akari-video 0.1.63 → 0.1.65

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akari-video",
-  "version": "0.1.63",
+  "version": "0.1.65",
   "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/capture-command.mjs

@@ -1,13 +1,21 @@
 import { spawnSync } from "node:child_process";
 import { existsSync } from "node:fs";
 
-import { resolveLauncherAssets } from "./repo-assets.mjs";
+import { CAPTURE_SCRIPT_RELATIVE, resolveLauncherAssets } from "./repo-assets.mjs";
 
 export async function runCaptureCommand(argv, options = {}) {
   const logError = options.error ?? options.logError ?? ((line) => console.error(line));
   const assets = options.assets ?? resolveLauncherAssets();
   if (!assets.captureScript || !existsSync(assets.captureScript)) {
-    logError("akari capture の実行スクリプトが見つかりません。AKARI Video を再インストールしてください。");
+    // 再インストールで直る欠けではない（同梱漏れは配布物側の問題）。欠けている同梱物と
+    // 探索した置き場を名指しして、報告・切り分けに使える形で止める（issue #74）。
+    const missing = assets.captureScript ?? CAPTURE_SCRIPT_RELATIVE;
+    logError(
+      `akari capture の実行スクリプトが見つかりません: ${missing}`
+      + `（探索先: ${assets.repoRoot ?? "不明"}）。`
+      + "この AKARI Video 配布物に packages/akari-tools/bin/capture.mjs が同梱されていません。"
+      + "バージョンと OS を添えて https://github.com/AkariLabs/akari-video/issues へ報告してください。",
+    );
     return { exitCode: 1 };
   }
 

package/src/repo-assets.mjs

@@ -35,7 +35,8 @@ const BEATMAP_SCRIPT_RELATIVE = path.join('packages', 'akari-tools', 'bin', 'bea
 const PROBE_FRAME_SCRIPT_RELATIVE = path.join('packages', 'akari-tools', 'bin', 'probe-frame.mjs');
 const DECISION_LOG_SCRIPT_RELATIVE = path.join('packages', 'akari-tools', 'bin', 'decision-log.mjs');
 const CAPTIONS_SCRIPT_RELATIVE = path.join('packages', 'akari-tools', 'bin', 'captions.mjs');
-const CAPTURE_SCRIPT_RELATIVE = path.join('packages', 'akari-tools', 'bin', 'capture.mjs');
+// capture-command.mjs のエラー文と apps/shell の同梱テストが同じ相対パスを名指しできるよう export する。
+export const CAPTURE_SCRIPT_RELATIVE = path.join('packages', 'akari-tools', 'bin', 'capture.mjs');
 const RENDER_WHEN_IDLE_SCRIPT_RELATIVE = path.join('packages', 'akari-tools', 'bin', 'render-when-idle.sh');
 const EYE_BAR_SCRIPT_RELATIVE = path.join('packages', 'akari-tools', 'bin', 'eye-bar.mjs');
 

package/vendor/.akari-capability-sources.json

@@ -66,6 +66,7 @@
     "docs/contract-2026-09-05-clip-adjust-v1.md",
     "docs/contract-2026-09-06-cut-audio-split-v0.md",
     "docs/contract-2026-09-06-vgpu-layer-v0.md",
+    "docs/contract-2026-09-12-review-session-viewer.md",
     "packages/akari-launcher/package.json",
     "packages/akari-launcher/README.md",
     "packages/akari-tools/package.json",

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

@@ -137,6 +137,12 @@ finalFrameNumber **239**、lookahead hits **8**を要求する。
 shell のプレビューでは DOM 層として提示し、書き出しでは同じ DOM 規約から overlay sheet を構成する。
 器専用の字幕 HTML や出口専用の再レイアウトを持たない。
 
+行用 `style_vars` は `packages/edit-store/src/caption-display.ts` の
+`resolveCaptionLineStyleVars` / `mergeCaptionLineTextStyles` をカーネル単一定義とし、shell、Web UI、
+render-cut、`display_policy` の 4 面が同じ関数を呼ぶ。`display_policy` 経路の stroke も
+`-webkit-text-stroke` として `width_px × 2` を出し、`paint-order: stroke fill` で描く
+（2026-09-13 裁定）。
+
 active cue の判定は両プレビューとも**出力秒**で行う。source 秒の cue（`time_domain: "source"` と未宣言の
 legacy）は共有カーネル `packages/edit-store/src/caption-clock.ts` の `normalizeCaptionClock` が cut map
 で出力秒へ射影し、削除区間をまたぐ cue は 1 本ずつに分割する（`<id>-output-<n>`、元 id は

package/vendor/docs/contract-2026-08-11-review-session-ui-events.md

@@ -46,6 +46,7 @@
 | `panel:<id>` | シェルの主要パネル | `panel:assets` / `panel:inspector` / `panel:review` / `panel:timeline` |
 | `tab:<id>` | タブ | `tab:assets-builtin` |
 | `timeline:cut:<n>` | タイムラインのカット（cuts[] index） | `timeline:cut:3` |
+| `timeline:item:<id>` | v2 タイムラインのカット（tracks[].items[].id。compile 時に legacy cuts[] index へ射影） | `timeline:item:cut-4` |
 | `timeline:overlay:<id>` | タイムラインのオーバーレイ | `timeline:overlay:o-0002` |
 | `asset:<path>` | 素材（プロジェクト相対 or カタログ id） | `asset:assets/broll/city.mp4` |
 | `asset:<category>/<id>` | 素材（カタログ由来カード。key = `<category>/<id>`） | `asset:still/br-typing-laptop` |

package/vendor/docs/contract-2026-08-23-captions-emphasis-words-v0.md

@@ -27,6 +27,7 @@
       "t_end": 12.44,
       "word": "最高",
       "emotion": "joy",
+      "style_preset": "neon",
       "style_hint": "size-pulse"
     }
   ],
@@ -49,11 +50,12 @@
    `captions.json.emphasis_words` へ移す。
 2. `edit.json` v2 へは書かない。v0/v1 の旧席は後方互換の読取専用として残す。
 
-したがって各レコードは `{ id, word, emotion, src?, t_start, t_end, style_hint? }` で、`id` は
+したがって各レコードは `{ id, word, emotion, src?, t_start, t_end, style_preset?, style_hint? }` で、`id` は
 `^e-\d{4}$` かつファイル内一意、`word` と `emotion` は空でない文字列、時刻は source 秒で
 `0 <= t_start < t_end` とする。`emotion` は `joy` / `pain` / `surprise` / `anger` / `sadness` /
 `emphasis` を標準語彙として使うが、v1 契約どおり enum 強制はしない。`style_hint` も描画側への
-提案に留まる。
+提案に留まる。`style_preset` は任意で、字幕テンプレと同じ `textstyle-catalog` の id を語の見た目として
+提案する。台本パネルの単語選択から「🎨 テンプレ」を適用すると、この席へ範囲ごとに 1 件を書く。
 
 ## 3. 読取優先順
 
@@ -75,3 +77,21 @@
 語と `captions[].words[]` の実測値の突き合わせは v1 契約と同じく書き手の規律であり、静的検証では
 行わない。
 edit-lint は object ルートの `emphasis_words` を受理し、同じ規則で検証する。
+
+## 5. style_preset の描画
+
+共有字幕カーネルは、`style_preset` を持つ `emphasis_words[]` が投影後の語へ当たった場合にだけ、
+display cue へ `words[]` と `word_styles[]` を追加する。`words[]` は出力秒の `start` / `end`、本文
+`text`、`display_lines` の行番号 `line` を持つ。`word_styles[]` は `words[]` の半開区間 `from` / `to`、
+プリセット id `preset_id`、解決済み CSS 変数 `style_vars` を持つ。時間範囲が語の途中だけと重なる場合も、
+その語全体へ丸める（含む側）。該当語が無い cue には両キーとも追加せず、従来の出力を変えない。
+
+描画 DOM は通常の語を `akari-caption__tok`、プリセット付きの語を
+`akari-caption__tok akari-caption__tok--preset` とし、後者へ `data-emphasis-preset` と解決済み
+`style_vars` のインライン CSS を付ける。shell プレビュー、Web プレビュー、render-cut、gpu-export の
+4 出口はこの同じ規則で描く。台本パネルは語 span の `data-emphasis-preset` を読み取れる形で残し、
+プリセット色と薄い下線だけを表示する。既存の行テンプレチップは維持する。
+
+`style_preset` の無いレコードは従来の `emotion` / `style_hint` 経路のままである。現状、語へ渡す
+`style_vars` は color / font-size / font-weight / line-height / stroke 系だけであり、glow、shadow、
+`letter_spacing`、`text_transform` は未対応とする。

package/vendor/docs/contract-2026-08-23-stroke-persistence.md

@@ -1,7 +1,7 @@
 ---
 lifecycle: implemented
 created: 2026-08-23
-updated: 2026-08-23
+updated: 2026-09-12
 ---
 
 # 注釈ストローク永続表示契約
@@ -20,12 +20,24 @@ updated: 2026-08-23
   変更で座標は変わらない。
 - pointerup 後は従来のグロー・きらめき・600 ms フェードをそのまま再生し、その後段の静的
   ビットマップへ同じ正規化図形を残す。新しい録音セッションの開始時に前セッションの表示を
-  クリアし、録音終了では消さない。
+  クリアし、録音終了では消さない。※ 2026-09-12 改訂（§1.1）
 - 描線 canvas は非描画モードで `pointer-events: none` とする。ペンまたは四角モードのドラッグ中
   だけ既存どおり入力面になる。
 - 注釈パネルの「描線を表示」チェックは既定 ON。OFF は残留描線と明示的に再表示した描線を隠し、
   データを削除しない。ON に戻すと保持した正規化座標から即時再描画する。
 
+### 1.1 表示の寿命（2026-09-12 追記）
+
+- 描線はプレイヘッド近傍表示とする。録音中は `recT - recTEnd`、録音外の再表示では
+  `|playheadT - frame.timelineT|` を距離として、直近または近傍の複数描線だけを表示する。
+- 表示規則の単一正本は `PEN_TUNING.visibleWindowSec`（既定 8 秒）と
+  `PEN_TUNING.fadeOutMs`（既定 1500 ms）である。時間窓内は不透明とし、窓を超えた描線は
+  `fadeOutMs` をかけて薄れて非表示になる。
+- `fadeOutMs` は表示寿命のための値であり、pointerup 直後のきらめきと描き味を担う既存の
+  `fadeDurationMs`（600 ms）とは別物である。
+- 録音停止時は画面上の表示プールをクリアするが、記録側の `strokes.json` は変更しない。
+  録音済みセッションの描線は再表示できるため、手動のクリアボタンは設けない。
+
 ## 2. 既存セッションの読み出しと再表示
 
 `readReviewSessionStrokes({projectRootUri, sessionId})` は

package/vendor/docs/contract-2026-09-12-review-session-viewer.md

@@ -0,0 +1,97 @@
+---
+lifecycle: draft
+created: 2026-09-12
+updated: 2026-09-12
+---
+
+# レビューセッション見返しビューア契約
+
+- 日付: 2026-09-12
+- 状態: draft
+- 前提: `contract-2026-08-11-review-session-ui-events.md`、
+  `contract-2026-08-23-stroke-persistence.md`
+- スコープ: 録音時計 `recT` を基準にした音声・出力プレビュー・描線・文字起こしの同期表示と、
+  録音時点の `edit.snapshot.json` と現在の `edit.json` の差分表示
+
+## 0. 版と互換
+
+本機能は `review/sessions/s-NNNN/` の原本の形を変えず、すべて読むだけで扱う。欠けたファイル、
+壊れた行、未知フィールドは警告または情報なしへ縮退させ、既知の残りを表示する寛容リーダーとする。
+記録原本、manifest、edit.json の migration や書き戻しは行わない。
+
+## 1. `readReviewSessionBundle` 読み出し口
+
+入力は次のとおり。
+
+| フィールド | 型 | 意味 |
+|---|---|---|
+| `projectRootUri` | `string` | ワークスペース内のプロジェクトルート URI |
+| `sessionId` | `string` | `s-NNNN` 形式のセッション ID |
+
+出力は次のとおり。
+
+| フィールド | 型 | 意味 |
+|---|---|---|
+| `sessionId` | `string` | 読み出したセッション ID |
+| `audioUri` | `string \| null` | `audio.wav` の file URI。欠落時は `null` |
+| `audioDurationSec` | `number` | WAV ヘッダから得た録音尺。読めなければ `0` |
+| `events` | `ReviewSessionEvent[]` | 有効行を `recT` 昇順で安定ソートしたイベント |
+| `strokes` | `ReviewStroke[]` | 既存の寛容な strokes リーダーが返す描線 |
+| `transcript` | `ReviewSessionTranscriptSegment[] \| null` | 発話列。未コンパイル時は `null` |
+| `proposals` | `ReviewSessionProposalSummary[] \| null` | 対象解決の表示用要約。欠落時は `null` |
+| `editSnapshotText` | `string \| null` | 8 MiB 以下の snapshot 生テキスト |
+| `warnings` | `string[]` | 読み飛ばした原本・行の説明 |
+
+入口の不正 ID、ワークスペース外、セッションディレクトリ不在だけは例外とする。それ以外の欠落・
+破損は残りを返し、原本へ書き込まない。
+
+## 2. `recT` から `timelineT` への写像
+
+状態は `{playing, anchorTimelineT, anchorRecT, rate}` とし、位置を次で求める。
+
+`playing ? anchorTimelineT + (recT - anchorRecT) * rate : anchorTimelineT`
+
+| イベント | anchor と状態の更新 |
+|---|---|
+| `start` | `timelineT` / `recT` を anchor、`playing` を記録値、`rate=1` |
+| `play` | 先に現位置を求め、有効な `timelineT` または現位置を anchor、`playing=true` |
+| `pause` | 有効な `timelineT` または現位置を anchor、`playing=false` |
+| `seek` | `to` を timeline anchor、イベント `recT` を rec anchor にする |
+| `rate` | 先に現位置を anchor にし、正の `value` を rate にする |
+| `tick` | イベント `timelineT` / `recT` で anchor を打ち直す |
+| `end` | 有効な `timelineT` または現位置を anchor、`playing=false` |
+
+この意味論は `compile-review-session` の時刻写像と同一である。ビューアは `audio.currentTime` を
+`recT` の正本とし、出力プレビューへの seek は既存の requestAnimationFrame 経路で間引く。
+
+## 3. 描線の再表示
+
+描線の寿命と薄れ方は `contract-2026-08-23-stroke-persistence.md` および
+`PEN_TUNING.visibleWindowSec` を正本とする。ビューアはセッションの描線をプレビューへ attach し、
+録音プレイヘッドを動かし、閉じると detach するだけである。描画規則や原本は変更しない。
+
+## 4. 文字起こしと対象表示
+
+`transcript.json` があれば発話単位で並べ、現在の `recT` に該当する発話を強調する。発話クリックは
+その開始 `recT` へシークする。`compile-proposals.json` は発話と同じ index で突き合わせ、
+`target`、`sourceT`、low confidence の要確認表示を添える。本票は人間が解決結果を目視確認する
+表示のみで、対象を修正する UI は次段とする。未コンパイル時の導線は定型文をコピーするだけで、
+compile 自体を実行しない。
+
+## 5. `edit.snapshot.json` との差分
+
+両文書を `readInternalEdit` で読み、全 track の item と再帰的な children を ID で突き合わせる。
+表示する変化は追加、削除、`at` の移動、`duration` の尺変更、media source の `in/out` の素材区間変更の
+5 種である。1 item に複数の変化があれば別々に表示する。v0 / v1 snapshot は「旧形式のため差分を
+出せない」と明示し、migrate しない。
+
+## 6. 映像
+
+映像面には現在の `edit.json` の出力プレビューを使う。当時の素材や映像を探索・復元しない。
+
+## 7. 非目標
+
+- audio、events、strokes、snapshot、transcript、proposals の書き換え
+- compile の実行や文字起こし生成
+- compile の対象解決や注釈内容の編集
+- 当時の映像・素材の復元

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

@@ -1,6 +1,6 @@
 {
   "name": "akari-video",
-  "version": "0.1.63",
+  "version": "0.1.65",
   "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/edit-lint/src/edit-lint.mjs

@@ -4086,7 +4086,7 @@ function validateCaptions(captions, edit, analysis, findings, paths, cutsEndSeco
       continue;
     }
     const required = ["id", "start", "end", "text", "speaker", "sourceRef", "edited"];
-    const optional = ["src", "time_domain", "words", "unrecognized", "style", "display_text", "display_fragments", "style_preset", "text_style"];
+    const optional = ["src", "time_domain", "words", "unrecognized", "style", "display_text", "display_fragments", "display_timing", "style_preset", "text_style"];
     for (const field of required) {
       if (!Object.hasOwn(caption, field)) {
         captionFinding(findings, "captions.schema", `${field} is required`, itemPath);
@@ -4180,6 +4180,10 @@ function validateCaptions(captions, edit, analysis, findings, paths, cutsEndSeco
     if (Object.hasOwn(caption, "display_fragments") && !Array.isArray(caption.display_fragments)) {
       captionFinding(findings, "captions.schema", "display_fragments must be an array when present", itemPath);
     }
+    if (Object.hasOwn(caption, "display_timing")
+      && caption.display_timing !== "full" && caption.display_timing !== "speech-tight") {
+      captionFinding(findings, "captions.schema", 'display_timing must be "full" or "speech-tight" when present', itemPath);
+    }
     if (Object.hasOwn(caption, "style_preset")) {
       if (typeof caption.style_preset !== "string"
         || !/^[a-z0-9][a-z0-9-]*$/.test(caption.style_preset)) {
@@ -4974,6 +4978,8 @@ const REVIEW_DOC_TARGET_PATTERN = /^doc:(.+)#(.+)$/;
 const REVIEW_IMAGE_TARGET_PATTERN = /^image:(.+)$/;
 const REVIEW_CANVAS_TARGET_PATTERN = /^canvas:(c-\d{4,})$/;
 const REVIEW_REQUIRED_FIELDS = ["id", "createdAt", "sourceT", "text", "input", "status"];
+// review.schema.json の annotation.properties と同じ集合を保つ（issue #73: compile-review-session が
+// 正式に書く strokeRefs / transcript / session がここに無く、正規の生成物に warning が出ていた）。
 const REVIEW_OPTIONAL_FIELDS = [
   "src",
   "sourceRange",
@@ -4982,10 +4988,13 @@ const REVIEW_OPTIONAL_FIELDS = [
   "targetKind",
   "region",
   "strokes",
+  "strokeRefs",
   "refs",
   "insertPosition",
   "intent",
   "audio",
+  "transcript",
+  "session",
   "poses",
   "response",
 ];

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

@@ -20,6 +20,8 @@ export interface CaptionDisplayPolicy {
     max_line_units: number;
     minimum_fragment_duration_seconds: number;
     locale: string;
+    lines?: number;
+    wrap?: 'multi' | 'fold';
     break_hints?: CaptionBreakHints;
 }
 export interface CaptionDisplayCue {
@@ -33,11 +35,31 @@ export interface CaptionDisplayCue {
     start: number;
     end: number;
     text: string;
+    display_lines?: string[];
     units: number;
     line_override: boolean;
     text_style?: Record<string, unknown>;
     style_vars?: Record<string, string>;
     layout?: ResolvedCaptionLayout;
+    words?: CaptionDisplayWord[];
+    word_styles?: CaptionDisplayWordStyle[];
+    overflow?: CaptionDisplayOverflow;
+}
+export interface CaptionDisplayOverflow {
+    code: 'NO_WORD_BOUNDARY_SPLIT' | 'INVALID_MANUAL_FRAGMENTS';
+    units: number;
+}
+export interface CaptionDisplayWord {
+    start: number;
+    end: number;
+    text: string;
+    line: number;
+}
+export interface CaptionDisplayWordStyle {
+    from: number;
+    to: number;
+    preset_id: string;
+    style_vars: Record<string, string>;
 }
 export interface CaptionBoundaryProjection {
     source_cue_id: string;
@@ -72,11 +94,42 @@ export interface ResolvedCaptionLayout {
     scale: number;
 }
 type UnknownRecord = Record<string, any>;
+export interface CaptionOccurrence {
+    source_cue_id: string;
+    src: string | null;
+    cut_index: number;
+    caption_input_index: number;
+    source_start: number;
+    source_end: number;
+    start: number;
+    end: number;
+    track: number;
+    text: string;
+    display_fragments?: string[];
+    occurrence_index?: number;
+    text_style?: UnknownRecord;
+    time_offset?: number;
+    time_scale?: number;
+}
+export interface ProjectedCaptionWords {
+    displayText: string;
+    words: UnknownRecord[] | undefined;
+    changed: boolean;
+    renderable: boolean;
+}
 export declare class CaptionDisplayError extends Error {
     readonly code: string;
     constructor(code: string, message: string);
 }
 export declare function measureCaptionUnits(text: string): number;
+export interface CaptionWordSpan {
+    start: number;
+    end: number;
+    wordLike: boolean;
+}
+/** 自動分割で採用してはいけない、Latin/数字または Segmenter 語の内部境界を判定する。 */
+export declare function captionBreakBoundaryBlocked(text: string, boundary: number, wordSpans: readonly CaptionWordSpan[]): boolean;
+export declare function joinCaptionLines(lines: string[], locale: string): string;
 export declare function validateCaptionDisplayPolicy(value: unknown): CaptionDisplayPolicy;
 export declare function resolveCaptionDisplay(captionsRoot: unknown, edit: UnknownRecord, options?: {
     output?: {
@@ -91,16 +144,39 @@ export declare function resolveCaptionDisplay(captionsRoot: unknown, edit: Unkno
  * conceal an invalid default (or vice versa).
  */
 export declare function validateCaptionTextStyle(value: unknown, label?: string): UnknownRecord;
+/**
+ * `captions.json` は変更せず、keep cut から外れた語だけを描画用の本文と words から除く。
+ * どれかの cut と一部でも交差する語は残す（語の途中で切った場合に欠落させない）。
+ */
+export declare function projectCaptionWords(caption: UnknownRecord, cuts: UnknownRecord[]): ProjectedCaptionWords;
+/**
+ * 同じ source cue が同じ出力区間へ複数回射影された場合、下→上の trackOrder で
+ * 最後に描かれる occurrence だけを残す。部分重複は境界で分割する。
+ */
+export declare function dedupeCaptionOccurrences<T extends {
+    source_cue_id: string;
+    start: number;
+    end: number;
+    track: number;
+    source_start?: number;
+    source_end?: number;
+}>(occurrences: readonly T[], trackOrder: readonly number[]): T[];
 export declare function splitCaptionFragments(text: string, policy: CaptionDisplayPolicy): {
     fragments: string[];
     boundaries: number[];
+    overflow?: CaptionDisplayOverflow;
 };
+export declare function foldCaptionLines(text: string, maxLineUnits: number, lines: number, locale?: string): string[];
 export declare function scheduleCaptionFragments(start: number, end: number, fragments: string[], minimumSeconds: number): Array<{
     start: number;
     end: number;
     text: string;
 }>;
 export declare function mergeCaptionDisplayStyles(base: unknown, override: unknown): UnknownRecord | undefined;
+/** Merge the snake_case captions.json line style vocabulary used by every renderer. */
+export declare function mergeCaptionLineTextStyles(base: unknown, override: unknown): UnknownRecord | null;
+export declare function usesPercentageBackground(background: unknown): boolean;
+export declare function usesExtendedPerLineBackground(background: unknown): boolean;
 /**
  * zone 方式の px 系フィールドに掛ける scale（issue #40 §2）。`reference_height_px` が無ければ 1
  * （既存出力はバイト同一）。あれば output.height / reference_height_px — 基準は高さ（文字サイズは
@@ -127,6 +203,11 @@ export declare function scaleCaptionPx(value: number, scale: number): number;
  * 不正な anchor / vertical_align は未宣言として無視する（書き込み時検証済みが前提の防御）。
  */
 export declare function captionAnchorPositionVars(anchorValue: unknown, positionValue: unknown, verticalAlignValue: unknown): Record<string, string>;
+/** Resolve the complete snake_case captions.json line style vocabulary to CSS variables. */
+export declare function resolveCaptionLineStyleVars(style: UnknownRecord | null | undefined, output: {
+    width: number;
+    height: number;
+} | undefined): Record<string, string>;
 export declare function resolveCaptionStyleForOutput(style: UnknownRecord, output: {
     width: number;
     height: number;
@@ -134,5 +215,11 @@ export declare function resolveCaptionStyleForOutput(style: UnknownRecord, outpu
     vars: Record<string, string>;
     layout?: ResolvedCaptionLayout;
 };
+export declare function resolveCaptionWordStyleVars(style: UnknownRecord, output: {
+    width: number;
+    height: number;
+} | undefined): Record<string, string>;
+export declare function captionTextShadowValue(shadow: unknown, glow: unknown, scale?: number): string | null;
+export declare function colorWithOpacity(color: string, explicitOpacity?: number): string;
 export declare function formatCssNumber(value: number): string;
 export {};