akari-video 0.1.21 → 0.1.23

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

@@ -20,10 +20,16 @@ var AkariEditKernel = (() => {
   // src/webview-kernel.ts
   var webview_kernel_exports = {};
   __export(webview_kernel_exports, {
+    TRANSITION_BY_ID: () => TRANSITION_BY_ID,
+    TRANSITION_CATEGORIES: () => TRANSITION_CATEGORIES,
+    TRANSITION_TYPE_IDS: () => TRANSITION_TYPE_IDS,
+    TRANSITION_VOCABULARY: () => TRANSITION_VOCABULARY,
     buildTimelineMap: () => buildTimelineMap,
     captionWindowSeconds: () => captionWindowSeconds,
+    computeTransitionVisual: () => computeTransitionVisual,
     findActiveCaption: () => findActiveCaption,
     findActiveResolvedCaption: () => findActiveResolvedCaption,
+    isTransitionType: () => isTransitionType,
     outputToSource: () => outputToSource,
     transitionProgressAt: () => transitionProgressAt
   });
@@ -63,6 +69,9 @@ var AkariEditKernel = (() => {
   var TRANSITION_TYPE_IDS = TRANSITION_VOCABULARY.map((entry) => entry.id);
   var TRANSITION_CATEGORIES = [...new Set(TRANSITION_VOCABULARY.map((entry) => entry.category))];
   var TRANSITION_BY_ID = Object.fromEntries(TRANSITION_VOCABULARY.map((entry) => [entry.id, entry]));
+  function isTransitionType(value) {
+    return typeof value === "string" && Object.prototype.hasOwnProperty.call(TRANSITION_BY_ID, value);
+  }
 
   // src/edit-store.ts
   function computeCutTrackSegments(cuts) {
@@ -296,6 +305,136 @@ var AkariEditKernel = (() => {
     });
   }
 
+  // src/transition-visual.ts
+  function computeTransitionVisual(previewKind, rawProgress, fallbackName = "") {
+    const clamp01 = (value) => Math.max(0, Math.min(1, value));
+    const progress = clamp01(Number.isFinite(rawProgress) ? rawProgress : 0);
+    const mid = 1 - Math.abs(2 * progress - 1);
+    const percent = (value) => `${value * 100}%`;
+    const translateX = (value) => `translateX(${percent(value)})`;
+    const translateY = (value) => `translateY(${percent(value)})`;
+    const base = {
+      progress,
+      engine: "none",
+      blurStdDeviationRatio: 0,
+      pixelBlockRatio: 0,
+      dissolveVisibleRatio: 0,
+      outgoingOpacity: 1,
+      incomingOpacity: 1,
+      incomingClipPath: "none",
+      outgoingTransform: "",
+      incomingTransform: "",
+      outgoingMask: "none",
+      incomingMask: "none",
+      outgoingFilter: "none",
+      incomingFilter: "none",
+      plateOpacity: 0,
+      plateColor: "transparent",
+      zSwap: false,
+      fallbackLabel: ""
+    };
+    const cross = () => ({
+      ...base,
+      outgoingOpacity: 1 - progress,
+      incomingOpacity: progress
+    });
+    if (previewKind === "blur") {
+      return { ...cross(), engine: "directional-blur", blurStdDeviationRatio: mid * 0.075 };
+    }
+    if (previewKind === "pixelize") {
+      return { ...cross(), engine: "pixelize", pixelBlockRatio: mid / 22 };
+    }
+    if (previewKind === "dissolve") {
+      return { ...base, engine: "noise-dissolve", dissolveVisibleRatio: progress };
+    }
+    if (previewKind === "fade") return cross();
+    if (previewKind === "fade-black" || previewKind === "fade-white") {
+      return {
+        ...cross(),
+        plateOpacity: clamp01(Math.min(progress / 0.18, (1 - progress) / 0.7)),
+        plateColor: previewKind === "fade-white" ? "#fff" : "#000"
+      };
+    }
+    if (previewKind === "fade-grays") {
+      const filter = `grayscale(${mid})`;
+      return { ...cross(), outgoingFilter: filter, incomingFilter: filter };
+    }
+    const hidden = 1 - progress;
+    if (previewKind === "wipe-left") return { ...base, incomingClipPath: `inset(0 0 0 ${percent(hidden)})` };
+    if (previewKind === "wipe-right") return { ...base, incomingClipPath: `inset(0 ${percent(hidden)} 0 0)` };
+    if (previewKind === "wipe-up") return { ...base, incomingClipPath: `inset(${percent(hidden)} 0 0 0)` };
+    if (previewKind === "wipe-down") return { ...base, incomingClipPath: `inset(0 0 ${percent(hidden)} 0)` };
+    if (previewKind === "slide-left") {
+      return { ...base, outgoingTransform: translateX(-progress), incomingTransform: translateX(hidden) };
+    }
+    if (previewKind === "slide-right") {
+      return { ...base, outgoingTransform: translateX(progress), incomingTransform: translateX(-hidden) };
+    }
+    if (previewKind === "slide-up") {
+      return { ...base, outgoingTransform: translateY(-progress), incomingTransform: translateY(hidden) };
+    }
+    if (previewKind === "slide-down") {
+      return { ...base, outgoingTransform: translateY(progress), incomingTransform: translateY(-hidden) };
+    }
+    if (previewKind === "cover-left") return { ...base, incomingTransform: translateX(hidden) };
+    if (previewKind === "cover-right") return { ...base, incomingTransform: translateX(-hidden) };
+    if (previewKind === "cover-up") return { ...base, incomingTransform: translateY(hidden) };
+    if (previewKind === "cover-down") return { ...base, incomingTransform: translateY(-hidden) };
+    if (previewKind === "reveal-left") {
+      return { ...base, outgoingTransform: translateX(-progress), zSwap: true };
+    }
+    if (previewKind === "reveal-right") {
+      return { ...base, outgoingTransform: translateX(progress), zSwap: true };
+    }
+    if (previewKind === "reveal-up") {
+      return { ...base, outgoingTransform: translateY(-progress), zSwap: true };
+    }
+    if (previewKind === "reveal-down") {
+      return { ...base, outgoingTransform: translateY(progress), zSwap: true };
+    }
+    if (previewKind === "circle-open") {
+      const c = progress * 170 - 35;
+      return {
+        ...base,
+        incomingMask: `radial-gradient(circle farthest-corner, #000 ${c - 35}%, transparent ${c + 35}%)`
+      };
+    }
+    if (previewKind === "circle-close") {
+      const c = (1 - progress) * 170 - 35;
+      return {
+        ...base,
+        outgoingMask: `radial-gradient(circle farthest-corner, #000 ${c - 35}%, transparent ${c + 35}%)`,
+        zSwap: true
+      };
+    }
+    if (previewKind === "radial") {
+      const c = progress * 424 - 32;
+      return {
+        ...base,
+        incomingMask: `conic-gradient(from 0deg, #000 ${c - 16}deg, transparent ${c + 16}deg)`
+      };
+    }
+    if (previewKind === "zoom-in") {
+      return {
+        ...base,
+        outgoingOpacity: progress < 0.6 ? 1 : 1 - (progress - 0.6) / 0.4,
+        outgoingTransform: `scale(${1 + 1.5 * progress})`,
+        outgoingFilter: `blur(${6 * progress}px)`,
+        zSwap: true
+      };
+    }
+    if (previewKind === "squeeze-h") {
+      return { ...base, outgoingTransform: `scaleY(${1 - progress})`, zSwap: true };
+    }
+    if (previewKind === "squeeze-v") {
+      return { ...base, outgoingTransform: `scaleX(${1 - progress})`, zSwap: true };
+    }
+    return {
+      ...cross(),
+      fallbackLabel: `${fallbackName || previewKind} \u2014 \u30D7\u30EC\u30D3\u30E5\u30FC\u8FD1\u4F3C\u306A\u3057`
+    };
+  }
+
   // src/webview-kernel.ts
   function findActiveResolvedCaption(cues, outputTime) {
     return cues.find((cue) => cue.start <= outputTime && outputTime < cue.end);

package/vendor/packages/frame-engine/README.ja.md

@@ -0,0 +1,24 @@
+[English](./README.md) | **日本語**
+
+# @akari-video/frame-engine
+
+`frame-engine` は edit-store が解決済みのタイムライン時刻を、1枚の完成 WebGL2 surface へ評価します。同じ `CompositedFrame` を canvas preview 出口と PBO raw-frame 出口が消費し、`evaluateFrame` 自体は preview/export モードを持ちません。
+
+Phase 1a の対応範囲はハードカットだけです。速度、framing、transform、freeze、transition はこの版の対象外です。
+
+## ローカル検証
+
+ゴールデンハーネスは Chromium の WebCodecs と WebGL2 実装を必要とします。まずリポジトリにある Electron を起動し、ホストが GUI app を登録できない場合だけ同じ renderer bundle を Playwright Chromium で実行します。H.264 フィクスチャは ffmpeg で生成し、動画と証跡は gitignore 済みの `test/golden/.generated/` にだけ置きます。
+
+```sh
+cd packages/frame-engine
+npm run typecheck
+npm run test:unit
+npm test
+```
+
+`npm test` は build、unit test、Electron 実走、preview/export の RGBA・PNG hash 一致、故意の1px改変を比較器が棄却すること、MP4 encode 後の抽出フレームが静止していないことを一括検証します。段階別集計は `test/golden/.generated/metrics.json` に生成されます。
+
+CI runner が GPU/WebCodecs 対応 Chromium を持たない場合、Electron/WebCodecs 試験はローカル専用です。unit test と typecheck はその種の CI でも実行できます。
+
+固定した demux/decode 依存の評価は [av-cliper 保守現況](./docs/av-cliper-status.md) を参照してください。

package/vendor/packages/frame-engine/README.md

@@ -0,0 +1,24 @@
+**English** | [日本語](./README.ja.md)
+
+# @akari-video/frame-engine
+
+`frame-engine` evaluates one edit-store-resolved timeline instant into one completed WebGL2 surface. The same `CompositedFrame` is consumed by the canvas preview exit and the PBO raw-frame exit; `evaluateFrame` has no preview/export mode.
+
+Phase 1a supports hard cuts only. Speed, framing, transforms, freeze frames, and transitions remain outside this package version.
+
+## Local verification
+
+The golden harness needs Chromium's WebCodecs and WebGL2 implementations. It first launches the repository's Electron binary; if the host cannot register a GUI app, it runs the same renderer bundle in Playwright Chromium. It generates its H.264 fixture with ffmpeg and keeps all media and evidence under the ignored `test/golden/.generated/` directory.
+
+```sh
+cd packages/frame-engine
+npm run typecheck
+npm run test:unit
+npm test
+```
+
+`npm test` builds the package, runs unit tests, launches Electron, compares preview/export RGBA and PNG hashes, proves the comparator rejects an injected one-pixel mutation, encodes an MP4, and verifies extracted frames are not static. Stage summaries are written to `test/golden/.generated/metrics.json`.
+
+The Electron/WebCodecs test is intentionally local-only when a CI runner has no GPU/WebCodecs-capable Chromium. Unit tests and typechecking remain suitable for such CI runners.
+
+See [av-cliper maintenance status](./docs/av-cliper-status.md) for the pinned demux/decode dependency assessment.

package/vendor/packages/frame-engine/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@akari-video/frame-engine",
+  "version": "0.1.0",
+  "private": true,
+  "description": "Deterministic timeline frame evaluator with a WebGL2 compositor and shared preview/export surfaces.",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit && tsc -p tsconfig.golden.json",
+    "bundle:golden": "mkdir -p test/golden/.generated && esbuild test/golden/renderer.ts --bundle --format=iife --platform=browser --target=chrome122 --outfile=test/golden/.generated/renderer.js",
+    "test:unit": "node --test test/*.test.mjs",
+    "test:golden": "node test/golden/run.mjs",
+    "test": "npm run build && npm run test:unit && npm run test:golden"
+  },
+  "dependencies": {
+    "@akari-video/edit-store": "0.1.0",
+    "@webav/av-cliper": "1.2.8",
+    "@webav/mp4box.js": "^0.5.7"
+  },
+  "devDependencies": {
+    "@playwright/test": "^1.62.0",
+    "esbuild": "^0.24.0",
+    "typescript": "^5.6.0"
+  }
+}

package/vendor/packages/preview-engine/README.md

@@ -1,5 +1,43 @@
 # @akari-video/preview-engine
 
+> ## 🧊 状態: **凍結中（2026-08-27 裁定）** — 接続先未定・ビルド/配信ラインから除外済み
+>
+> このパッケージは **どのアプリからも import されていない**。2026-07-15〜16 の実装ラウンド以降、
+> `packages/preview-server` が `public/preview-engine.bundle.js` へバンドル・配信していたが、
+> `public/index.html` にも `public/app.js` にも読み込み口が無く、実行されたことは一度も無い
+> （死蔵の確定根拠: 内部監査 2026-08-17）。維持費（ビルド時間・381KB のバンドル配信・
+> 追随改修による保守錯覚）だけが発生していたため、**ビルド・配信ラインから外した**:
+>
+> - `packages/preview-server/package.json` の `build` から preview-engine の esbuild を削除
+> - 追跡されていた `packages/preview-server/public/preview-engine.bundle.js` を削除
+> - `packages/preview-server/test/server.spec.mjs` の「配信されるか」スモークを削除
+>
+> **コードは消していない**。エンジン v2 構想（合成エンジンを 1 個に統一する
+> WebCodecs + GPU コンポジタ路線・2026-08-26 オーナー承認）で **土台候補**として実査済みであり、
+> 「再利用するか新規に起こすか」はエンジン v2 のゲート G1（Phase 0 スパイクの実測と併せて裁定）
+> に委ねられている。それまでは触らない — **本パッケージへの追随改修を新たに入れないこと**
+> （入れても誰も実行しない。必要な変更は G1 の裁定後に、再利用と決まってから行う）。
+>
+> ### 凍結の解除（復活）手順
+>
+> 1. `packages/preview-server/package.json` の `build` 先頭へ次を戻す:
+>    `esbuild ../preview-engine/src/index.ts --bundle --format=esm --outfile=public/preview-engine.bundle.js --target=chrome122 --platform=browser && `
+> 2. `public/index.html` か `public/app.js` に**実際の読み込み口**を作る（これが無かったのが死蔵の原因）
+> 3. 必要なら `server.spec.mjs` の配信スモークを復活させる（削除前の内容は git 履歴を参照）
+>
+> ### 凍結中に確定した申し送り
+>
+> - **ducking の正本は本パッケージではない**。`src/duckingGain.ts` は「BGM を下げる区間」の
+>   計算を純関数 + テスト付きで持つ唯一の実装だが、同じ規則が Web UI（`packages/preview-server/public/app.js`）
+>   と shell（`apps/shell/extensions/akari-preview/src/browser/akari-preview-open-handler.ts`）に
+>   インラインで各 1 本ある（= プレビュー側は計 3 実装）。2026-08-27 時点で 3 者は数値的に同値
+>   （0〜10s を 10ms 刻み × ducking on/off の 2,002 点で不一致 0 を実測）。
+>   共有カーネル（`packages/edit-store`）への一本化は消費側 2 ファイルの書き換えを伴うため
+>   別タスク扱い。**復活時は `src/duckingGain.ts` を残さず、カーネル側を import すること**
+> - `src/timeline.ts` の `Timeline` は MVP 用の素朴な解決器で、`packages/edit-store` の
+>   timeline-map 共有カーネル（トラック勝者・時間写像の正本）とは別物。復活時は timeline-map を正とする
+
+
 シェル非依存の TS プレビューエンジン（レベル3: Chromium 内完結、WebCodecs + `@webav/av-cliper` 基盤）。
 正本契約（E1〜E5）は非公開の内部 planning で管理する（本リポには置かない方針）。
 パラメータの根拠・設計判断の要約は本 README 「E1〜E4 の実装メモ」節を参照。

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

@@ -4,7 +4,7 @@
   "private": true,
   "type": "module",
   "scripts": {
-    "build": "esbuild ../preview-engine/src/index.ts --bundle --format=esm --outfile=public/preview-engine.bundle.js --target=chrome122 --platform=browser && 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",
+    "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",
     "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",
     "start": "node src/server.mjs",