akari-video 0.1.17 → 0.1.18

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akari-video",
-  "version": "0.1.17",
+  "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/packages/akari-launcher/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akari-video",
-  "version": "0.1.17",
+  "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,
     );
   }
 
@@ -2272,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;
@@ -2336,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);
@@ -2376,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,
@@ -2472,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/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/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,