venice-video-harness 2.4.0

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

@@ -0,0 +1,57 @@
+/** One video clip placed on the primary storyline. */
+export interface TimelineSegment {
+    /** Path to the video file (mp4). */
+    path: string;
+    /** Display label. */
+    label: string;
+    /** Duration in seconds. */
+    durSec: number;
+    /** Timeline start in seconds. */
+    startSec: number;
+}
+/** One connected audio clip on a non-primary lane. */
+export interface TimelineAudioClip {
+    /** Path to the audio file (mp3/wav/m4a). */
+    path: string;
+    /** Display label. */
+    label: string;
+    /** Timeline start in seconds. */
+    startSec: number;
+    /** Duration in seconds. */
+    audioDur: number;
+    /** Lane number — always negative (connected below primary in FCPXML). */
+    lane: -1 | -2 | -3;
+    /** FCP X role. Premiere/Resolve exporters map this to their track-name conventions. */
+    role: 'dialogue.dialogue' | 'effects.effects' | 'music.music';
+}
+/**
+ * Format-neutral export options. Every exporter accepts the same shape
+ * so the CLI command can dispatch via a `--format` flag without inventing
+ * per-format option types.
+ */
+export interface TimelineExportOptions {
+    outputPath: string;
+    /** Video segments in spine order. Caller is responsible for ordering. */
+    segments: TimelineSegment[];
+    /** Connected audio clips. Order within a lane doesn't matter. */
+    audio: TimelineAudioClip[];
+    /** Total sequence duration. Defaults to the cumulative segment duration. */
+    totalDurationSec?: number;
+    /** Frames per second. Defaults to 24. */
+    fps?: number;
+    /** Sequence width in pixels. Defaults to 1920. */
+    width?: number;
+    /** Sequence height in pixels. Defaults to 1080. */
+    height?: number;
+    /** Library / event name. Defaults to "Episode". */
+    eventName?: string;
+    /** Project / sequence name. Defaults to `<eventName> — fine-tune`. */
+    projectName?: string;
+}
+/** @deprecated Use TimelineSegment. */
+export type FcpxmlSegment = TimelineSegment;
+/** @deprecated Use TimelineAudioClip. */
+export type FcpxmlAudioClip = TimelineAudioClip;
+/** @deprecated Use TimelineExportOptions. */
+export type FcpxmlExportOptions = TimelineExportOptions;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/mini-drama/timeline-export/types.ts"],"names":[],"mappings":"AAaA,sDAAsD;AACtD,MAAM,WAAW,eAAe;IAC9B,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,sDAAsD;AACtD,MAAM,WAAW,iBAAiB;IAChC,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,iCAAiC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,yEAAyE;IACzE,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACnB,uFAAuF;IACvF,IAAI,EAAE,mBAAmB,GAAG,iBAAiB,GAAG,aAAa,CAAC;CAC/D;AAED;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,iEAAiE;IACjE,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,4EAA4E;IAC5E,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,yCAAyC;IACzC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mDAAmD;IACnD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mDAAmD;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sEAAsE;IACtE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAMD,uCAAuC;AACvC,MAAM,MAAM,aAAa,GAAG,eAAe,CAAC;AAC5C,yCAAyC;AACzC,MAAM,MAAM,eAAe,GAAG,iBAAiB,CAAC;AAChD,6CAA6C;AAC7C,MAAM,MAAM,mBAAmB,GAAG,qBAAqB,CAAC"}

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

@@ -0,0 +1,14 @@
+// ---------------------------------------------------------------------------
+// Format-neutral types shared by every timeline exporter.
+//
+// The three supported formats (FCPXML 1.10, Resolve-tuned FCPXML, Final
+// Cut Pro 7 xmeml v5 for Premiere) all consume the same input shape — an
+// ordered list of video segments and a flat list of audio clips, each
+// tagged with a lane and a role. The exporter functions translate this
+// neutral form into format-specific XML.
+//
+// Back-compat: `Fcpxml*` type aliases below mirror the previous names that
+// lived in `src/mini-drama/fcpxml-export.ts`.
+// ---------------------------------------------------------------------------
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/mini-drama/timeline-export/types.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,0DAA0D;AAC1D,EAAE;AACF,wEAAwE;AACxE,yEAAyE;AACzE,sEAAsE;AACtE,uEAAuE;AACvE,yCAAyC;AACzC,EAAE;AACF,2EAA2E;AAC3E,8CAA8C;AAC9C,8EAA8E"}

package/dist/mini-drama/video-generator.d.ts

@@ -0,0 +1,22 @@
+import type { VeniceClient } from '../venice/client.js';
+import type { GenerationPlan, SeriesState, ShotScript } from '../series/types.js';
+export interface GenerateEpisodeVideosResult {
+    videoPaths: string[];
+    plan: GenerationPlan;
+}
+/**
+ * Pre-flight check that every shot's requested duration is renderable on the
+ * model it was routed to. Throws a single error listing all violations so the
+ * operator can fix the script in one pass rather than fail-and-retry against
+ * Venice (which returns HTTP 422 deep into the queue call with a generic
+ * message).
+ *
+ * Examples this catches:
+ *   - duration: "16s" routed to seedance-2-0-* (max 15s)
+ *   - duration: "12s" routed to veo3.1-fast-image-to-video (max 8s)
+ *   - duration: "8s" routed to wan-2-7-reference-to-video (max 10s, but step
+ *     restriction — 8s not in [5s, 10s])
+ */
+export declare function assertShotDurationsValid(shots: ShotScript[], plan: GenerationPlan): void;
+export declare function generateEpisodeVideos(client: VeniceClient, series: SeriesState, shots: ShotScript[], sceneDir: string, plan: GenerationPlan, episodeAudioMix?: import('../series/types.js').AudioMixDefaults): Promise<GenerateEpisodeVideosResult>;
+//# sourceMappingURL=video-generator.d.ts.map

package/dist/mini-drama/video-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"video-generator.d.ts","sourceRoot":"","sources":["../../src/mini-drama/video-generator.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,KAAK,EACV,cAAc,EAGd,WAAW,EACX,UAAU,EAEX,MAAM,oBAAoB,CAAC;AAy6C5B,MAAM,WAAW,2BAA2B;IAC1C,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,IAAI,EAAE,cAAc,CAAC;CACtB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,UAAU,EAAE,EACnB,IAAI,EAAE,cAAc,GACnB,IAAI,CAiEN;AAED,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,UAAU,EAAE,EACnB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,cAAc,EACpB,eAAe,CAAC,EAAE,OAAO,oBAAoB,EAAE,gBAAgB,GAC9D,OAAO,CAAC,2BAA2B,CAAC,CAoEtC"}