akari-video 0.1.42 → 0.1.44

package/package.json

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

@@ -167,6 +167,7 @@
     "skills/harvest-asset/SKILL.md",
     "skills/manage-connections/SKILL.md",
     "skills/overlay-authoring/3d.md",
+    "skills/overlay-authoring/glass.md",
     "skills/overlay-authoring/motion.md",
     "skills/overlay-authoring/SKILL.md",
     "skills/overlay-authoring/table.md",

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

@@ -423,7 +423,7 @@ v3 は、宣言型 Three.js scene の HTML 部分にある CSS animation / trans
 `threeRuntime.render(container, t)` へ直接渡し、scene 内部の animation、動画 texture、ready 判定は
 変更しない。登場表現を従来の文法へ解析できる場合は理由 `three-scene-entrance-curve`、解析できない場合は
 計算済みスタイルを実測する理由 `three-scene-entrance-sampled` とする。解析不能だけを理由に fail-closed
-にはしない。CSS animation のない宣言型 3D は理由 `three-scene-canvas-direct` のままである。
+にはしない。CSS animation のない宣言型 3D は他の条件を持たない場合は理由 `three-scene-canvas-direct` のままとし、`advanced-css` や CSS 3D 幾何を伴う場合は composite 経路（`three-scene-sampled-composite`）で断片全体を転写する。
 
 curve モードは従来どおり、対になった `[data-akari-active] .root, [data-no-timeline] .root` selector、
 1 本・2 endpoint の keyframe、既知の timing、非負 delay、iteration 1、normal direction、`both` または

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

@@ -1,6 +1,6 @@
 {
   "name": "akari-video",
-  "version": "0.1.42",
+  "version": "0.1.44",
   "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/gpu-export/README.ja.md

@@ -79,7 +79,7 @@ sheet / DOM 間のカスタムプロパティ補間パリティを実測する
 composite の入口外条件は `three-sampled-condition:<条件名>` を報告します。方式 A の
 `three-sampled-chain-css:<プロパティ>` ガードは残します。manifest は `entranceMode`、receipt は
 `curve` / `sampled` / `composite` mode、sampling 費用、composite の DOM 要素数と canvas 中継・DOM 層費用の
-p50/p95 を記録します。CSS animation のない scene は従来どおり `three-scene-canvas-direct` です。
+p50/p95 を記録します。CSS animation のない scene は他の条件を持たない場合は従来どおり `three-scene-canvas-direct` とし、`advanced-css` や CSS 3D 幾何を伴う場合は composite 経路（`three-scene-sampled-composite`）で断片全体を転写します。
 
 `render-cut --engine auto` は macOS / Windows で GPU を候補にし、プロジェクト全体が適格なら GPU、
 不適格なら OSR を使います。Linux の `auto` は legacy のままで、`--engine gpu` を明示した場合だけ

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

@@ -87,7 +87,7 @@ Extending `preserve3dOrderConflicts` to sibling pairs can re-enable this shape i
 continue to pass with a warning (measured parity 0.6374).
 Manifests record `entranceMode`, and receipts record
 `curve` / `sampled` / `composite`, sampling cost, plus composite DOM-element and p50/p95 copy/DOM-layer costs.
-Scenes without CSS animation remain `three-scene-canvas-direct`.
+Scenes without CSS animation remain `three-scene-canvas-direct` when no other conditions are present; scenes with `advanced-css` or CSS 3D geometry transfer the entire fragment through the composite path (`three-scene-sampled-composite`).
 
 `render-cut --engine auto` considers GPU export on macOS and Windows, using it when the complete
 project is eligible and otherwise using OSR. On Linux, `auto` remains legacy and GPU export is

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

@@ -53,6 +53,9 @@ Three.js + glTF シーンを決定的な時刻で描画し（`three-runtime.js`
    自動でこの順に埋め込む — 同じ順序をホストの `<script>` タグでも守ること）。ランタイム読込後、
    `font` 省略を許すホストは mount より前に
    `window.akari.threeRuntime.configure({ defaultFontUrl })` を 1 回呼ぶ
+   ガラス宣言を扱うホストは `src/glass-runtime.js` を `src/overlay-runtime.js` より前に読み込む。
+   `backdrop` は断片相対。ホストは `htmlPath` を配信 URL で渡すか、宣言の `backdrop` を配信 URL に解決する。
+   preview-server は素材同梱の `runtime/glass-runtime.js` を読み込む。
 4. テキスト分割断片（`data-akari-split`）を扱うホストは、`src/interaction.js` より前に
    `src/vendor/budoux-ja-bundle.js` → `src/text-split.js` の順で読み込む。
    未読込でも他機能は動くが、日本語の文節分割が精度の落ちる近似になり

package/vendor/packages/schemas/bin/validate-asset.mjs

@@ -416,12 +416,42 @@ function validateFiles() {
     }
   }
 
+  if (Array.isArray(meta?.requires) && meta.requires.includes("glass-runtime")) {
+    for (const filePath of payloadFiles) {
+      const name = relativeToAsset(filePath).replaceAll("\\", "/");
+      if (name === "fragment.html" || /^variants\/[^/]+\.html$/i.test(name)) validateGlassDeclaration(filePath);
+    }
+  }
   for (const filePath of payloadFiles) {
     if (/\.(?:html?|css|svg|m?js|cjs)$/i.test(filePath)) validateLocalReferences(filePath);
     else if (/\.gltf$/i.test(filePath)) validateGltfReferences(filePath);
   }
 }
 
+function validateGlassDeclaration(filePath) {
+  const source = fs.readFileSync(filePath, "utf8").replace(/<!--[\s\S]*?-->/gu, "");
+  const pattern = /<script\b(?=[^>]*\btype\s*=\s*(?:"application\/json"|'application\/json'))(?=[^>]*\bdata-akari-glass-scene\b)[^>]*>([\s\S]*?)<\/script\s*>/giu;
+  const declarations = [...source.matchAll(pattern)];
+  if (!declarations.length) fail(`${relativeToAsset(filePath)} に data-akari-glass-scene 宣言が見つかりません`);
+  const elements = source.replace(/<script\b[^>]*>[\s\S]*?<\/script\s*>/giu, "").replace(/<style\b[^>]*>[\s\S]*?<\/style\s*>/giu, "");
+  if (declarations.length && !/<[a-z][^>]*\sdata-akari-glass(?=\s|=|\/?>)/iu.test(elements)) {
+    fail(`${relativeToAsset(filePath)}: 宣言があるのにガラス面が無い`);
+  }
+  for (const match of declarations) {
+    let descriptor;
+    try { descriptor = JSON.parse(match[1]); }
+    catch (error) { fail(`data-akari-glass-scene の JSON を読めません: ${messageOf(error)}`); continue; }
+    if (!isPlainObject(descriptor)) { fail("data-akari-glass-scene は JSON object である必要があります"); continue; }
+    if (descriptor.backdrop === undefined) continue;
+    const backdrop = descriptor.backdrop;
+    if (typeof backdrop !== "string" || !backdrop.trim() || /^[a-z][a-z\d+.-]*:|^[\/\\]/iu.test(backdrop) || backdrop.includes("\\")) {
+      fail("data-akari-glass-scene.backdrop は相対パスである必要があります");
+      continue;
+    }
+    validateReference(filePath, backdrop);
+  }
+}
+
 // data-akari-3d-scene 宣言が model を持たず、かつ非空の texts[] を持つときだけ glb を任意化する
 // （overlay-runtime/src/three-runtime.js の readDescriptor と同じ判定。texts[] も model も
 // 無い宣言・宣言を読めない場合は従来どおり glb を必須のまま扱う＝安全側デフォルト）。
@@ -496,7 +526,14 @@ function validateLocalReferences(filePath) {
     /\.load(?:Async)?\s*\(\s*["']([^"']+)["']/gi,
   ];
   for (const pattern of patterns) {
-    for (const match of source.matchAll(pattern)) references.add(match[1].trim());
+    for (const match of source.matchAll(pattern)) {
+      // new URL(url, base) is a dynamic JS constructor, not CSS url().
+      // Limit this correction to glass packs; keep literal CSS and JS loaders checked.
+      if (pattern === patterns[1] && meta?.requires?.includes("glass-runtime")
+          && /\.(?:m?js|cjs)$/i.test(filePath) && match[0].startsWith("URL(")
+          && /\bnew\s*$/u.test(source.slice(0, match.index))) continue;
+      references.add(match[1].trim());
+    }
   }
 
   for (const match of source.matchAll(/\bimport\s+(?:[^"']*?\s+from\s+)?["']([^"']+)["']/gi)) {

package/vendor/packages/schemas/test/validate-glass-asset.test.mjs

@@ -0,0 +1,56 @@
+import assert from 'node:assert/strict';
+import { spawnSync } from 'node:child_process';
+import { cpSync, mkdirSync, mkdtempSync, readFileSync, writeFileSync, rmSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import test from 'node:test';
+
+const cli = new URL('../bin/validate-asset.mjs', import.meta.url);
+const declaration = (value) => `<script type="application/json" data-akari-glass-scene>${JSON.stringify(value)}</script>`;
+function fixture(t) {
+  const root = mkdtempSync(join(tmpdir(), 'akari-glass-asset-'));
+  t.after(() => rmSync(root, { recursive: true, force: true }));
+  const dir = join(root, 'overlay/lower-third-clean');
+  cpSync(new URL('./fixtures/asset/valid-library/overlay/lower-third-clean', import.meta.url), dir, { recursive: true });
+  const meta = JSON.parse(readFileSync(join(dir, 'meta.json')));
+  meta.requires = ['glass-runtime'];
+  writeFileSync(join(dir, 'meta.json'), JSON.stringify(meta));
+  for (const sub of ['variants', 'runtime', 'backgrounds']) mkdirSync(join(dir, sub));
+  writeFileSync(join(dir, 'backgrounds/bg.png'), 'image');
+  writeFileSync(join(dir, 'sample-press.mp4'), 'sample');
+  cpSync(new URL('../../overlay-runtime/src/glass-runtime.js', import.meta.url), join(dir, 'runtime/glass-runtime.js'));
+  writeFileSync(join(dir, 'fragment.html'), `<div data-akari-glass>${declaration({ backdrop: 'backgrounds/bg.png' })}</div>`);
+  writeFileSync(join(dir, 'variants/press.html'), `<div data-akari-glass>${declaration({ backdrop: '../backgrounds/bg.png' })}</div>`);
+  return dir;
+}
+const run = (dir) => spawnSync(process.execPath, [cli.pathname, dir], { encoding: 'utf8' });
+
+test('glass pack variants, runtime, backgrounds and sample mp4 pass', (t) => {
+  const result = run(fixture(t));
+  assert.equal(result.status, 0, result.stderr);
+});
+
+test('glass declaration validation rejects malformed JSON, missing surfaces and bad references', (t) => {
+  const dir = fixture(t);
+  for (const [html, error] of [
+    [declaration({}), /ガラス面が無い/],
+    ['<div data-akari-glass>' + declaration([]) + '</div>', /JSON object/],
+    ...['https://example.com/bg.png', 'data:image/png;base64,AA==', 'missing.png', '/tmp/bg.png', '../outside.png', 42].map((backdrop) => [`<div data-akari-glass>${declaration({ backdrop })}</div>`, /相対パス|見つかりません|ディレクトリ外/]),
+    ['<div data-akari-glass><script type="application/json" data-akari-glass-scene>{</script></div>', /JSON を読めません/],
+  ]) {
+    writeFileSync(join(dir, 'variants/press.html'), html);
+    const result = run(dir);
+    assert.equal(result.status, 1, html);
+    assert.match(result.stderr, error);
+  }
+  writeFileSync(join(dir, 'variants/press.html'), `<div data-akari-glass>${declaration({})}</div>`);
+  assert.equal(run(dir).status, 0, 'backdrop is optional');
+});
+
+test('quoted JS asset loaders still detect missing pack assets', (t) => {
+  const dir = fixture(t);
+  writeFileSync(join(dir, 'runtime/missing.js'), 'const image = new URL("missing.png", document.baseURI);');
+  assert.match(run(dir).stderr, /missing.png/);
+  writeFileSync(join(dir, 'runtime/missing.js'), 'const css = `background: url(missing-style.png)`;');
+  assert.match(run(dir).stderr, /missing-style.png/);
+});

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

@@ -38,6 +38,7 @@ description: AKARI Video のオーバーレイ HTML、字幕、表・グラフ
 - 字幕・テロップの日本語組版、可読性、配置: [telop.md](telop.md)
 - 表・グラフの HTML/CSS 構成とアニメーション: [table.md](table.md)
 - Three.js + glTF、動画テクスチャ、3D 性能: [3d.md](3d.md)
+- ガラス屈折の宣言、入れ子、ツマミ、静止背景: [glass.md](glass.md)
 - 決定的モーション、イージング、compositor 制約: [motion.md](motion.md)
 - サムネイルの型、デザイン語彙、生成経路、HTML スクショ: [thumbnail.md](thumbnail.md)
 - 人物切り抜き、HEVC alpha、text-behind-person: [text-behind-person.md](text-behind-person.md)

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

@@ -0,0 +1,93 @@
+# Glass refraction authoring
+
+## 経路の振り分け（まずここを判定）
+
+ガラス屈折は同梱の `glass-runtime.js` に任せ、断片は宣言と CSS だけを書く。
+ホストは `glass-runtime.js` を `overlay-runtime.js` より前に読み込む。
+任意 script、CDN、html2canvas、独自 rAF を断片に持ち込まない。
+
+## 現在の実装ゲート
+
+背景は **(a) 静止画**のみ。`backdrop` は断片ファイルからの相対パス。
+3D の `model` は edit.json 相対なので、基準ディレクトリを混同しない。
+ホストは断片相対をプロジェクト入力に束縛し、プレビューでは localhost の配信 URL、
+書き出しでは画像 data URI に解決する。宣言には http(s): / data: を直接書かない。
+
+(b) 下のトラックと同じ動画を渡す方式、(c) engine が合成直下の under-frame を供給する方式は次段。
+現状のガラスが写すのは宣言した画像であり、下の動画を自動で取り込むものではない。
+背景省略は検証上許されるが、通常のホストは `render(..., {})` なので画像の明示が必要。
+
+## 宣言型 fragment スキーマ
+
+単一ルート内に非実行 JSON 宣言を 1 個と `[data-akari-glass]` 要素を 1 個以上置く。
+canvas はランタイムが作る。面に position、寸法、px 単位の角丸を与え、文字は canvas より前面に置く。
+
+```html
+<div class="glass-card">
+  <style>
+    .glass-card__surface {
+      position: relative; width: var(--button-width, 280px); height: var(--button-height, 90px);
+      border-radius: var(--button-radius, 36px);
+      --glass-tint: var(--lg-tint, 0.06);
+      --glass-blur: var(--lg-blur, 2.5);
+      --glass-edge-intensity: var(--lg-lens, 0.035);
+      --glass-rim-intensity: calc(var(--lg-lens, 0.035) * 3.7);
+      --glass-rim-distance: var(--lg-lens-width, 0.6);
+      --glass-ripple: var(--lg-ripple, 0);
+    }
+    .glass-card__label { position: relative; z-index: 1; color: var(--lg-text-color, #fff); }
+  </style>
+  <div class="glass-card__surface" data-akari-glass><span class="glass-card__label">再生する</span></div>
+  <script type="application/json" data-akari-glass-scene>{"backdrop":"backgrounds/rooftop.jpg"}</script>
+</div>
+```
+
+`variants/press.html` から同じ背景を参照するなら `../backgrounds/rooftop.jpg`。
+素材の meta.json は `requires: ["glass-runtime"]` を宣言する。
+
+## 入れ子
+
+`[data-akari-glass]` の中に別の `[data-akari-glass]` を置くと、親の canvas を子が屈折させる。
+描画順は document order の親 → 子。親 canvas の代わりに背景画像を子へ再投入しない。
+子は親より濁りやすいので tint を確認する。円は正方形とし、角丸は % ではなく px にする。
+
+## ツマミ — 生値と製品レシピ
+
+ランタイムは `--glass-*` を読む。製品断片が `--lg-*` から写す二層構造で、
+動画側の `overlays[].vars` では基本的に `--lg-*` を調整する。
+以下は PoC の製品レシピ既定値。生値の既定とは区別する。
+
+| 変数 | 既定 | 意味 |
+|---|---|---|
+| `--lg-tint` | 0.06（原作 0.2） | 白グラデの混合。大きいほど濁る |
+| `--lg-blur` | 2.5（原作 5） | ぼかし |
+| `--lg-lens` | 0.035（原作 edge 0.01） | 縁の屈折。rim は 3.7 倍へ写す |
+| `--lg-lens-width` | 0.6（原作 0.8） | レンズ帯の減衰。小さいほど広い |
+| `--lg-ripple` | 0（原作 0.1） | 縁の波紋 |
+| `--lg-scale` | 1（drag は 2） | 寸法・文字・影・経路の倍率 |
+| `--lg-press-at` / `--lg-press-step` | 1s / 0.7s | i 番目の押下 = at + i × step |
+| `--lg-drag-scale` | 1.07 | 掴んだときの倍率 |
+| `--lg-text-color` / `--lg-font` / `--lg-shadow` / `--lg-flash` / `--anim` | #fff / system-ui / 1 / 1 / 1 | 文字・書体・影・フラッシュ・アニメ省略 |
+
+`--glass-warp` / `--glass-base-intensity` / `--glass-base-distance` /
+`--glass-edge-distance` / `--glass-corner-boost` は生値を継承して微調整できる。
+予約変数 `--x` / `--y` / `--scale` / `--rotate` を自前用途に使わない。
+
+## 決定的モーションと禁止事項
+
+ホストが CSS/WAAPI を localSeconds にシークし、その後
+`glassRuntime.render(container, localSeconds, {})` を呼ぶ。初期化中は
+`inspect(container).status` を 10 ms ごとに確認し、ready / error を待つ。
+非表示・unmount 時は `dispose(container)` で GPU リソースを返す。
+
+任意 script、wall-clock、未 seed 乱数、`backdrop-filter` は禁止。
+ripple は既定 0 とし、意図なく上げて縁を波打たせない。
+掴む動きと離す動きの transform アニメを同一要素で競合させず、1 本へまとめるか層を分ける。
+
+## 検証と落とし穴
+
+同時刻を往復シークして PNG の md5 を比較する。9:16（1080×1920）でも
+背景を center / cover で敷き、面内と下の背景の位置が一致することを確認する。
+GLSL の cover 写像、premultiplied alpha 出力、親 → 子の順序は変えない。
+ランタイムをインライン化するホストは `inlineScript()` で `</script` をエスケープする。
+`validate-asset` で背景の存在とガラス面を検査し、ガラス宣言なしの 2D / 3D シートも比較する。