@kenkaiiii/gg-editor 0.1.0

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

@@ -0,0 +1,70 @@
+import { describe, expect, it } from "vitest";
+import { correlateEnvelopes } from "./envelope-sync.js";
+/**
+ * Pure-math tests for the correlator. The full envelope pipeline needs ffmpeg
+ * + real audio; the correlator itself is testable in isolation.
+ */
+function buildEnvelope(events, length) {
+    const out = new Float64Array(length);
+    for (const [pos, amp] of events)
+        out[pos] = amp;
+    return out;
+}
+describe("correlateEnvelopes", () => {
+    it("identical envelopes correlate at lag 0 with correlation ~1", () => {
+        const e = buildEnvelope([
+            [10, 1],
+            [20, 0.5],
+            [30, 0.8],
+        ], 60);
+        const r = correlateEnvelopes(e, e, 30);
+        expect(r.lagBlocks).toBe(0);
+        expect(r.correlation).toBeCloseTo(1, 3);
+    });
+    it("a trails b (peaks at later indices) → NEGATIVE lag", () => {
+        // b's peaks at 0, 2 (early in b's timeline)
+        // a's peaks at 3, 5 (late in a's timeline) — a trails b by 3.
+        const b = buildEnvelope([
+            [0, 1],
+            [2, 1],
+        ], 10);
+        const a = buildEnvelope([
+            [3, 1],
+            [5, 1],
+        ], 10);
+        const r = correlateEnvelopes(a, b, 5);
+        expect(r.lagBlocks).toBe(-3);
+        expect(r.correlation).toBeGreaterThan(0.99);
+        // Wall-clock: offsetSec = -lagBlocks * blockSec → positive → a started LATER. ✓
+    });
+    it("a leads b (peaks at earlier indices) → POSITIVE lag", () => {
+        const b = buildEnvelope([
+            [5, 1],
+            [7, 1],
+        ], 12);
+        const a = buildEnvelope([
+            [2, 1],
+            [4, 1],
+        ], 12);
+        const r = correlateEnvelopes(a, b, 5);
+        expect(r.lagBlocks).toBe(3);
+    });
+    it("uncorrelated envelopes return low correlation", () => {
+        // pure random-like signals
+        const a = new Float64Array(100);
+        const b = new Float64Array(100);
+        for (let i = 0; i < 100; i++) {
+            a[i] = Math.sin(i * 0.4);
+            b[i] = Math.cos(i * 0.7);
+        }
+        const r = correlateEnvelopes(a, b, 10);
+        expect(Math.abs(r.correlation)).toBeLessThan(0.7);
+    });
+    it("respects maxLag cap (won't return a lag outside the search range)", () => {
+        const b = buildEnvelope([[0, 1]], 50);
+        const a = buildEnvelope([[20, 1]], 50);
+        const r = correlateEnvelopes(a, b, 5);
+        expect(Math.abs(r.lagBlocks)).toBeLessThanOrEqual(5);
+    });
+});
+//# sourceMappingURL=envelope-sync.test.js.map

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

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

package/dist/core/fcpxml-roundtrip.test.d.ts

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

package/dist/core/fcpxml-roundtrip.test.d.ts.map

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

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

@@ -0,0 +1,251 @@
+/**
+ * Round-trip golden tests for the FCPXML emitter.
+ *
+ * Like the EDL counterpart: targeted regex extraction of asset-clip elements
+ * + numeric verification of `start` / `duration` / `offset` attributes.
+ *
+ * These guard against silent drift in time-rational construction
+ * (e.g. accidentally swapping num/den in 29.97 or 23.976 fractions).
+ */
+import { describe, expect, it } from "vitest";
+import { buildFcpxml } from "./fcpxml.js";
+function parseAssetClips(xml) {
+    const out = [];
+    const re = /<asset-clip\b([^>]*)\/?>/g;
+    for (const m of xml.matchAll(re)) {
+        const attrs = m[1];
+        const ref = /ref="([^"]+)"/.exec(attrs)?.[1] ?? "";
+        const name = /name="([^"]+)"/.exec(attrs)?.[1] ?? "";
+        const offset = /offset="([^"]+)"/.exec(attrs)?.[1] ?? "";
+        const start = /start="([^"]+)"/.exec(attrs)?.[1];
+        const duration = /duration="([^"]+)"/.exec(attrs)?.[1] ?? "";
+        out.push({ ref, name, offset, start, duration });
+    }
+    return out;
+}
+function parseAssets(xml) {
+    const out = [];
+    // <asset ...> but not <asset-clip ...>
+    const re = /<asset(?![-\w])([^>]*?)\/?>/g;
+    for (const m of xml.matchAll(re)) {
+        const attrs = m[1];
+        const id = /id="([^"]+)"/.exec(attrs)?.[1] ?? "";
+        const src = /src="([^"]+)"/.exec(attrs)?.[1] ?? "";
+        const hasAudio = /hasAudio="([^"]+)"/.exec(attrs)?.[1] ?? "";
+        out.push({ id, src, hasAudio });
+    }
+    return out;
+}
+/** Parse "Ns" or "N/Ds" into a number of seconds. */
+function timeToSec(t) {
+    if (t === "0s" || t === "0")
+        return 0;
+    const m = /^([0-9]+)(?:\/([0-9]+))?s?$/.exec(t);
+    if (!m)
+        throw new Error(`unrecognised time literal: ${t}`);
+    const num = Number(m[1]);
+    const den = m[2] ? Number(m[2]) : 1;
+    return num / den;
+}
+describe("FCPXML round-trip", () => {
+    it("emits one asset per unique reel", () => {
+        const events = [
+            { reel: "A", sourcePath: "/a.mov", sourceInFrame: 0, sourceOutFrame: 60 },
+            { reel: "B", sourcePath: "/b.mov", sourceInFrame: 0, sourceOutFrame: 60 },
+            { reel: "A", sourcePath: "/a.mov", sourceInFrame: 200, sourceOutFrame: 250 },
+        ];
+        const xml = buildFcpxml({ title: "t", frameRate: 30, events });
+        const assets = parseAssets(xml);
+        expect(assets).toHaveLength(2);
+        expect(assets.find((a) => a.src.endsWith("/a.mov"))).toBeDefined();
+        expect(assets.find((a) => a.src.endsWith("/b.mov"))).toBeDefined();
+    });
+    it("places clips contiguously by offset (record timeline)", () => {
+        const events = [
+            { reel: "A", sourcePath: "/a.mov", sourceInFrame: 0, sourceOutFrame: 60 },
+            { reel: "B", sourcePath: "/b.mov", sourceInFrame: 0, sourceOutFrame: 90 },
+            { reel: "A", sourcePath: "/a.mov", sourceInFrame: 0, sourceOutFrame: 30 },
+        ];
+        const xml = buildFcpxml({ title: "t", frameRate: 30, events });
+        const clips = parseAssetClips(xml);
+        expect(clips).toHaveLength(3);
+        // offsets: 0, 60/30=2s, (60+90)/30=5s
+        expect(timeToSec(clips[0].offset)).toBeCloseTo(0);
+        expect(timeToSec(clips[1].offset)).toBeCloseTo(2);
+        expect(timeToSec(clips[2].offset)).toBeCloseTo(5);
+    });
+    it("durations come from sourceOut - sourceIn", () => {
+        const events = [
+            { reel: "A", sourcePath: "/a.mov", sourceInFrame: 30, sourceOutFrame: 90 },
+        ];
+        const xml = buildFcpxml({ title: "t", frameRate: 30, events });
+        const clips = parseAssetClips(xml);
+        expect(timeToSec(clips[0].duration)).toBeCloseTo(60 / 30);
+    });
+    it("uses NTSC fractions for 29.97 frame rate", () => {
+        const events = [
+            { reel: "A", sourcePath: "/a.mov", sourceInFrame: 0, sourceOutFrame: 30 },
+        ];
+        const xml = buildFcpxml({ title: "t", frameRate: 29.97, events });
+        // 30 frames at 30000/1001 fps = 30 * 1001/30000 s = 1001/1000 s
+        const clips = parseAssetClips(xml);
+        // Ratio should approximate 1.001 seconds
+        expect(timeToSec(clips[0].duration)).toBeCloseTo(1.001, 3);
+    });
+    it("uses NTSC fractions for 23.976 frame rate", () => {
+        const events = [
+            { reel: "A", sourcePath: "/a.mov", sourceInFrame: 0, sourceOutFrame: 24 },
+        ];
+        const xml = buildFcpxml({ title: "t", frameRate: 23.976, events });
+        const clips = parseAssetClips(xml);
+        // 24 frames at 24000/1001 = 24 * 1001/24000 s = 1.001s
+        expect(timeToSec(clips[0].duration)).toBeCloseTo(1.001, 3);
+    });
+    it("each clip references a real asset id", () => {
+        const events = [
+            { reel: "X", sourcePath: "/x.mov", sourceInFrame: 0, sourceOutFrame: 30 },
+            { reel: "Y", sourcePath: "/y.mov", sourceInFrame: 0, sourceOutFrame: 30 },
+        ];
+        const xml = buildFcpxml({ title: "t", frameRate: 30, events });
+        const assets = parseAssets(xml);
+        const clips = parseAssetClips(xml);
+        const assetIds = new Set(assets.map((a) => a.id));
+        for (const c of clips) {
+            expect(assetIds.has(c.ref)).toBe(true);
+        }
+    });
+    it("emits standard audio metadata on every asset (real-world Resolve/Premiere export shape)", () => {
+        // Audio routing in Resolve / Premiere relies on hasAudio + audioSources +
+        // audioChannels + audioRate. Real-world fixtures from BBC fcpx-xml-composer,
+        // DozaVisuals, and the Apple FCPXML 1.10 sample all include these.
+        const events = [
+            { reel: "A", sourcePath: "/a.mov", sourceInFrame: 0, sourceOutFrame: 60 },
+        ];
+        const xml = buildFcpxml({ title: "t", frameRate: 30, events });
+        expect(xml).toContain('hasVideo="1"');
+        expect(xml).toContain('videoSources="1"');
+        expect(xml).toContain('hasAudio="1"');
+        expect(xml).toContain('audioSources="1"');
+        expect(xml).toContain('audioChannels="2"');
+        expect(xml).toContain('audioRate="48000"');
+    });
+    it("honours custom audioChannels / audioRate overrides", () => {
+        const xml = buildFcpxml({
+            title: "t",
+            frameRate: 30,
+            events: [{ reel: "A", sourcePath: "/a.mov", sourceInFrame: 0, sourceOutFrame: 30 }],
+            audioChannels: 1,
+            audioRate: 44100,
+        });
+        expect(xml).toContain('audioChannels="1"');
+        expect(xml).toContain('audioRate="44100"');
+    });
+    it("preserves clip names when supplied", () => {
+        const events = [
+            {
+                reel: "A",
+                sourcePath: "/a.mov",
+                sourceInFrame: 0,
+                sourceOutFrame: 30,
+                clipName: "intro_take_3",
+            },
+        ];
+        const xml = buildFcpxml({ title: "t", frameRate: 30, events });
+        const clips = parseAssetClips(xml);
+        // FCPXML emitter appends a sequence index to the clip name to keep them
+        // unique across the spine; check the prefix.
+        expect(clips[0].name.startsWith("intro_take_3")).toBe(true);
+    });
+});
+describe("FCPXML round-trip — transform / keyframes / lane / title", () => {
+    it('emits both <adjust-transform> and <param name="position"> for a keyframed clip', () => {
+        const events = [
+            {
+                reel: "A",
+                sourcePath: "/a.mov",
+                sourceInFrame: 0,
+                sourceOutFrame: 60,
+                transform: {
+                    position: {
+                        keyframes: [
+                            { frame: 0, value: [0, 0] },
+                            { frame: 60, value: [200, 0] },
+                        ],
+                    },
+                },
+            },
+        ];
+        const xml = buildFcpxml({ title: "t", frameRate: 30, events });
+        expect(xml).toContain("<adjust-transform");
+        expect(xml).toContain('<param name="position">');
+        // Two keyframes, no interp on either (position rule).
+        const kfs = [...xml.matchAll(/<keyframe time="([^"]+)" value="([^"]+)"\s*\/>/g)];
+        expect(kfs.length).toBeGreaterThanOrEqual(2);
+        // Position values should be the literal x y pairs we asked for.
+        expect(kfs.find((m) => m[2] === "0 0")).toBeDefined();
+        expect(kfs.find((m) => m[2] === "200 0")).toBeDefined();
+    });
+    it('emits <filter-audio>/<param name="gain"> with linear interp for volume ramps', () => {
+        const events = [
+            {
+                reel: "A",
+                sourcePath: "/a.mov",
+                sourceInFrame: 0,
+                sourceOutFrame: 60,
+                volumeDb: {
+                    keyframes: [
+                        { frame: 0, value: -60 },
+                        { frame: 30, value: 0 },
+                        { frame: 60, value: -60 },
+                    ],
+                },
+            },
+        ];
+        const xml = buildFcpxml({ title: "t", frameRate: 30, events });
+        expect(xml).toContain('<filter-audio name="Volume">');
+        // Every gain keyframe carries interp (NOT skipped like position).
+        const gainKfs = [
+            ...xml.matchAll(/<keyframe time="[^"]+" value="-?\d+(\.\d+)?" interp="[^"]+" \/>/g),
+        ];
+        expect(gainKfs.length).toBeGreaterThanOrEqual(3);
+    });
+    it("places lane clips at absolute offsets without disturbing the spine cursor", () => {
+        const events = [
+            { reel: "A", sourcePath: "/a.mov", sourceInFrame: 0, sourceOutFrame: 90 },
+            {
+                reel: "B",
+                sourcePath: "/b.mov",
+                sourceInFrame: 0,
+                sourceOutFrame: 30,
+                lane: 1,
+                recordOffsetFrame: 30,
+            },
+            { reel: "A", sourcePath: "/a.mov", sourceInFrame: 90, sourceOutFrame: 150 },
+        ];
+        const xml = buildFcpxml({ title: "t", frameRate: 30, events });
+        const clips = parseAssetClips(xml);
+        // 3 clips total; the spine clips advance the cursor (90 frames + 60 = 5s),
+        // and the lane clip sits at 1s without touching the cursor.
+        expect(clips).toHaveLength(3);
+        const spineOffsets = clips.filter((_, i) => i !== 1).map((c) => timeToSec(c.offset));
+        expect(spineOffsets[0]).toBeCloseTo(0);
+        expect(spineOffsets[1]).toBeCloseTo(3); // 90/30
+    });
+    it("emits a Basic Title effect resource exactly once when multiple titles share it", () => {
+        const xml = buildFcpxml({
+            title: "t",
+            frameRate: 30,
+            events: [{ reel: "A", sourcePath: "/a.mov", sourceInFrame: 0, sourceOutFrame: 60 }],
+            titles: [
+                { text: "One", startFrame: 0, durationFrames: 30 },
+                { text: "Two", startFrame: 30, durationFrames: 30 },
+            ],
+        });
+        const titleEffectMatches = [...xml.matchAll(/name="Basic Title"/g)];
+        // The resource is emitted once; the two <title> elements reference it.
+        const titleElementMatches = [...xml.matchAll(/<title ref="/g)];
+        expect(titleEffectMatches.length).toBe(1);
+        expect(titleElementMatches.length).toBe(2);
+    });
+});
+//# sourceMappingURL=fcpxml-roundtrip.test.js.map

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

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

package/dist/core/fcpxml.d.ts

@@ -0,0 +1,172 @@
+/**
+ * FCPXML 1.10 emitter.
+ *
+ * FCPXML preserves what EDL drops:
+ *   - Per-clip names (not just reel comments)
+ *   - Frame-rational time (no rounding loss for 23.976/29.97/59.94)
+ *   - Multi-source media in one timeline
+ *   - Color/audio metadata can be added later as extensions
+ *
+ * Premiere Pro imports FCPXML natively as a Sequence. DaVinci Resolve
+ * imports it as a Timeline. Both treat it as the "richer" interchange
+ * compared to EDL, which is why we expose write_fcpxml as the preferred
+ * format for Premiere and an alternative for Resolve.
+ *
+ * v2 scope:
+ *   - One or more source assets (each unique `reel` becomes an asset)
+ *   - Multi-track / multi-lane composition (lane="N" on asset-clip)
+ *   - <adjust-transform> with static OR keyframed position/scale/rotation/anchor
+ *   - <param name="opacity"> + <keyframeAnimation> for fade ramps
+ *   - <filter-audio name="Volume"> + <param name="gain"> + <keyframe> for
+ *     audio gain ramps
+ *   - <title> elements (Basic Title effect ref) with <text-style-def>
+ *   - Integer or rational frame rates (24, 25, 29.97, 30, 50, 59.94, 60)
+ *
+ * Real-world references:
+ *   - mifi/lossless-cut FCPXML 1.9 fixtures: <adjust-transform position scale anchor>
+ *   - mazsola2k/ai-video-editor: <filter-audio>/<keyframe> for volume ramps
+ *   - hysmichael/srt_fcpxml_converter: <title>/<text-style-def> shape
+ *   - subtitleedit FinalCutProXmlGap.cs: lane= on title
+ *   - eoyilmaz/anima conformer: emitter shape verified
+ */
+/** Single keyframe at a clip-relative frame. */
+export interface Keyframe<T> {
+    /** Time within the clip, in frames (0-based, frame 0 = start of clip). */
+    frame: number;
+    value: T;
+    /**
+     * Interpolation between this keyframe and the next. Per FCPXML spec,
+     * position keyframes ignore curve/interp attributes — the emitter omits
+     * them automatically for position. "linear" is the most portable choice.
+     */
+    interp?: "linear" | "easeIn" | "easeOut" | "smooth";
+}
+/** Animated value driven by 2+ keyframes. Single-frame = static. */
+export interface KeyframedValue<T> {
+    keyframes: Keyframe<T>[];
+}
+/** Static or animated transform on a clip. */
+export interface TransformSpec {
+    /** [x, y] in FCPXML normalized units. (0,0) = centred. Animatable. */
+    position?: [number, number] | KeyframedValue<[number, number]>;
+    /** [sx, sy] uniform-or-anisotropic scale. 1 = native. Animatable. */
+    scale?: [number, number] | KeyframedValue<[number, number]>;
+    /** [ax, ay] anchor point. Static only (FCPXML doesn't keyframe anchor). */
+    anchor?: [number, number];
+    /** Rotation in degrees. Animatable. */
+    rotation?: number | KeyframedValue<number>;
+}
+export interface FcpxmlEvent {
+    /** Source identifier — multiple events with the same reel share an asset. */
+    reel: string;
+    /** Absolute path or file:// URL to the source media. */
+    sourcePath: string;
+    /** Source IN (frames into the source clip). */
+    sourceInFrame: number;
+    /** Source OUT (exclusive). */
+    sourceOutFrame: number;
+    /** Optional clip name on the timeline. */
+    clipName?: string;
+    /** Optional source duration in frames. Used to declare the asset's total length. */
+    sourceDurationFrames?: number;
+    /**
+     * Lane number for multi-track composition. 0 (or undefined) = main spine.
+     * 1, 2, … = stacked above (B-roll, overlays, lower-thirds).
+     *
+     * IMPORTANT: lane clips use absolute timeline offset — they do NOT advance
+     * the spine cursor. Two events with lane=1 at offset 0 both start at 0.
+     * If you omit recordOffsetFrame on a lane clip, it inherits the cursor
+     * position at emit time (rare; usually you want to specify it).
+     */
+    lane?: number;
+    /**
+     * Override the timeline offset where this clip starts. Required for lane
+     * clips so they sit at the right time. Spine clips (lane undefined / 0)
+     * normally leave this unset and accept contiguous placement.
+     */
+    recordOffsetFrame?: number;
+    /** Static or animated transform applied via <adjust-transform>. */
+    transform?: TransformSpec;
+    /**
+     * Static or animated opacity 0..1. Static emits a single keyframe, animated
+     * emits the full ramp. Backed by <param name="opacity">.
+     */
+    opacity?: number | KeyframedValue<number>;
+    /**
+     * Static or animated audio gain in dB. Static emits <adjust-volume>;
+     * animated emits <filter-audio name="Volume"> + <keyframe time= value=> ramp.
+     * Convention: 0 dB = unchanged, -inf approximated as -60 dB.
+     */
+    volumeDb?: number | KeyframedValue<number>;
+}
+/** A standalone <title> element (lower-third / title card / lyric). */
+export interface FcpxmlTitle {
+    /** Text content. Newlines emit as &#10;. */
+    text: string;
+    /** Lane to render on. 0 = main spine (rare). 1+ = above. */
+    lane?: number;
+    /** Timeline offset in frames. */
+    startFrame: number;
+    /** Duration in frames. */
+    durationFrames: number;
+    /** Optional name in the timeline panel. */
+    name?: string;
+    fontName?: string;
+    /** Font size in points (FCPXML coords). 63 ≈ medium HD title. */
+    fontSize?: number;
+    /** Hex RRGGBB; converted to FCPXML's 0..1 RGB. White by default. */
+    fontColor?: string;
+    /** "left" | "center" | "right" — passed through to text-style alignment. */
+    alignment?: "left" | "center" | "right";
+}
+export interface FcpxmlOptions {
+    title: string;
+    /** Frame rate as a number. 29.97 / 23.976 are auto-mapped to NTSC fractions. */
+    frameRate: number;
+    width?: number;
+    height?: number;
+    events: FcpxmlEvent[];
+    /**
+     * Standalone titles to emit on the spine alongside asset-clips. Useful for
+     * lower-thirds / chapter cards. If you only want titles, leave events empty
+     * is NOT valid — pass at least one event (use a black gap clip if needed).
+     */
+    titles?: FcpxmlTitle[];
+    /**
+     * Audio metadata applied to every emitted asset. These attributes are
+     * standard in real-world Resolve / Premiere / FCP exports and let
+     * importers route audio without guessing. The defaults match the most
+     * common content-creator setup (stereo 48kHz).
+     */
+    audioChannels?: number;
+    audioRate?: number;
+}
+interface FrameRational {
+    /** Numerator of frame duration (seconds). */
+    num: number;
+    /** Denominator of frame duration (seconds). */
+    den: number;
+}
+/**
+ * Map a frame rate to FCPXML rational frame duration.
+ *
+ * 30/1001 NDF maps to 1001/30000s, etc. Integer rates use 1/N.
+ */
+export declare function frameRateToRational(fps: number): FrameRational;
+/** Convert a frame count to FCPXML time string e.g. "1001/30000s × 30 = 30030/30000s". */
+export declare function framesToTime(frames: number, fr: FrameRational): string;
+/**
+ * Build an FCPXML 1.10 string. Lays spine events out contiguously
+ * (event N starts where N-1 ended) — matches our EDL emitter's contract.
+ * Lane events (lane>=1) and titles use absolute offsets and do NOT advance
+ * the cursor.
+ */
+export declare function buildFcpxml(opts: FcpxmlOptions): string;
+export declare function totalRecordFramesFcpxml(events: FcpxmlEvent[]): number;
+/**
+ * Convert hex RRGGBB to FCPXML's space-separated 0..1 RGBA color literal.
+ * "FFFFFF" → "1 1 1 1". "808080" → "0.501961 0.501961 0.501961 1".
+ */
+export declare function hexToFcpColor(hex: string): string;
+export {};
+//# sourceMappingURL=fcpxml.d.ts.map

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

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