akari-video 0.1.39 → 0.1.40

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akari-video",
-  "version": "0.1.39",
+  "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/packages/akari-launcher/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akari-video",
-  "version": "0.1.39",
+  "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/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/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/`）側の機能で行う。