diff --git a/.claude/rules/infra/development.md b/.claude/rules/infra/development.md index 560453c19e3..57118853ed6 100644 --- a/.claude/rules/infra/development.md +++ b/.claude/rules/infra/development.md @@ -19,7 +19,7 @@ AWS CDK infrastructure projects live in `infra/`. Each project is independent fr | smalruby-api | `infra/smalruby-api/` | Smalruby API endpoints (HTTP API v2 + Lambda): cors-proxy, mesh-domain, scratch-api-proxy/* | | smalruby-bug-report | `infra/smalruby-bug-report/` | Program bug report service (HTTP API v2 + Lambda + DynamoDB + S3): 作品添付つき不具合報告 + 管理者レジストリ | | smalruby-admin | `infra/smalruby-admin/` | Admin service (HTTP API v2 + Lambda + DynamoDB): 管理 SPA のバックエンド(deny-by-default 許可リスト + 監査ログ) | -| smalruby-web-hosting | `infra/smalruby-web-hosting/` | Web 配信基盤(Route 53 + S3 + CloudFront + ACM + GitHub OIDC ロール): stg: ブランチプレビュー `preview.smalruby.app//`。prod: 本番 smalruby.app の配信基盤(`docs/hosting/`) | +| smalruby-web-hosting | `infra/smalruby-web-hosting/` | Web 配信基盤(Route 53 + S3 + CloudFront + ACM + GitHub OIDC ロール): stg: ブランチプレビュー `preview.smalruby.app//`。prod: 本番 smalruby.app の配信基盤とホストゾーン `smalruby.app`(`docs/hosting/`) | See project-specific rules for details: - `.claude/rules/infra/smalruby-mesh-v2.md` @@ -316,7 +316,8 @@ account ID は CDK の `cdk.context.json` コミット方針で既にリポジ 1. **消えると取り戻せないデータ**の表: bug-report の `BugReportAdmins`、classroom の `SharedAssignments`(みんなの課題。prod のみ RETAIN)、rubytee-relay の `RubyteeRelayUsage`(利用集計)。 2. **作り直すと、AWS の外に登録した値と食い違うリソース**: web-hosting の Route 53 ホストゾーン - `preview.smalruby.app`(stg のみ)。作り直すと NS が変わり、お名前.com に登録した委任の NS と合わなくなる。 + `preview.smalruby.app`(stg のみ)と `smalruby.app`(prod のみ)。作り直すと NS が変わり、お名前.com に + 登録した委任・ネームサーバーの NS と合わなくなる。 3. **例外: 本番の配信元**: web-hosting の本番の配信バケット `SiteBucket`(prod のみ)。中身はビルドから 作り直せるが、消えると smalruby.app が止まるので、スタックの削除や論理 ID の変更で消えないようにする。 プレビューのバケットは DESTROY のまま。 diff --git a/.claude/rules/infra/smalruby-web-hosting.md b/.claude/rules/infra/smalruby-web-hosting.md index f6c9f412a0a..f07007bc835 100644 --- a/.claude/rules/infra/smalruby-web-hosting.md +++ b/.claude/rules/infra/smalruby-web-hosting.md @@ -16,7 +16,8 @@ Smalruby の Web フロントエンドを AWS(Route 53 / 今後 S3 + CloudFron - **プレビュー用の資源は stg ステージだけに作る**。`Deploy Infra` は develop へのマージで prod にも 出すので、prod と stg2 などにはプレビュー用の資源を作らない(`if (stage !== 'stg') return`)。 同じ名前のゾーンが複数あると、どれが委任先か分からなくなる。この分岐を外さない。 -- **prod には本番 smalruby.app の配信基盤だけを作る**(`createSiteDelivery()`。計画は +- **prod には本番 smalruby.app の配信基盤とホストゾーン `smalruby.app` だけを作る**(`createSiteDelivery()` / + `createSiteZone()`。計画は `docs/hosting/README.md`)。本番は GitHub Pages から切り替える途中なので、**本番の DNS・配信の向き先を 変える差分(apex のレコード、`smalruby.app` の代替ドメインなど)は、人間が夜間(21:00〜7:00)に マージする PR に分ける**。本番のバケットは**いまの版を期限で消さない**(プレビューのライフサイクルを @@ -25,7 +26,11 @@ Smalruby の Web フロントエンドを AWS(Route 53 / 今後 S3 + CloudFron お名前.com に登録した委任(NS 4 本)と食い違って `preview.smalruby.app` が引けなくなる。 このプロジェクトの RETAIN は「データ」ではなく「AWS の外に登録した値」を守るためのもの (`.claude/rules/infra/development.md` の「データ保持」)。 -- **ゾーンを作り直さない**。論理 ID(`PreviewHostedZone`)の変更・コンストラクトの移動・スタック名の +- **ホストゾーン `smalruby.app`(prod)も `RemovalPolicy.RETAIN`**。レコードの値は + `lib/site-zone-records.ts` にまとめ、**お名前.com と同じ値**にする(ネームサーバーを変えた瞬間に答えが + 変わらないように。apex の A の TTL だけ 300)。`_github-pages-challenge-smalruby` の TXT は消さない。 + 照合は `scripts/hosting/dns-compare.mjs`。 +- **ゾーンを作り直さない**。論理 ID(`PreviewHostedZone` / `SiteHostedZone`)の変更・コンストラクトの移動・スタック名の 変更は、CloudFormation から見ると「削除 + 新規作成」になる。RETAIN なので古いゾーンは残り、 **同名の 2 つ目のゾーン(別の NS)が黙ってできる**(Route 53 は同名ゾーンを許す)。 レビューでは、ゾーンの論理 ID・スタック名・`zoneName` が変わる差分を **[Must]** で止める。 diff --git a/.claude/rules/scratch-gui/mesh.md b/.claude/rules/scratch-gui/mesh.md index a36f1d2284b..307ab2f9c73 100644 --- a/.claude/rules/scratch-gui/mesh.md +++ b/.claude/rules/scratch-gui/mesh.md @@ -124,8 +124,6 @@ mesh のリグレッション確認には `tools/playwright-verify/` の **ス | スクリプト | 検証対象 | |-----------|---------| | `mesh-v2-classroom-binding.mjs` | **mesh v2 ↔ クラス管理ドメイン連動の本命リグレッション**。teacher/student 2 タブで参加コード→ `state.scratchGui.meshV2.domain` 一致、接続モーダル入力欄 disabled、解除時の復元 | -| `verify-mesh-collision-paths.mjs` | mesh センサー衝突パス | -| `verify-mesh-self-sensor-notice.mjs` | グローバル変数名と mesh センサー値の重複通知 (#707) | | `verify-tutorial-mesh-categories.mjs` | チュートリアルの mesh カテゴリ | 実行(dev server 起動 + `.env` の `DEV_BYPASS_TOKEN`/mesh/classroom エンドポイントが前提): diff --git a/.github/workflows/ci-cd.yml b/.github/workflows/ci-cd.yml index 0e43021149b..080b3e587ca 100644 --- a/.github/workflows/ci-cd.yml +++ b/.github/workflows/ci-cd.yml @@ -245,6 +245,13 @@ jobs: build-and-deploy: runs-on: ubuntu-26.04 + # Job-level permissions replace the workflow-level ones, so restate them and add + # id-token for the S3 + CloudFront deploy (AssumeRole with GitHub OIDC, #2002). + permissions: + contents: write + issues: write + pull-requests: write + id-token: write env: NODE_OPTIONS: --max-old-space-size=4000 steps: @@ -342,6 +349,96 @@ jobs: full_commit_message: "Admin build for ${{ github.sha }}" external_repository: smalruby/smalruby.app + # The same build also goes to the production S3 + CloudFront (EPIC #1931, #2002), next to + # GitHub Pages, so the two can be compared before smalruby.app is switched over + # (docs/hosting/README.md). GitHub Pages stays the live site until then. + - name: Check the S3 site settings + id: site + if: github.ref == 'refs/heads/develop' + env: + SITE_DEPLOY_ROLE_ARN: ${{ vars.SITE_DEPLOY_ROLE_ARN }} + SITE_BUCKET_NAME: ${{ vars.SITE_BUCKET_NAME }} + SITE_DISTRIBUTION_ID: ${{ vars.SITE_DISTRIBUTION_ID }} + run: | + missing=() + [ -n "${SITE_DEPLOY_ROLE_ARN}" ] || missing+=(SITE_DEPLOY_ROLE_ARN) + [ -n "${SITE_BUCKET_NAME}" ] || missing+=(SITE_BUCKET_NAME) + [ -n "${SITE_DISTRIBUTION_ID}" ] || missing+=(SITE_DISTRIBUTION_ID) + if [ ${#missing[@]} -gt 0 ]; then + echo "::warning::repo の Variables に ${missing[*]} が未設定のため、S3 + CloudFront への配置を飛ばします(docs/hosting/README.md)。" + echo "enabled=false" >> "$GITHUB_OUTPUT" + else + echo "enabled=true" >> "$GITHUB_OUTPUT" + fi + - uses: aws-actions/configure-aws-credentials@e1253824e5c10ff9df46874f81ed3ec929e19cfd # v6.3.0 + if: steps.site.outputs.enabled == 'true' + with: + role-to-assume: ${{ vars.SITE_DEPLOY_ROLE_ARN }} + aws-region: ap-northeast-1 + - name: Upload to the S3 site bucket + if: steps.site.outputs.enabled == 'true' + env: + BUCKET: ${{ vars.SITE_BUCKET_NAME }} + run: | + set -euo pipefail + # upload + # Same cache rules as the preview (docs/infra/smalruby-web-hosting.md): file names with a + # hash are immutable, the rest (index.html, service-worker.js, version.json, .well-known, + # auth-redirect.*) are re-checked on every load. Types aws s3 may guess wrong (.wasm / + # .mjs / .hex) are uploaded with an explicit Content-Type. + upload() { + local src="$1" dest="$2" + shift 2 + local hashed plain + hashed="$(mktemp -d)" + plain="$(mktemp -d)" + (cd "${src}" && find . -type f ! -name '.DS_Store' ! -name '.nojekyll' ! -name 'CNAME' -print0) | + while IFS= read -r -d '' f; do + if printf '%s' "${f}" | grep -qE '\.[0-9a-f]{8,}\.'; then + to="${hashed}" + else + to="${plain}" + fi + mkdir -p "${to}/$(dirname "${f}")" + cp -p "${src}/${f}" "${to}/${f}" + done + local typed=(--exclude '*.wasm' --exclude '*.mjs' --exclude '*.hex') + aws s3 sync "${hashed}" "${dest}" --only-show-errors "${typed[@]}" \ + --cache-control 'public, max-age=31536000, immutable' + aws s3 sync "${plain}" "${dest}" --only-show-errors "${typed[@]}" \ + --cache-control 'max-age=0, s-maxage=60' + local ext type dir cache + for spec in 'wasm:application/wasm' 'mjs:text/javascript' 'hex:application/octet-stream'; do + ext="${spec%%:*}" + type="${spec#*:}" + for dir in "${hashed}" "${plain}"; do + if [ "${dir}" = "${hashed}" ]; then + cache='public, max-age=31536000, immutable' + else + cache='max-age=0, s-maxage=60' + fi + aws s3 sync "${dir}" "${dest}" --only-show-errors \ + --exclude '*' --include "*.${ext}" \ + --content-type "${type}" --cache-control "${cache}" + done + done + # Remove what the new build no longer has. Everything left was just uploaded, so + # --size-only keeps sync from re-uploading it (which would drop the Cache-Control). + aws s3 sync "${src}" "${dest}" --delete --size-only --only-show-errors \ + --exclude '.DS_Store' --exclude '.nojekyll' --exclude 'CNAME' "$@" + } + # The editor at the root. admin/ is its own deploy below, so --delete must not touch it. + upload packages/scratch-gui/dist "s3://${BUCKET}/" --exclude 'admin/*' + # Admin SPA at /admin/ (--delete stays inside admin/). + upload packages/admin/build "s3://${BUCKET}/admin/" + - name: Invalidate the S3 site + if: steps.site.outputs.enabled == 'true' + env: + DISTRIBUTION_ID: ${{ vars.SITE_DISTRIBUTION_ID }} + run: | + aws cloudfront create-invalidation --distribution-id "${DISTRIBUTION_ID}" \ + --paths '/*' --query 'Invalidation.Id' --output text + # Branch previews on https://preview.smalruby.app// (#1344), built with the stg values # so a preview never touches production data. These replace the GitHub Pages previews # (smalruby.jp/smalruby3-editor//, prod values), which stopped in #1345. diff --git a/assignments/LICENSE b/assignments/LICENSE new file mode 100644 index 00000000000..5d9de222ef4 --- /dev/null +++ b/assignments/LICENSE @@ -0,0 +1,14 @@ +CC0 1.0 Universal (CC0 1.0) Public Domain Dedication + +To the extent possible under law, the authors of the Smalruby standard +assignments have waived all copyright and related or neighboring rights to the +files in this directory (assignments/). This work is published from Japan. + +The full legal code is available at: +https://creativecommons.org/publicdomain/zero/1.0/legalcode + +このディレクトリ(assignments/)の課題・ワークシート・評価規準は CC0 1.0 +(パブリックドメイン)です。自由にコピー・改変・配布できます(出典の表示は不要)。 + +The rest of the smalruby3-editor repository keeps its own license (see the +LICENSE file at the repository root). diff --git a/assignments/README.md b/assignments/README.md new file mode 100644 index 00000000000..36ebbd9015c --- /dev/null +++ b/assignments/README.md @@ -0,0 +1,8 @@ +# スモウルビー標準課題(assignments/) + +クラス管理で使う「標準課題」の成果物です。エディタと一緒に `https://smalruby.app/assignments/` で公開します。 +説明・決まりごとは [`docs/standard-assignments/README.md`](../docs/standard-assignments/README.md) を見てください。 + +- ライセンス: CC0 1.0([`LICENSE`](LICENSE))。リポジトリのほかの部分のライセンスとは別です。 +- ここに置くのは成果物(課題の説明の JSON・PDF・sb3)だけです。原本と生成スクリプトはリポジトリの外にあります。 +- `<課題のID>/<版>/` は一度置いたら変えません。直すときは新しい版のディレクトリを足し、`<課題のID>/` (最新)をその版と同じ中身にします。 diff --git a/assignments/es-pg-kyou-kara-programmer-01-first-step/0.1.0/assignment.json b/assignments/es-pg-kyou-kara-programmer-01-first-step/0.1.0/assignment.json new file mode 100644 index 00000000000..0db66ff9c3e --- /dev/null +++ b/assignments/es-pg-kyou-kara-programmer-01-first-step/0.1.0/assignment.json @@ -0,0 +1,40 @@ +{ + "schemaVersion": 1, + "id": "es-pg-kyou-kara-programmer-01-first-step", + "version": "0.1.0", + "series": "es-pg-kyou-kara-programmer", + "number": 1, + "title": "はじめの一歩(スモウルビーの地図と最初の 5 分)", + "goal": "スモウルビーの画面の部分の名前と、ヒントを見ながら進めるレッスンの進め方を知る。", + "schoolType": "es", + "subject": "教科を問わない(総合的な学習の時間・算数・理科などのプログラミング)", + "curriculum": "プログラミング体験(スモウルビーのレッスン「きょうからプログラマー」)", + "grade": 4, + "hours": 1, + "starter": null, + "license": "CC0-1.0", + "lessons": [ + { + "course": "kyou-kara-programmer", + "lessons": [ + "blocks-l1" + ] + } + ], + "submit": { + "project": null, + "worksheet": false + }, + "files": [ + { + "file": "map.pdf", + "kind": "map", + "audience": "student" + }, + { + "file": "script.pdf", + "kind": "script", + "audience": "teacher" + } + ] +} diff --git a/assignments/es-pg-kyou-kara-programmer-01-first-step/0.1.0/map.pdf b/assignments/es-pg-kyou-kara-programmer-01-first-step/0.1.0/map.pdf new file mode 100644 index 00000000000..9756013bf77 Binary files /dev/null and b/assignments/es-pg-kyou-kara-programmer-01-first-step/0.1.0/map.pdf differ diff --git a/assignments/es-pg-kyou-kara-programmer-01-first-step/0.1.0/script.pdf b/assignments/es-pg-kyou-kara-programmer-01-first-step/0.1.0/script.pdf new file mode 100644 index 00000000000..d418556d053 Binary files /dev/null and b/assignments/es-pg-kyou-kara-programmer-01-first-step/0.1.0/script.pdf differ diff --git a/assignments/es-pg-kyou-kara-programmer-01-first-step/0.1.1/assignment.json b/assignments/es-pg-kyou-kara-programmer-01-first-step/0.1.1/assignment.json new file mode 100644 index 00000000000..e74d01f2c46 --- /dev/null +++ b/assignments/es-pg-kyou-kara-programmer-01-first-step/0.1.1/assignment.json @@ -0,0 +1,41 @@ +{ + "schemaVersion": 1, + "id": "es-pg-kyou-kara-programmer-01-first-step", + "version": "0.1.1", + "series": "es-pg-kyou-kara-programmer", + "number": 1, + "title": "はじめの一歩(スモウルビーの地図と最初の 5 分)", + "goal": "スモウルビーの画面の部分の名前と、ヒントを見ながら進めるレッスンの進め方を知る。", + "schoolType": "es", + "subject": "教科を問わない(総合的な学習の時間・算数・理科などのプログラミング)", + "curriculum": "プログラミング体験(スモウルビーのレッスン「きょうからプログラマー」)", + "grade": 4, + "hours": 1, + "starter": null, + "license": "CC0-1.0", + "lessons": [ + { + "course": "kyou-kara-programmer", + "lessons": [ + "blocks-l0", + "blocks-l1" + ] + } + ], + "submit": { + "project": null, + "worksheet": false + }, + "files": [ + { + "file": "map.pdf", + "kind": "map", + "audience": "student" + }, + { + "file": "script.pdf", + "kind": "script", + "audience": "teacher" + } + ] +} diff --git a/assignments/es-pg-kyou-kara-programmer-01-first-step/0.1.1/map.pdf b/assignments/es-pg-kyou-kara-programmer-01-first-step/0.1.1/map.pdf new file mode 100644 index 00000000000..0815e67fe54 Binary files /dev/null and b/assignments/es-pg-kyou-kara-programmer-01-first-step/0.1.1/map.pdf differ diff --git a/assignments/es-pg-kyou-kara-programmer-01-first-step/0.1.1/script.pdf b/assignments/es-pg-kyou-kara-programmer-01-first-step/0.1.1/script.pdf new file mode 100644 index 00000000000..7cd56d8932b Binary files /dev/null and b/assignments/es-pg-kyou-kara-programmer-01-first-step/0.1.1/script.pdf differ diff --git a/assignments/es-pg-kyou-kara-programmer-01-first-step/0.1.2/assignment.json b/assignments/es-pg-kyou-kara-programmer-01-first-step/0.1.2/assignment.json new file mode 100644 index 00000000000..82749e4261c --- /dev/null +++ b/assignments/es-pg-kyou-kara-programmer-01-first-step/0.1.2/assignment.json @@ -0,0 +1,41 @@ +{ + "schemaVersion": 1, + "id": "es-pg-kyou-kara-programmer-01-first-step", + "version": "0.1.2", + "series": "es-pg-kyou-kara-programmer", + "number": 1, + "title": "はじめの一歩(スモウルビーの地図と最初の 5 分)", + "goal": "スモウルビーの画面の部分の名前と、ヒントを見ながら進めるレッスンの進め方を知る。", + "schoolType": "es", + "subject": "教科を問わない(総合的な学習の時間・算数・理科などのプログラミング)", + "curriculum": "プログラミング体験(スモウルビーのレッスン「きょうからプログラマー」)", + "grade": 4, + "hours": 1, + "starter": null, + "license": "CC0-1.0", + "lessons": [ + { + "course": "kyou-kara-programmer", + "lessons": [ + "blocks-l0", + "blocks-l1" + ] + } + ], + "submit": { + "project": null, + "worksheet": false + }, + "files": [ + { + "file": "map.pdf", + "kind": "map", + "audience": "student" + }, + { + "file": "script.pdf", + "kind": "script", + "audience": "teacher" + } + ] +} diff --git a/assignments/es-pg-kyou-kara-programmer-01-first-step/0.1.2/map.pdf b/assignments/es-pg-kyou-kara-programmer-01-first-step/0.1.2/map.pdf new file mode 100644 index 00000000000..0533210b98e Binary files /dev/null and b/assignments/es-pg-kyou-kara-programmer-01-first-step/0.1.2/map.pdf differ diff --git a/assignments/es-pg-kyou-kara-programmer-01-first-step/0.1.2/script.pdf b/assignments/es-pg-kyou-kara-programmer-01-first-step/0.1.2/script.pdf new file mode 100644 index 00000000000..efe5b5a9148 Binary files /dev/null and b/assignments/es-pg-kyou-kara-programmer-01-first-step/0.1.2/script.pdf differ diff --git a/assignments/es-pg-kyou-kara-programmer-01-first-step/assignment.json b/assignments/es-pg-kyou-kara-programmer-01-first-step/assignment.json new file mode 100644 index 00000000000..82749e4261c --- /dev/null +++ b/assignments/es-pg-kyou-kara-programmer-01-first-step/assignment.json @@ -0,0 +1,41 @@ +{ + "schemaVersion": 1, + "id": "es-pg-kyou-kara-programmer-01-first-step", + "version": "0.1.2", + "series": "es-pg-kyou-kara-programmer", + "number": 1, + "title": "はじめの一歩(スモウルビーの地図と最初の 5 分)", + "goal": "スモウルビーの画面の部分の名前と、ヒントを見ながら進めるレッスンの進め方を知る。", + "schoolType": "es", + "subject": "教科を問わない(総合的な学習の時間・算数・理科などのプログラミング)", + "curriculum": "プログラミング体験(スモウルビーのレッスン「きょうからプログラマー」)", + "grade": 4, + "hours": 1, + "starter": null, + "license": "CC0-1.0", + "lessons": [ + { + "course": "kyou-kara-programmer", + "lessons": [ + "blocks-l0", + "blocks-l1" + ] + } + ], + "submit": { + "project": null, + "worksheet": false + }, + "files": [ + { + "file": "map.pdf", + "kind": "map", + "audience": "student" + }, + { + "file": "script.pdf", + "kind": "script", + "audience": "teacher" + } + ] +} diff --git a/assignments/es-pg-kyou-kara-programmer-01-first-step/map.pdf b/assignments/es-pg-kyou-kara-programmer-01-first-step/map.pdf new file mode 100644 index 00000000000..0533210b98e Binary files /dev/null and b/assignments/es-pg-kyou-kara-programmer-01-first-step/map.pdf differ diff --git a/assignments/es-pg-kyou-kara-programmer-01-first-step/script.pdf b/assignments/es-pg-kyou-kara-programmer-01-first-step/script.pdf new file mode 100644 index 00000000000..efe5b5a9148 Binary files /dev/null and b/assignments/es-pg-kyou-kara-programmer-01-first-step/script.pdf differ diff --git a/assignments/es-pg-kyou-kara-programmer/0.1.0/series.json b/assignments/es-pg-kyou-kara-programmer/0.1.0/series.json new file mode 100644 index 00000000000..5896f98128c --- /dev/null +++ b/assignments/es-pg-kyou-kara-programmer/0.1.0/series.json @@ -0,0 +1,17 @@ +{ + "schemaVersion": 1, + "id": "es-pg-kyou-kara-programmer", + "version": "0.1.0", + "title": "きょうからプログラマー(小学校)", + "description": "スモウルビーのレッスン「きょうからプログラマー」と合わせて使う、小学 4〜6 年のプログラミングの時間。最初の時間は、プロジェクターで「スモウルビーの地図」を見せて画面の部分の名前を覚え、ヒントを見ながら進めるレッスンの進め方をやって見せてから、レッスン 0「スモウルビーをたんけんしよう」に進む。1 時間が 1 つの課題。", + "schoolType": "es", + "subject": "教科を問わない(総合的な学習の時間・算数・理科などのプログラミング)", + "curriculum": "プログラミング体験(スモウルビーのレッスン「きょうからプログラマー」)", + "grade": 4, + "license": "CC0-1.0", + "hours": 1, + "assignments": [ + "es-pg-kyou-kara-programmer-01-first-step" + ], + "files": [] +} diff --git a/assignments/es-pg-kyou-kara-programmer/0.1.1/series.json b/assignments/es-pg-kyou-kara-programmer/0.1.1/series.json new file mode 100644 index 00000000000..49882ef0c26 --- /dev/null +++ b/assignments/es-pg-kyou-kara-programmer/0.1.1/series.json @@ -0,0 +1,17 @@ +{ + "schemaVersion": 1, + "id": "es-pg-kyou-kara-programmer", + "version": "0.1.1", + "title": "きょうからプログラマー(小学校)", + "description": "スモウルビーのレッスン「きょうからプログラマー」と合わせて使う、小学 4〜6 年のプログラミングの時間。最初の時間は、プロジェクターで「スモウルビーの地図」を見せて画面の部分の名前を覚え、ヒントを見ながら進めるレッスンの進め方をやって見せてから、レッスン 0「スモウルビーをたんけんしよう」に進む。1 時間が 1 つの課題。", + "schoolType": "es", + "subject": "教科を問わない(総合的な学習の時間・算数・理科などのプログラミング)", + "curriculum": "プログラミング体験(スモウルビーのレッスン「きょうからプログラマー」)", + "grade": 4, + "license": "CC0-1.0", + "hours": 1, + "assignments": [ + "es-pg-kyou-kara-programmer-01-first-step" + ], + "files": [] +} diff --git a/assignments/es-pg-kyou-kara-programmer/0.1.2/series.json b/assignments/es-pg-kyou-kara-programmer/0.1.2/series.json new file mode 100644 index 00000000000..80a7c538be6 --- /dev/null +++ b/assignments/es-pg-kyou-kara-programmer/0.1.2/series.json @@ -0,0 +1,17 @@ +{ + "schemaVersion": 1, + "id": "es-pg-kyou-kara-programmer", + "version": "0.1.2", + "title": "きょうからプログラマー(小学校)", + "description": "スモウルビーのレッスン「きょうからプログラマー」と合わせて使う、小学 4〜6 年のプログラミングの時間。最初の時間は、プロジェクターで「スモウルビーの地図」を見せて画面の部分の名前を覚え、ヒントを見ながら進めるレッスンの進め方をやって見せてから、レッスン 0「スモウルビーをたんけんしよう」に進む。1 時間が 1 つの課題。", + "schoolType": "es", + "subject": "教科を問わない(総合的な学習の時間・算数・理科などのプログラミング)", + "curriculum": "プログラミング体験(スモウルビーのレッスン「きょうからプログラマー」)", + "grade": 4, + "license": "CC0-1.0", + "hours": 1, + "assignments": [ + "es-pg-kyou-kara-programmer-01-first-step" + ], + "files": [] +} diff --git a/assignments/es-pg-kyou-kara-programmer/series.json b/assignments/es-pg-kyou-kara-programmer/series.json new file mode 100644 index 00000000000..80a7c538be6 --- /dev/null +++ b/assignments/es-pg-kyou-kara-programmer/series.json @@ -0,0 +1,17 @@ +{ + "schemaVersion": 1, + "id": "es-pg-kyou-kara-programmer", + "version": "0.1.2", + "title": "きょうからプログラマー(小学校)", + "description": "スモウルビーのレッスン「きょうからプログラマー」と合わせて使う、小学 4〜6 年のプログラミングの時間。最初の時間は、プロジェクターで「スモウルビーの地図」を見せて画面の部分の名前を覚え、ヒントを見ながら進めるレッスンの進め方をやって見せてから、レッスン 0「スモウルビーをたんけんしよう」に進む。1 時間が 1 つの課題。", + "schoolType": "es", + "subject": "教科を問わない(総合的な学習の時間・算数・理科などのプログラミング)", + "curriculum": "プログラミング体験(スモウルビーのレッスン「きょうからプログラマー」)", + "grade": 4, + "license": "CC0-1.0", + "hours": 1, + "assignments": [ + "es-pg-kyou-kara-programmer-01-first-step" + ], + "files": [] +} diff --git a/assignments/index.html b/assignments/index.html new file mode 100644 index 00000000000..39b99ebc4e7 --- /dev/null +++ b/assignments/index.html @@ -0,0 +1,121 @@ + + + + + + スモウルビー標準課題 + + + + + + +
+

スモウルビー標準課題

+

授業 1 時間 = 1 つの課題。ワークシートと評価規準を、そのまま印刷して使えます。

+
+
+
+

小学校 きょうからプログラマー

+

小学 4〜6 年。スモウルビーのレッスン「きょうからプログラマー」と合わせて使います。

+
    +
  1. + はじめの一歩(スモウルビーの地図と最初の 5 分) + +
    es-pg-kyou-kara-programmer-01-first-step
    +
  2. +
+
+
+

中学校 技術・家庭科〈技術分野〉D(2) 双方向性のあるコンテンツ(チャットを作ろう)

+

8 時間(中学 2 年)。スモウルビーのレッスン「チャットをつくろう」と合わせて使います。 + 評価規準とルーブリック(先生用・PDF)

+
    +
  1. + 第 1 時 双方向性のあるコンテンツとスモウルビー + +
    jhs-tech-d2-chat-01-intro
    +
  2. +
  3. + 第 2 時 使用者の働きかけと応答 + +
    jhs-tech-d2-chat-02-input-output
    +
  4. +
  5. + 第 3 時 メッセージで 2 人がやりとりする + +
    jhs-tech-d2-chat-03-message
    +
  6. +
  7. + 第 4 時 ネットワークを利用したプログラム(メッシュ) + +
    jhs-tech-d2-chat-04-mesh
    +
  8. +
  9. + 第 5 時 チャットを便利・快適・安全にする + +
    jhs-tech-d2-chat-05-find-problems
    +
  10. +
  11. + 第 6 時 便利・快適・安全なチャットを設計しよう + +
    jhs-tech-d2-chat-06-design
    +
  12. +
  13. + 第 7 時 チャットを作ろう(制作とデバッグ) + +
    jhs-tech-d2-chat-07-build-debug
    +
  14. +
  15. + 第 8 時 評価・改善とまとめ + +
    jhs-tech-d2-chat-08-evaluate-improve
    +
  16. +
+
+
+
+

ここにある課題・ワークシート・評価規準・地図・台本は CC0 1.0(パブリックドメイン)です。自由にコピー・改変・配布できます(出典の表示は不要)。

+

課題の説明は index.json と各課題の assignment.json にあります。 + 各課題の URL は /assignments/<課題のID>/(最新)と /assignments/<課題のID>/<版>/(版を固定)です。

+

スモウルビーを開く

+
+ + diff --git a/assignments/index.json b/assignments/index.json new file mode 100644 index 00000000000..d9fbc09f7ef --- /dev/null +++ b/assignments/index.json @@ -0,0 +1,76 @@ +{ + "schemaVersion": 1, + "license": "CC0-1.0", + "series": [ + { + "id": "es-pg-kyou-kara-programmer", + "version": "0.1.2", + "title": "きょうからプログラマー(小学校)", + "schoolType": "es", + "assignments": [ + { + "id": "es-pg-kyou-kara-programmer-01-first-step", + "version": "0.1.2", + "number": 1, + "title": "はじめの一歩(スモウルビーの地図と最初の 5 分)" + } + ] + }, + { + "id": "jhs-tech-d2-chat", + "version": "0.1.0", + "title": "双方向性のあるコンテンツ(チャットを作ろう)", + "schoolType": "jhs", + "assignments": [ + { + "id": "jhs-tech-d2-chat-01-intro", + "version": "0.1.0", + "number": 1, + "title": "双方向性のあるコンテンツとスモウルビー" + }, + { + "id": "jhs-tech-d2-chat-02-input-output", + "version": "0.1.0", + "number": 2, + "title": "使用者の働きかけと応答" + }, + { + "id": "jhs-tech-d2-chat-03-message", + "version": "0.1.0", + "number": 3, + "title": "メッセージで 2 人がやりとりする" + }, + { + "id": "jhs-tech-d2-chat-04-mesh", + "version": "0.1.0", + "number": 4, + "title": "ネットワークを利用したプログラム(メッシュ)" + }, + { + "id": "jhs-tech-d2-chat-05-find-problems", + "version": "0.1.0", + "number": 5, + "title": "チャットを便利・快適・安全にする" + }, + { + "id": "jhs-tech-d2-chat-06-design", + "version": "0.1.0", + "number": 6, + "title": "便利・快適・安全なチャットを設計しよう" + }, + { + "id": "jhs-tech-d2-chat-07-build-debug", + "version": "0.1.0", + "number": 7, + "title": "チャットを作ろう(制作とデバッグ)" + }, + { + "id": "jhs-tech-d2-chat-08-evaluate-improve", + "version": "0.1.0", + "number": 8, + "title": "評価・改善とまとめ" + } + ] + } + ] +} diff --git a/assignments/jhs-tech-d2-chat-01-intro/0.1.0/assignment.json b/assignments/jhs-tech-d2-chat-01-intro/0.1.0/assignment.json new file mode 100644 index 00000000000..cb1149a349c --- /dev/null +++ b/assignments/jhs-tech-d2-chat-01-intro/0.1.0/assignment.json @@ -0,0 +1,47 @@ +{ + "schemaVersion": 1, + "id": "jhs-tech-d2-chat-01-intro", + "version": "0.1.0", + "series": "jhs-tech-d2-chat", + "number": 1, + "title": "双方向性のあるコンテンツとスモウルビー", + "goal": "単元の見通しをもち、双方向性のあるコンテンツの言葉と、スモウルビーの画面を知る。", + "schoolType": "jhs", + "subject": "技術・家庭科〈技術分野〉", + "curriculum": "D(2) 双方向性のあるコンテンツのプログラミングによる問題解決", + "grade": 2, + "hours": 1, + "starter": null, + "license": "CC0-1.0", + "worksheetPages": [ + 0, + 1, + 2 + ], + "lessons": [ + { + "course": "kyou-kara-programmer", + "lessons": [ + "blocks-l1", + "blocks-l2", + "blocks-l3" + ] + } + ], + "submit": { + "project": "01_れんしゅう", + "worksheet": false + }, + "files": [ + { + "file": "worksheet.pdf", + "kind": "worksheet", + "audience": "student" + }, + { + "file": "worksheet-teacher.pdf", + "kind": "worksheet", + "audience": "teacher" + } + ] +} diff --git a/assignments/jhs-tech-d2-chat-01-intro/0.1.0/worksheet-teacher.pdf b/assignments/jhs-tech-d2-chat-01-intro/0.1.0/worksheet-teacher.pdf new file mode 100644 index 00000000000..1372c71d2b4 Binary files /dev/null and b/assignments/jhs-tech-d2-chat-01-intro/0.1.0/worksheet-teacher.pdf differ diff --git a/assignments/jhs-tech-d2-chat-01-intro/0.1.0/worksheet.pdf b/assignments/jhs-tech-d2-chat-01-intro/0.1.0/worksheet.pdf new file mode 100644 index 00000000000..117d8fb0a79 Binary files /dev/null and b/assignments/jhs-tech-d2-chat-01-intro/0.1.0/worksheet.pdf differ diff --git a/assignments/jhs-tech-d2-chat-01-intro/assignment.json b/assignments/jhs-tech-d2-chat-01-intro/assignment.json new file mode 100644 index 00000000000..cb1149a349c --- /dev/null +++ b/assignments/jhs-tech-d2-chat-01-intro/assignment.json @@ -0,0 +1,47 @@ +{ + "schemaVersion": 1, + "id": "jhs-tech-d2-chat-01-intro", + "version": "0.1.0", + "series": "jhs-tech-d2-chat", + "number": 1, + "title": "双方向性のあるコンテンツとスモウルビー", + "goal": "単元の見通しをもち、双方向性のあるコンテンツの言葉と、スモウルビーの画面を知る。", + "schoolType": "jhs", + "subject": "技術・家庭科〈技術分野〉", + "curriculum": "D(2) 双方向性のあるコンテンツのプログラミングによる問題解決", + "grade": 2, + "hours": 1, + "starter": null, + "license": "CC0-1.0", + "worksheetPages": [ + 0, + 1, + 2 + ], + "lessons": [ + { + "course": "kyou-kara-programmer", + "lessons": [ + "blocks-l1", + "blocks-l2", + "blocks-l3" + ] + } + ], + "submit": { + "project": "01_れんしゅう", + "worksheet": false + }, + "files": [ + { + "file": "worksheet.pdf", + "kind": "worksheet", + "audience": "student" + }, + { + "file": "worksheet-teacher.pdf", + "kind": "worksheet", + "audience": "teacher" + } + ] +} diff --git a/assignments/jhs-tech-d2-chat-01-intro/worksheet-teacher.pdf b/assignments/jhs-tech-d2-chat-01-intro/worksheet-teacher.pdf new file mode 100644 index 00000000000..1372c71d2b4 Binary files /dev/null and b/assignments/jhs-tech-d2-chat-01-intro/worksheet-teacher.pdf differ diff --git a/assignments/jhs-tech-d2-chat-01-intro/worksheet.pdf b/assignments/jhs-tech-d2-chat-01-intro/worksheet.pdf new file mode 100644 index 00000000000..117d8fb0a79 Binary files /dev/null and b/assignments/jhs-tech-d2-chat-01-intro/worksheet.pdf differ diff --git a/assignments/jhs-tech-d2-chat-02-input-output/0.1.0/assignment.json b/assignments/jhs-tech-d2-chat-02-input-output/0.1.0/assignment.json new file mode 100644 index 00000000000..e60a06b75c1 --- /dev/null +++ b/assignments/jhs-tech-d2-chat-02-input-output/0.1.0/assignment.json @@ -0,0 +1,44 @@ +{ + "schemaVersion": 1, + "id": "jhs-tech-d2-chat-02-input-output", + "version": "0.1.0", + "series": "jhs-tech-d2-chat", + "number": 2, + "title": "使用者の働きかけと応答", + "goal": "使用者の働きかけ(入力)を受け取って、応答(出力)を返すプログラムを作る。", + "schoolType": "jhs", + "subject": "技術・家庭科〈技術分野〉", + "curriculum": "D(2) 双方向性のあるコンテンツのプログラミングによる問題解決", + "grade": 2, + "hours": 1, + "starter": null, + "license": "CC0-1.0", + "worksheetPages": [ + 3 + ], + "lessons": [ + { + "course": "chat-wo-tsukurou", + "lessons": [ + "chat-l1", + "chat-l2" + ] + } + ], + "submit": { + "project": "02_あいさつ", + "worksheet": true + }, + "files": [ + { + "file": "worksheet.pdf", + "kind": "worksheet", + "audience": "student" + }, + { + "file": "worksheet-teacher.pdf", + "kind": "worksheet", + "audience": "teacher" + } + ] +} diff --git a/assignments/jhs-tech-d2-chat-02-input-output/0.1.0/worksheet-teacher.pdf b/assignments/jhs-tech-d2-chat-02-input-output/0.1.0/worksheet-teacher.pdf new file mode 100644 index 00000000000..3377e25968e Binary files /dev/null and b/assignments/jhs-tech-d2-chat-02-input-output/0.1.0/worksheet-teacher.pdf differ diff --git a/assignments/jhs-tech-d2-chat-02-input-output/0.1.0/worksheet.pdf b/assignments/jhs-tech-d2-chat-02-input-output/0.1.0/worksheet.pdf new file mode 100644 index 00000000000..df39ff1713f Binary files /dev/null and b/assignments/jhs-tech-d2-chat-02-input-output/0.1.0/worksheet.pdf differ diff --git a/assignments/jhs-tech-d2-chat-02-input-output/assignment.json b/assignments/jhs-tech-d2-chat-02-input-output/assignment.json new file mode 100644 index 00000000000..e60a06b75c1 --- /dev/null +++ b/assignments/jhs-tech-d2-chat-02-input-output/assignment.json @@ -0,0 +1,44 @@ +{ + "schemaVersion": 1, + "id": "jhs-tech-d2-chat-02-input-output", + "version": "0.1.0", + "series": "jhs-tech-d2-chat", + "number": 2, + "title": "使用者の働きかけと応答", + "goal": "使用者の働きかけ(入力)を受け取って、応答(出力)を返すプログラムを作る。", + "schoolType": "jhs", + "subject": "技術・家庭科〈技術分野〉", + "curriculum": "D(2) 双方向性のあるコンテンツのプログラミングによる問題解決", + "grade": 2, + "hours": 1, + "starter": null, + "license": "CC0-1.0", + "worksheetPages": [ + 3 + ], + "lessons": [ + { + "course": "chat-wo-tsukurou", + "lessons": [ + "chat-l1", + "chat-l2" + ] + } + ], + "submit": { + "project": "02_あいさつ", + "worksheet": true + }, + "files": [ + { + "file": "worksheet.pdf", + "kind": "worksheet", + "audience": "student" + }, + { + "file": "worksheet-teacher.pdf", + "kind": "worksheet", + "audience": "teacher" + } + ] +} diff --git a/assignments/jhs-tech-d2-chat-02-input-output/worksheet-teacher.pdf b/assignments/jhs-tech-d2-chat-02-input-output/worksheet-teacher.pdf new file mode 100644 index 00000000000..3377e25968e Binary files /dev/null and b/assignments/jhs-tech-d2-chat-02-input-output/worksheet-teacher.pdf differ diff --git a/assignments/jhs-tech-d2-chat-02-input-output/worksheet.pdf b/assignments/jhs-tech-d2-chat-02-input-output/worksheet.pdf new file mode 100644 index 00000000000..df39ff1713f Binary files /dev/null and b/assignments/jhs-tech-d2-chat-02-input-output/worksheet.pdf differ diff --git a/assignments/jhs-tech-d2-chat-03-message/0.1.0/assignment.json b/assignments/jhs-tech-d2-chat-03-message/0.1.0/assignment.json new file mode 100644 index 00000000000..5744d611f2f --- /dev/null +++ b/assignments/jhs-tech-d2-chat-03-message/0.1.0/assignment.json @@ -0,0 +1,46 @@ +{ + "schemaVersion": 1, + "id": "jhs-tech-d2-chat-03-message", + "version": "0.1.0", + "series": "jhs-tech-d2-chat", + "number": 3, + "title": "メッセージで 2 人がやりとりする", + "goal": "メッセージを使って、2 つのスプライトがやりとりするプログラムを作る。", + "schoolType": "jhs", + "subject": "技術・家庭科〈技術分野〉", + "curriculum": "D(2) 双方向性のあるコンテンツのプログラミングによる問題解決", + "grade": 2, + "hours": 1, + "starter": null, + "license": "CC0-1.0", + "worksheetPages": [ + 4 + ], + "lessons": [ + { + "course": "chat-wo-tsukurou", + "lessons": [ + "chat-l3" + ], + "challenges": [ + "chat-l3-local-message" + ] + } + ], + "submit": { + "project": "03_メッセージ", + "worksheet": false + }, + "files": [ + { + "file": "worksheet.pdf", + "kind": "worksheet", + "audience": "student" + }, + { + "file": "worksheet-teacher.pdf", + "kind": "worksheet", + "audience": "teacher" + } + ] +} diff --git a/assignments/jhs-tech-d2-chat-03-message/0.1.0/worksheet-teacher.pdf b/assignments/jhs-tech-d2-chat-03-message/0.1.0/worksheet-teacher.pdf new file mode 100644 index 00000000000..bdc1d719797 Binary files /dev/null and b/assignments/jhs-tech-d2-chat-03-message/0.1.0/worksheet-teacher.pdf differ diff --git a/assignments/jhs-tech-d2-chat-03-message/0.1.0/worksheet.pdf b/assignments/jhs-tech-d2-chat-03-message/0.1.0/worksheet.pdf new file mode 100644 index 00000000000..8f1e464cb7f Binary files /dev/null and b/assignments/jhs-tech-d2-chat-03-message/0.1.0/worksheet.pdf differ diff --git a/assignments/jhs-tech-d2-chat-03-message/assignment.json b/assignments/jhs-tech-d2-chat-03-message/assignment.json new file mode 100644 index 00000000000..5744d611f2f --- /dev/null +++ b/assignments/jhs-tech-d2-chat-03-message/assignment.json @@ -0,0 +1,46 @@ +{ + "schemaVersion": 1, + "id": "jhs-tech-d2-chat-03-message", + "version": "0.1.0", + "series": "jhs-tech-d2-chat", + "number": 3, + "title": "メッセージで 2 人がやりとりする", + "goal": "メッセージを使って、2 つのスプライトがやりとりするプログラムを作る。", + "schoolType": "jhs", + "subject": "技術・家庭科〈技術分野〉", + "curriculum": "D(2) 双方向性のあるコンテンツのプログラミングによる問題解決", + "grade": 2, + "hours": 1, + "starter": null, + "license": "CC0-1.0", + "worksheetPages": [ + 4 + ], + "lessons": [ + { + "course": "chat-wo-tsukurou", + "lessons": [ + "chat-l3" + ], + "challenges": [ + "chat-l3-local-message" + ] + } + ], + "submit": { + "project": "03_メッセージ", + "worksheet": false + }, + "files": [ + { + "file": "worksheet.pdf", + "kind": "worksheet", + "audience": "student" + }, + { + "file": "worksheet-teacher.pdf", + "kind": "worksheet", + "audience": "teacher" + } + ] +} diff --git a/assignments/jhs-tech-d2-chat-03-message/worksheet-teacher.pdf b/assignments/jhs-tech-d2-chat-03-message/worksheet-teacher.pdf new file mode 100644 index 00000000000..bdc1d719797 Binary files /dev/null and b/assignments/jhs-tech-d2-chat-03-message/worksheet-teacher.pdf differ diff --git a/assignments/jhs-tech-d2-chat-03-message/worksheet.pdf b/assignments/jhs-tech-d2-chat-03-message/worksheet.pdf new file mode 100644 index 00000000000..8f1e464cb7f Binary files /dev/null and b/assignments/jhs-tech-d2-chat-03-message/worksheet.pdf differ diff --git a/assignments/jhs-tech-d2-chat-04-mesh/0.1.0/assignment.json b/assignments/jhs-tech-d2-chat-04-mesh/0.1.0/assignment.json new file mode 100644 index 00000000000..984c45f1525 --- /dev/null +++ b/assignments/jhs-tech-d2-chat-04-mesh/0.1.0/assignment.json @@ -0,0 +1,48 @@ +{ + "schemaVersion": 1, + "id": "jhs-tech-d2-chat-04-mesh", + "version": "0.1.0", + "series": "jhs-tech-d2-chat", + "number": 4, + "title": "ネットワークを利用したプログラム(メッシュ)", + "goal": "メッシュ拡張機能を使って、別のコンピューターと文字をやりとりする。", + "schoolType": "jhs", + "subject": "技術・家庭科〈技術分野〉", + "curriculum": "D(2) 双方向性のあるコンテンツのプログラミングによる問題解決", + "grade": 2, + "hours": 1, + "starter": null, + "license": "CC0-1.0", + "worksheetPages": [ + 5 + ], + "lessons": [ + { + "course": "chat-wo-tsukurou", + "lessons": [ + "chat-l3", + "chat-l4" + ], + "challenges": [ + "chat-l3-mesh-signal", + "chat-l3-mesh-variable" + ] + } + ], + "submit": { + "project": "04_チャット基本", + "worksheet": false + }, + "files": [ + { + "file": "worksheet.pdf", + "kind": "worksheet", + "audience": "student" + }, + { + "file": "worksheet-teacher.pdf", + "kind": "worksheet", + "audience": "teacher" + } + ] +} diff --git a/assignments/jhs-tech-d2-chat-04-mesh/0.1.0/worksheet-teacher.pdf b/assignments/jhs-tech-d2-chat-04-mesh/0.1.0/worksheet-teacher.pdf new file mode 100644 index 00000000000..a5fff88b43b Binary files /dev/null and b/assignments/jhs-tech-d2-chat-04-mesh/0.1.0/worksheet-teacher.pdf differ diff --git a/assignments/jhs-tech-d2-chat-04-mesh/0.1.0/worksheet.pdf b/assignments/jhs-tech-d2-chat-04-mesh/0.1.0/worksheet.pdf new file mode 100644 index 00000000000..264cdbeefd0 Binary files /dev/null and b/assignments/jhs-tech-d2-chat-04-mesh/0.1.0/worksheet.pdf differ diff --git a/assignments/jhs-tech-d2-chat-04-mesh/assignment.json b/assignments/jhs-tech-d2-chat-04-mesh/assignment.json new file mode 100644 index 00000000000..984c45f1525 --- /dev/null +++ b/assignments/jhs-tech-d2-chat-04-mesh/assignment.json @@ -0,0 +1,48 @@ +{ + "schemaVersion": 1, + "id": "jhs-tech-d2-chat-04-mesh", + "version": "0.1.0", + "series": "jhs-tech-d2-chat", + "number": 4, + "title": "ネットワークを利用したプログラム(メッシュ)", + "goal": "メッシュ拡張機能を使って、別のコンピューターと文字をやりとりする。", + "schoolType": "jhs", + "subject": "技術・家庭科〈技術分野〉", + "curriculum": "D(2) 双方向性のあるコンテンツのプログラミングによる問題解決", + "grade": 2, + "hours": 1, + "starter": null, + "license": "CC0-1.0", + "worksheetPages": [ + 5 + ], + "lessons": [ + { + "course": "chat-wo-tsukurou", + "lessons": [ + "chat-l3", + "chat-l4" + ], + "challenges": [ + "chat-l3-mesh-signal", + "chat-l3-mesh-variable" + ] + } + ], + "submit": { + "project": "04_チャット基本", + "worksheet": false + }, + "files": [ + { + "file": "worksheet.pdf", + "kind": "worksheet", + "audience": "student" + }, + { + "file": "worksheet-teacher.pdf", + "kind": "worksheet", + "audience": "teacher" + } + ] +} diff --git a/assignments/jhs-tech-d2-chat-04-mesh/worksheet-teacher.pdf b/assignments/jhs-tech-d2-chat-04-mesh/worksheet-teacher.pdf new file mode 100644 index 00000000000..a5fff88b43b Binary files /dev/null and b/assignments/jhs-tech-d2-chat-04-mesh/worksheet-teacher.pdf differ diff --git a/assignments/jhs-tech-d2-chat-04-mesh/worksheet.pdf b/assignments/jhs-tech-d2-chat-04-mesh/worksheet.pdf new file mode 100644 index 00000000000..264cdbeefd0 Binary files /dev/null and b/assignments/jhs-tech-d2-chat-04-mesh/worksheet.pdf differ diff --git a/assignments/jhs-tech-d2-chat-05-find-problems/0.1.0/assignment.json b/assignments/jhs-tech-d2-chat-05-find-problems/0.1.0/assignment.json new file mode 100644 index 00000000000..dec3aeffd13 --- /dev/null +++ b/assignments/jhs-tech-d2-chat-05-find-problems/0.1.0/assignment.json @@ -0,0 +1,43 @@ +{ + "schemaVersion": 1, + "id": "jhs-tech-d2-chat-05-find-problems", + "version": "0.1.0", + "series": "jhs-tech-d2-chat", + "number": 5, + "title": "チャットを便利・快適・安全にする", + "goal": "チャットの問題を見つけ、それを直す機能にはどんなものがあるかを知る。", + "schoolType": "jhs", + "subject": "技術・家庭科〈技術分野〉", + "curriculum": "D(2) 双方向性のあるコンテンツのプログラミングによる問題解決", + "grade": 2, + "hours": 1, + "starter": null, + "license": "CC0-1.0", + "worksheetPages": [ + 6 + ], + "lessons": [ + { + "course": "chat-wo-tsukurou", + "lessons": [ + "chat-l5" + ] + } + ], + "submit": { + "project": null, + "worksheet": true + }, + "files": [ + { + "file": "worksheet.pdf", + "kind": "worksheet", + "audience": "student" + }, + { + "file": "worksheet-teacher.pdf", + "kind": "worksheet", + "audience": "teacher" + } + ] +} diff --git a/assignments/jhs-tech-d2-chat-05-find-problems/0.1.0/worksheet-teacher.pdf b/assignments/jhs-tech-d2-chat-05-find-problems/0.1.0/worksheet-teacher.pdf new file mode 100644 index 00000000000..b0d5be81b99 Binary files /dev/null and b/assignments/jhs-tech-d2-chat-05-find-problems/0.1.0/worksheet-teacher.pdf differ diff --git a/assignments/jhs-tech-d2-chat-05-find-problems/0.1.0/worksheet.pdf b/assignments/jhs-tech-d2-chat-05-find-problems/0.1.0/worksheet.pdf new file mode 100644 index 00000000000..631ed8e7bb4 Binary files /dev/null and b/assignments/jhs-tech-d2-chat-05-find-problems/0.1.0/worksheet.pdf differ diff --git a/assignments/jhs-tech-d2-chat-05-find-problems/assignment.json b/assignments/jhs-tech-d2-chat-05-find-problems/assignment.json new file mode 100644 index 00000000000..dec3aeffd13 --- /dev/null +++ b/assignments/jhs-tech-d2-chat-05-find-problems/assignment.json @@ -0,0 +1,43 @@ +{ + "schemaVersion": 1, + "id": "jhs-tech-d2-chat-05-find-problems", + "version": "0.1.0", + "series": "jhs-tech-d2-chat", + "number": 5, + "title": "チャットを便利・快適・安全にする", + "goal": "チャットの問題を見つけ、それを直す機能にはどんなものがあるかを知る。", + "schoolType": "jhs", + "subject": "技術・家庭科〈技術分野〉", + "curriculum": "D(2) 双方向性のあるコンテンツのプログラミングによる問題解決", + "grade": 2, + "hours": 1, + "starter": null, + "license": "CC0-1.0", + "worksheetPages": [ + 6 + ], + "lessons": [ + { + "course": "chat-wo-tsukurou", + "lessons": [ + "chat-l5" + ] + } + ], + "submit": { + "project": null, + "worksheet": true + }, + "files": [ + { + "file": "worksheet.pdf", + "kind": "worksheet", + "audience": "student" + }, + { + "file": "worksheet-teacher.pdf", + "kind": "worksheet", + "audience": "teacher" + } + ] +} diff --git a/assignments/jhs-tech-d2-chat-05-find-problems/worksheet-teacher.pdf b/assignments/jhs-tech-d2-chat-05-find-problems/worksheet-teacher.pdf new file mode 100644 index 00000000000..b0d5be81b99 Binary files /dev/null and b/assignments/jhs-tech-d2-chat-05-find-problems/worksheet-teacher.pdf differ diff --git a/assignments/jhs-tech-d2-chat-05-find-problems/worksheet.pdf b/assignments/jhs-tech-d2-chat-05-find-problems/worksheet.pdf new file mode 100644 index 00000000000..631ed8e7bb4 Binary files /dev/null and b/assignments/jhs-tech-d2-chat-05-find-problems/worksheet.pdf differ diff --git a/assignments/jhs-tech-d2-chat-06-design/0.1.0/assignment.json b/assignments/jhs-tech-d2-chat-06-design/0.1.0/assignment.json new file mode 100644 index 00000000000..b0a3295abef --- /dev/null +++ b/assignments/jhs-tech-d2-chat-06-design/0.1.0/assignment.json @@ -0,0 +1,36 @@ +{ + "schemaVersion": 1, + "id": "jhs-tech-d2-chat-06-design", + "version": "0.1.0", + "series": "jhs-tech-d2-chat", + "number": 6, + "title": "便利・快適・安全なチャットを設計しよう", + "goal": "見つけた問題から課題を決め、解決のしかたを考えて、手順をアクティビティ図にする(設計シート)。", + "schoolType": "jhs", + "subject": "技術・家庭科〈技術分野〉", + "curriculum": "D(2) 双方向性のあるコンテンツのプログラミングによる問題解決", + "grade": 2, + "hours": 1, + "starter": null, + "license": "CC0-1.0", + "worksheetPages": [ + 7 + ], + "lessons": [], + "submit": { + "project": null, + "worksheet": true + }, + "files": [ + { + "file": "worksheet.pdf", + "kind": "worksheet", + "audience": "student" + }, + { + "file": "worksheet-teacher.pdf", + "kind": "worksheet", + "audience": "teacher" + } + ] +} diff --git a/assignments/jhs-tech-d2-chat-06-design/0.1.0/worksheet-teacher.pdf b/assignments/jhs-tech-d2-chat-06-design/0.1.0/worksheet-teacher.pdf new file mode 100644 index 00000000000..4083d43f94d Binary files /dev/null and b/assignments/jhs-tech-d2-chat-06-design/0.1.0/worksheet-teacher.pdf differ diff --git a/assignments/jhs-tech-d2-chat-06-design/0.1.0/worksheet.pdf b/assignments/jhs-tech-d2-chat-06-design/0.1.0/worksheet.pdf new file mode 100644 index 00000000000..76ffd4926b4 Binary files /dev/null and b/assignments/jhs-tech-d2-chat-06-design/0.1.0/worksheet.pdf differ diff --git a/assignments/jhs-tech-d2-chat-06-design/assignment.json b/assignments/jhs-tech-d2-chat-06-design/assignment.json new file mode 100644 index 00000000000..b0a3295abef --- /dev/null +++ b/assignments/jhs-tech-d2-chat-06-design/assignment.json @@ -0,0 +1,36 @@ +{ + "schemaVersion": 1, + "id": "jhs-tech-d2-chat-06-design", + "version": "0.1.0", + "series": "jhs-tech-d2-chat", + "number": 6, + "title": "便利・快適・安全なチャットを設計しよう", + "goal": "見つけた問題から課題を決め、解決のしかたを考えて、手順をアクティビティ図にする(設計シート)。", + "schoolType": "jhs", + "subject": "技術・家庭科〈技術分野〉", + "curriculum": "D(2) 双方向性のあるコンテンツのプログラミングによる問題解決", + "grade": 2, + "hours": 1, + "starter": null, + "license": "CC0-1.0", + "worksheetPages": [ + 7 + ], + "lessons": [], + "submit": { + "project": null, + "worksheet": true + }, + "files": [ + { + "file": "worksheet.pdf", + "kind": "worksheet", + "audience": "student" + }, + { + "file": "worksheet-teacher.pdf", + "kind": "worksheet", + "audience": "teacher" + } + ] +} diff --git a/assignments/jhs-tech-d2-chat-06-design/worksheet-teacher.pdf b/assignments/jhs-tech-d2-chat-06-design/worksheet-teacher.pdf new file mode 100644 index 00000000000..4083d43f94d Binary files /dev/null and b/assignments/jhs-tech-d2-chat-06-design/worksheet-teacher.pdf differ diff --git a/assignments/jhs-tech-d2-chat-06-design/worksheet.pdf b/assignments/jhs-tech-d2-chat-06-design/worksheet.pdf new file mode 100644 index 00000000000..76ffd4926b4 Binary files /dev/null and b/assignments/jhs-tech-d2-chat-06-design/worksheet.pdf differ diff --git a/assignments/jhs-tech-d2-chat-07-build-debug/0.1.0/assignment.json b/assignments/jhs-tech-d2-chat-07-build-debug/0.1.0/assignment.json new file mode 100644 index 00000000000..c345171ad70 --- /dev/null +++ b/assignments/jhs-tech-d2-chat-07-build-debug/0.1.0/assignment.json @@ -0,0 +1,36 @@ +{ + "schemaVersion": 1, + "id": "jhs-tech-d2-chat-07-build-debug", + "version": "0.1.0", + "series": "jhs-tech-d2-chat", + "number": 7, + "title": "チャットを作ろう(制作とデバッグ)", + "goal": "設計シートのとおりに作り、少し作るたびに動かして確かめ、思ったとおりに動かないところを直す(デバッグ)。", + "schoolType": "jhs", + "subject": "技術・家庭科〈技術分野〉", + "curriculum": "D(2) 双方向性のあるコンテンツのプログラミングによる問題解決", + "grade": 2, + "hours": 1, + "starter": null, + "license": "CC0-1.0", + "worksheetPages": [ + 8 + ], + "lessons": [], + "submit": { + "project": "05_◯◯チャット", + "worksheet": true + }, + "files": [ + { + "file": "worksheet.pdf", + "kind": "worksheet", + "audience": "student" + }, + { + "file": "worksheet-teacher.pdf", + "kind": "worksheet", + "audience": "teacher" + } + ] +} diff --git a/assignments/jhs-tech-d2-chat-07-build-debug/0.1.0/worksheet-teacher.pdf b/assignments/jhs-tech-d2-chat-07-build-debug/0.1.0/worksheet-teacher.pdf new file mode 100644 index 00000000000..30fc0823e87 Binary files /dev/null and b/assignments/jhs-tech-d2-chat-07-build-debug/0.1.0/worksheet-teacher.pdf differ diff --git a/assignments/jhs-tech-d2-chat-07-build-debug/0.1.0/worksheet.pdf b/assignments/jhs-tech-d2-chat-07-build-debug/0.1.0/worksheet.pdf new file mode 100644 index 00000000000..1135cf0b739 Binary files /dev/null and b/assignments/jhs-tech-d2-chat-07-build-debug/0.1.0/worksheet.pdf differ diff --git a/assignments/jhs-tech-d2-chat-07-build-debug/assignment.json b/assignments/jhs-tech-d2-chat-07-build-debug/assignment.json new file mode 100644 index 00000000000..c345171ad70 --- /dev/null +++ b/assignments/jhs-tech-d2-chat-07-build-debug/assignment.json @@ -0,0 +1,36 @@ +{ + "schemaVersion": 1, + "id": "jhs-tech-d2-chat-07-build-debug", + "version": "0.1.0", + "series": "jhs-tech-d2-chat", + "number": 7, + "title": "チャットを作ろう(制作とデバッグ)", + "goal": "設計シートのとおりに作り、少し作るたびに動かして確かめ、思ったとおりに動かないところを直す(デバッグ)。", + "schoolType": "jhs", + "subject": "技術・家庭科〈技術分野〉", + "curriculum": "D(2) 双方向性のあるコンテンツのプログラミングによる問題解決", + "grade": 2, + "hours": 1, + "starter": null, + "license": "CC0-1.0", + "worksheetPages": [ + 8 + ], + "lessons": [], + "submit": { + "project": "05_◯◯チャット", + "worksheet": true + }, + "files": [ + { + "file": "worksheet.pdf", + "kind": "worksheet", + "audience": "student" + }, + { + "file": "worksheet-teacher.pdf", + "kind": "worksheet", + "audience": "teacher" + } + ] +} diff --git a/assignments/jhs-tech-d2-chat-07-build-debug/worksheet-teacher.pdf b/assignments/jhs-tech-d2-chat-07-build-debug/worksheet-teacher.pdf new file mode 100644 index 00000000000..30fc0823e87 Binary files /dev/null and b/assignments/jhs-tech-d2-chat-07-build-debug/worksheet-teacher.pdf differ diff --git a/assignments/jhs-tech-d2-chat-07-build-debug/worksheet.pdf b/assignments/jhs-tech-d2-chat-07-build-debug/worksheet.pdf new file mode 100644 index 00000000000..1135cf0b739 Binary files /dev/null and b/assignments/jhs-tech-d2-chat-07-build-debug/worksheet.pdf differ diff --git a/assignments/jhs-tech-d2-chat-08-evaluate-improve/0.1.0/assignment.json b/assignments/jhs-tech-d2-chat-08-evaluate-improve/0.1.0/assignment.json new file mode 100644 index 00000000000..de3b65c7be8 --- /dev/null +++ b/assignments/jhs-tech-d2-chat-08-evaluate-improve/0.1.0/assignment.json @@ -0,0 +1,38 @@ +{ + "schemaVersion": 1, + "id": "jhs-tech-d2-chat-08-evaluate-improve", + "version": "0.1.0", + "series": "jhs-tech-d2-chat", + "number": 8, + "title": "評価・改善とまとめ", + "goal": "おたがいのチャットを使って評価し、直すところを決めて改善し、単元をふりかえる。", + "schoolType": "jhs", + "subject": "技術・家庭科〈技術分野〉", + "curriculum": "D(2) 双方向性のあるコンテンツのプログラミングによる問題解決", + "grade": 2, + "hours": 1, + "starter": null, + "license": "CC0-1.0", + "worksheetPages": [ + 9, + 10, + 11 + ], + "lessons": [], + "submit": { + "project": "06_◯◯チャット改良版", + "worksheet": true + }, + "files": [ + { + "file": "worksheet.pdf", + "kind": "worksheet", + "audience": "student" + }, + { + "file": "worksheet-teacher.pdf", + "kind": "worksheet", + "audience": "teacher" + } + ] +} diff --git a/assignments/jhs-tech-d2-chat-08-evaluate-improve/0.1.0/worksheet-teacher.pdf b/assignments/jhs-tech-d2-chat-08-evaluate-improve/0.1.0/worksheet-teacher.pdf new file mode 100644 index 00000000000..441c0a704e5 Binary files /dev/null and b/assignments/jhs-tech-d2-chat-08-evaluate-improve/0.1.0/worksheet-teacher.pdf differ diff --git a/assignments/jhs-tech-d2-chat-08-evaluate-improve/0.1.0/worksheet.pdf b/assignments/jhs-tech-d2-chat-08-evaluate-improve/0.1.0/worksheet.pdf new file mode 100644 index 00000000000..6e6d3fdeabb Binary files /dev/null and b/assignments/jhs-tech-d2-chat-08-evaluate-improve/0.1.0/worksheet.pdf differ diff --git a/assignments/jhs-tech-d2-chat-08-evaluate-improve/assignment.json b/assignments/jhs-tech-d2-chat-08-evaluate-improve/assignment.json new file mode 100644 index 00000000000..de3b65c7be8 --- /dev/null +++ b/assignments/jhs-tech-d2-chat-08-evaluate-improve/assignment.json @@ -0,0 +1,38 @@ +{ + "schemaVersion": 1, + "id": "jhs-tech-d2-chat-08-evaluate-improve", + "version": "0.1.0", + "series": "jhs-tech-d2-chat", + "number": 8, + "title": "評価・改善とまとめ", + "goal": "おたがいのチャットを使って評価し、直すところを決めて改善し、単元をふりかえる。", + "schoolType": "jhs", + "subject": "技術・家庭科〈技術分野〉", + "curriculum": "D(2) 双方向性のあるコンテンツのプログラミングによる問題解決", + "grade": 2, + "hours": 1, + "starter": null, + "license": "CC0-1.0", + "worksheetPages": [ + 9, + 10, + 11 + ], + "lessons": [], + "submit": { + "project": "06_◯◯チャット改良版", + "worksheet": true + }, + "files": [ + { + "file": "worksheet.pdf", + "kind": "worksheet", + "audience": "student" + }, + { + "file": "worksheet-teacher.pdf", + "kind": "worksheet", + "audience": "teacher" + } + ] +} diff --git a/assignments/jhs-tech-d2-chat-08-evaluate-improve/worksheet-teacher.pdf b/assignments/jhs-tech-d2-chat-08-evaluate-improve/worksheet-teacher.pdf new file mode 100644 index 00000000000..441c0a704e5 Binary files /dev/null and b/assignments/jhs-tech-d2-chat-08-evaluate-improve/worksheet-teacher.pdf differ diff --git a/assignments/jhs-tech-d2-chat-08-evaluate-improve/worksheet.pdf b/assignments/jhs-tech-d2-chat-08-evaluate-improve/worksheet.pdf new file mode 100644 index 00000000000..6e6d3fdeabb Binary files /dev/null and b/assignments/jhs-tech-d2-chat-08-evaluate-improve/worksheet.pdf differ diff --git a/assignments/jhs-tech-d2-chat/0.1.0/rubric.pdf b/assignments/jhs-tech-d2-chat/0.1.0/rubric.pdf new file mode 100644 index 00000000000..0b37aaebc31 Binary files /dev/null and b/assignments/jhs-tech-d2-chat/0.1.0/rubric.pdf differ diff --git a/assignments/jhs-tech-d2-chat/0.1.0/series.json b/assignments/jhs-tech-d2-chat/0.1.0/series.json new file mode 100644 index 00000000000..bf849b88158 --- /dev/null +++ b/assignments/jhs-tech-d2-chat/0.1.0/series.json @@ -0,0 +1,30 @@ +{ + "schemaVersion": 1, + "id": "jhs-tech-d2-chat", + "version": "0.1.0", + "title": "双方向性のあるコンテンツ(チャットを作ろう)", + "description": "中学校 技術・家庭科〈技術分野〉D(2) の 8 時間の単元。チャットを題材に、入力と応答・メッセージ・ネットワーク(メッシュ)を学び、問題の発見・設計・制作・評価・改善を一巡する。1 時間が 1 つの課題。", + "schoolType": "jhs", + "subject": "技術・家庭科〈技術分野〉", + "curriculum": "D(2) 双方向性のあるコンテンツのプログラミングによる問題解決", + "grade": 2, + "license": "CC0-1.0", + "hours": 8, + "assignments": [ + "jhs-tech-d2-chat-01-intro", + "jhs-tech-d2-chat-02-input-output", + "jhs-tech-d2-chat-03-message", + "jhs-tech-d2-chat-04-mesh", + "jhs-tech-d2-chat-05-find-problems", + "jhs-tech-d2-chat-06-design", + "jhs-tech-d2-chat-07-build-debug", + "jhs-tech-d2-chat-08-evaluate-improve" + ], + "files": [ + { + "file": "rubric.pdf", + "kind": "rubric", + "audience": "teacher" + } + ] +} diff --git a/assignments/jhs-tech-d2-chat/rubric.pdf b/assignments/jhs-tech-d2-chat/rubric.pdf new file mode 100644 index 00000000000..0b37aaebc31 Binary files /dev/null and b/assignments/jhs-tech-d2-chat/rubric.pdf differ diff --git a/assignments/jhs-tech-d2-chat/series.json b/assignments/jhs-tech-d2-chat/series.json new file mode 100644 index 00000000000..bf849b88158 --- /dev/null +++ b/assignments/jhs-tech-d2-chat/series.json @@ -0,0 +1,30 @@ +{ + "schemaVersion": 1, + "id": "jhs-tech-d2-chat", + "version": "0.1.0", + "title": "双方向性のあるコンテンツ(チャットを作ろう)", + "description": "中学校 技術・家庭科〈技術分野〉D(2) の 8 時間の単元。チャットを題材に、入力と応答・メッセージ・ネットワーク(メッシュ)を学び、問題の発見・設計・制作・評価・改善を一巡する。1 時間が 1 つの課題。", + "schoolType": "jhs", + "subject": "技術・家庭科〈技術分野〉", + "curriculum": "D(2) 双方向性のあるコンテンツのプログラミングによる問題解決", + "grade": 2, + "license": "CC0-1.0", + "hours": 8, + "assignments": [ + "jhs-tech-d2-chat-01-intro", + "jhs-tech-d2-chat-02-input-output", + "jhs-tech-d2-chat-03-message", + "jhs-tech-d2-chat-04-mesh", + "jhs-tech-d2-chat-05-find-problems", + "jhs-tech-d2-chat-06-design", + "jhs-tech-d2-chat-07-build-debug", + "jhs-tech-d2-chat-08-evaluate-improve" + ], + "files": [ + { + "file": "rubric.pdf", + "kind": "rubric", + "audience": "teacher" + } + ] +} diff --git a/docs/README.md b/docs/README.md index 66be3412e5f..edee99d0c93 100644 --- a/docs/README.md +++ b/docs/README.md @@ -41,6 +41,7 @@ smalruby3-editor の機能ドキュメントは **ユーザーストーリー単 |---|---|---| | [`google-drive/`](google-drive/) — Google Drive 保存・読込 | 🆕 独自 | ✅ | | [`classroom/`](classroom/) — クラスルーム機能 | 🆕 独自 | ✅ | +| [`standard-assignments/`](standard-assignments/) — 標準課題(`assignments/`。授業 1 時間ごとのワークシート・評価規準を CC0 で公開) | 🆕 独自 | ✏️ | | [`mesh-v2/`](mesh-v2/) — Mesh v2 ネットワーク | 🆕 独自 | ✅ | | [`device-connection/`](device-connection/) — connection-modal 共通基盤 | 🔧 改良 | ✅ | diff --git a/docs/analytics/README.md b/docs/analytics/README.md index 911b6689209..e0d513f43c3 100644 --- a/docs/analytics/README.md +++ b/docs/analytics/README.md @@ -72,8 +72,9 @@ GA4(プロパティ smalruby.app / 測定 ID G-94VC8N0J4K) | `classroom_student` | `lib/classroom-student-analytics.js` | [`classroom/ui-ux.md`](../classroom/ui-ux.md) の「GA の計測(生徒の参加〜提出)」 | ✅ | | `google_drive` | `containers/google-drive-saver-hoc.jsx` | [`google-drive/`](../google-drive/) | ✅ | | `mesh_v2` / `smalrubot_s1` | `containers/connection-modal.jsx` | [`mesh-v2/`](../mesh-v2/)・[`extension-smalrubot-s1/`](../extension-smalrubot-s1/) | ✅ | -| `lessons` | `lib/lessons/lesson-analytics.js` | [`lessons/README.md`](../lessons/README.md) の「GA の計測」 | ✅ | +| `lessons` | `lib/lessons/lesson-analytics.js`(右クリックのアクティビティ図 `activity_diagram_open` は `containers/block-activity-diagram.jsx` から) | [`lessons/README.md`](../lessons/README.md) の「GA の計測」 | ✅ | | `welcome` | `components/welcome-tooltip/`・`containers/welcome-modal-hoc.jsx` | [`welcome/README.md`](../welcome/README.md) の「GA4 イベント」 | ✅ | +| `tutorial_url` | `lib/tutorial-url-analytics.js`(`lib/tutorial-from-url.js` から) | [`tutorial/README.md`](../tutorial/README.md) の「GA の計測」 | ❌(トリガーの正規表現に足す人間の作業待ち) | | `extensions` / `library` / `open_debug_modal` / `close_debug_modal` / `change_topic_debug_modal` | upstream のコード | — | ❌(upstream のイベント。数えていない) | ### 項目の一覧(データレイヤー変数 = タグのパラメータ = GA4 のカスタム定義) @@ -81,7 +82,7 @@ GA4(プロパティ smalruby.app / 測定 ID G-94VC8N0J4K) | 項目 | 使う category | GA4 | |---|---|---| | `action` | すべて | ディメンション | -| `label` | すべて(`lessons`・`welcome` などが使う。`classroom_student` は使わない) | ディメンション | +| `label` | すべて(`lessons`・`welcome`・`tutorial_url` などが使う。`classroom_student` は使わない) | ディメンション | | `course_id` / `lesson_id` / `challenge_id` / `from_assignment` / `page` | `lessons` | ディメンション | | `seconds` | `lessons`・`classroom_student` | **指標**(秒) | | `minutes` | `classroom_student` | **指標**(分) | diff --git a/docs/classroom/screenshots/0204-teacher-detail.png b/docs/classroom/screenshots/0204-teacher-detail.png index 2a289e61805..571cb3b917c 100644 Binary files a/docs/classroom/screenshots/0204-teacher-detail.png and b/docs/classroom/screenshots/0204-teacher-detail.png differ diff --git a/docs/classroom/screenshots/0205-teacher-detail-submitted.png b/docs/classroom/screenshots/0205-teacher-detail-submitted.png index 50754e2cf31..2263b725f40 100644 Binary files a/docs/classroom/screenshots/0205-teacher-detail-submitted.png and b/docs/classroom/screenshots/0205-teacher-detail-submitted.png differ diff --git a/docs/classroom/screenshots/0206-teacher-member-detail.png b/docs/classroom/screenshots/0206-teacher-member-detail.png index 1adf5181d1d..45e3ff8a60a 100644 Binary files a/docs/classroom/screenshots/0206-teacher-member-detail.png and b/docs/classroom/screenshots/0206-teacher-member-detail.png differ diff --git a/docs/classroom/screenshots/0208-teacher-kick-request-panel.png b/docs/classroom/screenshots/0208-teacher-kick-request-panel.png index 862d7233156..df55ab9a0dd 100644 Binary files a/docs/classroom/screenshots/0208-teacher-kick-request-panel.png and b/docs/classroom/screenshots/0208-teacher-kick-request-panel.png differ diff --git a/docs/classroom/screenshots/0212-teacher-detail-description.png b/docs/classroom/screenshots/0212-teacher-detail-description.png index a974b51aab1..41006b5d958 100644 Binary files a/docs/classroom/screenshots/0212-teacher-detail-description.png and b/docs/classroom/screenshots/0212-teacher-detail-description.png differ diff --git a/docs/classroom/screenshots/0214-detail-retention-banner.png b/docs/classroom/screenshots/0214-detail-retention-banner.png index 92c7a49be86..08dfb3599d8 100644 Binary files a/docs/classroom/screenshots/0214-detail-retention-banner.png and b/docs/classroom/screenshots/0214-detail-retention-banner.png differ diff --git a/docs/classroom/screenshots/0215-class-archive-confirm.png b/docs/classroom/screenshots/0215-class-archive-confirm.png index d1460a9a272..dfb76e70de8 100644 Binary files a/docs/classroom/screenshots/0215-class-archive-confirm.png and b/docs/classroom/screenshots/0215-class-archive-confirm.png differ diff --git a/docs/classroom/screenshots/0219-share-suggestion-banner.png b/docs/classroom/screenshots/0219-share-suggestion-banner.png index 9a2bdd6f0fe..40ae043d3fa 100644 Binary files a/docs/classroom/screenshots/0219-share-suggestion-banner.png and b/docs/classroom/screenshots/0219-share-suggestion-banner.png differ diff --git a/docs/classroom/screenshots/0222-teacher-description-peer-view.png b/docs/classroom/screenshots/0222-teacher-description-peer-view.png index aa731a9b74c..1c0572b7e69 100644 Binary files a/docs/classroom/screenshots/0222-teacher-description-peer-view.png and b/docs/classroom/screenshots/0222-teacher-description-peer-view.png differ diff --git a/docs/classroom/screenshots/0223-teacher-member-detail-hide-from-peers.png b/docs/classroom/screenshots/0223-teacher-member-detail-hide-from-peers.png index b9166d65f11..46a18c0775e 100644 Binary files a/docs/classroom/screenshots/0223-teacher-member-detail-hide-from-peers.png and b/docs/classroom/screenshots/0223-teacher-member-detail-hide-from-peers.png differ diff --git a/docs/classroom/screenshots/0226-board-create-assignment.png b/docs/classroom/screenshots/0226-board-create-assignment.png index f439f80d8d0..b604cae2175 100644 Binary files a/docs/classroom/screenshots/0226-board-create-assignment.png and b/docs/classroom/screenshots/0226-board-create-assignment.png differ diff --git a/docs/classroom/screenshots/0227-detail-more-menu.png b/docs/classroom/screenshots/0227-detail-more-menu.png index d465ee3db1e..470e3655bae 100644 Binary files a/docs/classroom/screenshots/0227-detail-more-menu.png and b/docs/classroom/screenshots/0227-detail-more-menu.png differ diff --git a/docs/classroom/screenshots/0228-detail-advanced-settings.png b/docs/classroom/screenshots/0228-detail-advanced-settings.png index cf8273317d5..12eea7d6711 100644 Binary files a/docs/classroom/screenshots/0228-detail-advanced-settings.png and b/docs/classroom/screenshots/0228-detail-advanced-settings.png differ diff --git a/docs/classroom/screenshots/0230-class-ai-settings-confirm.png b/docs/classroom/screenshots/0230-class-ai-settings-confirm.png index a8841836d6a..65d72943e35 100644 Binary files a/docs/classroom/screenshots/0230-class-ai-settings-confirm.png and b/docs/classroom/screenshots/0230-class-ai-settings-confirm.png differ diff --git a/docs/classroom/screenshots/0231-class-ai-settings-service.png b/docs/classroom/screenshots/0231-class-ai-settings-service.png index f487462fc73..c25c8edd78b 100644 Binary files a/docs/classroom/screenshots/0231-class-ai-settings-service.png and b/docs/classroom/screenshots/0231-class-ai-settings-service.png differ diff --git a/docs/classroom/screenshots/0232-class-ai-settings-other.png b/docs/classroom/screenshots/0232-class-ai-settings-other.png index 73616a9b035..265732d94d3 100644 Binary files a/docs/classroom/screenshots/0232-class-ai-settings-other.png and b/docs/classroom/screenshots/0232-class-ai-settings-other.png differ diff --git a/docs/classroom/screenshots/0233-detail-description-empty.png b/docs/classroom/screenshots/0233-detail-description-empty.png index 94e7ae4c4d3..62857457c0d 100644 Binary files a/docs/classroom/screenshots/0233-detail-description-empty.png and b/docs/classroom/screenshots/0233-detail-description-empty.png differ diff --git a/docs/classroom/screenshots/0239-detail-advanced-unsaved.png b/docs/classroom/screenshots/0239-detail-advanced-unsaved.png index a36adddb898..a3f02e80207 100644 Binary files a/docs/classroom/screenshots/0239-detail-advanced-unsaved.png and b/docs/classroom/screenshots/0239-detail-advanced-unsaved.png differ diff --git a/docs/classroom/screenshots/0240-detail-assignment-name-focused.png b/docs/classroom/screenshots/0240-detail-assignment-name-focused.png index 2e7779364a1..e81225a749f 100644 Binary files a/docs/classroom/screenshots/0240-detail-assignment-name-focused.png and b/docs/classroom/screenshots/0240-detail-assignment-name-focused.png differ diff --git a/docs/classroom/screenshots/0241-detail-assignment-name-saved.png b/docs/classroom/screenshots/0241-detail-assignment-name-saved.png index c899388bd61..98228315b7c 100644 Binary files a/docs/classroom/screenshots/0241-detail-assignment-name-saved.png and b/docs/classroom/screenshots/0241-detail-assignment-name-saved.png differ diff --git a/docs/classroom/screenshots/0242-class-ai-settings-rubytee-confirm.png b/docs/classroom/screenshots/0242-class-ai-settings-rubytee-confirm.png index d64659ea428..d1d60f18592 100644 Binary files a/docs/classroom/screenshots/0242-class-ai-settings-rubytee-confirm.png and b/docs/classroom/screenshots/0242-class-ai-settings-rubytee-confirm.png differ diff --git a/docs/classroom/screenshots/0243-class-ai-settings-rubytee-unconfirmed.png b/docs/classroom/screenshots/0243-class-ai-settings-rubytee-unconfirmed.png index 1fa26159990..060ce696ffd 100644 Binary files a/docs/classroom/screenshots/0243-class-ai-settings-rubytee-unconfirmed.png and b/docs/classroom/screenshots/0243-class-ai-settings-rubytee-unconfirmed.png differ diff --git a/docs/classroom/screenshots/0244-detail-lesson-settings.png b/docs/classroom/screenshots/0244-detail-lesson-settings.png index a73ec9f16a5..5986e92d9d8 100644 Binary files a/docs/classroom/screenshots/0244-detail-lesson-settings.png and b/docs/classroom/screenshots/0244-detail-lesson-settings.png differ diff --git a/docs/classroom/screenshots/0245-detail-lesson-scoring.png b/docs/classroom/screenshots/0245-detail-lesson-scoring.png index d8962d0ea3b..afc7d4a3e22 100644 Binary files a/docs/classroom/screenshots/0245-detail-lesson-scoring.png and b/docs/classroom/screenshots/0245-detail-lesson-scoring.png differ diff --git a/docs/classroom/screenshots/0246-detail-lesson-unknown-course.png b/docs/classroom/screenshots/0246-detail-lesson-unknown-course.png index cc33a7ec50b..2c8569e49a5 100644 Binary files a/docs/classroom/screenshots/0246-detail-lesson-unknown-course.png and b/docs/classroom/screenshots/0246-detail-lesson-unknown-course.png differ diff --git a/docs/classroom/screenshots/0247-detail-lesson-members.png b/docs/classroom/screenshots/0247-detail-lesson-members.png index 973b494127a..f78126ad2b9 100644 Binary files a/docs/classroom/screenshots/0247-detail-lesson-members.png and b/docs/classroom/screenshots/0247-detail-lesson-members.png differ diff --git a/docs/classroom/screenshots/0248-detail-lesson-progress.png b/docs/classroom/screenshots/0248-detail-lesson-progress.png index 831ca848f96..e10e6d6bbf5 100644 Binary files a/docs/classroom/screenshots/0248-detail-lesson-progress.png and b/docs/classroom/screenshots/0248-detail-lesson-progress.png differ diff --git a/docs/classroom/screenshots/0250-detail-lesson-member-detail.png b/docs/classroom/screenshots/0250-detail-lesson-member-detail.png index a4b2e0d1dfe..08bd54383f7 100644 Binary files a/docs/classroom/screenshots/0250-detail-lesson-member-detail.png and b/docs/classroom/screenshots/0250-detail-lesson-member-detail.png differ diff --git a/docs/classroom/screenshots/0256-detail-lesson-create.png b/docs/classroom/screenshots/0256-detail-lesson-create.png index 68b9c26f38e..e341ce46b54 100644 Binary files a/docs/classroom/screenshots/0256-detail-lesson-create.png and b/docs/classroom/screenshots/0256-detail-lesson-create.png differ diff --git a/docs/classroom/screenshots/0257-detail-lesson-description-question.png b/docs/classroom/screenshots/0257-detail-lesson-description-question.png index d7dd917cdf5..1da2ba3005e 100644 Binary files a/docs/classroom/screenshots/0257-detail-lesson-description-question.png and b/docs/classroom/screenshots/0257-detail-lesson-description-question.png differ diff --git a/docs/classroom/screenshots/0258-teacher-member-remove-confirm.png b/docs/classroom/screenshots/0258-teacher-member-remove-confirm.png index d6dd8445037..7d416e8636d 100644 Binary files a/docs/classroom/screenshots/0258-teacher-member-remove-confirm.png and b/docs/classroom/screenshots/0258-teacher-member-remove-confirm.png differ diff --git a/docs/classroom/screenshots/0263-detail-close-discard.png b/docs/classroom/screenshots/0263-detail-close-discard.png new file mode 100644 index 00000000000..49f4587ccd6 Binary files /dev/null and b/docs/classroom/screenshots/0263-detail-close-discard.png differ diff --git a/docs/classroom/source-code.md b/docs/classroom/source-code.md index 9c54ca7e402..7817759208c 100644 --- a/docs/classroom/source-code.md +++ b/docs/classroom/source-code.md @@ -247,8 +247,9 @@ GOOGLE_ID_TOKEN=eyJ... docker compose run --rm -w /app/infra/smalruby-classroom | ファイル | 責務 | |---------|------| -| `classroom-modal/teacher-view-layout.jsx` | `TeacherScreen`(いまいる所を持つトップレベル画面)と `TeacherSubView`(パネル内サブ画面。`as="form"` で `
` になる)。タブの行 → タイトル → 説明 → エラー → 本文 → フッター の順を固定する。`breadcrumbs` は紫のヘッダーへ運ばれる(`teacher-breadcrumbs.jsx`) | +| `classroom-modal/teacher-view-layout.jsx` | `TeacherScreen`(いまいる所を持つトップレベル画面)と `TeacherSubView`(パネル内サブ画面。`as="form"` で `` になる。`onClose` を渡すとタイトルが「✕ + 見出し」の行になる)。タブの行 → タイトル → 説明 → エラー → 本文 → フッター の順を固定する。`breadcrumbs` は紫のヘッダーへ運ばれる(`teacher-breadcrumbs.jsx`) | | `classroom-modal/teacher-breadcrumbs.jsx` | `TeacherBreadcrumbs`(いまいる所「クラス管理 › クラス名 › 課題名」)。`BreadcrumbSlotContext` で渡されたヘッダーの要素へポータルで描く(無ければその場に描く)。いまの画面は太字で `aria-current="page"`、長い名前は「…」で切って `title` に全体。`breadcrumbMessages`(「クラス管理」・nav の名前) | +| `classroom-modal/teacher-close-row.jsx` | `TeacherCloseRow`(1 つの物を編集する画面の本文の上の「✕ + 見出し」の行)。✕ は `onClose`(行き先は画面ごと)、`unsaved` のときは先に行の中で「変更を破棄しますか?」[キャンセル][破棄]を聞く。右端は `children`(課題詳細の参加コード・[課題を保存])。`TeacherSubView` は `onClose` を渡すとタイトルをこの行にする。`closeRowMessages`(✕ の名前・確認の文) | | `classroom-modal/teacher-class-tabs.jsx` | `TeacherClassTabs`(クラスの中のタブ[ストリーム][授業][採点]と、tablist の外の[⚙ クラスの設定])。クラスの画面と採点の画面で使う。`classTabMessages` | | `classroom-teacher-modal/teacher-header.jsx` | `TeacherHeader`(紫のヘッダー「← エディタに戻る|いまいる所」+ 右にベル・アバター)。いまいる所はポータルで運び込まれる要素(`slotRef`)。共有 `Modal` のヘッダーは隠す | | `classroom-modal/class-ai-settings.jsx` | クラス設定の「このクラスで使う AI」欄。「学校の生成AI に相談」(使わない / Gemini / ChatGPT / その他)とルビティー(トグル)の 2 行に、それぞれ生徒の画面に起こることを書く。生成AI を選ぶとその行の下に条件・必須の確認・URL を、ルビティーをオンにするとその行の下に条件・必須の確認を開く。下書きは親のクラス設定フォームが持ち、「保存」で変わった項目だけ送る | diff --git a/docs/classroom/testing.md b/docs/classroom/testing.md index 901d21bfde0..b2b99ce3f27 100644 --- a/docs/classroom/testing.md +++ b/docs/classroom/testing.md @@ -104,7 +104,6 @@ Playwright MCP および Selenium integration tests で使用する `data-testid | `classroom-lesson-progress-current-{challengeId}` | sup | 列のいまやっている人の数(右肩の青い数。いるときだけ) | | `classroom-lesson-progress-loading` | p | はじめの取得が終わるまでの「進み具合を読み込み中…」(メンバータブ・「進み具合」タブ) | | `classroom-lesson-progress-error` | p | はじめの取得から失敗したときの「進み具合を読み込めませんでした。…」 | -| `classroom-detail-compact-code` | div | 「進み具合」タブでの小さな 1 行の参加コード(課題名の欄と保存期限の行の代わり) | | `classroom-lesson-progress-row-{memberId}` | tr | 席の行 | | `classroom-lesson-progress-seat-{memberId}` | button | 席番号(押すと右にメンバーの詳細) | | `classroom-lesson-progress-cell-{memberId}-{challengeId}` | span | セル(`data-kind` = `done` / `before` / `current` / `stuck` / `todo`) | @@ -341,7 +340,7 @@ Playwright MCP および Selenium integration tests で使用する `data-testid | `classroom-lesson-sentence` | span | 生徒に出る文(「6 つのうち 4 つ(★ 2 つをふくむ)」) | | `classroom-lesson-submit-no` / `-yes` | input (radio) | 「提出しない(レッスンだけ)」(既定)/「最後に作品も提出する」 | | `classroom-lesson-dropped-notice` | p | 保存したチャレンジを外したときの注意(送られた進み具合は残るが数えない) | -| `classroom-assignment-save` | button | 課題を保存(フォームの最上段) | +| `classroom-assignment-save` | button | 課題を保存(「説明」タブのときだけ、課題詳細の「✕ + 課題名」の行の右端) | ### 生徒: 始め方(主ボタン・ほかの始め方) @@ -788,6 +787,19 @@ Playwright MCP および Selenium integration tests で使用する `data-testid | `classroom-notification-page-item-{notificationId}` | button | 一覧ページ内のお知らせ 1 件 | | `classroom-notifications-pager` / `-prev` / `-next` | div / button | ページャ(10 件/ページ) | +### 「✕ + 見出し」の行(先生・1 つの物を編集する画面) + +課題詳細・課題を作成・課題を再利用・合言葉で取り込み・課題を共有・Google Classroom への共有・クラスの設定の本文の上に出る。1 画面に 1 つなので、どの画面も同じ testid。 + +| data-testid | 要素 | 説明 | +|------------|------|------| +| `classroom-close-row` | div | 行(課題詳細では課題名の欄・参加コード・[課題を保存]も入る) | +| `classroom-close-row-close` | button | ✕(`aria-label` は行き先: 「課題一覧に戻る」「クラスに戻る」「クラス一覧に戻る」「課題に戻る」) | +| `classroom-close-row-title` | h2 | 見出し(課題詳細は見出しの代わりに課題名の欄 `classroom-detail-assignment-name`) | +| `classroom-close-row-discard-message` | p | 保存していない変更があるときに ✕ を押すと出る「変更を破棄しますか?保存していない変更は消えます。」 | +| `classroom-close-row-discard-cancel` | button | [キャンセル](とどまる) | +| `classroom-close-row-discard` | button | [破棄](変更を捨てて戻る・赤) | + ### 汎用 | data-testid | 要素 | 説明 | diff --git a/docs/classroom/ui-ux.md b/docs/classroom/ui-ux.md index ff96bf8a491..532050ea978 100644 --- a/docs/classroom/ui-ux.md +++ b/docs/classroom/ui-ux.md @@ -369,6 +369,27 @@ stateDiagram-v2 - タブの行の右端に **[⚙ クラスの設定]**(ストリーム・授業のとき)。クラス一覧のカードの「設定」と同じ設定の画面を、クラスの中で開く(いまいる所は「クラス管理 › {クラス名} › **クラスの設定**」)。クラスをアーカイブしたらクラス一覧へ戻る。 - 採点の画面から[ストリーム][授業]へ移るときも、書き出していない採点があれば先に確かめる(「1.10 先生: 採点」)。 - 課題詳細の[説明][メンバー]のタブは、課題の中のタブ(課題詳細の画面の中)。 +- **「✕ + 見出し」の行**(Google Classroom の編集の画面と同じ): **1 つの物を編集する画面**は、本文のいちばん上に、左から **✕** と見出しの行を置く(高さはボタンの 36px・下に線)。✕ は開いた元へ戻る。ヘッダーの「← エディタに戻る」・いまいる所・Esc(クラス管理を閉じてエディタへ)は変えない。 + + | 画面 | 見出し | ✕ の行き先(✕ の名前) | + |---|---|---| + | 課題詳細 | 課題名の欄(右に参加コード・[説明]タブのときは[課題を保存]) | [授業]。開いていた課題の行を開いたまま(「課題一覧に戻る」) | + | 課題を作成 / レッスンの課題を作成 | 課題を作成 / レッスンの課題を作成 | [授業](「課題一覧に戻る」) | + | 課題を再利用 | 課題を再利用 | [授業](「課題一覧に戻る」) | + | 合言葉で取り込み | 合言葉で取り込み | [授業](「課題一覧に戻る」) | + | 課題を共有(みんなの課題) | 課題を共有 / 共有しました | [授業](「課題一覧に戻る」) | + | Google Classroom への共有 | Google Classroom に課題を配信します / ✓ 配信しました! | 課題詳細(「課題に戻る」) | + | クラスの設定(クラスの中) | クラスの設定 | 開いた元のタブ([ストリーム]か[授業]・「クラスに戻る」) | + | クラスの設定(クラス一覧のカードから) | クラスの設定 | クラス一覧(「クラス一覧に戻る」) | + + - ✕ は各画面の[キャンセル]と同じ所へ戻る([キャンセル]はそのまま残す)。 + - **保存していない変更があるとき**(課題詳細の説明・画像・スターター・詳しい設定・レッスンが、読み込んだ・保存したときと違うとき)は、✕ を押すと行の右に淡いオレンジの枠で「変更を破棄しますか?保存していない変更は消えます。」と[キャンセル][破棄]を出す(ブラウザの `confirm()` は使わない)。[キャンセル]でとどまり、[破棄]で戻る。変更は消えて取り消せないので[破棄]は赤(R4)。課題名は欄を出たときに保存されるので数えない。変更が無ければすぐ戻る。 + + ![課題詳細の ✕ で「変更を破棄しますか?」](screenshots/0263-detail-close-discard.png) + + - 聞くのは課題詳細の ✕ だけ。作成・再利用などの画面の ✕ は、これまでの[キャンセル]と同じく聞かずに戻る。いまいる所のリンク(パンくず)もこれまでどおり聞かずに移る。「← エディタに戻る」はクラス管理を隠して残すだけなので、変更は消えず、聞かない。 + - 一覧の行の ⋮ に「編集」は置かない。課題詳細へは、これまでどおり[授業]で行を開いて[課題を開く]。 + - [作品を開く]の後の戻る帯([‹ 課題に戻る])の動きは変えない。 - **上の余白はどの画面も同じ**: ヘッダーの下の余白は、本文の枠の 1rem と各画面の `$space-small`(0.25rem)だけ(合わせて 20px)。授業の PC(1300×600)は高さがせまいので詰めて本文に回す。画面ごとに変えないのは、[ストリーム][授業][採点]を切りかえるたびにタブの行が上下に動かないようにするため(値は `classroom-modal.css` の `$teacher-screen-padding-top` の 1 か所)。 ## 共通: クラスの色 @@ -564,7 +585,7 @@ Google または Microsoft アカウントでサインインする画面。先 課題をひらくと、ふだんは「メンバー」タブが最初に表示される。「説明」タブが最初に出るのは、**このセッションで新しく作った課題をはじめてひらいたときだけ**(説明を書くのは作った直後なので。そこで書かなかった課題は、説明が要らない課題とみなす)。メニューバーの「いまの課題を開く」は常に「メンバー」タブでひらく。「説明」タブでは左に生徒へ表示する説明・画像・スターターの編集フォーム、**右ペインに生徒視点プレビュー**(編集内容をライブ表示・ページ送り。生徒への反映は保存時のみ)。 -- **1300×600 で縦スクロールしない**(R6)。[課題を保存]は説明 1 行の右(タブのすぐ下)に置き、スクロールせずに見える(Google Classroom の[割り当て]と同じく上)。ページの編集欄は先生が数を決める一覧なので、その**枠の中だけ**がスクロールする。スターターと「詳しい設定」はページの右の列 +- **1300×600 で縦スクロールしない**(R6)。[課題を保存]は「✕ + 課題名」の行の右端(参加コードの右)に置き、スクロールせずに見える(Google Classroom の[割り当て]と同じく上。[共通: 画面の組み立て(先生)](#共通-画面の組み立て先生))。ページの編集欄は先生が数を決める一覧なので、その**枠の中だけ**がスクロールする。スターターと「詳しい設定」はページの右の列 - **詳しい設定**(R3): 「他者参照」「メッシュのグループの人数」(レッスンの課題では採点の点も)は「詳しい設定」1 つに畳む。閉じた状態でも「他者参照: しない・メッシュ: 6人まで」と**いまの値**(保存前の選択も含む)を出す。保存した値から変えた設定は、要約の値と開いた中の欄をオレンジ色にし、見出しの横に「保存していません」を出す([課題を保存]で保存すると元の色に戻る。色だけに頼らない・赤は使わない)。開くとページ欄の上に重ねて出し([課題を保存]は隠さない)、右上の **✕(閉じる)**・外を押す・Escape キーのどれかで閉じる(✕ はほかのモーダルの見出しの ✕ と同じ見た目。閉じたら開閉ボタンにフォーカスを戻す) - **プレビューが空のとき**(どのページにも文字も画像も無い)は「ページを書くとここに出ます」の 1 行だけ - **レッスン**欄: コース・チャレンジ・必須(★)・完了の条件・作品の提出・採点の点を選ぶ([レッスンの課題](#レッスンの課題)の「課題の「説明」タブのレッスン欄」) @@ -713,7 +734,7 @@ Google または Microsoft アカウントでサインインする画面。先 ## 4. 先生: 課題詳細のメンバータブ (`teacher-detail`) -1 つの課題(1 授業)の参加状況と提出を管理する画面。クラス名と課題名はヘッダーの「クラス管理 › {クラス名} › {課題名}」に出す(本文の上にクラス名の見出しは置かない)。モーダルが**ワイド表示 (968px)** に広がります。 +1 つの課題(1 授業)の参加状況と提出を管理する画面。クラス名と課題名はヘッダーの「クラス管理 › {クラス名} › {課題名}」に出す(本文の上にクラス名の見出しは置かない)。本文のいちばん上は「✕ + 課題名」の行(✕・課題名の欄・参加コード)で、✕ で[授業]へ戻る([共通: 画面の組み立て(先生)](#共通-画面の組み立て先生))。モーダルが**ワイド表示 (968px)** に広がります。 ### メンバータブ(座席の色の凡例・⋮) @@ -1702,8 +1723,8 @@ ja の例(チャレンジ 6 つ・★ 2・条件 4 つ・作品の提出あり 縦書きのチャレンジ名・「**できた人**」の行(列ごとのできた人の数と、右肩に小さく青でいまやっている人の数)。 チャレンジの色は「できた人」の行の上の線、レッスンの区切りは列の左の線で示し、レッスン名はチャレンジ名に乗せたときに出す。 **1300×600 で席の行が 12 行以上見える**ようにする。 -- このタブを開いている間は、課題名の欄と保存期限の行を畳み(課題名は「説明」タブで直す)、参加コードは小さな 1 行 - (全画面表示のボタンだけ)にする。保存期限が残り 7 日以内のときだけは警告を出したままにする。 +- このタブを開いている間は、保存期限の行を畳む(課題名の欄と参加コードは、どのタブでも「✕ + 課題名」の 1 行にある)。 + 保存期限が残り 7 日以内のときだけは警告を出したままにする。 記号の凡例は並べ方と同じ行に、短い言葉(「✓できた 前から ▶いま !10分以上 ・まだ ★必須」)で置く。 - 「できた人」の行は**下に固定しない**。プロジェクターでは画面の下が見えにくく、高さも足りないので、有益な情報は できるだけ**上**に置く。 @@ -1916,8 +1937,7 @@ Google Classroom にリンクしたクラス(学級)の課題で、課題リ | 要素 | テキスト/内容 | 操作 | |------|-------------|------| -| 戻るリンク | 「< 戻る」 | → teacher-detail | -| ページタイトル | 「Google Classroom に課題を配信します」 | — | +| ✕ の行 | ✕(「課題に戻る」)と見出し「Google Classroom に課題を配信します」(配信のあとは「✓ 配信しました!」) | ✕ → teacher-detail([キャンセル]と同じ) | | 対象 | 「対象: {クラス名}」 | — | | タイトル入力 | テキスト入力(デフォルト: 課題名) | — | | 説明入力 | テキストエリア | 任意 | diff --git a/docs/design-system/tokens.md b/docs/design-system/tokens.md index 8b9adbc06e0..bd9f4af58ac 100644 --- a/docs/design-system/tokens.md +++ b/docs/design-system/tokens.md @@ -174,6 +174,7 @@ | `$color-warning` / `$color-warning-background` | `$data-primary` / `$ui-alert-orange` | 注意(`alert.css` の `.warn`) | | `$color-success` / `$color-success-background` | `$extensions-tertiary` / `$extensions-light` | 成功(`alert.css` の `.success`) | | `$color-info` / `$color-info-background` | `$motion-primary` / `$ui-primary` | お知らせ(`alert.css` の `.info-blue`) | +| `$color-emphasis` / `$color-emphasis-background` | `#a33d00` / `$ui-alert-orange` | 文言の中の強調(レッスンのヒントの `**…**`)。上流の `$red-tertiary`(`#E64D00`)は淡い地に 3.5:1 で足りないので濃くした値を持つ(地に 5.9:1・白に 6.5:1) | | `$color-confirm-background` / `$color-confirm-text` | `hsla(35, 90%, 55%, 0.12)`(白の上で `#FEF3E5`)/ `hsla(30, 60%, 30%, 1)`(`#7A4D1F`) | クラス管理の取り消せる操作の確認の枠(アーカイブ・退室させる・採点を離れる。`classroom-modal.css` の `.confirm-note`)。赤は使わない(クラス管理の R4)。文字は地に 6.5:1 | | `$color-attention-action` | `#b35900` | 白い文字を載せるオレンジの塗り(退室依頼の[承認]: トースト・状況のパネル・メンバー詳細)。上流の `$error-primary`(`#FF8C1A`)は白に 2.3:1 で白い文字が読めないので、同じ色相で白に 4.8:1 の濃さをここで持つ | | `$color-seat-empty` / `$color-seat-empty-text` / `$color-seat-empty-border` | `$ui-white` / `$color-action` / `$color-action` | クラス管理の座席: 空いている席(白地に点線の枠。大きな座席は 2px、状況のパネルは 1px)。文字は白に 4.7:1 | diff --git a/docs/extension-mesh-v2/README.md b/docs/extension-mesh-v2/README.md index 24a7923cca0..bb18b8d2646 100644 --- a/docs/extension-mesh-v2/README.md +++ b/docs/extension-mesh-v2/README.md @@ -73,19 +73,13 @@ - **ドロップダウン候補**: `getVariableNamesMenuItems`(`index.js`)は、ネットワーク受信名(`remoteData`)に加えて**自プロジェクトのグローバルスカラー変数名**(`getGlobalVariables()`)を合算する。これにより、起動直後・接続前でもプリセット変数を含む自分の変数が候補に出る(ネットワーク往復に依存しない)。 - **broadcast は対象外**: メッセージ(`meshV2_broadcast` 系)は従来どおり自ノードを除外する(自分が送ったメッセージは自分には届かない)。変数とメッセージで非対称。 -### 後方互換性と一度きりの通知 +### 後方互換性 「同一グローバル変数名を複数ノードで共有しない」前提のもとでは、他ノード変数の読み取り(本来の用途)は不変で、変わるのは「自分の変数を読むと空文字ではなく自分の値が返る」点のみ。 -唯一挙動が変わりうるのは **グローバル変数名とセンサーの値の指定が重複** しているプロジェクト。これを検出したとき、**ブラウザで一度だけ**「動作が変わった」ことを非ブロッキングのバナーで知らせる(`localStorage: smalruby:meshSelfSensorNoticeShown`)。重複は読込・変数追加・リネーム・ドロップダウン変更・Ruby 編集のいずれでも生じうるため、全経路が集約される `PROJECT_LOADED` / `PROJECT_CHANGED` を監視して検出する。 +挙動が変わりうるのは **グローバル変数名とセンサーの値の指定が重複** しているプロジェクトだけ。以前はこれを検出してブラウザで一度だけバナーで知らせていたが、変更から十分に時間がたったので、いまは知らせない(チャットのレッスンのように、わざと同じ名前にする教材もある)。解説ページ `pages/mesh-self-sensor.html` は残してある。 -関連実装(scratch-gui): - -- `src/lib/mesh-v2-sensor-collision.js` — 重複検出(センサーの値の名前はメニュー shadow ブロック `meshV2_menu_variableNames` の `variableNames` フィールドに入る) -- `src/components/mesh-self-sensor-notice/` — バナー / `src/containers/mesh-self-sensor-notice.jsx` — 監視と初回ガード -- `pages/mesh-self-sensor.html` — 解説ページ(バナーの「くわしくはこちら」から開く) - -> 詳細経緯は Issue #707(自己参照仕様)と Issue #713(即時参照のローカルシード)。実装回帰の確認は `packages/scratch-vm/test/unit/mesh_service_v2_timestamp.js`、`packages/scratch-vm/test/integration/extensions/mesh-v2-variable-sync.test.js`、`packages/scratch-gui/test/unit/lib/mesh-v2-sensor-collision.test.js`、`tools/playwright-verify/verify-mesh-collision-paths.mjs` を参照。 +> 詳細経緯は Issue #707(自己参照仕様)と Issue #713(即時参照のローカルシード)。実装回帰の確認は `packages/scratch-vm/test/unit/mesh_service_v2_timestamp.js`、`packages/scratch-vm/test/integration/extensions/mesh-v2-variable-sync.test.js` を参照。 ### 既知の制限(クロスノードのレース) diff --git a/docs/hosting/README.md b/docs/hosting/README.md index f422811ce7c..1ace0df2358 100644 --- a/docs/hosting/README.md +++ b/docs/hosting/README.md @@ -99,7 +99,7 @@ URL の扱いで GitHub Pages と違う点: `/about` のように拡張子も末 - `_github-pages-challenge-smalruby.smalruby.app` TXT(GitHub の組織のドメイン検証。**消さない**。`docs/security/github-pages-subdomain-takeover.md` の Layer 1) - `smalruby.app` CAA ×6(amazon.com / amazonaws.com / amazontrust.com / awstrust.com / letsencrypt.org / issuewild `;`) - `api.smalruby.app` NS ×4、`preview.smalruby.app` NS ×4(委任をそのまま写す) - - `everdiary.smalruby.app` A は使っていないので写さない + - `everdiary.smalruby.app` A は使っていないので写さない(人間が確かめ、お名前.com からも消した) - 段 3 のスクリプトで、両方のネームサーバーの応答が一致している(照合はホストか GitHub Actions で行う。コンテナの firewall は任意の DNS サーバーへの問い合わせを止めている)。 - DNSSEC は無効のまま(有効なら先に外す)。 @@ -153,6 +153,33 @@ URL の扱いで GitHub Pages と違う点: `/about` のように拡張子も末 - CI は置いたあとに `/*` を invalidation する(1 回 1 パスとして数えるので、月 1,000 パスの無料枠に十分収まる)。 - S3 はバージョニングを有効にし、上書き・削除された古い版を 30 日残す(CI の誤りで消えたファイルを戻すため。日数は人間が決める値)。いまの版は期限で消さない(プレビューと違う点)。バケットは本番の配信元なので `RETAIN`(スタックを消しても残る)。 +## アクセスログ(段 5) + +本番の CloudFront(`SiteDistribution`)のアクセスログを、ログ専用の S3 バケット `SiteLogBucket` に残す。 + +| 項目 | 内容 | +|---|---| +| 方式 | CloudFront の**標準ログ(従来の S3 配信)** | +| 置き場所 | `SiteLogBucket` の `cloudfront/smalruby.app/` 以下(gzip のファイルが数分〜1 時間ごとに届く) | +| バケット | 非公開(Block Public Access 全部 ON)・SSE-S3 で暗号化・SSL のみ。CI 用ロールからは触れない | +| 保持期間 | **30 日で消す**(人間が決めた値)。`infra/smalruby-web-hosting/lib/web-hosting-stack.ts` の `SITE_ACCESS_LOG_RETENTION_DAYS` だけを変えれば、バケットのライフサイクルが追従する | +| Cookie | 記録しない(`logIncludesCookies: false`) | + +### 標準ログ(従来)を選んだ理由 + +- **費用**: 従来の方式は、ログを S3 に届けること自体は無料で、かかるのは S3 の保存とリクエストだけ。新しい方式(v2。CloudWatch Logs の配信の仕組みを使う)は、S3 へ届けたログの量に応じて料金がかかる。 +- **手間**: 従来の方式は CloudFront のディストリビューションに設定を足すだけ(ディストリビューションの置き換えにならない)。v2 は配信元の設定を us-east-1 に作る必要があるが、このスタックは ap-northeast-1 で、スタックを分けない決まり(`Deploy Infra` が `cdk deploy` をスタック名なしで呼ぶため)がある。 +- **引き換え**: 従来の方式は CloudFront がバケットの ACL を使って書き込むので、ログのバケットだけ ACL を無効にせず `BucketOwnerPreferred` にする(書かれたログの持ち主はこのアカウントになる)。ACL の相手は CloudFront のログ配信用アカウントで、公開ではないので Block Public Access は全部 ON のまま使える。 +- v2 にしかない機能(項目の選択、Parquet、CloudWatch Logs や Firehose への配信)が必要になったら、そのときに移る。 + +### 個人を特定しうる情報の扱い + +- 標準ログには、利用者の **IP アドレス**、要求した URL(クエリ文字列を含む。`?tab=ruby` など)、User-Agent、Referer が入る。Cookie は記録しない。エディタはログインの情報や作品の中身を URL に入れないので、それらはログに入らない。 +- ログは障害の調査と、転送量・利用の傾向をつかむためだけに使う。**ログを外へ出さない**(Issue・PR・チャットに IP アドレスや生のログを貼らない。集計した数だけを書く)。 +- 読めるのはこの AWS アカウントの管理者だけ(バケットは非公開、CI 用ロールの権限にも入れない)。 +- 保持期間を過ぎたものは S3 のライフサイクルで自動で消える。期間を延ばすときは、使い道と見合うかを人間が決める。 +- WAF(フィルタリング)は入れていない(費用がかかるので、必要になったら別に決める)。 + ## PWA / service worker エディタは Workbox の `GenerateSW` で作った `/service-worker.js`(scope `/`・`skipWaiting` + `clientsClaim`)を登録し、ビルドの大部分を precache する。 @@ -180,7 +207,7 @@ URL の扱いで GitHub Pages と違う点: `/about` のように拡張子も末 | S3 の保存 | 月 0.1 未満 | ビルドは 1 版あたり 100〜200 MB。古い版を 30 日残しても数 GB | | CloudFront のデータ転送 | 月 0〜230 | 毎月 1 TB までは無料。新しい端末は precache で 60〜100 MB を読む。1 日の利用者 3,000 人が平均 10〜30 MB を読むと月 1〜3 TB。1 TB を超えた分は 1 GB あたり約 0.114 | | CloudFront のリクエストと関数 | 月 0〜30 | 毎月 1,000 万リクエスト・関数 200 万回までは無料。1 回の読み込みで数百のリクエストがあるので、無料枠を超えうる | -| アクセスログ | 月 1 未満 | S3 に置き、保持期間を決めて消す | +| アクセスログ | 月 1 未満 | 標準ログ(従来)は届けるのが無料で、かかるのは S3 の保存と書き込みだけ。月 3,000 万リクエストでもログは gzip で月 数 GB、30 日分を置いて月 0.05〜0.2 程度 | - 従量課金の上限が読みにくいので、**CloudFront の定額プラン**(Pro は月 15 で転送量の上限が十分大きい)を使うかどうかを人間が決める。まず従量で 1〜2 週間動かし、CloudFront の使用量レポートで実際の転送量を見てから決めるのが安全。 - **AWS Budgets の予算アラート**(例: 月 50 を超えたら通知)を切り替えの前に設定する。 diff --git a/docs/hosting/verify-scripts.md b/docs/hosting/verify-scripts.md new file mode 100644 index 00000000000..ddbe7847150 --- /dev/null +++ b/docs/hosting/verify-scripts.md @@ -0,0 +1,118 @@ +# 照合スクリプト(DNS と配信内容) + +> **🆕 Smalruby 独自** — 本番 smalruby.app を GitHub Pages から S3 + CloudFront へ移すときに使う、読むだけの確かめ用スクリプト + +本番の配信を移す作業(設計は `docs/hosting/README.md`)の各段で、「写したものが同じか」を機械で確かめるためのスクリプト。どちらも**問い合わせるだけで、DNS や配信を変えない**。Node.js の標準モジュールだけで動く(npm のパッケージは要らない)。 + +| スクリプト | 使う段 | 確かめること | +|---|---|---| +| `scripts/hosting/dns-compare.mjs` | 段 3(ネームサーバーを変える前) | お名前.com と Route 53 のレコードが同じか | +| `scripts/hosting/site-compare.mjs` | 段 8(apex を CloudFront に向ける前) | GitHub Pages と CloudFront が同じものを、設計どおりのヘッダで返すか | + +**どこで走らせるか**: コンテナ(devcontainer)の firewall は、任意の DNS サーバーへの問い合わせと、許可していない宛先への通信を止めている。`dns-compare.mjs` の `ns:` はコンテナでは `connection refused` で止まる(終了コード 2)ので、**ホストか GitHub Actions で走らせる**。`site-compare.mjs` は、いまの `https://smalruby.app/`(GitHub Pages)にはコンテナからも届く。CloudFront に届かないときはホストで走らせる。 + +## DNS の照合(`dns-compare.mjs`) + +2 つの「ソース」のレコードを、名前と型ごとに並べて比べる。 + +| ソース | 書き方 | 中身 | +|---|---|---| +| ゾーンファイル | `zone:<ファイル>` | BIND 形式(`名前 TTL IN 型 値`)。お名前.com のエクスポートはこの形で渡す(下の「入力の形」)。`dig +noall +answer` の出力もこの形なので、そのまま読める | +| Route 53 | `route53:<ファイル>` | `aws route53 list-resource-record-sets --hosted-zone-id ` の JSON | +| ネームサーバー | `ns:[,...]` | 指定したネームサーバーに `dig +norec` で直接聞く。全部のサーバーに聞き、サーバーどうしで答えが違えば `INCONSISTENT` として出す | + +```bash +# お名前.com のエクスポートと、Route 53 のネームサーバー 4 本を比べる(ホストで) +node scripts/hosting/dns-compare.mjs --origin smalruby.app \ + --a zone:onamae-zone.txt \ + --b ns:,<2>,<3>,<4> + +# お名前.com と Route 53 のネームサーバーに直接聞いて比べる(ゾーンファイルなし) +node scripts/hosting/dns-compare.mjs --origin smalruby.app \ + --a ns:01.dnsv.jp,02.dnsv.jp,03.dnsv.jp,04.dnsv.jp \ + --b ns:,<2>,<3>,<4> \ + --names @,www,api,preview,_github-pages-challenge-smalruby + +# 動きを見るだけなら、架空の値のサンプルどうしを比べる(ネットワークに出ない) +node scripts/hosting/dns-compare.mjs --origin example.com \ + --a zone:scripts/hosting/samples/onamae-zone.example.txt \ + --b route53:scripts/hosting/samples/route53.example.json +``` + +- 比べる型は既定で A / AAAA / CNAME / TXT / CAA / NS / MX(`--types` で変える)。SOA は比べない。 +- **頂点(`@`)の NS は既定で比べない**。お名前.com と Route 53 では、それぞれ自分のネームサーバーを返すのが正しいため。比べたいときは `--include-apex-ns`。`api` / `preview` の委任の NS は比べる。 +- `ns:` のときに聞く名前は、`--names`(既定: `@,www,api,preview,_github-pages-challenge-smalruby`)と、もう片方のファイルに出てくる名前のすべて。ネームサーバーはゾーン転送を許さないので、名前は列挙して聞く。 +- 出力は 1 行に 1 組。`OK`(一致)/ `DIFF`(値が違う)/ `ONLY-A` / `ONLY-B`(片方にだけある)。`--json` で JSON にする。 +- **TTL の違いは警告だけ**(`warn: TTL A=3600 B=300`)。apex の A は Route 53 だけ 300 にしてある(戻しやすくするため)。 +- 終了コード: 0 = 全部一致、1 = 一致しないものがある、2 = 引数の間違い・問い合わせの失敗。 + +### 入力の形(お名前.com のエクスポート) + +1 行に 1 レコードの BIND 形式にする。お名前.com の画面やエクスポートが別の形なら、この形に書き写す。サンプルは `scripts/hosting/samples/onamae-zone.example.txt`(架空の値)。 + +```text +$ORIGIN smalruby.app. +$TTL 3600 +@ 3600 IN A +@ 3600 IN TXT "google-site-verification=..." +@ 3600 IN CAA 0 issue "amazon.com" +_github-pages-challenge-smalruby 3600 IN TXT "..." +api 3600 IN NS <委任先のネームサーバー>. +``` + +- 名前の `@` は頂点。`.` で終わらない名前・値には `$ORIGIN` が付く。 +- 名前を省いて行頭を空白にすると、前の行と同じ名前になる。 +- TXT は `"..."` で囲む。`;` から行末まではコメント。 + +**本物のエクスポートはリポジトリにコミットしない**(`tmp/` に置く)。 + +## 配信内容の照合(`site-compare.mjs`) + +2 つのホスト(A = いまの GitHub Pages、B = 新しい CloudFront)に同じパスを GET し、比べる。 + +```bash +# 段 8: GitHub Pages と CloudFront のドメインを比べる +node scripts/hosting/site-compare.mjs \ + --a https://smalruby.app \ + --b https:// + +# 切り替えの直前: CloudFront に https://smalruby.app/ として聞く(curl --resolve と同じ) +node scripts/hosting/site-compare.mjs \ + --a https://smalruby.app \ + --b https://smalruby.app --resolve-b + +# 調べるパスの一覧だけ出す(A に 2 回だけ聞く) +node scripts/hosting/site-compare.mjs --a https://smalruby.app --b https://smalruby.app --list +``` + +調べるパス: + +- いつも: `/`、`/index.html`、`/admin/`、`/.well-known/microsoft-identity-association.json`、`/auth-redirect.html`、`/version.json`、`/service-worker.js` +- A の `/service-worker.js` の precache の一覧(Workbox の実行用のファイルも含む)と、A の `/index.html` が読むファイル(`--no-precache` で外す) +- `--dist <ディレクトリ>`: ビルドの出力(例: `packages/scratch-gui/dist`)の全ファイル。`index.html` のあるディレクトリは `/` と、末尾の `/` 無しの `` も調べる +- `--paths-file <ファイル>`: 1 行に 1 パス(`#` はコメント) + +パスごとに見ること: + +| 何を | どちらに | 期待 | +|---|---|---| +| 状態コード | A と B | 同じ | +| 中身の SHA-256 | A と B(どちらも 200 のとき) | 同じ(`Accept-Encoding: identity` で、圧縮しない中身を比べる) | +| `Content-Type` | A と B | 型が同じ(`charset` などの違いは警告だけ) | +| `Content-Type` | B | `.wasm` = `application/wasm`、`.mjs` / `.js` = `text/javascript` か `application/javascript`、`.hex` = `application/octet-stream` などダウンロードされる型、`.json` = `application/json`、`.html` = `text/html` ほか | +| `Cache-Control` | B | ハッシュ付き(`/\.[0-9a-f]{8,}\./`)= `max-age=31536000` と `immutable`。それ以外 = `max-age=0`(か `no-cache`) | +| 存在しないパス | B | **403**(S3 + OAC は一覧を見せないため。GitHub Pages は 404。A の値は警告として並べて出す) | +| 末尾の `/` が無いディレクトリ(`/admin` など) | B | **301** で `/` へ | + +- B の設計どおりかの確かめ(下 4 行)は `--no-b-checks` で外せる(例: GitHub Pages どうしを比べるとき)。 +- 一度に聞く数は `--concurrency`(既定 4)。`--limit N` で先頭の N 個だけにする。全部を比べると両方から precache の全部(60〜100 MB)を読む。 +- 出力は `OK` / `NG` とその理由。`--json` で JSON にする。 +- 終了コード: 0 = 問題なし、1 = 問題がある、2 = 引数の間違い・ホストに届かない。 + +## テスト + +比べる関数だけを、ネットワークに出ずに確かめる(`npm run lint` の中でも走る)。 + +```bash +npm run test:hosting-scripts +``` diff --git a/docs/infra/smalruby-web-hosting.md b/docs/infra/smalruby-web-hosting.md index 101aa1ceec8..66fbcaa3dda 100644 --- a/docs/infra/smalruby-web-hosting.md +++ b/docs/infra/smalruby-web-hosting.md @@ -16,13 +16,13 @@ stg ステージに、`preview.smalruby.app` のホストゾーン(お名前.c | Stage | スタック名 | リソース | |---|---|---| | stg | `SmalrubyWebHostingStack-stg` | パブリックホストゾーン `preview.smalruby.app`、S3 バケット、CloudFront、ACM 証明書(us-east-1)、A / AAAA(ALIAS)、CI 用 IAM ロール | -| prod | `SmalrubyWebHostingStack` | 本番 smalruby.app の配信基盤(S3 バケット、CloudFront、CI 用 IAM ロール)。独自ドメイン・証明書・DNS はまだ無い(下の「本番の配信基盤(prod)」) | +| prod | `SmalrubyWebHostingStack` | 本番 smalruby.app の配信基盤(S3 バケット、CloudFront、CI 用 IAM ロール)と、パブリックホストゾーン `smalruby.app`(お名前.com のレコードを写したもの)。CloudFront の独自ドメイン・証明書はまだ無い(下の「本番の配信基盤(prod)」「ホストゾーン `smalruby.app`(prod)」) | | その他(stg2 等) | `SmalrubyWebHostingStack-` | なし | - プレビューは stg の API を見るので、プレビュー用の資源は **stg ステージ**に置く。 - `Deploy Infra` は develop へのマージで prod にも出す。prod でプレビュー用のリソースができないよう、 プレビュー用の資源は stg だけに作る(同じ名前のゾーンが複数あると、どれが委任先か分からなくなる)。 -- prod には本番(smalruby.app)の配信基盤だけを作る。stg2 などほかのステージでは何も作らない。 +- prod には本番(smalruby.app)の配信基盤と `smalruby.app` のゾーンだけを作る。stg2 などほかのステージでは何も作らない。 ## ホストゾーン `preview.smalruby.app` @@ -175,7 +175,8 @@ aws s3 rm "s3://$BUCKET/test/index.html" | リソース | 内容 | |---|---| | S3 バケット `SiteBucket` | Block Public Access 全部 ON・`enforceSSL`・**バージョニングあり**。上書き・削除された古い版は 30 日で消し、残った削除マーカーも片付ける。**いまの版は期限で消さない**(プレビューとの違い)。`removalPolicy` は **`RETAIN`**(下の「本番のバケットを RETAIN にする理由」) | -| CloudFront `SiteDistribution` | オリジンは S3 + OAC。viewer-request はプレビューと同じ関数(`/` → `/index.html`、`/admin` → `/admin/` へ 301)。キャッシュポリシーもプレビューと同じ値。応答ヘッダポリシーで HSTS(1 年)と `X-Content-Type-Options: nosniff` を付ける。HTTP/2 と HTTP/3、Price Class 200 | +| CloudFront `SiteDistribution` | オリジンは S3 + OAC。viewer-request はプレビューと同じ関数(`/` → `/index.html`、`/admin` → `/admin/` へ 301)。キャッシュポリシーもプレビューと同じ値。応答ヘッダポリシーで HSTS(1 年)と `X-Content-Type-Options: nosniff` を付ける。HTTP/2 と HTTP/3、Price Class 200。標準ログ(従来の S3 配信・Cookie なし)を `SiteLogBucket` の `cloudfront/smalruby.app/` に出す | +| S3 バケット `SiteLogBucket` | アクセスログ専用。Block Public Access 全部 ON・SSE-S3・`enforceSSL`。標準ログは ACL で書き込まれるので Object Ownership は `BucketOwnerPreferred`(ACL を無効にしない)。`SITE_ACCESS_LOG_RETENTION_DAYS`(30 日)を過ぎたログは消す。バージョニングなし・`removalPolicy` は `DESTROY`(ログが無くても配信は止まらない。中身が残っている間は削除が失敗して止まる)。方式を選んだ理由と個人情報の扱いは [`docs/hosting/README.md`](../hosting/README.md) の「アクセスログ(段 5)」 | | CI 用ロール `SiteDeployRole` | 既存の GitHub OIDC プロバイダを参照。信頼は `repo:smalruby/smalruby3-editor:ref:refs/heads/develop` と `...:environment:prod` だけ(プレビューより狭い)。権限はこのバケットの `ListBucket` / `PutObject` / `DeleteObject` と、このディストリビューションの invalidation だけ | ### 本番のバケットを RETAIN にする理由 @@ -200,6 +201,7 @@ TLS 1.2 以上の指定(`minimumProtocolVersion`)は既定の証明書では | `SiteBucketName` | ビルドを置くバケット(`SITE_BUCKET_NAME`) | | `SiteDistributionId` | invalidation の対象(`SITE_DISTRIBUTION_ID`) | | `SiteDistributionDomainName` | CloudFront のドメイン(切り替え前の確認用) | +| `SiteLogBucketName` | アクセスログのバケット(調べるときに `aws s3 ls s3://<値>/cloudfront/smalruby.app/`) | ```bash aws cloudformation describe-stacks --stack-name SmalrubyWebHostingStack \ @@ -218,6 +220,86 @@ curl -sI "https://$DOMAIN/" # 200・strict-transport-security が付く aws s3 rm "s3://$BUCKET/index.html" ``` +### CI からの配置(GitHub Pages と並べて置く) + +`.github/workflows/ci-cd.yml` の `build-and-deploy` は、develop への push のたびに、GitHub Pages へ出したのと +**同じビルド**をこのバケットにも置く。切り替えるまでの本番は GitHub Pages のままで、こちらは CloudFront の +ドメインでしか見えない。 + +- repo の Variables `SITE_DEPLOY_ROLE_ARN` / `SITE_BUCKET_NAME` / `SITE_DISTRIBUTION_ID` のどれかが無いときは、 + warning を出して飛ばす(GitHub Pages への配置は続ける)。 +- ジョブに `id-token: write` を足すため、ジョブの `permissions` で workflow の権限(`contents` / `issues` / + `pull-requests` の write)も書き直している(ジョブに書くと workflow の分は引き継がれない)。 +- 置き方はプレビューと同じ「CI がアップロードするときの約束」: ハッシュ付きのファイルは + `public, max-age=31536000, immutable`、それ以外は `max-age=0, s-maxage=60`。`.wasm` / `.mjs` / `.hex` は + `Content-Type` を明示する。最後に `--delete --size-only` で古いファイルを消す。 +- 本体(`packages/scratch-gui/dist`)はバケットの直下、管理 SPA(`packages/admin/build`)は `admin/` に置く。 + 本体の `--delete` は `admin/*` を除き、管理 SPA の `--delete` は `admin/` の中だけに効く。 + `.well-known/` などドットで始まるものも置く。GitHub Pages 用の `.nojekyll` と `CNAME` は置かない。 +- 置いたあとに `/*` を invalidation する。 + +## ホストゾーン `smalruby.app`(prod) + +本番のドメイン `smalruby.app` の DNS を、お名前.com から Route 53 へ移すためのゾーン(`docs/hosting/README.md` の段 2)。 +お名前.com のネームサーバーを、このゾーンの NS 4 本に変えるまで(人間が夜間に行う)、誰もこのゾーンを引かない。 +だから作っただけでは、いまの本番には何も起きない。 + +| 項目 | 値 | +|---|---| +| 種類 | パブリックホストゾーン(論理 ID `SiteHostedZone`) | +| `removalPolicy` | **`RETAIN`** — 作り直すと NS が変わり、お名前.com に登録したネームサーバーと食い違う | +| Output `SiteHostedZoneNameServers` | NS 4 本(カンマ区切り)。お名前.com のネームサーバーの設定に使う | +| Output `SiteHostedZoneId` | ホストゾーン ID | + +写したレコード(値は `infra/smalruby-web-hosting/lib/site-zone-records.ts`。お名前.com のエクスポートと同じ値): + +| 名前 | 型 | 数 | TTL | 内容 | +|---|---|---|---|---| +| `smalruby.app` | A | 4 | 300 | GitHub Pages(185.199.108〜111.153)。お名前.com は 3600 だが、切り替えと戻しを早く効かせるため 300 にする | +| `smalruby.app` | TXT | 1 | 300 | `google-site-verification=...`(Search Console の所有確認) | +| `_github-pages-challenge-smalruby.smalruby.app` | TXT | 1 | 3600 | GitHub の組織のドメイン検証。**消さない**(`docs/security/github-pages-subdomain-takeover.md`) | +| `smalruby.app` | CAA | 6 | 3600 | `issue` amazon.com / amazonaws.com / amazontrust.com / awstrust.com / letsencrypt.org、`issuewild ";"` | +| `api.smalruby.app` | NS | 4 | 900 | API 群のゾーンへの委任(いまの NS のまま) | +| `preview.smalruby.app` | NS | 4 | 900 | stg の `PreviewHostedZone` への委任(いまの NS のまま) | + +写さないもの: apex の NS / SOA(Route 53 のものになる)、`everdiary.smalruby.app` A(使っていないことを人間が確かめ、お名前.com からも消した)。ワイルドカードは作らない。 + +- お名前.com 側のレコードを変えたら、ここも同じ値にする(ネームサーバーを変えるまでは両方に書いておく決まり)。 + 照合は `scripts/hosting/dns-compare.mjs`(`docs/hosting/verify-scripts.md`)で、お名前.com のエクスポートと + `cdk synth` の結果、または両方のネームサーバーへの問い合わせを比べる。 +- NS の値は末尾に `.` を付けて書く(ゾーン名を足した相対名と読まれないように)。 +- apex の A を CloudFront の ALIAS に変えるのは別の変更(本番の向き先が変わるので、人間が夜間にマージする)。 + +NS はデプロイ後に次で確認する: + +```bash +aws cloudformation describe-stacks --stack-name SmalrubyWebHostingStack \ + --query "Stacks[0].Outputs[?starts_with(OutputKey, 'SiteHostedZone')]" --output table +``` + +### `smalruby.app` のゾーンを作り直すとき(RETAIN の後始末) + +考え方は上の「ゾーンを作り直すとき」(`preview.smalruby.app`)と同じ。作り直さないのが基本 +(論理 ID `SiteHostedZone`・スタック名 `SmalrubyWebHostingStack`・ゾーン名を変えない)。やむを得ないときは、 +まず同名のゾーンがいくつあるかを確かめる: + +```bash +aws route53 list-hosted-zones-by-name --dns-name smalruby.app \ + --query "HostedZones[?Name=='smalruby.app.'].[Id,Config.Comment]" --output table +``` + +**注意**: `RETAIN` なのはゾーンだけで、レコードは `DESTROY`。NS を切り替えたあとにスタックを消すと、apex の A と `api.` / `preview.` の委任が消えて smalruby.app が止まる。作り直すときは、ゾーンを `cdk import` で取り込んでから deploy する。 + +そのうえで次のどちらかを選ぶ(どちらも人間が手元で行う)。 + +- **残ったゾーンを取り込む(NS が変わらない。こちらを優先)**: スタックが無い状態で + `npx cdk import --context stage=prod` を実行し、`SiteHostedZone` に残ったゾーンの ID を渡す。 + お名前.com のネームサーバーはそのままでよい。 +- **残ったゾーンを消して作り直す(NS が変わる)**: お名前.com のネームサーバーをまだ変えていないときだけ選ぶ。 + 変えたあとに消すと、`smalruby.app` も `api.` / `preview.` も引けなくなる。残ったゾーンの NS / SOA 以外の + レコードを消してからゾーンを消し、`Deploy Infra` で出し直す。新しい NS 4 本(Output `SiteHostedZoneNameServers`)を + 使う。 + ## CI のプレビュー | 何を | どこで | @@ -288,7 +370,7 @@ Secrets が無いままマージすると、`Deploy Infra` のこのプロジェ ### prod のデプロイ -prod には本番の配信基盤(上の「本番の配信基盤(prod)」)がある。追加だけの差分なので、develop への +prod には本番の配信基盤(上の「本番の配信基盤(prod)」)と `smalruby.app` のゾーンがある。追加だけの差分なので、develop への マージで `Deploy Infra` が自動で出す。削除・置き換えを含む差分は自動では出ず、人間が確かめて手元から出す。 prod にプレビュー用のリソースはできない。 @@ -307,7 +389,10 @@ npx cdk synth --context stage=prod 「バケットが非公開・SSL 必須・ライフサイクルあり」「証明書が us-east-1」「CloudFront が OAC・ 代替ドメイン・viewer-request 関数つき」「ALIAS にワイルドカードが無い」「CI 用ロールの信頼と権限が 最小」「prod にはプレビュー用の資源が無く、本番の配信基盤(非公開・バージョニングあり・いまの版を消さない・ -独自ドメインも DNS も無い・develop だけを信頼するロール)がある」「stg2 には何も作らない」を確かめる。`test/preview-viewer-request.test.ts` は +独自ドメインも証明書も無い・develop だけを信頼するロール)と、アクセスログのバケット(非公開・暗号化・ +保持期間で消える・CI 用ロールから触れない)がある」「stg2 には何も作らない」を確かめる。`test/site-zone.test.ts` は「prod に `smalruby.app` のゾーンが 1 つあり `RETAIN`・論理 ID が変わらない」「写した +レコードがお名前.com の値と同じ(apex の A だけ TTL 300)」「apex の NS / SOA・`everdiary`・ワイルドカードが無い」 +「stg / stg2 にはこのゾーンが無い」を確かめる。`test/preview-viewer-request.test.ts` は CloudFront Function の実コードを評価して URI の書き換えを確かめる。 CI(`.github/workflows/ci-infra.yml` の `[web-hosting] Unit Tests` / `CDK Build & Synth` / @@ -318,9 +403,11 @@ CI(`.github/workflows/ci-infra.yml` の `[web-hosting] Unit Tests` / `CDK Buil | ファイル | 役割 | |---|---| | `infra/smalruby-web-hosting/bin/smalruby-web-hosting.ts` | エントリポイント。stage とスタック名を決める | -| `infra/smalruby-web-hosting/lib/web-hosting-stack.ts` | スタック本体(stg: ホストゾーン・プレビューの配信基盤・CI 用ロール / prod: 本番の配信基盤 `createSiteDelivery()`) | +| `infra/smalruby-web-hosting/lib/web-hosting-stack.ts` | スタック本体(stg: ホストゾーン・プレビューの配信基盤・CI 用ロール / prod: 本番の配信基盤 `createSiteDelivery()`・ゾーン `createSiteZone()`) | +| `infra/smalruby-web-hosting/lib/site-zone-records.ts` | `smalruby.app` のゾーンに写すレコードの値(お名前.com と同じ) | | `infra/smalruby-web-hosting/lib/functions/preview-viewer-request.js` | CloudFront Function(ディレクトリの URL → `index.html`)。プレビューと本番で共用 | | `infra/smalruby-web-hosting/test/web-hosting.test.ts` | スタックのテスト | +| `infra/smalruby-web-hosting/test/site-zone.test.ts` | `smalruby.app` のゾーンのテスト(写したレコードの一覧・`RETAIN`・prod だけに作る) | | `infra/smalruby-web-hosting/test/preview-viewer-request.test.ts` | CloudFront Function のテスト | | `.github/workflows/ci-cd.yml`(`preview-deploy`) | プレビューを stg の値でビルドして置く | | `.github/workflows/preview-cleanup.yml` | プレビューの片付け | diff --git a/docs/lessons/README.md b/docs/lessons/README.md index ff96a8d7a04..00eb3299d88 100644 --- a/docs/lessons/README.md +++ b/docs/lessons/README.md @@ -28,7 +28,8 @@ | レッスン | チャレンジの並び | レッスン 1「うごかしてみよう」(4 個)・2「えらんで たずねよう」(3 個)・3「おぼえて つたえよう」(4 個) | | チャレンジ | いまの deck 1 本に当たる。毎回、新しい作品から始める | 「押したら話そう」 | -段 1 には**「必須」も「できること」も無い**。レッスンやコースの「全部できた」は、そのチャレンジが全部できたとき。 +段 1 には**「必須」も「できること」も無い**。レッスンやコースの「全部できた」は、そのチャレンジが全部できたとき +(テーマを選ぶレッスンだけは、決めた数できたとき。下の「レッスン」の `checkCount`)。 先生が必須にするチャレンジは、段 2 でクラス管理の「レッスンの課題」の側に持つ(レッスンのデータには持たない)。 「できること」はバッジなどを考えるときにあらためて作る。 @@ -45,7 +46,14 @@ | `id` | string | 例: `kyou-kara-programmer` | | `language` | `blocks` \| `ruby` \| `dncl` | `LANGUAGES` | | `name` | message | コースの名前 | -| `lessons` | レッスン[] | 並び順 | +| `lessons` | レッスン[] | 並び順。**コースの数に入れるレッスンだけ**(`warmup` のレッスンは入らない) | +| `warmupLessons` | レッスン[] | コースの数に入れない、はじめのレッスン(レッスン 0)。`defineCourse` が渡されたレッスンから `warmup: true` のものを分けて置く | + +`course.lessons` はコースの数(レッスン表の進みぐあいのバーと「n / 11」・コースの ✓・クラス管理の課題に選べるチャレンジ・ +先生の進みぐあいの表・ウェルカムの案内の数)に使う。レッスン 0 を `lessons` から外して `warmupLessons` に置くので、レッスン 0 を +足してもこれらの数とクラスの課題の中身は変わらない(課題の「全部」の条件・チャレンジ id の並びにも入らない)。レッスン表・ +チャレンジの検索(`findChallenge` / `findLesson`)・「次のレッスン」・ウェルカムの「レッスンを始める」は **`courseLessons(course)`** +(レッスン 0 が先頭)を使い、レッスン表の番号は `lessonNumberOf`(レッスン 0 は 0)。 ### レッスン @@ -55,8 +63,17 @@ | `name` | message | レッスンの名前 | | `challenges` | チャレンジ[] | 並び順 | | `allowDnclMode` | boolean | レッスンのあいだ Ruby タブを日本語モードに切りかえてよいか。**書いていなければ不可**(`false`)。下の「日本語モードの切りかえ」 | +| `showPartNames` | boolean | チャレンジを開いたときから画面の部分の名前の札を出しておくか(下の「名前の札」。課題バーの「ガイド」で消せる)。**書いていなければ出さない**(`false`)。画面の部分の名前を覚えるレッスン 0 で使う | +| `warmup` | boolean | コースの数に入れない、はじめのレッスンか(上の「コース」)。**書いていなければ数える**(`false`)。「きょうからプログラマー」のレッスン 0 だけ `true` | +| `checkCount` | number | レッスンの ✓(「全部できた」)に要るできた数。**書いていなければチャレンジの数**(全部)。テーマを選んでやるレッスン(「チャットをつくろう」のレッスン 5)だけ `1` | + +必須のチャレンジは持たない。`checkCount` を書いたレッスンは、その数だけできれば ✓ がつく。まだ残りのチャレンジがあるときの「できた!」は、 +見出しを「レッスン n クリア!」、2 行目を「「レッスン名」は n つできました。このレッスンはこれでクリア」にする(「ぜんぶ」とは言わない)。 +コースの ✓ はチャレンジのあるレッスンが全部 ✓ のとき(チャレンジが 0 のレッスンは外す)、レッスン表のコースの進み具合(数とバー)は +レッスンごとに `checkCount` までを数える(バーがいっぱいになるのと ✓ をそろえる)。 -クリア条件(n 個・必須)は持たない。 +クラス管理の課題で絞ったレッスン表(「はじめる」で開いたとき・`restrictCourseStatus`)は、`checkCount` を使わず、**課題のチャレンジが +全部**で数える(テーマを選ぶレッスンでも同じ。課題の残りは課題の帯が「あと n つ」で出し、先生は課題の「n つできたら」でテーマの数を決める)。 #### 日本語モードの切りかえ(`allowDnclMode`) @@ -96,12 +113,18 @@ | `card` | `{category, main}` \| null | null | レッスン表のカード。`category` = 左の帯の色のなかま、`main` = そのチャレンジで覚えるメインのなかま(同じ数で並んだときの色)。どちらも `CATEGORIES` の値(`motion` / `looks` / `sound` / `events` / `control` / `sensing` / `operators` / `variables` / `lists` / `extensions`)。決め方は下の「カードの色」 | | `goal` | 条件[] \| null | null | できた の判定。条件の配列で、全部を満たしたら「できた」(下の「できた の判定」)。null なら判定しない | | `allowedBlocks` | object \| null | null | パレットに出すブロック(deck と同じ形)。項目は opcode か、初期値を持つ `{opcode, fields, inputs}`(下の「パレットのブロックの初期値」) | -| `setup` | object \| null | null | 始めるときの準備(deck と同じ形。`lib/deck-setup.js`) | +| `setup` | object \| null | null | 始めるときの準備。deck と同じ項目(`tab` / `rubyMode` / `extensions` / `rubyVersion`。`lib/lessons/apply-setup.js`)に、作品の準備(`sprites` / `code` / `spriteCodes` / `stageCode`。`lib/lessons/challenge-start.js`)を足せる。下の「レッスンモード」の **setup** | | `steps` | ヒント[] | [] | ヒント(下の表) | | `code` | string \| `{ja, 'ja-Hira', en}` \| null | null | ヒントの最後の手段「プログラムを入れる」(Ruby。deck の `code` と同じ)。作品の中の名前が locale で変わるときは locale ごとに書く(下の「英語の UI でも使う(locale ごとの `code`)」) | | `codeTarget` | `'stage'` \| null | null | `code` を入れる相手。null はいま編集中のスプライト。`'stage'` はステージのプログラムのチャレンジ(入れる前にステージをえらぶ) | | `spriteCodes` | `{sprite, code}`[] | [] | `code` のほかに、名前で決めたスプライトに入れるプログラム(2 つのスプライトでやりとりするチャレンジ用)。`sprite` はライブラリのスプライトの名前。`code` は `code` と同じく locale ごとにも書ける。下の「最後の手段」 | | `debug` | message[] | [] | うまく動かないときは | +| `activityDiagram` | boolean | false | 答えのプログラム(`code` と `spriteCodes`)から描くアクティビティ図を、課題の全文とヒントの 1 ページ目に出すか。答えが無いチャレンジでは true でも出さない。描き方は下の「アクティビティ図(答えから描く)」 | +| `partner` | object \| null | null | メッシュの練習相手の定義 `{name, buttons: [{label, set, broadcast}], replies: [{onBroadcast, set, broadcast}], watch}`(`set` = `{variable, value}` か、その配列。`watch` は任意で、パネルの「〜に届いた」に出す生徒の変数の名前の配列)。あればチャレンジ中に練習相手のパネルを出す(下の「メッシュの練習相手」)。図では相手のスイムレーンになる。無ければ自分のプログラムだけを描く | +| `quiz` | `{question, choices, answer, explanation}` \| null | null | ふりかえりのクイズ(3 択)。「できた!」の表示の中に出す(下の「ふりかえりのクイズ」)。`question` / `choices`(3 つ)/ `explanation` は message、`answer` は正解が `choices` の何番目か(0 から)。ふつうは `challengeQuiz(id, answer)` で書く | +| `partQuiz` | `{questions: [label, ...]}` \| null | null | 「どこでしょう?」のクイズ(下の「どこでしょう?のクイズ」)。`label` は名前の札の名前(`lib/lessons/part-names.js` の `PART_NAMES`)。クイズのあいだは画面のクリックをクイズが受け、名前の札と「ガイド」のボタンは出さない。`validatePartQuiz` が形を確かめる | +| `mode` | `'readDiagram'` \| null | null | チャレンジの形。null = ふつう。`'readDiagram'` = **読んで作る**(説明とアクティビティ図だけで指示する)。図を必ず出し(`activityDiagram` は true になる)、ヒントを 3 ページ(図と説明 → 試す → 答えを見る)に置き換える(`steps` は使わない)。最後の手段のページ(「正解のプログラムを確認する」)は付かない。答えは `code`。下の「読んで作るチャレンジ」 | +| `explanation` | message \| null | null | 読んで作るチャレンジのヒントの 1 ページ目の説明。無ければ `task` を出す | ヒント(`steps` の要素)。deck の step と同じ `title` を文言にし、吹き出しのための項目を足す。 省いた項目は `defineChallenge` が既定値で埋める。 @@ -109,7 +132,7 @@ | 項目 | 型 | 既定 | 説明 | |------|----|------|------| | `title` | message \| null | null | 吹き出しの文言 | -| `target` | string \| null | null | 指す場所(`lib/lessons/hint-targets.js` の `HINT_TARGETS`): `palette`(パレット)・`code-area`(コードエリア)・`stage`(ステージ)・`sprite-list`(スプライトリスト)・`sounds-tab`(音タブ)・`costumes-tab`(コスチュームタブ)・`backdrop`(背景を選ぶ)・`extension-button`(拡張機能のボタン)・`green-flag`(旗)・`keyboard`(場所の無いもの。画面の真ん中に出す) | +| `target` | string \| null | null | 指す場所(`lib/lessons/hint-targets.js` の `HINT_TARGETS`): `palette`(ブロックパレット)・`code-area`(スクリプトエリア)・`stage`(ステージ)・`sprite-list`(スプライトペイン)・`sounds-tab`(音タブ)・`costumes-tab`(コスチュームタブ)・`backdrop`(背景を選ぶ)・`extension-button`(拡張機能のボタン)・`green-flag`(緑の旗)・`stop-button`(停止ボタン)・`code-tab`(コードタブ)・`ruby-tab`(ルビータブ)・`task-bar`(課題バー)・`hint-button`(課題バーの「ヒント」)・`practice-partner`(メッシュの練習相手のパネル。閉じているときは小さな「練習相手」のボタン)・`role-picker`(課題バーの役のボタン。役のあるチャレンジの「役を決めよう」のページ)・`keyboard`(場所の無いもの。画面の真ん中に出す) | | `blocks` | string \| `{ja, 'ja-Hira', en}` \| null | null | 吹き出しに描くブロック(Ruby。`code` と同じ変換でブロックにする)。`code` と同じく locale ごとにも書ける | | `spotlight` | boolean | false | はじめて開いたチャレンジだけ、周りを暗くして `target` を照らす | @@ -123,8 +146,9 @@ 開くときに照らす)。 文言の message id の付け方: `gui.lessons.course..name`・`gui.lessons.lesson..name`・ -`gui.lessons.challenge..name`。`task` / `steps[].title` / `debug[]` も -同じ `gui.lessons.` の下に置き、3 locale(en / ja / ja-Hira)にそろえる(テストが解決できることを確かめる)。 +`gui.lessons.challenge..name`。`task` / `steps[].title` / `debug[]` / `quiz` も +同じ `gui.lessons.` の下に置き(`quiz` は `gui.lessons.challenge..quiz.question` / `.quiz.choice1`〜`3` / +`.quiz.explanation`。`challengeQuiz` がこの id で作る)、3 locale(en / ja / ja-Hira)にそろえる(テストが解決できることを確かめる)。 `defineCourse` / `defineLesson` / `defineChallenge` は export してあるので、コースやレッスンが増えて ファイルを分けるときも同じ形で定義できる。 @@ -137,9 +161,9 @@ locale ごとに書ける: ```js code: { - ja: 'when_key_pressed("space") do\n play_until_done("ニャー")\n play("Owl")\nend\n', - 'ja-Hira': 'when_key_pressed("space") do\n play_until_done("Meow")\n play("Owl")\nend\n', - en: 'when_key_pressed("space") do\n play_until_done("Meow")\n play("Owl")\nend\n', + ja: 'when_key_pressed("space") do\n play_until_done("ニャー")\nend\n', + 'ja-Hira': 'when_key_pressed("space") do\n play_until_done("Meow")\nend\n', + en: 'when_key_pressed("space") do\n play_until_done("Meow")\nend\n', }, ``` @@ -150,12 +174,12 @@ code: { (scratch-l10n に ja-Hira の訳が無い)。スプライト名(「スプライト1」/ "Sprite1")・コスチューム名・背景名も locale で変わるので、`code` で名前を使うときは locale ごとに書く(いまのレッスン 1 で名前を使うのはチャレンジ 1 の ネコの音だけ。スプライトは名前でなく「`spriteCodes` に名前の無い最初のスプライト」で探す)。ライブラリの名前 - ("Owl" / "Canyon" / "Arctic" / "Penguin")は locale で変わらない。 + ("Canyon" / "Arctic" / "Penguin")は locale で変わらない。 - **「プログラムを入れる」は作品に合う組を探す**: いまの locale の `code`(と `spriteCodes`)を音・背景の確かめ込みで 試し、作品に合わない(日本語の作品を英語の UI で開いた、先生が配った日本語の作品を英語の生徒が開いた等)ときは、 ほかの locale の組を順に試して、合った組を入れる(`challengeCodeCandidates`)。試すのは変換だけで、作品に 入れるのは選んだ 1 組だけ。どれも合わなければ、わけのいちばん少ない組(同じならいまの locale の組)のわけを出す - (Owl をまだ足していない等。日本語の作品を英語の UI で開いたときに、作品に無い "Meow" を探させない)。 + (背景「Canyon」をまだ足していない等。日本語の作品を英語の UI で開いたときに、作品に無い "Meow" を探させない)。 - セリフ・変数名・リスト名は、その locale の課題とヒントの文言に合わせる。レッスン 1 では en の課題が "Hello!" / "That tickles!" / "Touch me" / "What's your name?" / " seconds" / "Correct" / "Wrong" と書くので en の `code` もそれを言う。 @@ -183,7 +207,7 @@ code: { - テスト: `courses.test.js` が全チャレンジの `code` を ja / ja-Hira / en それぞれの新しい作品の名前で(音・背景の 確かめ込みで)ブロックに変換できることを確かめる。`challenge-goals-per-locale.test.js` は、その `code` を それぞれの locale の新しい作品に入れて本物の VM で動かし、課題の操作(キー・クリック・答えの入力)をすると - `goal` を満たす(「できた」になる)ことを、全 11 チャレンジ × 3 locale で確かめる。integration は `smalruby-lessons-en.test.js`(en で + `goal` を満たす(「できた」になる)ことを、全チャレンジ × 3 locale で確かめる。integration は `smalruby-lessons-en.test.js`(en で チャレンジ 1・8・9 を開いて「プログラムを入れる」→ 操作 →「できた」)。 コース「きょうからプログラマー」の 11 のチャレンジは、どれも中身(課題・パレット・ヒント・判定・Ruby)が @@ -191,11 +215,13 @@ code: { ### コース「きょうからプログラマー」のチャレンジ +最初に **レッスン 0「スモウルビーをたんけんしよう」**(`blocks-l0`・`warmup`。下の「レッスン 0 のチャレンジ」)を置き、その後ろに 11 のチャレンジを 3 つのレッスンに分ける(順番と中身は 1 つのレッスンだったころと同じ)。下の表の # は コースの通し番号で、課題バーやレッスン表の番号はレッスンの中の番号(例: 6 は レッスン 2 の 2 個め)。 | レッスン | id | 名前(ja / ja-Hira / en) | チャレンジ(通し番号) | |---------|----|------------------------|---------------------| +| 0 | `blocks-l0` | スモウルビーをたんけんしよう / スモウルビーを たんけんしよう / Explore Smalruby | 0-1〜0-8(コースの数に入れない) | | 1 | `blocks-l1` | うごかしてみよう / うごかしてみよう / Let's Move | 1〜4 | | 2 | `blocks-l2` | えらんで たずねよう / えらんで たずねよう / Choose and Ask | 5〜7 | | 3 | `blocks-l3` | おぼえて つたえよう / おぼえて つたえよう / Remember and Tell | 8〜11 | @@ -205,56 +231,88 @@ code: { | # | id | 課題 | パレット(`allowedBlocks`) | できた の条件(`goal`) | |---|----|------|---------------------------|------------------------| -| 1 | `blocks-l1-key-sound` | スペースキーを押したら、ネコが「ニャー」と鳴いたあと、「Owl」の音が鳴る | `event_whenkeypressed` / `sound_playuntildone` / `sound_play` | スペースキーのスクリプトで `sound_playuntildone` → `sound_play` の順に動いた | +| 1 | `blocks-l1-key-sound` | スペースキーを押したら、ネコが「ニャー」と鳴く(音タブを使わない。はじめての操作を少なくする) | `event_whenkeypressed` / `sound_playuntildone` | スペースキーのスクリプトで `sound_playuntildone` か `sound_play` が動いた(音の名前は見ない) | | 2 | `blocks-l1-arrow-move` | 上向き矢印キーで上へ、下向き矢印キーで下へ、ネコを動かす | `event_whenkeypressed` / `motion_changeyby` | 上向き矢印キーのスクリプトで `DY > 0`、下向き矢印キーのスクリプトで `DY < 0` の `motion_changeyby` が動いた | | 3 | `blocks-l1-click-say` | コスチュームを足して、押したら「こんにちは!」と言って、見た目がかわる | `event_whenthisspriteclicked` / `looks_sayforsecs` / `looks_nextcostume` | コスチュームが始めより 1 つ以上増え、スプライトを押したスクリプトで `looks_sayforsecs` と `looks_nextcostume` が動いた | -| 4 | `blocks-l1-repeat` | 1 のキーを押したら、背景が「Canyon」と「Arctic」に 3 回かわる(**ステージのプログラム**) | `event_whenkeypressed` / `control_repeat` / `control_wait` / `looks_switchbackdropto` | ステージの 1 のキーのスクリプトで `control_repeat` が動き、`looks_switchbackdropto` が 6 回動いた | +| 4 | `blocks-l1-repeat` | 1 のキーを押したら、「Canyon」という名前の背景と「Arctic」という名前の背景に 3 回かわる(**ステージのプログラム**) | `event_whenkeypressed` / `control_repeat` / `control_wait` / `looks_switchbackdropto` | ステージの 1 のキーのスクリプトで `control_repeat` が動き、`looks_switchbackdropto` が 6 回動いた | | 5 | `blocks-l1-if` | マウスでネコにさわったら「くすぐったい!」、さわっていないときは「さわってみて」と言う | `event_whenflagclicked` / `control_forever` / `control_if` / `control_if_else` / `sensing_touchingobject` / `looks_say` | 旗のスクリプトで `sensing_touchingobject` が動き、ちがうセリフ(`MESSAGE`)の `looks_say` が 2 種類動いた | | 6 | `blocks-l1-ask-answer` | ネコを押したら名前を聞いて、答えた名前と、答えるまでにかかった秒数を言う | `event_whenthisspriteclicked` / `sensing_resettimer` / `sensing_askandwait` / `sensing_answer` / `sensing_timer` / `operator_join` / `looks_sayforsecs` | スプライトを押したスクリプトで `sensing_resettimer` → `sensing_askandwait` の順に動き、`sensing_answer`・`sensing_timer`・`looks_sayforsecs` 2 回が動いた。答えと同じことばを言った | | 7 | `blocks-l1-quiz` | ネコを押したら「4+3=?」と聞いて、7 なら「正解です」、ちがえば「ちがいます」と言う | `event_whenthisspriteclicked` / `sensing_askandwait` / `sensing_answer` / `control_if` / `control_if_else` / `operator_equals` / `looks_sayforsecs` | 答えが 7 のときに「正解です」(ja-Hira の「せいかいです」、en の "Correct" も可)、7 でないときに「ちがいます」(en の "Wrong" も可)を言った(両方) | | 8 | `blocks-l1-count` | ネコを押した回数を数えて、その数を言う。3 回押す | `event_whenflagclicked` / `event_whenthisspriteclicked` / `data_setvariableto` / `data_changevariableby` / `data_variable` / `looks_say` | 変数「回数」(ja-Hira の「かいすう」、en の `count` も可)が 3 以上になり、その値を言った | -| 9 | `blocks-l1-broadcast` | ペンギンを足して、ネコを押したらペンギンが「やあ!」と言う(**2 つのスプライト**) | `event_whenthisspriteclicked` / `event_broadcast` / `event_whenbroadcastreceived` / `looks_sayforsecs` | スプライト 2 つ以上・押されたときで送る・**別のスプライト**が受け取ったときに言う(`sentBy: 'other'`) | +| 9 | `blocks-l1-broadcast` | ペンギンを足して、ネコを押したらペンギンが「やあ!」と言う(**2 つのスプライト**。『Penguin』という名前のスプライトだという説明はヒント 1 に書き、課題バーは短くする) | `event_whenthisspriteclicked` / `event_broadcast` / `event_whenbroadcastreceived` / `looks_sayforsecs` | スプライト 2 つ以上・押されたときで送る・**別のスプライト**が受け取ったときに言う(`sentBy: 'other'`) | | 10 | `blocks-l1-speak` | 拡張機能「音声合成」を足して、ネコを押したら「ボタンが押されました」としゃべる | `event_whenthisspriteclicked` / `text2speech_speakAndWait` | 拡張機能 `text2speech` が読み込まれている・押されたときで `text2speech_speakAndWait` | | 11 | `blocks-l1-message-list` | ネコを押したら「メッセージは?」と聞いて、答えをリスト「トーク」にためる。3 つためる | `event_whenflagclicked` / `event_whenthisspriteclicked` / `data_deletealloflist` / `data_addtolist` / `sensing_askandwait` / `sensing_answer` | リスト「トーク」(en の `talk` も可)の長さ 3 以上・中身が答えから(`itemsFromAnswers`) | -ヒントは、音タブ・コスチュームタブ・背景を選ぶ・スプライトリストのように「足す・えらぶ」場所を指すものと、 -パレット・コードエリアを指して**本物のブロック**を描くもの、ステージ・キーボードを指して「動かしてみよう」と +#### レッスン 0 のチャレンジ + +画面の部分の名前とレッスンの進め方(ヒントを出したまま操作する)を覚える。8 チャレンジ・合計 約 12〜15 分で、 +1 チャレンジで新しく出る名前は 1〜2 個。`showPartNames: true`(名前の札を最初から出す)で、 +**パレットはしぼらない**(`allowedBlocks: null`)。ヒントは各 1〜3 ページで、吹き出しは `target` で部分を指す(スポットライトは +つかむ・押す・くっつける・消す・旗の基本操作だけ)。判定は**結果で見る**(タブを開いたことは見ない)。0-4 は前の答え、0-5 は +「15 度回す」と「マウスのポインターへ行く」の旗のスクリプト(`setup.code`)から、0-6 はシマラビ(`setup.sprites`。絵が 2 つ)から始める。課題・ヒント・クイズの部分の名前は **Scratch Wiki「Scratchユーザーインターフェース (3.0)」の名前** +(ブロックパレット・スクリプトエリア・コスチュームタブ・音タブ・コードタブ・ステージ・緑の旗・ +停止ボタン・スプライトペイン。Wiki に無い背景・課題バー・ヒントはそのまま。en は Block Palette / Code Area / Green Flag / +Stop Button / Sprite Pane など)で書く。 + +| # | id | 課題 | 新しい名前 | できた の条件(`goal`) | +|---|----|------|-----------|------------------------| +| 0-1 | `blocks-l0-drag-cat` | ステージのネコを、マウスでつかんで好きなところへ動かす | ステージ・スプライト | `moved`(ネコの位置がチャレンジを開いたときから変わった) | +| 0-2 | `blocks-l0-click-block` | ブロックパレットの「10 歩動かす」を押す(置かずにブロックパレットで) | ブロックパレット | `uses`・`trigger: {click: 'palette'}`・`motion_movesteps`(ブロックパレットで押して動いた。スクリプトエリアで押したもの・つかんで動かしたものは数えない) | +| 0-3 | `blocks-l0-snap` | 「10 歩動かす」と「15 度回す」をスクリプトエリアに置いて、くっつけて押す | スクリプトエリア・ドラッグ・くっつける | `uses`・`trigger: {click: 'codeArea'}`・`together: true`(スクリプトエリアで押した 1 回の実行で 2 つとも動いた = つながっている) | +| 0-4 | `blocks-l0-flag` | 「旗が押されたとき」をいちばん上にくっつけて緑の旗を押す。止めるときは停止ボタン(赤い ●) | 緑の旗・停止ボタン | `uses`・旗のスクリプトで「歩動かす」か「度回す」が動いた | +| 0-5 | `blocks-l0-change-number` | 「15 度回す」の「15」を「90」に変え、「マウスのポインターへ行く」の ▼ で「どこかの場所」をえらぶ。いらないブロックはブロックパレットへもどすと消える | 白いところ・▼・消す | `uses`・`trigger: {click: 'any'}`・`DEGREES` が 15 でない「度回す」と、`TO` がマウスのポインターでない「へ行く」が動いた(旗でも押してでも・別々の実行でもよい) | +| 0-6 | `blocks-l0-tabs` | シマラビ(絵が 2 つ)で始め、コスチュームタブで 2 つめの絵をえらび、音タブで ▶ を押して「Chirp」という名前の音を聞き、コードタブにもどる | タブ | `currentCostume`(`number: 2`)・`tab`(`code`)。音の再生は判定しない | +| 0-7 | `blocks-l0-sprite-backdrop` | スプライトペインのボタンからスプライトを 1 つ足し、背景も 1 つえらぶ | スプライトペイン・背景 | `sprites`(`min: 2`)・`currentCostume`(`target: 'stage'`・`changed: true`) | +| 0-8 | `blocks-l0-where` | 「ブロックパレットはどこ?」のように聞かれたら、画面のその場所をクリックして答える(5 問) | ふりかえり | `partQuiz`(`count: 5`。下の「どこでしょう?のクイズ」) | + +「足す・えらぶ」場所を指すものと、 +ブロックパレット・スクリプトエリアを指して**本物のブロック**を描くもの、ステージ・キーボードを指して「動かしてみよう」と 言うものの並び。スポットライト(はじめて開いたときだけ)は基本操作(出す・くっつける・押す・消す)のヒントに -だけ付けている(チャレンジ 1 のパレットとキーボード、チャレンジ 3 のパレット・ステージ・コードエリア)。 +だけ付けている(チャレンジ 1 のブロックパレットとキーボード、チャレンジ 3 のブロックパレット・ステージ・スクリプトエリア)。 どのチャレンジも、できあがりのプログラムの帽子のブロックを置くページがあり、ブロックを描くページは そのページで置いてほしいブロックを置いてほしい並びのまま描く(決まりは [`design.md`](design.md) の「ヒント」)。 帽子のブロックが描かれていることは `courses.test.js`(`every hat block of the answer is drawn in a hint`)が -3 locale で確かめる。 +3 locale で確かめる(最初から入っていて書きかえないスプライトのプログラムは除く)。 文言がつなげる相手・置く位置を言うページ(「〜の下に」「〜の上に」「〜の中に」「穴に」「つなげ」「くっつけ」など)は、 置くブロックを**相手のブロックとつないだ 1 つのかたまり**で描く(例: 「その下に『y座標を 10 ずつ変える』を くっつけよう」は帽子のブロック+「y座標を 10 ずつ変える」、「『ずっと』の中に『もし〜なら でなければ』を入れよう」は 「ずっと」に入れた「もし〜なら でなければ」)。描くのは相手(すぐ上のブロック・入れる先のブロック)と置くブロックで、 スクリプト全体ではない。これは `hint-pictures.test.js`(`a hint that names where to put a block draws it connected with its partner`)が、文言の言い方(正規表現 `NAMES_A_PARTNER`)と描いたかたまりの数で 3 locale とも確かめる。 -手順の最後のヒント(「うまく動かないときは」のページの前)は、どのチャレンジも「できた」になる操作を促すページ(ステージ・キーボード・旗を指す)で、 -それより前のページはステージ・キーボード・旗を指さない(できたら吹き出しが閉じて、そのあとのページは +手順の最後のヒント(「うまく動かないときは」のページの前)は、どのチャレンジも「できた」になる操作を促すページ(ステージ・キーボード・緑の旗を指す)で、 +それより前のページはステージ・キーボード・緑の旗を指さない(できたら吹き出しが閉じて、そのあとのページは 見られないため)。これは `courses.test.js`(`the hint that asks to try it out is the last one`)が確かめる。 -チャレンジ 3 は、ブロックの消し方(コードエリアを指す)を、ステージのスプライトを押すページの前に置く。 +チャレンジ 3 は、ブロックの消し方(スクリプトエリアを指す)を、ステージのスプライトを押すページの前に置く。 作るときの注意: - **ヒントに描くブロックは、まだ足していない音・背景でもよい**。吹き出しの変換(`hint-blocks.js`)は - converter の `validateAssets: false` で音・コスチューム・背景の存在を確かめない(「Owl の音を鳴らす」は - Owl を足す前から描く)。**`code` を入れるときの変換は従来どおり確かめる**ので、チャレンジ 1 の `code` - (`play("Owl")`)はヒント 1 のとおり Owl を足してから、チャレンジ 4 の `code` は背景を足してから入れる - (足していなければ入れずに、吹き出しの中に「まだプログラムを入れられないよ。先にヒントのとおりに足そう。」と - 変換のエラー(「音「Owl」は存在しません。…先に音を追加してください。」)を出す)。 + converter の `validateAssets: false` で音・コスチューム・背景の存在を確かめない(「Canyon の背景にする」は + Canyon を足す前から描く)。**`code` を入れるときの変換は従来どおり確かめる**ので、チャレンジ 4 の `code` は + ヒント 1 のとおり背景を足してから入れる(足していなければ入れずに、吹き出しの中に「まだプログラムを + 入れられないよ。先にヒントのとおりに足そう。」と変換のエラーを出す)。 - 中身の無い「繰り返す」を描くときは **`3.times`**(ブロック無し)と書く(帽子のブロックの下なら `when_key_pressed("1") do\n 3.times\nend\n`)。`3.times do ... end` は中身が無いと変換できない。帽子のブロックだけを描くときは `when_key_pressed("1") do\nend\n` のように中身の無い `do ... end` でよい(帽子のブロックは中身が無くても変換できる)。 - チャレンジ 4 のヒント 5 は、「繰り返す」の中に入れる 4 つ(`switch_backdrop("Canyon")` / `sleep(1)` / `switch_backdrop("Arctic")` / `sleep(1)`)を、「繰り返す」に入れた 1 つのかたまり(`3.times do ... end`)として描く。 - `self.y += -10` は「y座標を -10 ずつ変える」になる(チャレンジ 2 の下向き矢印)。 -- チャレンジ 1 の `code` とヒント 3 のネコの音は locale ごとに書く(ja は「ニャー」、en / ja-Hira は "Meow"。上の +- **チャレンジ 1 は音タブを使わない**。はじめての操作を少なくするため([`design.md`](design.md) の「はじめの一歩」)、 + 音を足す手順は無く、ネコの音だけを鳴らす。ヒントは、イベントのブロックを置く → 音のブロックをくっつける → + キーを押す、の 3 ページ(と「うまく動かないときは」)。 +- チャレンジ 1 の `code` とヒント 2 のネコの音は locale ごとに書く(ja は「ニャー」、en / ja-Hira は "Meow"。上の 「英語の UI でも使う」)。`goal` は音の名前を見ない。 -- ライブラリの音「Owl」・背景「Canyon」「Arctic」の表示名は日本語でも英語のまま(ライブラリの名前は - 翻訳されない)。ヒントの文言もそのまま "Owl" / "Canyon" / "Arctic" と書く。 +- ライブラリの背景「Canyon」「Arctic」・スプライト「Penguin」の表示名は日本語でも英語のまま(ライブラリの名前は + 翻訳されない)。英語の名前だけでは何のことか分からないので、課題とヒントの文言は「『Canyon』という名前の背景」 + 「『Penguin』という名前のスプライト」のように、何の名前かを書く(ja-Hira も「『Meow』というなまえのおと」)。 + ただしチャレンジ 9 の課題は「ペンギン」だけにして課題バーを短く保ち、『Penguin』という名前のスプライトだという説明は + ヒント 1 に書く。 +- **ヒントの文の画面の部分の呼び方**は、レッスン 0 で覚える 9 つの名前(タブ・ブロックパレット・スクリプトエリア・ステージ・ + 緑の旗と停止ボタン・スプライトペイン・背景・課題バー・ヒント)にそろえる(「上の『音』タブ」ではなく「音タブ」、 + 「右下の『スプライトを選ぶ』」ではなく「スプライトペインの『スプライトを選ぶ』」)。名前は Scratch Wiki の名前 + (決まりと 3 locale の対応表は `design.md` の「はじめの一歩」の「部分の名前は Scratch Wiki の名前」)。 + ブロックの名前(「旗が押されたとき」)はブロックの文字のまま書く。 - チャレンジ 4 のように**ステージのプログラム**のチャレンジは `codeTarget: 'stage'` にする。 「プログラムを入れる」がステージをえらんで(`vm.setEditingTarget`)Ruby タブの相手(`rubyCode.target`)も ステージにしてから入れるので、スプライトを編集中に押してもステージに入る。 @@ -286,6 +344,295 @@ with its partner`)が、文言の言い方(正規表現 `NAMES_A_PARTNER`) - エディタ(コードエリア)にフォーカスがあってもキーはステージに届く(`vm-listener-hoc` は SVG への keydown を VM に渡す)。`integration` テストはコードエリアをクリックしてからキーを押して確かめている。 +### コース「チャットをつくろう」のチャレンジ + +中学 2 年の授業のコース(方針は [`design.md` の「中 2 のコース「チャットをつくろう」」](design.md#中-2-のコースチャットをつくろう))。 +コース id は `chat-wo-tsukurou`、文言は `chat.locale.js`(ja / ja-Hira / en。`lessons.locale.js` に spread する)。 +レッスン 1〜5 が入っている。 + +- **始め方**: どのチャレンジも、新しい作品のネコを**シマラビ**(ライブラリの Shimaraby)に置きかえて始める + (`setup.sprites: ['Shimaraby']`)。「プログラムを入れる」の `code` もシマラビに入る。レッスン 1・2 はメッシュを使わない。 + レッスン 3 の 3-2・3-3 はシマラビとシマネコで始める(`setup.sprites: ['Shimaraby', 'Shimacat']`。シマネコのプログラムは `spriteCodes`)。 +- **キャラクターの名前**: シマラビとシマネコは、作品に足すときに**言語の名前**にする(ja / ja-Hira「シマラビ」「シマネコ」、 + en ほかは「Shimaraby」「Shimacat」。`lib/lessons/sprite-names.js`)。チャレンジの始め方・「プログラムを入れる」・ + 「スプライトを選ぶ」(3-1 で生徒が足す)のどれで足しても同じ名前になる。ライブラリ(`sprites.json`)・`setup.sprites`・ + `spriteCodes` の `sprite` はライブラリの名前(英語)のまま書き、スプライトを名前で探すとき(`findSpriteByName`)は、どの言語の + 名前でも見つける(日本語で作った作品を英語の画面で開いても、「プログラムを入れる」が同じスプライトに入る)。判定(`goal`)は + スプライトの名前を見ない。コスチューム(`shimacat-a` など)と音の名前はライブラリのまま。 +- **アクティビティ図**: 全チャレンジ `activityDiagram: true`。課題の全文に入らない大きい図は、ヒントの 1 ページ目で見る。 +- **ヒントの 1 ページ目**は、どのチャレンジも「課題の説明と、アクティビティ図を理解しよう。」(ja-Hira「かだいの せつめいと、 + アクティビティずを りかいしよう。」、en "Understand the task and the activity diagram.")で始め、図の読み方(ひし形・戻る線・ + とがった図形・くぼんだ図形・レーン)もこのページに書く。ブロックの絵は描かず、吹き出しはステージの左に出す(`kind: 'understand'`・ + `courses.js` の `withDiagramFirst`)。図はこのページだけに出し、手順は 2 ページ目から(手順のページに図を重ねると情報が + 多すぎるため)。読んで作る 1-4 は、もとから 1 ページ目が図と説明(下の「読んで作るチャレンジ」)。 +- **ヒントの文に色の言葉を書かない**: 「黄色い『イベント』の」ではなく「『イベント』の」と、なかまの名前だけで書く(ブロックの絵が + 付くので、色は絵に任せる)。手順・つまずき・課題の文の 3 locale とも。`courses.test.js` が確かめる。 +- **変数**: 「すべてのスプライト用」(Ruby の `$`)。名前は ja / ja-Hira が「シマラビのメッセージ」(カタカナなので + ja-Hira も同じ。画面のキャラクターの名前もカタカナ)、en が `shimaraby_message`。判定はどの名前でも通す。 +- **クイズ**: 用語は教科書(順次処理・反復処理・分岐処理・変数など)にそろえる。文は自分の言葉で書く。教科書に無いもの(乱数)は教科書の用語を使わない。 +- 「聞いて待つ」の質問は「メッセージを入力」(ja-Hira「メッセージを にゅうりょく」、en "Enter a message")。 + +レッスン 1「手順を図にしよう」(`chat-l1`。ja-Hira「てじゅんを ずに しよう」、en "Draw the Steps"): + +| # | id | 課題 | 答え(ja) | できた の条件(`goal`) | クイズの正解 | +|---|----|------|-----------|------------------------|-------------| +| 1 | `chat-l1-sequence` | 旗を押したら「メッセージを入力」と聞き、答えを変数「シマラビのメッセージ」に入れて 2 秒言う(順次処理) | `ask` → `$シマラビのメッセージ = answer` → `say($シマラビのメッセージ, 2)` | 旗のスクリプトで `sensing_askandwait` → `data_setvariableto` → `looks_sayforsecs` の順に動いた + 答えを入れた変数を言った | ②順次処理 | +| 2 | `chat-l1-repeat` | 「メッセージを入力」と聞いたあと、ずっと「変数を (答え) にして、(変数) と聞いて待つ」をくり返す(反復処理) | `ask` → `loop do` 〔`$シマラビのメッセージ = answer` → `ask($シマラビのメッセージ)`〕 | 旗のスクリプトで `control_forever`・`data_setvariableto` と、`sensing_askandwait` が 3 回(2 回以上入力した)+ 答えを入れた変数「シマラビのメッセージ」を質問にした(「聞いて待つ」の質問は吹き出しに出るので `said` の `equalsAnswer` と `equalsVariable` で見る) | ③反復処理 | +| 3 | `chat-l1-branch` | 何も入力しなければ「何か書いてね」、書いたら変数に入れて 2 秒言う(分岐処理) | `if answer == ""` 〔`say("何か書いてね", 2)`〕 `else` 〔変数に入れて言う〕 | 旗のスクリプトで `control_if_else` が動いた + 答えが空のときに「何か書いてね」(ja-Hira「なにか かいてね」、en "Write something")を言った + 答えを入れた変数を言った(2 回試す) | ①分岐処理 | +| 4 | `chat-l1-read-diagram` | 読んで作る: 「おわり」と入力するまで聞いて言うをくり返し、最後に「またね」と言う | `ask` → `until answer == "おわり"` 〔`say(answer, 1)` → `ask`〕 → `say("またね")` | 旗のスクリプトで `control_repeat_until` と、`sensing_askandwait` が 2 回と、「言う」ブロックで「またね」(en "Bye!")を言った(入力した「またね」では通さない) | ②またね | + +- **2 の答え**は、教科書のチャットの送る側から「送る」を抜いた形。レッスン 4 で「送る」を 1 つ足すと教科書のチャットになる。 + 「聞いて待つ」の質問に変数を入れるので、入力を待つあいだ、前のメッセージが吹き出しに出る。 +- **3 の「=」の右**はパレットの初期値を空にしてある(何も入力しなかった = 空の文字と等しい)。 +- **4 の答え**は、くり返しの前に 1 回聞き、くり返しの中は「言う → 聞く」にする(教科書のチャットの送る側と同じ + 「聞く → くり返し〔… → 聞く〕」の形)。Scratch の「答え」は前の実行の値を覚えているが、旗を押すたびに最初に聞くので、 + 前に「おわり」と入力していても、すぐ「またね」にはならない。「おわり」と入力したら「おわり」は言わずにくり返しをぬける。 + 判定の「聞いて待つが 2 回」は、くり返しの前の 1 回とくり返しの中の 1 回(くり返しを 1 回は通った)。終わりの言葉は + en が `end`。答えはふつうのチャレンジと同じく `code` に書き、ヒントの 3 ページ目に描く(置き換えない)。 +- ヒントの図の読み方は、教科書の記号にそろえた図(ひし形の合流と戻る線)に合わせて、1 ページ目に書く(例: 「いちばん下から上の + ひし形へもどる線が『ずっと』」)。 + +![チャットをつくろう 1-1 の課題の全文と図(1300×600)](screenshots/0701-chat-l1-sequence-full-text-1300x600.png) + +![チャットをつくろう 1-1 のヒントの 1 ページ目(課題の説明と、アクティビティ図を理解しよう・1300×600)](screenshots/0726-chat-l1-sequence-hint1-1300x600.png) + +![チャットをつくろう 1-1 のヒントの 2 ページ目(手順から。図は出さない・1300×600)](screenshots/0727-chat-l1-sequence-hint2-1300x600.png) + +![チャットをつくろう 1-2 のヒントの 1 ページ目(1300×600)](screenshots/0702-chat-l1-repeat-hint1-1300x600.png) + +![チャットをつくろう 1-4 読んで作るのヒントの 1 ページ目(1300×600)](screenshots/0703-chat-l1-read-diagram-hint1-1300x600.png) + +![チャットをつくろう 1-1 の「できた!」のクイズ(1300×600)](screenshots/0704-chat-l1-sequence-quiz-1300x600.png) + +![チャットをつくろう 1-4 読んで作るのヒントの 3 ページ目(答え・1300×600)](screenshots/0705-chat-l1-read-diagram-answer-1300x600.png) + +![レッスン表の「チャットをつくろう」(1300×600)](screenshots/0706-chat-lessons-library-1300x600.png) + +レッスン 2「データとイベント」(`chat-l2`。ja-Hira も「データとイベント」、en "Data and Events"): + +| # | id | 課題 | 答え(ja) | できた の条件(`goal`) | クイズの正解 | +|---|----|------|-----------|------------------------|-------------| +| 1 | `chat-l2-omikuji` | シマラビを押したら 1〜3 の乱数を変数「くじ」に入れ、1 なら「大吉」、それ以外は「小吉」と 2 秒言う | `$くじ = rand(1..3)` → `if $くじ == 1` 〔`say("大吉", 2)`〕 `else` 〔`say("小吉", 2)`〕 | 押したときのスクリプトで `operator_random`(1 から 3)・`data_setvariableto`・`control_if_else` が動いた + 「くじ」が 1 のときに「大吉」、1 でないときに「小吉」を言った(`said` の `variable`) | ①3 回に 1 回 | +| 2 | `chat-l2-timer` | 旗でタイマーをリセットし、タイマーが 10 より大きくなるまで待ってから「10秒たったよ」と言う | `timer.reset` → `wait until timer.value > 10` → `say("10秒たったよ")` | 旗のスクリプトで `sensing_resettimer` → `control_wait_until` → `looks_say` の順に動き、`sensing_timer` と、右が 10 以上の `operator_gt` が動いた + 「10秒たったよ」(ja-Hira「10びょう たったよ」、en "10 seconds passed")を言った | ①使う時間を自分で制御できなくなる | +| 3 | `chat-l2-janken` | 「0:グー 1:チョキ 2:パー」と聞き、0〜2 の乱数を変数「手」に入れ、答えと同じなら「あいこ」、ちがえば「勝負あり」と 2 秒言う | `ask` → `$手 = rand(0..2)` → `if answer == $手` 〔`say("あいこ", 2)`〕 `else` 〔`say("勝負あり", 2)`〕 | 押したときのスクリプトで `operator_random`(0 から 2)・`sensing_askandwait`・`data_setvariableto`・`control_if_else` が動いた + 「手」と答えが同じときに「あいこ」、ちがうときに「勝負あり」を言った(`said` の `variable.equalsAnswer`) | ②値を入れておき、あとで比べるのに使う | + +- **変数の名前**: 「くじ」は ja / ja-Hira とも「くじ」、en が `fortune`。「手」は ja が「手」、ja-Hira が「て」、en が `hand`。 + 言うことは ja-Hira が「だいきち」「しょうきち」「しょうぶあり」、en が "Great luck" / "Small luck" / "Tie" / "No tie"。 +- **1・3 の判定**は「分岐で言い分けたこと」を、言った時点の変数の値で見る。分岐を使わずに両方を言うプログラムは通らない。 + くじを見ずに別の乱数で分けるプログラム、答えを決まった数と比べるプログラムは、乱数の出方しだいで何回か試すうちに通ることがある + (判定は動いた結果を見るので、そこまでは見分けない)。`challenge-goals-per-locale.test.js` の「通ってはいけない例」は、 + 乱数を決めた場合に、これらが通らないことを確かめる。 +- **2 のタイマー**は、授業で試せるように 10 秒にする。課題の全文に「本当に使いすぎを知らせるなら 600 秒(10 分)」と書く。 + 判定は「>」の右が 10 以上(600 にしても通る)。左の値(タイマー)は実行ごとに変わり、記録する引数の種類に上限がある + (`goal.js` の `MAX_ARGS_SEEN`)ので条件にしない。右は数に限る(「10秒」のような文字だと Scratch は文字として比べ、2 秒ほどで + 成り立つ)。同じスクリプトの「言う」は待つが終わってから動くので、`order` で「待ったあとに言った」ことになる。ただし `order` は + それぞれのブロックが**最初に動いた順だけ**を見る(あとで動いた分は見ない)。`> 1` のように早く終わる条件では通らない。 +- **クイズ**: 1 の乱数は教科書に無いので教科書の用語は使わない。2 は教科書の「使う時間を自分で制御できなくなる」(使いすぎへの + 対策)、3 は変数のはたらき。 +- ヒントの図の読み方は、分岐のひし形と、枝の [条件] / [それ以外] に合わせて、1 ページ目に書く(例: 「枝の [くじ = 1] が『もし』の条件」)。 + +![チャットをつくろう 2-1 の課題の全文と図(1300×600)](screenshots/0707-chat-l2-omikuji-full-text-1300x600.png) + +![チャットをつくろう 2-2 のヒントの 1 ページ目(1300×600)](screenshots/0708-chat-l2-timer-hint1-1300x600.png) + +![チャットをつくろう 2-3 のヒントの 5 ページ目(1300×600)](screenshots/0709-chat-l2-janken-hint4-1300x600.png) + +![チャットをつくろう 2-2 の「できた!」のクイズ(1300×600)](screenshots/0710-chat-l2-timer-quiz-1300x600.png) + +レッスン 3「メッシュでつながろう」(`chat-l3`。ja-Hira「メッシュで つながろう」、en "Connect with Mesh")。ペアが基本で、 +ひとりのときは練習相手の**シマネコ**とやる(`partner`)。ペアでシマネコの役の人は、課題バーで役を選ぶと名前を入れかえた形で出る(3-3。下の「ペアの役」)。 +判定はどちらの役の名前も通す。変数とメッセージは同じ名前にする(教科書の形)。拡張機能「メッシュ」は 3-2 で生徒が足し、 +3-3 は `setup.extensions: ['meshV2']` で読み込んでおく: + +| # | id | 課題 | 答え(ja) | できた の条件(`goal`) | クイズの正解 | +|---|----|------|-----------|------------------------|-------------| +| 1 | `chat-l3-local-message` | ライブラリからシマネコを足し、旗でシマラビが聞いた答えを変数「シマラビのメッセージ」に入れてメッセージ「シマラビのメッセージ」を送る。受け取ったシマネコがその変数を 3 秒言う(同じコンピューターの中) | シマラビ: `ask` → `$シマラビのメッセージ = answer` → `broadcast("シマラビのメッセージ")`、シマネコ: `when_receive("シマラビのメッセージ")` 〔`say($シマラビのメッセージ, 3)`〕 | スプライトが 2 つ以上 + 旗のスクリプトで `sensing_askandwait` → `data_setvariableto` → `event_broadcast` の順に動いた + ほかのスプライトから受け取ったスクリプトで `looks_sayforsecs` と、変数「シマラビのメッセージ」を読む `data_variable` が動いた + **ほかのスプライトから受け取ったスクリプトで**、答えを入れた変数を言った(`said` の `trigger`) | ①「送ったよ」という知らせだけ | +| 2 | `chat-l3-mesh-signal` | 拡張機能「メッシュ」を足し、ペアならホストと参加(ひとりなら練習相手)。スペースキーでシマラビがメッセージ「てをふる」を送り、受け取ったシマネコが「やあ!」と 2 秒言う | シマラビ: `when_key_pressed("space")` 〔`broadcast("てをふる")`〕、シマネコ: `when_receive("てをふる")` 〔`say("やあ!", 2)`〕 | `meshV2` を読み込んだ + スペースキーのスクリプトで「てをふる」を送った(「送る」「送って待つ」「値つきで送る」のどれでもよい。`blocks` の `opcode` の配列)+ 「てをふる」を受け取ったスクリプトで `looks_sayforsecs` が動いた(自分の送ったメッセージも自分に届くので、ひとりでも「できた」になる) | ③プロトコル | +| 3 | `chat-l3-mesh-variable` | 1 のキーで変数「シマラビのきぶん」を「うれしい」、2 のキーで「ねむい」にする。シマネコを押したら「シマネコのきぶん」のセンサーの値を 2 秒言う | シマラビ: `when_key_pressed("1")` 〔`$シマラビのきぶん = "うれしい"`〕・`when_key_pressed("2")` 〔`$シマラビのきぶん = "ねむい"`〕、シマネコ: `when_clicked` 〔`say(mesh.sensor_value("シマネコのきぶん"), 2)`〕 | 1 のキーのスクリプトで気分の変数を「うれしい」に、2 のキーのスクリプトで「ねむい」にした + 気分の変数が**ステージの変数**(すべてのスプライト用。メッシュで共有されるのはこれだけ)で、いま「うれしい」か「ねむい」(`variable` の `target: 'stage'`)+ 押したときのスクリプトで、気分の名前の `meshV2_getSensorValue` と `looks_sayforsecs` が動いた + 押したときのスクリプトで「うれしい」か「ねむい」を言い、それが**ほかのノード(練習相手・ペアの相手)から届いた値**だった(`said` の `remoteValue`。センサーに値が届いていないと何も言わないので、相手が気分を変えてから押したことになる) | ②IP アドレス | + +- **名前**: メッシュで相手に届く名前(メッセージ・共有する変数)は、**ja と ja-Hira で同じ**にする(漢字を使わない形。ja と ja-Hira の + 生徒がペアになっても届くように)。メッセージは「てをふる」、気分の変数は「シマラビのきぶん」「シマネコのきぶん」(Ruby の変数名に + 空白は入れられないので続けて書く)。en は別の名前(メッセージ `wave`、変数 `shimaraby_mood` / `shimacat_mood`。en と ja のペアは + 考えない)。値は「うれしい」「ねむい」(en "happy" / "sleepy")、「やあ!」は en "Hi!"。判定はどの名前・どちらの役の名前でも通す。 + 課題の文の「気分」は言葉としては漢字で書き、名前だけを「〜のきぶん」と書く。 +- **練習相手**: 3-2 は「てをふる」のボタン(`broadcast`)だけ。3-3 は「うれしい」「ねむい」のボタンで「シマネコのきぶん」を変える(`set` の + `value` は locale ごとの `{ja, 'ja-Hira', en}`)。3-3 は `watch: ['シマラビのきぶん']`(locale ごと)で、1・2 のキーで変えた + 自分の気分もパネルの「シマネコに届いた」に出す。3-1 は同じコンピューターの中なので練習相手はいない。 +- **3-1 の判定**は、「受け取ったスクリプトで変数を読んで言った」ことを見る(`uses` の `data_variable` と `said` の `trigger`)。シマラビが + 自分で変数を言い、シマネコは別のことを言うプログラム、変数に入れたうえでシマネコが (答え) を言うプログラムは通らない。「言う」ブロックは + 見張りのすぐあとに同じブロックの中で吹き出しを出すので、goal-monitor は最後にブロックを動かしたスクリプト(同じスプライトのもの + だけ。1 つの吹き出しに 1 回だけ使う)を、その吹き出しを言ったスクリプトにする。 +- **3-2 の判定**は、メッシュで届いた合図の送り手を記録しないので `sentBy` を使わない(上の「メッシュの練習相手」)。 +- **3-3 の判定**は、言った文字が、言ったときに**自分以外のノード**(練習相手 `smalruby-mesh-practice-partner`・ペアの相手)から届いて + いた変数の値のどれかと同じかを見る(`remoteValue`)。自分の変数の値(`remoteData[自分]`。自分の変数の「センサーの値」用)は入れないので、 + 自分の気分のセンサーの値や自分の気分の変数を言うプログラムは、相手の気分と同じ値でない限り通らない。 +- **3-3 の判定で見分けないもの**: 押したスクリプトでセンサーの値のブロックを動かしたうえで、相手から届いている値と同じ文字(「うれしい」)を + 書いて言うプログラムは通る。自分の気分のセンサーの値でも、相手の気分とたまたま同じ値なら通る。 +- **3-3 のヒント**: 「センサーの値」の ▼ には、届いた変数(と自分のグローバル変数)の名前だけが出る。そのため、先に練習相手の + 「うれしい」を押してから(ペアなら相手が 1 のキーを押してから)▼ で「シマネコのきぶん」をえらぶ順にしてある。「うまく動かないときは」 + に「▼ で自分の気分をえらばない」を入れてある。 +- **練習相手のパネルとヒント**: パネルを押すページ(3-2 の 3 ページ目・3-3 の 7 ページ目)は `practice-partner` を指す。パネルが出ている + ときは、どのページの吹き出しもパネルにかからない位置に置く(下の「ヒントの吹き出し」)。 +- ヒントの図の読み方は、送信は「端がとがった図形」、受信は「端がくぼんだ図形」、とがった図形からくぼんだ図形へ矢印、と書き、 + 1 ページ目に書く(「五角形」「へこんだ箱」は分かりにくいので使わない。`courses.test.js` が確かめる)。どちらの端がとがる・くぼむかは + 相手のいる側で変わる(送信は相手の側がとがり、受信は送り手の側がくぼむ・両側にいれば両端)ので、そのチャレンジの図に合わせて + 「右端」「左端」「両端」を書く。 +- **ヒントの強調(`**…**`)**: 文言の `**…**` は、吹き出しで淡い注意の地に濃い朱色の太字で出る(`$color-emphasis` / + `$color-emphasis-background`・`lib/lessons/hint-text.js` の `splitEmphasis`。文字として出すので HTML にはならない)。スプライトを + 足すとえらばれているスプライトが変わり、えらびなおし忘れが多いので、別のスプライトをえらぶ手順の「〜をえらんで」「〜をえらびなおして」に + 使う(3-1 の 3・5 ページ目など)。前の手順で別のスプライトを足した・見たときは「えらびなおして」と書く。3 locale で同じ数だけ付ける + (`courses.test.js` が確かめる)。手順と「うまく動かないときは」で使える。 + メッセージを新しく作る手順は、新しく作ることに気づかない生徒が多いので「**▼ の『新しいメッセージ』で**」を強調する + (チャットのコースの 8 か所すべて。`courses.test.js` が確かめる)。 +- **受け取る準備のページ**: ブロックを置かずに、練習相手(ペアなら相手)に送ってもらって、センサーの値の ▼ に相手の変数の + 名前を出すだけのページ(3-3 の 7 ページ目・4-3 の 6 ページ目)は、「〜を受け取る準備をしよう。」で始める(ブロックを置く + 手順とまちがえないように)。 +- **メッシュのつなぎ方(クラスの中と外)**: つなぎ方の手順(3-2 の 3 ページ目・4-1 の 4 ページ目)は、手順に `classroom: true` を + 付け、`stepN.inClass` の文言を足す。クラスに参加中の生徒(出席番号がある・接続モーダルが「出席番号でつながる」を出す人。 + `isSeatedStudent`)には「2 人とも『出席番号でつながる』を選び、相手の出席番号を選んで『つなぐ』」を、ほか(クラスの外・先生)には + 「1 人が『メッシュのホストになる』、もう 1 人が『メッシュに参加する』」を出す。ひとりのときの練習相手のパネルはどちらにも書く。 +- **「メッシュにつなごう」のページ**: つなぐ手順の無かったペア・グループのチャレンジ(3-3・4-2〜5-5)は、2 ページ目に + 「メッシュにつなごう」を置く(`connectStep`)。チャレンジを始めると作品を読み込み直すので、前のチャレンジからつながったままかは + 生徒にはわからないため、「もうつながっていれば次へ」と書く。文は短く(ペアは 100 字ほど)。文はどのチャレンジでも同じなので、チャレンジの + `stepN` ではなく共通の文言(`gui.lessons.chat.connect.pair` / `.group` と、それぞれの `.inClass`)を使う(`withTitles` は手順に + `title` / `classroomTitle` があればそれを使う)。4-4・4-5 は 3 人以上のグループの文(クラスの中は「グループの人の出席番号を全部選ぶ」)。 + 役を決めることはこのページに書かず、次の「役を決めよう」のページに分ける(下の「ペアでやるチャレンジの役」)。 +- **相手が人間のときの確かめ方(4-1・4-2・3-3)**: 自分の画面の「送った」では、相手に届いたかはわからない。確かめのページは + 「ひとりなら練習相手のパネルの『シマネコに届いた』、ペアなら**相手の画面**で『メッシュの状態と履歴』のウィンドウを開き、『履歴』に + 『受け取った』の行が出るか(3-3 は『状態』の届いた変数に自分の気分が出るか)、2 人で見せ合う」と書く(相手の画面には + 受け取るプログラムがまだ無いため)。 +- **D7(メッセージが変数より先に届く)**: 3-1 は同じコンピューターの中なので起こらない。本物のメッシュ(ペア)での回数はレッスン 4 + の実装の確認で見る(答えはこのまま)。 + +![チャットをつくろう 3-1 の課題の全文と図(1300×600)](screenshots/0711-chat-l3-local-message-full-text-1300x600.png) + +![チャットをつくろう 3-2 のヒントの 1 ページ目と練習相手のパネル(1300×600)](screenshots/0712-chat-l3-mesh-signal-hint1-1300x600.png) + +![チャットをつくろう 3-3 のヒントの 1 ページ目(スイムレーンの図)と練習相手のパネル(1300×600)](screenshots/0713-chat-l3-mesh-variable-hint1-1300x600.png) + +![チャットをつくろう 3-3 の「できた!」のクイズ(1300×600)](screenshots/0714-chat-l3-mesh-variable-quiz-1300x600.png) + +![チャットをつくろう 3-3 のヒント 7 ページ目(練習相手のパネルを指し、パネルにはかからない・1300×600)](screenshots/0715-chat-l3-mesh-variable-hint4-partner-1300x600.png) + +レッスン 4「チャットを作ろう」(`chat-l4`。ja-Hira「チャットを つくろう」、en "Make a Chat")。1 回送る → くり返し送る → おたがいに → +グループ → ダイレクトメッセージ、と育てて教科書の形のチャットを作る。どの段も、シマラビ・シマネコと拡張機能「メッシュ」に、前の段の +**答え**を入れて始める(`setup: {sprites: ['Shimaraby', 'Shimacat'], extensions: ['meshV2'], code, spriteCodes}`。4-1 はプログラムなし)。 +4-1〜4-3 はシマラビの役(練習相手 = シマネコの役。ペアでシマネコの役を選ぶと名前と受け持ちを入れかえた形で出る。判定は両方の名前を通す・下の「ペアの役」)。 +4-4 からは、みんなで 1 つの変数・メッセージ「メッセージ」に切りかえる(4-4 の始めは 4-3 をその形に置きかえたもの。シマネコはみんなの発言を言う役): + +| # | id | 課題 | 足すもの(ja) | できた の条件(`goal`) | クイズの正解 | +|---|----|------|-----------|------------------------|-------------| +| 1 | `chat-l4-send-once` | 旗でシマラビが聞いた答えを変数「シマラビのメッセージ」に入れ、メッセージ「シマラビのメッセージ」を送る | シマラビ: `ask` → `$シマラビのメッセージ = answer` → `broadcast("シマラビのメッセージ")` | 旗のスクリプトで `sensing_askandwait` → `data_setvariableto` → 送る の順に動いた(変数とメッセージは自分のメッセージの名前)+ 自分のメッセージの変数が**ステージの変数**で、入力した答えが入っている(`variable` の `fromAnswer`) | ②パケット | +| 2 | `chat-l4-send-repeat` | 「〜にする」と「送る」を「ずっと」に入れ、その下に「(シマラビのメッセージ) と聞いて待つ」(レッスン 1-2 の形) | `loop do` 〔`$シマラビのメッセージ = answer` → `broadcast(…)` → `ask($シマラビのメッセージ)`〕 | 旗のスクリプトで `control_forever` が動き、聞いて待つ・変数に入れる・送る がそれぞれ 2 回以上動いた + 変数に入力した答えが入っている | ②サーバ | +| 3 | `chat-l4-both-ways` | シマネコが、メッセージ「シマネコのメッセージ」を受け取ったら、そのセンサーの値を言う | シマネコ: `when_receive("シマネコのメッセージ")` 〔`say(mesh.sensor_value("シマネコのメッセージ"))`〕 | 旗のスクリプトで自分のメッセージを送った + 相手(またはペアで入れかえた側)のメッセージを受け取ったスクリプトで、その名前の `meshV2_getSensorValue` と「言う」が動いた + そのスクリプトで言った文字が**ほかのノードから届いた値**(`said` の `remoteValue`) | ②「(変数) を言う」を「(〜のセンサーの値) を言う」に | +| 4 | `chat-l4-group` | はじめに「名前は?」と聞いて変数「なまえ」に入れ、「なまえ:メッセージ」の形で送る | `ask("名前は?")` → `$なまえ = answer`、`$メッセージ = $なまえ + ":" + answer` | 旗のスクリプトで「なまえ」に入れ、`operator_join` が 2 回動き、「メッセージ」を送った + 「なまえ」に入力した答えが入っている(`fromAnswer`)+ ステージの変数「メッセージ」が「:」を含み、「なまえ」の値を含む(`includesVariable`) | ②人が増えるたびに変数と受け取るプログラムを足す | +| 5 | `chat-l4-dm` | メッセージのあと「だれに送る?」と聞いて変数「あてさき」に入れてから送る。シマネコは「あてさき」のセンサーの値が自分の名前と同じときだけ言う | シマラビ: `ask("だれに送る?")` → `$あてさき = answer`、シマネコ: `if mesh.sensor_value("あてさき") == $なまえ` 〔言う〕 | 旗のスクリプトで「あてさき」に入れて「メッセージ」を送った + 「あてさき」がステージの変数で入力した答え + 「メッセージ」を受け取ったスクリプトで `control_if`・`operator_equals`・「あてさき」の `meshV2_getSensorValue`・変数「なまえ」の `data_variable`・言う が動いた + そのスクリプトで、ほかのノードから届いたメッセージ(「:」を含む)を言った | ①機密性 | + +- **名前**: メッシュで相手に届く名前は ja と ja-Hira で同じ(「シマラビのメッセージ」「シマネコのメッセージ」「メッセージ」)。「なまえ」 + 「あてさき」もすべてのスプライト用の変数なのでメッシュで共有されるから、同じ決まりで漢字を使わない形にする(判定は「名前」「あて先」も + 通す)。en は `shimaraby_message` / `shimacat_message` / `message` / `name` / `to`。つなぐ文字は ja / ja-Hira が「:」、en が ": "。 +- **練習相手**: 4-1〜4-3 は「こんにちは」「元気?」のボタン(シマネコのメッセージを変えて送る)と、「シマラビのメッセージ」を受け取ったら + 「とどいたよ」を送り返す自動の返事。4-4 は「シマネコとして送る」「ミミとして送る」(「メッセージ」を「シマネコ:こんにちは」などにして送る)。 + 4-5 は「あなたに DM」(「あてさき」を、押したときの生徒の「なまえ」の値にする `fromVariable`。「名前」「name」でもよい)と「ミミに DM」。 + 名前をまだ入れていない(空・作ったときの 0)ときは「あなたに DM」を押しても送らず、パネルに「「なまえ」がまだ空。先に旗を押して + 入れよう。」と出す。ミミはキャラクターではない人の名前。 +- **見分けないもの**: 4-1 で、決まった文字を入れても、それと同じ文字を入力すれば通る。4-3 で、受け取るメッセージの ▼ を自分のメッセージに + しても、前に届いた相手の値を言えば通る(センサーの値の名前は見るが、ハットの名前との組み合わせは見ない)。4-5 で、いつも成り立つ条件の + 「もし」(「あてさき」のセンサーの値と「なまえ」を読んだうえで比べ方をずらすなど)は、自分あての DM が届けば通る。 + `challenge-goals-per-locale.test.js` の「通ってはいけない例」は、変数に入れずに送る・決まった文字を入れる・このスプライトのみの変数・ + 入れる前に送る(4-1)、ずっとを使わない・聞かずに送り続ける(4-2)、自分のメッセージのセンサーの値・3-1 の形・センサーを読まずに同じ文字(4-3)、 + 名前を聞かない・聞いたのに決まった名前・「:」なし・決まった名前(4-4)、もし無し・自分の「あてさき」の変数と比べる・このスプライトのみの + 「あてさき」・「だれに送る?」なし・ほかの人あての DM だけ(4-5)が通らないことを確かめる。 +- **ヒントの図**: 左が「あなた」のレーン(4-3 からはシマラビとシマネコの列)、右が相手のレーン。「ずっと」はひし形への戻る線、4-5 の「もし」は + ひし形から出る [「あてさき」のセンサー値 = なまえ] の枝(どれも 1 ページ目に書く)。4-4 の 5 ページ目・4-5 の 3 ページ目はできあがりの形を描く(「なまえ」が文字の変数だと + 分かる代入が同じ絵に無いと「+」がつなぐにならないため)。 +- **D7(メッセージが変数より先に届く)**: 4-5 は「メッセージ」と「あてさき」を続けて送るので、本物のメッシュでは前の「あてさき」で届くことがある。 + 答えはこのままにし、「うまく動かないときは」に「もう一度送ってみよう」を 1 行入れてある。 +- メッシュの「センサーの値」の名前と同じ名前のグローバル変数がある(4-4・4-5 の「メッセージ」)。同じ名前を知らせるメッシュのお知らせは無くしたので、出ない。 + +![チャットをつくろう 4-1 のヒントの 1 ページ目(「あなた」と相手のスイムレーン)と練習相手のパネル(1300×600)](screenshots/0716-chat-l4-send-once-hint1-1300x600.png) + +![チャットをつくろう 4-3 のヒント 6 ページ目(練習相手のパネルを指し、パネルにはかからない・1300×600)](screenshots/0717-chat-l4-both-ways-hint3-partner-1300x600.png) + +![チャットをつくろう 4-4 のヒント 5 ページ目(できあがりの形・1300×600)](screenshots/0718-chat-l4-group-hint3-1300x600.png) + +![チャットをつくろう 4-5 のヒント 4 ページ目(シマネコの「もし」・1300×600)](screenshots/0719-chat-l4-dm-hint2-1300x600.png) + +![チャットをつくろう 4-5 の「できた!」のクイズ(1300×600)](screenshots/0720-chat-l4-dm-quiz-1300x600.png) + +レッスン 5「チャットを改良しよう」(`chat-l5`。ja-Hira「チャットを かいりょう しよう」、en "Improve the Chat")。改良のテーマを 1 つずつ +チャレンジにしたもので、生徒は 1 つ以上を選んでやる。**テーマを 1 つ「できた」にすればレッスンの ✓ がつく**(`checkCount: 1`・ +design.md の「中 2 のコース」。コースの ✓ もこれで数える)。どのテーマも、シマラビ・シマネコ・メッシュに **4-3 の答え**(シマラビが聞いて送り、シマネコが +相手のメッセージを言う 2 人のチャット)を入れて始め(`setup: {sprites, extensions: ['meshV2'], code, spriteCodes}`)、最低限の機能を +足したところまでを「できた」にする。その先の工夫は判定せず、課題の全文の最後の「さらに工夫するなら」に 1 行書くだけ(提出した作品で +先生が見る): + +| # | id | 課題 | 足すもの(ja) | できた の条件(`goal`) | クイズの正解 | +|---|----|------|-----------|------------------------|-------------| +| 1 | `chat-l5-read-receipt` | 相手のメッセージが届いたらシマネコが「Meow」を鳴らし、シマネコを押すと「シマラビがよんだ」を送る。シマラビは「シマネコがよんだ」を受け取ったら「既読」と 2 秒言う | シマネコ: 受け取ったときに `play("Meow")`、`when_clicked` 〔`broadcast("シマラビがよんだ")`〕、シマラビ: `when_receive("シマネコがよんだ")` 〔`say("既読", 2)`〕 | 相手のメッセージを**相手から**受け取ったスクリプトで音を鳴らした + 押したスクリプトで既読の合図(どちらかの役の名前)を送った + **相手から**届いた既読の合図を受け取ったスクリプトで「既読」と言った | ①双方向性 | +| 2 | `chat-l5-ng-word` | 入力した言葉がリスト「NGワード」に入っていたら、送らずに「その言葉は送れません」と言う。入っていなければ送る | 「ずっと」の中を `if $NGワード.include?(answer)` 〔注意〕 `else` 〔`$シマラビのメッセージ = answer` → 送る〕に | 旗のスクリプトで `data_listcontainsitem`・`control_if_else`・送る が動いた + NG ワード(「ばか」「きらい」)を入力したときに「送れません」と言った + 自分のメッセージの変数(ステージの変数)に入力したふつうの言葉が入っている + 最後に旗を押した実行で NG ワードを自分のメッセージの変数に入れていない(`uses` の `not`。直して旗を押し直せば通る) | ①フィルタリング | +| 3 | `chat-l5-auto-reply` | 「シマネコのメッセージ」を受け取ったとき、現在の時が 21 より大きければ「もう寝ています。朝に返事します」を送り返す。昼は 21 を小さい数にして確かめる | シマラビ: `when_receive("シマネコのメッセージ")` 〔`if Time.now.hour > 21` 〔変数に入れて送る〕〕 | 相手のメッセージを**相手から**受け取ったスクリプトで、もし・「現在の (時)」(`sensing_current` の `HOUR`)・比べる(`>` か `<`)・自分のメッセージの変数に入れる・送る が動いた(自動返信が送られた) | ①一度も返信しない(「かつ」と「または」・バグとデバッグ) | +| 4 | `chat-l5-password` | 旗で「合言葉は?」と聞き、「もみじ」ならチャットを始め、ちがえば「合言葉がちがいます」と言う | `ask("合言葉は?")` → `if answer == "もみじ"` 〔4-3 の送る側〕 `else` 〔`say("合言葉がちがいます", 2)`〕 | 旗のスクリプトで `operator_equals`・`control_if_else`・送る が動いた + 合言葉でない答えのときに「ちがいます」と言った + 自分のメッセージの変数に合言葉のあとに入力したメッセージが入っている + 最後に旗を押した実行で合言葉を自分のメッセージの変数に入れていない | ①認証システム | +| 5 | `chat-l5-stamp` | シマラビを押すと「シマラビのスタンプ」を送る。「シマネコのスタンプ」を受け取ったら、シマネコのコスチュームを「shimacat-b」にして 2 秒待ち「shimacat-a」にもどす | シマラビ: `when_clicked` 〔`broadcast("シマラビのスタンプ")`〕、シマネコ: `when_receive("シマネコのスタンプ")` 〔`switch_costume` ×2・`sleep(2)`〕 | 押したスクリプトでスタンプの合図を送った + **相手から**届いたスタンプの合図を受け取ったスクリプトで、ちがう 2 つのコスチュームにかえ(`distinct: 'COSTUME'`)、待った | ②静止画 | + +- **5-3 は「時間で自動返信」**(教科書の改良の例が、時刻での自動返信と、その条件の誤りのデバッグのため)。使いすぎを知らせるタイマーは、 + レッスン 2-2 と 5-3 の「さらに工夫するなら」に残す。 +- **「相手から」**(`trigger.sentBy: 'remote'`): この作品のスクリプトが送っていない合図(メッシュでほかのノード・練習相手から届いた)で + 動いたスクリプトだけを数える。押して送る名前と受け取る名前を同じにする(自分の画面だけで既読・スタンプになる)プログラム、受け取る ▼ を + 自分のメッセージにするプログラムを通さない。メッシュが届いた合図を流すときは「送る」の関数を直接呼ぶので、見張りはスレッドがいま送る + ブロックにいるときだけ「送った」と記録する(下の「VM の見張り方」)。 +- **名前**: 相手に届く名前は ja と ja-Hira で同じ(「シマラビがよんだ」「シマネコがよんだ」「シマラビのスタンプ」「シマネコのスタンプ」。 + リスト「NGワード」もカタカナと英字)。en は `shimaraby_read` / `shimacat_read` / `shimaraby_stamp` / `shimacat_stamp` / `ng_words`。 + ペアでシマネコの役を選ぶと名前と受け持ちを入れかえた形で出る(下の「ペアの役」)。判定は両方の役の名前を通す。音「Meow」とコスチューム + 「shimacat-a」「shimacat-b」はライブラリの Shimacat の名前で、locale によらない(シマネコの役では Shimaraby の「Chirp」「shimaraby-a」「shimaraby-b」)。 +- **始め方**: 5-2 だけ、ステージに「旗でリスト『NGワード』を空にして『ばか』『きらい』(en は "stupid" "idiot")を入れる」プログラムを入れて + 始める(`setup.stageCode`)。リストの「含まれる」は丸ごと一致(大文字小文字は区別しない)なので、「ばかやろう」は止まらない + (「さらに工夫するなら」の題材)。 +- **練習相手**: 5-2・5-4 は 4-1〜4-3 と同じ。5-1 は「発言する」(「明日の持ち物は?」を送る)と「既読にする」(「シマネコがよんだ」を送る)。 + 5-3 は「こんにちは」「元気?」だけで**自動の返事(「とどいたよ」)を持たない**(自動返信どうしが行き来し続けないように。ペアで 2 人とも + 条件が成り立つと同じことが起きるので、ヒントと「うまく動かないときは」に「どちらか 1 人だけ数を小さくする」と書いてある)。5-5 は + 「スタンプを送る」と、「シマラビのスタンプ」を受け取ったら「シマネコのスタンプ」を返す自動の返事、それに 4-1〜4-3 と同じ「とどいたよ」の + 自動の返事(最初から入っている、相手のメッセージを言うシマネコのプログラムが、ひとりでも動くように。図でも送り手のいない受信にならない)。 +- **見分けないもの**: 5-2 で「でなければ」の外で送るプログラムは、ふつうの言葉を送ったあとに NG ワードを入れると、注意の 2 秒のあいだに + 「できた」になる(NG ワードを先に入れれば通らない)。「もし」を 2 つ使う正しい作り方(入っていれば注意・入っていなければ送る)は、 + 「もし〜なら でなければ」を見るので通らない。5-3 は、もしの条件の数(21)は見ないので、数を小さくしたまま(いつも返信する形)でも通る + (ヒントで「確かめたら 21 にもどそう」と書く)。昼は答えのとおりでも返事が出ないので「できた」にならない(数を小さくして試す)。 + 5-1・5-5 で、自分で一度でも相手の名前の合図を送ったあとは、相手から届いても「この作品が送った」とみなす(ずるのあとにやり直したら、 + チャレンジを開き直す)。 +- `challenge-goals-per-locale.test.js` の「通ってはいけない例」: 押して送る名前と受け取る名前が同じ・音を押したときに鳴らす・メッセージが + 届いたときに「既読」と言う(5-1)、「もし」だけで注意して送る・「でなければ」の外で送る(NG ワードが先)・リストを使わず決まった言葉と + 比べる・NG ワードしか入れていない(5-2)、自分のメッセージに返事する・もしの中が空・時を調べずにいつも返事する・昼に 21 のまま(5-3)、 + 確かめずに注意してから始める・合言葉をそのまま送る・ちがう合言葉だけ(5-4)、押して送る名前と受け取る名前が同じ・もどさない・待たずに + 2 回かえる(5-5)。正しい答えは 3 locale と、ペアでシマネコの役の入れかえた形で通ること、5-2・5-4 は NG ワード・合言葉を送って + しまったあと、ヒントどおり直して旗を押し直せば(開き直さずに)通ることを確かめる。 +- **ヒント**: 1 ページ目は課題と図のページで、図の読み方(相手の「送る」は左端がとがった図形、相手から受け取る「受け取ったとき」は右端が + くぼんだ図形、ひし形の枝)をテーマごとに一言そえる。2 ページ目は「メッシュにつなごう」、3 ページ目は「役を決めよう」。5-2〜5-5 の + 4 ページ目は最初から入っている 4-3 のチャット(2 つのスプライトのプログラム)の説明で、1 つの吹き出しに収まらないので**絵は描かずに文で書く**。 + どのテーマも最後のページは旗(4-3 の送る側の絵)。ブロックを「もし〜なら でなければ」で囲むページ(5-2・5-4)は、C の形のブロックを + 途中に入れたときに下のブロックが中に入るかどうかによらないよう、動かしたあとの形で書く。5-3 の「〜を送る」は、▼ の最初の名前が + 受け取る名前(「シマネコのメッセージ」)なので、▼ で自分のメッセージを選ぶよう書く(そのままだと自分の返事を自分で受け取り続ける)。 + 練習相手のパネルを押すページは `practice-partner` を指す。 + +**作品の提出**: このコースのための提出の仕組みは作らない。段 2 の「作品の提出もする」課題で出す([design.md の「作品の提出」](design.md#作品の提出))。 +生徒は最後にやったテーマのプログラムから続けて自分で工夫し、課題クリアのあとに提出する。先生の課題の設定の例: + +| 項目 | 例 | +|------|----| +| 紐付けるレッスン | 「チャットをつくろう」のレッスン 3・4・5(レッスン 1・2 の復習も入れるなら 1〜5) | +| クリアの条件(「n つできたら」) | レッスン 3・4 の 8 つ+テーマ 1 つ = **9 つ**(テーマは生徒が選ぶので、テーマを必須にしない) | +| 作品の提出もする | ON | +| 課題の説明 | ワークシート 7〜8 ページ(設計・計画、制作・デバッグ)を書きながら作ることなど、学校ごとのこと | + +![チャットをつくろう 5-1 の課題の全文と図(1300×600)](screenshots/0721-chat-l5-read-receipt-full-text-1300x600.png) + +![チャットをつくろう 5-2 のヒント 7 ページ目(「もし〜なら でなければ」に入れたできあがり・1300×600)](screenshots/0722-chat-l5-ng-word-hint4-1300x600.png) + +![チャットをつくろう 5-3 のヒント 8 ページ目(練習相手のパネルを指す・1300×600)](screenshots/0723-chat-l5-auto-reply-hint5-partner-1300x600.png) + +![チャットをつくろう 5-3 の「できた!」のクイズ(「かつ」と「または」・1300×600)](screenshots/0724-chat-l5-auto-reply-quiz-1300x600.png) + +![チャットをつくろう 5-5 のヒントの 1 ページ目(図と練習相手のパネル・1300×600)](screenshots/0725-chat-l5-stamp-hint1-1300x600.png) + ## 記録の形(端末) `packages/scratch-gui/src/lib/lessons/lesson-progress.js`。localStorage の **`smalruby:lessonProgress`** に、 @@ -340,22 +687,38 @@ with its partner`)が、文言の言い方(正規表現 `NAMES_A_PARTNER`) | `type` | 見るもの | 項目 | |--------|---------|------| | `uses` | 決めたきっかけ(`trigger`)から始まったスクリプトで、決めたブロックが動いた | `trigger`(省略可), `blocks`(必須), `order` | -| `said` | 言った(考えた)文字 | `text`, `equalsAnswer`, `equalsVariable`, `answer`, `target` | -| `variable` | 変数の値(ステージの変数を先に探す) | `name`, `value` | +| `said` | 言った(考えた)文字 | `text`, `equalsAnswer`, `equalsVariable`, `answer`, `variable`, `target`, `trigger` | +| `variable` | 変数の値(ステージの変数を先に探す) | `name`, `value`, `target`(`'stage'` ならステージの変数 = すべてのスプライト用だけ、`'sprite'` ならスプライトの変数だけ), `fromAnswer: true`(値が「聞いて待つ」に入力した答えのどれか。空は合わない。作っただけの変数(0)や決まった文字を入れた変数を通さない), `includesVariable`(値が、その変数(名前か名前の配列)の空でない値を含む。例: 「なまえ:メッセージ」に「なまえ」を入れた) | | `list` | リストの中身 | `name`, `length`, `itemsFromAnswers` | | `sprites` | スプライトの数(クローンを除く) | `min` | | `costumes` | コスチューム(`target: 'stage'` なら背景)の数が、チャレンジを開いたときより増えた。後から足したスプライトは数えない | `added`(既定 1), `target` | | `extension` | 拡張機能を読み込んだ | `id`(例: `text2speech`) | +| `moved` | スプライトの位置が、チャレンジを開いたとき(見張りを始めたとき)から `min`(既定 1)以上動いた。後から足したスプライトは見ない | `min` | +| `currentCostume` | いまのコスチューム(`target: 'stage'` なら背景)。`number` = 何番め(1 から)、`changed: true` = 開いたときと別のコスチュームになった。始めにいたものだけ見る | `number`, `changed`, `target`(どちらか 1 つは要る) | +| `tab` | いま開いているタブ(エディタの画面の状態。`code` / `costumes` / `sounds`) | `tab` | +| `partQuiz` | 「どこでしょう?」のクイズに `count` 問正しく答えた(エディタの画面の状態) | `count` | + +`tab` と `partQuiz` は VM ではなく**エディタの画面の状態**を見る。見張り(`attachGoalMonitor`)に `getUi`(`{activeTab, partQuizSolved}` を +返す関数)を渡し、`containers/lesson-goal-watcher.jsx` がタブ・クイズの答えが変わったら `refresh()` で判定を予約する。 +`tab` は「タブを開いた」ことを数えるのではなく、ほかの条件(コスチュームを変えた)を満たしたあとに**いまそのタブにいる**ことを見る。 **`uses` の項目** - `trigger`: `{hat, key, message, target, sentBy}`。`hat` はハットの opcode(`event_whenkeypressed` / `event_whenflagclicked` / `event_whenthisspriteclicked` / `event_whenbroadcastreceived` など)。 - `key` はキー(`space` / `up arrow` / `1` ...。「どれかのキー」のスクリプトも合格)、`message` はメッセージ名、 - `target` は `'stage'` / `'sprite'`、`sentBy: 'other'` は「メッセージを別のスプライト(ステージ)が送った」。 + `key` はキー(`space` / `up arrow` / `1` ...。「どれかのキー」のスクリプトも合格)、`message` はメッセージ名 + (名前の配列も書ける。どれか 1 つに合えばよい。ペアで役を入れかえると合図の名前も入れかわるので、両方の役と + 3 つの locale の名前を並べる。例 `['シマネコのメッセージ', 'シマラビのメッセージ', 'しまねこのめっせーじ', …]`)、 + `target` は `'stage'` / `'sprite'`、`sentBy: 'other'` は「メッセージを別のスプライト(ステージ)が送った」、`sentBy: 'remote'` は + 「この作品のスクリプトが送っていない合図(メッシュでほかのノード・練習相手から届いた)」(自分で一度でも送った名前は、あとで届いても + 合わない。メッシュの合図に `'other'` は使えない。`'remote'` はレッスン 5 で使う)。 省くとどのハットから始まったスクリプトでもよい。コードエリアでスクリプトをクリックして動かしたものは 数えない(きっかけが違う)。 -- `blocks`: 動いたブロックの一覧。要素は opcode の文字列か `{opcode, count, args, distinct}`。 + `click` は、ブロックを**押して**動かしたものを数える: `'palette'` = パレットで(置かずに)押した、`'codeArea'` = コードエリアで + 押した、`'any'` = どちらでもよく、ハットから始まった実行も数える。パレットで押したかは、スレッドの先頭のブロックがスプライトの + ブロックに無く `runtime.flyoutBlocks` にあることで分ける(`goal-monitor.js` の `describeThread`)。 +- `blocks`: 動いたブロックの一覧。要素は opcode の文字列か `{opcode, count, args, distinct}`。`opcode` は、どれでもよい opcode の + 配列でもよい(例: `['event_broadcast', 'event_broadcastandwait', 'meshV2_broadcastWithValue']` = どの「送る」で送ってもよい。数は合計する)。 - `count`: **1 回のスクリプトの実行(スレッド 1 本)の中で** その回数以上動いた(例: 背景を 6 回かえた)。 「待つ」「繰り返す」のように待ちながら何度も呼ばれるブロックは、呼ばれた回数になる - `args`: 引数の条件(引数名 → 値の条件。例: `{DY: {gt: 0}}`)。条件に合う実行を数える @@ -363,6 +726,11 @@ with its partner`)が、文言の言い方(正規表現 `NAMES_A_PARTNER`) 2 種類のセリフを言った) - 要素ごとに「きっかけに合うどれかのスクリプトの実行で満たした」を見るので、同じキーのスクリプトが 2 本に 分かれていてもよい +- `not: true`: 「`trigger` に合う**いちばん新しい**スクリプトの実行で、`blocks` のとおりに動いていない」(例: 最後に旗を押した実行で、 + NG ワードを自分のメッセージの変数に入れていない)。前の実行は見ないので、直して旗を押し直せば満たす(チャレンジを開き直さなくてよい)。 + きっかけに合う実行がまだ無ければ満たす。ほかの条件と組み合わせて使う。`uses` 以外の条件には書けない(`validateGoal` が弾く) +- `together: true`: `blocks` が全部、**1 回のスクリプトの実行(スレッド 1 本)の中で**動いた(= くっついている。別々に押して + 動かしたものは合わない)。書いていなければ、要素ごとに別の実行で満たしてよい - `order`: opcode の並び。1 回のスクリプトの実行の中で、それぞれの **最初の実行** がこの順だった (例: `['sensing_resettimer', 'sensing_askandwait']`) @@ -372,10 +740,17 @@ with its partner`)が、文言の言い方(正規表現 `NAMES_A_PARTNER`) **`said` の項目**: `text`(matcher)、`equalsAnswer: true`(最後に「聞いて待つ」で入力した答えと同じ文字を言った)、 `equalsVariable: '<変数名>'`(言った時点のその変数の値と同じ。名前の配列ならどれか 1 つ)、`answer`(言った時点の最後の答えの条件。 -例: `{eq: 7}` / `{ne: 7}`。まだ答えていなければ合わない)、`target`(`'stage'` / `'sprite'`)。 +例: `{eq: 7}` / `{ne: 7}`。まだ答えていなければ合わない)、`variable: {name, value, equalsAnswer}`(言った時点の変数の値の条件。 +`value` は matcher、`equalsAnswer: true` は変数が最後の答えと同じ・`false` はちがう(まだ答えていなければ合わない)。`value` か +`equalsAnswer` のどちらかは要る。 +例: `{name: ['くじ', 'fortune'], value: 1}` =「くじが 1 のときに言った」。分岐で言い分けたことを見るのに使う)、`target`(`'stage'` / `'sprite'`)、 +`trigger`(言ったスクリプトのきっかけ。形は `uses` の `trigger` と同じ。例: `{hat: 'event_whenbroadcastreceived', sentBy: 'other'}` = +「ほかのスプライトから受け取ったスクリプトで言った」。言ったスクリプトは、吹き出しを出す直前にブロックを動かしたスクリプト +(同じスプライトのもの)。分からないときは合わない)。`remoteValue: true`(言った文字が、言ったときにメッシュで**自分以外のノード**(練習相手を含む)から届いていた +変数の値のどれかと同じ。自分の変数の「センサーの値」を読んだだけでは合わない)。 吹き出しを消す(空の文字)は記録しない。 -**変数・リストの名前**(`variable` / `list` の `name`、`said` の `equalsVariable`)は、文字列か名前の配列 +**変数・リストの名前**(`variable` / `list` の `name`、`said` の `equalsVariable` と `variable.name`)は、文字列か名前の配列 (見つかった変数のどれか 1 つが合えばよい)。ja-Hira のヒントは変数名をひらがなで書き(「かいすう」)、en は英語で 書く(`count`)ので、`['回数', 'かいすう', 'count']` のように全部を書く。言う文字も同じで、ja-Hira の課題がひらがなで書く文字は RegExp で両方を許す(例: `/^(正解です|せいかいです|correct)$/i`。en の `code` が言う文字も許す)。 @@ -477,6 +852,12 @@ scratch-vm には「ブロックが動いた」を知らせるイベントが無 `blocks.resetCache()` を呼んで、包む前に取られた関数を作り直させる。一度包んだら runtime の間は包んだまま (listener が無いときは元の関数を呼ぶだけ)。 - primitive の中から別の primitive を呼ぶもの(mesh v2 の broadcast など)は外側だけ記録する。 +- メッシュの拡張は、ほかのノードから届いた合図を、つないだときに取った「送る」の関数(=見張りの包み)を直接呼んで流す + (`broadcast-receiver.js`)。そのときの `util` は最後に使われたもので、スレッドは「送る」を動かしていない。そこで「送る」の + ブロック(`event_broadcast` / `event_broadcastandwait` / `meshV2_broadcastWithValue`)は、スレッドがいまその送るブロックに + いて(`thread.peekStack()` のブロックが送るブロック)、そのブロックのメッセージ(▼ の影ブロックの `BROADCAST_OPTION`)が送る名前と + 同じときだけ記録する(「送って待つ」で別のメッセージに止まっているスレッドにも数えない。レポーターを入れた「送る」は名前を比べない)。届いた合図が、たまたま最後に動いたスクリプトの + 「送った」に数えられない(`sentBy: 'remote'` が本物のメッシュでも合う)。 - 判定は、何か記録があったあとの次の step(runtime の `BEFORE_STEP`)で 1 回だけ行う(1 step に何度も判定しない)。 スプライト・コスチューム・拡張機能の変化は `PROJECT_CHANGED` / `targetWasCreated` / `EXTENSION_ADDED` で判定を 予約する。 @@ -501,6 +882,12 @@ scratch-vm には「ブロックが動いた」を知らせるイベントが無 | `lesson-completed-toast-next` | button | 「次のチャレンジへ」/「次のレッスンへ」/「レッスン表へ」。`data-action` が `next` / `otherLessons` / `library`(`COMPLETED_ACTIONS`) | | `lesson-completed-toast-close` | button | 「もう少し見る」(閉じるだけ) | | `lesson-completed-toast-submit` | button | 「課題を提出する」(クラスの課題がはじめて課題クリアになり、作品も提出する課題のときだけ。主ボタン) | +| `lesson-quiz` | div | ふりかえりのクイズ(チャレンジに `quiz` があるときだけ)。`lesson-completed-toast` の `data-has-quiz` が `true` / `false` | +| `lesson-quiz-label` | div | 「ふりかえりクイズ」 | +| `lesson-quiz-question` | div | 問い | +| `lesson-quiz-choice` | button | 選択肢 1 つ(3 つ並ぶ・`role="radio"`)。`data-index` = 何番目か(0 から)、`aria-checked` = 選んでいるか、`data-result` = 選んでいるものだけ `correct` / `wrong` | +| `lesson-quiz-result` | div | 「2: 正解!」/「3: はずれ。もう一度選んでみよう」(選んだあとだけ。前に選んだ番号)。`data-correct` が `true` / `false` | +| `lesson-quiz-explanation` | div | 解説(選んだあとだけ。正解でもはずれでも出す) | クラスの課題に参加しているとき、その課題の条件をはじめて満たしたチャレンジでは、`lesson-completed-toast` の `data-assignment-cleared="true"` で、タイトルが「課題クリア!」、丸が課題のチャレンジ(★ は必須)になる @@ -541,6 +928,40 @@ scratch-vm には「ブロックが動いた」を知らせるイベントが無 ![最後のレッスンのチャレンジが全部できたときの「できた!」(1300×600)](screenshots/0102-completed-toast-last-1300x600.png) +#### ふりかえりのクイズ + +チャレンジの定義に `quiz` があれば、「できた!」の表示の中(丸の行とボタンのあいだ)に **3 択のクイズ**を出す +(`components/lesson-completed-toast/lesson-completed-quiz.jsx`。方針は `design.md` の「ふりかえりのクイズ」)。 +`quiz` の無いチャレンジは、これまでどおりクイズを出さない。 + +- 3 つの場面(`next` / `otherLessons` / `library`)でも「課題クリア!」でも同じように出す。 +- 選ぶと、選んだ選択肢に ○(正解)/×(はずれ)を付け、「正解!」/「はずれ。もう一度選んでみよう」と解説を出す。 + **何度でも選び直せる**(正解のあとも)。選択肢の並びは定義のまま(混ぜない)。 +- 選んだものは記録しない(「できた」の判定にも記録にも入れない)。答えなくても「次のチャレンジへ」などで先へ進める。 + 別のチャレンジの「できた!」では選んだものを消す(`key` = チャレンジ id)。 +- **見られるのは「できた!」が出ているあいだだけ**。「もう少し見る」で閉じたら、そのチャレンジではクイズをもう出さない + (もう一度「できた」にすれば出る)。閉じるまでに生徒はクイズを見ている。 +- **課題バーの全文をタップで開いても閉じない**。全文を開いているあいだだけ隠し(`lessonMode.completedHidden`。 + reducer の `hideCompleted` / `showCompleted`)、全文を閉じたら出し直す。toast は描いたまま `hidden` にするので、 + 選んだ答えは残る。隠しているあいだは、課題バーから見て toast は出ていない扱い(`toastVisible` が false)。 + 閉じる・チャレンジを開き直す・もう一度「できた」になると、隠したのは解ける。クイズの無い「できた!」は、全文を + 開くとこれまでどおり閉じる。 +- 読み上げ: クイズは `role="radiogroup"`(問いを `aria-labelledby`)、選択肢は `role="radio"` + `aria-checked`。 + 結果の文の前に選んだ番号を付ける(「3: はずれ。もう一度選んでみよう」)ので、はずれを続けて選んでも字が変わって + 読み上げられる。live region は toast の `role="status"` だけ(クイズの中には置かない)。 +- 文言は、クイズの部品の言葉(`gui.lessons.completed.quizLabel` / `quizCorrect` / `quizWrong`)と、チャレンジごとの + 問い・選択肢・解説(上の「チャレンジ」の message id)。どれも en / ja / ja-Hira にそろえる(ja-Hira は漢字なし)。 +- クイズがあるときは toast の幅を 560px に決める(選んで解説が出ても横幅が変わらない)。**文言の長さの目安**は + 問い 2 行・選択肢 1 行・解説 3 行(ja で問い 50 字・選択肢 20 字・解説 75 字くらいまで)。この長さで 1300×600 の + 画面に収まる(解説まで出して toast の下の端が 560px くらい)。目安を超えたときだけ、画面の外に出さずに toast の + 中をスクロールする(保険)。 + +![クイズのある「できた!」(選ぶ前・1300×600)](screenshots/0104-completed-toast-quiz-1300x600.png) + +![はずれを選んだところ(解説が出る・選び直せる・1300×600)](screenshots/0105-completed-toast-quiz-wrong-1300x600.png) + +![「レッスン 1 ぜんぶできた!」の中で正解を選んだところ(1300×600)](screenshots/0106-completed-toast-quiz-lesson-correct-1300x600.png) + デバッグ・テスト用に `window.smalruby.lessonGoal` を出している(integration テスト `test/integration/lesson-goal.test.js` と pw-check が使う。レッスン表・レッスンモードの UI ができるまでの入口): @@ -551,6 +972,218 @@ scratch-vm には「ブロックが動いた」を知らせるイベントが無 | `openChallenge(id)` / `closeLesson()` | チャレンジを開く / レッスンモードを抜ける(Redux の action) | | `markCompleted(id)` | 「できた」にする(記録 + 「できた!」) | +## メッシュの練習相手 + +> 方針は [design.md の「メッシュの練習相手」](design.md#メッシュの練習相手)。ここは定義の形と動き方。 + +メッシュのチャレンジをひとりでもできるように、チャレンジの `partner` に相手を**データだけ**で書く。チャレンジごとに +コードは書かない。 + +```js +partner: { + name: 'ロボ', + buttons: [ + // パネルのボタン。押すと set → broadcast の順に起きる + { label: 'あいさつする', set: { variable: 'へんじ', value: 'こんにちは' }, broadcast: 'へんじ' }, + ], + replies: [ + // 自動の返事。生徒の作品が onBroadcast の合図を送ったら、少しあと(0.5 秒)に set → broadcast + { onBroadcast: 'メッセージ', set: [{ variable: 'へんじ', value: 'やあ' }], broadcast: 'へんじ' }, + ], + // 任意。パネルの「届いた」に出す生徒の変数(相手が使わない変数でも出す。例: 3-3 の自分の気分) + watch: ['気分'], +} +``` + +- `set` は共有する変数を変える `{ variable, value }`(複数なら配列)。`value` は文字列・数・locale ごとの文字列 + `{ja, 'ja-Hira', en}`(例: 3-3 の気分「うれしい」/ "happy")のほかに、`{ fromVariable: '名前' }` と書ける(押したとき・返事のときの**生徒の作品の変数の値**。ステージの変数を先に、 + 無ければスプライトの変数を探し、どちらにも無ければ空文字。名前は文字列か `{ja, 'ja-Hira', en}`。例: DM の + 「あなたに DM」で、生徒が入力した名前をあて先にする `{ variable: 'あて先', value: { fromVariable: '名前' } }`)。 + `orVariables`(配列か locale ごとの配列)で同じ意味のほかの名前を書くと、`fromVariable` が無いときに順に探す。 + `required: true` にすると、その値がまだ入っていない(変数が無い・空・作ったときのまま数の 0)ときは押しても何もせず、 + パネルのボタンの下に「「なまえ」がまだ空。先に旗を押して入れよう。」と出す(`data-testid="lesson-practice-partner-missing"`)。 + 空のあて先で送ると、押しても何も起きないように見えるため。 + アクティビティ図では「あて先を(名前の値)にする」と描く。 +- `watch`(任意)は、パネルの「届いた」の行に出す**生徒の共有する変数**の名前の配列(文字列か `{ja, 'ja-Hira', en}`)。 + 行に出す変数はふつう相手が使う名前だけなので、相手が読まない変数を見せたいときに書く(例: 3-3 は + `watch: ['シマラビの気分']`。1・2 のキーで変えた自分の気分が、ひとりのときもパネルに出る)。書かなければ今までどおり。 + ボタン・返事が無い定義は `watch` があっても練習相手にならない。図には描かない。`broadcast` / `onBroadcast` は合図の名前 + (大文字小文字は区別しない)。`name` / `label` / `variable` / `broadcast` / `onBroadcast` は、作品の中の名前が + locale で変わるときは `code` と同じく `{ja, 'ja-Hira', en}` でも書ける。 +- アクティビティ図(相手のスイムレーン)も同じ定義から、動かすときと同じ読み方(`normalizePartner`。locale ごとの書き方の選び方も同じ)で描く。動かすときに使わない行(ラベルの無いボタン・名前の無い変数や `fromVariable`・何もしない返事)は図にも描かない。 + +### 動き方(ブラウザの中で折り返す・scratch-vm は変えない) + +`lib/lessons/practice-loopback.js` が、メッシュの練習相手の共通の部品(`lib/mesh-practice/loopback.js`。ひとりで使える練習相手と同じもの)に +`owner: 'lesson'` でつなぎ、メッシュの拡張の受け取り口に相手の分を入れる。サーバーには何も出さない。レッスンの側に残るのは、 +定義を読む `normalizePartner`(locale ごとの文字列を選ぶ)と、相手に届いたものをパネルに出す(`onReceived`)ことだけ。 + +- 1 つの作品(runtime)につなげる練習相手は 1 つだけ。レッスンの練習相手がつないでいるあいだ、ひとりで使える練習相手は休む。 + ひとりで使える練習相手がまだつないでいたときは、それが外れてからつなぐ。 +- 送った・受け取ったものは、メッシュの「状態と履歴」のウィンドウの履歴にも出る(相手は「相手(練習相手)」)。外すと消える。 + +| 向き | 本物のメッシュ | 練習相手 | +|---|---|---| +| 相手の変数 → 生徒 | ほかのノードの値を `meshService.remoteData[ノード]` に入れ、「〜のセンサー値」が読む | 同じ置き場の `remoteData['smalruby-mesh-practice-partner']` に入れる | +| 相手の合図 → 生徒 | 「〜を受け取ったとき」のハットを動かす(作品にその合図が無ければ何もしない) | 同じ(`runtime.startHats`) | +| 生徒の合図 → 相手 | サーバーへ送る | 「〜を送る」「〜を送って待つ」が動いたのを `vm-execution-hook.js` で見て、自動の返事を返す | +| 生徒の変数 | 自分のノードの値として `remoteData[自分]` にも入れる(自分の変数の「〜のセンサー値」も読める) | 同じ(ブロックで変えたときに入れる) | + +- 「できた」の判定(`goal`)は変えない。相手の合図で動いたスクリプトは、本物のメッシュで受け取ったときと同じ事実 + (「〜を受け取ったとき」から始まった)として数える。どちらも届いた合図の送り手は記録しないので、メッシュの合図を + 受け取るスクリプトの条件に `sentBy` を使わない(design.md の「メッシュの練習相手」)。 +- 自動の返事は、同じ合図の返事が待っているあいだは新しく積まない(本物のメッシュの `fireEvent` が、まだ送っていない + 同じ合図をまとめるのと同じ)。「ずっと『メッセージ』を送る」でも、返事は 0.5 秒ごとに 1 回まで。待っている返事は + 合図の名前ごとに 1 つで、全部で 100 まで(本物のメッシュの送るキューの上限と同じ)。 +- **本物のメッシュでつながっている・つなごうとしているあいだは何もしない**(`practiceAllowed`)。つながるとパネルを + 閉じ、切れたら小さな「練習相手」のボタンを出す(自分で開き直す)。 + - メッシュの拡張は「つないでいる途中」になったことを知らせないので、折り返しは毎フレームの最初(`BEFORE_STEP`。 + スクリプトが動く前)に接続のようすを見て、つなぎ始めていたら入れた値をその場で消す。そのあとに押されたボタン・ + 発火した返事のタイマーは何もしない。 +- パネルを閉じる・チャレンジを変える・レッスンを出ると、折り返しを外し、入れた値を `remoteData` から消す + (あとから本物のメッシュが入れた値は消さない)。自分の変数の値は、書いたときのノード ID から消す(つながっていない + あいだにも出席番号で `meshId` が変わるため)。 +- **パネルは枠と見出しで 2 つに分ける**: 「〈相手の名前〉から送る」(相手のボタン。2 つまでなら横に並べて 1 段)と + 「〈相手の名前〉に届いた」(生徒の作品から相手に届いたもの)。見出しの名前はチャレンジの `partner.name` で、シマネコの役を + 選ぶと入れかわる(「シマラビから送る」「シマラビに届いた」)。ヒントでは「練習相手のパネルの『シマネコに届いた』」と書く + (シマネコの役では自動の入れかえで「シマラビに届いた」になる)。 +- **「〈相手の名前〉に届いた」**: 生徒の作品から相手に届いたものを、**新しいものを上に 3 行**出す(古い行は薄く)。 + ひとりのときに、送るだけの段や自動返信の段で届いたことが見えるようにするため。 + - 1 行は、**変数なら値を大きく、その下に変数の名前を小さく**(「へいへい!」の下に「← シマラビのメッセージ」)。 + **合図なら合図の名前だけ**。ただし同じ名前の共有する変数があればその値と名前(このコースは変数と合図に同じ名前を使う。 + 名前はまず大文字小文字まで一致する変数、無いときだけ区別なしで探す)。値は文字として出し(HTML にしない)、 + はみ出しは省略して全文は行の title(「名前 = 値」)で見る。 + - **同じものが続けて届いても 1 行ずつ足す**(同じ見た目のままだと、届いたかどうかが分からないため)。変数は値が + 変わったときだけ行にする(同じ値を入れ直しても相手には何も新しく届かない。ずっと同じ値を入れるスクリプトで行が + 増え続けないように)。 + - **新しい行は 1 秒ほど光らせる**(縁の色。`prefers-reduced-motion: reduce` では光らせない)。 + - 行になる変数は、**その練習相手が使う名前**(`set` の変数・`fromVariable`・相手が受け取る / 送る合図と + 同じ名前の変数)と `watch` の名前だけ(`partnerNames`)。ずっと得点を変えるような、相手に関係の無い変数では増えない。 + - 知らせるのはフレームの最初(`BEFORE_STEP`)にまとめて 1 回まで。同じフレームの中で変数を入れて合図を送ると 1 行。 + - 読み上げ(`aria-live="polite"`)は**合図が届いたときだけ**(画面には出さない読み上げ用の要素 + `lesson-practice-partner-announcement`。「シマネコに届いた: シマラビのメッセージ = へいへい!」。変数が変わるたびには + 読み上げない。同じ合図が続けて届いたときも読み上げ直す)。 + - パネルの幅(11rem)は変えない。「届いた」の枠は**3 行ぶんの高さで固定**(まだ何も届いていないときは + 「(まだ何も届いていない)」を出す)し、届いてもパネルの高さは動かない。 + - 1300×600 で、パネルは 176×269px(コードエリアの右上、ステージの列の左。ボタンが 2 つの段)。コードエリアの右下の + スクリーンショットのボタンに少しかかるが、拡大・縮小のボタンにはかからない。fixed で重ねるだけなので、パネルが + あってもなくても、コードエリアとステージの列の位置・大きさは変わらない。667×375 でも画面の高さに収まる。 + - 相手のボタン・返事(相手から生徒へ)は行にしない。チャレンジを変えると消える。同じ練習相手を使うチャレンジ + (4-1〜4-3)に移ったときも、折り返しをチャレンジごとにつなぎ直し、前のチャレンジで届いたもの・覚えた値を持ち越さない。 + 定義(`partner`)の項目は増やさない。 + +![チャットをつくろう 4-1 の練習相手のパネル: 「シマネコから送る」と「シマネコに届いた」(同じメッセージが 2 回届き、新しい行が光っている・1300×600)](screenshots/0601-practice-partner-1300x600.png) + +![チャットをつくろう 4-1 の練習相手のパネル(667×375)](screenshots/0731-chat-l4-send-once-partner-received-667x375.png) + +- × で閉じると「練習相手」のボタンへ、開き直すと最初のボタンへフォーカスを移す(チャレンジを開いたときは動かさない)。 +- チャレンジを開くとパネルは開いた状態で出る(本物のメッシュでつながっていれば出さない)。 +- 置き場所はコードエリアの右上(ステージの列のすぐ左。`stage_stage-wrapper_` の位置から測り、window の resize と + ステージの列の大きさの変化で測り直す)。ステージの列は動かさない。 + +### data-testid(練習相手) + +| data-testid | 要素 | 説明 | +|------------|------|------| +| `lesson-practice-partner` | section | 練習相手のパネル(開いているときだけある) | +| `lesson-practice-partner-name` | span | 「練習相手: 名前」 | +| `lesson-practice-partner-send` | div | 「〈相手〉から送る」の見出しと枠(`role="group"`) | +| `lesson-practice-partner-button` | button | 相手のボタン(`data-index` = 定義の何番目か) | +| `lesson-practice-partner-missing` | p | 押したのに、相手が使う生徒の変数(`required`)がまだ空で何もしなかったときの短い文(`role="status"`) | +| `lesson-practice-partner-received-group` | div | 「〈相手〉に届いた」の見出しと枠(`role="group"`) | +| `lesson-practice-partner-received` | ol | 届いたものの枠(3 行ぶんの高さで固定。何も無いときは「(まだ何も届いていない)」) | +| `lesson-practice-partner-received-item` | li | 届いた 1 行(新しいものが先)。`data-kind`(`message` / `variable`)・`data-old`(2 行め以降)・`data-flash`(届いて 1 秒ほど)。全文は title | +| `lesson-practice-partner-received-value` | span | 行の大きい文字(変数の値か、合図の名前) | +| `lesson-practice-partner-received-name` | span | 行の小さい文字「← 変数の名前」(値のある行だけ) | +| `lesson-practice-partner-announcement` | span | 読み上げ用(画面には出さない・`aria-live="polite"`)。合図が届いたときだけ変わる | +| `lesson-practice-partner-note` | p | 「ペアでやるときは、閉じて本物のメッシュでつなごう。」 | +| `lesson-practice-partner-close` | button | パネルを閉じる(本物のメッシュに切りかえる) | +| `lesson-practice-partner-open` | button | 閉じたあとの小さな「練習相手」ボタン(押すとパネルをもう一度出す) | + +### スクリーンショット(練習相手) + +0601 と 0731 は「チャットをつくろう」の 4-1 で、生徒の作品が「シマラビのメッセージ」を「やあ」「へいへい!」「へいへい!」の順に送ったところ。0602 は、コースに練習相手のあるチャレンジがまだ無かったときに、チャレンジ 9 に仮の `partner`(と `setup`)を一時的に足して撮った。 + +| ファイル | 説明 | +|---------|------| +| `screenshots/0601-practice-partner-1300x600.png` | 1300×600 で、「シマネコから送る」と「シマネコに届いた」の 2 つの枠。届いたものは新しいものを上に 3 行(古い行は薄い)、同じメッセージが 2 回続けて届いて 2 行になり、新しい行が光っている。値(「へいへい!」)が大きく、変数の名前(「← シマラビのメッセージ」)が小さい | +| `screenshots/0731-chat-l4-send-once-partner-received-667x375.png` | 667×375(SP の横向き)で同じところ。パネルは画面の高さに収まる | +| `screenshots/0602-practice-partner-closed-1300x600.png` | パネルを閉じたところ(小さな「練習相手」のボタンだけ残る) | + +## ペアの役(シマラビの役 / シマネコの役) + +> 方針は [design.md の「ペアの役」](design.md#ペアの役)。ここはしくみ。 + +「チャットをつくろう」のペアでやるチャレンジは、2 人が**同じ形のプログラムを、名前を入れかえて**作る(シマラビの役は +「シマラビのメッセージ」を送って「シマネコのメッセージ」を受け取る。シマネコの役はその逆)。役を選ぶと、画面がその役の +名前で出る(**鏡の形**)。生徒が頭の中で名前を入れかえなくてよい。 + +- **役のあるチャレンジ**: チャレンジの `roles: true`。3-3・4-1〜4-3・5-1〜5-5。みんな同じ名前を使う段(3-2・4-4・4-5)と、 + 同じコンピューターの中の段(レッスン 1〜3-1)は付けない(入れかえない)。 +- **入れかえるもの**(`lib/lessons/role-swap.js` の `swapChallengeRoles` / `challengeForRole`): 課題・ヒントの文・ + うまく動かないときは・ヒントのブロックの絵・「プログラムを入れる」(`code` / `spriteCodes`)・最初から入っている + プログラム(`setup`)・練習相手(`partner`)・パレットの絞り込みの値。語は シマラビ ↔ シマネコ(ja / ja-Hira)、 + Shimaraby ↔ Shimacat、`shimaraby` ↔ `shimacat`(変数・メッセージ・コスチュームの名前)、Chirp ↔ Meow(スプライトの音。 + シマラビは Chirp だけを持つ)。ミミなどほかの名前は変えない。2 回入れかえると元にもどる。 +- **入れかえないもの**: id・チャレンジの名前(レッスン表)・カード・**判定(`goal`)**・クイズ。判定は両方の役の名前を + もう通すので、シマネコの役の答えもそのまま「できた」になる(`challenge-goals-per-locale.test.js` が、役のある + チャレンジを入れかえた答えで動かして確かめる)。 +- **文言**: message descriptor は入れかえた文字を持てないので、入れかえたチャレンジの文言には `roleSwapped: true` の + 印を付け、出すときに `formatRoleMessage(intl, descriptor)` が文字にしてから入れかえる(課題バー・ヒントの吹き出し)。 + 自動の入れかえで不自然になる文は、`.asShimacat` の文言を足せばそれを使う(いまは無い)。 +- **`getCurrentChallenge`** がいまの役で入れかえたチャレンジを返す(同じ役なら同じ参照)。ヒント・「プログラムを入れる」・ + 練習相手・アクティビティ図は、この値を読むだけで鏡の形になる。 +- **役の決め方**(`lib/lessons/lesson-role.js` の `resolveChallengeRole`。チャレンジを始める前に決める。最初から入る + プログラムも役で入れかわるため): + 1. 役を選びなおして始めなおすときは、その役。 + 2. クラスで**出席番号のペア**(2 人のグループ)につながっていれば、**出席番号の小さい人がシマラビの役**。同じペアで + 前に選んだ役を覚えていれば、そちら(ペアで入れかえた役を、次のチャレンジで戻さない)。ペアの出席番号は、 + つながっているグループの名前(「出席番号でつながる」の `seats=` と `host=`)から読む(`connectedGroupSeats`)。 + 3 人以上のグループでは決めない。 + 3. それ以外は**前回選んだ役**(`smalruby:lessonRole`)。 + 4. 何も無ければ**シマラビの役**(ひとりは選ばなくてよい)。 + 覚えている役といまのつながりだけで決まるので、**チャレンジをどの順にやっても同じ**(3-2 を先にやった、のような前提を + 置かない)。端末に覚えるのは**生徒が自分で選んだ役だけ**(既定のシマラビの役・出席番号で決まった役は覚えない。一度も + 選んでいない生徒に「前回は…」を出さない)。前回の役を読むのはチャレンジを開くとき、書くのは役を選んだときで、どちらも + コンテナ(`containers/lesson-mode.jsx`)がする(reducer は端末に触らない)。 +- **課題バーの役のボタン**: 「シマラビの役」「シマネコの役」(いまの役が白地)。ボタンの下に、役をどう決めたかを小さく出す + (前回の役 → 「前回はシマネコの役」、出席番号 → 「出席番号で決めた役」。自分で選んだら出さない)。横に並べると、768px や + SP(844×390)で課題の 1 行がほとんど見えなくなるため、ボタンの下に置いてバーの高さ(40px)に収める。 +- **役を変えたとき**: 役のあるチャレンジはすべて、その役でチャレンジを始めなおす(`roleChangeRestarts`。作品に変更が + あれば、置きかえの確認が出る。メッシュはつながったまま。ヒントのページはそのまま)。最初から入っているプログラムの + 名前が役で変わるうえ、先に作った変数の名前と、入れかわった練習相手の変数の名前がぶつかるのを防ぐため。 +- **途中で出席番号のペアにつながったら**: まだこのチャレンジで役を選んでいなければ、開くときと同じ決め方 + (`resolveChallengeRole`)で決めなおす。同じペアで前に選んだ役を覚えていれば、出席番号の役で上書きしない。役が変わる + ときは始めなおすので、作品をもう変えていたら決めなおさない(作ったものを消さない。ボタンで変えられる)。役が同じで + 決め方だけ変わるとき(出席番号でも同じ役)は、始めなおさずに「出席番号で決めた役」にする。 +- **アクティビティ図**: 役のあるチャレンジの見出しは「あなた(シマラビの役)」「相手(シマネコの役)」。シマネコの役では + 左のレーンが入れかえた答え、右のレーンが入れかえた練習相手になる。相手のレーンの絵は、ひとりのときもペアのときも + 練習相手のボタンの形のまま(ペアの途中で絵が変わらないように)。ペアの相手の人間が作るものは、相手の画面の + 「あなた」のレーンと同じ形(名前ちがい)になる。図の変換結果は役ごとに覚える。 +- **役を決めよう(ヒントのページ)**: 役のあるチャレンジ(3-3・4-1〜4-3・5-1〜5-5)は、メッシュにつなぐページのすぐ次に + 「役を決めよう」のページを置く(`roleStep`・`kind: 'role'`。3-3・4-2・4-3・5-1〜5-5 は 3 ページ目、4-1 はつなぎ方の手順の次の + 5 ページ目)。「役を決める」がどの操作かわかるよう、つなぐページの文には書かず独立させ、吹き出しのしっぽで**課題バーの + 役のボタン**を指す(`target: 'role-picker'` → `lesson-task-bar-role-buttons`。課題バーは吹き出しより上に描かれ、吹き出しは + バーの下から置くので、下に置いてしっぽを上に向ける。置く側は下だけ — 画面の上にあるので、下ならパネルをよけたあとも役のボタンの真ん中が + 吹き出しの辺の中に入り、しっぽが出る)。1300×600 では役のボタンが練習相手のパネルの真上にあるので、 + このページだけはパネルにかぶってもボタンの真下に置く(`coverAvoid`。パネルをよけるとしっぽがボタンに届かない)。 + 文はどのチャレンジでも同じ共通の文言(`gui.lessons.chat.role`。ペアなら 2 人で決めて役のボタンで選ぶ、ひとりなら + もうシマラビの役なのでそのまま次へ)。シマネコの役でも名前を入れかえない(`.asShimacat` に同じ文)。 + このチャレンジで役を選ぶと(始めなおしてもヒントのページはそのまま)、文の下に「『シマネコの役』を選んだよ。次へ進もう。」を + 出す(`lesson-role.js` の `roleStepNote`)。選ばなくても次へ進める。 + +![チャットをつくろう 4-2 の「役を決めよう」のページ。しっぽが課題バーの役のボタンを指す(1300×600)](screenshots/0730-chat-role-page-l4-2-1300x600.png) + +![同じページでシマネコの役を選んだところ(「『シマネコの役』を選んだよ。次へ進もう。」・1300×600)](screenshots/0734-chat-role-page-chosen-l4-2-1300x600.png) + +![SP(844×390)の「役を決めよう」のページ](screenshots/0732-chat-role-page-l4-2-844x390.png) + +![幅の広い画面(1440×900)の「役を決めよう」のページ(しっぽが役のボタンを指す)](screenshots/0733-chat-role-page-l4-2-1440x900.png) + +![チャットをつくろう 3-3 を前回シマネコの役で開いたところ(課題バーに「前回はシマネコの役」と役のボタン、ヒントと練習相手がシマネコの役の名前・1300×600)](screenshots/0728-chat-role-l3-shimacat-hint3-1300x600.png) + +![チャットをつくろう 3-3 のシマネコの役のヒントの 1 ページ目(図の見出し「あなた(シマネコの役)」・1300×600)](screenshots/0729-chat-role-l3-shimacat-hint1-diagram-1300x600.png) + ## 状態(Redux) `packages/scratch-gui/src/reducers/lesson-mode.js`(`state.scratchGui.lessonMode`)。 @@ -559,21 +1192,27 @@ scratch-vm には「ブロックが動いた」を知らせるイベントが無 |------|------| | `courseId` / `lessonId` / `challengeId` | いま開いているチャレンジ。`challengeId` が null ならレッスンモードではない | | `pendingChallengeId` | 開こうとしているチャレンジ(新しい作品ができるまでの間だけ入る。下の「レッスンモード」) | -| `hintVisible` / `hintIndex` | ヒントの吹き出しを出しているか・何番めのヒントか(チャレンジを開く・閉じるたびに最初にもどる。開いたときはヒントがあれば出す) | +| `hintVisible` / `hintIndex` | ヒントの吹き出しを出しているか・何番めのヒントか(チャレンジを開く・閉じるたびに最初にもどる。開いたときは、ヒントがあれば出す) | +| `hintMinimized` | ヒントを小さくして札だけを残しているか(`hideHint` で true、`showHint`・`finishHint`・できた・チャレンジを開く・閉じるで false) | | `hintSession` | チャレンジを開いた回数(`openChallenge` のたびに増える。同じチャレンジを開き直しても増える)。吹き出しの `key` にして、開き直したらドラッグした位置・確認・入れられなかったわけを持ち越さない(吹き出しは開いたまま次のチャレンジに移ることがあり、そのときは作り直されないため) | | `hintSpotlight` | はじめて開いたチャレンジか(`spotlight` のヒントで周りを暗くする)。`openChallenge` で `smalruby:lessonSpotlightSeen` を見て決め、同時に「見た」と記録する | | `progress` | 記録の写し(起動時に localStorage から読む) | | `justCompletedId` | 「できた!」を出しているチャレンジ id(null なら出していない) | | `libraryFocusChallengeId` | レッスン表を開いたときに見せるチャレンジ(「次のチャレンジ」で開いたとき)。レッスン表はこれから見せるレッスンと次のチャレンジを決める(`lessonsLibraryFocus`)。レッスンを閉じても消さず、レッスン表が閉じるときに消す | +| `role` / `roleSource` / `rolePair` | いまのチャレンジの役(`shimaraby` / `shimacat`。役のあるチャレンジだけ)・どう決めたか(`default` / `remembered` / `seat` / `chosen`)・出席番号のペアの印(`'3-7'`)。上の「ペアの役」 | +| `pendingRole` / `pendingRoleSource` | 役を選びなおして始めなおすときの役(開くまでの間だけ入る) | | `libraryStartFocus` | レッスン表を、ウェルカムの「レッスンを始める」で開いたか。レッスン表は記録から次にやるチャレンジを決める(`startLessonsFocus`)。レッスン表が閉じるときに消す | | action / selector | 説明 | |------|------| | `startChallenge(challengeId)` | **チャレンジを開く入口**(レッスン表が呼ぶ)。新しい作品 → setup → `openChallenge` の順にコンテナが進める(知らない id は無視)。日本語モードのときは、作品の置きかえが決まってから、ふりがなモードに戻す(日本語モードのパレットの絞り込みとチャレンジの絞り込みが重なってブロックが出なくなるため。置きかえを断ったときは変えない) | +| `startChallenge(challengeId, {role, roleSource})` | 役を選びなおして始めなおす(その役で始める。ヒントのページは保つ) | +| `setLessonRole(role, {roleSource, rolePair})` | いまのチャレンジの役・決め方を変える(始めなおさない変更。役の無いチャレンジでは何もしない)。端末には書かない(選んだ役を覚えるのはコンテナ) | +| `getCurrentRole(state)` | `{role, source}`(役の無いチャレンジでは null) | | `cancelStartChallenge()` | 開こうとしていたチャレンジを取り消す(「保存しますか」で取りやめたとき) | | `openChallenge(challengeId)` | レッスンモードに入る(作品の準備は済んでいる前提。知らない id は無視)。「できた!」は消す | | `closeLesson()` | レッスンモードを抜ける(記録は残す) | -| `showHint()` / `hideHint()` / `nextHint()` / `prevHint()` | ヒントの吹き出しの出し入れと「進める・もどる」(ヒントが無いチャレンジでは出ない。両端で止まる)。`hideHint` はページを保つ | +| `showHint()` / `hideHint()` / `nextHint()` / `prevHint()` | ヒントの吹き出しの出し入れと「進める・もどる」(ヒントが無いチャレンジでは出ない。両端で止まる)。`hideHint` は閉じずに小さくする(札が残る・ページを保つ) | | `finishHint()` | 「おわり」で閉じる(次に開くときは 1 ページ目から) | | `markChallengeCompleted(challengeId, completedAt?)` | 「できた」にして localStorage にも書く。書く前に localStorage の最新と合わせる(別のタブが書いた分を消さない)。`justCompletedId` をそのチャレンジにする(すでにできていても)。いま開いているチャレンジなら、ヒントの吹き出しを閉じる(ページは保つ) | | `dismissCompleted()` | 「できた!」を閉じる | @@ -624,7 +1263,7 @@ scratch-vm には「ブロックが動いた」を知らせるイベントが無 | チャレンジ | 数 | 色 | |---|---|---| - | key-sound | サウンド 2・イベント 1 | サウンド | + | key-sound | サウンド 1・イベント 1(同数) | サウンド(メイン) | | arrow-move | 動き 2・イベント 2(同数) | 動き(メイン) | | click-say | 見た目 2・イベント 1 | 見た目 | | repeat | 制御 3・見た目 2・イベント 1 | 制御 | @@ -641,6 +1280,19 @@ scratch-vm には「ブロックが動いた」を知らせるイベントが無 区別しない(`normalizeQuery`)。合うチャレンジだけ出し、合うものが無いレッスン・コースは隠す。コースの バーと「n / m」は絞り込みで変えない。1 つも無いときは「『○○』に合うチャレンジはありません」。 判定は `lib/lessons/library-filter.js` の `filterCourseStatuses`(純粋関数)。 +- **たたみ方**: コースとレッスンの見出しはボタン(`aria-expanded`・`aria-controls`・キーボードの Enter / Space でも開閉)。 + 表を開いたときは**いま進めているところだけ開く**(決まりは `design.md` の「たたみ方」。判定は + `lib/lessons/library-fold.js` の `initialFoldState`(純粋関数)): + - いま進めているコース(いちばん最近チャレンジができた、まだ全部できていないコース。どれも始めていなければ最初のコース。 + 「次のチャレンジ」から開いたときはそのレッスンのコース)だけ開く。たたんだコースは見出しと進み具合のバーだけ。 + - コースの中では、いまのレッスン(まだ全部できていない最初のレッスン。`focusLessonId` があればそれ)と、 + その後ろのまだ全部できていないレッスン 1 つを開く。全部できたレッスンとそれより後ろは閉じる。 + - 閉じたレッスンは 1 行(▶・✓・「レッスン 2」・名前・チャレンジの数だけの丸・「2 / 4」)。丸はできた=緑の塗り、 + 次(「次はこれ!」のチャレンジ)=オレンジ、まだ=白(`lessonDots`)。開いたレッスンの行には丸を出さない(カードで見える)。 + - 閉じてもカードは DOM に残して隠す(`hidden`)。 + - 開閉は覚えない(表を開くたびに決まりどおり)。検索中と、クラスの課題のチャレンジだけのレッスン表は全部開く。 + 検索を始めた・やめたときは、見出しを押して変えた分を捨てる。コースのボタン(コースが 4 つを超えたとき)を押すと + そのコースを開いてスクロールする。 - **記録の取り込み**: 開くたびに `reloadProgress()` を呼び、別のタブで書いた記録も反映する。 - **ほかのチャレンジへ → もどる**: レッスンモードの「ほかのチャレンジへ」は `closeLesson()` のあとレッスン表を開く(次のチャレンジを すぐ選べる)。 @@ -690,11 +1342,18 @@ scratch-vm には「ブロックが動いた」を知らせるイベントが無 | `lessons-library-tab-` | button | 言語のボタン(コースがある言語だけ。`aria-pressed`) | | `lessons-library-course-nav` | div | コースのボタンの段(コースが 4 つを超えたときだけ) | | `lessons-library-course-nav-` | button | コースのボタン(押すとそのコースまでスクロール) | -| `lessons-library-course-` | section | コース | +| `lessons-library-course-` | section | コース(`data-expanded="true\|false"`) | +| `lessons-library-course-toggle-` | button | コースの見出し(押すと開閉。`aria-expanded`・`aria-controls`) | +| `lessons-library-course-lessons-` | div | コースのレッスンの入れ物(たたむと `hidden`) | | `lessons-library-course-done` | span | コース名の前の ✓(コースのチャレンジが全部できたときだけ) | | `lessons-library-course-progress` | div | コースのプログレスバー(`role="progressbar"`)と数(課題のチャレンジだけのレッスン表では出さない) | | `lessons-library-course-progress-text` | span | 「m / n」(コース全体) | -| `lessons-library-lesson-` | section | レッスン(`data-focused`) | +| `lessons-library-lesson-` | section | レッスン(`data-focused`・`data-expanded="true\|false"`) | +| `lessons-library-lesson-toggle-` | button | レッスンの見出し(押すと開閉。`aria-expanded`・`aria-controls` = カードの並び `lessons-library-lesson-cards-`) | +| `lessons-library-lesson-done` | span | レッスン名の前の ✓(レッスンが全部できたときだけ) | +| `lessons-library-lesson-progress-text` | span | 見出しの右の「m / n」(レッスン) | +| `lessons-library-lesson-dots` | span | 閉じたレッスンの丸の並び(閉じているときだけ) | +| `lessons-library-lesson-dot` | span | 丸 1 つ(`data-state="done\|next\|todo"`) | | `lessons-library-challenge-` | button | チャレンジのカード(`data-completed="true\|false"`・`data-next`) | | `lessons-library-card-band` | span | カードの左の色の帯(`data-category` = なかま) | | `lessons-library-challenge-done` | span | カードの右上の ✓ | @@ -719,8 +1378,34 @@ scratch-vm には「ブロックが動いた」を知らせるイベントが無 結び付きも切る)→ 作品ができたらチャレンジの setup を適用 → `openChallenge(id)`。 この流れは `containers/lesson-mode.jsx` が進める(作成中 → 表示中の遷移で「できた」を検出する)。 - **setup**: `lib/lessons/challenge-setup.js` の `setupForChallenge(course, challenge)` が - `lib/deck-setup.js` に渡す形を作る。コースの言語から既定(ブロック = コードタブ、Ruby = Ruby タブ・Ruby + `lib/lessons/apply-setup.js` の `applySetup` に渡す形を作る(チュートリアルの一覧も同じ `applySetup` を使うが、 + チュートリアルを上流に戻したあともレッスンが使うので `lib/lessons/` に置く)。コースの言語から既定(ブロック = コードタブ、Ruby = Ruby タブ・Ruby モード、DNCL = Ruby タブ・DNCL モード)を決め、チャレンジの `setup` で上書きする。 + deck と同じ項目を適用したあと(拡張機能を読み込んでから)、作品の準備をする(`lib/lessons/challenge-start.js`): + + | 項目 | 形 | 何をするか | + |---|---|---| + | `sprites` | string[] | 新しい作品のネコを、ライブラリのスプライトに置きかえる(例 `['Shimaraby']`・`['Shimaraby', 'Shimacat']`)。1 つめはネコのいた場所、2 つめは「プログラムを入れる」で足すときと同じネコと重ならない右(x=150, y=0)、3 つめからはその下へ 100 ずつずらす。1 つめを編集中にする。ライブラリに 1 つも無いときはネコを残す | + | `code` | Ruby(locale ごとにも書ける) | 前の段の**答え**を、`sprites` の 1 つめ(無ければネコ)に入れておく。生徒の前の作品ではない | + | `spriteCodes` | `{sprite, code}`[] | ほかのスプライトの前の段の答え。チャレンジの `spriteCodes` と同じ形(いなければライブラリから足す) | + | `stageCode` | Ruby(locale ごとにも書ける) | ステージのプログラム(例: 旗でリスト「NGワード」を作り直す準備) | + + 入れる順はステージ → `spriteCodes` → `code`。変換は「プログラムを入れる」の `spriteCodes` と同じ(`targetCodeToBlocks` → `apply`)。 + Ruby のバージョンは `setup.rubyVersion` があればそれ、無ければいまの設定。 + - **失敗はとばして続ける**: ライブラリに無い・足すのに失敗したスプライト、変換できない・入れるのに失敗したプログラムは + とばし(コンソールに警告)、残りのスプライト・プログラム、編集中の切りかえ、Ruby タブの出し直しは行う。 + - **途中で止める**: 準備のあいだにほかのチャレンジを選んだ・作品が差しかわった(ステージの target が変わった)ときは、 + 段ごとの確かめで止め、変わったあとの作品には手を入れない。 + - **「変更あり」にしない**: スプライトを足すと VM が「作品が変わった」を出すので、準備のあとに「変更なし」にもどす + (そのままだと、チャレンジを選び直すだけで「作品を置きかえますか」やページを離れるときの確認が出る)。 + 編集中のスプライトの Ruby も出し直す(Ruby タブは編集中のスプライトが変わったときしか作り直さないため)。 + + `sprites` のあるチャレンジでは、「正解のプログラムを確認する」の `code` も `sprites` の 1 つめに入る(生徒がほかの + スプライトを選んでいても。決め方は `insert-sprite-code.js` の `resolveCodeSprite` で、始め方と共通)。 + アクティビティ図・読んで作るチャレンジの見出しの名前も「ネコ」の代わりにそのスプライトの名前になる。このコースの + キャラクター(Shimaraby → シマラビ、Shimacat → シマネコ)は、課題の文とそろえて locale の名前で書く + (`gui.lessons.activityDiagram.sprite.<名前>`。スプライトの名前そのもの・`spriteCodes`・判定はライブラリの名前のまま)。 + 全チャレンジの `setup.sprites` / `setup.spriteCodes` のスプライトがライブラリにあることは `courses.test.js` が確かめる。 - **課題バー**(`components/lesson-task-bar/`): メニューバーのすぐ下に、**画面の幅いっぱい**(エディタの列と ステージの列の両方の上)で 1 行・40px で出す(`gui.jsx` がメニューバーと本体のあいだに置き、本体は `.body-wrapper-with-lesson-task-bar` でその分だけ縮む)。 @@ -768,7 +1453,9 @@ scratch-vm には「ブロックが動いた」を知らせるイベントが無 吹き出しを隠さない。乗せ直せばまた出る)。 - **「できた!」・タップで開いたパネルは重ねない**: 「できた!」の toast が出ているあいだは、乗せても全文を 出さない。タップで開いたまま(pinned)のパネルは、吹き出し・toast のどちらかが出ると閉じ、タップで開くと - その 2 つを閉じる(z-index は 470。toast の 480・吹き出しの 490 より下)。 + その 2 つを閉じる(z-index は 470。toast の 480・吹き出しの 490 より下)。ただし**クイズのある「できた!」は + 閉じずに隠す**(`hideCompleted`。toast は描いたまま `hidden`)。全文のパネルが閉じたら(タップ・外を押す・Esc・ + 吹き出しが出る、のどれでも。課題バーの `onCloseFullText`)、`showCompleted` で出し直す(下の「ふりかえりのクイズ」)。 ![課題の全文(1300×600)](screenshots/0203-lesson-task-full-text-1300x600.png) @@ -797,7 +1484,9 @@ scratch-vm には「ブロックが動いた」を知らせるイベントが無 `procedures: [...]`)を書く。キー名は自由(中の opcode だけを見る)。チャットのチュートリアルと Ruby の基本 3・4・6 には書いてある。deck とチャレンジのプログラム(`code`・ヒントのブロック)が使う 変数・リスト・ブロック定義の opcode が `allowedBlocks` に入っているかは - `test/unit/lib/lesson-dynamic-categories-decks.test.js` が Ruby をブロックに変換して確かめる。 + `test/unit/lib/lessons/challenge-dynamic-categories.test.js`(チャレンジ)と + `test/unit/lib/libraries/decks/deck-dynamic-categories.test.js`(deck)が Ruby をブロックに変換して確かめる + (道具は `test/helpers/dynamic-category-opcodes.js`)。 - `?only_blocks=`・ステージのコメント・ブロックの選択(`selectedBlocks`)で絞るときは、これまでどおり 2 つとも出る。 - **パレットのブロックの初期値**: `allowedBlocks` の項目は opcode の文字列のほかに @@ -812,7 +1501,7 @@ scratch-vm には「ブロックが動いた」を知らせるイベントが無 (足す前の背景「Canyon」など)も、そのまま ▼ に出る。 - 書かないブロックはツールボックスの初期値のまま。メッセージ(「あいさつ」)・変数(「回数」)・リスト (「トーク」)の ▼ は子どもが作るものなので書かない(無い名前を入れると flyout が作ってしまう)。 - - レッスン 1 で書いている初期値: 1 = キー「スペース」・音 2 つとも「ニャー」(Owl を足したあとも)、 + - レッスン 1 で書いている初期値: 1 = キー「スペース」・音「ニャー」(終わるまで鳴らす)、 2 = キー「上向き矢印」、3・6・8 = 言う「こんにちは!」(en "Hello!"。ツールボックスの初期値は半角の 「こんにちは!」なので書く)、4 = キー「1」・繰り返す 3・背景「Canyon」、5 = 言う「くすぐったい!」、 6 = 聞く「なまえは?」、7 = 聞く「4+3=?」・`=` の右 7・言う「正解です」、9 = 言う「やあ!」、 @@ -820,8 +1509,10 @@ scratch-vm には「ブロックが動いた」を知らせるイベントが無 「なにか」を追加など)はツールボックスの初期値が仕様と同じ。 初期値で済むようになったヒント(▼で「上向き矢印」をえらぶ・「こんにちは!」と書く・「なまえは?」と書く・ 右に 7 を入れる・ことばを書く)は、「なっているか見よう」「のままでいいよ」の文言にしている。 -- **ヒント**: チャレンジを始めると(`openChallenge`)ヒントの 1 ページ目が**自動で開く**(ヒントボタンに - 気づかない子でも、何から始めるかがわかるように)。閉じたあとは「ヒント」ボタンで `showHint` / `hideHint`。 +- **ヒント**: どのコースのどのチャレンジも、チャレンジを始めると(`openChallenge`)ヒントの 1 ページ目が + **自動で開く**(ヒントボタンに気づかない子・ヒントを出したまま操作してよいとわからない子でも、何から始めるかが + わかるように。レッスンごとの設定は無い)。開いたあとは「ヒント」ボタンで `showHint` / `hideHint` + (`hideHint` は閉じずに小さくする。下の「ヒントの吹き出し」の「小さくする」)。 吹き出し(下の「ヒントの吹き出し」)は `containers/lesson-mode.jsx` の `` の次に置いた `containers/lesson-hint.jsx` が出す。ヒントが無いチャレンジでは自動で開かず、ボタンも無効。 自動で開くのはレッスンモードに入ったあとなので、「保存しますか」の確認・レッスン表とは重ならない。 @@ -860,6 +1551,8 @@ scratch-vm には「ブロックが動いた」を知らせるイベントが無 スクリーンショットは使わない。言語・色のモードはエディタと同じ (Blocks コンテナが Redux に置いた ScratchBlocks を使う)。inject は main workspace を差し替えるので、 描いたあとにエディタのワークスペースを `setMainWorkspace` で戻す。変換した XML は Ruby ごとに覚える。 + XML の先頭にはブロックが使う変数・リスト・メッセージを `` で宣言する(「(変数)」のブロックは id で変数を + 探すだけで作らないので、「〜にする」の無い絵では名前が空になるため)。 変換できない Ruby は「(このブロックは描けませんでした)」を出す(文言は出る)。`blocks` が locale ごとの オブジェクトなら、いまの UI の locale のものを描く(`localizeCode`)。 条件の穴に入った `false` は空の穴として描く(`if false` = 「もし < > なら」)。これは Ruby → ブロック変換 @@ -876,13 +1569,48 @@ scratch-vm には「ブロックが動いた」を知らせるイベントが無 ステージ・スプライトリスト・背景 = 左、タブ・旗 = 下、…)。画面幅で収まらないときは下(→ 上)にずらし、 それも収まらなければ指す場所の中に置く。場所が無い(`keyboard`)・いまのタブに無いときは画面の真ん中。 タブの切り替えで場所が現れたり消えたりするので、resize のほかに短い間隔(300ms)でも測り直す。 + 練習相手のパネル(`lesson-practice-partner`)が出ているときは、吹き出しをパネルにかぶせない(`findHintAvoidRects` → + `computeHintPlacement` の `avoid`)。かぶる置き方は、横に置くときは縦に・縦に置くときは横にずらし、それでもかぶれば + パネルの左(右)へずらす。指す場所にかからない置き方を先に選び、無ければ指す場所にかかる面積がいちばん小さいもの + (1300×600 で図のある 1 ページ目をパレットの右に置くと、パネルをよけてパレットの右はしに少しかかる)。どう置いても + かぶるときは、今までどおりに置く。 + 同じしくみで、コスチュームタブ・音タブの左の一覧(`selector_wrapper_`。ヒントを読みながら絵や音をえらぶ)と、 + スクリプトエリアを指すときはそこに置いてあるスクリプト(いちばん上のブロックの組。置いてあるブロックの数や ▼ を + 変えさせるヒントで、そのブロックを隠さない)にもかぶせない。 + ずらした結果、しっぽの位置が次のどれかになるときは、しっぽを出さない(何も指さず、閉じるボタンの横の白いひし形に見えるため): + 指す場所の真ん中が吹き出しの辺の外、左右の辺でヘッダーの帯の横(1300×600 で旗を指すページ)、上の辺で閉じるボタンの上。 + 帯の下の端と閉じるボタンの位置は、吹き出しの DOM から測って渡す。 - **スポットライト**: `spotlight: true` のヒントで、かつ `hintSpotlight`(はじめて開いたチャレンジ)のときだけ、 指す場所の矩形に穴を開けた巨大な box-shadow で周りを暗くする。`pointer-events: none` なので、照らした パレットやステージはそのまま操作できる(ドラッグ中のブロックは吹き出しより上を通る)。 -- **進める・もどる・閉じる**: `nextHint` / `prevHint` / `hideHint`。最初で「もどる」が無効。最後のページは +- **進める・もどる・小さくする**: `nextHint` / `prevHint` / `hideHint`。最初で「もどる」が無効。最後のページは そのあとが無いので、「進める」の代わりに **「おわり」**(`lesson-hint-finish`。押すと閉じる)を出す。 +- **小さくする(閉じない)**: ヘッダーのボタンは × ではなく **「-」**(ヒントを小さくする)。押すと吹き出しの代わりに、 + 課題バーのすぐ下に**小さな札**(`lesson-hint-minimized`。いまのページの「ヒント n/N」と、文言の最初の文から作った + 短い見出し・もどす印 ⤢)が残り、押すと同じページで元の大きさにもどる(課題バーの「ヒント」でももどる)。 + 授業で、子どもがヒントを読んで操作するときに閉じてしまい、手順を見失っていたため(ヒントを出したまま操作して + よいことがわかっていなかった)。小さくしても消えず、「もどしたくなる」ように吹き出しのヘッダーと同じ色の札にする。 + - 札の置き場所(`lib/lessons/hint-minimized.js` の `minimizedHintPosition`): 課題バーのすぐ下で、右の端をバーの + 「ヒント」ボタンにそろえる。ステージの列(旗・止める・ステージの大きさのボタン)にかかるときはその左(コードエリアの + 右上)へずらし、そこがパレットにかかるとき(SP の狭い画面)はパレットの右へずらす。1300×600 では + コードエリアの右上(タブの行の右)に出る。 + - 小さくしたらスポットライトも消す(照らしたまま操作のじゃまをしない)。札の z-index は 460(タップで開いたままの + 課題の全文のパネル 470 より下で、全文を隠さない)。 + - 「おわり」・できたとき・レッスンを出たときは、札も残さず閉じる(今までどおり)。 + - 状態は `lessonMode.hintMinimized`(`getCurrentHint` の `minimized`。`visible` と同時に true にならない)。 +- **手が止まったら光らせる**: プログラム(ブロックの変化)もステージ(スプライトの位置・見た目・実行)も **2 分**変わらなければ、 + 課題バーの「ヒント」と小さくしたヒントの札をゆっくり(2.4 秒で 1 往復)オレンジに光らせ、その下に「ヒントを見てみよう」 + (`lesson-hint-nudge`。押せない文字・`role="status"`)を出す。音は出さない。何か操作したら(押す・キー・ホイール・ + プログラムやステージの変化)止め、そこからまた 2 分を数える。ヒントを大きく出しているあいだ・「できた!」のあいだは + 光らせない。ヒントのページを変えた・小さくした・チャレンジを変えたときも数え直す。 + - 動きを減らす設定(`prefers-reduced-motion: reduce`)では光らせず、文字だけを出す。 + - 判定は純粋関数(`lib/lessons/idle-nudge.js` の `shouldNudgeHint` / `nextNudgeCheckIn`。2 分は `IDLE_NUDGE_MS`)、 + 変化は `lib/lessons/use-idle-nudge.js` が VM のイベントで知る(VM の `PROJECT_CHANGED`・`targetsUpdate`・`workspaceUpdate`、 + runtime の `PROJECT_RUN_START`・`SAY`)。イベントでは時刻を覚えるだけで、光らせる時刻にタイマーを 1 つ置いて判定し直す + (毎フレームの処理はしない)。`containers/lesson-mode.jsx` が hook を呼び、課題バー(`hintNudge`)・札(`nudge`)・ + 文字(`LessonHintNudge`)に渡す。GA には送らない。 - **開き直したときのページ**: 閉じ方で変える。 - - **×(閉じる・`hideHint`)**: 同じページから。読みかけを一度よけただけなので。 + - **「-」(小さくする・`hideHint`)**: 同じページから。読みかけを一度よけただけなので。 - **「おわり」(`finishHint`)**: 1 ページ目から。最後まで読んだので、次に「ヒント」を押したときに最後のページ (うまく動かないときは)がまた出ると、何をすればよいかわかりにくいため。 - **できたとき(`markChallengeCompleted` がいま開いているチャレンジ)**: 吹き出しを自動で閉じる。できたあとは @@ -903,6 +1631,10 @@ scratch-vm には「ブロックが動いた」を知らせるイベントが無 - **SP のサイドレールの右に置く**: サイドレール(`mobile-side-rail`。z-index 9200)は吹き出し(490)より上の層なので、 吹き出しの置き方・ドラッグの範囲はレールの右からにする(`hintViewport`)。レールの下に吹き出しの左側が 隠れて、取っ手や「もどる」を押せなくなるのを防ぐ。 + - **課題バーの下に置く**: 課題バー(`lesson-task-bar`)もメニューバーと同じ層で吹き出しより上に描かれるので、 + 置き方・ドラッグの範囲は課題バーの下からにする(`hintViewport` の `top`)。吹き出しの高さ(`max-height`)も + 課題バーの下から画面の下までに収める。指す場所が無いとき(画面の真ん中)も、課題バーの下の範囲の真ん中に置く。高い吹き出し(図のある 1 ページ目・読んで作るチャレンジの答えのページ)を + ステージの横に出すと、上の端がバーの下にもぐってヘッダーと閉じるが隠れるのを防ぐ。 - **最後の手段**: 最後のページは「うまく動かないときは」(`debug` の箇条書き)と**「正解のプログラムを確認する」** (`code`。`lesson-hint-insert-code`)。「プログラムを入れる」では、なぜあるのか生徒にわからなかったため。押すと 吹き出しの中に確認(`lesson-hint-insert-code-confirm`)「正解のプログラムで置き換えますか?あなたが作成したプログラムは @@ -914,7 +1646,7 @@ scratch-vm には「ブロックが動いた」を知らせるイベントが無 コードタブでは Ruby タブが変換してブロックにする)。チャレンジの `codeTarget` が `'stage'` なら、入れる前に ステージをえらび、Ruby タブの相手(`rubyCode.target`)もステージにする(ステージのプログラムのチャレンジ)。 入れる前に同じ変換を音・コスチューム・背景の確かめ込みで試し(`rubyToBlocksXml` の `validateAssets: true`)、 - 失敗するとき(ヒントの「Owl を足そう」をまだしていない等)は入れずに、ボタンの下にわけを出す + 失敗するとき(チャレンジ 4 のヒントの「背景を足そう」をまだしていない等)は入れずに、ボタンの下にわけを出す (`lesson-hint-insert-code-error`。入れると Ruby タブに切りかわってエラーになり、ブロックのコースの子どもには 何が起きたかわかりにくいため)。入れると吹き出しは閉じる。入れて動かしても「できた」になる(判定側は区別しない)。 - **ほかのスプライトのプログラム(`spriteCodes`)**: Ruby タブは編集中のスプライト 1 つに向けて変換するので、 @@ -926,6 +1658,175 @@ scratch-vm には「ブロックが動いた」を知らせるイベントが無 に対して行い、1 つでも失敗したら何も入れない(まだいないスプライトは target なしで確かめる)。 - **文言**: `gui.lessonHint.*`(`src/locales/{en,ja,ja-Hira}.js`)。 +### 読んで作るチャレンジ(`mode: 'readDiagram'`) + +**説明とアクティビティ図だけで指示する**チャレンジの形。生徒はやれるだけやってみて、最後に自分のプログラムと答えを +見くらべて確かめる。方針は [`design.md` の「アクティビティ図」](design.md#アクティビティ図)の「読んで作る」。 + +- **定義**: ふつうのチャレンジに `mode: 'readDiagram'` を足す。答えは `code`(と `spriteCodes`)、判定は `goal` + (`uses` / `result`。ほかのチャレンジと同じ)、パレットは `allowedBlocks`(ふつうと同じ)。1 ページ目の説明を + 課題の 1 行と変えたいときは `explanation` に書く。`steps` / `debug` は使わない(書いても無視する)。 + 決まりを当てはめるのは `defineChallenge`(`lib/lessons/read-diagram.js` の `applyChallengeMode`)。 +- **図**: 必ず出す(`activityDiagram` を true にする)。課題の全文とヒントの 1 ページ目(下の「アクティビティ図(答えから描く)」)。 +- **課題バー**: 位置の丸の右に「読んで作る」の印(`lesson-task-bar-read-diagram`)を出す。始める前に、説明と図だけの + チャレンジだとわかるように。 +- **ヒントは 3 ページだけ**(`readDiagramSteps`)。どのページもステージの左(コードエリアの右側)に出す(パレットと、 + 組み立てているコードエリアの左側を隠さない)。スポットライトは使わない。 + 1. **図と説明**: チャレンジを始めたら自動で開く。図・説明(`explanation` か `task`)・「答えはヒントの最後の + ページにあるよ」(文言の下の一言 `note`。`lesson-hint-note`)。 + 2. **試す**: 動かして図のとおりか試す・ちがったら図を読み直す、と、答えは次のページにあること。答えを見る前に + 試してもらうため、答えのページの手前に置く。 + 3. **答えを見る**: 答えのプログラム(`code` のいまの locale のもの)を、ヒントの絵と同じ描き方で吹き出しの中に + **スクリプト全体**描く(「描くのは相手と置くブロックまで」の例外)。**生徒のプログラムは置き換えない**。 + 「正解のプログラムを確認する」は置かない(置き換えると、そのまま動かすだけで「できた」になるため)。最後の + ページなので「おわり」。 +- **当てはめないヒントの決まり**: 帽子のブロックを置く手順を抜かさない・絵は置いてほしいブロックを並びのまま描く・ + つなげる相手もいっしょに描く、は手順のページの決まりで、読んで作るチャレンジは手順のページを持たない。 +- **プログラムが 2 つ以上あるとき**(`spriteCodes` があるとき): 3 ページ目に描くのは 1 つだけ(ページを 3 つに + 保つため)。`code` があればそれ(残りのスプライト = ネコ、`codeTarget: 'stage'` ならステージ)、無ければ + `spriteCodes` の最初のもの。ほかのスプライトの答えは図(スプライトごとに名前を書く)で見る。描いたブロックの上には、 + どのスプライトのものかの見出し「ネコのプログラム」(`gui.lessonHint.readDiagram.answerOf`。名前は図の見出しと同じ + 「ネコ」「ステージ」か、`spriteCodes` の `sprite`。`lesson-hint-blocks-label`)を出す。プログラムが 1 つだけの + ときは見出しを出さない(`readDiagramAnswer`)。 +- **答えの無い定義を止める**: 読んで作るチャレンジに答え(`code` か `spriteCodes`)が無いと、図も答えの絵も出ない。 + `courses.test.js` が全チャレンジを見て止め、開発のときは `applyChallengeMode` が警告を出す(本番では投げずに動かす)。 +- **吹き出しの高さ**: 図のある 1 ページ目と答えのページは高くなるので、吹き出しは課題バーの下から置き + (`hintViewport` の `top`)、高さも課題バーの下から画面の下までに収める。1300×600 で見本(クリック → 聞く → + もし〜でなければ・言う 2 つ)の 1 ページ目・答えのページとも、中をスクロールせずに収まることを確かめた。 + +![読んで作る: 図と説明(1 ページ目・1300×600)](screenshots/0411-lesson-hint-read-diagram-page1-1300x600.png) + +![読んで作る: 答えを見るページ(1300×600)](screenshots/0413-lesson-hint-read-diagram-answer-1300x600.png) + +### アクティビティ図(答えから描く) + +チャレンジの定義で `activityDiagram: true` にすると、答えのプログラムから描いたアクティビティ図を、**課題の全文** +(課題バーにマウスを乗せたとき・タップしたとき。文の下)と**ヒントの 1 ページ目**(文言の上)に出す。ヒントの +ほかのページには出さない。方針は [`design.md` の「アクティビティ図」](design.md#アクティビティ図)。 + +- **図のもと**: 答えの Ruby(`code` と `spriteCodes`、いまの locale のもの)を、ヒントの絵と同じ Ruby → ブロック変換に + かけたブロック。変換は VM も target も使わない(図に要るのはブロックの形と文だけ。まだ足していないスプライトや音の + 名前で迷わないように)。変換の結果はチャレンジ・locale・Ruby のバージョンごとに覚え、全文とヒントで同じ図を使う。 + 作品には入れない。答えが変換できないときは図を出さない(全文・ヒントはそのまま)。 +- **描き方**(`layout.js`): 記号は**教科書のアクティビティ図**(技術・家庭 技術分野の「アクティビティ図に使われる記号」)に + そろえる。上から下へ流す。 + - **開始・終了**: 帽子のブロックは開始(黒丸)の横の文、最後に終了(二重丸)。最後が「ずっと」のスクリプトと、 + 「すべてを止める」「このスクリプトを止める」で終わるスクリプトは、終了の記号とそこへの矢印を描かない。 + 両方の枝が終わる(ずっと・止める)分岐は合流を描かず、その後ろのブロック(届かない)も描かない。 + - **処理**: つながったブロックは角の丸い箱。 + - **分岐・合流**: 「もし〜なら」は**中に字を書かないひし形**から、条件に合う枝を左・合わない枝を右へ分け、枝に + ガード「[答え = 7]」「[それ以外]」を書く。下の**同じ大きさのひし形**(合流)でまとめる(「でなければ」が + 無いときは右はそのまま合流へ)。合わない枝を「[〜ではない]」と書かないのは「[触れたではない]」のような文に + なるため(UML の [else] と同じ考え方)。 + - **くり返し**: 点線の枠は使わず、**ひし形の合流と戻る線**で描く。「ずっと」は、上のひし形(合流)→ 本体 → + 本体の下から左を回ってひし形の左のかどへ戻る線(出口が無い)。「〜回くり返す」「〜までくり返す」は、上のひし形が + 合流と分岐を兼ね、下へ続ける枝に「[それ以外]」、右から出てぬける枝に「[3回くり返した]」 + 「[答え = 「おわり」]」を書く。ぬける線は戻る線の下を通って真ん中へ戻り、次の記号へ続く。 + - **送信**: 「〜を送る」「〜を送って待つ」(メッシュの合図も同じブロック)と、メッシュの値つきで送る + (`meshV2_broadcastWithValue`)は、相手の向きがとがった五角形。相手が左右両側にいれば両側がとがる。 + 「送って待つ」は記号の中の文で読む(待つための線は描かない)。合図を送るブロックは `model.js` の + `SEND_OPCODES` に並べる。 + - **受信**: 「〜を受け取ったとき」で始まるスクリプトは、開始の黒丸の代わりに受信の記号(送り手の向きがへこんだ + 箱。中に「「〜」を受け取ったとき」)で始める。送り手が左右両側にいれば両側がへこむ。 + - **送信から受信への矢印**: 送信から、**ほかのスプライト・レーン**の同じ合図の受信へ矢印を引く。合図の名前は + Scratch と同じく大文字と小文字を区別しない。矢印は送信の相手のいる側の辺から出て、受信の送り手のいる側の + へこみへ入り、**両はしの記号のほかのどの記号の内側も通らない**。道すじは次の順に、ほかの記号を通らないものを選ぶ: + 1. まっすぐ横(受信のスクリプトは、まっすぐ引ける送信がいれば、その高さまで下げる。近いスプライトから選ぶ) + 2. 受け手の手前のすき間で曲げる + 3. 送り手の先のすき間で曲げる + 4. 図の下を回る(合図ごとに段を分け、そのぶん図が高くなる) + + すき間(スクリプトの間)を何本も通るときと、レーンの境目のすき間では、線を少しずつずらす。 + **同じスプライトの中の合図**には矢印を引かず、合図の名前(送信と受信の記号の中の文)で読む(スクリプトが + 横に並ぶので、矢印を引くとほかの記号を回りこむ長い線になるため)。相手の側へ寄せるため、スプライトの中の + スクリプトは「左の相手とやりとりするもの → どちらでもないもの → 右の相手とやりとりするもの」の順に並べる + (同じ寄せ方どうしは書いた順)。 + - スクリプトは横に並べる。答えにスクリプトが 1 つも無い(コメントだけなど)ときは図を出さない。 +- **対応するブロック**: 順次・くり返し・もし・聞いて待つ・言う / 考える・待つ・変数(〜にする・〜ずつ変える)・ + メッセージ(送る・受け取ったとき)・メッシュ(センサー値)と、その中の値(答え・タイマー・比べる・かつ / または・ + つなぐ・乱数・触れた など)。**対応していないブロック**は処理の箱に、ブロックの文(scratch-blocks の文言の + テンプレート「背景を %1 にする」に値を入れたもの)を書く。文言が引けないときは opcode を書く。 +- **スプライトが 2 つ以上**(`spriteCodes` がある)のときは、スプライトごとに名前(`code` の分は「ネコ」、ステージの + プログラムは「ステージ」、ほかは `sprite` の名前)を上に書く。 +- **練習相手**(`partner`)があるときは、「あなた」と相手の名前の**スイムレーン**にする。相手のレーンは、練習相手の + 定義(形は [`design.md` の「メッシュの練習相手」](design.md#メッシュの練習相手))から描く: + - ボタン `buttons: [{label, set, broadcast}]` → 開始「「〜」ボタンを押したとき」。 + - 自動の返事 `replies: [{onBroadcast, set, broadcast}]` → 受信「「〜」を受け取ったとき」(`onBroadcast` の合図)。 + - どちらも `set`(共有する変数を変える `{variable, value}`。複数なら配列)を「〈変数〉を〈値〉にする」の処理、 + `broadcast` を「「〜」を送る」の送信にし、`set` → `broadcast` の順に並べる。自動の返事は受信の記号で始まる。 + - `value` が `{fromVariable}` なら「(名前の値)」と書く(ja-Hira「(名前のあたい)」、en「(value of 名前)」)。 + - 定義は練習のパネルと同じ `normalizePartner` で読む(locale ごとの `{ja, 'ja-Hira', en}` も同じ選び方。キーが無ければ + en → ja)。動かすときに使わない行(ラベルの無いボタン・名前の無い変数や `fromVariable`・何もしない返事)は描かない。 + - 定義が無い・描くものが無いときは自分のレーンだけ(見出しも描かない)。 +- **大きさ**: 置き方は字の大きさ 12 の単位で作り、SVG は縦横の比のまま縮める。**縮めるのは、いちばん小さい字(11)が + 10px になるところ(`MIN_DIAGRAM_SCALE` = 10/11 ≒ 0.91)まで**(`diagramScaleFor`)。それより小さくすると読めないため。 + - 課題の全文: 図に使えるのは、縦は 60vh から課題の文の高さ(開いたときに測る。測れないうちは 2 行ぶんの 6.25rem)と + 余白・すき間・枠の 2.25rem を引いた残り、横はパネルの幅(`lesson-task-bar.jsx`)。下限まで縮めても入らないときは + 図を出さず、代わりに「図はヒントの 1 ページ目で見られます」の 1 行を出す(マウスで乗せて出すパネルは中を + スクロールできないため)。1300×600 で課題の文が 2 行なら、図に使えるのは約 250px(置き方の高さで約 275 まで)。 + チャットの答えのような 8 ブロックほどの 1 本のスクリプトは入らず、案内の 1 行になる。 + - ヒントの 1 ページ目: 図のあるページは吹き出しを最大 30rem に広げ(分岐のある図が下限の大きさのまま横に入るように)、 + 縦 `min(16rem, 100vh − 16rem)`・幅は吹き出しの幅まで縮める。下限まで縮めても入らないときは、図の枠の中を + スクロールする。 +- **代わりの文**: SVG に ``(「アクティビティ図」)と、流れを文にした `<desc>`(`aria-describedby`)を付ける + (`describeActivityModel`。例「このスプライトが押されたとき → 「4+3=?」と聞いて待つ → 答え = 7?([答え = 7]: … / [それ以外]: …)」)。 + 分岐の枝は図と同じガードで書き、送信・受信には矢印の相手(例「「あいさつ」を送る(受け取る: ロボ)」 + 「「やあ」を受け取ったとき(送る: あなた)」)を書く。 + スクリーンリーダーでも流れがわかるように(「読んで作る」は図だけで指示するため)。 + +![課題の全文のアクティビティ図(1300×600)](screenshots/0207-lesson-task-full-text-activity-diagram-1300x600.png) + +![練習相手があるときのスイムレーン(1300×600)](screenshots/0208-lesson-task-full-text-activity-diagram-swimlane-1300x600.png) + +![ヒントの 1 ページ目のアクティビティ図(1300×600)](screenshots/0409-lesson-hint-activity-diagram-1300x600.png) + +### アクティビティ図(ブロックを右クリックして描く) + +コードエリアのブロックを**右クリック →「アクティビティ図」**(ja-Hira「アクティビティず」、en "Activity diagram")で、 +そのブロックのある**1 本のスクリプト**の図をパネルに描く。方針は [`design.md` の「アクティビティ図」](design.md#アクティビティ図)の +「描く」。レッスンモードでなくても使える(自分のプログラムを図にして読む練習に)。 + +- **メニューの項目**: scratch-blocks(Blockly)の `ContextMenuRegistry` に足す(id `smalrubyActivityDiagram`。 + 上流の項目の下)。upstream のファイルは変えず、`gui.jsx` に常時マウントしたコンテナ(`containers/block-activity-diagram.jsx`)が + 登録する。**出さない**のは、パレット(フライアウト)のブロックと、どこにもつながっていない値のブロック(「x座標」だけ・ + 「答え = 7」だけなど。流れが無い)。スクリプトの中の値のブロックを右クリックしたときは、そのスクリプトを描く。 +- **図のもと**: VM の target のブロック。右クリックしたブロックから親をたどったいちばん上のブロックと、そこから + next・入力でたどれるブロックだけを使う(ほかのスクリプトは描かない。`script-diagram.js`)。描き方(記号・置き方・ + 代わりの文)は上の「アクティビティ図(答えから描く)」と同じ部品(`model.js` / `layout.js` / `lesson-activity-diagram`)。 + 見出し(レーン・スプライトの名前)は描かず、パネルの見出しに「アクティビティ図(スプライトの名前)」と書く。 +- **図にできないもの**: + - 帽子の無いスクリプト(つながっているだけのブロック)は、開始の黒丸から描く。 + - 対応していないブロックは処理の箱に、**ワークスペースに出ているブロックの文**(Blockly の `toString()`。 + 拡張機能のブロックの文も出る)を書く。そのスプライトを選んでいないときは、答えから描く図と同じく scratch-blocks の + 文言のテンプレート、それも無ければ opcode。 + - 拡張機能の「〜とき」のように opcode で分からない帽子は、上につながらない形(`previousConnection` も + `outputConnection` も無い)なら開始の文にする。 + - 自分で作ったブロック: 定義は開始「ジャンプ (高さ)の定義」、呼び出しは「ジャンプ 10」(穴に入っている値)。 + - スクリプトを消した・ほかのプロジェクトを読んだなどでブロックが無くなったら、「このスクリプトはなくなりました。 + ブロックを右クリックして、もう一度開いてください。」を出す。 +- **描き直し**: 開いている間は、ブロックを変えると図も変わる(VM の `PROJECT_CHANGED` を 150ms まとめて読み直す)。 + 右クリックしたブロックをほかのスクリプトにつなぐと、つないだ先のスクリプトを描く。パネルの下に + 「ブロックを変えると、図も変わります。」を出す。開いたまま別のブロックを右クリックすると、そのスクリプトに替わる + (位置はそのまま)。 +- **GA**: 開くたびに `lessons` の `activity_diagram_open` を送る(下の「GA の計測」)。 +- **パネル**: モーダルにしない(後ろのブロックと見くらべながら直せるように)。開くと右上(メニューバーの下・ステージの上)に + 出て、見出しをつかんで動かせる(`react-draggable`、画面の外へは出ない)。×か Esc で閉じる。幅は図に合わせ(16〜40rem)、 + 高さは画面の高さ − 4.5rem まで。それより大きい図はパネルの中をスクロールする(字は答えから描く図と同じく下限 + `MIN_DIAGRAM_SCALE` より小さくしない)。1300×600 でチャットの答えくらいのスクリプト(くり返しと分岐と送る)は + スクロールなしで入る。重なりはメニューバー・モーダルより下(485)。本文は白(後ろが透けない)。 + +| data-testid | 要素 | 説明 | +|------------|------|------| +| `block-activity-diagram` | div | パネル全体(開いているときだけある) | +| `block-activity-diagram-title` | span | 見出し「アクティビティ図(スプライトの名前)」(ドラッグの取っ手のヘッダーの中) | +| `block-activity-diagram-close` | button | 閉じる(×) | +| `block-activity-diagram-body` | div | 図(`lesson-activity-diagram`)の入れ物 | +| `block-activity-diagram-gone` | p | スクリプトが無くなったときの文 | + +![ブロックを右クリックしたメニューの「アクティビティ図」(1300×600)](screenshots/0801-block-activity-diagram-menu-1300x600.png) + +![右クリックしたスクリプトのアクティビティ図のパネル(1300×600)](screenshots/0802-block-activity-diagram-popup-1300x600.png) + ### 吹き出しの共通の土台 吹き出し・ツールチップ・はじめての案内の**見た目**(枠・角丸・影・しっぽの向きと位置・色・閉じるボタン・ボタン・文字)は @@ -947,23 +1848,93 @@ scratch-vm には「ブロックが動いた」を知らせるイベントが無 | ウェルカムバルーン(`welcome-tooltip/`。`docs/welcome/`) | 青の `callout` + `BalloonCloseButton`、しっぽは右 | | クラス管理のツールチップ(`classroom-tutorial/`。`docs/tutorial/`) | 画面の真ん中のカードで吹き出しとは形が違うので `Balloon` は使わず、`balloon-tokens.css`(白地・角丸・影・文字色)と `BalloonButton`(OK)だけを使う | +### 名前の札(「ガイド」) + +画面の部分の名前(ヒントの文と同じ呼び方。Scratch Wiki の名前・`design.md`)を、部分を囲む枠と札で重ねて出す。「音タブを押して」が通じない子が、 +名前と場所を結びつけられるようにする。 + +- **出す部分**: 課題バー・ヒント(課題バーの「ヒント」)・コードタブ・コスチュームタブ・音タブ・ルビータブ・緑の旗・停止ボタン・ + ブロックパレット・スクリプトエリア・ステージ・スプライトペイン・背景(9 つの部分。タブは 4 つ、緑の旗と停止ボタンは 2 つの札)。 + スプライトペインの札は「スプライトペイン(スプライトをえらぶところ)」と短い説明を付ける(クイズの問いは名前だけ)。 + 部分の探し方はヒントの吹き出しと同じ(`findHintTargetRect`)で、いまの画面に無い部分(コスチュームタブを開いているときの + ブロックパレットなど)は出さない。ルビータブは 4 つめのタブ(SP はサイドレールの `mobile-side-rail-ruby`)。 +- **置き方**(`lib/lessons/part-names.js` の `computePartNameLayout`。純粋関数): 小さな部分(ボタン・タブ)は札をすぐ下 + (入らなければ横)に、広い部分は中の左上に置く。札が画面の外にはみ出さず、札どうし・ほかの小さな部分・ヒントの + 吹き出し・練習相手のパネルに重ならない置き場所を、部分に近いものから選ぶ。部分が動く(タブの切りかえ・画面の + 大きさの変化)のに合わせて 0.5 秒ごとに置き直す。 +- **出し方**: 課題バーの「ガイド」(「ヒント」の左。en は "Guide")で出し、**6 秒たつか、どこかを押すか、 + Esc で消える**。もう一度「ガイド」を押しても消える。押した操作はそのまま下の部品に届く。 +- **「ガイド」のボタン**: 大きさ・字・枠は「ヒント」と同じ(`lesson-task-bar.css` の `.button`。字は `$font-size-small`・ + 上下の余白は `$space-small`)。字の左に目のアイコンを付け、札を出しているときは開いた目と白地(`aria-pressed="true"`)、 + 隠しているときは斜めの線で消した目(`aria-pressed="false"`)にして、出し入れの状態がわかるようにする。 +- **最初から出す**: レッスンの `showPartNames: true` なら、チャレンジを開いたときから出したままにする(時間でも + 押しても消えない。「ガイド」で消せ、もう一度押すと出したままにもどる)。枠と札は `pointer-events: none` なので、 + 出したままでもブロックのドラッグやクリックを邪魔しない。 +- 層はヒントの吹き出し・課題バーより下(吹き出しを読みながら操作するため)。 + +### どこでしょう?のクイズ(`partQuiz`) + +レッスン 0 の最後(0-8)のふりかえり。「「ブロックパレット」はどこ? クリックしよう」と聞き、生徒が画面の部分を +クリックして答える。 + +- **問い**: チャレンジの `partQuiz.questions`(名前の札の `label`。問いに出す名前は Scratch Wiki の名前で、クイズの文言 + `gui.lessonPartQuiz.part.<label>` に持つ。0-8 は `palette` / `codeArea` / `soundsTab` / `greenFlag` / + `spriteList` の 5 問・固定。9 つの名前から、レッスン 0 で手で操作した場所をえらんだ)。並び順に 1 問ずつ聞く。 +- **判定**: クリックした点が、問いの部分の矩形(`findHintTargetRect`。ヒントの吹き出し・名前の札と同じ探し方)の中か + (`lib/lessons/part-quiz.js` の `isPartQuizAnswer`。純粋関数)。正しければ「せいかい!」と出して次の問いへ。まちがえたら + 「ちがうよ。光っているところを見て、もう一度」と出し、正しい場所を 2.5 秒光らせる(`PART_QUIZ_REVEAL_MS`。動きを減らす設定では + 点滅しない)。同じ問いをやり直す(数は減らない)。全部答えたら「5 問ぜんぶ せいかい!」。 +- **できた**: 正しく答えた数は Redux(`lessonMode.partQuizSolved`。`solvePartQuiz(challengeId, index)` で、いまの問いのときだけ 1 つ + 増える。チャレンジを開くたびに 0)に持ち、goal の `partQuiz`(`count: 5`)が「できた」を決める。 +- **クリックを奪う**: クイズのあいだは画面全体に透明な受け皿(`lesson-part-quiz-catcher`)を重ね、`pointerdown` / `mousedown` / + `click` / `contextmenu` を下へ届けない(答えのクリックでブロック・タブ・旗が動かない)。受け皿は、小さくしたヒントの札(460)・ + 「できた!」(480)・ヒントの吹き出し(490)・課題バー(491)より下の層(459)なので、それらは押せる。全部答えたら外す。 +- **問いの札**: コードエリアの下のほう(真ん中)に出す(パレット・タブ・旗・スプライトリストを隠さない。1300×600 で問いの文と + 結果が見える)。ヒントの 1 ページ目はこの札を指す(`HINT_TARGETS.PART_QUIZ`)。 +- クイズのチャレンジでは、名前の札(`showPartNames` のレッスンでも)と課題バーの「ガイド」を出さない(答えが見えてしまう)。 + ### data-testid | data-testid | 要素 | 説明 | |------------|------|------| | `lesson-task-bar` | div | 課題バー全体(レッスンモードのときだけある) | | `lesson-task-bar-position` | span | 「何個め / レッスンの中の数」(例: 「3 / 4」。en は "3 of 4") | +| `lesson-task-bar-read-diagram` | span | 「読んで作る」の印(チャレンジの `mode` が `'readDiagram'` のときだけ) | | `lesson-task-bar-task` | button | 課題の 1 行(長いときは省略記号)。タップ・キーボードで全文のパネルを開閉する(`aria-expanded` / `aria-controls`) | | `lesson-task-bar-full-text` | div | 課題の全文のパネル(マウスを乗せているあいだ・タップで開いているあいだだけある) | | `lesson-task-bar-full-text-text` | p | パネルの課題の文(改行つき) | | `lesson-task-bar-full-text-image` | img | パネルの画像(チャレンジに `image` があるときだけ) | +| `lesson-task-bar-full-text-diagram` | div | パネルのアクティビティ図(チャレンジの `activityDiagram` が true のときだけ。文の下) | +| `lesson-task-bar-full-text-diagram-note` | p | 図が大きくて全文に入らないときの「図はヒントの 1 ページ目で見られます」(図の代わり) | +| `lesson-activity-diagram` | svg | アクティビティ図の SVG(全文のパネルとヒントの 1 ページ目)。記号は `[data-shape]`(`start` / `end` / `action` / `decision` / `merge` / `loop` / `guard` / `lane` / `caption`)、矢印は `[data-edge]` | +| `lesson-task-bar-role` | span | 役のボタンと、役をどう決めたかの一言(役のあるチャレンジだけ) | +| `lesson-task-bar-role-buttons` | span | 役のボタンの並び(ヒントの「役を決めよう」の吹き出しが指す・`role-picker`) | +| `lesson-task-bar-role-shimaraby` / `lesson-task-bar-role-shimacat` | button | 「シマラビの役」/「シマネコの役」(いまの役は `aria-pressed="true"`) | +| `lesson-task-bar-role-note` | span | 「前回はシマネコの役」/「出席番号で決めた役」(前回の役・出席番号で決めたときだけ。ボタンの下) | +| `lesson-task-bar-part-names` | button | 「ガイド」。画面の部分の名前の札の出し入れ(出ているときは `aria-pressed="true"`) | +| `lesson-task-bar-part-names-icon` | svg | 「ガイド」の目のアイコン(札が出ているときは `data-open="true"` の開いた目、隠しているときは `"false"` の消した目) | | `lesson-task-bar-hint` | button | ヒントの吹き出しの出し入れ(ヒントが無ければ disabled) | +| `lesson-part-names` | div | 名前の札の重ね(出ているときだけある。document.body への portal) | +| `lesson-part-names-frame-<label>` | div | 部分を囲む枠(見つかった部分だけ)。`<label>` は `taskBar` / `hint` / `codeTab` / `costumesTab` / `soundsTab` / `greenFlag` / `stop` / `palette` / `codeArea` / `stage` / `spriteList` / `backdrop` | +| `lesson-part-quiz` | div | 「どこでしょう?」のクイズ(チャレンジに `partQuiz` があるときだけ。document.body への portal) | +| `lesson-part-quiz-catcher` | div | クリックを受ける透明な受け皿(全部答えるまで) | +| `lesson-part-quiz-panel` | div | 問いの札(コードエリアの下のほう) | +| `lesson-part-quiz-title` | div | 「どこでしょう? n / 5」 | +| `lesson-part-quiz-question` | div | 問いの文(`data-part` = 問いの部分の `label`) | +| `lesson-part-quiz-feedback` | div | 答えの結果(`data-result` = `correct` / `wrong`) | +| `lesson-part-quiz-reveal` | div | まちがえたときに光らせる正しい場所(2.5 秒) | +| `lesson-part-quiz-done` | div | 全部答えたときの「5 問ぜんぶ せいかい!」 | +| `lesson-part-names-label-<label>` | span | 部分の名前の札(置いたものは `data-placed="true"`、画面に無い部分は `false` で見えない) | | `lesson-task-bar-quit` | button | ほかのチャレンジへ(いまのチャレンジを終えてレッスン表を開く。白地で目立たせる) | | `lesson-task-bar-end` | button | レッスンをおえる(右端。レッスンから出て、いつもの画面にもどる。レッスン表は開かない) | | `lesson-hint` | div | ヒントの吹き出し(`data-side` = 置いた側 `right` / `left` / `bottom` / `top` / `inside` / `center`、`data-target` = 指す場所) | | `lesson-hint-spotlight` | div | スポットライトの穴(照らしているときだけある) | | `lesson-hint-position` | span | 「ヒント n / N」 | | `lesson-hint-title` | p | ヒントの文言 | +| `lesson-hint-emphasis` | strong | ヒントの文言の中の強調(`**…**`) | +| `lesson-hint-note` | p | 文言の下の一言(読んで作るチャレンジの 1 ページ目の「答えは最後のページ」) | +| `lesson-hint-blocks-label` | p | 描いたブロックの見出し(読んで作るチャレンジの答えのページで、プログラムが 2 つ以上あるとき「ネコのプログラム」) | +| `lesson-hint-activity-diagram` | div | ヒントの 1 ページ目のアクティビティ図(文言の上。チャレンジの `activityDiagram` が true のときだけ) | | `lesson-hint-blocks` | div | 本物のブロックを描く読み取り専用ワークスペース(`.blocklyBlockCanvas g[data-id]` がブロック) | | `lesson-hint-blocks-error` | p | ブロックを描けなかったときの注意 | | `lesson-hint-debug-title` / `lesson-hint-debug` | div / ul | 「うまく動かないときは」と箇条書き(最後のページ) | @@ -973,7 +1944,10 @@ scratch-vm には「ブロックが動いた」を知らせるイベントが無 | `lesson-hint-finish` | button | おわり(最後のページで「進める」の代わり。押すと閉じ、次は 1 ページ目から開く) | | `lesson-hint-drag-handle` | div | 吹き出しのヘッダー(ドラッグで動かす取っ手) | | `lesson-hint-insert-code-error` | div | プログラムを入れられないときのわけ(音・背景をまだ足していない等) | -| `lesson-hint-prev` / `lesson-hint-next` / `lesson-hint-close` | button | もどる / 進める(最後のページには無い) / 閉じる | +| `lesson-hint-prev` / `lesson-hint-next` / `lesson-hint-close` | button | もどる / 進める(最後のページには無い) / 小さくする(「-」。閉じずに札を残す。testid は前の「閉じる」のまま) | +| `lesson-hint-minimized` | button | 小さくしたヒントの札(押すと同じページで元の大きさにもどる) | +| `lesson-hint-minimized-position` / `lesson-hint-minimized-heading` | span | 札の「ヒント n/N」と短い見出し | +| `lesson-hint-nudge` | div | 手が止まったときの「ヒントを見てみよう」(光らせているあいだだけある。課題バーの「ヒント」と札は `data-nudge="true"`) | ### スクリーンショット @@ -985,25 +1959,49 @@ scratch-vm には「ブロックが動いた」を知らせるイベントが無 | `screenshots/0204-lesson-task-full-text-667x375.png` | SP 横(MobileGui)で同じ課題の文をタップして全文を開いたところ | | `screenshots/0206-lesson-task-bar-end-1300x600.png` | 課題バーの右端の「レッスンをおえる」(「ほかのチャレンジへ」は白地、「レッスンをおえる」は透明地に白い枠) | | `screenshots/0205-lesson-task-full-text-image-1300x600.png` | 1300×600 でチャレンジ 2「矢印キーで動かそう」の全文(画像つき)を出したところ | +| `screenshots/0207-lesson-task-full-text-activity-diagram-1300x600.png` | 1300×600 で全文にアクティビティ図を出したところ(「もし〜なら」を `activityDiagram: true` にして撮影。ずっと・分岐・合流) | +| `screenshots/0208-lesson-task-full-text-activity-diagram-swimlane-1300x600.png` | 練習相手の定義があるときのスイムレーン(「クイズを作ろう」にテスト用の `partner`(ボタンで変数を変えて合図を送る・合図を受け取ったら返す)を足して撮影) | +| `screenshots/0209-lesson-task-full-text-activity-diagram-too-tall-1300x600.png` | 図が大きくて全文に入らないときの案内の 1 行(テスト用の 8 ブロックの答えで撮影) | +| `screenshots/0210-lesson-task-full-text-read-diagram-1300x600.png` | 読んで作るチャレンジの課題バー(「読んで作る」の印)と全文の図(撮影のため、「クイズを作ろう」を見本の読んで作るチャレンジに実行時に差し替えた。いまのコースに読んで作るチャレンジは無い) | +| `screenshots/0211-editor-map-1300x600.png` | 標準課題「はじめの一歩」の「スモウルビーの地図」に使った画面(1300×600 でチャレンジ 2「矢印キーで動かそう」を開き、ヒントを「-」で小さくしたところ。地図はこの写真に 9 つの名前を書きこむ) | +| `screenshots/0410-lesson-hint-activity-diagram-scroll-1300x600.png` | 同じ大きい図をヒントの 1 ページ目で出したところ(下限の大きさで、図の枠の中をスクロールできる) | +| `screenshots/0411-lesson-hint-read-diagram-page1-1300x600.png` | 読んで作るチャレンジのヒント 1 ページ目(自動で開く。図・説明・答えは最後のページ)。見本は 0210 と同じ | +| `screenshots/0412-lesson-hint-read-diagram-page2-1300x600.png` | 同じチャレンジの 2 ページ目(試す) | +| `screenshots/0413-lesson-hint-read-diagram-answer-1300x600.png` | 同じチャレンジの 3 ページ目(答えのプログラム全体をブロックで描く。置き換えのボタンは無い・おわり) | | `screenshots/0401-lesson-hint-1300x600.png` | ヒント 2(パレットを指す・はじめてなのでスポットライト・本物のブロック)を 1300×600 で開いたところ | | `screenshots/0402-lesson-hint-667x375.png` | 同じヒントを SP 横(667×375)で開いたところ(パレットの右に収まる) | | `screenshots/0403-lesson-hint-375x667.png` | 同じヒントを SP 縦(375×667。縦持ちゲートを閉じたあと)で開いたところ(収まらないのでパレットの中) | | `screenshots/0404-lesson-hint-last-resort-1300x600.png` | 最後の手段のページ(うまく動かないときは・正解のプログラムを確認する・おわり) | | `screenshots/0405-lesson-hint-check-answer-confirm-1300x600.png` | 「正解のプログラムを確認する」を押したあとの確認(いいえ・はい) | | `screenshots/0406-lesson-hint-auto-open-1300x600.png` | チャレンジを始めたら自動で開いたヒントの 1 ページ目(1300×600) | +| `screenshots/0414-lesson-hint-minimized-1300x600.png` | ヒントを「-」で小さくしたところ(1300×600。課題バーの下・コードエリアの右上に「ヒント 2/7」と見出しの札。ステージの列にはかからない) | +| `screenshots/0415-lesson-hint-minimized-844x390.png` | 同じところを SP 横(844×390)で(札はパレットの右) | +| `screenshots/0416-lesson-hint-nudge-1300x600.png` | 2 分変化が無く、「ヒント」と札を光らせ、「ヒントを見てみよう」を出したところ(1300×600) | +| `screenshots/0417-lesson-hint-nudge-reduced-motion-1300x600.png` | 動きを減らす設定のとき(光らせず文字だけ・ヒントを閉じたあとなので札も無い。1300×600) | | `screenshots/0407-lesson-hint-dragged-667x375.png` | SP 横でヘッダーをタッチでドラッグして動かしたところ(しっぽは消える) | | `screenshots/0408-lesson-hint-auto-open-375x667.png` | SP 縦(縦持ちの案内を閉じたあと)で自動で開いたヒント(サイドレールの右に置く) | +| `screenshots/0409-lesson-hint-activity-diagram-1300x600.png` | ヒントの 1 ページ目にアクティビティ図を出したところ(1300×600。図・文言・ブロックの順) | | `screenshots/0301-lessons-button-1300x600.png` | メニューバーの「レッスン」ボタン(1300×600。はじめての人にも吹き出しは出ない) | -| `screenshots/0302-lessons-library-1300x600.png` | レッスン表(1300×600)。3 つのレッスンで、いくつかできた状態 | +| `screenshots/0302-lessons-library-1300x600.png` | レッスン表(1300×600)。レッスン 0 ができて、レッスン 1 の途中。レッスン 0(✓)・3 と「チャットをつくろう」はたたんである | | `screenshots/0303-lessons-library-375x667.png` | レッスン表(SP 縦 375×667。カード 2 列) | -| `screenshots/0304-lessons-library-cleared-1300x600.png` | コースのチャレンジが全部できた状態(コース名の前に ✓) | +| `screenshots/0304-lessons-library-cleared-1300x600.png` | コースのチャレンジが全部できた状態(コース名の前に ✓。そのコースはたたまれ、次のコースが開く) | | `screenshots/0306-lessons-library-667x375.png` | レッスン表(SP 横 667×375) | | `screenshots/0307-lessons-library-search-1300x600.png` | 検索したとき(「キー」) | | `screenshots/0101-completed-toast-1300x600.png` | 「できた!」(レッスンの途中。丸と「あと n つ」・次のチャレンジへ・もう少し見る) | | `screenshots/0102-completed-toast-last-1300x600.png` | 最後のレッスン(レッスン 3)のチャレンジが全部できたときの「レッスン 3 ぜんぶできた!」(コース名の行・レッスン表へ) | | `screenshots/0103-completed-toast-lesson-1300x600.png` | レッスン 1 のチャレンジが全部できたときの「レッスン 1 ぜんぶできた!」(レッスン名の行・次のレッスンへ) | +| `screenshots/0104-completed-toast-quiz-1300x600.png` | ふりかえりのクイズのある「できた!」(選ぶ前)。撮影のため、チャレンジ 3 に見本のクイズを足して撮った(いまのコースのチャレンジはクイズを持たない) | +| `screenshots/0105-completed-toast-quiz-wrong-1300x600.png` | 同じクイズで、はずれを選んだところ(×・「はずれ。もう一度選んでみよう」・解説) | +| `screenshots/0106-completed-toast-quiz-lesson-correct-1300x600.png` | 「レッスン 1 ぜんぶできた!」の中のクイズで正解を選んだところ(○・「正解!」・解説) | | `screenshots/0305-lessons-library-next-1300x600.png` | 「次のチャレンジ」で開いたレッスン表(1〜3 ができていて、4 に「次はこれ!」) | -| `screenshots/0501-challenge1-key-sound-hint1-1300x600.png` | チャレンジ 1「キーで音を鳴らそう」の最初のヒント(音タブを指す) | +| `screenshots/0523-lesson0-drag-cat-1300x600.png` | レッスン 0 の 0-1「ネコをつかんで動かそう」(ヒントが自動で開き、ステージを照らす。名前の札を最初から出す。1300×600) | +| `screenshots/0528-lesson0-change-number-hint1-1300x600.png` | 0-5「数と ▼ を変えよう」のヒント 1(「15 度回す」と「マウスのポインターへ行く」の旗のスクリプトから始まる。吹き出しはスクリプトにかぶらない。1300×600) | +| `screenshots/0529-lesson0-change-number-hint2-1300x600.png` | 0-5 のヒント 2(「マウスのポインターへ行く」の ▼ で「どこかの場所」をえらぶ。1300×600) | +| `screenshots/0524-lesson0-tabs-1300x600.png` | 0-6「タブをめぐろう」のコスチュームタブ(シマラビの 2 つの絵。ヒントは左の絵の一覧にかぶらない。1300×600) | +| `screenshots/0525-lesson0-where-1300x600.png` | 0-8「どこでしょう?」の問い(コードエリアの下の問いの札。ヒントは「-」で小さくした。1300×600) | +| `screenshots/0526-lesson0-where-wrong-1300x600.png` | 0-8 でまちがえたところ(「ちがうよ」と、正しい場所を光らせる。1300×600) | +| `screenshots/0527-lessons-library-lesson0-1300x600.png` | レッスン表の最初の「レッスン 0」(レッスン 0 の 3 つができても、コースの数は 0 / 11 のまま。1300×600) | +| `screenshots/0501-challenge1-key-sound-hint1-1300x600.png` | チャレンジ 1「キーで音を鳴らそう」の最初のヒント(パレットを指し、帽子のブロック「スペースキーが押されたとき」を描く。音タブは使わない) | | `screenshots/0502-challenge2-arrow-move-hint1-1300x600.png` | チャレンジ 2「矢印キーで動かそう」の最初のヒント(パレットを指し、帽子のブロック「上向き矢印キーが押されたとき」を描く) | | `screenshots/0503-challenge3-click-say-hint1-1300x600.png` | チャレンジ 3「押したら話そう」の最初のヒント(コスチュームタブを指す) | | `screenshots/0504-challenge4-repeat-hint1-1300x600.png` | チャレンジ 4「くり返そう」の最初のヒント(背景を選ぶを指す) | @@ -1078,6 +2076,7 @@ GTM・GA4 の設定(トリガー・データレイヤー変数・カスタム | `answer_view` | 「正解のプログラムを確認する」で、正解のプログラムを入れた(「はい」で入れたとき。「いいえ」・入れられなかったときは送らない) | チャレンジ id | 上の 4 つ | | `other_challenge` | 課題バーの「ほかのチャレンジへ」を押した | チャレンジ id | 上の 4 つ | | `lesson_end` | 課題バーの「レッスンをおえる」を押した | チャレンジ id | 上の 4 つ | +| `activity_diagram_open` | ブロックを右クリック →「アクティビティ図」でパネルを開いた(下の「アクティビティ図(ブロックを右クリックして描く)」。**レッスンモードの外でも送る**。メニューから開くたびに 1 回送る(開いたまま別のブロックで開き直したときも送る)) | `sprite`/`stage`(図にしたスクリプトがスプライトのものかステージのものか) | レッスンモードの中なら上の 4 つ(いまのチャレンジ)、外なら 4 つとも `undefined`(レッスン中かどうかは `challenge_id` があるかで見る) | - **ヒントの滞在時間**(`hint_view` の `seconds`): ページごとに、**そのページを出してから、次のページ・前のページへ 移る・吹き出しを閉じる(×・「おわり」)・「できた!」になる・チャレンジを閉じる/ほかのチャレンジを開く**までの秒 @@ -1092,15 +2091,19 @@ GTM・GA4 の設定(トリガー・データレイヤー変数・カスタム - **`from_assignment`**: クラスの課題のチャレンジから開いたか(true / false だけ)。レッスン表が、 課題のチャレンジを開くときに `startChallenge(id, {fromAssignment: true})` を渡す(課題の外のチャレンジや、課題に参加していないときは false)。 - **送らないもの**: 個人を特定する ID・クラス・席番号・ニックネーム・セッション・課題の ID・参加コード・入力した文字 - (検索の文字もふくむ)。送るのはコース・レッスン・チャレンジの id・ページの番号・秒・課題からか、だけ。 + (検索の文字もふくむ)・ブロックの文字・スプライトの名前。送るのはコース・レッスン・チャレンジの id・ページの番号・秒・課題からか・ + 図にしたのがスプライトかステージか、だけ。 - **先生(ログイン中)からは送らない**: 先生がクラス管理にログインしているあいだは、エディタでレッスンを開いても 何も送らない(`state.scratchGui.classroom.teacherLoggedIn`。授業の準備で開くと数がゆがむため)。どこまで送ったかの 覚えだけは進めるので、ログアウトしても、先生のときに開いたチャレンジを開いたことにはしない。 +- レッスン 0(`blocks-l0`)も同じイベントを送る(`lesson_id` = `blocks-l0`、`challenge_id` = `blocks-l0-*`)。項目は増やしていない。 - 計測の失敗(`dataLayer` が無いなど)は握りつぶし、レッスンの動きを止めない。 - 判断は純粋関数 `lib/lessons/lesson-analytics.js`(`stepLessonAnalytics`。前の状態と今の状態と時刻から、送るイベントを 決める)、送るのは `containers/lesson-analytics.jsx`(gui.jsx のマーカー `lesson mode` の中に常時マウント)。 ボタンで決まる `answer_view` / `other_challenge` / `lesson_end` は、押したところ(`containers/lesson-hint.jsx` / `containers/lesson-mode.jsx`)から `sendLessonEvent` で送る。 + `activity_diagram_open` は、イベントを決める純粋関数 `activityDiagramEvent` を `containers/block-activity-diagram.jsx` が + `sendActivityDiagramEvent` で送る(新しい項目は足していない。GTM の共通タグのパラメータは 25 個で満杯のため)。 ## いまのチュートリアルの入口 @@ -1119,16 +2122,37 @@ GTM・GA4 の設定(トリガー・データレイヤー変数・カスタム |---------|------| | `packages/scratch-gui/src/lib/lessons/images/` | チャレンジの `image` に使う画像(`courses.js` で import する) | | `packages/scratch-gui/src/lib/lessons/card-color.js` | レッスン表のカードの色の決め方(ブロックをなかまごとに数える・いちばん多いなかま、同数ならメイン) | -| `packages/scratch-gui/src/lib/lessons/courses.js` | コース・レッスン・チャレンジのデータと検索。locale ごとの Ruby を選ぶ `localizeCode` / `challengeCodeFor` / `challengeCodeCandidates` | +| `packages/scratch-gui/src/lib/lessons/courses.js` | コース・レッスン・チャレンジのデータと検索。locale ごとの Ruby を選ぶ `localizeCode` / `challengeCodeFor` / `challengeCodeCandidates`。ふりかえりのクイズを作る `challengeQuiz` と形を確かめる `validateQuiz` | | `packages/scratch-gui/src/lib/lessons/lessons.locale.js` | 文言(en / ja / ja-Hira。`src/locales/*.js` に spread) | +| `packages/scratch-gui/src/lib/lessons/chat.locale.js` | コース「チャットをつくろう」の文言(en / ja / ja-Hira。`lessons.locale.js` に spread) | | `packages/scratch-gui/src/lib/lessons/lesson-progress.js` | 端末への記録(いまの定義での読みかえ)・レッスン/コースの進み具合・「できた!」のボタンとレッスン表で見せるもの | +| `packages/scratch-gui/src/lib/lessons/role-swap.js` | ペアの役の名前の入れかえ(`swapRoleText` / `swapChallengeRoles` / `challengeForRole` / `formatRoleMessage` / `roleOfChallenge`) | +| `packages/scratch-gui/src/lib/lessons/lesson-role.js` | 役の決め方(`resolveChallengeRole`・出席番号のペア `seatRoleFor` / `connectedGroupSeats`)・前回の役の保存(`smalruby:lessonRole`)・役を変えたら始めなおすか(`roleChangeRestarts`) | +| `packages/scratch-gui/src/components/lesson-task-bar/lesson-role-picker.jsx` | 課題バーの役のボタン | | `packages/scratch-gui/src/lib/lessons/challenge-setup.js` | チャレンジを開くときの setup(言語の既定 + チャレンジの `setup`) | | `packages/scratch-gui/src/components/balloon/` | 吹き出し・ツールチップの見た目の土台(`Balloon` / `BalloonHeader` / `BalloonCloseButton` / `BalloonButton` / `balloon-tokens.css`。上の「吹き出しの共通の土台」) | -| `packages/scratch-gui/src/components/lesson-hint/` | ヒントの吹き出し(`lesson-hint.jsx` = 中身・置き方・スポットライト・ドラッグ・正解のプログラムの確認(枠は `balloon/`)、`lesson-hint-blocks.jsx` = 読み取り専用ワークスペースに本物のブロックを描く) | -| `packages/scratch-gui/src/containers/lesson-hint.jsx` | 吹き出しのコンテナ(`getCurrentHint` を読み、`blocks` を XML にし、「プログラムを入れる」を dispatch) | -| `packages/scratch-gui/src/lib/lessons/hint-targets.js` | 指す場所の名前(`HINT_TARGETS`)・DOM の探し方・置き方・ドラッグした位置を画面に収める(`clampHintPosition`)・置いてよい範囲(`hintViewport`。SP のサイドレールの右)(純粋関数) | +| `packages/scratch-gui/src/components/lesson-hint/` | ヒントの吹き出し(`lesson-hint-nudge.jsx` = 手が止まったときの「ヒントを見てみよう」、`lesson-hint.jsx` = 中身・置き方・スポットライト・ドラッグ・正解のプログラムの確認(枠は `balloon/`)、`lesson-hint-blocks.jsx` = 読み取り専用ワークスペースに本物のブロックを描く、`lesson-hint-minimized.jsx` = 小さくしたヒントの札) | +| `packages/scratch-gui/src/lib/lessons/idle-nudge.js` / `use-idle-nudge.js` | 手が止まったら「ヒント」を光らせるかの判定(純粋関数)と、VM のイベントで変化を知る hook | +| `packages/scratch-gui/src/lib/lessons/hint-minimized.js` | 小さくしたヒントの札の短い見出し(`shortHintHeading`)と置き場所(`minimizedHintPosition`)(純粋関数) | +| `packages/scratch-gui/src/containers/lesson-hint.jsx` | 吹き出しのコンテナ(`getCurrentHint` を読み、`blocks` を XML にし、「プログラムを入れる」を dispatch。クラスに参加中の生徒には手順の `classroomTitle` を出す) | +| `packages/scratch-gui/src/lib/lessons/hint-text.js` | ヒントの文言の決まり(`**…**` の強調を分ける `splitEmphasis`、クラスの中と外で文言を選ぶ `hintStepTitle` / `isSeatedStudent`) | +| `packages/scratch-gui/src/lib/lessons/hint-targets.js` | 指す場所の名前(`HINT_TARGETS`)・DOM の探し方・置き方・ドラッグした位置を画面に収める(`clampHintPosition`)・置いてよい範囲(`hintViewport`。SP のサイドレールの右・課題バーの下)(純粋関数) | +| `packages/scratch-gui/src/lib/lessons/part-names.js` | 名前の札を出す部分(`PART_NAMES`)・探し方(`findPartNameRects`)・札の置き方(`computePartNameLayout`。純粋関数) | +| `packages/scratch-gui/src/components/lesson-part-names/` | 名前の札の重ね(枠と札・置き直し・6 秒で消す) | +| `packages/scratch-gui/src/lib/lessons/part-quiz.js` | 「どこでしょう?」のクイズの判定(`isPartQuizAnswer` / `partQuizTarget` / `validatePartQuiz`。純粋関数) | +| `packages/scratch-gui/src/components/lesson-part-quiz/` | 「どこでしょう?」のクイズ(問いの札・クリックを受ける受け皿・まちがえたときに光らせる) | +| `packages/scratch-gui/src/lib/lessons/read-diagram.js` | 読んで作るチャレンジ(`mode: 'readDiagram'`)のヒントの 3 ページを作る・定義に決まりを当てはめる(`readDiagramSteps`・`applyChallengeMode`。純粋関数) | +| `packages/scratch-gui/test/unit/lib/lessons/read-diagram.test.js` | 読んで作るチャレンジの unit テスト | | `packages/scratch-gui/src/lib/lessons/hint-blocks.js` / `blocks-xml.js` | Ruby → ブロック → Blockly の XML | +| `packages/scratch-gui/src/lib/lessons/activity-diagram/` | アクティビティ図。`labels.js`(ブロックの文)・`model.js`(ブロック → 記号の木・練習相手のレーン)・`layout.js`(置き方)は純粋関数。`challenge-diagram.js` がチャレンジの定義から図を作り、`use-challenge-activity-diagram.js` がいまのチャレンジの図を返す hook(変換の結果を覚える)。文言は `activity-diagram.locale.js`(`src/locales/*.js` に spread) | +| `packages/scratch-gui/src/components/lesson-activity-diagram/` | 置き方を SVG に描く部品(課題の全文・ヒントの 1 ページ目・右クリックのパネル) | +| `packages/scratch-gui/src/lib/lessons/activity-diagram/script-diagram.js` | 右クリックしたブロックのスクリプトだけを取り出して図にする(`scriptRootId` / `scriptBlocksOf` / `scriptActivityDiagram`。純粋関数) | +| `packages/scratch-gui/src/containers/block-activity-diagram.jsx` | ブロックのメニューに「アクティビティ図」を登録し、パネルを開く・描き直す・閉じる。`gui.jsx` に常時マウント(Smalruby マーカー `block activity diagram`) | +| `packages/scratch-gui/src/components/block-activity-diagram/` | 右クリックで開くアクティビティ図のパネル(動かせる・閉じられる) | +| `packages/scratch-gui/test/unit/lib/lessons/script-diagram.test.js` / `test/unit/containers/block-activity-diagram.test.jsx` | 右クリックで描く図の unit テスト(スクリプトの取り出し・図にできないもの・メニューの項目・開閉・描き直し) | +| `packages/scratch-gui/test/unit/lib/lessons/activity-diagram.test.js` / `test/unit/components/lesson-activity-diagram.test.jsx` | アクティビティ図の unit テスト(本物の変換でモデル・置き方を確かめる) | | `packages/scratch-gui/src/lib/lessons/insert-sprite-code.js` | 「プログラムを入れる」で `spriteCodes` をそれぞれのスプライトに入れる(いなければライブラリから足す) | +| `packages/scratch-gui/src/lib/lessons/sprite-names.js` | コースのキャラクター(Shimaraby / Shimacat)の言語ごとの名前(足すときの名前・どの言語の名前でも探す・「スプライトを選ぶ」の一覧。`containers/sprite-library.jsx` がマーカー付きで使う) | | `packages/scratch-gui/src/lib/lessons/lesson-analytics.js` | GA の計測の判断(`stepLessonAnalytics`。前の状態・今の状態・時刻から送るイベントを決める純粋関数)と、ボタンで決まるイベントを送る `sendLessonEvent`(上の「GA の計測」) | | `packages/scratch-gui/src/containers/lesson-analytics.jsx` | GA の計測のコンテナ(描画しない。state を渡して `analytics.event` に送る)。`gui.jsx` のマーカー `lesson mode` の中に常時マウント | | `packages/scratch-gui/test/unit/lib/lessons/lesson-analytics.test.js` / `test/unit/containers/lesson-analytics.test.jsx` | GA の計測の unit テスト(イベントの名前・項目・ヒントの滞在時間・送らない項目) | @@ -1144,17 +2168,24 @@ GTM・GA4 の設定(トリガー・データレイヤー変数・カスタム | `packages/scratch-gui/test/integration/smalruby-lesson1-challenges-5-8.test.js` | チャレンジ 5〜8 を開く → プログラムを入れる → 旗・マウス・ネコを押す・答えを入力する →「できた!」(Selenium・1300×600) | | `packages/scratch-gui/test/integration/smalruby-lesson1-challenges-9-11.test.js` | チャレンジ 9〜11 を開く → ペンギン・リストを足す → プログラムを入れる → ネコを押す・旗・答えを入力する →「できた!」(Selenium・1300×600) | | `packages/scratch-gui/test/integration/smalruby-lesson1-clear.test.js` | コースの全体: レッスン表から 11 個すべてが開ける(課題バーはレッスンの中の番号)→ レッスン 1・2 を 1 つのレッスンだったころの記録で入れ、レッスン 3 の 4 つを「プログラムを入れる」→ 操作 →「できた!」→ コースの進み具合とコース名の前の ✓(Selenium・1300×600) | +| `packages/scratch-gui/src/lib/lessons/practice-partner.js` | 練習相手の定義を読む純粋関数(`normalizePartner`・`repliesFor`・`practiceAllowed`) | +| `packages/scratch-gui/src/lib/lessons/practice-loopback.js` | 練習相手のブラウザの中での折り返し(`attachPracticeLoopback`) | +| `packages/scratch-gui/src/components/lesson-practice-partner/` | 練習相手のパネル | +| `packages/scratch-gui/src/containers/lesson-practice-partner.jsx` | 練習相手のコンテナ(開閉・本物のメッシュのつながりを見る・置き場所を測る)。`lesson-mode.jsx` からマウント | +| `packages/scratch-gui/test/unit/lib/lessons/practice-partner.test.js` / `test/unit/containers/lesson-practice-partner.test.jsx` | 練習相手の unit テスト | | `packages/scratch-gui/src/lib/lessons/goal.js` | できた の判定(`goal` の形・事実の記録・判定の純粋関数・`validateGoal`) | | `packages/scratch-gui/src/lib/lessons/vm-execution-hook.js` | ブロックの実行をスレッドつきで取るフック(runtime の `getOpcodeFunction` を包む) | | `packages/scratch-gui/src/lib/lessons/goal-monitor.js` | VM を見張って goal を判定する(`attachGoalMonitor` / `takeSnapshot`) | | `packages/scratch-gui/src/containers/lesson-goal-watcher.jsx` | レッスンモードのあいだ見張りをつなぎ、できたら記録して「できた!」を出す(gui.jsx に常時マウント) | -| `packages/scratch-gui/src/components/lesson-completed-toast/` | 「できた!」の表示 | +| `packages/scratch-gui/src/components/lesson-completed-toast/` | 「できた!」の表示(`lesson-completed-quiz.jsx` = その中のふりかえりのクイズ) | | `packages/scratch-gui/src/reducers/lesson-mode.js` | いま開いているチャレンジ・開こうとしているチャレンジ・ヒント・「できた!」・記録の写し | | `packages/scratch-gui/src/containers/lesson-mode.jsx` | チャレンジを開く流れ(新しい作品 → setup → レッスンモード)と課題バーのマウント。`gui.jsx` のエディタ列の先頭に常時マウント | | `packages/scratch-gui/src/components/lesson-task-bar/` | 課題バー(1 行・40px) | | `packages/scratch-gui/src/components/lessons-library/` | レッスン表(モーダル) | | `packages/scratch-gui/src/lib/lessons/library-filter.js` | レッスン表の検索(`filterCourseStatuses`)・出す言語(`libraryLanguages`)・コースのボタンを出すか(`showCourseNav`) | | `packages/scratch-gui/test/unit/lib/lessons/library-filter.test.js` | 上の unit テスト | +| `packages/scratch-gui/src/lib/lessons/library-fold.js` | レッスン表を開いたときのたたみ方(`initialFoldState`・いま進めているコース `currentCourseId`・閉じた行の丸 `lessonDots`。純粋関数) | +| `packages/scratch-gui/test/unit/lib/lessons/library-fold.test.js` | 上の unit テスト(全部できた・いま・つぎ・後ろ、検索中、課題だけの表、`focusLessonId`、コースのたたみ) | | `packages/scratch-gui/src/lib/lessons/open-lessons-library.js` | レッスン表をいまのレッスンを見せて開く(`openLessonsLibraryAt`。「次のチャレンジ」が使う)・クラスの課題のチャレンジだけで開く(`openAssignmentLessonsLibrary`。「はじめる」「レッスンを続ける」) | | `packages/scratch-gui/src/lib/lessons/assignment-progress.js` | クラスの課題のレッスンの数え方(設定をそろえる・条件の数・あと n つ・課題クリア・メニューバーの印・はじめての課題クリア・レッスン表を課題のチャレンジに絞る・次にやる課題のチャレンジ・クラスへ送る分の記録)の純粋関数 | | `packages/scratch-gui/test/unit/lib/lessons/assignment-progress.test.js` | 上の unit テスト | @@ -1168,11 +2199,12 @@ GTM・GA4 の設定(トリガー・データレイヤー変数・カスタム | `packages/scratch-gui/src/lib/lessons/block-defaults.js` | `allowedBlocks` に書いたブロックの初期値を集め、ツールボックスの XML・flyout の要素に入れる純粋関数(`blocks.jsx` のマーカー `lesson palette block defaults`) | | `packages/scratch-gui/src/lib/lesson-dynamic-categories.js` | 「変数」「ブロック定義」を `allowedBlocks` で絞る純粋関数(カテゴリを出すか・flyout の中身) | | `packages/scratch-gui/src/lib/make-toolbox-xml.js` | `allowedBlocks` に無ければ「変数」「ブロック定義」のカテゴリを出さない(マーカー `lesson dynamic category filtering`) | -| `packages/scratch-gui/test/unit/lib/lesson-dynamic-categories.test.js` | 上の純粋関数・toolbox XML・既存の deck / チャレンジの unit テスト | -| `packages/scratch-gui/test/unit/lib/lesson-dynamic-categories-decks.test.js` | すべての deck・チャレンジのプログラムを変換し、使う変数・リスト・ブロック定義の opcode が `allowedBlocks` にあるか | +| `packages/scratch-gui/test/unit/lib/lesson-dynamic-categories.test.js` | 上の純粋関数・toolbox XML・既存のチャレンジの unit テスト | +| `packages/scratch-gui/test/unit/lib/lessons/challenge-dynamic-categories.test.js` | すべてのチャレンジのプログラムを変換し、使う変数・リスト・ブロック定義の opcode が `allowedBlocks` にあるか(deck の分は `test/unit/lib/libraries/decks/deck-dynamic-categories.test.js`。道具は `test/helpers/dynamic-category-opcodes.js`) | +| `packages/scratch-gui/src/lib/lessons/apply-setup.js` | チャレンジの setup(タブ・Ruby のモード・拡張機能・Ruby の版)を当てる `applySetup`。チュートリアルの一覧も使う | | `packages/scratch-gui/test/unit/lib/lessons/` | データの形・記録・クリア判定・setup・できた の判定・見張り・カードの色の決め方(`card-color.test.js`)の unit テスト | | `packages/scratch-gui/test/unit/reducers/lesson-mode-reducer.test.js` | reducer の unit テスト | -| `packages/scratch-gui/test/unit/components/lesson-completed-toast.test.jsx` / `test/unit/containers/lesson-goal-watcher.test.jsx` | 「できた!」と見張りのコンテナの unit テスト | +| `packages/scratch-gui/test/unit/components/lesson-completed-toast.test.jsx` / `test/unit/components/lesson-completed-quiz.test.jsx` / `test/unit/containers/lesson-goal-watcher.test.jsx` | 「できた!」と見張りのコンテナの unit テスト | | `packages/scratch-gui/test/integration/lesson-goal.test.js` | 本物の VM に Ruby のプログラムを入れて動かし、判定が true になる integration テスト | | `packages/scratch-gui/src/components/menu-bar/menu-bar.jsx` | 「レッスン」ボタン(`lessons button` マーカー)、「?」メニューのチュートリアル / デバッグ項目(`help menu` マーカー) | | `packages/scratch-gui/src/containers/menu-bar-hoc.jsx` | `onOpenLessonsLibrary` / `lessonModeActive`(`lessons button` マーカー)と `onOpenTipsLibrary`(`help menu` マーカー)の供給 | @@ -1181,7 +2213,7 @@ GTM・GA4 の設定(トリガー・データレイヤー変数・カスタム | `packages/scratch-gui/test/integration/smalruby-lesson-task-bar-layout.test.js` | 課題バーが画面の幅いっぱい・ボタンが右端・ステージの列の旗/止める/ステージの大きさが押せる・ページがスクロールしない、中サイズのステージのスプライトの情報が詰まった形でどの入力欄も押せる(大きいステージでは upstream の形)(Selenium・1300×600) | | `packages/scratch-gui/test/unit/components/sprite-info-compact.test.jsx` | 中サイズのステージのスプライトの情報(「スプライト」の字なし・x / y が左隣・大きさ / 向きのアイコンとツールチップ en / ja / ja-Hira、小・大は upstream のまま) | | `packages/scratch-gui/test/integration/smalruby-lessons.test.js` | チャレンジを開く → 課題バー・絞ったパレット → やめる → 元にもどる。「レッスンをおえる」でレッスン表を開かずに出て、プログラムが残り、パレットが全部にもどる(Selenium) | -| `packages/scratch-gui/test/unit/components/lessons-library.test.jsx` / `test/unit/containers/lessons-library.test.jsx` / `test/unit/components/menu-bar-lessons.test.jsx` | レッスン表(3 つのレッスン・カードの色の帯・✓・コースのバー・検索・言語とコースのボタン・「次はこれ!」)、コンテナ、「レッスン」ボタン(吹き出しを出さないこと)の unit テスト | +| `packages/scratch-gui/test/unit/components/lessons-library.test.jsx` / `test/unit/containers/lessons-library.test.jsx` / `test/unit/components/menu-bar-lessons.test.jsx` | レッスン表(3 つのレッスン・カードの色の帯・✓・コースのバー・検索・言語とコースのボタン・「次はこれ!」・見出しの開閉と丸)、コンテナ、「レッスン」ボタン(吹き出しを出さないこと)の unit テスト | | `packages/scratch-gui/test/integration/smalruby-lessons-library.test.js` | メニューから開く → チャレンジを押す → レッスンモード → やめる → レッスン表にもどる・記録に合わせた ✓ とコースの進み具合・検索(Selenium) | ## 設定・データ永続化 @@ -1190,5 +2222,6 @@ GTM・GA4 の設定(トリガー・データレイヤー変数・カスタム |------|------|------| | localStorage | `smalruby:lessonProgress` | チャレンジ ID → できた日時(とコース・レッスン) | | localStorage | `smalruby:lessonAssignmentConsent` | 本人の確認の答え(課題 × 席 × 席に入った人(参加した時刻、無ければトークンの短いハッシュ)→ `{answer: mine\|cleared\|none, beforeIds, decidedAt}`。新しいものから 50 件) | +| localStorage | `smalruby:lessonRole` | ペアのチャレンジで生徒が前回**選んだ**役と、そのときの出席番号のペアの印(`{role: 'shimaraby'\|'shimacat', pair: '3-7'\|null}`)。既定の役・出席番号で決まった役は書かない | | localStorage | `smalruby:lessonSpotlightSeen` | チャレンジ ID → はじめて開いた日時(ヒントのスポットライトを 2 回目から出さないため) | | localStorage | `smalruby:tutorialSeen` | レッスン表を開くと `true` を書く(`tutorial-onboarding` reducer の `markTutorialSeen`)。いまは読む画面が無い(「レッスン」ボタンの下の吹き出しは出さないため) | diff --git a/docs/lessons/design.md b/docs/lessons/design.md index ad28c872ad7..68926ba48b0 100644 --- a/docs/lessons/design.md +++ b/docs/lessons/design.md @@ -30,13 +30,14 @@ |---|---|---| | 言語 | レッスン表の上の帯のボタン | ブロック/Ruby/日本語(DNCL)。**コースがある言語のボタンだけ出す**(いまは「ブロック」だけ) | | コース | 大きい見出し | 全部できたら名前の前に ✓。右にプログレスバーと「n / 全部」(課題のチャレンジだけのレッスン表では出さない) | -| レッスン | コースの中の小さい見出し | 「レッスン 1」+ 名前。1 つのレッスンは 3〜4 個のチャレンジ | +| レッスン | コースの中の小さい見出し | 「レッスン 1」+ 名前。1 つのレッスンは 3〜4 個のチャレンジ(「チャットをつくろう」だけは 5 個まで) | | チャレンジ | カード | 1 つ 5 分・3〜5 ブロックで作れる大きさ。チャレンジの ID は一度出したら変えない(記録のキー) | - 最初のコースはブロック › 「きょうからプログラマー」(はじめての人が全員やる)。 レッスン 1「うごかしてみよう」(1〜4)、レッスン 2「えらんで たずねよう」(5〜7)、 レッスン 3「おぼえて つたえよう」(8〜11)。分け方は「覚えること」のまとまり (きっかけと動き・見た目・音/条件と入力/変数・メッセージ・リスト)。 +- 中学 2 年の授業のためのコースはブロック › 「チャットをつくろう」(下の[「チャットをつくろう」](#中-2-のコースチャットをつくろう))。 - レッスンを分け直しても、チャレンジの ID と記録は変えない。記録はチャレンジ ID を主にし、 どのレッスンに属するかは、いまの定義から読みかえる。 @@ -60,8 +61,21 @@ - その下に、コースの見出し → レッスンの見出し → チャレンジのカード。 - **1300×600 で、いまのコース(3 レッスン 11 枚)がスクロールせずに見える**こと。カードを足す・大きく するときはこれを確かめる。 +- **例外: ブロックのコースが 2 つ以上になったら、レッスン表は自分の枠の中で縦にスクロールしてよい**(1300×600 でも)。 + スクロールしてよいのはレッスン表の枠の中だけで、生徒の画面のほかの部分(課題バー・ヒントなど)は、いまのとおり + スクロールせずに使えること。コースが増えると、すべてを 1 画面に収めることはできないため。 - **検索**: チャレンジの名前の部分一致。合うものが無いレッスン・コースは隠す。大文字小文字・全角半角・ カタカナとひらがなは区別しない。 +- **たたみ方(いまのところだけ開く)**: 「チャレンジが多すぎる」と感じてためらわないよう、コースとレッスンの見出しを + 押すと開閉でき、表を開いたときは次の決まりで開き方を決める。はじめての人もチャレンジの量を見わたせ(閉じた行の丸)、 + クラスに参加していないときも次のチャレンジがわかり、できたものもわかるようにするため。 + - 全部できたレッスン → 閉じる(1 行。名前の前に ✓、右に「3 / 3」)。 + - 次のチャレンジがあるレッスン(まだ全部できていない最初のレッスン。「次のチャレンジ」から開いたときはそのレッスン)と、 + その後ろのまだ全部できていないレッスン 1 つ → 開く。 + - それより後ろのレッスン → 閉じる。閉じた行にも、チャレンジの数だけ小さな丸を出す(できた=緑の塗り・次=オレンジ・まだ=白)。 + - コースもたたむ。**いま進めているコースだけ開く**(いちばん最近チャレンジができた、まだ全部できていないコース。 + どれも始めていなければ最初のコース)。たたんだコースは見出しと進み具合のバーだけ。 + - **開閉は覚えない**(表を開くたびに決まりどおり)。**検索中**と、**クラスの課題のチャレンジだけのレッスン表**は全部開く。 - **増えたとき**: 1 ページに縦に並べる(コースが少ないあいだは、いちばん見わたしやすい)。コースが 4 つを 超えたら、帯の 2 段目にコースのボタン(押すとそのコースまでスクロール)を出す。さらに増えたら 「コースのカード → コースのページ」の 2 段階の入口を足す(いまのページがそのままコースのページになる)。 @@ -81,7 +95,8 @@ ## チャレンジ -- **毎回、新しい作品から始める**(前のチャレンジの続きにしない)。 +- **毎回、新しい作品から始める**(前のチャレンジの続きにしない)。例外は「チャットをつくろう」のレッスン 4・5 + (下の[「5 つのレッスン」](#5-つのレッスン))。 - パレットは使うブロックだけ(`allowedBlocks`)。ブロックの初期値は、仕様の表記(`[1 ▼]`・`(3)`)に合わせる。 子どもが作る名前(変数・リスト・メッセージ)の ▼ には初期値を入れない。 - 英語の UI では、子どもが作る名前も英語にする(`count` / `talk` / `hello` など)。判定はどの言語の名前でも通す。 @@ -92,7 +107,7 @@ - 上に課題の 1 行と「何個め / そのレッスンの全部」(レッスンの中の番号)。 - **画面の幅いっぱい**(エディタの列だけでなく、ステージの列の上もおおう)。「ヒント」「ほかのチャレンジへ」は - **画面の右端**に置く。ステージの列(旗・止める・ステージの大きさ)は帯の下に下がり、そのまま押せる。 + **画面の右端**に置く。ステージの列(緑の旗・停止ボタン・ステージの大きさ)は帯の下に下がり、そのまま押せる。 縦が 40px 減る分は、中サイズのステージのスプライトの情報を詰め(`docs/sprite/README.md`)、右下のステージの列の 見出し「ステージ」を出さないで補う(`docs/stage/README.md`)。ステージの列の見出しを消してもステージ(canvas)の 位置は変わらないので、下の resize の決まりには当たらない。 @@ -106,6 +121,10 @@ 「できた!」が出ているときは出さない。 - 課題の文は、読みやすい位置で改行しておく(定義の改行をそのまま出す)。 - 「やめる」とは書かない。前向きな言葉(「ほかのチャレンジへ」)にして、押すとレッスン表を開く。 +- **「ヒント」の左に「ガイド」**(「ヒント」と同じ大きさ。目のアイコンの開いた/閉じたで、出しているか隠しているかを見せる)。押すと画面の部分の名前(タブ(コード・コスチューム・音・ルビー)・ + ブロックパレット・スクリプトエリア・ステージ・緑の旗と停止ボタン・スプライトペイン・背景・課題バー・ヒント)を枠と札で 6 秒ほど重ねて出す + (どこかを押しても消える)。札は画面からはみ出さず、互いに重ならない。レッスン 0 のようにレッスンの設定 + (`showPartNames`)で最初から出しておくこともでき、そのときも操作は邪魔しない(`docs/lessons/README.md` の「名前の札」)。 - **右端に「レッスンをおえる」**(「ほかのチャレンジへ」の右)。「ほかのチャレンジへ」より目立たせない (透明地に白い枠)。押すとレッスンから出て、いまのプログラムを残したまま、ブロックを全部使えるいつもの画面に もどる(レッスン表は開かない・確認は出さない)。レッスンにもどるのはメニューの「レッスン」から。 @@ -119,6 +138,10 @@ 押されたとき」「旗が押されたとき」「このスプライトが押されたとき」「〜を受け取ったとき」など)は、どれも どこかのヒントで置き方を示す。「〜の下に〜をつなげよう」と言う前に、その上のブロックを置くページがあること。 「〜したら〜するプログラムを作ろう」のように 1 ページでまとめるときは、絵に帽子のブロックから描く。 + ただし、最初から入っていて書きかえないスプライトのプログラム(4-4 のシマネコ)は生徒が置かないので除く + (「シマラビ、シマネコの順に押して見よう」と文で案内する。2 つのスプライトのプログラムは吹き出しに入りきらない)。 +- **最初から入っているプログラムの穴は「白いところ」と言わない**。値のブロックがもう入っている穴(4-4 の + 「メッセージを (答え) にする」)は、「(答え) を取り出して、〜をつないで入れよう」のように、取り出す手順から書く。 - **絵は、そのページで置いてほしいブロックを、置いてほしい並びのまま描く**。文言で「〜と〜を入れよう」 「2 組」「上と下に」と言うなら、その全部を、組み立てたときの並び(つながり・入れ子)で描く。一部だけを 描くと、何をいくつ置くかが伝わらない(例: 「繰り返す」の中の「背景を Canyon にする・1 秒待つ・背景を @@ -132,7 +155,16 @@ 答えを入れるなど、課題を試すページ)。できたら吹き出しが閉じるので、そのあとのヒントは見られない。 ブロックの消し方のような「知っておくとよいこと」も、試すページより前に置く。試すページは、ステージ・ キーボード・旗を指す。 -- **チャレンジを始めたら、ヒントの 1 ページ目を自動で開く**(ヒントボタンに気づかない子のため)。 +- **どのチャレンジも、始めたらヒントの 1 ページ目を自動で開く**(ヒントボタンに気づかない子・ヒントを出したまま + 操作してよいとわからない子のため。チャットのコースも同じ)。はじめのレッスン 0 と 1 だけにしたこともあったが、 + どのレッスンでもヒントを出したまま進めるほうがよいので、全部にもどした。じゃまなら「-」で小さくする。 +- **ヒントは閉じずに小さくする**(ヘッダーの「-」)。小さくしたヒントは、課題バーのすぐ下に「ヒント n/N」と短い見出しの + 札として残り、押すと同じページで元の大きさにもどる。子どもはヒントを読んで操作するときに閉じてしまい、手順を + 見失っていた(ヒントを出したまま操作してよいことがわかっていなかった)。札はステージやパレットの操作をじゃましない + 場所に置き、スポットライトは小さくしたら消す。「おわり」とできたときは、今までどおり札も残さず閉じる。 +- **手が止まったら「ヒント」を光らせる**。プログラムもステージも 2 分変わらなければ、「ヒント」(小さくした札も)を + ゆっくり光らせ、「ヒントを見てみよう」と文字で出す。音は出さない(授業中の教室で鳴らさない)。何か操作したら止める。 + 動きを減らす設定のときは光らせず、文字だけ。ヒントを読んでいるあいだと「できた!」のあいだは出さない。 - **ドラッグで動かせる**(じゃまなとき)。画面の外には出さない。 - 最後のページ(うまく動かないときは): - 「プログラムを入れる」とは書かない。**「正解のプログラムを確認する」**にして、押すと @@ -331,3 +363,274 @@ GA で計測する。目的は、**人気のないコンテンツ**と**滞在 - **個人を特定する ID は送らない**。席番号・ニックネーム・セッションも送らない。課題や参加コードの ID も送らない。 送るのはコース・レッスン・チャレンジの ID とページの番号くらいにする。 - イベントの名前と項目は [`README.md`](README.md) の「GA の計測」。 + +## 中 2 のコース「チャットをつくろう」 + +中学 2 年の技術分野「双方向性のあるコンテンツのプログラミングによる問題解決」の授業のためのコース。 +ブロックで、チャットのアプリを作りながら、順次・反復・分岐、データとイベント、メッシュでの通信を学び、 +最後に自分で工夫したチャットを作品として提出する。 + +設計の出発点([EPIC #1616](https://github.com/smalruby/smalruby3-editor/issues/1616)): 授業でワークシートを使ったら、 +スモウルビーの基本操作やメッシュの使い方がわからず、自分の課題解決に進むところで生徒の手が止まった。基本と +メッシュの基本をレッスンで身につけてから、自分の課題解決に進めるようにする。 + +### コースの位置(前提にするもの) + +- **「きょうからプログラマー」を前提にする**。そこで身につくこと(ブロックの置き方・きっかけ・見た目・音・ + 条件と入力・変数・メッセージ・リストの基本)は、このコースでくり返さない。 +- **小学 5 年の算数のコース(図形を描く)を前提にする**。図形(ペン)はこのコースに入れない(別のコースで学ぶ)。 +- このコースで扱うのは、前提のコースで済まないこと: 手順をアクティビティ図で表す・読む、データとイベントの + 組み合わせ、**メッシュの基本**(グループ・合図・共有する変数)、チャットを作って改良すること。 +- 作品の提出に[段 2](#段-2-クラスの課題とレッスン)の仕組みを使うので、このコースは段 2 のあとに出す。 + +### 5 つのレッスン + +| レッスン | 名前 | めあて・あらまし | +|---|---|---| +| 1 | 手順を図にしよう | チャットの題材で、順次・反復・分岐を使い、アクティビティ図を読む・書く。「読んで作る」チャレンジを 1 つ入れる | +| 2 | データとイベント | 乱数・タイマー・分岐を組み合わせる(おみくじ・タイマー・じゃんけんなど) | +| 3 | メッシュでつながろう | メッシュのグループ(ホストになる・参加する)、メッシュの合図、共有する変数 | +| 4 | チャットを作ろう | 1 回送る → くり返し送る → おたがいに送る → グループチャット → ダイレクトメッセージ、と少しずつ育てる | +| 5 | チャットを改良しよう | 改良のテーマを 1 つずつチャレンジにし、生徒は 1 つ以上を選んでやる。最後に自由に工夫して作品を提出する | + +- **チャレンジの中身(課題・パレット・答え・ヒント・判定・アクティビティ図・クイズ)は、レッスンごとに、実装の前に + 人間と artifact で詰める**(「きょうからプログラマー」のレッスン 1 と同じ進め方)。ここには、どのレッスンにも + 共通の決まりだけを書く。 +- **1 つのレッスンのチャレンジは 5 個まで**(このコースだけの例外。ほかのコースは 3〜4 個)。レッスン 4 は 5 段で + 育て、レッスン 5 は改良のテーマが 5 つある。 +- **レッスン 4・5 は、前の段のプログラムを入れた状態で始める**(`setup` で入れる)。生徒はそこに 3〜5 ブロックを足す。 + 1 つのチャレンジを 5 分・3〜5 ブロックの大きさに保ちながら、チャットを少しずつ育てるため。 +- レッスン 3・4 のメッシュのチャレンジは**ペアでやるのが基本**。ひとりのときは練習相手(下)を使う。 +- **チャレンジを変えても、メッシュの接続は保つ**(グループに入り直さない)。チャレンジごとに 2 人で入り直すのは + 授業の時間がかかるため。**確かめた結果、保てる**: チャレンジを開くと新しい作品にするが、メッシュの拡張とその接続は + 作品の読み込みで消えない(VM は作品を捨てても拡張を残す)ので、グループに入ったまま次のチャレンジの合図・共有する + 変数がそのまま届く。ただし、つながったあとに作品を読み込むと、「変数を作る」で作った変数・モニターのスライダーで + 変えた値はすぐには送られない(ブロックで値を変えたときに送られる)。メッシュの拡張の既知のすきまで、別に直す。 +- レッスン 5 の改良のテーマ(パスワード・通知と既読・NG ワード・タイマー・スタンプなど)は、1 つずつチャレンジにし、 + その先は生徒ごとに工夫できるようにする(「できた」の判定は下の[「作品の提出」](#作品の提出))。 +- **レッスン 5 は、テーマを 1 つ以上「できた」にすれば ✓**(全部のテーマをやらなくてよい)。「レッスン 5 ぜんぶ + できた!」・コースの ✓ も、これに従って数える。テーマは生徒が選ぶもので、全部やることを求めないため。 +- プロトコル・IP アドレスなどの知識は、課題の説明やヒントで少しふれ、ふりかえりのクイズ(下)で確かめる。 + 知識だけを教えるページは作らない。 + +### アクティビティ図 + +プログラムをブロックだけでなくアクティビティ図でも表せるようにする。**見る・読んで作る・描く**の 3 つ。 + +- **見る(最初に提示する)**: チャレンジの答えのプログラムから、アクティビティ図を自動で描く。 + - 出すのは**課題の全文**(課題の帯にマウスを乗せたときの全文)と、**ヒントの 1 ページ目**。ヒントのページごとには + 描かない(情報が多すぎるため)。 + - 描くのは SVG。スクリーンショットは使わない([段 1 で入れないもの](#段-1-で入れないもの入れないと決めたもの)と同じ理由で、 + 答えのプログラムから描けば古くならない)。1300×600 で課題の全文の中に収まる大きさにする。 + - 記号は、**教科書のアクティビティ図の記号**(開始・終了・処理・分岐と合流のひし形・送信・受信)にそろえる。 + 生徒は教科書と見くらべるので、ちがう形にすると混乱する。くり返しも教科書と同じく、ひし形の合流と戻る線で描く + (点線の枠は使わない)。**記号の正はここ**で、私たちのワークシートもこの記号を使う(ワークシートは学校ごとに + 変わりうるので、ワークシートに合わせない)。 + - メッシュのチャレンジは、送る人と受け取る人を分けたスイムレーンで描く。 + - **図のもとのデータ**: 自分のレーンは答えのプログラム(`code` と `spriteCodes`)から描く。相手のレーンは、 + 練習相手の定義(ボタン・自動の返事。下の[「メッシュの練習相手」](#メッシュの練習相手))から描く。練習相手の + 定義はデータだけなので、図のための項目を別に足さなくてよい。練習相手の定義が無いチャレンジは、自分のレーンだけを描く。 + - 対応するブロックから始め、対応していないブロックは「処理」の箱にブロック名を書く。 + - 図を出す・出さないは、チャレンジの定義で選べる(読んで作るチャレンジでは必ず出す)。 + - **描き方の決まり**: 帽子のブロックは開始の横の文、「もし」は字の無いひし形から条件に合う枝を左・合わない枝を右に + 分け、枝にガード(「[条件]」「[それ以外]」)を書いて合流でまとめる、くり返しはひし形の合流へ戻る線で描き、 + ぬける枝に回数や条件のガードを書く、「〜を送る」は送信、「〜を受け取ったとき」は受信の記号で、送信から + ほかのスプライト・レーンの受信へ矢印を引く。スプライトが 2 つ以上なら、スプライトごとに名前を + 上に書く。図のもとは答えの Ruby をヒントの絵と同じ変換でブロックにしたもの(定義の項目と細かい描き方は + [README の「アクティビティ図(答えから描く)」](README.md#アクティビティ図答えから描く))。 +- **読んで作る**: チャレンジの 1 つの形(定義の `mode: 'readDiagram'`。形は README の「読んで作るチャレンジ」)。**説明とアクティビティ図だけで指示する**。生徒はやれるだけやってみて、 + 最後に自分のプログラムと答えを見くらべて確かめる。パレットはふつうのチャレンジと同じ。「できた」の判定もほかの + チャレンジと同じ(`uses` / `result`。プログラムの形は見ない)。 + - **ヒントは 3 ページだけ**: ① 図と説明(チャレンジを始めたら自動で開く)→ ② 試すページ → ③ 答えを見るページ。 + 1 ページ目で、最後のページに答えがあることを伝える。 + - **答えを見るページ**は、答えのプログラムを吹き出しの中に本物のブロックで描くだけで、**生徒のプログラムを + 置き換えない**。読んで作るチャレンジには「正解のプログラムを確認する」(置き換え)を置かない。置き換えると、 + そのまま動かすだけで「できた」になり([チャレンジ](#チャレンジ)の判定の決まり)、自分で読んで作る意味が + なくなるため。答えを描くのは、いまのヒントの絵(`steps[].blocks`)と同じ描き方なので、新しい画面は要らない。 + - [ヒント](#ヒント)の決まりとの関係: + - **そのまま当てはめる**: 1 ページ目を自動で開く。試すページは答えのページの手前(答えを見る前に試してもらう)。 + ドラッグで動かせる・できたら閉じる。 + - **当てはめない(例外)**: 帽子のブロックを置く手順を抜かさない・絵は置いてほしいブロックを並びのまま描く・ + つなげる相手もいっしょに描く。どれも手順のページの決まりで、読んで作るチャレンジは手順のページを持たない + (図を読んで自分で組み立てるのがねらいのため)。 + - 答えを見るページの絵は、スクリプト全体を描いてよい(「描くのは相手と置くブロックまで」の例外)。答えと + 見くらべるには全体が要るため。 +- **描く**: ブロックを右クリック →「アクティビティ図」で、そのスクリプトの図をポップアップに描く。見るための + 描く部品を使う。ポップアップはモーダルにせず、動かせる・閉じられるパネルにして、ブロックを変えると図も描き直す + (ブロックと図を見くらべながら直せるように)。形は README の「アクティビティ図(ブロックを右クリックして描く)」。 + +### ペアの役 + +ペアでやるチャレンジは、2 人が同じ形のプログラムを**名前を入れかえて**作る(シマラビの役とシマネコの役)。 + +- **役を選ぶと、画面がその役の名前で出る(鏡の形)**。課題・ヒント・ブロックの絵・答え・最初から入っているプログラム・ + 図・練習相手を、シマラビ ↔ シマネコを入れかえた形で出す。生徒が頭の中で入れかえなくてよい。相手のレーンは + 「相手の人間も、自分と同じ形(名前ちがい)を作っている」と読める。 +- **みんな同じ名前を使う段は入れかえない**(3-2・4-4・4-5)。名前をそろえることがその段の学び。 +- **役はチャレンジごとに選ぶが、前回選んだ役を覚えて最初から選んでおく**(「前回はシマネコの役」と出す)。生徒はチャレンジを + 順番にやるとはかぎらないので、どの順でも同じに決まるようにする(覚えている役といまのつながりだけで決める)。 +- **クラスでは出席番号で既定を決める**: 出席番号のペアの小さい人がシマラビの役(変えられる)。ひとりのときは選ばずに + シマラビの役。 +- **判定は変えない**: 両方の役の名前を通す(締めない)。 +- 役を変えたら、その役で始めなおす(最初のプログラムの名前と、練習相手の変数の名前が役で変わるため)。作品を変えて + いれば確かめを出す。覚えるのは生徒が自分で選んだ役だけ。 + +### メッシュの練習相手 + +メッシュのチャレンジを**ひとりでも**できるようにする。ペアがいるときは本物のメッシュでやるのが基本。 + +- **ブラウザの中で折り返す「にせのメッシュの相手」**。メッシュの送受信をサーバーに出さずにブラウザの中で折り返す + 練習のモードで、相手を 1 人ぶん置く。ローカルで動き、レッスンに特化した軽いものにする。 +- チャレンジ中、ステージの横に小さな**練習相手のパネル**を出す。枠と見出しで 2 つに分ける: + 「〈相手〉から送る」はボタン(2〜3 個)で、押すと相手がメッシュで合図を送った・共有する変数を変えたのと同じことが起きる。 + 「〈相手〉に届いた」は生徒の作品から相手に届いたもの(新しいものから 3 行・届いた行は 1 秒ほど光る)。**1300×600 では、コードエリアの右上 + (ステージの列のすぐ左)に重ねて出す**。ステージの列の下(スプライトの情報)はヒントが指すので隠さない。ステージの + 列は動かさないので、[課題バー](#課題バー)の `resize` の決まりには当たらない。 +- 本物のメッシュでつながっている・つなごうとしているあいだは、練習相手は出さず、何もしない(本物のメッシュに混ぜない)。 + つながるとパネルは閉じる。 +- **自動の返事**: 「合図 X を受け取ったら Y を送り返す」のような簡単な決まりで、相手が返事をする。 +- **定義はデータだけ**。チャレンジの定義に相手の名前・ボタン・自動の返事を書けば動き、チャレンジごとにコードを + 書かない(チャレンジごとに作り込まない)。 + - 定義の形: `partner: { name, buttons: [{ label, set, broadcast }], replies: [{ onBroadcast, set, broadcast }] }`。 + `name` = 相手の名前、`buttons` = パネルのボタン(`label` = ボタンの文字)、`replies` = 自動の返事(`onBroadcast` = + 受け取る合図の名前)。`set` = 共有する変数を変える `{ variable, value }`(複数なら配列)、`broadcast` = 送る合図の名前。 + ボタンを押したとき・合図を受け取ったときに、`set` → `broadcast` の順に起きる。 + アクティビティ図の相手のレーンもこの形から描く([アクティビティ図](#アクティビティ図))。 +- 「できた」の判定は、本物のメッシュと同じ事実として数える(判定のしくみは変えない)。 + - **メッシュで届いた合図は、`goal` の `sentBy: 'other'` で見分けない**。本物のメッシュでも練習相手でも、届いた合図の + 送り手は記録されず、受け取ったスクリプトの送り手は「その名前の合図を最後に作品の中で送ったスプライト」になる。 + 生徒が同じ名前の合図を自分でも送っていると `sentBy: 'other'` が当たってしまうので、メッシュの合図を受け取る + スクリプトの条件には `sentBy` を使わない(`message` と `uses` / `result` で見る)。 +- パネルを閉じれば、同じチャレンジを本物のメッシュ(ペア)でできる。 +- 作らないもの: サーバーにいる相手(ボット)、AI の返事、2 台目のスモウルビーを丸ごと動かす仕組み。 +- メッシュはいちばん大事な機能なので、練習のモードを足すときはメッシュのデグレの確認をする。 + +### ふりかえりのクイズ + +- チャレンジができたときの**「できた!」の表示の中**に、**3 択のクイズ**を出せるようにする(「レッスン n ぜんぶできた!」 + 「課題クリア!」の表示でも同じ)。チャレンジの定義に問い・3 つの選択肢・正解・解説を書くだけで出る。 + 文言は en / ja / ja-Hira。 +- ヒントの中には置かない。「できた」になるとヒントの吹き出しは閉じる([ヒント](#ヒント))ので、ヒントの中に置くと、 + 自分でできた生徒ほどクイズを見ない。「できた!」の中に出せば、できた生徒の全員が見る。 +- 選ぶと、正解/はずれと解説を出す。**何度でも選び直せる**。 +- **「できた」の判定には入れない**(できたあとに出るので、答えは「できた」に関係しない)。答えなくても「次のチャレンジへ」 + などのボタンで先へ進める。 +- 選んだ選択肢に ○ / × を付け、「正解!」/「はずれ。もう一度選んでみよう」と解説を出す。解説は正解でもはずれでも出す + (はずれのあと解説を読んで選び直せばよい。クイズは確かめるためのもので、試験ではないため)。選んだものは記録しない。 +- 選択肢の並びは定義のまま(混ぜない)。授業で「2 番は〜」と話せるようにするため。 +- 1300×600 で、解説まで出しても画面に収まる大きさにする。文言の目安は問い 2 行・選択肢 1 行・解説 3 行。 +- **クイズを見られるのは、その「できた!」が出ているあいだだけ**。 + - 「もう少し見る」は、生徒がはっきり閉じる操作。閉じたら、そのチャレンジではクイズをもう出さない(もう一度 + 「できた」にすれば出る)。閉じるまでに生徒はクイズを見ているので、Q14 の「できた生徒は全員見る」は保たれる。 + - **課題バーの全文をタップで開いても、クイズのある「できた!」は閉じない**。全文を開いているあいだだけ隠し、 + 全文を閉じたら出し直す(選んだ答えもそのまま)。全文を見たいだけで、クイズを閉じるつもりはないため。 + 同時に出すと全文と「できた!」が重なるので、重ねずに隠す形にした。クイズの無い「できた!」は、これまでどおり閉じる。 +- 読み上げ(スクリーンリーダー): 3 つから 1 つを選ぶので radiogroup / radio にする。結果の文の前に選んだ番号を付け + (「3: はずれ…」)、はずれを続けて選んでも読み上げられるようにする。live region は「できた!」の 1 つだけにする。 +- 定義の形(`quiz` の項目・文言の id・`challengeQuiz`)と画面の部品は README の「チャレンジ」と「ふりかえりのクイズ」。 + +### ワークシートとのリンク(片方向) + +- **ワークシートからスモウルビーへリンクする**。ワークシートの各ページに、やるレッスン・チャレンジの名前とリンクを書く。 + ワークシートの前半に当たる基本をレッスンで終えてから、自分の課題解決のページに進む流れにする。 +- **スモウルビーからワークシートへはリンクしない**。ワークシートは学校ごとに変わるため。コースの定義にワークシートの + URL や名前を持たない。生徒にワークシートを示したいときは、先生がクラスの課題の説明に書く。 +- **リンクの書き方**: レッスンを URL で直接開く道は作っていない(URL パラメータは作らない。README の「レッスン表」)。 + そのため、ワークシートには「スモウルビー(https://smalruby.app)のメニューの『レッスン』→ コース名 → レッスン名」の + 道順と、やるレッスン・チャレンジの番号を書く。先生がレッスンを紐付けたクラスの課題を作っていれば、生徒はクラスの + 画面からも同じレッスンに入れる(ワークシートには両方の道を書かず、メニューの道だけを書く)。 +- **私たちのワークシートとの対応**(中 2「双方向性のあるコンテンツ」8 時間・12 ページの例。学校ごとに変えてよい): + + | ワークシート | 時間 | やるレッスン | + |---|---|---| + | 2 ページ(画面の名前・練習) | 第 1 時 | 「きょうからプログラマー」から 3 つ(前提のコースの復習) | + | 3 ページ(入力と応答) | 第 2 時 | レッスン 1「手順を図にしよう」→ レッスン 2「データとイベント」。乱数・タイマーは、ブロックの絵と 1〜2 行の説明だけ | + | 4 ページ(メッセージ) | 第 3 時 | レッスン 3 の 3-1(同じコンピューターの中のメッセージ) | + | 5 ページ(メッシュ) | 第 4 時 | レッスン 3 の 3-2・3-3 → レッスン 4「チャットを作ろう」(ペア。ひとりなら練習相手) | + | 6 ページ(改良の例・作りたい機能) | 第 5 時 | レッスン 5「チャットを改良しよう」のテーマから 1 つ以上。改良の例はレッスン 5 のテーマにそろえる | + | 7・8 ページ(制作工程表・制作) | 第 6・7 時 | レッスン 5 で最後にやったテーマのプログラムから作り、クラスの課題から作品を提出する | + + 授業で手が止まった 6 ページ(自分の課題解決)より前に、レッスン 1〜4 を終えている流れにする。各ページには + 「▶ レッスンで練習しよう」の帯と「終わった □」を置き、0 ページ(8 時間の流れ)にも「第 6 時までにレッスン 1〜4 を + 終える」と書く。 + ワークシートの名前はコースの名前(「チャットをつくろう」)とレッスンの名前(「手順を図にしよう」「データとイベント」 + 「メッシュでつながろう」「チャットを作ろう」「チャットを改良しよう」)をそのまま使い、チャレンジは「3-1」のように + レッスンの中の番号で指す。レッスンの名前を変えたら、ワークシートも直す。 + この対応は、標準課題 `jhs-tech-d2-chat`(`docs/standard-assignments/`)の各課題の `lessons` にも同じ形で入っている。 + +### 作品の提出 + +- **段 2 の「作品の提出もする」課題の仕組みで出す**。このコースのための提出の仕組みは作らない。 +- 先生はレッスン 5(とそれまでのレッスン)を紐付けた課題を作り、「作品の提出もする」を ON にする。課題クリアの + あと、「課題クリア!」・課題の帯・クラスの画面の案内(自由にプログラムを作って提出しよう)から提出する + ([課題クリア](#課題クリア))。 +- 改良のテーマのチャレンジは、それぞれ最低限を学ぶところまでを「できた」の判定にする。その先の工夫は判定せず、 + 提出した作品で先生が見る。 + +## はじめの一歩(レッスン 0 と、手が止まったときの助け) + +小学 4〜6 年の授業(説明なし・40 分)で、「きょうからプログラマー」の手が止まる子が何人もいた。止まる場所は +ばらばらで、画面の部分の名前(「音タブ」など)が通じない子、ヒントを読んで操作するときにヒントを閉じてしまう子が +いた。そこで、レッスンの前に画面の部分の名前とレッスンの進め方を覚える場所を作る。 + +- **レッスン 0「スモウルビーをたんけんしよう」**を「きょうからプログラマー」の最初に置く。8 チャレンジ・約 12〜15 分。 + 画面の部分の 9 つの名前(タブ・ブロックパレット・スクリプトエリア・ステージ・緑の旗と停止ボタン・スプライトペイン・背景・ + 課題バー・ヒント)を、1 チャレンジで 1〜2 個ずつさわって覚える。最後は画面の部分をクリックして答えるクイズ。 + コースの 11 個の数(課題・進みぐあい)は変えず、レッスン 0 は別に数える。 +- **ヒントの文の呼び方は、この 9 つの名前にそろえる**。英語の名前の音・背景・スプライトは + 「『Owl』という名前の音」のように説明する(英語の名前だけでは何のことか分からない)。 +- **レッスン 1 の 1 個めは、はじめての操作を少なくする**(音タブを使わない)。 +- **どのチャレンジもヒントを自動で開く**。ヒントは閉じずに**小さくする**ことができ、いつでも元に戻せる + (上の[ヒント](#ヒント))。 +- **2 分変化がなければ「ヒント」を光らせる**(音は出さない。上の[ヒント](#ヒント))。 +- **「ガイド」ボタン**で、画面の部分の名前を重ねて出せる(レッスン 0 は最初から出す)。 +- 先生用に「スモウルビーの地図」(A4 横・CC0)と、最初の 5 分の台本(A4 縦)を標準課題「はじめの一歩」 + (`assignments/es-pg-kyou-kara-programmer-01-first-step/` の `map.pdf` / `script.pdf`。`docs/standard-assignments/README.md`)に置く。 + 地図は実際の画面(課題バーが出ているレッスンの画面・ヒントを小さくしたところ)の写真に、9 つの名前を番号と線で書きこみ、 + 下に「こまったら ヒント → 進める」「ヒントは小さくできる(-)。消えないので、おすと元にもどる」を書く。名前の呼び方は + ヒントの文・「ガイド」の札と同じ。台本はプロジェクターで ①地図 ②ネコをつかんで動かす ③ブロックパレットのブロックを押す + ④ヒントを開いて「進める」・「-」で小さくして続ける をやって見せ、レッスン 0 へ進む。 + +### レッスン 0 の形 + +- **数えないレッスン**: レッスン 0 はレッスンに `warmup: true` の印を付け、コースの `lessons`(数えるレッスン)から外して + `warmupLessons` に置く。コースの数を使う所(レッスン表のバーと「n / 11」・コースの ✓・クラス管理の課題に選べるチャレンジ・ + 課題の「全部」の条件・先生の進みぐあいの表・ウェルカムの案内)は `lessons` だけを見るので、どれも 11 のまま変わらない。 + 1 つずつ「レッスン 0 を除く」を書き足すと、どれかを忘れたときに課題の中身や数が変わってしまうため、数える側を変えない形にした。 + レッスン表と「次のレッスン」はレッスン 0 をふくむ並び(`courseLessons`)を見る。 +- **はじめの入口**: レッスン表ではレッスン 0 が最初に「レッスン 0」として出る。ウェルカムの「レッスンを始める」は、まだ何も + できていなければレッスン 0 の最初のチャレンジに「次はこれ!」を付ける。前からレッスン 1 を進めている人は、続きのチャレンジを + 案内する(レッスン 0 にもどさない)。レッスン 0 が全部できたら「ほかのレッスンへ」でレッスン 1 へ進む。 +- **部分の名前は Scratch Wiki の名前**(ここが決まりの正): 課題・ヒント・つまずき・「ガイド」の札・クイズ・先生用の地図と台本は、 + Scratch Wiki「Scratchユーザーインターフェース (3.0)」に書いてある名前で書く。一次情報の名前にそろえ、ほかの教材と同じ + 呼び方にするため。**Wiki に無いもの(課題バー・ヒント・ルビータブ・背景)はスモウルビー独自**に決める。 + + | 部分 | ja | ja-Hira | en | + |---|---|---|---| + | タブ(コード・コスチューム・音・**ルビー**) | コードタブ・コスチュームタブ・音タブ・ルビータブ | コードタブ・コスチュームタブ・おとタブ・ルビータブ | Code tab・Costumes tab・Sounds tab・Ruby tab | + | ブロックの一覧(左のカテゴリの列もふくむ) | ブロックパレット | ブロックパレット | Block Palette | + | ブロックを組み立てるところ | スクリプトエリア | スクリプトエリア | Code Area | + | ステージ | ステージ | ステージ | Stage | + | 旗・止める | 緑の旗・停止ボタン | みどりのはた・ていしボタン | Green Flag・Stop Button | + | スプライトの一覧 | スプライトペイン | スプライトペイン | Sprite Pane | + | 背景(独自) | 背景 | はいけい | Backdrop | + | 課題バー・ヒント(独自) | 課題バー・ヒント | かだいバー・ヒント | Task bar・Hint | + + コスチュームタブはそのまま(「ペイントタブ」は昔の呼び名なので使わない)。ブロックの名前(「旗が押されたとき」など)は + ブロックの文字・アクティビティ図に合わせてそのまま書く(部分の名前ではないため)。「チャットをつくろう」は色の言葉を書かない + 決まりがあるが、「緑の旗」は部分の名前なので使ってよい(`courses.test.js` が除いて数える)。 +- **パレットはしぼらない**: レッスン 0 は画面の部分と操作を覚えるので、どのブロックも出しておく(ふだんの画面と同じ)。 +- **判定は結果で見る**: 位置が変わった・ブロックパレットで押して動いた・くっつけた 2 つが 1 回で動いた・2 つめの絵になって + いまコードタブにいる・スプライトが増えて背景が変わった、のように結果を見る。タブを開いた・ボタンを押したこと自体は数えない + (開いただけで「できた」にすると、何を覚えたかが分からない)。音の再生は判定しない(音の出ない教室がある)。 +- **操作する相手を最初から置いておく**: 0-5「数と ▼ を変えよう」は、数を変える「15 度回す」と ▼ を変える「マウスのポインターへ + 行く」を旗のスクリプトに置いて始め、ヒント 1 はその数、ヒント 2 はその ▼ を指す(ヒントが置いていないブロックを指すと、 + 子どもはどこを押せばよいかわからない。「歩動かす」には ▼ で選ぶ相手が無い)。判定も 2 つとも変えて動いたこと。 + 0-6「タブをめぐろう」は、絵が 2 つあるシマラビ(スモウルビーの公式キャラクター)で始め、操作は「2 つめの絵をえらぶ」だけに + する(スモウルビーのネコは絵が 1 つで、絵を足す操作が要った)。シマラビは 0-6 だけで使う(ほかのレッスン 0 と レッスン 1 は + ネコで書いていて、レッスン 0 の終わりからそのままレッスン 1 のネコへつながるため)。シマラビの音は「Chirp」なので、 + 英語の名前は「「Chirp」という名前の音」と書く。 +- **ふりかえりは画面をクリックして答える**: 最後の 0-8 は 3 択のクイズではなく、「ブロックパレットはどこ?」と聞いて画面の部分を + クリックして答える(名前と場所を結びつけるのが目的のため)。まちがえたら正しい場所を数秒光らせて、もう一度答える + (まちがえても先へ進めなくならない)。クイズのあいだはクリックを下の部品に届けない(答えるたびにタブやブロックが動くと混乱する)。 + diff --git a/docs/lessons/screenshots/0104-completed-toast-quiz-1300x600.png b/docs/lessons/screenshots/0104-completed-toast-quiz-1300x600.png new file mode 100644 index 00000000000..c58d4710805 Binary files /dev/null and b/docs/lessons/screenshots/0104-completed-toast-quiz-1300x600.png differ diff --git a/docs/lessons/screenshots/0105-completed-toast-quiz-wrong-1300x600.png b/docs/lessons/screenshots/0105-completed-toast-quiz-wrong-1300x600.png new file mode 100644 index 00000000000..77e046169e6 Binary files /dev/null and b/docs/lessons/screenshots/0105-completed-toast-quiz-wrong-1300x600.png differ diff --git a/docs/lessons/screenshots/0106-completed-toast-quiz-lesson-correct-1300x600.png b/docs/lessons/screenshots/0106-completed-toast-quiz-lesson-correct-1300x600.png new file mode 100644 index 00000000000..33023fef996 Binary files /dev/null and b/docs/lessons/screenshots/0106-completed-toast-quiz-lesson-correct-1300x600.png differ diff --git a/docs/lessons/screenshots/0201-lesson-mode-1300x600.png b/docs/lessons/screenshots/0201-lesson-mode-1300x600.png index e6c14399c16..8911ac70739 100644 Binary files a/docs/lessons/screenshots/0201-lesson-mode-1300x600.png and b/docs/lessons/screenshots/0201-lesson-mode-1300x600.png differ diff --git a/docs/lessons/screenshots/0207-lesson-task-full-text-activity-diagram-1300x600.png b/docs/lessons/screenshots/0207-lesson-task-full-text-activity-diagram-1300x600.png new file mode 100644 index 00000000000..5f36fdad24e Binary files /dev/null and b/docs/lessons/screenshots/0207-lesson-task-full-text-activity-diagram-1300x600.png differ diff --git a/docs/lessons/screenshots/0208-lesson-task-full-text-activity-diagram-swimlane-1300x600.png b/docs/lessons/screenshots/0208-lesson-task-full-text-activity-diagram-swimlane-1300x600.png new file mode 100644 index 00000000000..f38ba83c4b0 Binary files /dev/null and b/docs/lessons/screenshots/0208-lesson-task-full-text-activity-diagram-swimlane-1300x600.png differ diff --git a/docs/lessons/screenshots/0209-lesson-task-full-text-activity-diagram-too-tall-1300x600.png b/docs/lessons/screenshots/0209-lesson-task-full-text-activity-diagram-too-tall-1300x600.png new file mode 100644 index 00000000000..77b9ee786fb Binary files /dev/null and b/docs/lessons/screenshots/0209-lesson-task-full-text-activity-diagram-too-tall-1300x600.png differ diff --git a/docs/lessons/screenshots/0210-lesson-task-full-text-read-diagram-1300x600.png b/docs/lessons/screenshots/0210-lesson-task-full-text-read-diagram-1300x600.png new file mode 100644 index 00000000000..572e5d85a8f Binary files /dev/null and b/docs/lessons/screenshots/0210-lesson-task-full-text-read-diagram-1300x600.png differ diff --git a/docs/lessons/screenshots/0211-editor-map-1300x600.png b/docs/lessons/screenshots/0211-editor-map-1300x600.png new file mode 100644 index 00000000000..ba499847ff2 Binary files /dev/null and b/docs/lessons/screenshots/0211-editor-map-1300x600.png differ diff --git a/docs/lessons/screenshots/0302-lessons-library-1300x600.png b/docs/lessons/screenshots/0302-lessons-library-1300x600.png index 449fceb4336..f8873e4eb54 100644 Binary files a/docs/lessons/screenshots/0302-lessons-library-1300x600.png and b/docs/lessons/screenshots/0302-lessons-library-1300x600.png differ diff --git a/docs/lessons/screenshots/0303-lessons-library-375x667.png b/docs/lessons/screenshots/0303-lessons-library-375x667.png index 311fcd2732e..9be917955ce 100644 Binary files a/docs/lessons/screenshots/0303-lessons-library-375x667.png and b/docs/lessons/screenshots/0303-lessons-library-375x667.png differ diff --git a/docs/lessons/screenshots/0304-lessons-library-cleared-1300x600.png b/docs/lessons/screenshots/0304-lessons-library-cleared-1300x600.png index db349f47098..2fb7eb1fa65 100644 Binary files a/docs/lessons/screenshots/0304-lessons-library-cleared-1300x600.png and b/docs/lessons/screenshots/0304-lessons-library-cleared-1300x600.png differ diff --git a/docs/lessons/screenshots/0305-lessons-library-next-1300x600.png b/docs/lessons/screenshots/0305-lessons-library-next-1300x600.png index a8879ae0901..0964ea4e62e 100644 Binary files a/docs/lessons/screenshots/0305-lessons-library-next-1300x600.png and b/docs/lessons/screenshots/0305-lessons-library-next-1300x600.png differ diff --git a/docs/lessons/screenshots/0306-lessons-library-667x375.png b/docs/lessons/screenshots/0306-lessons-library-667x375.png index 16bca848c8a..4def572feba 100644 Binary files a/docs/lessons/screenshots/0306-lessons-library-667x375.png and b/docs/lessons/screenshots/0306-lessons-library-667x375.png differ diff --git a/docs/lessons/screenshots/0307-lessons-library-search-1300x600.png b/docs/lessons/screenshots/0307-lessons-library-search-1300x600.png index 4bb9e33ae86..a125009c66d 100644 Binary files a/docs/lessons/screenshots/0307-lessons-library-search-1300x600.png and b/docs/lessons/screenshots/0307-lessons-library-search-1300x600.png differ diff --git a/docs/lessons/screenshots/0401-lesson-hint-1300x600.png b/docs/lessons/screenshots/0401-lesson-hint-1300x600.png index ee3458a2101..036f88bb9c6 100644 Binary files a/docs/lessons/screenshots/0401-lesson-hint-1300x600.png and b/docs/lessons/screenshots/0401-lesson-hint-1300x600.png differ diff --git a/docs/lessons/screenshots/0402-lesson-hint-667x375.png b/docs/lessons/screenshots/0402-lesson-hint-667x375.png index 16bc8a86f62..9d9ae3b2ce2 100644 Binary files a/docs/lessons/screenshots/0402-lesson-hint-667x375.png and b/docs/lessons/screenshots/0402-lesson-hint-667x375.png differ diff --git a/docs/lessons/screenshots/0403-lesson-hint-375x667.png b/docs/lessons/screenshots/0403-lesson-hint-375x667.png index 527bfc50a0b..f3494583382 100644 Binary files a/docs/lessons/screenshots/0403-lesson-hint-375x667.png and b/docs/lessons/screenshots/0403-lesson-hint-375x667.png differ diff --git a/docs/lessons/screenshots/0404-lesson-hint-last-resort-1300x600.png b/docs/lessons/screenshots/0404-lesson-hint-last-resort-1300x600.png index 85e372ab5d0..469fbf0b6bd 100644 Binary files a/docs/lessons/screenshots/0404-lesson-hint-last-resort-1300x600.png and b/docs/lessons/screenshots/0404-lesson-hint-last-resort-1300x600.png differ diff --git a/docs/lessons/screenshots/0405-lesson-hint-check-answer-confirm-1300x600.png b/docs/lessons/screenshots/0405-lesson-hint-check-answer-confirm-1300x600.png index 03c1acfb191..cdd9c80713c 100644 Binary files a/docs/lessons/screenshots/0405-lesson-hint-check-answer-confirm-1300x600.png and b/docs/lessons/screenshots/0405-lesson-hint-check-answer-confirm-1300x600.png differ diff --git a/docs/lessons/screenshots/0406-lesson-hint-auto-open-1300x600.png b/docs/lessons/screenshots/0406-lesson-hint-auto-open-1300x600.png index cc81975e5b1..06cca78226f 100644 Binary files a/docs/lessons/screenshots/0406-lesson-hint-auto-open-1300x600.png and b/docs/lessons/screenshots/0406-lesson-hint-auto-open-1300x600.png differ diff --git a/docs/lessons/screenshots/0407-lesson-hint-dragged-667x375.png b/docs/lessons/screenshots/0407-lesson-hint-dragged-667x375.png index c31c984821c..ca985bfdc85 100644 Binary files a/docs/lessons/screenshots/0407-lesson-hint-dragged-667x375.png and b/docs/lessons/screenshots/0407-lesson-hint-dragged-667x375.png differ diff --git a/docs/lessons/screenshots/0408-lesson-hint-auto-open-375x667.png b/docs/lessons/screenshots/0408-lesson-hint-auto-open-375x667.png index 08f25260ef0..3de0851af3f 100644 Binary files a/docs/lessons/screenshots/0408-lesson-hint-auto-open-375x667.png and b/docs/lessons/screenshots/0408-lesson-hint-auto-open-375x667.png differ diff --git a/docs/lessons/screenshots/0409-lesson-hint-activity-diagram-1300x600.png b/docs/lessons/screenshots/0409-lesson-hint-activity-diagram-1300x600.png new file mode 100644 index 00000000000..c8012d710a1 Binary files /dev/null and b/docs/lessons/screenshots/0409-lesson-hint-activity-diagram-1300x600.png differ diff --git a/docs/lessons/screenshots/0410-lesson-hint-activity-diagram-scroll-1300x600.png b/docs/lessons/screenshots/0410-lesson-hint-activity-diagram-scroll-1300x600.png new file mode 100644 index 00000000000..728104663aa Binary files /dev/null and b/docs/lessons/screenshots/0410-lesson-hint-activity-diagram-scroll-1300x600.png differ diff --git a/docs/lessons/screenshots/0411-lesson-hint-read-diagram-page1-1300x600.png b/docs/lessons/screenshots/0411-lesson-hint-read-diagram-page1-1300x600.png new file mode 100644 index 00000000000..b7c1e194a92 Binary files /dev/null and b/docs/lessons/screenshots/0411-lesson-hint-read-diagram-page1-1300x600.png differ diff --git a/docs/lessons/screenshots/0412-lesson-hint-read-diagram-page2-1300x600.png b/docs/lessons/screenshots/0412-lesson-hint-read-diagram-page2-1300x600.png new file mode 100644 index 00000000000..bd2a53311c7 Binary files /dev/null and b/docs/lessons/screenshots/0412-lesson-hint-read-diagram-page2-1300x600.png differ diff --git a/docs/lessons/screenshots/0413-lesson-hint-read-diagram-answer-1300x600.png b/docs/lessons/screenshots/0413-lesson-hint-read-diagram-answer-1300x600.png new file mode 100644 index 00000000000..50bbfc7e9e6 Binary files /dev/null and b/docs/lessons/screenshots/0413-lesson-hint-read-diagram-answer-1300x600.png differ diff --git a/docs/lessons/screenshots/0414-lesson-hint-minimized-1300x600.png b/docs/lessons/screenshots/0414-lesson-hint-minimized-1300x600.png new file mode 100644 index 00000000000..7d097555fd5 Binary files /dev/null and b/docs/lessons/screenshots/0414-lesson-hint-minimized-1300x600.png differ diff --git a/docs/lessons/screenshots/0415-lesson-hint-minimized-844x390.png b/docs/lessons/screenshots/0415-lesson-hint-minimized-844x390.png new file mode 100644 index 00000000000..5f489c8caf8 Binary files /dev/null and b/docs/lessons/screenshots/0415-lesson-hint-minimized-844x390.png differ diff --git a/docs/lessons/screenshots/0416-lesson-hint-nudge-1300x600.png b/docs/lessons/screenshots/0416-lesson-hint-nudge-1300x600.png new file mode 100644 index 00000000000..da6c0ca7270 Binary files /dev/null and b/docs/lessons/screenshots/0416-lesson-hint-nudge-1300x600.png differ diff --git a/docs/lessons/screenshots/0417-lesson-hint-nudge-reduced-motion-1300x600.png b/docs/lessons/screenshots/0417-lesson-hint-nudge-reduced-motion-1300x600.png new file mode 100644 index 00000000000..968c120835f Binary files /dev/null and b/docs/lessons/screenshots/0417-lesson-hint-nudge-reduced-motion-1300x600.png differ diff --git a/docs/lessons/screenshots/0501-challenge1-key-sound-hint1-1300x600.png b/docs/lessons/screenshots/0501-challenge1-key-sound-hint1-1300x600.png index d7e223214ee..e5c7cb9de43 100644 Binary files a/docs/lessons/screenshots/0501-challenge1-key-sound-hint1-1300x600.png and b/docs/lessons/screenshots/0501-challenge1-key-sound-hint1-1300x600.png differ diff --git a/docs/lessons/screenshots/0502-challenge2-arrow-move-hint1-1300x600.png b/docs/lessons/screenshots/0502-challenge2-arrow-move-hint1-1300x600.png index 2b92bd686f0..4ba83f7b7e9 100644 Binary files a/docs/lessons/screenshots/0502-challenge2-arrow-move-hint1-1300x600.png and b/docs/lessons/screenshots/0502-challenge2-arrow-move-hint1-1300x600.png differ diff --git a/docs/lessons/screenshots/0503-challenge3-click-say-hint1-1300x600.png b/docs/lessons/screenshots/0503-challenge3-click-say-hint1-1300x600.png index 8229b1362bf..dc55c3ea112 100644 Binary files a/docs/lessons/screenshots/0503-challenge3-click-say-hint1-1300x600.png and b/docs/lessons/screenshots/0503-challenge3-click-say-hint1-1300x600.png differ diff --git a/docs/lessons/screenshots/0504-challenge4-repeat-hint1-1300x600.png b/docs/lessons/screenshots/0504-challenge4-repeat-hint1-1300x600.png index 9b9c6e7faa0..208c4eb3b58 100644 Binary files a/docs/lessons/screenshots/0504-challenge4-repeat-hint1-1300x600.png and b/docs/lessons/screenshots/0504-challenge4-repeat-hint1-1300x600.png differ diff --git a/docs/lessons/screenshots/0505-challenge5-if-hint1-1300x600.png b/docs/lessons/screenshots/0505-challenge5-if-hint1-1300x600.png index edc209c2095..56feaad4e42 100644 Binary files a/docs/lessons/screenshots/0505-challenge5-if-hint1-1300x600.png and b/docs/lessons/screenshots/0505-challenge5-if-hint1-1300x600.png differ diff --git a/docs/lessons/screenshots/0506-challenge6-ask-answer-hint1-1300x600.png b/docs/lessons/screenshots/0506-challenge6-ask-answer-hint1-1300x600.png index 6f8a43c839a..e491b142d99 100644 Binary files a/docs/lessons/screenshots/0506-challenge6-ask-answer-hint1-1300x600.png and b/docs/lessons/screenshots/0506-challenge6-ask-answer-hint1-1300x600.png differ diff --git a/docs/lessons/screenshots/0507-challenge7-quiz-hint1-1300x600.png b/docs/lessons/screenshots/0507-challenge7-quiz-hint1-1300x600.png index 33a2ff124c7..b72fd41bab4 100644 Binary files a/docs/lessons/screenshots/0507-challenge7-quiz-hint1-1300x600.png and b/docs/lessons/screenshots/0507-challenge7-quiz-hint1-1300x600.png differ diff --git a/docs/lessons/screenshots/0508-challenge8-count-hint1-1300x600.png b/docs/lessons/screenshots/0508-challenge8-count-hint1-1300x600.png index d830f2dd925..2d321149262 100644 Binary files a/docs/lessons/screenshots/0508-challenge8-count-hint1-1300x600.png and b/docs/lessons/screenshots/0508-challenge8-count-hint1-1300x600.png differ diff --git a/docs/lessons/screenshots/0509-challenge9-hint-1300x600.png b/docs/lessons/screenshots/0509-challenge9-hint-1300x600.png index 0174f741b10..3d574d8ec75 100644 Binary files a/docs/lessons/screenshots/0509-challenge9-hint-1300x600.png and b/docs/lessons/screenshots/0509-challenge9-hint-1300x600.png differ diff --git a/docs/lessons/screenshots/0510-challenge10-hint-1300x600.png b/docs/lessons/screenshots/0510-challenge10-hint-1300x600.png index b5a9003c5be..37b3d14f58b 100644 Binary files a/docs/lessons/screenshots/0510-challenge10-hint-1300x600.png and b/docs/lessons/screenshots/0510-challenge10-hint-1300x600.png differ diff --git a/docs/lessons/screenshots/0511-challenge11-hint-1300x600.png b/docs/lessons/screenshots/0511-challenge11-hint-1300x600.png index debd50ad213..485d7d54c71 100644 Binary files a/docs/lessons/screenshots/0511-challenge11-hint-1300x600.png and b/docs/lessons/screenshots/0511-challenge11-hint-1300x600.png differ diff --git a/docs/lessons/screenshots/0514-challenge4-repeat-hint3-1300x600.png b/docs/lessons/screenshots/0514-challenge4-repeat-hint3-1300x600.png index f4ab2e96cb8..77a699e5d14 100644 Binary files a/docs/lessons/screenshots/0514-challenge4-repeat-hint3-1300x600.png and b/docs/lessons/screenshots/0514-challenge4-repeat-hint3-1300x600.png differ diff --git a/docs/lessons/screenshots/0515-challenge4-repeat-hint5-1300x600.png b/docs/lessons/screenshots/0515-challenge4-repeat-hint5-1300x600.png index b6a1320538c..8741cbddada 100644 Binary files a/docs/lessons/screenshots/0515-challenge4-repeat-hint5-1300x600.png and b/docs/lessons/screenshots/0515-challenge4-repeat-hint5-1300x600.png differ diff --git a/docs/lessons/screenshots/0516-challenge7-quiz-hint3-1300x600.png b/docs/lessons/screenshots/0516-challenge7-quiz-hint3-1300x600.png index d4e5253758d..0e1679963d7 100644 Binary files a/docs/lessons/screenshots/0516-challenge7-quiz-hint3-1300x600.png and b/docs/lessons/screenshots/0516-challenge7-quiz-hint3-1300x600.png differ diff --git a/docs/lessons/screenshots/0517-challenge9-broadcast-hint4-1300x600.png b/docs/lessons/screenshots/0517-challenge9-broadcast-hint4-1300x600.png index e2a0b183be1..431c50ebe78 100644 Binary files a/docs/lessons/screenshots/0517-challenge9-broadcast-hint4-1300x600.png and b/docs/lessons/screenshots/0517-challenge9-broadcast-hint4-1300x600.png differ diff --git a/docs/lessons/screenshots/0518-challenge3-click-say-hint5-1300x600.png b/docs/lessons/screenshots/0518-challenge3-click-say-hint5-1300x600.png index 25ade819c3f..ee02a003eec 100644 Binary files a/docs/lessons/screenshots/0518-challenge3-click-say-hint5-1300x600.png and b/docs/lessons/screenshots/0518-challenge3-click-say-hint5-1300x600.png differ diff --git a/docs/lessons/screenshots/0519-challenge3-click-say-hint6-1300x600.png b/docs/lessons/screenshots/0519-challenge3-click-say-hint6-1300x600.png index e8063029377..304e446bdf0 100644 Binary files a/docs/lessons/screenshots/0519-challenge3-click-say-hint6-1300x600.png and b/docs/lessons/screenshots/0519-challenge3-click-say-hint6-1300x600.png differ diff --git a/docs/lessons/screenshots/0520-challenge5-if-hint2-1300x600.png b/docs/lessons/screenshots/0520-challenge5-if-hint2-1300x600.png index 8701140f693..169c3789407 100644 Binary files a/docs/lessons/screenshots/0520-challenge5-if-hint2-1300x600.png and b/docs/lessons/screenshots/0520-challenge5-if-hint2-1300x600.png differ diff --git a/docs/lessons/screenshots/0521-challenge5-if-hint3-1300x600.png b/docs/lessons/screenshots/0521-challenge5-if-hint3-1300x600.png index 799d1236af4..50e0ded3353 100644 Binary files a/docs/lessons/screenshots/0521-challenge5-if-hint3-1300x600.png and b/docs/lessons/screenshots/0521-challenge5-if-hint3-1300x600.png differ diff --git a/docs/lessons/screenshots/0522-challenge6-ask-answer-hint4-1300x600.png b/docs/lessons/screenshots/0522-challenge6-ask-answer-hint4-1300x600.png index 9b4ebdd4986..5dcddc96cd6 100644 Binary files a/docs/lessons/screenshots/0522-challenge6-ask-answer-hint4-1300x600.png and b/docs/lessons/screenshots/0522-challenge6-ask-answer-hint4-1300x600.png differ diff --git a/docs/lessons/screenshots/0523-lesson0-drag-cat-1300x600.png b/docs/lessons/screenshots/0523-lesson0-drag-cat-1300x600.png new file mode 100644 index 00000000000..2a3102966a1 Binary files /dev/null and b/docs/lessons/screenshots/0523-lesson0-drag-cat-1300x600.png differ diff --git a/docs/lessons/screenshots/0524-lesson0-tabs-1300x600.png b/docs/lessons/screenshots/0524-lesson0-tabs-1300x600.png new file mode 100644 index 00000000000..a10706a0adb Binary files /dev/null and b/docs/lessons/screenshots/0524-lesson0-tabs-1300x600.png differ diff --git a/docs/lessons/screenshots/0525-lesson0-where-1300x600.png b/docs/lessons/screenshots/0525-lesson0-where-1300x600.png new file mode 100644 index 00000000000..b3ef47f91d9 Binary files /dev/null and b/docs/lessons/screenshots/0525-lesson0-where-1300x600.png differ diff --git a/docs/lessons/screenshots/0526-lesson0-where-wrong-1300x600.png b/docs/lessons/screenshots/0526-lesson0-where-wrong-1300x600.png new file mode 100644 index 00000000000..9455bc46bec Binary files /dev/null and b/docs/lessons/screenshots/0526-lesson0-where-wrong-1300x600.png differ diff --git a/docs/lessons/screenshots/0527-lessons-library-lesson0-1300x600.png b/docs/lessons/screenshots/0527-lessons-library-lesson0-1300x600.png new file mode 100644 index 00000000000..845fb08b225 Binary files /dev/null and b/docs/lessons/screenshots/0527-lessons-library-lesson0-1300x600.png differ diff --git a/docs/lessons/screenshots/0528-lesson0-change-number-hint1-1300x600.png b/docs/lessons/screenshots/0528-lesson0-change-number-hint1-1300x600.png new file mode 100644 index 00000000000..ea7378a5e5f Binary files /dev/null and b/docs/lessons/screenshots/0528-lesson0-change-number-hint1-1300x600.png differ diff --git a/docs/lessons/screenshots/0529-lesson0-change-number-hint2-1300x600.png b/docs/lessons/screenshots/0529-lesson0-change-number-hint2-1300x600.png new file mode 100644 index 00000000000..beae81f12a8 Binary files /dev/null and b/docs/lessons/screenshots/0529-lesson0-change-number-hint2-1300x600.png differ diff --git a/docs/lessons/screenshots/0601-practice-partner-1300x600.png b/docs/lessons/screenshots/0601-practice-partner-1300x600.png new file mode 100644 index 00000000000..c04c10f6735 Binary files /dev/null and b/docs/lessons/screenshots/0601-practice-partner-1300x600.png differ diff --git a/docs/lessons/screenshots/0602-practice-partner-closed-1300x600.png b/docs/lessons/screenshots/0602-practice-partner-closed-1300x600.png new file mode 100644 index 00000000000..c14be504132 Binary files /dev/null and b/docs/lessons/screenshots/0602-practice-partner-closed-1300x600.png differ diff --git a/docs/lessons/screenshots/0701-chat-l1-sequence-full-text-1300x600.png b/docs/lessons/screenshots/0701-chat-l1-sequence-full-text-1300x600.png new file mode 100644 index 00000000000..46c739bfd4a Binary files /dev/null and b/docs/lessons/screenshots/0701-chat-l1-sequence-full-text-1300x600.png differ diff --git a/docs/lessons/screenshots/0702-chat-l1-repeat-hint1-1300x600.png b/docs/lessons/screenshots/0702-chat-l1-repeat-hint1-1300x600.png new file mode 100644 index 00000000000..868a49bd944 Binary files /dev/null and b/docs/lessons/screenshots/0702-chat-l1-repeat-hint1-1300x600.png differ diff --git a/docs/lessons/screenshots/0703-chat-l1-read-diagram-hint1-1300x600.png b/docs/lessons/screenshots/0703-chat-l1-read-diagram-hint1-1300x600.png new file mode 100644 index 00000000000..cdfad97c84e Binary files /dev/null and b/docs/lessons/screenshots/0703-chat-l1-read-diagram-hint1-1300x600.png differ diff --git a/docs/lessons/screenshots/0704-chat-l1-sequence-quiz-1300x600.png b/docs/lessons/screenshots/0704-chat-l1-sequence-quiz-1300x600.png new file mode 100644 index 00000000000..1c0d99ccb56 Binary files /dev/null and b/docs/lessons/screenshots/0704-chat-l1-sequence-quiz-1300x600.png differ diff --git a/docs/lessons/screenshots/0705-chat-l1-read-diagram-answer-1300x600.png b/docs/lessons/screenshots/0705-chat-l1-read-diagram-answer-1300x600.png new file mode 100644 index 00000000000..12d159aeaf5 Binary files /dev/null and b/docs/lessons/screenshots/0705-chat-l1-read-diagram-answer-1300x600.png differ diff --git a/docs/lessons/screenshots/0706-chat-lessons-library-1300x600.png b/docs/lessons/screenshots/0706-chat-lessons-library-1300x600.png new file mode 100644 index 00000000000..1725cf10508 Binary files /dev/null and b/docs/lessons/screenshots/0706-chat-lessons-library-1300x600.png differ diff --git a/docs/lessons/screenshots/0707-chat-l2-omikuji-full-text-1300x600.png b/docs/lessons/screenshots/0707-chat-l2-omikuji-full-text-1300x600.png new file mode 100644 index 00000000000..ca4aa6d1ef6 Binary files /dev/null and b/docs/lessons/screenshots/0707-chat-l2-omikuji-full-text-1300x600.png differ diff --git a/docs/lessons/screenshots/0708-chat-l2-timer-hint1-1300x600.png b/docs/lessons/screenshots/0708-chat-l2-timer-hint1-1300x600.png new file mode 100644 index 00000000000..37c5ff4a79d Binary files /dev/null and b/docs/lessons/screenshots/0708-chat-l2-timer-hint1-1300x600.png differ diff --git a/docs/lessons/screenshots/0709-chat-l2-janken-hint4-1300x600.png b/docs/lessons/screenshots/0709-chat-l2-janken-hint4-1300x600.png new file mode 100644 index 00000000000..e19ad9ea6b7 Binary files /dev/null and b/docs/lessons/screenshots/0709-chat-l2-janken-hint4-1300x600.png differ diff --git a/docs/lessons/screenshots/0710-chat-l2-timer-quiz-1300x600.png b/docs/lessons/screenshots/0710-chat-l2-timer-quiz-1300x600.png new file mode 100644 index 00000000000..9da3784a731 Binary files /dev/null and b/docs/lessons/screenshots/0710-chat-l2-timer-quiz-1300x600.png differ diff --git a/docs/lessons/screenshots/0711-chat-l3-local-message-full-text-1300x600.png b/docs/lessons/screenshots/0711-chat-l3-local-message-full-text-1300x600.png new file mode 100644 index 00000000000..f8c382302fe Binary files /dev/null and b/docs/lessons/screenshots/0711-chat-l3-local-message-full-text-1300x600.png differ diff --git a/docs/lessons/screenshots/0712-chat-l3-mesh-signal-hint1-1300x600.png b/docs/lessons/screenshots/0712-chat-l3-mesh-signal-hint1-1300x600.png new file mode 100644 index 00000000000..08bc103529d Binary files /dev/null and b/docs/lessons/screenshots/0712-chat-l3-mesh-signal-hint1-1300x600.png differ diff --git a/docs/lessons/screenshots/0713-chat-l3-mesh-variable-hint1-1300x600.png b/docs/lessons/screenshots/0713-chat-l3-mesh-variable-hint1-1300x600.png new file mode 100644 index 00000000000..c42852b3965 Binary files /dev/null and b/docs/lessons/screenshots/0713-chat-l3-mesh-variable-hint1-1300x600.png differ diff --git a/docs/lessons/screenshots/0714-chat-l3-mesh-variable-quiz-1300x600.png b/docs/lessons/screenshots/0714-chat-l3-mesh-variable-quiz-1300x600.png new file mode 100644 index 00000000000..e04d30e92db Binary files /dev/null and b/docs/lessons/screenshots/0714-chat-l3-mesh-variable-quiz-1300x600.png differ diff --git a/docs/lessons/screenshots/0715-chat-l3-mesh-variable-hint4-partner-1300x600.png b/docs/lessons/screenshots/0715-chat-l3-mesh-variable-hint4-partner-1300x600.png new file mode 100644 index 00000000000..ff683ba2b92 Binary files /dev/null and b/docs/lessons/screenshots/0715-chat-l3-mesh-variable-hint4-partner-1300x600.png differ diff --git a/docs/lessons/screenshots/0716-chat-l4-send-once-hint1-1300x600.png b/docs/lessons/screenshots/0716-chat-l4-send-once-hint1-1300x600.png new file mode 100644 index 00000000000..d4fff69efef Binary files /dev/null and b/docs/lessons/screenshots/0716-chat-l4-send-once-hint1-1300x600.png differ diff --git a/docs/lessons/screenshots/0717-chat-l4-both-ways-hint3-partner-1300x600.png b/docs/lessons/screenshots/0717-chat-l4-both-ways-hint3-partner-1300x600.png new file mode 100644 index 00000000000..b96929c4111 Binary files /dev/null and b/docs/lessons/screenshots/0717-chat-l4-both-ways-hint3-partner-1300x600.png differ diff --git a/docs/lessons/screenshots/0718-chat-l4-group-hint3-1300x600.png b/docs/lessons/screenshots/0718-chat-l4-group-hint3-1300x600.png new file mode 100644 index 00000000000..b4fd5dbb8da Binary files /dev/null and b/docs/lessons/screenshots/0718-chat-l4-group-hint3-1300x600.png differ diff --git a/docs/lessons/screenshots/0719-chat-l4-dm-hint2-1300x600.png b/docs/lessons/screenshots/0719-chat-l4-dm-hint2-1300x600.png new file mode 100644 index 00000000000..951fc38be2f Binary files /dev/null and b/docs/lessons/screenshots/0719-chat-l4-dm-hint2-1300x600.png differ diff --git a/docs/lessons/screenshots/0720-chat-l4-dm-quiz-1300x600.png b/docs/lessons/screenshots/0720-chat-l4-dm-quiz-1300x600.png new file mode 100644 index 00000000000..8dc01d9ace1 Binary files /dev/null and b/docs/lessons/screenshots/0720-chat-l4-dm-quiz-1300x600.png differ diff --git a/docs/lessons/screenshots/0721-chat-l5-read-receipt-full-text-1300x600.png b/docs/lessons/screenshots/0721-chat-l5-read-receipt-full-text-1300x600.png new file mode 100644 index 00000000000..a3ab4e91b49 Binary files /dev/null and b/docs/lessons/screenshots/0721-chat-l5-read-receipt-full-text-1300x600.png differ diff --git a/docs/lessons/screenshots/0722-chat-l5-ng-word-hint4-1300x600.png b/docs/lessons/screenshots/0722-chat-l5-ng-word-hint4-1300x600.png new file mode 100644 index 00000000000..bc8d2e369c9 Binary files /dev/null and b/docs/lessons/screenshots/0722-chat-l5-ng-word-hint4-1300x600.png differ diff --git a/docs/lessons/screenshots/0723-chat-l5-auto-reply-hint5-partner-1300x600.png b/docs/lessons/screenshots/0723-chat-l5-auto-reply-hint5-partner-1300x600.png new file mode 100644 index 00000000000..460a7b3746e Binary files /dev/null and b/docs/lessons/screenshots/0723-chat-l5-auto-reply-hint5-partner-1300x600.png differ diff --git a/docs/lessons/screenshots/0724-chat-l5-auto-reply-quiz-1300x600.png b/docs/lessons/screenshots/0724-chat-l5-auto-reply-quiz-1300x600.png new file mode 100644 index 00000000000..c457d645c98 Binary files /dev/null and b/docs/lessons/screenshots/0724-chat-l5-auto-reply-quiz-1300x600.png differ diff --git a/docs/lessons/screenshots/0725-chat-l5-stamp-hint1-1300x600.png b/docs/lessons/screenshots/0725-chat-l5-stamp-hint1-1300x600.png new file mode 100644 index 00000000000..69cec3a9e97 Binary files /dev/null and b/docs/lessons/screenshots/0725-chat-l5-stamp-hint1-1300x600.png differ diff --git a/docs/lessons/screenshots/0726-chat-l1-sequence-hint1-1300x600.png b/docs/lessons/screenshots/0726-chat-l1-sequence-hint1-1300x600.png new file mode 100644 index 00000000000..b658f30f90e Binary files /dev/null and b/docs/lessons/screenshots/0726-chat-l1-sequence-hint1-1300x600.png differ diff --git a/docs/lessons/screenshots/0727-chat-l1-sequence-hint2-1300x600.png b/docs/lessons/screenshots/0727-chat-l1-sequence-hint2-1300x600.png new file mode 100644 index 00000000000..dc1bc19129c Binary files /dev/null and b/docs/lessons/screenshots/0727-chat-l1-sequence-hint2-1300x600.png differ diff --git a/docs/lessons/screenshots/0728-chat-role-l3-shimacat-hint3-1300x600.png b/docs/lessons/screenshots/0728-chat-role-l3-shimacat-hint3-1300x600.png new file mode 100644 index 00000000000..06ec30c4b28 Binary files /dev/null and b/docs/lessons/screenshots/0728-chat-role-l3-shimacat-hint3-1300x600.png differ diff --git a/docs/lessons/screenshots/0729-chat-role-l3-shimacat-hint1-diagram-1300x600.png b/docs/lessons/screenshots/0729-chat-role-l3-shimacat-hint1-diagram-1300x600.png new file mode 100644 index 00000000000..996fca1b12e Binary files /dev/null and b/docs/lessons/screenshots/0729-chat-role-l3-shimacat-hint1-diagram-1300x600.png differ diff --git a/docs/lessons/screenshots/0730-chat-role-page-l4-2-1300x600.png b/docs/lessons/screenshots/0730-chat-role-page-l4-2-1300x600.png new file mode 100644 index 00000000000..2be756ae96f Binary files /dev/null and b/docs/lessons/screenshots/0730-chat-role-page-l4-2-1300x600.png differ diff --git a/docs/lessons/screenshots/0731-chat-l4-send-once-partner-received-667x375.png b/docs/lessons/screenshots/0731-chat-l4-send-once-partner-received-667x375.png new file mode 100644 index 00000000000..f893ae621bb Binary files /dev/null and b/docs/lessons/screenshots/0731-chat-l4-send-once-partner-received-667x375.png differ diff --git a/docs/lessons/screenshots/0732-chat-role-page-l4-2-844x390.png b/docs/lessons/screenshots/0732-chat-role-page-l4-2-844x390.png new file mode 100644 index 00000000000..7d282ac4be4 Binary files /dev/null and b/docs/lessons/screenshots/0732-chat-role-page-l4-2-844x390.png differ diff --git a/docs/lessons/screenshots/0733-chat-role-page-l4-2-1440x900.png b/docs/lessons/screenshots/0733-chat-role-page-l4-2-1440x900.png new file mode 100644 index 00000000000..c7c90c4905a Binary files /dev/null and b/docs/lessons/screenshots/0733-chat-role-page-l4-2-1440x900.png differ diff --git a/docs/lessons/screenshots/0734-chat-role-page-chosen-l4-2-1300x600.png b/docs/lessons/screenshots/0734-chat-role-page-chosen-l4-2-1300x600.png new file mode 100644 index 00000000000..88ba2af9a05 Binary files /dev/null and b/docs/lessons/screenshots/0734-chat-role-page-chosen-l4-2-1300x600.png differ diff --git a/docs/lessons/screenshots/0801-block-activity-diagram-menu-1300x600.png b/docs/lessons/screenshots/0801-block-activity-diagram-menu-1300x600.png new file mode 100644 index 00000000000..d70d7998ed1 Binary files /dev/null and b/docs/lessons/screenshots/0801-block-activity-diagram-menu-1300x600.png differ diff --git a/docs/lessons/screenshots/0802-block-activity-diagram-popup-1300x600.png b/docs/lessons/screenshots/0802-block-activity-diagram-popup-1300x600.png new file mode 100644 index 00000000000..c536381bde5 Binary files /dev/null and b/docs/lessons/screenshots/0802-block-activity-diagram-popup-1300x600.png differ diff --git a/docs/maintenance/smalruby-markers-gui.md b/docs/maintenance/smalruby-markers-gui.md index b5119775bdb..d92e48ec262 100644 --- a/docs/maintenance/smalruby-markers-gui.md +++ b/docs/maintenance/smalruby-markers-gui.md @@ -30,7 +30,7 @@ upstream ファイルに追加した Smalruby 固有コードのマーカー一 - JSDoc・コメントの言いかえだけの変更。 - 末尾のカンマ・空行・インデントだけの変更(後ろに行を足したための `,` も含む)。 - `eslint-disable` のコメントを消しただけの変更、未使用の変数を `_x` にしただけの分割代入の名前の変更。 -- チュートリアルの `src/lib/libraries/decks/` は、upstream に戻す EPIC(#1935)の進み具合を見てから決める。 +- チュートリアル(`src/lib/libraries/decks/`・`tutorial-tags.js`・カードの部品)は upstream の v13.7.2 のまま使う。スモウルビーの変更を足さない(足すときはマーカーを付けてこの一覧に載せる)。 付けるときは、コードの動きを変えない(コメントの行だけを足す)。 @@ -44,13 +44,11 @@ upstream ファイルに追加した Smalruby 固有コードのマーカー一 | `src/reducers/gui.ts` | Redux state registry | Smalruby reducer の import | | `src/reducers/gui.ts` | initial state | Smalruby 初期 state の展開 | | `src/reducers/gui.ts` | reducers | Smalruby reducer の登録 | -| `src/containers/cards.jsx` | tutorial glow animation | チュートリアルのハイライトアニメーション | +| `src/containers/sprite-library.jsx` | localized library sprite names | 「スプライトを選ぶ」の一覧で、コースのキャラクター(Shimaraby / Shimacat)を言語の名前(シマラビ / シマネコ)にする(import・`localizeSprites`・render の 3 ペア)。一覧の名前・検索・足したスプライトの名前がそろう。名前の表は `src/lib/lessons/sprite-names.js`(`docs/lessons/README.md`) | | `src/containers/connection-modal.jsx` | smalrubot firmware flash | SmalrubotS1 ファームウェア書き込みの import、ハンドラー、props | | `src/containers/connection-modal.jsx` | meshV2 initial step feature | Mesh v2 接続初期ステップ | | `src/containers/connection-modal.jsx` | meshV2 connected message feature | Mesh v2 接続済みメッセージ | | `src/containers/connection-modal.jsx` | meshV2 back button feature | Mesh v2 戻るボタン | -| `src/components/cards/cards.jsx` | tutorial glow animation | チュートリアル UI のハイライト | -| `src/components/cards/cards.jsx` | external-url button | step の `externalUrl` を新規タブで開くボタン (TryRuby 導線など) | | `src/components/connection-modal/connection-modal.jsx` | smalrubot firmware flash | SmalrubotS1 ファームウェアボタン propType | | `src/components/connection-modal/connection-modal.jsx` | network filter detection feature | ネットワークフィルター検出 | | `src/components/connection-modal/error-step.jsx` | smalrubot firmware flash | エラーステップのファームウェアボタン | @@ -70,13 +68,13 @@ upstream ファイルに追加した Smalruby 固有コードのマーカー一 | `src/containers/gui.jsx` | bug report modal | `openBugReportModal` の import、`onOpenBugReportModal` を Redux `openBugReportModal()` にマップ | | `src/components/modal/modal.css` | default modal background | `.modal-content` (非フルスクリーン) に既定背景 `$ui-white` を付与し、本文背景の設定漏れでも青いオーバーレイが透けないようにする (案X)。`background-clip: padding-box` で枠(白 25%)の下は塗らず、枠は上流と同じ淡い青に見せる | | `src/components/gui/gui.jsx` | meshV2 classroom binding | クラス状態に応じて Mesh v2 ドメインを参加コードに固定する常時マウントの binding | -| `src/components/gui/gui.jsx` | meshV2 self-sensor notice | グローバル変数名と mesh センサーの値の重複を検出し初回のみ通知する常時マウントのバナー (Issue #707) の import と配置 | | `src/components/gui/gui.jsx` | mesh status popup | メッシュの「状態と履歴」ウィンドウ(`containers/mesh-status-popup.jsx`)の import と、エディターとプレイヤーのツリー(`StageWrapper` 内)への常時マウント(`docs/mesh-v2/README.md`) | | `src/components/stage-header/stage-header.jsx` | mesh status button | 緑の旗・停止(`Controls`)とメッシュのボタン(`MeshStatusButton`)を 1 つのまとまり(`controlsGroup`)に入れる。通常表示と全画面の 2 か所 + import | | `src/components/menu-bar/menu-bar.jsx` | mesh status popup | メッシュのメニューの「状態と履歴を見る」(`menu-bar-mesh-status`)と、`openMeshV2StatusPopup` の import・`onOpenMeshV2StatusPopup` の dispatch と propType | | `src/components/connection-modal/connected-step.jsx` | mesh status popup | メッシュの接続済み画面の[状態と履歴]ボタン(`mesh-v2-open-status`)の import と配置 | | `src/components/connection-modal/connection-modal.jsx` | mesh header design system | メッシュの接続のモーダルだけ、ヘッダーの題を太字 1.2rem にし(`.mesh-v2-header-title`)、ヘルプをヘッダーに置かず、どの画面でも本文の下に `MeshV2HelpRow`(`mesh-v2-help-row.jsx`・`meshV2-help`)を出す。その import と `extensionId` の propType(`docs/design-system/components/modal.md` の「つなぐ画面」) | | `src/components/gui/gui.jsx` | lesson goal watcher | レッスンモードのあいだ VM を見張り、チャレンジの「できた」を判定して記録・「できた!」を出す常時マウントのコンテナ(`containers/lesson-goal-watcher.jsx`)の import と配置 | +| `src/components/gui/gui.jsx` | block activity diagram | ブロックを右クリック →「アクティビティ図」の項目をブロックのメニューに足し、そのスクリプトの図をパネルに描く常時マウントのコンテナ(`containers/block-activity-diagram.jsx`)の import と配置 | | `src/components/gui/gui.jsx` | welcome modal | 初回訪問者向けウェルカムモーダル HOC の import と配置、`onShowWelcomeModal` prop | | `src/containers/gui.jsx` | welcome modal | `onShowWelcomeModal` を Redux `openWelcomeModal()` にマップ | | `src/components/gui/gui.jsx` | DNCL mode notice | DnclModeNotice コンポーネントの import・配置・`onRequestExitDnclMode` prop | @@ -119,7 +117,10 @@ upstream ファイルに追加した Smalruby 固有コードのマーカー一 | `webpack.config.js` | classroom API | CLASSROOM_API_ENDPOINT 環境変数注入 | | `webpack.config.js` | scratch api proxy endpoint | SCRATCH_API_PROXY_ENDPOINT 環境変数注入 | | `webpack.config.js` | self-hosted Monaco Editor (#1171) | Monaco 本体 (`min/vs`) を版付きの `static/monaco/<版>/vs` へコピーする定数(版は monaco-editor の package.json から読む)・CopyWebpackPlugin パターン・`DefinePlugin` の `process.env.MONACO_VS_SUBPATH` 注入と、PWA precache 除外 + runtime caching 設定。マーカーは 2 箇所の `GenerateSW` にも単一行で入る | +| `webpack.config.js` | lazy tutorial images | 上流のチュートリアルの画像(`src/lib/libraries/decks/` の png・gif・jpg)を `gui.js` に埋めこまず `static/assets/decks/` にファイルで出す規則と、それと言語ごとの `*-steps` チャンクを PWA の precache から外し、開いたときだけ runtime caching(`smalruby-tutorial-images`)する設定。マーカーは 2 箇所の `GenerateSW` にも単一行で入る | +| `src/lib/tutorial-from-url.js` | unknown tutorial url analytics | `?tutorial=` の値に合うチュートリアルが無いとき、`lib/tutorial-url-analytics.js` で GA に送る(import と呼び出しの 2 ペア。`docs/analytics/README.md`) | | `webpack.config.js` | copy-webpack-plugin 14 (#1320) | dist の `libraries/*.json` コピーで、copy-webpack-plugin 7 で廃止された `flatten: true` の代わりに `to: 'libraries/[name][ext]'` を使う | +| `webpack.config.js` | standard assignments | リポジトリの `assignments/`(標準課題・CC0)を `assignments/` へコピーする CopyWebpackPlugin パターンと、PWA の precache から外す正規表現。マーカーは 2 箇所の `GenerateSW` にも単一行で入る | | `eslint.config.mjs` | react lifecycle typo detection | `react/no-typos` を error にして getDerivedStateFromProps/Error の static 抜け等を lint で検出 | | `eslint.config.mjs` | prettier integration | eslintConfigPrettier を最後に置いて prettier と競合する整形ルールを無効化 | | `src/lib/blocks.js` | gesture recovery import | ジェスチャー復旧モジュールの import | @@ -179,14 +180,12 @@ upstream ファイルに追加した Smalruby 固有コードのマーカー一 | `src/containers/blocks.jsx` | stale block delete event guard | scratch-blocks v2 の非同期イベント配送で、ワークスペースリロードを跨いで届いた stale な delete イベントが VM のスクリプトを消す問題のガード。`attachVM` で `vm.blockListener` を `createStaleBlockDeleteGuard` でラップ (issue #710)。import も含む | | `src/containers/blocks.jsx` | Ruby-converted toolbox update deferral | `onWorkspaceUpdate` の fromRuby 分岐の `updateToolbox()` を `Events.disable()` 窓の外 (finally 後) へ移動。窓内では flyout 再構築の create イベントが破棄され、新規変数が `runtime.monitorBlocks` / `flyoutBlocks` に登録されずモニタチェックボックスが無反応になる問題の修正 (issue #719)。フラグ宣言部と実行部の 2 箇所 | | `src/containers/blocks.jsx` | extension category flyout scroll | `handleExtensionAdded` 末尾で `_pendingScrollToCategoryId` をセット。scratch-blocks v1 は追加カテゴリへ自動でフォーカスしたが v2 continuous toolbox はしないため、post-rebuild で新カテゴリへスクロールさせる (Issue #749 の v13.7.2 再整合で `setBlockStyle` 復元と共存) | -| `src/containers/blocks.jsx` | lesson mode | `getLessonAllowedBlocks` と `allowedBlocksToIds` / `filterDynamicCategoryXmlList` の import と、`mapStateToProps` の `tutorialAllowedBlocks` にレッスンモードのチャレンジの `allowedBlocks` をチュートリアルより優先して渡す(`docs/lessons/README.md`) | +| `src/containers/blocks.jsx` | lesson mode | `getLessonAllowedBlocks` と `allowedBlocksToIds` / `filterDynamicCategoryXmlList` の import と、`mapStateToProps` の `tutorialAllowedBlocks` にレッスンモードのチャレンジの `allowedBlocks` を渡す(チュートリアルは上流のままでパレットを絞らない。`docs/lessons/README.md`) | | `src/containers/blocks.jsx` | lesson dynamic category filtering | 「変数」「ブロック定義」のカテゴリコールバックを `allowedBlocks` で絞り、`applyBlockDefaultsToElements` で初期値を入れるラッパー、`getTutorialAllowedBlockIds`、`getToolboxXML` で `onlyBlocks` と `makeToolboxXML` の最後の引数に渡す部分(`docs/lessons/README.md`) | | `src/containers/blocks.jsx` | lesson palette block defaults | `lib/lessons/block-defaults.js` の import、`getTutorialBlockDefaults`(`allowedBlocks` に書いたブロックの初期値を locale で選ぶ)、`getToolboxXML` の戻り値に `applyBlockDefaultsToToolboxXml` で初期値を入れる部分(`docs/lessons/README.md`) | | `src/containers/custom-procedures.jsx` | cat-blocks theme for custom procedures | `setBlocks` で `workspaceConfig.scratchTheme` に catblocks/classic を設定し、定義モーダルのブロックをメインエディタと同じテーマにする (Issue #749 の v13.7.2 再整合で upstream の `workspaceConfig.theme = theme` 採用と共存) | | `src/containers/stage-header.jsx` | classroom submission thumbnail | クラスルーム参加中の生徒にだけ upstream の「提出サムネイルを設定」ボタンを表示。`isStudentJoined` ヘルパー + import、`manuallySaveThumbnails`/`userOwnsProject` を joined 由来の props にマップ、`onUpdateProjectThumbnail` でキャプチャを redux にキャッシュ、`isStudentJoined` の named export (issue #631) | | `src/lib/vm-manager-hoc.jsx` | koshien mock config wiring | VM 初期化時に `wireKoshienMockConfig(vm)` を呼び、甲子園拡張機能が練習ゲーム設定(マップ/自機サイド/相手AI)を読めるよう runtime に getter を差し込む (import + componentDidMount) | -| `src/lib/titled-hoc.jsx` | start-tutorial button | チュートリアル開始ボタンが設定した保留プロジェクトタイトル(`pendingProjectTitle`)の適用とクリア(6 ペア。`src/reducers/cards.js` と対) | -| `src/reducers/cards.js` | start-tutorial button | `SET_PENDING_PROJECT_TITLE` アクションと `pendingProjectTitle` state — チュートリアル開始時に適用するプロジェクトタイトルの保留(5 ペア) | | `src/lib/define-dynamic-block.js` | argumentsByMethod support / argumentsByMethod layout / menu field support | 拡張ブロックの `argumentsByMethod`(メソッドごとの引数定義)と menu フィールドのサポート。undo/redo・プロジェクトロードのため複数回の `domToMutation` を許容 | | `src/lib/sb-file-uploader-hoc.jsx` | clear Google Drive state on file upload | ローカル sb3 ファイルのアップロード時に Google Drive のロード状態をクリア(3 ペア) | | `src/lib/make-toolbox-xml.js` | DNCL hide extensions | DNCL(日本語)モード時にツールボックスから拡張機能カテゴリを隠す | @@ -205,13 +204,10 @@ upstream ファイルに追加した Smalruby 固有コードのマーカー一 | `src/components/connection-modal/peripheral-tile.jsx` | customizable name label | ペリフェラルタイルの名前ラベルのカスタマイズ対応(2 ペア) | | `src/components/menu-bar/project-title-input.jsx` | read-only project title for Google Drive | Google Drive の閲覧専用プロジェクトでタイトル入力を read-only 化(4 ペア) | | `src/components/menu-bar/project-title-input.css` | read-only project title for Google Drive | 同機能のスタイル | -| `src/components/cards/card.css` | insert-code button overlay / tutorial glow animation | チュートリアルカードの「コードを挿入」ボタンのオーバーレイとハイライトアニメーションのスタイル | | `test/helpers/selenium-helper.js` | getLogs SEVERE filter | `getLogs()` が SEVERE を返さなかった不具合(`entry.level` は `logging.Level` のオブジェクト)を直し、絞り込みと既知の無害なログの一覧を `test/helpers/ignorable-severe-logs.js` の `filterBrowserLogs` に任せる(import と本体の 2 ペア)。他の Smalruby マーカー(extra helpers / no-sandbox など)は従来どおり | | `src/components/blocks/blocks.css` | palette toggle position | `.blocks` に `position: relative`(ブロックのパレットの ◀ / ▶ のボタンをこの箱に対して置く) | | `src/components/blocks/blocks.css` | show whole block shape on flyout hover | フライアウトにマウスを乗せている間、長いブロックが右へはみ出して見えるようにする(`clip-path`・RTL 対応)。スクロールバーを左に 4px 離し、ホバー中のスクロールバーの地を不透明度 0.4 にする | | `src/components/blocks/blocks.css` | v2 toolbox category label selector | カテゴリ名を 0.65rem に縮める規則のクラス名を、scratch-blocks v2.1.19 が描く `.blocklyToolboxCategoryLabel` にする(上流は v1 の `.scratchCategoryMenuItemLabel` のままで効かない) | -| `src/components/library/library.css` | tutorial library category full width | `.library-category` を幅いっぱいにして、チュートリアルのカテゴリが横に並ばないようにする | -| `src/components/library/library.jsx` | tutorial categories | チュートリアルのカテゴリを `lib/libraries/tutorial-tags` から読み、カテゴリの名前(ブロックのきほん・通信入門 ①〜③・Ruby のきほん など)に差し替える | | `src/components/library/library.jsx` | extension library key | 拡張機能の項目のキーに `extensionId` を使う | | `src/components/library/library.jsx` | modal header actions | `headerActions` を `Modal` に渡す(prop と propType) | | `src/components/modal/modal.jsx` | modal header actions | ヘッダーの右のボタン置き場 `headerActions`(拡張機能のライブラリ・甲子園のテストのモーダルが使う)。描画と propType | @@ -230,9 +226,6 @@ upstream ファイルに追加した Smalruby 固有コードのマーカー一 | `src/components/menu-bar/menu-bar.css` | Google Drive save status | Google ドライブへの保存の状態 `.save-status`・`.save-status-spinner` | | `src/components/gui/gui.css` | Ruby tab list container | Ruby タブを含むタブの並びと右のリンクを包む `.tab-list-container` | | `src/components/gui/gui.css` | legal links | タブの右のプライバシーポリシー・フィードバック・不具合の報告のリンク(`.legal-links`・`.privacy-link`・`.link-separator`・`.feedback-link`、幅 743px 以下でフィードバックを消す規則) | -| `src/components/cards/card.css` | tutorial card layout | チュートリアルのカードの幅を 500px までにし、長い題を折り返す(2 か所) | -| `src/components/cards/card.css` | step pip selector | 手順の点の規則のクラス名 `.inactiveStepPip` を `.inactive-step-pip` にする | -| `src/components/cards/card.css` | tutorial insert-code button | チュートリアルのカードの「コードを入れる」ボタン `.insert-code-button`(地 `$extensions-tertiary`(#0B8E69。白い文字 4.15:1)・太字・ホバー `$ui-green`)。地と太字は取りいそぎの修正で、チュートリアルを上流に戻す EPIC #1935 で revert する | | `src/lib/layout-constants.js` | middle stage size | 「中」のステージ: `STAGE_SIZE_MODES.middle`・`STAGE_DISPLAY_SIZES.middle`・倍率 0.75(3 か所) | | `src/lib/screen-utils.js` | middle stage size | `resolveStageSize` が「中」を返す | | `src/reducers/stage-size.js` | middle stage size | ステージの大きさの既定を「中」にする(上流は「大」) | diff --git a/docs/mesh-v2/README.md b/docs/mesh-v2/README.md index 303cb7370c0..d576b014692 100644 --- a/docs/mesh-v2/README.md +++ b/docs/mesh-v2/README.md @@ -259,6 +259,17 @@ end-to-end 動作確認: [`tools/playwright-verify/verify-classroom-mesh-connect 実装: 決まり = `src/lib/mesh-practice/partner.js`、折り返し = `src/lib/mesh-practice/loopback.js`(VM は変えない。`remoteData`・`recordMessage`・`startMessageHats`・`startHats` と、ブロックの実行を見る `src/lib/lessons/vm-execution-hook.js` を使う)、ブラウザに覚える = `src/lib/mesh-practice/storage.js`、状態と操作 = `src/lib/mesh-practice/use-mesh-practice-partner.js`(`src/containers/mesh-status-popup.jsx` がいつも呼ぶ)、画面 = `src/components/mesh-practice-partner/`。 +### レッスンの練習相手(ブラウザの中で折り返す) + +レッスンのメッシュのチャレンジでは、ひとりでも練習できるように「練習相手」を出せる(詳しくは +[`docs/lessons/README.md` の「メッシュの練習相手」](../lessons/README.md#メッシュの練習相手))。メッシュの拡張は変えず、 +ひとりで使える練習相手と同じ共通の部品(`lib/mesh-practice/loopback.js`)が、拡張の受け取り口(`meshService.remoteData` の +`smalruby-mesh-practice-partner`)・履歴と `startMessageHats` / `runtime.startHats` だけを使う。**本物のメッシュでつながっている・つなごうとしているあいだは何もしない**ので、本物のメッシュの動きは変わらない。 + +チャレンジを変えても(新しい作品を読み込んでも)メッシュのグループのつながりは保たれる(拡張と `meshService` は +作品の読み込みで消えない)。つながったあとに作品を読み込んでも、新しいステージの変数の見張りを付け直すので、「変数を作る」・名前の変更・ブロックでの変更は送られる +(モニターのスライダーで変えた値は、読み込みと関係なくすぐには送られない)。 + ## 主要ファイル ### scratch-gui diff --git a/docs/ruby-editor/bridging-patterns.md b/docs/ruby-editor/bridging-patterns.md index 597bd410374..e02a911cff2 100644 --- a/docs/ruby-editor/bridging-patterns.md +++ b/docs/ruby-editor/bridging-patterns.md @@ -96,6 +96,7 @@ Scratch の変数・リストの名前で、Ruby の情報を持たせている | `_symbols_`(ステージ) | 使われたシンボル | ステージのリスト | `variable-utils.js` の `_symbolToBlock` | | `__lit_<番号>__1_` | 何もしないリテラルだけの行(`"Jimmy"`) | スプライトの変数・リスト | `finish.js` の `_convertBareLiteralToAssignment` | | `_super_<メソッド>_<番号>_` | `super` で呼ばれる、module 側の同じ名前のメソッド | 定義ブロック(手続き名) | `class-visitor.js` | +| `_<名前>`(`_1_文字えらぶ`・`_end`。1 けたの数字は `__1`) | 数字で始まる名前・予約語の名前の定義ブロック(「1 文字えらぶ」「end」) | 定義ブロック(Ruby のメソッド名だけ。ブロックの名前には `_` を付けない) | `src/lib/ruby-method-name.js`(P20) | 生成器だけが使う、出力の途中の目印もある(Ruby には残らない)。 @@ -217,6 +218,7 @@ say(@_ret1.length + @_ret2.length) - **配列リテラルの代入**: 「すべて削除」(`@ruby:array:literal:<個数>`)と「追加する」を要素の数だけ(`@ruby:array:literal:element`)。生成器は `@ruby:array:literal:<個数>` から先の個数の「追加する」をまとめて `@a = [1, 2, 3]` に戻す。 - **添字**: Ruby は 0 から、Scratch は 1 から数える。`@a[i]` は「`i + 1` 番目」にし、足し算に `@ruby:array:index` を付ける。生成器は `+ 1` を消して `@a[i]` に戻す。文字の位置(`"abc"[i]`)も同じ。 +- **添字が `x - 1` のとき**: ブロックで作った「(k) 番目」は、生成器が `@a[@k - 1]` と書く。変換器はこの形(引く数が整数の `1`、引かれる側が数でないブロック、`@ruby:` の注釈の無い引き算)を「`k` 番目」に戻し、`+ 1` も注釈も付けない(`variable-hash-ops.js` の `indexCountedFromOne`。`adjustIndex` が呼ぶので、`[]`・`[]=`・`insert`・`delete_at`・文字の位置 `"abc"[k - 1]` のどれにも効く)。これが無いと「((k - 1) + 1) 番目」になり、ブロックが読みにくくなっていた。ローカル変数・メソッドの引数・`rand(1..@n) - 1`・入れ子(`@a[@b[@k - 1] - 1]`)も同じ。`3 - 1` は戻さない(「3 番目」にすると生成器が `@a[2]` と書き、Ruby の文字が変わる)。`@k - 1.0`・`@k - 2` も今までどおり「`+ 1` 番目」。`@a.delete_at(@a.length - 1)` も戻さない(「(a の長さ)番目を削除する」は生成器が `delete_at(-1)` と書くので、Ruby の文字が変わる。`@a[@a.length - 1]` は「(a の長さ)番目」に戻す)。`@a.index(x)` は `@ruby:array:index` の付いた引き算なので戻さず、`@a[@a.index(x) - 1]` は外側の `- 1` だけを戻す。 - **`delete_at(-1)`**: 「(リストの長さ)番目を削除する」にし、`@ruby:array:delete_at:last` を付ける。添字が「リストの長さ」なので、ブロックとして動かしても最後の項目が消える。生成器は、添字が同じリストの長さのブロックなら注釈が無くても `delete_at(-1)` と書く。注釈があって添字が `1` のもの(前の変換器が作った形)も `delete_at(-1)` と書く。利用者が添字をほかの数に書きかえたら、ふつうの `delete_at` として書く。Ruby v1(`list("$a").delete_at(-1)`)も同じで、v1 の `list("$a").delete_at(list("$a").length)` も `delete_at(-1)` に戻る(意味は同じ)。 - **変数とリストが同じ名前のとき**: Scratch では変数 `a` とリスト `a` を同時に持てるが、Ruby の `@a` は 1 つ。生成器はリストの方を `@_a_list_`(それも使われていれば `@_a_list2_` ...)と書き、変換器は `@_a_list_` をリスト `a` に読む(`_listNameOfAlias`)。 - **ブロック付きのメソッド**(`@a.each do |x|`): `smalrubyRuby_arrayMethodWithBlock`。リストの ID と名前を隠しフィールド `LIST_ID` / `LIST_NAME` に持たせる(→ P13)。 @@ -250,7 +252,7 @@ say(@_a_list_[0]) **できないこと**: 1 つの名前を変数とリストの両方に使う形(`@a = 0` と `@a.push(1)`)はエラー(`variableAndListSameName`)。配列リテラルに直接メソッドを使う形もエラー(`arrayLiteralReceiver`)。要素は数・文字列(式展開の文字列 `"a#{@x}"` は除く)・値のブロック(`@x`、`1 + 2`、`true` など)だけで、ほかの要素(代入などの命令 `[(@a = 1)]`、シンボル・`nil`・配列・ハッシュ・`self`、値を返すメソッドの呼び出し `[foo(1)]`)はその行の「命令がまちがっています」のエラー(`wrongInstruction`)。リストに入れられないので、黙って `0` にしない。保存済みのプロジェクトの前の形(添字 `1` に `@ruby:array:delete_at:last`)は、読みこんでもブロックは直らず、動かすと 1 番目の項目が消える(Ruby に戻すと `delete_at(-1)` なので、Ruby とブロックの動きが合わない)。Ruby タブで変換し直すと「(リストの長さ)番目」になる。`-1` 以外の負の添字(`@a[-1]`、`@a.delete_at(-2)`)は「`-1 + 1` 番目」のように数えるので、往復はするが、ブロックとして動かすと Ruby と同じ項目にならない。 -**テスト**: `ruby-to-blocks-converter/literal-element-not-a-value.test.js`、`ruby-to-blocks-converter/variables/variables-array-global.test.js`、`variables-array-local.test.js`、`ruby-roundtrip/variables-v2-array.test.js`、`ruby-roundtrip/list-index-parens.test.js`、`ruby-roundtrip/list-as-argument.test.js`、`ruby-roundtrip/variable-and-list-same-name.test.js`、`ruby-roundtrip/variable-or-list-kind.test.js`、`ruby-roundtrip/string-letter-index.test.js`、`ruby-roundtrip/list-delete-at-last-vm.test.js`、`ruby-generator/data.test.js`。 +**テスト**: `ruby-to-blocks-converter/literal-element-not-a-value.test.js`、`ruby-to-blocks-converter/variables/variables-array-global.test.js`、`variables-array-local.test.js`、`ruby-roundtrip/variables-v2-array.test.js`、`ruby-roundtrip/list-index-parens.test.js`、`ruby-roundtrip/list-as-argument.test.js`、`ruby-roundtrip/variable-and-list-same-name.test.js`、`ruby-roundtrip/variable-or-list-kind.test.js`、`ruby-roundtrip/string-letter-index.test.js`、`ruby-roundtrip/list-index-minus-one-table.test.js`、`ruby-roundtrip/list-delete-at-last-vm.test.js`、`ruby-generator/data.test.js`。 ### P5. ハッシュ @@ -739,6 +741,32 @@ say(mesh.message_value) **テスト**: `ruby-to-blocks-converter/mesh_v2.test.js`、`ruby-roundtrip/extension_mesh.test.js`、`furigana-annotator.test.js`。 +### P20. 定義ブロックの名前と「画面を再描画せずに実行する」 + +**Ruby で書きたいこと**: 定義ブロック(ブロックを作る)の名前と設定を、Ruby の `def` で書く。名前が数字で始まる・予約語のものもある。 + +**Scratch での表し方**: 定義ブロック(`procedures_definition` と `procedures_prototype`)。名前は `proccode` の言葉、「画面を再描画せずに実行する」は `procedures_prototype` の `mutation.warp`(`"true"` / `"false"`。読みこんだ作品では真偽値のこともある)。 + +- **名前**: 生成器は `proccode` の言葉(`%s` / `%b` を除く)を `_` でつないでメソッド名にする(`'1 文字えらぶ %s'` → `1_文字えらぶ`)。名前が数字で始まるか予約語のときは前に `_` を付け、1 けたの数字(`_1`〜`_9` は番号指定パラメータ)には `__` を付ける。もとから `_` で始まる同じ形の名前には、もう 1 つ付ける(`_1x` → `__1x`)。変換器は逆に付けた分を取る。この対応は `src/lib/ruby-method-name.js` の 1 か所(`rubyMethodNameOfProccode` / `blockNameOfRubyMethodName`)にあり、生成器 `procedure.js` と、変換器が `proccode` からメソッド名を求める所(`variable-utils.js` の `_isProcedureCallWithReturnValue`・`my-blocks.js`・`return-value-temps.js` の `_procedureNameOfCall`)が使う。変換器の手続きの表(`_context.procedures`)と `_return_<メソッド>_`・`@ruby:return:<メソッド>` は Ruby のメソッド名(`_1_文字えらぶ`)のまま。 +- **注釈の名前**: `@ruby:return:<メソッド>` のメソッド名は日本語のこともあるので、生成器は `\w+` ではなく `[^:,\s]+` で読む(`\w` は日本語に当たらず、`return` のある日本語の名前のメソッドで、初期化と控えのブロックが Ruby に出ていた)。 +- **画面を再描画せずに実行する**: 生成器は `without_screen_refresh def foo ... end` と書く(Ruby の `private def foo` と同じ形。`def` はメソッド名のシンボルを返すので、Ruby として正しい)。変換器は解析の段(`parse-stage.js`)で、この呼び出しを中の `def` に置きかえ(`screen-refresh-defs.js` の `unwrapWithoutScreenRefreshDefs`)、`def` を `_context.warpDefNodes` に覚える。分析・class / module・コメント・ブロックの中の `def` の検査は、ふつうの `def` として見る。`my-blocks.js` が `warp` を `"true"` にする(呼び出しのブロックの `mutation.warp` も同じにする)。module のメソッド(ほかのスプライトの module を読むときも)も同じ。注釈は使わない(Ruby だけで書く人も書けるように、Ruby の形で表す)。smalruby3 gem では `without_screen_refresh` は名前を返すだけのクラスメソッドで、メソッドはふつうに動く。 + +**往復の例**: + +```ruby +without_screen_refresh def _1_文字えらぶ(n) + say(n) +end + +_1_文字えらぶ(1) +``` + +- 定義ブロック「1_文字えらぶ (n)」(画面を再描画せずに実行する)と、その呼び出しになり、同じコードに戻る。 + +**できないこと**: 名前の中の空白は `_` になり、ブロックに戻しても `_` のまま(「1 文字えらぶ」は「1_文字えらぶ」になる)。`-` などメソッド名に使えない記号の入った名前は、そのまま書くので Ruby の文法エラーになる。自分で `def without_screen_refresh` を定義したコードでは、`without_screen_refresh def foo` をその呼び出しとして読む(置きかえない)。日本語モードは `without_screen_refresh def` を読めない。 + +**テスト**: `ruby-roundtrip/my-block-warp-and-name.test.js`、`ruby-roundtrip/my_blocks.test.js`。 + ## 注釈 `@ruby:*` の一覧(仕様) 「書く」はその注釈を作るところ、「読む」は使うところ。変換器・生成器は `packages/scratch-gui/src/lib/` の `ruby-to-blocks-converter/` と `ruby-generator/` のこと。 diff --git a/docs/ruby-editor/converter-stages.md b/docs/ruby-editor/converter-stages.md index b3210d62b6a..6bea620d1d8 100644 --- a/docs/ruby-editor/converter-stages.md +++ b/docs/ruby-editor/converter-stages.md @@ -21,27 +21,28 @@ Ruby → ブロックの変換器(`packages/scratch-gui/src/lib/ruby-to-blocks | 項目 | いま | | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| 大きさ | 73 ファイル・約 20,600 行(`ast-handlers/` と `send-table.js` を含む) | -| クラス | `RubyToBlocksConverter`(prism の `Visitor` を継承)1 つに、15 の部品を `Object.assign` で混ぜる | +| 大きさ | 78 ファイル・約 20,700 行(`ast-handlers/` と `send-table.js` を含む) | +| クラス | `RubyToBlocksConverter`(prism の `Visitor` を継承)1 つに、段ごとの部品(共通 2・解析 1・分析 1・変換 10・仕上げ 4)を `stages.js` の `mixStages` で混ぜる。同じ名前のメソッドが 2 つの部品にあるとエラーにする(「段ごとの部品」) | | 呼び出しの登録 | 呼び出しの表(`send-table.js`)の行が 95(motion 12・looks 25・sound 8・control 5・event 6・sensing 16・operators 6・pen 17)。ほかに `converter.registerOnSend(` 324 か所・`converter.registerOnSendWithBlock(` 53 か所・`converter.registerOnSendMyBlock(` 1 か所 | | 構文の登録 | `converter.registerOnIf(` / `OnUntil` / `OnOpAsgn` / `OnAnd` / `OnOr` / `OnVar` / `OnVasgn` / `OnDefs`(13 か所) | | 古い `onXxx` 形式 | なくした。`_callConvertersHandler` は `registerOnXxx` で登録した配列だけを見る | -| 変換の前の分析 | `analysis.js` の `analyze`(変数の使い方・ローカル変数の範囲・値として呼ばれる手続きの数)。変換器は結果の表を `_context.analysis` に置いて読む。`_rejectRubyNameOfVariableAndList` は表の `errors` を見て断る | +| 変換の前の分析 | `analysis.js` の `analyze`(変数の使い方・ローカル変数の範囲・値として呼ばれる手続きの数・class / module / initialize の構造)。変換器は結果の表を `_context.analysis` に置いて読む。`_rejectRubyNameOfVariableAndList` は表の `errors` を見て断る | | 変換のあとの仕上げ | `finish.js` の `_finish`(素のリテラルを代入に変える、`ruby_*` ブロックを断る、拡張機能の ID を集める、使われないハッシュの変数を消す、`$_symbols_` を作る、コメントを結びつける など)。書きこみは `target-applier.js` | 数え方: `ruby-to-blocks-converter/` の下の `.js`(`ast-handlers/` を含む)を対象に、ファイルの数と行の数(`wc -l`)、登録は `converter.registerOnXxx(` と書かれた所の数を数えた(`grep -roF`)。`converter-registry.js` の中の定義と、`receiver` の `self` / `any` / 配列を広げるための呼び直しは数えない。`forEach` の中の 1 か所は、いくつのメソッドを登録していても 1 と数える(実際に登録される数はこれより多い)。`send-table.js` の中の `registerOnSend(` / `registerOnSendWithBlock(` 1 か所ずつもこの数に入る。表の行は、`map` で広げたあとの数(各変換器の `sends`)。 `targetCodeToBlocks`(`index.js`)は 4 段を順に呼ぶだけになった: `_indexSource` と `_parse`(解析)→ `_analyze`(分析。`analysis.js` の `analyze` を呼ぶ)→ `_convert`(変換)→ `_finish`(仕上げ。`finish.js`)。 -解析・分析・変換・仕上げの段で投げたエラーは、`targetCodeToBlocks` の 1 か所の `catch` が行と列のついた `errors` にする。残りの仕事は、class / module / initialize の判断を分析へ移し、`Object.assign` で混ぜている部品を段ごとに分けること。 +解析・分析・変換・仕上げの段で投げたエラーは、`targetCodeToBlocks` の 1 か所の `catch` が行と列のついた `errors` にする。class / module / initialize の構造も分析で決め(`class-analysis.js`)、部品は段ごとに分けた(「段ごとの部品」)。 ### 構文木をたどる処理 -| たどる処理 | 子の取り方 | -| ------------------------------------------------------- | --------------------------------------------------------------------- | -| 変換そのもの(`visit` と `visitXxxNode`) | ノードの種類ごとに手で書く | -| 分析(`analyze`) | `forEachNode`(`node-walk.js`。prism の `childNodes()` のすべての子) | -| `_statementNodeOf`(エラーで文を指す) | `_childNodesOf`。エラーのたびに根からたどる | -| `_associateSourceComments` の一部、`_nodeContainsSuper` | `_childNodesOf` | +| たどる処理 | 子の取り方 | +| ----------------------------------------------------------------------- | --------------------------------------------------------------------- | +| 変換そのもの(`visit` と `visitXxxNode`) | ノードの種類ごとに手で書く | +| 分析(`analyze`) | `forEachNode`(`node-walk.js`。prism の `childNodes()` のすべての子) | +| `_statementNodeOf`(エラーで文を指す) | `_childNodesOf`。エラーのたびに根からたどる | +| `_associateSourceComments` の一部 | `_childNodesOf` | +| `containsSuper`(`class-analysis.js`。メソッドの中に `super` があるか) | `forEachNode` | 手続きの呼び出しを数える下調べ(もとの `_countProcedureCallsInNode`)は、子を手で並べたプロパティ名でたどっていた。並べた名前に `CaseNode` の `conditions`(`when` の並び)や `elseClause` が無く、`case` の中の手続きの呼び出しを数えていなかった。 @@ -83,7 +84,7 @@ Scratch のブロック | `variables` | Ruby の名前(`@a` / `$a` / `a`)ごとの使い方(リスト・ハッシュ・値・文字列か)、最初に使われた行 | `analysis.js`(もとは `_collectVariableUses`)。済み | | `locals` | ローカル変数の範囲(メソッド・スクリプトのブロックごと)と、範囲ごとの名前(`_x_1_`) | `analysis.js`(もとは `_collectVariableUses`)。済み | | `procedures` | `def` の名前・引数・戻り値を返すか、値として呼ばれる数 | 数は `analysis.js`(もとは `_countProcedureCallsInNode`)。`def` は `my-blocks.js` | -| `classes` | class / module / initialize / super / attr_accessor の構造 | `class-visitor.js` / `module-visitor.js` / `initialize-handler.js` の判断の部分 | +| `classes` | class / module / initialize / super / attr_accessor の構造 | `class-analysis.js`(`analysis.js` が `classes` の `structure` に入れる)。済み | | `symbols` | シンボルの一覧(`$_symbols_` リストのもと) | 変換の途中で集めている | | `errors` | 変換の前に断れる誤り(同じ `@a` を変数とリストに使う、など) | `analysis.js`。断るのは `_rejectRubyNameOfVariableAndList`。済み | @@ -98,17 +99,17 @@ prism の `childNodes()` のすべての子を、ソースの順に(親を子 `analyze` は構文木とソースだけを読む純粋な関数で、変換器や VM を読まない。結果は `Object.freeze` する(中の prism のノードは凍らせない。`Map` は読むだけの形 `{ get, has, size }` にする)。 Ruby の名前をキーにする表(`variables.uses`・`locals.uses`・`procedures.valueCallCounts` など)は `Object.create(null)` で作る。`__proto__` や `constructor` も、ほかの名前と同じに扱うため。 -| 表 | 形 | 変換器で読むところ | -| ---------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- | -| `variables.uses` | `{ [Ruby の名前]: { list, scalar, hash, string, notString } }` | `_variableUsesOf`・`_kindOfRubyName`・`_listNameOfAlias`(`variable-utils.js`) | -| `variables.firstUses` | `{ ['@a' / '$a']: { list?: { line, node }, scalar?: { line, node } } }`(いちばん前の行) | (`errors` のもと) | -| `variables.rubyNames` | コードが読み書きする `@a` / `$a` の並び | `_kindOfRubyName`・`_listNameOfAlias` | -| `locals` | `unitOfNode`(範囲を始めるノード → 範囲の番号)、`uses[範囲][名前]`、`groups[範囲]`(メソッドは自分、スクリプトのブロックは 0)、`splitNames` | `_enterLocalUnit`・`_localScopeIndex`・`_variableUsesOf`(範囲ごとの名前の番号は変換の途中で決まるので `_context.localScopeIndexes` に置く) | -| `procedures.valueCallCounts` | `{ [メソッド名]: 値として呼ばれる数 }` | `my-blocks.js`(戻り値を入れる変数の番号) | -| `procedures.definitions` | `def` ごとの `{ name, line, onSelf, requireds, optionals, returnsValue, usesSuper, node }` | まだ読まない(`my-blocks.js` と `class-visitor.js` がその場で調べている) | -| `classes` | `classes`: `{ name, superclass, line, attrs, includes, methods, hasInitialize, node }`、`modules`: `{ name, line, methods, node }` | まだ読まない(`class-visitor.js` / `module-visitor.js` の本体の下調べ) | -| `symbols` | コードに書かれたシンボル(`:name`)の並び。`$_symbols_` に入る候補(変換で使われたものだけが入る) | まだ読まない(`_context.symbols` は変換の途中で集める) | -| `errors` | `{ kind: 'variableAndList', name, listLine, variableLine, node }` を変数としての行の順に | `_rejectRubyNameOfVariableAndList`(最初の 1 つで止める) | +| 表 | 形 | 変換器で読むところ | +| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- | +| `variables.uses` | `{ [Ruby の名前]: { list, scalar, hash, string, notString } }` | `_variableUsesOf`・`_kindOfRubyName`・`_listNameOfAlias`(`variable-utils.js`) | +| `variables.firstUses` | `{ ['@a' / '$a']: { list?: { line, node }, scalar?: { line, node } } }`(いちばん前の行) | (`errors` のもと) | +| `variables.rubyNames` | コードが読み書きする `@a` / `$a` の並び | `_kindOfRubyName`・`_listNameOfAlias` | +| `locals` | `unitOfNode`(範囲を始めるノード → 範囲の番号)、`uses[範囲][名前]`、`groups[範囲]`(メソッドは自分、スクリプトのブロックは 0)、`splitNames` | `_enterLocalUnit`・`_localScopeIndex`・`_variableUsesOf`(範囲ごとの名前の番号は変換の途中で決まるので `_context.localScopeIndexes` に置く) | +| `procedures.valueCallCounts` | `{ [メソッド名]: 値として呼ばれる数 }` | `my-blocks.js`(戻り値を入れる変数の番号) | +| `procedures.definitions` | `def` ごとの `{ name, line, onSelf, requireds, optionals, returnsValue, usesSuper, node }` | まだ読まない(`my-blocks.js` がその場で調べている) | +| `classes` | `classes`: `{ name, superclass, line, attrs, includes, methods, hasInitialize, node, structure }`、`modules`: `{ name, line, methods, node, structure }`、`ofNode`(ClassNode / ModuleNode → その項目) | `class-visitor.js`・`initialize-handler.js`・`module-visitor.js`(`structure` を読む。次の節) | +| `symbols` | コードに書かれたシンボル(`:name`)の並び。`$_symbols_` に入る候補(変換で使われたものだけが入る) | まだ読まない(`_context.symbols` は変換の途中で集める) | +| `errors` | `{ kind: 'variableAndList', name, listLine, variableLine, node }` を変数としての行の順に | `_rejectRubyNameOfVariableAndList`(最初の 1 つで止める) | 「値として呼ばれる」は、変換が値として変換する所で決める。 ノードごとに「文として見る」「値として見る」を子に配り、値として見た `CallNode` を数える @@ -119,6 +120,28 @@ Ruby の名前をキーにする表(`variables.uses`・`locals.uses`・`proced いまは `test/unit/lib/ruby-to-blocks-converter/analysis.test.js` が表の中身を、変換器と往復のテストが表を読んだ変換の結果を確かめる。 文字列の値か(`isStringValueNode`)と多重代入の組(`multiWritePairs`)は `analysis.js` の 1 か所にあり、変換(`visitMultiWriteNode`)も同じものを使う。 +#### class / module / initialize の構造(`class-analysis.js`) + +`classStructureOf(node)` が、class の本体から木だけで決まることを決める。`analysis.js` が `classes` の各項目の `structure` に入れ、 +変換(`visitClassNode`)は `ofNode` で引いて読む(変換が通る class と module はすべて分析した木の中にあるので、表に無いノードは変換器の誤りとして投げる。分析の取りこぼしを、黙って計算し直して隠さないため)。 + +| `structure` の中身 | 決めること | 変換で使うところ | +| ------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- | +| `isStage`・`isSpriteIndexName`・`superclassPath` | ステージの class か、`Sprite1` のような名前か、親(ステージは持たない) | `include` を断る、注釈 `@ruby:class` | +| `attrs`・`attrVariables` | `attr_accessor` / `attr_reader` / `attr_writer` の名前と種類、作るインスタンス変数 | 変数を作り、`_context.attrAccessors` に置く(`visitCallNode` の getter / setter) | +| `includeStatements` | `include M` / `extend` を行の順に | module があるかを調べる(この code で前に定義したもの、ほかのスプライトのもの) | +| `superMethods` | `super` を呼ぶメソッドの名前 | `include` した module に同じ名前があれば、その手続きの名前を変える(`superMethodMap`) | +| `comment`・`classInfo` | 注釈 `@ruby:class:...` の文、スプライト(ステージ)の属性(`set_xxx`) | コメントを作る。`classInfo` はスプライトへ書きこむ(`target-applier.js`) | +| `initializes` | `def initialize` ごとの引数・`super`・行(変数かリストか、値、`attr=` に書く名前) | 変数・リストを作り、値を `initializeValues` に置き、注釈 `@ruby:initialize:...` を作る(`initialize-handler.js`) | +| `bodyStatements` | `set_xxx`・`attr_xxx`・`include`・`def initialize` を除いた、ブロックにする行 | 1 行ずつ変換する | +| `superclassError`・`setError`・`assetError`、`initializes` の行の `error` | 木だけでわかる誤り(`{ node, message, values }`。`message` は `messages` のキー) | 前と同じ所で投げる | + +誤りは分析では投げない。分析で投げると、class より前の行の誤りより先に出て、最初の誤りが変わってしまうため。 +変換は、本体を見ていたときと同じ順(親 → `attr_xxx` の変数 → `set_xxx` → `include` → 素材の名前 → module のメソッド → `initialize` → 本体)に投げる。 +変換のバージョン(v1 では class を断る)・ステージか・それまでに定義した module と手続き(`private` を断るか)は変換器の状態なので、変換で調べる。 +module は、本体の行(`structure.statements`)だけを分析で決め、`def` 以外を断るのは変換で行う。 +移すときは、変換器と往復のテストに書かれた Ruby と class / module / initialize を使う Ruby(約 7,500 個)を 4 通り(スプライトの v2・v1、ステージ、衣装と音のあるスプライト)で変換し、エラー・ブロック・変数・リスト・コメント・`classInfo`・`initializeValues` が移す前とすべて一致することを確かめた。 + ### 3. 変換(convert) - `visitXxxNode` がノードごとにブロックを作る(prism の `Visitor` の形はそのまま)。 @@ -136,6 +159,22 @@ Ruby の名前をキーにする表(`variables.uses`・`locals.uses`・`proced - ソースのコメントをブロックに結びつける(P14) - `target-applier.js` でスプライト(ステージ)へ書きこむのは仕上げのあと、呼び出し側が `apply()`(`applyTargetBlocks`)を呼んだとき(書きこみの途中で失敗したら戻す) +## 段ごとの部品 + +`stages.js` の `STAGES` が、変換器の部品を働く段ごとに並べる。`mixStages` がそれを `RubyToBlocksConverter.prototype` に混ぜる。 +同じ名前のメソッドが 2 つの部品にある(またはクラスにもある)とエラーにする。`Object.assign` では後のものが黙って勝つため(`stages.test.js`)。 + +| 段 | 部品 | すること | +| ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- | +| 共通 | `ContextUtils`(`context-utils.js`)、`NodeUtils`(`node-utils.js`) | 変換の状態(`_context` と巻き戻しの記録)、ソースの索引とエラーの位置。どの段も使う | +| 解析 | `ParseStage`(`parse-stage.js`) | `_indexSource`・`_parse` | +| 分析 | `AnalyzeStage`(`analyze-stage.js`) | `_analyze`(`analysis.js` の `analyze` と `class-analysis.js`) | +| 変換 | `ConvertStage`(`convert-stage.js`)、`AstHandlers`、`ClassVisitor`、`InitializeHandler`、`ModuleVisitor`、`ConverterRegistry`、`BlockUtils`、`VariableUtils`、`ScopeManager`、`ReturnValueTemps` | `_convert`・`visit` と、ノードごとにブロックを作る部品 | +| 仕上げ | `Finish`(`finish.js`)、`CommentHandler`、`TargetApplier`、`LineMappingUtils` | 全体の検査、ソースのコメント、スプライトへの書きこみ(`applyTargetBlocks`)、行からブロックを引く(Ruby タブ) | + +`index.js` には、4 段を順に呼ぶ `targetCodeToBlocks` と、変換器の設定(翻訳・登録の表)だけが残る。 +`VariableUtils` には、分析の表を読む関数(`_variableAnalysis` など)と仕上げで使う関数(`_dropUnusedHashVariables` など)も入っている。変数の名前を決める処理と一緒にあるため、変換に置いている。 + ## 呼び出しの登録を表にする ### 表の形(`send-table.js`) @@ -239,16 +278,16 @@ registerSendTable(converter, MOTION_SENDS); どの段階でも、移す領域の **ブロック ⇔ Ruby の表**(`test/unit/lib/ruby-roundtrip/<category>-table.test.js`)を先に作るか足して、移す前に通ることを確かめてから移す。 表が無い領域は、まず既存のテストを表へ移す(`.claude/rules/scratch-gui/testing.md` の「新しい opcode はブロック ⇔ Ruby の表から」)。 -| 順 | すること | 振る舞いを固定するテスト | 効率 | -| --- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | ---------------------------- | -| 1 | 解析の索引: 行の表、ノードの種類名をクラスごとに覚える(`nodeTypeName`)。済み | 表のテストすべて、`line-for-offset.test.js`、`multibyte-offset.test.js` | 小 | -| 2 | 変換の巻き戻しを journal に(`_saveContext` を写さない)。済み | 表のテストすべて、`orphan-blocks.test.js`、`target-applier-transaction.test.js`、往復テスト | **大**(いま最も時間を使う) | -| 3 | 分析の段: `forEachNode` を作り、`_collectVariableUses` と `_countProcedureCallsInNode` を移して凍結した `Analysis` を出す。済み | 分析の結果の表のテスト(Ruby → `Analysis`)、表のテストすべて | 小 | -| 4 | 呼び出しの表: motion → looks → sound → control / event → sensing → operators → data(表にできる行なし)→ 拡張機能(pen まで済み)。古い `onXxx` 2 つもここで移した。残りは pen 以外の拡張機能 | その領域の表のテスト | なし | -| 5 | 仕上げの段: `targetCodeToBlocks` の後半を `_finish()`(`finish.js`)へ。`targetCodeToBlocks` は 4 段を順に呼ぶだけにする。済み | 表のテストすべて、往復テスト | なし | -| 6 | class / module / initialize の判断を分析へ移す | `class.test.js`、`module.test.js`、`initialize-round-trip.test.js`、`ruby-roundtrip-class-*.test.js` | なし | +| 順 | すること | 振る舞いを固定するテスト | 効率 | +| --- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------- | +| 1 | 解析の索引: 行の表、ノードの種類名をクラスごとに覚える(`nodeTypeName`)。済み | 表のテストすべて、`line-for-offset.test.js`、`multibyte-offset.test.js` | 小 | +| 2 | 変換の巻き戻しを journal に(`_saveContext` を写さない)。済み | 表のテストすべて、`orphan-blocks.test.js`、`target-applier-transaction.test.js`、往復テスト | **大**(いま最も時間を使う) | +| 3 | 分析の段: `forEachNode` を作り、`_collectVariableUses` と `_countProcedureCallsInNode` を移して凍結した `Analysis` を出す。済み | 分析の結果の表のテスト(Ruby → `Analysis`)、表のテストすべて | 小 | +| 4 | 呼び出しの表: motion → looks → sound → control / event → sensing → operators → data(表にできる行なし)→ 拡張機能(pen まで済み)。古い `onXxx` 2 つもここで移した。残りは pen 以外の拡張機能 | その領域の表のテスト | なし | +| 5 | 仕上げの段: `targetCodeToBlocks` の後半を `_finish()`(`finish.js`)へ。`targetCodeToBlocks` は 4 段を順に呼ぶだけにする。済み | 表のテストすべて、往復テスト | なし | +| 6 | class / module / initialize の判断を分析へ移し(`class-analysis.js`)、部品を段ごとに分ける(`stages.js`)。済み | `class.test.js`、`module.test.js`、`initialize-round-trip.test.js`、`super.test.js`、`ruby-roundtrip-class-*.test.js`、`stages.test.js` | なし | -1・2 は振る舞いを変えずに速くするだけなので先に行う。3 以降は、分析の表ができると変換の部品が `_context` を書きかえなくなり、`Object.assign` で混ぜている部品を段ごとのモジュールへ分けられるようになる(14 の部品を分けるのは 6 のあと)。 +1・2 は振る舞いを変えずに速くするだけなので先に行う。3 以降は、分析の表ができると変換の部品が構造を決めるために `_context` を書きかえなくなり、部品を段ごとのモジュールへ分けられるようになる(分けたのは 6)。 ## 実行の効率 diff --git a/docs/smalruby-language-spec.ja.md b/docs/smalruby-language-spec.ja.md index ef7e528ab61..ec132477b0b 100644 --- a/docs/smalruby-language-spec.ja.md +++ b/docs/smalruby-language-spec.ja.md @@ -435,6 +435,18 @@ greet("こんにちは") - メソッドのオーバーロードはできません - 再帰呼び出しはできません +**画面を再描画せずに実行する**: 定義ブロックの「画面を再描画せずに実行する」は、`def` の前に `without_screen_refresh` を書きます(`private def foo` と同じ形)。`def` の前に書かなければ、ふつうの定義ブロック(画面を再描画する)になります。 + +```ruby +without_screen_refresh def 学習する(n) + n.times do + @見る長さ += 1 + end +end +``` + +**メソッドにできない名前の定義ブロック**: 数字で始まる名前(「1 文字えらぶ」)や Ruby の予約語(`end`・`if` など)の名前は、Ruby では前に `_` を付けて書きます(`def _1_文字えらぶ` / 呼び出しも `_1_文字えらぶ`)。ブロックに戻すと `_` は取れます(「1_文字えらぶ」)。`_1` から `_9` は Ruby のブロックの番号指定パラメータで名前にできないので、1 けたの数字だけの名前は `__` を付けます(「1」は `__1`)。もとから `_` で始まる同じ形の名前(「_1x」「_end」)は、もう 1 つ `_` を付けます(`__1x`・`__end`)。名前の中の空白は `_` になります(ブロックに戻しても `_` のまま)。 + ### 戻り値 ```ruby @@ -782,6 +794,8 @@ hide_list("@items") # リストの非表示 say(@items) # リストそのもの(「リスト items」ブロック)を値として渡す ``` +ブロックの「(リスト) の (k) 番目」「(文字列) の (k) 番目の文字」のように 1 から数える番号は、Ruby では `@items[@k - 1]` / `@s[@k - 1]` と書く。添字が `式 - 1`(式から整数の `1` を引く形)のときは、ブロックに戻すと「(式) 番目」になる(`@items[@k - 1]` は「(k) 番目」、`@items[rand(1..@n) - 1]` は「(1 から n までの乱数) 番目」)。`[]` / `[]=` / `insert` / `delete_at` のどれも同じ。そのほかの添字(`@items[@k]`、`@items[@k - 2]`、`@items[3 - 1]`)は「(添字 + 1) 番目」になる。 + 同じ `@a` を変数とリストの両方には使えない(Scratch では同じ名前の変数とリストを持てるが、Ruby の `@a` は 1 つ)。そのため、スプライト(またはステージ)に同じ名前の変数 `a` とリスト `a` の両方があるときだけ、Ruby ではリストを `@_a_list_`(ステージは `$_a_list_`)と書く。ブロックに戻すとリスト `a` になる(名前は `a` のまま)。同じスプライトに `_a_list_` という名前の変数かリストもあるときは、リスト `a` を `@_a_list2_`(それもあれば `@_a_list3_`、…)と書き、名前が重ならないようにする(`@_a_list2_` がリスト `a` になるのは `@_a_list_` が別の変数かリストのときだけ。`@_a_list3_` は `@_a_list_` と `@_a_list2_` の両方がそうのときだけ)。両方があるときの `@a` は変数 `a`。`@_a_list_` のような名前の変数やリストを自分で作っていたときは、その名前のまま読む(スプライトに `_a_list_` という名前の変数かリストがある、`@_a_list_ = 0` のように数や文字列を入れている、または `a` という名前の変数・リストがどこにも無いとき)。`@a = 0` と `@a = []` のように 1 つの `@a` を両方に使うと、ブロックに変えるときにどの行かがわかるエラーになる。リストを値として読むだけ(`@a = []` のあとの `say(@a)`)はエラーにならない。文字列を入れた変数の `length` / `include?` / `empty?` / `[i]` は文字列のブロックになり、リストは作られない。`index` は文字列のブロックが無いので、文字列だけを入れる名前の `@a.index("x")` は「文字列の『index』はブロックにできません」というどの行かがわかるエラーになる(リストのエラーにはならない)。どちらとして使うかはコード全体から決める(書いた順によらない): 配列(`[]`)を入れる・`push` / `<<` / `insert` / `delete_at` / `clear` / `@a[i] = x` を使う名前はリスト、それ以外の値(文字列・数・`gets` など)だけを入れる名前は変数として読む。メソッドやイベントの中で代入より先に `@a.length` を読んでも、最後に数を入れても同じ。コードからわからないときは、スプライト(またはステージ)にあるものから決める: 変数だけ(または変数とリストの両方)があれば変数、リストだけがあればリストとして読む(`say(@a)` もリストを読む)。どちらも無く、どちらも書いていない名前(`say(@a.length)` だけ)はリストとして読む。リストとして使っていたコードを変数に書きかえたとき(`@a = []` → `@a = 0`)は、スプライト(またはステージ)にあるリストはそのまま残り、変数がとなりに作られる。このコードでリストとして使っていなければエラーにならない。ローカル変数は、別々のメソッドや、別々のイベント(`when_flag_clicked do` などのブロック)の中では別の変数なので、片方で文字列・もう片方でリストに使ってもエラーにならない(ブロックの外で同じ名前に代入しているときは、ブロックの中もその変数なので、同じ名前を両方に使うとエラーになる)。 ## 5. サポートされていないRuby構文 diff --git a/docs/smalruby-language-spec.md b/docs/smalruby-language-spec.md index d3b84d64e5c..e47344cb22a 100644 --- a/docs/smalruby-language-spec.md +++ b/docs/smalruby-language-spec.md @@ -406,6 +406,18 @@ greet("hello") - Method overloading is not supported - Recursion is not supported +**Run without screen refresh**: "Run without screen refresh" of a custom block is written `without_screen_refresh` before `def` (the same form as `private def foo`). Without it, the custom block refreshes the screen as usual. + +```ruby +without_screen_refresh def learn(n) + n.times do + @length += 1 + end +end +``` + +**Custom block names that cannot be method names**: a name that starts with a digit ("1 pick letter") or is a reserved word of Ruby (`end`, `if`, ...) gets `_` in front in Ruby (`def _1_pick_letter`, called as `_1_pick_letter`). Back in the blocks the `_` is taken off ("1_pick_letter"). `_1` to `_9` are the numbered parameters of Ruby blocks, so a name that is one digit gets `__` ("1" is `__1`). A name of the same form that already starts with `_` ("_1x", "_end") gets one more `_` (`__1x`, `__end`). A space in a name becomes `_` (it stays `_` in the blocks). + ### Return Values ```ruby @@ -740,6 +752,8 @@ hide_list("@items") # Hide list say(@items) # Pass the list itself (the list reporter block) as a value ``` +A number counted from 1 in the blocks ("item (k) of (list)", "letter (k) of (string)") is written `@items[@k - 1]` / `@s[@k - 1]` in Ruby. When the index is `expression - 1` (the integer `1` subtracted from an expression), it comes back to the blocks as "item (expression) of" (`@items[@k - 1]` is "item (k)", `@items[rand(1..@n) - 1]` is "item (pick random 1 to n)"). It is the same for `[]` / `[]=` / `insert` / `delete_at`. Other indexes (`@items[@k]`, `@items[@k - 2]`, `@items[3 - 1]`) become "item (index + 1)". + One name cannot be both a variable and a list (Scratch can have a variable and a list of the same name, but Ruby has one `@a`). Using a name as both, like `@a = 0` and `@a = []`, is an error that tells the lines when the code is turned into blocks. Only reading a list as a value (`say(@a)` after `@a = []`) is not an error. `length` / `include?` / `empty?` / `[i]` of a variable set to a string become string blocks and make no list. `index` has no string block, so `@a.index("x")` of a name set only to strings is an error that tells the line and says a string has no block for it (not the list error). When the code is rewritten from a list to a variable (`@a = []` → `@a = 0`), the list that the sprite (or the stage) already has stays, and the variable is made beside it: a list that this code does not use is not an error. ## 5. Unsupported Ruby Syntax diff --git a/docs/standard-assignments/README.md b/docs/standard-assignments/README.md new file mode 100644 index 00000000000..28a7012f798 --- /dev/null +++ b/docs/standard-assignments/README.md @@ -0,0 +1,91 @@ +# 標準課題(assignments/) + +> **🆕 Smalruby 独自** — upstream に存在しない、Smalruby のために新規追加された機能 + +クラス管理で先生が使える「標準課題」を、エディタと一緒に `https://smalruby.app/assignments/` で公開する。 +授業 1 時間を 1 つの課題とし、単元は課題の並び(シリーズ)にする。ワークシートは課題の資料の 1 つ。 + +いまあるシリーズ: + +| シリーズ | 内容 | 合わせて使うレッスン | +|---|---|---| +| `es-pg-kyou-kara-programmer` | 小学 4〜6 年のプログラミングの時間。1 つめの課題「はじめの一歩」は、スモウルビーの地図(`map.pdf`)と最初の 5 分の台本(先生用・`script.pdf`) | 「きょうからプログラマー」(`docs/lessons/design.md` の「はじめの一歩」) | +| `jhs-tech-d2-chat` | 中学校 技術・家庭科〈技術分野〉D(2)「双方向性のあるコンテンツ」8 時間 | 「チャットをつくろう」(対応は `docs/lessons/design.md` の「ワークシートとのリンク」) | + +「はじめの一歩」は単元ではないが、レッスン「きょうからプログラマー」を使う小学校の授業の 1 時間めなので、そのレッスンに合わせたシリーズの 1 つめの課題にした(あとの時間の課題を同じシリーズに足せる)。小学校のプログラミングは決まった教科の単元ではないので、ID の教科と単元の部分は `pg`(プログラミング)とコースの名前(`kyou-kara-programmer`)にした。 + +## 決まりごと + +| 項目 | 決まり | +|---|---| +| 置くもの | **成果物だけ**(課題の説明の JSON・PDF・sb3)。原本(ワークシートの HTML)と生成スクリプトはリポジトリの外に置く | +| ライセンス | **CC0 1.0**(`assignments/LICENSE`)。リポジトリのほかの部分のライセンスとは別。CC0 にできない素材(Scratch のライブラリの絵など)は入れない | +| 単位 | 1 時間 = 1 課題(`hours: 1`)。単元はシリーズ(`series.json` の `assignments` の順) | +| 学校の種類 | `es`(小学校)・`jhs`(中学校)。小学校のように教科の単元が決まっていないときは、ID の教科を `pg`、単元をレッスンのコースの名前にする | +| ID | `<学校の種類>-<教科>-<学習指導要領の単元>-<題材>-<番号>-<内容>`(例: `jhs-tech-d2-chat-01-intro`)。シリーズの ID は課題の ID の先頭(`jhs-tech-d2-chat`) | +| URL | `/assignments/<ID>/` が最新、`/assignments/<ID>/<版>/` が版を固定した URL | +| 版 | `x.y.z`。**一度置いた版のディレクトリは変えない**。直すときは新しい版のディレクトリを足し、`<ID>/` をその版と同じ中身にする | +| 公開するもの・しないもの | ワークシート(生徒用・先生用)と評価規準・ルーブリックは公開する。期末試験の問題は公開しない | +| スターター(sb3) | いまは全部なし(`starter: null`) | + +## ディレクトリ + +``` +assignments/ + index.html 課題の一覧のページ(smalruby.app/assignments/) + index.json シリーズと課題の一覧 + LICENSE CC0 1.0 + README.md リポジトリを読む人向け(公開しない) + <シリーズの ID>/ + series.json rubric.pdf 最新 + <版>/series.json <版>/rubric.pdf 版を固定 + <課題の ID>/ + assignment.json worksheet.pdf worksheet-teacher.pdf 最新 + <版>/assignment.json <版>/worksheet.pdf <版>/worksheet-teacher.pdf +``` + +資料のファイル名は課題ごとに `assignment.json` の `files` に書く(「はじめの一歩」は `map.pdf`・`script.pdf`)。 + +同じ PDF が最新と版の 2 か所にあるが、Git は同じ中身を 1 つとして持つので、リポジトリの大きさは増えない。 + +## assignment.json + +| 項目 | 内容 | +|---|---| +| `schemaVersion` | この形の版(いまは `1`) | +| `id` / `version` | 課題の ID と版 | +| `series` / `number` | シリーズの ID と、シリーズの中の順番(1 から) | +| `title` / `goal` | 課題の名前とめあて | +| `schoolType` / `subject` / `curriculum` / `grade` / `hours` | 学校の種類(`jhs` など)・教科・学習指導要領の単元・学年・時間数 | +| `worksheetPages` | ワークシート全体の中のページ(0 から)。ワークシートの無い課題(はじめの一歩)には無い | +| `lessons` | 合わせて使うスモウルビーのレッスン(`course` = コースの ID、`lessons` / `challenges` = レッスン・チャレンジの ID。`src/lib/lessons/courses.js`) | +| `submit` | 提出するもの(`project` = 作品の名前の例、`worksheet` = ワークシートを提出するか) | +| `files` | 資料(`file` = ファイル名、`kind` = 種類〔`worksheet` / `rubric` / `map`(スモウルビーの地図)/ `script`(授業の台本)〕、`audience` = `student` / `teacher`) | +| `starter` | スターターの sb3(いまは `null`) | +| `license` | `CC0-1.0` | + +`series.json` は `id` / `version` / `title` / `description` / `assignments`(課題の ID の並び)/ `files`(評価規準など。無ければ空の配列)を持つ。 + +課題テンプレート(クラス管理で標準課題から課題を作る機能)は、これらの JSON を読む形にする(まだ無い)。 + +## 公開のしかた + +- ビルドで `assignments/` をそのまま `build/assignments/`(本番は `dist/assignments/`)へコピーする + (`packages/scratch-gui/webpack.config.js` の CopyWebpackPlugin。マーカー `standard assignments`)。`README.md` はコピーしない。 +- PWA の precache には入れない(PDF は授業で印刷するもので、エディタを使うのに要らないため)。 +- ブランチのプレビュー(`preview.smalruby.app/<slug>/assignments/`)でも見られる。 + +## 課題を足す・直す + +1. 原本(リポジトリの外)を直し、PDF を作り直す。公開版では、CC0 にできない素材と、公開しない資料への参照を外す。 +2. 新しい版のディレクトリ `<ID>/<新しい版>/` に置き、`<ID>/` をその版と同じ中身にする。`index.json` の版も上げる。 +3. 新しい課題・シリーズは `index.json` と `index.html` に足す。 +4. `packages/scratch-gui/test/unit/standard-assignments.test.js` を流す(最新と版の中身が同じか、ID・版・レッスンの ID が正しいか、一覧のページから全部の資料にリンクしているか)。 + +## 主要ファイル + +| ファイル | 役割 | +|---|---| +| `assignments/` | 標準課題の成果物 | +| `packages/scratch-gui/webpack.config.js` | `assignments/` のコピーと precache からの除外 | +| `packages/scratch-gui/test/unit/standard-assignments.test.js` | 決まりごとのテスト | diff --git a/docs/tutorial/README.md b/docs/tutorial/README.md index a92007c29d2..5dfd834768b 100644 --- a/docs/tutorial/README.md +++ b/docs/tutorial/README.md @@ -28,7 +28,9 @@ URL パラメータ `?tutorial=<urlId>`(例: `?tutorial=getStarted`)で直 2. 「次へ」「前へ」で進む 3. 完了で閉じる -Smalruby 独自のチュートリアル(「さあ、始めましょう」やメッセージ送信シリーズ)が並ぶ。タグで「ルビー」「メッシュ」フィルタが可能。 +上流(Scratch v13.7.2)のチュートリアルがそのまま並ぶ(スモウルビー独自のチュートリアルは無い。学習の入口は [`docs/lessons/`](../lessons/) のレッスン)。 + +前にスモウルビーにあったチュートリアルの `?tutorial=<urlId>`(`chat1Basic1` など)はもう開かない。こうしたリンクが使われているかを数えるため、見つからない `urlId` で開かれたら GA に送る(下の「GA の計測」)。 ### Ruby タブオンボーディング (Smalruby 独自) @@ -50,9 +52,10 @@ Smalruby Classroom の各フェーズ(教師ログイン、クラス作成、 | ファイル | 役割 | |---|---| -| `packages/scratch-gui/src/containers/cards.jsx` | チュートリアルカードのコンテナ(Smalruby: glow animation 追加)| +| `packages/scratch-gui/src/containers/cards.jsx` | チュートリアルカードのコンテナ(上流のまま)| | `packages/scratch-gui/src/components/cards/` | カード UI | -| `packages/scratch-gui/src/containers/tips-library.jsx` | ヒント / チュートリアル一覧 | +| `packages/scratch-gui/src/containers/tips-library.jsx` | ヒント / チュートリアル一覧(上流のまま)| +| `packages/scratch-gui/src/lib/tutorial-from-url.js` | `?tutorial=<urlId>` からチュートリアルを開く(Smalruby: 見つからないときの GA 計測)| #### Smalruby 独自 @@ -61,12 +64,15 @@ Smalruby Classroom の各フェーズ(教師ログイン、クラス作成、 | `packages/scratch-gui/src/reducers/tutorial-onboarding.js` | onboarding state(`MARK_TUTORIAL_SEEN`, `MARK_RUBY_TAB_USED`, `DISMISS_TOOLTIP`)。吹き出し UI は廃止済みで、現在は Ruby タブ訪問の記録に使う | | `packages/scratch-gui/src/components/classroom-tutorial/` | クラスルーム機能のチュートリアル UI(見た目のトークンと OK ボタンは `components/balloon/`) | | `packages/scratch-gui/src/reducers/classroom-tutorial.js` | クラスルームチュートリアル state | -| `packages/scratch-gui/src/lib/libraries/decks/categories/book-promo.jsx` | Block 軸シリーズ共通の書籍プロモ要素(`BOOK` 書誌プレースホルダ / `BOOK_URL` / オープニング・クロージング step ファクトリ)。書誌確定後は `BOOK` 定数 1 箇所を差し替える(Phase 3, #956)。カテゴリは `blockBasics`(第1章)と `blockGames`(第4章)の 2 章のみ。第5章・第6章(`blockMath` / `blockScience`)は元となる書籍 PDF が提供されなかったため対象外(#962)| +| `packages/scratch-gui/src/lib/tutorial-url-analytics.js` | 見つからない `?tutorial=` の GA 計測(送る値を決める純粋関数と送信) | #### Smalruby マーカー (upstream への埋め込み) -`src/containers/cards.jsx`, `src/components/cards/cards.jsx`: -- "tutorial glow animation" — チュートリアルのハイライト用アニメーション +`src/lib/tutorial-from-url.js`: +- "unknown tutorial url analytics" — 見つからない `?tutorial=` を GA に送る + +`webpack.config.js`: +- "lazy tutorial images" — チュートリアルの画像を `gui.js` に埋めこまず、開いたときだけ読みこむ `src/components/menu-bar/menu-bar.jsx`, `src/containers/menu-bar-hoc.jsx`: - "help menu" — 「チュートリアル」「デバッグ」をメニューバーのボタンから「?」メニューの項目へ移す @@ -97,6 +103,16 @@ Smalruby Classroom の各フェーズ(教師ログイン、クラス作成、 特定の onboarding 完了フラグは Redux state にあるが、永続化はプロジェクト state や `legacy-storage` 経由で扱われる場合がある。 +## GA の計測 + +category は `tutorial_url`(`lib/tutorial-url-analytics.js`)。項目は `action` と `label` だけ。 + +| action | いつ送るか | label | +|---|---|---| +| `not_found` | `?tutorial=<urlId>` で開いたのに、その `urlId` のチュートリアルが無いとき(`all` と上流のチュートリアルの `urlId` は送らない) | 前にスモウルビーにあったチュートリアルの `urlId`(`chat1Basic1`〜`chat3Mesh3`・`gettingStartedCostume`・`gettingStartedSprites`・`rubyBasics1Numbers`〜`rubyBasics7Next`)なら、その値。ほかは `unknown`(入力した文字かもしれないので送らない) | + +送られた数を見てから、古いリンクをレッスンへつなぎかえるかを決める。 + ## 関連ドキュメント - [`docs/menu-bar/`](../menu-bar/) — 「?」メニュー(チュートリアル・デバッグの入口) diff --git a/docs/welcome/README.md b/docs/welcome/README.md index bf19b4bb1de..df4de63ba28 100644 --- a/docs/welcome/README.md +++ b/docs/welcome/README.md @@ -43,6 +43,8 @@ CTA: | 途中 | いちばん最近できたチャレンジを「いまのチャレンジ」として、「次のチャレンジへ」と同じ決め方(`lessonsLibraryFocus`)。それで印が付かないとき(後ろのレッスンだけ全部できている)は、コースの並び順で最初のまだできていないチャレンジ | | ぜんぶできた | 付けない(メニューから開いたときと同じ) | +見るのは**最初のコース(きょうからプログラマー)だけ**。それを全部終えても、ほかのコース(授業で先生が開く中 2 の「チャットをつくろう」など)へは案内しない。 + #### 見た目 上流のモーダル(`components/modal/modal.css`)に合わせる: 青い幕(`$color-overlay`)、白い 4px の縁と角丸(`$radius-medium`)、紫のヘッダー(`.header` と同じ高さ `$library-header-height`・`$color-primary`)、紫の主ボタン(`$color-primary`・枠 `1px solid $color-primary`・文字 `$ui-white`。ホバーの見た目は付けず、押したときに `$color-primary-dark`)。ボタンの形とフォーカス(`:focus-visible` で 2px の紫の線を 2px 外に)は [`docs/design-system/components/README.md`](../design-system/components/README.md) の「独自の画面で使う形」に合わせる。角丸・文字・余白は `smalruby-tokens.css` のトークンで書く([`docs/design-system/tokens.md`](../design-system/tokens.md))。 diff --git a/infra/smalruby-web-hosting/.env.example b/infra/smalruby-web-hosting/.env.example index 86dd1aa321f..24f2a3187eb 100644 --- a/infra/smalruby-web-hosting/.env.example +++ b/infra/smalruby-web-hosting/.env.example @@ -10,6 +10,7 @@ # AWS CDK Stage (stg / prod) # - stg: creates preview.smalruby.app (hosted zone, S3 + CloudFront, ACM, CI role) for branch previews # - prod: creates the smalruby.app delivery (S3 + CloudFront + CI role, no custom domain yet) +# and the smalruby.app hosted zone (records copied from onamae.com, RETAIN) STAGE=stg # AWS Configuration (optional: CDK_DEFAULT_ACCOUNT/CDK_DEFAULT_REGION from AWS CLI take priority) diff --git a/infra/smalruby-web-hosting/README.md b/infra/smalruby-web-hosting/README.md index 31affa9a2fe..55c5dffd1de 100644 --- a/infra/smalruby-web-hosting/README.md +++ b/infra/smalruby-web-hosting/README.md @@ -12,7 +12,7 @@ Route 53 ホストゾーン、S3(非公開)+ CloudFront(OAC)、ACM 証 | Stage | Stack | 作るもの | |-------|-------|----------| | stg | `SmalrubyWebHostingStack-stg` | `preview.smalruby.app` のホストゾーン(`RETAIN`)と配信基盤。NS・ゾーン ID・CI 用ロール ARN・バケット名・ディストリビューション ID を Output | -| prod | `SmalrubyWebHostingStack` | 何も作らない(空のスタック) | +| prod | `SmalrubyWebHostingStack` | 本番 smalruby.app の配信基盤(S3 + CloudFront + CI 用ロール。独自ドメインはまだ無い)と、ホストゾーン `smalruby.app`(`RETAIN`。お名前.com のレコードを写したもの)。ゾーン ID・NS も Output | ## Commands diff --git a/infra/smalruby-web-hosting/lib/site-zone-records.ts b/infra/smalruby-web-hosting/lib/site-zone-records.ts new file mode 100644 index 00000000000..12e0744d363 --- /dev/null +++ b/infra/smalruby-web-hosting/lib/site-zone-records.ts @@ -0,0 +1,87 @@ +/** + * Route 53 に写す `smalruby.app` のレコード(EPIC #1931 の段 2・Issue #2000)。 + * + * 値はお名前.com のゾーンのエクスポート(BIND 形式)と同じにする。ネームサーバーを + * お名前.com から Route 53 へ変えた瞬間に、外から見える答えが変わらないようにするため + * (docs/hosting/README.md の「DNS の切り替え」)。値を変えるときは、お名前.com 側も同じに + * そろえるか、切り替え後であることを確かめてからにする。 + * + * 写さないもの: + * - apex の NS / SOA(Route 53 のゾーンが自分のものを持つ) + * - `everdiary.smalruby.app` A(使っていないことを人間が確かめ、お名前.com からも消した) + * - ワイルドカード(docs/security/github-pages-subdomain-takeover.md) + */ + +/** 本番のゾーン名。作り直すと NS が変わるので変えない。 */ +export const SITE_ZONE_NAME = 'smalruby.app'; + +/** + * apex の A(いまの GitHub Pages)。CloudFront へ向けるのは別の変更(#2007)。 + * お名前.com では TTL 3600 だが、切り替えや戻しを早く効かせるため Route 53 では 300 にする。 + */ +export const SITE_APEX_A_TTL_SECONDS = 300; +export const SITE_APEX_A_VALUES = [ + '185.199.108.153', + '185.199.109.153', + '185.199.110.153', + '185.199.111.153', +]; + +/** Google Search Console の所有確認(お名前.com では TTL 300)。 */ +export const SITE_APEX_TXT_TTL_SECONDS = 300; +export const SITE_APEX_TXT_VALUES = [ + 'google-site-verification=IjEgIRcoKO9cJVQAqtwUZH7WfDtA9ujP2zRCJUE8vZA', +]; + +/** + * GitHub の組織のドメイン検証。**消さない**(サブドメイン乗っ取り対策の Layer 1。 + * docs/security/github-pages-subdomain-takeover.md)。 + */ +export const SITE_GITHUB_PAGES_CHALLENGE_NAME = '_github-pages-challenge-smalruby'; +export const SITE_GITHUB_PAGES_CHALLENGE_TTL_SECONDS = 3600; +export const SITE_GITHUB_PAGES_CHALLENGE_VALUES = ['a445b86bba88094e49c43b9af4b04d']; + +/** + * 証明書を発行してよい認証局。ACM(Amazon の 4 つ)と、GitHub Pages が使う Let's Encrypt。 + * ワイルドカード証明書はどこにも出させない(issuewild ";")。 + */ +export const SITE_CAA_TTL_SECONDS = 3600; +export const SITE_CAA_VALUES: { tag: 'issue' | 'issuewild'; value: string }[] = [ + { tag: 'issue', value: 'amazon.com' }, + { tag: 'issue', value: 'amazonaws.com' }, + { tag: 'issue', value: 'amazontrust.com' }, + { tag: 'issue', value: 'awstrust.com' }, + { tag: 'issue', value: 'letsencrypt.org' }, + { tag: 'issuewild', value: ';' }, +]; + +/** + * サブドメインの委任(それぞれ別の Route 53 のゾーン)。いまお名前.com に書いてある NS を + * そのまま写す。ゾーンを作り直すと NS が変わるので、そのときはここも直す。 + * 末尾の `.` は付けたままにする(ゾーン名を足した相対名と読まれないように。照合スクリプトも同じ)。 + */ +export const SITE_DELEGATION_TTL_SECONDS = 900; +export const SITE_DELEGATIONS: { name: string; id: string; nameServers: string[] }[] = [ + { + // API 群のカスタムドメイン用のゾーン(このプロジェクトの外で管理している)。 + name: 'api', + id: 'SiteApiDelegation', + nameServers: [ + 'ns-1254.awsdns-28.org.', + 'ns-1861.awsdns-40.co.uk.', + 'ns-457.awsdns-57.com.', + 'ns-703.awsdns-23.net.', + ], + }, + { + // ブランチプレビュー(このプロジェクトの stg のゾーン `PreviewHostedZone`)。 + name: 'preview', + id: 'SitePreviewDelegation', + nameServers: [ + 'ns-1447.awsdns-52.org.', + 'ns-1984.awsdns-56.co.uk.', + 'ns-233.awsdns-29.com.', + 'ns-857.awsdns-43.net.', + ], + }, +]; diff --git a/infra/smalruby-web-hosting/lib/web-hosting-stack.ts b/infra/smalruby-web-hosting/lib/web-hosting-stack.ts index 8fe8c53ba35..043358e2340 100644 --- a/infra/smalruby-web-hosting/lib/web-hosting-stack.ts +++ b/infra/smalruby-web-hosting/lib/web-hosting-stack.ts @@ -8,6 +8,20 @@ import * as route53 from 'aws-cdk-lib/aws-route53'; import * as targets from 'aws-cdk-lib/aws-route53-targets'; import * as s3 from 'aws-cdk-lib/aws-s3'; import { Construct } from 'constructs'; +import { + SITE_APEX_A_TTL_SECONDS, + SITE_APEX_A_VALUES, + SITE_APEX_TXT_TTL_SECONDS, + SITE_APEX_TXT_VALUES, + SITE_CAA_TTL_SECONDS, + SITE_CAA_VALUES, + SITE_DELEGATION_TTL_SECONDS, + SITE_DELEGATIONS, + SITE_GITHUB_PAGES_CHALLENGE_NAME, + SITE_GITHUB_PAGES_CHALLENGE_TTL_SECONDS, + SITE_GITHUB_PAGES_CHALLENGE_VALUES, + SITE_ZONE_NAME, +} from './site-zone-records'; /** プレビュー配信用のゾーン名(お名前.com から NS を委任する)。 */ export const PREVIEW_ZONE_NAME = 'preview.smalruby.app'; @@ -52,6 +66,16 @@ export const SITE_DEPLOY_SUBJECTS = [ */ export const SITE_NONCURRENT_VERSION_EXPIRATION_DAYS = 30; +/** + * 本番 CloudFront のアクセスログを残す日数(人間が 30 日に決めた)。 + * ログには利用者の IP アドレスが入るので、必要な間だけ残して消す(docs/hosting/README.md)。 + * 変えるときはこの値だけを変える(バケットのライフサイクルが追従する)。 + */ +export const SITE_ACCESS_LOG_RETENTION_DAYS = 30; + +/** アクセスログのオブジェクトキーの接頭辞(ログのバケットを後でほかの用途と分けられるように付ける)。 */ +export const SITE_ACCESS_LOG_PREFIX = 'cloudfront/smalruby.app/'; + /** GitHub Actions の OIDC プロバイダ(アカウントに 1 つだけ。Deploy Infra 用に作成済みのものを使う)。 */ const GITHUB_OIDC_HOST = 'token.actions.githubusercontent.com'; @@ -61,6 +85,7 @@ export interface SmalrubyWebHostingStackProps extends cdk.StackProps { export class SmalrubyWebHostingStack extends cdk.Stack { public readonly previewZone?: route53.PublicHostedZone; + public readonly siteZone?: route53.PublicHostedZone; constructor(scope: Construct, id: string, props: SmalrubyWebHostingStackProps) { super(scope, id, props); @@ -72,9 +97,11 @@ export class SmalrubyWebHostingStack extends cdk.Stack { cdk.Tags.of(this).add('Service', 'Route53'); cdk.Tags.of(this).add('ManagedBy', 'CDK'); - // 本番(smalruby.app)の配信基盤は prod だけに作る。独自ドメインと DNS はまだ付けない - // (smalruby.app のゾーンを Route 53 に移してから、別の変更で足す)。 + // 本番(smalruby.app)の配信基盤と DNS のゾーンは prod だけに作る。ゾーンにはいまの + // お名前.com のレコードを同じ値で写すだけで、CloudFront の独自ドメインはまだ付けない + // (お名前.com のネームサーバーを Route 53 に変えてから、別の変更で足す)。 if (stage === SITE_STAGE) { + this.siteZone = this.createSiteZone(); this.createSiteDelivery(); return; } @@ -201,14 +228,78 @@ export class SmalrubyWebHostingStack extends cdk.Stack { }); } + /** + * 本番のパブリックホストゾーン `smalruby.app` と、お名前.com から写したレコード。 + * + * お名前.com のネームサーバーを Route 53 の 4 本に変えるまで(人間が夜間に行う)、誰もこの + * ゾーンを引かないので、作っただけではいまの本番に何も起きない。変えた瞬間から答えが + * 変わらないよう、値はお名前.com と同じにする(site-zone-records.ts)。 + */ + private createSiteZone(): route53.PublicHostedZone { + const zone = new route53.PublicHostedZone(this, 'SiteHostedZone', { + zoneName: SITE_ZONE_NAME, + comment: 'Smalruby production (smalruby.app, copied from onamae.com)', + }); + // 作り直すと NS が変わり、お名前.com に登録したネームサーバーと食い違うので残す + // (preview.smalruby.app と同じ扱い。論理 ID・スタック名・zoneName を変えない)。 + zone.applyRemovalPolicy(cdk.RemovalPolicy.RETAIN); + + // apex の A はいまの GitHub Pages。CloudFront の ALIAS に変えるのは別の変更。 + new route53.ARecord(this, 'SiteApexA', { + zone, + target: route53.RecordTarget.fromIpAddresses(...SITE_APEX_A_VALUES), + ttl: cdk.Duration.seconds(SITE_APEX_A_TTL_SECONDS), + }); + new route53.TxtRecord(this, 'SiteApexTxt', { + zone, + values: SITE_APEX_TXT_VALUES, + ttl: cdk.Duration.seconds(SITE_APEX_TXT_TTL_SECONDS), + }); + // GitHub の組織のドメイン検証。消さない(docs/security/github-pages-subdomain-takeover.md)。 + new route53.TxtRecord(this, 'SiteGitHubPagesChallenge', { + zone, + recordName: SITE_GITHUB_PAGES_CHALLENGE_NAME, + values: SITE_GITHUB_PAGES_CHALLENGE_VALUES, + ttl: cdk.Duration.seconds(SITE_GITHUB_PAGES_CHALLENGE_TTL_SECONDS), + }); + new route53.CaaRecord(this, 'SiteApexCaa', { + zone, + values: SITE_CAA_VALUES.map(({ tag, value }) => ({ + flag: 0, + tag: tag === 'issue' ? route53.CaaTag.ISSUE : route53.CaaTag.ISSUEWILD, + value, + })), + ttl: cdk.Duration.seconds(SITE_CAA_TTL_SECONDS), + }); + // api. と preview. はそれぞれ別のゾーンへの委任を、いまの NS のまま写す。 + for (const { name, id, nameServers } of SITE_DELEGATIONS) { + new route53.NsRecord(this, id, { + zone, + recordName: name, + values: nameServers, + ttl: cdk.Duration.seconds(SITE_DELEGATION_TTL_SECONDS), + }); + } + + new cdk.CfnOutput(this, 'SiteHostedZoneId', { + value: zone.hostedZoneId, + description: `Route 53 hosted zone id of ${SITE_ZONE_NAME}`, + }); + new cdk.CfnOutput(this, 'SiteHostedZoneNameServers', { + value: cdk.Fn.join(',', zone.hostedZoneNameServers!), + description: `Name servers to register at onamae.com for ${SITE_ZONE_NAME}`, + }); + return zone; + } + /** * 本番(smalruby.app)の配信基盤(S3 + CloudFront + CI 用ロール)。 * * いまの本番は GitHub Pages で配信しており、これは切り替え先として並べて作るだけ。 - * 独自ドメイン(smalruby.app)・証明書・DNS はまだ付けないので、CloudFront の既定の + * 独自ドメイン(smalruby.app)・証明書・apex の ALIAS はまだ付けないので、CloudFront の既定の * ドメイン(`*.cloudfront.net`)でしか見えず、いまの本番には影響しない。 - * 証明書は smalruby.app のゾーンを Route 53 に移してから足す(委任前だと DNS 検証が - * 終わらないのはプレビューと同じ)。 + * 証明書は、お名前.com のネームサーバーを `createSiteZone()` のゾーンに変えてから足す + * (変える前だと DNS 検証が終わらないのはプレビューと同じ)。 */ private createSiteDelivery(): void { const bucket = new s3.Bucket(this, 'SiteBucket', { @@ -265,8 +356,17 @@ export class SmalrubyWebHostingStack extends cdk.Stack { }, ); + const logBucket = this.createSiteAccessLogBucket(); + const distribution = new cloudfront.Distribution(this, 'SiteDistribution', { comment: 'Smalruby production site (smalruby.app, not attached yet)', + // 標準ログ(従来の S3 配信)。v2(CloudWatch Logs の配信)は S3 へ出すと 1 GB あたりの + // 料金がかかり、CloudFront の配信元の設定を us-east-1 に置く必要がある(このスタックは + // ap-northeast-1 で、スタックは分けない)。従来の方式は配信が無料で、プロパティを足すだけで済む。 + enableLogging: true, + logBucket, + logFilePrefix: SITE_ACCESS_LOG_PREFIX, + logIncludesCookies: false, // minimumProtocolVersion(TLS 1.2 以上)は既定の証明書では効かないので、 // smalruby.app の証明書を付けるときに一緒に足す。 httpVersion: cloudfront.HttpVersion.HTTP2_AND_3, @@ -312,6 +412,38 @@ export class SmalrubyWebHostingStack extends cdk.Stack { value: distribution.distributionDomainName, description: 'CloudFront domain name (check before attaching smalruby.app)', }); + new cdk.CfnOutput(this, 'SiteLogBucketName', { + value: logBucket.bucketName, + description: `S3 bucket that keeps CloudFront access logs of smalruby.app (${SITE_ACCESS_LOG_RETENTION_DAYS} days)`, + }); + } + + /** + * 本番 CloudFront のアクセスログ専用バケット。非公開・SSE-S3・SSL のみで、 + * `SITE_ACCESS_LOG_RETENTION_DAYS` を過ぎたログは消す。 + * + * 標準ログ(従来の S3 配信)は CloudFront(awslogsdelivery)がバケットの ACL で書き込むので、 + * ACL を無効にする BUCKET_OWNER_ENFORCED は使えない。BUCKET_OWNER_PREFERRED にして、 + * 書かれたログの持ち主をこのアカウントにする。ACL の付与は特定のアカウント宛てで公開ではないので、 + * Block Public Access は全部 ON のまま使える。 + * ログは取り戻せなくても配信は止まらないので RETAIN にしない(.claude/rules/infra/development.md の + * 「データ保持」)。autoDeleteObjects は付けないので、中身が残っている間は削除が失敗して止まる。 + */ + private createSiteAccessLogBucket(): s3.Bucket { + return new s3.Bucket(this, 'SiteLogBucket', { + blockPublicAccess: s3.BlockPublicAccess.BLOCK_ALL, + encryption: s3.BucketEncryption.S3_MANAGED, + enforceSSL: true, + objectOwnership: s3.ObjectOwnership.BUCKET_OWNER_PREFERRED, + removalPolicy: cdk.RemovalPolicy.DESTROY, + lifecycleRules: [ + { + id: 'ExpireAccessLogs', + expiration: cdk.Duration.days(SITE_ACCESS_LOG_RETENTION_DAYS), + abortIncompleteMultipartUploadAfter: cdk.Duration.days(7), + }, + ], + }); } /** diff --git a/infra/smalruby-web-hosting/test/site-zone.test.ts b/infra/smalruby-web-hosting/test/site-zone.test.ts new file mode 100644 index 00000000000..5a46e2f1968 --- /dev/null +++ b/infra/smalruby-web-hosting/test/site-zone.test.ts @@ -0,0 +1,119 @@ +import * as cdk from 'aws-cdk-lib/core'; +import { Template } from 'aws-cdk-lib/assertions'; +import { SmalrubyWebHostingStack } from '../lib/web-hosting-stack'; + +const env = { account: '123456789012', region: 'ap-northeast-1' }; + +const synth = (stage: string): Template => { + const app = new cdk.App(); + const stack = new SmalrubyWebHostingStack(app, `TestStack-${stage}`, { env, stage }); + return Template.fromStack(stack); +}; + +/** レコードを `名前 型 TTL 値` の 1 行ずつに並べる(照合しやすい形)。 */ +const recordLines = (template: Template): string[] => + Object.values(template.findResources('AWS::Route53::RecordSet')) + .flatMap((r) => + (r.Properties.ResourceRecords as string[]).map( + (v) => `${r.Properties.Name} ${r.Properties.Type} ${r.Properties.TTL} ${v}`, + ), + ) + .sort(); + +// お名前.com のゾーンのエクスポートから、写すものだけを書き写した期待値(SOA・apex の NS・ +// everdiary は写さない。apex の A だけ TTL を 300 に下げる)。 +const EXPECTED = [ + '_github-pages-challenge-smalruby.smalruby.app. TXT 3600 "a445b86bba88094e49c43b9af4b04d"', + 'api.smalruby.app. NS 900 ns-1254.awsdns-28.org.', + 'api.smalruby.app. NS 900 ns-1861.awsdns-40.co.uk.', + 'api.smalruby.app. NS 900 ns-457.awsdns-57.com.', + 'api.smalruby.app. NS 900 ns-703.awsdns-23.net.', + 'preview.smalruby.app. NS 900 ns-1447.awsdns-52.org.', + 'preview.smalruby.app. NS 900 ns-1984.awsdns-56.co.uk.', + 'preview.smalruby.app. NS 900 ns-233.awsdns-29.com.', + 'preview.smalruby.app. NS 900 ns-857.awsdns-43.net.', + 'smalruby.app. A 300 185.199.108.153', + 'smalruby.app. A 300 185.199.109.153', + 'smalruby.app. A 300 185.199.110.153', + 'smalruby.app. A 300 185.199.111.153', + 'smalruby.app. CAA 3600 0 issue "amazon.com"', + 'smalruby.app. CAA 3600 0 issue "amazonaws.com"', + 'smalruby.app. CAA 3600 0 issue "amazontrust.com"', + 'smalruby.app. CAA 3600 0 issue "awstrust.com"', + 'smalruby.app. CAA 3600 0 issue "letsencrypt.org"', + 'smalruby.app. CAA 3600 0 issuewild ";"', + 'smalruby.app. TXT 300 "google-site-verification=IjEgIRcoKO9cJVQAqtwUZH7WfDtA9ujP2zRCJUE8vZA"', +].sort(); + +describe('smalruby.app hosted zone (prod)', () => { + let template: Template; + + beforeAll(() => { + template = synth('prod'); + }); + + test('creates one public hosted zone smalruby.app', () => { + template.resourceCountIs('AWS::Route53::HostedZone', 1); + template.hasResourceProperties('AWS::Route53::HostedZone', { Name: 'smalruby.app.' }); + }); + + test('retains the zone so its name servers never change', () => { + template.hasResource('AWS::Route53::HostedZone', { + DeletionPolicy: 'Retain', + UpdateReplacePolicy: 'Retain', + }); + }); + + test('keeps the zone logical id so the zone is never recreated', () => { + const ids = Object.keys(template.findResources('AWS::Route53::HostedZone')); + expect(ids).toHaveLength(1); + expect(ids[0]).toMatch(/^SiteHostedZone[0-9A-F]{8}$/); + }); + + test('copies the onamae.com records with the same values', () => { + expect(recordLines(template)).toEqual(EXPECTED); + }); + + test('all records belong to the smalruby.app zone', () => { + const zoneId = Object.keys(template.findResources('AWS::Route53::HostedZone'))[0]; + for (const r of Object.values(template.findResources('AWS::Route53::RecordSet'))) { + expect(r.Properties.HostedZoneId).toEqual({ Ref: zoneId }); + } + }); + + test('does not copy the apex NS / SOA, everdiary, or any wildcard', () => { + const sets = Object.values(template.findResources('AWS::Route53::RecordSet')); + const names = sets.map((r) => r.Properties.Name as string); + expect(names.some((n) => n.startsWith('*') || n.includes('\\052'))).toBe(false); + expect(names).not.toContain('everdiary.smalruby.app.'); + expect( + sets.filter( + (r) => + r.Properties.Name === 'smalruby.app.' && + ['NS', 'SOA'].includes(r.Properties.Type), + ), + ).toEqual([]); + }); + + test('keeps the GitHub Pages domain verification TXT', () => { + template.hasResourceProperties('AWS::Route53::RecordSet', { + Name: '_github-pages-challenge-smalruby.smalruby.app.', + Type: 'TXT', + }); + }); + + test('outputs the zone id and the name servers to register at onamae.com', () => { + expect(Object.keys(template.findOutputs('*'))).toEqual( + expect.arrayContaining(['SiteHostedZoneId', 'SiteHostedZoneNameServers']), + ); + }); +}); + +describe('smalruby.app hosted zone (other stages)', () => { + test.each(['stg', 'stg2'])('%s does not create the smalruby.app zone', (stage) => { + const names = Object.values( + synth(stage).findResources('AWS::Route53::HostedZone'), + ).map((r) => r.Properties.Name); + expect(names).not.toContain('smalruby.app.'); + }); +}); diff --git a/infra/smalruby-web-hosting/test/web-hosting.test.ts b/infra/smalruby-web-hosting/test/web-hosting.test.ts index 7687a86d7cb..b24db62f897 100644 --- a/infra/smalruby-web-hosting/test/web-hosting.test.ts +++ b/infra/smalruby-web-hosting/test/web-hosting.test.ts @@ -3,6 +3,8 @@ import { Match, Template } from 'aws-cdk-lib/assertions'; import { PREVIEW_DEFAULT_TTL_SECONDS, PREVIEW_OBJECT_EXPIRATION_DAYS, + SITE_ACCESS_LOG_PREFIX, + SITE_ACCESS_LOG_RETENTION_DAYS, SITE_NONCURRENT_VERSION_EXPIRATION_DAYS, SmalrubyWebHostingStack, } from '../lib/web-hosting-stack'; @@ -46,7 +48,11 @@ describe('SmalrubyWebHostingStack', () => { test('prod creates no preview resources', () => { const template = synth('prod'); - template.resourceCountIs('AWS::Route53::HostedZone', 0); + // prod のゾーンは smalruby.app だけ(preview.smalruby.app は stg にある)。 + const zoneNames = Object.values(template.findResources('AWS::Route53::HostedZone')).map( + (r) => r.Properties.Name, + ); + expect(zoneNames).toEqual(['smalruby.app.']); expect( Object.keys(template.findResources('*')).filter((id) => id.startsWith('Preview')), ).toEqual([]); @@ -76,21 +82,39 @@ describe('SmalrubyWebHostingStack', () => { describe('production site delivery (prod)', () => { let template: Template; + // 本番の配信元(SiteBucket)とアクセスログ(SiteLogBucket)の 2 つがある。 + const bucketById = (prefix: string) => { + const found = Object.entries(template.findResources('AWS::S3::Bucket')).filter(([id]) => + id.startsWith(prefix), + ); + expect(found).toHaveLength(1); + return found[0][1]; + }; + const siteBucket = () => bucketById('SiteBucket'); + const logBucket = () => bucketById('SiteLogBucket'); + beforeAll(() => { template = synth('prod'); }); - test('creates one private, SSL-only, versioned bucket', () => { - template.resourceCountIs('AWS::S3::Bucket', 1); - template.hasResourceProperties('AWS::S3::Bucket', { - PublicAccessBlockConfiguration: { - BlockPublicAcls: true, - BlockPublicPolicy: true, - IgnorePublicAcls: true, - RestrictPublicBuckets: true, - }, - VersioningConfiguration: { Status: 'Enabled' }, - }); + test('creates the site bucket and the access log bucket only', () => { + template.resourceCountIs('AWS::S3::Bucket', 2); + siteBucket(); + logBucket(); + }); + + test('creates one private, SSL-only, versioned site bucket', () => { + expect(siteBucket().Properties).toEqual( + expect.objectContaining({ + PublicAccessBlockConfiguration: { + BlockPublicAcls: true, + BlockPublicPolicy: true, + IgnorePublicAcls: true, + RestrictPublicBuckets: true, + }, + VersioningConfiguration: { Status: 'Enabled' }, + }), + ); template.hasResourceProperties('AWS::S3::BucketPolicy', { PolicyDocument: { Statement: Match.arrayWith([ @@ -104,15 +128,16 @@ describe('SmalrubyWebHostingStack', () => { }); test('retains the bucket (the production origin is never deleted with the stack)', () => { - template.hasResource('AWS::S3::Bucket', { - DeletionPolicy: 'Retain', - UpdateReplacePolicy: 'Retain', - }); + expect(siteBucket()).toEqual( + expect.objectContaining({ + DeletionPolicy: 'Retain', + UpdateReplacePolicy: 'Retain', + }), + ); }); test('never expires the current objects, only old versions', () => { - const buckets = Object.values(template.findResources('AWS::S3::Bucket')); - const rules = buckets[0].Properties.LifecycleConfiguration.Rules; + const rules = siteBucket().Properties.LifecycleConfiguration.Rules; for (const rule of rules) { expect(rule.ExpirationInDays).toBeUndefined(); expect(rule.ExpirationDate).toBeUndefined(); @@ -151,11 +176,89 @@ describe('SmalrubyWebHostingStack', () => { ); }); - test('creates no DNS records or certificates (the live site is untouched)', () => { - template.resourceCountIs('AWS::Route53::HostedZone', 0); - template.resourceCountIs('AWS::Route53::RecordSet', 0); + test('access log bucket is private, encrypted, SSL only and accepts CloudFront logs', () => { + const bucket = logBucket(); + expect(bucket.Properties).toEqual( + expect.objectContaining({ + PublicAccessBlockConfiguration: { + BlockPublicAcls: true, + BlockPublicPolicy: true, + IgnorePublicAcls: true, + RestrictPublicBuckets: true, + }, + BucketEncryption: { + ServerSideEncryptionConfiguration: [ + { ServerSideEncryptionByDefault: { SSEAlgorithm: 'AES256' } }, + ], + }, + // 標準ログは ACL で書き込まれるので ACL を無効にしない(持ち主はこのアカウント)。 + OwnershipControls: { Rules: [{ ObjectOwnership: 'BucketOwnerPreferred' }] }, + }), + ); + expect(bucket.Properties.VersioningConfiguration).toBeUndefined(); + const policies = Object.values(template.findResources('AWS::S3::BucketPolicy')).filter( + (p) => JSON.stringify(p.Properties.Bucket).includes('SiteLogBucket'), + ); + expect(policies).toHaveLength(1); + expect(policies[0].Properties.PolicyDocument.Statement).toEqual( + expect.arrayContaining([ + expect.objectContaining({ + Effect: 'Deny', + Condition: { Bool: { 'aws:SecureTransport': 'false' } }, + }), + ]), + ); + }); + + test('access logs are deleted after the retention period', () => { + // 人間が決めた保持期間(30 日)。変えるときは docs/hosting/README.md も直す。 + expect(SITE_ACCESS_LOG_RETENTION_DAYS).toBe(30); + const rules = logBucket().Properties.LifecycleConfiguration.Rules; + expect(rules).toEqual([ + expect.objectContaining({ + Status: 'Enabled', + ExpirationInDays: SITE_ACCESS_LOG_RETENTION_DAYS, + }), + ]); + }); + + test('access log bucket is not retained (logs are not needed to keep serving)', () => { + expect(logBucket()).toEqual( + expect.objectContaining({ + DeletionPolicy: 'Delete', + UpdateReplacePolicy: 'Delete', + }), + ); + }); + + test('distribution writes standard logs to the log bucket without cookies', () => { + const distribution = Object.values( + template.findResources('AWS::CloudFront::Distribution'), + )[0]; + const logging = distribution.Properties.DistributionConfig.Logging; + expect(logging).toEqual({ + Bucket: { + 'Fn::GetAtt': [expect.stringMatching(/^SiteLogBucket/), 'RegionalDomainName'], + }, + IncludeCookies: false, + Prefix: SITE_ACCESS_LOG_PREFIX, + }); + }); + + test('deploy role cannot touch the access log bucket', () => { + const statements = Object.values(template.findResources('AWS::IAM::Policy')).flatMap( + (p) => p.Properties.PolicyDocument.Statement, + ); + expect(JSON.stringify(statements)).not.toContain('SiteLogBucket'); + }); + + test('creates no certificate or alias to CloudFront yet (the live site is untouched)', () => { template.resourceCountIs('AWS::CertificateManager::Certificate', 0); template.resourceCountIs('AWS::CloudFormation::CustomResource', 0); + const aliases = Object.values( + template.findResources('AWS::Route53::RecordSet'), + ).filter((r) => r.Properties.AliasTarget); + expect(aliases).toEqual([]); }); test('cache policy keeps index.html short and lets hashed assets stay long', () => { @@ -235,6 +338,10 @@ describe('SmalrubyWebHostingStack', () => { 'SiteDeployRoleArn', 'SiteDistributionDomainName', 'SiteDistributionId', + // smalruby.app のゾーン(test/site-zone.test.ts) + 'SiteHostedZoneId', + 'SiteHostedZoneNameServers', + 'SiteLogBucketName', ].sort(), ); }); diff --git a/package.json b/package.json index 2e4ac5061d7..c2cff13523b 100644 --- a/package.json +++ b/package.json @@ -28,8 +28,9 @@ "build:dev": "npm run --workspaces build:dev", "build-monorepo": "cross-env-shell ./scripts/build-monorepo.sh", "clean": "npm run --workspaces clean", - "lint": "npm run lint:secrets && npm run lint --workspace=packages/scratch-vm --workspace=packages/scratch-gui", + "lint": "npm run lint:secrets && npm run test:hosting-scripts && npm run lint --workspace=packages/scratch-vm --workspace=packages/scratch-gui", "lint:secrets": "node --test scripts/check-dev-bypass-token.test.mjs && node scripts/check-dev-bypass-token.mjs", + "test:hosting-scripts": "node --test scripts/hosting/dns-compare.test.mjs scripts/hosting/site-compare.test.mjs", "format": "npm run format --workspace=packages/scratch-vm --workspace=packages/scratch-gui", "format:check": "npm run format:check --workspace=packages/scratch-vm --workspace=packages/scratch-gui", "prepare": "husky install", diff --git a/packages/scratch-gui/.prettierignore b/packages/scratch-gui/.prettierignore index 8d45ea24848..6e70fa5838d 100644 --- a/packages/scratch-gui/.prettierignore +++ b/packages/scratch-gui/.prettierignore @@ -83,6 +83,16 @@ src/components/* !src/components/lesson-task-bar/** !src/components/lesson-hint/ !src/components/lesson-hint/** +!src/components/lesson-part-names/ +!src/components/lesson-part-names/** +!src/components/lesson-part-quiz/ +!src/components/lesson-part-quiz/** +!src/components/lesson-practice-partner/ +!src/components/lesson-practice-partner/** +!src/components/block-activity-diagram/ +!src/components/block-activity-diagram/** +!src/components/lesson-activity-diagram/ +!src/components/lesson-activity-diagram/** !src/components/lessons-library/ !src/components/lessons-library/** !src/components/dncl-mode-notice/** @@ -98,8 +108,6 @@ src/components/* !src/components/lesson-progress-confirm/ !src/components/lesson-progress-confirm/** !src/components/koshien-mock-panel/** -!src/components/mesh-self-sensor-notice/ -!src/components/mesh-self-sensor-notice/** !src/components/mesh-status-button/ !src/components/mesh-status-button/** !src/components/mesh-status-popup/ @@ -218,12 +226,13 @@ src/containers/* !src/containers/google-drive-loader-hoc.jsx !src/containers/koshien-mock-panel.jsx !src/containers/lesson-hint.jsx +!src/containers/lesson-practice-partner.jsx !src/containers/lesson-analytics.jsx !src/containers/lesson-progress-sync.jsx !src/containers/lesson-goal-watcher.jsx +!src/containers/block-activity-diagram.jsx !src/containers/lesson-mode.jsx !src/containers/lessons-library.jsx -!src/containers/mesh-self-sensor-notice.jsx !src/containers/mesh-status-popup.jsx !src/containers/mesh-v2-seat-connect.jsx !src/containers/google-drive-saver-hoc.jsx @@ -244,6 +253,7 @@ src/lib/* !src/lib/lessons/** !src/lib/lesson-dynamic-categories.js !src/lib/ruby-markers.js +!src/lib/ruby-method-name.js !src/lib/dncl/** !src/lib/ruby-to-blocks-converter/ !src/lib/ruby-to-blocks-converter/** @@ -256,7 +266,6 @@ src/lib/* !src/lib/bug-report-api.js !src/lib/koshien-mock-config.js !src/lib/koshien-test-url.js -!src/lib/deck-setup.js !src/lib/avatar-initials.js !src/lib/classroom-api.js !src/lib/classroom-assignment-utils.js @@ -318,7 +327,6 @@ src/lib/* !src/lib/mesh-v2-seat-connect.js !src/lib/mesh-v2-seat-label.js !src/lib/mesh-v2-seat-snapshot.js -!src/lib/mesh-v2-sensor-collision.js !src/lib/mesh-v2-status.js !src/lib/mesh-practice/ !src/lib/mesh-practice/** @@ -360,6 +368,7 @@ src/lib/* !src/lib/use-display-mode.js !src/lib/use-is-narrow-screen.js !src/lib/version-checker.js +!src/lib/tutorial-url-analytics.js # Level 3: src/lib/settings/* # color-mode/ and theme/ are upstream; only these are Smalruby-only. @@ -372,7 +381,6 @@ src/lib/settings/* # Level 3: src/lib/libraries/* src/lib/libraries/* !src/lib/libraries/extensions/ -!src/lib/libraries/decks/ # Level 4: src/lib/libraries/extensions/* src/lib/libraries/extensions/* @@ -388,16 +396,6 @@ src/lib/libraries/extensions/* !src/lib/libraries/extensions/tm2scratch/ !src/lib/libraries/extensions/tm2scratch/** -# Level 4: src/lib/libraries/decks/* -# index.jsx and the other pre-existing deck assets are upstream-derived and -# not (yet) whitelisted; only the new per-category modules are Smalruby-only -# (issue #932). -src/lib/libraries/decks/* -!src/lib/libraries/decks/categories/ -!src/lib/libraries/decks/categories/** -!src/lib/libraries/decks/green-flag-icon.jsx - -# Level 5: src/lib/libraries/decks/categories/* — Smalruby-only (whole directory via `/**`) # ============================================================ # Level 2: src/locales/* @@ -450,6 +448,7 @@ test/helpers/* !test/helpers/menu-xpaths.js !test/helpers/ruby-helper.js !test/helpers/smalruby-mock-state.js +!test/helpers/dynamic-category-opcodes.js # Level 2: test/integration/* test/integration/* @@ -474,12 +473,12 @@ test/integration/* !test/integration/smalruby-lesson1-challenges-5-8.test.js !test/integration/smalruby-lesson1-challenges-9-11.test.js !test/integration/smalruby-help-menu.test.js -!test/integration/smalruby-tutorials.test.js !test/integration/smalruby-lessons.test.js !test/integration/smalruby-lessons-hint.test.js !test/integration/smalruby-lesson-task-bar-full-text.test.js !test/integration/smalruby-lesson-task-bar-layout.test.js !test/integration/smalruby-lessons-first-time-balloons.test.js +!test/integration/smalruby-lesson0.test.js !test/integration/smalruby-lesson1-challenges-1-4.test.js !test/integration/smalruby-lessons-library.test.js !test/integration/smalruby-lessons-en.test.js @@ -508,6 +507,7 @@ test/unit/* !test/unit/make-toolbox-xml-hex.test.js !test/unit/only-blocks-initialization.test.js !test/unit/setup.js +!test/unit/standard-assignments.test.js # Level 3: test/unit/components/* test/unit/components/* @@ -525,20 +525,25 @@ test/unit/components/* !test/unit/components/url-loader-modal.test.jsx !test/unit/components/dncl-mode-notice.test.jsx !test/unit/components/lesson-task-bar.test.jsx +!test/unit/components/lesson-part-names.test.jsx +!test/unit/components/lesson-part-quiz.test.jsx !test/unit/components/sprite-info-compact.test.jsx !test/unit/components/stage-selector-compact.test.jsx !test/unit/components/lesson-hint.test.jsx +!test/unit/components/lesson-hint-nudge.test.jsx +!test/unit/containers/lesson-practice-partner.test.jsx !test/unit/components/balloon.test.jsx !test/unit/components/classroom-tutorial.test.jsx !test/unit/components/lessons-library.test.jsx +!test/unit/components/lesson-activity-diagram.test.jsx !test/unit/components/genai-answer-steps-index-hints.test.jsx !test/unit/components/genai-answer-steps-words.test.jsx !test/unit/components/extension-button-dncl.test.jsx !test/unit/components/connected-step.test.jsx !test/unit/components/lesson-completed-toast.test.jsx +!test/unit/components/lesson-completed-quiz.test.jsx !test/unit/components/lesson-assignment-band.test.jsx !test/unit/components/lesson-progress-confirm.test.jsx -!test/unit/components/mesh-self-sensor-notice.test.jsx !test/unit/components/mesh-status-popup.test.jsx !test/unit/components/mesh-status-button.test.jsx !test/unit/components/mesh-v2-help-row.test.jsx @@ -557,6 +562,8 @@ test/unit/components/* !test/unit/components/classroom-teacher-header.test.jsx !test/unit/components/classroom-teacher-modal-share-suggestion.test.js !test/unit/components/teacher-open-work-confirm.test.jsx +!test/unit/components/teacher-close-row.test.jsx +!test/unit/components/classroom-teacher-modal-close-row.test.jsx !test/unit/components/classroom-tab.test.jsx !test/unit/components/classroom-teacher-view-layout.test.jsx !test/unit/components/classroom-teacher-evaluation.test.jsx @@ -596,9 +603,9 @@ test/unit/containers/* !test/unit/containers/lesson-analytics.test.jsx !test/unit/containers/lesson-progress-sync.test.jsx !test/unit/containers/lesson-goal-watcher.test.jsx +!test/unit/containers/block-activity-diagram.test.jsx !test/unit/containers/ruby-tab/** !test/unit/containers/backpack.test.jsx -!test/unit/containers/cards.test.jsx !test/unit/containers/lesson-mode.test.jsx !test/unit/containers/lesson-hint.test.jsx !test/unit/containers/lessons-library.test.jsx @@ -664,8 +671,6 @@ test/unit/lib/* !test/unit/lib/mesh-practice/ !test/unit/lib/mesh-practice/** !test/unit/lib/dncl/** -!test/unit/lib/libraries/ -!test/unit/lib/libraries/** !test/unit/lib/ruby-generator/ !test/unit/lib/ruby-generator/** !test/unit/lib/ruby-roundtrip/ @@ -724,7 +729,6 @@ test/unit/lib/* !test/unit/lib/classroom-continue-options.test.js !test/unit/lib/classroom-welcome-back.test.js !test/unit/lib/classroom-mesh-connect.test.js -!test/unit/lib/deck-setup.test.js !test/unit/lib/blocks-screenshot.test.js !test/unit/lib/download-blob.test.js !test/unit/lib/calculate-popup-position.test.js @@ -744,12 +748,10 @@ test/unit/lib/* !test/unit/lib/legacy-storage.test.js !test/unit/lib/make-toolbox-xml.test.js !test/unit/lib/lesson-dynamic-categories.test.js -!test/unit/lib/lesson-dynamic-categories-decks.test.js !test/unit/lib/mesh-v2-classroom-binding.test.js !test/unit/lib/mesh-v2-seat-connect.test.js !test/unit/lib/mesh-v2-seat-label.test.js !test/unit/lib/mesh-v2-status.test.js -!test/unit/lib/mesh-v2-sensor-collision.test.js !test/unit/lib/monaco-i18n-helper.test.js !test/unit/lib/display-mode-persistence.test.js !test/unit/lib/responsive-gui.test.jsx @@ -794,6 +796,8 @@ test/unit/lib/* !test/unit/lib/setup-prism.js !test/unit/lib/version-checker.test.js !test/unit/lib/audio-buffer-player.test.js +!test/unit/lib/tutorial-from-url-analytics.test.js +!test/unit/lib/tutorial-url-analytics.test.js # Level 3: test/unit/reducers/* test/unit/reducers/* diff --git a/packages/scratch-gui/src/components/balloon/balloon-close-button.jsx b/packages/scratch-gui/src/components/balloon/balloon-close-button.jsx index b8eb4ec51f9..4975a32b961 100644 --- a/packages/scratch-gui/src/components/balloon/balloon-close-button.jsx +++ b/packages/scratch-gui/src/components/balloon/balloon-close-button.jsx @@ -1,10 +1,11 @@ // 吹き出しの閉じる(×)ボタン。色の帯や塗りの吹き出しの上に置く半透明の丸。 +// `icon` で × 以外の印にできる(ヒントの吹き出しは閉じずに小さくするので「-」)。 import classNames from 'classnames'; import PropTypes from 'prop-types'; import React from 'react'; import styles from './balloon.css'; -const BalloonCloseButton = ({ className, label, onClick, testId, title }) => ( +const BalloonCloseButton = ({ className, icon = '×', label, onClick, testId, title }) => ( <button type="button" className={classNames(styles.closeButton, className)} @@ -13,12 +14,14 @@ const BalloonCloseButton = ({ className, label, onClick, testId, title }) => ( title={title} onClick={onClick} > - × + {icon} </button> ); BalloonCloseButton.propTypes = { className: PropTypes.string, + // ボタンの印(無ければ ×) + icon: PropTypes.node, label: PropTypes.string.isRequired, onClick: PropTypes.func.isRequired, testId: PropTypes.string, diff --git a/packages/scratch-gui/src/components/balloon/balloon-header.jsx b/packages/scratch-gui/src/components/balloon/balloon-header.jsx index d9850acbc51..36ead52d034 100644 --- a/packages/scratch-gui/src/components/balloon/balloon-header.jsx +++ b/packages/scratch-gui/src/components/balloon/balloon-header.jsx @@ -6,11 +6,17 @@ import React from 'react'; import BalloonCloseButton from './balloon-close-button.jsx'; import styles from './balloon.css'; -const BalloonHeader = ({ children, className, closeLabel, closeTestId, onClose, ...rest }) => ( +const BalloonHeader = ({ children, className, closeIcon, closeLabel, closeTestId, onClose, ...rest }) => ( <div className={classNames(styles.header, className)} {...rest}> <span className={styles.headerTitle}>{children}</span> {onClose ? ( - <BalloonCloseButton label={closeLabel || ''} title={closeLabel} testId={closeTestId} onClick={onClose} /> + <BalloonCloseButton + icon={closeIcon} + label={closeLabel || ''} + title={closeLabel} + testId={closeTestId} + onClick={onClose} + /> ) : null} </div> ); @@ -18,6 +24,8 @@ const BalloonHeader = ({ children, className, closeLabel, closeTestId, onClose, BalloonHeader.propTypes = { children: PropTypes.node, className: PropTypes.string, + // 閉じるボタンの印(無ければ ×) + closeIcon: PropTypes.node, closeLabel: PropTypes.string, closeTestId: PropTypes.string, onClose: PropTypes.func, diff --git a/packages/scratch-gui/src/components/block-activity-diagram/block-activity-diagram.css b/packages/scratch-gui/src/components/block-activity-diagram/block-activity-diagram.css new file mode 100644 index 00000000000..85b62f66b0f --- /dev/null +++ b/packages/scratch-gui/src/components/block-activity-diagram/block-activity-diagram.css @@ -0,0 +1,92 @@ +@import '../../css/smalruby-tokens.css'; + +/* + ブロックを右クリックして開くアクティビティ図のパネル(#1647)。モーダルにしない(後ろのブロックを + 見くらべながら直せるように)。幕はドラッグの範囲を決めるだけで、マウスの操作はすべて後ろへ通す。 + 重なりはメニューバー(491)とモーダル(510)より下。 +*/ +.overlay { + position: fixed; + inset: 0; + z-index: 485; + pointer-events: none; +} + +/* 授業 PC(1300×600)に入る大きさ。図が大きいときは中をスクロールする */ +.panel { + position: absolute; + display: flex; + flex-direction: column; + width: max-content; + min-width: 16rem; + max-width: min(40rem, calc(100vw - 2rem)); + max-height: calc(100vh - 4.5rem); + overflow: hidden; + border: 1px solid $color-border; + border-radius: $radius-medium; + background-color: $color-surface; + box-shadow: $shadow-raised; + color: $color-text; + font-size: $font-size-small; + pointer-events: auto; +} + +.header { + display: flex; + flex: none; + align-items: center; + gap: 0.25rem; + padding: 0.3rem 0.4rem 0.3rem 0.6rem; + background-color: $color-primary; + color: $color-surface; + cursor: move; + user-select: none; +} + +.title { + flex: 1; + overflow: hidden; + font-weight: $font-weight-bold; + text-overflow: ellipsis; + white-space: nowrap; +} + +.close { + width: 1.5rem; + height: 1.5rem; + padding: 0; + border: none; + border-radius: $radius-small; + background: transparent; + color: $color-surface; + font-size: $font-size-medium; + line-height: 1; + cursor: pointer; +} + +.close:hover { + background-color: rgba(255, 255, 255, 0.2); +} + +/* 本文は不透明の白(後ろのコードエリアが透けないように) */ +.body { + flex: 1; + min-height: 0; + padding: 0.5rem 0.6rem; + overflow: auto; + background-color: $color-surface; +} + +.note { + flex: none; + margin: 0; + padding: 0.25rem 0.6rem 0.4rem; + background-color: $color-surface; + color: $color-text-muted; + font-size: $font-size-xsmall; +} + +.message { + margin: 0; + line-height: 1.4; +} diff --git a/packages/scratch-gui/src/components/block-activity-diagram/block-activity-diagram.jsx b/packages/scratch-gui/src/components/block-activity-diagram/block-activity-diagram.jsx new file mode 100644 index 00000000000..cc3bea68313 --- /dev/null +++ b/packages/scratch-gui/src/components/block-activity-diagram/block-activity-diagram.jsx @@ -0,0 +1,103 @@ +// ブロックを右クリック →「アクティビティ図」で開くパネル(#1647)。図はレッスンと同じ部品 +// (lesson-activity-diagram)で描く。モーダルにせず、見出しをつかんで動かせる・×で閉じられるパネルにする +// (後ろのブロックと見くらべながら直せるように。授業 PC の 1300×600 でも図の上に重ならないところへ動かせる)。 +import PropTypes from 'prop-types'; +import React from 'react'; +import Draggable from 'react-draggable'; +import { defineMessages, useIntl } from 'react-intl'; +import LessonActivityDiagram from '../lesson-activity-diagram/lesson-activity-diagram.jsx'; +import styles from './block-activity-diagram.css'; + +const messages = defineMessages({ + title: { + id: 'gui.lessons.activityDiagram.popupTitle', + description: 'Title of the panel that shows the activity diagram of the right-clicked script', + defaultMessage: 'Activity diagram ({name})', + }, + close: { + id: 'gui.lessons.activityDiagram.close', + description: 'Label of the close button of the activity diagram panel', + defaultMessage: 'Close', + }, + scriptGone: { + id: 'gui.lessons.activityDiagram.scriptGone', + description: 'Shown in the activity diagram panel when the script was deleted', + defaultMessage: 'This script is gone. Right-click a block to open the diagram again.', + }, + liveNote: { + id: 'gui.lessons.activityDiagram.liveNote', + description: 'Note under the activity diagram: the diagram follows edits of the blocks', + defaultMessage: 'The diagram changes when you change the blocks.', + }, +}); + +/** + * ブロックのスクリプトのアクティビティ図のパネル。 + * @param {object} props - props。 + * @param {?object} props.layout - 図の置き方(`scriptActivityDiagram` の layout)。null ならスクリプトが無くなった。 + * @param {string} props.name - スプライトの名前(見出しに書く)。 + * @param {object} props.panelRef - パネルの要素の ref(大きさを測る)。 + * @param {{x: number, y: number}} props.position - パネルの位置。 + * @param {Function} props.onClose - 閉じる。 + * @param {Function} props.onDrag - 動かした(`(e, {x, y})`)。 + * @returns {React.ReactElement} パネル。 + */ +const BlockActivityDiagram = ({ layout, name, panelRef, position, onClose, onDrag }) => { + const intl = useIntl(); + return ( + <div className={styles.overlay}> + <Draggable bounds="parent" handle={`.${styles.header}`} position={position} onDrag={onDrag}> + <div + aria-label={intl.formatMessage(messages.title, { name })} + className={styles.panel} + data-testid="block-activity-diagram" + ref={panelRef} + role="dialog" + > + <div className={styles.header}> + <span className={styles.title} data-testid="block-activity-diagram-title"> + {intl.formatMessage(messages.title, { name })} + </span> + <button + aria-label={intl.formatMessage(messages.close)} + className={styles.close} + data-testid="block-activity-diagram-close" + title={intl.formatMessage(messages.close)} + type="button" + onClick={onClose} + > + {'×'} + </button> + </div> + <div className={styles.body} data-testid="block-activity-diagram-body"> + {layout ? ( + <LessonActivityDiagram layout={layout} /> + ) : ( + <p className={styles.message} data-testid="block-activity-diagram-gone"> + {intl.formatMessage(messages.scriptGone)} + </p> + )} + </div> + {layout ? <p className={styles.note}>{intl.formatMessage(messages.liveNote)}</p> : null} + </div> + </Draggable> + </div> + ); +}; + +BlockActivityDiagram.propTypes = { + layout: PropTypes.shape({ + width: PropTypes.number.isRequired, + height: PropTypes.number.isRequired, + shapes: PropTypes.arrayOf(PropTypes.object).isRequired, + edges: PropTypes.arrayOf(PropTypes.object).isRequired, + description: PropTypes.string, + }), + name: PropTypes.string.isRequired, + panelRef: PropTypes.oneOfType([PropTypes.func, PropTypes.shape({ current: PropTypes.any })]), + position: PropTypes.shape({ x: PropTypes.number, y: PropTypes.number }).isRequired, + onClose: PropTypes.func.isRequired, + onDrag: PropTypes.func.isRequired, +}; + +export default BlockActivityDiagram; diff --git a/packages/scratch-gui/src/components/cards/card.css b/packages/scratch-gui/src/components/cards/card.css index fe591bea4f8..a9e33a1caef 100644 --- a/packages/scratch-gui/src/components/cards/card.css +++ b/packages/scratch-gui/src/components/cards/card.css @@ -98,9 +98,6 @@ body .card-container { box-shadow: 0px 5px 25px 5px $ui-black-transparent; align-items: center; font-family: "Helvetica Neue", Helvetica, Arial, sans-serif; - /* === Smalruby: Start of tutorial card layout === */ - max-width: 500px; - /* === Smalruby: End of tutorial card layout === */ } .header-buttons { @@ -162,11 +159,6 @@ body .card-container { text-align: center; font-weight: bold; color: $text-primary; - /* === Smalruby: Start of tutorial card layout === */ - /* wrap long Japanese titles instead of widening the card */ - word-break: break-word; - overflow-wrap: break-word; - /* === Smalruby: End of tutorial card layout === */ } .step-body { @@ -187,16 +179,9 @@ body .card-container { height: 256px; } -/* === Smalruby: Start of insert-code button overlay === */ -.step-image-container { - position: relative; - display: flex; - justify-content: center; -} - .step-image { - max-width: 480px; - max-height: 360px; + max-width: 450px; + max-height: 200px; object-fit: contain; background: #F9F9F9; border: 1px solid #ddd; @@ -205,14 +190,6 @@ body .card-container { margin: 0 0.5rem 0.5rem; } -.insert-code-button-overlay { - position: absolute; - bottom: 0.75rem; - left: 50%; - transform: translateX(-50%); -} -/* === Smalruby: End of insert-code button overlay === */ - .decks, .resources { display: flex; flex-direction: row; @@ -311,16 +288,13 @@ body .card-container { align-items: center; } -/* === Smalruby: Start of step pip selector === */ -/* upstream: .inactiveStepPip (mixed-case class name in a kebab-case file) */ -.active-step-pip, .inactive-step-pip { +.active-step-pip, .inactiveStepPip { width: 0.5rem; height: 0.5rem; margin: 0 0.25rem; border-radius: 100%; background: $ui-white-transparent; } -/* === Smalruby: End of step pip selector === */ .active-step-pip { background: $ui-white; @@ -330,72 +304,3 @@ body .card-container { .hidden { display: none; } - -/* === Smalruby: Start of tutorial insert-code button === */ -/* Insert Code Button */ -.insert-code-button { - display: flex; - align-items: center; - gap: 0.5rem; - margin-top: 0.75rem; - padding: 0.5rem 1rem; - /* Darker green (#0B8E69) so the white label reaches 4.15:1 (#0DA57A was - 3.14:1), and a bold label. Quick fix only: EPIC #1935 brings the - tutorial back to upstream and reverts this (#1933 Q4). */ - background-color: $extensions-tertiary; - color: $ui-white; - border: none; - border-radius: 0.25rem; - font-size: 0.875rem; - font-weight: bold; - cursor: pointer; - transition: background-color 0.2s; - font-family: "Helvetica Neue", Helvetica, Arial, sans-serif; - white-space: nowrap; -} - -.insert-code-button:hover { - background-color: $ui-green; -} - -.insert-code-button .code-icon { - width: 1rem; - height: 1rem; - filter: brightness(0) invert(1); -} -/* === Smalruby: End of tutorial insert-code button === */ - -/* === Smalruby: Start of tutorial glow animation === */ -/* Glow animation for tutorial hints */ -@keyframes glow-pulse-next { - 0%, 100% { - box-shadow: 0 0 0 4px $extensions-transparent; - } - 50% { - box-shadow: 0 0 14px 8px rgba(255, 220, 50, 0.85); - } -} - -@keyframes glow-pulse-button { - 0%, 100% { - box-shadow: none; - } - 50% { - box-shadow: 0 0 14px 8px rgba(255, 220, 50, 0.85); - } -} - - -.left-button-glow { - animation: glow-pulse-next 1s ease-in-out infinite; -} - -.right-button-glow { - animation: glow-pulse-next 1s ease-in-out infinite; -} - -.insert-code-button-glow { - animation: glow-pulse-button 1s ease-in-out infinite; -} -/* === Smalruby: End of tutorial glow animation === */ - diff --git a/packages/scratch-gui/src/components/cards/cards.jsx b/packages/scratch-gui/src/components/cards/cards.jsx index f8c2743cef2..393f7f63019 100644 --- a/packages/scratch-gui/src/components/cards/cards.jsx +++ b/packages/scratch-gui/src/components/cards/cards.jsx @@ -14,10 +14,6 @@ import leftArrow from './icon--prev.svg'; import helpIcon from '../../lib/assets/icon--tutorials.svg'; import closeIcon from './icon--close.svg'; -import codeIcon from './icon--code.svg'; -// === Smalruby: Start of start-tutorial button === -import startIcon from './icon--start.svg'; -// === Smalruby: End of start-tutorial button === import {translateVideo} from '../../lib/libraries/decks/translate-video.js'; import {translateImage} from '../../lib/libraries/decks/translate-image.js'; @@ -127,10 +123,10 @@ class VideoStep extends React.Component { componentWillUnmount () { const script = document.getElementById('wistia-video-content'); - if (script) script.parentNode.removeChild(script); + script.parentNode.removeChild(script); const script2 = document.getElementById('wistia-video-api'); - if (script2) script2.parentNode.removeChild(script2); + script2.parentNode.removeChild(script2); } render () { @@ -153,15 +149,7 @@ VideoStep.propTypes = { video: PropTypes.string.isRequired }; -// === Smalruby: Start of tutorial glow animation (insert-code button overlay) === -// === Smalruby: Start of start-tutorial button === -const ImageStep = ({ - title, image, code, codeType, onInsertCodeFactory, animateInsertCode, - startTutorial, onStartTutorial, animateStartTutorial, - // === Smalruby: Start of external-url button === - externalUrl, externalUrlLabel - // === Smalruby: End of external-url button === -}) => (<Fragment> +const ImageStep = ({title, image}) => (<Fragment> <div className={styles.stepTitle}> {title} </div> @@ -172,106 +160,22 @@ const ImageStep = ({ key={image} /* Use src as key to prevent hanging around on slow connections */ src={image} /> - {startTutorial && onStartTutorial ? ( - <button - className={animateStartTutorial ? - classNames(styles.insertCodeButton, styles.insertCodeButtonOverlay, styles.insertCodeButtonGlow) : - classNames(styles.insertCodeButton, styles.insertCodeButtonOverlay)} - data-card-action="start-tutorial" - onClick={onStartTutorial} - > - <img - className={styles.codeIcon} - src={startIcon} - /> - <FormattedMessage - defaultMessage="Start Tutorial" - description="Button to reset project and start tutorial" - id="gui.cards.start-tutorial" - /> - </button> - ) : null} - {code && onInsertCodeFactory ? ( - <button - className={animateInsertCode ? - classNames(styles.insertCodeButton, styles.insertCodeButtonOverlay, styles.insertCodeButtonGlow) : - classNames(styles.insertCodeButton, styles.insertCodeButtonOverlay)} - data-card-action={codeType === 'blocks' ? 'insert-blocks' : 'insert-ruby'} - onClick={onInsertCodeFactory(code, codeType)} - > - <img - className={styles.codeIcon} - src={codeIcon} - /> - {codeType === 'blocks' ? ( - <FormattedMessage - defaultMessage="Insert Blocks" - description="Button to insert code as blocks (injects Ruby then switches to blocks tab)" - id="gui.cards.insert-blocks" - /> - ) : ( - <FormattedMessage - defaultMessage="Insert This Ruby" - description="Button to insert code into Ruby tab" - id="gui.cards.insert-ruby" - /> - )} - </button> - ) : null} - {/* === Smalruby: Start of external-url button === */} - {externalUrl ? ( - <a - className={classNames(styles.insertCodeButton, styles.insertCodeButtonOverlay)} - data-card-action="open-external-link" - href={externalUrl} - target="_blank" - rel="noopener noreferrer" - > - {externalUrlLabel || ( - <FormattedMessage - defaultMessage="Open External Link" - description="Button to open an external website in a new browser tab" - id="gui.cards.open-external-link" - /> - )} - </a> - ) : null} - {/* === Smalruby: End of external-url button === */} </div> </Fragment> ); ImageStep.propTypes = { - animateInsertCode: PropTypes.bool, // Smalruby: tutorial glow animation - animateStartTutorial: PropTypes.bool, // Smalruby: start-tutorial button glow - code: PropTypes.string, - codeType: PropTypes.string, // 'ruby' (default) or 'blocks' - // === Smalruby: Start of external-url button === - externalUrl: PropTypes.string, // Smalruby: opens this URL in a new tab (e.g. TryRuby) - externalUrlLabel: PropTypes.node, // Smalruby: optional custom label for the external link button - // === Smalruby: End of external-url button === image: PropTypes.string.isRequired, - onInsertCodeFactory: PropTypes.func, - onStartTutorial: PropTypes.func, // Smalruby: start-tutorial button handler - startTutorial: PropTypes.bool, // Smalruby: show start-tutorial button title: PropTypes.node.isRequired }; -// === Smalruby: End of start-tutorial button === -// === Smalruby: End of tutorial glow animation (insert-code button overlay) === -// === Smalruby: Start of tutorial glow animation (next button) === -const NextPrevButtons = ({isRtl, onNextStep, onPrevStep, expanded, animateNext}) => ( +const NextPrevButtons = ({isRtl, onNextStep, onPrevStep, expanded}) => ( <Fragment> {onNextStep ? ( <div> <div className={expanded ? (isRtl ? styles.leftCard : styles.rightCard) : styles.hidden} /> <div - className={expanded ? ( - isRtl ? - (animateNext ? classNames(styles.leftButton, styles.leftButtonGlow) : styles.leftButton) : - (animateNext ? classNames(styles.rightButton, styles.rightButtonGlow) : styles.rightButton) - ) : styles.hidden} - data-card-action="next" + className={expanded ? (isRtl ? styles.leftButton : styles.rightButton) : styles.hidden} onClick={onNextStep} > <img @@ -286,7 +190,6 @@ const NextPrevButtons = ({isRtl, onNextStep, onPrevStep, expanded, animateNext}) <div className={expanded ? (isRtl ? styles.rightCard : styles.leftCard) : styles.hidden} /> <div className={expanded ? (isRtl ? styles.rightButton : styles.leftButton) : styles.hidden} - data-card-action="prev" onClick={onPrevStep} > <img @@ -300,13 +203,11 @@ const NextPrevButtons = ({isRtl, onNextStep, onPrevStep, expanded, animateNext}) ); NextPrevButtons.propTypes = { - animateNext: PropTypes.bool, // Smalruby: tutorial glow animation expanded: PropTypes.bool.isRequired, isRtl: PropTypes.bool, onNextStep: PropTypes.func, onPrevStep: PropTypes.func }; -// === Smalruby: End of tutorial glow animation (next button) === CardHeader.propTypes = { expanded: PropTypes.bool.isRequired, onCloseCards: PropTypes.func.isRequired, @@ -330,14 +231,14 @@ const PreviewsStep = ({deckIds, content, onActivateDeckFactory, onShowAll}) => ( <div className={styles.deck} key={`deck-preview-${id}`} - onClick={id in content ? onActivateDeckFactory(id) : null} + onClick={onActivateDeckFactory(id)} > <img className={styles.deckImage} draggable={false} - src={content[id]?.img} + src={content[id].img} /> - <div className={styles.deckName}>{content[id]?.name}</div> + <div className={styles.deckName}>{content[id].name}</div> </div> ))} </div> @@ -441,26 +342,17 @@ const Cards = props => { onDrag, onStartDrag, onEndDrag, - onInsertCodeFactory, onShowAll, onNextStep, onPrevStep, step, expanded, showVideos, - // === Smalruby: Start of tutorial glow animation === - animateNext, - animateInsertCode, - // === Smalruby: End of tutorial glow animation === - // === Smalruby: Start of start-tutorial button === - animateStartTutorial, - onStartTutorial, - // === Smalruby: End of start-tutorial button === ...posProps } = props; let {x, y} = posProps; - if (activeDeckId === null) return null; + if (activeDeckId === null) return; // Tutorial cards need to calculate their own dragging bounds // to allow for dragging the cards off the left, right and bottom @@ -474,9 +366,9 @@ const Cards = props => { // initialize positions x = isRtl ? (-190 - wideCardWidth - cardHorizontalDragOffset) : 292; x += cardHorizontalDragOffset; - // The tallest cards are about 500px high (header ~40 + title ~40 + image 360 + margins ~60), - // and the default position is pinned to near the bottom of the blocks palette to allow room to work above. - const tallCardHeight = 500; + // The tallest cards are about 320px high, and the default position is pinned + // to near the bottom of the blocks palette to allow room to work above. + const tallCardHeight = 320; const bottomMargin = 60; // To avoid overlapping the backpack region y = window.innerHeight - tallCardHeight - bottomMargin - menuBarHeight; } @@ -503,13 +395,7 @@ const Cards = props => { onStop={onEndDrag} > <div className={styles.cardContainer}> - <div - className={styles.card} - data-deck-id={activeDeckId} - data-step={step + 1} - data-total-steps={steps.length} - data-steps-remaining={steps.length - step - 1} - > + <div className={styles.card}> <CardHeader expanded={expanded} step={step} @@ -549,18 +435,7 @@ const Cards = props => { ) ) : ( <ImageStep - animateInsertCode={animateInsertCode} - animateStartTutorial={animateStartTutorial} - code={steps[step].code} - codeType={steps[step].codeType} - // === Smalruby: Start of external-url button === - externalUrl={steps[step].externalUrl} - externalUrlLabel={steps[step].externalUrlLabel} - // === Smalruby: End of external-url button === image={translateImage(steps[step].image, locale)} - onInsertCodeFactory={onInsertCodeFactory} - onStartTutorial={steps[step].startTutorial ? onStartTutorial : null} - startTutorial={steps[step].startTutorial} title={steps[step].title} /> ) @@ -568,7 +443,6 @@ const Cards = props => { {steps[step].trackingPixel && steps[step].trackingPixel} </div> <NextPrevButtons - animateNext={animateNext} expanded={expanded} isRtl={isRtl} onNextStep={step < steps.length - 1 ? onNextStep : null} @@ -582,14 +456,7 @@ const Cards = props => { }; Cards.propTypes = { - activeDeckId: PropTypes.string, - // === Smalruby: Start of tutorial glow animation === - animateInsertCode: PropTypes.bool, - animateNext: PropTypes.bool, - // === Smalruby: End of tutorial glow animation === - // === Smalruby: Start of start-tutorial button === - animateStartTutorial: PropTypes.bool, - // === Smalruby: End of start-tutorial button === + activeDeckId: PropTypes.string.isRequired, content: PropTypes.shape({ id: PropTypes.shape({ name: PropTypes.node.isRequired, @@ -598,12 +465,6 @@ Cards.propTypes = { title: PropTypes.node, image: PropTypes.string, video: PropTypes.string, - code: PropTypes.string, - codeType: PropTypes.string, - // === Smalruby: Start of external-url button === - externalUrl: PropTypes.string, - externalUrlLabel: PropTypes.node, - // === Smalruby: End of external-url button === deckIds: PropTypes.arrayOf(PropTypes.string) })) }) @@ -616,12 +477,8 @@ Cards.propTypes = { onCloseCards: PropTypes.func.isRequired, onDrag: PropTypes.func, onEndDrag: PropTypes.func, - onInsertCodeFactory: PropTypes.func, onNextStep: PropTypes.func.isRequired, onPrevStep: PropTypes.func.isRequired, - // === Smalruby: Start of start-tutorial button === - onStartTutorial: PropTypes.func, - // === Smalruby: End of start-tutorial button === onShowAll: PropTypes.func, onShrinkExpandCards: PropTypes.func.isRequired, onStartDrag: PropTypes.func, diff --git a/packages/scratch-gui/src/components/cards/icon--code.svg b/packages/scratch-gui/src/components/cards/icon--code.svg deleted file mode 100644 index 7d4d3f366c3..00000000000 --- a/packages/scratch-gui/src/components/cards/icon--code.svg +++ /dev/null @@ -1,8 +0,0 @@ -<?xml version="1.0" encoding="UTF-8"?> -<svg width="16px" height="16px" viewBox="0 0 16 16" version="1.1" xmlns="http://www.w3.org/2000/svg"> - <g stroke="currentColor" stroke-width="2" fill="none" stroke-linecap="round" stroke-linejoin="round"> - <path d="M5 4L1 8L5 12"/> - <path d="M11 4L15 8L11 12"/> - <path d="M9 2L7 14"/> - </g> -</svg> diff --git a/packages/scratch-gui/src/components/cards/icon--start.svg b/packages/scratch-gui/src/components/cards/icon--start.svg deleted file mode 100644 index d0a0a9ec1ad..00000000000 --- a/packages/scratch-gui/src/components/cards/icon--start.svg +++ /dev/null @@ -1,4 +0,0 @@ -<?xml version="1.0" encoding="UTF-8"?> -<svg width="16px" height="16px" viewBox="0 0 16 16" version="1.1" xmlns="http://www.w3.org/2000/svg"> - <polygon fill="currentColor" points="3,1 14,8 3,15"/> -</svg> diff --git a/packages/scratch-gui/src/components/classroom-modal/classroom-modal.css b/packages/scratch-gui/src/components/classroom-modal/classroom-modal.css index 903042921cd..dd4578b2ac9 100644 --- a/packages/scratch-gui/src/components/classroom-modal/classroom-modal.css +++ b/packages/scratch-gui/src/components/classroom-modal/classroom-modal.css @@ -343,19 +343,6 @@ $teacher-screen-padding-top: $space-small; outline: 2px solid transparent; } -/* 課題名(左)と参加コード(右)を均等幅 2 カラムに分ける。両カラムは - stretch で高さが揃うので、課題名入力の高さは参加コードカードに一致する。 - 幅が足りず参加コードカードが 340px を割り込むと、行が折り返して参加コード - カードは単独行(フル幅)になり、狭いウインドウでも 2 行に収まる。 */ -.name-code-row { - display: flex; - flex-wrap: wrap; - gap: 0.5rem; - align-items: stretch; - /* 下は課題名の欄の下に重ねる保存のしかた(#1388)の 1 行分を空けておく。 */ - margin: 0.3rem 0 0.7rem; -} - /* 課題名: ラベル・1 行の入力欄・保存結果を横並び(#1303 D3 / #1388)。 */ .name-col { flex: 1 1 340px; @@ -2379,27 +2366,14 @@ $seat-tile-min: 36px; } /* E1 (#1303): 説明 1 行と[課題を保存]を最上段に置き、スクロールせずに見せる。 */ -.assignment-editor-header { - display: flex; - align-items: center; - gap: 1rem; - margin-bottom: 0.5rem; -} - .assignment-editor-hint { - flex: 1 1 auto; - margin: 0; + flex: 0 0 auto; + margin: 0 0 0.5rem; color: #575e75; font-size: 0.8rem; line-height: 1.4; } -.assignment-editor-actions { - flex: 0 0 auto; - display: flex; - gap: 0.5rem; -} - .assignment-editor-columns { /* レッスン欄の開いた中身(.lesson-panel)をページの列に重ねる基準。 */ position: relative; @@ -5762,27 +5736,6 @@ $seat-tile-min: 36px; padding-bottom: 0; } -.compact-code-row { - display: flex; - align-items: center; - gap: 0.25rem; - font-size: 0.8rem; - color: #575e75; - margin-bottom: 0.25rem; -} - -.compact-code-value { - font-weight: bold; - letter-spacing: 0.05em; - color: $color-action; -} - -.compact-code-row .join-code-action { - padding: 0 0.3rem; - min-height: 0; - line-height: 1.3; -} - .lesson-cleared-summary { white-space: nowrap; font-size: 0.8rem; @@ -6155,3 +6108,103 @@ $seat-tile-min: 36px; .lesson-detail-todo .lesson-detail-status { color: #9aa1b8; } + +/* 「✕ + 見出し」の行(#2089・Google Classroom の編集の画面と同じ)。1 つの物を編集する + 画面の本文の上に置き、✕ で一覧(開いた元)へ戻る。高さはボタンの 36px に収め、 + 1300×600 で本文に高さを回す。右端には画面ごとの値と確定のボタン(参加コード・[課題を保存])。 */ +.close-row { + display: flex; + align-items: center; + gap: $space-medium; + min-height: $size-button-height; + padding-bottom: $space-small; + margin-bottom: $space-medium; + border-bottom: 1px solid $color-border; +} + +.close-row-button { + flex: 0 0 auto; + display: inline-flex; + align-items: center; + justify-content: center; + width: $size-button-height; + height: $size-button-height; + padding: 0; + border: none; + border-radius: $radius-round; + background: transparent; + color: $color-text; + cursor: pointer; + transition: $transition-standard; +} + +.close-row-button:hover { + background-color: $color-background; +} + +.close-row-button:focus-visible { + outline: 2px solid $color-action; + outline-offset: 2px; +} + +.close-row-title { + flex: 0 1 auto; + min-width: 0; + margin: 0; + overflow: hidden; + font-size: $font-size-heading-small; + font-weight: $font-weight-bold; + color: $color-text; + white-space: nowrap; + text-overflow: ellipsis; +} + +/* 見出しが文字でないとき(課題詳細の課題名の欄)。幅を取って右端の値を押し出す。 */ +.close-row-heading { + flex: 1 1 auto; + min-width: 0; + display: flex; + align-items: center; +} + +.close-row-end { + flex: 0 1 auto; + min-width: 0; + display: flex; + align-items: center; + gap: $space-medium; + margin-left: auto; +} + +/* 破棄の確認(色は .confirm-note)。確認の間は右端の値の代わりに出す。 */ +.close-row-confirm { + margin: 0; + padding: 0.4rem 0.75rem; + font-size: $font-size-medium; +} + +/* 課題詳細の「✕ + 課題名」の行(#2089): 課題名の欄は残りの幅を取り、参加コードのカードと + [課題を保存]は中身の幅で 1 行に並べる(カードの中で折り返して行が高くならないように)。 */ +.close-row-heading .name-col { + flex: 1 1 auto; +} + +.close-row .close-row-end { + flex: 0 0 auto; +} + +.close-row .join-code-card { + flex: 0 0 auto; + flex-wrap: nowrap; + /* 幅を中身から決める(inline-size の containment だと幅が 0 になる)。 */ + container-type: normal; + padding: 0.2rem 0.5rem; + white-space: nowrap; +} + +/* 共有できない理由(まれ)は、行の中ではボタンの右に幅を決めて折り返す。 */ +.close-row .join-code-gc-blocked-note { + flex: 0 1 14rem; + margin-top: 0; + white-space: normal; +} diff --git a/packages/scratch-gui/src/components/classroom-modal/lesson-settings-field.jsx b/packages/scratch-gui/src/components/classroom-modal/lesson-settings-field.jsx index a04846ab78c..9b6a088b07e 100644 --- a/packages/scratch-gui/src/components/classroom-modal/lesson-settings-field.jsx +++ b/packages/scratch-gui/src/components/classroom-modal/lesson-settings-field.jsx @@ -127,8 +127,9 @@ const NO_COURSE = ''; /** * Where the open panel goes. At 1300x600 the editor's columns are only about * 200px tall, too short for the challenge list, so the panel reaches up over - * the assignment name and tabs (to the top of the scrolling body) and stops - * left of[課題を保存]so the save button stays visible (R6). + * the tabs. It stops under the「✕ + 課題名」row (#2089), which holds[課題を保存], + * so ✕ and the save button stay visible (R6). Without that row it reaches the + * top of the scrolling body and stops left of[課題を保存]. * @param {HTMLElement} root - the lesson section * @returns {?{top: number, right: number, maxHeight: number}} offsets from the positioned columns */ @@ -137,9 +138,12 @@ const panelPlacement = (root) => { if (!base) return null; const baseRect = base.getBoundingClientRect(); const editor = root.closest('[data-testid="classroom-description-editor"]'); - const save = editor && editor.querySelector('[data-testid="classroom-assignment-save"]'); + const detail = root.closest('[data-testid="classroom-phase-teacher-detail"]'); + const closeRow = detail && detail.querySelector('[data-testid="classroom-close-row"]'); + const save = closeRow ? null : editor && editor.querySelector('[data-testid="classroom-assignment-save"]'); const scroller = root.closest('main') || editor; - const topLimit = scroller ? scroller.getBoundingClientRect().top + 8 : baseRect.top; + let topLimit = scroller ? scroller.getBoundingClientRect().top + 8 : baseRect.top; + if (closeRow) topLimit = Math.max(topLimit, closeRow.getBoundingClientRect().bottom + 4); const right = save ? baseRect.right - save.getBoundingClientRect().left + 12 : 0; const top = Math.min(0, Math.round(topLimit - baseRect.top)); // The panel is as tall as its content (#1770) but never taller than the diff --git a/packages/scratch-gui/src/components/classroom-modal/teacher-assignment-board.jsx b/packages/scratch-gui/src/components/classroom-modal/teacher-assignment-board.jsx index 854c74b464e..bcf10bf489e 100644 --- a/packages/scratch-gui/src/components/classroom-modal/teacher-assignment-board.jsx +++ b/packages/scratch-gui/src/components/classroom-modal/teacher-assignment-board.jsx @@ -29,6 +29,7 @@ import { breadcrumbMessages } from './teacher-breadcrumbs.jsx'; import { yearSectionLine } from './teacher-class-card.jsx'; import { ClassSettingsForm } from './teacher-class-list.jsx'; import TeacherClassTabs, { classTabMessages } from './teacher-class-tabs.jsx'; +import { closeRowMessages } from './teacher-close-row.jsx'; import TeacherPasscodeImport from './teacher-passcode-import.jsx'; import TeacherShareStep from './teacher-share-step.jsx'; import { TeacherScreen, TeacherSubView } from './teacher-view-layout.jsx'; @@ -1032,6 +1033,7 @@ const TeacherAssignmentBoard = ({ error, errorTitle, group, + initialOpenId, initialTab, isLoading, onCreateAssignmentInClass, @@ -1042,6 +1044,7 @@ const TeacherAssignmentBoard = ({ onSelectClassroom, onShowClassList, onShowGrading, + onInitialOpenUsed, onTabChange, onUpdateAssignmentMeta, onUpdateGroup, @@ -1228,7 +1231,10 @@ const TeacherAssignmentBoard = ({ // Accordion (B7): one open row at a time. Its counts and description are // loaded when it opens (not with the list) and kept for this board. - const [openId, setOpenId] = useState(null); + // The ✕ of the assignment detail comes back with that assignment's row open (#2089). + const [openId, setOpenId] = useState( + initialOpenId && classrooms.some((c) => c.classroomId === initialOpenId) ? initialOpenId : null, + ); const [summaries, setSummaries] = useState({}); const summariesRef = useRef(summaries); summariesRef.current = summaries; @@ -1297,6 +1303,18 @@ const TeacherAssignmentBoard = ({ if (el && typeof el.scrollIntoView === 'function') el.scrollIntoView({ block: 'nearest' }); setScrollTargetId(null); }, [scrollTargetId]); + // Once on mount: load the reopened row's counts, bring it into view and tell the + // parent it was used (so the next visit from elsewhere does not open it again). + useEffect(() => { + if (!initialOpenId) return; + const classroom = classrooms.find((c) => c.classroomId === initialOpenId); + if (classroom) { + ensureSummary(classroom); + setScrollTargetId(`classroom-board-row-${initialOpenId}`); + } + if (onInitialOpenUsed) onInitialOpenUsed(); + // Mount only: the row is opened once, not again when the props change. + }, []); const handleRenameTopic = useCallback( (name, to) => onUpdateGroupTopics(group.groupId, { action: 'rename', name, to }), [onUpdateGroupTopics, group.groupId], @@ -1381,7 +1399,11 @@ const TeacherAssignmentBoard = ({ errorTitle={errorTitle} testId="classroom-board-settings-view" > - <TeacherSubView title={formatClassLabel(group)}> + <TeacherSubView + closeLabel={intl.formatMessage(closeRowMessages.backToClass)} + title={intl.formatMessage(classTabMessages.settings)} + onClose={handleCloseSettings} + > <ClassSettingsForm group={group} isLoading={isLoading || archiving} @@ -1680,6 +1702,7 @@ const TeacherAssignmentBoard = ({ </ClassroomButton> </> } + closeLabel={intl.formatMessage(closeRowMessages.backToAssignments)} testId="classroom-board-create-view" title={ createLesson ? ( @@ -1696,6 +1719,7 @@ const TeacherAssignmentBoard = ({ /> ) } + onClose={handleToggleInlineCreate} onSubmit={handleSubmitInlineCreate} > <div className={styles.formGroup}> @@ -1745,6 +1769,7 @@ const TeacherAssignmentBoard = ({ id="gui.classroom.board.reuseHint" /> } + closeLabel={intl.formatMessage(closeRowMessages.backToAssignments)} testId="classroom-board-reuse-view" title={ <FormattedMessage @@ -1753,6 +1778,7 @@ const TeacherAssignmentBoard = ({ id="gui.classroom.board.reuse" /> } + onClose={handleToggleReuse} > <div className={styles.formGroup}> <select @@ -1933,6 +1959,8 @@ TeacherAssignmentBoard.propTypes = { error: PropTypes.string, errorTitle: PropTypes.string, group: PropTypes.object.isRequired, + /** The assignment row to open when the board mounts (back from its detail with ✕). */ + initialOpenId: PropTypes.string, initialTab: PropTypes.oneOf(['stream', 'classwork']), isLoading: PropTypes.bool, onCreateAssignmentInClass: PropTypes.func.isRequired, @@ -1944,6 +1972,8 @@ TeacherAssignmentBoard.propTypes = { onShowClassList: PropTypes.func.isRequired, /** [採点]のタブ。このクラスの採点の画面を開く。 */ onShowGrading: PropTypes.func, + /** Called once the row of `initialOpenId` was opened. */ + onInitialOpenUsed: PropTypes.func, onTabChange: PropTypes.func, onUpdateAssignmentMeta: PropTypes.func.isRequired, /** [⚙ クラスの設定]で保存する。渡さなければボタンを出さない。 */ diff --git a/packages/scratch-gui/src/components/classroom-modal/teacher-assignment-editor.jsx b/packages/scratch-gui/src/components/classroom-modal/teacher-assignment-editor.jsx index e334c83a0b9..cde0f687382 100644 --- a/packages/scratch-gui/src/components/classroom-modal/teacher-assignment-editor.jsx +++ b/packages/scratch-gui/src/components/classroom-modal/teacher-assignment-editor.jsx @@ -19,7 +19,6 @@ import { } from '../../lib/classroom-assignment-utils.js'; import { effectiveScoring, lessonChanges } from '../../lib/classroom-lesson-settings.js'; import { findCourse } from '../../lib/lessons/courses.js'; -import Spinner from '../spinner/spinner.jsx'; import styles from './classroom-modal.css'; import ErrorDisplay from './error-display.jsx'; import LessonScoringField, { lessonScoringMessages } from './lesson-scoring-field.jsx'; @@ -241,7 +240,6 @@ const TeacherAssignmentEditor = ({ onRemovePage, onRemovePageImage, onRemoveStarter, - onSave, onUseCurrentProject, onUseFile, }) => { @@ -382,34 +380,14 @@ const TeacherAssignmentEditor = ({ return ( <div className={styles.assignmentEditor} data-testid="classroom-description-editor"> {/* E1 (#1303): the save button sits at the top (like Google - Classroom's "Assign"), so it is visible without scrolling. */} - <div className={styles.assignmentEditorHeader}> - <p className={styles.assignmentEditorHint}> - <FormattedMessage - defaultMessage="Students see these pages when they join with the class code, and start from the starter project with a button." - description="Assignment editor explanation" - id="gui.classroom.assignmentEditor.hint" - /> - </p> - <div className={styles.assignmentEditorActions}> - <button - className={styles.primaryButton} - data-testid="classroom-assignment-save" - disabled={isSaving} - onClick={onSave} - > - {isSaving ? ( - <Spinner className={styles.buttonSpinner} small /> - ) : ( - <FormattedMessage - defaultMessage="Save Assignment" - description="Assignment editor: save" - id="gui.classroom.assignmentEditor.save" - /> - )} - </button> - </div> - </div> + Classroom's "Assign"), in the「✕ + 課題名」row above the tabs (#2089). */} + <p className={styles.assignmentEditorHint}> + <FormattedMessage + defaultMessage="Students see these pages when they join with the class code, and start from the starter project with a button." + description="Assignment editor explanation" + id="gui.classroom.assignmentEditor.hint" + /> + </p> <ErrorDisplay error={error} errorTitle={errorTitle} /> @@ -747,7 +725,6 @@ TeacherAssignmentEditor.propTypes = { onRemovePage: PropTypes.func.isRequired, onRemovePageImage: PropTypes.func.isRequired, onRemoveStarter: PropTypes.func.isRequired, - onSave: PropTypes.func.isRequired, onUseCurrentProject: PropTypes.func.isRequired, onUseFile: PropTypes.func.isRequired, }; diff --git a/packages/scratch-gui/src/components/classroom-modal/teacher-class-detail.jsx b/packages/scratch-gui/src/components/classroom-modal/teacher-class-detail.jsx index cdfc0c1c8c3..c4bff3230d2 100644 --- a/packages/scratch-gui/src/components/classroom-modal/teacher-class-detail.jsx +++ b/packages/scratch-gui/src/components/classroom-modal/teacher-class-detail.jsx @@ -24,6 +24,7 @@ import { isMemberSeated } from '../../lib/classroom-presence.js'; import { retentionLevel } from '../../lib/classroom-retention.js'; import { findCourse } from '../../lib/lessons/courses.js'; import googleClassroomIcon from '../classroom-teacher-modal/google-classroom-icon.png'; +import Spinner from '../spinner/spinner.jsx'; import BoardMenu, { BoardMenuItem } from './board-menu.jsx'; import ClassroomButton from './classroom-button.jsx'; import classroomIconMessages from './classroom-icon-messages.js'; @@ -45,6 +46,7 @@ import SeatColorLegend, { seatColorClass, } from './seat-color-legend.jsx'; import TeacherAssignmentEditor from './teacher-assignment-editor.jsx'; +import TeacherCloseRow, { closeRowMessages } from './teacher-close-row.jsx'; import TeacherLessonProgress from './teacher-lesson-progress.jsx'; import TeacherMemberDetail from './teacher-member-detail.jsx'; import TeacherProjectionView, { projectionMessages } from './teacher-projection-view.jsx'; @@ -143,6 +145,8 @@ const TeacherClassDetail = ({ googleCourseAccess, isVerifyingGoogleCourseAccess, onVerifyGoogleCourseAccess, + onClose, + hasUnsavedChanges, }) => { // Destructured with handle-prefixed names for the embedded editor // (react/jsx-handler-names requires handler props to look like handlers). @@ -477,272 +481,254 @@ const TeacherClassDetail = ({ {'<'} <FormattedMessage defaultMessage="Back" description="Back button" id="gui.classroom.back" /> </button> )} - <div className={styles.detailTwoPaneLayout}> - {/* Left pane */} - <div className={styles.detailLeftPane}> - {/* 課題名(左)と参加コード(右)を均等幅の 2 カラムに - 分け、各カラムを 2 行に収める。参加コードカードが - 縦に伸びて全体が崩れるのを防ぐ。 */} - {compactHeader ? ( - <div className={styles.compactCodeRow} data-testid="classroom-detail-compact-code"> + {/* 「✕ + 見出し」の行(#2089・Google Classroom の編集の画面と同じ): ✕ で[授業]へ戻る。 + 課題名の欄・参加コード・[課題を保存]をこの 1 行にまとめ、1300×600 で本文を広くする。 */} + <TeacherCloseRow + closeLabel={intl.formatMessage(closeRowMessages.backToAssignments)} + heading={ + <div className={styles.nameCol}> + <label className={styles.assignmentNameLabel} htmlFor={nameInputId}> + <FormattedMessage + defaultMessage="Assignment Name" + description="Assignment name label in class detail" + id="gui.classroom.teacherDetail.assignmentNameLabel" + /> + {': '} + </label> + <div className={styles.assignmentNameField}> + <input + className={styles.assignmentNameInput} + data-testid="classroom-detail-assignment-name" + id={nameInputId} + maxLength={50} + type="text" + value={editAssignmentName} + onBlur={handleAssignmentNameBlur} + onChange={handleAssignmentNameChange} + onFocus={handleAssignmentNameFocus} + onKeyDown={handleAssignmentNameKeyDown} + /> + {nameFocused && ( + <div + className={styles.assignmentNameSaveHint} + data-testid="classroom-detail-assignment-name-save-hint" + > + <FormattedMessage + defaultMessage="Press Enter or click outside the field to save" + description="Shown under the assignment name field while it is focused: how the name is saved" + id="gui.classroom.teacherDetail.assignmentNameSaveHint" + /> + </div> + )} + </div> + {nameSaveStatus === 'saved' && ( + <span + className={styles.assignmentNameSaved} + data-testid="classroom-detail-assignment-name-saved" + role="status" + > + {'✓ '} + <FormattedMessage + defaultMessage="Saved" + description="Shown next to the assignment name for a moment after it was saved" + id="gui.classroom.teacherDetail.assignmentNameSaved" + /> + </span> + )} + {nameSaveStatus === 'error' && ( + <span + className={styles.assignmentNameSaveError} + data-testid="classroom-detail-assignment-name-save-error" + role="alert" + > + <FormattedMessage + defaultMessage="Couldn't save" + description="Shown next to the assignment name when saving it failed" + id="gui.classroom.teacherDetail.assignmentNameSaveFailed" + /> + </span> + )} + </div> + } + unsaved={Boolean(hasUnsavedChanges)} + onClose={onClose} + > + <div className={styles.joinCodeCard}> + <span className={styles.joinCodeCodePart}> + <span className={styles.joinCodeLabel}> <FormattedMessage defaultMessage="Join Code" description="Join code label" id="gui.classroom.joinCode.label" /> {': '} - <span className={styles.compactCodeValue} data-testid="classroom-detail-join-code"> - {selectedClassroom.joinCode.toLowerCase()} - </span> + </span> + <span className={styles.joinCodeValue} data-testid="classroom-detail-join-code"> + {selectedClassroom.joinCode.toLowerCase()} + </span> + </span> + {/* 全画面表示: アイコンの横に「全画面」の文字(#1924 C11) */} + <button + className={styles.joinCodeAction} + data-testid="classroom-detail-expand-code" + title={intl.formatMessage({ + id: 'gui.classroom.joinCode.fullscreen', + defaultMessage: 'Show fullscreen', + description: 'Fullscreen the join code', + })} + type="button" + onClick={handleProject} + > + <span aria-hidden="true" className={styles.joinCodeIcon}> + {'⛶'} + </span> + {intl.formatMessage(classroomIconMessages.fullscreen)} + </button> + {/* 招待リンクをコピー: アイコンのみ。クリックすると + アイコンがチェックに変わり、コピー完了を示す。 */} + <button + className={classNames(styles.joinCodeAction, { + [styles.joinCodeActionCopied]: inviteCopied, + })} + data-testid="classroom-detail-copy-link" + title={intl.formatMessage( + inviteCopied + ? { + id: 'gui.classroom.codeDisplay.copied', + defaultMessage: 'Copied', + description: 'Confirmation after copying invite link', + } + : { + id: 'gui.classroom.codeDisplay.copyLink', + defaultMessage: 'Copy invite link', + description: 'Button to copy classroom invite link', + }, + )} + type="button" + onClick={handleCopyInvite} + > + {inviteCopied ? ( + <svg + className={styles.joinCodeIcon} + fill="none" + height="15" + stroke="currentColor" + strokeWidth="2.5" + viewBox="0 0 24 24" + width="15" + > + <path d="M20 6L9 17l-5-5" /> + </svg> + ) : ( + <svg + className={styles.joinCodeIcon} + fill="none" + height="15" + stroke="currentColor" + strokeWidth="2" + viewBox="0 0 24 24" + width="15" + > + <rect height="13" rx="2" ry="2" width="13" x="9" y="9" /> + <path d="M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1" /> + </svg> + )} + </button> + {/* Google Classroom linkage lives on the class + (group), so an assignment posts to the group's + course even without its own courseId. ボタンは + 幅に関わらず "[アイコン]に共有" の短縮表示で固定。 */} + {(selectedClassroom.googleClassroomCourseId || (group && group.googleClassroomCourseId)) && + (selectedClassroom.googleClassroomAlternateLink ? ( + <a + className={classNames(styles.joinCodeAction, styles.joinCodeActionGc)} + data-testid="classroom-view-assignment" + href={selectedClassroom.googleClassroomAlternateLink} + rel="noopener noreferrer" + target="_blank" + > + <img alt="" className={styles.gcImportIcon} src={googleClassroomIcon} /> + <span className={styles.joinCodeGcLabel}> + <FormattedMessage + defaultMessage="Open" + description="Short label (icon shows Google Classroom) to open the assignment" + id="gui.classroom.joinCode.openInGcShort" + /> + </span> + </a> + ) : ( <button - className={styles.joinCodeAction} - data-testid="classroom-detail-expand-code" - title={intl.formatMessage({ - id: 'gui.classroom.joinCode.fullscreen', - defaultMessage: 'Show fullscreen', - description: 'Fullscreen the join code', - })} + className={classNames(styles.joinCodeAction, styles.joinCodeActionGc)} + data-testid="classroom-post-assignment" + disabled={gcShareBlocked} + title={gcShareBlockedText || null} type="button" - onClick={handleProject} + onClick={onShowPostAssignment} > - <span aria-hidden="true" className={styles.joinCodeIcon}> - {'⛶'} - </span> - {intl.formatMessage(classroomIconMessages.fullscreen)} - </button> - </div> - ) : ( - <div className={styles.nameCodeRow}> - {/* 左: 課題名。1 行の入力欄(#1303 D3)。カーソルがある間は - 欄の下に保存のしかた、保存後は欄の横に結果を出す(#1388)。 */} - <div className={styles.nameCol}> - <label className={styles.assignmentNameLabel} htmlFor={nameInputId}> + <img alt="" className={styles.gcImportIcon} src={googleClassroomIcon} /> + <span className={styles.joinCodeGcLabel}> <FormattedMessage - defaultMessage="Assignment Name" - description="Assignment name label in class detail" - id="gui.classroom.teacherDetail.assignmentNameLabel" + defaultMessage="Share join code" + description="Short label (icon shows Google Classroom) to share the join code" + id="gui.classroom.joinCode.shareToGcShort" /> - {': '} - </label> - <div className={styles.assignmentNameField}> - <input - className={styles.assignmentNameInput} - data-testid="classroom-detail-assignment-name" - id={nameInputId} - maxLength={50} - type="text" - value={editAssignmentName} - onBlur={handleAssignmentNameBlur} - onChange={handleAssignmentNameChange} - onFocus={handleAssignmentNameFocus} - onKeyDown={handleAssignmentNameKeyDown} - /> - {nameFocused && ( - <div - className={styles.assignmentNameSaveHint} - data-testid="classroom-detail-assignment-name-save-hint" - > - <FormattedMessage - defaultMessage="Press Enter or click outside the field to save" - description="Shown under the assignment name field while it is focused: how the name is saved" - id="gui.classroom.teacherDetail.assignmentNameSaveHint" - /> - </div> - )} - </div> - {nameSaveStatus === 'saved' && ( - <span - className={styles.assignmentNameSaved} - data-testid="classroom-detail-assignment-name-saved" - role="status" - > - {'✓ '} - <FormattedMessage - defaultMessage="Saved" - description="Shown next to the assignment name for a moment after it was saved" - id="gui.classroom.teacherDetail.assignmentNameSaved" - /> - </span> - )} - {nameSaveStatus === 'error' && ( - <span - className={styles.assignmentNameSaveError} - data-testid="classroom-detail-assignment-name-save-error" - role="alert" - > - <FormattedMessage - defaultMessage="Couldn't save" - description="Shown next to the assignment name when saving it failed" - id="gui.classroom.teacherDetail.assignmentNameSaveFailed" - /> - </span> - )} - </div> - - {/* 右: 参加コードカード。コードとボタンを 1 つの - flex flow に並べ、同じ行から始めることで 3 つの - ボタンが 2 行に収まる。狭い幅では全画面表示・招待 - リンクコピーをアイコンのみ、GC 共有を短縮表示。 */} - <div className={styles.joinCodeCard}> - <span className={styles.joinCodeCodePart}> - <span className={styles.joinCodeLabel}> - <FormattedMessage - defaultMessage="Join Code" - description="Join code label" - id="gui.classroom.joinCode.label" - /> - {': '} - </span> - <span className={styles.joinCodeValue} data-testid="classroom-detail-join-code"> - {selectedClassroom.joinCode.toLowerCase()} - </span> </span> - {/* 全画面表示: アイコンの横に「全画面」の文字(#1924 C11) */} - <button - className={styles.joinCodeAction} - data-testid="classroom-detail-expand-code" - title={intl.formatMessage({ - id: 'gui.classroom.joinCode.fullscreen', - defaultMessage: 'Show fullscreen', - description: 'Fullscreen the join code', - })} - type="button" - onClick={handleProject} - > - <span aria-hidden="true" className={styles.joinCodeIcon}> - {'⛶'} - </span> - {intl.formatMessage(classroomIconMessages.fullscreen)} - </button> - {/* 招待リンクをコピー: アイコンのみ。クリックすると - アイコンがチェックに変わり、コピー完了を示す。 */} + </button> + ))} + {/* 共有できない理由(GC コースの教師ではない共同担当) + をボタンの近くに出す。本当に GC の共同教師である + 先生だけが「確認する」で自分で解除できる。#1184 */} + {gcShareBlocked && ( + <div className={styles.joinCodeGcBlockedNote} data-testid="classroom-post-assignment-blocked"> + {gcShareBlockedText} + {gcCanVerify && ( <button - className={classNames(styles.joinCodeAction, { - [styles.joinCodeActionCopied]: inviteCopied, - })} - data-testid="classroom-detail-copy-link" - title={intl.formatMessage( - inviteCopied - ? { - id: 'gui.classroom.codeDisplay.copied', - defaultMessage: 'Copied', - description: 'Confirmation after copying invite link', - } - : { - id: 'gui.classroom.codeDisplay.copyLink', - defaultMessage: 'Copy invite link', - description: 'Button to copy classroom invite link', - }, - )} + className={styles.joinCodeGcVerifyButton} + data-testid="classroom-post-assignment-verify" + disabled={isVerifyingGoogleCourseAccess} type="button" - onClick={handleCopyInvite} + onClick={handleVerifyGcAccess} > - {inviteCopied ? ( - <svg - className={styles.joinCodeIcon} - fill="none" - height="15" - stroke="currentColor" - strokeWidth="2.5" - viewBox="0 0 24 24" - width="15" - > - <path d="M20 6L9 17l-5-5" /> - </svg> + {isVerifyingGoogleCourseAccess ? ( + <FormattedMessage + defaultMessage="Checking…" + description="Label while checking the teacher's Google Classroom access" + id="gui.classroom.googleShare.verifying" + /> ) : ( - <svg - className={styles.joinCodeIcon} - fill="none" - height="15" - stroke="currentColor" - strokeWidth="2" - viewBox="0 0 24 24" - width="15" - > - <rect height="13" rx="2" ry="2" width="13" x="9" y="9" /> - <path d="M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1" /> - </svg> + <FormattedMessage + defaultMessage="I am a teacher of this Google Classroom class (check)" + description="Button that lets a Google Classroom co-teacher prove their access and share" + id="gui.classroom.googleShare.verify" + /> )} </button> - {/* Google Classroom linkage lives on the class - (group), so an assignment posts to the group's - course even without its own courseId. ボタンは - 幅に関わらず "[アイコン]に共有" の短縮表示で固定。 */} - {(selectedClassroom.googleClassroomCourseId || - (group && group.googleClassroomCourseId)) && - (selectedClassroom.googleClassroomAlternateLink ? ( - <a - className={classNames(styles.joinCodeAction, styles.joinCodeActionGc)} - data-testid="classroom-view-assignment" - href={selectedClassroom.googleClassroomAlternateLink} - rel="noopener noreferrer" - target="_blank" - > - <img alt="" className={styles.gcImportIcon} src={googleClassroomIcon} /> - <span className={styles.joinCodeGcLabel}> - <FormattedMessage - defaultMessage="Open" - description="Short label (icon shows Google Classroom) to open the assignment" - id="gui.classroom.joinCode.openInGcShort" - /> - </span> - </a> - ) : ( - <button - className={classNames(styles.joinCodeAction, styles.joinCodeActionGc)} - data-testid="classroom-post-assignment" - disabled={gcShareBlocked} - title={gcShareBlockedText || null} - type="button" - onClick={onShowPostAssignment} - > - <img alt="" className={styles.gcImportIcon} src={googleClassroomIcon} /> - <span className={styles.joinCodeGcLabel}> - <FormattedMessage - defaultMessage="Share join code" - description="Short label (icon shows Google Classroom) to share the join code" - id="gui.classroom.joinCode.shareToGcShort" - /> - </span> - </button> - ))} - {/* 共有できない理由(GC コースの教師ではない共同担当) - をボタンの近くに出す。本当に GC の共同教師である - 先生だけが「確認する」で自分で解除できる。#1184 */} - {gcShareBlocked && ( - <div - className={styles.joinCodeGcBlockedNote} - data-testid="classroom-post-assignment-blocked" - > - {gcShareBlockedText} - {gcCanVerify && ( - <button - className={styles.joinCodeGcVerifyButton} - data-testid="classroom-post-assignment-verify" - disabled={isVerifyingGoogleCourseAccess} - type="button" - onClick={handleVerifyGcAccess} - > - {isVerifyingGoogleCourseAccess ? ( - <FormattedMessage - defaultMessage="Checking…" - description="Label while checking the teacher's Google Classroom access" - id="gui.classroom.googleShare.verifying" - /> - ) : ( - <FormattedMessage - defaultMessage="I am a teacher of this Google Classroom class (check)" - description="Button that lets a Google Classroom co-teacher prove their access and share" - id="gui.classroom.googleShare.verify" - /> - )} - </button> - )} - </div> - )} - </div> + )} </div> )} + </div> + {activeTab === 'description' && assignmentEditor ? ( + <button + className={styles.primaryButton} + data-testid="classroom-assignment-save" + disabled={descEditor.isSaving} + onClick={handleDescSave} + > + {descEditor.isSaving ? ( + <Spinner className={styles.buttonSpinner} small /> + ) : ( + <FormattedMessage + defaultMessage="Save Assignment" + description="Assignment editor: save" + id="gui.classroom.assignmentEditor.save" + /> + )} + </button> + ) : null} + </TeacherCloseRow> + <div className={styles.detailTwoPaneLayout}> + {/* Left pane */} + <div className={styles.detailLeftPane}> {/* 保存期限(#1303 D1・R4): ふだんは灰色の小さな 1 行。 残り 7 日以内のときだけ赤い警告と「全作品ダウンロード」を 日付の右に出す(課題一覧の行と同じ扱い)。狭い幅では @@ -986,7 +972,6 @@ const TeacherClassDetail = ({ onChangePeerView={handleDescChangePeerView} onChangeMeshGroupLimit={handleDescChangeMeshGroupLimit} onRemoveStarter={handleDescRemoveStarter} - onSave={handleDescSave} onUseCurrentProject={handleDescUseCurrentProject} onUseFile={handleDescUseFile} /> @@ -1409,6 +1394,10 @@ TeacherClassDetail.propTypes = { }), /** Back to the class (the stream): closing the[⛶ 映す]screen opened from the stream. */ onBackToBoard: PropTypes.func, + /** ✕ of the「✕ + 課題名」row (#2089): back to[授業]. Without it, no ✕. */ + onClose: PropTypes.func, + /** The description has changes that are not saved: ✕ asks before leaving. */ + hasUnsavedChanges: PropTypes.bool, /** Called when `detailEntry.project` was used, so the container forgets it. */ onProjectEntryUsed: PropTypes.func, onOpenShareSuggestion: PropTypes.func, diff --git a/packages/scratch-gui/src/components/classroom-modal/teacher-class-list.jsx b/packages/scratch-gui/src/components/classroom-modal/teacher-class-list.jsx index 1eebeac5dbe..688033febd6 100644 --- a/packages/scratch-gui/src/components/classroom-modal/teacher-class-list.jsx +++ b/packages/scratch-gui/src/components/classroom-modal/teacher-class-list.jsx @@ -28,6 +28,7 @@ import ErrorDisplay from './error-display.jsx'; import { breadcrumbMessages } from './teacher-breadcrumbs.jsx'; import ClassCard, { ArchiveClassDialog } from './teacher-class-card.jsx'; import { classTabMessages } from './teacher-class-tabs.jsx'; +import { closeRowMessages } from './teacher-close-row.jsx'; import TeacherReviewBand from './teacher-review-band.jsx'; import { TeacherScreen, TeacherSubView } from './teacher-view-layout.jsx'; @@ -752,7 +753,11 @@ const TeacherClassList = ({ errorTitle={errorTitle} testId="classroom-phase-teacher-class-list" > - <TeacherSubView title={formatClassLabel(settingsGroup)}> + <TeacherSubView + closeLabel={intl.formatMessage(closeRowMessages.backToClassList)} + title={intl.formatMessage(classTabMessages.settings)} + onClose={handleCloseSettings} + > <ClassSettingsForm group={settingsGroup} isLoading={isLoading} diff --git a/packages/scratch-gui/src/components/classroom-modal/teacher-close-row.jsx b/packages/scratch-gui/src/components/classroom-modal/teacher-close-row.jsx new file mode 100644 index 00000000000..d4b37d04e60 --- /dev/null +++ b/packages/scratch-gui/src/components/classroom-modal/teacher-close-row.jsx @@ -0,0 +1,153 @@ +/** + * The「✕ + 見出し」row on top of a teacher screen that edits one thing (#2089). + * + * Google Classroom puts a thin row with ✕ and the title above every edit + * screen (an assignment, the class settings, …), and ✕ goes back to the list. + * The class management keeps its purple header (「← エディタに戻る」 and the + * path) and adds this row under it, so the way back to the list looks the same + * as in Google Classroom while「← エディタに戻る」stays where it always is. + * + * When the screen holds changes that are not saved (`unsaved`), ✕ asks first + * in the row (no `confirm()`): [キャンセル]keeps the screen, [破棄]leaves. + * Leaving loses the changes and cannot be undone, so[破棄]is red (R4). + */ +import classNames from 'classnames'; +import PropTypes from 'prop-types'; +import React, { useCallback, useRef, useState } from 'react'; +import { defineMessages, useIntl } from 'react-intl'; +import ClassroomButton from './classroom-button.jsx'; +import styles from './classroom-modal.css'; + +export const closeRowMessages = defineMessages({ + backToAssignments: { + defaultMessage: 'Back to the assignments', + description: 'Accessible name of the ✕ on top of an assignment screen: back to the assignment list (授業)', + id: 'gui.classroom.closeRow.backToAssignments', + }, + backToClass: { + defaultMessage: 'Back to the class', + description: 'Accessible name of the ✕ on top of the class settings: back to the class screen', + id: 'gui.classroom.closeRow.backToClass', + }, + backToClassList: { + defaultMessage: 'Back to the class list', + description: 'Accessible name of the ✕ on top of the class settings opened from the class list', + id: 'gui.classroom.closeRow.backToClassList', + }, + backToAssignment: { + defaultMessage: 'Back to the assignment', + description: 'Accessible name of the ✕ on top of the Google Classroom share screen: back to the assignment', + id: 'gui.classroom.closeRow.backToAssignment', + }, + discardQuestion: { + defaultMessage: 'Discard the changes? The changes you have not saved will be lost.', + description: 'Asked in the ✕ row when the screen has changes that are not saved', + id: 'gui.classroom.closeRow.discardQuestion', + }, + discard: { + defaultMessage: 'Discard', + description: 'Button in the ✕ row: leave the screen and lose the changes that are not saved', + id: 'gui.classroom.closeRow.discard', + }, + cancel: { + defaultMessage: 'Cancel', + description: 'Button in the ✕ row: stay on the screen (keep the changes that are not saved)', + id: 'gui.classroom.closeRow.cancel', + }, +}); + +const CloseIcon = () => ( + <svg aria-hidden="true" fill="none" height="20" viewBox="0 0 24 24" width="20"> + <path d="M6 6l12 12M18 6L6 18" stroke="currentColor" strokeLinecap="round" strokeWidth="2.2" /> + </svg> +); + +const TeacherCloseRow = ({ + children, + closeLabel, + heading, + testId = 'classroom-close-row', + title, + unsaved, + onClose, +}) => { + const intl = useIntl(); + const [asking, setAsking] = useState(false); + const closeButtonRef = useRef(null); + const handleClose = useCallback(() => { + if (unsaved) { + setAsking(true); + return; + } + onClose(); + }, [unsaved, onClose]); + const handleDiscard = useCallback(() => { + setAsking(false); + onClose(); + }, [onClose]); + const handleKeep = useCallback(() => { + setAsking(false); + // The buttons of the question are gone: give the focus back to ✕. + setTimeout(() => closeButtonRef.current && closeButtonRef.current.focus(), 0); + }, []); + return ( + <div className={styles.closeRow} data-testid={testId}> + {onClose ? ( + <button + ref={closeButtonRef} + aria-label={closeLabel} + className={styles.closeRowButton} + data-testid={`${testId}-close`} + title={closeLabel} + type="button" + onClick={handleClose} + > + <CloseIcon /> + </button> + ) : null} + {title ? ( + <h2 className={styles.closeRowTitle} data-testid={`${testId}-title`}> + {title} + </h2> + ) : null} + {heading ? <div className={styles.closeRowHeading}>{heading}</div> : null} + {asking ? ( + <div className={styles.closeRowEnd}> + <p + className={classNames(styles.confirmNote, styles.closeRowConfirm)} + data-testid={`${testId}-discard-message`} + role="alert" + > + {intl.formatMessage(closeRowMessages.discardQuestion)} + </p> + <ClassroomButton autoFocus dataTestId={`${testId}-discard-cancel`} onClick={handleKeep}> + {intl.formatMessage(closeRowMessages.cancel)} + </ClassroomButton> + <ClassroomButton dataTestId={`${testId}-discard`} variant="danger" onClick={handleDiscard}> + {intl.formatMessage(closeRowMessages.discard)} + </ClassroomButton> + </div> + ) : children ? ( + <div className={styles.closeRowEnd}>{children}</div> + ) : null} + </div> + ); +}; + +TeacherCloseRow.propTypes = { + /** What sits at the right end of the row (the join code,[課題を保存]…). */ + children: PropTypes.node, + /** The accessible name of ✕: where it goes (「課題一覧に戻る」など). */ + closeLabel: PropTypes.string, + /** A heading that is not plain text (e.g. the editable assignment name). */ + heading: PropTypes.node, + testId: PropTypes.string, + /** The heading text (drawn as h2). */ + title: PropTypes.node, + /** The screen holds changes that are not saved: ✕ asks before leaving. */ + unsaved: PropTypes.bool, + /** Where ✕ goes. Without it the row has no ✕ (a screen drawn on its own, e.g. in a test). */ + onClose: PropTypes.func, +}; + +export default TeacherCloseRow; diff --git a/packages/scratch-gui/src/components/classroom-modal/teacher-passcode-import.jsx b/packages/scratch-gui/src/components/classroom-modal/teacher-passcode-import.jsx index ee9cd5cb2f3..cc500012169 100644 --- a/packages/scratch-gui/src/components/classroom-modal/teacher-passcode-import.jsx +++ b/packages/scratch-gui/src/components/classroom-modal/teacher-passcode-import.jsx @@ -5,12 +5,15 @@ */ import PropTypes from 'prop-types'; import React, { useCallback, useState } from 'react'; -import { FormattedMessage } from 'react-intl'; +import { FormattedMessage, useIntl } from 'react-intl'; import ClassroomButton from './classroom-button.jsx'; import styles from './classroom-modal.css'; +import { closeRowMessages } from './teacher-close-row.jsx'; import { TeacherSubView } from './teacher-view-layout.jsx'; const TeacherPasscodeImport = ({ group, isLoading, lookup, error, onLookup, onImport, onCancel }) => { + const intl = useIntl(); + const backLabel = intl.formatMessage(closeRowMessages.backToAssignments); const [passcode, setPasscode] = useState(''); const handleChange = useCallback((e) => { @@ -65,6 +68,8 @@ const TeacherPasscodeImport = ({ group, isLoading, lookup, error, onLookup, onIm return ( <TeacherSubView + closeLabel={backLabel} + onClose={onCancel} footer={footer} hint={ <FormattedMessage diff --git a/packages/scratch-gui/src/components/classroom-modal/teacher-post-assignment.jsx b/packages/scratch-gui/src/components/classroom-modal/teacher-post-assignment.jsx index 05c304ae794..5c1566b4982 100644 --- a/packages/scratch-gui/src/components/classroom-modal/teacher-post-assignment.jsx +++ b/packages/scratch-gui/src/components/classroom-modal/teacher-post-assignment.jsx @@ -1,10 +1,11 @@ import PropTypes from 'prop-types'; import React, { useCallback, useState } from 'react'; -import { FormattedMessage } from 'react-intl'; +import { FormattedMessage, useIntl } from 'react-intl'; import { formatClassLabel } from '../../lib/classroom-class-label.js'; import googleClassroomIcon from '../classroom-teacher-modal/google-classroom-icon.png'; import styles from './classroom-modal.css'; import ErrorDisplay from './error-display.jsx'; +import TeacherCloseRow, { closeRowMessages } from './teacher-close-row.jsx'; const TeacherPostAssignment = ({ error, @@ -15,6 +16,7 @@ const TeacherPostAssignment = ({ onBack, onPostAssignment, }) => { + const intl = useIntl(); const defaultTitle = selectedClassroom?.assignmentName || ''; const [title, setTitle] = useState(defaultTitle); const [description, setDescription] = useState(''); @@ -47,18 +49,33 @@ const TeacherPostAssignment = ({ return ( <div className={styles.postAssignmentContainer} data-testid="classroom-phase-teacher-post-assignment"> + {/* 「✕ + 見出し」の行(#2089): ✕ で開いた元の課題詳細へ戻る([キャンセル]と同じ)。 */} + <TeacherCloseRow + closeLabel={intl.formatMessage(closeRowMessages.backToAssignment)} + title={ + posted ? ( + <span className={styles.postAssignmentSuccessTitle}> + {'✓ '} + <FormattedMessage + defaultMessage="Assignment posted!" + description="Assignment posted successfully" + id="gui.classroom.postAssignment.success" + /> + </span> + ) : ( + <FormattedMessage + defaultMessage="Post assignment to Google Classroom" + description="Post assignment page title" + id="gui.classroom.postAssignment.pageTitle" + /> + ) + } + onClose={onBack} + /> {posted ? ( // 配信後: タイトル(成功) + ヒント + フッター(左=戻る / 右=確認)。 // 基本レイアウト(プライマリー右下・キャンセル左下)に揃える。 <div data-testid="classroom-post-assignment-success"> - <div className={styles.postAssignmentSuccessTitle}> - {'✓ '} - <FormattedMessage - defaultMessage="Assignment posted!" - description="Assignment posted successfully" - id="gui.classroom.postAssignment.success" - /> - </div> <p className={styles.subViewHint}> <FormattedMessage defaultMessage="You can edit or delete this assignment on Google Classroom." @@ -99,13 +116,6 @@ const TeacherPostAssignment = ({ </div> ) : ( <> - <div className={styles.phaseTitle}> - <FormattedMessage - defaultMessage="Post assignment to Google Classroom" - description="Post assignment page title" - id="gui.classroom.postAssignment.pageTitle" - /> - </div> {/* クラス名(対象ラベルなし・課題詳細と同じ表記) */} <div className={styles.postAssignmentTarget}>{targetLabel}</div> <div className={styles.formGroup}> @@ -191,7 +201,7 @@ TeacherPostAssignment.propTypes = { section: PropTypes.string, }), isLoading: PropTypes.bool, - onBack: PropTypes.func, + onBack: PropTypes.func.isRequired, onPostAssignment: PropTypes.func.isRequired, selectedClassroom: PropTypes.shape({ assignmentName: PropTypes.string, diff --git a/packages/scratch-gui/src/components/classroom-modal/teacher-share-step.jsx b/packages/scratch-gui/src/components/classroom-modal/teacher-share-step.jsx index fa25fb615b2..9506ff64f03 100644 --- a/packages/scratch-gui/src/components/classroom-modal/teacher-share-step.jsx +++ b/packages/scratch-gui/src/components/classroom-modal/teacher-share-step.jsx @@ -8,13 +8,16 @@ import classNames from 'classnames'; import PropTypes from 'prop-types'; import React, { useCallback, useState } from 'react'; -import { FormattedMessage } from 'react-intl'; +import { FormattedMessage, useIntl } from 'react-intl'; import ClassroomButton from './classroom-button.jsx'; import styles from './classroom-modal.css'; import SharedAssignmentForm from './shared-assignment-form.jsx'; +import { closeRowMessages } from './teacher-close-row.jsx'; import { TeacherSubView } from './teacher-view-layout.jsx'; const TeacherShareStep = ({ classroom, isLoading, lastShared, onShare, onCancel }) => { + const intl = useIntl(); + const backLabel = intl.formatMessage(closeRowMessages.backToAssignments); const [mode, setMode] = useState('limited'); const [title, setTitle] = useState(classroom.assignmentName || classroom.className || ''); const [copied, setCopied] = useState(false); @@ -38,6 +41,8 @@ const TeacherShareStep = ({ classroom, isLoading, lastShared, onShare, onCancel if (lastShared) { return ( <TeacherSubView + closeLabel={backLabel} + onClose={onCancel} footer={ <> <span /> @@ -121,6 +126,8 @@ const TeacherShareStep = ({ classroom, isLoading, lastShared, onShare, onCancel return ( <TeacherSubView + closeLabel={backLabel} + onClose={onCancel} testId="classroom-phase-share-step" title={ <FormattedMessage diff --git a/packages/scratch-gui/src/components/classroom-modal/teacher-view-layout.jsx b/packages/scratch-gui/src/components/classroom-modal/teacher-view-layout.jsx index 515e8acdeb1..5c9bf01dc94 100644 --- a/packages/scratch-gui/src/components/classroom-modal/teacher-view-layout.jsx +++ b/packages/scratch-gui/src/components/classroom-modal/teacher-view-layout.jsx @@ -21,6 +21,7 @@ import React from 'react'; import styles from './classroom-modal.css'; import ErrorDisplay from './error-display.jsx'; import TeacherBreadcrumbs from './teacher-breadcrumbs.jsx'; +import TeacherCloseRow from './teacher-close-row.jsx'; const breadcrumbItemsShape = PropTypes.arrayOf( PropTypes.shape({ @@ -70,17 +71,22 @@ TeacherScreen.propTypes = { title: PropTypes.node, }; -/* パネル内サブ画面。`as="form"` にすると `<form>` として描画し `onSubmit` を通す。 */ +/* パネル内サブ画面。`as="form"` にすると `<form>` として描画し `onSubmit` を通す。 + `onClose` を渡すと、タイトルは「✕ + 見出し」の行(`TeacherCloseRow`・#2089)になる。 */ export const TeacherSubView = ({ as = 'div', children, className, + closeLabel, error, errorTitle, footer, hint, testId, title, + titleEnd, + unsaved, + onClose, onSubmit, }) => { const Container = as; @@ -88,7 +94,13 @@ export const TeacherSubView = ({ const submitProps = as === 'form' ? { onSubmit } : {}; return ( <Container className={className || styles.panelInnerView} data-testid={testId} {...submitProps}> - {title ? <div className={styles.phaseTitle}>{title}</div> : null} + {onClose ? ( + <TeacherCloseRow closeLabel={closeLabel} title={title} unsaved={unsaved} onClose={onClose}> + {titleEnd} + </TeacherCloseRow> + ) : title ? ( + <div className={styles.phaseTitle}>{title}</div> + ) : null} {/* サブ画面の説明文は .sub-view-hint (旧 .post-assignment-hint)。 トップレベル画面の .teacher-view-hint とは色・サイズが違う。 */} {hint ? <p className={styles.subViewHint}>{hint}</p> : null} @@ -103,6 +115,8 @@ TeacherSubView.propTypes = { as: PropTypes.oneOf(['div', 'form']), children: PropTypes.node, className: PropTypes.string, + /** ✕ の名前(行き先。「課題一覧に戻る」など)。`onClose` と対で渡す。 */ + closeLabel: PropTypes.string, error: PropTypes.string, errorTitle: PropTypes.string, /** セカンダリ左・プライマリ右で並べるボタン行。 */ @@ -110,5 +124,11 @@ TeacherSubView.propTypes = { hint: PropTypes.node, testId: PropTypes.string, title: PropTypes.node, + /** ✕ の行の右端に置くもの。 */ + titleEnd: PropTypes.node, + /** 保存していない変更がある: ✕ は先に破棄してよいか聞く。 */ + unsaved: PropTypes.bool, + /** ✕ で戻る先。渡すとタイトルが ✕ の行になる。 */ + onClose: PropTypes.func, onSubmit: PropTypes.func, }; diff --git a/packages/scratch-gui/src/components/classroom-teacher-modal/classroom-teacher-modal.jsx b/packages/scratch-gui/src/components/classroom-teacher-modal/classroom-teacher-modal.jsx index 26373fe63ea..caa0e315f16 100644 --- a/packages/scratch-gui/src/components/classroom-teacher-modal/classroom-teacher-modal.jsx +++ b/packages/scratch-gui/src/components/classroom-teacher-modal/classroom-teacher-modal.jsx @@ -123,6 +123,7 @@ const ClassroomTeacherModal = ({ containerProps, onClose }) => { assignmentSavedSettings, assignmentLessonDraft, assignmentSavedLesson, + assignmentHasUnsavedChanges, onAssignmentAddPage, onAssignmentRemovePage, onAssignmentMovePage, @@ -188,15 +189,23 @@ const ClassroomTeacherModal = ({ containerProps, onClose }) => { // A class opens on[ストリーム](B5). Coming back from an assignment of the // same class returns to the tab the teacher left (e.g.[授業]); another // class or the class list starts on the stream again. - const [boardTab, setBoardTab] = useState({ groupId: null, tab: 'stream' }); + // `openId`: the assignment row to open once when the board mounts — the ✕ of the + // assignment detail comes back to[授業]with that assignment's row open (#2089). + const [boardTab, setBoardTab] = useState({ groupId: null, tab: 'stream', openId: null }); const selectedGroupId = selectedGroup ? selectedGroup.groupId : null; + const selectedClassroomId = selectedClassroom ? selectedClassroom.classroomId : null; + const handleCloseDetail = useCallback(() => { + setBoardTab({ groupId: selectedGroupId, tab: 'classwork', openId: selectedClassroomId }); + onBackToDashboard(); + }, [selectedGroupId, selectedClassroomId, onBackToDashboard]); + const handleBoardOpenRowUsed = useCallback(() => setBoardTab((prev) => ({ ...prev, openId: null })), []); const handleBoardTabChange = useCallback( - (tab) => setBoardTab({ groupId: selectedGroupId, tab }), + (tab) => setBoardTab({ groupId: selectedGroupId, tab, openId: null }), [selectedGroupId], ); // Leaving the class (the class list clears selectedGroup) forgets the tab. useEffect(() => { - if (!selectedGroupId) setBoardTab({ groupId: null, tab: 'stream' }); + if (!selectedGroupId) setBoardTab({ groupId: null, tab: 'stream', openId: null }); }, [selectedGroupId]); // Opening a class scopes the board to its assignments (GC style). @@ -231,7 +240,7 @@ const ClassroomTeacherModal = ({ containerProps, onClose }) => { if (!evaluation || !evalGroup || tab === 'grading') return; evaluation.handleRequestLeave(() => { evaluation.handleBackFromEvaluation(); - setBoardTab({ groupId: evalGroup.groupId, tab }); + setBoardTab({ groupId: evalGroup.groupId, tab, openId: null }); onSelectGroup(evalGroup); }, 'leave'); }, @@ -453,6 +462,7 @@ const ClassroomTeacherModal = ({ containerProps, onClose }) => { errorTitle={errorTitle} googleCourseAccess={googleCourseAccess} group={selectedGroup} + hasUnsavedChanges={Boolean(assignmentHasUnsavedChanges)} isLoading={isLoading} isVerifyingGoogleCourseAccess={isVerifyingGoogleCourseAccess} kickRequestsBySeat={kickRequestsBySeat} @@ -470,6 +480,7 @@ const ClassroomTeacherModal = ({ containerProps, onClose }) => { memberCommentDrafts={memberCommentDrafts} onChangeMemberCommentDraft={onChangeMemberCommentDraft} onBackToBoard={onBackToDashboard} + onClose={handleCloseDetail} onProjectEntryUsed={onProjectEntryUsed} onDetailTabChange={onDetailTabChange} onDownloadAll={onDownloadAll} @@ -557,6 +568,7 @@ const ClassroomTeacherModal = ({ containerProps, onClose }) => { error={error} errorTitle={errorTitle} group={selectedGroup} + initialOpenId={boardTab.groupId === selectedGroup.groupId ? boardTab.openId : null} initialTab={boardTab.groupId === selectedGroup.groupId ? boardTab.tab : 'stream'} isLoading={isLoading} shared={shared} @@ -568,6 +580,7 @@ const ClassroomTeacherModal = ({ containerProps, onClose }) => { onSelectClassroom={onSelectClassroom} onShowClassList={onShowClassList} onShowGrading={evaluation ? handleShowGradingFromClass : null} + onInitialOpenUsed={handleBoardOpenRowUsed} onTabChange={handleBoardTabChange} onUpdateAssignmentMeta={onUpdateAssignmentMeta} onUpdateGroup={onUpdateGroup} diff --git a/packages/scratch-gui/src/components/gui/gui.jsx b/packages/scratch-gui/src/components/gui/gui.jsx index 295cb3b0dea..2a46abbbd9a 100644 --- a/packages/scratch-gui/src/components/gui/gui.jsx +++ b/packages/scratch-gui/src/components/gui/gui.jsx @@ -70,15 +70,15 @@ import MeshV2ClassroomBinding from '../../lib/mesh-v2-classroom-binding.jsx'; import ClassroomMeshConnectPrompt from '../../containers/classroom-mesh-connect-prompt.jsx'; // === Smalruby: End of meshV2 classroom binding === -// === Smalruby: Start of meshV2 self-sensor notice === -import MeshSelfSensorNotice from '../../containers/mesh-self-sensor-notice.jsx'; -// === Smalruby: End of meshV2 self-sensor notice === // === Smalruby: Start of mesh status popup === import MeshStatusPopup from '../../containers/mesh-status-popup.jsx'; // === Smalruby: End of mesh status popup === // === Smalruby: Start of lesson goal watcher === import LessonGoalWatcher from '../../containers/lesson-goal-watcher.jsx'; // === Smalruby: End of lesson goal watcher === +// === Smalruby: Start of block activity diagram === +import BlockActivityDiagram from '../../containers/block-activity-diagram.jsx'; +// === Smalruby: End of block activity diagram === // === Smalruby: Start of welcome modal === import WelcomeModalHOC from '../../containers/welcome-modal-hoc.jsx'; // === Smalruby: End of welcome modal === @@ -584,15 +584,15 @@ const GUIComponent = props => { <MeshV2ClassroomBinding /> <ClassroomMeshConnectPrompt /> {/* === Smalruby: End of meshV2 classroom binding === */} - {/* === Smalruby: Start of meshV2 self-sensor notice === */} - <MeshSelfSensorNotice /> - {/* === Smalruby: End of meshV2 self-sensor notice === */} {/* === Smalruby: Start of mesh status popup === */} <MeshStatusPopup /> {/* === Smalruby: End of mesh status popup === */} {/* === Smalruby: Start of lesson goal watcher === */} <LessonGoalWatcher /> {/* === Smalruby: End of lesson goal watcher === */} + {/* === Smalruby: Start of block activity diagram === */} + <BlockActivityDiagram /> + {/* === Smalruby: End of block activity diagram === */} {/* === Smalruby: End of smalrubot firmware modal === */} {/* === Smalruby: Start of welcome modal === */} <WelcomeModalHOC /> diff --git a/packages/scratch-gui/src/components/lesson-activity-diagram/lesson-activity-diagram.css b/packages/scratch-gui/src/components/lesson-activity-diagram/lesson-activity-diagram.css new file mode 100644 index 00000000000..43f01b2789f --- /dev/null +++ b/packages/scratch-gui/src/components/lesson-activity-diagram/lesson-activity-diagram.css @@ -0,0 +1,60 @@ +@import '../../css/colors.css'; + +/* + 答えのプログラムから描いたアクティビティ図(SVG)。大きさは置き方(viewBox)から決め、入れる場所 + (課題の全文・ヒントの吹き出し)の幅と高さの上限に合わせて縦横の比のまま縮める。線と字は + ワークシートと同じく濃い 1 色、記号の中は白(全文のパネル・吹き出しはどちらも白地)。 +*/ +.diagram { + display: block; + width: auto; + max-width: 100%; + height: auto; + flex-shrink: 0; + color: $text-primary; +} + +.line { + fill: none; + stroke: currentColor; + stroke-width: 1.4; +} + +.shape { + fill: $ui-white; + stroke: currentColor; + stroke-width: 1.3; +} + +.lane { + fill: none; + stroke: currentColor; + stroke-width: 1; +} + +.solid { + fill: currentColor; + stroke: none; +} + +.text { + fill: currentColor; + font-size: 12px; +} + +.small-text { + fill: currentColor; + font-size: 11px; +} + +.caption { + fill: currentColor; + font-size: 11px; + font-weight: bold; +} + +.lane-title { + fill: currentColor; + font-size: 12px; + font-weight: bold; +} diff --git a/packages/scratch-gui/src/components/lesson-activity-diagram/lesson-activity-diagram.jsx b/packages/scratch-gui/src/components/lesson-activity-diagram/lesson-activity-diagram.jsx new file mode 100644 index 00000000000..c26d65def25 --- /dev/null +++ b/packages/scratch-gui/src/components/lesson-activity-diagram/lesson-activity-diagram.jsx @@ -0,0 +1,281 @@ +// 答えのプログラムから描いたアクティビティ図(lib/lessons/activity-diagram の置き方)を SVG にする。 +// 記号は教科書のアクティビティ図にそろえる(docs/lessons/design.md の「アクティビティ図」): 開始(黒丸)・ +// 終了(二重丸)・処理(角の丸い箱)・分岐と合流(中に字の無いひし形。条件は枝の「[条件]」)・送信(相手の +// 向きがとがった五角形)・受信(送り手の向きがへこんだ箱)。くり返しはひし形の合流と戻る線(置き方が線で描く)。 +// スクリーンショットは使わない。 +// 課題の全文(lesson-task-bar)とヒントの 1 ページ目(lesson-hint)で使う。 +import PropTypes from 'prop-types'; +import React, { useId } from 'react'; +import { defineMessages, useIntl } from 'react-intl'; +import { + DIAGRAM_SHAPES, + FONT_SIZE, + MIN_DIAGRAM_SCALE, + RECEIVE_NOTCH, + SEND_TIP, + SMALL_FONT_SIZE, +} from '../../lib/lessons/activity-diagram/layout'; +import styles from './lesson-activity-diagram.css'; + +const messages = defineMessages({ + ariaLabel: { + id: 'gui.lessons.activityDiagram.ariaLabel', + description: 'Accessible name of the activity diagram drawn from the answer program of a lesson challenge', + defaultMessage: 'Activity diagram', + }, +}); + +const LINE_HEIGHT = 15; +const SMALL_LINE_HEIGHT = 14; + +// 行の並びを、cy を真ん中にして縦に並べる +const Lines = ({ lines, x, cy, anchor = 'middle', small = false }) => { + const lineHeight = small ? SMALL_LINE_HEIGHT : LINE_HEIGHT; + const size = small ? SMALL_FONT_SIZE : FONT_SIZE; + const top = cy - (lines.length * lineHeight) / 2; + return ( + <text className={small ? styles.smallText : styles.text} textAnchor={anchor}> + {lines.map((line, i) => ( + <tspan key={i} x={x} y={top + lineHeight * i + (lineHeight + size) / 2 - 2}> + {line} + </tspan> + ))} + </text> + ); +}; + +Lines.propTypes = { + anchor: PropTypes.string, + cy: PropTypes.number.isRequired, + lines: PropTypes.arrayOf(PropTypes.string).isRequired, + small: PropTypes.bool, + x: PropTypes.number.isRequired, +}; + +const diamond = ({ x, y, w, h }) => `${x + w / 2},${y} ${x + w},${y + h / 2} ${x + w / 2},${y + h} ${x},${y + h / 2}`; + +// 送信: とがった側(direction)を相手に向けた五角形。相手が両側にいれば両側がとがった六角形 +const sendOutline = ({ x, y, w, h, direction }) => { + const left = direction === 'left' || direction === 'both'; + const right = direction !== 'left'; + const l = left ? SEND_TIP : 0; + const r = right ? SEND_TIP : 0; + return [ + `${x + l},${y}`, + `${x + w - r},${y}`, + ...(right ? [`${x + w},${y + h / 2}`] : []), + `${x + w - r},${y + h}`, + `${x + l},${y + h}`, + ...(left ? [`${x},${y + h / 2}`] : []), + ].join(' '); +}; + +// 受信: 送り手の側(notch)が内へへこんだ箱。送り手が両側にいれば両側がへこむ +const receiveOutline = ({ x, y, w, h, notch }) => { + const left = notch !== 'right'; + const right = notch === 'right' || notch === 'both'; + return [ + `${x},${y}`, + `${x + w},${y}`, + ...(right ? [`${x + w - RECEIVE_NOTCH},${y + h / 2}`] : []), + `${x + w},${y + h}`, + `${x},${y + h}`, + ...(left ? [`${x + RECEIVE_NOTCH},${y + h / 2}`] : []), + ].join(' '); +}; + +// 字を記号の中の真ん中に置く(片側だけのとがり・へこみのぶんだけ寄せる) +const textCenterX = ({ type, x, w, direction, notch }) => { + if (type === DIAGRAM_SHAPES.SEND) { + if (direction === 'both') return x + w / 2; + return x + w / 2 + (direction === 'left' ? SEND_TIP : -SEND_TIP) / 2; + } + if (type === DIAGRAM_SHAPES.RECEIVE) { + if (notch === 'both') return x + w / 2; + return x + w / 2 + (notch === 'right' ? -RECEIVE_NOTCH : RECEIVE_NOTCH) / 2; + } + return x + w / 2; +}; + +const Shape = ({ shape }) => { + const { type, x, y, w, h } = shape; + const cx = x + w / 2; + const cy = y + h / 2; + switch (type) { + case DIAGRAM_SHAPES.START: + return ( + <g data-shape={type}> + <circle className={styles.solid} cx={cx} cy={cy} r={w / 2} /> + {shape.lines && shape.lines.length > 0 ? ( + <Lines lines={shape.lines} x={x + w + 6} cy={cy} anchor="start" small /> + ) : null} + </g> + ); + case DIAGRAM_SHAPES.END: + return ( + <g data-shape={type}> + <circle className={styles.shape} cx={cx} cy={cy} r={w / 2} /> + <circle className={styles.solid} cx={cx} cy={cy} r={w / 2 - 3.5} /> + </g> + ); + case DIAGRAM_SHAPES.ACTION: + return ( + <g data-shape={type}> + <rect className={styles.shape} x={x} y={y} width={w} height={h} rx={Math.min(h / 2, 12)} /> + <Lines lines={shape.lines} x={cx} cy={cy} /> + </g> + ); + case DIAGRAM_SHAPES.SEND: + return ( + <g data-shape={type} data-direction={shape.direction}> + <polygon className={styles.shape} points={sendOutline(shape)} /> + <Lines lines={shape.lines} x={textCenterX(shape)} cy={cy} /> + </g> + ); + case DIAGRAM_SHAPES.RECEIVE: + return ( + <g data-shape={type} data-notch={shape.notch}> + <polygon className={styles.shape} points={receiveOutline(shape)} /> + <Lines lines={shape.lines} x={textCenterX(shape)} cy={cy} /> + </g> + ); + case DIAGRAM_SHAPES.DECISION: + case DIAGRAM_SHAPES.MERGE: + // 教科書と同じく、ひし形の中には字を書かない(条件は枝のガード) + return <polygon data-shape={type} className={styles.shape} points={diamond(shape)} />; + case DIAGRAM_SHAPES.GUARD: + return ( + <g data-shape={type}> + <Lines + lines={shape.lines} + x={shape.anchor === 'end' ? x + w : x} + cy={cy} + anchor={shape.anchor} + small + /> + </g> + ); + case DIAGRAM_SHAPES.LANE: + return ( + <g data-shape={type}> + <rect className={styles.lane} x={x} y={y} width={w} height={h} /> + <line className={styles.lane} x1={x} y1={y + shape.headerH} x2={x + w} y2={y + shape.headerH} /> + <text className={styles.laneTitle} x={cx} y={y + shape.headerH / 2 + 4} textAnchor="middle"> + {shape.label} + </text> + </g> + ); + case DIAGRAM_SHAPES.CAPTION: + return ( + <text data-shape={type} className={styles.caption} x={x} y={y + h - 3}> + {shape.label} + </text> + ); + default: + return null; + } +}; + +Shape.propTypes = { + shape: PropTypes.shape({ + type: PropTypes.string.isRequired, + x: PropTypes.number.isRequired, + y: PropTypes.number.isRequired, + w: PropTypes.number.isRequired, + h: PropTypes.number.isRequired, + // 箱・開始・ガードの文の行 + lines: PropTypes.arrayOf(PropTypes.string), + label: PropTypes.string, + // ガードの寄せ方(start / end) + anchor: PropTypes.string, + // 送信のとがった向き・受信のへこみの側(left / right / both) + direction: PropTypes.string, + notch: PropTypes.string, + // レーンの見出しの高さ + headerH: PropTypes.number, + }).isRequired, +}; + +const LessonActivityDiagram = ({ className = null, layout, scale = null }) => { + const intl = useIntl(); + // 課題の全文とヒントで同時に描くことがあるので、矢じりなどの id はコンポーネントごとに分ける + const idBase = `lesson-activity-diagram-${useId().replace(/:/g, '')}`; + const markerId = `${idBase}-arrow`; + const descId = `${idBase}-desc`; + // スクリプトが 1 つも無い図(空の枠)は描かない + if (!layout || layout.shapes.length === 0) return null; + // scale があればその大きさで描く。無ければ入れる場所の CSS(max-width / max-height)で縮み、 + // 字が読めなくならないよう下限(MIN_DIAGRAM_SCALE)より小さくはしない(入らなければ入れる側がスクロールさせる) + const sizeStyle = + scale === null + ? { minWidth: layout.width * MIN_DIAGRAM_SCALE, minHeight: layout.height * MIN_DIAGRAM_SCALE } + : { width: layout.width * scale, height: layout.height * scale, maxWidth: 'none', maxHeight: 'none' }; + // レーンの枠 → 矢印 → 記号の順に描く(記号の白で線の端が隠れるように) + const lanes = layout.shapes.filter((s) => s.type === DIAGRAM_SHAPES.LANE); + const others = layout.shapes.filter((s) => s.type !== DIAGRAM_SHAPES.LANE); + return ( + <svg + className={className ? `${styles.diagram} ${className}` : styles.diagram} + data-testid="lesson-activity-diagram" + role="img" + aria-label={intl.formatMessage(messages.ariaLabel)} + aria-describedby={layout.description ? descId : null} + viewBox={`0 0 ${layout.width} ${layout.height}`} + width={layout.width} + height={layout.height} + // 縦の上限で縮んだときも左上にそろえる(幅だけ残って真ん中に寄らないように) + preserveAspectRatio="xMinYMin meet" + style={sizeStyle} + xmlns="http://www.w3.org/2000/svg" + > + <title>{intl.formatMessage(messages.ariaLabel)} + {/* 流れを文にした代わりの文(スクリーンリーダー向け。「読んで作る」は図だけで指示するため) */} + {layout.description ? {layout.description} : null} + + + + + + {lanes.map((shape, i) => ( + + ))} + {layout.edges.map((edge, i) => ( + p.join(',')).join(' ')} + {...(edge.arrow ? { markerEnd: `url(#${markerId})` } : {})} + /> + ))} + {others.map((shape, i) => ( + + ))} + + ); +}; + +LessonActivityDiagram.propTypes = { + className: PropTypes.string, + // lib/lessons/activity-diagram/layout.js の layoutActivityDiagram の戻り値。無ければ何も描かない + layout: PropTypes.shape({ + width: PropTypes.number.isRequired, + height: PropTypes.number.isRequired, + shapes: PropTypes.arrayOf(PropTypes.object).isRequired, + edges: PropTypes.arrayOf(PropTypes.object).isRequired, + // 流れを文にした代わりの文(challenge-diagram.js が付ける) + description: PropTypes.string, + }), + // 描く倍率(課題の全文のように、入れる側が大きさを決めるとき)。無ければ CSS で縮み、下限で止まる + scale: PropTypes.number, +}; + +export default LessonActivityDiagram; diff --git a/packages/scratch-gui/src/components/lesson-completed-toast/lesson-completed-quiz.css b/packages/scratch-gui/src/components/lesson-completed-toast/lesson-completed-quiz.css new file mode 100644 index 00000000000..69bb2a1e9d7 --- /dev/null +++ b/packages/scratch-gui/src/components/lesson-completed-toast/lesson-completed-quiz.css @@ -0,0 +1,116 @@ +@import '../../css/colors.css'; + +/* ふりかえりのクイズ(「できた!」の中)。色は toast の --accent を引き継ぐ。 + 正解/はずれの色は字が白地で WCAG AA(4.5:1)に届く濃さにする */ +$quiz-correct: hsla(163, 86%, 26%, 1); /* #097A5B */ +$quiz-wrong: hsla(0, 70%, 42%, 1); /* #B62020 */ + +.quiz { + margin-top: 12px; + padding: 10px 12px 12px; + border-radius: 10px; + border: 2px solid var(--accent); + background-color: $ui-white; +} + +.label { + font-size: 12px; + font-weight: bold; + color: var(--accent-ink); +} + +.question { + margin-top: 2px; + font-size: 15px; + font-weight: bold; + line-height: 1.35; + overflow-wrap: anywhere; +} + +.choices { + display: flex; + flex-direction: column; + gap: 6px; + margin-top: 8px; +} + +.choice { + display: flex; + align-items: center; + gap: 8px; + min-height: 36px; + padding: 4px 12px 4px 6px; + border: 2px solid $ui-tertiary; + border-radius: 18px; + background-color: $ui-white; + color: $text-primary; + font-size: 14px; + text-align: left; + cursor: pointer; +} + +.choice:hover { + border-color: var(--accent); +} + +.mark { + display: inline-flex; + align-items: center; + justify-content: center; + flex-shrink: 0; + width: 24px; + height: 24px; + border-radius: 50%; + background-color: $ui-tertiary; + color: $text-primary; + font-size: 13px; + font-weight: bold; +} + +.choice-text { + overflow-wrap: anywhere; +} + +.choice-correct, +.choice-correct:hover { + border-color: $quiz-correct; +} + +.choice-correct .mark { + background-color: $quiz-correct; + color: $ui-white; +} + +.choice-wrong, +.choice-wrong:hover { + border-color: $quiz-wrong; +} + +.choice-wrong .mark { + background-color: $quiz-wrong; + color: $ui-white; +} + +.feedback { + margin-top: 8px; +} + +.result { + font-size: 15px; + font-weight: bold; +} + +.result-correct { + color: $quiz-correct; +} + +.result-wrong { + color: $quiz-wrong; +} + +.explanation { + margin-top: 2px; + font-size: 14px; + line-height: 1.4; + overflow-wrap: anywhere; +} diff --git a/packages/scratch-gui/src/components/lesson-completed-toast/lesson-completed-quiz.jsx b/packages/scratch-gui/src/components/lesson-completed-toast/lesson-completed-quiz.jsx new file mode 100644 index 00000000000..4e5ec6cde95 --- /dev/null +++ b/packages/scratch-gui/src/components/lesson-completed-toast/lesson-completed-quiz.jsx @@ -0,0 +1,112 @@ +import classNames from 'classnames'; +import PropTypes from 'prop-types'; +import React, { useCallback, useId, useState } from 'react'; +import { defineMessages, injectIntl } from 'react-intl'; +import intlShape from '../../lib/intlShape.js'; +import styles from './lesson-completed-quiz.css'; + +const messages = defineMessages({ + label: { + id: 'gui.lessons.completed.quizLabel', + defaultMessage: 'Quick quiz', + description: 'Small heading above the 3-choice reflection quiz in the "You did it!" toast', + }, + correct: { + id: 'gui.lessons.completed.quizCorrect', + defaultMessage: 'Correct!', + description: 'Shown when the student chose the right answer of the reflection quiz', + }, + wrong: { + id: 'gui.lessons.completed.quizWrong', + defaultMessage: 'Not quite. Try another one.', + description: 'Shown when the student chose a wrong answer of the reflection quiz; they can choose again', + }, +}); + +/** + * ふりかえりのクイズ(#1639)。「できた!」の表示の中に出す 3 択。選ぶと正解/はずれと解説を出し、 + * 何度でも選び直せる。「できた」の判定には関係しない(選んだものは記録しない)。 + * 選んだものは、この部品の中だけに持つ(別のチャレンジの「できた!」では key で作り直す)。 + * 読み上げ: 3 つから 1 つを選ぶので radiogroup / radio。結果の読み上げは toast(外側の role="status")に + * 任せ、ここには live region を置かない(入れ子にしない)。はずれを続けて選んでも字が変わるように、 + * 結果の文の前に選んだ番号を付ける(「3: はずれ…」)。 + * @param {object} props - props。 + * @param {object} props.quiz - チャレンジの `quiz`(courses.js の `challengeQuiz`)。 + * @param {object} props.intl - react-intl。 + * @returns {React.ReactElement} クイズ。 + */ +const LessonCompletedQuiz = ({ quiz, intl }) => { + const [selected, setSelected] = useState(null); + const handleChoose = useCallback((event) => setSelected(Number(event.currentTarget.dataset.index)), []); + const answered = selected !== null; + const correct = answered && selected === quiz.answer; + const questionId = useId(); + return ( +
+
+ {intl.formatMessage(messages.label)} +
+
+ {intl.formatMessage(quiz.question)} +
+
+ {quiz.choices.map((choice, index) => { + const isSelected = selected === index; + let result; + if (isSelected) result = correct ? 'correct' : 'wrong'; + return ( + + ); + })} +
+ {answered && ( +
+
+ {`${selected + 1}: ${intl.formatMessage(correct ? messages.correct : messages.wrong)}`} +
+
+ {intl.formatMessage(quiz.explanation)} +
+
+ )} +
+ ); +}; + +const messageShape = PropTypes.shape({ id: PropTypes.string.isRequired }); + +LessonCompletedQuiz.propTypes = { + intl: intlShape.isRequired, + quiz: PropTypes.shape({ + question: messageShape.isRequired, + choices: PropTypes.arrayOf(messageShape).isRequired, + // 正解の choices の何番目か(0 から) + answer: PropTypes.number.isRequired, + explanation: messageShape.isRequired, + }).isRequired, +}; + +export { messages }; +export default injectIntl(LessonCompletedQuiz); diff --git a/packages/scratch-gui/src/components/lesson-completed-toast/lesson-completed-toast.css b/packages/scratch-gui/src/components/lesson-completed-toast/lesson-completed-toast.css index 8413e690137..745ff5e3188 100644 --- a/packages/scratch-gui/src/components/lesson-completed-toast/lesson-completed-toast.css +++ b/packages/scratch-gui/src/components/lesson-completed-toast/lesson-completed-toast.css @@ -35,6 +35,21 @@ $celebrate-light: hsla(45, 100%, 98%, 1); /* #FFFDF6 */ --accent-on: $ui-white; } +/* いっとき隠す(hidden 属性。.toast の display: flex が UA の display: none より強いので書く) */ +.toast[hidden] { + display: none; +} + +/* クイズがあるとき: 幅を決めておく(選んで解説が出ても横幅が変わらない)。文言の長さの目安(問い 2 行・ + 選択肢 1 行・解説 3 行)なら 1300×600 で画面に収まる。目安を超えたときだけ、画面の外へ出さずに + toast の中をスクロールする(保険) */ +.with-quiz { + width: min(92vw, 560px); + max-height: calc(100vh - 3rem - 2.5rem - 1rem); + overflow-y: auto; + box-sizing: border-box; +} + .lesson-done { border-color: $celebrate; background-color: $celebrate-light; diff --git a/packages/scratch-gui/src/components/lesson-completed-toast/lesson-completed-toast.jsx b/packages/scratch-gui/src/components/lesson-completed-toast/lesson-completed-toast.jsx index 31827028a86..b918f7655c1 100644 --- a/packages/scratch-gui/src/components/lesson-completed-toast/lesson-completed-toast.jsx +++ b/packages/scratch-gui/src/components/lesson-completed-toast/lesson-completed-toast.jsx @@ -5,6 +5,7 @@ import { defineMessages, injectIntl } from 'react-intl'; import intlShape from '../../lib/intlShape.js'; import { COMPLETED_ACTIONS } from '../../lib/lessons/lesson-progress.js'; import { messages as bandMessages } from '../lesson-assignment-band/lesson-assignment-band.jsx'; +import LessonCompletedQuiz from './lesson-completed-quiz.jsx'; import styles from './lesson-completed-toast.css'; const messages = defineMessages({ @@ -30,6 +31,20 @@ const messages = defineMessages({ 'Second line of the completed toast when every challenge of the lesson is done and the course has ' + 'another lesson to do. {name} is the lesson name, {count} the number of its challenges', }, + lessonTitleSome: { + id: 'gui.lessons.completed.lessonTitleSome', + defaultMessage: 'Lesson {number} cleared!', + description: + 'Title of the completed toast when a lesson needs only some of its challenges (the themes to choose ' + + 'from) and that many are done, but not all', + }, + lessonDetailSome: { + id: 'gui.lessons.completed.lessonDetailSome', + defaultMessage: 'You finished {count} of the challenges of "{name}". That is enough for this lesson.', + description: + 'Second line of the completed toast when a lesson needs only some of its challenges (the themes to ' + + 'choose from) and that many are done. {name} is the lesson name, {count} the number done', + }, courseDetail: { id: 'gui.lessons.completed.courseDetail', defaultMessage: 'That was every lesson in "{course}".', @@ -111,6 +126,8 @@ const BUTTON_MESSAGES = { * @param {object} props.lessonName - レッスン名(message descriptor)。 * @param {Function} props.onClose - 「もう少し見る」(閉じる)。 * @param {Function} props.onNextChallenge - 「次のチャレンジへ」など(レッスン表を開く)。 + * @param {boolean} props.hidden - いっとき隠すか(描いたまま見えなくする。クイズで選んだものを残す・#1639)。 + * @param {?object} props.quiz - できたチャレンジのふりかえりのクイズ(#1639。無ければ出さない)。 * @param {object} props.intl - react-intl。 * @returns {React.ReactElement} toast。 */ @@ -124,10 +141,12 @@ const LessonCompletedToast = ({ challenges = [], courseCompleted = false, courseName, + hidden = false, lessonName, lessonNumber, onClose, onNextChallenge, + quiz = null, intl, }) => { // 課題クリア(#1599): 段 1 の「レッスン n ぜんぶできた!」より優先。同じお祝いの形で、丸は課題のチャレンジ @@ -144,17 +163,25 @@ const LessonCompletedToast = ({ else detail = intl.formatMessage(messages.assignmentDetailNoName); } else if (action === COMPLETED_ACTIONS.LIBRARY && courseCompleted && courseName) { detail = intl.formatMessage(messages.courseDetail, { course: intl.formatMessage(courseName) }); + } else if (lessonDone && lessonName && remaining > 0) { + // テーマを選ぶレッスン(checkCount がチャレンジの数より少ない): できた数だけ書く(「全部」と言わない) + detail = intl.formatMessage(messages.lessonDetailSome, { + name: intl.formatMessage(lessonName), + count: total - remaining, + }); } else if (lessonDone && lessonName) { detail = intl.formatMessage(messages.lessonDetail, { name: intl.formatMessage(lessonName), count: total }); } return (
@@ -199,6 +230,9 @@ const LessonCompletedToast = ({ )}
+ {/* ふりかえりのクイズ(#1639): どの場面(できた!/レッスン n ぜんぶできた!/課題クリア!)でも出す。 + 答えなくてもボタンで先へ進める。チャレンジが変わったら選んだものを消す(key) */} + {quiz && }
{assignmentCleared && onSubmitAssignment ? ( , + document.body, + ); +}; + +LessonHintMinimized.propTypes = { + count: PropTypes.number.isRequired, + index: PropTypes.number.isRequired, + // 最後の手段のページ(うまく動かないときは)か + lastResort: PropTypes.bool, + // 手が止まっているので光らせるか(#2132) + nudge: PropTypes.bool, + onRestore: PropTypes.func.isRequired, + // いまのページの文言(message descriptor。lib/lessons/hint-text.js の hintStepTitle) + title: PropTypes.object, +}; + +export default LessonHintMinimized; diff --git a/packages/scratch-gui/src/components/lesson-hint/lesson-hint-nudge.jsx b/packages/scratch-gui/src/components/lesson-hint/lesson-hint-nudge.jsx new file mode 100644 index 00000000000..ba920085e6c --- /dev/null +++ b/packages/scratch-gui/src/components/lesson-hint/lesson-hint-nudge.jsx @@ -0,0 +1,86 @@ +// 手が止まったときの「ヒントを見てみよう」(#2129 の Q5)。課題バーの「ヒント」ボタン(小さくしたヒントの札が +// あれば札)の近くに文字で出す。光らせるのは課題バーのボタン・札の側(CSS)。音は出さない。 +// 置き方は小さくしたヒントの札と同じ純粋関数(lib/lessons/hint-minimized.js)で、札があれば札のすぐ下に出す。 +// 押せない文字だけ(pointer-events: none)なので、下の部品の操作をじゃましない。document.body に portal で出す。 +import PropTypes from 'prop-types'; +import React, { useCallback, useEffect, useLayoutEffect, useRef, useState } from 'react'; +import { createPortal } from 'react-dom'; +import { defineMessages, useIntl } from 'react-intl'; +import { minimizedHintPosition } from '../../lib/lessons/hint-minimized'; +import { HINT_TARGETS, findHintTargetRect, hintViewport } from '../../lib/lessons/hint-targets'; +import styles from './lesson-hint.css'; + +const messages = defineMessages({ + nudge: { + id: 'gui.lessonHint.nudge', + description: + 'Shown near the hint button when the program and the stage have not changed for a while (the student ' + + 'may be stuck)', + defaultMessage: 'Take a look at the hint', + }, +}); + +const toRect = (el) => { + if (!el) return null; + const r = el.getBoundingClientRect(); + return r.right - r.left > 0 && r.bottom - r.top > 0 + ? { left: r.left, top: r.top, right: r.right, bottom: r.bottom } + : null; +}; + +const STAGE_COLUMN = '[class*="gui_stage-and-target-wrapper_"]'; + +const LessonHintNudge = ({ visible }) => { + const intl = useIntl(); + const ref = useRef(null); + const [position, setPosition] = useState(null); + const measure = useCallback(() => { + const el = ref.current; + if (!el || typeof document === 'undefined') return; + const size = el.getBoundingClientRect(); + // 小さくしたヒントの札があれば、その下に右をそろえて出す。無ければ課題バーの「ヒント」ボタンの下 + const tag = toRect(document.querySelector('[data-testid="lesson-hint-minimized"]')); + const next = minimizedHintPosition({ + bar: tag || toRect(document.querySelector('[data-testid="lesson-task-bar"]')), + hintButton: tag || toRect(document.querySelector('[data-testid="lesson-task-bar-hint"]')), + stage: toRect(document.querySelector(STAGE_COLUMN)), + palette: findHintTargetRect(HINT_TARGETS.PALETTE, document), + chip: { width: size.width, height: size.height }, + viewport: hintViewport(document, window), + }); + setPosition((prev) => (prev && prev.left === next.left && prev.top === next.top ? prev : next)); + }, []); + useLayoutEffect(() => { + if (visible) measure(); + }, [visible, measure]); + useEffect(() => { + if (!visible) return () => {}; + window.addEventListener('resize', measure); + const timer = window.setInterval(measure, 300); + return () => { + window.removeEventListener('resize', measure); + window.clearInterval(timer); + }; + }, [visible, measure]); + + if (!visible || typeof document === 'undefined') return null; + return createPortal( +
+ {intl.formatMessage(messages.nudge)} +
, + document.body, + ); +}; + +LessonHintNudge.propTypes = { + // 手が止まっているか(containers/lesson-mode.jsx の useIdleNudge) + visible: PropTypes.bool, +}; + +export default LessonHintNudge; diff --git a/packages/scratch-gui/src/components/lesson-hint/lesson-hint.css b/packages/scratch-gui/src/components/lesson-hint/lesson-hint.css index b9c36b322a4..ee047f46570 100644 --- a/packages/scratch-gui/src/components/lesson-hint/lesson-hint.css +++ b/packages/scratch-gui/src/components/lesson-hint/lesson-hint.css @@ -1,4 +1,5 @@ @import '../../css/colors.css'; +@import '../../css/smalruby-tokens.css'; @import '../../css/units.css'; @import '../../css/z-index.css'; @import '../balloon/balloon-tokens.css'; @@ -16,6 +17,15 @@ max-height: calc(100vh - 1rem); } +/* + アクティビティ図のある 1 ページ目は、図が字の読める大きさ(下限)のまま横に収まりやすいよう広げる + (分岐のある図で幅 420px ほど)。それでも入らなければ図の枠の中をスクロールする +*/ +.balloon-wide { + composes: balloon; + max-width: min(30rem, calc(100vw - 1rem)); +} + /* ヘッダー(色の帯)をドラッグの取っ手にする。touch-action: none でタッチのドラッグを ページのスクロールにとられないようにする(Pointer Events でマウスとタッチを同じに扱う) @@ -39,10 +49,55 @@ white-space: pre-line; } +/* 文言の `**…**`(見落としやすいところ)。文言はもう太字なので、色と地で見分けられるようにする */ +.emphasis { + padding: 0 0.125rem; + border-radius: 0.125rem; + color: $color-emphasis; + background-color: $color-emphasis-background; + font-weight: bold; +} + .title:last-child { margin-bottom: 0; } +/* 文言の下の一言(読んで作るチャレンジの「答えは最後のページ」など)。文言より控えめにする */ +.note { + margin: 0 0 0.5rem; + font-size: 0.8125rem; + color: $text-primary-transparent; + white-space: pre-line; +} + +.note:last-child { + margin-bottom: 0; +} + +/* + 1 ページ目のアクティビティ図。吹き出しの幅(最大 22rem)と、1300×600 で吹き出しが画面に収まる高さまで + 縦横の比のまま縮める。字が読める下限(lesson-activity-diagram.jsx の min-width / min-height)まで縮めても + 入らないときは、図の枠の中をスクロールする +*/ +.activity-diagram { + max-height: min(16rem, calc(100vh - 16rem)); + margin: 0 0 0.5rem; + overflow: auto; +} + +.activity-diagram > svg { + margin: 0 auto; + max-height: min(16rem, calc(100vh - 16rem)); +} + +/* 描いたブロックの見出し(読んで作るチャレンジの答えのページ「ネコのプログラム」) */ +.blocks-label { + margin: 0 0 0.25rem; + font-size: 0.8125rem; + font-weight: bold; + color: $text-primary-transparent; +} + /* 本物のブロックを描く Blockly の読み取り専用ワークスペース。大きさは描いた中身から決める */ .blocks { position: relative; @@ -163,3 +218,107 @@ padding: 0.5rem; } } + +/* + 小さくしたヒントの札(lesson-hint-minimized.jsx)。課題バーのすぐ下に position: fixed で置く(置き方は + lib/lessons/hint-minimized.js)。課題バーの全文のパネル(タップで開いたままのものは 470)より下の 460 に置き、 + 全文を隠さない(パレット・ステージより上)。消えたと思わず「もどしたくなる」ように、吹き出しの + ヘッダーと同じ色の地に白い字で、番号・短い見出し・もどす印を 1 行に並べる。小さく保つため見出しは 1 行で切る +*/ +.minimized { + position: fixed; + z-index: 460; + display: flex; + align-items: center; + gap: 0.375rem; + max-width: min(18rem, calc(100vw - 1rem)); + padding: 0.25rem 0.5rem 0.25rem 0.375rem; + border: $balloon-border-width solid $ui-white; + border-radius: $balloon-button-radius; + background-color: $balloon-primary; + box-shadow: $balloon-shadow-panel; + color: $ui-white; + font-family: $balloon-font-family; + font-size: $balloon-font-size-small; + line-height: 1.2; + cursor: pointer; +} + +.minimized:hover { + background-color: $balloon-primary-hover; +} + +.minimized:focus-visible { + outline: 3px solid $balloon-text; + outline-offset: 2px; +} + +.minimized-position { + flex-shrink: 0; + padding: 0.125rem 0.375rem; + border-radius: 1rem; + background-color: $ui-white; + color: $balloon-primary; + font-weight: bold; + white-space: nowrap; +} + +.minimized-heading { + min-width: 0; + font-weight: bold; + white-space: nowrap; + overflow: hidden; + text-overflow: ellipsis; +} + +.minimized-restore { + flex-shrink: 0; + font-size: 0.875rem; +} + +/* + 手が止まったときに光らせる(#2132)。小さくしたヒントの札を、ゆっくり(2.4 秒で 1 往復)オレンジに光らせる。 + 動きを減らす設定(prefers-reduced-motion)では光らせず、「ヒントを見てみよう」の文字だけにする +*/ +.minimized-nudge { + composes: minimized; +} + +@media (prefers-reduced-motion: no-preference) { + .minimized-nudge { + animation: hint-nudge-glow 1.2s ease-in-out infinite alternate; + } +} + +@keyframes hint-nudge-glow { + from { + box-shadow: $balloon-shadow-panel; + } + + to { + box-shadow: + 0 0 0 4px $data-primary, + 0 0 16px 6px $data-primary; + } +} + +/* + 「ヒントを見てみよう」。課題バーの「ヒント」(小さくした札があれば札)の下に出す文字(lesson-hint-nudge.jsx)。 + 押せない文字なので pointer-events: none(下の部品の操作をじゃましない)。札と同じ層(460) +*/ +.nudge { + position: fixed; + z-index: 460; + padding: 0.25rem 0.625rem; + border: $balloon-border-width solid $data-primary; + border-radius: $balloon-button-radius; + background-color: $ui-white; + box-shadow: $balloon-shadow; + color: $color-emphasis; + font-family: $balloon-font-family; + font-size: $balloon-font-size; + font-weight: bold; + line-height: 1.2; + white-space: nowrap; + pointer-events: none; +} diff --git a/packages/scratch-gui/src/components/lesson-hint/lesson-hint.jsx b/packages/scratch-gui/src/components/lesson-hint/lesson-hint.jsx index 4c60afafc93..3362494fee7 100644 --- a/packages/scratch-gui/src/components/lesson-hint/lesson-hint.jsx +++ b/packages/scratch-gui/src/components/lesson-hint/lesson-hint.jsx @@ -3,9 +3,13 @@ // 最後のページは「うまく動かないときは」と「正解のプログラムを確認する」(最後の手段)。押すと吹き出しの中で // 「置き換えますか?」を確かめ、はいで正解のプログラムを入れる(onInsertCode)。最後のページの「進める」は「おわり」 // (押すと閉じる)。 +// 読んで作るチャレンジ(`mode: 'readDiagram'`)は最後の手段のページを持たず、3 ページ目の答えをブロックで描くだけ +// (lib/lessons/read-diagram.js。ページは steps と同じ形なので、この部品は文言の下の一言 `note` を出すだけ)。 // ヘッダー(色の帯)をドラッグすると吹き出しを動かせる(マウス・タッチ。Pointer Events)。動かした位置は // ページを進めても保ち(じゃまだから動かした場所に、また戻ってこないように)、吹き出しを閉じると元の置き方に戻る。 // 動かしたあとは指す場所から離れるので、しっぽは消す(スポットライトは指す場所を照らし続ける)。 +// ヘッダーの「-」は閉じずに小さくする(onClose。課題バーの近くに札が残り、押すと同じページで元にもどる・ +// lesson-hint-minimized.jsx)。子どもはヒントを読んで操作するときに閉じてしまい、手順を見失っていたため。 // 枠・しっぽ・ヘッダー・ボタンの見た目は共通の吹き出し(components/balloon)を使う。 // document.body に portal で出す(エディタの列のレイアウトに影響しない)。 import PropTypes from 'prop-types'; @@ -16,16 +20,35 @@ import { HINT_SIDES, clampHintPosition, computeHintPlacement, + findHintAvoidRects, findHintTargetRect, hintViewport, preferredSides, } from '../../lib/lessons/hint-targets'; +import { splitEmphasis } from '../../lib/lessons/hint-text'; +import { formatRoleMessage } from '../../lib/lessons/role-swap'; import BalloonButton from '../balloon/balloon-button.jsx'; import BalloonHeader from '../balloon/balloon-header.jsx'; import Balloon, { BALLOON_VARIANTS } from '../balloon/balloon.jsx'; import LessonHintBlocks from './lesson-hint-blocks.jsx'; import styles from './lesson-hint.css'; +// 文言の `**…**` を強調して出す(lib/lessons/hint-text.js)。文字として出すので、訳の中の記号は HTML にならない +const EmphasizedText = ({ text }) => + splitEmphasis(text).map((part, i) => + part.strong ? ( + + {part.text} + + ) : ( + {part.text} + ), + ); + +EmphasizedText.propTypes = { + text: PropTypes.string.isRequired, +}; + const messages = defineMessages({ ariaLabel: { id: 'gui.lessonHint.ariaLabel', @@ -47,10 +70,12 @@ const messages = defineMessages({ description: 'Button that goes on to the next hint', defaultMessage: 'Next', }, - close: { - id: 'gui.lessonHint.close', - description: 'Button that closes the hint balloon', - defaultMessage: 'Close', + minimize: { + id: 'gui.lessonHint.minimize', + description: + 'Button in the header of the hint balloon that makes the balloon small (a small tag stays near the ' + + 'lesson task bar, and pressing it shows the same hint page again)', + defaultMessage: 'Make the hint small', }, debugTitle: { id: 'gui.lessonHint.debugTitle', @@ -119,11 +144,20 @@ const useHintPlacement = (target, balloonRef, deps) => { if (!el || typeof document === 'undefined') return; const targetRect = target ? findHintTargetRect(target, document) : null; const size = el.getBoundingClientRect(); + // しっぽをヘッダーの帯の横・閉じるボタンの上に出さないよう、どちらの位置も吹き出しからの相対で渡す + const header = el.querySelector('[data-testid="lesson-hint-drag-handle"]'); + const close = el.querySelector('[data-testid="lesson-hint-close"]'); const placement = computeHintPlacement({ target: targetRect, - balloon: { width: size.width, height: size.height }, + balloon: { + width: size.width, + height: size.height, + header: header ? header.getBoundingClientRect().bottom - size.top : 0, + closeLeft: close ? close.getBoundingClientRect().left - size.left : null, + }, viewport: viewportSize(), sides: preferredSides(target), + avoid: findHintAvoidRects(document, target), }); setState((prev) => sameRect(prev.targetRect, targetRect) && @@ -152,6 +186,9 @@ const useHintPlacement = (target, balloonRef, deps) => { const viewportSize = () => hintViewport(document, window); +// 画面の端から空ける幅(px。hint-targets.js の置き方の margin と同じ) +const VIEWPORT_MARGIN = 8; + // ドラッグとみなすまでに動かす距離(px)。ヘッダーを押しただけの手ぶれで吹き出しを動かさない const DRAG_THRESHOLD = 4; @@ -253,6 +290,7 @@ const useHintDrag = (balloonRef, deps) => { }; const LessonHint = ({ + activityDiagram = null, blocksError = false, blocksXml, colorMode, @@ -261,12 +299,14 @@ const LessonHint = ({ hasCode = false, index, insertErrors = [], + label = null, lastResort = false, mediaPath = './static/blocks-media/default/', onClose, onFinish, onInsertCode, onNext, + note = null, onPrev, scratchBlocks, spotlight = false, @@ -277,12 +317,22 @@ const LessonHint = ({ const balloonRef = useRef(null); const [renderedTick, setRenderedTick] = useState(0); const handleRendered = useCallback(() => setRenderedTick((t) => t + 1), []); - const { targetRect, placement } = useHintPlacement(target, balloonRef, [index, blocksXml, renderedTick]); + // アクティビティ図は 1 ページ目だけ(毎ページ描くと情報が多すぎる・docs/lessons/design.md の「アクティビティ図」) + const diagram = index === 0 && !lastResort ? activityDiagram : null; + // 置き方の測り直しは、図が出た・消えたときだけ(図の要素は描くたびに作り直されるので、要素では見ない) + const hasDiagram = Boolean(diagram); + const { targetRect, placement } = useHintPlacement(target, balloonRef, [ + index, + blocksXml, + renderedTick, + hasDiagram, + ]); const { position: dragged, onPointerDown } = useHintDrag(balloonRef, [ index, blocksXml, renderedTick, lastResort, + hasDiagram, ]); // 「正解のプログラムを確認する」を押して、置き換えてよいかを確かめているところか(ページが変わったらやめる) const [confirming, setConfirming] = useState(false); @@ -303,6 +353,10 @@ const LessonHint = ({ let balloonStyle = { visibility: 'hidden' }; if (dragged) balloonStyle = { left: dragged.left, top: dragged.top }; else if (placement) balloonStyle = { left: placement.left, top: placement.top }; + // 課題バーの下から画面の下までに収める(CSS の max-height は画面の高さだけを見るので、高い吹き出しの + // 下の端が画面の外に出る。上の端は hintViewport の top でバーの下にそろえる) + const viewport = viewportSize(); + if (viewport.top > 0) balloonStyle.maxHeight = viewport.height - viewport.top - 2 * VIEWPORT_MARGIN; const arrowStyle = arrow ? side === HINT_SIDES.RIGHT || side === HINT_SIDES.LEFT ? { top: arrow.y } @@ -328,7 +382,8 @@ const LessonHint = ({ variant={BALLOON_VARIANTS.PANEL} arrowSide={arrow ? side : null} arrowStyle={arrowStyle} - className={styles.balloon} + // 図のあるページは、図が字の読める大きさのまま収まるよう吹き出しを少し広げる + className={hasDiagram ? styles.balloonWide : styles.balloon} data-testid="lesson-hint" data-side={side} data-target={target || ''} @@ -342,7 +397,9 @@ const LessonHint = ({ data-testid="lesson-hint-drag-handle" title={intl.formatMessage(messages.dragLabel)} onPointerDown={onPointerDown} - closeLabel={intl.formatMessage(messages.close)} + // 閉じずに小さくする(data-testid は前の「閉じる」のまま。押すと札が残る) + closeIcon="-" + closeLabel={intl.formatMessage(messages.minimize)} closeTestId="lesson-hint-close" onClose={onClose} > @@ -359,7 +416,9 @@ const LessonHint = ({ {debug.length > 0 ? (
    {debug.map((tip) => ( -
  • {intl.formatMessage(tip)}
  • +
  • + +
  • ))}
) : null} @@ -417,9 +476,29 @@ const LessonHint = ({ ) : ( <> + {diagram ? ( +
+ {diagram} +
+ ) : null} {title ? (

- {intl.formatMessage(title)} + +

+ ) : null} + {note ? ( +

+ {formatRoleMessage(intl, note)} +

+ ) : null} + {label && (blocksXml || blocksError) ? ( +

+ {intl.formatMessage(label.message, { + name: + typeof label.name === 'string' + ? label.name + : intl.formatMessage(label.name), + })}

) : null} {blocksXml ? ( @@ -462,6 +541,8 @@ const LessonHint = ({ }; LessonHint.propTypes = { + // 答えのプログラムから描いたアクティビティ図(components/lesson-activity-diagram)。1 ページ目の文の上に出す + activityDiagram: PropTypes.node, blocksError: PropTypes.bool, blocksXml: PropTypes.string, colorMode: PropTypes.string, @@ -472,8 +553,17 @@ LessonHint.propTypes = { index: PropTypes.number.isRequired, // 「プログラムを入れる」を試して失敗したときのわけ(変換のエラーの文言) insertErrors: PropTypes.arrayOf(PropTypes.string), + // 描いたブロックの見出し(読んで作るチャレンジの答えのページで、プログラムが 2 つ以上あるとき「ネコのプログラム」)。 + // `message` は `{name}` を持つ message descriptor、`name` はスプライトの名前か message descriptor + label: PropTypes.shape({ + message: PropTypes.object.isRequired, + name: PropTypes.oneOfType([PropTypes.string, PropTypes.object]).isRequired, + }), lastResort: PropTypes.bool, mediaPath: PropTypes.string, + // 文言の下に添える一言(message descriptor)。読んで作るチャレンジの 1 ページ目の「答えは最後のページ」など + note: PropTypes.object, + // ヘッダーの「-」で小さくする(reducers/lesson-mode.js の hideHint) onClose: PropTypes.func.isRequired, // 「おわり」で閉じる(無ければ onClose) onFinish: PropTypes.func, @@ -487,4 +577,5 @@ LessonHint.propTypes = { title: PropTypes.object, }; +export { messages as lessonHintMessages }; export default LessonHint; diff --git a/packages/scratch-gui/src/components/lesson-part-names/lesson-part-names.css b/packages/scratch-gui/src/components/lesson-part-names/lesson-part-names.css new file mode 100644 index 00000000000..62d497c5f54 --- /dev/null +++ b/packages/scratch-gui/src/components/lesson-part-names/lesson-part-names.css @@ -0,0 +1,34 @@ +@import '../../css/colors.css'; + +/* + 画面全体に重ねるが、pointer-events を通す(出したままでもドラッグ・クリックを邪魔しない)。 + ヒントの吹き出し($z-index-tooltip)と課題バー($z-index-menu-bar)より下に描く(吹き出しを読みながら操作するため)。 + 札の置き場所は、吹き出しと練習相手のパネルをよけて決める(lib/lessons/part-names.js) +*/ +.overlay { + position: fixed; + inset: 0; + z-index: 489; + pointer-events: none; +} + +/* 部分を囲む枠。中が見えるよう、線だけ */ +.frame { + position: fixed; + box-sizing: border-box; + border: 2px dashed $data-primary; + border-radius: 0.25rem; +} + +.label { + position: fixed; + padding: 0.125rem 0.5rem; + border-radius: 0.75rem; + background-color: $data-primary; + color: $ui-white; + font-size: 0.875rem; + font-weight: bold; + line-height: 1.3; + white-space: nowrap; + box-shadow: 0 1px 3px rgba(0, 0, 0, 0.25); +} diff --git a/packages/scratch-gui/src/components/lesson-part-names/lesson-part-names.jsx b/packages/scratch-gui/src/components/lesson-part-names/lesson-part-names.jsx new file mode 100644 index 00000000000..bb3bbccddf3 --- /dev/null +++ b/packages/scratch-gui/src/components/lesson-part-names/lesson-part-names.jsx @@ -0,0 +1,211 @@ +// 名前の札(「ガイド」)(#2133)。画面の部分(タブ・ブロックパレット・スクリプトエリア・ステージ・緑の旗と停止ボタン・ +// スプライトペイン・背景・課題バー・ヒント)を枠で囲み、名前の札を重ねて出す。部分の探し方と札の置き方は lib/lessons/part-names.js。 +// 札も枠も pointer-events を通すので、出したままでもドラッグやクリックを邪魔しない(レッスン 0 は最初から出す)。 +// 課題バーの「ガイド」で出したときは、数秒たつか、どこかを押すか、Esc で消す(押した操作はそのまま下に届く)。 +// document.body への portal で出し、部分の場所が変わる(タブを切りかえる・画面の大きさが変わる)のに合わせて置き直す。 +import PropTypes from 'prop-types'; +import React, { useCallback, useEffect, useLayoutEffect, useRef, useState } from 'react'; +import { createPortal } from 'react-dom'; +import { defineMessages, useIntl } from 'react-intl'; +import { + PART_NAMES, + PART_NAMES_DURATION_MS, + computePartNameLayout, + findPartNameRects, +} from '../../lib/lessons/part-names'; +import styles from './lesson-part-names.css'; + +const messages = defineMessages({ + taskBar: { + id: 'gui.lessonPartNames.taskBar', + description: 'Name tag on the lesson task bar (the bar that shows the challenge)', + defaultMessage: 'Task bar', + }, + hint: { + id: 'gui.lessonPartNames.hint', + description: 'Name tag on the Hint button of the lesson task bar', + defaultMessage: 'Hint', + }, + codeTab: { + id: 'gui.lessonPartNames.codeTab', + description: 'Name tag on the Code tab', + defaultMessage: 'Code tab', + }, + costumesTab: { + id: 'gui.lessonPartNames.costumesTab', + description: 'Name tag on the Costumes tab', + defaultMessage: 'Costumes tab', + }, + soundsTab: { + id: 'gui.lessonPartNames.soundsTab', + description: 'Name tag on the Sounds tab', + defaultMessage: 'Sounds tab', + }, + rubyTab: { + id: 'gui.lessonPartNames.rubyTab', + description: 'Name tag on the Ruby tab', + defaultMessage: 'Ruby tab', + }, + greenFlag: { + id: 'gui.lessonPartNames.greenFlag', + description: 'Name tag on the green flag button', + defaultMessage: 'Green Flag', + }, + stop: { + id: 'gui.lessonPartNames.stop', + description: 'Name tag on the stop button', + defaultMessage: 'Stop Button', + }, + palette: { + id: 'gui.lessonPartNames.palette', + description: 'Name tag on the block palette', + defaultMessage: 'Block Palette', + }, + codeArea: { + id: 'gui.lessonPartNames.codeArea', + description: 'Name tag on the code area (the block workspace; "Code Area" on the Scratch Wiki)', + defaultMessage: 'Code Area', + }, + stage: { + id: 'gui.lessonPartNames.stage', + description: 'Name tag on the stage', + defaultMessage: 'Stage', + }, + spriteList: { + id: 'gui.lessonPartNames.spriteList', + description: 'Name tag on the sprite pane, with a short note on what it is for', + defaultMessage: 'Sprite Pane (choose a sprite here)', + }, + backdrop: { + id: 'gui.lessonPartNames.backdrop', + description: 'Name tag on the backdrop (stage) selector', + defaultMessage: 'Backdrop', + }, +}); + +// 部分の場所を測り直す間(ms)。タブの切りかえ・パレットの開閉は知らせが無いので、出ているあいだだけ見る +const RELAYOUT_MS = 500; +// 札でかぶせないもの(ヒントの吹き出し・小さくしたヒントの札・練習相手のパネル)。名前の札はヒントの吹き出しより +// 下の層に描くが、文字を隠さないよう置き場所でもよける(小さくしたヒントの札は名前の札より下の層なので、よけないと隠れる) +const AVOID_SELECTORS = [ + '[data-testid="lesson-hint"]', + '[data-testid="lesson-hint-minimized"]', + '[data-testid="lesson-practice-partner"]', +]; +// 押しても札を消さない場所(「ガイド」のボタン。押すと出し入れが切りかわる) +const TOGGLE_SELECTOR = '[data-testid="lesson-task-bar-part-names"]'; + +const sameLayout = (a, b) => JSON.stringify(a) === JSON.stringify(b); + +const LessonPartNames = ({ onClose, timed }) => { + const intl = useIntl(); + const labelRefs = useRef({}); + const [layout, setLayout] = useState({ frames: [], labels: [] }); + + const relayout = useCallback(() => { + if (typeof document === 'undefined') return; + const parts = findPartNameRects(document); + const sizes = {}; + parts.forEach((part) => { + const el = labelRefs.current[part.label]; + if (el) sizes[part.label] = { width: el.offsetWidth, height: el.offsetHeight }; + }); + const avoid = AVOID_SELECTORS.flatMap((s) => Array.from(document.querySelectorAll(s))) + .map((el) => el.getBoundingClientRect()) + .filter((r) => r.width > 0 && r.height > 0) + .map((r) => ({ left: r.left, top: r.top, right: r.right, bottom: r.bottom })); + const next = { + frames: parts.map((part) => ({ label: part.label, rect: part.rect })), + labels: computePartNameLayout({ + parts, + sizes, + viewport: { width: window.innerWidth, height: window.innerHeight }, + avoid, + }), + }; + setLayout((prev) => (sameLayout(prev, next) ? prev : next)); + }, []); + + useLayoutEffect(() => { + relayout(); + }, [relayout]); + useEffect(() => { + const timer = setInterval(relayout, RELAYOUT_MS); + window.addEventListener('resize', relayout); + return () => { + clearInterval(timer); + window.removeEventListener('resize', relayout); + }; + }, [relayout]); + + // 「ガイド」で出したときは、数秒で・どこかを押すと・Esc で消す。押した操作はそのまま下の部品に届く(capture で見るだけ) + const onCloseRef = useRef(onClose); + onCloseRef.current = onClose; + useEffect(() => { + if (!timed) return () => {}; + const close = () => onCloseRef.current(); + const timer = setTimeout(close, PART_NAMES_DURATION_MS); + const handlePointer = (e) => { + if (e.target && e.target.closest && e.target.closest(TOGGLE_SELECTOR)) return; + close(); + }; + const handleKey = (e) => { + if (e.key === 'Escape') close(); + }; + document.addEventListener('pointerdown', handlePointer, true); + document.addEventListener('keydown', handleKey); + return () => { + clearTimeout(timer); + document.removeEventListener('pointerdown', handlePointer, true); + document.removeEventListener('keydown', handleKey); + }; + }, [timed]); + + if (typeof document === 'undefined') return null; + const placed = new Map(layout.labels.map((l) => [l.label, l])); + return createPortal( +