Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
30 commits
Select commit Hold shift + click to select a range
6584f6e
docs(studuino): describe the studuino renewal plan for the smalrubot …
smalruby3-editor-bot[bot] Nov 18, 2026
6e6f536
Merge pull request #2195 from smalruby/docs/studuino-renewal-2187
smalruby3-editor-bot[bot] Nov 18, 2026
caef814
feat(studuino): rename the extension to Studuino and use a board illu…
smalruby3-editor-bot[bot] Nov 18, 2026
5c59ced
docs(studuino): retake screenshots with the new name and add the libr…
smalruby3-editor-bot[bot] Nov 18, 2026
6c5f939
Merge branch 'develop' into topic/studuino-2162
smalruby3-editor-bot[bot] Nov 18, 2026
ef30ac4
Merge pull request #2226 from smalruby/feat/studuino-name-image-2188
smalruby3-editor-bot[bot] Nov 18, 2026
7914ae7
feat(studuino): use textbook sensor names and group robot blocks unde…
smalruby3-editor-bot[bot] Nov 18, 2026
b796cf2
docs(studuino): retake the block palette screenshot with the robot ca…
smalruby3-editor-bot[bot] Nov 18, 2026
b30cd1a
Merge pull request #2228 from smalruby/feat/studuino-sensor-names-2189
smalruby3-editor-bot[bot] Nov 18, 2026
37d53cf
feat(ruby): write studuino. for the Studuino blocks and still read sm…
smalruby3-editor-bot[bot] Nov 18, 2026
b0846a3
Merge pull request #2229 from smalruby/feat/studuino-ruby-prefix-2190
smalruby3-editor-bot[bot] Nov 18, 2026
1db6de2
feat(studuino): send commands and sensor reads to a practice board wh…
smalruby3-editor-bot[bot] Nov 18, 2026
2618c2c
Merge pull request #2231 from smalruby/feat/studuino-practice-board-v…
smalruby3-editor-bot[bot] Nov 18, 2026
50b99b9
feat(studuino): add the practice board panel (sensors, LEDs, motors, …
smalruby3-editor-bot[bot] Nov 18, 2026
da94289
fix(studuino): show sensor names in the GUI and keep the panel above …
smalruby3-editor-bot[bot] Nov 18, 2026
04e5603
docs(studuino): add screenshots of the practice board panel
smalruby3-editor-bot[bot] Nov 18, 2026
5c807ff
Merge pull request #2232 from smalruby/feat/studuino-practice-panel-2192
smalruby3-editor-bot[bot] Nov 18, 2026
2cf0d37
feat(studuino): record the commands and sensor reads for lesson checks
smalruby3-editor-bot[bot] Nov 18, 2026
94d1e8c
Merge pull request #2235 from smalruby/feat/studuino-command-log-2193
smalruby3-editor-bot[bot] Nov 18, 2026
8361cff
feat(studuino): name the extension ArtecRobo and keep Studuino for th…
smalruby3-editor-bot[bot] Nov 19, 2026
42bbab2
docs(studuino): retake screenshots with the ArtecRobo name
smalruby3-editor-bot[bot] Nov 19, 2026
6184d1e
Merge pull request #2277 from smalruby/feat/artecrobo-name
smalruby3-editor-bot[bot] Nov 19, 2026
3c051cd
feat(studuino): keep the Smalrubot S1 card for one year
smalruby3-editor-bot[bot] Nov 19, 2026
55d4fbc
feat(studuino): show the old Smalrubot S1 pictures on the old card
smalruby3-editor-bot[bot] Nov 19, 2026
eccde20
fix(studuino): give the rename alert a background
smalruby3-editor-bot[bot] Nov 19, 2026
b6eb2f5
docs(studuino): retake screenshots with the ArtecRobo (Studuino) name…
smalruby3-editor-bot[bot] Nov 19, 2026
b35f9c4
docs(studuino): retake the renamed alert with its background
smalruby3-editor-bot[bot] Nov 19, 2026
d33767c
Merge pull request #2283 from smalruby/feat/smalrubot-legacy-card
smalruby3-editor-bot[bot] Nov 19, 2026
68fa763
feat(studuino): call every label ArtecRobo and use the new board picture
smalruby3-editor-bot[bot] Nov 19, 2026
34e6a00
Merge pull request #2284 from smalruby/feat/artecrobo-final-2162
smalruby3-editor-bot[bot] Nov 19, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion docs/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -63,7 +63,7 @@ smalruby3-editor の機能ドキュメントは **ユーザーストーリー単
| [`extension-boost/`](extension-boost/) (`defaultHidden: true`) | ⬆️ そのまま | ✅ |
| [`extension-wedo2/`](extension-wedo2/) (`defaultHidden: true`) | ⬆️ そのまま | ✅ |
| [`extension-mesh-v2/`](extension-mesh-v2/) | 🆕 独自 | ✅ |
| [`extension-smalrubot-s1/`](extension-smalrubot-s1/) | 🆕 独自 | ✅ |
| [`extension-smalrubot-s1/`](extension-smalrubot-s1/)(アーテックロボ・Studuino 基板/旧 スモウルボットS1) | 🆕 独自 | ✅ |
| [`extension-koshien/`](extension-koshien/) | 🆕 独自 | ✅ |
| [`extension-smalruby-ruby/`](extension-smalruby-ruby/) | 🆕 独自 | ✅ |
| [`extension-tm2scratch/`](extension-tm2scratch/) | 🆕 独自 | ✅ |
Expand Down
436 changes: 381 additions & 55 deletions docs/extension-smalrubot-s1/README.md

Large diffs are not rendered by default.

Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
31 changes: 18 additions & 13 deletions docs/furigana/furigana-mapping.md
Original file line number Diff line number Diff line change
Expand Up @@ -604,23 +604,28 @@ TryRuby 対応で追加された Ruby メソッドのふりがな。
| `mesh_v1`(レシーバー) | `メッシュ(従来)` | — |
| `mesh_v1.sensor_value("x")` | `メッシュ(従来)` `センサーの値` | 「xセンサーの値」 |

### スモウルボットS1(Smalrubot S1拡張機能)
### アーテックロボ拡張機能(旧 スモウルボットS1)

`smalrubot_s1` は事前定義レシーバー。レシーバー自体に `スモウルボットS1` のふりがなが付く。
`studuino` は事前定義レシーバー。レシーバー自体に `アーテックロボ` のふりがなが付く(読みの「スタディーノ」ではなく、意味としてキットの名前を書く)。ブロックからは `studuino.` を書き出す。前の書き方の `smalrubot_s1` も同じふりがな(レシーバー・メソッド・選択肢)が付く。

| Ruby | ふりがな | Scratchブロック |
| ------ | --------- | ------ |
| `smalrubot_s1`(レシーバー) | `スモウルボットS1` | — |
| `smalrubot_s1.action("forward")` | `スモウルボットS1` `動作する` `進める` | 「進める」 |
| `smalrubot_s1.action("backward")` | `スモウルボットS1` `動作する` `バックさせる` | 「バックさせる」 |
| `smalrubot_s1.action("turnLeft")` | `スモウルボットS1` `動作する` `左に曲げる` | 「左に曲げる」 |
| `smalrubot_s1.action("turnRight")` | `スモウルボットS1` `動作する` `右に曲げる` | 「右に曲げる」 |
| `smalrubot_s1.action("stop")` | `スモウルボットS1` `動作する` `止める` | 「止める」 |
| `smalrubot_s1.bend_arm(90, 1)` | `スモウルボットS1` `アームを曲げる` | 「アームを曲げる」 |
| `smalrubot_s1.sensor_value("left")` | `スモウルボットS1` `センサーの値` | 「左のセンサー」 |
| `smalrubot_s1.get_motor_speed("left")` | `スモウルボットS1` `モーター速度` | 「左DCモーターの速度」 |
| `smalrubot_s1.set_motor_speed("left", 50)` | `スモウルボットS1` `モーター速度を設定` | 「左DCモーターの速度を50にする」 |
| `smalrubot_s1.led("left", true)` | `スモウルボットS1` `LED設定` | 「左のLEDをオンにする」 |
| `studuino` / `smalrubot_s1`(レシーバー) | `アーテックロボ` | — |
| `studuino.action("forward")` | `アーテックロボ` `動作する` `車を前進させる` | 「車を前進させる」 |
| `studuino.action("backward")` | `アーテックロボ` `動作する` `車を後退させる` | 「車を後退させる」 |
| `studuino.action("left")` | `アーテックロボ` `動作する` `車を左に曲げる` | 「車を左に曲げる」 |
| `studuino.action("right")` | `アーテックロボ` `動作する` `車を右に曲げる` | 「車を右に曲げる」 |
| `studuino.action("stop")` | `アーテックロボ` `動作する` `車を止める` | 「車を止める」 |
| `studuino.bend_arm(90, 1)` | `アーテックロボ` `アームを曲げる` | 「アーム(サーボモーター D10)を曲げる」 |
| `studuino.sensor_value("light")` | `アーテックロボ` `センサーの値` `光センサー (A6)` | 「光センサー (A6) の値」 |
| `studuino.sensor_value("ir_a4")` | `アーテックロボ` `センサーの値` `赤外線センサー(フォトリフレクタ)(A4)` | 「赤外線センサー(フォトリフレクタ)(A4) の値」 |
| `studuino.sensor_value("left")` | `アーテックロボ` `センサーの値` `左のセンサー (A4)` | 「左のセンサー (A4) の値」 |
| `studuino.get_motor_speed("left")` | `アーテックロボ` `モーター速度` `左` | 「左の DC モーターの速度」 |
| `studuino.set_motor_speed("left", 50)` | `アーテックロボ` `モーター速度を設定` `左` | 「左の DC モーターの速度を 50 にする」 |
| `studuino.led("left", true)` | `アーテックロボ` `LED設定` `左` | 「左の LED をオンにする」 |
| `studuino.arm_calibration = 0` | `アーテックロボ` `アーム調整` | 「アームを 0 度調整する」 |

センサーの選択肢は、ほかに `ir_a5`(赤外線センサー(フォトリフレクタ)(A5))・`touch`(タッチセンサー (A2))・`sound`(音センサー (A7))・`right`(右のセンサー (A5))。

### スモウルビー甲子園(Koshien拡張機能)

Expand Down
27 changes: 27 additions & 0 deletions docs/lessons/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -697,6 +697,8 @@ design.md の「中 2 のコース」。コースの ✓ もこれで数える
| `currentCostume` | いまのコスチューム(`target: 'stage'` なら背景)。`number` = 何番め(1 から)、`changed: true` = 開いたときと別のコスチュームになった。始めにいたものだけ見る | `number`, `changed`, `target`(どちらか 1 つは要る) |
| `tab` | いま開いているタブ(エディタの画面の状態。`code` / `costumes` / `sounds`) | `tab` |
| `partQuiz` | 「どこでしょう?」のクイズに `count` 問正しく答えた(エディタの画面の状態) | `count` |
| `boardCommand` | アーテックロボの拡張機能が基板に出した命令(実機でも練習用の基板でも同じ記録) | `kind`(必須。`led` / `motor` / `servo` / `servoCalibration`。配列も可), `port`, `value`, `speed`, `whenSensor` |
| `sensorRead` | アーテックロボの拡張機能がセンサーの値を読んだ | `port`, `sensor`, `value` |

`tab` と `partQuiz` は VM ではなく**エディタの画面の状態**を見る。見張り(`attachGoalMonitor`)に `getUi`(`{activeTab, partQuizSolved}` を
返す関数)を渡し、`containers/lesson-goal-watcher.jsx` がタブ・クイズの答えが変わったら `refresh()` で判定を予約する。
Expand Down Expand Up @@ -758,6 +760,30 @@ RegExp で両方を許す(例: `/^(正解です|せいかいです|correct)$/i
**`list` の項目**: `length`(matcher。例: `{gte: 3}`)、`itemsFromAnswers: true`(中身が全部「聞いて待つ」に
入力した答え)。

**`boardCommand` / `sensorRead` の項目**(Studuino の命令とセンサーの値の記録。形は `docs/extension-smalrubot-s1/README.md` の「命令とセンサーの値の記録」)

- 実機(`board: 'device'`)か練習用の基板(`'practice'`)かは見ない。どちらでも同じ事実で「できた」にする。
- `port`(`A0` / `M1` / `D10` / `A6` ...)と `sensor`(`touch` / `irPhotoreflector` / `light` / `sound`)は、文字列か配列(どれか 1 つに合えばよい)。
`value` と `speed` は matcher。LED の `value` は `on` / `off`、モーターは `normal` / `reverse` / `stop`、サーボは角度。
- `whenSensor: {port, sensor, value}`: 命令を出したときに、**最後に読んでいたセンサーの値**(ポートごと)のどれかが合った。
`port` も `sensor` も書かなければ、どのセンサーでもよい(手元に無いセンサーの代わりに、ほかのセンサーで試してもよいため)。
緑の旗・作品の読みこみで記録が消えたら、その前に読んだ値は使わない(前の実行の値で合わない)。
- 命令・読みの事実はチャレンジのあいだ残る(上限はそれぞれ 1000 件)。一度でも満たせばよい。

```js
// 暗いとき(光センサー < 50)に LED をオンにし、明るいとき(>= 50)にオフにした
[
{ type: 'boardCommand', kind: 'led', value: 'on', whenSensor: { sensor: 'light', value: { lt: 50 } } },
{ type: 'boardCommand', kind: 'led', value: 'off', whenSensor: { sensor: 'light', value: { gte: 50 } } },
]

// どれかのセンサーの値で車を前に動かした(センサーの種類はしばらない)
[{ type: 'boardCommand', kind: 'motor', port: 'M1', value: 'normal', whenSensor: { value: { gte: 1 } } }]

// 光センサーの値を読んだ
[{ type: 'sensorRead', sensor: 'light' }]
```

`validateGoal(goal)` が形を確かめる(courses.js に入れる前のテスト用)。

### レッスン 1 の 11 のチャレンジの `goal`(例)
Expand Down Expand Up @@ -844,6 +870,7 @@ scratch-vm には「ブロックが動いた」を知らせるイベントが無
| 誰がメッセージを送ったか | `event_broadcast` / `event_broadcastandwait` / `meshV2_broadcastWithValue`(メッシュの「といっしょに送る」)の実行を記録(メッセージ名 → ターゲット id)。受け取ったスクリプトの run に送り主を持つ |
| 言った文字 | runtime の `SAY` イベント(`say` / `think` も。空の文字は吹き出しを消すだけなので記録しない)。言った時点の変数の値も一緒に持つ |
| 答え | runtime の `ANSWER` イベント |
| Studuino の命令・センサーの読み | 拡張機能の runtime のイベント `STUDUINO_COMMAND_LOG`(1 件ずつ)。`STUDUINO_COMMAND_LOG_CLEAR`(緑の旗・作品の読みこみ)で「そのときのセンサーの値」を消す。この記録だけは scratch-vm の拡張機能が出す |
| 変数・リスト・スプライト数・コスチューム数・拡張機能 | 判定のたびに VM を読む(`takeSnapshot`)。コスチューム数は見張りを始めたときの数と比べる |

注意:
Expand Down
3 changes: 3 additions & 0 deletions docs/maintenance/smalruby-markers-gui.md
Original file line number Diff line number Diff line change
Expand Up @@ -75,6 +75,7 @@ upstream ファイルに追加した Smalruby 固有コードのマーカー一
| `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` | studuino practice board | Studuino の拡張機能を読みこんだときだけ出す練習用の基板のパネル(`containers/studuino-practice-board.jsx`。document.body への portal)の import と配置。MobileGui には置かない |
| `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 |
Expand Down Expand Up @@ -195,6 +196,7 @@ upstream ファイルに追加した Smalruby 固有コードのマーカー一
| `src/lib/legacy-storage.ts` | local sprite assets | スプライトの画像アセットをローカル配信の web store から解決する追加登録 |
| `src/lib/legacy-backpack-storage.ts` | localStorage backpack support | バックパックを localStorage に保存する対応(5 ペア) |
| `src/lib/alerts/index.jsx` | classroom session expired alert | クラスルームのセッション失効アラートの定義 |
| `src/lib/alerts/index.jsx` | Smalrubot S1 renamed alert | 移行期間の前の名前のカード(スモウルボットS1)を選んだときの、名前が変わったことの知らせ(`smalrubotS1Renamed`。2027-11-30 の期限のあとに消す) |
| `src/components/alerts/alert.jsx` | classroom session expired | セッション失効アラートの表示側 |
| `src/containers/alert.jsx` | classroom session expired | セッション失効アラートのコンテナ側(3 ペア) |
| `src/lib/libraries/extensions/index.jsx` | TM2Scratch extension / AkaDako extension / Ruby String extension | 拡張機能ライブラリへの Smalruby 拡張エントリ(各 2 ペア。取り外し可能拡張の分離マーカーと同名系列) |
Expand All @@ -210,6 +212,7 @@ upstream ファイルに追加した Smalruby 固有コードのマーカー一
| `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.jsx` | extension library key | 拡張機能の項目のキーに `extensionId` を使う |
| `src/containers/extension-library.jsx` | Smalrubot S1 legacy card | 移行期間(2027-11-30 まで)だけ、アーテックロボのカードの後ろに前の名前のカード「スモウルボットS1」を差しこみ、選ばれたら同じ拡張機能 `smalrubotS1` を読みこんで知らせを出す(import・`handleItemSelect`・render・propTypes・mapDispatchToProps の 5 ペア。処理は `src/lib/libraries/extensions/smalrubot-s1/legacy-card.jsx`) |
| `src/components/library/library.jsx` | modal header actions | `headerActions` を `Modal` に渡す(prop と propType) |
| `src/components/modal/modal.jsx` | modal header actions | ヘッダーの右のボタン置き場 `headerActions`(拡張機能のライブラリ・甲子園のテストのモーダルが使う)。描画と propType |
| `src/components/modal/modal.css` | modal header actions | `.header-item-actions`(`headerActions` の置き場。LTR / RTL の余白) |
Expand Down
1 change: 1 addition & 0 deletions docs/maintenance/smalruby-markers-vm.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,6 +28,7 @@ scratch-vm の **upstream ファイルに埋め込んだ Smalruby マーカー**
| `src/virtual-machine.js` | mesh v1 to v2 migration | mesh v1→v2 移行の統合(**同名マーカー 4 ペア**): ① `serialization/smalruby-migration.js` からの import、② プロジェクトロード時の `options.migrateMeshV1ToV2` 分岐、③ `hasMeshV1Project` / `hasKoshienProject` / `migrateMeshV1InBackpackBlocks` / `migrateMeshV1InBackpackSprite` メソッド群、④ `shareBlocksToTarget` での stray v1 opcode 書き換え。mesh v1 サービス廃止後もプロジェクト/バックパックを壊さないための後方互換 |
| `src/virtual-machine.js` | mesh v1 to v2 migration on install | `installTargets` の先頭で、読み込んだターゲットの v1 opcode と拡張 ID `mesh` を v2 に書き換える(`migrateMeshV1InTargets`)。v1 の拡張機能本体を削除したので、`migrateMeshV1ToV2` を付けない読み込み(初期プロジェクト・スプライト追加など)でも `mesh` をロードしに行かないようにする |
| `src/extension-support/extension-manager.js` | builtin extension entries | `builtinExtensions` オブジェクトリテラル内の直書き 2 行(`meshV2` / `smalrubotS1`)。新規拡張はこの形式ではなく `smalruby-extensions.js` 経由で登録する(`.claude/rules/scratch-vm/development.md`) |
| `src/extension-support/block-type.js` / `src/extension-support/extension-manager.js` / `src/engine/runtime.js` | label block type | 拡張機能のパレットに見出しを出す `BlockType.LABEL`(各ファイル 1 ペア)。`block-type.js` に値 `label` を足し、`extension-manager.js` の `_prepareBlockInfo` で opcode 無しを許し、`runtime.js` の `_convertForScratchBlocks` で `<label text="..."/>`(Blockly のフライアウトの見出し。scratch-blocks v2 がそのまま描く)に変える。ブロックではないので sb3 には何も保存されない。Studuino の「ロボットカー」の見出しが使う。upstream に同じ機能が入ったら、そちらに合わせてマーカーを外す |

## 関連ファイル

Expand Down
Loading
Loading