venice-video-harness 2.4.0

package/dist/mini-drama/timeline-export/fcpxml.d.ts

@@ -0,0 +1,11 @@
+import type { TimelineExportOptions } from './types.js';
+/**
+ * Emit an FCPXML 1.10 file. Returns the output path.
+ *
+ * The function is pure orchestration — segment timing and audio placement
+ * decisions must already be made by the caller. The standard placement
+ * pattern (shot-anchored offsets from  + music cues from ) builds
+ * the inputs naturally.
+ */
+export declare function exportFcpxml(opts: TimelineExportOptions): Promise<string>;
+//# sourceMappingURL=fcpxml.d.ts.map

package/dist/mini-drama/timeline-export/fcpxml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fcpxml.d.ts","sourceRoot":"","sources":["../../../src/mini-drama/timeline-export/fcpxml.ts"],"names":[],"mappings":"AAgCA,OAAO,KAAK,EAAqB,qBAAqB,EAAmB,MAAM,YAAY,CAAC;AAa5F;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC,CAiH/E"}

package/dist/mini-drama/timeline-export/fcpxml.js

@@ -0,0 +1,140 @@
+// ---------------------------------------------------------------------------
+// FCPXML 1.10 export (Final Cut Pro X).
+//
+// Emits an FCPXML 1.10 that imports cleanly into FCP X 10.7+ with:
+//   - one <format> declaration sized to the series' aspect ratio + fps
+//   - one <asset> per unique video segment AND per unique audio file, each
+//     with a child <media-rep kind="original-media" src="file://...">.
+//     (FCPXML 1.10 puts src on <media-rep>, NOT on <asset> itself — putting
+//     it on <asset> fails DTD validation.)
+//   - per-asset audioRate + audioChannels probed from each file
+//   - primary storyline: one <asset-clip> per video segment in sequence, with
+//     <adjust-volume amount="-96dB"/> to mute the segment's silent audio
+//   - connected audio MUST be children of their containing primary clip (NOT
+//     siblings on the spine). Each child <audio> uses lane="-N" (negative =
+//     connected below primary) and an offset expressed in the parent's local
+//     media time (= timeline offset − parent's spine offset).
+//   - lane plan: -1 dialogue (role dialogue.dialogue), -2 SFX (effects.effects),
+//     -3 music (music.music).
+//   - time format: rational `<frames>/<fps>s` (e.g. 4345/24s = 181.04s @24fps).
+//     Snap to frame boundary.
+// ---------------------------------------------------------------------------
+import { mkdir, writeFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { dirname } from 'node:path';
+import { pathToFileUri, probeAudioInfo, segmentContaining, toRationalTime, xmlEscape, } from './probe.js';
+/**
+ * Emit an FCPXML 1.10 file. Returns the output path.
+ *
+ * The function is pure orchestration — segment timing and audio placement
+ * decisions must already be made by the caller. The standard placement
+ * pattern (shot-anchored offsets from  + music cues from ) builds
+ * the inputs naturally.
+ */
+export async function exportFcpxml(opts) {
+    const fps = opts.fps ?? 24;
+    const width = opts.width ?? 1920;
+    const height = opts.height ?? 1080;
+    const eventName = opts.eventName ?? 'Episode';
+    const projectName = opts.projectName ?? `${eventName} — fine-tune`;
+    // 1. Build assets. One asset per unique file path.
+    const assetById = new Map();
+    let counter = 1; // r1 is reserved for the <format>; assets start at r2.
+    const FORMAT_ID = 'r1';
+    async function registerAsset(path, hasVideo, durSec, name) {
+        const existing = assetById.get(path);
+        if (existing)
+            return existing;
+        const id = `r${++counter + 1}`; // r2, r3, ...
+        let audioRate = 48000;
+        let audioChannels = 2;
+        try {
+            const info = await probeAudioInfo(path);
+            audioRate = info.sampleRate;
+            audioChannels = info.channels;
+        }
+        catch { /* best-effort */ }
+        const rec = {
+            id, name, path,
+            hasVideo,
+            hasAudio: true,
+            durRt: toRationalTime(durSec, fps),
+            audioRate,
+            audioChannels,
+        };
+        assetById.set(path, rec);
+        return rec;
+    }
+    for (const s of opts.segments) {
+        if (!existsSync(s.path)) {
+            throw new Error(`exportFcpxml: missing segment ${s.path}`);
+        }
+        s._asset =
+            await registerAsset(s.path, true, s.durSec, s.label);
+    }
+    for (const a of opts.audio) {
+        if (!existsSync(a.path)) {
+            throw new Error(`exportFcpxml: missing audio file ${a.path}`);
+        }
+        a._asset =
+            await registerAsset(a.path, false, a.audioDur, a.label);
+    }
+    // 2. Bucket connected audio under the segment that contains its startSec.
+    const buckets = opts.segments.map(() => []);
+    for (const a of opts.audio) {
+        buckets[segmentContaining(opts.segments, a.startSec)].push(a);
+    }
+    // 3. Emit XML.
+    const masterDur = opts.totalDurationSec
+        ?? opts.segments.reduce((acc, s) => Math.max(acc, s.startSec + s.durSec), 0);
+    const lines = [];
+    lines.push(`<?xml version="1.0" encoding="UTF-8"?>`);
+    lines.push(`<!DOCTYPE fcpxml>`);
+    lines.push(`<fcpxml version="1.10">`);
+    lines.push(`  <resources>`);
+    lines.push(`    <format id="${FORMAT_ID}" name="FFVideoFormat${width}x${height}p${fps}" frameDuration="1/${fps}s" width="${width}" height="${height}" colorSpace="1-1-1 (Rec. 709)"/>`);
+    for (const a of assetById.values()) {
+        const uri = pathToFileUri(a.path);
+        const hasVideo = a.hasVideo ? '1' : '0';
+        const formatAttr = a.hasVideo ? ` format="${FORMAT_ID}"` : '';
+        lines.push(`    <asset id="${a.id}" name="${xmlEscape(a.name)}" start="0s" duration="${a.durRt}" hasVideo="${hasVideo}" hasAudio="1"${formatAttr} audioSources="1" audioChannels="${a.audioChannels}" audioRate="${a.audioRate}">`);
+        lines.push(`      <media-rep kind="original-media" src="${uri}"/>`);
+        lines.push(`    </asset>`);
+    }
+    lines.push(`  </resources>`);
+    lines.push(`  <library>`);
+    lines.push(`    <event name="${xmlEscape(eventName)}">`);
+    lines.push(`      <project name="${xmlEscape(projectName)}">`);
+    lines.push(`        <sequence format="${FORMAT_ID}" duration="${toRationalTime(masterDur, fps)}" tcStart="0s" tcFormat="NDF" audioLayout="stereo" audioRate="48k">`);
+    lines.push(`          <spine>`);
+    for (let i = 0; i < opts.segments.length; i++) {
+        const s = opts.segments[i];
+        const segAsset = s._asset;
+        const children = buckets[i];
+        const open = `            <asset-clip name="${xmlEscape(s.label)}" ref="${segAsset.id}" offset="${toRationalTime(s.startSec, fps)}" duration="${toRationalTime(s.durSec, fps)}" start="0s" tcFormat="NDF" audioRole="dialogue.dialogue"`;
+        if (children.length === 0) {
+            lines.push(open + `>`);
+            lines.push(`              <adjust-volume amount="-96dB"/>`);
+            lines.push(`            </asset-clip>`);
+            continue;
+        }
+        lines.push(open + `>`);
+        lines.push(`              <adjust-volume amount="-96dB"/>`);
+        for (const ch of children) {
+            const chAsset = ch._asset;
+            const localOffset = ch.startSec - s.startSec;
+            lines.push(`              <audio name="${xmlEscape(ch.label)}" ref="${chAsset.id}" offset="${toRationalTime(localOffset, fps)}" duration="${toRationalTime(ch.audioDur, fps)}" start="0s" lane="${ch.lane}" role="${ch.role}"/>`);
+        }
+        lines.push(`            </asset-clip>`);
+    }
+    lines.push(`          </spine>`);
+    lines.push(`        </sequence>`);
+    lines.push(`      </project>`);
+    lines.push(`    </event>`);
+    lines.push(`  </library>`);
+    lines.push(`</fcpxml>`);
+    await mkdir(dirname(opts.outputPath), { recursive: true });
+    await writeFile(opts.outputPath, lines.join('\n') + '\n', 'utf-8');
+    return opts.outputPath;
+}
+//# sourceMappingURL=fcpxml.js.map

package/dist/mini-drama/timeline-export/fcpxml.js.map

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

package/dist/mini-drama/timeline-export/index.d.ts

@@ -0,0 +1,13 @@
+export type { TimelineSegment, TimelineAudioClip, TimelineExportOptions, FcpxmlSegment, FcpxmlAudioClip, FcpxmlExportOptions, } from './types.js';
+export { toRationalTime, toFrames, pathToFileUri, xmlEscape, probeAudioInfo, segmentContaining, } from './probe.js';
+export { exportFcpxml } from './fcpxml.js';
+export { exportPremiereXml } from './premiere-xmeml.js';
+export { exportDavinciFcpxml } from './davinci-fcpxml.js';
+export type TimelineExportFormat = 'fcpxml' | 'premiere' | 'davinci';
+import type { TimelineExportOptions } from './types.js';
+/**
+ * Dispatch by format. Used by the CLI command so the exporter selection
+ * lives in one place.
+ */
+export declare function exportTimeline(format: TimelineExportFormat, opts: TimelineExportOptions): Promise<string>;
+//# sourceMappingURL=index.d.ts.map

package/dist/mini-drama/timeline-export/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mini-drama/timeline-export/index.ts"],"names":[],"mappings":"AAGA,YAAY,EACV,eAAe,EACf,iBAAiB,EACjB,qBAAqB,EAErB,aAAa,EACb,eAAe,EACf,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,cAAc,EACd,QAAQ,EACR,aAAa,EACb,SAAS,EACT,cAAc,EACd,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE1D,MAAM,MAAM,oBAAoB,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;AAErE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAKxD;;;GAGG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,oBAAoB,EAC5B,IAAI,EAAE,qBAAqB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAWjB"}

package/dist/mini-drama/timeline-export/index.js

@@ -0,0 +1,26 @@
+// Timeline-export barrel. Single import point for all three exporters
+// (FCPXML 1.10, Resolve-tuned FCPXML, Premiere xmeml v5) and shared types.
+export { toRationalTime, toFrames, pathToFileUri, xmlEscape, probeAudioInfo, segmentContaining, } from './probe.js';
+export { exportFcpxml } from './fcpxml.js';
+export { exportPremiereXml } from './premiere-xmeml.js';
+export { exportDavinciFcpxml } from './davinci-fcpxml.js';
+import { exportFcpxml } from './fcpxml.js';
+import { exportPremiereXml } from './premiere-xmeml.js';
+import { exportDavinciFcpxml } from './davinci-fcpxml.js';
+/**
+ * Dispatch by format. Used by the CLI command so the exporter selection
+ * lives in one place.
+ */
+export async function exportTimeline(format, opts) {
+    switch (format) {
+        case 'fcpxml': return exportFcpxml(opts);
+        case 'premiere': return exportPremiereXml(opts);
+        case 'davinci': return exportDavinciFcpxml(opts);
+        default: {
+            // Exhaustiveness check.
+            const _exhaustive = format;
+            throw new Error(`Unknown timeline export format: ${_exhaustive}`);
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/mini-drama/timeline-export/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/mini-drama/timeline-export/index.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,2EAA2E;AAY3E,OAAO,EACL,cAAc,EACd,QAAQ,EACR,aAAa,EACb,SAAS,EACT,cAAc,EACd,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAK1D,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE1D;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAA4B,EAC5B,IAA2B;IAE3B,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,QAAQ,CAAC,CAAC,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC;QACzC,KAAK,UAAU,CAAC,CAAC,OAAO,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAChD,KAAK,SAAS,CAAC,CAAC,OAAO,mBAAmB,CAAC,IAAI,CAAC,CAAC;QACjD,OAAO,CAAC,CAAC,CAAC;YACR,wBAAwB;YACxB,MAAM,WAAW,GAAU,MAAM,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,mCAAmC,WAAW,EAAE,CAAC,CAAC;QACpE,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/mini-drama/timeline-export/premiere-xmeml.d.ts

@@ -0,0 +1,3 @@
+import type { TimelineExportOptions } from './types.js';
+export declare function exportPremiereXml(opts: TimelineExportOptions): Promise<string>;
+//# sourceMappingURL=premiere-xmeml.d.ts.map

package/dist/mini-drama/timeline-export/premiere-xmeml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"premiere-xmeml.d.ts","sourceRoot":"","sources":["../../../src/mini-drama/timeline-export/premiere-xmeml.ts"],"names":[],"mappings":"AA+BA,OAAO,KAAK,EAAqB,qBAAqB,EAAmB,MAAM,YAAY,CAAC;AAyB5F,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC,CA8KpF"}

package/dist/mini-drama/timeline-export/premiere-xmeml.js

@@ -0,0 +1,211 @@
+// ---------------------------------------------------------------------------
+// Adobe Premiere Pro export via Final Cut Pro 7 XML (xmeml v5).
+//
+// Premiere imports xmeml v5 natively via File > Import > XML… The format is
+// Apple's predecessor to FCPXML — different shape, same idea. Differences
+// from the FCPXML 1.10 path this module mirrors:
+//
+//   - Root is <xmeml version="5"> with <sequence> directly inside. No
+//     <library> / <event> / <project> wrapper.
+//   - Times are integer FRAMES, not the rational <frames>/<fps>s form.
+//   - Rate appears as <rate><ntsc>FALSE</ntsc><timebase>24</timebase></rate>.
+//   - Connected audio is a separate <media><audio> block with <track>
+//     elements, NOT children of video clips.
+//   - One <track> per lane: V1 for video, A1 dialogue, A2 SFX, A3 music.
+//   - Each unique source file gets a <file id="..."> the first time it
+//     appears. Subsequent <clipitem> references reuse it via <file id="..."/>.
+//
+// References used to derive this format:
+//   - "Final Cut Pro X XML Interchange Format" — Apple developer docs.
+//   - Adobe Premiere "Import a Final Cut Pro project" support article.
+// Both confirm xmeml v5 as the canonical Premiere import format.
+//
+// Open question (flag in PR body): test live import in Premiere on a real
+// machine before merge — frame-count math is sensitive to ntsc-vs-drop-frame
+// nuance that's hard to verify without the actual NLE.
+// ---------------------------------------------------------------------------
+import { mkdir, writeFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { dirname } from 'node:path';
+import { pathToFileUri, probeAudioInfo, toFrames, xmlEscape } from './probe.js';
+/**
+ * Map the format-neutral lane to a Premiere audio-track index (1-based).
+ *
+ *   lane -1 (dialogue) -> A1
+ *   lane -2 (SFX)      -> A2
+ *   lane -3 (music)    -> A3
+ */
+function laneToTrackIndex(lane) {
+    if (lane === -1)
+        return 1;
+    if (lane === -2)
+        return 2;
+    return 3;
+}
+export async function exportPremiereXml(opts) {
+    const fps = opts.fps ?? 24;
+    const width = opts.width ?? 1920;
+    const height = opts.height ?? 1080;
+    const sequenceName = opts.projectName ?? opts.eventName ?? 'Episode';
+    // 1. Register every unique source file as a <file> entry. Premiere
+    //    references each <file> by id from each <clipitem>; only the first
+    //    appearance carries the full <pathurl> block.
+    let counter = 0;
+    const fileById = new Map();
+    async function registerFile(path, hasVideo, durSec, name) {
+        const existing = fileById.get(path);
+        if (existing)
+            return existing;
+        const id = `file-${++counter}`;
+        let sampleRate = 48000;
+        let channels = 2;
+        try {
+            const info = await probeAudioInfo(path);
+            sampleRate = info.sampleRate;
+            channels = info.channels;
+        }
+        catch { /* best-effort — keep defaults */ }
+        const rec = {
+            id, name, path,
+            durFrames: toFrames(durSec, fps),
+            hasVideo,
+            sampleRate,
+            channels,
+        };
+        fileById.set(path, rec);
+        return rec;
+    }
+    for (const s of opts.segments) {
+        if (!existsSync(s.path)) {
+            throw new Error(`exportPremiereXml: missing segment ${s.path}`);
+        }
+        s._file =
+            await registerFile(s.path, true, s.durSec, s.label);
+    }
+    for (const a of opts.audio) {
+        if (!existsSync(a.path)) {
+            throw new Error(`exportPremiereXml: missing audio file ${a.path}`);
+        }
+        a._file =
+            await registerFile(a.path, false, a.audioDur, a.label);
+    }
+    // 2. Bucket audio clips by Premiere track index.
+    const audioByTrack = { 1: [], 2: [], 3: [] };
+    for (const a of opts.audio) {
+        audioByTrack[laneToTrackIndex(a.lane)].push(a);
+    }
+    const masterDurSec = opts.totalDurationSec
+        ?? opts.segments.reduce((acc, s) => Math.max(acc, s.startSec + s.durSec), 0);
+    const masterDurFrames = toFrames(masterDurSec, fps);
+    // 3. Track files that have already emitted their <pathurl>. Subsequent
+    //    references in <clipitem> use the bare <file id="..."/> form.
+    const emittedFiles = new Set();
+    function fileElement(rec, includePath, durFrames) {
+        if (!includePath) {
+            return [`              <file id="${rec.id}"/>`];
+        }
+        const uri = pathToFileUri(rec.path);
+        const lines = [
+            `              <file id="${rec.id}">`,
+            `                <name>${xmlEscape(rec.name)}</name>`,
+            `                <pathurl>${uri}</pathurl>`,
+            `                <rate><ntsc>FALSE</ntsc><timebase>${fps}</timebase></rate>`,
+            `                <duration>${rec.durFrames}</duration>`,
+            `                <media>`,
+        ];
+        if (rec.hasVideo) {
+            lines.push(`                  <video>`);
+            lines.push(`                    <samplecharacteristics>`);
+            lines.push(`                      <rate><ntsc>FALSE</ntsc><timebase>${fps}</timebase></rate>`);
+            lines.push(`                      <width>${width}</width>`);
+            lines.push(`                      <height>${height}</height>`);
+            lines.push(`                    </samplecharacteristics>`);
+            lines.push(`                  </video>`);
+        }
+        lines.push(`                  <audio>`);
+        lines.push(`                    <samplecharacteristics>`);
+        lines.push(`                      <depth>16</depth>`);
+        lines.push(`                      <samplerate>${rec.sampleRate}</samplerate>`);
+        lines.push(`                    </samplecharacteristics>`);
+        lines.push(`                    <channelcount>${rec.channels}</channelcount>`);
+        lines.push(`                  </audio>`);
+        lines.push(`                </media>`);
+        lines.push(`              </file>`);
+        // Suppress full pathurl on subsequent references to this same file.
+        emittedFiles.add(rec.id);
+        return lines;
+    }
+    // 4. Emit XML.
+    const lines = [];
+    lines.push(`<?xml version="1.0" encoding="UTF-8"?>`);
+    lines.push(`<!DOCTYPE xmeml>`);
+    lines.push(`<xmeml version="5">`);
+    lines.push(`  <sequence id="seq-1">`);
+    lines.push(`    <name>${xmlEscape(sequenceName)}</name>`);
+    lines.push(`    <duration>${masterDurFrames}</duration>`);
+    lines.push(`    <rate><ntsc>FALSE</ntsc><timebase>${fps}</timebase></rate>`);
+    lines.push(`    <media>`);
+    // --- Video track (V1) ---
+    lines.push(`      <video>`);
+    lines.push(`        <format>`);
+    lines.push(`          <samplecharacteristics>`);
+    lines.push(`            <rate><ntsc>FALSE</ntsc><timebase>${fps}</timebase></rate>`);
+    lines.push(`            <width>${width}</width>`);
+    lines.push(`            <height>${height}</height>`);
+    lines.push(`          </samplecharacteristics>`);
+    lines.push(`        </format>`);
+    lines.push(`        <track>`);
+    for (let i = 0; i < opts.segments.length; i++) {
+        const s = opts.segments[i];
+        const rec = s._file;
+        const startFr = toFrames(s.startSec, fps);
+        const endFr = startFr + toFrames(s.durSec, fps);
+        const includePath = !emittedFiles.has(rec.id);
+        lines.push(`          <clipitem id="vclip-${i + 1}">`);
+        lines.push(`            <name>${xmlEscape(s.label)}</name>`);
+        lines.push(`            <duration>${rec.durFrames}</duration>`);
+        lines.push(`            <rate><ntsc>FALSE</ntsc><timebase>${fps}</timebase></rate>`);
+        lines.push(`            <start>${startFr}</start>`);
+        lines.push(`            <end>${endFr}</end>`);
+        lines.push(`            <in>0</in>`);
+        lines.push(`            <out>${toFrames(s.durSec, fps)}</out>`);
+        for (const ln of fileElement(rec, includePath, rec.durFrames))
+            lines.push(ln);
+        lines.push(`          </clipitem>`);
+    }
+    lines.push(`        </track>`);
+    lines.push(`      </video>`);
+    // --- Audio tracks (A1 dialogue, A2 SFX, A3 music) ---
+    lines.push(`      <audio>`);
+    for (const trackIdx of [1, 2, 3]) {
+        lines.push(`        <track>`);
+        let clipNum = 0;
+        for (const a of audioByTrack[trackIdx]) {
+            const rec = a._file;
+            const startFr = toFrames(a.startSec, fps);
+            const endFr = startFr + toFrames(a.audioDur, fps);
+            const includePath = !emittedFiles.has(rec.id);
+            clipNum += 1;
+            lines.push(`          <clipitem id="a${trackIdx}-clip-${clipNum}">`);
+            lines.push(`            <name>${xmlEscape(a.label)}</name>`);
+            lines.push(`            <duration>${rec.durFrames}</duration>`);
+            lines.push(`            <rate><ntsc>FALSE</ntsc><timebase>${fps}</timebase></rate>`);
+            lines.push(`            <start>${startFr}</start>`);
+            lines.push(`            <end>${endFr}</end>`);
+            lines.push(`            <in>0</in>`);
+            lines.push(`            <out>${toFrames(a.audioDur, fps)}</out>`);
+            for (const ln of fileElement(rec, includePath, rec.durFrames))
+                lines.push(ln);
+            lines.push(`          </clipitem>`);
+        }
+        lines.push(`        </track>`);
+    }
+    lines.push(`      </audio>`);
+    lines.push(`    </media>`);
+    lines.push(`  </sequence>`);
+    lines.push(`</xmeml>`);
+    await mkdir(dirname(opts.outputPath), { recursive: true });
+    await writeFile(opts.outputPath, lines.join('\n') + '\n', 'utf-8');
+    return opts.outputPath;
+}
+//# sourceMappingURL=premiere-xmeml.js.map

package/dist/mini-drama/timeline-export/premiere-xmeml.js.map

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

package/dist/mini-drama/timeline-export/probe.d.ts

@@ -0,0 +1,53 @@
+import type { TimelineSegment } from './types.js';
+/**
+ * Convert a duration in seconds to FCPXML's rational form, snapped to the
+ * nearest frame boundary.
+ *
+ * Example: `toRationalTime(181.04, 24)` → `"4345/24s"`.
+ */
+export declare function toRationalTime(seconds: number, fps: number): string;
+/**
+ * Convert a duration in seconds to an integer frame count.
+ *
+ * Premiere's xmeml v5 uses integer frames for `start` / `end` / `in` / `out`
+ * fields — NOT the rational FCPXML form.
+ */
+export declare function toFrames(seconds: number, fps: number): number;
+/**
+ * Convert a filesystem path to a `file://` URI. URI-encodes spaces and most
+ * special characters but leaves `/` and `:` alone.
+ *
+ * Used by FCPXML 1.10 (`<media-rep src>`) and Premiere xmeml v5 (`<pathurl>`).
+ * The DaVinci exporter has its own variant that avoids URI encoding for
+ * non-ASCII paths on Linux Resolve versions.
+ */
+export declare function pathToFileUri(p: string): string;
+/**
+ * Escape a string for inclusion in XML text or attribute values.
+ *
+ * Handles the five XML entity characters. Suitable for both element content
+ * and attribute values; the result is safe to drop into either context.
+ */
+export declare function xmlEscape(s: string): string;
+/**
+ * ffprobe wrapper returning normalized audio info for a single file.
+ *
+ * Returns sane defaults (48 kHz / stereo) if the probe fails or the file
+ * has no audio stream. The FCPXML 1.10 exporter requires both
+ * `audioRate` and `audioChannels` on every `<asset>` declaration; lying
+ * about either is fine as long as the values exist.
+ */
+export declare function probeAudioInfo(path: string): Promise<{
+    durSec: number;
+    sampleRate: number;
+    channels: number;
+}>;
+/**
+ * Locate the spine segment index that contains a given timeline timestamp.
+ *
+ * Past-end timestamps clamp to the last segment so off-by-frame audio
+ * placement at the very end of the episode still emits a clip rather than
+ * being dropped.
+ */
+export declare function segmentContaining(segments: TimelineSegment[], timeSec: number): number;
+//# sourceMappingURL=probe.d.ts.map

package/dist/mini-drama/timeline-export/probe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"probe.d.ts","sourceRoot":"","sources":["../../../src/mini-drama/timeline-export/probe.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAIlD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAGnE;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAI3C;AAED;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAC1D,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC,CAcD;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,eAAe,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAMtF"}

package/dist/mini-drama/timeline-export/probe.js

@@ -0,0 +1,89 @@
+// ---------------------------------------------------------------------------
+// Format-neutral helpers shared across all timeline exporters.
+//
+// Pure utilities — no exporter-specific logic. The FCPXML, Premiere, and
+// DaVinci exporters all share these.
+// ---------------------------------------------------------------------------
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+const execFileAsync = promisify(execFile);
+/**
+ * Convert a duration in seconds to FCPXML's rational form, snapped to the
+ * nearest frame boundary.
+ *
+ * Example: `toRationalTime(181.04, 24)` → `"4345/24s"`.
+ */
+export function toRationalTime(seconds, fps) {
+    const frames = Math.max(0, Math.round(seconds * fps));
+    return `${frames}/${fps}s`;
+}
+/**
+ * Convert a duration in seconds to an integer frame count.
+ *
+ * Premiere's xmeml v5 uses integer frames for `start` / `end` / `in` / `out`
+ * fields — NOT the rational FCPXML form.
+ */
+export function toFrames(seconds, fps) {
+    return Math.max(0, Math.round(seconds * fps));
+}
+/**
+ * Convert a filesystem path to a `file://` URI. URI-encodes spaces and most
+ * special characters but leaves `/` and `:` alone.
+ *
+ * Used by FCPXML 1.10 (`<media-rep src>`) and Premiere xmeml v5 (`<pathurl>`).
+ * The DaVinci exporter has its own variant that avoids URI encoding for
+ * non-ASCII paths on Linux Resolve versions.
+ */
+export function pathToFileUri(p) {
+    return 'file://' + encodeURI(p).replace(/'/g, '%27');
+}
+/**
+ * Escape a string for inclusion in XML text or attribute values.
+ *
+ * Handles the five XML entity characters. Suitable for both element content
+ * and attribute values; the result is safe to drop into either context.
+ */
+export function xmlEscape(s) {
+    return String(s).replace(/[<>&'"]/g, c => ({
+        '<': '&lt;', '>': '&gt;', '&': '&amp;', "'": '&apos;', '"': '&quot;',
+    }[c]));
+}
+/**
+ * ffprobe wrapper returning normalized audio info for a single file.
+ *
+ * Returns sane defaults (48 kHz / stereo) if the probe fails or the file
+ * has no audio stream. The FCPXML 1.10 exporter requires both
+ * `audioRate` and `audioChannels` on every `<asset>` declaration; lying
+ * about either is fine as long as the values exist.
+ */
+export async function probeAudioInfo(path) {
+    const { stdout } = await execFileAsync('ffprobe', [
+        '-v', 'quiet',
+        '-print_format', 'json',
+        '-show_format', '-show_streams',
+        path,
+    ]);
+    const j = JSON.parse(stdout);
+    const a = j.streams.find((s) => s.codec_type === 'audio');
+    return {
+        durSec: parseFloat(a?.duration ?? j.format.duration ?? '0'),
+        sampleRate: parseInt(a?.sample_rate ?? '48000', 10),
+        channels: parseInt(a?.channels ?? '2', 10),
+    };
+}
+/**
+ * Locate the spine segment index that contains a given timeline timestamp.
+ *
+ * Past-end timestamps clamp to the last segment so off-by-frame audio
+ * placement at the very end of the episode still emits a clip rather than
+ * being dropped.
+ */
+export function segmentContaining(segments, timeSec) {
+    for (let i = 0; i < segments.length; i++) {
+        const s = segments[i];
+        if (timeSec >= s.startSec && timeSec < s.startSec + s.durSec)
+            return i;
+    }
+    return Math.max(0, segments.length - 1);
+}
+//# sourceMappingURL=probe.js.map

package/dist/mini-drama/timeline-export/probe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"probe.js","sourceRoot":"","sources":["../../../src/mini-drama/timeline-export/probe.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,+DAA+D;AAC/D,EAAE;AACF,yEAAyE;AACzE,qCAAqC;AACrC,8EAA8E;AAE9E,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAGtC,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAE1C;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,OAAe,EAAE,GAAW;IACzD,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,GAAG,CAAC,CAAC,CAAC;IACtD,OAAO,GAAG,MAAM,IAAI,GAAG,GAAG,CAAC;AAC7B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CAAC,OAAe,EAAE,GAAW;IACnD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,GAAG,CAAC,CAAC,CAAC;AAChD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,CAAS;IACrC,OAAO,SAAS,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AACvD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,CAAS;IACjC,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;QACzC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ;KACrE,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC;AACV,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAY;IAK/C,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,SAAS,EAAE;QAChD,IAAI,EAAE,OAAO;QACb,eAAe,EAAE,MAAM;QACvB,cAAc,EAAE,eAAe;QAC/B,IAAI;KACL,CAAC,CAAC;IACH,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC7B,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAyB,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,OAAO,CAAC,CAAC;IAClF,OAAO;QACL,MAAM,EAAE,UAAU,CAAC,CAAC,EAAE,QAAQ,IAAI,CAAC,CAAC,MAAM,CAAC,QAAQ,IAAI,GAAG,CAAC;QAC3D,UAAU,EAAE,QAAQ,CAAC,CAAC,EAAE,WAAW,IAAI,OAAO,EAAE,EAAE,CAAC;QACnD,QAAQ,EAAE,QAAQ,CAAC,CAAC,EAAE,QAAQ,IAAI,GAAG,EAAE,EAAE,CAAC;KAC3C,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAA2B,EAAE,OAAe;IAC5E,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACzC,MAAM,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QACtB,IAAI,OAAO,IAAI,CAAC,CAAC,QAAQ,IAAI,OAAO,GAAG,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,MAAM;YAAE,OAAO,CAAC,CAAC;IACzE,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AAC1C,CAAC"}