akari-video 0.1.39 → 0.1.41

package/package.json

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

@@ -61,6 +61,8 @@
     "docs/contract-2026-09-02-shape-item-v0.md",
     "docs/contract-2026-09-02-transcript-unrecognized-spans-v0.md",
     "docs/contract-2026-09-02-word-book-v0.md",
+    "docs/contract-2026-09-03-clip-adjust-v0.md",
+    "docs/contract-2026-09-03-preview-playback-rate-v1.md",
     "packages/akari-launcher/package.json",
     "packages/akari-launcher/README.md",
     "packages/akari-tools/package.json",
@@ -71,8 +73,6 @@
     "packages/asset-resolver/README.md",
     "packages/audio-library-setup/package.json",
     "packages/audio-library-setup/README.md",
-    "packages/bake-layer/package.json",
-    "packages/bake-layer/README.md",
     "packages/chat-bridge/package.json",
     "packages/creator-root/package.json",
     "packages/decision-cards/package.json",
@@ -108,9 +108,6 @@
     "packages/render-cut/README.ja.md",
     "packages/render-cut/README.md",
     "packages/schemas/package.json",
-    "packages/template-render/package.json",
-    "packages/template-render/README.ja.md",
-    "packages/template-render/README.md",
     "packages/word-book/package.json",
     "skills/address-review/SKILL.md",
     "skills/analyze-footage/analysis-json.md",

package/vendor/docs/contract-2026-07-13-asset-library.md

@@ -78,7 +78,7 @@ assets/                     ← 当面はローカルディレクトリ。コミ
   値へ付く単位だけを書き、**無単位の倍率・比率（短辺比など）では `unit` を省略する**。
   意味は `label` に書く（例「木枠の太さ（短辺比。0 で枠なし）」）。この規律により、
   ツールが `--var board-width=940` を `940px` へ、比率のツマミは数値のまま渡せる
-  （`packages/template-render`）。ここを混ぜると `width: 940` という無効な CSS が生まれ、
+  （HTML 素材のパラメータ展開）。ここを混ぜると `width: 940` という無効な CSS が生まれ、
   **絵は変わるが「効いた」のではなく「壊れた」**という誤検知が検査側にも起きる
 - `knobs.type` の語彙: `text` / `color` / `slider` / `dropdown` / `checkbox` / `media`
   （.mogrt と同じ心的モデル。世界中のモーションデザイナーが既に知っている語彙）
@@ -400,8 +400,7 @@ catalog に載せる素材は、取得元のライセンスが CC0 相当（帰
 
 現在の収録:
 
-- `presets/telop/` — ATF テロップテンプレート 36 件。`packages/bake-layer` が
-  `--preset <id>` から `presets/telop/<id>/template.json` を解決する
+- ATF テロップの参照表と描画器は退役。HTML 素材版は Lab で取得する。既存の baked は再生互換を維持する。
 - `presets/luts/` — 3D LUT 2 件（自前生成）。`packages/render-cut/src/plan.mjs` が
   `edit.json` の `output.look.lut`（区切り文字を含まない名前）から
   `presets/luts/<id>/<id>.cube` を解決する

package/vendor/docs/contract-2026-09-03-clip-adjust-v0.md

@@ -0,0 +1,166 @@
+# edit.json v2 clip adjust v0 契約
+
+- 日付: 2026-09-03
+- lifecycle: accepted
+- 位置づけ: v2 visual item 共通の per-clip カラー補正語彙と、その段階導入契約
+
+## 0. 位置づけ
+
+`adjust` は、1 個の visual item に基本補正と 3D LUT を適用する任意フィールドである。値の保存、
+検証、プレビュー、GPU / OSR 書き出しが同じ語彙と同じ演算順を使う。v0 は基本補正 10 項目と
+単一 LUT に限定し、カーブやホイールを混ぜない。
+
+本契約の導入は段階的に行う。M1 では schema、edit-store、validator、lint、能力台帳へ席を作る。
+エンジン消費が入るまでは、正しく保存できる値であっても GPU / OSR の能力台帳では `ignored`、
+`runtime_warning: true` とし、edit-lint は `engine.unsupported-field` error を返す。未実装を黙って
+描画したように扱わない。
+
+## 1. 席
+
+席は `edit.json` version 2 の visual lane にある `tracks[].items[].adjust` である。現行 schema の
+本契約対象の visual item（media / html / telop / filter / group / captions / caption）に共通し、audio lane
+の item には置かない。
+
+```jsonc
+{
+  "version": 2,
+  "tracks": [{
+    "id": "visual",
+    "lane": "visual",
+    "items": [{
+      "id": "clip-1",
+      "at": 0,
+      "duration": 90,
+      "adjust": {
+        "basic": { "exposure": 0.35, "temperature": -0.1, "saturation": 0.15 },
+        "lut": { "lut": "cinematic-warm", "intensity": 0.8 },
+        "sections": { "basic": true, "lut": true }
+      },
+      "source": { "kind": "media", "src": "main", "in": 0, "out": 3 }
+    }]
+  }]
+}
+```
+
+version 0 / 1 の `cuts[]` と `layers[]` には `adjust` の席を追加しない。
+
+## 2. 語彙
+
+`adjust` は追加キーを許さない object で、全フィールドが任意である。
+
+| field | 型 | 範囲・既定 |
+|---|---|---|
+| `basic` | object | 追加キー不可。各値の省略は `0`（中立） |
+| `lut` | `null` または object | `null` / 省略は LUT 無し |
+| `sections` | object | `basic?` / `lut?` の boolean だけを持つ疎辞書 |
+
+`basic` の 10 項目は次のとおりである。
+
+| field | 範囲 | 単位・中立 |
+|---|---:|---|
+| `exposure` | `-3..3` | EV、`0` |
+| `contrast` | `-1..1` | `0` |
+| `highlights` | `-1..1` | `0` |
+| `shadows` | `-1..1` | `0` |
+| `blacks` | `-1..1` | `0` |
+| `whites` | `-1..1` | `0` |
+| `temperature` | `-1..1` | `0` |
+| `tint` | `-1..1` | `0` |
+| `vibrance` | `-1..1` | `0` |
+| `saturation` | `-1..1` | `0` |
+
+`lut` object は追加キー不可で、空でない文字列 `lut` を必須とし、任意の `intensity` は `0..1`、
+省略時 `1` とする。
+
+## 3. 基本補正の数値契約
+
+演算は video-space、すなわち gamma 符号化 sRGB 値のまま行う。scene-linear へ変換しない。
+入力チャンネルを `c = (r, g, b)`、`clamp01(x) = min(1, max(0, x))`、Rec.709 luma を
+`Y(c) = 0.2126r + 0.7152g + 0.0722b` とする。`smoothstep(a,b,x)` は
+`t = clamp01((x-a)/(b-a))`、`t²(3-2t)` である。
+
+演算順は固定で、次の順に進める。
+
+1. exposure: `c *= 2^exposure`。
+2. white balance: `r *= 1 + temperature*0.18`、`b *= 1 - temperature*0.18`、
+   `g *= 1 - tint*0.12` とし、各チャンネルを `clamp01` する。
+3. tone zones: highlights → shadows → whites → blacks の順に処理する。各有効ステップの直前に
+   現在の `c` から luma を再計算し、処理後は各チャンネルを `clamp01` する。
+   - highlights: `c *= 1 + highlights*smoothstep(0.5,0.9,Y(c))`
+   - shadows: `c *= 1 + shadows*(1-smoothstep(0.1,0.5,Y(c)))`
+   - whites: `c += whites*smoothstep(0.7,1.0,Y(c))*0.3`
+   - blacks: `c += blacks*(1-smoothstep(0.0,0.3,Y(c)))*0.3`
+4. contrast: 各チャンネルを `(c-0.5)*(1+contrast)+0.5` とし、`clamp01` する。pivot は `0.5`。
+5. saturation: 現在の Rec.709 luma を使い、各チャンネルを
+   `Y(c) + (c-Y(c))*(1+saturation)` として `clamp01` する。
+6. vibrance: 現在値の `max` と `min` から
+   `S = max > 1e-6 ? (max-min)/max : 0`、`amount = vibrance*(1-S)` を求め、各チャンネルを
+   `Y(c) + (c-Y(c))*(1+amount)` として `clamp01` する。
+7. 外部 LUT: `lut` が有効なら trilinear sampler で `c` を置換し、`intensity` で identity 入力と
+   LUT 出力を線形混合する。
+
+定数の正本値は `REC709 = (0.2126, 0.7152, 0.0722)`、`TEMP_COEF = 0.18`、
+`TINT_COEF = 0.12`、`CONTRAST_PIVOT = 0.5` である。基本補正を LUT に bake する消費者は
+`LUT_3D_SIZE 33`、R fastest → G → B、各成分小数 6 桁とし、適用時は trilinear 補間する。
+
+## 4. 解決順とバイパス
+
+処理順は次で固定する。
+
+1. item の `adjust.basic`
+2. 同じ item の `adjust.lut`
+3. timeline 上の item 合成
+4. `output.look`（全体へ掛けるグローバル LUT）
+
+`adjust.lut.lut` の参照解決は `output.look.lut` と同じである。値にスラッシュが無ければ
+`presets/luts/<id>/<id>.cube`、スラッシュがあればプロジェクトルート相対パスとして解決する。
+パス区切りは Windows と POSIX の双方を扱う。
+
+`sections` は疎辞書であり、`sections.basic === false` のときだけ基本補正全体を、
+`sections.lut === false` のときだけ item LUT をバイパスする。キー省略は有効を意味する。
+**OFF はプレビューと書き出しの両方で必ずバイパスする。** 一方だけで OFF を無視したり、
+プレビューと書き出しで結果をずらしたりしてはならない。
+
+## 5. 消費側の約束
+
+最終消費者は GPU export と OSR export の 2 出口である。両者は同じ `adjust` 値、33³ bake、
+LUT 参照解決、適用順、sections バイパスを使い、受領情報にも item adjust の適用状況を残す。
+
+プレビューには frame-engine WebGL2 レールと DOM fallback レールがある。WebGL2 は item / quad 単位の
+LUT として適用し、DOM fallback は表現可能な基本補正を CSS 近似し、表現できない項目や LUT を
+黙って同等と称さない。どちらのレールでも `sections.* === false` を先に評価する。frame-engine active
+時は DOM fallback と二重適用しない。
+
+M1 時点では edit-store が `adjust` を内部 item declaration へ損失なく射影するところまでであり、
+GPU / OSR / frame-engine / DOM preview は未消費である。能力台帳は全 visual item 用途について
+`gpu: ignored`、`osr: ignored`、`runtime_warning: true` とし、frame-engine の未知キー警告へ到達させる。
+消費実装を導入する便でのみ、実測と同時に `consumed` へ反転する。
+
+## 6. lint 分担
+
+- JSON Schema は閉じた object、型、数値範囲、必須の `lut` 文字列、visual/audio の席を検査する。
+- `validate-edit.mjs` は依存を増やさず、同じ構造制約を手書きで検査する。
+- edit-store の v2 reader は未知キーを拒否し、型と範囲を検査して内部 declaration へ射影する。
+- edit-lint は依存ゼロを守るため同じ構造検証を意図的に重複実装する。構造が正しい場合も、M1 の
+  能力台帳に従い `--engine gpu|osr|auto` で `engine.unsupported-field` error を出す。
+
+構造エラーと未消費エラーを混同しない。構造が不正な文書は engine 能力判定へ進めない。
+
+## 7. 書き込み側・パネル側の約束
+
+書き込み側は version 2 の visual item だけを編集対象にする。version 0 / 1 を平坦な近似語彙へ
+書き換えない。`basic` が全て `0` または省略、`lut` が `null` または省略で、`sections` 以外に
+効果が無い identity 状態は `adjust` field 自体を削除する。schema は読み込み互換のため identity
+object を拒否しないが、正規の保存形は field 省略である。
+
+パネルで section を OFF にしても値は保持してよい。再度 ON にしたとき同じ値へ戻せる一方、消費側は
+OFF 中の値を必ず無視する。UI が値を表示・更新できることと、エンジンが消費済みであることは別であり、
+未消費の間は lint error と runtime warning を隠さない。
+
+## 8. 非スコープ
+
+- version 0 / 1 の `cuts[]` / `layers[]` への席追加
+- RGB curves、color wheels / CDL、hue curves、effects（M2 の語彙）
+- vignette（空間処理であり basic/LUT bake の対象外）
+- 本便での compositor、page-builder、preview、inspector、preset カタログの実装
+- 複数 LUT の `luts[]`、adjust layer の `layers[]` など v0 を越える構造

package/vendor/docs/contract-2026-09-03-preview-playback-rate-v1.md

@@ -0,0 +1,52 @@
+---
+lifecycle: accepted
+created: 2026-09-03
+updated: 2026-09-03
+---
+
+# プレビュー再生速度・ピッチ保持契約 v1
+
+## 1. UI と状態
+
+プレビューのトランスポート右側は pen → rate → zoom → fullscreen の順とする。rate ボタンは
+アイコンではなく現在値を `0.5×` の形式で表示し、ポップアップから
+`0.5 / 0.75 / 1 / 1.25 / 1.5 / 2 / 3` の 7 値を選ぶ。値域は 0.5 以上 3 以下である。
+スライダーとキーボードショートカットは設けない。
+
+速度の正本は webview の `previewRate` とする。変更値は host の当該 preview widget にだけ保持し、
+インスペクター編集による incremental 更新と webview 再構築を跨いで復元する。ディスク、Theia
+preferences、edit.json には保存せず、widget を閉じた後の新しいプレビューは 1× から始める。
+raw 素材プレビューにも同じ UI と速度を適用する。
+
+## 2. `rate` の意味
+
+`previewRate` は「出力タイムライン秒 / 実時間秒」である。`playbackTick.rate` とレビューセッションの
+`reviewTransport` に記録する `type: "rate"` の `value` は、どちらもこの値を送る。legacy の cut に
+宣言された `segment.speed` は素材秒と出力秒の写像であり、レビューの rate イベントには送らない。
+従来の segment speed 変更イベントは廃止する。
+
+frame-engine の時計は経過実時間へ `previewRate` を掛ける。legacy の動画要素は
+`segment.speed × previewRate` で再生し、gap と静止画は壁時計へ `previewRate` を掛ける。
+freeze の実時間ホールドは宣言秒を `previewRate` で割る。速度変更時は現在位置に錨を打ち直し、
+再生ヘッドを飛ばさない。
+
+## 3. 音声とピッチ保持
+
+frame-engine 経路では全音源を `PreviewAudioSupply` の master gain に集め、音源の予定時刻と
+AudioContext 時計を `previewRate` で進める。legacy 経路でも previewAudio の BGM・SFX・ナレーションを
+同じ倍率で再予定する。legacy の動画要素（台詞を含む）は `preservesPitch = true` を明示する。
+
+1× は master gain から destination への直結である。1× 以外は共通の
+`preview-audio-worklet.js` と `akari-pitch-shift` processor を使い、速度 r で再生した全音声へ
+ratio `1 / r` のピッチ補正を掛ける。worklet の準備前は速度だけを先に反映し、準備完了後に経路へ
+差し込む。読み込み失敗または AudioWorklet 非対応時も再生を止めず、警告を 1 行出して素の速度へ
+フォールバックする。
+
+frame-engine の `debug()` は `rate`、`pitchPreserved`、`stretcher` を返す。`stretcher` は
+`"worklet" | "none"`、`pitchPreserved` は 1× または worklet が実際の経路に入った場合だけ true とする。
+`attachAnalyser()` は master bus 出口へ AnalyserNode を一つだけ接続し、検収用の tap として返す。
+
+## 4. 非目標
+
+本機能はプレビュー専用である。書き出しの速度・音声処理には影響せず、edit.json の内容も変えない。
+速度の preferences 永続化、キーボードショートカット、速度スライダーは本契約の対象外とする。

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

@@ -1,6 +1,6 @@
 {
   "name": "akari-video",
-  "version": "0.1.39",
+  "version": "0.1.41",
   "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/audio-library-setup/shared/bgm-suggest.mjs

@@ -1,8 +1,8 @@
 // BGM 自動提案（v0）— intake / 演出の tone 語彙 × AKARI Sounds のトラック系統の突き合わせ。
 //
 // 設計方針:
-// - tone 語彙は表現選定（skills/edit-plan/expression-selection.md / presets/telop の tone）と
-//   同じ 8 語に固定する。BGM だけ別の語彙を発明しない
+// - tone 語彙は表現選定（skills/edit-plan/expression-selection.md）と同じ 8 語に固定する。
+//   BGM だけ別の語彙を発明しない
 // - 対応表は「系統（トラック id の接頭辞）→ tone 重み」の宣言表。トラック個別の
 //   when_to_use（宣言パック = 有償レイヤ）には依存しない — 無料の catalog.json（tags / id）
 //   だけで動く

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

@@ -1086,6 +1086,9 @@ function validateEditV2(edit, findings) {
             });
           }
         }
+        if (Object.hasOwn(item, "adjust")) {
+          validateAdjust(item.adjust, findings, `${itemPath}.adjust`);
+        }
         if (Array.isArray(item.items)) visit(item.items, item, `${itemPath}.items`);
       }
     };
@@ -1421,6 +1424,14 @@ async function validateV2ObjectTreeFiles(edit, findings, paths) {
 
   const referencedMotion = new Set();
   for (const { item, path: itemPath } of entries) {
+    if (item.source?.kind === "telop" && item.source.baked === undefined) {
+      addFinding(findings, {
+        severity: "error",
+        check: "telop.retired",
+        message: "テロップ（ATF）の描画は退役しました。HTML 素材版のテロップに差し替えてください（Lab で配布）。すでに焼いた baked を持つ項目はそのまま再生できます。",
+        path: `${itemPath}.source`,
+      });
+    }
     if (isRecord(item.keyframes) && isNonEmptyString(item.keyframes.path)) {
       referencedMotion.add(item.keyframes.path);
       const filePath = resolve(paths.projectRoot, item.keyframes.path);
@@ -1551,6 +1562,104 @@ function validateLook(value, findings, path) {
   }
 }
 
+// docs/contract-2026-09-03-clip-adjust-v0.md。edit-lint は依存ゼロを保つため、schema と
+// validate-edit.mjs の閉じた adjust 語彙をここでも独立に検証する。
+function validateAdjust(value, findings, path) {
+  if (!isRecord(value)) {
+    addFinding(findings, {
+      severity: "error", check: "adjust.structure", message: "adjust must be an object", path,
+    });
+    return;
+  }
+  const reportUnknownKeys = (record, allowed, ownerPath) => {
+    for (const key of Object.keys(record)) {
+      if (allowed.has(key)) continue;
+      addFinding(findings, {
+        severity: "error",
+        check: "adjust.unknown-key",
+        message: `${key} is not defined by clip adjust v0`,
+        path: `${ownerPath}.${key}`,
+      });
+    }
+  };
+  reportUnknownKeys(value, new Set(["basic", "lut", "sections"]), path);
+
+  if (Object.hasOwn(value, "basic")) {
+    const basicPath = `${path}.basic`;
+    if (!isRecord(value.basic)) {
+      addFinding(findings, {
+        severity: "error", check: "adjust.basic.structure", message: "basic must be an object", path: basicPath,
+      });
+    } else {
+      const basicKeys = new Set([
+        "exposure", "contrast", "highlights", "shadows", "blacks", "whites",
+        "temperature", "tint", "vibrance", "saturation",
+      ]);
+      reportUnknownKeys(value.basic, basicKeys, basicPath);
+      for (const key of basicKeys) {
+        if (!Object.hasOwn(value.basic, key)) continue;
+        const minimum = key === "exposure" ? -3 : -1;
+        const maximum = key === "exposure" ? 3 : 1;
+        if (!isFiniteNumber(value.basic[key]) || value.basic[key] < minimum || value.basic[key] > maximum) {
+          addFinding(findings, {
+            severity: "error",
+            check: `adjust.basic.${key}`,
+            message: `${key} must be a finite number within [${minimum}, ${maximum}]`,
+            path: `${basicPath}.${key}`,
+          });
+        }
+      }
+    }
+  }
+
+  if (Object.hasOwn(value, "lut") && value.lut !== null) {
+    const lutPath = `${path}.lut`;
+    if (!isRecord(value.lut)) {
+      addFinding(findings, {
+        severity: "error", check: "adjust.lut.structure", message: "lut must be null or an object", path: lutPath,
+      });
+    } else {
+      reportUnknownKeys(value.lut, new Set(["lut", "intensity"]), lutPath);
+      if (!isNonEmptyString(value.lut.lut)) {
+        addFinding(findings, {
+          severity: "error", check: "adjust.lut.lut", message: "lut must be a non-empty string", path: `${lutPath}.lut`,
+        });
+      }
+      if (Object.hasOwn(value.lut, "intensity")
+        && (!isFiniteNumber(value.lut.intensity) || value.lut.intensity < 0 || value.lut.intensity > 1)) {
+        addFinding(findings, {
+          severity: "error",
+          check: "adjust.lut.intensity",
+          message: "intensity must be a finite number within [0, 1]",
+          path: `${lutPath}.intensity`,
+        });
+      }
+    }
+  }
+
+  if (Object.hasOwn(value, "sections")) {
+    const sectionsPath = `${path}.sections`;
+    if (!isRecord(value.sections)) {
+      addFinding(findings, {
+        severity: "error", check: "adjust.sections.structure", message: "sections must be an object", path: sectionsPath,
+      });
+    } else {
+      const sectionKeys = new Set(["basic", "lut"]);
+      reportUnknownKeys(value.sections, sectionKeys, sectionsPath);
+      for (const key of sectionKeys) {
+        if (Object.hasOwn(value.sections, key) && typeof value.sections[key] !== "boolean") {
+          addFinding(findings, {
+            severity: "error",
+            check: `adjust.sections.${key}`,
+            message: `${key} must be a boolean`,
+            path: `${sectionsPath}.${key}`,
+          });
+        }
+      }
+    }
+  }
+}
+
 function validateChromaKey(value, findings, path) {
   if (value === undefined || value === null) return;
   if (!isRecord(value)) {
@@ -2339,6 +2448,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/adjust-css-approx.d.ts

@@ -0,0 +1,2 @@
+import type { AdjustBasicV0 } from './edit-v2';
+export declare function adjustBasicToCssApprox(basic: AdjustBasicV0): string;

package/vendor/packages/edit-store/lib/adjust-css-approx.js

@@ -0,0 +1,31 @@
+"use strict";
+// Serialized into the preview webview via Function.prototype.toString() -- see
+// apps/shell/extensions/akari-preview/src/common/cut-framing-visual.ts for the established
+// pattern. Keep this function self-contained: no closures over module state and no calls to
+// sibling functions in this file.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.adjustBasicToCssApprox = adjustBasicToCssApprox;
+function adjustBasicToCssApprox(basic) {
+    const source = basic ?? {};
+    const exposure = Number.isFinite(source.exposure) ? source.exposure : 0;
+    const contrast = Number.isFinite(source.contrast) ? source.contrast : 0;
+    const saturation = Number.isFinite(source.saturation) ? source.saturation : 0;
+    const temperature = Number.isFinite(source.temperature) ? source.temperature : 0;
+    const parts = [];
+    if (Math.abs(exposure) > 0.005) {
+        parts.push(`brightness(${Math.pow(2, exposure).toFixed(2)})`);
+    }
+    if (Math.abs(contrast) > 0.005) {
+        parts.push(`contrast(${(1 + contrast).toFixed(2)})`);
+    }
+    if (Math.abs(saturation) > 0.005) {
+        parts.push(`saturate(${(1 + saturation).toFixed(2)})`);
+    }
+    if (temperature > 0.005) {
+        parts.push(`sepia(${(temperature * 0.3).toFixed(2)})`);
+    }
+    else if (temperature < -0.005) {
+        parts.push(`hue-rotate(${(-temperature * 20).toFixed(0)}deg)`);
+    }
+    return parts.join(' ');
+}

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

@@ -164,6 +164,30 @@ export interface CaptionSourceV2 {
     id: string;
 }
 export type SourceV2 = MediaSourceV2 | HtmlSourceV2 | ShapeSourceV2 | TelopSourceV2 | FilterSourceV2 | GroupSourceV2 | CaptionsSourceV2 | CaptionSourceV2;
+export interface AdjustBasicV0 {
+    exposure?: number;
+    contrast?: number;
+    highlights?: number;
+    shadows?: number;
+    blacks?: number;
+    whites?: number;
+    temperature?: number;
+    tint?: number;
+    vibrance?: number;
+    saturation?: number;
+}
+export interface AdjustLutV0 {
+    lut: string;
+    intensity?: number;
+}
+export interface AdjustV0 {
+    basic?: AdjustBasicV0;
+    lut?: AdjustLutV0 | null;
+    sections?: {
+        basic?: boolean;
+        lut?: boolean;
+    };
+}
 export interface ItemV2Base {
     id: string;
     name?: string;
@@ -186,6 +210,7 @@ export interface ItemV2Base {
     opacity?: number;
     blend?: BlendModeV2;
     crop?: CropV2;
+    adjust?: AdjustV0;
     perspective?: Record<string, unknown>;
     motion?: MotionV0;
     animator?: AnimatorV0[];

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

@@ -9,7 +9,7 @@ const SHAPE_KINDS = new Set([
     'rect', 'rounded-rect', 'ellipse', 'line', 'arrow', 'speech-bubble'
 ]);
 const ITEM_KEYS = new Set([
-    'id', 'name', 'hidden', 'locked', 'at', 'duration', 'transform', 'opacity', 'blend', 'crop', 'perspective',
+    'id', 'name', 'hidden', 'locked', 'at', 'duration', 'transform', 'opacity', 'blend', 'crop', 'adjust', 'perspective',
     'motion', 'animator', 'keyframes', 'items', 'mask', 'source'
 ]);
 const AUDIO_ITEM_KEYS = new Set([
@@ -265,6 +265,8 @@ function validateItem(value, path, ids, sourceIds) {
     }
     if (hasOwn(value, 'crop'))
         validateCrop(value.crop, `${path}.crop`);
+    if (hasOwn(value, 'adjust'))
+        validateAdjust(value.adjust, `${path}.adjust`);
     if (hasOwn(value, 'perspective'))
         requireRecord(value.perspective, `${path}.perspective`);
     if (hasOwn(value, 'motion'))
@@ -457,6 +459,41 @@ function validateCrop(value, path) {
             throw invalid(`${path}.${key}`, '0 より大きい必要があります');
     }
 }
+function validateAdjust(value, path) {
+    requireRecord(value, path);
+    requireExactKeys(value, new Set(['basic', 'lut', 'sections']), path);
+    if (hasOwn(value, 'basic')) {
+        requireRecord(value.basic, `${path}.basic`);
+        const basicKeys = new Set([
+            'exposure', 'contrast', 'highlights', 'shadows', 'blacks', 'whites',
+            'temperature', 'tint', 'vibrance', 'saturation'
+        ]);
+        requireExactKeys(value.basic, basicKeys, `${path}.basic`);
+        for (const key of basicKeys) {
+            if (!hasOwn(value.basic, key))
+                continue;
+            const [minimum, maximum] = key === 'exposure' ? [-3, 3] : [-1, 1];
+            requireRange(value.basic[key], minimum, maximum, `${path}.basic.${key}`);
+        }
+    }
+    if (hasOwn(value, 'lut') && value.lut !== null) {
+        requireRecord(value.lut, `${path}.lut`);
+        requireExactKeys(value.lut, new Set(['lut', 'intensity']), `${path}.lut`);
+        requireText(value.lut.lut, `${path}.lut.lut`);
+        if (hasOwn(value.lut, 'intensity'))
+            requireRange(value.lut.intensity, 0, 1, `${path}.lut.intensity`);
+    }
+    if (hasOwn(value, 'sections')) {
+        requireRecord(value.sections, `${path}.sections`);
+        const sectionKeys = new Set(['basic', 'lut']);
+        requireExactKeys(value.sections, sectionKeys, `${path}.sections`);
+        for (const key of sectionKeys) {
+            if (hasOwn(value.sections, key) && typeof value.sections[key] !== 'boolean') {
+                throw invalid(`${path}.sections.${key}`, 'boolean である必要があります');
+            }
+        }
+    }
+}
 const EASINGS = new Set([
     'linear', 'ease-in-out', 'in-quad', 'out-quad', 'in-out-quad', 'in-cubic', 'out-cubic',
     'in-out-cubic', 'in-quart', 'out-quart', 'in-out-quart', 'in-expo', 'out-expo', 'in-out-expo',

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

@@ -1,4 +1,4 @@
-export declare const ITEM_V2_KEYS: readonly ["id", "name", "hidden", "locked", "at", "duration", "anchor", "transform", "opacity", "blend", "crop", "perspective", "motion", "animator", "keyframes", "items", "mask", "source", "role", "gain_db", "denoise", "lowcut_hz", "fade_in", "fade_out", "ducking", "duck_db", "duck_attack", "duck_release", "script", "reading", "provenance"];
+export declare const ITEM_V2_KEYS: readonly ["id", "name", "hidden", "locked", "at", "duration", "anchor", "transform", "opacity", "blend", "crop", "adjust", "perspective", "motion", "animator", "keyframes", "items", "mask", "source", "role", "gain_db", "denoise", "lowcut_hz", "fade_in", "fade_out", "ducking", "duck_db", "duck_attack", "duck_release", "script", "reading", "provenance"];
 export declare const ITEM_SOURCE_V2_KEYS: readonly ["kind", "src", "in", "out", "framing", "transition_out", "freeze", "fx", "speed", "chroma_key", "pitch_semitones", "formant", "path", "part", "style", "text", "exclude", "derivedFrom", "vars", "params", "shape", "preset", "baked", "from", "filter", "id"];
 export declare const KEYFRAME_V2_KEYS: readonly ["t", "transform", "crop", "perspective", "opacity", "gain_db", "animator", "easing"];
 export declare const MOTION_V0_KEYS: readonly ["in", "out", "loop"];
@@ -6,14 +6,14 @@ export declare const ANIMATOR_V0_KEYS: readonly ["id", "basis", "shape", "start"
 export declare const MOTION_FILE_V0_KEYS: readonly ["version", "group", "items"];
 export declare const SOURCE_KIND_V2: readonly ["media", "html", "shape", "telop", "filter", "group", "captions", "caption"];
 export declare const ITEM_V2_KEYS_BY_DEFINITION: {
-    readonly itemV2Media: readonly ["id", "name", "hidden", "locked", "at", "duration", "anchor", "transform", "opacity", "blend", "crop", "perspective", "motion", "animator", "keyframes", "items", "mask", "source"];
-    readonly itemV2Html: readonly ["id", "name", "hidden", "locked", "at", "duration", "anchor", "transform", "opacity", "blend", "crop", "perspective", "motion", "animator", "keyframes", "items", "source"];
+    readonly itemV2Media: readonly ["id", "name", "hidden", "locked", "at", "duration", "anchor", "transform", "opacity", "blend", "crop", "adjust", "perspective", "motion", "animator", "keyframes", "items", "mask", "source"];
+    readonly itemV2Html: readonly ["id", "name", "hidden", "locked", "at", "duration", "anchor", "transform", "opacity", "blend", "crop", "adjust", "perspective", "motion", "animator", "keyframes", "items", "source"];
     readonly itemV2Shape: readonly ["id", "name", "hidden", "locked", "at", "duration", "anchor", "transform", "opacity", "blend", "crop", "perspective", "motion", "animator", "keyframes", "items", "source"];
-    readonly itemV2Telop: readonly ["id", "name", "hidden", "locked", "at", "duration", "anchor", "transform", "opacity", "blend", "crop", "perspective", "motion", "animator", "keyframes", "items", "source"];
-    readonly itemV2Filter: readonly ["id", "name", "hidden", "locked", "at", "duration", "anchor", "transform", "opacity", "blend", "crop", "perspective", "motion", "animator", "keyframes", "items", "source"];
-    readonly itemV2Group: readonly ["id", "name", "hidden", "locked", "at", "duration", "anchor", "transform", "opacity", "blend", "crop", "perspective", "motion", "animator", "keyframes", "items", "source"];
-    readonly itemV2Captions: readonly ["id", "name", "hidden", "locked", "at", "duration", "transform", "opacity", "blend", "crop", "perspective", "motion", "animator", "keyframes", "items", "source"];
-    readonly itemV2Caption: readonly ["id", "name", "hidden", "locked", "at", "duration", "transform", "opacity", "blend", "crop", "perspective", "motion", "animator", "keyframes", "items", "source"];
+    readonly itemV2Telop: readonly ["id", "name", "hidden", "locked", "at", "duration", "anchor", "transform", "opacity", "blend", "crop", "adjust", "perspective", "motion", "animator", "keyframes", "items", "source"];
+    readonly itemV2Filter: readonly ["id", "name", "hidden", "locked", "at", "duration", "anchor", "transform", "opacity", "blend", "crop", "adjust", "perspective", "motion", "animator", "keyframes", "items", "source"];
+    readonly itemV2Group: readonly ["id", "name", "hidden", "locked", "at", "duration", "anchor", "transform", "opacity", "blend", "crop", "adjust", "perspective", "motion", "animator", "keyframes", "items", "source"];
+    readonly itemV2Captions: readonly ["id", "name", "hidden", "locked", "at", "duration", "transform", "opacity", "blend", "crop", "adjust", "perspective", "motion", "animator", "keyframes", "items", "source"];
+    readonly itemV2Caption: readonly ["id", "name", "hidden", "locked", "at", "duration", "transform", "opacity", "blend", "crop", "adjust", "perspective", "motion", "animator", "keyframes", "items", "source"];
     readonly itemV2AudioMedia: readonly ["id", "name", "hidden", "locked", "at", "duration", "role", "source", "gain_db", "denoise", "lowcut_hz", "keyframes", "fade_in", "fade_out", "ducking", "duck_db", "duck_attack", "duck_release", "script", "reading", "provenance"];
 };
 export declare const ITEM_SOURCE_V2_KEYS_BY_DEFINITION: {