TurboWarp extension and toolchain overview

Concept

Scratchでの創作からTypeScriptの機能拡張、Composition API、SB3の再現可能なbuild、TM Kamishibaiの統合applicationまでを一つの道筋として説明する。

• Scratchでの創作
• TurboWarpと既存機能拡張の利用
• TypeScriptによる独自機能拡張
• Composition APIによる機能の合成
• SB3のsource管理と再現可能なbuild
• TM Kamishibaiという統合application

このecosystemは、Scratch作品をいきなり別言語へ移すためのものではありません。TurboWarpのblock UIで試せるStandalone extensionと、host applicationから組み合わせるComposition APIを分け、同じ機能を学習・制作・配布の流れへ接続するためのものです。

機能は一枚岩にせず、camera、recognition、input、state、asset、text、bubble、diagnostic、networkへ分けます。個々のrepositoryは小さく検証可能な責務を持ち、TM Kamishibaiはそれらを教材・作品・Web配布へ接続する統合applicationとして扱います。

Relationship Flow

flowchart LR
  scratch[Scratchでの創作] --> turbowarp[TurboWarpと既存機能拡張]
  turbowarp --> typescript[TypeScriptによる独自機能拡張]
  typescript --> vite[Vite Plugin]
  vite --> bundles[standalone bundle / manifest / Composition API]
  bundles --> sb3[SB3 Toolchain]
  camera[TurboWarp-Camera-Source] --> tm[TurboWarp TM]
  camera --> jsqr[jsQR]
  tm --> async[TurboWarp-Async-Input]
  asset[TurboWarp-Asset-Manager] --> bubble[Bubble]
  text[Text Lines] --> bubble
  svg[TurboWarp-SVG-Text] --> bubble
  async --> app[TM Kamishibai]
  asset --> app
  expression[TurboWarp-Runtime-Expression] --> app
  bubble --> app
  diagnostic[TurboWarp-Diagnostic-Overlay] --> app
  sb3 --> app
  app --> docs[Docs]
  app --> samples[Samples]

図は次の関係を示します。TypeScriptで書いた機能拡張はVite pluginでstandalone bundle、manifest、Composition API向け出力へ分かれ、SB3 ToolchainでScratch/TurboWarp projectのsource管理と再現可能buildへ接続します。Camera SourceはTurboWarp TMとjsQRへ映像sourceを渡し、Async Inputは認識・device・application eventを作品の実行tickから扱える状態へ整えます。SVG Text、Text Lines、Asset ManagerはBubbleの表示素材と台詞を支え、Diagnostic Overlayは停止理由や検証結果を画面へ出します。TM Kamishibaiはこれらを統合し、DocsとSamplesが利用者・教材作者・開発者の入口を提供します。

Inventory Policy

• product name、package name、repository slug、Extension ID、opcodeは同じものとして扱わない。
• current entryではTM Kamishibai、TM紙芝居、TurboWarp TM、tm-kamishibaiを使う。
• old product name、old repository slug、old Extension ID、old opcode prefixはHistory、Migration、source provenanceだけに限定する。
• version numberを本文に固定する場合はinventoryまたはrelease記録と一致検査できる場所へ置く。
• docsとして扱う本文と独自図はCC BY-SA 4.0、build scriptとsite codeはMPL-2.0、第三者素材は個別noticeに従う。

認識・入力・通信

状態・素材

表示・対話

開発・配布基盤

統合application／content

upstream fork

Repository Integration Checklist

主要repositoryのREADMEには、この文書と同じ一覧を複製しません。各READMEには短い導線だけを置き、詳細な相互関係はこの中央indexへ集約します。

• TurboWarp機能拡張: READMEからこのoverviewへ一文で案内する。
• templateとVite plugin: 新規機能拡張を作る開発者向けに、このoverviewを設計背景として案内する。
• SB3 Toolchain: manifest、migration plan、reproducible buildの説明からこのoverviewへ接続する。
• TM Kamishibai: applicationが統合するpackage群をこのoverviewへ委譲し、READMEには利用者向け導線を残す。
• DocsとSamples: 公開siteの入口から、このoverview、チュートリアル、作品libraryを行き来できるようにする。