@kubohiroya/turbowarp-bubble 0.11.0 → 0.13.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.
@@ -8,21 +8,21 @@
8
8
 
9
9
  ## 1. 必要な拡張機能
10
10
 
11
- 入力待ちを含む完全な例では5つの拡張機能を使います。TurboWarpの拡張機能ライブラリからTemporary Variablesを追加し、選択した機能に必要なカスタム拡張機能を「サンドボックスなしで実行」を許可して読み込みます。BubbleはSVG Text 0.8.1のhost-neutral layout providerをbundle内に持ち、既定のSVG overlayではskinを作りません。portrait、lip-sync、continue indicator、フルボイス、表示効果音などのメディアアセットにはAsset Managerが必要です。Async InputとRuntime Expressionはconditionを使うBubble待機またはclose policyで必要です。timeoutだけのclose policyにはどちらも不要です。
11
+ 入力待ちを含む完全な例では5つの拡張機能を使います。TurboWarpの拡張機能ライブラリからTemporary Variablesを追加し、選択した機能に必要なカスタム拡張機能を「サンドボックスなしで実行」を許可して読み込みます。BubbleはSVG Text 0.10.0のhost-neutral layout providerをbundle内に持ち、既定のSVG overlayではskinを作りません。portrait、lip-sync、continue indicator、フルボイス、表示効果音などのメディアアセットにはAsset Cacheが必要です。Async InputとRuntime Expressionはconditionを使うBubble待機またはclose policyで必要です。timeoutだけのclose policyにはどちらも不要です。
12
12
 
13
13
  | 順番 | 拡張機能 | 読み込み先 |
14
14
  | ---: | ------------------------ | -------------------------------------------------------------------------------------------------------- |
15
15
  | 1 | Temporary Variables | TurboWarpの拡張機能ライブラリから追加 |
16
- | 2 | Async Input 0.5.0 | `https://cdn.jsdelivr.net/npm/@kubohiroya/turbowarp-async-input@0.5.0/dist/async-input.js` |
17
- | 3 | Runtime Expression 0.4.0 | `https://cdn.jsdelivr.net/npm/@kubohiroya/turbowarp-runtime-expression@0.4.0/dist/runtime-expression.js` |
18
- | 4 | Asset Manager 0.13.0 | `https://cdn.jsdelivr.net/npm/@kubohiroya/turbowarp-asset-manager@0.13.0/dist/asset-manager.js` |
19
- | 5 | Bubble 0.11.0 | `https://cdn.jsdelivr.net/npm/@kubohiroya/turbowarp-bubble@0.11.0/dist/turbowarp-bubble.js` |
16
+ | 2 | Async Input 0.7.0 | `https://cdn.jsdelivr.net/npm/@kubohiroya/turbowarp-async-input@0.7.0/dist/async-input.js` |
17
+ | 3 | Runtime Expression 0.6.0 | `https://cdn.jsdelivr.net/npm/@kubohiroya/turbowarp-runtime-expression@0.6.0/dist/runtime-expression.js` |
18
+ | 4 | Asset Cache 0.1.0 | `https://cdn.jsdelivr.net/npm/@kubohiroya/turbowarp-asset-cache@0.1.0/dist/asset-cache.js` |
19
+ | 5 | Bubble 0.13.0 | `https://cdn.jsdelivr.net/npm/@kubohiroya/turbowarp-bubble@0.13.0/dist/turbowarp-bubble.js` |
20
20
 
21
- 開発中のBubbleを試す場合は、このリポジトリの`dist/turbowarp-bubble.js`をローカルカスタム拡張機能として読み込みます。既定SVG overlayに必要なrenderer APIがない場合、画像・メディア機能の使用時にAsset Managerがない場合、condition待機の開始時にAsync InputかRuntime Expressionがない場合は、Bubbleが明示的なエラーを返します。低レベルComposition APIでは別のtext capabilityを注入できます。
21
+ 開発中のBubbleを試す場合は、このリポジトリの`dist/turbowarp-bubble.js`をローカルカスタム拡張機能として読み込みます。既定SVG overlayに必要なrenderer APIがない場合、画像・メディア機能の使用時にAsset Cacheがない場合、condition待機の開始時にAsync InputかRuntime Expressionがない場合は、Bubbleが明示的なエラーを返します。低レベルComposition APIでは別のtext capabilityを注入できます。
22
22
 
23
23
  参考:
24
24
 
25
- - [Asset Manager 日本語ガイド](https://kubohiroya.github.io/turbowarp-asset-manager/ja/)
25
+ - [Asset Cache 日本語ガイド](https://kubohiroya.github.io/turbowarp-asset-cache/ja/)
26
26
  - [Async Input 日本語ガイド](https://kubohiroya.github.io/turbowarp-async-input/ja/)
27
27
  - [Runtime Expression 日本語ガイド](https://kubohiroya.github.io/turbowarp-runtime-expression/ja/)
28
28
  - [SVG Text 日本語ガイド](https://kubohiroya.github.io/turbowarp-svg-text/ja/)
@@ -31,19 +31,19 @@
31
31
 
32
32
  例では`Assets`という素材用spriteに、次のcostumeを入れます。素材用spriteは画面上で非表示でも構いません。
33
33
 
34
- | costume | Asset Managerへ登録する名前 | 内容 |
35
- | ----------------- | --------------------------- | ------------------------------------------------ |
36
- | `HeroFace` | `HeroFace` | 顔、髪、輪郭などのベース。動かす目と口は含めない |
37
- | `HeroEyesOpen` | `HeroEyesOpen` | 開いた目だけを描いた透明差分 |
38
- | `HeroEyesClosed` | `HeroEyesClosed` | 閉じた目だけを描いた透明差分 |
39
- | `HeroMouthClosed` | `HeroMouthClosed` | 閉じた口だけを描いた透明差分 |
40
- | `HeroMouthOpen` | `HeroMouthOpen` | 開いた口だけを描いた透明差分 |
41
- | `Next1` | `Next1` | 「次へ」アイコンの1枚目 |
42
- | `Next2` | `Next2` | 「次へ」アイコンの2枚目 |
34
+ | costume | Asset Cacheへ登録する名前 | 内容 |
35
+ | ----------------- | ------------------------- | ------------------------------------------------ |
36
+ | `HeroFace` | `HeroFace` | 顔、髪、輪郭などのベース。動かす目と口は含めない |
37
+ | `HeroEyesOpen` | `HeroEyesOpen` | 開いた目だけを描いた透明差分 |
38
+ | `HeroEyesClosed` | `HeroEyesClosed` | 閉じた目だけを描いた透明差分 |
39
+ | `HeroMouthClosed` | `HeroMouthClosed` | 閉じた口だけを描いた透明差分 |
40
+ | `HeroMouthOpen` | `HeroMouthOpen` | 開いた口だけを描いた透明差分 |
41
+ | `Next1` | `Next1` | 「次へ」アイコンの1枚目 |
42
+ | `Next2` | `Next2` | 「次へ」アイコンの2枚目 |
43
43
 
44
44
  ベース、目、口の画像は同じcanvasサイズと同じ中心位置で作ります。差分画像の背景は透明にしてください。位置やcanvasサイズが異なると、レイヤーを重ねたときに目や口がずれます。
45
45
 
46
- Asset Managerのブロックで各costumeを登録します。
46
+ Asset Cacheのブロックで各costumeを登録します。
47
47
 
48
48
  ```text
49
49
  register resource [costume:Assets:HeroFace] as asset [HeroFace]
@@ -55,11 +55,11 @@ register resource [costume:Assets:Next1] as asset [Next1]
55
55
  register resource [costume:Assets:Next2] as asset [Next2]
56
56
  ```
57
57
 
58
- URL画像を使う場合は、`RESOURCE_ID`へHTTPS URLを指定します。Bubbleに設定できるのは、Asset Managerへ登録済みでMIME typeが`image/*`のアセットだけです。
58
+ URL画像を使う場合は、`RESOURCE_ID`へHTTPS URLを指定します。Bubbleに設定できるのは、Asset Cacheへ登録済みでMIME typeが`image/*`のアセットだけです。
59
59
 
60
60
  ## 3. 文字layout styleを選ぶ
61
61
 
62
- standalone BubbleはSVG Text 0.8.1のlayout compositionを内包し、2つのBubble styleを組み込みます。`say`はspeech本体とspeech tail、`think`はthought本体とround trailを持ち、本体とtail/trailの形は別項目ではなく1つのvisual styleとして選びます。短い`say [MESSAGE]`/`think [MESSAGE]`ブロックが対応styleを自動選択するため、基本経路にはstyle定義もstyle入力も不要です。どちらも予約text profile `default`、内容に追従するサイズ、14px Helvetica、右側優先・収まりに応じた左反転、block入力の330文字上限、空文字でのcloseを使います。4pxのSVG strokeを白いfillより先に描き、内側半分を隠すことで、見かけの輪郭をTurboWarp標準と同じ細さにします。それ以外のtext style名やstyle設定ブロックを使うとcustom profileになります。custom text styleは初回参照時に背景透明のSVG Text既定styleとして初期化されます。stock SVG Text 0.8.1をBubbleより先に別拡張として読み込んだprojectでは、Bubbleが公開`getLayoutCapability()`を使い、SVG Text blockで定義したnamed styleを維持します。handoffのない古いSVG Textがロード済みならstyleを黙って置換せず互換errorを返し、必要な場合だけ文書化済みscratch-render fallbackを選択します。
62
+ standalone BubbleはSVG Text 0.10.0のlayout compositionを内包し、2つのBubble styleを組み込みます。`say`はspeech本体とspeech tail、`think`はthought本体とround trailを持ち、本体とtail/trailの形は別項目ではなく1つのvisual styleとして選びます。短い`say [MESSAGE]`/`think [MESSAGE]`ブロックが対応styleを自動選択するため、基本経路にはstyle定義もstyle入力も不要です。どちらも予約text profile `default`、内容に追従するサイズ、14px Helvetica、右側優先・収まりに応じた左反転、block入力の330文字上限、空文字でのcloseを使います。4pxのSVG strokeを白いfillより先に描き、内側半分を隠すことで、見かけの輪郭をTurboWarp標準と同じ細さにします。それ以外のtext style名やstyle設定ブロックを使うとcustom profileになります。custom text styleは初回参照時に背景透明のSVG Text既定styleとして初期化されます。stock SVG Text 0.10.0をBubbleより先に別拡張として読み込んだprojectでは、Bubbleが公開`getLayoutCapability()`を使い、SVG Text blockで定義したnamed styleを維持します。handoffのない古いSVG Textがロード済みならstyleを黙って置換せず互換errorを返し、必要な場合だけ文書化済みscratch-render fallbackを選択します。
63
63
 
64
64
  ```text
65
65
  define bubble style [hero-dialogue] using text style [default]
@@ -178,7 +178,7 @@ set continue frames [Next1,Next2]
178
178
  every [0.2] seconds for bubble style [hero-dialogue]
179
179
  ```
180
180
 
181
- `ASSETS`はカンマ区切りのAsset Managerアセット名です。名前の前後の空白は除去されます。アセット名自体にカンマは使用できません。
181
+ `ASSETS`はカンマ区切りのAsset Cacheアセット名です。名前の前後の空白は除去されます。アセット名自体にカンマは使用できません。
182
182
 
183
183
  - 目パチと口パクは1枚以上指定できます。1枚だけなら表示は固定されます。
184
184
  - 「次へ」はループが分かるよう2枚以上必要です。
@@ -202,7 +202,7 @@ show [海へ出発!] with bubble style [hero-dialogue]
202
202
  finish [CHARACTER] with condition [input == "pressed"] or timeout after [10] seconds
203
203
  ```
204
204
 
205
- `DYNAMIC`は表示単位ごとに吹き出しの大きさと配置を再計算し、`RESERVED`は最終的な文字量を先に計測して表示中の外形を予約します。`set bubble reveal sound`は単位ごと、`set bubble voice`は表示開始時にAsset Managerの名前付き音声を再生します。音声がなくても文字表示は利用できます。
205
+ `DYNAMIC`は表示単位ごとに吹き出しの大きさと配置を再計算し、`RESERVED`は最終的な文字量を先に計測して表示中の外形を予約します。`set bubble reveal sound`は単位ごと、`set bubble voice`は表示開始時にAsset Cacheの名前付き音声を再生します。音声がなくても文字表示は利用できます。
206
206
 
207
207
  ## 6. セリフを表示して入力を待つ
208
208
 
@@ -328,7 +328,7 @@ cloneが停止・削除された場合は、そのtargetに属するtimer、over
328
328
 
329
329
  | 状況 | 原因と対処 |
330
330
  | ------------------------------------ | ------------------------------------------------------------------------ |
331
- | Asset Managerを要求するエラー | 画像・メディアアセットを使う前にAsset Manager 0.12.xを読み込む |
331
+ | Asset Cacheを要求するエラー | 画像・メディアアセットを使う前にAsset Cache 0.1.0を読み込む |
332
332
  | SVG overlay backendのエラー | `renderer.addOverlay()`対応hostを使うか`scratch-render`を明示する |
333
333
  | Async Inputを要求するエラー | Bubble待機より前にAsync Input 0.3.xをサンドボックスなしで読み込む |
334
334
  | Runtime Expressionを要求するエラー | Bubble待機より前にRuntime Expression 0.3.xをサンドボックスなしで読み込む |
@@ -353,7 +353,7 @@ cloneが停止・削除された場合は、そのtargetに属するtimer、over
353
353
  - projectの全停止
354
354
  - TurboWarp runtimeの破棄
355
355
 
356
- Asset Managerへ登録したアセット自体はBubbleの所有物ではありません。不要になった登録画像をメモリから削除する場合は、Bubbleを閉じた後にAsset Managerの`delete asset [NAME] from memory`を使います。
356
+ Asset Cacheへ登録したアセット自体はBubbleの所有物ではありません。不要になった登録画像をメモリから削除する場合は、Bubbleを閉じた後にAsset Cacheの`delete asset [NAME] from memory`を使います。
357
357
 
358
358
  ## 14. マニュアル画像の再生成
359
359
 
@@ -8,21 +8,21 @@ This manual explains how to use `turbowarp-bubble` as an unsandboxed TurboWarp c
8
8
 
9
9
  ## 1. Load the required extensions
10
10
 
11
- The complete input-wait example uses five extensions. Add Temporary Variables from TurboWarp's extension library, then load the custom extensions needed by the selected features with **Run without sandbox** enabled. Bubble bundles the host-neutral SVG Text 0.8.1 layout provider and creates no text skin on its default SVG overlay. Asset Manager is required for portrait, lip-sync, continue indicator, voice, and display-sound assets. Async Input and Runtime Expression are required only for condition-based Bubble waits and close policies; a timeout-only close policy needs neither.
11
+ The complete input-wait example uses five extensions. Add Temporary Variables from TurboWarp's extension library, then load the custom extensions needed by the selected features with **Run without sandbox** enabled. Bubble bundles the host-neutral SVG Text 0.10.0 layout provider and creates no text skin on its default SVG overlay. Asset Cache is required for portrait, lip-sync, continue indicator, voice, and display-sound assets. Async Input and Runtime Expression are required only for condition-based Bubble waits and close policies; a timeout-only close policy needs neither.
12
12
 
13
13
  | Order | Extension | URL |
14
14
  | ----: | ------------------------ | -------------------------------------------------------------------------------------------------------- |
15
15
  | 1 | Temporary Variables | Add from the TurboWarp extension library |
16
- | 2 | Async Input 0.5.0 | `https://cdn.jsdelivr.net/npm/@kubohiroya/turbowarp-async-input@0.5.0/dist/async-input.js` |
17
- | 3 | Runtime Expression 0.4.0 | `https://cdn.jsdelivr.net/npm/@kubohiroya/turbowarp-runtime-expression@0.4.0/dist/runtime-expression.js` |
18
- | 4 | Asset Manager 0.13.0 | `https://cdn.jsdelivr.net/npm/@kubohiroya/turbowarp-asset-manager@0.13.0/dist/asset-manager.js` |
19
- | 5 | Bubble 0.11.0 | `https://cdn.jsdelivr.net/npm/@kubohiroya/turbowarp-bubble@0.11.0/dist/turbowarp-bubble.js` |
16
+ | 2 | Async Input 0.7.0 | `https://cdn.jsdelivr.net/npm/@kubohiroya/turbowarp-async-input@0.7.0/dist/async-input.js` |
17
+ | 3 | Runtime Expression 0.6.0 | `https://cdn.jsdelivr.net/npm/@kubohiroya/turbowarp-runtime-expression@0.6.0/dist/runtime-expression.js` |
18
+ | 4 | Asset Cache 0.1.0 | `https://cdn.jsdelivr.net/npm/@kubohiroya/turbowarp-asset-cache@0.1.0/dist/asset-cache.js` |
19
+ | 5 | Bubble 0.13.0 | `https://cdn.jsdelivr.net/npm/@kubohiroya/turbowarp-bubble@0.13.0/dist/turbowarp-bubble.js` |
20
20
 
21
- To try a development build, load this repository's `dist/turbowarp-bubble.js` as a local custom extension. Bubble reports an explicit error if the renderer lacks the default SVG overlay APIs, if an image/media feature is used without Asset Manager, or if Async Input or Runtime Expression is missing when it starts a condition-based Bubble wait. The lower-level Composition API can inject another text capability.
21
+ To try a development build, load this repository's `dist/turbowarp-bubble.js` as a local custom extension. Bubble reports an explicit error if the renderer lacks the default SVG overlay APIs, if an image/media feature is used without Asset Cache, or if Async Input or Runtime Expression is missing when it starts a condition-based Bubble wait. The lower-level Composition API can inject another text capability.
22
22
 
23
23
  See also:
24
24
 
25
- - [Asset Manager guide](https://kubohiroya.github.io/turbowarp-asset-manager/)
25
+ - [Asset Cache guide](https://kubohiroya.github.io/turbowarp-asset-cache/)
26
26
  - [Async Input guide](https://kubohiroya.github.io/turbowarp-async-input/)
27
27
  - [Runtime Expression guide](https://kubohiroya.github.io/turbowarp-runtime-expression/)
28
28
  - [SVG Text guide](https://kubohiroya.github.io/turbowarp-svg-text/)
@@ -31,19 +31,19 @@ See also:
31
31
 
32
32
  The following example stores costumes in a hidden asset sprite named `Assets`.
33
33
 
34
- | Costume | Asset Manager name | Contents |
35
- | ----------------- | ------------------ | ---------------------------------------------------------- |
36
- | `HeroFace` | `HeroFace` | Face, hair, and outline, excluding the animated eyes/mouth |
37
- | `HeroEyesOpen` | `HeroEyesOpen` | Transparent overlay containing only the open eyes |
38
- | `HeroEyesClosed` | `HeroEyesClosed` | Transparent overlay containing only the closed eyes |
39
- | `HeroMouthClosed` | `HeroMouthClosed` | Transparent overlay containing only the closed mouth |
40
- | `HeroMouthOpen` | `HeroMouthOpen` | Transparent overlay containing only the open mouth |
41
- | `Next1` | `Next1` | First frame of the continue indicator |
42
- | `Next2` | `Next2` | Second frame of the continue indicator |
34
+ | Costume | Asset Cache name | Contents |
35
+ | ----------------- | ----------------- | ---------------------------------------------------------- |
36
+ | `HeroFace` | `HeroFace` | Face, hair, and outline, excluding the animated eyes/mouth |
37
+ | `HeroEyesOpen` | `HeroEyesOpen` | Transparent overlay containing only the open eyes |
38
+ | `HeroEyesClosed` | `HeroEyesClosed` | Transparent overlay containing only the closed eyes |
39
+ | `HeroMouthClosed` | `HeroMouthClosed` | Transparent overlay containing only the closed mouth |
40
+ | `HeroMouthOpen` | `HeroMouthOpen` | Transparent overlay containing only the open mouth |
41
+ | `Next1` | `Next1` | First frame of the continue indicator |
42
+ | `Next2` | `Next2` | Second frame of the continue indicator |
43
43
 
44
44
  Use the same canvas size and center point for the base, eye, and mouth images. Keep overlay backgrounds transparent; mismatched canvases or centers make the layers drift when composed.
45
45
 
46
- Register each costume with Asset Manager:
46
+ Register each costume with Asset Cache:
47
47
 
48
48
  ```text
49
49
  register resource [costume:Assets:HeroFace] as asset [HeroFace]
@@ -55,11 +55,11 @@ register resource [costume:Assets:Next1] as asset [Next1]
55
55
  register resource [costume:Assets:Next2] as asset [Next2]
56
56
  ```
57
57
 
58
- For a remote image, pass its HTTPS URL as `RESOURCE_ID`. Bubble accepts only assets already registered with Asset Manager whose MIME type is `image/*`.
58
+ For a remote image, pass its HTTPS URL as `RESOURCE_ID`. Bubble accepts only assets already registered with Asset Cache whose MIME type is `image/*`.
59
59
 
60
60
  ## 3. Select a text layout style
61
61
 
62
- Standalone Bubble bundles the SVG Text 0.8.1 layout composition and installs two Bubble styles: `say` owns the speech body and speech tail, while `think` owns the thought body and round trail. A style's body and tail/trail shapes are one visual choice, not separately selected properties. The short `say [MESSAGE]` and `think [MESSAGE]` blocks select the matching style automatically, so the basic path needs neither a style definition nor a style input. Both styles use the reserved text profile `default`, a content-sized body, 14px Helvetica text, right-first placement with a fit-dependent left flip, 330-character block-input limit, and empty-message close behavior. Their 4px SVG stroke is painted before the white fill, hiding the inner half so the visible outline matches TurboWarp's standard bubble. Any other text style name or explicit style-setting block selects the custom profile. Custom text styles are initialized on first use with transparent-background SVG Text defaults. If a project separately loads the stock SVG Text 0.8.1 extension before Bubble, Bubble uses its public `getLayoutCapability()` instead and preserves the named styles defined by SVG Text blocks. An older loaded SVG Text extension without that handoff produces an explicit compatibility error rather than silently replacing the style; select the documented scratch-render fallback only when needed.
62
+ Standalone Bubble bundles the SVG Text 0.10.0 layout composition and installs two Bubble styles: `say` owns the speech body and speech tail, while `think` owns the thought body and round trail. A style's body and tail/trail shapes are one visual choice, not separately selected properties. The short `say [MESSAGE]` and `think [MESSAGE]` blocks select the matching style automatically, so the basic path needs neither a style definition nor a style input. Both styles use the reserved text profile `default`, a content-sized body, 14px Helvetica text, right-first placement with a fit-dependent left flip, 330-character block-input limit, and empty-message close behavior. Their 4px SVG stroke is painted before the white fill, hiding the inner half so the visible outline matches TurboWarp's standard bubble. Any other text style name or explicit style-setting block selects the custom profile. Custom text styles are initialized on first use with transparent-background SVG Text defaults. If a project separately loads the stock SVG Text 0.10.0 extension before Bubble, Bubble uses its public `getLayoutCapability()` instead and preserves the named styles defined by SVG Text blocks. An older loaded SVG Text extension without that handoff produces an explicit compatibility error rather than silently replacing the style; select the documented scratch-render fallback only when needed.
63
63
 
64
64
  ```text
65
65
  define bubble style [hero-dialogue] using text style [default]
@@ -178,7 +178,7 @@ set continue frames [Next1,Next2]
178
178
  every [0.2] seconds for bubble style [hero-dialogue]
179
179
  ```
180
180
 
181
- `ASSETS` is a comma-separated list of Asset Manager names. Surrounding whitespace is removed; commas cannot be part of an asset name.
181
+ `ASSETS` is a comma-separated list of Asset Cache names. Surrounding whitespace is removed; commas cannot be part of an asset name.
182
182
 
183
183
  - Blink and lip-sync animations accept one or more frames. A single frame remains static.
184
184
  - Use two or more continue frames so the loop is visible.
@@ -202,7 +202,7 @@ show [Let's head for the sea!] with bubble style [hero-dialogue]
202
202
  finish [CHARACTER] with condition [input == "pressed"] or timeout after [10] seconds
203
203
  ```
204
204
 
205
- `DYNAMIC` recalculates the Bubble size and placement after each unit. `RESERVED` measures the final text first and reserves that layout while units appear. `set bubble reveal sound` plays a named Asset Manager audio asset per unit, while `set bubble voice` plays full voice audio when the Bubble starts. Text display remains available without audio.
205
+ `DYNAMIC` recalculates the Bubble size and placement after each unit. `RESERVED` measures the final text first and reserves that layout while units appear. `set bubble reveal sound` plays a named Asset Cache audio asset per unit, while `set bubble voice` plays full voice audio when the Bubble starts. Text display remains available without audio.
206
206
 
207
207
  ## 6. Show dialogue and wait for input
208
208
 
@@ -328,7 +328,7 @@ Saved projects using the former `say/think [MESSAGE] with bubble style [STYLE]`
328
328
 
329
329
  | Symptom | Cause and solution |
330
330
  | ------------------------------------ | ------------------------------------------------------------------------------- |
331
- | Asset Manager required error | Load Asset Manager 0.12.x without sandbox before using image/media assets |
331
+ | Asset Cache required error | Load Asset Cache 0.1.0 without sandbox before using image/media assets |
332
332
  | SVG overlay backend error | Use a host with `renderer.addOverlay()` or explicitly select `scratch-render` |
333
333
  | Async Input required error | Load Async Input 0.3.x without sandbox before using the Bubble wait |
334
334
  | Runtime Expression required error | Load Runtime Expression 0.3.x without sandbox before using the Bubble wait |
@@ -353,7 +353,7 @@ Bubble automatically releases its owned timers, overlay DOM, and image leases in
353
353
  - the whole project stops; or
354
354
  - the TurboWarp runtime is disposed.
355
355
 
356
- Assets registered with Asset Manager are not owned by Bubble. To remove an unused registered image from memory, close the Bubble first and then use Asset Manager's `delete asset [NAME] from memory` block.
356
+ Assets registered with Asset Cache are not owned by Bubble. To remove an unused registered image from memory, close the Bubble first and then use Asset Cache's `delete asset [NAME] from memory` block.
357
357
 
358
358
  ## 14. Regenerating the manual assets
359
359
 
package/docs/index.html CHANGED
@@ -74,7 +74,7 @@
74
74
  </blockquote>
75
75
  <p><img src="./assets/block-quick-start.svg" alt="A quick-start block sequence that registers Next1 and Next2 separately, prepares input listeners, then uses Bubble&#39;s integrated wait"></p>
76
76
  <h2 id="requirements">1. Load the required extensions</h2>
77
- <p>The complete input-wait example uses five extensions. Add Temporary Variables from TurboWarp&#39;s extension library, then load the custom extensions needed by the selected features with <strong>Run without sandbox</strong> enabled. Bubble bundles the host-neutral SVG Text 0.8.1 layout provider and creates no text skin on its default SVG overlay. Asset Manager is required for portrait, lip-sync, continue indicator, voice, and display-sound assets. Async Input and Runtime Expression are required only for condition-based Bubble waits and close policies; a timeout-only close policy needs neither.</p>
77
+ <p>The complete input-wait example uses five extensions. Add Temporary Variables from TurboWarp&#39;s extension library, then load the custom extensions needed by the selected features with <strong>Run without sandbox</strong> enabled. Bubble bundles the host-neutral SVG Text 0.10.0 layout provider and creates no text skin on its default SVG overlay. Asset Cache is required for portrait, lip-sync, continue indicator, voice, and display-sound assets. Async Input and Runtime Expression are required only for condition-based Bubble waits and close policies; a timeout-only close policy needs neither.</p>
78
78
  <table>
79
79
  <thead>
80
80
  <tr>
@@ -90,29 +90,29 @@
90
90
  </tr>
91
91
  <tr>
92
92
  <td align="right">2</td>
93
- <td>Async Input 0.5.0</td>
94
- <td><code>https://cdn.jsdelivr.net/npm/@kubohiroya/turbowarp-async-input@0.5.0/dist/async-input.js</code></td>
93
+ <td>Async Input 0.7.0</td>
94
+ <td><code>https://cdn.jsdelivr.net/npm/@kubohiroya/turbowarp-async-input@0.7.0/dist/async-input.js</code></td>
95
95
  </tr>
96
96
  <tr>
97
97
  <td align="right">3</td>
98
- <td>Runtime Expression 0.4.0</td>
99
- <td><code>https://cdn.jsdelivr.net/npm/@kubohiroya/turbowarp-runtime-expression@0.4.0/dist/runtime-expression.js</code></td>
98
+ <td>Runtime Expression 0.6.0</td>
99
+ <td><code>https://cdn.jsdelivr.net/npm/@kubohiroya/turbowarp-runtime-expression@0.6.0/dist/runtime-expression.js</code></td>
100
100
  </tr>
101
101
  <tr>
102
102
  <td align="right">4</td>
103
- <td>Asset Manager 0.13.0</td>
104
- <td><code>https://cdn.jsdelivr.net/npm/@kubohiroya/turbowarp-asset-manager@0.13.0/dist/asset-manager.js</code></td>
103
+ <td>Asset Cache 0.1.0</td>
104
+ <td><code>https://cdn.jsdelivr.net/npm/@kubohiroya/turbowarp-asset-cache@0.1.0/dist/asset-cache.js</code></td>
105
105
  </tr>
106
106
  <tr>
107
107
  <td align="right">5</td>
108
- <td>Bubble 0.11.0</td>
109
- <td><code>https://cdn.jsdelivr.net/npm/@kubohiroya/turbowarp-bubble@0.11.0/dist/turbowarp-bubble.js</code></td>
108
+ <td>Bubble 0.13.0</td>
109
+ <td><code>https://cdn.jsdelivr.net/npm/@kubohiroya/turbowarp-bubble@0.13.0/dist/turbowarp-bubble.js</code></td>
110
110
  </tr>
111
111
  </tbody></table>
112
- <p>To try a development build, load this repository&#39;s <code>dist/turbowarp-bubble.js</code> as a local custom extension. Bubble reports an explicit error if the renderer lacks the default SVG overlay APIs, if an image/media feature is used without Asset Manager, or if Async Input or Runtime Expression is missing when it starts a condition-based Bubble wait. The lower-level Composition API can inject another text capability.</p>
112
+ <p>To try a development build, load this repository&#39;s <code>dist/turbowarp-bubble.js</code> as a local custom extension. Bubble reports an explicit error if the renderer lacks the default SVG overlay APIs, if an image/media feature is used without Asset Cache, or if Async Input or Runtime Expression is missing when it starts a condition-based Bubble wait. The lower-level Composition API can inject another text capability.</p>
113
113
  <p>See also:</p>
114
114
  <ul>
115
- <li><a href="https://kubohiroya.github.io/turbowarp-asset-manager/">Asset Manager guide</a></li>
115
+ <li><a href="https://kubohiroya.github.io/turbowarp-asset-cache/">Asset Cache guide</a></li>
116
116
  <li><a href="https://kubohiroya.github.io/turbowarp-async-input/">Async Input guide</a></li>
117
117
  <li><a href="https://kubohiroya.github.io/turbowarp-runtime-expression/">Runtime Expression guide</a></li>
118
118
  <li><a href="https://kubohiroya.github.io/turbowarp-svg-text/">SVG Text guide</a></li>
@@ -123,7 +123,7 @@
123
123
  <thead>
124
124
  <tr>
125
125
  <th>Costume</th>
126
- <th>Asset Manager name</th>
126
+ <th>Asset Cache name</th>
127
127
  <th>Contents</th>
128
128
  </tr>
129
129
  </thead>
@@ -164,7 +164,7 @@
164
164
  </tr>
165
165
  </tbody></table>
166
166
  <p>Use the same canvas size and center point for the base, eye, and mouth images. Keep overlay backgrounds transparent; mismatched canvases or centers make the layers drift when composed.</p>
167
- <p>Register each costume with Asset Manager:</p>
167
+ <p>Register each costume with Asset Cache:</p>
168
168
  <pre><code class="language-text">register resource [costume:Assets:HeroFace] as asset [HeroFace]
169
169
  register resource [costume:Assets:HeroEyesOpen] as asset [HeroEyesOpen]
170
170
  register resource [costume:Assets:HeroEyesClosed] as asset [HeroEyesClosed]
@@ -173,9 +173,9 @@ register resource [costume:Assets:HeroMouthOpen] as asset [HeroMouthOpen]
173
173
  register resource [costume:Assets:Next1] as asset [Next1]
174
174
  register resource [costume:Assets:Next2] as asset [Next2]
175
175
  </code></pre>
176
- <p>For a remote image, pass its HTTPS URL as <code>RESOURCE_ID</code>. Bubble accepts only assets already registered with Asset Manager whose MIME type is <code>image/*</code>.</p>
176
+ <p>For a remote image, pass its HTTPS URL as <code>RESOURCE_ID</code>. Bubble accepts only assets already registered with Asset Cache whose MIME type is <code>image/*</code>.</p>
177
177
  <h2 id="text-style">3. Select a text layout style</h2>
178
- <p>Standalone Bubble bundles the SVG Text 0.8.1 layout composition and installs two Bubble styles: <code>say</code> owns the speech body and speech tail, while <code>think</code> owns the thought body and round trail. A style&#39;s body and tail/trail shapes are one visual choice, not separately selected properties. The short <code>say [MESSAGE]</code> and <code>think [MESSAGE]</code> blocks select the matching style automatically, so the basic path needs neither a style definition nor a style input. Both styles use the reserved text profile <code>default</code>, a content-sized body, 14px Helvetica text, right-first placement with a fit-dependent left flip, 330-character block-input limit, and empty-message close behavior. Their 4px SVG stroke is painted before the white fill, hiding the inner half so the visible outline matches TurboWarp&#39;s standard bubble. Any other text style name or explicit style-setting block selects the custom profile. Custom text styles are initialized on first use with transparent-background SVG Text defaults. If a project separately loads the stock SVG Text 0.8.1 extension before Bubble, Bubble uses its public <code>getLayoutCapability()</code> instead and preserves the named styles defined by SVG Text blocks. An older loaded SVG Text extension without that handoff produces an explicit compatibility error rather than silently replacing the style; select the documented scratch-render fallback only when needed.</p>
178
+ <p>Standalone Bubble bundles the SVG Text 0.10.0 layout composition and installs two Bubble styles: <code>say</code> owns the speech body and speech tail, while <code>think</code> owns the thought body and round trail. A style&#39;s body and tail/trail shapes are one visual choice, not separately selected properties. The short <code>say [MESSAGE]</code> and <code>think [MESSAGE]</code> blocks select the matching style automatically, so the basic path needs neither a style definition nor a style input. Both styles use the reserved text profile <code>default</code>, a content-sized body, 14px Helvetica text, right-first placement with a fit-dependent left flip, 330-character block-input limit, and empty-message close behavior. Their 4px SVG stroke is painted before the white fill, hiding the inner half so the visible outline matches TurboWarp&#39;s standard bubble. Any other text style name or explicit style-setting block selects the custom profile. Custom text styles are initialized on first use with transparent-background SVG Text defaults. If a project separately loads the stock SVG Text 0.10.0 extension before Bubble, Bubble uses its public <code>getLayoutCapability()</code> instead and preserves the named styles defined by SVG Text blocks. An older loaded SVG Text extension without that handoff produces an explicit compatibility error rather than silently replacing the style; select the documented scratch-render fallback only when needed.</p>
179
179
  <pre><code class="language-text">define bubble style [hero-dialogue] using text style [default]
180
180
  </code></pre>
181
181
  <p>Application hosts that need custom fonts, colors, or alignment can define styles on <code>createSvgTextLayoutComposition()</code> and inject them through <code>createSvgTextOverlayTextCapability()</code>. The custom profile uses the same <code>layoutText()</code> API and does not create an SVG text skin on the default overlay backend. Bubble owns placement, tail, and outer shape.</p>
@@ -264,7 +264,7 @@ set lip-sync frames [HeroMouthClosed,HeroMouthOpen]
264
264
  set continue frames [Next1,Next2]
265
265
  every [0.2] seconds for bubble style [hero-dialogue]
266
266
  </code></pre>
267
- <p><code>ASSETS</code> is a comma-separated list of Asset Manager names. Surrounding whitespace is removed; commas cannot be part of an asset name.</p>
267
+ <p><code>ASSETS</code> is a comma-separated list of Asset Cache names. Surrounding whitespace is removed; commas cannot be part of an asset name.</p>
268
268
  <ul>
269
269
  <li>Blink and lip-sync animations accept one or more frames. A single frame remains static.</li>
270
270
  <li>Use two or more continue frames so the loop is visible.</li>
@@ -284,7 +284,7 @@ set bubble voice [HeroVoice] for bubble style [hero-dialogue]
284
284
  show [Let&#39;s head for the sea!] with bubble style [hero-dialogue]
285
285
  finish [CHARACTER] with condition [input == &quot;pressed&quot;] or timeout after [10] seconds
286
286
  </code></pre>
287
- <p><code>DYNAMIC</code> recalculates the Bubble size and placement after each unit. <code>RESERVED</code> measures the final text first and reserves that layout while units appear. <code>set bubble reveal sound</code> plays a named Asset Manager audio asset per unit, while <code>set bubble voice</code> plays full voice audio when the Bubble starts. Text display remains available without audio.</p>
287
+ <p><code>DYNAMIC</code> recalculates the Bubble size and placement after each unit. <code>RESERVED</code> measures the final text first and reserves that layout while units appear. <code>set bubble reveal sound</code> plays a named Asset Cache audio asset per unit, while <code>set bubble voice</code> plays full voice audio when the Bubble starts. Text display remains available without audio.</p>
288
288
  <h2 id="animation-modes">6. Show dialogue and wait for input</h2>
289
289
  <p><code>say</code> and <code>think</code> show a Bubble immediately, continue to the next block, and begin in <code>talking</code> animation mode.</p>
290
290
  <pre><code class="language-text">set runtime variable [input] to []
@@ -507,8 +507,8 @@ animate bubble shape to [WAVY] speed [1] for [0.5] seconds
507
507
  </tr>
508
508
  </thead>
509
509
  <tbody><tr>
510
- <td>Asset Manager required error</td>
511
- <td>Load Asset Manager 0.12.x without sandbox before using image/media assets</td>
510
+ <td>Asset Cache required error</td>
511
+ <td>Load Asset Cache 0.1.0 without sandbox before using image/media assets</td>
512
512
  </tr>
513
513
  <tr>
514
514
  <td>SVG overlay backend error</td>
@@ -569,7 +569,7 @@ animate bubble shape to [WAVY] speed [1] for [0.5] seconds
569
569
  <li>the whole project stops; or</li>
570
570
  <li>the TurboWarp runtime is disposed.</li>
571
571
  </ul>
572
- <p>Assets registered with Asset Manager are not owned by Bubble. To remove an unused registered image from memory, close the Bubble first and then use Asset Manager&#39;s <code>delete asset [NAME] from memory</code> block.</p>
572
+ <p>Assets registered with Asset Cache are not owned by Bubble. To remove an unused registered image from memory, close the Bubble first and then use Asset Cache&#39;s <code>delete asset [NAME] from memory</code> block.</p>
573
573
  <h2>14. Regenerating the manual assets</h2>
574
574
  <p>The diagrams and GIF are generated from scripts in this repository. GIF generation requires the ImageMagick <code>magick</code> command.</p>
575
575
  <p>The two <code>turbowarp-say-think-*-comparison.png</code> files are real TurboWarp Editor screenshots rather than generated renderer previews. They use the capture conditions documented in section 4 and are not overwritten by <code>docs:render</code>.</p>
@@ -74,7 +74,7 @@
74
74
  </blockquote>
75
75
  <p><img src="../assets/block-quick-start.svg" alt="Next1とNext2を個別登録し、入力listenerを準備してBubble内蔵待機を使うブロック例"></p>
76
76
  <h2 id="requirements">1. 必要な拡張機能</h2>
77
- <p>入力待ちを含む完全な例では5つの拡張機能を使います。TurboWarpの拡張機能ライブラリからTemporary Variablesを追加し、選択した機能に必要なカスタム拡張機能を「サンドボックスなしで実行」を許可して読み込みます。BubbleはSVG Text 0.8.1のhost-neutral layout providerをbundle内に持ち、既定のSVG overlayではskinを作りません。portrait、lip-sync、continue indicator、フルボイス、表示効果音などのメディアアセットにはAsset Managerが必要です。Async InputとRuntime Expressionはconditionを使うBubble待機またはclose policyで必要です。timeoutだけのclose policyにはどちらも不要です。</p>
77
+ <p>入力待ちを含む完全な例では5つの拡張機能を使います。TurboWarpの拡張機能ライブラリからTemporary Variablesを追加し、選択した機能に必要なカスタム拡張機能を「サンドボックスなしで実行」を許可して読み込みます。BubbleはSVG Text 0.10.0のhost-neutral layout providerをbundle内に持ち、既定のSVG overlayではskinを作りません。portrait、lip-sync、continue indicator、フルボイス、表示効果音などのメディアアセットにはAsset Cacheが必要です。Async InputとRuntime Expressionはconditionを使うBubble待機またはclose policyで必要です。timeoutだけのclose policyにはどちらも不要です。</p>
78
78
  <table>
79
79
  <thead>
80
80
  <tr>
@@ -90,29 +90,29 @@
90
90
  </tr>
91
91
  <tr>
92
92
  <td align="right">2</td>
93
- <td>Async Input 0.5.0</td>
94
- <td><code>https://cdn.jsdelivr.net/npm/@kubohiroya/turbowarp-async-input@0.5.0/dist/async-input.js</code></td>
93
+ <td>Async Input 0.7.0</td>
94
+ <td><code>https://cdn.jsdelivr.net/npm/@kubohiroya/turbowarp-async-input@0.7.0/dist/async-input.js</code></td>
95
95
  </tr>
96
96
  <tr>
97
97
  <td align="right">3</td>
98
- <td>Runtime Expression 0.4.0</td>
99
- <td><code>https://cdn.jsdelivr.net/npm/@kubohiroya/turbowarp-runtime-expression@0.4.0/dist/runtime-expression.js</code></td>
98
+ <td>Runtime Expression 0.6.0</td>
99
+ <td><code>https://cdn.jsdelivr.net/npm/@kubohiroya/turbowarp-runtime-expression@0.6.0/dist/runtime-expression.js</code></td>
100
100
  </tr>
101
101
  <tr>
102
102
  <td align="right">4</td>
103
- <td>Asset Manager 0.13.0</td>
104
- <td><code>https://cdn.jsdelivr.net/npm/@kubohiroya/turbowarp-asset-manager@0.13.0/dist/asset-manager.js</code></td>
103
+ <td>Asset Cache 0.1.0</td>
104
+ <td><code>https://cdn.jsdelivr.net/npm/@kubohiroya/turbowarp-asset-cache@0.1.0/dist/asset-cache.js</code></td>
105
105
  </tr>
106
106
  <tr>
107
107
  <td align="right">5</td>
108
- <td>Bubble 0.11.0</td>
109
- <td><code>https://cdn.jsdelivr.net/npm/@kubohiroya/turbowarp-bubble@0.11.0/dist/turbowarp-bubble.js</code></td>
108
+ <td>Bubble 0.13.0</td>
109
+ <td><code>https://cdn.jsdelivr.net/npm/@kubohiroya/turbowarp-bubble@0.13.0/dist/turbowarp-bubble.js</code></td>
110
110
  </tr>
111
111
  </tbody></table>
112
- <p>開発中のBubbleを試す場合は、このリポジトリの<code>dist/turbowarp-bubble.js</code>をローカルカスタム拡張機能として読み込みます。既定SVG overlayに必要なrenderer APIがない場合、画像・メディア機能の使用時にAsset Managerがない場合、condition待機の開始時にAsync InputかRuntime Expressionがない場合は、Bubbleが明示的なエラーを返します。低レベルComposition APIでは別のtext capabilityを注入できます。</p>
112
+ <p>開発中のBubbleを試す場合は、このリポジトリの<code>dist/turbowarp-bubble.js</code>をローカルカスタム拡張機能として読み込みます。既定SVG overlayに必要なrenderer APIがない場合、画像・メディア機能の使用時にAsset Cacheがない場合、condition待機の開始時にAsync InputかRuntime Expressionがない場合は、Bubbleが明示的なエラーを返します。低レベルComposition APIでは別のtext capabilityを注入できます。</p>
113
113
  <p>参考:</p>
114
114
  <ul>
115
- <li><a href="https://kubohiroya.github.io/turbowarp-asset-manager/ja/">Asset Manager 日本語ガイド</a></li>
115
+ <li><a href="https://kubohiroya.github.io/turbowarp-asset-cache/ja/">Asset Cache 日本語ガイド</a></li>
116
116
  <li><a href="https://kubohiroya.github.io/turbowarp-async-input/ja/">Async Input 日本語ガイド</a></li>
117
117
  <li><a href="https://kubohiroya.github.io/turbowarp-runtime-expression/ja/">Runtime Expression 日本語ガイド</a></li>
118
118
  <li><a href="https://kubohiroya.github.io/turbowarp-svg-text/ja/">SVG Text 日本語ガイド</a></li>
@@ -123,7 +123,7 @@
123
123
  <thead>
124
124
  <tr>
125
125
  <th>costume</th>
126
- <th>Asset Managerへ登録する名前</th>
126
+ <th>Asset Cacheへ登録する名前</th>
127
127
  <th>内容</th>
128
128
  </tr>
129
129
  </thead>
@@ -164,7 +164,7 @@
164
164
  </tr>
165
165
  </tbody></table>
166
166
  <p>ベース、目、口の画像は同じcanvasサイズと同じ中心位置で作ります。差分画像の背景は透明にしてください。位置やcanvasサイズが異なると、レイヤーを重ねたときに目や口がずれます。</p>
167
- <p>Asset Managerのブロックで各costumeを登録します。</p>
167
+ <p>Asset Cacheのブロックで各costumeを登録します。</p>
168
168
  <pre><code class="language-text">register resource [costume:Assets:HeroFace] as asset [HeroFace]
169
169
  register resource [costume:Assets:HeroEyesOpen] as asset [HeroEyesOpen]
170
170
  register resource [costume:Assets:HeroEyesClosed] as asset [HeroEyesClosed]
@@ -173,9 +173,9 @@ register resource [costume:Assets:HeroMouthOpen] as asset [HeroMouthOpen]
173
173
  register resource [costume:Assets:Next1] as asset [Next1]
174
174
  register resource [costume:Assets:Next2] as asset [Next2]
175
175
  </code></pre>
176
- <p>URL画像を使う場合は、<code>RESOURCE_ID</code>へHTTPS URLを指定します。Bubbleに設定できるのは、Asset Managerへ登録済みでMIME typeが<code>image/*</code>のアセットだけです。</p>
176
+ <p>URL画像を使う場合は、<code>RESOURCE_ID</code>へHTTPS URLを指定します。Bubbleに設定できるのは、Asset Cacheへ登録済みでMIME typeが<code>image/*</code>のアセットだけです。</p>
177
177
  <h2 id="text-style">3. 文字layout styleを選ぶ</h2>
178
- <p>standalone BubbleはSVG Text 0.8.1のlayout compositionを内包し、2つのBubble styleを組み込みます。<code>say</code>はspeech本体とspeech tail、<code>think</code>はthought本体とround trailを持ち、本体とtail/trailの形は別項目ではなく1つのvisual styleとして選びます。短い<code>say [MESSAGE]</code>/<code>think [MESSAGE]</code>ブロックが対応styleを自動選択するため、基本経路にはstyle定義もstyle入力も不要です。どちらも予約text profile <code>default</code>、内容に追従するサイズ、14px Helvetica、右側優先・収まりに応じた左反転、block入力の330文字上限、空文字でのcloseを使います。4pxのSVG strokeを白いfillより先に描き、内側半分を隠すことで、見かけの輪郭をTurboWarp標準と同じ細さにします。それ以外のtext style名やstyle設定ブロックを使うとcustom profileになります。custom text styleは初回参照時に背景透明のSVG Text既定styleとして初期化されます。stock SVG Text 0.8.1をBubbleより先に別拡張として読み込んだprojectでは、Bubbleが公開<code>getLayoutCapability()</code>を使い、SVG Text blockで定義したnamed styleを維持します。handoffのない古いSVG Textがロード済みならstyleを黙って置換せず互換errorを返し、必要な場合だけ文書化済みscratch-render fallbackを選択します。</p>
178
+ <p>standalone BubbleはSVG Text 0.10.0のlayout compositionを内包し、2つのBubble styleを組み込みます。<code>say</code>はspeech本体とspeech tail、<code>think</code>はthought本体とround trailを持ち、本体とtail/trailの形は別項目ではなく1つのvisual styleとして選びます。短い<code>say [MESSAGE]</code>/<code>think [MESSAGE]</code>ブロックが対応styleを自動選択するため、基本経路にはstyle定義もstyle入力も不要です。どちらも予約text profile <code>default</code>、内容に追従するサイズ、14px Helvetica、右側優先・収まりに応じた左反転、block入力の330文字上限、空文字でのcloseを使います。4pxのSVG strokeを白いfillより先に描き、内側半分を隠すことで、見かけの輪郭をTurboWarp標準と同じ細さにします。それ以外のtext style名やstyle設定ブロックを使うとcustom profileになります。custom text styleは初回参照時に背景透明のSVG Text既定styleとして初期化されます。stock SVG Text 0.10.0をBubbleより先に別拡張として読み込んだprojectでは、Bubbleが公開<code>getLayoutCapability()</code>を使い、SVG Text blockで定義したnamed styleを維持します。handoffのない古いSVG Textがロード済みならstyleを黙って置換せず互換errorを返し、必要な場合だけ文書化済みscratch-render fallbackを選択します。</p>
179
179
  <pre><code class="language-text">define bubble style [hero-dialogue] using text style [default]
180
180
  </code></pre>
181
181
  <p>独自のfont、色、alignmentを使うアプリhostは、<code>createSvgTextLayoutComposition()</code>へstyleを定義し、<code>createSvgTextOverlayTextCapability()</code>でBubbleへ注入します。custom profileは同じ<code>layoutText()</code>を使い、既定overlay backendではSVG文字skinを生成しません。Bubbleの配置、tail、吹き出し外形はBubble側が担当します。</p>
@@ -264,7 +264,7 @@ set lip-sync frames [HeroMouthClosed,HeroMouthOpen]
264
264
  set continue frames [Next1,Next2]
265
265
  every [0.2] seconds for bubble style [hero-dialogue]
266
266
  </code></pre>
267
- <p><code>ASSETS</code>はカンマ区切りのAsset Managerアセット名です。名前の前後の空白は除去されます。アセット名自体にカンマは使用できません。</p>
267
+ <p><code>ASSETS</code>はカンマ区切りのAsset Cacheアセット名です。名前の前後の空白は除去されます。アセット名自体にカンマは使用できません。</p>
268
268
  <ul>
269
269
  <li>目パチと口パクは1枚以上指定できます。1枚だけなら表示は固定されます。</li>
270
270
  <li>「次へ」はループが分かるよう2枚以上必要です。</li>
@@ -284,7 +284,7 @@ set bubble voice [HeroVoice] for bubble style [hero-dialogue]
284
284
  show [海へ出発!] with bubble style [hero-dialogue]
285
285
  finish [CHARACTER] with condition [input == &quot;pressed&quot;] or timeout after [10] seconds
286
286
  </code></pre>
287
- <p><code>DYNAMIC</code>は表示単位ごとに吹き出しの大きさと配置を再計算し、<code>RESERVED</code>は最終的な文字量を先に計測して表示中の外形を予約します。<code>set bubble reveal sound</code>は単位ごと、<code>set bubble voice</code>は表示開始時にAsset Managerの名前付き音声を再生します。音声がなくても文字表示は利用できます。</p>
287
+ <p><code>DYNAMIC</code>は表示単位ごとに吹き出しの大きさと配置を再計算し、<code>RESERVED</code>は最終的な文字量を先に計測して表示中の外形を予約します。<code>set bubble reveal sound</code>は単位ごと、<code>set bubble voice</code>は表示開始時にAsset Cacheの名前付き音声を再生します。音声がなくても文字表示は利用できます。</p>
288
288
  <h2 id="animation-modes">6. セリフを表示して入力を待つ</h2>
289
289
  <p><code>say</code>または<code>think</code>はBubbleを表示するとすぐ次のブロックへ進み、初期animation modeは<code>talking</code>になります。</p>
290
290
  <pre><code class="language-text">set runtime variable [input] to []
@@ -507,8 +507,8 @@ animate bubble shape to [WAVY] speed [1] for [0.5] seconds
507
507
  </tr>
508
508
  </thead>
509
509
  <tbody><tr>
510
- <td>Asset Managerを要求するエラー</td>
511
- <td>画像・メディアアセットを使う前にAsset Manager 0.12.xを読み込む</td>
510
+ <td>Asset Cacheを要求するエラー</td>
511
+ <td>画像・メディアアセットを使う前にAsset Cache 0.1.0を読み込む</td>
512
512
  </tr>
513
513
  <tr>
514
514
  <td>SVG overlay backendのエラー</td>
@@ -569,7 +569,7 @@ animate bubble shape to [WAVY] speed [1] for [0.5] seconds
569
569
  <li>projectの全停止</li>
570
570
  <li>TurboWarp runtimeの破棄</li>
571
571
  </ul>
572
- <p>Asset Managerへ登録したアセット自体はBubbleの所有物ではありません。不要になった登録画像をメモリから削除する場合は、Bubbleを閉じた後にAsset Managerの<code>delete asset [NAME] from memory</code>を使います。</p>
572
+ <p>Asset Cacheへ登録したアセット自体はBubbleの所有物ではありません。不要になった登録画像をメモリから削除する場合は、Bubbleを閉じた後にAsset Cacheの<code>delete asset [NAME] from memory</code>を使います。</p>
573
573
  <h2>14. マニュアル画像の再生成</h2>
574
574
  <p>図とGIFはリポジトリ内のスクリプトから再生成できます。GIF生成にはImageMagickの<code>magick</code>コマンドが必要です。</p>
575
575
  <p>2つの<code>turbowarp-say-think-*-comparison.png</code>はrenderer previewから生成した図ではなく、TurboWarp Editorの実画面です。第4章に記載した撮影条件を使い、<code>docs:render</code>では上書きしません。</p>
@@ -0,0 +1,18 @@
1
+ # TurboWarp Bubble 0.13.0
2
+
3
+ Bubble 0.13.0 replaces the deprecated optional
4
+ `@kubohiroya/turbowarp-asset-manager` peer with
5
+ `@kubohiroya/turbowarp-asset-cache@0.1.0`. The standalone adapter first resolves
6
+ `runtime.ext_kubohiroyaassetcache`; the legacy `ext_kubohiroyaassetmanager` lookup remains only as
7
+ a temporary runtime fallback for already-published projects.
8
+
9
+ ## Migration
10
+
11
+ - Install Asset Cache 0.1.0 instead of Asset Manager.
12
+ - Replace the standalone extension ID `kubohiroyaassetmanager` with `kubohiroyaassetcache`.
13
+ - Composition hosts should inject Asset Cache's public DOM image capability as before.
14
+
15
+ ## Rollback
16
+
17
+ Pin Bubble 0.12.0 and Asset Manager to the versions recorded by the existing project lockfile. Do
18
+ not rewrite already-published SB3 artifacts during rollback.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@kubohiroya/turbowarp-bubble",
3
- "version": "0.11.0",
3
+ "version": "0.13.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",
@@ -49,6 +49,9 @@
49
49
  "registry": "https://registry.npmjs.org/"
50
50
  },
51
51
  "packageManager": "pnpm@11.18.0",
52
+ "engines": {
53
+ "node": ">=22.18.0"
54
+ },
52
55
  "scripts": {
53
56
  "typecheck": "tsc --noEmit",
54
57
  "build": "pnpm run build:extension && pnpm run build:composition && pnpm run build:reveal && pnpm run build:turbowarp-adapter && pnpm run build:types",
@@ -61,21 +64,21 @@
61
64
  "lint": "eslint src tests scripts vite.config.ts vite.composition.config.ts vite.reveal.config.ts vite.turbowarp-adapter.config.ts eslint.config.mjs",
62
65
  "format": "prettier --check .",
63
66
  "format:write": "prettier --write .",
64
- "docs:render": "node scripts/render-block-manual-assets.mjs && pnpm run docs:pages",
65
- "docs:pages": "node scripts/render-pages.mjs",
66
- "docs:pages:check": "node scripts/render-pages.mjs --check",
67
- "docs:check": "node scripts/check-block-manual.mjs && pnpm run docs:pages:check",
68
- "benchmark:render-backends": "pnpm run build && node --expose-gc scripts/benchmark-render-backends.mjs",
67
+ "docs:render": "node scripts/render-block-manual-assets.ts && pnpm run docs:pages",
68
+ "docs:pages": "node scripts/render-pages.ts",
69
+ "docs:pages:check": "node scripts/render-pages.ts --check",
70
+ "docs:check": "node scripts/check-block-manual.ts && pnpm run docs:pages:check",
71
+ "benchmark:render-backends": "pnpm run build && node --expose-gc scripts/benchmark-render-backends.ts",
69
72
  "test": "vitest run",
70
- "check:dist": "pnpm run build && node scripts/check-dist.mjs",
71
- "repo:check": "node scripts/check-repo.mjs",
73
+ "check:dist": "pnpm run build && node scripts/check-dist.ts",
74
+ "repo:check": "node scripts/check-repo.ts",
72
75
  "pack:check": "npm pack --dry-run --ignore-scripts",
73
76
  "release:check": "pnpm publish --dry-run --access public --no-git-checks",
74
77
  "check": "pnpm run typecheck && pnpm run lint && pnpm run format && pnpm run test && pnpm run docs:check && pnpm run check:dist && pnpm run types:composition:check && pnpm run repo:check && pnpm run pack:check",
75
78
  "prepack": "pnpm run check"
76
79
  },
77
80
  "peerDependencies": {
78
- "@kubohiroya/turbowarp-asset-manager": ">=0.7.0 <1",
81
+ "@kubohiroya/turbowarp-asset-cache": ">=0.1.0 <1",
79
82
  "@kubohiroya/turbowarp-async-input": ">=0.3.0 <1",
80
83
  "@kubohiroya/turbowarp-runtime-expression": ">=0.3.0 <1"
81
84
  },
@@ -83,7 +86,7 @@
83
86
  "@kubohiroya/turbowarp-async-input": {
84
87
  "optional": true
85
88
  },
86
- "@kubohiroya/turbowarp-asset-manager": {
89
+ "@kubohiroya/turbowarp-asset-cache": {
87
90
  "optional": true
88
91
  },
89
92
  "@kubohiroya/turbowarp-runtime-expression": {
@@ -92,10 +95,10 @@
92
95
  },
93
96
  "devDependencies": {
94
97
  "@eslint/js": "^10.0.1",
95
- "@kubohiroya/turbowarp-asset-manager": "0.13.0",
96
- "@kubohiroya/turbowarp-async-input": "0.5.0",
97
- "@kubohiroya/turbowarp-runtime-expression": "0.4.0",
98
- "@kubohiroya/vite-plugin-turbowarp-extension": "0.1.1",
98
+ "@kubohiroya/turbowarp-asset-cache": "0.1.0",
99
+ "@kubohiroya/turbowarp-async-input": "0.7.0",
100
+ "@kubohiroya/turbowarp-runtime-expression": "0.6.0",
101
+ "@kubohiroya/vite-plugin-turbowarp-extension": "0.4.0",
99
102
  "@types/node": "^26.1.2",
100
103
  "eslint": "^10.8.0",
101
104
  "happy-dom": "20.0.8",
@@ -120,6 +123,6 @@
120
123
  ],
121
124
  "dependencies": {
122
125
  "@cto.af/linebreak": "4.0.3",
123
- "@kubohiroya/turbowarp-svg-text": "0.8.1"
126
+ "@kubohiroya/turbowarp-svg-text": "0.10.0"
124
127
  }
125
128
  }