akari-video 0.1.29 → 0.1.30

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akari-video",
-  "version": "0.1.29",
+  "version": "0.1.30",
   "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-08-30-edit-json-v2-object-tree-v0.md

@@ -127,6 +127,12 @@ updated: 2026-08-30
 - 分離（§3.1）は不変条件 1 の帰結として**必ず新しい段を生やす**（同じ段に重ねられないため）。戻せば（⌘Z）段は消える
 - 音声段も同じ 4 条件に従う（既存の重なり禁止と同じ）
 
+### 2-5 追記（2026-08-31・オーナー裁定）: 字幕にも特別な z 規則を置かない
+
+- **字幕（袋グループ・分離した行・テロップ変換後）も z は段どおり**。「字幕は常に一番上」という特別規則は**廃止**する（描画側の `generatedFrom` による無条件最上段寄せも撤去）
+- 取り込み時に字幕袋が最前面の段に乗るのは**既定の置き場**であって規則ではない。ユーザー / AI は字幕の段を自由に前後へ動かせる
+- 狙い: 種別ごとの特別規則を増やさない（§2 の 4 不変条件だけで全種別が説明できる状態を保つ）。プレビュー / osr / gpu / render-cut の 4 出口で同時に切り替え、パリティで担保する
+
 ## 3. 操作の意味論（データ変換として定義。UI のコマンド・キー割り当ては別契約）
 
 操作は **出す / まとめる / ばらす** の 3 つ + 切り出し・テロップに変換。**「戻す」は無い**（⌘Z のみ。再グループ化は「まとめる」で足りる）。

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

@@ -1,6 +1,6 @@
 {
   "name": "akari-video",
-  "version": "0.1.29",
+  "version": "0.1.30",
   "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-store/lib/caption-display.d.ts

@@ -101,8 +101,8 @@ export declare function mergeCaptionDisplayStyles(base: unknown, override: unkno
  * （プレビュー = shell captionTextStyleVars / 書き出し = render-cut captions.mjs の両消費者が
  * これを使う — 2026-08-26 akari-reel 実機: プレビュー側だけ text_anchor/position を落として
  * 明示位置付き字幕が既定の下段 7% に出る「出力とプレビューの位置不一致」の再発防止）。
- * position 未指定なら anchor は zone 相当の縁寄せとして効く。position 指定時は
- * その座標へ anchor の縦成分（t/m/b）を合わせる（m は 100% を超えないよう近似で top 配置）。
+ * position 未指定なら anchor は zone 相当の縁寄せとして効く。position.y 指定時は
+ * b は下端、t は上端、m は中心をその座標へ合わせる。
  * 不正な anchor / vertical_align は未宣言として無視する（書き込み時検証済みが前提の防御）。
  */
 export declare function captionAnchorPositionVars(anchorValue: unknown, positionValue: unknown, verticalAlignValue: unknown): Record<string, string>;

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

@@ -720,8 +720,8 @@ function mergeCaptionDisplayStyles(base, override) {
  * （プレビュー = shell captionTextStyleVars / 書き出し = render-cut captions.mjs の両消費者が
  * これを使う — 2026-08-26 akari-reel 実機: プレビュー側だけ text_anchor/position を落として
  * 明示位置付き字幕が既定の下段 7% に出る「出力とプレビューの位置不一致」の再発防止）。
- * position 未指定なら anchor は zone 相当の縁寄せとして効く。position 指定時は
- * その座標へ anchor の縦成分（t/m/b）を合わせる（m は 100% を超えないよう近似で top 配置）。
+ * position 未指定なら anchor は zone 相当の縁寄せとして効く。position.y 指定時は
+ * b は下端、t は上端、m は中心をその座標へ合わせる。
  * 不正な anchor / vertical_align は未宣言として無視する（書き込み時検証済みが前提の防御）。
  */
 function captionAnchorPositionVars(anchorValue, positionValue, verticalAlignValue) {
@@ -739,8 +739,17 @@ function captionAnchorPositionVars(anchorValue, positionValue, verticalAlignValu
     const horizontal = anchor ? anchor[1] : 'c';
     if (typeof position?.y === 'number' && Number.isFinite(position.y)) {
         const clamped = Math.min(1, Math.max(0, position.y));
-        vars['--caption-top'] = `${Math.round(clamped * 10000) / 100}%`;
-        vars['--caption-bottom'] = 'auto';
+        if ((anchor || verticalAlign) && vertical === 'b') {
+            vars['--caption-top'] = 'auto';
+            vars['--caption-bottom'] = `${Math.round((1 - clamped) * 10000) / 100}%`;
+        }
+        else {
+            vars['--caption-top'] = `${Math.round(clamped * 10000) / 100}%`;
+            vars['--caption-bottom'] = 'auto';
+            if ((anchor || verticalAlign) && vertical === 'm') {
+                vars['--caption-translate'] = '0 -50%';
+            }
+        }
     }
     else if (anchor || verticalAlign) {
         vars['--caption-top'] = vertical === 't' ? '7%' : vertical === 'm' ? '0' : 'auto';

package/vendor/packages/edit-store/lib/tree-ops.d.ts

@@ -25,6 +25,8 @@ export interface ProjectedItemTiming {
     at: number;
     duration: number;
 }
+export type KeyframeProperty = 'transform.x' | 'transform.y' | 'transform.scale' | 'transform.rotate' | 'opacity' | 'crop' | 'perspective';
+export type SegmentEasing = string;
 export interface ConvertCaptionToTelopOptions {
     preset?: string;
     text: string;
@@ -60,6 +62,16 @@ export interface ItemLocation {
 }
 export declare function attachEditHelpers(edit: EditableEditV2): void;
 export declare function updateItem(edit: EditableEditV2, id: string, patch: JsonRecord): ProjectItemV2;
+/** inline 点列へ値を打つ。最初の点では反対側の端にも同じ値を置き minItems:2 を守る。 */
+export declare function setKeyframe(edit: EditableEditV2, id: string, property: KeyframeProperty, t: number, value: unknown): ProjectItemV2;
+/** 指定プロパティの点だけを消し、空点を除去する。2 点未満なら点列自体を外す。 */
+export declare function removeKeyframe(edit: EditableEditV2, id: string, property: KeyframeProperty, t: number): ProjectItemV2;
+/** 1 プロパティの点を別時刻へ移す。同時刻の既存点があれば値をマージする。 */
+export declare function moveKeyframe(edit: EditableEditV2, id: string, property: KeyframeProperty, fromT: number, toT: number): ProjectItemV2;
+/** easing は「その点へ入る区間」に置く。プロパティ別指定は object 形へ正規化する。 */
+export declare function setSegmentEasing(edit: EditableEditV2, id: string, property: KeyframeProperty, toT: number, easing: SegmentEasing): ProjectItemV2;
+/** motion 袋を読んだ UI が参照形を inline へ戻すための純関数。 */
+export declare function hydrateKeyframes(edit: EditableEditV2, id: string, points: readonly KeyframeV2[]): ProjectItemV2;
 export declare function moveItem(edit: EditableEditV2, id: string, target: MoveTarget): ProjectItemV2;
 export declare function insertItem(edit: EditableEditV2, target: string, item: MutableItem, index?: number): ProjectItemV2;
 export declare function removeItem(edit: EditableEditV2, id: string): ProjectItemV2;

package/vendor/packages/edit-store/lib/tree-ops.js

@@ -3,6 +3,11 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.DEFAULT_CAPTION_TELOP_PRESET = void 0;
 exports.attachEditHelpers = attachEditHelpers;
 exports.updateItem = updateItem;
+exports.setKeyframe = setKeyframe;
+exports.removeKeyframe = removeKeyframe;
+exports.moveKeyframe = moveKeyframe;
+exports.setSegmentEasing = setSegmentEasing;
+exports.hydrateKeyframes = hydrateKeyframes;
 exports.moveItem = moveItem;
 exports.insertItem = insertItem;
 exports.removeItem = removeItem;
@@ -29,6 +34,12 @@ exports.composeTransforms = composeTransforms;
 exports.relativeTransform = relativeTransform;
 exports.ensureChildren = ensureChildren;
 exports.clone = clone;
+const SEGMENT_EASINGS = new Set([
+    'linear', 'ease-in-out', 'in-quad', 'out-quad', 'in-out-quad',
+    'in-cubic', 'out-cubic', 'in-out-cubic', 'in-quart', 'out-quart', 'in-out-quart',
+    'in-expo', 'out-expo', 'in-out-expo', 'in-back', 'out-back', 'in-out-back',
+    'out-bounce', 'out-elastic', 'hold'
+]);
 // 助詞ミニマは通常字幕に近く、ワードスナップほど演出を強くしないため変換の既定にする。
 exports.DEFAULT_CAPTION_TELOP_PRESET = 'ref3_particle_min';
 function attachEditHelpers(edit) {
@@ -63,6 +74,100 @@ function updateItem(edit, id, patch) {
     }
     return location.item;
 }
+/** inline 点列へ値を打つ。最初の点では反対側の端にも同じ値を置き minItems:2 を守る。 */
+function setKeyframe(edit, id, property, t, value) {
+    const item = requireLocation(edit, id).item;
+    const time = requireKeyframeTime(t, item.duration);
+    const points = editableKeyframes(item);
+    if (points.length === 0) {
+        const opposite = time === 0 ? item.duration : 0;
+        points.push(pointWithValue(time, property, value), pointWithValue(opposite, property, value));
+    }
+    else {
+        const point = points.find(candidate => candidate.t === time);
+        if (point)
+            assignKeyframeValue(point, property, value);
+        else
+            points.push(pointWithValue(time, property, value));
+    }
+    item.keyframes = normalizeKeyframes(points);
+    return item;
+}
+/** 指定プロパティの点だけを消し、空点を除去する。2 点未満なら点列自体を外す。 */
+function removeKeyframe(edit, id, property, t) {
+    const item = requireLocation(edit, id).item;
+    const points = editableKeyframes(item);
+    const point = points.find(candidate => candidate.t === t);
+    if (!point)
+        return item;
+    deleteKeyframeValue(point, property);
+    const remaining = points.filter(hasKeyframeValue);
+    if (remaining.length < 2)
+        delete item.keyframes;
+    else
+        item.keyframes = normalizeKeyframes(remaining);
+    return item;
+}
+/** 1 プロパティの点を別時刻へ移す。同時刻の既存点があれば値をマージする。 */
+function moveKeyframe(edit, id, property, fromT, toT) {
+    const item = requireLocation(edit, id).item;
+    const targetTime = requireKeyframeTime(toT, item.duration);
+    const points = editableKeyframes(item);
+    const source = points.find(point => point.t === fromT);
+    const value = source ? keyframeValue(source, property) : undefined;
+    if (!source || value === undefined)
+        throw new Error(`キーフレームが見つかりません: ${id} ${property} t=${fromT}`);
+    const easing = source.easing;
+    deleteKeyframeValue(source, property);
+    let target = points.find(point => point.t === targetTime);
+    if (!target) {
+        target = { t: targetTime };
+        points.push(target);
+    }
+    assignKeyframeValue(target, property, value);
+    if (easing !== undefined && target.easing === undefined)
+        target.easing = clone(easing);
+    const remaining = points.filter(hasKeyframeValue);
+    if (remaining.length < 2)
+        throw new Error('キーフレームは 2 点以上必要です。');
+    item.keyframes = normalizeKeyframes(remaining);
+    return item;
+}
+/** easing は「その点へ入る区間」に置く。プロパティ別指定は object 形へ正規化する。 */
+function setSegmentEasing(edit, id, property, toT, easing) {
+    requireSegmentEasing(easing);
+    const item = requireLocation(edit, id).item;
+    const points = editableKeyframes(item);
+    const index = points.findIndex(point => point.t === toT);
+    if (index <= 0 || keyframeValue(points[index], property) === undefined) {
+        throw new Error('イージングを設定する区間が見つかりません。');
+    }
+    const point = points[index];
+    const declared = keyframeProperties(point);
+    if (declared.length <= 1) {
+        point.easing = easing;
+    }
+    else {
+        const previous = typeof point.easing === 'string' ? point.easing : 'linear';
+        const perProperty = isRecord(point.easing) ? clone(point.easing) : {};
+        for (const declaredProperty of declared) {
+            if (!(declaredProperty in perProperty))
+                perProperty[declaredProperty] = previous;
+        }
+        perProperty[property] = easing;
+        point.easing = perProperty;
+    }
+    item.keyframes = normalizeKeyframes(points);
+    return item;
+}
+/** motion 袋を読んだ UI が参照形を inline へ戻すための純関数。 */
+function hydrateKeyframes(edit, id, points) {
+    if (points.length > 0 && points.length < 2)
+        throw new Error('キーフレームは 2 点以上必要です。');
+    const item = requireLocation(edit, id).item;
+    item.keyframes = normalizeKeyframes(points.map(point => clone(point)));
+    return item;
+}
 function moveItem(edit, id, target) {
     if ((target.track === undefined) === (target.parent === undefined)) {
         throw new Error('move の置き先は track または parent のどちらか一方で指定してください。');
@@ -457,6 +562,85 @@ function ensureChildren(item, create = true) {
 function clone(value) {
     return structuredClone(value);
 }
+function editableKeyframes(item) {
+    if (item.keyframes === undefined)
+        return [];
+    if (!Array.isArray(item.keyframes)) {
+        throw new Error('motion 袋を inline に戻してからキーフレームを編集してください。');
+    }
+    return item.keyframes.map(point => clone(point));
+}
+function requireSegmentEasing(value) {
+    const cubic = /^cubic-bezier\(\s*-?\d*\.?\d+\s*,\s*-?\d*\.?\d+\s*,\s*-?\d*\.?\d+\s*,\s*-?\d*\.?\d+\s*\)$/u;
+    if (!SEGMENT_EASINGS.has(value) && !cubic.test(value))
+        throw new Error(`未対応の easing です: ${value}`);
+}
+function requireKeyframeTime(t, duration) {
+    if (!Number.isInteger(t) || t < 0 || t > duration) {
+        throw new Error(`キーフレーム時刻は 0〜${duration} の整数フレームで指定してください。`);
+    }
+    return t;
+}
+function normalizeKeyframes(points) {
+    const result = points.map(point => clone(point)).sort((left, right) => left.t - right.t);
+    for (let index = 1; index < result.length; index++) {
+        if (result[index - 1].t === result[index].t)
+            throw new Error('同じ時刻にキーフレームを重ねられません。');
+    }
+    return result;
+}
+function pointWithValue(t, property, value) {
+    const point = { t };
+    assignKeyframeValue(point, property, value);
+    return point;
+}
+function assignKeyframeValue(point, property, value) {
+    if (property.startsWith('transform.')) {
+        const key = property.slice('transform.'.length);
+        point.transform = { ...(point.transform ?? {}), [key]: clone(value) };
+    }
+    else {
+        point[property] = clone(value);
+    }
+}
+function deleteKeyframeValue(point, property) {
+    if (property.startsWith('transform.')) {
+        const key = property.slice('transform.'.length);
+        if (point.transform) {
+            delete point.transform[key];
+            if (Object.keys(point.transform).length === 0)
+                delete point.transform;
+        }
+    }
+    else {
+        delete point[property];
+    }
+    if (isRecord(point.easing)) {
+        delete point.easing[property];
+        if (Object.keys(point.easing).length === 0)
+            delete point.easing;
+    }
+}
+function keyframeValue(point, property) {
+    if (!property.startsWith('transform.'))
+        return point[property];
+    return point.transform?.[property.slice('transform.'.length)];
+}
+function keyframeProperties(point) {
+    const result = [];
+    for (const property of ['transform.x', 'transform.y', 'transform.scale', 'transform.rotate']) {
+        if (keyframeValue(point, property) !== undefined)
+            result.push(property);
+    }
+    for (const property of ['opacity', 'crop', 'perspective']) {
+        if (keyframeValue(point, property) !== undefined)
+            result.push(property);
+    }
+    return result;
+}
+function hasKeyframeValue(point) {
+    return keyframeProperties(point).length > 0 || point.animator !== undefined;
+}
 function requireLocation(edit, id) {
     const location = locate(edit, id);
     if (!location)

package/vendor/packages/edit-store/lib/webview-kernel.js

@@ -983,8 +983,16 @@ var AkariEditKernel = (() => {
     const horizontal = anchor ? anchor[1] : "c";
     if (typeof position?.y === "number" && Number.isFinite(position.y)) {
       const clamped = Math.min(1, Math.max(0, position.y));
-      vars["--caption-top"] = `${Math.round(clamped * 1e4) / 100}%`;
-      vars["--caption-bottom"] = "auto";
+      if ((anchor || verticalAlign) && vertical === "b") {
+        vars["--caption-top"] = "auto";
+        vars["--caption-bottom"] = `${Math.round((1 - clamped) * 1e4) / 100}%`;
+      } else {
+        vars["--caption-top"] = `${Math.round(clamped * 1e4) / 100}%`;
+        vars["--caption-bottom"] = "auto";
+        if ((anchor || verticalAlign) && vertical === "m") {
+          vars["--caption-translate"] = "0 -50%";
+        }
+      }
     } else if (anchor || verticalAlign) {
       vars["--caption-top"] = vertical === "t" ? "7%" : vertical === "m" ? "0" : "auto";
       vars["--caption-bottom"] = vertical === "b" ? "7%" : vertical === "m" ? "0" : "auto";

package/vendor/packages/overlay-runtime/package.json

@@ -4,7 +4,7 @@
   "private": true,
   "description": "Shell-agnostic overlay DOM runtime: mount/tick of edit.json overlays (#overlay-stage), pointer-driven select/drag/resize/edit interaction layer, and zoom minimap. Host-agnostic — see README.md for the window.akari.* adapter contract a hosting shell must provide.",
   "main": "src/overlay-runtime.js",
-  "exports": { ".": "./src/overlay-runtime.js", "./parts": { "types": "./src/parts.d.ts", "import": "./src/parts.mjs", "require": "./src/parts.mjs" } },
+  "exports": { ".": "./src/overlay-runtime.js", "./parts": { "types": "./src/parts.d.ts", "import": "./src/parts.mjs", "require": "./src/parts.mjs" }, "./keyframes": { "types": "./src/keyframes.d.ts", "import": "./src/keyframes.mjs" } },
   "files": [
     "src/",
     "docs/",

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

@@ -76,7 +76,7 @@
     "textAnchor": {
       "type": "string",
       "enum": ["tl", "tc", "tr", "ml", "mc", "mr", "bl", "bc", "br"],
-      "description": "9 点アンカー。1 文字目が縦（t/m/b）、2 文字目が横（l/c/r）。"
+      "description": "9 点アンカー。1 文字目が縦（t/m/b）、2 文字目が横（l/c/r）。position.y 指定時の縦成分は b = 下端基準、t = 上端基準、m = 中心基準。"
     },
     "textPosition": {
       "type": "object",
@@ -85,7 +85,7 @@
         "x": { "type": "number" },
         "y": { "type": "number" }
       },
-      "description": "フレーム比 0..1 の配置座標。指定した軸だけが効き、未指定の軸は zone / text_anchor に従う。"
+      "description": "フレーム比 0..1 の配置座標。指定した軸だけが効き、未指定の軸は zone / text_anchor に従う。position.y 指定時の text_anchor 縦成分は b = 下端基準、t = 上端基準、m = 中心基準。"
     },
     "textShadowStyle": {
       "type": "object",