@kenkaiiii/gg-editor 0.1.0

package/dist/core/edl-roundtrip.test.js

@@ -0,0 +1,171 @@
+/**
+ * Round-trip golden tests for the EDL writer.
+ *
+ * We don't ship a full EDL parser (no agent reads EDLs), so we use targeted
+ * regexes to pull (event, reel, track, srcIn, srcOut, recIn, recOut) back
+ * out of our own output and verify the structural invariants:
+ *
+ *   - One event line per input event, in order, with monotonically increasing event numbers
+ *   - Source frames round-trip via framesToTimecode
+ *   - Record frames are contiguous (recIn[N] == recOut[N-1])
+ *   - Reel + track padding is preserved
+ *   - Clip-name comments appear on the right event lines
+ *
+ * These give us a real regression net for any future edit to the EDL emitter.
+ */
+import { describe, expect, it } from "vitest";
+import { buildEdl } from "./edl.js";
+import { framesToTimecode } from "./format.js";
+const EVENT_RE = /^(\d{3})\s{2}(.{8})\s{2}(.{5})\s{2}C\s{8}(\d{2}:\d{2}:\d{2}:\d{2}) (\d{2}:\d{2}:\d{2}:\d{2}) (\d{2}:\d{2}:\d{2}:\d{2}) (\d{2}:\d{2}:\d{2}:\d{2})$/;
+function parseEdl(edl) {
+    const lines = edl.split("\n");
+    let title = "";
+    let fcm = "";
+    const events = [];
+    let pending = null;
+    for (const line of lines) {
+        if (line.startsWith("TITLE:"))
+            title = line.slice(6).trim();
+        else if (line.startsWith("FCM:"))
+            fcm = line.slice(4).trim();
+        else if (line.startsWith("* FROM CLIP NAME:") && pending) {
+            pending.clipName = line.slice("* FROM CLIP NAME:".length).trim();
+        }
+        else {
+            const m = EVENT_RE.exec(line);
+            if (m) {
+                if (pending)
+                    events.push(pending);
+                pending = {
+                    num: Number(m[1]),
+                    reel: m[2],
+                    track: m[3],
+                    srcIn: m[4],
+                    srcOut: m[5],
+                    recIn: m[6],
+                    recOut: m[7],
+                };
+            }
+        }
+    }
+    if (pending)
+        events.push(pending);
+    return { title, fcm, events };
+}
+describe("EDL round-trip", () => {
+    it("preserves source frames for a single event at 30fps", () => {
+        const events = [
+            {
+                reel: "TAKE1",
+                track: "V",
+                sourceInFrame: 30,
+                sourceOutFrame: 90,
+                clipName: "intro_take_1",
+            },
+        ];
+        const edl = buildEdl({ title: "test", frameRate: 30, events });
+        const parsed = parseEdl(edl);
+        expect(parsed.title).toBe("test");
+        expect(parsed.fcm).toBe("NON-DROP FRAME");
+        expect(parsed.events).toHaveLength(1);
+        expect(parsed.events[0].srcIn).toBe(framesToTimecode(30, 30));
+        expect(parsed.events[0].srcOut).toBe(framesToTimecode(90, 30));
+        expect(parsed.events[0].recIn).toBe(framesToTimecode(0, 30));
+        expect(parsed.events[0].recOut).toBe(framesToTimecode(60, 30));
+        expect(parsed.events[0].clipName).toBe("intro_take_1");
+    });
+    it("places events contiguously on the record timeline", () => {
+        const events = [
+            { reel: "A", track: "V", sourceInFrame: 0, sourceOutFrame: 100 },
+            { reel: "B", track: "V", sourceInFrame: 200, sourceOutFrame: 350 },
+            { reel: "A", track: "V", sourceInFrame: 500, sourceOutFrame: 600 },
+        ];
+        const edl = buildEdl({ title: "t", frameRate: 30, events });
+        const parsed = parseEdl(edl);
+        expect(parsed.events).toHaveLength(3);
+        // recOut of N === recIn of N+1
+        expect(parsed.events[0].recOut).toBe(parsed.events[1].recIn);
+        expect(parsed.events[1].recOut).toBe(parsed.events[2].recIn);
+        // record cursor totals match source-frame totals
+        const totalSrc = events.reduce((sum, e) => sum + (e.sourceOutFrame - e.sourceInFrame), 0);
+        expect(parsed.events.at(-1)?.recOut).toBe(framesToTimecode(totalSrc, 30));
+    });
+    it("emits 1-indexed monotonically increasing event numbers", () => {
+        const events = [];
+        for (let i = 0; i < 5; i++) {
+            events.push({
+                reel: `R${i}`,
+                track: "V",
+                sourceInFrame: i * 100,
+                sourceOutFrame: i * 100 + 50,
+            });
+        }
+        const parsed = parseEdl(buildEdl({ title: "t", frameRate: 30, events }));
+        expect(parsed.events.map((e) => e.num)).toEqual([1, 2, 3, 4, 5]);
+    });
+    it("truncates and pads reel names to 8 chars", () => {
+        const edl = buildEdl({
+            title: "t",
+            frameRate: 30,
+            events: [
+                {
+                    reel: "WAY_TOO_LONG_REEL_NAME",
+                    track: "V",
+                    sourceInFrame: 0,
+                    sourceOutFrame: 100,
+                },
+                { reel: "A", track: "V", sourceInFrame: 0, sourceOutFrame: 100 },
+            ],
+        });
+        const parsed = parseEdl(edl);
+        expect(parsed.events[0].reel).toBe("WAY_TOO_");
+        expect(parsed.events[1].reel).toBe("A       ");
+    });
+    it("preserves track type column", () => {
+        const edl = buildEdl({
+            title: "t",
+            frameRate: 30,
+            events: [
+                { reel: "A", track: "V", sourceInFrame: 0, sourceOutFrame: 30 },
+                { reel: "A", track: "A1", sourceInFrame: 0, sourceOutFrame: 30 },
+                { reel: "A", track: "B", sourceInFrame: 0, sourceOutFrame: 30 },
+            ],
+        });
+        const parsed = parseEdl(edl);
+        expect(parsed.events[0].track).toBe("V    ");
+        expect(parsed.events[1].track).toBe("A1   ");
+        expect(parsed.events[2].track).toBe("B    ");
+    });
+    it("survives 24/25/29.97/30/60 frame rates without drift", () => {
+        for (const fps of [24, 25, 29.97, 30, 60]) {
+            const events = [{ reel: "R", track: "V", sourceInFrame: 0, sourceOutFrame: 240 }];
+            const parsed = parseEdl(buildEdl({ title: "t", frameRate: fps, events }));
+            // Round-trip via framesToTimecode for the same fps must match.
+            expect(parsed.events[0].srcOut).toBe(framesToTimecode(240, fps));
+        }
+    });
+    it("attaches clip-name comments only to the events that have them", () => {
+        const events = [
+            {
+                reel: "A",
+                track: "V",
+                sourceInFrame: 0,
+                sourceOutFrame: 100,
+                clipName: "first",
+            },
+            { reel: "B", track: "V", sourceInFrame: 0, sourceOutFrame: 100 },
+            {
+                reel: "C",
+                track: "V",
+                sourceInFrame: 0,
+                sourceOutFrame: 100,
+                clipName: "third",
+            },
+        ];
+        const parsed = parseEdl(buildEdl({ title: "t", frameRate: 30, events }));
+        expect(parsed.events[0].clipName).toBe("first");
+        expect(parsed.events[1].clipName).toBeUndefined();
+        expect(parsed.events[2].clipName).toBe("third");
+    });
+});
+//# sourceMappingURL=edl-roundtrip.test.js.map

package/dist/core/edl-roundtrip.test.js.map

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

package/dist/core/edl.d.ts

@@ -0,0 +1,41 @@
+/**
+ * CMX 3600 EDL writer.
+ *
+ * One event per kept segment. The agent supplies a list of (source-in,
+ * source-out) pairs in source order; we lay them out contiguously on the
+ * record timeline, which is exactly the "rebuilt timeline after silence
+ * removal" pattern.
+ *
+ * CMX 3600 is the lowest-common-denominator interchange format — both
+ * DaVinci Resolve and Premiere Pro import it.
+ */
+export interface EdlEvent {
+    /** Reel name (≤8 chars in strict CMX 3600; we'll truncate). Most NLEs map this to the source clip. */
+    reel: string;
+    /** Track type. "V" video only, "A" audio, "B" both, "A1"/"A2" individual audio tracks. */
+    track: "V" | "A" | "B" | "A1" | "A2";
+    /** Source IN (frames into the source clip). */
+    sourceInFrame: number;
+    /** Source OUT (exclusive). */
+    sourceOutFrame: number;
+    /** Optional human label, written as a "* FROM CLIP NAME:" comment. */
+    clipName?: string;
+}
+export interface EdlOptions {
+    title: string;
+    frameRate: number;
+    events: EdlEvent[];
+    /** Drop-frame timecode? Default false. NDF is correct for 30/60 fps; DF only for 29.97/59.94. */
+    dropFrame?: boolean;
+}
+/**
+ * Build a CMX 3600 EDL string. Events are placed contiguously on the record
+ * timeline (event N starts where event N-1 ended).
+ */
+export declare function buildEdl(opts: EdlOptions): string;
+/**
+ * Total record-side duration of an EDL in frames. Useful for the agent to
+ * verify the rebuild matches its plan.
+ */
+export declare function totalRecordFrames(events: EdlEvent[]): number;
+//# sourceMappingURL=edl.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"edl.d.ts","sourceRoot":"","sources":["../../src/core/edl.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,QAAQ;IACvB,sGAAsG;IACtG,IAAI,EAAE,MAAM,CAAC;IACb,0FAA0F;IAC1F,KAAK,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI,CAAC;IACrC,+CAA+C;IAC/C,aAAa,EAAE,MAAM,CAAC;IACtB,8BAA8B;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,sEAAsE;IACtE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,QAAQ,EAAE,CAAC;IACnB,iGAAiG;IACjG,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAgCjD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,CAE5D"}

package/dist/core/edl.js

@@ -0,0 +1,56 @@
+import { framesToTimecode } from "./format.js";
+/**
+ * Build a CMX 3600 EDL string. Events are placed contiguously on the record
+ * timeline (event N starts where event N-1 ended).
+ */
+export function buildEdl(opts) {
+    const { title, frameRate, events, dropFrame = false } = opts;
+    const fcm = dropFrame ? "DROP FRAME" : "NON-DROP FRAME";
+    const lines = [];
+    lines.push(`TITLE: ${sanitize(title, 70)}`);
+    lines.push(`FCM: ${fcm}`);
+    lines.push("");
+    let recordCursor = 0;
+    events.forEach((ev, i) => {
+        const eventNum = String(i + 1).padStart(3, "0");
+        const reel = padReel(ev.reel);
+        const track = padTrack(ev.track);
+        const dur = ev.sourceOutFrame - ev.sourceInFrame;
+        if (dur <= 0) {
+            throw new Error(`event ${i + 1}: sourceOutFrame must be > sourceInFrame`);
+        }
+        const srcIn = framesToTimecode(ev.sourceInFrame, frameRate);
+        const srcOut = framesToTimecode(ev.sourceOutFrame, frameRate);
+        const recIn = framesToTimecode(recordCursor, frameRate);
+        const recOut = framesToTimecode(recordCursor + dur, frameRate);
+        recordCursor += dur;
+        lines.push(`${eventNum}  ${reel}  ${track}  C        ${srcIn} ${srcOut} ${recIn} ${recOut}`);
+        if (ev.clipName) {
+            lines.push(`* FROM CLIP NAME: ${sanitize(ev.clipName, 80)}`);
+        }
+    });
+    // Trailing newline — some parsers require it.
+    return lines.join("\n") + "\n";
+}
+/**
+ * Total record-side duration of an EDL in frames. Useful for the agent to
+ * verify the rebuild matches its plan.
+ */
+export function totalRecordFrames(events) {
+    return events.reduce((sum, ev) => sum + (ev.sourceOutFrame - ev.sourceInFrame), 0);
+}
+// ── Helpers ─────────────────────────────────────────────────
+function padReel(reel) {
+    // CMX 3600 reel field is 8 chars wide. Most modern NLEs accept longer reels
+    // with a free-form column, but we stay strict for max compatibility.
+    const r = reel.replace(/\s+/g, "_").slice(0, 8);
+    return r.padEnd(8, " ");
+}
+function padTrack(track) {
+    // 5-char column.
+    return track.padEnd(5, " ");
+}
+function sanitize(s, max) {
+    return s.replace(/[\r\n]+/g, " ").slice(0, max);
+}
+//# sourceMappingURL=edl.js.map

package/dist/core/edl.js.map

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

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

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

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

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

package/dist/core/edl.test.js

@@ -0,0 +1,62 @@
+import { describe, expect, it } from "vitest";
+import { buildEdl, totalRecordFrames } from "./edl.js";
+describe("buildEdl", () => {
+    it("emits a valid CMX 3600 header", () => {
+        const out = buildEdl({ title: "Test", frameRate: 30, events: [] });
+        expect(out).toContain("TITLE: Test");
+        expect(out).toContain("FCM: NON-DROP FRAME");
+    });
+    it("places events contiguously on the record timeline", () => {
+        const out = buildEdl({
+            title: "T",
+            frameRate: 30,
+            events: [
+                { reel: "src1", track: "V", sourceInFrame: 0, sourceOutFrame: 30 },
+                { reel: "src1", track: "V", sourceInFrame: 90, sourceOutFrame: 120 },
+            ],
+        });
+        // Event 1: src 00:00:00:00 → 00:00:01:00, rec 00:00:00:00 → 00:00:01:00
+        expect(out).toContain("001  src1      V      C        00:00:00:00 00:00:01:00 00:00:00:00 00:00:01:00");
+        // Event 2: src 00:00:03:00 → 00:00:04:00, rec 00:00:01:00 → 00:00:02:00 (continues from prev)
+        expect(out).toContain("002  src1      V      C        00:00:03:00 00:00:04:00 00:00:01:00 00:00:02:00");
+    });
+    it("writes clip name comments", () => {
+        const out = buildEdl({
+            title: "T",
+            frameRate: 30,
+            events: [
+                { reel: "src1", track: "V", sourceInFrame: 0, sourceOutFrame: 30, clipName: "hello.mp4" },
+            ],
+        });
+        expect(out).toContain("* FROM CLIP NAME: hello.mp4");
+    });
+    it("rejects zero or negative durations", () => {
+        expect(() => buildEdl({
+            title: "T",
+            frameRate: 30,
+            events: [{ reel: "src1", track: "V", sourceInFrame: 30, sourceOutFrame: 30 }],
+        })).toThrow(/must be > sourceInFrame/);
+    });
+    it("truncates reel to 8 chars and replaces whitespace", () => {
+        const out = buildEdl({
+            title: "T",
+            frameRate: 30,
+            events: [{ reel: "my source clip", track: "V", sourceInFrame: 0, sourceOutFrame: 30 }],
+        });
+        // "my_sourc" — 8 chars, underscores
+        expect(out).toMatch(/001 {2}my_sourc/);
+    });
+    it("supports drop-frame timecode flag", () => {
+        const out = buildEdl({ title: "T", frameRate: 29.97, events: [], dropFrame: true });
+        expect(out).toContain("FCM: DROP FRAME");
+    });
+});
+describe("totalRecordFrames", () => {
+    it("sums per-event durations", () => {
+        expect(totalRecordFrames([
+            { reel: "a", track: "V", sourceInFrame: 0, sourceOutFrame: 30 },
+            { reel: "a", track: "V", sourceInFrame: 100, sourceOutFrame: 200 },
+        ])).toBe(130);
+    });
+});
+//# sourceMappingURL=edl.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"edl.test.js","sourceRoot":"","sources":["../../src/core/edl.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAEvD,QAAQ,CAAC,UAAU,EAAE,GAAG,EAAE;IACxB,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,GAAG,GAAG,QAAQ,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;QACnE,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;QACrC,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,qBAAqB,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,MAAM,GAAG,GAAG,QAAQ,CAAC;YACnB,KAAK,EAAE,GAAG;YACV,SAAS,EAAE,EAAE;YACb,MAAM,EAAE;gBACN,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,aAAa,EAAE,CAAC,EAAE,cAAc,EAAE,EAAE,EAAE;gBAClE,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,aAAa,EAAE,EAAE,EAAE,cAAc,EAAE,GAAG,EAAE;aACrE;SACF,CAAC,CAAC;QACH,wEAAwE;QACxE,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CACnB,gFAAgF,CACjF,CAAC;QACF,8FAA8F;QAC9F,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CACnB,gFAAgF,CACjF,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACnC,MAAM,GAAG,GAAG,QAAQ,CAAC;YACnB,KAAK,EAAE,GAAG;YACV,SAAS,EAAE,EAAE;YACb,MAAM,EAAE;gBACN,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,aAAa,EAAE,CAAC,EAAE,cAAc,EAAE,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE;aAC1F;SACF,CAAC,CAAC;QACH,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,6BAA6B,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,MAAM,CAAC,GAAG,EAAE,CACV,QAAQ,CAAC;YACP,KAAK,EAAE,GAAG;YACV,SAAS,EAAE,EAAE;YACb,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,aAAa,EAAE,EAAE,EAAE,cAAc,EAAE,EAAE,EAAE,CAAC;SAC9E,CAAC,CACH,CAAC,OAAO,CAAC,yBAAyB,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,MAAM,GAAG,GAAG,QAAQ,CAAC;YACnB,KAAK,EAAE,GAAG;YACV,SAAS,EAAE,EAAE;YACb,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE,GAAG,EAAE,aAAa,EAAE,CAAC,EAAE,cAAc,EAAE,EAAE,EAAE,CAAC;SACvF,CAAC,CAAC;QACH,oCAAoC;QACpC,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,GAAG,GAAG,QAAQ,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACpF,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IACjC,EAAE,CAAC,0BAA0B,EAAE,GAAG,EAAE;QAClC,MAAM,CACJ,iBAAiB,CAAC;YAChB,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,aAAa,EAAE,CAAC,EAAE,cAAc,EAAE,EAAE,EAAE;YAC/D,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,aAAa,EAAE,GAAG,EAAE,cAAc,EAAE,GAAG,EAAE;SACnE,CAAC,CACH,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/core/envelope-sync.d.ts

@@ -0,0 +1,52 @@
+export interface EnvelopeResult {
+    path: string;
+    envelope: Float64Array;
+    /** Total file duration in seconds. */
+    durationSec: number;
+}
+export interface EnvelopeSyncOptions {
+    /** Search window in seconds. Larger = finds bigger drifts but slower. Default 10. */
+    maxLagSec?: number;
+    signal?: AbortSignal;
+}
+export interface EnvelopeSyncResult {
+    reference: string;
+    results: Array<{
+        path: string;
+        /** Positive = file starts later than reference. */
+        offsetSec: number;
+        /** 0..1 normalised correlation strength at the chosen lag. */
+        confidence: number;
+    }>;
+    /** Set when ANY pair correlated below 0.3 (low-confidence alignment). */
+    warning?: string;
+}
+/**
+ * Extract a mono 16kHz RMS energy envelope. One value every 100ms.
+ */
+export declare function extractEnvelope(inputPath: string, opts?: {
+    signal?: AbortSignal;
+}): Promise<EnvelopeResult>;
+/**
+ * Find the lag (in blocks) at which envelope `a` best aligns with envelope `b`.
+ * Searches ±maxLagBlocks. Returns peak lag and normalised Pearson correlation.
+ *
+ * Convention: maximises sum(a[i - lag] * b[i]). So:
+ *   - Positive lag = `a` LEADS `b` (a's peaks happen at smaller indices than b's)
+ *   - Negative lag = `a` TRAILS `b` (a's peaks happen at larger indices)
+ *
+ * Callers convert this to a wall-clock offset:
+ *   offsetSec = -lagBlocks * blockSec
+ * (positive offset = `a` started later than `b`).
+ */
+export declare function correlateEnvelopes(a: Float64Array, b: Float64Array, maxLagBlocks: number): {
+    lagBlocks: number;
+    correlation: number;
+};
+/**
+ * Align 2+ inputs using envelope correlation. Reference is the first input.
+ * For each non-reference input, compute the correlation lag and report the
+ * offset in seconds.
+ */
+export declare function envelopeSync(inputPaths: string[], opts?: EnvelopeSyncOptions): Promise<EnvelopeSyncResult>;
+//# sourceMappingURL=envelope-sync.d.ts.map

package/dist/core/envelope-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelope-sync.d.ts","sourceRoot":"","sources":["../../src/core/envelope-sync.ts"],"names":[],"mappings":"AA4BA,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,YAAY,CAAC;IACvB,sCAAsC;IACtC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,qFAAqF;IACrF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,mDAAmD;QACnD,SAAS,EAAE,MAAM,CAAC;QAClB,8DAA8D;QAC9D,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC,CAAC;IACH,yEAAyE;IACzE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE;IAAE,MAAM,CAAC,EAAE,WAAW,CAAA;CAAO,GAClC,OAAO,CAAC,cAAc,CAAC,CA8DzB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAChC,CAAC,EAAE,YAAY,EACf,CAAC,EAAE,YAAY,EACf,YAAY,EAAE,MAAM,GACnB;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CA4B5C;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,UAAU,EAAE,MAAM,EAAE,EACpB,IAAI,GAAE,mBAAwB,GAC7B,OAAO,CAAC,kBAAkB,CAAC,CAsC7B"}

package/dist/core/envelope-sync.js

@@ -0,0 +1,169 @@
+/**
+ * Envelope-based cross-correlation for multicam alignment.
+ *
+ * Why not full FFT correlation? For editorial alignment we don't need
+ * sub-millisecond precision — we need "the speaker says hello at t=2.4 here
+ * and t=3.1 there, so file B leads A by 0.7s". The energy envelope (RMS in
+ * 100ms blocks) is sufficient and far cheaper than full PCM correlation.
+ *
+ * Pipeline:
+ *   1. ffmpeg extracts mono 16kHz PCM s16le to a temp file
+ *   2. We read PCM as Int16Array, compute per-block RMS → Float64 envelope
+ *   3. Time-domain cross-correlation against a reference within ±maxLagSec
+ *   4. Peak position → lag in blocks → seconds
+ *
+ * This is the approach used by tools like PluralEyes for non-slate sync. It
+ * works on dialogue, applause, music — anything with energy variation. It
+ * fails on sustained tones (test patterns, drone) because there's no
+ * envelope to correlate against.
+ */
+import { spawn } from "node:child_process";
+import { mkdtempSync, readFileSync, statSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+const SAMPLE_RATE = 16000;
+const BLOCK_MS = 100;
+const SAMPLES_PER_BLOCK = (SAMPLE_RATE * BLOCK_MS) / 1000; // 1600
+/**
+ * Extract a mono 16kHz RMS energy envelope. One value every 100ms.
+ */
+export async function extractEnvelope(inputPath, opts = {}) {
+    const dir = mkdtempSync(join(tmpdir(), "gg-editor-env-"));
+    const pcmPath = join(dir, "audio.pcm");
+    await new Promise((resolve, reject) => {
+        const child = spawn("ffmpeg", [
+            "-hide_banner",
+            "-y",
+            "-i",
+            inputPath,
+            "-f",
+            "s16le",
+            "-ac",
+            "1",
+            "-ar",
+            String(SAMPLE_RATE),
+            pcmPath,
+        ], { stdio: ["ignore", "pipe", "pipe"] });
+        let stderr = "";
+        child.stderr.on("data", (d) => (stderr += d.toString()));
+        opts.signal?.addEventListener("abort", () => child.kill("SIGTERM"));
+        child.on("error", reject);
+        child.on("close", (code) => code === 0
+            ? resolve()
+            : reject(new Error(`ffmpeg PCM extract exited ${code}: ${stderr.slice(-300)}`)));
+    });
+    const buf = readFileSync(pcmPath);
+    const samples = new Int16Array(buf.buffer, buf.byteOffset, Math.floor(buf.byteLength / 2));
+    const numBlocks = Math.floor(samples.length / SAMPLES_PER_BLOCK);
+    const env = new Float64Array(numBlocks);
+    for (let b = 0; b < numBlocks; b++) {
+        let sumSq = 0;
+        const off = b * SAMPLES_PER_BLOCK;
+        for (let i = 0; i < SAMPLES_PER_BLOCK; i++) {
+            const s = samples[off + i] / 32768;
+            sumSq += s * s;
+        }
+        env[b] = Math.sqrt(sumSq / SAMPLES_PER_BLOCK);
+    }
+    // Normalize so different gain levels don't bias the correlation.
+    let max = 0;
+    for (let i = 0; i < env.length; i++)
+        if (env[i] > max)
+            max = env[i];
+    if (max > 0) {
+        for (let i = 0; i < env.length; i++)
+            env[i] /= max;
+    }
+    // Clean up the PCM file. The dir survives until process exit.
+    try {
+        statSync(pcmPath);
+    }
+    catch {
+        /* */
+    }
+    return {
+        path: inputPath,
+        envelope: env,
+        durationSec: samples.length / SAMPLE_RATE,
+    };
+}
+/**
+ * Find the lag (in blocks) at which envelope `a` best aligns with envelope `b`.
+ * Searches ±maxLagBlocks. Returns peak lag and normalised Pearson correlation.
+ *
+ * Convention: maximises sum(a[i - lag] * b[i]). So:
+ *   - Positive lag = `a` LEADS `b` (a's peaks happen at smaller indices than b's)
+ *   - Negative lag = `a` TRAILS `b` (a's peaks happen at larger indices)
+ *
+ * Callers convert this to a wall-clock offset:
+ *   offsetSec = -lagBlocks * blockSec
+ * (positive offset = `a` started later than `b`).
+ */
+export function correlateEnvelopes(a, b, maxLagBlocks) {
+    let bestLag = 0;
+    let bestCorr = -Infinity;
+    for (let lag = -maxLagBlocks; lag <= maxLagBlocks; lag++) {
+        // a is shifted by `lag`; compare against b.
+        // Iterate over indices i where both a[i - lag] and b[i] exist.
+        const start = Math.max(0, lag);
+        const end = Math.min(b.length, a.length + lag);
+        if (end - start < 4)
+            continue;
+        let sumAB = 0;
+        let sumAA = 0;
+        let sumBB = 0;
+        for (let i = start; i < end; i++) {
+            const av = a[i - lag];
+            const bv = b[i];
+            sumAB += av * bv;
+            sumAA += av * av;
+            sumBB += bv * bv;
+        }
+        const denom = Math.sqrt(sumAA * sumBB);
+        const corr = denom > 0 ? sumAB / denom : 0;
+        if (corr > bestCorr) {
+            bestCorr = corr;
+            bestLag = lag;
+        }
+    }
+    return { lagBlocks: bestLag, correlation: bestCorr };
+}
+/**
+ * Align 2+ inputs using envelope correlation. Reference is the first input.
+ * For each non-reference input, compute the correlation lag and report the
+ * offset in seconds.
+ */
+export async function envelopeSync(inputPaths, opts = {}) {
+    if (inputPaths.length === 0) {
+        throw new Error("envelopeSync: inputs is empty");
+    }
+    const maxLagSec = opts.maxLagSec ?? 10;
+    const maxLagBlocks = Math.round((maxLagSec * 1000) / BLOCK_MS);
+    const envs = await Promise.all(inputPaths.map((p) => extractEnvelope(p, { signal: opts.signal })));
+    const ref = envs[0];
+    const results = [{ path: ref.path, offsetSec: 0, confidence: 1 }];
+    let lowConfidence = 0;
+    for (let i = 1; i < envs.length; i++) {
+        const e = envs[i];
+        const { lagBlocks, correlation } = correlateEnvelopes(e.envelope, ref.envelope, maxLagBlocks);
+        // lagBlocks > 0 means we shifted e RIGHT to match ref → e starts EARLIER
+        // than ref → its offset relative to ref is NEGATIVE.
+        const offsetSec = -lagBlocks * (BLOCK_MS / 1000);
+        const confidence = Math.max(0, correlation);
+        if (confidence < 0.3)
+            lowConfidence += 1;
+        results.push({
+            path: e.path,
+            offsetSec: +offsetSec.toFixed(3),
+            confidence: +confidence.toFixed(3),
+        });
+    }
+    return {
+        reference: ref.path,
+        results,
+        warning: lowConfidence > 0
+            ? `${lowConfidence} of ${results.length - 1} pair(s) correlated below 0.3 \u2014 alignment uncertain`
+            : undefined,
+    };
+}
+//# sourceMappingURL=envelope-sync.js.map

package/dist/core/envelope-sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelope-sync.js","sourceRoot":"","sources":["../../src/core/envelope-sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC9D,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,WAAW,GAAG,KAAK,CAAC;AAC1B,MAAM,QAAQ,GAAG,GAAG,CAAC;AACrB,MAAM,iBAAiB,GAAG,CAAC,WAAW,GAAG,QAAQ,CAAC,GAAG,IAAI,CAAC,CAAC,OAAO;AA4BlE;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,SAAiB,EACjB,OAAiC,EAAE;IAEnC,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,gBAAgB,CAAC,CAAC,CAAC;IAC1D,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;IACvC,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC1C,MAAM,KAAK,GAAG,KAAK,CACjB,QAAQ,EACR;YACE,cAAc;YACd,IAAI;YACJ,IAAI;YACJ,SAAS;YACT,IAAI;YACJ,OAAO;YACP,KAAK;YACL,GAAG;YACH,KAAK;YACL,MAAM,CAAC,WAAW,CAAC;YACnB,OAAO;SACR,EACD,EAAE,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CACtC,CAAC;QACF,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;QACzD,IAAI,CAAC,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;QACpE,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC1B,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CACzB,IAAI,KAAK,CAAC;YACR,CAAC,CAAC,OAAO,EAAE;YACX,CAAC,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,6BAA6B,IAAI,KAAK,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAClF,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,MAAM,GAAG,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IAClC,MAAM,OAAO,GAAG,IAAI,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC;IAC3F,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,iBAAiB,CAAC,CAAC;IACjE,MAAM,GAAG,GAAG,IAAI,YAAY,CAAC,SAAS,CAAC,CAAC;IACxC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,EAAE,CAAC,EAAE,EAAE,CAAC;QACnC,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,MAAM,GAAG,GAAG,CAAC,GAAG,iBAAiB,CAAC;QAClC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,iBAAiB,EAAE,CAAC,EAAE,EAAE,CAAC;YAC3C,MAAM,CAAC,GAAG,OAAO,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC;YACnC,KAAK,IAAI,CAAC,GAAG,CAAC,CAAC;QACjB,CAAC;QACD,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,iBAAiB,CAAC,CAAC;IAChD,CAAC;IACD,iEAAiE;IACjE,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE;QAAE,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG;YAAE,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;IACpE,IAAI,GAAG,GAAG,CAAC,EAAE,CAAC;QACZ,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE;YAAE,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC;IACrD,CAAC;IACD,8DAA8D;IAC9D,IAAI,CAAC;QACH,QAAQ,CAAC,OAAO,CAAC,CAAC;IACpB,CAAC;IAAC,MAAM,CAAC;QACP,KAAK;IACP,CAAC;IACD,OAAO;QACL,IAAI,EAAE,SAAS;QACf,QAAQ,EAAE,GAAG;QACb,WAAW,EAAE,OAAO,CAAC,MAAM,GAAG,WAAW;KAC1C,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,kBAAkB,CAChC,CAAe,EACf,CAAe,EACf,YAAoB;IAEpB,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,QAAQ,GAAG,CAAC,QAAQ,CAAC;IAEzB,KAAK,IAAI,GAAG,GAAG,CAAC,YAAY,EAAE,GAAG,IAAI,YAAY,EAAE,GAAG,EAAE,EAAE,CAAC;QACzD,4CAA4C;QAC5C,+DAA+D;QAC/D,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QAC/B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC;QAC/C,IAAI,GAAG,GAAG,KAAK,GAAG,CAAC;YAAE,SAAS;QAC9B,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,KAAK,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;YACjC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;YACtB,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YAChB,KAAK,IAAI,EAAE,GAAG,EAAE,CAAC;YACjB,KAAK,IAAI,EAAE,GAAG,EAAE,CAAC;YACjB,KAAK,IAAI,EAAE,GAAG,EAAE,CAAC;QACnB,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC;QACvC,MAAM,IAAI,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3C,IAAI,IAAI,GAAG,QAAQ,EAAE,CAAC;YACpB,QAAQ,GAAG,IAAI,CAAC;YAChB,OAAO,GAAG,GAAG,CAAC;QAChB,CAAC;IACH,CAAC;IACD,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC;AACvD,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,UAAoB,EACpB,OAA4B,EAAE;IAE9B,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;IACnD,CAAC;IACD,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC;IACvC,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAC;IAE/D,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,GAAG,CAC5B,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CACnE,CAAC;IACF,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAEpB,MAAM,OAAO,GAAkC,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC,CAAC;IAEjG,IAAI,aAAa,GAAG,CAAC,CAAC;IACtB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,GAAG,kBAAkB,CAAC,CAAC,CAAC,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;QAC9F,yEAAyE;QACzE,qDAAqD;QACrD,MAAM,SAAS,GAAG,CAAC,SAAS,GAAG,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;QACjD,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;QAC5C,IAAI,UAAU,GAAG,GAAG;YAAE,aAAa,IAAI,CAAC,CAAC;QACzC,OAAO,CAAC,IAAI,CAAC;YACX,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,SAAS,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;YAChC,UAAU,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;SACnC,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,SAAS,EAAE,GAAG,CAAC,IAAI;QACnB,OAAO;QACP,OAAO,EACL,aAAa,GAAG,CAAC;YACf,CAAC,CAAC,GAAG,aAAa,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,0DAA0D;YACrG,CAAC,CAAC,SAAS;KAChB,CAAC;AACJ,CAAC"}

package/dist/core/envelope-sync.test.d.ts

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

package/dist/core/envelope-sync.test.d.ts.map

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