akari-video 0.1.38 → 0.1.40

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akari-video",
-  "version": "0.1.38",
+  "version": "0.1.40",
   "description": "AKARI Video launcher CLI — start an AI-edited video project from any directory: scaffold, connection check, then hand over to Claude Code (or opencode). AKARI Video を opencode や Claude Code で、どのディレクトリからでも始めるための `akari` ランチャー CLI。接続確認（doctor）→ 未セットアップならプロジェクト雛形を作成 → AI エージェントを起動する。外部 npm 依存ゼロ（Node.js 組み込みモジュールのみ）。",
   "type": "module",
   "bin": {

package/vendor/docs/contract-2026-08-28-gpu-export-v0.md

@@ -123,11 +123,16 @@ cuts と layers が同時に空のフレームは、出力解像度の黒 1 枚
 スプライト合成は通常どおりこの黒い frame-engine canvas の上へ重ねる。
 
 3D は engine の時計から得た local seconds を `threeRuntime.render(container, t)` へ直接渡して駆動する。
-GPU 出口は overlay sheet の `__akariSeek` を使用しない。毎コマの DOM animation 同期、全 container の
-visibility 更新、video seek 待ちを 3D canvas の texture 更新へ持ち込まないためである。sheet の
+GPU 出口は overlay sheet の `__akariSeek` を使用しない。毎コマの DOM animation 同期と全 container の
+visibility 更新を 3D canvas の texture 更新へ持ち込まないためである。sheet の
 `__akariReady` は起動時に 1 回だけ待ち、各 scene が ready でない場合は overlay id と状態を示して
 fail-closed にする。active 区間は最終 compositor の draw へ積むかどうかで決める。
 
+**2026-09-04 改訂（issue #53）**: video seek 待ちだけは例外とし、sheet が公開する `__akariSeekVideos(seconds)`
+（`__akariSeek` から切り出した video 部分・OSR と同一実装）を毎コマ、3D 描画の前に呼ぶ。3D 断片の動画テクスチャは
+`<video>` の提示フレームから上がるため、シーク → 提示確定 → 3D 描画 の順序が必要で（`3d.md`）、呼ばないと
+GPU 経路の動画テクスチャは起動時の 0 秒の絵に固定される。シートに `<video>` が無ければ呼ばない。
+
 ## 4. 読み戻しゼロ
 
 製品実行経路は GPU frame surface を CPU へ読む API を使用しない。静的監査は
@@ -187,6 +192,26 @@ software MP4 SHA はエンコーダが決定論的な場合だけ必須とし、
 GPU と OSR の decode 比較は、engine-only 区間の per-frame MAD 1.0 以下、字幕 cue の代表 5 時刻の
 下半分 MAD 1.0 以下、3D 区間 MAD 1.0 以下を固定閾値とする。
 
+**2026-09-04 追加（issue #53）— 2 経路で同じでなければならない 4 点**:
+
+1. **overlay へ渡す時刻は `frameNumber / fps`**。µs へ丸めてはならない。overlay の `start` は必ず
+   `atFrames / fps` なので、丸めると比較が 1 ulp で反転し、カット境界の 1 コマだけ絵が食い違う。
+   この `seconds` は時間窓判定・CSS アニメ位相・item keyframes のフレーム番号すべてに流れる。
+2. **時間窓の外の container も毎コマ pause して `currentTime` を書く**。飛ばすと窓の外の断片の CSS アニメが
+   壁時計（書き出しは分単位）で走り切り、`animation-fill-mode: both/forwards` の最終姿勢に張り付いたまま
+   窓へ入ってくる = 同じ時刻でも直前に何を撮ったかで絵が変わる。OSR の `__akariSyncAnimations` は
+   active 判定を持たない。
+3. **DOM ステージのルートに `data-no-timeline`**。断片の規約は
+   `[data-akari-active] .x, [data-no-timeline] .x { animation: … }` の 2 アームで、OSR のシートは `#stage` に
+   これを持つ。GPU 側に無いと no-timeline アームだけで宣言した断片が GPU でのみ動かない。
+4. **静的スプライトは overlay の `transform` を落とさない**。`.akari-sprite-root` に OSR の
+   `.akari-overlay-container` と同じ `translate/scale/rotate` + `transform-origin: center` を宣言する
+   （`role: "background"` は両経路とも恒等固定）。
+
+あわせて、manifest 生成時に overlay の `start` / `duration` が有限数でなければ fail-closed とする。
+既定値（`?? 0` / `?? duration`）を置くと、欠けたときに「OSR は絶対に出さない・GPU は全尺出す」という
+最悪の非対称になる（OSR は `formatNumber(undefined)` が `"NaN"` を書き、`seconds >= NaN` が常に偽になる）。
+
 ## 7. receipt
 
 `.akari/render.json` は `provenance.engine = "gpu"` と GPU receipt を持つ。GPU receipt は少なくとも

package/vendor/docs/contract-2026-08-28-osr-export-v0.md

@@ -117,6 +117,17 @@ ffprobe timeoutは `max(120000, frames × 100)` msとする。尺、フレーム
 - `AKARI_OSR_MEMORY_WARN_MIB` / `AKARI_OSR_MEMORY_HARD_STOP_MIB`で正の整数MiBへ上書きでき（絶対値・スケールも下限も上限も受けない）、
   適用値はwarning < hard stopを必須とする。hard stop だけを上書きし既定 warning がそれ以上になるときは warning を hard stop の 75% に追従させる。
   同じ変数を GPU 直結出口（gpu-export）も読む。
+- 書き出しは厳密に前方順で過去フレームを読み直さないため、**評価 plan から外れたカットのデコーダセッションは解放する**
+  （`StreamReaper`。frame-engine が `plan.base` / `plan.layers` の `streamId` を集め、最後に使ったフレームから 1 秒ぶんの
+  猶予を過ぎたものを `LookaheadFrameSource.releaseStream` で落とす）。解放しないとカット本数ぶんのセッションが最後まで
+  積み上がり、RSS が単調に伸びて長尺ほど後ろで hard stop に当たる（2026-09-04 追加・issue #52。
+  244 秒 / 7,320 コマの実機報告で 98% 地点・RSS 4.01 GB）。トランジション中の送出カットは plan に載るので残る。
+- receipt / run.json の `memory.decoderSessions` に生存セッション数（`live`）と累計解放数（`released`）を記録する。
+  RSS はセッション数に比例するため、ランプの原因を後から突き合わせられるようにする（同・issue #52。
+  #28 の時点で比例は分かっていたが記録が無く、再発時にまた手探りになった）。
+- hard stop に当たった GPU 直結出口の失敗は reasonCode `memory-hard-stop` とし、`--engine auto` のときは OSR で
+  走り直して完走させる（`FALLBACK_REASONS`。同・issue #52。それまでは成果物ゼロで終わり、前版で出せていたものが
+  出せない退行になっていた）。`--engine gpu` 明示は従来どおり fail-closed。
 - 並列予算1 worker = 1 GiBはGPU前提の値である。v0のworker数は1。
 - 10秒ごとにRSSを記録し、ウィンドウ破棄後も採る。
 - 固定Nコマごとのページ再生成は行わない。再生成を許すのはページ境界、renderer crash、watchdog回復時だけである。

package/vendor/packages/akari-launcher/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akari-video",
-  "version": "0.1.38",
+  "version": "0.1.40",
   "description": "AKARI Video launcher CLI — start an AI-edited video project from any directory: scaffold, connection check, then hand over to Claude Code (or opencode). AKARI Video を opencode や Claude Code で、どのディレクトリからでも始めるための `akari` ランチャー CLI。接続確認（doctor）→ 未セットアップならプロジェクト雛形を作成 → AI エージェントを起動する。外部 npm 依存ゼロ（Node.js 組み込みモジュールのみ）。 [akari-video npm vendor: bin/akari.mjs is reference-only. These CLI entrypoints are not included in the akari-video npm package. Use `akari doctor --json` and run the path reported in `render_cut.path`. Full installations provide it in a monorepo checkout, ~/.akari/app, /Applications/AKARI Video.app/Contents/Resources/packages, or %LOCALAPPDATA%\\Programs\\@akari-videoshell\\resources\\packages.]",
   "type": "module",
   "files": [

package/vendor/packages/edit-lint/src/edit-lint.mjs

@@ -2339,6 +2339,25 @@ async function validateOverlays(overlays, timeline, findings, paths) {
         path: relativePath(paths.projectRoot, htmlPath),
       });
     }
+    // テキスト分割断片の CSS animation は [data-akari-active] ゲートの中で宣言する
+    // （skills/overlay-authoring/telop.md「テキスト分割と stagger 規約」）。
+    // getAnimations() のコストはドキュメント全体の animation 総数に比例するため、
+    // ゲート無しの断片が 1 つでも混ざると全体の tick が落ちる。分割はその危険を
+    // 分割数ぶんに増幅する（実測: 1,200 断片 × 8 分割 = 9,600 本で 221ms/tick。
+    // akari-video-internal contract-2026-08-15-telop-motion-grammar-v0 §6）。
+    if (/\bdata-akari-split\s*=/.test(html) && /(^|[^-\w])animation\s*:/.test(html)) {
+      const gated = /\[data-akari-active\][^{}]*\.[^{}]*\{[^{}]*animation\s*:/.test(html);
+      if (!gated) {
+        addFinding(findings, {
+          severity: "error",
+          check: "overlays.split-animation-gate",
+          message:
+            "text-split fragment must declare animations under a [data-akari-active] selector",
+          path: relativePath(paths.projectRoot, htmlPath),
+        });
+      }
+    }
+
     for (const [attribute, expected] of [
       ["data-start", overlay.start],
       ["data-duration", overlay.duration],

package/vendor/packages/edit-store/lib/caption-store.js

@@ -296,7 +296,10 @@ function updateCaptionStylePresetInSource(source, captionIds, presetId) {
             changed++;
             continue;
         }
-        if (hasPreset && record.style_preset === presetId)
+        const shadowed = shadowedPresetStyleKeys(presetId, record.text_style);
+        // 同じテンプレの再適用でも、そのテンプレを覆い隠している字幕個別の指定が残っていれば
+        // 掃除する仕事が残っている（「変更はありません」で終わらせない）。
+        if (hasPreset && record.style_preset === presetId && shadowed.length === 0)
             continue;
         let nextElement;
         if (hasPreset) {
@@ -317,11 +320,46 @@ function updateCaptionStylePresetInSource(source, captionIds, presetId) {
                     + element.text.slice(textStyle.start);
             }
         }
+        nextElement = pruneShadowedTextStyle(nextElement, shadowed, captionId);
         output = replaceElement(output, array.openIndex + 1, element, nextElement);
         changed++;
     }
     return { source: output, changed };
 }
+/**
+ * そのテンプレが決めるツマミのうち、字幕個別の text_style が上書きしてしまっているキーを挙げる。
+ *
+ * 合成規則は `{ ...presetStyle, ...text_style }`（caption-style-preset.ts）で **字幕側が強い**。
+ * そのため text_style に既定値が丸ごと書かれていると、テンプレを当てても見た目が変わらない
+ * （オーナー報告 2026-09-04:「ニュース帯だけ効く」= ニュース風の background だけが text_style に
+ *  無いツマミだった）。テンプレを選ぶ操作は「このツマミはテンプレに任せる」という意思表示なので、
+ * 適用時に該当キーを落としてテンプレを表に出す。テンプレが決めないツマミ（ドラッグした position /
+ * zone / max_characters など）は字幕個別の指定として残す。
+ */
+function shadowedPresetStyleKeys(presetId, textStyle) {
+    const preset = Object.prototype.hasOwnProperty.call(textstyle_catalog_1.TEXTSTYLE_CATALOG, presetId)
+        ? textstyle_catalog_1.TEXTSTYLE_CATALOG[presetId] : undefined;
+    if (!preset || textStyle === null || typeof textStyle !== 'object' || Array.isArray(textStyle)) {
+        return [];
+    }
+    const style = textStyle;
+    return Object.keys(preset.style)
+        .filter(key => Object.prototype.hasOwnProperty.call(style, key));
+}
+/** text_style から指定キーを取り除く。空になったら text_style ごと落とす。 */
+function pruneShadowedTextStyle(element, keys, captionId) {
+    if (keys.length === 0) {
+        return element;
+    }
+    const located = locateTopLevelObjectProperty(element, 'text_style', `字幕 ${captionId}`);
+    let textStyle = located.text;
+    for (const key of keys) {
+        textStyle = removeObjectProperty(textStyle, key);
+    }
+    return Object.keys(JSON.parse(textStyle)).length === 0
+        ? removeObjectProperty(element, 'text_style')
+        : element.slice(0, located.start) + textStyle + element.slice(located.end);
+}
 function insertCaptionLine(source, caption) {
     const parsed = parseCaptions(source);
     if (!normalizeCaption(caption)) {

package/vendor/packages/overlay-runtime/README.md

@@ -53,8 +53,12 @@ Three.js + glTF シーンを決定的な時刻で描画し（`three-runtime.js`
    自動でこの順に埋め込む — 同じ順序をホストの `<script>` タグでも守ること）。ランタイム読込後、
    `font` 省略を許すホストは mount より前に
    `window.akari.threeRuntime.configure({ defaultFontUrl })` を 1 回呼ぶ
-4. `src/interaction.css` と `src/minimap.css` を `<link>` する
-5. edit.json ロード後、`window.akari.runtime.mount(summary)` を呼ぶ
+4. テキスト分割断片（`data-akari-split`）を扱うホストは、`src/interaction.js` より前に
+   `src/vendor/budoux-ja-bundle.js` → `src/text-split.js` の順で読み込む。
+   未読込でも他機能は動くが、日本語の文節分割が精度の落ちる近似になり
+   （実測 85% → 65%）、編集時の畳み／再分割も働かない
+5. `src/motion-vocab.css`（イージング語彙 + 対象別既定尺の単一定義。断片の `var(--ease-*)` / `var(--anim-duration-*)` の解決先）と `src/interaction.css`・`src/minimap.css` を `<link>` する
+6. edit.json ロード後、`window.akari.runtime.mount(summary)` を呼ぶ
    （`summary` = `EditSummary`。下記参照）。以降はタイムライン更新のたびに
    `window.akari.runtime.tick(t, playing)` を呼ぶ
 
@@ -238,11 +242,15 @@ src/
   vendor/opentype.js-LICENSE.txt        opentype.js の MIT License
   vendor/matter-js-LICENSE.txt          matter-js の MIT License
   vendor/poly-decomp-LICENSE.txt        poly-decomp の MIT License
+  vendor/budoux-ja-bundle.js  BudouX（日本語の表示単位分割）の単一 IIFE
+  vendor/budoux-LICENSE.txt   BudouX の Apache License 2.0
+  text-split.js        data-akari-split の分割 / 畳み / 再分割（v0.5.0〜）
   three-runtime.js     宣言型 3D scene の load / setTime / render / dispose
   viewport-units.js    断片 CSS の vw/vh 系単位をステージ（出力サイズ）基準へ書き換え
   overlay-runtime.js   DOM mount/tick と 3D 可視ライフサイクル
   interaction.js       legacy ui/interaction.js を無改変移送
   interaction.css       legacy ui/interaction.css を無改変移送
+  motion-vocab.css      イージング語彙 + 対象別既定尺（正典。skills/overlay-authoring/motion.md 参照）
   minimap.js            legacy ui/minimap.js を無改変移送
   minimap.css           legacy ui/style.css 206〜234 行（#minimap ブロック）を抽出
 docs/

package/vendor/packages/overlay-runtime/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@akari-video/overlay-runtime",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "private": true,
   "description": "Shell-agnostic overlay DOM runtime: mount/tick of edit.json overlays (#overlay-stage), pointer-driven select/drag/resize/edit interaction layer, and zoom minimap. Host-agnostic — see README.md for the window.akari.* adapter contract a hosting shell must provide.",
   "main": "src/overlay-runtime.js",
@@ -11,7 +11,7 @@
     "README.md"
   ],
   "scripts": {
-    "check": "node --check src/parts.mjs && node --check src/vendor/three-bundle.js && node --check src/vendor/vendor-3d-text-bundle.js && node --check src/three-runtime.js && node --check src/slot-params.js && node --check src/video-fx.js && node --check src/viewport-units.js && node --check src/overlay-runtime.js && node --check src/interaction.js && node --check src/minimap.js",
+    "check": "node --check src/parts.mjs && node --check src/vendor/three-bundle.js && node --check src/vendor/vendor-3d-text-bundle.js && node --check src/three-runtime.js && node --check src/slot-params.js && node --check src/video-fx.js && node --check src/viewport-units.js && node --check src/vendor/budoux-ja-bundle.js && node --check src/text-split.js && node --check src/overlay-runtime.js && node --check src/interaction.js && node --check src/minimap.js",
     "test": "node --test test-harness/*.test.mjs"
   }
 }

package/vendor/packages/preview-server/package.json

@@ -4,7 +4,7 @@
   "private": true,
   "type": "module",
   "scripts": {
-    "build": "esbuild ../pen-visuals/src/index.ts --bundle --format=esm --outfile=public/pen-visuals.bundle.js --target=chrome122 --platform=browser && esbuild ../overlay-runtime/src/interaction.js --bundle --format=iife --outfile=public/overlay-interaction.bundle.js --target=chrome122 --platform=browser && esbuild ../overlay-runtime/src/interaction.css --bundle --outfile=public/overlay-interaction.css --target=chrome122 && esbuild ../edit-store/src/webview-kernel.ts --bundle --format=esm --outfile=public/edit-kernel.bundle.js --target=chrome122 --platform=browser && esbuild src/frame-engine-client.ts --bundle --format=esm --outfile=public/frame-engine.bundle.js --target=chrome122 --platform=browser",
+    "build": "esbuild ../pen-visuals/src/index.ts --bundle --format=esm --outfile=public/pen-visuals.bundle.js --target=chrome122 --platform=browser && esbuild ../overlay-runtime/src/interaction.js --bundle --format=iife --outfile=public/overlay-interaction.bundle.js --target=chrome122 --platform=browser && esbuild ../overlay-runtime/src/interaction.css --bundle --outfile=public/overlay-interaction.css --target=chrome122 && esbuild ../overlay-runtime/src/motion-vocab.css --bundle --outfile=public/overlay-motion-vocab.css --target=chrome122 && esbuild ../edit-store/src/webview-kernel.ts --bundle --format=esm --outfile=public/edit-kernel.bundle.js --target=chrome122 --platform=browser && esbuild src/frame-engine-client.ts --bundle --format=esm --outfile=public/frame-engine.bundle.js --target=chrome122 --platform=browser",
     "pretest": "npm --prefix ../edit-store run build && npm --prefix ../../apps/shell/extensions/akari-preview run build && npm run build",
     "test": "node --test test/*.test.mjs",
     "test:frame-engine-browser": "node --test test/frame-engine-preview-browser.l1.mjs",

package/vendor/skills/overlay-authoring/3d.md

@@ -118,6 +118,21 @@ fragment は単一ルートとし、透明 canvas、任意の静的 fallback、
   clip を分けるので、1 個のモデルに複数の動きがあるときは `"*"` で束ねる（1 本しか再生しないと
   片方しか動かない）。存在しない clip 名を書いた場合はエラーになる。
 - `materialOverrides` は `{ "<material 名>": { "texture": "<画像または動画の相対パス>" } }` の形で、名前が一致するマテリアルの `emissiveMap` を差し替える。**差し替え先が `emissiveMap` である以上、貼り先の材質が発光しない（glTF の `emissiveFactor` が未設定 = 黒）と「0 × テクスチャ」で何も出ない**（2026-08-14 実害。詳細は後述「発光しない材質には貼れない」）。edit.json のあるディレクトリからの相対 PNG / JPEG / WebP 等、または MP4 / MOV / WebM を指定し、URL や CDN を書かない。該当するマテリアル名がモデル内にない場合は警告して無視される。
+  - `textureVar` は画面に映すものをツマミ（CSS カスタムプロパティ）にする任意キー。`"--screen-src"` のような変数名を書き、overlay の `vars` でその変数に相対パスを入れると `texture` の代わりに差し込まれる。空・未設定なら `texture` がそのまま使われる。
+  - `textureVar` を使う場合も `texture` は実在する相対パスのままにする。書き出し前の宣言済み入力検査が実ファイルを要求するため、`texture` に `var(--screen-src)` を直接書く形はライブプレビューでは動くが書き出しでは失敗する。
+  - `brightness` は任意の発光倍率（0〜4、既定 1）で、差し替えたテクスチャの `emissiveIntensity` に掛かる。`var(--screen-brightness)` のような CSS 変数も書き出しを含めて使える。既定の 1 のときは `emissiveIntensity` に触れず、既存宣言の見た目を維持する。
+  - ツマミへ結線する宣言例:
+    ```json
+    {
+      "materialOverrides": {
+        "ScreenMaterial": {
+          "texture": "placeholder.png",
+          "textureVar": "--screen-src",
+          "brightness": "var(--screen-brightness)"
+        }
+      }
+    }
+    ```
   - **パスは「edit.json のあるディレクトリ」から。断片の場所からの相対ではない。** `model` も同様。
     断片を `overlays/3d-phone/fragment.html` へ置いたなら `"overlays/3d-phone/model.glb"` と書く
     （`"model.glb"` はプロジェクト直下を探して ENOENT になる）。

package/vendor/skills/overlay-authoring/motion.md

@@ -16,15 +16,40 @@
 
 ## イージング語彙
 
-| 意図 | CSS 語彙 | 使い方 |
-|---|---|---|
-| 等速・進捗・連続回転 | `linear` | 速度変化そのものに意味がない動き |
-| 入場・減速して止まる | `ease-out` | 画面外から定位置へ入る要素 |
-| 退場・加速して去る | `ease-in` | 定位置から画面外へ出る要素 |
-| 姿勢 A と B の往復 | `ease-in-out` | カード反転、視線移動、穏やかな遷移 |
-| 離散切替 | `steps()` | カウンタの桁、LED、コマ送り風表現 |
+数値の `cubic-bezier()` を断片に直書きしない。ランタイムの語彙
+（`packages/overlay-runtime/src/motion-vocab.css`。ホストが読み込み、書き出し側は
+rasterize.mjs が同じ内容をシートへ埋め込む）を **名前で** 呼ぶ。
 
-独自 `cubic-bezier()` は named easing で意図を表せない場合だけ使い、CSS 変数化して理由を残す。標準キーワードの定義は [W3C CSS Easing Functions Level 2](https://www.w3.org/TR/css-easing-2/) を参照する。
+| 変数 | 質感 | 使いどころ |
+|---|---|---|
+| `--ease-smooth` | **既定**。すっと出て長く減速 | 入場・移動・サイズ変化の第一候補。未指定の `var(--anim-easing)` はこれになる |
+| `--ease-natural` | 中庸の立ち上がり + 長い減速の尾 | リストの送り、続きものの移動 |
+| `--ease-slowdown` | 初速最大 → 匍匐して止まる | 勢いから静止へ。強い ease-out |
+| `--ease-accelerate` | 深い溜め → 加速して去る | 退場。**直後にカットが来る前提**の動き |
+| `--ease-overshoot` | バネ。目標を大きく越えてから戻る（約 +90%） | 強調の飛び込み・ポップイン |
+| `--ease-overshoot-mid` / `--ease-overshoot-soft` | 同じバネの控えめ段（約 +66% / +32%） | 移動量がやや大きいときの逃がし先 |
+| `--ease-impulse` | 突進して小さく上振れ | 高速スライドイン |
+| `--ease-linear` | 等速 | 進捗・連続回転など、速度変化に意味がない動き |
+| `--ease-snap-out` / `--ease-hard-out` / `--ease-deep-inout` / `--ease-snappy` | 切れ味系の補助語彙 | テロップの歯切れを出したいとき（telop.md） |
+
+`--anim-duration` に入れる尺の相場も対象別の変数がある:
+
+| 変数 | 値 | 対象 |
+|---|---|---|
+| `--anim-duration-telop` | 500ms | テロップ（1 文字 / 1 文節あたり） |
+| `--anim-duration-shape` | 800ms | 図形・帯・カード |
+| `--anim-duration-group` | 1000ms | ラッパ `<div>` ごと動かすとき |
+
+**overshoot / impulse は「小さい移動・スケールのポップ」専用**。越え量は移動量に
+**比例**するため、画面幅級の搬入（数百 px の translate）に掛けると目標を数百 px
+突き抜けて画面外へ飛ぶ。長距離の搬入は `--ease-smooth` / `--ease-natural`、退場は
+`--ease-accelerate`、ポップ強調（scale 0.7→1、数十 px の移動）にだけ overshoot 系を使う。
+どうしても大きめの移動で使うときは `-mid` / `-soft` へ落とす。
+
+CSS 標準キーワード（`ease-out` 等）より上記の語彙を優先する。離散切替（カウンタの桁・
+LED・コマ送り風）だけは標準の `steps()` を使う。語彙で意図を表せない場合に限り
+`cubic-bezier()` を新設し、CSS 変数化して理由を残す。標準キーワードの定義は
+[W3C CSS Easing Functions Level 2](https://www.w3.org/TR/css-easing-2/) を参照する。
 
 ## compositor 合成の制約
 

package/vendor/skills/overlay-authoring/telop.md

@@ -92,6 +92,7 @@ YouTube の safe zone も全端末保証ではない。オーガニック投稿
 
 - 字幕の出入りは短い opacity / translate を使い、保持中は動かさない。
 - 1 文字ずつの出現は可読速度とシーク再現性を損ねやすい。必要な演出だけに限定し、文字 DOM は先に確定しておく。
+  日本語で時間差の出現をやるなら 1 文字ではなく**文節単位**にする（下の「テキスト分割と stagger 規約」）。
 - CSS animation / WAAPI を使い、ランタイムが `currentTime = (t - start) * 1000` を設定できる形にする。
 - 位置移動の transform は断片内の子要素へ付け、AKARI が所有する外側コンテナの幾何 transform と分離する。
 
@@ -108,6 +109,83 @@ OUT の `both`（= backwards fill）は**遅延中に OUT の開始値（`opacit
 - チェック: 断片の冒頭数フレームをシークし、IN の開始値（opacity 0 / 画面外）から始まることを目視する
 - この罠は IN/OUT の 2 段に限らず一般化できる（3 段以上の連鎖、点滅ループの片端省略など）。`motion.md`「複数アニメーションを同一プロパティへ連鎖させるときの暗黙 0% 上書き」を参照
 
+## テキスト分割と stagger 規約（2026-08-15）
+
+文字・単語・文節ごとに時間差で出す演出は、**断片が分割済みで出荷し、
+stagger は CSS の `calc()` で表現する**。断片に `<script>` は書かない。
+
+```html
+<div class="foo__line" data-akari-split="bunsetsu"
+  ><span class="akari-u" style="--i:0">今日は</span
+  ><span class="akari-u" style="--i:1">とても</span
+  ><span class="akari-u" style="--i:2">いい</span
+  ><span class="akari-u" style="--i:3">天気ですね</span></div>
+```
+
+```css
+.foo__line{
+  --anim-duration: var(--anim-duration-telop, 500ms);  /* 1 要素の尺（対象別の相場は motion.md） */
+  --anim-stagger:  150ms;                              /* ずらし */
+  --anim-easing:   var(--ease-snap-out);               /* 語彙は motion.md「イージング語彙」。未指定なら smooth */
+}
+/* ★ [data-akari-active] ゲートの中で宣言する（下の「性能」参照） */
+[data-akari-active] .foo__line .akari-u{
+  animation: foo__in var(--anim-duration) var(--anim-easing) both paused;
+  animation-delay: calc(var(--i) * var(--anim-stagger));
+}
+@keyframes foo__in{
+  from{ opacity:0; transform: translateY(var(--anim-distance, 50px)); }
+  to  { opacity:1; transform: none; }
+}
+```
+
+- **`animation-delay: calc(var(--i) * var(--anim-stagger))` の 1 行がすべて**。
+  どの `@keyframes`（= どの演出）にも同じ形で stagger が掛かる。
+  演出ごとに遅延を書き並べない
+- **ツマミは CSS 変数**にする。`edit.json` の `vars` から上書きできる
+- **`--i` は 0 始まりの通し番号**。`--n` に総数が入る（ランタイムが振る）
+
+### 分割単位（`data-akari-split`）
+
+| 値 | 単位 | 使いどころ |
+|---|---|---|
+| `bunsetsu` | 文節（日本語の表示単位） | **日本語テロップの既定** |
+| `chars` | 1 文字 | 演出用。可読速度を損ねるので多用しない |
+| `words` | 単語 | 欧文向け。**日本語では分かち書きしないので機能しない** |
+| `lines` | 行 | 行単位で送る |
+| `none` | 分割しない | — |
+
+日本語の文節分割は BudouX（`src/vendor/budoux-ja-bundle.js`・Apache-2.0）で行う。
+`Intl.Segmenter` 単体の単語分割は助詞がバラけるため使わない
+（`今日 | は | とても | いい | 天気 | です | ね` になる）。
+
+### ランタイムの担当（断片は書かなくてよい）
+
+`data-mirror="text"` と同じく、DOM 操作はランタイムが持つ:
+
+- **mount 時**: 宣言はあるが未分割の要素を分割する（出荷漏れの安全網・冪等）
+- **編集開始時**: 分割を素のテキストへ畳む（`<span>` のまま contenteditable にすると
+  打鍵で span が割れる・キャレットが単位境界で飛ぶ）
+- **編集確定時**: 確定したテキストで分割し直し、`--i` を振り直す。
+  保存される HTML は**分割済みの状態**（書き出しは断片の HTML をそのまま使うため）
+
+必要ランタイム: **0.5.0 以降**。素材の `meta.json` に
+`min_overlay_runtime_version: "0.5.0"` を宣言する。
+
+### 性能 — `[data-akari-active]` ゲートは必須（実測）
+
+分割は 1 断片の CSS animation を分割数ぶんに増やす。ゲートが無いと即死する:
+
+| 条件 | 現存 animation | 1 tick |
+|---|---:|---:|
+| ゲート有り・1,200 断片 × 16 分割・可視 60 | 960 | **0.023ms** |
+| ゲート無し・1,200 断片 × 8 分割 | 9,600 | **221ms** |
+| ゲート無し・上記 + 可視 60 | 9,600 | **11,783ms** |
+
+`getAnimations()` のコストは「ドキュメント全体に現存する CSS animation の総数」に
+比例する。ゲートの中で宣言すれば非可視分は現存しないので、**分割そのものは無害**。
+ゲートを忘れた断片が 1 つあるだけで全体が落ちる。
+
 ## 多層テキスト断片と data-mirror 規約（2026-08-06）
 
 同一テキストを太さ違いの `-webkit-text-stroke` 等で複数層重ねる断片（多重縁取り・ずらし影・裏打ち・二段押し出し等）は、編集対象を 1 層に決めないと打ち替えが層間でズレる。層間の同期は overlay-runtime（`packages/overlay-runtime/`）側の機能で行う。