akari-video 0.1.16 → 0.1.18

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akari-video",
-  "version": "0.1.16",
+  "version": "0.1.18",
   "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-07-22-render-basics.md

@@ -99,3 +99,31 @@ perspective のレイヤー分割フォールバック — perspective は `crop
 "per-frame 評価に対応しない" 制約を持つが、ffmpeg 側に時刻変数自体が無いためこの技法すら
 使えず、レイヤー分割へフォールバックする点が crop/framing と異なる）・プレビュー再現の詳細は
 すべて同契約 §2.4.7 に記載する（本ファイルでの重複記載はしない — SSOT は 1 箇所）。
+
+- **レイヤー拡大・crop の固定キャンバス化（2026-08-24 追記）**: normal blend かつ
+  perspective/rotate 非併用の `layers[].keyframes` では、`transform.scale` に応じて素材の整数
+  bitmap 寸法を毎フレーム変え、その可変 `overlay_w/overlay_h` を中央配置する方式を廃止した。
+  素材ネイティブ寸法を 2 倍した固定グリッド（`LAYER_KEYFRAME_SUPERSAMPLE=2`）内で scale/crop
+  を補間し、最大 footprint の固定透明キャンバスへ偶数座標で配置・固定 crop した後、Lanczos で
+  実寸へ縮小する。これにより overlay の外形寸法は全フレーム不変となり、拡大後サイズの偶奇変化
+  による中央座標の ±1px 往復を除去しつつ、PiP の footprint 自体は固定グリッド内で連続的に
+  拡縮する。倍率値は `cut-framing.mjs` の `SUPERSAMPLE=2` と同値だが、両者は出力相対の framing
+  と素材ネイティブ相対の layer という独立した filter builder であり、実装モジュール間の逆依存を
+  作らないため定数は共有しない。キーフレーム無しの filter 文字列は不変。perspective は bitmap
+  外形を四隅の基準にし、rotate と非 normal blend は固定外形化による既存意味の変化を排除できない
+  ため、この組み合わせだけは従来互換経路を維持する。
+
+## 5. macOS の字幕レンダ用 Chrome 起動（2026-08-24 追記）
+
+- macOS では `.app` 内の Chrome 実行ファイルを子プロセスとして直接起動しない。書き出し専用の
+  一意な `user-data-dir` を作り、`/usr/bin/open -na <Chrome.app> --args` で LaunchServices
+  経由の新規インスタンスを起動する。
+- `--remote-debugging-port=0` で起動し、専用プロファイルの `DevToolsActivePort` を
+  タイムアウト付きで待ってから `puppeteer.connect()` する。通常の連番 PNG 経路と静止画経路は
+  同じ起動・接続・終了層を使う。Linux / Windows は共通層内の `puppeteer.launch()` で
+  実行ファイルを直接起動する。
+- 正常・異常を問わず、接続済み Chrome は CDP の `Browser.close` 相当で終了し、専用プロファイルを
+  削除する。macOS の終了設計は PID の推測や広域 `kill` に依存しない。
+- Chrome 不在、`.app` でない実行ファイル、`DevToolsActivePort` 待機または接続の失敗は、
+  「字幕レンダ用ブラウザの起動に失敗した」ことと Chrome の確認を日本語で示し、書き出しを
+  非 0 で停止する。別スタイルの簡易字幕へは切り替えない。

package/vendor/docs/contract-2026-08-02-preview-parity.md

@@ -560,8 +560,8 @@ 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 配線は T2 予定） | ✅（WebGL rail。chroma → LUT、intensity 対応） |
-| `chroma_key`（source / layer） | 🟡（WebGL rail 配線は T2 予定） | ✅（WebGL rail。source は背景合成、layer はアルファ抜き） |
+| `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`（フリーズ）は

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

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

@@ -288,12 +288,17 @@ export async function lintProject(input, options = {}) {
   validateTrackTransitionOutCompatibility(edit, findings);
 
   if (captionsState.value !== undefined) {
+    const cutsEndSeconds = cutTrackSegments.reduce(
+      (maximum, segment) => Math.max(maximum, segment.end),
+      0,
+    );
     validateCaptions(
       captionsState.value,
       edit,
       analysisState.value,
       findings,
       paths,
+      cutsEndSeconds,
     );
   }
 
@@ -683,6 +688,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")
@@ -2257,7 +2277,7 @@ async function validateReferences(edit, findings, paths, ignoredSourceIds = new
   return { sourceExists };
 }
 
-function validateCaptions(captions, edit, analysis, findings, paths) {
+function validateCaptions(captions, edit, analysis, findings, paths, cutsEndSeconds) {
   const captionPath = relativePath(paths.projectRoot, paths.captionsPath);
   const captionsRoot = captions;
   let displayPolicy;
@@ -2321,7 +2341,7 @@ function validateCaptions(captions, edit, analysis, findings, paths) {
       continue;
     }
     const required = ["id", "start", "end", "text", "speaker", "sourceRef", "edited"];
-    const optional = ["src", "words", "style", "display_text", "display_fragments", "text_style"];
+    const optional = ["src", "time_domain", "words", "style", "display_text", "display_fragments", "text_style"];
     for (const field of required) {
       if (!Object.hasOwn(caption, field)) {
         captionFinding(findings, "captions.schema", `${field} is required`, itemPath);
@@ -2361,6 +2381,15 @@ function validateCaptions(captions, edit, analysis, findings, paths) {
         }
       }
     }
+    if (Object.hasOwn(caption, "time_domain")
+      && caption.time_domain !== "source" && caption.time_domain !== "output") {
+      captionFinding(
+        findings,
+        "captions.schema",
+        'time_domain must be "source" or "output" when present',
+        itemPath,
+      );
+    }
     if (typeof caption.id !== "string" || !/^c-\d{4}$/.test(caption.id)) {
       captionFinding(
         findings,
@@ -2457,17 +2486,29 @@ function validateCaptions(captions, edit, analysis, findings, paths) {
           range: { start: caption.start, end: caption.end },
         });
       }
-      const kept = keptOverlap(caption.start, caption.end, edit?.cuts, caption.src);
-      const ratio = kept / (caption.end - caption.start);
-      if (ratio < 0.5 - EPSILON) {
+      if (caption.time_domain === "output" && caption.end > cutsEndSeconds + EPSILON) {
         addFinding(findings, {
-          severity: "error",
-          check: "captions.cut-visibility",
-          message: "less than 50% of the caption remains after cuts",
+          severity: "warning",
+          check: "captions.output-domain-exceeds-duration",
+          message: `captions[${index}] は time_domain: output の宣言区間が動画総尺 ${cutsEndSeconds.toFixed(1)}s を超えています。書き出しでは ${cutsEndSeconds.toFixed(1)}s までにクランプして表示されます。`,
           path: itemPath,
           range: { start: caption.start, end: caption.end },
         });
       }
+      // output-domain cue は既に最終出力軸にあり、source cut への keptOverlap 射影を行わない。
+      if (caption.time_domain !== "output") {
+        const kept = keptOverlap(caption.start, caption.end, edit?.cuts, caption.src);
+        const ratio = kept / (caption.end - caption.start);
+        if (ratio < 0.5 - EPSILON) {
+          addFinding(findings, {
+            severity: "error",
+            check: "captions.cut-visibility",
+            message: "less than 50% of the caption remains after cuts",
+            path: itemPath,
+            range: { start: caption.start, end: caption.end },
+          });
+        }
+      }
     }
 
     const sourceSegment = sourceSegmentIndex(caption.sourceRef);

package/vendor/packages/edit-store/lib/caption-display.js

@@ -445,7 +445,7 @@ function validateSourceReferences(captions, cuts, edit) {
         }
     });
     captions.forEach((caption, index) => {
-        if (edit.sources.length > 1 && caption.src === undefined) {
+        if (edit.sources.length > 1 && caption.time_domain !== 'output' && caption.src === undefined) {
             fail('MISSING_SOURCE', `captions[${index}].src is required for a multi-source edit`);
         }
         if (caption.src !== undefined && !sourceIds.has(caption.src)) {
@@ -475,8 +475,39 @@ function validateLinearCuts(cuts, edit) {
 }
 function projectOccurrences(captions, cuts, sourceCount) {
     const occurrences = [];
+    let cursor = 0;
+    const segments = cuts.map((cut, cutIndex) => {
+        const speed = finitePositive(cut.speed) ? cut.speed : 1;
+        const duration = (cut.out - cut.in) / speed;
+        const segment = { cut, cutIndex, speed, start: cursor, end: cursor + duration };
+        cursor += duration;
+        return segment;
+    });
+    const timelineEnd = cursor;
+    captions.forEach((caption, captionInputIndex) => {
+        if (!isRecord(caption) || caption.time_domain !== 'output')
+            return;
+        const clampedEnd = Math.min(caption.end, timelineEnd);
+        if (!(clampedEnd > caption.start))
+            return;
+        occurrences.push({
+            source_cue_id: caption.id,
+            src: strictText(caption.src) ? caption.src : null,
+            cut_index: -1,
+            caption_input_index: captionInputIndex,
+            source_start: caption.start,
+            source_end: clampedEnd,
+            start: caption.start,
+            end: clampedEnd,
+            text: caption.display_text ?? caption.text,
+            display_fragments: caption.display_fragments,
+            text_style: caption.text_style
+        });
+    });
     if (cuts.length === 0) {
         captions.forEach((caption, captionInputIndex) => {
+            if (caption?.time_domain === 'output')
+                return;
             const text = caption?.display_text ?? caption?.text;
             if (isRecord(caption) && finiteNonNegative(caption.start) && finitePositive(caption.end) && caption.end > caption.start && typeof text === 'string') {
                 occurrences.push({
@@ -496,17 +527,11 @@ function projectOccurrences(captions, cuts, sourceCount) {
         });
         return occurrences;
     }
-    let cursor = 0;
-    const segments = cuts.map((cut, cutIndex) => {
-        const speed = finitePositive(cut.speed) ? cut.speed : 1;
-        const duration = (cut.out - cut.in) / speed;
-        const segment = { cut, cutIndex, speed, start: cursor, end: cursor + duration };
-        cursor += duration;
-        return segment;
-    });
     captions.forEach((caption, captionInputIndex) => {
         if (!isRecord(caption))
             return;
+        if (caption.time_domain === 'output')
+            return;
         const captionSource = strictText(caption.src) ? caption.src : null;
         if (sourceCount > 1 && captionSource === null) {
             fail('MISSING_SOURCE', `captions[${captionInputIndex}].src is required for a multi-source edit`);
@@ -544,6 +569,10 @@ function validateSourceCaption(caption, index, policy) {
     if (caption.src !== undefined && !strictText(caption.src)) {
         fail('INVALID_CAPTION', `captions[${index}].src must be a non-empty NFC trimmed string when present`);
     }
+    if (caption.time_domain !== undefined
+        && caption.time_domain !== 'source' && caption.time_domain !== 'output') {
+        fail('INVALID_CAPTION', `captions[${index}].time_domain must be source or output when present`);
+    }
     const text = caption.display_text ?? caption.text;
     if (!strictText(text))
         fail('INVALID_TEXT', `captions[${index}] display text must be non-empty, NFC, and trimmed`);
@@ -562,6 +591,8 @@ function validateEmphasisConflicts(captions, emphasisValue) {
     if (!Array.isArray(emphasisValue))
         return;
     captions.forEach((caption, index) => {
+        if (caption.time_domain === 'output')
+            return;
         const conflict = emphasisValue.some(value => isRecord(value)
             && (!strictText(value.src) || !strictText(caption.src) || value.src === caption.src)
             && finiteNonNegative(value.t_start) && finitePositive(value.t_end)

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

@@ -109,6 +109,8 @@ export interface CaptionRecord {
         segment: number;
     } | null;
     edited: boolean;
+    /** 省略時は source。output は edit.json の出力時間軸を直接参照する。 */
+    timeDomain?: 'source' | 'output';
     textStyle?: CaptionTextStyle;
 }
 export declare function parseCaptions(source: string): {
@@ -118,6 +120,8 @@ export declare function parseCaptions(source: string): {
 };
 export declare function mergeCaptionTextStyles(defaultStyle: CaptionTextStyle | undefined, captionStyle: CaptionTextStyle | undefined): CaptionTextStyle | undefined;
 export declare function shiftCaptionLine(source: string, captionId: string, deltaStart: number, deltaEnd: number): string;
+/** 字幕の時刻と domain を絶対値で更新する。undo は元値をそのまま渡して完全復元できる。 */
+export declare function setCaptionTimingLine(source: string, captionId: string, start: number, end: number, timeDomain: 'source' | 'output' | null | undefined, edited: boolean): string;
 export declare function updateCaptionFieldsInSource(source: string, captionId: string, updates: {
     text?: string;
     speaker?: string | null;

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

@@ -4,6 +4,7 @@ exports.CAPTION_ZONES = void 0;
 exports.parseCaptions = parseCaptions;
 exports.mergeCaptionTextStyles = mergeCaptionTextStyles;
 exports.shiftCaptionLine = shiftCaptionLine;
+exports.setCaptionTimingLine = setCaptionTimingLine;
 exports.updateCaptionFieldsInSource = updateCaptionFieldsInSource;
 exports.updateCaptionTextStyleInSource = updateCaptionTextStyleInSource;
 exports.insertCaptionLine = insertCaptionLine;
@@ -129,6 +130,20 @@ function shiftCaptionLine(source, captionId, deltaStart, deltaEnd) {
     nextElement = replaceCaptionProperty(nextElement, 'edited', true, captionId);
     return replaceElement(source, array.openIndex + 1, element, nextElement);
 }
+/** 字幕の時刻と domain を絶対値で更新する。undo は元値をそのまま渡して完全復元できる。 */
+function setCaptionTimingLine(source, captionId, start, end, timeDomain, edited) {
+    if (!captionId || !Number.isFinite(start) || !Number.isFinite(end)
+        || start < 0 || end - start < 0.15) {
+        throw new Error('字幕が短すぎます（0.15 秒未満にはできません）');
+    }
+    const array = locateCaptionArray(source);
+    const element = findCaptionElement(array.elements, captionId);
+    let nextElement = replaceCaptionProperty(element.text, 'start', start, captionId);
+    nextElement = replaceCaptionProperty(nextElement, 'end', end, captionId);
+    nextElement = replaceCaptionProperty(nextElement, 'edited', edited, captionId);
+    nextElement = updateOptionalStyleProperty(nextElement, 'time_domain', timeDomain, `字幕 ${captionId}`);
+    return replaceElement(source, array.openIndex + 1, element, nextElement);
+}
 function updateCaptionFieldsInSource(source, captionId, updates) {
     if (!captionId) {
         throw new Error('字幕 ID を指定してください。');
@@ -281,6 +296,8 @@ function normalizeCaption(value, onTextStyleUnknownKeys) {
         speaker: value.speaker,
         sourceRef,
         edited: value.edited,
+        ...(value.time_domain === 'source' || value.time_domain === 'output'
+            ? { timeDomain: value.time_domain } : {}),
         ...(textStyle !== undefined ? { textStyle } : {})
     };
 }
@@ -427,10 +444,13 @@ function insertIntoEmptyArray(inner, serialized, lineEnding) {
     return `${beforeClosingIndent}${closingIndent}  ${serialized}${lineEnding}${closingIndent}`;
 }
 function serializeCaption(caption) {
+    const timeDomain = caption.timeDomain === undefined
+        ? ''
+        : `, "time_domain": ${JSON.stringify(caption.timeDomain)}`;
     const textStyle = caption.textStyle === undefined
         ? ''
         : `, "text_style": ${JSON.stringify(textStyleToJson(caption.textStyle))}`;
-    return `{ "id": ${JSON.stringify(caption.id)}, "start": ${JSON.stringify(caption.start)}, "end": ${JSON.stringify(caption.end)}, "text": ${JSON.stringify(caption.text)}, "speaker": ${JSON.stringify(caption.speaker)}, "sourceRef": ${JSON.stringify(caption.sourceRef)}, "edited": ${JSON.stringify(caption.edited)}${textStyle} }`;
+    return `{ "id": ${JSON.stringify(caption.id)}, "start": ${JSON.stringify(caption.start)}, "end": ${JSON.stringify(caption.end)}, "text": ${JSON.stringify(caption.text)}, "speaker": ${JSON.stringify(caption.speaker)}, "sourceRef": ${JSON.stringify(caption.sourceRef)}, "edited": ${JSON.stringify(caption.edited)}${timeDomain}${textStyle} }`;
 }
 function isRecord(value) {
     return Boolean(value) && typeof value === 'object' && !Array.isArray(value);

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);

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/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/video-fx.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/bin/validate-captions.mjs

@@ -42,6 +42,7 @@ const CAPTION_FIELDS = new Set([
   "sourceRef",
   "edited",
   "src",
+  "time_domain",
   "words",
   "style",
   "display_text",
@@ -219,6 +220,13 @@ function validateCaptionsArray(captions, optInDefaultTextStyle = null) {
     if (hasOwn(caption, "src") && !isNonEmptyString(caption.src)) {
       fail(`${label}.src は空でない文字列である必要があります`);
     }
+    if (
+      hasOwn(caption, "time_domain")
+      && caption.time_domain !== "source"
+      && caption.time_domain !== "output"
+    ) {
+      fail(`${label}.time_domain は source または output である必要があります`);
+    }
     if (hasOwn(caption, "words")) validateCaptionWords(caption.words, label);
     if (hasOwn(caption, "style") && !CAPTION_STYLES.has(caption.style)) {
       fail(`${label}.style は karaoke/pop/reveal/reveal-word のいずれかである必要があります`);

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

@@ -281,6 +281,11 @@
         "sourceRef": { "$ref": "#/$defs/sourceRef" },
         "edited": { "type": "boolean" },
         "src": { "type": "string", "minLength": 1, "pattern": "\\S" },
+        "time_domain": {
+          "enum": ["source", "output"],
+          "default": "source",
+          "$comment": "start/end と words[].start/end の時刻ドメイン。省略時は後方互換の source。output は edit.json の出力時間軸を直接参照し、src は任意の出所情報として保持できる。"
+        },
         "words": {
           "type": "array",
           "items": { "$ref": "#/$defs/captionWord" }
@@ -295,7 +300,7 @@
         },
         "text_style": { "$ref": "#/$defs/textStyle" }
       },
-      "$comment": "end > start、ID 一意性、words[].end >= start は JSON Schema 標準だけでは兄弟値を比較できないため validate-captions.mjs でも検証する。style は既存の単語リビール演出、text_style は見た目のスタイルであり別契約。"
+      "$comment": "end > start、ID 一意性、words[].end >= start は JSON Schema 標準だけでは兄弟値を比較できないため validate-captions.mjs でも検証する。time_domain 省略時は source。style は既存の単語リビール演出、text_style は見た目のスタイルであり別契約。"
     },
     "emphasisWordItem": {
       "type": "object",

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/packages/schemas/test/validate-captions.test.mjs

@@ -131,6 +131,18 @@ const displayPolicy = {
   },
 };
 
+test("time_domain は source/output を受理し、省略時も後方互換で通る", () => {
+  for (const time_domain of [undefined, "source", "output"]) {
+    const value = { ...caption };
+    if (time_domain !== undefined) value.time_domain = time_domain;
+    const executed = runValue([value]);
+    assert.equal(executed.status, 0, executed.stderr);
+  }
+  const invalid = runValue([{ ...caption, time_domain: "timeline" }]);
+  assert.equal(invalid.status, 1, invalid.stdout);
+  assert.match(invalid.stderr, /time_domain は source または output/u);
+});
+
 test("display policy, manual fragments, and reference-pixel style pass together", () => {
   const executed = runValue({
     display_policy: displayPolicy,

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 を使い、保持中は動かさない。