@kubohiroya/turbowarp-bubble 0.8.0 → 0.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -6,13 +6,15 @@
6
6
  - `"scratch-render"`は明示指定できるrollback backendとして保持する。
7
7
  - `renderer.addOverlay(root, "scale")`上の共有SVG rootにBubble surfaceを描画する。
8
8
  - host-neutralな`svgOverlayTextCapability`と、解放可能な`svgOverlayImageCapability`を公開する。
9
- - SVG Text 0.8.0を通常dependencyとし、既定で`createSvgTextLayoutComposition().layoutText()`の行layoutを座標・角丸ごと変換する。
9
+ - SVG Text 0.8.1を通常dependencyとし、standalone拡張がない場合は`createSvgTextLayoutComposition().layoutText()`、ロード済みの場合は公開`getLayoutCapability()`から同じnamed-style registryの行layoutを変換する。
10
+ - handoffのない古いstandalone SVG Textが存在する場合、named styleを既定値へ黙って置換せず、明示errorまたは設定済みscratch-render fallbackを使う。
10
11
  - Bubble側の`createAssetManagerSvgOverlayImageCapability()`でAsset Managerの汎用DOM resourceを変換する。依存方向はBubbleからAsset Managerへの一方向を維持する。
12
+ - stock Asset Manager 0.12.1を別拡張として読み込んだ場合、Bubbleが公開`getDOMImageCapability()`を遅延取得し、Asset Managerブロックで登録された同じregistryへ自動接続する。
11
13
  - overlay API未対応hostは`BUBBLE-RUNTIME-004`を返す。`svgOverlayUnsupportedBehavior: "fallback"`を明示した場合だけ既存backendへ戻る。
12
14
 
13
15
  ## 自動検証結果
14
16
 
15
- 2026-08-18時点のunit testでは、次を合格条件としている。
17
+ 2026-08-19時点のunit testでは、次を合格条件としている。
16
18
 
17
19
  - optionsを省略した既定経路でshow、text更新、shake、shape animationを行っても、Bubbleから`createDrawable()`、`createSVGSkin()`、`createBitmapSkin()`を呼ばない(許容値: 0回)。
18
20
  - 2つのBubbleが1つのrootを共有し、最後のclose後に`removeOverlay()`を1回呼ぶ(許容値: 残存root 0、重複remove 0)。
@@ -21,20 +23,69 @@
21
23
  - capability所有のblob URLをreplacement/close時に各1回解放する。
22
24
  - renderer cleanupが失敗した場合も、残りのlistener、DOM、image leaseの解放を継続してerrorを集約する。
23
25
  - Asset Managerのsanitize済みSVG resourceをBubble側adapter経由で描画し、close時にleaseを1回解放する。
24
- - SVG Textのhost-neutral layoutをBubble側adapterで変換し、renderer skinを生成せず行座標を維持する。
26
+ - SVG Textのhost-neutral layoutをBubble側adapterで変換し、renderer skinを生成せず行座標を維持する。stock named styleの再定義後は、同じ公開handoffから次回layoutへ新しいfont、color、size、alignment、改行layoutを反映する。
27
+
28
+ ## Web smoke結果
29
+
30
+ 2026-08-20にcommit `9b01605`からbuildしたrelease候補の`dist/turbowarp-bubble.js`を、TurboWarp Webのカスタム拡張機能へtext入力し、unsandboxedで読み込んだ。Chrome/macOSで`define bubble style`、say/think、style/reveal/animation/closeの各blockを実行した結果は次のとおり。
31
+
32
+ - Bubble paletteが登録され、sprite上方に`NORMAL`のsay bubbleが表示された。
33
+ - `[data-bubble-render-backend="svg-overlay"]`は1個で、DOMへ接続済みだった。
34
+ - rootは`viewBox="0 0 480 360"`、属性上の幅・高さとCSS上の表示領域はいずれも480×360だった。
35
+ - `NORMAL`、`THINKING`、`DREAMING`、`YELLING`、`OFF_PANEL`、`WAVY`、`WHISPERING`、`ANNOUNCEMENT`、`NARRATION`、`NO_BUBBLE`の全10styleを表示した。`THINKING`はbody `path` 1個とtrail `circle` 2個、`DREAMING`は`circle` 3個、`NO_BUBBLE`はbodyを非表示にしてtextだけを維持した。
36
+ - short textの`THINKING`/`DREAMING`で固定Bezier制御点が自己交差する問題をこの確認で検出した。cloud bodyへ176×96の最小viewportと比例制御点によるclosed splineを導入し、修正版で滑らかな輪郭を再確認した。
37
+ - root内の`script`、`foreignObject`、inline event handlerは0個だった。
38
+ - 初回登録時に検出したTurboWarp VMの`Unexpected input recieved in replaceUnsafeChars`は、`color2`/`color3`の明示後のrelease候補bundleでは再現せず、extension登録から全smoke終了まで新規warning/errorは0件だった。
39
+ - revealを`CHARACTER`、0.05秒に設定したsayは`H`、`Hello`、`Hello!`の順に進み、Chromiumのreadback、`Silhouette.unlazy()`、`getImageData()`関連warningは0件だった。
40
+ - shake中はsurface transformが変化して終了時に基準位置へ戻り、shape animationは`NORMAL`から`WAVY`へ完了した。close後はrootが0個となり、再度sayするとroot 1個へ復帰した。
41
+
42
+ stageはnative 480×360、small表示240×180、fullscreen表示3152×2364、custom native 640×480で確認した。各表示でrootの属性と`viewBox`はnative sizeに一致し、CSS表示領域はhostの拡大縮小へ追随した。sprite相対配置に加え、Stage targetの`HEADER_LIKE`も640×480上端のsafe area内へ表示された。最後に480×360、sprite相対`NORMAL`へ戻した。
43
+
44
+ ## Desktop smoke結果
45
+
46
+ 2026-08-20にTurboWarp Desktop 1.16.0へ同じrelease候補をtext入力し、unsandboxedで読み込んだ。実アプリのsprite/Stage targetとVM primitiveを使って確認した結果は次のとおり。
47
+
48
+ - Bubble paletteと全28 primitiveが登録され、say/thinkと全10 visual styleが表示された。short textの`THINKING`は176×96・trail `circle` 2個、`DREAMING`は176×96・`circle` 3個だった。
49
+ - revealは`H`、`Hell`、`Hello!`の順に進んだ。shakeはsurface transformを変化させて基準位置へ戻り、shape animationは`NORMAL`から`WAVY`へ完了した。
50
+ - native 480×360、small表示240×180、fullscreen表示955×716、custom native 640×480でrootがstageへ追随した。sprite相対配置とStage targetの`HEADER_LIKE`を確認した。
51
+ - spriteとStageの2 surfaceを同時表示した後、Stageのcloseで1 surface、spriteのcloseでroot 0となった。
52
+ - 正しいstage sizeを設定して再実行した区間では、consoleのwarning/errorは0件だった。最後にstageを480×360へ戻し、root 0を確認した。
53
+
54
+ ## Packager smoke結果
55
+
56
+ 2026-08-20にTurboWarp Packager Standalone 3.13.0で、Bubble blockを含むDesktopプロジェクトからプレーンHTMLのpreviewを生成した。Packagerの高度な設定ではrelease候補のdata URLがcustom extensionとして検出され、cached copyの埋め込みが有効だった。生成playerではBubbleの全28 primitiveがロードされた。
57
+
58
+ - sayで全10 visual styleを表示し、明示したthinkでもshort `DREAMING`が176×96・trail `circle` 3個となった。short `THINKING`は176×96・`circle` 2個だった。
59
+ - revealは`H`、`Hel`、`Hello!`の順に進んだ。`zoomIn`はscale 0.01から1へ完了し、shakeは位置を変化させて基準位置へ戻り、shape animationは`WAVY`へ完了した。
60
+ - sprite相対配置に加え、Stage targetの`HEADER_LIKE`をnative 480×360のsafe area内で確認した。
61
+ - Bubble表示中にcanvasの`toDataURL()`はPNG data URLを返し、`captureStream()`はvideo trackを1本返した。Bubble rootはcanvasの子ではなく、隣接する`.scratch-render-overlays`内にあるため、両APIにBubbleが含まれない既知制約を確認した。
62
+ - show/replace/closeを100回実行した後、Bubble root、surface、overlay childは0で、runtime listener数の増分も0だった。
63
+ - 全smoke終了までconsoleのwarning/errorは0件だった。
64
+
65
+ ## deterministic benchmark結果
66
+
67
+ `pnpm benchmark:render-backends`は、happy-dom上の同一fake rendererと決定的schedulerを使い、`svg-overlay`とrollback用`scratch-render`を同じ入力で比較する。2026-08-20にNode.js v26.7.0/arm64 macOSで実行した代表値は次のとおり。
68
+
69
+ | workload | svg-overlay | scratch-render | 判定 |
70
+ | ---------------------------------------------- | ---------------------------------------- | ---------------------------------------- | ----------------------------------- |
71
+ | typewriter、1,000回 | 62.254 ms、skin/drawable生成0 | 8.720 ms、skin 1,002、drawable 2 | overlayのrenderer resource生成0 |
72
+ | shape/shake/zoom、各10秒・合計1,875 callback | callback超過0%、p95 0.352 ms | callback超過0%、p95 0.157 ms | 差0 percentage points、許容値+5以内 |
73
+ | show/text・style更新/close、100回 | DOM/listener/skin/drawable残存すべて0 | DOM/listener/skin/drawable残存すべて0 | lifecycle residual 0 |
74
+
75
+ このbenchmarkが測るのはJavaScript callbackのCPU時間、renderer API呼び出し数、明示resourceの解放である。実browserのlayout/paint/composite、GC後の保持heap、host固有のframe dropを代替しない。数値は環境と実行ごとに変動するため、release判定ではresource残存とpercentage-point基準を主要判定値とする。
25
76
 
26
77
  ## release前のmanual gate
27
78
 
28
- 上流の[turbowarp-svg-text#26](https://github.com/kubohiroya/turbowarp-svg-text/issues/26)で公開されたhost-neutral layoutを0.8.0の通常dependencyとして採用し、[turbowarp-asset-manager#103](https://github.com/kubohiroya/turbowarp-asset-manager/issues/103)のDOM image resourceは0.12.0対応adapterから任意注入する。既定値変更後も次のmanual gateをrelease前に実施し、実測値をこの表へ記録する。
79
+ 上流の[turbowarp-svg-text#26](https://github.com/kubohiroya/turbowarp-svg-text/issues/26)で公開されたhost-neutral layoutを0.8.0の通常dependencyとして採用する。[turbowarp-asset-manager#103](https://github.com/kubohiroya/turbowarp-asset-manager/issues/103)のDOM image resourceをBubble所有adapterで変換し、stock拡張間のhandoffには[turbowarp-asset-manager#106](https://github.com/kubohiroya/turbowarp-asset-manager/issues/106)で公開された0.12.1 APIを使う。既定値変更後も次のmanual gateをrelease前に実施し、実測値をこの表へ記録する。
29
80
 
30
- | 項目 | host | 許容基準 | 結果 |
31
- | -------------------------- | ------------------------------------ | --------------------------------------------------------- | ------ |
32
- | say/think、全visual style | Web、Desktop、Packager | reference screenshotの主要geometry差異なし | 未測定 |
33
- | actor/background配置 | native 480×360と変更size、fullscreen | stage外clip、tail方向、centerに回帰なし | 未測定 |
34
- | typewriter | 1,000 update | Chromium readback警告0、`Silhouette.unlazy()`増分0 | 未測定 |
35
- | shape/shake/zoom | 各10秒 | dropped frame率が既存backend比+5 percentage points以内 | 未測定 |
36
- | memory/lifecycle | show/replace/stopを100回 | close後のBubble DOM、object URL、animation、listener残存0 | 未測定 |
37
- | raw canvas capture | `toDataURL()`、`captureStream()` | Bubbleが含まれない既知制約を確認 | 未測定 |
81
+ | 項目 | host | 許容基準 | 結果 |
82
+ | -------------------------- | ------------------------------------ | --------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
83
+ | say/think、全visual style | Web、Desktop、Packager | reference screenshotの主要geometry差異なし | 3 hostでsay/thinkと全10styleを確認。short cloudの最小寸法とtrail数も一致 |
84
+ | actor/background配置 | native 480×360と変更size、fullscreen | stage外clip、tail方向、centerに回帰なし | Web/Desktopで480×360、small、fullscreen、640×480、Packagerで480×360のactor/backgroundを確認 |
85
+ | typewriter | 1,000 update | Chromium readback警告0、`Silhouette.unlazy()`増分0 | harnessで1,000 updateとresource生成0。3 hostの実revealで関連warning 0 |
86
+ | shape/shake/zoom | 各10秒 | dropped frame率が既存backend比+5 percentage points以内 | harnessで各10秒・0%対0%、差0 points。Web/Desktopでshape/shake、Packagerでshape/shake/zoomをsmoke済み |
87
+ | memory/lifecycle | show/replace/stopを100回 | close後のBubble DOM、object URL、animation、listener残存0 | harnessの全resource残存0。Packager実hostの100回後にDOM、surface、overlay child、listener増分0 |
88
+ | raw canvas capture | `toDataURL()`、`captureStream()` | Bubbleが含まれない既知制約を確認 | Packagerで両APIの成功と、Bubble rootがcanvas外のsibling overlayにあることを確認 |
38
89
 
39
90
  ## capture制約
40
91
 
@@ -0,0 +1,47 @@
1
+ # 0.9.0: TurboWarp互換の組み込みsay/think style
2
+
3
+ ## 概要
4
+
5
+ Bubble 0.9.0では、設定不要の基本経路をTurboWarp標準の`say`/`think`ブロックへ揃え、named custom styleは種類指定が競合しない1つの表示ブロックから利用できるようにする。
6
+
7
+ - 組み込みBubble style `say`はspeech本体とspeech tailを持つ。
8
+ - 組み込みBubble style `think`はthought本体とround trailを持つ。
9
+ - 本体とtail/trailの形は不可分なvisual styleであり、tail形状だけを独立して指定する設定は持たない。
10
+ - 短い`say [MESSAGE]`/`think [MESSAGE]`ブロックが対応する組み込みstyleを自動選択する。
11
+ - 両組み込みstyleは予約SVG Text profile `default`を使う。
12
+ - named custom styleは`show [MESSAGE] with bubble style [STYLE]`で表示する。
13
+
14
+ ## TurboWarpとの外観互換
15
+
16
+ 基本profileは内容に追従するgeometry、14px Helvetica、16px line height、最大行幅170px、最小text幅50px、padding 10px、corner 16px、白いfill、Scratchのtext/outline色、右側優先・収まりに応じた左反転、block入力の330文字上限、空文字でのcloseを使う。
17
+
18
+ Scratch互換SVG本体は4px strokeを白いfillより先に描く。fillがstrokeの内側半分を覆うため、画面上に見える輪郭はTurboWarp標準と同じ細さになる。Actor相対のspeech tail/thought trailはActorの方向を指す。
19
+
20
+ 日英マニュアルには、実際のTurboWarp Editorで撮影したStage結果と対応コードブロックの比較図版を含める。
21
+
22
+ - [Stage比較](./assets/turbowarp-say-think-stage-comparison.png)
23
+ - [ブロック比較](./assets/turbowarp-say-think-block-comparison.png)
24
+
25
+ ## ブロック契約と互換性
26
+
27
+ standalone manifestは31定義を持ち、paletteには29ブロックを表示する。
28
+
29
+ - 表示opcode `say`、`think`、`showWithBubbleStyle`を追加する。
30
+ - 旧`sayWithBubbleStyle`/`thinkWithBubbleStyle` opcodeは以前のargument既定値を維持したまま実装を残し、paletteから非表示にする。
31
+ - いずれかの旧opcodeを使う保存済みprojectは引き続き動作する。
32
+ - quick-startとlifecycle図版は、named custom style用の表示される統合`show`ブロックを使う。
33
+ - Bubbleを消す操作は`close this bubble`とし、設定済みの表示終了animation後に所有resourceを解放する。`hide`という別ブロックは設けない。
34
+
35
+ ## 検証
36
+
37
+ - `pnpm check`
38
+ - TypeScript declarationとComposition API consumerのcompile成功。
39
+ - 14 test files/125 tests成功。
40
+ - ドキュメントsource、Pages生成HTML、extension manifest、配布bundle、npm tarballを一括検証。
41
+ - 公開Stage/ブロック比較画像のhashがrepository assetと一致。
42
+
43
+ ## 更新とロールバック
44
+
45
+ 保存済みstyled say/thinkブロックを移行せず、extension URLを0.8.0から0.9.0へ置き換えられる。新しいscriptでは、基本profileには短い組み込みブロック、named custom styleには統合`show`ブロックを使う。
46
+
47
+ 回帰が見つかった場合はextension URLまたはnpm dependencyを0.8.0へpinし、修正版0.9.x patchを公開する。公開済み0.9.0 packageをunpublishしたり、対応するGit tag/GitHub Releaseを削除したりしない。
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@kubohiroya/turbowarp-bubble",
3
- "version": "0.8.0",
3
+ "version": "0.9.0",
4
4
  "description": "Composable say and think bubbles with portrait layers and animated continue indicators for TurboWarp.",
5
5
  "author": "Hiroya Kubo <hiroya@cuc.ac.jp>",
6
6
  "type": "module",
@@ -37,6 +37,7 @@
37
37
  "dist/",
38
38
  "docs/",
39
39
  "README.md",
40
+ "README_ja.md",
40
41
  "LICENSE",
41
42
  "THIRD_PARTY_NOTICES.md"
42
43
  ],
@@ -65,7 +66,7 @@
65
66
  },
66
67
  "devDependencies": {
67
68
  "@eslint/js": "^10.0.1",
68
- "@kubohiroya/turbowarp-asset-manager": "0.12.0",
69
+ "@kubohiroya/turbowarp-asset-manager": "0.12.1",
69
70
  "@kubohiroya/turbowarp-async-input": "0.3.0",
70
71
  "@kubohiroya/turbowarp-runtime-expression": "0.3.0",
71
72
  "@kubohiroya/vite-plugin-turbowarp-extension": "0.1.1",
@@ -93,7 +94,7 @@
93
94
  ],
94
95
  "dependencies": {
95
96
  "@cto.af/linebreak": "4.0.3",
96
- "@kubohiroya/turbowarp-svg-text": "0.8.0"
97
+ "@kubohiroya/turbowarp-svg-text": "0.8.1"
97
98
  },
98
99
  "scripts": {
99
100
  "typecheck": "tsc --noEmit",
@@ -111,6 +112,7 @@
111
112
  "docs:pages": "node scripts/render-pages.mjs",
112
113
  "docs:pages:check": "node scripts/render-pages.mjs --check",
113
114
  "docs:check": "node scripts/check-block-manual.mjs && pnpm docs:pages:check",
115
+ "benchmark:render-backends": "pnpm build && node --expose-gc scripts/benchmark-render-backends.mjs",
114
116
  "test": "vitest run",
115
117
  "check:dist": "pnpm build && node scripts/check-dist.mjs",
116
118
  "pack:check": "npm pack --dry-run --ignore-scripts",