video-editing 1.3.1

package/dist/index.d.ts

@@ -0,0 +1,3569 @@
+import { z } from 'zod';
+
+type TokenType = "word" | "spacing" | "audio_event";
+/** A single ElevenLabs Scribe token (word-level, verbatim). */
+interface ScribeWord {
+    type?: TokenType;
+    text?: string;
+    start: number | null;
+    end: number | null;
+    speaker_id?: string | null;
+    [extra: string]: unknown;
+}
+interface ScribeTranscript {
+    language_code?: string;
+    text?: string;
+    words: ScribeWord[];
+    [extra: string]: unknown;
+}
+/** One KEEP segment in SOURCE seconds. Gaps between ranges are the cuts. */
+interface EdlRange {
+    source: string;
+    start: number;
+    end: number;
+    beat?: string;
+    quote?: string;
+    reason?: string;
+    /** Optional per-range grade override (preset name | raw ffmpeg filter | "auto"). */
+    grade?: string;
+}
+interface EdlOverlay {
+    [k: string]: unknown;
+}
+interface Edl {
+    version: number;
+    sources: Record<string, string>;
+    /** "none" | preset name | raw ffmpeg filter | "auto" */
+    grade: string;
+    ranges: EdlRange[];
+    overlays: EdlOverlay[];
+    total_duration_s: number;
+    /** Optional explicit subtitle path. */
+    subtitles?: string;
+    /** Set once the amplitude silence-trim pass has rewritten the ranges. */
+    desilenced?: boolean;
+}
+interface SourceJson {
+    created: string;
+    source: string;
+    stem: string;
+    job_dir: string;
+    duration_s: number;
+    stored_width: number;
+    stored_height: number;
+    display_width: number;
+    display_height: number;
+    rotation: number;
+    probe: FfprobeResult;
+}
+interface FfprobeStream {
+    index?: number;
+    codec_type?: string;
+    codec_name?: string;
+    width?: number;
+    height?: number;
+    r_frame_rate?: string;
+    avg_frame_rate?: string;
+    duration?: string;
+    color_transfer?: string;
+    side_data_list?: Array<Record<string, unknown>>;
+    tags?: Record<string, string>;
+    [extra: string]: unknown;
+}
+interface FfprobeResult {
+    streams?: FfprobeStream[];
+    format?: {
+        duration?: string;
+        size?: string;
+        format_name?: string;
+        [k: string]: unknown;
+    };
+    [extra: string]: unknown;
+}
+interface CutBoundary {
+    index: number;
+    output_time_s: number;
+    removed_source_gap_s: number;
+    source_before: number;
+    source_after: number;
+}
+type RenderMode = "preview" | "draft" | "final";
+interface ReviewIssue {
+    where?: string;
+    range_index?: number | null;
+    severity?: "error" | "warning" | "info";
+    problem?: string;
+    fix?: string;
+}
+interface ReviewJson {
+    verdict?: "clean" | "needs-fixes";
+    issues?: ReviewIssue[];
+    confidence?: string;
+}
+interface Warning {
+    id: string;
+    severity: string;
+    output_time_s: number;
+    range_index: number | null | undefined;
+    problem: string;
+    fix: string;
+}
+interface VerifyJoinFinding {
+    index: number;
+    output_time_s: number;
+    duplicated_phrase?: string;
+    gap_s?: number;
+    severity: "error" | "warning" | "info";
+    detail: string;
+}
+interface VerifyResult {
+    verdict: "clean" | "needs-fixes";
+    mode: "full" | "joins";
+    joins: VerifyJoinFinding[];
+    confidence: string;
+}
+
+interface RunResult {
+    code: number;
+    stdout: string;
+    stderr: string;
+}
+interface RunOptions {
+    /** Capture stdout/stderr into strings (default: inherit to the terminal). */
+    capture?: boolean;
+    /** Write merged stdout+stderr to this file path. */
+    stdoutPath?: string;
+    cwd?: string;
+    /** Throw on non-zero exit (default true). */
+    check?: boolean;
+    /** Echo the command (default true) — mirrors the Python "+ <cmd>" trace. */
+    echo?: boolean;
+}
+declare function shown(cmd: string[]): string;
+declare class CommandError extends Error {
+    code: number;
+    result: RunResult;
+    constructor(message: string, code: number, result: RunResult);
+}
+/** Run a command, streaming or capturing output. Async. */
+declare function run(cmd: string[], opts?: RunOptions): Promise<RunResult>;
+/** Synchronous run (used by a few hot paths / parity tooling). */
+declare function runSync(cmd: string[], opts?: {
+    check?: boolean;
+    echo?: boolean;
+}): RunResult;
+/** ffprobe -of json, parsed. Mirrors cli.py ffprobe(). */
+declare function ffprobe(path: string): Promise<FfprobeResult>;
+declare function videoStream(probe: FfprobeResult): FfprobeStream;
+declare function mediaDuration(path: string): Promise<number>;
+/** Assert ffmpeg + ffprobe are on PATH. */
+declare function requireFfmpeg(): void;
+
+declare function configDir(): string;
+declare function configEnvPath(): string;
+interface KeyOptions {
+    /** explicit --api-key value (highest precedence after env var miss) */
+    apiKey?: string;
+    /** extra .env path to check (e.g. for tests) */
+    envPath?: string;
+}
+/** Resolve the ElevenLabs API key or throw with a clear message. */
+declare function loadApiKey(opts?: KeyOptions): string;
+
+declare function slugify(value: string): string;
+declare function isoNow(): string;
+/** Round to `ndigits` using round-half-to-even (Python's round()). */
+declare function pyRound(x: number, ndigits?: number): number;
+/** Format like Python f"{x:.<prec>f}" (fixed-point, round-half-even-ish). */
+declare function pyFixed(x: number, prec: number): string;
+/** Python f"{x:0<width>.<prec>f}" — zero-padded fixed width incl. sign/dot. */
+declare function pyFixedPad(x: number, width: number, prec: number): string;
+/** Python f"{x:<width>.<prec>f}" — space-padded (right-aligned). */
+declare function pySpacePad(x: number, width: number, prec: number): string;
+
+declare function rotationDegrees(stream: FfprobeStream): number;
+/** Returns [displayWidth, displayHeight, rotation] accounting for rotation flags. */
+declare function displayedDimensions(stream: FfprobeStream): [number, number, number];
+
+declare const DEFAULT_EDIT_ROOT: string;
+declare const VIDEO_EXTS: Set<string>;
+declare function defaultJobDir(source: string): string;
+declare function transcriptPath(jobDir: string, stem: string): string;
+declare function initJob(source: string, jobDir: string | null, opts?: {
+    force?: boolean;
+}): Promise<string>;
+declare function loadJob(jobDir: string): SourceJson;
+declare function sourceFromJob(jobDir: string): string;
+interface ResolvedJob {
+    jobDir: string;
+    source: string;
+    stem: string;
+}
+/** Resolve a job from a --source or --job-dir argument. */
+declare function resolveJob(args: {
+    source?: string;
+    jobDir?: string;
+}, opts?: {
+    forceJob?: boolean;
+}): Promise<ResolvedJob>;
+
+declare function ensureVerticalMaster(jobDir: string, source: string, opts?: {
+    force?: boolean;
+}): Promise<string>;
+
+interface TranscribeOptions {
+    editDir: string;
+    language?: string;
+    numSpeakers?: number;
+    noHeal?: boolean;
+    force?: boolean;
+    apiKey?: string;
+    verbose?: boolean;
+}
+/**
+ * Transcribe a single video. Returns the path to the transcript JSON.
+ * Cached: returns the existing path immediately if the transcript already
+ * exists (unless `force`). Mirrors transcribe_one().
+ */
+declare function transcribeOne(video: string, opts: TranscribeOptions): Promise<string>;
+
+interface BatchOptions {
+    workers?: number;
+    language?: string;
+    numSpeakers?: number;
+    editDir?: string;
+    apiKey?: string;
+}
+interface BatchResult {
+    videos: string[];
+    cached: string[];
+    transcribed: string[];
+    errors: Array<{
+        video: string;
+        message: string;
+    }>;
+}
+/**
+ * Batch transcription. Returns a summary of which files were cached,
+ * transcribed, and which failed. Mirrors transcribe_batch.main().
+ */
+declare function transcribeBatch(videosDir: string, opts?: BatchOptions): Promise<BatchResult>;
+
+/**
+ * Screen a single transcript and return the report text exactly as
+ * flag_takes.py prints it to stdout (this is what gets written to flags.txt).
+ */
+declare function screenTakes(transcriptPath: string, opts?: {
+    offset?: number;
+    longToken?: number;
+    gap?: number;
+}): string;
+
+interface PackTranscriptsOptions {
+    silenceThreshold?: number;
+    output?: string;
+}
+declare function packTranscripts(editDir: string, opts?: PackTranscriptsOptions): {
+    path: string;
+    content: string;
+};
+
+declare const PRESETS: Record<string, string>;
+/** Return the ffmpeg filter string for a preset name. Empty string for 'none'.
+ *  Throws (like Python's KeyError) for unknown presets. */
+declare function getPreset(name: string): string;
+interface GradeStats {
+    y_mean: number;
+    y_range: number;
+    sat_mean: number;
+}
+/** Pure decision logic — mirrors auto_grade_for_clip's decision rules exactly.
+ *  Bounded to ±8% on any axis, NO color shift. Unit-testable without ffmpeg. */
+declare function decideGradeFilter(stats: GradeStats): string;
+/** Analyze a clip and return the computed auto-grade `eq=...` filter string
+ *  (or "" for passthrough). Bounded to ±8% on any axis, NO color shift.
+ *
+ *  Probes the clip duration via ffprobe (matching Python's default behavior),
+ *  samples frames via ffmpeg signalstats, then applies the bounded decision
+ *  rules. Equivalent to Python's auto_grade_for_clip(video)[0]. */
+declare function autoGradeForClip(input: string): Promise<string>;
+
+interface RenderOptions {
+    preview?: boolean;
+    draft?: boolean;
+    buildSubtitles?: boolean;
+    noSubtitles?: boolean;
+    noLoudnorm?: boolean;
+}
+/** Render a video from an EDL. Mirrors render.py main(). */
+declare function render(edlPath: string, output: string, opts?: RenderOptions): Promise<void>;
+
+/**
+ * Compute a windowed-RMS envelope of length `samples` from raw Int16 PCM.
+ *
+ * Pure port of the math in Python's compute_envelope() (after WAV parsing):
+ *   - convert to float32 / 32768
+ *   - window = max(1, floor(n / samples))
+ *   - reshape to (-1, window) over the usable prefix, RMS per window
+ *   - pad with zeros / truncate to `samples`
+ *   - normalize by max so values land in [0, 1]
+ *
+ * Returns all-zeros of length `samples` for empty input.
+ */
+declare function computeEnvelope(pcm: Int16Array, samples: number): number[];
+interface TimelineViewOptions {
+    /** Number of frames in the filmstrip (default 10). */
+    nFrames?: number;
+    /** Path to a transcript.json for word labels + silence shading. */
+    transcript?: string;
+}
+/**
+ * Render a filmstrip + waveform composite PNG for [start, end] of `video` to
+ * `output`. Faithful port of render_timeline() in timeline_view.py.
+ *
+ * The caller must pass `end < duration`; we clamp `end` to the media duration
+ * internally (same defensive behavior as the Python EOF guard) to avoid the
+ * end-window-at-EOF failure.
+ */
+declare function timelineView(video: string, start: number, end: number, output: string, opts?: TimelineViewOptions): Promise<void>;
+
+interface VerifyOptions {
+    full?: boolean;
+    windowS?: number;
+    gapThresholdS?: number;
+    apiKey?: string;
+}
+interface TimedWord {
+    text: string;
+    norm: string;
+    start: number;
+    end: number;
+}
+interface DupSpan {
+    /** The full matched text (abandoned take + keeper). */
+    text: string;
+    /** The repeated n-gram length in tokens. 2 = a bare two-word repeat (often
+     *  emphasis / a spelled acronym like "WW" → "דבל יו דבל יו" / a spoken number),
+     *  >= 3 = a restarted clause (the strong retake fingerprint). */
+    n: number;
+}
+/**
+ * ALL near-adjacent repeated phrases (the retake fingerprint), left to right.
+ * Reports the longest match at each position and skips past it, so a stumbly
+ * source with several within-window stutters surfaces every one (not just the
+ * first). Intentional rhetorical repeats ("X? Y X?") also match — the editor
+ * adjudicates those. Each span carries its n-gram length so callers can weight
+ * a 3+-word clause restart (almost always a real retake) above a bare 2-word
+ * repeat (frequently a spelled acronym / number / emphasis, not a retake).
+ */
+declare function duplicatedSpans(words: TimedWord[]): DupSpan[];
+/** ALL near-adjacent repeated phrases as plain text (back-compat). */
+declare function duplicatedPhrases(words: TimedWord[]): string[];
+/** First near-adjacent duplicate (back-compat helper). */
+declare function duplicatedPhrase(words: TimedWord[]): string | null;
+/** Largest inter-word gap that straddles `joinOffset` (window-relative seconds). */
+declare function straddlingGap(words: TimedWord[], joinOffset: number): number;
+declare function verify(jobDir: string, opts?: VerifyOptions): Promise<VerifyResult>;
+
+interface SilenceInterval {
+    start: number;
+    end: number;
+}
+interface DesilenceOptions {
+    /** Silence threshold in dB (ffmpeg silencedetect `noise`). Default -39. */
+    noiseDb: number;
+    /** Minimum silence length (s) to act on — also silencedetect `d`. Default 0.30. */
+    minSilence: number;
+    /** Total air (s) to leave where an internal silence is cut. Default 0.13. */
+    targetGap: number;
+    /** Air kept BEFORE speech resumes at a cut / leading edge. Default 0.05. */
+    leadKeep: number;
+    /** Air kept AFTER speech ends at a cut / trailing edge. Default 0.08. */
+    trailKeep: number;
+    /** Drop any resulting sub-range shorter than this (s). Default 0.10. */
+    minSegment: number;
+}
+declare const DEFAULT_DESILENCE: DesilenceOptions;
+/** ffmpeg argv for an amplitude silence scan. No video, null muxer; the report
+ *  lands on stderr. Pure (no execution). */
+declare function silenceDetectArgs(source: string, noiseDb: number, minSilenceS: number): string[];
+/** Parse `silence_start:` / `silence_end:` pairs out of ffmpeg stderr.
+ *  A dangling silence_start (silence runs to EOF) is closed at `sourceDurationS`
+ *  when provided (>0), otherwise dropped. */
+declare function parseSilenceDetect(stderr: string, sourceDurationS?: number): SilenceInterval[];
+/** Tighten ONE keep-range against the detected silences: excise internal
+ *  silences >= minSilence (leaving trailKeep + leadKeep of air) and trim silent
+ *  leading/trailing edges. Returns 1..N sub-ranges, all inside [start,end],
+ *  inheriting source/grade/beat/quote. Pure. */
+declare function tightenRange(range: EdlRange, silences: SilenceInterval[], opts?: DesilenceOptions, words?: SilenceInterval[]): EdlRange[];
+/** Tighten every range against per-source silence maps, protecting intra-word
+ *  splits with per-source word tokens. Pure. */
+declare function tightenRanges(ranges: EdlRange[], silencesBySource: Record<string, SilenceInterval[]>, opts?: DesilenceOptions, wordsBySource?: Record<string, SilenceInterval[]>): EdlRange[];
+/** Load word-token spans per EDL source from the job's transcripts/ dir. Tries
+ *  transcripts/<sourceName>.json, then falls back to the lone transcript when a
+ *  single-source job names its transcript by stem (the common case). */
+declare function loadWordsBySource(edl: Edl, editDir: string): Record<string, SilenceInterval[]>;
+/** Run silencedetect on a source and return the silence intervals. */
+declare function detectSilences(source: string, noiseDb: number, minSilenceS: number, sourceDurationS: number): Promise<SilenceInterval[]>;
+interface DesilenceStats {
+    rangesBefore: number;
+    rangesAfter: number;
+    durationBefore: number;
+    durationAfter: number;
+    removedS: number;
+}
+/** Detect silences for every source referenced by the EDL, tighten all ranges,
+ *  and return a new EDL (with updated total_duration_s + a `desilenced` marker)
+ *  plus stats. Does NOT write anything. */
+declare function desilenceEdl(edl: Edl, editDir: string, opts?: DesilenceOptions): Promise<{
+    edl: Edl;
+    stats: DesilenceStats;
+}>;
+
+declare function loadWords(tpath: string, opts?: {
+    includeEvents?: boolean;
+}): ScribeWord[];
+declare function writeWordDump(tpath: string, outPath: string, gapThreshold?: number): void;
+declare function writeCoverage(jobDir: string, source: string, tpath: string): Promise<string>;
+declare function writeTranscriptArtifacts(jobDir: string, source: string, tpath: string): Promise<void>;
+declare function ensureTranscribed(jobDir: string, source: string, stem: string, opts?: {
+    language?: string;
+    numSpeakers?: number;
+    noHeal?: boolean;
+    force?: boolean;
+    apiKey?: string;
+}): Promise<string>;
+declare function edlPath(jobDir: string): string;
+declare function readEdl(jobDir: string): Edl | null;
+declare function cutBoundaries(ranges: Edl["ranges"]): CutBoundary[];
+declare function writeBoundaries(jobDir: string): string | null;
+declare function generateQcImages(jobDir: string, opts?: {
+    preview?: string;
+    maxImages?: number;
+}): Promise<string | null>;
+declare function writeWarningsFromReview(jobDir: string): string;
+declare function artifactPaths(jobDir: string, stem: string): Record<string, string>;
+declare function writeAgentManifest(jobDir: string, source: string, stem: string, mode: string): string;
+declare function statusPayload(jobDir: string): Promise<Record<string, unknown>>;
+
+declare function learnedEditingGuardrails(jobDir: string, stem: string): string;
+declare function agentizePrompt(text: string, jobDir: string, stem: string): string;
+declare function writeVideoEditingPrompt(jobDir: string, stem: string, templateName: string, outName: string): string;
+interface SilencePromptOptions {
+    minGap: number;
+    targetGap: number;
+    leadPad: number;
+    trailPad: number;
+}
+declare function writeSilencePrompt(jobDir: string, stem: string, opts: SilencePromptOptions): string;
+
+/** Who put an item into the timeline, and in which authoring round. Required on
+ *  every item; defaults to {round:null, changeId:null, actor:"agent"}. */
+declare const provenanceSchema: z.ZodDefault<z.ZodObject<{
+    round: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    changeId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    actor: z.ZodDefault<z.ZodEnum<["agent", "user"]>>;
+}, "strict", z.ZodTypeAny, {
+    round: number | null;
+    changeId: string | null;
+    actor: "agent" | "user";
+}, {
+    round?: number | null | undefined;
+    changeId?: string | null | undefined;
+    actor?: "agent" | "user" | undefined;
+}>>;
+type Provenance = z.infer<typeof provenanceSchema>;
+/** Anchor to a phrase in a source's word-level transcript. `resolved` is a
+ *  cache: trusted only while the source's transcriptHash still matches. */
+declare const wordsAnchorSchema: z.ZodObject<{
+    type: z.ZodLiteral<"words">;
+    source: z.ZodString;
+    phrase: z.ZodString;
+    /** 1-based occurrence index when the phrase appears more than once. */
+    occurrence: z.ZodOptional<z.ZodNumber>;
+    /** Cached resolution in SOURCE seconds. */
+    resolved: z.ZodOptional<z.ZodObject<{
+        start: z.ZodNumber;
+        end: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        start: number;
+        end: number;
+    }, {
+        start: number;
+        end: number;
+    }>>;
+    /** Collapse the span to one instant (phrase start or end). */
+    edge: z.ZodOptional<z.ZodEnum<["start", "end"]>>;
+}, "strict", z.ZodTypeAny, {
+    type: "words";
+    source: string;
+    phrase: string;
+    occurrence?: number | undefined;
+    resolved?: {
+        start: number;
+        end: number;
+    } | undefined;
+    edge?: "start" | "end" | undefined;
+}, {
+    type: "words";
+    source: string;
+    phrase: string;
+    occurrence?: number | undefined;
+    resolved?: {
+        start: number;
+        end: number;
+    } | undefined;
+    edge?: "start" | "end" | undefined;
+}>;
+/** Anchor to explicit SOURCE seconds. */
+declare const sourceAnchorSchema: z.ZodObject<{
+    type: z.ZodLiteral<"source">;
+    source: z.ZodString;
+    start: z.ZodNumber;
+    end: z.ZodNumber;
+}, "strict", z.ZodTypeAny, {
+    type: "source";
+    start: number;
+    end: number;
+    source: string;
+}, {
+    type: "source";
+    start: number;
+    end: number;
+    source: string;
+}>;
+/** Symbolic OUTPUT-time anchor. Numeric output seconds are deliberately not
+ *  representable: output time shifts under desilence/re-cuts, so authored docs
+ *  may only say start/end/full or "after that other item". */
+declare const outputAnchorSchema: z.ZodObject<{
+    type: z.ZodLiteral<"output">;
+    at: z.ZodUnion<[z.ZodEnum<["start", "end", "full"]>, z.ZodObject<{
+        after: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        after: string;
+    }, {
+        after: string;
+    }>]>;
+    durationS: z.ZodOptional<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    type: "output";
+    at: "start" | "end" | "full" | {
+        after: string;
+    };
+    durationS?: number | undefined;
+}, {
+    type: "output";
+    at: "start" | "end" | "full" | {
+        after: string;
+    };
+    durationS?: number | undefined;
+}>;
+declare const anchorSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    type: z.ZodLiteral<"words">;
+    source: z.ZodString;
+    phrase: z.ZodString;
+    /** 1-based occurrence index when the phrase appears more than once. */
+    occurrence: z.ZodOptional<z.ZodNumber>;
+    /** Cached resolution in SOURCE seconds. */
+    resolved: z.ZodOptional<z.ZodObject<{
+        start: z.ZodNumber;
+        end: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        start: number;
+        end: number;
+    }, {
+        start: number;
+        end: number;
+    }>>;
+    /** Collapse the span to one instant (phrase start or end). */
+    edge: z.ZodOptional<z.ZodEnum<["start", "end"]>>;
+}, "strict", z.ZodTypeAny, {
+    type: "words";
+    source: string;
+    phrase: string;
+    occurrence?: number | undefined;
+    resolved?: {
+        start: number;
+        end: number;
+    } | undefined;
+    edge?: "start" | "end" | undefined;
+}, {
+    type: "words";
+    source: string;
+    phrase: string;
+    occurrence?: number | undefined;
+    resolved?: {
+        start: number;
+        end: number;
+    } | undefined;
+    edge?: "start" | "end" | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"source">;
+    source: z.ZodString;
+    start: z.ZodNumber;
+    end: z.ZodNumber;
+}, "strict", z.ZodTypeAny, {
+    type: "source";
+    start: number;
+    end: number;
+    source: string;
+}, {
+    type: "source";
+    start: number;
+    end: number;
+    source: string;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"output">;
+    at: z.ZodUnion<[z.ZodEnum<["start", "end", "full"]>, z.ZodObject<{
+        after: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        after: string;
+    }, {
+        after: string;
+    }>]>;
+    durationS: z.ZodOptional<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    type: "output";
+    at: "start" | "end" | "full" | {
+        after: string;
+    };
+    durationS?: number | undefined;
+}, {
+    type: "output";
+    at: "start" | "end" | "full" | {
+        after: string;
+    };
+    durationS?: number | undefined;
+}>]>;
+type WordsAnchor = z.infer<typeof wordsAnchorSchema>;
+type SourceAnchor = z.infer<typeof sourceAnchorSchema>;
+type OutputAnchor = z.infer<typeof outputAnchorSchema>;
+type Anchor = z.infer<typeof anchorSchema>;
+declare const timelineSourceSchema: z.ZodObject<{
+    /** Path (absolute or job-dir-relative) to the media file. */
+    path: z.ZodString;
+    durationS: z.ZodOptional<z.ZodNumber>;
+    /** "sha256:<hex>" of the transcript JSON this doc's cached anchor
+     *  resolutions were computed against. */
+    transcriptHash: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    path: string;
+    durationS?: number | undefined;
+    transcriptHash?: string | undefined;
+}, {
+    path: string;
+    durationS?: number | undefined;
+    transcriptHash?: string | undefined;
+}>;
+declare const settingsSchema: z.ZodDefault<z.ZodObject<{
+    canvas: z.ZodDefault<z.ZodObject<{
+        w: z.ZodNumber;
+        h: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        w: number;
+        h: number;
+    }, {
+        w: number;
+        h: number;
+    }>>;
+    /** "none" | preset name | raw ffmpeg filter | "auto" (same as EDL grade),
+     *  or a declarative {preset, intensity?} grade for the composition path. */
+    grade: z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodObject<{
+        preset: z.ZodString;
+        intensity: z.ZodOptional<z.ZodNumber>;
+    }, "strict", z.ZodTypeAny, {
+        preset: string;
+        intensity?: number | undefined;
+    }, {
+        preset: string;
+        intensity?: number | undefined;
+    }>]>>;
+    loudnorm: z.ZodDefault<z.ZodBoolean>;
+    /** Optional DesilenceOptions subset; merged over DEFAULT_DESILENCE. */
+    desilence: z.ZodOptional<z.ZodObject<{
+        noiseDb: z.ZodOptional<z.ZodNumber>;
+        minSilence: z.ZodOptional<z.ZodNumber>;
+        targetGap: z.ZodOptional<z.ZodNumber>;
+        leadKeep: z.ZodOptional<z.ZodNumber>;
+        trailKeep: z.ZodOptional<z.ZodNumber>;
+        minSegment: z.ZodOptional<z.ZodNumber>;
+    }, "strict", z.ZodTypeAny, {
+        noiseDb?: number | undefined;
+        minSilence?: number | undefined;
+        targetGap?: number | undefined;
+        leadKeep?: number | undefined;
+        trailKeep?: number | undefined;
+        minSegment?: number | undefined;
+    }, {
+        noiseDb?: number | undefined;
+        minSilence?: number | undefined;
+        targetGap?: number | undefined;
+        leadKeep?: number | undefined;
+        trailKeep?: number | undefined;
+        minSegment?: number | undefined;
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    canvas: {
+        w: number;
+        h: number;
+    };
+    grade: string | {
+        preset: string;
+        intensity?: number | undefined;
+    };
+    loudnorm: boolean;
+    desilence?: {
+        noiseDb?: number | undefined;
+        minSilence?: number | undefined;
+        targetGap?: number | undefined;
+        leadKeep?: number | undefined;
+        trailKeep?: number | undefined;
+        minSegment?: number | undefined;
+    } | undefined;
+}, {
+    canvas?: {
+        w: number;
+        h: number;
+    } | undefined;
+    grade?: string | {
+        preset: string;
+        intensity?: number | undefined;
+    } | undefined;
+    loudnorm?: boolean | undefined;
+    desilence?: {
+        noiseDb?: number | undefined;
+        minSilence?: number | undefined;
+        targetGap?: number | undefined;
+        leadKeep?: number | undefined;
+        trailKeep?: number | undefined;
+        minSegment?: number | undefined;
+    } | undefined;
+}>>;
+declare const cutRangeSchema: z.ZodObject<{
+    id: z.ZodString;
+    source: z.ZodString;
+    start: z.ZodNumber;
+    end: z.ZodNumber;
+    beat: z.ZodOptional<z.ZodString>;
+    quote: z.ZodOptional<z.ZodString>;
+    reason: z.ZodOptional<z.ZodString>;
+    /** Optional per-range grade override (kept for v1 EDL round-trips). */
+    grade: z.ZodOptional<z.ZodString>;
+    provenance: z.ZodDefault<z.ZodObject<{
+        round: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+        changeId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        actor: z.ZodDefault<z.ZodEnum<["agent", "user"]>>;
+    }, "strict", z.ZodTypeAny, {
+        round: number | null;
+        changeId: string | null;
+        actor: "agent" | "user";
+    }, {
+        round?: number | null | undefined;
+        changeId?: string | null | undefined;
+        actor?: "agent" | "user" | undefined;
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    start: number;
+    end: number;
+    source: string;
+    id: string;
+    provenance: {
+        round: number | null;
+        changeId: string | null;
+        actor: "agent" | "user";
+    };
+    grade?: string | undefined;
+    beat?: string | undefined;
+    quote?: string | undefined;
+    reason?: string | undefined;
+}, {
+    start: number;
+    end: number;
+    source: string;
+    id: string;
+    grade?: string | undefined;
+    beat?: string | undefined;
+    quote?: string | undefined;
+    reason?: string | undefined;
+    provenance?: {
+        round?: number | null | undefined;
+        changeId?: string | null | undefined;
+        actor?: "agent" | "user" | undefined;
+    } | undefined;
+}>;
+declare const captionOverrideSchema: z.ZodObject<{
+    id: z.ZodString;
+    anchor: z.ZodObject<{
+        type: z.ZodLiteral<"words">;
+        source: z.ZodString;
+        phrase: z.ZodString;
+        /** 1-based occurrence index when the phrase appears more than once. */
+        occurrence: z.ZodOptional<z.ZodNumber>;
+        /** Cached resolution in SOURCE seconds. */
+        resolved: z.ZodOptional<z.ZodObject<{
+            start: z.ZodNumber;
+            end: z.ZodNumber;
+        }, "strict", z.ZodTypeAny, {
+            start: number;
+            end: number;
+        }, {
+            start: number;
+            end: number;
+        }>>;
+        /** Collapse the span to one instant (phrase start or end). */
+        edge: z.ZodOptional<z.ZodEnum<["start", "end"]>>;
+    }, "strict", z.ZodTypeAny, {
+        type: "words";
+        source: string;
+        phrase: string;
+        occurrence?: number | undefined;
+        resolved?: {
+            start: number;
+            end: number;
+        } | undefined;
+        edge?: "start" | "end" | undefined;
+    }, {
+        type: "words";
+        source: string;
+        phrase: string;
+        occurrence?: number | undefined;
+        resolved?: {
+            start: number;
+            end: number;
+        } | undefined;
+        edge?: "start" | "end" | undefined;
+    }>;
+    op: z.ZodEnum<["replace-text", "hide", "break-line", "style"]>;
+    text: z.ZodOptional<z.ZodString>;
+    /** op:"style" — per-word color (hex or simple CSS color name). */
+    color: z.ZodOptional<z.ZodString>;
+    /** op:"style" — per-word animated emphasis at the word's onset. */
+    emphasis: z.ZodOptional<z.ZodEnum<["pop", "highlight"]>>;
+    provenance: z.ZodDefault<z.ZodObject<{
+        round: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+        changeId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        actor: z.ZodDefault<z.ZodEnum<["agent", "user"]>>;
+    }, "strict", z.ZodTypeAny, {
+        round: number | null;
+        changeId: string | null;
+        actor: "agent" | "user";
+    }, {
+        round?: number | null | undefined;
+        changeId?: string | null | undefined;
+        actor?: "agent" | "user" | undefined;
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    anchor: {
+        type: "words";
+        source: string;
+        phrase: string;
+        occurrence?: number | undefined;
+        resolved?: {
+            start: number;
+            end: number;
+        } | undefined;
+        edge?: "start" | "end" | undefined;
+    };
+    id: string;
+    provenance: {
+        round: number | null;
+        changeId: string | null;
+        actor: "agent" | "user";
+    };
+    op: "replace-text" | "hide" | "break-line" | "style";
+    text?: string | undefined;
+    color?: string | undefined;
+    emphasis?: "pop" | "highlight" | undefined;
+}, {
+    anchor: {
+        type: "words";
+        source: string;
+        phrase: string;
+        occurrence?: number | undefined;
+        resolved?: {
+            start: number;
+            end: number;
+        } | undefined;
+        edge?: "start" | "end" | undefined;
+    };
+    id: string;
+    op: "replace-text" | "hide" | "break-line" | "style";
+    text?: string | undefined;
+    provenance?: {
+        round?: number | null | undefined;
+        changeId?: string | null | undefined;
+        actor?: "agent" | "user" | undefined;
+    } | undefined;
+    color?: string | undefined;
+    emphasis?: "pop" | "highlight" | undefined;
+}>;
+declare const zoomSchema: z.ZodObject<{
+    id: z.ZodString;
+    anchor: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+        type: z.ZodLiteral<"words">;
+        source: z.ZodString;
+        phrase: z.ZodString;
+        /** 1-based occurrence index when the phrase appears more than once. */
+        occurrence: z.ZodOptional<z.ZodNumber>;
+        /** Cached resolution in SOURCE seconds. */
+        resolved: z.ZodOptional<z.ZodObject<{
+            start: z.ZodNumber;
+            end: z.ZodNumber;
+        }, "strict", z.ZodTypeAny, {
+            start: number;
+            end: number;
+        }, {
+            start: number;
+            end: number;
+        }>>;
+        /** Collapse the span to one instant (phrase start or end). */
+        edge: z.ZodOptional<z.ZodEnum<["start", "end"]>>;
+    }, "strict", z.ZodTypeAny, {
+        type: "words";
+        source: string;
+        phrase: string;
+        occurrence?: number | undefined;
+        resolved?: {
+            start: number;
+            end: number;
+        } | undefined;
+        edge?: "start" | "end" | undefined;
+    }, {
+        type: "words";
+        source: string;
+        phrase: string;
+        occurrence?: number | undefined;
+        resolved?: {
+            start: number;
+            end: number;
+        } | undefined;
+        edge?: "start" | "end" | undefined;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"source">;
+        source: z.ZodString;
+        start: z.ZodNumber;
+        end: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        type: "source";
+        start: number;
+        end: number;
+        source: string;
+    }, {
+        type: "source";
+        start: number;
+        end: number;
+        source: string;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"output">;
+        at: z.ZodUnion<[z.ZodEnum<["start", "end", "full"]>, z.ZodObject<{
+            after: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            after: string;
+        }, {
+            after: string;
+        }>]>;
+        durationS: z.ZodOptional<z.ZodNumber>;
+    }, "strict", z.ZodTypeAny, {
+        type: "output";
+        at: "start" | "end" | "full" | {
+            after: string;
+        };
+        durationS?: number | undefined;
+    }, {
+        type: "output";
+        at: "start" | "end" | "full" | {
+            after: string;
+        };
+        durationS?: number | undefined;
+    }>]>;
+    onCut: z.ZodDefault<z.ZodEnum<["clip", "drop", "error"]>>;
+    rect: z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        w: z.ZodNumber;
+        h: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        w: number;
+        h: number;
+        x: number;
+        y: number;
+    }, {
+        w: number;
+        h: number;
+        x: number;
+        y: number;
+    }>;
+    scale: z.ZodNumber;
+    /** Ramp target: when present, the zoom animates from the base rect/scale
+     *  to `to` over the zoom window (`ease` shapes the ramp). */
+    to: z.ZodOptional<z.ZodObject<{
+        rect: z.ZodOptional<z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            w: z.ZodNumber;
+            h: z.ZodNumber;
+        }, "strict", z.ZodTypeAny, {
+            w: number;
+            h: number;
+            x: number;
+            y: number;
+        }, {
+            w: number;
+            h: number;
+            x: number;
+            y: number;
+        }>>;
+        scale: z.ZodOptional<z.ZodNumber>;
+    }, "strict", z.ZodTypeAny, {
+        rect?: {
+            w: number;
+            h: number;
+            x: number;
+            y: number;
+        } | undefined;
+        scale?: number | undefined;
+    }, {
+        rect?: {
+            w: number;
+            h: number;
+            x: number;
+            y: number;
+        } | undefined;
+        scale?: number | undefined;
+    }>>;
+    ease: z.ZodDefault<z.ZodObject<{
+        in: z.ZodNumber;
+        out: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        in: number;
+        out: number;
+    }, {
+        in: number;
+        out: number;
+    }>>;
+    provenance: z.ZodDefault<z.ZodObject<{
+        round: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+        changeId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        actor: z.ZodDefault<z.ZodEnum<["agent", "user"]>>;
+    }, "strict", z.ZodTypeAny, {
+        round: number | null;
+        changeId: string | null;
+        actor: "agent" | "user";
+    }, {
+        round?: number | null | undefined;
+        changeId?: string | null | undefined;
+        actor?: "agent" | "user" | undefined;
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    anchor: {
+        type: "words";
+        source: string;
+        phrase: string;
+        occurrence?: number | undefined;
+        resolved?: {
+            start: number;
+            end: number;
+        } | undefined;
+        edge?: "start" | "end" | undefined;
+    } | {
+        type: "source";
+        start: number;
+        end: number;
+        source: string;
+    } | {
+        type: "output";
+        at: "start" | "end" | "full" | {
+            after: string;
+        };
+        durationS?: number | undefined;
+    };
+    id: string;
+    provenance: {
+        round: number | null;
+        changeId: string | null;
+        actor: "agent" | "user";
+    };
+    onCut: "error" | "drop" | "clip";
+    rect: {
+        w: number;
+        h: number;
+        x: number;
+        y: number;
+    };
+    scale: number;
+    ease: {
+        in: number;
+        out: number;
+    };
+    to?: {
+        rect?: {
+            w: number;
+            h: number;
+            x: number;
+            y: number;
+        } | undefined;
+        scale?: number | undefined;
+    } | undefined;
+}, {
+    anchor: {
+        type: "words";
+        source: string;
+        phrase: string;
+        occurrence?: number | undefined;
+        resolved?: {
+            start: number;
+            end: number;
+        } | undefined;
+        edge?: "start" | "end" | undefined;
+    } | {
+        type: "source";
+        start: number;
+        end: number;
+        source: string;
+    } | {
+        type: "output";
+        at: "start" | "end" | "full" | {
+            after: string;
+        };
+        durationS?: number | undefined;
+    };
+    id: string;
+    rect: {
+        w: number;
+        h: number;
+        x: number;
+        y: number;
+    };
+    scale: number;
+    provenance?: {
+        round?: number | null | undefined;
+        changeId?: string | null | undefined;
+        actor?: "agent" | "user" | undefined;
+    } | undefined;
+    onCut?: "error" | "drop" | "clip" | undefined;
+    to?: {
+        rect?: {
+            w: number;
+            h: number;
+            x: number;
+            y: number;
+        } | undefined;
+        scale?: number | undefined;
+    } | undefined;
+    ease?: {
+        in: number;
+        out: number;
+    } | undefined;
+}>;
+/** Entrance/exit animation for an overlay (rendered as GSAP fromTo tweens at
+ *  the overlay's output start/end). */
+declare const overlayFxSchema: z.ZodObject<{
+    preset: z.ZodEnum<["fade", "pop", "slide-up", "slide-down", "scale-in"]>;
+    durationS: z.ZodNumber;
+}, "strict", z.ZodTypeAny, {
+    preset: "pop" | "fade" | "slide-up" | "slide-down" | "scale-in";
+    durationS: number;
+}, {
+    preset: "pop" | "fade" | "slide-up" | "slide-down" | "scale-in";
+    durationS: number;
+}>;
+declare const overlaySchema: z.ZodObject<{
+    id: z.ZodString;
+    kind: z.ZodEnum<["text", "title-card", "image", "sticker"]>;
+    anchor: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+        type: z.ZodLiteral<"words">;
+        source: z.ZodString;
+        phrase: z.ZodString;
+        /** 1-based occurrence index when the phrase appears more than once. */
+        occurrence: z.ZodOptional<z.ZodNumber>;
+        /** Cached resolution in SOURCE seconds. */
+        resolved: z.ZodOptional<z.ZodObject<{
+            start: z.ZodNumber;
+            end: z.ZodNumber;
+        }, "strict", z.ZodTypeAny, {
+            start: number;
+            end: number;
+        }, {
+            start: number;
+            end: number;
+        }>>;
+        /** Collapse the span to one instant (phrase start or end). */
+        edge: z.ZodOptional<z.ZodEnum<["start", "end"]>>;
+    }, "strict", z.ZodTypeAny, {
+        type: "words";
+        source: string;
+        phrase: string;
+        occurrence?: number | undefined;
+        resolved?: {
+            start: number;
+            end: number;
+        } | undefined;
+        edge?: "start" | "end" | undefined;
+    }, {
+        type: "words";
+        source: string;
+        phrase: string;
+        occurrence?: number | undefined;
+        resolved?: {
+            start: number;
+            end: number;
+        } | undefined;
+        edge?: "start" | "end" | undefined;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"source">;
+        source: z.ZodString;
+        start: z.ZodNumber;
+        end: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        type: "source";
+        start: number;
+        end: number;
+        source: string;
+    }, {
+        type: "source";
+        start: number;
+        end: number;
+        source: string;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"output">;
+        at: z.ZodUnion<[z.ZodEnum<["start", "end", "full"]>, z.ZodObject<{
+            after: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            after: string;
+        }, {
+            after: string;
+        }>]>;
+        durationS: z.ZodOptional<z.ZodNumber>;
+    }, "strict", z.ZodTypeAny, {
+        type: "output";
+        at: "start" | "end" | "full" | {
+            after: string;
+        };
+        durationS?: number | undefined;
+    }, {
+        type: "output";
+        at: "start" | "end" | "full" | {
+            after: string;
+        };
+        durationS?: number | undefined;
+    }>]>;
+    onCut: z.ZodDefault<z.ZodEnum<["clip", "drop", "error"]>>;
+    layout: z.ZodDefault<z.ZodObject<{
+        x: z.ZodDefault<z.ZodNumber>;
+        y: z.ZodDefault<z.ZodNumber>;
+        align: z.ZodDefault<z.ZodEnum<["left", "center", "right"]>>;
+        safeArea: z.ZodDefault<z.ZodBoolean>;
+    }, "strict", z.ZodTypeAny, {
+        x: number;
+        y: number;
+        align: "center" | "left" | "right";
+        safeArea: boolean;
+    }, {
+        x?: number | undefined;
+        y?: number | undefined;
+        align?: "center" | "left" | "right" | undefined;
+        safeArea?: boolean | undefined;
+    }>>;
+    text: z.ZodOptional<z.ZodString>;
+    style: z.ZodDefault<z.ZodObject<{
+        preset: z.ZodOptional<z.ZodString>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        preset: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        preset: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">>>;
+    durationS: z.ZodOptional<z.ZodNumber>;
+    asset: z.ZodOptional<z.ZodObject<{
+        ref: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        ref: string;
+    }, {
+        ref: string;
+    }>>;
+    /** Entrance/exit presets (image/sticker overlays). */
+    enter: z.ZodOptional<z.ZodObject<{
+        preset: z.ZodEnum<["fade", "pop", "slide-up", "slide-down", "scale-in"]>;
+        durationS: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        preset: "pop" | "fade" | "slide-up" | "slide-down" | "scale-in";
+        durationS: number;
+    }, {
+        preset: "pop" | "fade" | "slide-up" | "slide-down" | "scale-in";
+        durationS: number;
+    }>>;
+    exit: z.ZodOptional<z.ZodObject<{
+        preset: z.ZodEnum<["fade", "pop", "slide-up", "slide-down", "scale-in"]>;
+        durationS: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        preset: "pop" | "fade" | "slide-up" | "slide-down" | "scale-in";
+        durationS: number;
+    }, {
+        preset: "pop" | "fade" | "slide-up" | "slide-down" | "scale-in";
+        durationS: number;
+    }>>;
+    /** Size as canvas fractions (w of canvas width, h of canvas height). */
+    size: z.ZodOptional<z.ZodObject<{
+        w: z.ZodOptional<z.ZodNumber>;
+        h: z.ZodOptional<z.ZodNumber>;
+    }, "strict", z.ZodTypeAny, {
+        w?: number | undefined;
+        h?: number | undefined;
+    }, {
+        w?: number | undefined;
+        h?: number | undefined;
+    }>>;
+    /** Stacking order (CSS z-index); temporal lanes stay non-overlapping. */
+    z: z.ZodOptional<z.ZodNumber>;
+    provenance: z.ZodDefault<z.ZodObject<{
+        round: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+        changeId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        actor: z.ZodDefault<z.ZodEnum<["agent", "user"]>>;
+    }, "strict", z.ZodTypeAny, {
+        round: number | null;
+        changeId: string | null;
+        actor: "agent" | "user";
+    }, {
+        round?: number | null | undefined;
+        changeId?: string | null | undefined;
+        actor?: "agent" | "user" | undefined;
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    anchor: {
+        type: "words";
+        source: string;
+        phrase: string;
+        occurrence?: number | undefined;
+        resolved?: {
+            start: number;
+            end: number;
+        } | undefined;
+        edge?: "start" | "end" | undefined;
+    } | {
+        type: "source";
+        start: number;
+        end: number;
+        source: string;
+    } | {
+        type: "output";
+        at: "start" | "end" | "full" | {
+            after: string;
+        };
+        durationS?: number | undefined;
+    };
+    kind: "text" | "title-card" | "image" | "sticker";
+    id: string;
+    provenance: {
+        round: number | null;
+        changeId: string | null;
+        actor: "agent" | "user";
+    };
+    style: {
+        preset?: string | undefined;
+    } & {
+        [k: string]: unknown;
+    };
+    onCut: "error" | "drop" | "clip";
+    layout: {
+        x: number;
+        y: number;
+        align: "center" | "left" | "right";
+        safeArea: boolean;
+    };
+    text?: string | undefined;
+    size?: {
+        w?: number | undefined;
+        h?: number | undefined;
+    } | undefined;
+    durationS?: number | undefined;
+    asset?: {
+        ref: string;
+    } | undefined;
+    enter?: {
+        preset: "pop" | "fade" | "slide-up" | "slide-down" | "scale-in";
+        durationS: number;
+    } | undefined;
+    exit?: {
+        preset: "pop" | "fade" | "slide-up" | "slide-down" | "scale-in";
+        durationS: number;
+    } | undefined;
+    z?: number | undefined;
+}, {
+    anchor: {
+        type: "words";
+        source: string;
+        phrase: string;
+        occurrence?: number | undefined;
+        resolved?: {
+            start: number;
+            end: number;
+        } | undefined;
+        edge?: "start" | "end" | undefined;
+    } | {
+        type: "source";
+        start: number;
+        end: number;
+        source: string;
+    } | {
+        type: "output";
+        at: "start" | "end" | "full" | {
+            after: string;
+        };
+        durationS?: number | undefined;
+    };
+    kind: "text" | "title-card" | "image" | "sticker";
+    id: string;
+    text?: string | undefined;
+    size?: {
+        w?: number | undefined;
+        h?: number | undefined;
+    } | undefined;
+    durationS?: number | undefined;
+    provenance?: {
+        round?: number | null | undefined;
+        changeId?: string | null | undefined;
+        actor?: "agent" | "user" | undefined;
+    } | undefined;
+    style?: z.objectInputType<{
+        preset: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough"> | undefined;
+    onCut?: "error" | "drop" | "clip" | undefined;
+    layout?: {
+        x?: number | undefined;
+        y?: number | undefined;
+        align?: "center" | "left" | "right" | undefined;
+        safeArea?: boolean | undefined;
+    } | undefined;
+    asset?: {
+        ref: string;
+    } | undefined;
+    enter?: {
+        preset: "pop" | "fade" | "slide-up" | "slide-down" | "scale-in";
+        durationS: number;
+    } | undefined;
+    exit?: {
+        preset: "pop" | "fade" | "slide-up" | "slide-down" | "scale-in";
+        durationS: number;
+    } | undefined;
+    z?: number | undefined;
+}>;
+declare const audioSchema: z.ZodObject<{
+    id: z.ZodString;
+    kind: z.ZodEnum<["music", "sfx"]>;
+    asset: z.ZodObject<{
+        ref: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        ref: string;
+    }, {
+        ref: string;
+    }>;
+    anchor: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+        type: z.ZodLiteral<"words">;
+        source: z.ZodString;
+        phrase: z.ZodString;
+        /** 1-based occurrence index when the phrase appears more than once. */
+        occurrence: z.ZodOptional<z.ZodNumber>;
+        /** Cached resolution in SOURCE seconds. */
+        resolved: z.ZodOptional<z.ZodObject<{
+            start: z.ZodNumber;
+            end: z.ZodNumber;
+        }, "strict", z.ZodTypeAny, {
+            start: number;
+            end: number;
+        }, {
+            start: number;
+            end: number;
+        }>>;
+        /** Collapse the span to one instant (phrase start or end). */
+        edge: z.ZodOptional<z.ZodEnum<["start", "end"]>>;
+    }, "strict", z.ZodTypeAny, {
+        type: "words";
+        source: string;
+        phrase: string;
+        occurrence?: number | undefined;
+        resolved?: {
+            start: number;
+            end: number;
+        } | undefined;
+        edge?: "start" | "end" | undefined;
+    }, {
+        type: "words";
+        source: string;
+        phrase: string;
+        occurrence?: number | undefined;
+        resolved?: {
+            start: number;
+            end: number;
+        } | undefined;
+        edge?: "start" | "end" | undefined;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"source">;
+        source: z.ZodString;
+        start: z.ZodNumber;
+        end: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        type: "source";
+        start: number;
+        end: number;
+        source: string;
+    }, {
+        type: "source";
+        start: number;
+        end: number;
+        source: string;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"output">;
+        at: z.ZodUnion<[z.ZodEnum<["start", "end", "full"]>, z.ZodObject<{
+            after: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            after: string;
+        }, {
+            after: string;
+        }>]>;
+        durationS: z.ZodOptional<z.ZodNumber>;
+    }, "strict", z.ZodTypeAny, {
+        type: "output";
+        at: "start" | "end" | "full" | {
+            after: string;
+        };
+        durationS?: number | undefined;
+    }, {
+        type: "output";
+        at: "start" | "end" | "full" | {
+            after: string;
+        };
+        durationS?: number | undefined;
+    }>]>;
+    gainDb: z.ZodDefault<z.ZodNumber>;
+    duckToSpeech: z.ZodDefault<z.ZodBoolean>;
+    fadeOutS: z.ZodOptional<z.ZodNumber>;
+    provenance: z.ZodDefault<z.ZodObject<{
+        round: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+        changeId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        actor: z.ZodDefault<z.ZodEnum<["agent", "user"]>>;
+    }, "strict", z.ZodTypeAny, {
+        round: number | null;
+        changeId: string | null;
+        actor: "agent" | "user";
+    }, {
+        round?: number | null | undefined;
+        changeId?: string | null | undefined;
+        actor?: "agent" | "user" | undefined;
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    anchor: {
+        type: "words";
+        source: string;
+        phrase: string;
+        occurrence?: number | undefined;
+        resolved?: {
+            start: number;
+            end: number;
+        } | undefined;
+        edge?: "start" | "end" | undefined;
+    } | {
+        type: "source";
+        start: number;
+        end: number;
+        source: string;
+    } | {
+        type: "output";
+        at: "start" | "end" | "full" | {
+            after: string;
+        };
+        durationS?: number | undefined;
+    };
+    kind: "music" | "sfx";
+    id: string;
+    provenance: {
+        round: number | null;
+        changeId: string | null;
+        actor: "agent" | "user";
+    };
+    asset: {
+        ref: string;
+    };
+    gainDb: number;
+    duckToSpeech: boolean;
+    fadeOutS?: number | undefined;
+}, {
+    anchor: {
+        type: "words";
+        source: string;
+        phrase: string;
+        occurrence?: number | undefined;
+        resolved?: {
+            start: number;
+            end: number;
+        } | undefined;
+        edge?: "start" | "end" | undefined;
+    } | {
+        type: "source";
+        start: number;
+        end: number;
+        source: string;
+    } | {
+        type: "output";
+        at: "start" | "end" | "full" | {
+            after: string;
+        };
+        durationS?: number | undefined;
+    };
+    kind: "music" | "sfx";
+    id: string;
+    asset: {
+        ref: string;
+    };
+    provenance?: {
+        round?: number | null | undefined;
+        changeId?: string | null | undefined;
+        actor?: "agent" | "user" | undefined;
+    } | undefined;
+    gainDb?: number | undefined;
+    duckToSpeech?: boolean | undefined;
+    fadeOutS?: number | undefined;
+}>;
+type CutRange = z.infer<typeof cutRangeSchema>;
+type CaptionOverride = z.infer<typeof captionOverrideSchema>;
+type ZoomItem = z.infer<typeof zoomSchema>;
+type OverlayItem = z.infer<typeof overlaySchema>;
+type OverlayFx = z.infer<typeof overlayFxSchema>;
+type AudioItem = z.infer<typeof audioSchema>;
+type TimelineSource = z.infer<typeof timelineSourceSchema>;
+type TimelineSettings = z.infer<typeof settingsSchema>;
+declare const timelineV2Schema: z.ZodObject<{
+    version: z.ZodLiteral<2>;
+    id: z.ZodString;
+    sources: z.ZodEffects<z.ZodRecord<z.ZodString, z.ZodObject<{
+        /** Path (absolute or job-dir-relative) to the media file. */
+        path: z.ZodString;
+        durationS: z.ZodOptional<z.ZodNumber>;
+        /** "sha256:<hex>" of the transcript JSON this doc's cached anchor
+         *  resolutions were computed against. */
+        transcriptHash: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        path: string;
+        durationS?: number | undefined;
+        transcriptHash?: string | undefined;
+    }, {
+        path: string;
+        durationS?: number | undefined;
+        transcriptHash?: string | undefined;
+    }>>, Record<string, {
+        path: string;
+        durationS?: number | undefined;
+        transcriptHash?: string | undefined;
+    }>, Record<string, {
+        path: string;
+        durationS?: number | undefined;
+        transcriptHash?: string | undefined;
+    }>>;
+    settings: z.ZodDefault<z.ZodObject<{
+        canvas: z.ZodDefault<z.ZodObject<{
+            w: z.ZodNumber;
+            h: z.ZodNumber;
+        }, "strict", z.ZodTypeAny, {
+            w: number;
+            h: number;
+        }, {
+            w: number;
+            h: number;
+        }>>;
+        /** "none" | preset name | raw ffmpeg filter | "auto" (same as EDL grade),
+         *  or a declarative {preset, intensity?} grade for the composition path. */
+        grade: z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodObject<{
+            preset: z.ZodString;
+            intensity: z.ZodOptional<z.ZodNumber>;
+        }, "strict", z.ZodTypeAny, {
+            preset: string;
+            intensity?: number | undefined;
+        }, {
+            preset: string;
+            intensity?: number | undefined;
+        }>]>>;
+        loudnorm: z.ZodDefault<z.ZodBoolean>;
+        /** Optional DesilenceOptions subset; merged over DEFAULT_DESILENCE. */
+        desilence: z.ZodOptional<z.ZodObject<{
+            noiseDb: z.ZodOptional<z.ZodNumber>;
+            minSilence: z.ZodOptional<z.ZodNumber>;
+            targetGap: z.ZodOptional<z.ZodNumber>;
+            leadKeep: z.ZodOptional<z.ZodNumber>;
+            trailKeep: z.ZodOptional<z.ZodNumber>;
+            minSegment: z.ZodOptional<z.ZodNumber>;
+        }, "strict", z.ZodTypeAny, {
+            noiseDb?: number | undefined;
+            minSilence?: number | undefined;
+            targetGap?: number | undefined;
+            leadKeep?: number | undefined;
+            trailKeep?: number | undefined;
+            minSegment?: number | undefined;
+        }, {
+            noiseDb?: number | undefined;
+            minSilence?: number | undefined;
+            targetGap?: number | undefined;
+            leadKeep?: number | undefined;
+            trailKeep?: number | undefined;
+            minSegment?: number | undefined;
+        }>>;
+    }, "strict", z.ZodTypeAny, {
+        canvas: {
+            w: number;
+            h: number;
+        };
+        grade: string | {
+            preset: string;
+            intensity?: number | undefined;
+        };
+        loudnorm: boolean;
+        desilence?: {
+            noiseDb?: number | undefined;
+            minSilence?: number | undefined;
+            targetGap?: number | undefined;
+            leadKeep?: number | undefined;
+            trailKeep?: number | undefined;
+            minSegment?: number | undefined;
+        } | undefined;
+    }, {
+        canvas?: {
+            w: number;
+            h: number;
+        } | undefined;
+        grade?: string | {
+            preset: string;
+            intensity?: number | undefined;
+        } | undefined;
+        loudnorm?: boolean | undefined;
+        desilence?: {
+            noiseDb?: number | undefined;
+            minSilence?: number | undefined;
+            targetGap?: number | undefined;
+            leadKeep?: number | undefined;
+            trailKeep?: number | undefined;
+            minSegment?: number | undefined;
+        } | undefined;
+    }>>;
+    cut: z.ZodDefault<z.ZodObject<{
+        ranges: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            source: z.ZodString;
+            start: z.ZodNumber;
+            end: z.ZodNumber;
+            beat: z.ZodOptional<z.ZodString>;
+            quote: z.ZodOptional<z.ZodString>;
+            reason: z.ZodOptional<z.ZodString>;
+            /** Optional per-range grade override (kept for v1 EDL round-trips). */
+            grade: z.ZodOptional<z.ZodString>;
+            provenance: z.ZodDefault<z.ZodObject<{
+                round: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+                changeId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+                actor: z.ZodDefault<z.ZodEnum<["agent", "user"]>>;
+            }, "strict", z.ZodTypeAny, {
+                round: number | null;
+                changeId: string | null;
+                actor: "agent" | "user";
+            }, {
+                round?: number | null | undefined;
+                changeId?: string | null | undefined;
+                actor?: "agent" | "user" | undefined;
+            }>>;
+        }, "strict", z.ZodTypeAny, {
+            start: number;
+            end: number;
+            source: string;
+            id: string;
+            provenance: {
+                round: number | null;
+                changeId: string | null;
+                actor: "agent" | "user";
+            };
+            grade?: string | undefined;
+            beat?: string | undefined;
+            quote?: string | undefined;
+            reason?: string | undefined;
+        }, {
+            start: number;
+            end: number;
+            source: string;
+            id: string;
+            grade?: string | undefined;
+            beat?: string | undefined;
+            quote?: string | undefined;
+            reason?: string | undefined;
+            provenance?: {
+                round?: number | null | undefined;
+                changeId?: string | null | undefined;
+                actor?: "agent" | "user" | undefined;
+            } | undefined;
+        }>, "many">>;
+    }, "strict", z.ZodTypeAny, {
+        ranges: {
+            start: number;
+            end: number;
+            source: string;
+            id: string;
+            provenance: {
+                round: number | null;
+                changeId: string | null;
+                actor: "agent" | "user";
+            };
+            grade?: string | undefined;
+            beat?: string | undefined;
+            quote?: string | undefined;
+            reason?: string | undefined;
+        }[];
+    }, {
+        ranges?: {
+            start: number;
+            end: number;
+            source: string;
+            id: string;
+            grade?: string | undefined;
+            beat?: string | undefined;
+            quote?: string | undefined;
+            reason?: string | undefined;
+            provenance?: {
+                round?: number | null | undefined;
+                changeId?: string | null | undefined;
+                actor?: "agent" | "user" | undefined;
+            } | undefined;
+        }[] | undefined;
+    }>>;
+    captions: z.ZodDefault<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        preset: z.ZodDefault<z.ZodEnum<["grouped", "opus-karaoke"]>>;
+        style: z.ZodDefault<z.ZodObject<{
+            /** Max words per grouped cue (preset "grouped" only). */
+            maxWords: z.ZodOptional<z.ZodNumber>;
+            /** Inter-word gap (seconds) that ends a phrase — a hard cue boundary
+             *  (preset "grouped" only). */
+            gapBreakS: z.ZodOptional<z.ZodNumber>;
+            /** Seconds each cue's display start is shifted EARLIER (clamped to the
+             *  previous cue's end / the segment's outStart). */
+            leadS: z.ZodOptional<z.ZodNumber>;
+            /** Max seconds a cue is held past its last word to bridge the gap to the
+             *  next cue (never past the segment's outEnd). */
+            holdS: z.ZodOptional<z.ZodNumber>;
+            /** Per-word highlight sweep within grouped cues (karaoke-style). */
+            karaoke: z.ZodOptional<z.ZodBoolean>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            /** Max words per grouped cue (preset "grouped" only). */
+            maxWords: z.ZodOptional<z.ZodNumber>;
+            /** Inter-word gap (seconds) that ends a phrase — a hard cue boundary
+             *  (preset "grouped" only). */
+            gapBreakS: z.ZodOptional<z.ZodNumber>;
+            /** Seconds each cue's display start is shifted EARLIER (clamped to the
+             *  previous cue's end / the segment's outStart). */
+            leadS: z.ZodOptional<z.ZodNumber>;
+            /** Max seconds a cue is held past its last word to bridge the gap to the
+             *  next cue (never past the segment's outEnd). */
+            holdS: z.ZodOptional<z.ZodNumber>;
+            /** Per-word highlight sweep within grouped cues (karaoke-style). */
+            karaoke: z.ZodOptional<z.ZodBoolean>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            /** Max words per grouped cue (preset "grouped" only). */
+            maxWords: z.ZodOptional<z.ZodNumber>;
+            /** Inter-word gap (seconds) that ends a phrase — a hard cue boundary
+             *  (preset "grouped" only). */
+            gapBreakS: z.ZodOptional<z.ZodNumber>;
+            /** Seconds each cue's display start is shifted EARLIER (clamped to the
+             *  previous cue's end / the segment's outStart). */
+            leadS: z.ZodOptional<z.ZodNumber>;
+            /** Max seconds a cue is held past its last word to bridge the gap to the
+             *  next cue (never past the segment's outEnd). */
+            holdS: z.ZodOptional<z.ZodNumber>;
+            /** Per-word highlight sweep within grouped cues (karaoke-style). */
+            karaoke: z.ZodOptional<z.ZodBoolean>;
+        }, z.ZodTypeAny, "passthrough">>>;
+        overrides: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            anchor: z.ZodObject<{
+                type: z.ZodLiteral<"words">;
+                source: z.ZodString;
+                phrase: z.ZodString;
+                /** 1-based occurrence index when the phrase appears more than once. */
+                occurrence: z.ZodOptional<z.ZodNumber>;
+                /** Cached resolution in SOURCE seconds. */
+                resolved: z.ZodOptional<z.ZodObject<{
+                    start: z.ZodNumber;
+                    end: z.ZodNumber;
+                }, "strict", z.ZodTypeAny, {
+                    start: number;
+                    end: number;
+                }, {
+                    start: number;
+                    end: number;
+                }>>;
+                /** Collapse the span to one instant (phrase start or end). */
+                edge: z.ZodOptional<z.ZodEnum<["start", "end"]>>;
+            }, "strict", z.ZodTypeAny, {
+                type: "words";
+                source: string;
+                phrase: string;
+                occurrence?: number | undefined;
+                resolved?: {
+                    start: number;
+                    end: number;
+                } | undefined;
+                edge?: "start" | "end" | undefined;
+            }, {
+                type: "words";
+                source: string;
+                phrase: string;
+                occurrence?: number | undefined;
+                resolved?: {
+                    start: number;
+                    end: number;
+                } | undefined;
+                edge?: "start" | "end" | undefined;
+            }>;
+            op: z.ZodEnum<["replace-text", "hide", "break-line", "style"]>;
+            text: z.ZodOptional<z.ZodString>;
+            /** op:"style" — per-word color (hex or simple CSS color name). */
+            color: z.ZodOptional<z.ZodString>;
+            /** op:"style" — per-word animated emphasis at the word's onset. */
+            emphasis: z.ZodOptional<z.ZodEnum<["pop", "highlight"]>>;
+            provenance: z.ZodDefault<z.ZodObject<{
+                round: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+                changeId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+                actor: z.ZodDefault<z.ZodEnum<["agent", "user"]>>;
+            }, "strict", z.ZodTypeAny, {
+                round: number | null;
+                changeId: string | null;
+                actor: "agent" | "user";
+            }, {
+                round?: number | null | undefined;
+                changeId?: string | null | undefined;
+                actor?: "agent" | "user" | undefined;
+            }>>;
+        }, "strict", z.ZodTypeAny, {
+            anchor: {
+                type: "words";
+                source: string;
+                phrase: string;
+                occurrence?: number | undefined;
+                resolved?: {
+                    start: number;
+                    end: number;
+                } | undefined;
+                edge?: "start" | "end" | undefined;
+            };
+            id: string;
+            provenance: {
+                round: number | null;
+                changeId: string | null;
+                actor: "agent" | "user";
+            };
+            op: "replace-text" | "hide" | "break-line" | "style";
+            text?: string | undefined;
+            color?: string | undefined;
+            emphasis?: "pop" | "highlight" | undefined;
+        }, {
+            anchor: {
+                type: "words";
+                source: string;
+                phrase: string;
+                occurrence?: number | undefined;
+                resolved?: {
+                    start: number;
+                    end: number;
+                } | undefined;
+                edge?: "start" | "end" | undefined;
+            };
+            id: string;
+            op: "replace-text" | "hide" | "break-line" | "style";
+            text?: string | undefined;
+            provenance?: {
+                round?: number | null | undefined;
+                changeId?: string | null | undefined;
+                actor?: "agent" | "user" | undefined;
+            } | undefined;
+            color?: string | undefined;
+            emphasis?: "pop" | "highlight" | undefined;
+        }>, "many">>;
+    }, "strict", z.ZodTypeAny, {
+        preset: "grouped" | "opus-karaoke";
+        style: {
+            maxWords?: number | undefined;
+            gapBreakS?: number | undefined;
+            leadS?: number | undefined;
+            holdS?: number | undefined;
+            karaoke?: boolean | undefined;
+        } & {
+            [k: string]: unknown;
+        };
+        enabled: boolean;
+        overrides: {
+            anchor: {
+                type: "words";
+                source: string;
+                phrase: string;
+                occurrence?: number | undefined;
+                resolved?: {
+                    start: number;
+                    end: number;
+                } | undefined;
+                edge?: "start" | "end" | undefined;
+            };
+            id: string;
+            provenance: {
+                round: number | null;
+                changeId: string | null;
+                actor: "agent" | "user";
+            };
+            op: "replace-text" | "hide" | "break-line" | "style";
+            text?: string | undefined;
+            color?: string | undefined;
+            emphasis?: "pop" | "highlight" | undefined;
+        }[];
+    }, {
+        preset?: "grouped" | "opus-karaoke" | undefined;
+        style?: z.objectInputType<{
+            /** Max words per grouped cue (preset "grouped" only). */
+            maxWords: z.ZodOptional<z.ZodNumber>;
+            /** Inter-word gap (seconds) that ends a phrase — a hard cue boundary
+             *  (preset "grouped" only). */
+            gapBreakS: z.ZodOptional<z.ZodNumber>;
+            /** Seconds each cue's display start is shifted EARLIER (clamped to the
+             *  previous cue's end / the segment's outStart). */
+            leadS: z.ZodOptional<z.ZodNumber>;
+            /** Max seconds a cue is held past its last word to bridge the gap to the
+             *  next cue (never past the segment's outEnd). */
+            holdS: z.ZodOptional<z.ZodNumber>;
+            /** Per-word highlight sweep within grouped cues (karaoke-style). */
+            karaoke: z.ZodOptional<z.ZodBoolean>;
+        }, z.ZodTypeAny, "passthrough"> | undefined;
+        enabled?: boolean | undefined;
+        overrides?: {
+            anchor: {
+                type: "words";
+                source: string;
+                phrase: string;
+                occurrence?: number | undefined;
+                resolved?: {
+                    start: number;
+                    end: number;
+                } | undefined;
+                edge?: "start" | "end" | undefined;
+            };
+            id: string;
+            op: "replace-text" | "hide" | "break-line" | "style";
+            text?: string | undefined;
+            provenance?: {
+                round?: number | null | undefined;
+                changeId?: string | null | undefined;
+                actor?: "agent" | "user" | undefined;
+            } | undefined;
+            color?: string | undefined;
+            emphasis?: "pop" | "highlight" | undefined;
+        }[] | undefined;
+    }>>;
+    zooms: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        anchor: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+            type: z.ZodLiteral<"words">;
+            source: z.ZodString;
+            phrase: z.ZodString;
+            /** 1-based occurrence index when the phrase appears more than once. */
+            occurrence: z.ZodOptional<z.ZodNumber>;
+            /** Cached resolution in SOURCE seconds. */
+            resolved: z.ZodOptional<z.ZodObject<{
+                start: z.ZodNumber;
+                end: z.ZodNumber;
+            }, "strict", z.ZodTypeAny, {
+                start: number;
+                end: number;
+            }, {
+                start: number;
+                end: number;
+            }>>;
+            /** Collapse the span to one instant (phrase start or end). */
+            edge: z.ZodOptional<z.ZodEnum<["start", "end"]>>;
+        }, "strict", z.ZodTypeAny, {
+            type: "words";
+            source: string;
+            phrase: string;
+            occurrence?: number | undefined;
+            resolved?: {
+                start: number;
+                end: number;
+            } | undefined;
+            edge?: "start" | "end" | undefined;
+        }, {
+            type: "words";
+            source: string;
+            phrase: string;
+            occurrence?: number | undefined;
+            resolved?: {
+                start: number;
+                end: number;
+            } | undefined;
+            edge?: "start" | "end" | undefined;
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"source">;
+            source: z.ZodString;
+            start: z.ZodNumber;
+            end: z.ZodNumber;
+        }, "strict", z.ZodTypeAny, {
+            type: "source";
+            start: number;
+            end: number;
+            source: string;
+        }, {
+            type: "source";
+            start: number;
+            end: number;
+            source: string;
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"output">;
+            at: z.ZodUnion<[z.ZodEnum<["start", "end", "full"]>, z.ZodObject<{
+                after: z.ZodString;
+            }, "strict", z.ZodTypeAny, {
+                after: string;
+            }, {
+                after: string;
+            }>]>;
+            durationS: z.ZodOptional<z.ZodNumber>;
+        }, "strict", z.ZodTypeAny, {
+            type: "output";
+            at: "start" | "end" | "full" | {
+                after: string;
+            };
+            durationS?: number | undefined;
+        }, {
+            type: "output";
+            at: "start" | "end" | "full" | {
+                after: string;
+            };
+            durationS?: number | undefined;
+        }>]>;
+        onCut: z.ZodDefault<z.ZodEnum<["clip", "drop", "error"]>>;
+        rect: z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            w: z.ZodNumber;
+            h: z.ZodNumber;
+        }, "strict", z.ZodTypeAny, {
+            w: number;
+            h: number;
+            x: number;
+            y: number;
+        }, {
+            w: number;
+            h: number;
+            x: number;
+            y: number;
+        }>;
+        scale: z.ZodNumber;
+        /** Ramp target: when present, the zoom animates from the base rect/scale
+         *  to `to` over the zoom window (`ease` shapes the ramp). */
+        to: z.ZodOptional<z.ZodObject<{
+            rect: z.ZodOptional<z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+                w: z.ZodNumber;
+                h: z.ZodNumber;
+            }, "strict", z.ZodTypeAny, {
+                w: number;
+                h: number;
+                x: number;
+                y: number;
+            }, {
+                w: number;
+                h: number;
+                x: number;
+                y: number;
+            }>>;
+            scale: z.ZodOptional<z.ZodNumber>;
+        }, "strict", z.ZodTypeAny, {
+            rect?: {
+                w: number;
+                h: number;
+                x: number;
+                y: number;
+            } | undefined;
+            scale?: number | undefined;
+        }, {
+            rect?: {
+                w: number;
+                h: number;
+                x: number;
+                y: number;
+            } | undefined;
+            scale?: number | undefined;
+        }>>;
+        ease: z.ZodDefault<z.ZodObject<{
+            in: z.ZodNumber;
+            out: z.ZodNumber;
+        }, "strict", z.ZodTypeAny, {
+            in: number;
+            out: number;
+        }, {
+            in: number;
+            out: number;
+        }>>;
+        provenance: z.ZodDefault<z.ZodObject<{
+            round: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+            changeId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            actor: z.ZodDefault<z.ZodEnum<["agent", "user"]>>;
+        }, "strict", z.ZodTypeAny, {
+            round: number | null;
+            changeId: string | null;
+            actor: "agent" | "user";
+        }, {
+            round?: number | null | undefined;
+            changeId?: string | null | undefined;
+            actor?: "agent" | "user" | undefined;
+        }>>;
+    }, "strict", z.ZodTypeAny, {
+        anchor: {
+            type: "words";
+            source: string;
+            phrase: string;
+            occurrence?: number | undefined;
+            resolved?: {
+                start: number;
+                end: number;
+            } | undefined;
+            edge?: "start" | "end" | undefined;
+        } | {
+            type: "source";
+            start: number;
+            end: number;
+            source: string;
+        } | {
+            type: "output";
+            at: "start" | "end" | "full" | {
+                after: string;
+            };
+            durationS?: number | undefined;
+        };
+        id: string;
+        provenance: {
+            round: number | null;
+            changeId: string | null;
+            actor: "agent" | "user";
+        };
+        onCut: "error" | "drop" | "clip";
+        rect: {
+            w: number;
+            h: number;
+            x: number;
+            y: number;
+        };
+        scale: number;
+        ease: {
+            in: number;
+            out: number;
+        };
+        to?: {
+            rect?: {
+                w: number;
+                h: number;
+                x: number;
+                y: number;
+            } | undefined;
+            scale?: number | undefined;
+        } | undefined;
+    }, {
+        anchor: {
+            type: "words";
+            source: string;
+            phrase: string;
+            occurrence?: number | undefined;
+            resolved?: {
+                start: number;
+                end: number;
+            } | undefined;
+            edge?: "start" | "end" | undefined;
+        } | {
+            type: "source";
+            start: number;
+            end: number;
+            source: string;
+        } | {
+            type: "output";
+            at: "start" | "end" | "full" | {
+                after: string;
+            };
+            durationS?: number | undefined;
+        };
+        id: string;
+        rect: {
+            w: number;
+            h: number;
+            x: number;
+            y: number;
+        };
+        scale: number;
+        provenance?: {
+            round?: number | null | undefined;
+            changeId?: string | null | undefined;
+            actor?: "agent" | "user" | undefined;
+        } | undefined;
+        onCut?: "error" | "drop" | "clip" | undefined;
+        to?: {
+            rect?: {
+                w: number;
+                h: number;
+                x: number;
+                y: number;
+            } | undefined;
+            scale?: number | undefined;
+        } | undefined;
+        ease?: {
+            in: number;
+            out: number;
+        } | undefined;
+    }>, "many">>;
+    overlays: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        kind: z.ZodEnum<["text", "title-card", "image", "sticker"]>;
+        anchor: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+            type: z.ZodLiteral<"words">;
+            source: z.ZodString;
+            phrase: z.ZodString;
+            /** 1-based occurrence index when the phrase appears more than once. */
+            occurrence: z.ZodOptional<z.ZodNumber>;
+            /** Cached resolution in SOURCE seconds. */
+            resolved: z.ZodOptional<z.ZodObject<{
+                start: z.ZodNumber;
+                end: z.ZodNumber;
+            }, "strict", z.ZodTypeAny, {
+                start: number;
+                end: number;
+            }, {
+                start: number;
+                end: number;
+            }>>;
+            /** Collapse the span to one instant (phrase start or end). */
+            edge: z.ZodOptional<z.ZodEnum<["start", "end"]>>;
+        }, "strict", z.ZodTypeAny, {
+            type: "words";
+            source: string;
+            phrase: string;
+            occurrence?: number | undefined;
+            resolved?: {
+                start: number;
+                end: number;
+            } | undefined;
+            edge?: "start" | "end" | undefined;
+        }, {
+            type: "words";
+            source: string;
+            phrase: string;
+            occurrence?: number | undefined;
+            resolved?: {
+                start: number;
+                end: number;
+            } | undefined;
+            edge?: "start" | "end" | undefined;
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"source">;
+            source: z.ZodString;
+            start: z.ZodNumber;
+            end: z.ZodNumber;
+        }, "strict", z.ZodTypeAny, {
+            type: "source";
+            start: number;
+            end: number;
+            source: string;
+        }, {
+            type: "source";
+            start: number;
+            end: number;
+            source: string;
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"output">;
+            at: z.ZodUnion<[z.ZodEnum<["start", "end", "full"]>, z.ZodObject<{
+                after: z.ZodString;
+            }, "strict", z.ZodTypeAny, {
+                after: string;
+            }, {
+                after: string;
+            }>]>;
+            durationS: z.ZodOptional<z.ZodNumber>;
+        }, "strict", z.ZodTypeAny, {
+            type: "output";
+            at: "start" | "end" | "full" | {
+                after: string;
+            };
+            durationS?: number | undefined;
+        }, {
+            type: "output";
+            at: "start" | "end" | "full" | {
+                after: string;
+            };
+            durationS?: number | undefined;
+        }>]>;
+        onCut: z.ZodDefault<z.ZodEnum<["clip", "drop", "error"]>>;
+        layout: z.ZodDefault<z.ZodObject<{
+            x: z.ZodDefault<z.ZodNumber>;
+            y: z.ZodDefault<z.ZodNumber>;
+            align: z.ZodDefault<z.ZodEnum<["left", "center", "right"]>>;
+            safeArea: z.ZodDefault<z.ZodBoolean>;
+        }, "strict", z.ZodTypeAny, {
+            x: number;
+            y: number;
+            align: "center" | "left" | "right";
+            safeArea: boolean;
+        }, {
+            x?: number | undefined;
+            y?: number | undefined;
+            align?: "center" | "left" | "right" | undefined;
+            safeArea?: boolean | undefined;
+        }>>;
+        text: z.ZodOptional<z.ZodString>;
+        style: z.ZodDefault<z.ZodObject<{
+            preset: z.ZodOptional<z.ZodString>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            preset: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            preset: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">>>;
+        durationS: z.ZodOptional<z.ZodNumber>;
+        asset: z.ZodOptional<z.ZodObject<{
+            ref: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            ref: string;
+        }, {
+            ref: string;
+        }>>;
+        /** Entrance/exit presets (image/sticker overlays). */
+        enter: z.ZodOptional<z.ZodObject<{
+            preset: z.ZodEnum<["fade", "pop", "slide-up", "slide-down", "scale-in"]>;
+            durationS: z.ZodNumber;
+        }, "strict", z.ZodTypeAny, {
+            preset: "pop" | "fade" | "slide-up" | "slide-down" | "scale-in";
+            durationS: number;
+        }, {
+            preset: "pop" | "fade" | "slide-up" | "slide-down" | "scale-in";
+            durationS: number;
+        }>>;
+        exit: z.ZodOptional<z.ZodObject<{
+            preset: z.ZodEnum<["fade", "pop", "slide-up", "slide-down", "scale-in"]>;
+            durationS: z.ZodNumber;
+        }, "strict", z.ZodTypeAny, {
+            preset: "pop" | "fade" | "slide-up" | "slide-down" | "scale-in";
+            durationS: number;
+        }, {
+            preset: "pop" | "fade" | "slide-up" | "slide-down" | "scale-in";
+            durationS: number;
+        }>>;
+        /** Size as canvas fractions (w of canvas width, h of canvas height). */
+        size: z.ZodOptional<z.ZodObject<{
+            w: z.ZodOptional<z.ZodNumber>;
+            h: z.ZodOptional<z.ZodNumber>;
+        }, "strict", z.ZodTypeAny, {
+            w?: number | undefined;
+            h?: number | undefined;
+        }, {
+            w?: number | undefined;
+            h?: number | undefined;
+        }>>;
+        /** Stacking order (CSS z-index); temporal lanes stay non-overlapping. */
+        z: z.ZodOptional<z.ZodNumber>;
+        provenance: z.ZodDefault<z.ZodObject<{
+            round: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+            changeId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            actor: z.ZodDefault<z.ZodEnum<["agent", "user"]>>;
+        }, "strict", z.ZodTypeAny, {
+            round: number | null;
+            changeId: string | null;
+            actor: "agent" | "user";
+        }, {
+            round?: number | null | undefined;
+            changeId?: string | null | undefined;
+            actor?: "agent" | "user" | undefined;
+        }>>;
+    }, "strict", z.ZodTypeAny, {
+        anchor: {
+            type: "words";
+            source: string;
+            phrase: string;
+            occurrence?: number | undefined;
+            resolved?: {
+                start: number;
+                end: number;
+            } | undefined;
+            edge?: "start" | "end" | undefined;
+        } | {
+            type: "source";
+            start: number;
+            end: number;
+            source: string;
+        } | {
+            type: "output";
+            at: "start" | "end" | "full" | {
+                after: string;
+            };
+            durationS?: number | undefined;
+        };
+        kind: "text" | "title-card" | "image" | "sticker";
+        id: string;
+        provenance: {
+            round: number | null;
+            changeId: string | null;
+            actor: "agent" | "user";
+        };
+        style: {
+            preset?: string | undefined;
+        } & {
+            [k: string]: unknown;
+        };
+        onCut: "error" | "drop" | "clip";
+        layout: {
+            x: number;
+            y: number;
+            align: "center" | "left" | "right";
+            safeArea: boolean;
+        };
+        text?: string | undefined;
+        size?: {
+            w?: number | undefined;
+            h?: number | undefined;
+        } | undefined;
+        durationS?: number | undefined;
+        asset?: {
+            ref: string;
+        } | undefined;
+        enter?: {
+            preset: "pop" | "fade" | "slide-up" | "slide-down" | "scale-in";
+            durationS: number;
+        } | undefined;
+        exit?: {
+            preset: "pop" | "fade" | "slide-up" | "slide-down" | "scale-in";
+            durationS: number;
+        } | undefined;
+        z?: number | undefined;
+    }, {
+        anchor: {
+            type: "words";
+            source: string;
+            phrase: string;
+            occurrence?: number | undefined;
+            resolved?: {
+                start: number;
+                end: number;
+            } | undefined;
+            edge?: "start" | "end" | undefined;
+        } | {
+            type: "source";
+            start: number;
+            end: number;
+            source: string;
+        } | {
+            type: "output";
+            at: "start" | "end" | "full" | {
+                after: string;
+            };
+            durationS?: number | undefined;
+        };
+        kind: "text" | "title-card" | "image" | "sticker";
+        id: string;
+        text?: string | undefined;
+        size?: {
+            w?: number | undefined;
+            h?: number | undefined;
+        } | undefined;
+        durationS?: number | undefined;
+        provenance?: {
+            round?: number | null | undefined;
+            changeId?: string | null | undefined;
+            actor?: "agent" | "user" | undefined;
+        } | undefined;
+        style?: z.objectInputType<{
+            preset: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough"> | undefined;
+        onCut?: "error" | "drop" | "clip" | undefined;
+        layout?: {
+            x?: number | undefined;
+            y?: number | undefined;
+            align?: "center" | "left" | "right" | undefined;
+            safeArea?: boolean | undefined;
+        } | undefined;
+        asset?: {
+            ref: string;
+        } | undefined;
+        enter?: {
+            preset: "pop" | "fade" | "slide-up" | "slide-down" | "scale-in";
+            durationS: number;
+        } | undefined;
+        exit?: {
+            preset: "pop" | "fade" | "slide-up" | "slide-down" | "scale-in";
+            durationS: number;
+        } | undefined;
+        z?: number | undefined;
+    }>, "many">>;
+    audio: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        kind: z.ZodEnum<["music", "sfx"]>;
+        asset: z.ZodObject<{
+            ref: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            ref: string;
+        }, {
+            ref: string;
+        }>;
+        anchor: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+            type: z.ZodLiteral<"words">;
+            source: z.ZodString;
+            phrase: z.ZodString;
+            /** 1-based occurrence index when the phrase appears more than once. */
+            occurrence: z.ZodOptional<z.ZodNumber>;
+            /** Cached resolution in SOURCE seconds. */
+            resolved: z.ZodOptional<z.ZodObject<{
+                start: z.ZodNumber;
+                end: z.ZodNumber;
+            }, "strict", z.ZodTypeAny, {
+                start: number;
+                end: number;
+            }, {
+                start: number;
+                end: number;
+            }>>;
+            /** Collapse the span to one instant (phrase start or end). */
+            edge: z.ZodOptional<z.ZodEnum<["start", "end"]>>;
+        }, "strict", z.ZodTypeAny, {
+            type: "words";
+            source: string;
+            phrase: string;
+            occurrence?: number | undefined;
+            resolved?: {
+                start: number;
+                end: number;
+            } | undefined;
+            edge?: "start" | "end" | undefined;
+        }, {
+            type: "words";
+            source: string;
+            phrase: string;
+            occurrence?: number | undefined;
+            resolved?: {
+                start: number;
+                end: number;
+            } | undefined;
+            edge?: "start" | "end" | undefined;
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"source">;
+            source: z.ZodString;
+            start: z.ZodNumber;
+            end: z.ZodNumber;
+        }, "strict", z.ZodTypeAny, {
+            type: "source";
+            start: number;
+            end: number;
+            source: string;
+        }, {
+            type: "source";
+            start: number;
+            end: number;
+            source: string;
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"output">;
+            at: z.ZodUnion<[z.ZodEnum<["start", "end", "full"]>, z.ZodObject<{
+                after: z.ZodString;
+            }, "strict", z.ZodTypeAny, {
+                after: string;
+            }, {
+                after: string;
+            }>]>;
+            durationS: z.ZodOptional<z.ZodNumber>;
+        }, "strict", z.ZodTypeAny, {
+            type: "output";
+            at: "start" | "end" | "full" | {
+                after: string;
+            };
+            durationS?: number | undefined;
+        }, {
+            type: "output";
+            at: "start" | "end" | "full" | {
+                after: string;
+            };
+            durationS?: number | undefined;
+        }>]>;
+        gainDb: z.ZodDefault<z.ZodNumber>;
+        duckToSpeech: z.ZodDefault<z.ZodBoolean>;
+        fadeOutS: z.ZodOptional<z.ZodNumber>;
+        provenance: z.ZodDefault<z.ZodObject<{
+            round: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+            changeId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            actor: z.ZodDefault<z.ZodEnum<["agent", "user"]>>;
+        }, "strict", z.ZodTypeAny, {
+            round: number | null;
+            changeId: string | null;
+            actor: "agent" | "user";
+        }, {
+            round?: number | null | undefined;
+            changeId?: string | null | undefined;
+            actor?: "agent" | "user" | undefined;
+        }>>;
+    }, "strict", z.ZodTypeAny, {
+        anchor: {
+            type: "words";
+            source: string;
+            phrase: string;
+            occurrence?: number | undefined;
+            resolved?: {
+                start: number;
+                end: number;
+            } | undefined;
+            edge?: "start" | "end" | undefined;
+        } | {
+            type: "source";
+            start: number;
+            end: number;
+            source: string;
+        } | {
+            type: "output";
+            at: "start" | "end" | "full" | {
+                after: string;
+            };
+            durationS?: number | undefined;
+        };
+        kind: "music" | "sfx";
+        id: string;
+        provenance: {
+            round: number | null;
+            changeId: string | null;
+            actor: "agent" | "user";
+        };
+        asset: {
+            ref: string;
+        };
+        gainDb: number;
+        duckToSpeech: boolean;
+        fadeOutS?: number | undefined;
+    }, {
+        anchor: {
+            type: "words";
+            source: string;
+            phrase: string;
+            occurrence?: number | undefined;
+            resolved?: {
+                start: number;
+                end: number;
+            } | undefined;
+            edge?: "start" | "end" | undefined;
+        } | {
+            type: "source";
+            start: number;
+            end: number;
+            source: string;
+        } | {
+            type: "output";
+            at: "start" | "end" | "full" | {
+                after: string;
+            };
+            durationS?: number | undefined;
+        };
+        kind: "music" | "sfx";
+        id: string;
+        asset: {
+            ref: string;
+        };
+        provenance?: {
+            round?: number | null | undefined;
+            changeId?: string | null | undefined;
+            actor?: "agent" | "user" | undefined;
+        } | undefined;
+        gainDb?: number | undefined;
+        duckToSpeech?: boolean | undefined;
+        fadeOutS?: number | undefined;
+    }>, "many">>;
+}, "strict", z.ZodTypeAny, {
+    audio: {
+        anchor: {
+            type: "words";
+            source: string;
+            phrase: string;
+            occurrence?: number | undefined;
+            resolved?: {
+                start: number;
+                end: number;
+            } | undefined;
+            edge?: "start" | "end" | undefined;
+        } | {
+            type: "source";
+            start: number;
+            end: number;
+            source: string;
+        } | {
+            type: "output";
+            at: "start" | "end" | "full" | {
+                after: string;
+            };
+            durationS?: number | undefined;
+        };
+        kind: "music" | "sfx";
+        id: string;
+        provenance: {
+            round: number | null;
+            changeId: string | null;
+            actor: "agent" | "user";
+        };
+        asset: {
+            ref: string;
+        };
+        gainDb: number;
+        duckToSpeech: boolean;
+        fadeOutS?: number | undefined;
+    }[];
+    id: string;
+    version: 2;
+    sources: Record<string, {
+        path: string;
+        durationS?: number | undefined;
+        transcriptHash?: string | undefined;
+    }>;
+    settings: {
+        canvas: {
+            w: number;
+            h: number;
+        };
+        grade: string | {
+            preset: string;
+            intensity?: number | undefined;
+        };
+        loudnorm: boolean;
+        desilence?: {
+            noiseDb?: number | undefined;
+            minSilence?: number | undefined;
+            targetGap?: number | undefined;
+            leadKeep?: number | undefined;
+            trailKeep?: number | undefined;
+            minSegment?: number | undefined;
+        } | undefined;
+    };
+    cut: {
+        ranges: {
+            start: number;
+            end: number;
+            source: string;
+            id: string;
+            provenance: {
+                round: number | null;
+                changeId: string | null;
+                actor: "agent" | "user";
+            };
+            grade?: string | undefined;
+            beat?: string | undefined;
+            quote?: string | undefined;
+            reason?: string | undefined;
+        }[];
+    };
+    captions: {
+        preset: "grouped" | "opus-karaoke";
+        style: {
+            maxWords?: number | undefined;
+            gapBreakS?: number | undefined;
+            leadS?: number | undefined;
+            holdS?: number | undefined;
+            karaoke?: boolean | undefined;
+        } & {
+            [k: string]: unknown;
+        };
+        enabled: boolean;
+        overrides: {
+            anchor: {
+                type: "words";
+                source: string;
+                phrase: string;
+                occurrence?: number | undefined;
+                resolved?: {
+                    start: number;
+                    end: number;
+                } | undefined;
+                edge?: "start" | "end" | undefined;
+            };
+            id: string;
+            provenance: {
+                round: number | null;
+                changeId: string | null;
+                actor: "agent" | "user";
+            };
+            op: "replace-text" | "hide" | "break-line" | "style";
+            text?: string | undefined;
+            color?: string | undefined;
+            emphasis?: "pop" | "highlight" | undefined;
+        }[];
+    };
+    zooms: {
+        anchor: {
+            type: "words";
+            source: string;
+            phrase: string;
+            occurrence?: number | undefined;
+            resolved?: {
+                start: number;
+                end: number;
+            } | undefined;
+            edge?: "start" | "end" | undefined;
+        } | {
+            type: "source";
+            start: number;
+            end: number;
+            source: string;
+        } | {
+            type: "output";
+            at: "start" | "end" | "full" | {
+                after: string;
+            };
+            durationS?: number | undefined;
+        };
+        id: string;
+        provenance: {
+            round: number | null;
+            changeId: string | null;
+            actor: "agent" | "user";
+        };
+        onCut: "error" | "drop" | "clip";
+        rect: {
+            w: number;
+            h: number;
+            x: number;
+            y: number;
+        };
+        scale: number;
+        ease: {
+            in: number;
+            out: number;
+        };
+        to?: {
+            rect?: {
+                w: number;
+                h: number;
+                x: number;
+                y: number;
+            } | undefined;
+            scale?: number | undefined;
+        } | undefined;
+    }[];
+    overlays: {
+        anchor: {
+            type: "words";
+            source: string;
+            phrase: string;
+            occurrence?: number | undefined;
+            resolved?: {
+                start: number;
+                end: number;
+            } | undefined;
+            edge?: "start" | "end" | undefined;
+        } | {
+            type: "source";
+            start: number;
+            end: number;
+            source: string;
+        } | {
+            type: "output";
+            at: "start" | "end" | "full" | {
+                after: string;
+            };
+            durationS?: number | undefined;
+        };
+        kind: "text" | "title-card" | "image" | "sticker";
+        id: string;
+        provenance: {
+            round: number | null;
+            changeId: string | null;
+            actor: "agent" | "user";
+        };
+        style: {
+            preset?: string | undefined;
+        } & {
+            [k: string]: unknown;
+        };
+        onCut: "error" | "drop" | "clip";
+        layout: {
+            x: number;
+            y: number;
+            align: "center" | "left" | "right";
+            safeArea: boolean;
+        };
+        text?: string | undefined;
+        size?: {
+            w?: number | undefined;
+            h?: number | undefined;
+        } | undefined;
+        durationS?: number | undefined;
+        asset?: {
+            ref: string;
+        } | undefined;
+        enter?: {
+            preset: "pop" | "fade" | "slide-up" | "slide-down" | "scale-in";
+            durationS: number;
+        } | undefined;
+        exit?: {
+            preset: "pop" | "fade" | "slide-up" | "slide-down" | "scale-in";
+            durationS: number;
+        } | undefined;
+        z?: number | undefined;
+    }[];
+}, {
+    id: string;
+    version: 2;
+    sources: Record<string, {
+        path: string;
+        durationS?: number | undefined;
+        transcriptHash?: string | undefined;
+    }>;
+    audio?: {
+        anchor: {
+            type: "words";
+            source: string;
+            phrase: string;
+            occurrence?: number | undefined;
+            resolved?: {
+                start: number;
+                end: number;
+            } | undefined;
+            edge?: "start" | "end" | undefined;
+        } | {
+            type: "source";
+            start: number;
+            end: number;
+            source: string;
+        } | {
+            type: "output";
+            at: "start" | "end" | "full" | {
+                after: string;
+            };
+            durationS?: number | undefined;
+        };
+        kind: "music" | "sfx";
+        id: string;
+        asset: {
+            ref: string;
+        };
+        provenance?: {
+            round?: number | null | undefined;
+            changeId?: string | null | undefined;
+            actor?: "agent" | "user" | undefined;
+        } | undefined;
+        gainDb?: number | undefined;
+        duckToSpeech?: boolean | undefined;
+        fadeOutS?: number | undefined;
+    }[] | undefined;
+    settings?: {
+        canvas?: {
+            w: number;
+            h: number;
+        } | undefined;
+        grade?: string | {
+            preset: string;
+            intensity?: number | undefined;
+        } | undefined;
+        loudnorm?: boolean | undefined;
+        desilence?: {
+            noiseDb?: number | undefined;
+            minSilence?: number | undefined;
+            targetGap?: number | undefined;
+            leadKeep?: number | undefined;
+            trailKeep?: number | undefined;
+            minSegment?: number | undefined;
+        } | undefined;
+    } | undefined;
+    cut?: {
+        ranges?: {
+            start: number;
+            end: number;
+            source: string;
+            id: string;
+            grade?: string | undefined;
+            beat?: string | undefined;
+            quote?: string | undefined;
+            reason?: string | undefined;
+            provenance?: {
+                round?: number | null | undefined;
+                changeId?: string | null | undefined;
+                actor?: "agent" | "user" | undefined;
+            } | undefined;
+        }[] | undefined;
+    } | undefined;
+    captions?: {
+        preset?: "grouped" | "opus-karaoke" | undefined;
+        style?: z.objectInputType<{
+            /** Max words per grouped cue (preset "grouped" only). */
+            maxWords: z.ZodOptional<z.ZodNumber>;
+            /** Inter-word gap (seconds) that ends a phrase — a hard cue boundary
+             *  (preset "grouped" only). */
+            gapBreakS: z.ZodOptional<z.ZodNumber>;
+            /** Seconds each cue's display start is shifted EARLIER (clamped to the
+             *  previous cue's end / the segment's outStart). */
+            leadS: z.ZodOptional<z.ZodNumber>;
+            /** Max seconds a cue is held past its last word to bridge the gap to the
+             *  next cue (never past the segment's outEnd). */
+            holdS: z.ZodOptional<z.ZodNumber>;
+            /** Per-word highlight sweep within grouped cues (karaoke-style). */
+            karaoke: z.ZodOptional<z.ZodBoolean>;
+        }, z.ZodTypeAny, "passthrough"> | undefined;
+        enabled?: boolean | undefined;
+        overrides?: {
+            anchor: {
+                type: "words";
+                source: string;
+                phrase: string;
+                occurrence?: number | undefined;
+                resolved?: {
+                    start: number;
+                    end: number;
+                } | undefined;
+                edge?: "start" | "end" | undefined;
+            };
+            id: string;
+            op: "replace-text" | "hide" | "break-line" | "style";
+            text?: string | undefined;
+            provenance?: {
+                round?: number | null | undefined;
+                changeId?: string | null | undefined;
+                actor?: "agent" | "user" | undefined;
+            } | undefined;
+            color?: string | undefined;
+            emphasis?: "pop" | "highlight" | undefined;
+        }[] | undefined;
+    } | undefined;
+    zooms?: {
+        anchor: {
+            type: "words";
+            source: string;
+            phrase: string;
+            occurrence?: number | undefined;
+            resolved?: {
+                start: number;
+                end: number;
+            } | undefined;
+            edge?: "start" | "end" | undefined;
+        } | {
+            type: "source";
+            start: number;
+            end: number;
+            source: string;
+        } | {
+            type: "output";
+            at: "start" | "end" | "full" | {
+                after: string;
+            };
+            durationS?: number | undefined;
+        };
+        id: string;
+        rect: {
+            w: number;
+            h: number;
+            x: number;
+            y: number;
+        };
+        scale: number;
+        provenance?: {
+            round?: number | null | undefined;
+            changeId?: string | null | undefined;
+            actor?: "agent" | "user" | undefined;
+        } | undefined;
+        onCut?: "error" | "drop" | "clip" | undefined;
+        to?: {
+            rect?: {
+                w: number;
+                h: number;
+                x: number;
+                y: number;
+            } | undefined;
+            scale?: number | undefined;
+        } | undefined;
+        ease?: {
+            in: number;
+            out: number;
+        } | undefined;
+    }[] | undefined;
+    overlays?: {
+        anchor: {
+            type: "words";
+            source: string;
+            phrase: string;
+            occurrence?: number | undefined;
+            resolved?: {
+                start: number;
+                end: number;
+            } | undefined;
+            edge?: "start" | "end" | undefined;
+        } | {
+            type: "source";
+            start: number;
+            end: number;
+            source: string;
+        } | {
+            type: "output";
+            at: "start" | "end" | "full" | {
+                after: string;
+            };
+            durationS?: number | undefined;
+        };
+        kind: "text" | "title-card" | "image" | "sticker";
+        id: string;
+        text?: string | undefined;
+        size?: {
+            w?: number | undefined;
+            h?: number | undefined;
+        } | undefined;
+        durationS?: number | undefined;
+        provenance?: {
+            round?: number | null | undefined;
+            changeId?: string | null | undefined;
+            actor?: "agent" | "user" | undefined;
+        } | undefined;
+        style?: z.objectInputType<{
+            preset: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough"> | undefined;
+        onCut?: "error" | "drop" | "clip" | undefined;
+        layout?: {
+            x?: number | undefined;
+            y?: number | undefined;
+            align?: "center" | "left" | "right" | undefined;
+            safeArea?: boolean | undefined;
+        } | undefined;
+        asset?: {
+            ref: string;
+        } | undefined;
+        enter?: {
+            preset: "pop" | "fade" | "slide-up" | "slide-down" | "scale-in";
+            durationS: number;
+        } | undefined;
+        exit?: {
+            preset: "pop" | "fade" | "slide-up" | "slide-down" | "scale-in";
+            durationS: number;
+        } | undefined;
+        z?: number | undefined;
+    }[] | undefined;
+}>;
+type TimelineV2 = z.infer<typeof timelineV2Schema>;
+interface Diagnostic {
+    /** JSON-path-ish location, e.g. "cut.ranges[2].end". */
+    path: string;
+    code: string;
+    message: string;
+    suggestion?: string;
+    context?: unknown;
+}
+interface Diagnostics {
+    errors: Diagnostic[];
+    warnings: Diagnostic[];
+    /** Item ids removed by onCut:"drop" policy during compile. */
+    dropped: string[];
+}
+interface ParseResult {
+    doc: TimelineV2 | null;
+    errors: Diagnostic[];
+}
+/** Parse + shape-validate a raw JSON value into a TimelineV2 (applying
+ *  defaults). Returns diagnostics instead of throwing. */
+declare function parseTimeline(raw: unknown): ParseResult;
+/** Semantic (beyond-shape) validation. Pure. Capability checks live in
+ *  capabilities.ts (checkCapabilities) so the registry stays injectable. */
+declare function validateTimeline(doc: TimelineV2): {
+    errors: Diagnostic[];
+    warnings: Diagnostic[];
+};
+
+type CapabilityStatus = "ready" | "staged" | "none";
+interface Capability {
+    status: CapabilityStatus;
+}
+type FeatureKey = "cut" | "captions.karaoke" | "captions.word-style" | "captions.karaoke-highlight" | "zoom" | "zoom.ramp" | "overlay.text" | "overlay.title-card" | "overlay.image" | "overlay.sticker" | "overlay.enter-exit" | "audio.music" | "audio.sfx" | "grade";
+declare const CAPABILITIES: Record<string, Capability>;
+/** The ordered, de-duplicated list of feature keys a doc actually uses. */
+declare function usesFromDoc(doc: TimelineV2): string[];
+/** Check used features against a registry (injectable for tests). Unknown
+ *  feature keys are treated as status "none". */
+declare function checkCapabilities(uses: string[], registry?: Record<string, Capability>): {
+    errors: Diagnostic[];
+    warnings: Diagnostic[];
+};
+
+interface StreamWord {
+    /** Index in the word stream (word tokens only, sorted by start). */
+    index: number;
+    start: number;
+    end: number;
+    text: string;
+    /** Normalized token used for matching. */
+    norm: string;
+}
+interface PhraseMatch {
+    /** 1-based occurrence index in stream order. */
+    occurrence: number;
+    start: number;
+    end: number;
+    words: Array<{
+        start: number;
+        end: number;
+        text: string;
+    }>;
+    /** ±5 words of context around the match. */
+    context: string;
+    /** Stream index of the first matched word. */
+    wordIndex: number;
+}
+interface PhraseSuggestion {
+    start: number;
+    end: number;
+    text: string;
+    similarity: number;
+}
+type ResolveOutcome = {
+    status: "ok";
+    match: PhraseMatch;
+    matches: PhraseMatch[];
+} | {
+    status: "ambiguous";
+    candidates: PhraseMatch[];
+} | {
+    status: "not-found";
+    suggestions: PhraseSuggestion[];
+};
+/** Strip leading/trailing non-letter/digit characters and lowercase. Keeps
+ *  interior characters (apostrophes, Hebrew letters, gershayim …) intact. */
+declare function normalizeToken(text: string): string;
+/** Tokenize a phrase on whitespace, normalize, drop empties. */
+declare function normalizePhrase(phrase: string): string[];
+/** Word tokens (type==="word", numeric times) sorted by start, normalized. */
+declare function wordStream(transcript: ScribeTranscript): StreamWord[];
+/** All exact (normalized) occurrences of `phrase` in the stream, in order. */
+declare function findPhrase(stream: StreamWord[], phrase: string): PhraseMatch[];
+/** Nearest windows of the same token count, ranked by string similarity. */
+declare function fuzzySuggestions(stream: StreamWord[], phrase: string, limit?: number): PhraseSuggestion[];
+interface ResolveOptions {
+    /** 1-based occurrence to pick when the phrase repeats. */
+    occurrence?: number;
+    /** Disambiguate by proximity: pick the match whose start is nearest to this
+     *  SOURCE time (seconds). */
+    nearS?: number;
+}
+/** Resolve a phrase to source time. Exactly one match → ok. Multiple matches
+ *  are disambiguated by `occurrence` or `nearS`; otherwise → ambiguous with
+ *  every occurrence listed (±5-word context). Zero matches → not-found with
+ *  fuzzy suggestions. */
+declare function resolvePhrase(stream: StreamWord[], phrase: string, opts?: ResolveOptions): ResolveOutcome;
+
+interface PlanZoomOp {
+    kind: "zoom";
+    itemId: string;
+    rect: {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    };
+    scale: number;
+    ease: {
+        in: number;
+        out: number;
+    };
+    /** Seconds relative to the segment's own start. */
+    tIn: number;
+    tOut: number;
+    /** Ramp target (zoom `to`): animate rect/scale base → target over [tIn, tOut]. */
+    toRect?: {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    };
+    toScale?: number;
+}
+type PlanVideoOp = PlanZoomOp;
+interface PlanSegment {
+    id: string;
+    source: string;
+    srcStart: number;
+    srcEnd: number;
+    outStart: number;
+    outEnd: number;
+    /** The authored cut range this segment came from (pre-desilence). */
+    rangeId: string;
+    videoOps: PlanVideoOp[];
+}
+interface PlanCueWord {
+    /** Offset from the cue's outStart. */
+    t: number;
+    d: number;
+    text: string;
+    /** Per-word color (op:"style" caption override). */
+    color?: string;
+    /** Per-word animated emphasis at the word's onset (op:"style" override). */
+    emphasis?: "pop" | "highlight";
+}
+interface PlanCaptionCueEvent {
+    kind: "caption-cue";
+    outStart: number;
+    outEnd: number;
+    words: PlanCueWord[];
+    /** Force a line break after this cue (break-line override). */
+    lineBreakAfter?: boolean;
+    /** Set when the cue came from a caption override. */
+    itemId?: string;
+    /** Per-word highlight sweep within the cue (captions.style.karaoke). */
+    karaoke?: boolean;
+}
+interface PlanOverlayEvent {
+    kind: "overlay";
+    itemId: string;
+    outStart: number;
+    outEnd: number;
+    overlay: {
+        kind: OverlayItem["kind"];
+        layout: OverlayItem["layout"];
+        text?: string;
+        style: OverlayItem["style"];
+        asset?: {
+            ref: string;
+        };
+        enter?: OverlayFx;
+        exit?: OverlayFx;
+        size?: {
+            w?: number;
+            h?: number;
+        };
+        z?: number;
+    };
+}
+interface PlanAudioEvent {
+    kind: "audio";
+    itemId: string;
+    outStart: number;
+    outEnd: number;
+    audio: {
+        kind: AudioItem["kind"];
+        asset: {
+            ref: string;
+        };
+        gainDb: number;
+        duckToSpeech: boolean;
+        fadeOutS?: number;
+    };
+}
+type PlanEvent = PlanCaptionCueEvent | PlanOverlayEvent | PlanAudioEvent;
+interface Plan {
+    version: 1;
+    fromTimeline: string;
+    timelineHash: string;
+    outputDurationS: number;
+    segments: PlanSegment[];
+    events: PlanEvent[];
+    uses: string[];
+    boundaries: CutBoundary[];
+}
+interface CompileCtx {
+    /** Parsed word-level Scribe transcripts by source name. */
+    transcripts?: Record<string, ScribeTranscript | undefined>;
+    /** "sha256:…" hash of each source's transcript file (anchor cache key). */
+    transcriptHashes?: Record<string, string>;
+    /** Amplitude silences by source (from ffmpeg silencedetect). When omitted,
+     *  the desilence pass sees no silences and keeps ranges as authored. */
+    silencesBySource?: Record<string, SilenceInterval[]>;
+    /** Word-token spans by source for intra-word split protection. Defaults to
+     *  spans derived from `transcripts`. */
+    wordsBySource?: Record<string, SilenceInterval[]>;
+    /** Set false to skip the desilence tighten pass entirely. Default true. */
+    desilence?: boolean;
+    /** Capability registry override (tests). */
+    capabilities?: Record<string, Capability>;
+    /** Existence of referenced asset files by ref (a stat pass gathered by the
+     *  caller — see gatherCompileCtx). A ref mapped to false fails compile with
+     *  "asset-missing"; refs absent from the map are not checked. */
+    assetsPresent?: Record<string, boolean>;
+}
+interface CompileResult {
+    ok: boolean;
+    plan: Plan | null;
+    legacyEdl: Edl | null;
+    diagnostics: Diagnostics;
+    uses: string[];
+}
+/** Deterministic content hash of the (defaults-applied) doc: sha256 over a
+ *  canonical (recursively key-sorted) JSON encoding. */
+declare function timelineHash(doc: TimelineV2): string;
+/** Compile an authored TimelineV2 into a render plan. Pure: never touches the
+ *  filesystem; the CLI layer (io.ts) gathers ctx and writes artifacts. */
+declare function compileTimeline(doc: TimelineV2, ctx?: CompileCtx): CompileResult;
+
+interface TimelineFromEdlOptions {
+    /** Timeline id; default "tl_<uuid>". */
+    id?: string;
+    /** Known source durations (seconds) by source name. */
+    sourceDurations?: Record<string, number>;
+    /** "sha256:…" transcript hashes by source name. */
+    transcriptHashes?: Record<string, string>;
+}
+/** Lift a legacy EDL into a cut-only TimelineV2 document. */
+declare function timelineFromEdl(edl: Edl, opts?: TimelineFromEdlOptions): TimelineV2;
+
+/** Vertical 9:16 master geometry — matches ensureVerticalMaster's output. */
+declare const COMPOSE_WIDTH: 1080;
+declare const COMPOSE_HEIGHT: 1920;
+/** Entry HTML file name inside the composition dir. */
+declare const COMPOSE_ENTRY: "index.html";
+/** Composition-relative media paths written by the `compose` verb. */
+declare const COMPOSE_VIDEO_SRC: "media/source.mp4";
+declare const COMPOSE_AUDIO_SRC: "media/audio.m4a";
+/** The subset of a compiled plan the composition needs. */
+type ComposePlan = Pick<Plan, "segments" | "events">;
+interface ComposeHtmlOptions {
+    /** URL (composition-relative) of the proxy video. Default media/source.mp4. */
+    videoSrc?: string;
+    /** URL (composition-relative) of the CONTINUOUS cut audio — the ffmpeg-cut
+     *  track extracted from preview.mp4. Default media/audio.m4a. */
+    audioSrc?: string;
+    /** Declarative color grade (timeline settings.grade object form) — stamped
+     *  as data-color-grading on the base track-0 clips. */
+    grade?: {
+        preset: string;
+        intensity?: number;
+    };
+}
+/** Element counts as emitted by composeHtml (mirrors its skip rules). */
+interface ComposeCounts {
+    segments: number;
+    cues: number;
+    zooms: number;
+    overlays: number;
+}
+declare function composeCounts(plan: ComposePlan): ComposeCounts;
+/** Declarative HyperFrames composition markup — see module doc. Pure. */
+declare function composeHtml(plan: ComposePlan, options?: ComposeHtmlOptions): string;
+
+declare function timelineJsonPath(jobDir: string): string;
+declare function planPath(jobDir: string): string;
+declare function diagnosticsPath(jobDir: string): string;
+interface LoadedTimeline {
+    doc: TimelineV2 | null;
+    errors: Diagnostic[];
+    raw: unknown;
+}
+/** Read + parse <job>/timeline.json. */
+declare function loadTimeline(jobDir: string): LoadedTimeline;
+/** Transcript file for a source name. Mirrors silence.ts loadWordsBySource:
+ *  transcripts/<name>.json, else the lone transcripts/*.json (single-source
+ *  jobs name the transcript by source stem). */
+declare function transcriptFileForSource(jobDir: string, name: string): string | null;
+declare function sha256File(path: string): string;
+interface GatherOptions {
+    /** Skip ffmpeg silence detection (ctx.silencesBySource stays undefined and
+     *  the compile desilence pass becomes a no-op tighten). */
+    noDetect?: boolean;
+}
+/** Gather the impure CompileCtx inputs for a doc: per-source transcripts +
+ *  hashes, and (unless noDetect) ffmpeg silencedetect maps using the doc's
+ *  desilence settings — the same detection the legacy desilence flow runs. */
+declare function gatherCompileCtx(jobDir: string, doc: TimelineV2, opts?: GatherOptions): Promise<CompileCtx>;
+interface WrittenArtifacts {
+    plan?: string;
+    diagnostics: string;
+    edl?: string;
+}
+/** Write resolved/plan.json + resolved/diagnostics.json (+ legacy edl.json on
+ *  success). diagnostics.json is always written, also for failed compiles. */
+declare function writeCompileArtifacts(jobDir: string, result: CompileResult): WrittenArtifacts;
+/** Update ONLY the captions block of timeline.json (enabled + preset), leaving
+ *  every other byte-level detail of the authored doc as-is. */
+declare function updateCaptionsBlock(jobDir: string, preset: string): {
+    raw: Record<string, unknown>;
+};
+
+export { type Anchor, type AudioItem, CAPABILITIES, COMPOSE_AUDIO_SRC, COMPOSE_ENTRY, COMPOSE_HEIGHT, COMPOSE_VIDEO_SRC, COMPOSE_WIDTH, type Capability, type CapabilityStatus, type CaptionOverride, CommandError, type CompileCtx, type CompileResult, type ComposeCounts, type ComposeHtmlOptions, type ComposePlan, type CutBoundary, type CutRange, DEFAULT_DESILENCE, DEFAULT_EDIT_ROOT, type DesilenceOptions, type DesilenceStats, type Diagnostic, type Diagnostics, type Edl, type EdlOverlay, type EdlRange, type FeatureKey, type FfprobeResult, type FfprobeStream, type OutputAnchor, type OverlayItem, PRESETS, type PhraseMatch, type PhraseSuggestion, type Plan, type PlanAudioEvent, type PlanCaptionCueEvent, type PlanCueWord, type PlanEvent, type PlanOverlayEvent, type PlanSegment, type PlanVideoOp, type PlanZoomOp, type Provenance, type RenderMode, type ResolveOutcome, type ReviewIssue, type ReviewJson, type ScribeTranscript, type ScribeWord, type SilenceInterval, type SourceAnchor, type SourceJson, type StreamWord, type TimelineFromEdlOptions, type TimelineSettings, type TimelineSource, type TimelineV2, type TokenType, VIDEO_EXTS, type VerifyJoinFinding, type VerifyResult, type Warning, type WordsAnchor, type ZoomItem, agentizePrompt, artifactPaths, autoGradeForClip, checkCapabilities, compileTimeline, composeCounts, composeHtml, computeEnvelope, configDir, configEnvPath, cutBoundaries, decideGradeFilter, defaultJobDir, desilenceEdl, detectSilences, diagnosticsPath, displayedDimensions, duplicatedPhrase, duplicatedPhrases, duplicatedSpans, edlPath, ensureTranscribed, ensureVerticalMaster, ffprobe, findPhrase, fuzzySuggestions, gatherCompileCtx, generateQcImages, getPreset, initJob, isoNow, learnedEditingGuardrails, loadApiKey, loadJob, loadTimeline, loadWords, loadWordsBySource, mediaDuration, normalizePhrase, normalizeToken, packTranscripts, parseSilenceDetect, parseTimeline, planPath, pyFixed, pyFixedPad, pyRound, pySpacePad, readEdl, render, requireFfmpeg, resolveJob, resolvePhrase, rotationDegrees, run, runSync, screenTakes, sha256File, shown, silenceDetectArgs, slugify, sourceFromJob, statusPayload, straddlingGap, tightenRange, tightenRanges, timelineFromEdl, timelineHash, timelineJsonPath, timelineV2Schema, timelineView, transcribeBatch, transcribeOne, transcriptFileForSource, transcriptPath, updateCaptionsBlock, usesFromDoc, validateTimeline, verify, videoStream, wordStream, writeAgentManifest, writeBoundaries, writeCompileArtifacts, writeCoverage, writeSilencePrompt, writeTranscriptArtifacts, writeVideoEditingPrompt, writeWarningsFromReview, writeWordDump };