@cueframe/kernel 0.0.1

package/dist/_members/nle-export/compact-timeline.js

@@ -0,0 +1,73 @@
+export function compactTimeline(clips, deletedRanges) {
+    const byClip = new Map();
+    for (const r of deletedRanges) {
+        if (!byClip.has(r.clipId))
+            byClip.set(r.clipId, []);
+        byClip.get(r.clipId).push(r);
+    }
+    const survivors = [];
+    const sortedClips = [...clips].sort((a, b) => a.timelineStart - b.timelineStart);
+    for (const clip of sortedClips) {
+        const clipDuration = clip.sourceOut - clip.sourceIn;
+        const ranges = (byClip.get(clip.id) ?? [])
+            .map(r => ({
+            start: Math.max(0, Math.min(r.startSec, clipDuration)),
+            end: Math.max(0, Math.min(r.endSec, clipDuration)),
+        }))
+            .filter(r => r.end > r.start)
+            .sort((a, b) => a.start - b.start);
+        const merged = [];
+        for (const r of ranges) {
+            const last = merged[merged.length - 1];
+            if (last && r.start <= last.end)
+                last.end = Math.max(last.end, r.end);
+            else
+                merged.push({ ...r });
+        }
+        const keep = [];
+        let cursor = 0;
+        for (const r of merged) {
+            if (r.start > cursor)
+                keep.push({ start: cursor, end: r.start });
+            cursor = r.end;
+        }
+        if (cursor < clipDuration)
+            keep.push({ start: cursor, end: clipDuration });
+        const anySplit = merged.length > 0;
+        keep.forEach((seg, idx) => {
+            survivors.push({
+                id: anySplit ? `${clip.id}__${idx}` : clip.id,
+                originalClipId: anySplit ? clip.id : undefined,
+                poolItemId: clip.poolItemId,
+                sourceIn: clip.sourceIn + seg.start,
+                sourceOut: clip.sourceIn + seg.end,
+                transitionIn: clip.transitionIn,
+                transitionDuration: clip.transitionDuration,
+                durationSec: seg.end - seg.start,
+            });
+        });
+    }
+    let tlCursor = 0;
+    return survivors.map(s => {
+        const timelineStart = tlCursor;
+        const timelineEnd = tlCursor + s.durationSec;
+        tlCursor = timelineEnd;
+        const { durationSec: _d, ...rest } = s;
+        const result = {
+            id: rest.id,
+            poolItemId: rest.poolItemId,
+            sourceIn: rest.sourceIn,
+            sourceOut: rest.sourceOut,
+            timelineStart,
+            timelineEnd,
+        };
+        if (rest.originalClipId !== undefined)
+            result.originalClipId = rest.originalClipId;
+        if (rest.transitionIn !== undefined)
+            result.transitionIn = rest.transitionIn;
+        if (rest.transitionDuration !== undefined)
+            result.transitionDuration = rest.transitionDuration;
+        return result;
+    });
+}
+//# sourceMappingURL=compact-timeline.js.map

package/dist/_members/nle-export/compact-timeline.js.map

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

package/dist/_members/nle-export/composition-to-input.d.ts

@@ -0,0 +1,2 @@
+import type { ClipExportInput, ExportComposition, TrimmedRef } from "./types.js";
+export declare function compositionToClipExportInput(composition: ExportComposition, trimmedRefs: TrimmedRef[]): ClipExportInput;

package/dist/_members/nle-export/composition-to-input.js

@@ -0,0 +1,147 @@
+import { compactTimeline } from "./compact-timeline";
+import { CompositionValidationError } from "./types";
+import { getPrimitiveText } from "@cueframe/compose";
+const EPSILON = 1e-6;
+function sequenceRational(fps) {
+    if (Math.abs(fps - 29.97) < 0.01)
+        return { fpsNum: 30000, fpsDen: 1001 };
+    if (Math.abs(fps - 23.976) < 0.01)
+        return { fpsNum: 24000, fpsDen: 1001 };
+    if (Math.abs(fps - 59.94) < 0.01)
+        return { fpsNum: 60000, fpsDen: 1001 };
+    return { fpsNum: Math.round(fps), fpsDen: 1 };
+}
+export function compositionToClipExportInput(composition, trimmedRefs) {
+    // Validate overlaps/gaps against the ORIGINAL composition clips (compactTimeline
+    // re-lays-out clips contiguously by cursor, so it would hide these defects).
+    const originalSorted = [...composition.clips].sort((a, b) => a.timelineStart - b.timelineStart);
+    for (let i = 0; i < originalSorted.length - 1; i++) {
+        const cur = originalSorted[i], next = originalSorted[i + 1];
+        if (next.timelineStart < cur.timelineEnd - EPSILON) {
+            throw new CompositionValidationError("Composition spine overlaps — clips must not share timeline time in v1", { kind: "overlap", detail: `${cur.id} overlaps ${next.id}` });
+        }
+        if (next.timelineStart > cur.timelineEnd + EPSILON) {
+            throw new CompositionValidationError("Composition spine has a gap — clips must be contiguous in v1", { kind: "gap", detail: `${cur.id} ends at ${cur.timelineEnd}, ${next.id} starts at ${next.timelineStart}` });
+        }
+    }
+    const compacted = compactTimeline(composition.clips, composition.deletedRanges);
+    const sorted = [...compacted].sort((a, b) => a.timelineStart - b.timelineStart);
+    function findRef(clip) {
+        // Match by exact integer triple. Trim activity computed
+        // inFramesAtSourceRate via `round(sourceIn * mediaItemFps)` — we use
+        // the same formula here so the round-trip is deterministic regardless
+        // of whether mediaItem.frameRate is stored as 29.97 (decimal) while
+        // ffprobe reports 30000/1001 (rational).
+        const match = trimmedRefs.find(r => {
+            if (r.sourceId !== clip.poolItemId)
+                return false;
+            const expectedIn = Math.round(clip.sourceIn * r.mediaItemFps);
+            const expectedOut = Math.round(clip.sourceOut * r.mediaItemFps);
+            return (r.inFramesAtSourceRate === expectedIn &&
+                r.outFramesAtSourceRate === expectedOut);
+        });
+        if (!match) {
+            throw new CompositionValidationError("Missing trimmedRef for clip", { kind: "missing-trim", detail: `clip ${clip.id} (${clip.poolItemId} ${clip.sourceIn}-${clip.sourceOut}s)` });
+        }
+        return match;
+    }
+    const assetOrder = [];
+    const refForClip = new Map();
+    for (const clip of sorted) {
+        const ref = findRef(clip);
+        refForClip.set(clip.id, ref);
+        const key = `${ref.sourceId}::${ref.inFramesAtSourceRate}::${ref.outFramesAtSourceRate}`;
+        if (!assetOrder.includes(key))
+            assetOrder.push(key);
+    }
+    const assetIdByKey = new Map();
+    const refByKey = new Map();
+    for (const clip of sorted) {
+        const ref = refForClip.get(clip.id);
+        const key = `${ref.sourceId}::${ref.inFramesAtSourceRate}::${ref.outFramesAtSourceRate}`;
+        if (!refByKey.has(key))
+            refByKey.set(key, ref);
+    }
+    const assets = assetOrder.map((key, i) => {
+        const id = `a${i + 1}`;
+        assetIdByKey.set(key, id);
+        const ref = refByKey.get(key);
+        return {
+            id,
+            relPath: `media/${id}.mp4`,
+            displayName: ref.displayName,
+            sourceId: ref.sourceId,
+            originInFrames: ref.inFramesAtSourceRate,
+            originOutFrames: ref.outFramesAtSourceRate,
+            fpsNum: ref.sourceFpsNum,
+            fpsDen: ref.sourceFpsDen,
+            width: composition.width,
+            height: composition.height,
+            durationSec: ref.durationSec,
+        };
+    });
+    const { fpsNum, fpsDen } = sequenceRational(composition.fps);
+    const seqFps = fpsNum / fpsDen;
+    // Map: original (pre-split) TimelineClip id → spine item id (first segment)
+    const spineIdByOriginalClipId = new Map();
+    const spine = sorted.map((clip, idx) => {
+        const ref = refForClip.get(clip.id);
+        const sourceFps = ref.sourceFpsNum / ref.sourceFpsDen;
+        const key = `${ref.sourceId}::${ref.inFramesAtSourceRate}::${ref.outFramesAtSourceRate}`;
+        const spineId = `s${idx + 1}`;
+        const originalId = clip.originalClipId ?? clip.id;
+        if (!spineIdByOriginalClipId.has(originalId)) {
+            spineIdByOriginalClipId.set(originalId, spineId);
+        }
+        const inFrames = Math.round(ref.handleBeforeSec * sourceFps);
+        const clipLen = Math.round((clip.sourceOut - clip.sourceIn) * sourceFps);
+        return {
+            id: spineId,
+            assetId: assetIdByKey.get(key),
+            inFrames,
+            outFrames: inFrames + clipLen,
+            timelineStartFrames: Math.round(clip.timelineStart * seqFps),
+            timelineDurationFrames: Math.round((clip.timelineEnd - clip.timelineStart) * seqFps),
+        };
+    });
+    const markers = [];
+    if (composition.metadata?.cueframe?.hook) {
+        markers.push({
+            startFrames: 0,
+            durationFrames: 1,
+            name: composition.metadata.cueframe.hook,
+            kind: "hook",
+        });
+    }
+    for (const label of composition.sceneLabels) {
+        const spineItemId = spineIdByOriginalClipId.get(label.clipId);
+        if (!spineItemId)
+            continue;
+        const spineItem = spine.find(s => s.id === spineItemId);
+        const timelineSec = (spineItem.timelineStartFrames / seqFps) + label.startSec;
+        markers.push({
+            startFrames: Math.round(timelineSec * seqFps),
+            durationFrames: 1,
+            name: label.text,
+            kind: "scene",
+            spineItemId,
+        });
+    }
+    const textOverlays = composition.overlays.map(o => ({
+        text: getPrimitiveText({ template: o.template, params: o.params ?? {} }) ?? "",
+        startFrames: o.startFrame,
+        durationFrames: o.durationInFrames,
+    }));
+    const durationFrames = spine.reduce((sum, s) => Math.max(sum, s.timelineStartFrames + s.timelineDurationFrames), 0);
+    return {
+        title: composition.metadata?.cueframe?.hook ?? "Clip Export",
+        hook: composition.metadata?.cueframe?.hook,
+        sequence: { fpsNum, fpsDen, width: composition.width, height: composition.height, durationFrames },
+        assets,
+        spine,
+        markers,
+        textOverlays,
+        audioTracks: [],
+    };
+}
+//# sourceMappingURL=composition-to-input.js.map

package/dist/_members/nle-export/composition-to-input.js.map

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

package/dist/_members/nle-export/fcpxml.d.ts

@@ -0,0 +1,15 @@
+import type { ClipExportInput } from "./types.js";
+/**
+ * Generate FCPXML v1.11. Compatible with Final Cut Pro 11 and DaVinci Resolve 19.
+ *
+ * Multi-clip, multi-asset composition:
+ * - One <format> per unique (w, h, fpsNum, fpsDen) across assets + sequence.
+ * - One <asset> per assets[] entry.
+ * - One <asset-clip> per spine[] item (offset/duration in sequence rate; start in source rate).
+ * - Markers with spineItemId render inside the matching <asset-clip>, start
+ *   relativized to the clip's timelineStartFrames.
+ * - Markers without spineItemId render at spine root, start in sequence-absolute rate.
+ * - Text overlays overlapping a spine item render as markers inside that clip
+ *   (value = overlay.text). Overlays outside all clips are dropped.
+ */
+export declare function generateFcpxml(input: ClipExportInput): string;

package/dist/_members/nle-export/fcpxml.js

@@ -0,0 +1,159 @@
+import { create } from "xmlbuilder2";
+/**
+ * Generate FCPXML v1.11. Compatible with Final Cut Pro 11 and DaVinci Resolve 19.
+ *
+ * Multi-clip, multi-asset composition:
+ * - One <format> per unique (w, h, fpsNum, fpsDen) across assets + sequence.
+ * - One <asset> per assets[] entry.
+ * - One <asset-clip> per spine[] item (offset/duration in sequence rate; start in source rate).
+ * - Markers with spineItemId render inside the matching <asset-clip>, start
+ *   relativized to the clip's timelineStartFrames.
+ * - Markers without spineItemId render at spine root, start in sequence-absolute rate.
+ * - Text overlays overlapping a spine item render as markers inside that clip
+ *   (value = overlay.text). Overlays outside all clips are dropped.
+ */
+export function generateFcpxml(input) {
+    const { title, sequence, assets, spine, markers, textOverlays } = input;
+    const doc = create({ version: "1.0", encoding: "UTF-8" })
+        .dtd({ name: "fcpxml" })
+        .ele("fcpxml", { version: "1.11" });
+    // ── Resources ────────────────────────────────────────────
+    const resources = doc.ele("resources");
+    // Collect unique formats across sequence + all assets.
+    const formatKey = (w, h, fpsNum, fpsDen) => `${w}x${h}-${fpsNum}-${fpsDen}`;
+    const formatSpecs = new Map();
+    const registerFormat = (w, h, fpsNum, fpsDen) => {
+        const key = formatKey(w, h, fpsNum, fpsDen);
+        const existing = formatSpecs.get(key);
+        if (existing)
+            return existing.id;
+        const id = formatId(w, h, fpsNum, fpsDen);
+        formatSpecs.set(key, { id, width: w, height: h, fpsNum, fpsDen });
+        return id;
+    };
+    const seqFormatId = registerFormat(sequence.width, sequence.height, sequence.fpsNum, sequence.fpsDen);
+    const assetFormatIds = new Map();
+    for (const asset of assets) {
+        const id = registerFormat(asset.width, asset.height, asset.fpsNum, asset.fpsDen);
+        assetFormatIds.set(asset.id, id);
+    }
+    for (const spec of formatSpecs.values()) {
+        resources.ele("format", {
+            id: spec.id,
+            name: formatName(spec.width, spec.height, spec.fpsNum, spec.fpsDen),
+            frameDuration: frameDuration(spec.fpsNum, spec.fpsDen),
+            width: String(spec.width),
+            height: String(spec.height),
+        });
+    }
+    // Assets
+    for (const asset of assets) {
+        const assetFormatId = assetFormatIds.get(asset.id);
+        const durMs = Math.round(asset.durationSec * 1000);
+        const a = resources.ele("asset", {
+            id: asset.id,
+            name: asset.displayName,
+            start: "0s",
+            duration: `${durMs}/1000s`,
+            hasVideo: "1",
+            hasAudio: "1",
+            format: assetFormatId,
+            videoSources: "1",
+            audioSources: "1",
+            audioChannels: "2",
+        });
+        a.ele("media-rep", {
+            kind: "original-media",
+            src: `./${asset.relPath}`,
+        });
+    }
+    // ── Library / Event / Project / Sequence ───────────────
+    const seqDur = rational(sequence.durationFrames, sequence.fpsNum, sequence.fpsDen);
+    const spineEl = doc
+        .ele("library")
+        .ele("event", { name: title })
+        .ele("project", { name: title })
+        .ele("sequence", {
+        format: seqFormatId,
+        duration: seqDur,
+        tcStart: "0s",
+        tcFormat: "NDF",
+        audioLayout: "stereo",
+        audioRate: "48k",
+    })
+        .ele("spine");
+    const assetById = new Map(assets.map((a) => [a.id, a]));
+    // Spine items → asset-clips
+    for (const item of spine) {
+        const asset = assetById.get(item.assetId);
+        if (!asset)
+            continue;
+        const assetFormatId = assetFormatIds.get(asset.id);
+        const clipEl = spineEl.ele("asset-clip", {
+            ref: asset.id,
+            offset: rational(item.timelineStartFrames, sequence.fpsNum, sequence.fpsDen),
+            name: asset.displayName,
+            duration: rational(item.timelineDurationFrames, sequence.fpsNum, sequence.fpsDen),
+            start: rational(item.inFrames, asset.fpsNum, asset.fpsDen),
+            format: assetFormatId,
+            tcFormat: "NDF",
+        });
+        // Markers attached to this spine item
+        const clipMarkers = markers.filter((m) => m.spineItemId === item.id);
+        for (const m of clipMarkers) {
+            const relFrames = m.startFrames - item.timelineStartFrames;
+            emitMarker(clipEl, m, relFrames, sequence.fpsNum, sequence.fpsDen);
+        }
+        // Text overlays overlapping this spine item (by startFrames)
+        const itemEnd = item.timelineStartFrames + item.timelineDurationFrames;
+        const overlappingOverlays = textOverlays.filter((o) => o.startFrames >= item.timelineStartFrames && o.startFrames < itemEnd);
+        for (const o of overlappingOverlays) {
+            const relFrames = o.startFrames - item.timelineStartFrames;
+            emitOverlayMarker(clipEl, o, relFrames, sequence.fpsNum, sequence.fpsDen);
+        }
+    }
+    // Root-level markers (no spineItemId)
+    const rootMarkers = markers.filter((m) => !m.spineItemId);
+    for (const m of rootMarkers) {
+        emitMarker(spineEl, m, m.startFrames, sequence.fpsNum, sequence.fpsDen);
+    }
+    return doc.end({ prettyPrint: true, allowEmptyTags: true });
+}
+// ── helpers ────────────────────────────────────────────────
+function rational(frames, fpsNum, fpsDen) {
+    if (frames === 0)
+        return "0s";
+    return `${frames * fpsDen}/${fpsNum}s`;
+}
+function frameDuration(fpsNum, fpsDen) {
+    return `${fpsDen}/${fpsNum}s`;
+}
+function formatId(width, height, fpsNum, fpsDen) {
+    return `r-${width}x${height}-${fpsNum}-${fpsDen}`;
+}
+function formatName(_w, h, fpsNum, fpsDen) {
+    const rate = fpsDen === 1001
+        ? Math.round((fpsNum / 1000) * 100) / 100
+        : fpsNum / fpsDen;
+    return `FFVideoFormat${h}p${String(rate).replace(".", "")}`;
+}
+function emitMarker(parent, m, startFrames, fpsNum, fpsDen) {
+    const dur = Math.max(1, m.durationFrames);
+    const attrs = {
+        start: rational(startFrames, fpsNum, fpsDen),
+        duration: rational(dur, fpsNum, fpsDen),
+        value: m.name,
+    };
+    if (m.note)
+        attrs.note = m.note;
+    parent.ele("marker", attrs);
+}
+function emitOverlayMarker(parent, o, startFrames, fpsNum, fpsDen) {
+    const dur = Math.max(1, o.durationFrames);
+    parent.ele("marker", {
+        start: rational(startFrames, fpsNum, fpsDen),
+        duration: rational(dur, fpsNum, fpsDen),
+        value: o.text,
+    });
+}
+//# sourceMappingURL=fcpxml.js.map

package/dist/_members/nle-export/fcpxml.js.map

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

package/dist/_members/nle-export/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Root subpath — zero-dep, edge-runtime-safe. Types + pure-TS logic only.
+ *
+ * XML generators (which depend on xmlbuilder2) live at `@cueframe/nle-export/xml`.
+ * Node-only packaging (archiver) lives at `@cueframe/nle-export/server`.
+ */
+export { generateSrt } from "./srt.js";
+export { compositionToClipExportInput } from "./composition-to-input.js";
+export { compactTimeline } from "./compact-timeline.js";
+export { slugify } from "./xml-utils.js";
+export * from "./types.js";

package/dist/_members/nle-export/index.js

@@ -0,0 +1,12 @@
+/**
+ * Root subpath — zero-dep, edge-runtime-safe. Types + pure-TS logic only.
+ *
+ * XML generators (which depend on xmlbuilder2) live at `@cueframe/nle-export/xml`.
+ * Node-only packaging (archiver) lives at `@cueframe/nle-export/server`.
+ */
+export { generateSrt } from "./srt";
+export { compositionToClipExportInput } from "./composition-to-input";
+export { compactTimeline } from "./compact-timeline";
+export { slugify } from "./xml-utils";
+export * from "./types";
+//# sourceMappingURL=index.js.map

package/dist/_members/nle-export/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AACpC,OAAO,EAAE,4BAA4B,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,cAAc,SAAS,CAAC"}

package/dist/_members/nle-export/premiere.d.ts

@@ -0,0 +1,2 @@
+import type { ClipExportInput } from "./types.js";
+export declare function generatePremiereXml(input: ClipExportInput): string;

package/dist/_members/nle-export/premiere.js

@@ -0,0 +1,161 @@
+import { create } from "xmlbuilder2";
+/**
+ * xmlbuilder2 escapes &, <, > automatically in text nodes, but leaves
+ * " and ' unescaped (valid per XML spec since they aren't ambiguous in
+ * text content). Premiere Pro's xmeml consumers are historically
+ * conservative — pre-escape " and ' only so xmlbuilder2 can still
+ * handle the others without double-encoding.
+ */
+function escapeQuotes(s) {
+    return s.replace(/"/g, "&quot;").replace(/'/g, "&apos;");
+}
+function displayRate(fpsNum, fpsDen) {
+    if (fpsDen === 1001) {
+        return { timebase: Math.round(fpsNum / 1000), ntsc: "TRUE" };
+    }
+    return { timebase: Math.round(fpsNum / fpsDen), ntsc: "FALSE" };
+}
+function findOwningSpineItem(spine, startFrames, durationFrames) {
+    const overlayStart = startFrames;
+    const overlayEnd = startFrames + Math.max(1, durationFrames);
+    for (const item of spine) {
+        const itemStart = item.timelineStartFrames;
+        const itemEnd = item.timelineStartFrames + item.timelineDurationFrames;
+        if (overlayStart < itemEnd && overlayEnd > itemStart) {
+            return item;
+        }
+    }
+    return null;
+}
+export function generatePremiereXml(input) {
+    const { title, sequence, assets, spine, markers, textOverlays } = input;
+    const assetById = new Map();
+    for (const a of assets)
+        assetById.set(a.id, a);
+    const seqRate = displayRate(sequence.fpsNum, sequence.fpsDen);
+    const doc = create({ version: "1.0", encoding: "UTF-8" })
+        .dtd({ name: "xmeml" })
+        .ele("xmeml", { version: "4" });
+    const seqEl = doc.ele("sequence", { id: "sequence-1" });
+    seqEl.ele("name").txt(escapeQuotes(title)).up();
+    seqEl.ele("duration").txt(String(sequence.durationFrames)).up();
+    const seqRateEl = seqEl.ele("rate");
+    seqRateEl.ele("timebase").txt(String(seqRate.timebase)).up();
+    seqRateEl.ele("ntsc").txt(seqRate.ntsc).up();
+    seqRateEl.up();
+    const mediaEl = seqEl.ele("media");
+    // ── Video ────────────────────────────────────────────────
+    const videoEl = mediaEl.ele("video");
+    const videoFormatEl = videoEl.ele("format");
+    const videoSampEl = videoFormatEl.ele("samplecharacteristics");
+    videoSampEl.ele("width").txt(String(sequence.width)).up();
+    videoSampEl.ele("height").txt(String(sequence.height)).up();
+    videoSampEl.up();
+    videoFormatEl.up();
+    const trackEl = videoEl.ele("track");
+    const seenAssetIds = new Set();
+    spine.forEach((item, idx) => {
+        const asset = assetById.get(item.assetId);
+        if (!asset)
+            return;
+        const assetRate = displayRate(asset.fpsNum, asset.fpsDen);
+        const clipDurationInAssetRate = asset.originOutFrames - asset.originInFrames;
+        const clipitemEl = trackEl.ele("clipitem", { id: `clipitem-${idx + 1}` });
+        clipitemEl.ele("name").txt(escapeQuotes(asset.displayName)).up();
+        clipitemEl.ele("enabled").txt("TRUE").up();
+        clipitemEl.ele("duration").txt(String(clipDurationInAssetRate)).up();
+        const rateEl = clipitemEl.ele("rate");
+        rateEl.ele("timebase").txt(String(assetRate.timebase)).up();
+        rateEl.ele("ntsc").txt(assetRate.ntsc).up();
+        rateEl.up();
+        clipitemEl.ele("in").txt(String(item.inFrames)).up();
+        clipitemEl.ele("out").txt(String(item.outFrames)).up();
+        clipitemEl.ele("start").txt(String(item.timelineStartFrames)).up();
+        clipitemEl
+            .ele("end")
+            .txt(String(item.timelineStartFrames + item.timelineDurationFrames))
+            .up();
+        // <file>: full body on first occurrence, empty self-close on subsequent.
+        if (!seenAssetIds.has(asset.id)) {
+            seenAssetIds.add(asset.id);
+            const fileEl = clipitemEl.ele("file", { id: asset.id });
+            fileEl.ele("name").txt(escapeQuotes(asset.displayName)).up();
+            fileEl.ele("pathurl").txt(escapeQuotes(`file://./${asset.relPath}`)).up();
+            const fileRateEl = fileEl.ele("rate");
+            fileRateEl.ele("timebase").txt(String(assetRate.timebase)).up();
+            fileRateEl.ele("ntsc").txt(assetRate.ntsc).up();
+            fileRateEl.up();
+            // Duration in source-rate frames — use the rational rate, not the
+            // integer timebase. For NTSC 29.97 the integer timebase (30) would
+            // otherwise overshoot by a frame per every ~1000 frames, showing up
+            // in Premiere's bin metadata as a 1-frame-off clip length.
+            const assetDurationFrames = Math.round(asset.durationSec * (asset.fpsNum / asset.fpsDen));
+            fileEl.ele("duration").txt(String(assetDurationFrames)).up();
+            const fileMediaEl = fileEl.ele("media");
+            const fileVideoEl = fileMediaEl.ele("video");
+            const fileVideoSampEl = fileVideoEl.ele("samplecharacteristics");
+            fileVideoSampEl.ele("width").txt(String(asset.width)).up();
+            fileVideoSampEl.ele("height").txt(String(asset.height)).up();
+            fileVideoSampEl.up();
+            fileVideoEl.up();
+            const fileAudioEl = fileMediaEl.ele("audio");
+            const fileAudioSampEl = fileAudioEl.ele("samplecharacteristics");
+            fileAudioSampEl.ele("samplerate").txt("48000").up();
+            fileAudioSampEl.ele("depth").txt("16").up();
+            fileAudioSampEl.up();
+            fileAudioEl.ele("channelcount").txt("2").up();
+            fileAudioEl.up();
+            fileMediaEl.up();
+            fileEl.up();
+        }
+        else {
+            clipitemEl.ele("file", { id: asset.id }).up();
+        }
+        // Markers belonging to this spine item.
+        const emitClipMarker = (name, note, startAbsFrames, durationFrames) => {
+            const markerEl = clipitemEl.ele("marker");
+            markerEl.ele("name").txt(escapeQuotes(name)).up();
+            if (note && note.length > 0) {
+                markerEl.ele("comment").txt(escapeQuotes(note)).up();
+            }
+            const relStart = startAbsFrames - item.timelineStartFrames;
+            const dur = Math.max(1, durationFrames);
+            markerEl.ele("in").txt(String(relStart)).up();
+            markerEl.ele("out").txt(String(relStart + dur)).up();
+            markerEl.up();
+        };
+        for (const m of markers) {
+            if (m.spineItemId === item.id) {
+                emitClipMarker(m.name, m.note, m.startFrames, m.durationFrames);
+            }
+        }
+        // Overlays overlapping this item.
+        for (const overlay of textOverlays) {
+            const owner = findOwningSpineItem(spine, overlay.startFrames, overlay.durationFrames);
+            if (owner && owner.id === item.id) {
+                emitClipMarker(overlay.text, undefined, overlay.startFrames, overlay.durationFrames);
+            }
+        }
+        clipitemEl.up();
+    });
+    trackEl.up();
+    videoEl.up();
+    mediaEl.up();
+    // Root-level markers (no spineItemId) — emitted AFTER </media> (after all tracks).
+    for (const m of markers) {
+        if (m.spineItemId)
+            continue;
+        const markerEl = seqEl.ele("marker");
+        markerEl.ele("name").txt(escapeQuotes(m.name)).up();
+        if (m.note && m.note.length > 0) {
+            markerEl.ele("comment").txt(escapeQuotes(m.note)).up();
+        }
+        const dur = Math.max(1, m.durationFrames);
+        markerEl.ele("in").txt(String(m.startFrames)).up();
+        markerEl.ele("out").txt(String(m.startFrames + dur)).up();
+        markerEl.up();
+    }
+    seqEl.up();
+    return doc.end({ prettyPrint: true });
+}
+//# sourceMappingURL=premiere.js.map