akari-video 0.1.45 → 0.1.47

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akari-video",
-  "version": "0.1.45",
+  "version": "0.1.47",
   "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

@@ -64,6 +64,7 @@
     "docs/contract-2026-09-03-clip-adjust-v0.md",
     "docs/contract-2026-09-03-preview-playback-rate-v1.md",
     "docs/contract-2026-09-05-clip-adjust-v1.md",
+    "docs/contract-2026-09-06-vgpu-layer-v0.md",
     "packages/akari-launcher/package.json",
     "packages/akari-launcher/README.md",
     "packages/akari-tools/package.json",

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

@@ -21,6 +21,7 @@
 |---|---|---|
 | `same` | はい | 静的 HTML は起動時、対応済み字幕は unit の初回活性時に 1 回だけスプライト化する |
 | `three` | はい | JSON の宣言型 3D scene と描画先 canvas を持つ overlay。毎コマ Three.js canvas を更新し、登場表現は `three-scene-entrance-curve`、`three-scene-entrance-sampled`、または `three-scene-sampled-composite` で処理する |
+| `vgpu` | はい | pure な `data-akari-vgpu-scene` を WebGPU canvas に描き、毎コマスプライトへ転送する（[vgpu v0 契約](./contract-2026-09-06-vgpu-layer-v0.md)） |
 | `degraded` | いいえ | raster 自体は可能でも live DOM と同じ時間変化を保証できない |
 | `unsupported` | いいえ | v0 の表現範囲外であり、正しい完成画を生成できない |
 
@@ -320,6 +321,8 @@ CSS 3D は次の 3 群に分けて判定する。
   子孫の描画域が画面上で交差し、手前の要素が DOM 上で先に描かれる矛盾対を検出した場合は警告するが、
   fail-closed にはしない。
 
+vgpu の理由語彙は `vgpu-scene-canvas-direct`、`vgpu-stateful-unsupported`、`vgpu-invalid-declaration`、`vgpu-condition:<条件をカンマ連結>`（[vgpu v0 契約](./contract-2026-09-06-vgpu-layer-v0.md)）。
+
 次の条件は fail-closed のまま `degraded` とし、receipt に overlay id、理由、検出条件を全件残す。
 
 - `iframe`、`object`、`embed` の埋め込み context。

package/vendor/docs/contract-2026-08-28-v2-audio-roles-v0.md

@@ -128,6 +128,17 @@ ms へ換算し、絶対値で集計する。全 59 点の最大は 16.667 ms、
 書き出しはこの speech 鍵を消費する。プレビューサーバーへ speech 鍵を渡す配線は同契約の範囲外で、
 配線されるまでは narration 鍵だけへ劣化する。
 
+`tracks[].items[].source`（`kind: 'media'`）の `gain_db`（-60〜12・省略時 0）と
+`mute`（boolean・省略時 false）で、カットごとに埋め込み音声を減衰 / ミュートできる。
+`mute: true` は speech 宣言そのものを作らず、プレビューのサイドカー要求も PCM 化のコストも消える。
+書き出しは無音区間で尺を保つ。キー無しの既定値は従来と完全同一で、既存案件の出力は変わらない。
+
+### 6.1 トラック単位の `tracks[].muted`
+
+`muted?: boolean` は省略時 false。visual トラックの `muted: true` は cut の埋め込み音声を anullsrc に置き換え、尺は保つ（video layer は対象外）。
+audio トラックの `muted: true` は item を書き出し・プレビューの mix から除外し、ducking の対象からも外れる。
+トラックの `hidden` / `locked` は従来どおり storage 側で保持し、edit.json には出ない。
+
 ## 7. 速度変更した台詞のピッチ保持サイドカー
 
 `speed` が 1 以外の撮影素材の台詞は、Web Audio の `playbackRate` による近似から外す。

package/vendor/docs/contract-2026-08-30-motion-and-keyframes-v0.md

@@ -44,6 +44,21 @@ updated: 2026-08-30
 - HTML 部品の L0 は既存どおり `vars`（CSS 変数 `--anim-duration / stagger / distance / easing / delay`）。`motion` は native アイテム（telop / media / caption / group）用
 - グループの `motion` は子全体にかかる（グループ = 小さなコンポジション）
 
+- **実装状態（2026-09-06）**: frame-engine の layer / cut 評価で `motion` を描画する。シェルプレビュー / gpu / osr の 3 出口で同じ評価を使う
+- `amount` の既定値は次表。`scale` / `pulse` は倍率に対する差分（0.2 = 20%）、`spin` は回転方向（±1）
+
+| プリセット | `amount` の既定値 |
+|---|---|
+| `slide-up` / `slide-down` / `slide-left` / `slide-right` | 40 px |
+| `scale` | 0.2 |
+| `pulse` | 0.05 |
+| `float` | 6 px |
+| `spin` | 1（回転方向）|
+
+- 合成は **keyframes の結果（未指定なら静的値）に motion を合成する 1 段**。`in` / `out` / `loop` の `dx` / `dy` / `rotate` は加算、`scale` と `opacity` は乗算、`reveal`（wipe）は交差
+- `wipe` は crop 窓の中の表示率 `reveal` で表し、隠れた部分は完全透過。閉じた端点でも crop の幅・高さは `Number.EPSILON` 以上を保ち、opacity 0 で完全透過にする
+- `duration` / `period` が 0 以下・非有限、または未知 preset の席は描画で無視する。未知 preset は席ごとに lint warning `motion.unknown-preset`（path は `.motion.in` / `.motion.out` / `.motion.loop`）
+
 ## 2. L1 キーフレーム — `keyframes` の一般化
 
 ### 2.1 形（1 つだけ: 点形）

package/vendor/docs/contract-2026-09-06-vgpu-layer-v0.md

@@ -0,0 +1,166 @@
+---
+lifecycle: accepted
+date: 2026-09-06
+---
+
+# vgpu レイヤー v0 契約
+
+## 1. 適用範囲
+
+`data-akari-vgpu-scene` に宣言した WebGPU のフルスクリーン fragment パスを、
+`window.akari.vgpuRuntime` が外部から渡された時刻で描く。vgpu 0.4.0 は vendor 同梱し、
+実行時の依存取得は行わない。Three.js と同じ overlay sheet に置き、GPU 書き出しでは
+canvas を SpriteCompositor に登録する。毎コマ `render` の直後に `updateSprite` する。
+WebGPU canvas の提示面は一時的なので、描画せずに前回の canvas を転送してはならない。
+CPU への画素読み戻しはこの経路に追加しない。ブラウザ内部のゼロコピーを保証するものではない。
+
+## 2. 宣言スキーマ
+
+断片に次の script をちょうど 1 個置く。canvas は任意で、省略時はランタイムが作成する。
+
+```html
+<canvas></canvas>
+<script type="application/json" data-akari-vgpu-scene>
+{
+  "version": 0,
+  "mode": "pure",
+  "alphaMode": "premultiplied",
+  "seed": 0,
+  "uniforms": { "speed": 1 },
+  "passes": [{
+    "id": "main",
+    "wgsl": "struct Params { speed: f32 }; @group(0) @binding(1) var<uniform> params: Params; @fragment fn fs_main(@builtin(position) p: vec4f) -> @location(0) vec4f { let uv = akari_uv(p); return vec4f(uv, 0.5 + 0.5 * sin(akari.time * params.speed), 1.0); }",
+    "inputs": [],
+    "scale": 1
+  }]
+}
+</script>
+```
+
+| 項目 | 制約・既定値 |
+|---|---|
+| `version` | 必須、数値 `0` のみ |
+| `mode` | 必須、`pure` のみ。`stateful` は予約語で拒否 |
+| `alphaMode` | 省略時 `premultiplied`。それ以外は拒否。シェーダー出力の RGB も alpha 乗算済みにする |
+| `seed` | 任意の有限数。省略時 `0` |
+| `uniforms` | 任意の plain object。値は有限数、または長さ 2〜4 の有限数配列。省略時 `{}` |
+| `passes` | 必須、1 個以上の配列 |
+| `passes[].id` | 必須、`^[A-Za-z0-9_-]+$`、一意 |
+| `passes[].wgsl` | 必須、空白だけではない WGSL 文字列 |
+| `passes[].inputs` | 先行パス id の文字列配列、最大 8 個。省略時 `[]`。自己参照・前方参照不可 |
+| `passes[].scale` | 正の有限数、省略時 `1`。最終パスでは無視する |
+
+未知のトップレベルキー・pass キー、不正 JSON、不正な値は `readDescriptor` が TypeError にする。
+`uniforms` のキーは WGSL `Params` のメンバーに対応し、断片が
+`@group(0) @binding(1) var<uniform> params: Params;` を自分で宣言する。
+型は `f32` / `vec2f` / `vec3f` / `vec4f`。params 宣言のないパスには params を set しない。
+未宣言名・未束縛・WGSL コンパイルエラーは vgpu の検証を通じて失敗する。
+
+`pure` は「出力が指定時刻・seed・uniforms の純関数」の authoring 契約である。
+任意時刻へ直接シークでき、前回描画結果への feedback はない。任意の WGSL の数学的な純粋性を
+静的に証明するものではない。時刻を進める時計や乱数源を断片へ提供しない。
+
+## 3. 固定 prelude とパス
+
+各パスのソース先頭に次を付加する。
+
+```wgsl
+struct AkariUniforms { time: f32, aspect: f32, width: f32, height: f32, seed: f32, pad: vec3f };
+@group(0) @binding(0) var<uniform> akari: AkariUniforms;
+fn akari_uv(pos: vec4f) -> vec2f { return pos.xy / vec2f(akari.pad.x, akari.pad.y); }
+```
+
+入力があるパスには、入力数だけ texture 宣言と、共通 sampler 宣言を続ける。断片側で重複宣言しない。
+
+```wgsl
+@group(1) @binding(0) var input_0: texture_2d<f32>;
+// input_1 ... input_7 は必要な個数だけ binding 1 ... 7 に宣言
+@group(1) @binding(8) var input_sampler: sampler;
+```
+
+パスは配列順に、1 回の `frame(gpu, f => ...)` で直列描画する。
+最後のパスだけが surface、それ以前は `scale` 倍のオフスクリーン target へ描く。
+`input_i` には参照先 target の `color` を渡す。resize 後は新しい texture を再束縛する。
+`effect.draw(surface)` は使用しない（0.4.0 の surface は `frame` の `pass` で描く）。
+
+`akari.width/height` は常に等倍出力の container 実寸で、`aspect = width / height`。
+**`pad` は予約した形を維持しつつ実値を運ぶ**: x/y は当該パスの描画バッファ実幅・実高、z は previewScale。
+最終パスの x/y は canvas 実寸、中間パスはさらに pass.scale を掛けた target 実寸。
+固定 struct を変えず、`@builtin(position)` のピクセル座標を解像度に依存せず正規化するための裁定補足である。
+断片は `akari_uv(position)`、または vgpu の頂点段が供給する左上原点の `@location(0) uv` を使う。
+`position.xy / vec2f(akari.width, akari.height)` は縮小時に構図が変わるので使わない。
+
+## 4. API・解像度・ツマミ
+
+- `probe()` はページで 1 回だけ `init()` し、同じ Promise を返す。64×64 一時 surface に 2 コマ描画し、
+  GPU queue 完了と検証完了を待つ。device lost を初期化直後から監視し、一時 surface を破棄する。
+  成功値は `{ ok: true, adapter: { vendor, architecture }, ms }`。情報取得不可の文字列は空文字。
+- `render(container, localTimeSeconds, { previewScale })` は同期描画。時刻の源は引数のみ。
+  未初期化時は probe を開始して loading のまま戻る。書き出しホストは必ず先に probe を await する。
+  描画の同期エラーは `VGPU-RENDER:` を投げ、以後その container は no-op とする。
+  書き出しホストは inspect の error も確認し、空の層を成功扱いしない。
+- `inspect(container)` は `{ status, adapter, passes, previewScale, drawCount, deviceLost }`。
+  status は `idle`（宣言なし）、`loading`、`ready`、`error`。passes は構築したパス数。
+- `dispose(container)` は surface・target と自動作成 canvas を破棄する。共有 device は維持する。
+- `readDescriptor(container)` は宣言なしなら null、宣言不正なら TypeError。
+
+previewScale は辺あたり倍率で、未指定 `1`。推奨値は `1` / `0.5` / `0.25` だが、
+実装は有限数 `0 < s <= 1` を受け付ける。範囲外は警告 1 回で `1` にする。
+preview-server の既定は `PREVIEW_VGPU_SCALE = 0.5`。書き出しは options を渡さず常に `1`。
+canvas の CSS は absolute / inset 0 / width・height 100% / display block に固定する。
+内部画素だけが減り、位置・大きさ・時刻・ツマミは変わらない。描画寸法は丸め、最小 1 px。
+container が 0 サイズなら前回寸法を使い、前回もなければ描画しない。
+GPU 合成側は container の解決済み配置変換をスプライトへ渡し、プレビューの位置と拡縮を維持する。
+
+`--vgpu-<key>` が container の CSS にある場合は uniforms より優先する。
+数値または空白・カンマ区切りのベクトルを読み、宣言と同じ要素数で全部有限数の場合だけ採用する。
+不一致はキーごとに警告 1 回で宣言値を使う。既存の `vars` からそのまま設定できる。
+
+## 5. 適格性と receipt
+
+`item-keyframes` の後、three-only 判定の前に vgpu 判定を置く。
+検出条件は `vgpu-runtime`、canvas があればその次に `three-or-canvas-runtime`。
+
+| 分類 | 理由 |
+|---|---|
+| `vgpu` | `vgpu-scene-canvas-direct`: pure 宣言が妥当で、他条件が canvas 由来だけ |
+| `degraded` | `vgpu-stateful-unsupported`: stateful |
+| `degraded` | `vgpu-invalid-declaration`: JSON・version・mode・スキーマ不正 |
+| `degraded` | `vgpu-condition:<条件をカンマ連結>`: 他の動的条件や外部参照を含む |
+
+3D 宣言が同居する場合は、優先して
+`vgpu-condition:three-or-canvas-runtime(data-akari-3d-scene)` とする。
+その後、他条件、宣言検証の順に判定する。JSON はちょうど 1 宣言だけを受け付ける。
+`forceDegraded` は pure の vgpu 分類を変更しない。degraded になった vgpu は既存の規則どおり
+`forced-dom:<元理由>` で DOM 強制の対象となり、eligible は false のまま残る。
+
+`summary.vgpu` は件数が 1 以上のときだけ追加する。`spriteManifest.vgpu` は常に配列で、
+各要素は `{ id, start, duration, index, z }`。overlay sheet は three と vgpu のいずれかがある場合だけ作る。
+receipt の `gpu.vgpu` は run に vgpu があるときだけ、次の形で追加する。
+
+```json
+{ "overlays": 2, "adapter": { "vendor": "apple", "architecture": "metal-3" },
+  "previewScale": null, "deviceLost": false, "probeMs": 12.5 }
+```
+
+overlays は有限非負整数、adapter は文字列、previewScale は数値または null、
+deviceLost は boolean、probeMs は有限非負数または null に正規化する。
+summary と receipt を条件付きにしたのは、vgpu を使わない既存 fixture・receipt を byte/deep-equal で保つため。
+vgpu 不在の overlay sheet には新しい script や seek 文を一切挿入しない。
+
+## 6. fail-loud と v0 の限界
+
+- WebGPU 未提供・adapter null・初期化/試験描画失敗は `VGPU-UNAVAILABLE:` で probe を reject。
+- device lost 後の render は `VGPU-DEVICE-LOST:` で throw。復帰や別 device への切り替えは行わない。
+- `auto` でも `VGPU-` を含む失敗は OSR へフォールバックせずそのまま伝播する。
+- プレビューは失敗を捕捉し `[data-akari-vgpu-fallback]`（任意、断片の既定 display:none）を表示して、
+  console.warn を 1 回出す。他のプレビューは続行する。
+
+CLI の `--engine legacy` は既に廃止され、引数処理で拒否される。
+その CLI のエラーを変更せず、`renderProject(..., { engine: 'legacy' })` の API 直呼びには
+vgpu 宣言を検出した時点で `vgpu overlays require --engine gpu` を返す。これが元裁定の
+「engine 解決後の legacy 拒否」と異なる理由は、CLI からその分岐に到達できないためである。
+
+stateful・feedback・固定ステップ replay は未対応。OSR は同じ sheet を通すが v0 のパリティ gate 対象外。
+Windows / Linux / 他 GPU は未検証。同一機での 2 走・全コマ SHA 一致は実 GPU の検収で確認する事項であり、
+異機種間の浮動小数点の一致を保証しない。SwiftShader を WebGPU の代替として採用しない。

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

@@ -1,6 +1,6 @@
 {
   "name": "akari-video",
-  "version": "0.1.45",
+  "version": "0.1.47",
   "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

@@ -49,6 +49,8 @@ const { captionsHaveRenderableCues, collectFitBasisCandidates } = createRequire(
 
 const VERSION = 1;
 const EPSILON = 1e-6;
+const MOTION_IN_OUT_PRESETS = new Set(["fade", "slide-up", "slide-down", "slide-left", "slide-right", "scale", "wipe"]);
+const MOTION_LOOP_PRESETS = new Set(["pulse", "float", "spin"]);
 const REPOSITORY_ROOT = resolve(dirname(fileURLToPath(import.meta.url)), "../../..");
 const CAPTIONS_SCHEMA = JSON.parse(readFileSync(
   new URL("../../schemas/captions.schema.json", import.meta.url),
@@ -1073,6 +1075,18 @@ function validateEditV2(edit, findings) {
           });
         }
         if (isRecord(item.motion)) {
+          for (const seat of ["in", "out", "loop"]) {
+            const entry = item.motion[seat];
+            const presets = seat === "loop" ? MOTION_LOOP_PRESETS : MOTION_IN_OUT_PRESETS;
+            if (isRecord(entry) && typeof entry.preset === "string" && !presets.has(entry.preset)) {
+              addFinding(findings, {
+                severity: "warning",
+                check: "motion.unknown-preset",
+                message: `unknown motion ${seat} preset: ${entry.preset}; ignored when rendering`,
+                path: `${itemPath}.motion.${seat}`,
+              });
+            }
+          }
           const inDuration = isRecord(item.motion.in) && Number.isInteger(item.motion.in.duration)
             ? item.motion.in.duration : 0;
           const outDuration = isRecord(item.motion.out) && Number.isInteger(item.motion.out.duration)

package/vendor/packages/edit-store/lib/audio-schedule.d.ts

@@ -77,6 +77,7 @@ export interface WebAudioSpeechCut extends EditCut {
         duration_sec?: unknown;
     } | null;
     gain_db?: unknown;
+    mute?: unknown;
     gainDb?: unknown;
     volume_db?: unknown;
     transition_out?: EditCut['transitionOut'] | null;

package/vendor/packages/edit-store/lib/audio-schedule.js

@@ -299,6 +299,8 @@ function projectSpeechDeclarations(cuts, options) {
         const cut = normalizedCuts[segment.cutIndex];
         if (!cut || typeof cut.src !== 'string' || !cut.src)
             continue;
+        if (cut.mute === true)
+            continue;
         const speed = finitePositive(cut.speed) ? cut.speed : 1;
         const segmentIn = typeof segment.in === 'number' ? segment.in : cut.in;
         const cutTimelineStart = segment.outStart - (segmentIn - cut.in) / speed;

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

@@ -9,7 +9,7 @@ const ITEM_KEY_ORDER = [
     'blend', 'crop', 'perspective', 'motion', 'animator', 'keyframes', 'source', 'items'
 ];
 const EDIT_KEY_ORDER = ['version', 'output', 'sources', 'audio', 'tracks'];
-const TRACK_KEY_ORDER = ['id', 'lane', 'name', 'items', 'content'];
+const TRACK_KEY_ORDER = ['id', 'lane', 'name', 'muted', 'items', 'content'];
 const CAPTION_KEY_ORDER = [
     'id', 'start', 'end', 'text', 'speaker', 'sourceRef', 'edited', 'time_domain', 'text_style'
 ];

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

@@ -91,6 +91,10 @@ export interface MediaSourceV2 {
     freeze?: Record<string, unknown> | null;
     fx?: unknown[];
     speed?: number;
+    /** 埋め込み音声（speech）の音量 dB。-60〜12・省略時 0。 */
+    gain_db?: number;
+    /** 埋め込み音声（speech）のミュート。省略時 false。 */
+    mute?: boolean;
     chroma_key?: Record<string, unknown> | null;
 }
 export interface AudioMediaSourceV2 {
@@ -321,12 +325,16 @@ export interface VisualItemsTrackV2 {
     id: string;
     lane: 'visual';
     name?: string;
+    /** トラックの音声をミュート。visual は cut の埋め込み音声、audio は item を書き出し・プレビューから除外。 */
+    muted?: boolean;
     items: ItemV2[];
 }
 export interface AudioItemsTrackV2 {
     id: string;
     lane: 'audio';
     name?: string;
+    /** トラックの音声をミュート。visual は cut の埋め込み音声、audio は item を書き出し・プレビューから除外。 */
+    muted?: boolean;
     items: AudioMediaItemV2[];
 }
 export type ItemsTrackV2 = VisualItemsTrackV2 | AudioItemsTrackV2;
@@ -334,6 +342,8 @@ export interface ContentTrackV2 {
     id: string;
     lane: LaneV2;
     name?: string;
+    /** トラックの音声をミュート。visual は cut の埋め込み音声、audio は item を書き出し・プレビューから除外。 */
+    muted?: boolean;
     content: CaptionTrackContentV2;
 }
 export type TrackV2 = ItemsTrackV2 | ContentTrackV2;

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

@@ -120,7 +120,7 @@ function validateEditSource(value, index, ids) {
 function validateTrack(value, index, trackIds, itemIds, sourceIds) {
     const path = `edit.json.tracks[${index}]`;
     requireRecord(value, path);
-    requireExactKeys(value, new Set(['id', 'lane', 'name', 'items', 'content']), path);
+    requireExactKeys(value, new Set(['id', 'lane', 'name', 'muted', 'items', 'content']), path);
     requireText(value.id, `${path}.id`);
     if (trackIds.has(value.id))
         throw invalid(`${path}.id`, `track id が重複しています: ${value.id}`);
@@ -131,6 +131,9 @@ function validateTrack(value, index, trackIds, itemIds, sourceIds) {
     if (hasOwn(value, 'name') && typeof value.name !== 'string') {
         throw invalid(`${path}.name`, '文字列である必要があります');
     }
+    if (hasOwn(value, 'muted') && typeof value.muted !== 'boolean') {
+        throw invalid(`${path}.muted`, 'boolean である必要があります');
+    }
     const hasItems = hasOwn(value, 'items');
     const hasContent = hasOwn(value, 'content');
     if (hasItems === hasContent) {
@@ -302,7 +305,7 @@ function validateItemSource(value, path, sourceIds) {
     switch (value.kind) {
         case 'media':
             requireExactKeys(value, new Set([
-                'kind', 'src', 'in', 'out', 'framing', 'transition_out', 'freeze', 'fx', 'speed', 'chroma_key'
+                'kind', 'src', 'in', 'out', 'framing', 'transition_out', 'freeze', 'fx', 'speed', 'chroma_key', 'gain_db', 'mute'
             ]), path);
             requireText(value.src, `${path}.src`);
             if (!sourceIds.has(value.src))
@@ -319,6 +322,10 @@ function validateItemSource(value, path, sourceIds) {
                 throw invalid(`${path}.fx`, '配列である必要があります');
             if (hasOwn(value, 'speed'))
                 requirePositiveNumber(value.speed, `${path}.speed`);
+            if (hasOwn(value, 'gain_db'))
+                requireRange(value.gain_db, -60, 12, `${path}.gain_db`);
+            if (hasOwn(value, 'mute') && typeof value.mute !== 'boolean')
+                throw invalid(`${path}.mute`, 'boolean である必要があります');
             return;
         case 'html':
             requireExactKeys(value, new Set(['kind', 'path', 'part', 'style', 'text', 'exclude', 'derivedFrom', 'vars', 'params']), path);

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

@@ -1,5 +1,5 @@
 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 ITEM_SOURCE_V2_KEYS: readonly ["kind", "src", "in", "out", "framing", "transition_out", "freeze", "fx", "speed", "gain_db", "mute", "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"];
 export declare const ANIMATOR_V0_KEYS: readonly ["id", "basis", "shape", "start", "end", "offset", "randomize", "amount", "ease"];
@@ -17,7 +17,7 @@ export declare const ITEM_V2_KEYS_BY_DEFINITION: {
     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: {
-    readonly itemSourceMediaV2: readonly ["kind", "src", "in", "out", "framing", "transition_out", "freeze", "fx", "speed", "chroma_key"];
+    readonly itemSourceMediaV2: readonly ["kind", "src", "in", "out", "framing", "transition_out", "freeze", "fx", "speed", "gain_db", "mute", "chroma_key"];
     readonly itemSourceAudioMediaV2: readonly ["kind", "src", "in", "out", "speed", "pitch_semitones", "formant"];
     readonly itemSourceHtmlV2: readonly ["kind", "path", "part", "style", "text", "exclude", "derivedFrom", "vars", "params"];
     readonly itemSourceShapeV2: readonly ["kind", "shape", "params"];

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

@@ -4,7 +4,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ITEM_SOURCE_V2_KEYS_BY_DEFINITION = exports.ITEM_V2_KEYS_BY_DEFINITION = exports.SOURCE_KIND_V2 = exports.MOTION_FILE_V0_KEYS = exports.ANIMATOR_V0_KEYS = exports.MOTION_V0_KEYS = exports.KEYFRAME_V2_KEYS = exports.ITEM_SOURCE_V2_KEYS = exports.ITEM_V2_KEYS = void 0;
 exports.ITEM_V2_KEYS = ["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"];
-exports.ITEM_SOURCE_V2_KEYS = ["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"];
+exports.ITEM_SOURCE_V2_KEYS = ["kind", "src", "in", "out", "framing", "transition_out", "freeze", "fx", "speed", "gain_db", "mute", "chroma_key", "pitch_semitones", "formant", "path", "part", "style", "text", "exclude", "derivedFrom", "vars", "params", "shape", "preset", "baked", "from", "filter", "id"];
 exports.KEYFRAME_V2_KEYS = ["t", "transform", "crop", "perspective", "opacity", "gain_db", "animator", "easing"];
 exports.MOTION_V0_KEYS = ["in", "out", "loop"];
 exports.ANIMATOR_V0_KEYS = ["id", "basis", "shape", "start", "end", "offset", "randomize", "amount", "ease"];
@@ -204,6 +204,8 @@ exports.ITEM_SOURCE_V2_KEYS_BY_DEFINITION = {
         "freeze",
         "fx",
         "speed",
+        "gain_db",
+        "mute",
         "chroma_key"
     ],
     "itemSourceAudioMediaV2": [

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

@@ -227,6 +227,7 @@ function readV2Internal(raw) {
             lane: track.lane,
             z: track.z,
             ...(track.name !== undefined ? { name: track.name } : {}),
+            ...(track.muted === undefined ? {} : { muted: track.muted }),
             origin: 'declared',
             ...('content' in track ? { content: { from: 'captions.json' } } : {}),
             items,
@@ -962,6 +963,8 @@ function copyMediaSourceFields(source) {
         ...(source.freeze !== undefined ? { freeze: source.freeze } : {}),
         ...(source.fx !== undefined ? { fx: source.fx } : {}),
         ...(source.speed !== undefined ? { speed: source.speed } : {}),
+        ...(source.gain_db !== undefined ? { gain_db: source.gain_db } : {}),
+        ...(source.mute !== undefined ? { mute: source.mute } : {}),
         ...(source.chroma_key !== undefined ? { chroma_key: source.chroma_key } : {})
     };
 }
@@ -1085,6 +1088,8 @@ function projectLegacyEdit(internal) {
     const audioNarration = [];
     let audioBgm;
     for (const track of internal.tracks) {
+        if (track.lane === 'audio' && track.muted === true)
+            continue;
         for (const item of track.items) {
             const value = item.legacy.value;
             if (value === undefined) {
@@ -1114,7 +1119,11 @@ function projectLegacyEdit(internal) {
                             layers.push({ index: item.legacy.index, value: value });
                             break;
                         default:
-                            cuts.push({ index: item.legacy.index, value: value });
+                            cuts.push({
+                                index: item.legacy.index,
+                                value: (track.lane === 'visual' && track.muted === true
+                                    ? { ...value, mute: true } : value)
+                            });
                             break;
                     }
                     break;

package/vendor/packages/edit-store/lib/legacy-audio-view.js

@@ -7,6 +7,7 @@ exports.projectLegacyAudioView = projectLegacyAudioView;
  */
 function projectLegacyAudioView(internal) {
     const ordered = internal.tracks
+        .filter(track => !(track.lane === 'audio' && track.muted === true))
         .flatMap(track => track.items)
         .filter(item => item.legacy.collection === 'sfx'
         || item.legacy.collection === 'narration'

package/vendor/packages/edit-store/lib/webview-kernel.js

@@ -1437,6 +1437,7 @@ var AkariEditKernel = (() => {
       if (segment.kind !== "src" || segment.cutIndex === null) continue;
       const cut = normalizedCuts[segment.cutIndex];
       if (!cut || typeof cut.src !== "string" || !cut.src) continue;
+      if (cut.mute === true) continue;
       const speed = finitePositive(cut.speed) ? cut.speed : 1;
       const segmentIn = typeof segment.in === "number" ? segment.in : cut.in;
       const cutTimelineStart = segment.outStart - (segmentIn - cut.in) / speed;
@@ -1863,7 +1864,7 @@ var AkariEditKernel = (() => {
   function validateTrack(value, index, trackIds, itemIds, sourceIds) {
     const path = `edit.json.tracks[${index}]`;
     requireRecord(value, path);
-    requireExactKeys(value, /* @__PURE__ */ new Set(["id", "lane", "name", "items", "content"]), path);
+    requireExactKeys(value, /* @__PURE__ */ new Set(["id", "lane", "name", "muted", "items", "content"]), path);
     requireText(value.id, `${path}.id`);
     if (trackIds.has(value.id)) throw invalid(`${path}.id`, `track id \u304C\u91CD\u8907\u3057\u3066\u3044\u307E\u3059: ${value.id}`);
     trackIds.add(value.id);
@@ -1873,6 +1874,9 @@ var AkariEditKernel = (() => {
     if (hasOwn(value, "name") && typeof value.name !== "string") {
       throw invalid(`${path}.name`, "\u6587\u5B57\u5217\u3067\u3042\u308B\u5FC5\u8981\u304C\u3042\u308A\u307E\u3059");
     }
+    if (hasOwn(value, "muted") && typeof value.muted !== "boolean") {
+      throw invalid(`${path}.muted`, "boolean \u3067\u3042\u308B\u5FC5\u8981\u304C\u3042\u308A\u307E\u3059");
+    }
     const hasItems = hasOwn(value, "items");
     const hasContent = hasOwn(value, "content");
     if (hasItems === hasContent) {
@@ -2018,7 +2022,9 @@ var AkariEditKernel = (() => {
           "freeze",
           "fx",
           "speed",
-          "chroma_key"
+          "chroma_key",
+          "gain_db",
+          "mute"
         ]), path);
         requireText(value.src, `${path}.src`);
         if (!sourceIds.has(value.src)) throw invalid(`${path}.src`, `sources[].id \u306B\u5B58\u5728\u3057\u307E\u305B\u3093: ${value.src}`);
@@ -2030,6 +2036,8 @@ var AkariEditKernel = (() => {
         }
         if (hasOwn(value, "fx") && !Array.isArray(value.fx)) throw invalid(`${path}.fx`, "\u914D\u5217\u3067\u3042\u308B\u5FC5\u8981\u304C\u3042\u308A\u307E\u3059");
         if (hasOwn(value, "speed")) requirePositiveNumber(value.speed, `${path}.speed`);
+        if (hasOwn(value, "gain_db")) requireRange(value.gain_db, -60, 12, `${path}.gain_db`);
+        if (hasOwn(value, "mute") && typeof value.mute !== "boolean") throw invalid(`${path}.mute`, "boolean \u3067\u3042\u308B\u5FC5\u8981\u304C\u3042\u308A\u307E\u3059");
         return;
       case "html":
         requireExactKeys(value, /* @__PURE__ */ new Set(["kind", "path", "part", "style", "text", "exclude", "derivedFrom", "vars", "params"]), path);
@@ -2549,6 +2557,7 @@ var AkariEditKernel = (() => {
         lane: track.lane,
         z: track.z,
         ...track.name !== void 0 ? { name: track.name } : {},
+        ...track.muted === void 0 ? {} : { muted: track.muted },
         origin: "declared",
         ..."content" in track ? { content: { from: "captions.json" } } : {},
         items,
@@ -3254,6 +3263,8 @@ var AkariEditKernel = (() => {
       ...source.freeze !== void 0 ? { freeze: source.freeze } : {},
       ...source.fx !== void 0 ? { fx: source.fx } : {},
       ...source.speed !== void 0 ? { speed: source.speed } : {},
+      ...source.gain_db !== void 0 ? { gain_db: source.gain_db } : {},
+      ...source.mute !== void 0 ? { mute: source.mute } : {},
       ...source.chroma_key !== void 0 ? { chroma_key: source.chroma_key } : {}
     };
   }
@@ -3381,6 +3392,7 @@ var AkariEditKernel = (() => {
     const audioNarration = [];
     let audioBgm;
     for (const track of internal.tracks) {
+      if (track.lane === "audio" && track.muted === true) continue;
       for (const item of track.items) {
         const value = item.legacy.value;
         if (value === void 0) {
@@ -3405,7 +3417,10 @@ var AkariEditKernel = (() => {
                 layers.push({ index: item.legacy.index, value });
                 break;
               default:
-                cuts.push({ index: item.legacy.index, value });
+                cuts.push({
+                  index: item.legacy.index,
+                  value: track.lane === "visual" && track.muted === true ? { ...value, mute: true } : value
+                });
                 break;
             }
             break;

package/vendor/packages/gpu-export/README.ja.md

@@ -236,3 +236,5 @@ frame-engine bundle は生成物です。`generated/frame-engine.js` を直接
 生フレーム hash は隔離した検証専用 module からだけ利用でき、実行時 readback trap とは同時に
 有効化できません。DOM frame 検証は隔離した texture sentinel を使い、選択した settle policy
 （`raf2-paint-event` または `sync-layout`）を receipt に記録します。
+
+宣言型 `data-akari-vgpu-scene` は同梱 vgpu 0.4.0 の WebGPU ランタイムで描き、描画直後の canvas を GPU 合成へ渡す。v0 は pure な fragment パス、先行パスの texture 入力、CSS `--vgpu-*` ツマミに対応する。ライブプレビューは辺あたり半解像度、GPU 書き出しは等倍で、配置と時刻を共有する。WebGPU の probe・device 障害は `auto` でも失敗として伝播し OSR へ落とさない。receipt の `gpu.vgpu` は使用時だけ追加する。詳しくは [vgpu v0 契約](../../docs/contract-2026-09-06-vgpu-layer-v0.md)。

package/vendor/packages/gpu-export/README.md

@@ -258,3 +258,5 @@ The frame-engine bundle is generated. Do not edit `generated/frame-engine.js` di
 Frame hashing is available only through the isolated verification module and cannot be combined
 with the runtime readback trap. DOM frame verification uses an isolated texture sentinel and
 records the selected settle policy (`raf2-paint-event` or `sync-layout`) in the receipt.
+
+Declarative `data-akari-vgpu-scene` overlays use the vendored vgpu 0.4.0 WebGPU runtime and transfer each freshly drawn canvas into the GPU compositor. v0 supports pure fragment passes, earlier-pass texture inputs, and CSS `--vgpu-*` uniforms. Live preview defaults to half resolution per edge; GPU export uses full resolution with the same placement and time. WebGPU probe/device failures are fatal, including in `auto` (no OSR fallback); `gpu.vgpu` is present in receipts only when used. See the [vgpu v0 contract](../../docs/contract-2026-09-06-vgpu-layer-v0.md) (Japanese).