@prestyj/editor 0.7.1

package/dist/core/python/sidecar-path.js

@@ -0,0 +1,24 @@
+import { existsSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+/**
+ * Resolve the on-disk path of a Python sidecar shipped under `src/core/python/`.
+ *
+ * In `src/` (during tests / dev), `import.meta.url` points inside `src/core/python/`
+ * so the script sits next to this file. In `dist/` (after `tsc`), the build's
+ * post-step copies `src/core/python/` → `dist/core/python/`, so the same
+ * relative resolution works.
+ *
+ * If the script cannot be found we throw — better an explicit error than
+ * silently spawning Python with a non-existent path.
+ */
+export function sidecarPath(filename) {
+    const here = dirname(fileURLToPath(import.meta.url));
+    const candidate = resolve(here, filename);
+    if (!existsSync(candidate)) {
+        throw new Error(`python sidecar '${filename}' not found at ${candidate} — ` +
+            "the build step that copies src/core/python/ → dist/core/python/ may have failed");
+    }
+    return candidate;
+}
+//# sourceMappingURL=sidecar-path.js.map

package/dist/core/python/sidecar-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidecar-path.js","sourceRoot":"","sources":["../../../src/core/python/sidecar-path.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC;;;;;;;;;;GAUG;AACH,MAAM,UAAU,WAAW,CAAC,QAAgB;IAC1C,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACrD,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC1C,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CACb,mBAAmB,QAAQ,kBAAkB,SAAS,KAAK;YACzD,iFAAiF,CACpF,CAAC;IACJ,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/core/python.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Shared Python helpers for one-shot sidecar invocations.
+ *
+ * The Resolve bridge (`hosts/resolve/bridge.ts`) is a *long-lived* Python
+ * subprocess we talk to via JSON-line protocol. Other tools (beat detection,
+ * face reframe, etc.) only need a one-shot invocation: spawn → write JSON to
+ * stdin → read JSON from stdout → exit. Both modes share interpreter probing,
+ * so `findPython()` lives here and is re-exported from bridge.ts for callers
+ * that already imported it from there.
+ *
+ * Cross-platform notes match the bridge's:
+ *   - macOS/Linux ship `python3`. Windows often only has `python` or `py -3`.
+ *   - Force UTF-8 I/O so JSON with non-ASCII names is safe on Windows.
+ *   - Capture stderr separately for diagnostics (warnings shouldn't break parsing).
+ */
+export interface PythonCmd {
+    cmd: string;
+    args: string[];
+    /**
+     * `sys.prefix` of the interpreter (Windows-only convenience for setting
+     * PYTHONHOME when multiple Pythons sit on PATH). Other callers can ignore.
+     */
+    prefix?: string;
+}
+export declare function findPython(): PythonCmd | undefined;
+/**
+ * Test-only: clear the cached interpreter so subsequent calls re-probe.
+ * Production code never needs this — there's no path where Python
+ * disappears mid-process and we need to rediscover.
+ */
+export declare function __resetPythonCacheForTests(): void;
+export interface RunPythonResult {
+    code: number;
+    stdout: string;
+    stderr: string;
+}
+export interface RunPythonOptions {
+    signal?: AbortSignal;
+    cwd?: string;
+    /** Extra env vars layered on top of process.env. */
+    env?: Record<string, string>;
+    /**
+     * JSON payload written to the script's stdin (one shot). Stringified by
+     * the caller in most cases — pass a string directly if you need raw bytes.
+     */
+    stdin?: string;
+}
+/**
+ * Run a Python script as a one-shot subprocess. Resolves with combined
+ * stdout/stderr/exit-code; never rejects on a non-zero exit (callers
+ * decide how to interpret it). Rejects only on spawn failure.
+ *
+ * Distinct from the Resolve bridge's long-lived spawn — this is for
+ * sidecars that produce one JSON blob and exit.
+ */
+export declare function runPython(scriptPath: string, scriptArgs: string[], opts?: RunPythonOptions): Promise<RunPythonResult>;
+//# sourceMappingURL=python.d.ts.map

package/dist/core/python.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"python.d.ts","sourceRoot":"","sources":["../../src/core/python.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;GAcG;AAEH,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,EAAE,CAAC;IACf;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAoBD,wBAAgB,UAAU,IAAI,SAAS,GAAG,SAAS,CA8BlD;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,IAAI,IAAI,CAEjD;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CACvB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAAE,EACpB,IAAI,GAAE,gBAAqB,GAC1B,OAAO,CAAC,eAAe,CAAC,CAgD1B"}

package/dist/core/python.js

@@ -0,0 +1,107 @@
+import { spawn, spawnSync } from "node:child_process";
+import { wireChildAbort } from "./child-abort.js";
+/**
+ * Probe for a working Python 3 interpreter. Order matters:
+ *   1. python3   — macOS/Linux standard
+ *   2. python    — Windows default name; also macOS with pyenv
+ *   3. py -3     — Windows launcher (when only the launcher is on PATH)
+ *
+ * We verify each candidate prints a 3.x version before accepting it.
+ *
+ * The first successful probe is cached for the lifetime of the process.
+ * Python-backed tools call this on every invocation (preflight + the actual
+ * sidecar spawn inside `runPython`), so without a cache a single agent turn
+ * could spawn 4+ synchronous subprocesses just to re-confirm the same
+ * interpreter. Negative results are NOT cached — if Python wasn't on PATH
+ * when the process started but the user installed it mid-session, the next
+ * call will probe again and pick it up.
+ */
+let cached;
+export function findPython() {
+    if (cached)
+        return cached;
+    const candidates = [
+        { cmd: "python3", args: [] },
+        { cmd: "python", args: [] },
+        { cmd: "py", args: ["-3"] },
+    ];
+    for (const c of candidates) {
+        const r = spawnSync(c.cmd, [...c.args, "--version"], {
+            encoding: "utf8",
+            windowsHide: true,
+        });
+        if (r.status === 0) {
+            const out = (r.stdout || r.stderr || "").trim();
+            if (/Python 3\./.test(out)) {
+                // Best-effort sys.prefix probe (used on Windows for PYTHONHOME).
+                const pr = spawnSync(c.cmd, [...c.args, "-c", "import sys;print(sys.prefix)"], {
+                    encoding: "utf8",
+                    windowsHide: true,
+                });
+                const prefix = pr.status === 0 && typeof pr.stdout === "string" ? pr.stdout.trim() : undefined;
+                cached = prefix ? { ...c, prefix } : c;
+                return cached;
+            }
+        }
+    }
+    return undefined;
+}
+/**
+ * Test-only: clear the cached interpreter so subsequent calls re-probe.
+ * Production code never needs this — there's no path where Python
+ * disappears mid-process and we need to rediscover.
+ */
+export function __resetPythonCacheForTests() {
+    cached = undefined;
+}
+/**
+ * Run a Python script as a one-shot subprocess. Resolves with combined
+ * stdout/stderr/exit-code; never rejects on a non-zero exit (callers
+ * decide how to interpret it). Rejects only on spawn failure.
+ *
+ * Distinct from the Resolve bridge's long-lived spawn — this is for
+ * sidecars that produce one JSON blob and exit.
+ */
+export function runPython(scriptPath, scriptArgs, opts = {}) {
+    const py = findPython();
+    if (!py) {
+        return Promise.reject(new Error("No Python 3 interpreter found. Install Python 3 (python3 / python / 'py -3') and ensure it's on PATH."));
+    }
+    const env = { ...process.env, ...(opts.env ?? {}) };
+    // UTF-8 stdio everywhere — Windows' default codepage can mangle JSON.
+    env.PYTHONIOENCODING = env.PYTHONIOENCODING ?? "utf-8";
+    // Don't litter the script dir with .pyc.
+    env.PYTHONDONTWRITEBYTECODE = "1";
+    return new Promise((resolve, reject) => {
+        const child = spawn(py.cmd, [...py.args, scriptPath, ...scriptArgs], {
+            env,
+            cwd: opts.cwd,
+            stdio: ["pipe", "pipe", "pipe"],
+            windowsHide: true,
+        });
+        let stdout = "";
+        let stderr = "";
+        child.stdout.setEncoding("utf8");
+        child.stderr.setEncoding("utf8");
+        child.stdout.on("data", (d) => (stdout += d));
+        child.stderr.on("data", (d) => (stderr += d));
+        // Robust abort: SIGTERM → SIGKILL after 1.5s, with synchronous fire on
+        // pre-aborted signals. CPU-bound Python sidecars (librosa beat detect,
+        // MediaPipe face reframe) can chew through SIGTERM if they're inside a
+        // numpy/cv2 inner loop — the SIGKILL escalation is non-negotiable.
+        const cleanup = wireChildAbort(opts.signal, child);
+        child.on("error", (e) => {
+            cleanup();
+            reject(e);
+        });
+        child.on("close", (code) => {
+            cleanup();
+            resolve({ code: code ?? 1, stdout, stderr });
+        });
+        if (opts.stdin !== undefined) {
+            child.stdin.write(opts.stdin);
+        }
+        child.stdin.end();
+    });
+}
+//# sourceMappingURL=python.js.map

package/dist/core/python.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"python.js","sourceRoot":"","sources":["../../src/core/python.ts"],"names":[],"mappings":"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"}

package/dist/core/python.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=python.test.d.ts.map

package/dist/core/python.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"python.test.d.ts","sourceRoot":"","sources":["../../src/core/python.test.ts"],"names":[],"mappings":""}

package/dist/core/python.test.js

@@ -0,0 +1,129 @@
+import { describe, expect, it, vi, beforeEach, afterEach } from "vitest";
+function ok(stdout) {
+    return { pid: 0, status: 0, signal: null, output: [], stdout, stderr: "" };
+}
+function fail() {
+    return { pid: 0, status: 1, signal: null, output: [], stdout: "", stderr: "" };
+}
+describe("findPython caching", () => {
+    beforeEach(() => {
+        vi.resetModules();
+    });
+    afterEach(() => {
+        vi.doUnmock("node:child_process");
+        vi.resetModules();
+    });
+    it("returns the same PythonCmd on every call and only spawns once", async () => {
+        const calls = [];
+        vi.doMock("node:child_process", () => ({
+            spawnSync: (cmd, args) => {
+                calls.push({ cmd, args });
+                if (cmd === "python3")
+                    return ok("Python 3.11.4\n");
+                return fail();
+            },
+            spawn: () => {
+                throw new Error("spawn should not be called by findPython");
+            },
+        }));
+        const mod = await import("./python.js");
+        mod.__resetPythonCacheForTests();
+        const first = mod.findPython();
+        expect(first?.cmd).toBe("python3");
+        // Two probes on first call: --version, then sys.prefix.
+        expect(calls.length).toBe(2);
+        for (let i = 0; i < 25; i++) {
+            const next = mod.findPython();
+            expect(next).toBe(first);
+        }
+        // Cache hit — no further spawns.
+        expect(calls.length).toBe(2);
+    });
+    it("does not cache a negative result", async () => {
+        let probeCount = 0;
+        vi.doMock("node:child_process", () => ({
+            spawnSync: () => {
+                probeCount++;
+                return fail();
+            },
+            spawn: () => {
+                throw new Error("spawn should not be called");
+            },
+        }));
+        const mod = await import("./python.js");
+        mod.__resetPythonCacheForTests();
+        expect(mod.findPython()).toBeUndefined();
+        const probesAfterFirst = probeCount;
+        expect(probesAfterFirst).toBeGreaterThanOrEqual(3); // tries python3, python, py
+        // Second call must re-probe — Python may have been installed since.
+        expect(mod.findPython()).toBeUndefined();
+        expect(probeCount).toBeGreaterThan(probesAfterFirst);
+    });
+    it("falls back to `python` when `python3` is absent and caches it", async () => {
+        const calls = [];
+        vi.doMock("node:child_process", () => ({
+            spawnSync: (cmd) => {
+                calls.push(cmd);
+                if (cmd === "python")
+                    return ok("Python 3.12.1\n");
+                return fail();
+            },
+            spawn: () => {
+                throw new Error("spawn should not be called");
+            },
+        }));
+        const mod = await import("./python.js");
+        mod.__resetPythonCacheForTests();
+        const first = mod.findPython();
+        expect(first?.cmd).toBe("python");
+        const before = calls.length;
+        const second = mod.findPython();
+        expect(second).toBe(first);
+        expect(calls.length).toBe(before);
+    });
+    it("rejects a Python 2 candidate and keeps probing", async () => {
+        vi.doMock("node:child_process", () => ({
+            spawnSync: (cmd) => {
+                if (cmd === "python3")
+                    return fail();
+                if (cmd === "python")
+                    return ok("Python 2.7.18\n");
+                if (cmd === "py")
+                    return ok("Python 3.10.6\n");
+                return fail();
+            },
+            spawn: () => {
+                throw new Error("spawn should not be called");
+            },
+        }));
+        const mod = await import("./python.js");
+        mod.__resetPythonCacheForTests();
+        const py = mod.findPython();
+        expect(py?.cmd).toBe("py");
+        expect(py?.args).toEqual(["-3"]);
+    });
+    it("__resetPythonCacheForTests forces a fresh probe", async () => {
+        let probes = 0;
+        vi.doMock("node:child_process", () => ({
+            spawnSync: (cmd) => {
+                probes++;
+                if (cmd === "python3")
+                    return ok("Python 3.11.4\n");
+                return fail();
+            },
+            spawn: () => {
+                throw new Error("spawn should not be called");
+            },
+        }));
+        const mod = await import("./python.js");
+        mod.__resetPythonCacheForTests();
+        mod.findPython();
+        const afterFirst = probes;
+        mod.findPython();
+        expect(probes).toBe(afterFirst); // cached
+        mod.__resetPythonCacheForTests();
+        mod.findPython();
+        expect(probes).toBeGreaterThan(afterFirst); // re-probed
+    });
+});
+//# sourceMappingURL=python.test.js.map

package/dist/core/python.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"python.test.js","sourceRoot":"","sources":["../../src/core/python.test.ts"],"names":[],"mappings":"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"}

package/dist/core/reformat.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Aspect-ratio reformat presets for short-form / vertical / square exports.
+ *
+ * Used by the `reformat_timeline` tool to derive the FCPXML format spec
+ * (width × height) for a new timeline. The tool then emits an FCPXML that
+ * imports as a fresh timeline at the target aspect; the user's NLE handles
+ * the actual reframing (Resolve Smart Reframe, Premiere Auto Reframe).
+ *
+ * The chosen base resolutions are the platform-canonical defaults:
+ *   - 9:16  → 1080×1920 (TikTok / Reels / Shorts)
+ *   - 1:1   → 1080×1080 (Instagram feed)
+ *   - 4:5   → 1080×1350 (Instagram portrait feed)
+ *   - 16:9  → 1920×1080 (long-form horizontal)
+ *   - 4:3   → 1440×1080 (legacy / old-school cuts)
+ */
+export type ReformatPreset = "9:16" | "1:1" | "4:5" | "16:9" | "4:3";
+export interface ReformatSpec {
+    preset: ReformatPreset;
+    width: number;
+    height: number;
+    /** Suggested label for use in clip / sequence names. */
+    label: string;
+}
+export declare function reformatSpec(preset: ReformatPreset): ReformatSpec;
+export declare const REFORMAT_PRESETS: ReformatPreset[];
+//# sourceMappingURL=reformat.d.ts.map

package/dist/core/reformat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reformat.d.ts","sourceRoot":"","sources":["../../src/core/reformat.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,CAAC;AAErE,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,cAAc,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,KAAK,EAAE,MAAM,CAAC;CACf;AAUD,wBAAgB,YAAY,CAAC,MAAM,EAAE,cAAc,GAAG,YAAY,CAQjE;AAED,eAAO,MAAM,gBAAgB,EAA2B,cAAc,EAAE,CAAC"}

package/dist/core/reformat.js

@@ -0,0 +1,31 @@
+/**
+ * Aspect-ratio reformat presets for short-form / vertical / square exports.
+ *
+ * Used by the `reformat_timeline` tool to derive the FCPXML format spec
+ * (width × height) for a new timeline. The tool then emits an FCPXML that
+ * imports as a fresh timeline at the target aspect; the user's NLE handles
+ * the actual reframing (Resolve Smart Reframe, Premiere Auto Reframe).
+ *
+ * The chosen base resolutions are the platform-canonical defaults:
+ *   - 9:16  → 1080×1920 (TikTok / Reels / Shorts)
+ *   - 1:1   → 1080×1080 (Instagram feed)
+ *   - 4:5   → 1080×1350 (Instagram portrait feed)
+ *   - 16:9  → 1920×1080 (long-form horizontal)
+ *   - 4:3   → 1440×1080 (legacy / old-school cuts)
+ */
+const PRESETS = {
+    "9:16": { preset: "9:16", width: 1080, height: 1920, label: "Vertical 9:16" },
+    "1:1": { preset: "1:1", width: 1080, height: 1080, label: "Square 1:1" },
+    "4:5": { preset: "4:5", width: 1080, height: 1350, label: "Portrait 4:5" },
+    "16:9": { preset: "16:9", width: 1920, height: 1080, label: "Horizontal 16:9" },
+    "4:3": { preset: "4:3", width: 1440, height: 1080, label: "Classic 4:3" },
+};
+export function reformatSpec(preset) {
+    const spec = PRESETS[preset];
+    if (!spec) {
+        throw new Error(`unknown reformat preset: ${preset}; valid: ${Object.keys(PRESETS).join(", ")}`);
+    }
+    return spec;
+}
+export const REFORMAT_PRESETS = Object.keys(PRESETS);
+//# sourceMappingURL=reformat.js.map

package/dist/core/reformat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reformat.js","sourceRoot":"","sources":["../../src/core/reformat.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAYH,MAAM,OAAO,GAAyC;IACpD,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,eAAe,EAAE;IAC7E,KAAK,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,YAAY,EAAE;IACxE,KAAK,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,cAAc,EAAE;IAC1E,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,iBAAiB,EAAE;IAC/E,KAAK,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,aAAa,EAAE;CAC1E,CAAC;AAEF,MAAM,UAAU,YAAY,CAAC,MAAsB;IACjD,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7B,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CACb,4BAA4B,MAAM,YAAY,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAChF,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAqB,CAAC"}

package/dist/core/reformat.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=reformat.test.d.ts.map

package/dist/core/reformat.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reformat.test.d.ts","sourceRoot":"","sources":["../../src/core/reformat.test.ts"],"names":[],"mappings":""}

package/dist/core/reformat.test.js

@@ -0,0 +1,29 @@
+import { describe, expect, it } from "vitest";
+import { REFORMAT_PRESETS, reformatSpec } from "./reformat.js";
+describe("reformatSpec", () => {
+    it("returns 1080x1920 for 9:16", () => {
+        const s = reformatSpec("9:16");
+        expect(s.width).toBe(1080);
+        expect(s.height).toBe(1920);
+    });
+    it("returns square 1080x1080 for 1:1", () => {
+        expect(reformatSpec("1:1")).toMatchObject({ width: 1080, height: 1080 });
+    });
+    it("returns 1080x1350 for 4:5 portrait", () => {
+        expect(reformatSpec("4:5")).toMatchObject({ width: 1080, height: 1350 });
+    });
+    it("returns 1920x1080 for 16:9", () => {
+        expect(reformatSpec("16:9")).toMatchObject({ width: 1920, height: 1080 });
+    });
+    it("returns 1440x1080 for 4:3", () => {
+        expect(reformatSpec("4:3")).toMatchObject({ width: 1440, height: 1080 });
+    });
+    it("throws on unknown preset", () => {
+        // @ts-expect-error invalid preset for testing
+        expect(() => reformatSpec("bogus")).toThrow(/unknown reformat preset/);
+    });
+    it("exposes a stable preset list", () => {
+        expect(REFORMAT_PRESETS).toEqual(["9:16", "1:1", "4:5", "16:9", "4:3"]);
+    });
+});
+//# sourceMappingURL=reformat.test.js.map

package/dist/core/reformat.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reformat.test.js","sourceRoot":"","sources":["../../src/core/reformat.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE/D,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QACpC,MAAM,CAAC,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;QAC/B,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3B,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3E,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3E,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QACpC,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5E,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACnC,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3E,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,0BAA0B,EAAE,GAAG,EAAE;QAClC,8CAA8C;QAC9C,MAAM,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,yBAAyB,CAAC,CAAC;IACzE,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,CAAC,gBAAgB,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/core/reorder.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Timeline reordering — turn a current TimelineState + an agent-supplied
+ * permutation into a list of FCPXML events that the host can re-import.
+ *
+ * Why this exists: neither Resolve nor Premiere expose a scriptable "move
+ * clip from index N to index M" call. The portable workaround is to rebuild
+ * the timeline as FCPXML and import it. This module is the pure, testable
+ * core of that workaround.
+ *
+ * Ordering rules:
+ *   - Only video clips are reorderable (audio rides along with each video
+ *     clip's underlying asset). Audio-only timelines are out of scope here.
+ *   - `newOrder` is a list of clip IDs in the desired new order. Clips not
+ *     listed keep their original relative order and stack at the end.
+ *   - Throws if newOrder references a clipId that doesn't exist on the
+ *     current timeline (typo guard — silently dropping is worse).
+ */
+import type { TimelineState } from "../types.js";
+import type { FcpxmlEvent } from "./fcpxml.js";
+export interface ReorderInput {
+    /** Current timeline state from host.getTimeline(). */
+    current: TimelineState;
+    /**
+     * Desired new order, as a list of clipIds. IDs not present here keep their
+     * original relative order and append at the end.
+     */
+    newOrder: string[];
+    /**
+     * Map from clipId to absolute source media path. Required because
+     * TimelineState's ClipInfo has an OPTIONAL sourcePath — when the host
+     * adapter can't resolve it (e.g. CEP fallback), the agent supplies it.
+     * If a ClipInfo already has sourcePath, the map entry is optional.
+     */
+    sourcePathByClipId?: Record<string, string>;
+}
+/**
+ * Build the FcpxmlEvent[] list for the reordered timeline. Each event maps
+ * to one video clip in the new order. Sequential record offsets are computed
+ * by the FCPXML emitter (we don't pre-compute them here — that's its job).
+ */
+export declare function reorderToEvents(input: ReorderInput): FcpxmlEvent[];
+//# sourceMappingURL=reorder.d.ts.map

package/dist/core/reorder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reorder.d.ts","sourceRoot":"","sources":["../../src/core/reorder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAY,aAAa,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,MAAM,WAAW,YAAY;IAC3B,sDAAsD;IACtD,OAAO,EAAE,aAAa,CAAC;IACvB;;;OAGG;IACH,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7C;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,YAAY,GAAG,WAAW,EAAE,CA6DlE"}

package/dist/core/reorder.js

@@ -0,0 +1,80 @@
+/**
+ * Timeline reordering — turn a current TimelineState + an agent-supplied
+ * permutation into a list of FCPXML events that the host can re-import.
+ *
+ * Why this exists: neither Resolve nor Premiere expose a scriptable "move
+ * clip from index N to index M" call. The portable workaround is to rebuild
+ * the timeline as FCPXML and import it. This module is the pure, testable
+ * core of that workaround.
+ *
+ * Ordering rules:
+ *   - Only video clips are reorderable (audio rides along with each video
+ *     clip's underlying asset). Audio-only timelines are out of scope here.
+ *   - `newOrder` is a list of clip IDs in the desired new order. Clips not
+ *     listed keep their original relative order and stack at the end.
+ *   - Throws if newOrder references a clipId that doesn't exist on the
+ *     current timeline (typo guard — silently dropping is worse).
+ */
+/**
+ * Build the FcpxmlEvent[] list for the reordered timeline. Each event maps
+ * to one video clip in the new order. Sequential record offsets are computed
+ * by the FCPXML emitter (we don't pre-compute them here — that's its job).
+ */
+export function reorderToEvents(input) {
+    const { current, newOrder, sourcePathByClipId = {} } = input;
+    // Filter to video-track clips only; audio-only timelines aren't supported
+    // by this rebuild path. Order by track then start so the input is stable.
+    const videoClips = current.clips
+        .filter((c) => c.trackKind === "video")
+        .sort((a, b) => a.track - b.track || a.startFrame - b.startFrame);
+    const byId = new Map();
+    for (const c of videoClips)
+        byId.set(c.id, c);
+    // Validate newOrder
+    for (const id of newOrder) {
+        if (!byId.has(id)) {
+            throw new Error(`reorder: clipId not found on current timeline: ${id}`);
+        }
+    }
+    const seen = new Set();
+    const ordered = [];
+    // First the explicitly-listed IDs, in the supplied order.
+    for (const id of newOrder) {
+        if (seen.has(id))
+            continue;
+        seen.add(id);
+        ordered.push(byId.get(id));
+    }
+    // Then anything not mentioned, preserving its original position relative
+    // to other unmentioned clips.
+    for (const c of videoClips) {
+        if (!seen.has(c.id)) {
+            seen.add(c.id);
+            ordered.push(c);
+        }
+    }
+    // Map each clip to an FcpxmlEvent. The reel = the source path so multiple
+    // clips from the same source share an asset in the emitted FCPXML.
+    return ordered.map((c, i) => {
+        const sourcePath = sourcePathByClipId[c.id] ?? c.sourcePath;
+        if (!sourcePath) {
+            throw new Error(`reorder: missing sourcePath for clip ${c.id}; pass sourcePathByClipId or ensure host returns it`);
+        }
+        const dur = c.endFrame - c.startFrame;
+        if (dur <= 0) {
+            throw new Error(`reorder: clip ${c.id} has non-positive duration`);
+        }
+        return {
+            reel: sourcePath,
+            sourcePath,
+            // Record-time start/end on the OLD timeline. We treat the original
+            // record start as the source-in for the rebuilt timeline so the clip
+            // body stays identical; offset on the spine is recomputed by the
+            // FCPXML emitter.
+            sourceInFrame: c.startFrame,
+            sourceOutFrame: c.endFrame,
+            clipName: c.name || `clip ${i + 1}`,
+        };
+    });
+}
+//# sourceMappingURL=reorder.js.map

package/dist/core/reorder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reorder.js","sourceRoot":"","sources":["../../src/core/reorder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAsBH;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,KAAmB;IACjD,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,kBAAkB,GAAG,EAAE,EAAE,GAAG,KAAK,CAAC;IAE7D,0EAA0E;IAC1E,0EAA0E;IAC1E,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK;SAC7B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,OAAO,CAAC;SACtC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC;IAEpE,MAAM,IAAI,GAAG,IAAI,GAAG,EAAoB,CAAC;IACzC,KAAK,MAAM,CAAC,IAAI,UAAU;QAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IAE9C,oBAAoB;IACpB,KAAK,MAAM,EAAE,IAAI,QAAQ,EAAE,CAAC;QAC1B,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,kDAAkD,EAAE,EAAE,CAAC,CAAC;QAC1E,CAAC;IACH,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,OAAO,GAAe,EAAE,CAAC;IAC/B,0DAA0D;IAC1D,KAAK,MAAM,EAAE,IAAI,QAAQ,EAAE,CAAC;QAC1B,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YAAE,SAAS;QAC3B,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACb,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAE,CAAC,CAAC;IAC9B,CAAC;IACD,yEAAyE;IACzE,8BAA8B;IAC9B,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;YACpB,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACf,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAED,0EAA0E;IAC1E,mEAAmE;IACnE,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QAC1B,MAAM,UAAU,GAAG,kBAAkB,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC;QAC5D,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CACb,wCAAwC,CAAC,CAAC,EAAE,qDAAqD,CAClG,CAAC;QACJ,CAAC;QACD,MAAM,GAAG,GAAG,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,UAAU,CAAC;QACtC,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC,EAAE,4BAA4B,CAAC,CAAC;QACrE,CAAC;QACD,OAAO;YACL,IAAI,EAAE,UAAU;YAChB,UAAU;YACV,mEAAmE;YACnE,qEAAqE;YACrE,iEAAiE;YACjE,kBAAkB;YAClB,aAAa,EAAE,CAAC,CAAC,UAAU;YAC3B,cAAc,EAAE,CAAC,CAAC,QAAQ;YAC1B,QAAQ,EAAE,CAAC,CAAC,IAAI,IAAI,QAAQ,CAAC,GAAG,CAAC,EAAE;SACpC,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/core/reorder.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=reorder.test.d.ts.map

package/dist/core/reorder.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reorder.test.d.ts","sourceRoot":"","sources":["../../src/core/reorder.test.ts"],"names":[],"mappings":""}