akari-video 0.1.15 → 0.1.17

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akari-video",
-  "version": "0.1.15",
+  "version": "0.1.17",
   "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-02-preview-parity.md

@@ -521,7 +521,10 @@ ffmpeg の `perspective` フィルタの制約（式に時刻変数を持たな
   プレビューでは、書き出しの `acrossfade=d=<duration>` のような前後 2 音源の同時混合は行わない
 
 ### 2.6 トランジション
-- 視覚描画は `fade-black` / `fade-white` のみ（dissolve は尺計算のみ）— 現状の両実装の共通仕様として明文化
+- `dissolve` / `fade-black` / `fade-white` / `reveal-down` / `reveal-up` の 5 種を実描画する。
+  dissolve は前後 2 面の opacity、fade は前後面 + 色プレート、reveal は incoming 面の
+  `clip-path` で表現する。Shell で video FX rail が有効な場合も同じ opacity / clip-path を
+  rail canvas へ鏡写しし、LUT / chroma 適用後の面同士を同じ進行率で合成する
 
 ### 2.7 書き込み
 - edit.json への**すべての書き込み経路は edit-lint を通す**（UI・API・RPC を問わず)。
@@ -557,6 +560,9 @@ ffmpeg の `perspective` フィルタの制約（式に時刻変数を持たな
 | `cuts[].fx`（2026-08-07 実装・近似あり） | 🟡（§2.4.5。5 種対応、3 種は近似バッジ付き） | ❌（未実装） |
 | `layers[].keyframes`（2026-08-09 実装） | ✅（§2.4.7。transform/crop は連続補間。perspective は blend:"normal" のみ・書き出しの段階保持とサンプル点で一致） | ✅（§2.4.7。同左） |
 | `cuts[].static-image-source`（2026-08-12 実装。正本: `contract-2026-08-12-still-image-cut-source-v0.md`） | 🟡（`<img>`/`<video>` 出し分け + preview-engine ClipSession/Timeline の image 対応を実装。framing/freeze/transform は流用。実ブラウザでの対話的スクラブ・複数区間切替の実機検証は未実施。2026-08-17: 静止画が stylesheet の display:none に隠れたまま永久に出ない実機バグ（`img.style.display=''`）を是正） | 🟡（2026-08-17 実装 — task/2026-08-17-shell-still-image-cut-preview。#preview-still + gap と同じ壁時計クロックで表示。cut transform/framing/freeze/選択ドラッグは video のスタイル鏡写しで流用。タイムラインの静止画フィルムストリップ/サムネも同時是正（probeForFilmstrip の duration 必須ガードが静止画分岐を dead code 化していた）。Electron 実機での対話検証は未実施） |
+| `output.look` | ✅（WebGL rail。chroma → LUT、intensity 対応） | ✅（WebGL rail。chroma → LUT、intensity 対応） |
+| `chroma_key`（source / layer） | ✅（WebGL rail。source は背景合成、layer はアルファ抜き） | ✅（WebGL rail。source は背景合成、layer はアルファ抜き） |
+| `audio.master` | 🟡（未裁定・badge のみ） | 🟡（未裁定・badge のみ） |
 
 - `cuts[].framing`（静的クロップ / ズームキーフレーム）・`cuts[].freeze`（フリーズ）は
   `contract-2026-07-22-render-basics.md` #6/#7 としてレンダ（render-cut）に加え、

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

@@ -1,6 +1,6 @@
 {
   "name": "akari-video",
-  "version": "0.1.15",
+  "version": "0.1.17",
   "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. Run them from a full AKARI Video app installation (normally ~/.akari/app) or a monorepo checkout.]",
   "type": "module",
   "files": [

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

@@ -683,6 +683,21 @@ function validateEditV2(edit, findings) {
         });
       }
 
+      if (kind === "html" && Object.hasOwn(item.source, "params")) {
+        const params = item.source.params;
+        const invalidEntry = isRecord(params)
+          ? Object.entries(params).find(([, value]) => typeof value !== "string")
+          : ["params", params];
+        if (invalidEntry) {
+          addFinding(findings, {
+            severity: "error",
+            check: "v2.html-params",
+            message: "HTML source params must be an object whose values are strings",
+            path: `${itemPath}.source.params${invalidEntry[0] === "params" ? "" : `.${invalidEntry[0]}`}`,
+          });
+        }
+      }
+
       if (track.lane === "audio") {
         const role = item.role ?? "sfx";
         if (Object.hasOwn(item, "gain_db")

package/vendor/packages/edit-store/lib/edit-v2-item-write.d.ts

@@ -21,6 +21,7 @@ export type PreviewItemWriteCommand = {
         vars?: UnknownRecord;
         transform?: PreviewItemTransformPatch;
         html?: string;
+        params?: Record<string, string>;
     };
 } | {
     kind: 'layer';

package/vendor/packages/edit-store/lib/edit-v2-item-write.js

@@ -49,6 +49,15 @@ function resolveV2Write(parsed, command) {
         if (typeof command.patch.html === 'string') {
             htmlPath = source.path;
         }
+        if (command.patch.params) {
+            for (const [name, value] of Object.entries(command.patch.params)) {
+                if (!name || typeof value !== 'string') {
+                    throw new Error('HTML params は空でないキーと文字列値である必要があります');
+                }
+            }
+            source.params = { ...source.params, ...command.patch.params };
+            editChanged = true;
+        }
         if (command.patch.vars) {
             source.vars = { ...recordOf(source.vars), ...command.patch.vars };
             editChanged = true;
@@ -109,6 +118,9 @@ function resolveLegacyWrite(edit, command) {
             throw new Error(`overlays[].html がファイル参照ではありません: ${command.itemId}`);
         }
         let editChanged = false;
+        if (command.patch.params) {
+            throw new Error('HTML params の書き戻しには edit.json version 2 が必要です');
+        }
         if (command.patch.vars) {
             overlay.vars = { ...recordOf(overlay.vars), ...command.patch.vars };
             editChanged = true;

package/vendor/packages/edit-store/lib/edit-v2.d.ts

@@ -60,6 +60,7 @@ export interface HtmlSourceV2 {
     kind: 'html';
     path: string;
     vars?: Record<string, unknown>;
+    params?: Record<string, string>;
 }
 export interface TelopSourceV2 {
     kind: 'telop';

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

@@ -239,10 +239,17 @@ function validateItemSource(value, path, sourceIds) {
                 requirePositiveNumber(value.speed, `${path}.speed`);
             return;
         case 'html':
-            requireExactKeys(value, new Set(['kind', 'path', 'vars']), path);
+            requireExactKeys(value, new Set(['kind', 'path', 'vars', 'params']), path);
             requireText(value.path, `${path}.path`);
             if (hasOwn(value, 'vars'))
                 requireRecord(value.vars, `${path}.vars`);
+            if (hasOwn(value, 'params')) {
+                requireRecord(value.params, `${path}.params`);
+                for (const [name, text] of Object.entries(value.params)) {
+                    if (typeof text !== 'string')
+                        throw invalid(`${path}.params.${name}`, '文字列である必要があります');
+                }
+            }
             return;
         case 'telop':
             requireExactKeys(value, new Set(['kind', 'preset', 'params', 'baked']), path);
@@ -326,10 +333,18 @@ function requireRecord(value, path) {
 function hasOwn(value, key) {
     return Object.prototype.hasOwnProperty.call(value, key);
 }
+const UNKNOWN_KEY_GUIDANCE = {
+    emphasis_words: '語レベル演出は captions.json のトップレベル emphasis_words[] へ移してください（契約 contract-2026-08-23-captions-emphasis-words-v0.md）',
+};
+const DEFAULT_UNKNOWN_KEY_GUIDANCE = 'このキーは v2 の語彙にありません。手で編集した場合は取り除くか、.akari/backup/ の原本から復元してください';
 function requireExactKeys(value, allowed, path) {
     const unknown = Object.keys(value).filter(key => !allowed.has(key));
-    if (unknown.length > 0)
-        throw invalid(path, `未定義キーを使用できません: ${unknown.join(', ')}`);
+    if (unknown.length > 0) {
+        const guidance = unknown
+            .map(key => `${key}: ${UNKNOWN_KEY_GUIDANCE[key] ?? DEFAULT_UNKNOWN_KEY_GUIDANCE}`)
+            .join(' / ');
+        throw invalid(path, `未定義キーを使用できません: ${unknown.join(', ')}。案内: ${guidance}`);
+    }
 }
 function requireText(value, path) {
     if (typeof value !== 'string' || value.trim().length === 0)

package/vendor/packages/edit-store/lib/internal-model.d.ts

@@ -19,6 +19,7 @@ export interface InternalHtmlSource {
     kind: 'html';
     /** 断片ファイルのパス、またはインライン HTML。 */
     html: string;
+    params?: Record<string, string>;
 }
 export interface InternalTelopSource {
     kind: 'telop';

package/vendor/packages/edit-store/lib/internal-model.js

@@ -466,7 +466,8 @@ function buildV2VisualItem(item, fps, ref, pathOf, chromaKeyOf, legacyIndexCount
         case 'html': {
             const declaration = {
                 id: item.id, html: item.source.path, start: at, duration, track: ref,
-                ...(item.source.vars !== undefined ? { vars: item.source.vars } : {}), ...common
+                ...(item.source.vars !== undefined ? { vars: item.source.vars } : {}),
+                ...(item.source.params !== undefined ? { params: item.source.params } : {}), ...common
             };
             const value = {
                 id: item.id,
@@ -478,7 +479,10 @@ function buildV2VisualItem(item, fps, ref, pathOf, chromaKeyOf, legacyIndexCount
             return {
                 item: {
                     id: item.id, atFrames, durationFrames, at, duration,
-                    source: { kind: 'html', html: item.source.path },
+                    source: {
+                        kind: 'html', html: item.source.path,
+                        ...(item.source.params !== undefined ? { params: item.source.params } : {})
+                    },
                     declaration,
                     legacy: { collection: 'overlays', index: nextLegacyIndex(legacyIndexCounters, 'overlays'), value }
                 }

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

@@ -18,6 +18,12 @@ Three.js + glTF シーンを決定的な時刻で描画し（`three-runtime.js`
 | `#overlay-stage` 配下のオーバーレイ DOM の mount/tick/unmount | アプリシェルの DOM 骨格（上部バー・字幕リストパネル・トランスポート・スプリッタ等） |
 | オーバーレイの選択・ドラッグ移動・拡縮ハンドル・ダブルクリックテキスト編集 | edit.json の実ファイル I/O（`overlay_write` の実装） |
 | ズーム中の全体フレーム + 現在視野ミニマップ（`#minimap`） | 動画プレーンの再生/シーク、書き出しパイプライン |
+| `video-fx.js` による動画面の画素 FX（LUT / chroma。外部時刻駆動） | 動画プレーン自身の再生・音声・クロック |
+
+`video-fx.js` は `<video>` / `<img>` 1 面ごとに宣言がある場合だけ WebGL canvas を重ねる。
+宣言が無い場合は canvas・WebGL context・rAF 負荷を一切作らない。ホストはメディア要素を再生の
+正として保ち、タイムライン更新時に `rail.render(t)` を呼ぶ。WebGL 初期化・LUT 解決・画像読込が
+失敗した rail は canvas を畳んで元のメディア表示へ戻るため、再生と音声を止めない。
 
 ホストシェル（新モノレポの `apps/shell/` 等）は、本パッケージが期待する DOM id と
 `window.akari.*` インターフェースを用意した上で、必要なスクリプトを読み込む。

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

@@ -10,7 +10,7 @@
     "README.md"
   ],
   "scripts": {
-    "check": "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/overlay-runtime.js && node --check src/interaction.js && node --check src/minimap.js",
+    "check": "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/overlay-runtime.js && node --check src/interaction.js && node --check src/minimap.js",
     "test": "node --test test-harness/*.test.mjs"
   }
 }

package/vendor/packages/schemas/edit.schema.json

@@ -666,9 +666,14 @@
       "properties": {
         "kind": { "const": "html" },
         "path": { "type": "string", "minLength": 1, "pattern": "\\S" },
-        "vars": { "type": "object" }
+        "vars": { "type": "object" },
+        "params": {
+          "type": "object",
+          "properties": {},
+          "additionalProperties": { "type": "string" }
+        }
       },
-      "$comment": "notes-2026-08-18-timeline-latency-and-track-model.md §9。HTML はその場で描画する絵の出どころであり、素材トリムの in/out を持たない。"
+      "$comment": "notes-2026-08-18-timeline-latency-and-track-model.md §9 / contract-2026-08-22-overlay-html-slots.md §1。HTML はその場で描画する絵の出どころであり、素材トリムの in/out を持たない。params は任意のスロット名をキーにできる一方、値を string のみに閉じる。"
     },
     "itemSourceTelopV2": {
       "type": "object",

package/vendor/packages/schemas/examples/edit-v2-html-params-invalid/edit.json

@@ -0,0 +1,23 @@
+{
+  "version": 2,
+  "output": { "width": 1920, "height": 1080, "fps": 30 },
+  "sources": [],
+  "tracks": [
+    {
+      "id": "v-html",
+      "lane": "visual",
+      "items": [
+        {
+          "id": "chapter-1",
+          "at": 0,
+          "duration": 90,
+          "source": {
+            "kind": "html",
+            "path": "overlays/chapter.html",
+            "params": { "title": 1 }
+          }
+        }
+      ]
+    }
+  ]
+}

package/vendor/packages/schemas/examples/edit-v2-html-params-valid/edit.json

@@ -0,0 +1,23 @@
+{
+  "version": 2,
+  "output": { "width": 1920, "height": 1080, "fps": 30 },
+  "sources": [],
+  "tracks": [
+    {
+      "id": "v-html",
+      "lane": "visual",
+      "items": [
+        {
+          "id": "chapter-1",
+          "at": 0,
+          "duration": 90,
+          "source": {
+            "kind": "html",
+            "path": "overlays/chapter.html",
+            "params": { "title": "第1章", "subtitle": "問題の本質" }
+          }
+        }
+      ]
+    }
+  ]
+}

package/vendor/packages/schemas/test/edit-v2-schema.test.mjs

@@ -134,6 +134,17 @@ test("minimum v2 fixture is valid", () => {
   assert.equal(validate(fixture("edit-v2-minimal-valid")), true, JSON.stringify(validate.errors, null, 2));
 });
 
+test("HTML source params accepts arbitrary slot names but only string values", () => {
+  const valid = fixture("edit-v2-html-params-valid");
+  assert.equal(validate(valid), true, JSON.stringify(validate.errors, null, 2));
+
+  const invalid = fixture("edit-v2-html-params-invalid");
+  assert.equal(validate(invalid), false);
+  assert.ok(validate.errors?.some(error =>
+    error.instancePath.endsWith("/source/params/title") && error.keyword === "type"
+  ), JSON.stringify(validate.errors, null, 2));
+});
+
 test("editV2 rejects removed top-level vocabulary as additional properties", () => {
   for (const [key, extension] of [
     ["beats", []],

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

@@ -46,12 +46,36 @@ YouTube の safe zone も全端末保証ではない。オーガニック投稿
 放送の左上・右上に常駐する番組名/コーナー名ラベル。番組タイトル + 現在の章タイトルを出し、章立てに追従させる定型。**素材ライブラリに入れず、この定型から都度生成してよい**（プロジェクト固有のテキスト差し替えが本体で、再利用価値は構造にしかないため）。
 
 - **HTML/CSS で作る。画像生成にしない**: 章ごとのテキスト差し替えが必要で、画像だと章数分の生成と文字品質リスク（画像生成の日本語誤字）を抱える。HTML なら 1 断片 + 章ごとのオーバーレイエントリで済み、プレビューと書き出しが同一ソースを通る
-- **章追従の実装**: 同じ断片を章数分コピーし、章タイトルのテキストと `data-start` / `data-duration` を章の区間に合わせる（1 章 = 1 オーバーレイエントリ）。テキストは**断片 DOM に直接置く**（CSS 変数でのテキスト保持は禁止。変更は html パッチ / contenteditable 経由）
+- **章追従の実装**: スロット付きの同じ断片を章数分参照し、章タイトルを各 HTML アイテムの `source.params`、区間を `at` / `duration` に持たせる（1 章 = 1 オーバーレイアイテム）。固定文言だけの既存断片は従来どおり DOM 直書きでもよい。CSS 変数へテキストを持たせない
 - **構造の目安**: ルート 1 つ + プレート（番組名の行 + 章名の行、または 1 行連結）。位置は外側コンテナの transform（ランタイム所有）で決め、断片は見た目だけを持つ
 - **常駐物の抑制**: 常時表示なので主張を抑える。小さめの `--font-size`、半透明の地、画面の隅で被写体・字幕・映像内 UI と重ねない。字幕（下側）と同時表示が前提なので、下側には置かない
 - knobs の例: `--plate-bg`、`--accent`、`--font-size`、`--radius`。既定値は `var(--name, fallback)` で公開する
 - 章替わりの出入りは短い opacity / translate のみ。保持中は動かさない（アニメーション節の原則どおり）
 
+## テキストスロット（data-akari-slot）
+
+1 本の HTML を複数アイテムで共有し、文字だけを `edit.json` に分離するときに使う。
+
+```html
+<span data-akari-slot="title">既定タイトル</span>
+```
+
+```json
+{
+  "source": {
+    "kind": "html",
+    "path": "overlays/chapter-tag.html",
+    "params": { "title": "第1章 問題の本質" }
+  }
+}
+```
+
+- **宣言**: 差し替えるテキスト要素そのものへ `data-akari-slot="<name>"` を付ける。スロット内はプレーンテキストだけにし、子要素や別スロットを入れ子にしない。ランタイムは値を `textContent` へ入れるため、`<b>` 等を params に書いてもタグにはならない
+- **既定テキスト**: 要素内へ必ず人が読める既定値を書く。対応する params キーが無いアイテムでは、その既定値がそのまま表示される
+- **命名**: `^[a-z][a-z0-9_-]*$` の意味名を使う（例: `title`、`chapter-title`、`speaker_name`）。連番や表示文言そのものを名前にせず、同じ名前を複数要素へ使う場合は同じ文字を表示する意図に限る
+- **共有境界**: 色・余白・書体・アニメーションはテンプレ HTML/CSS、インスタンスごとの文字は `source.params` に置く。スロットをダブルクリック編集した場合も、テンプレファイルではなく params だけが更新される
+- **非スロットとの互換**: `data-akari-slot` の無い断片は従来どおり DOM の文字を編集し、参照先 HTML ファイルへ書き戻す
+
 ## アニメーション
 
 - 字幕の出入りは短い opacity / translate を使い、保持中は動かさない。