@prestyj/editor 0.7.1

package/dist/core/marker-colors.test.js.map

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

package/dist/core/media/ffmpeg.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Thin ffmpeg/ffprobe wrappers. The agent never invokes ffmpeg directly —
+ * tools call these functions, which gives us one place to audit args and
+ * cancel running processes.
+ */
+export interface FfmpegResult {
+    code: number;
+    stdout: string;
+    stderr: string;
+}
+export declare function checkFfmpeg(): boolean;
+export declare function checkFfprobe(): boolean;
+export declare function runFfmpeg(args: string[], opts?: {
+    signal?: AbortSignal;
+}): Promise<FfmpegResult>;
+export interface MediaProbe {
+    durationSec: number;
+    width?: number;
+    height?: number;
+    frameRate?: number;
+    videoCodec?: string;
+    audioCodec?: string;
+    audioChannels?: number;
+    audioSampleRate?: number;
+}
+export declare function probeMedia(filePath: string): MediaProbe | null;
+//# sourceMappingURL=ffmpeg.d.ts.map

package/dist/core/media/ffmpeg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ffmpeg.d.ts","sourceRoot":"","sources":["../../../src/core/media/ffmpeg.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AAEH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,WAAW,IAAI,OAAO,CAGrC;AAED,wBAAgB,YAAY,IAAI,OAAO,CAGtC;AAED,wBAAgB,SAAS,CACvB,IAAI,EAAE,MAAM,EAAE,EACd,IAAI,GAAE;IAAE,MAAM,CAAC,EAAE,WAAW,CAAA;CAAO,GAClC,OAAO,CAAC,YAAY,CAAC,CAuBvB;AAED,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CA4C9D"}

package/dist/core/media/ffmpeg.js

@@ -0,0 +1,64 @@
+import { spawn, spawnSync } from "node:child_process";
+import { wireChildAbort } from "../child-abort.js";
+export function checkFfmpeg() {
+    const r = spawnSync("ffmpeg", ["-version"], { encoding: "utf8" });
+    return r.status === 0;
+}
+export function checkFfprobe() {
+    const r = spawnSync("ffprobe", ["-version"], { encoding: "utf8" });
+    return r.status === 0;
+}
+export function runFfmpeg(args, opts = {}) {
+    return new Promise((resolve, reject) => {
+        const child = spawn("ffmpeg", ["-hide_banner", "-y", ...args], {
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+        let stdout = "";
+        let stderr = "";
+        child.stdout.on("data", (d) => (stdout += d.toString()));
+        child.stderr.on("data", (d) => (stderr += d.toString()));
+        // Robust abort: SIGTERM → SIGKILL after 1.5s. ffmpeg respects SIGTERM
+        // quickly on its read loop; the SIGKILL backstop covers wedge cases.
+        // We resolve with a non-zero code on abort instead of rejecting because
+        // ffmpeg callers check `r.code !== 0` and surface a tailored error.
+        const cleanup = wireChildAbort(opts.signal, child);
+        child.on("error", (e) => {
+            cleanup();
+            reject(e);
+        });
+        child.on("close", (code) => {
+            cleanup();
+            resolve({ code: code ?? 1, stdout, stderr });
+        });
+    });
+}
+export function probeMedia(filePath) {
+    const r = spawnSync("ffprobe", ["-v", "error", "-print_format", "json", "-show_format", "-show_streams", filePath], { encoding: "utf8" });
+    if (r.status !== 0)
+        return null;
+    try {
+        const data = JSON.parse(r.stdout);
+        const v = data.streams?.find((s) => s.codec_type === "video");
+        const a = data.streams?.find((s) => s.codec_type === "audio");
+        let frameRate;
+        if (v?.r_frame_rate) {
+            const [num, den] = v.r_frame_rate.split("/").map(Number);
+            if (num && den)
+                frameRate = num / den;
+        }
+        return {
+            durationSec: parseFloat(data.format?.duration ?? "0"),
+            width: v?.width,
+            height: v?.height,
+            frameRate,
+            videoCodec: v?.codec_name,
+            audioCodec: a?.codec_name,
+            audioChannels: a?.channels,
+            audioSampleRate: a?.sample_rate ? parseInt(a.sample_rate, 10) : undefined,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=ffmpeg.js.map

package/dist/core/media/ffmpeg.js.map

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

package/dist/core/multi-format.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Multi-format render presets — the "render every platform at once" matrix.
+ *
+ * Pure dispatcher for `render_multi_format`: given a source resolution and a
+ * preset name, produces the ffmpeg `-vf` filter graph plus the target W×H.
+ * Spawning ffmpeg lives in the tool layer so this module stays trivially
+ * unit-testable.
+ *
+ * Two transform modes:
+ *
+ *   - "scale-pad"   — letterbox/pillarbox the source into the target frame
+ *                     without cropping. Used for 16:9-into-16:9 (different
+ *                     resolution) and any time we want to preserve every
+ *                     pixel of the source.
+ *
+ *   - "centre-crop" — crop the source to the target aspect, then scale to
+ *                     target resolution. The dumb / mechanical version of
+ *                     content-aware reframing — for face-tracked re-cropping
+ *                     the agent should pipe the source through `face_reframe`
+ *                     or Resolve `smart_reframe` BEFORE calling this tool.
+ */
+export type MultiFormat = "youtube-1080p" | "shorts-9x16" | "reels-9x16" | "tiktok-9x16" | "square-1x1" | "instagram-4x5" | "twitter-16x9";
+export declare const MULTI_FORMATS: readonly MultiFormat[];
+export type MultiFormatTransform = "scale-pad" | "centre-crop";
+interface PresetSpec {
+    width: number;
+    height: number;
+    transform: MultiFormatTransform;
+}
+export declare function multiFormatSpec(format: MultiFormat): PresetSpec;
+export interface BuildRenderFilterResult {
+    targetW: number;
+    targetH: number;
+    vf: string;
+    transform: MultiFormatTransform;
+}
+export interface BuildRenderFilterOptions {
+    /**
+     * If true, treat the source as already cropped to the target aspect (e.g.
+     * via face_reframe / smart_reframe upstream). Forces a non-cropping
+     * scale-pad regardless of the preset's default transform.
+     */
+    faceTracked?: boolean;
+}
+/**
+ * Build the ffmpeg `-vf` filter for a single (source, preset) pair.
+ *
+ * Pure function — no side effects, no I/O. Used by `render_multi_format`
+ * to compose ffmpeg args, and by the unit tests to lock the filter math.
+ *
+ * Math notes for centre-crop:
+ *
+ *   srcAR = srcW/srcH, tgtAR = Wt/Ht. The crop keeps the larger axis full.
+ *
+ *   - srcAR > tgtAR  ⇒  source is wider than target. Crop width.
+ *       cropW = ih * Wt/Ht ; cropH = ih ; x = (iw - cropW)/2 ; y = 0
+ *   - srcAR < tgtAR  ⇒  source is taller than target. Crop height.
+ *       cropW = iw ; cropH = iw * Ht/Wt ; x = 0 ; y = (ih - cropH)/2
+ *   - srcAR == tgtAR ⇒  no crop needed; emit `scale=Wt:Ht` only.
+ *
+ * Float crop dimensions are passed through to ffmpeg (which accepts them
+ * and rounds internally); the trailing `scale=Wt:Ht` enforces the final
+ * even-dimension target so x264 stays happy.
+ */
+export declare function buildRenderFilter(srcW: number, srcH: number, format: MultiFormat, opts?: BuildRenderFilterOptions): BuildRenderFilterResult;
+export {};
+//# sourceMappingURL=multi-format.d.ts.map

package/dist/core/multi-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multi-format.d.ts","sourceRoot":"","sources":["../../src/core/multi-format.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,MAAM,MAAM,WAAW,GACnB,eAAe,GACf,aAAa,GACb,YAAY,GACZ,aAAa,GACb,YAAY,GACZ,eAAe,GACf,cAAc,CAAC;AAEnB,eAAO,MAAM,aAAa,EAAE,SAAS,WAAW,EAQtC,CAAC;AAEX,MAAM,MAAM,oBAAoB,GAAG,WAAW,GAAG,aAAa,CAAC;AAE/D,UAAU,UAAU;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,oBAAoB,CAAC;CACjC;AAmBD,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,UAAU,CAQ/D;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,oBAAoB,CAAC;CACjC;AAED,MAAM,WAAW,wBAAwB;IACvC;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,WAAW,EACnB,IAAI,GAAE,wBAA6B,GAClC,uBAAuB,CA0CzB"}

package/dist/core/multi-format.js

@@ -0,0 +1,127 @@
+/**
+ * Multi-format render presets — the "render every platform at once" matrix.
+ *
+ * Pure dispatcher for `render_multi_format`: given a source resolution and a
+ * preset name, produces the ffmpeg `-vf` filter graph plus the target W×H.
+ * Spawning ffmpeg lives in the tool layer so this module stays trivially
+ * unit-testable.
+ *
+ * Two transform modes:
+ *
+ *   - "scale-pad"   — letterbox/pillarbox the source into the target frame
+ *                     without cropping. Used for 16:9-into-16:9 (different
+ *                     resolution) and any time we want to preserve every
+ *                     pixel of the source.
+ *
+ *   - "centre-crop" — crop the source to the target aspect, then scale to
+ *                     target resolution. The dumb / mechanical version of
+ *                     content-aware reframing — for face-tracked re-cropping
+ *                     the agent should pipe the source through `face_reframe`
+ *                     or Resolve `smart_reframe` BEFORE calling this tool.
+ */
+export const MULTI_FORMATS = [
+    "youtube-1080p",
+    "shorts-9x16",
+    "reels-9x16",
+    "tiktok-9x16",
+    "square-1x1",
+    "instagram-4x5",
+    "twitter-16x9",
+];
+/**
+ * Per-preset target resolution + default transform.
+ *
+ * Resolutions are platform-canonical: 1080p horizontal, 1080×1920 vertical,
+ * 1080-square IG, 1080×1350 IG-portrait, 720p Twitter (their feed downsamples
+ * anything taller anyway).
+ */
+const PRESETS = {
+    "youtube-1080p": { width: 1920, height: 1080, transform: "scale-pad" },
+    "shorts-9x16": { width: 1080, height: 1920, transform: "centre-crop" },
+    "reels-9x16": { width: 1080, height: 1920, transform: "centre-crop" },
+    "tiktok-9x16": { width: 1080, height: 1920, transform: "centre-crop" },
+    "square-1x1": { width: 1080, height: 1080, transform: "centre-crop" },
+    "instagram-4x5": { width: 1080, height: 1350, transform: "centre-crop" },
+    "twitter-16x9": { width: 1280, height: 720, transform: "scale-pad" },
+};
+export function multiFormatSpec(format) {
+    const spec = PRESETS[format];
+    if (!spec) {
+        throw new Error(`unknown multi-format preset: ${format}; valid: ${Object.keys(PRESETS).join(", ")}`);
+    }
+    return spec;
+}
+/**
+ * Build the ffmpeg `-vf` filter for a single (source, preset) pair.
+ *
+ * Pure function — no side effects, no I/O. Used by `render_multi_format`
+ * to compose ffmpeg args, and by the unit tests to lock the filter math.
+ *
+ * Math notes for centre-crop:
+ *
+ *   srcAR = srcW/srcH, tgtAR = Wt/Ht. The crop keeps the larger axis full.
+ *
+ *   - srcAR > tgtAR  ⇒  source is wider than target. Crop width.
+ *       cropW = ih * Wt/Ht ; cropH = ih ; x = (iw - cropW)/2 ; y = 0
+ *   - srcAR < tgtAR  ⇒  source is taller than target. Crop height.
+ *       cropW = iw ; cropH = iw * Ht/Wt ; x = 0 ; y = (ih - cropH)/2
+ *   - srcAR == tgtAR ⇒  no crop needed; emit `scale=Wt:Ht` only.
+ *
+ * Float crop dimensions are passed through to ffmpeg (which accepts them
+ * and rounds internally); the trailing `scale=Wt:Ht` enforces the final
+ * even-dimension target so x264 stays happy.
+ */
+export function buildRenderFilter(srcW, srcH, format, opts = {}) {
+    if (!Number.isFinite(srcW) || srcW <= 0 || !Number.isFinite(srcH) || srcH <= 0) {
+        throw new Error(`invalid source dimensions: ${srcW}x${srcH}`);
+    }
+    const spec = multiFormatSpec(format);
+    const targetW = spec.width;
+    const targetH = spec.height;
+    const transform = opts.faceTracked ? "scale-pad" : spec.transform;
+    if (transform === "scale-pad") {
+        const vf = `scale=${targetW}:${targetH}:force_original_aspect_ratio=decrease,` +
+            `pad=${targetW}:${targetH}:(ow-iw)/2:(oh-ih)/2:color=black`;
+        return { targetW, targetH, vf, transform };
+    }
+    // centre-crop
+    const srcAR = srcW / srcH;
+    const tgtAR = targetW / targetH;
+    // Use a tiny tolerance so 1920x1080 vs perfectly-equal 16:9 sources round
+    // to the no-crop branch; prevents emitting `crop=iw:ih:0:0`.
+    const eps = 1e-6;
+    if (Math.abs(srcAR - tgtAR) < eps) {
+        return {
+            targetW,
+            targetH,
+            vf: `scale=${targetW}:${targetH}`,
+            transform,
+        };
+    }
+    if (srcAR > tgtAR) {
+        // crop width
+        const cropW = formatNum((srcH * targetW) / targetH);
+        const x = formatNum((srcW - (srcH * targetW) / targetH) / 2);
+        const vf = `crop=${cropW}:${srcH}:${x}:0,scale=${targetW}:${targetH}`;
+        return { targetW, targetH, vf, transform };
+    }
+    // srcAR < tgtAR — crop height
+    const cropH = formatNum((srcW * targetH) / targetW);
+    const y = formatNum((srcH - (srcW * targetH) / targetW) / 2);
+    const vf = `crop=${srcW}:${cropH}:0:${y},scale=${targetW}:${targetH}`;
+    return { targetW, targetH, vf, transform };
+}
+/**
+ * Format a number for inclusion in an ffmpeg filter expression. Trims any
+ * `.0` tail (e.g. 1080.0 → "1080") so integer paths remain integer-looking
+ * in the filter graph; otherwise emits up to 2 decimals.
+ */
+function formatNum(n) {
+    if (Number.isInteger(n))
+        return String(n);
+    // Two decimals is enough for any practical (W, H) from canonical sources;
+    // the trailing `scale` rounds to the final integer target.
+    const rounded = Math.round(n * 100) / 100;
+    return Number.isInteger(rounded) ? String(rounded) : String(rounded);
+}
+//# sourceMappingURL=multi-format.js.map

package/dist/core/multi-format.js.map

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

package/dist/core/multi-format.test.d.ts

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

package/dist/core/multi-format.test.d.ts.map

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

package/dist/core/multi-format.test.js

@@ -0,0 +1,151 @@
+import { describe, expect, it } from "vitest";
+import { buildRenderFilter, MULTI_FORMATS, multiFormatSpec, } from "./multi-format.js";
+describe("multiFormatSpec", () => {
+    it("exposes seven canonical presets", () => {
+        expect(MULTI_FORMATS).toEqual([
+            "youtube-1080p",
+            "shorts-9x16",
+            "reels-9x16",
+            "tiktok-9x16",
+            "square-1x1",
+            "instagram-4x5",
+            "twitter-16x9",
+        ]);
+    });
+    it("returns 1920x1080 for youtube-1080p (scale-pad)", () => {
+        expect(multiFormatSpec("youtube-1080p")).toEqual({
+            width: 1920,
+            height: 1080,
+            transform: "scale-pad",
+        });
+    });
+    it("returns 1080x1920 + centre-crop for the three vertical aliases", () => {
+        for (const f of ["shorts-9x16", "reels-9x16", "tiktok-9x16"]) {
+            expect(multiFormatSpec(f)).toEqual({
+                width: 1080,
+                height: 1920,
+                transform: "centre-crop",
+            });
+        }
+    });
+    it("returns 1080x1080 for square-1x1, 1080x1350 for instagram-4x5, 1280x720 for twitter-16x9", () => {
+        expect(multiFormatSpec("square-1x1")).toMatchObject({ width: 1080, height: 1080 });
+        expect(multiFormatSpec("instagram-4x5")).toMatchObject({ width: 1080, height: 1350 });
+        expect(multiFormatSpec("twitter-16x9")).toMatchObject({
+            width: 1280,
+            height: 720,
+            transform: "scale-pad",
+        });
+    });
+    it("throws on unknown preset", () => {
+        expect(() => multiFormatSpec("bogus")).toThrow(/unknown multi-format preset/);
+    });
+});
+describe("buildRenderFilter — 1920x1080 source", () => {
+    it("youtube-1080p: emits scale+pad to 1920x1080", () => {
+        const r = buildRenderFilter(1920, 1080, "youtube-1080p");
+        expect(r.transform).toBe("scale-pad");
+        expect(r.targetW).toBe(1920);
+        expect(r.targetH).toBe(1080);
+        expect(r.vf).toBe("scale=1920:1080:force_original_aspect_ratio=decrease,pad=1920:1080:(ow-iw)/2:(oh-ih)/2:color=black");
+    });
+    it("shorts-9x16 from 1920x1080: centre-crops width to 607.5, x=656.25", () => {
+        const r = buildRenderFilter(1920, 1080, "shorts-9x16");
+        expect(r.transform).toBe("centre-crop");
+        expect(r.targetW).toBe(1080);
+        expect(r.targetH).toBe(1920);
+        expect(r.vf).toBe("crop=607.5:1080:656.25:0,scale=1080:1920");
+    });
+    it("square-1x1 from 1920x1080: crops width to 1080, x=420", () => {
+        const r = buildRenderFilter(1920, 1080, "square-1x1");
+        expect(r.transform).toBe("centre-crop");
+        // 1080 * 1 / 1 = 1080 ; (1920 - 1080)/2 = 420
+        expect(r.vf).toBe("crop=1080:1080:420:0,scale=1080:1080");
+    });
+    it("instagram-4x5 from 1920x1080: crops width to 864, x=528", () => {
+        const r = buildRenderFilter(1920, 1080, "instagram-4x5");
+        // 1080 * 4 / 5 = 864 ; (1920 - 864)/2 = 528
+        expect(r.transform).toBe("centre-crop");
+        expect(r.vf).toBe("crop=864:1080:528:0,scale=1080:1350");
+    });
+    it("twitter-16x9 from 1920x1080: scale+pad to 1280x720", () => {
+        const r = buildRenderFilter(1920, 1080, "twitter-16x9");
+        expect(r.transform).toBe("scale-pad");
+        expect(r.targetW).toBe(1280);
+        expect(r.targetH).toBe(720);
+        expect(r.vf).toBe("scale=1280:720:force_original_aspect_ratio=decrease,pad=1280:720:(ow-iw)/2:(oh-ih)/2:color=black");
+    });
+});
+describe("buildRenderFilter — 3840x2160 source (4K UHD, also 16:9)", () => {
+    it("shorts-9x16: same crop math scaled — cropW=1215, x=1312.5", () => {
+        const r = buildRenderFilter(3840, 2160, "shorts-9x16");
+        // 2160 * 9 / 16 = 1215 ; (3840 - 1215) / 2 = 1312.5
+        expect(r.vf).toBe("crop=1215:2160:1312.5:0,scale=1080:1920");
+    });
+    it("youtube-1080p: scale-pad still emits the 1080p target", () => {
+        const r = buildRenderFilter(3840, 2160, "youtube-1080p");
+        expect(r.targetW).toBe(1920);
+        expect(r.targetH).toBe(1080);
+        expect(r.vf).toContain("scale=1920:1080:force_original_aspect_ratio=decrease");
+    });
+    it("instagram-4x5 from 4K: cropW=1728, x=1056", () => {
+        const r = buildRenderFilter(3840, 2160, "instagram-4x5");
+        // 2160 * 4 / 5 = 1728 ; (3840 - 1728) / 2 = 1056
+        expect(r.vf).toBe("crop=1728:2160:1056:0,scale=1080:1350");
+    });
+    it("square-1x1 from 4K: cropW=2160, x=840", () => {
+        const r = buildRenderFilter(3840, 2160, "square-1x1");
+        expect(r.vf).toBe("crop=2160:2160:840:0,scale=1080:1080");
+    });
+});
+describe("buildRenderFilter — 1080x1920 portrait source", () => {
+    it("shorts-9x16: aspects match, no crop — just scale", () => {
+        const r = buildRenderFilter(1080, 1920, "shorts-9x16");
+        expect(r.transform).toBe("centre-crop");
+        expect(r.vf).toBe("scale=1080:1920");
+    });
+    it("youtube-1080p: scale+pad pillarboxes the portrait into 1920x1080", () => {
+        const r = buildRenderFilter(1080, 1920, "youtube-1080p");
+        expect(r.transform).toBe("scale-pad");
+        expect(r.vf).toBe("scale=1920:1080:force_original_aspect_ratio=decrease,pad=1920:1080:(ow-iw)/2:(oh-ih)/2:color=black");
+    });
+    it("square-1x1 from portrait: src is taller than 1:1, so crop HEIGHT", () => {
+        const r = buildRenderFilter(1080, 1920, "square-1x1");
+        // srcAR = 1080/1920 = 0.5625 < 1 (target). crop height: cropH = iw*Ht/Wt = 1080*1/1 = 1080 ; y = (1920-1080)/2 = 420
+        expect(r.vf).toBe("crop=1080:1080:0:420,scale=1080:1080");
+    });
+    it("instagram-4x5 from portrait: src AR (0.5625) < target AR (0.8) → crop height", () => {
+        const r = buildRenderFilter(1080, 1920, "instagram-4x5");
+        // cropH = iw * Ht/Wt = 1080 * 1350/1080 = 1350 ; y = (1920 - 1350)/2 = 285
+        expect(r.vf).toBe("crop=1080:1350:0:285,scale=1080:1350");
+    });
+});
+describe("buildRenderFilter — scale-pad math for upscale source 1280x720", () => {
+    it("youtube-1080p target from 720p: scale up + pad to 1920x1080", () => {
+        const r = buildRenderFilter(1280, 720, "youtube-1080p");
+        expect(r.transform).toBe("scale-pad");
+        expect(r.targetW).toBe(1920);
+        expect(r.targetH).toBe(1080);
+        expect(r.vf).toBe("scale=1920:1080:force_original_aspect_ratio=decrease,pad=1920:1080:(ow-iw)/2:(oh-ih)/2:color=black");
+    });
+});
+describe("buildRenderFilter — faceTracked option", () => {
+    it("forces scale-pad for vertical presets when faceTracked=true", () => {
+        const r = buildRenderFilter(1920, 1080, "shorts-9x16", { faceTracked: true });
+        expect(r.transform).toBe("scale-pad");
+        expect(r.vf).toBe("scale=1080:1920:force_original_aspect_ratio=decrease,pad=1080:1920:(ow-iw)/2:(oh-ih)/2:color=black");
+    });
+    it("is a no-op for already-scale-pad presets", () => {
+        const a = buildRenderFilter(1920, 1080, "youtube-1080p", { faceTracked: true });
+        const b = buildRenderFilter(1920, 1080, "youtube-1080p", { faceTracked: false });
+        expect(a.vf).toBe(b.vf);
+    });
+});
+describe("buildRenderFilter — input validation", () => {
+    it("rejects zero / negative / non-finite dimensions", () => {
+        expect(() => buildRenderFilter(0, 1080, "youtube-1080p")).toThrow(/invalid source dimensions/);
+        expect(() => buildRenderFilter(1920, -1, "youtube-1080p")).toThrow(/invalid source dimensions/);
+        expect(() => buildRenderFilter(NaN, 1080, "youtube-1080p")).toThrow(/invalid source dimensions/);
+    });
+});
+//# sourceMappingURL=multi-format.test.js.map

package/dist/core/multi-format.test.js.map

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

package/dist/core/multicam.d.ts

@@ -0,0 +1,40 @@
+export interface TransientResult {
+    path: string;
+    /** Seconds from file start where the first audible event begins, or null. */
+    transientSec: number | null;
+}
+export interface MulticamSyncResult {
+    /** Path used as the t=0 reference (transient closest to file start). */
+    reference: string;
+    results: Array<{
+        path: string;
+        /** Positive = file starts later than reference. null = no transient detected. */
+        offsetSec: number | null;
+        transientSec: number | null;
+    }>;
+    thresholdDb: number;
+    /** Set if any input had no detectable transient. */
+    warning?: string;
+}
+/**
+ * Detect the first transient (end of leading silence) in a media file.
+ *
+ * Runs `silencedetect` with a strict noise floor and a long min-silence so the
+ * lead-in counts as silence; the first `silence_end` is the first audible event.
+ */
+export declare function detectFirstTransient(inputPath: string, opts?: {
+    thresholdDb?: number;
+    minSilenceSec?: number;
+    signal?: AbortSignal;
+}): Promise<TransientResult>;
+/**
+ * Align 2+ inputs by their first transient. Pick the input with the smallest
+ * transient as reference (transient at t=0 in the synced timeline). Other
+ * offsets = transient[i] - reference.transient.
+ */
+export declare function multicamSync(inputPaths: string[], opts?: {
+    thresholdDb?: number;
+    minSilenceSec?: number;
+    signal?: AbortSignal;
+}): Promise<MulticamSyncResult>;
+//# sourceMappingURL=multicam.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"multicam.d.ts","sourceRoot":"","sources":["../../src/core/multicam.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,6EAA6E;IAC7E,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,kBAAkB;IACjC,wEAAwE;IACxE,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,iFAAiF;QACjF,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;KAC7B,CAAC,CAAC;IACH,WAAW,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAAO,GAChF,OAAO,CAAC,eAAe,CAAC,CAyB1B;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,UAAU,EAAE,MAAM,EAAE,EACpB,IAAI,GAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAAO,GAChF,OAAO,CAAC,kBAAkB,CAAC,CA2C7B"}

package/dist/core/multicam.js

@@ -0,0 +1,77 @@
+/**
+ * Multicam clap-sync — first-transient alignment via ffmpeg silencedetect.
+ *
+ * v1 limitation: works only when each take starts with a clap, slate, or sharp
+ * sound louder than the surrounding lead-in silence. For dialogue-only takes
+ * with no slate, this tool can't align — that needs cross-correlation, deferred
+ * to a future v2 (would require an FFT lib or numpy).
+ */
+import { runFfmpeg } from "./media/ffmpeg.js";
+import { parseSilenceDetect } from "./silence.js";
+/**
+ * Detect the first transient (end of leading silence) in a media file.
+ *
+ * Runs `silencedetect` with a strict noise floor and a long min-silence so the
+ * lead-in counts as silence; the first `silence_end` is the first audible event.
+ */
+export async function detectFirstTransient(inputPath, opts = {}) {
+    const thresholdDb = opts.thresholdDb ?? -40;
+    const minSilenceSec = opts.minSilenceSec ?? 0.5;
+    const r = await runFfmpeg([
+        "-i",
+        inputPath,
+        "-af",
+        `silencedetect=noise=${thresholdDb}dB:d=${minSilenceSec}`,
+        "-f",
+        "null",
+        "-",
+    ], { signal: opts.signal });
+    if (r.code !== 0) {
+        return { path: inputPath, transientSec: null };
+    }
+    const ranges = parseSilenceDetect(r.stderr);
+    // The first range's endSec is the first transient (end of lead-in silence).
+    const first = ranges[0];
+    return {
+        path: inputPath,
+        transientSec: first ? first.endSec : null,
+    };
+}
+/**
+ * Align 2+ inputs by their first transient. Pick the input with the smallest
+ * transient as reference (transient at t=0 in the synced timeline). Other
+ * offsets = transient[i] - reference.transient.
+ */
+export async function multicamSync(inputPaths, opts = {}) {
+    if (inputPaths.length === 0) {
+        throw new Error("multicamSync: inputs is empty");
+    }
+    const thresholdDb = opts.thresholdDb ?? -40;
+    const transients = await Promise.all(inputPaths.map((p) => detectFirstTransient(p, {
+        thresholdDb,
+        minSilenceSec: opts.minSilenceSec,
+        signal: opts.signal,
+    })));
+    // Pick reference: smallest finite transient. If all null, fall back to first.
+    const withTransient = transients.filter((t) => t.transientSec !== null);
+    const reference = withTransient.length > 0
+        ? withTransient.reduce((acc, t) => t.transientSec < acc.transientSec ? t : acc)
+        : transients[0];
+    const refSec = reference.transientSec ?? 0;
+    const results = transients.map((t) => ({
+        path: t.path,
+        transientSec: t.transientSec,
+        offsetSec: t.transientSec === null ? null : +(t.transientSec - refSec).toFixed(6),
+    }));
+    const missing = results.filter((r) => r.offsetSec === null);
+    const warning = missing.length > 0
+        ? `no transient detected for ${missing.length} of ${results.length} input(s); manual alignment needed`
+        : undefined;
+    return {
+        reference: reference.path,
+        results,
+        thresholdDb,
+        warning,
+    };
+}
+//# sourceMappingURL=multicam.js.map

package/dist/core/multicam.js.map

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

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

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

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

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