akari-video 1.3.0-beta.9 → 1.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akari-video",
-  "version": "1.3.0-beta.9",
+  "version": "1.3.0",
   "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/src/history-policy.mjs

@@ -60,6 +60,11 @@ const HISTORY_BLOCK_BODY = [
     '.akari/cache/**',
     '.akari/diffs/**',
     '!.akari/diffs/.gitkeep',
+    '.akari/write.lock',
+    '.akari/write.lock.claim/',
+    '.akari/write.lock.wait',
+    '.akari/write-journal.json',
+    '.akari/work/journal/',
     '',
     '# 素材の分析結果は作り直すのに手間がかかるので、変更履歴に残します。',
     '!.akari/sidecars/**',

package/vendor/docs/contract-2026-10-12-caption-look-v1.md

@@ -5,7 +5,7 @@
 
 ## 移行と書き出し
 
-移行は render-cut の書き出し結果（HTML と CSS 変数）を保つ。移行済みの強調範囲は、描画時に `migrated_emphasis` に保存した元の項目と移行前の配列内の位置から `emphasis_words` へ戻す。残った項目の順を保ち、移した項目を位置の昇順に差し込む。追加のプロパティと項目の順序も保つ。旧形式だけの入力はそのまま描画器へ渡す。
+移行は主経路（`resolveCaptionPlan` を通る書き出しとプレビュー）で、前後の HTML と CSS 変数を保つ。移行済みの強調範囲は、描画時に `migrated_emphasis` に保存した元の項目と移行前の配列内の位置から `emphasis_words` へ戻す。残った項目の順を保ち、移した項目を位置の昇順に差し込む。追加のプロパティと項目の順序も保つ。旧形式だけの入力はそのまま描画器へ渡す。
 
 | `style_hint`（省略時の `emotion`） | `motion.in.id` |
 |---|---|
@@ -52,3 +52,46 @@ source anchor は字幕が描かれる同じ素材の配置ごとに、速度と
 ## 検証
 
 構造は captions schema が判定する。文書の意味では v1 run の範囲外、ファイル内の run id 重複、anchor のない `spoken` を error として保存を拒む。`validate-captions` も文書の意味の層を呼び、error があれば非 0 で終了する。旧 runs v0 の範囲外・空の区間は従来どおり `captions.run-range` の warning とする。意味の error は診断を出す。描画経路での除外は後の版で行う（除外に使う純関数 `renderableCaptionRuns` は用意済み）。プロジェクトの意味では anchor の写像不能や表示窓の外を warning とし、経路の対応では選んだ描画経路が motion を描けるか判定する。診断はコード・重大度・パス・日本語メッセージを共有する。
+
+## 書き込みの境界
+
+`writeProjectFilesTransactional(projectRoot, { files, label })` は、プロジェクト内の相対パスごとに `expectedHash` と `next` を受け取る。`expectedHash` は生のバイト列の SHA-256 を `sha256:<64 桁の十六進数>` で指定する。`null` はファイルが無いことを期待し、省略時は比較しない。`next: null` は比較だけを行う。読んだだけの `edit.json` なども比較へ含められる。1 件でも違えば何も書かず、`ConflictError` の `files` に競合した相対パスを返す。
+
+書き込みは `.akari/write.lock` の排他作成でプロセス間を直列化する。lock の持ち主が同じホストで終了した場合、または作成から 30 秒を超えた場合は取得し直せる。同じプロセス内でもプロジェクトごとに順番を保つ。比較のない書き込みは lock の下でファイルごとに一時ファイルから rename し、途中で失敗しても先に書いたファイルを戻さず、journal と `.akari/work/` は作らない。比較つきの書き込みは、変更前に `.akari/write-journal.json` と `.akari/work/journal/<id>/` の元バイト列を保存する。途中で失敗したら元のバイト列に戻す。すべての rename が済んだら journal に `committed: true` を記録し、片付けに失敗しても保存は成功とする。
+
+lock を待つ側は `.akari/write.lock.wait` に印を置く。放す側は lock を消した後でその印を消し、待ち手に短く取得を譲る。
+
+書き込み先の相対パスは正規化し、同じファイルを指す鍵の重複、代替データストリームの `:`、lock・journal・退避先を拒む。`./edit.json` は `edit.json` として扱う。比較する hash は生バイトを基準にするが、UTF-8 BOM 付きのファイルでは BOM を除いたバイト列の hash も一致として受け入れる。元の BOM は取り消し用の変更前全文に残す。
+
+比較がすべて通った後、実際に書く各ファイルの rename 直前に `onWillWrite(destination, name)` を呼び、rename 完了後に同じファイルの `onDidWrite` を呼ぶ。競合や内容が同じため書かないファイルにはどちらも通知しない。
+
+次の書き込みの前に journal が残っていれば回復する。`committed: true` なら戻さず片付ける。印がなければ現在の内容が止まった書き込みの値と一致するファイルだけ元に戻し、元の値と一致するものはそのままにする。どちらでもないファイルや退避が読めないファイルは触らず通知する。journal が壊れていれば退避し、ファイルは触らない。回復通知は保存結果の `recovered` と `onRecovered` で受け取れる。journal が無ければ起動時の回復は lock を取らず直ちに終わる。
+
+## 見た目の編集コマンド
+
+`planCaptionStyleEdit` は `captions`、`targets`、`parts`、`source` を受け、副作用なしに `next`、`changed`、`notices` を返す。対象は `{caption_id}`（行）、`{caption_id, range}`（文字範囲）、`{default:true}`（既定スタイル）。対象ごとに `parts` を上書きできる。`range` は書記素の半開区間 `{from,to}`、または `{quote,occurrence}` で指定する。引用の候補は NFC にそろえ、左から重ならないように数える。一致後はその末尾から次を探す（「ああああ」の「ああ」は 2 件）。返す位置は元の文字列の書記素単位。同じ引用が複数あれば 1 始まりの `occurrence` が必要。引用が見つからない場合や範囲が空・範囲外の場合は失敗する。範囲の効果音と効果は使えず、行の効果音と効果は従来の attach 経路で扱う。
+
+行の look は許可項目を部品ごとに置換し、動きは `animation` 全体を置換する。範囲は `runs[].look` と `runs[].motion` を置換し、許可外の look 項目を外して通知する。同じ区間の v1 run は更新し、新しい区間にはファイル全体で一意の id を付ける。実測 words に対応付けられる場合だけ anchor を付ける。行の旧 `style_preset` は現在のカタログで値に解き、出所を記録してから外す。カタログに無ければ元の指定を保って通知する。配列ルートに `{default:true}` を当てた場合は `{default_text_style,captions}` にする。
+
+スタイルを当てても大きさは変えない。行の既存の `size_px` と `reference_height_px` を保ち、`size_px` が無ければ実効値を明示する。px 系の値は当て先の大きさに換算する。`style_sources.look` の hash は look の許可項目から `size_px` と `reference_height_px` を除いた値に付ける。`original_hash` は出所の値、`applied_hash` は換算後に保存した値である。`applied_at` には適用時刻を記録する。
+
+`planCaptionStyleClear` は run の指定全体を消す `mode: "run"`、選んだ文字を重なる run から切り取る `mode: "range"`、範囲指定のない `{caption_id}` で行の look・動き・出所・旧 preset を消す操作を扱う。行の大きさと配置は保つ。`planCaptionStyleReapply` は出所の現在の値を引き、部品ごとに `same`、`updated`、`missing` と手直しの有無を返す。`apply` に指定した部品だけ値を当て直す。出所が無ければ値を保って通知する。
+
+`planCaptionSizeEdit({captions,targets,size_px})` は行の大きさと、その行の look および範囲の look の px 系の値を、`新しい大きさ ÷ 変更前の実効の大きさ` で変える。小数は 6 桁に丸め、`reference_height_px` を保つ。比が 1 なら変更しない。元の `applied_hash` と値が一致していた部品は換算後の hash に更新し、大きさの変更だけで手直しとは判定しない。
+
+Node 側の `applyCaptionStyle`、`clearCaptionStyle`、`reapplyCaptionStyle`、`setCaptionSize` は読んだ全文の hash を比較してから保存し、書く前と後の全文・hash を返す。対象ファイルは既定の `captions.json` / `edit.json` に加え、プロジェクト直下の対応する `captions.<slug>.json` / `edit.<slug>.json` を指定できる。期待 hash は役割名（`captions` / `edit`）または実ファイル名で受け、前後の全文と `written` は実ファイル名を鍵にする。読んだだけのファイルも競合の比較に含める。保存前に v1 の項目の形と文書の意味を検査し、error があれば `AKARI_CAPTIONS_INVALID` と診断を返して書かない。形の検査は旧い行の他の項目や v0 の run の形を理由に拒まない。edit-lint も同じ v1 の形の診断を表示する。
+
+書き込み lock の奪取に使う `.akari/write.lock.claim` は、5 秒を超えて残ったものを取り除いてから再取得する。書き込み先のフォルダで作成権限が無いと確かめたときは、待ち上限を待たずに権限エラーを返す。
+`.akari/write.lock.claim` とその下、および試し書き名 `.akari/write.lock.probe-*` は書き込み先に指定できない。
+
+## 移行と CLI
+
+移行と preset の解決には同梱とライブラリを合わせた現在の textstyle カタログを使う。移行は現在の edit.json も読んで計画し、書き込む前の字幕データを保存境界の期待 hash として扱う。出所を指定せず look または motion を当てた場合、その部品の古い `style_sources` を消す。両部品の出所が無くなれば `style_sources` 自体を消す。
+
+CLI の `--caption <index>` は id の無い行や id が重複した行にも index で当てる。`--caption <id>` は id で指定する。CLI の JSON 出力の `changes[].before` と `changes[].after` は実際に計画または保存した文書の値を示す。
+
+アプリの `applyCaptionStyle`、`clearCaptionStyle`、`reapplyCaptionStyle`、`setCaptionSize`、`migrateCaptionLook` は projectRootUri と対象 URI を検査し、`captionsUri` と対になる edit のあるフォルダを根として別名の組も扱い、任意の期待 hash を受ける。成功は実ファイル名で書いたファイル、通知、前後の全文と hash を返す。`writeEditSnapshot` の期待 hash も edit と captions の役割に対応する候補を比較する。競合は `conflict: true`、検証エラーは `invalid: true` と診断を返し、どちらも書かない。中断した書き込みは `recoverInterruptedWrite` で元に戻す。アプリはプロジェクトを開いたときに回復を試み、通知を表示する。字幕スタイルの undo と redo は前後の全文を各 1 件の履歴に持ち、保存後の hash と一致するときだけ逆向きに書く。競合したら読み直して取り消しややり直しを失敗として知らせる。
+
+移行の保存はプロジェクト直下の `captions.json` と `captions.<slug>.json` を対象にし、対応する edit を比較する。強調語の id は移行済みと未解決の run に残る `migrated_from` も予約済みとして採番する。古い強調語と run の id が重なれば、強調語に新しい id を与えてから移す。主経路（`resolveCaptionPlan` を通る書き出しとプレビュー）では移行の前後で HTML と CSS 変数が同じ。取り出した字幕と GPU の適格判定の入口は未対応のため、移行の保存はまだ一般の利用に勧めない。
+
+`akari-apply-textstyle` の既存の対象指定、`--dry-run`、JSON 出力と終了コードは保つ。保存には同じ書き込み境界を使う。行に当てた場合は `style_sources.look` を記録し、旧 `style_preset` を値に解いて外す。既存の CLI が行っていた深い合成は互換のため維持する。

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

@@ -1,6 +1,6 @@
 {
   "name": "akari-video",
-  "version": "1.3.0-beta.9",
+  "version": "1.3.0",
   "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/akari-launcher/src/history-policy.mjs

@@ -60,6 +60,11 @@ const HISTORY_BLOCK_BODY = [
     '.akari/cache/**',
     '.akari/diffs/**',
     '!.akari/diffs/.gitkeep',
+    '.akari/write.lock',
+    '.akari/write.lock.claim/',
+    '.akari/write.lock.wait',
+    '.akari/write-journal.json',
+    '.akari/work/journal/',
     '',
     '# 素材の分析結果は作り直すのに手間がかかるので、変更履歴に残します。',
     '!.akari/sidecars/**',

package/vendor/packages/edit-lint/src/lint/captions.mjs

@@ -3,7 +3,7 @@ import { lintText } from '../i18n.mjs';
 import { buildMatcher, protectedTermsFrom } from "../../../word-book/src/index.mjs";
 import { resolveWordBookSync, scanRecord } from "../../../word-book/src/index.mjs";
 import { EPSILON, addFinding, captionFinding, isFiniteNumber, isNonEmptyString, isPositiveNumber, isRecord, relativePath } from "./shared.mjs";
-import { resolveCaptionDisplay, validateCaptionsSemantics, CAPTION_RUN_FIELDS } from "./external.mjs";
+import { resolveCaptionDisplay, validateCaptionsSemantics, validateCaptionLookV1Shape, CAPTION_RUN_FIELDS } from "./external.mjs";
 import { validateCaptionAnimation, validateTextStyle } from "./caption-style.mjs";
 import { captionLanguageDefaults, resolveContentLanguage } from "../../../content-language/src/index.mjs";
 import { readContentLanguageSync } from "../../../content-language/src/node.mjs";
@@ -452,7 +452,14 @@ export function validateCaptions(captions, edit, analysis, findings, paths, cuts
       captionFinding(findings, "captions.display-policy", error instanceof Error ? error.message : String(error), captionPath);
     }
   }
-  for (const diagnostic of validateCaptionsSemantics({ captions: captionsRoot, edit, timeline })) {
+  const seenDiagnostics = new Set();
+  for (const diagnostic of [...validateCaptionLookV1Shape(captionsRoot),
+    ...validateCaptionsSemantics({ captions: captionsRoot, edit, timeline })]) {
+    const identity = JSON.stringify([diagnostic.code, diagnostic.path, diagnostic.message]);
+    if (seenDiagnostics.has(identity)) continue;
+    if (diagnostic.code === 'captions.look.shape' && findings.some(item => item.severity === 'error'
+      && item.check === 'captions.schema' && item.path === diagnostic.path)) continue;
+    seenDiagnostics.add(identity);
     addFinding(findings, { severity: diagnostic.severity, check: diagnostic.code,
       message: diagnostic.message, path: diagnostic.path });
   }

package/vendor/packages/edit-lint/src/lint/external.mjs

@@ -17,6 +17,7 @@ export const {
   TRANSITION_TYPE_IDS,
   withoutItemAnchors,
   validateCaptionsSemantics,
+  validateCaptionLookV1Shape,
 } = createRequire(import.meta.url)("../../../edit-store/lib/index.js");
 
 

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

@@ -1,2 +1,4 @@
 /** 鍵を再帰的に整列した JSON を UTF-8 で SHA-256 にする。 */
 export declare function captionValueHash(value: unknown): string;
+/** UTF-8 の生バイト列をブラウザでも同じ SHA-256 にする。 */
+export declare function projectFileContentHash(text: string): string;

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

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.captionValueHash = captionValueHash;
+exports.projectFileContentHash = projectFileContentHash;
 /** 鍵を再帰的に整列した JSON を UTF-8 で SHA-256 にする。 */
 function captionValueHash(value) {
     const sorted = (entry) => {
@@ -10,7 +11,11 @@ function captionValueHash(value) {
             return Object.fromEntries(Object.keys(entry).sort().map(key => [key, sorted(entry[key])]));
         return entry;
     };
-    const bytes = new TextEncoder().encode(JSON.stringify(sorted(value)));
+    return projectFileContentHash(JSON.stringify(sorted(value)));
+}
+/** UTF-8 の生バイト列をブラウザでも同じ SHA-256 にする。 */
+function projectFileContentHash(text) {
+    const bytes = new TextEncoder().encode(text);
     const length = Math.ceil((bytes.length + 9) / 64) * 64;
     const padded = new Uint8Array(length);
     padded.set(bytes);

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

@@ -26,6 +26,8 @@ type CaptionsRoot = {
     emphasis_words?: Emphasis[];
     [key: string]: unknown;
 };
+/** 旧い強調の ID は移行済み run に残った出所 ID も予約済みとして扱う。 */
+export declare function nextEmphasisWordId(root: CaptionsRoot | CaptionRow[]): string;
 export declare const CAPTION_EMPHASIS_MOTION: Readonly<Record<string, string>>;
 export declare function readCaptionLookV1(root: CaptionsRoot | CaptionRow[], catalog: TextstyleCatalog): {
     captions: CaptionRow[];

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

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CAPTION_EMPHASIS_MOTION = void 0;
+exports.nextEmphasisWordId = nextEmphasisWordId;
 exports.readCaptionLookV1 = readCaptionLookV1;
 exports.planCaptionLookMigration = planCaptionLookMigration;
 exports.captionRenderInputFromV1 = captionRenderInputFromV1;
@@ -8,6 +9,30 @@ const caption_runs_1 = require("./caption-runs");
 const caption_hash_1 = require("./caption-hash");
 const caption_look_v1_1 = require("./caption-look-v1");
 const caption_style_preset_1 = require("./caption-style-preset");
+const isRecord = (value) => value !== null && typeof value === 'object' && !Array.isArray(value);
+const captionRows = (root) => Array.isArray(root) ? root : Array.isArray(root?.captions) ? root.captions : [];
+const emphasisWords = (root) => Array.isArray(root) || !Array.isArray(root?.emphasis_words) ? [] : root.emphasis_words;
+const unresolvedRuns = (root) => Array.isArray(root) || !Array.isArray(root?.unresolved_runs) ? []
+    : root.unresolved_runs.flatMap(item => isRecord(item) && isRecord(item.run)
+        ? [item.run] : []);
+/** 旧い強調の ID は移行済み run に残った出所 ID も予約済みとして扱う。 */
+function nextEmphasisWordId(root) {
+    const used = new Set(emphasisWords(root).flatMap(item => isRecord(item) && typeof item.id === 'string'
+        ? [item.id] : []));
+    for (const row of captionRows(root))
+        for (const run of rowRuns(row))
+            if (isRecord(run) && typeof run.migrated_from === 'string')
+                used.add(run.migrated_from);
+    for (const run of unresolvedRuns(root))
+        if (typeof run.migrated_from === 'string')
+            used.add(run.migrated_from);
+    let number = 1;
+    while (used.has(`e-${String(number).padStart(4, '0')}`))
+        number++;
+    if (number > 9999)
+        throw new Error('強調語の id に空きがありません。');
+    return `e-${String(number).padStart(4, '0')}`;
+}
 exports.CAPTION_EMPHASIS_MOTION = {
     'one-char-bang': 'pop', 'one-char-jumble': 'jitter', 'size-pulse': 'zoom-pulse'
 };
@@ -41,6 +66,8 @@ function projectEmphasis(rows, item) {
     if (!motion)
         return undefined;
     const candidates = rows.flatMap(row => {
+        if (!isRecord(row))
+            return [];
         if (row.runs !== undefined && (!Array.isArray(row.runs)
             || row.runs.some(run => !run || typeof run !== 'object' || Array.isArray(run))))
             return [];
@@ -50,7 +77,7 @@ function projectEmphasis(rows, item) {
     return candidates.length === 1 ? candidates[0] : undefined;
 }
 function rowRuns(row) {
-    return Array.isArray(row.runs) ? row.runs : [];
+    return isRecord(row) && Array.isArray(row.runs) ? row.runs : [];
 }
 function invalidLegacyRun(run, row) {
     if (['id', 'look', 'motion', 'anchor', 'fire'].some(key => Object.prototype.hasOwnProperty.call(run, key))) {
@@ -61,15 +88,16 @@ function invalidLegacyRun(run, row) {
         || run.from < 0 || run.to > length || run.from >= run.to;
 }
 function readCaptionLookV1(root, catalog) {
-    const rows = Array.isArray(root) ? root : root.captions;
-    const emphasis = Array.isArray(root) ? [] : root.emphasis_words ?? [];
+    const rows = captionRows(root);
+    const emphasis = emphasisWords(root);
     const projected = new Map();
-    const allRuns = [...rows.flatMap(rowRuns), ...(Array.isArray(root) ? [] :
-            (Array.isArray(root.unresolved_runs) ? root.unresolved_runs.flatMap(item => item.run ? [item.run] : []) : []))];
+    const allRuns = [...rows.flatMap(rowRuns), ...unresolvedRuns(root)];
     const occupiedIndices = new Set(allRuns.flatMap(run => run && typeof run === 'object'
         && Number.isInteger(run.migrated_emphasis?.index) ? [run.migrated_emphasis.index] : []));
     let originalIndex = 0;
     for (const item of emphasis) {
+        if (!isRecord(item))
+            continue;
         while (occupiedIndices.has(originalIndex))
             originalIndex++;
         const index = originalIndex++;
@@ -80,12 +108,16 @@ function readCaptionLookV1(root, catalog) {
     }
     const notices = [];
     const captions = rows.map(row => {
+        if (!isRecord(row))
+            return row;
         const resolved = (0, caption_style_preset_1.resolveCaptionStylePreset)(row, catalog);
         const runs = rowRuns(row).map(run => !run || typeof run !== 'object' || Array.isArray(run)
             || invalidLegacyRun(run, row) ? run : { ...run,
             ...(run.style && !run.look ? { look: { ...run.style } } : {}),
             ...(run.animation && !run.dormant_animation ? { dormant_animation: run.animation } : {}) });
         for (const item of emphasis) {
+            if (!isRecord(item))
+                continue;
             if (runs.some(run => run && typeof run === 'object' && run.migrated_from === item.id))
                 continue;
             const interval = projected.get(item.id);
@@ -109,15 +141,15 @@ function readCaptionLookV1(root, catalog) {
 }
 function planCaptionLookMigration(captions, catalog, _edit) {
     const source = structuredClone(captions);
-    const rows = Array.isArray(source) ? source : source.captions;
-    const emphasis = Array.isArray(source) ? [] : source.emphasis_words ?? [];
+    const rows = captionRows(source);
+    const emphasis = emphasisWords(source);
     const unresolved = [];
     const notices = [];
-    const allRuns = [...rows.flatMap(rowRuns),
-        ...(Array.isArray(source) ? [] : (Array.isArray(source.unresolved_runs)
-            ? source.unresolved_runs.flatMap(item => item.run ? [item.run] : []) : []))];
+    const allRuns = [...rows.flatMap(rowRuns), ...unresolvedRuns(source)];
     let invalidLegacyCount = 0;
     for (const row of rows) {
+        if (!isRecord(row))
+            continue;
         if (row.style_preset) {
             const preset = (0, caption_style_preset_1.resolveCaptionStylePreset)(row, catalog);
             if (preset.resolved) {
@@ -174,13 +206,15 @@ function planCaptionLookMigration(captions, catalog, _edit) {
     const migrated = new Set();
     let originalIndex = 0;
     for (const item of emphasis) {
+        if (!isRecord(item))
+            continue;
         while (occupiedIndices.has(originalIndex))
             originalIndex++;
         const index = originalIndex++;
-        if (rows.some(row => rowRuns(row).some(run => run && typeof run === 'object'
-            && run.migrated_from === item.id))) {
-            migrated.add(item.id);
-            continue;
+        if (allRuns.some(run => run && typeof run === 'object' && run.migrated_from === item.id)) {
+            const old = item.id;
+            item.id = nextEmphasisWordId(source);
+            notices.push(`強調語 ${old} は id が重なっていたので ${item.id} に振り直しました`);
         }
         const candidate = projectEmphasis(rows, item);
         if (!candidate) {
@@ -199,13 +233,15 @@ function planCaptionLookMigration(captions, catalog, _edit) {
         migrated.add(item.id);
         occupiedIndices.add(index);
     }
-    if (!Array.isArray(source) && Object.prototype.hasOwnProperty.call(source, 'emphasis_words')) {
-        source.emphasis_words = emphasis.filter(item => !migrated.has(item.id));
+    if (!Array.isArray(source) && Array.isArray(source.emphasis_words)) {
+        source.emphasis_words = emphasis.filter(item => !isRecord(item) || !migrated.has(item.id));
     }
-    const originalRows = Array.isArray(captions) ? captions : captions.captions;
+    const originalRows = captionRows(captions);
     const diff = [];
     rows.forEach((row, index) => {
-        const before = originalRows[index] ?? {};
+        if (!isRecord(row))
+            return;
+        const before = isRecord(originalRows[index]) ? originalRows[index] : {};
         for (const key of new Set([...Object.keys(before), ...Object.keys(row)])) {
             if (JSON.stringify(before[key]) !== JSON.stringify(row[key]))
                 diff.push({
@@ -218,19 +254,36 @@ function planCaptionLookMigration(captions, catalog, _edit) {
         diff.push({ path: 'emphasis_words', before: captions.emphasis_words, after: source.emphasis_words });
     }
     return { next: source, diff,
-        unresolved, notices };
+        unresolved, notices: [...new Set(notices)] };
 }
 /** Restore the renderer's legacy input without changing a legacy-only document. */
 function captionRenderInputFromV1(root) {
-    const rows = Array.isArray(root) ? root : root.captions;
+    const rows = captionRows(root);
+    const legacyIds = emphasisWords(root).flatMap(item => isRecord(item) ? [item.id] : []);
     if (!rows.some(row => rowRuns(row).some(run => run && typeof run === 'object'
-        && (run.look || run.dormant_animation || run.migrated_from))))
+        && (run.look || run.dormant_animation || run.migrated_from)))
+        && new Set(legacyIds).size === legacyIds.length)
         return root;
     const copy = structuredClone(root);
-    const nextRows = Array.isArray(copy) ? copy : copy.captions;
-    const emphasis = Array.isArray(copy) ? [] : [...(copy.emphasis_words ?? [])];
+    const nextRows = captionRows(copy);
+    const emphasis = [...emphasisWords(copy)];
+    const migratedIds = new Set();
+    for (const row of nextRows)
+        for (const run of rowRuns(row))
+            if (typeof run?.migrated_from === 'string')
+                migratedIds.add(run.migrated_from);
+    const ids = new Set();
+    for (const item of emphasis) {
+        if (!isRecord(item))
+            continue;
+        if (ids.has(item.id) || migratedIds.has(item.id))
+            item.id = nextEmphasisWordId({ captions: nextRows, emphasis_words: emphasis });
+        ids.add(item.id);
+    }
     const migrated = [];
     for (const row of nextRows) {
+        if (!isRecord(row))
+            continue;
         if (!Array.isArray(row.runs))
             continue;
         row.runs = row.runs.flatMap((run) => {
@@ -240,13 +293,25 @@ function captionRenderInputFromV1(root) {
                 const hint = Object.keys(exports.CAPTION_EMPHASIS_MOTION)
                     .find(key => exports.CAPTION_EMPHASIS_MOTION[key] === run.motion?.in?.id);
                 const restored = run.migrated_emphasis?.item;
-                if (restored)
-                    migrated.push({ index: run.migrated_emphasis.index, item: structuredClone(restored) });
-                else if (hint)
-                    emphasis.push({ id: run.migrated_from,
+                if (restored) {
+                    const item = structuredClone(restored);
+                    if (ids.has(item.id))
+                        item.id = nextEmphasisWordId({ captions: nextRows,
+                            emphasis_words: [...emphasis, ...migrated.map(entry => entry.item)] });
+                    ids.add(item.id);
+                    migrated.push({ index: run.migrated_emphasis.index, item });
+                }
+                else if (hint) {
+                    let id = run.migrated_from;
+                    if (ids.has(id))
+                        id = nextEmphasisWordId({ captions: nextRows,
+                            emphasis_words: [...emphasis, ...migrated.map(entry => entry.item)] });
+                    ids.add(id);
+                    emphasis.push({ id,
                         word: (0, caption_runs_1.captionGraphemes)(row.display_text ?? row.text ?? '').slice(run.from, run.to).join(''),
                         t_start: run.anchor.start, t_end: run.anchor.end, emotion: run.emotion ?? 'emphasis',
                         style_hint: hint, ...(run.anchor.src ? { src: run.anchor.src } : {}) });
+                }
                 return [];
             }
             const next = { ...run };
@@ -263,7 +328,7 @@ function captionRenderInputFromV1(root) {
             return [next];
         });
     }
-    if (!Array.isArray(copy) && (Object.prototype.hasOwnProperty.call(copy, 'emphasis_words') || migrated.length)) {
+    if (!Array.isArray(copy) && (Array.isArray(copy.emphasis_words) || migrated.length)) {
         const restored = [...emphasis];
         for (const entry of migrated.sort((left, right) => left.index - right.index)) {
             restored.splice(Math.min(entry.index, restored.length), 0, entry.item);

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

@@ -0,0 +1,18 @@
+import { type CaptionSemanticDiagnostic, type CaptionSemanticsContext } from './caption-semantics';
+export declare const CAPTION_LOOK_SHAPE_ANIMATION_IDS: string[];
+export declare const CAPTION_LOOK_SHAPE_KEYS: {
+    run: string[];
+    look: string[];
+    anchor: string[];
+    styleSources: string[];
+    source: string[];
+    unresolvedRun: string[];
+};
+/** v1 の追加項目だけを検査する。旧い行の他の項目と runs v0 の形は許す。 */
+export declare function validateCaptionLookV1Shape(captionsRoot: unknown): CaptionSemanticDiagnostic[];
+export declare class CaptionsInvalidError extends Error {
+    readonly diagnostics: CaptionSemanticDiagnostic[];
+    readonly code = "AKARI_CAPTIONS_INVALID";
+    constructor(diagnostics: CaptionSemanticDiagnostic[]);
+}
+export declare function assertCaptionsWritable(captionsRoot: CaptionSemanticsContext['captions'], ctx?: Omit<CaptionSemanticsContext, 'captions'>): void;

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

@@ -0,0 +1,134 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CaptionsInvalidError = exports.CAPTION_LOOK_SHAPE_KEYS = exports.CAPTION_LOOK_SHAPE_ANIMATION_IDS = void 0;
+exports.validateCaptionLookV1Shape = validateCaptionLookV1Shape;
+exports.assertCaptionsWritable = assertCaptionsWritable;
+const caption_semantics_1 = require("./caption-semantics");
+const isObject = (value) => value !== null && typeof value === 'object' && !Array.isArray(value);
+const has = (value, key) => Object.prototype.hasOwnProperty.call(value, key);
+const number = (value) => typeof value === 'number' && Number.isFinite(value);
+const positive = (value) => number(value) && value > 0;
+const nonnegative = (value) => number(value) && value >= 0;
+const integer = (value) => Number.isInteger(value);
+const nonempty = (value) => typeof value === 'string' && value.length > 0;
+const hex = (value) => typeof value === 'string' && /^#(?:[\da-fA-F]{3}|[\da-fA-F]{6}|[\da-fA-F]{8})$/.test(value);
+const runId = (value) => typeof value === 'string' && /^r-\d{4,}$/.test(value);
+const fire = (value) => ['shown', 'spoken', 'whole'].includes(String(value));
+const enumOf = (...values) => (value) => typeof value === 'string' && values.includes(value);
+function objectRule(fields, required = [], minProperties = 0) {
+    return value => isObject(value) && Object.keys(value).length >= minProperties
+        && required.every(key => has(value, key))
+        && Object.entries(value).every(([key, entry]) => fields[key] !== undefined && fields[key](entry));
+}
+const stroke = objectRule({ method: enumOf('webkit-outline'), color: hex, width_px: nonnegative });
+const shadow = objectRule({ color: hex, opacity: value => number(value) && value >= 0 && value <= 1,
+    blur_px: nonnegative, distance_px: nonnegative, angle_deg: number }, ['color']);
+const glow = objectRule({ color: hex, density: nonnegative, spread: nonnegative, offset_x: number, offset_y: number }, ['color']);
+const background = objectRule({ color: hex, opacity: value => number(value) && value >= 0 && value <= 1,
+    radius_px: nonnegative, padding_px: nonnegative, width_pct: nonnegative, height_pct: nonnegative,
+    fit: enumOf('text', 'frame'), offset_x: number, offset_y: number, mode: enumOf('per-line', 'block') });
+const lookFields = { color: hex, font_weight: value => integer(value) && value >= 1 && value <= 1000,
+    italic: value => typeof value === 'boolean', underline: value => typeof value === 'boolean', letter_spacing_em: number,
+    scale: positive, baseline_shift_em: number, rotate_deg: value => number(value) && Math.abs(value) <= 180,
+    stroke, shadow, glow, background };
+const look = objectRule(lookFields);
+exports.CAPTION_LOOK_SHAPE_ANIMATION_IDS = ['fade-in-out', 'soft-fade', 'fade-up', 'fade-down', 'cinematic-fade',
+    'slide-left', 'slide-right', 'slide-up', 'slide-down', 'push-left', 'push-right', 'push-up', 'push-down',
+    'rise-soft', 'drop-in', 'zoom-in-out', 'zoom-pop', 'zoom-pulse', 'pop', 'bounce', 'squash-pop',
+    'stretch-in', 'stomp', 'snap', 'rotate-in', 'spin-in', 'roll-in', 'spiral-in', 'swing', 'shake',
+    'jitter', 'glitch', 'flash', 'heartbeat', 'typewriter', 'wipe-left', 'wipe-right', 'wobble',
+    'float', 'breath', 'neon-flicker', 'hologram', 'retro-flicker', 'caption-rise', 'news-ticker',
+    'marquee-left', 'crawl-up'];
+const animationIds = new Set(exports.CAPTION_LOOK_SHAPE_ANIMATION_IDS);
+const slot = objectRule({ id: value => typeof value === 'string' && animationIds.has(value), duration_sec: positive,
+    ease: value => value === null || typeof value === 'string' && /\S/.test(value),
+    amp: value => value === null || positive(value) }, ['id']);
+const motion = objectRule({ in: slot, loop: slot, out: slot }, [], 1);
+const anchorFields = { src: nonempty, start: nonnegative, end: nonnegative,
+    domain: enumOf('source', 'output') };
+const anchor = objectRule(anchorFields, ['start', 'end', 'domain']);
+const sourceFields = { kind: enumOf('builtin', 'library', 'my'), id: nonempty, uid: nonempty,
+    revision: value => integer(value) && value >= 0, original_hash: nonempty,
+    applied_hash: nonempty, applied_at: nonempty,
+    requires: value => Array.isArray(value) && value.every(objectRule({ id: nonempty,
+        version: value => typeof value === 'string', hash: nonempty }, ['id', 'version', 'hash'])) };
+const source = objectRule(sourceFields, ['kind', 'id', 'original_hash', 'applied_hash']);
+const styleSourcesFields = { look: source, motion: source };
+const styleSources = objectRule(styleSourcesFields);
+const migratedEmphasis = objectRule({ index: nonnegative, item: value => isObject(value) }, ['index', 'item']);
+const v1Fields = {
+    id: runId, from: integer, to: integer, role: nonempty, look, motion, emotion: nonempty, anchor,
+    fire, fire_was: fire, style_sources: styleSources, needs_review: value => typeof value === 'boolean',
+    split_from: runId, migrated_from: value => typeof value === 'string' && /^e-\d{4,}$/.test(value),
+    dormant_animation: motion, migrated_emphasis: migratedEmphasis
+};
+const unresolvedFields = ['run', 'old_caption_id', 'old_text', 'old_src', 'old_start', 'old_end', 'reason'];
+exports.CAPTION_LOOK_SHAPE_KEYS = {
+    run: [...Object.keys(v1Fields), 'style', 'animation'], look: Object.keys(lookFields), anchor: Object.keys(anchorFields),
+    styleSources: Object.keys(styleSourcesFields), source: Object.keys(sourceFields), unresolvedRun: unresolvedFields
+};
+const idRequired = ['look', 'motion', 'anchor', 'fire', 'style_sources', 'migrated_from'];
+/** v1 の追加項目だけを検査する。旧い行の他の項目と runs v0 の形は許す。 */
+function validateCaptionLookV1Shape(captionsRoot) {
+    const diagnostics = [];
+    const add = (path, field) => diagnostics.push({ code: 'captions.look.shape', severity: 'error',
+        path, message: `${field} の形が字幕の規則に合いません。`, layer: 'document' });
+    const rows = Array.isArray(captionsRoot) ? captionsRoot : isObject(captionsRoot) ? captionsRoot.captions : undefined;
+    const checkRun = (run, path) => {
+        if (!isObject(run)) {
+            add(path, 'run');
+            return;
+        }
+        const v1 = Object.keys(v1Fields).some(key => has(run, key));
+        if (v1)
+            for (const key of ['from', 'to'])
+                if (!has(run, key))
+                    add(path, key);
+        if (idRequired.some(key => has(run, key)) && !has(run, 'id'))
+            add(path, 'id');
+        for (const [key, rule] of Object.entries(v1Fields))
+            if (has(run, key) && !rule(run[key]))
+                add(`${path}.${key}`, key);
+        for (const key of Object.keys(run))
+            if (!has(v1Fields, key) && !['style', 'animation'].includes(key))
+                add(`${path}.${key}`, key);
+    };
+    if (Array.isArray(rows))
+        rows.forEach((row, index) => {
+            if (!isObject(row))
+                return;
+            if (has(row, 'style_sources') && !styleSources(row.style_sources))
+                add(`captions.json#captions[${index}].style_sources`, 'style_sources');
+            if (Array.isArray(row.runs))
+                row.runs.forEach((run, runIndex) => checkRun(run, `captions.json#captions[${index}].runs[${runIndex}]`));
+        });
+    if (isObject(captionsRoot) && has(captionsRoot, 'unresolved_runs')) {
+        const value = captionsRoot.unresolved_runs;
+        const valid = Array.isArray(value) && value.every((item, index) => {
+            if (!isObject(item))
+                return false;
+            checkRun(item.run, `captions.json#unresolved_runs[${index}].run`);
+            return unresolvedFields.every(key => has(item, key)) && Object.keys(item).every(key => unresolvedFields.includes(key))
+                && isObject(item.run) && typeof item.old_caption_id === 'string'
+                && typeof item.old_text === 'string' && (item.old_src === null || typeof item.old_src === 'string')
+                && number(item.old_start) && number(item.old_end) && nonempty(item.reason);
+        });
+        if (!valid)
+            add('captions.json#unresolved_runs', 'unresolved_runs');
+    }
+    return diagnostics;
+}
+class CaptionsInvalidError extends Error {
+    constructor(diagnostics) {
+        super(`字幕の内容を保存できません: ${diagnostics.map(item => item.message).join('、')}`);
+        this.diagnostics = diagnostics;
+        this.code = 'AKARI_CAPTIONS_INVALID';
+        this.name = 'CaptionsInvalidError';
+    }
+}
+exports.CaptionsInvalidError = CaptionsInvalidError;
+function assertCaptionsWritable(captionsRoot, ctx = {}) {
+    const diagnostics = [...validateCaptionLookV1Shape(captionsRoot), ...(0, caption_semantics_1.validateCaptionsSemantics)({ ...ctx, captions: captionsRoot })];
+    if (diagnostics.some(item => item.severity === 'error'))
+        throw new CaptionsInvalidError(diagnostics);
+}

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

@@ -27,6 +27,7 @@ export declare function lookForCaptionRow(row: Record<string, unknown>, defaultS
     text_style?: Record<string, unknown>;
     notices: string[];
     reason?: string;
+    reasonCode?: 'AKARI_CAPTION_LAYOUT_REFERENCE_CONFLICT';
 };
 export declare function lookForCaptionRun(row: Record<string, unknown>, defaultStyle: Record<string, unknown>, styleLook: Record<string, unknown>, catalog?: Record<string, {
     style: Record<string, unknown>;

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

@@ -146,7 +146,8 @@ function lookForCaptionRow(row, defaultStyle, styleLook, options) {
         }
     }
     if (textStyle.layout !== undefined && textStyle.reference_height_px !== undefined) {
-        return { notices: [], reason: 'layout と reference_height_px を同時に指定できません' };
+        return { notices: [], reason: 'layout と reference_height_px を同時に指定できません',
+            reasonCode: 'AKARI_CAPTION_LAYOUT_REFERENCE_CONFLICT' };
     }
     return { text_style: textStyle, notices: [] };
 }

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

@@ -301,6 +301,10 @@ export declare function captionEditNotices(result: {
     removedEmphasis: readonly CaptionEmphasis[];
 }, oldDisplayText: string): string[];
 export declare function applyWordBookToCaptionsInSource(source: string, changes: WordBookCaptionChange[]): string;
+export declare function applyWordBookToCaptionsInSourceWithNotices(source: string, changes: WordBookCaptionChange[]): {
+    source: string;
+    notices: string[];
+};
 export declare function updateCaptionTextStyleInSource(source: string, captionId: string, updates: CaptionTextStylePatch): string;
 export declare function updateCaptionStylePresetInSource(source: string, captionIds: readonly string[], presetId: string | null, options?: {
     catalog?: TextstyleCatalog;