videowright 0.1.0

package/dist/segment/SegmentRunner.js

@@ -0,0 +1,187 @@
+/**
+ * Thrown when a segment's play() is interrupted by unmount.
+ * Framework code catches this to cleanly unwind segment teardown.
+ *
+ * Extends DOMException so that `isAbortError` can match both this class
+ * and the native AbortError raised by fetch/AbortController in browsers.
+ * The `(message, name)` constructor signature is supported in all modern
+ * browsers and jsdom (our test runner); Node 17+ also supports it.
+ */
+export class SegmentAbortError extends DOMException {
+    constructor() {
+        super("Segment aborted", "AbortError");
+    }
+}
+/** Type guard: true for SegmentAbortError or any DOMException with name "AbortError". */
+export function isAbortError(e) {
+    return e instanceof DOMException && e.name === "AbortError";
+}
+/**
+ * Per-mount wrapper around a Segment. Owns beat counter, resolver queue,
+ * abort controller, and produces the PlayerContext for lifecycle methods.
+ *
+ * Internal to the library -- not exported from the public barrel.
+ */
+export class SegmentRunner {
+    segment;
+    mode;
+    resolvers = [];
+    beatCounter = 0;
+    seekBeatsRemaining;
+    abortCtrl = new AbortController();
+    mountedAt = 0;
+    _playPromise = null;
+    state = "created";
+    constructor(segment, opts) {
+        this.segment = segment;
+        this.mode = opts.mode;
+        this.seekBeatsRemaining = opts.seekBeats ?? 0;
+    }
+    async mount(el) {
+        if (this.state !== "created") {
+            throw new Error("SegmentRunner: already mounted");
+        }
+        this.mountedAt = performance.now();
+        if (this.segment.mount) {
+            await this.segment.mount(el, this.makeContext());
+        }
+        this.state = "mounted";
+    }
+    startPlay() {
+        if (this.state !== "mounted") {
+            throw new Error("SegmentRunner: not mounted");
+        }
+        this.state = "playing";
+        this._playPromise = this.segment
+            .play(this.makeContext())
+            .catch((e) => {
+            // Re-throw non-abort errors; swallow AbortError so play()
+            // resolves cleanly on unmount-triggered teardown.
+            if (!isAbortError(e))
+                throw e;
+        })
+            .finally(() => {
+            if (this.state !== "unmounted") {
+                this.state = "done";
+            }
+        });
+        return this._playPromise;
+    }
+    triggerNext() {
+        if (this.segment.next) {
+            const consumed = this.segment.next();
+            if (consumed === true) {
+                this.beatCounter++;
+                return true;
+            }
+            if (consumed === false)
+                return false;
+            // undefined -> fall through to default
+        }
+        return this.defaultNext();
+    }
+    triggerPrev() {
+        if (this.segment.prev) {
+            const consumed = this.segment.prev();
+            if (consumed === true)
+                return true;
+        }
+        return false;
+    }
+    unmount() {
+        if (this.state === "unmounted")
+            return;
+        this.abortCtrl.abort();
+        if (this.segment.unmount) {
+            try {
+                this.segment.unmount();
+            }
+            catch (e) {
+                console.error("unmount() threw", e);
+            }
+        }
+        // Drain pending resolvers with AbortError so play() unwinds cleanly
+        const abortErr = new SegmentAbortError();
+        while (this.resolvers.length) {
+            const r = this.resolvers.shift();
+            if (r)
+                r.reject(abortErr);
+        }
+        this.state = "unmounted";
+    }
+    get currentBeat() {
+        return this.beatCounter;
+    }
+    get isDone() {
+        return this.state === "done";
+    }
+    get playPromise() {
+        return this._playPromise;
+    }
+    get currentState() {
+        return this.state;
+    }
+    get elapsedSinceMount() {
+        return this.mountedAt > 0 ? performance.now() - this.mountedAt : 0;
+    }
+    // ---- Private -----
+    defaultNext() {
+        if (this.resolvers.length === 0)
+            return false;
+        const r = this.resolvers.shift();
+        if (r) {
+            this.beatCounter++;
+            r.resolve();
+        }
+        return true;
+    }
+    makeContext() {
+        return {
+            waitForNext: () => {
+                if (this.seekBeatsRemaining > 0) {
+                    this.seekBeatsRemaining--;
+                    this.beatCounter++;
+                    return Promise.resolve();
+                }
+                return new Promise((resolve, reject) => {
+                    if (this.state === "unmounted") {
+                        reject(new SegmentAbortError());
+                        return;
+                    }
+                    this.resolvers.push({ resolve, reject });
+                });
+            },
+            hold: (ms) => {
+                // Both modes use real setTimeout. In render mode, the JS time shim
+                // virtualizes setTimeout so it fires when the driver advances the
+                // virtual clock, giving deterministic behavior.
+                return new Promise((resolve, reject) => {
+                    if (this.abortCtrl.signal.aborted) {
+                        reject(new SegmentAbortError());
+                        return;
+                    }
+                    const onAbort = () => {
+                        clearTimeout(t);
+                        reject(new SegmentAbortError());
+                    };
+                    const t = setTimeout(() => {
+                        this.abortCtrl.signal.removeEventListener("abort", onAbort);
+                        resolve();
+                    }, ms);
+                    this.abortCtrl.signal.addEventListener("abort", onAbort, {
+                        once: true,
+                    });
+                });
+            },
+            signal: this.abortCtrl.signal,
+            mode: this.mode,
+            clock: () => {
+                // Both modes use performance.now(). In render mode, the JS time
+                // shim virtualizes performance.now() so this returns deterministic
+                // virtual time.
+                return performance.now() - this.mountedAt;
+            },
+        };
+    }
+}
+//# sourceMappingURL=SegmentRunner.js.map

package/dist/segment/SegmentRunner.js.map

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

package/dist/segment/defineConfig.d.ts

@@ -0,0 +1,6 @@
+import type { Config } from "../types.js";
+/**
+ * Identity function for typed config authoring in videowright.config.ts.
+ */
+export declare function defineConfig(config: Config): Config;
+//# sourceMappingURL=defineConfig.d.ts.map

package/dist/segment/defineConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineConfig.d.ts","sourceRoot":"","sources":["../../src/segment/defineConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEnD"}

package/dist/segment/defineConfig.js

@@ -0,0 +1,7 @@
+/**
+ * Identity function for typed config authoring in videowright.config.ts.
+ */
+export function defineConfig(config) {
+    return config;
+}
+//# sourceMappingURL=defineConfig.js.map

package/dist/segment/defineConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineConfig.js","sourceRoot":"","sources":["../../src/segment/defineConfig.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,MAAc;IAC1C,OAAO,MAAM,CAAC;AACf,CAAC"}

package/dist/segment/defineSegment.d.ts

@@ -0,0 +1,7 @@
+import { type Segment, type SegmentSpec } from "../types.js";
+/**
+ * Author a segment with strict typing and brand validation.
+ * Runtime guards cover JS consumers; TS strict catches at compile time.
+ */
+export declare function defineSegment(spec: SegmentSpec): Segment;
+//# sourceMappingURL=defineSegment.d.ts.map

package/dist/segment/defineSegment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineSegment.d.ts","sourceRoot":"","sources":["../../src/segment/defineSegment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAE5E;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAsBxD"}

package/dist/segment/defineSegment.js

@@ -0,0 +1,25 @@
+import { SEGMENT_BRAND } from "../types.js";
+/**
+ * Author a segment with strict typing and brand validation.
+ * Runtime guards cover JS consumers; TS strict catches at compile time.
+ */
+export function defineSegment(spec) {
+    if (!spec.id)
+        throw new TypeError("defineSegment: id is required");
+    if (!spec.play)
+        throw new TypeError("defineSegment: play is required");
+    if (!spec.advances || !Array.isArray(spec.advances) || spec.advances.length === 0) {
+        throw new TypeError(`defineSegment: advances is required and must be a non-empty array (segment "${spec.id}")`);
+    }
+    for (let i = 0; i < spec.advances.length; i++) {
+        const v = spec.advances[i];
+        if (typeof v !== "number" || v <= 0 || !Number.isFinite(v)) {
+            throw new TypeError(`defineSegment: advances[${i}] must be a positive number (segment "${spec.id}", got ${v})`);
+        }
+        if (i > 0 && v <= spec.advances[i - 1]) {
+            throw new TypeError(`defineSegment: advances must be monotonically increasing (segment "${spec.id}", advances[${i}]=${v} <= advances[${i - 1}]=${spec.advances[i - 1]})`);
+        }
+    }
+    return Object.freeze({ ...spec, [SEGMENT_BRAND]: true });
+}
+//# sourceMappingURL=defineSegment.js.map

package/dist/segment/defineSegment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineSegment.js","sourceRoot":"","sources":["../../src/segment/defineSegment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAkC,MAAM,aAAa,CAAC;AAE5E;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,IAAiB;IAC9C,IAAI,CAAC,IAAI,CAAC,EAAE;QAAE,MAAM,IAAI,SAAS,CAAC,+BAA+B,CAAC,CAAC;IACnE,IAAI,CAAC,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,SAAS,CAAC,iCAAiC,CAAC,CAAC;IACvE,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnF,MAAM,IAAI,SAAS,CAClB,+EAA+E,IAAI,CAAC,EAAE,IAAI,CAC1F,CAAC;IACH,CAAC;IACD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC/C,MAAM,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QAC3B,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5D,MAAM,IAAI,SAAS,CAClB,2BAA2B,CAAC,yCAAyC,IAAI,CAAC,EAAE,UAAU,CAAC,GAAG,CAC1F,CAAC;QACH,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YACxC,MAAM,IAAI,SAAS,CAClB,sEAAsE,IAAI,CAAC,EAAE,eAAe,CAAC,KAAK,CAAC,gBAAgB,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CACpJ,CAAC;QACH,CAAC;IACF,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC,aAAa,CAAC,EAAE,IAAa,EAAE,CAAC,CAAC;AACnE,CAAC"}

package/dist/segment/index.d.ts

@@ -0,0 +1,5 @@
+export { defineSegment } from "./defineSegment.js";
+export { defineConfig } from "./defineConfig.js";
+export { SegmentRunner } from "./SegmentRunner.js";
+export type { SegmentRunnerOptions } from "./SegmentRunner.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/segment/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/segment/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,YAAY,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/segment/index.js

@@ -0,0 +1,4 @@
+export { defineSegment } from "./defineSegment.js";
+export { defineConfig } from "./defineConfig.js";
+export { SegmentRunner } from "./SegmentRunner.js";
+//# sourceMappingURL=index.js.map

package/dist/segment/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/segment/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/timeline/index.d.ts

@@ -0,0 +1,73 @@
+import type { Config, ResolvedTimelineMeta, Segment, Timeline, Transition } from "../types.js";
+export { resolveTiming } from "./resolveTiming.js";
+export type { ResolvedTiming, ResolveTimingArgs, TimingSegment } from "./resolveTiming.js";
+export type SegmentLoaderMap = Map<string, () => Promise<{
+    default: Segment;
+}>>;
+export type TransitionLoaderMap = Map<string, () => Promise<{
+    default: Transition;
+}>>;
+export type TimelineError = {
+    kind: "missing-segment";
+    segmentId: string;
+    timelineTitle: string;
+} | {
+    kind: "missing-transition";
+    transitionName: string;
+    segmentId: string;
+} | {
+    kind: "missing-title";
+} | {
+    kind: "malformed-segment-path";
+    path: string;
+};
+export type TimelineValidationResult = {
+    ok: true;
+    timeline: Timeline;
+} | {
+    ok: false;
+    errors: TimelineError[];
+};
+/**
+ * Build a segment id -> loader map from a Vite glob result.
+ * Input: Record<string, () => Promise<unknown>> from import.meta.glob('/segments/* /index.ts').
+ */
+export declare function buildSegmentLoaderMap(globResult: Record<string, () => Promise<unknown>>): SegmentLoaderMap;
+/**
+ * Build a transition name -> loader map, combining built-ins with user-registered transitions.
+ */
+export declare function buildTransitionLoaderMap(config: Config): TransitionLoaderMap;
+/**
+ * Validate a timeline against segment and transition loader maps.
+ * Returns ok:true with the timeline, or ok:false with accumulated errors.
+ */
+export declare function validateTimeline(timeline: Timeline, segmentLoaders: SegmentLoaderMap, transitionLoaders: TransitionLoaderMap): TimelineValidationResult;
+export type AdvancesValidationResult = {
+    ok: true;
+} | {
+    ok: false;
+    errors: string[];
+};
+/**
+ * Validate that all segments referenced by a timeline have valid `advances` arrays.
+ *
+ * Accepts a `Record<string, number[]>` mapping segment id to its advances array.
+ * This map is produced in the browser context (entry_video.ts / render_entry.ts)
+ * where segment modules are loaded via Vite and can import browser-only assets
+ * (CSS, JSON, images) that Node's tsImport cannot handle.
+ *
+ * Checks per segment:
+ * - `advances` is defined and non-empty.
+ * - `advances` is monotonically increasing.
+ * - All entries are positive numbers.
+ */
+export declare function validateSegmentAdvances(timeline: Timeline, advancesMap: Record<string, number[]>): AdvancesValidationResult;
+/**
+ * Apply config defaults to timeline meta. Returns a new Timeline without mutating.
+ * Priority: timeline meta > config.defaults > hardcoded fallbacks.
+ * The returned meta is guaranteed to have resolution, fps, and aspectRatio set.
+ */
+export declare function applyMetaDefaults(timeline: Timeline, config: Config): Timeline & {
+    meta: ResolvedTimelineMeta;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/timeline/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/timeline/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,oBAAoB,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAM/F,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAI3F,MAAM,MAAM,gBAAgB,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC,CAAC;AAChF,MAAM,MAAM,mBAAmB,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC;IAAE,OAAO,EAAE,UAAU,CAAA;CAAE,CAAC,CAAC,CAAC;AAItF,MAAM,MAAM,aAAa,GACtB;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,GACrE;IAAE,IAAI,EAAE,oBAAoB,CAAC;IAAC,cAAc,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACzE;IAAE,IAAI,EAAE,eAAe,CAAA;CAAE,GACzB;IAAE,IAAI,EAAE,wBAAwB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpD,MAAM,MAAM,wBAAwB,GACjC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAA;CAAE,GAChC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,aAAa,EAAE,CAAA;CAAE,CAAC;AAQ1C;;;GAGG;AACH,wBAAgB,qBAAqB,CACpC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC,GAChD,gBAAgB,CAsBlB;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,mBAAmB,CA4B5E;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC/B,QAAQ,EAAE,QAAQ,EAClB,cAAc,EAAE,gBAAgB,EAChC,iBAAiB,EAAE,mBAAmB,GACpC,wBAAwB,CAoC1B;AAID,MAAM,MAAM,wBAAwB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAEtF;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,CACtC,QAAQ,EAAE,QAAQ,EAClB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GACnC,wBAAwB,CA+B1B;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAChC,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,MAAM,GACZ,QAAQ,GAAG;IAAE,IAAI,EAAE,oBAAoB,CAAA;CAAE,CAW3C"}

package/dist/timeline/index.js

@@ -0,0 +1,142 @@
+// Re-export browser-safe helpers only.
+// Node-only helpers (loadVoiceover, loadAudioTrack, validateTiming, validateAudioTrack) are
+// imported directly from their own modules by CLI code to avoid pulling
+// node:fs into browser bundles.
+export { resolveTiming } from "./resolveTiming.js";
+// ---- Segment path regex ----
+const SEGMENT_PATH_RE = /^\/segments\/([^/]+)\/index\.ts$/;
+// ---- Functions ----
+/**
+ * Build a segment id -> loader map from a Vite glob result.
+ * Input: Record<string, () => Promise<unknown>> from import.meta.glob('/segments/* /index.ts').
+ */
+export function buildSegmentLoaderMap(globResult) {
+    const map = new Map();
+    const warnings = [];
+    for (const path of Object.keys(globResult)) {
+        const m = path.match(SEGMENT_PATH_RE);
+        if (!m) {
+            warnings.push({ kind: "malformed-segment-path", path });
+            continue;
+        }
+        const id = m[1];
+        if (map.has(id)) {
+            throw new Error(`Duplicate segment id: ${id} (path: ${path})`);
+        }
+        map.set(id, globResult[path]);
+    }
+    if (warnings.length) {
+        console.warn("buildSegmentLoaderMap: some paths skipped", warnings);
+    }
+    return map;
+}
+/**
+ * Build a transition name -> loader map, combining built-ins with user-registered transitions.
+ */
+export function buildTransitionLoaderMap(config) {
+    const map = new Map();
+    // Built-ins
+    map.set("cut", () => import("../player/transitions/cut.js"));
+    map.set("fade", () => import("../player/transitions/fade.js"));
+    map.set("slideLeft", () => import("../player/transitions/slide.js").then((m) => ({ default: m.slideLeft })));
+    map.set("slideRight", () => import("../player/transitions/slide.js").then((m) => ({ default: m.slideRight })));
+    map.set("slideUp", () => import("../player/transitions/slide.js").then((m) => ({ default: m.slideUp })));
+    map.set("slideDown", () => import("../player/transitions/slide.js").then((m) => ({ default: m.slideDown })));
+    // User-registered
+    for (const [name, loader] of Object.entries(config.transitions ?? {})) {
+        if (map.has(name)) {
+            console.warn(`Custom transition "${name}" shadows a built-in.`);
+        }
+        map.set(name, loader);
+    }
+    return map;
+}
+/**
+ * Validate a timeline against segment and transition loader maps.
+ * Returns ok:true with the timeline, or ok:false with accumulated errors.
+ */
+export function validateTimeline(timeline, segmentLoaders, transitionLoaders) {
+    const errors = [];
+    if (!timeline.meta.title || timeline.meta.title.trim() === "") {
+        errors.push({ kind: "missing-title" });
+    }
+    const titleForErrors = timeline.meta.title && timeline.meta.title.trim() !== "" ? timeline.meta.title : "(untitled)";
+    for (const entry of timeline.segments) {
+        if (!segmentLoaders.has(entry.id)) {
+            errors.push({
+                kind: "missing-segment",
+                segmentId: entry.id,
+                timelineTitle: titleForErrors,
+            });
+        }
+        if (entry.transition) {
+            const transitionName = typeof entry.transition === "string" ? entry.transition : entry.transition.type;
+            if (!transitionLoaders.has(transitionName)) {
+                errors.push({
+                    kind: "missing-transition",
+                    transitionName,
+                    segmentId: entry.id,
+                });
+            }
+        }
+    }
+    if (errors.length > 0) {
+        return { ok: false, errors };
+    }
+    return { ok: true, timeline };
+}
+/**
+ * Validate that all segments referenced by a timeline have valid `advances` arrays.
+ *
+ * Accepts a `Record<string, number[]>` mapping segment id to its advances array.
+ * This map is produced in the browser context (entry_video.ts / render_entry.ts)
+ * where segment modules are loaded via Vite and can import browser-only assets
+ * (CSS, JSON, images) that Node's tsImport cannot handle.
+ *
+ * Checks per segment:
+ * - `advances` is defined and non-empty.
+ * - `advances` is monotonically increasing.
+ * - All entries are positive numbers.
+ */
+export function validateSegmentAdvances(timeline, advancesMap) {
+    const errors = [];
+    for (const entry of timeline.segments) {
+        const advances = advancesMap[entry.id];
+        if (!advances || !Array.isArray(advances) || advances.length === 0) {
+            errors.push(`Segment "${entry.id}": missing or empty 'advances' array. Every segment must declare advances for render timing.`);
+            continue;
+        }
+        for (let i = 0; i < advances.length; i++) {
+            const v = advances[i];
+            if (typeof v !== "number" || v <= 0 || !Number.isFinite(v)) {
+                errors.push(`Segment "${entry.id}": advances[${i}] must be a positive number (got ${v})`);
+            }
+            if (i > 0 && v <= advances[i - 1]) {
+                errors.push(`Segment "${entry.id}": advances must be monotonically increasing ` +
+                    `(advances[${i}]=${v} <= advances[${i - 1}]=${advances[i - 1]})`);
+            }
+        }
+    }
+    if (errors.length > 0) {
+        return { ok: false, errors };
+    }
+    return { ok: true };
+}
+/**
+ * Apply config defaults to timeline meta. Returns a new Timeline without mutating.
+ * Priority: timeline meta > config.defaults > hardcoded fallbacks.
+ * The returned meta is guaranteed to have resolution, fps, and aspectRatio set.
+ */
+export function applyMetaDefaults(timeline, config) {
+    const d = config.defaults ?? {};
+    return {
+        ...timeline,
+        meta: {
+            ...timeline.meta,
+            resolution: timeline.meta.resolution ?? d.resolution ?? [1920, 1080],
+            fps: timeline.meta.fps ?? d.fps ?? 60,
+            aspectRatio: timeline.meta.aspectRatio ?? d.aspectRatio ?? "16:9",
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/timeline/index.js.map

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

package/dist/timeline/loadAudioTrack.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Load an audio track module from disk.
+ *
+ * Resolves the track.ts file via the shared ts-loader, then
+ * resolves audio_file to an absolute path.
+ */
+import type { AudioTrack } from "../types.js";
+export interface LoadAudioTrackArgs {
+    videoFolder: string;
+    trackId: string;
+}
+export interface LoadAudioTrackResult {
+    audioTrack: AudioTrack;
+    trackFolder: string;
+    audioFilePath: string;
+}
+export declare function loadAudioTrack(args: LoadAudioTrackArgs): Promise<LoadAudioTrackResult>;
+//# sourceMappingURL=loadAudioTrack.d.ts.map

package/dist/timeline/loadAudioTrack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadAudioTrack.d.ts","sourceRoot":"","sources":["../../src/timeline/loadAudioTrack.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,WAAW,kBAAkB;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,oBAAoB;IACpC,UAAU,EAAE,UAAU,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;CACtB;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA0D5F"}

package/dist/timeline/loadAudioTrack.js

@@ -0,0 +1,44 @@
+/**
+ * Load an audio track module from disk.
+ *
+ * Resolves the track.ts file via the shared ts-loader, then
+ * resolves audio_file to an absolute path.
+ */
+import { existsSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { UserError } from "../cli/errors.js";
+import { loadModule } from "../cli/ts_loader.js";
+export async function loadAudioTrack(args) {
+    const { videoFolder, trackId } = args;
+    const trackPath = resolve(videoFolder, "audio", "tracks", trackId, "track.ts");
+    if (!existsSync(trackPath)) {
+        throw new UserError(`Audio track not found: ${trackPath}`, `Check that audio/tracks/${trackId}/track.ts exists in your video folder.`);
+    }
+    const mod = await loadModule(trackPath);
+    const audioTrack = mod.default;
+    if (!audioTrack || typeof audioTrack !== "object" || !audioTrack.audio_file) {
+        throw new UserError(`Invalid audio track module at ${trackPath}`, "The track.ts file must default-export an AudioTrack with audio_file, length_s, and timing.");
+    }
+    if (typeof audioTrack.length_s !== "number" || !Number.isFinite(audioTrack.length_s)) {
+        throw new UserError(`Audio track missing valid length_s in ${trackPath}`, `track.ts must export length_s as a finite number (got ${typeof audioTrack.length_s}).`);
+    }
+    if (!audioTrack.timing ||
+        typeof audioTrack.timing !== "object" ||
+        typeof audioTrack.timing.perSegment !== "object" ||
+        audioTrack.timing.perSegment === null) {
+        throw new UserError(`Audio track missing valid timing in ${trackPath}`, "track.ts must export a timing object with a perSegment field.");
+    }
+    const trackFolder = dirname(trackPath);
+    // audio_file is relative to the video folder (the same convention used when
+    // the track is imported as default_audio_track in timeline.ts).
+    const audioFilePath = resolve(videoFolder, audioTrack.audio_file);
+    if (!existsSync(audioFilePath)) {
+        throw new UserError(`Audio track file not found: ${audioFilePath}`, `The audio_file "${audioTrack.audio_file}" referenced in ${trackPath} does not exist. Re-run the audio build step.`);
+    }
+    const resolvedAudioTrack = {
+        ...audioTrack,
+        audio_file: audioFilePath,
+    };
+    return { audioTrack: resolvedAudioTrack, trackFolder, audioFilePath };
+}
+//# sourceMappingURL=loadAudioTrack.js.map

package/dist/timeline/loadAudioTrack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadAudioTrack.js","sourceRoot":"","sources":["../../src/timeline/loadAudioTrack.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAcjD,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAwB;IAC5D,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAEtC,MAAM,SAAS,GAAG,OAAO,CAAC,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;IAC/E,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,SAAS,CAClB,0BAA0B,SAAS,EAAE,EACrC,2BAA2B,OAAO,wCAAwC,CAC1E,CAAC;IACH,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,UAAU,CAAC,SAAS,CAAC,CAAC;IACxC,MAAM,UAAU,GAAG,GAAG,CAAC,OAAqB,CAAC;IAE7C,IAAI,CAAC,UAAU,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC;QAC7E,MAAM,IAAI,SAAS,CAClB,iCAAiC,SAAS,EAAE,EAC5C,4FAA4F,CAC5F,CAAC;IACH,CAAC;IAED,IAAI,OAAO,UAAU,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACtF,MAAM,IAAI,SAAS,CAClB,yCAAyC,SAAS,EAAE,EACpD,yDAAyD,OAAO,UAAU,CAAC,QAAQ,IAAI,CACvF,CAAC;IACH,CAAC;IAED,IACC,CAAC,UAAU,CAAC,MAAM;QAClB,OAAO,UAAU,CAAC,MAAM,KAAK,QAAQ;QACrC,OAAO,UAAU,CAAC,MAAM,CAAC,UAAU,KAAK,QAAQ;QAChD,UAAU,CAAC,MAAM,CAAC,UAAU,KAAK,IAAI,EACpC,CAAC;QACF,MAAM,IAAI,SAAS,CAClB,uCAAuC,SAAS,EAAE,EAClD,+DAA+D,CAC/D,CAAC;IACH,CAAC;IAED,MAAM,WAAW,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IACvC,4EAA4E;IAC5E,gEAAgE;IAChE,MAAM,aAAa,GAAG,OAAO,CAAC,WAAW,EAAE,UAAU,CAAC,UAAU,CAAC,CAAC;IAElE,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,SAAS,CAClB,+BAA+B,aAAa,EAAE,EAC9C,mBAAmB,UAAU,CAAC,UAAU,mBAAmB,SAAS,+CAA+C,CACnH,CAAC;IACH,CAAC;IAED,MAAM,kBAAkB,GAAe;QACtC,GAAG,UAAU;QACb,UAAU,EAAE,aAAa;KACzB,CAAC;IAEF,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,WAAW,EAAE,aAAa,EAAE,CAAC;AACvE,CAAC"}

package/dist/timeline/loadVoiceover.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Load a voiceover module from disk.
+ *
+ * Resolves the voiceover.ts file via the shared ts-loader, then
+ * resolves audio_file and provider_timing_file to absolute paths.
+ */
+import type { Voiceover } from "../types.js";
+export interface LoadVoiceoverArgs {
+    videoFolder: string;
+    slug: string;
+}
+export interface LoadVoiceoverResult {
+    voiceover: Voiceover;
+    voiceoverFolder: string;
+    audioFilePath: string;
+}
+export declare function loadVoiceover(args: LoadVoiceoverArgs): Promise<LoadVoiceoverResult>;
+//# sourceMappingURL=loadVoiceover.d.ts.map

package/dist/timeline/loadVoiceover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadVoiceover.d.ts","sourceRoot":"","sources":["../../src/timeline/loadVoiceover.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,WAAW,iBAAiB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,mBAAmB;IACnC,SAAS,EAAE,SAAS,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;CACtB;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAiDzF"}