@clipwright/core 0.34.0 → 0.36.0

package/dist/reference-staging.js

@@ -0,0 +1,153 @@
+import { z } from "zod";
+import { REFERENCE_SOURCE_KINDS } from "./reference-kinds.js";
+// Staging measured from a reference (#914 D1): each element's place, entry, exit, layer and motion, and each freeze's pose. Every number names the
+// method that produced it; an absent field was not measured and `analysis.warnings` says why. Words come from closed lists, never the reference.
+export const REFERENCE_STAGING_VERSION = "reference-staging-v1";
+export const STAGING_METHODS = ["cv-cells/v1", "cv-template/v1", "cv-parallax/v1", "cv-before-after/v1", "yunet-native/v1", "vision-video",
+    "vision-still"];
+export const STAGING_ANCHOR_KINDS = ["cut", "flash", "freeze_start", "freeze_end", "beat"];
+export const STAGING_ENTRY_STYLES = ["pop", "fade", "blur_in", "slide", "scale_up", "tilt_in", "typewriter", "wipe", "unknown"];
+export const STAGING_EXIT_STYLES = [...STAGING_ENTRY_STYLES, "cut", "flash"];
+export const STAGING_SIDES = ["left", "right", "top", "bottom", "lower_left", "lower_right", "upper_left", "upper_right", "none"];
+export const STAGING_LAYERS = ["in_front_of_presenter", "behind_presenter", "no_overlap", "presenter_absent", "unknown"];
+export const STAGING_COVERS = ["hair", "face", "shoulder", "hand", "body", "chair", "microphone", "desk", "other"];
+export const STAGING_MOTIONS = ["static", "float", "drift", "scale", "moves_with_frame", "pushed"];
+export const STAGING_GAZES = ["camera", "up_left", "up_right", "left", "right", "down", "element", "closed"];
+/** The image side the top of the head leans to; a roll within ±5° is upright. */
+export const STAGING_HEAD_ROLLS = ["left", "right", "upright"];
+export const STAGING_EXPRESSIONS = ["neutral", "smile", "surprised", "thinking", "other"];
+export const STAGING_HANDS = ["at_chest", "gesturing", "out_of_frame", "other"];
+export const STAGING_FREEZE_ENDS = ["cut", "flash", "unfreeze", "end"];
+const frac = z.number().min(0).max(1);
+const seconds = z.number().min(0);
+const anchorId = z.string().regex(new RegExp(`^(${STAGING_ANCHOR_KINDS.join("|")})#\\d+$`));
+const method = z.enum(STAGING_METHODS);
+export const stagingRect = z.strictObject({ left: frac, top: frac, width: frac, height: frac });
+/** A rect in face units: origin the face centre, unit the face height in pixels, so x and y share one scale. */
+const faceUnits = z.number().min(-20).max(20);
+export const stagingFaceRect = z.strictObject({ left: faceUnits, top: faceUnits, width: z.number().positive().max(20), height: z.number().positive().max(20) });
+/** A moment named by its anchor: the nearest anchor on a side is never used, because it moves when the edit does. */
+export const stagingAnchorRef = z.strictObject({ id: anchorId, offset_s: z.number() });
+const entry = z.strictObject({
+    first_visible_s: seconds, settled_s: seconds, anchors: z.array(stagingAnchorRef).max(3),
+    style: z.enum(STAGING_ENTRY_STYLES), from: z.enum(STAGING_SIDES), duration_s: seconds,
+    displacement: z.tuple([z.number(), z.number()]).describe("Settled minus first position, in shares of width and height."),
+    scale_from: z.number().positive().optional(), method,
+}).partial();
+const exit = z.strictObject({
+    last_visible_s: seconds, anchors: z.array(stagingAnchorRef).max(3), style: z.enum(STAGING_EXIT_STYLES), to: z.enum(STAGING_SIDES),
+    duration_s: seconds, displacement: z.tuple([z.number(), z.number()]), method,
+}).partial();
+export const stagingElement = z.strictObject({
+    id: z.string().regex(/^[a-z0-9_]{1,24}$/),
+    beat_index: z.number().int().min(0),
+    graphic_index: z.number().int().min(0).nullable().describe("Its graphic in beats[beat_index].graphics; null when the beat pass missed it."),
+    kind: z.enum(REFERENCE_SOURCE_KINDS),
+    rect_hold: stagingRect.optional(),
+    rect_hold_face: stagingFaceRect.optional(),
+    rect_method: method.optional(),
+    rects: z.array(z.strictObject({ t_s: seconds, rect: stagingRect, visible: frac })).max(60).optional(),
+    entry: entry.optional(),
+    exit: exit.optional(),
+    layer: z.strictObject({
+        value: z.enum(STAGING_LAYERS), method,
+        covered_by: z.array(z.enum(STAGING_COVERS)).max(6),
+        face_clear: z.boolean().optional().describe("The face core stays clear in every measured frame of the element's life."),
+        face_core_cover_max: frac.optional().describe("The largest share of the face core the element covers in any measured frame."),
+        face_covered_share: frac.optional().describe("The share of measured frames in which the element covers the face core."),
+        blurs_presenter: z.boolean().optional(),
+    }).optional(),
+    motion: z.strictObject({
+        kind: z.enum(STAGING_MOTIONS), drift_per_s: z.tuple([z.number(), z.number()]).optional(), scale_per_s: z.number().optional(),
+        wobble: z.strictObject({ amplitude: frac, period_s: seconds }).optional(),
+    }).partial().optional(),
+});
+export const stagingFreeze = z.strictObject({
+    start_s: seconds, end_s: seconds, anchors: z.array(stagingAnchorRef).max(3),
+    face_box_start: stagingRect, face_box_end: stagingRect,
+    roll_deg: z.number().min(-90).max(90), yaw: z.number().min(-3).max(3), pitch: z.number().min(0).max(3),
+    gaze: z.enum(STAGING_GAZES).optional(), head_roll: z.enum(STAGING_HEAD_ROLLS),
+    expression: z.enum(STAGING_EXPRESSIONS).optional(), hands: z.enum(STAGING_HANDS).optional(),
+    frame_motion: z.strictObject({ scale_end: z.number().positive().max(4), centre_shift: z.tuple([z.number(), z.number()]) }).optional(),
+    ends_with: z.enum(STAGING_FREEZE_ENDS),
+});
+/** Elements one staging holds, measured or kept with only the vision pass's box and times (#930 S2). */
+export const MAX_STAGING_ELEMENTS = 40;
+export const referenceStaging = z.strictObject({
+    version: z.literal(REFERENCE_STAGING_VERSION),
+    analysis_width: z.number().int().positive(),
+    anchors: z.array(z.strictObject({ id: anchorId, t_s: seconds })).max(80),
+    elements: z.array(stagingElement).max(MAX_STAGING_ELEMENTS),
+    freezes: z.array(stagingFreeze).max(8),
+});
+/** Cross-field checks a profile runs on its staging: the beats and graphics it names exist, its anchors exist, and its times are ordered. */
+export function stagingIssues(staging, beats, duration) {
+    const out = [];
+    const ids = new Set();
+    staging.anchors.forEach((anchor, index) => {
+        if (ids.has(anchor.id))
+            out.push({ path: ["anchors", index, "id"], message: `${anchor.id} is named twice` });
+        ids.add(anchor.id);
+        if (anchor.t_s > duration)
+            out.push({ path: ["anchors", index, "t_s"], message: `lies past the source's ${duration} s` });
+    });
+    const refs = (path, list) => list?.forEach((ref, index) => {
+        if (!ids.has(ref.id))
+            out.push({ path: [...path, index, "id"], message: `${ref.id} is not in staging.anchors` });
+    });
+    const ordered = (path, times) => {
+        const known = times.filter((entry) => entry[1] !== undefined);
+        known.forEach(([field, t], index) => {
+            if (t > duration)
+                out.push({ path: [...path, field], message: `lies past the source's ${duration} s` });
+            const before = known[index - 1];
+            if (before && t < before[1])
+                out.push({ path: [...path, field], message: `comes before ${before[0]}` });
+        });
+    };
+    staging.elements.forEach((element, index) => {
+        const path = ["elements", index];
+        const beat = beats[element.beat_index];
+        if (!beat)
+            out.push({ path: [...path, "beat_index"], message: `there are ${beats.length} beats` });
+        else if (element.graphic_index !== null && element.graphic_index >= beat.graphics.length) {
+            out.push({ path: [...path, "graphic_index"], message: `beat ${element.beat_index} has ${beat.graphics.length} graphics` });
+        }
+        refs([...path, "entry", "anchors"], element.entry?.anchors);
+        refs([...path, "exit", "anchors"], element.exit?.anchors);
+        ordered(path, [["entry.first_visible_s", element.entry?.first_visible_s], ["entry.settled_s", element.entry?.settled_s],
+            ["exit.last_visible_s", element.exit?.last_visible_s]]);
+        element.rects?.forEach((sample, at) => { if (sample.t_s > duration)
+            out.push({ path: [...path, "rects", at, "t_s"], message: `lies past the source's ${duration} s` }); });
+    });
+    staging.freezes.forEach((freeze, index) => {
+        refs(["freezes", index, "anchors"], freeze.anchors);
+        if (freeze.end_s <= freeze.start_s)
+            out.push({ path: ["freezes", index, "end_s"], message: "ends where or before the freeze starts" });
+        if (freeze.end_s > duration)
+            out.push({ path: ["freezes", index, "end_s"], message: `lies past the source's ${duration} s` });
+    });
+    return out;
+}
+/** A frame rect in face units: origin the face box's centre, unit its height in pixels (Q2: our actor does not sit where theirs does). */
+export function faceRelativeRect(rect, face, width, height) {
+    const unit = face.height * height, cx = (face.left + face.width / 2) * width, cy = (face.top + face.height / 2) * height;
+    const round = (value) => Math.round(value * 1e4) / 1e4;
+    return { left: round((rect.left * width - cx) / unit), top: round((rect.top * height - cy) / unit), width: round((rect.width * width) / unit),
+        height: round((rect.height * height) / unit) };
+}
+/** Samples thinned to change points: one is kept when an edge moved more than `tolerance` since the last kept, and the last always stays. */
+export function thinStagingRects(samples, tolerance = 0.003, max = 60) {
+    const kept = [];
+    samples.forEach((sample, index) => {
+        const last = kept.at(-1);
+        const moved = !last || ["left", "top", "width", "height"].some(edge => Math.abs(sample.rect[edge] - last.rect[edge]) > tolerance);
+        if (moved || index === samples.length - 1)
+            kept.push(sample);
+    });
+    if (kept.length <= max)
+        return kept;
+    const step = (kept.length - 1) / (max - 1);
+    return Array.from({ length: max }, (_, index) => kept[Math.round(index * step)]);
+}
+//# sourceMappingURL=reference-staging.js.map

package/dist/reference-staging.js.map

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

package/dist/reference-voice.d.ts

@@ -0,0 +1,305 @@
+import { z } from "zod";
+export declare const REFERENCE_VOICE_VERSION = "voice-profile-v1";
+export declare const REFERENCE_VOICE_WARNINGS: readonly ["no_sentence_terminal_punctuation_pace_uses_turn_spans", "background_music_present_f0_and_intensity_may_be_contaminated"];
+export declare const MAX_REFERENCE_VOICE_SPEAKERS = 6;
+/** Words per second of our English default (eleven_v4) at speed 1 on the reference reel's text, as measured. */
+export declare const NARRATION_BASELINE_WPS = 2.54;
+/** ElevenLabs' speed range; make_ugc's voice_pace accepts the same. */
+export declare const VOICE_PACE_MIN = 0.7;
+export declare const VOICE_PACE_MAX = 1.2;
+/** No trimmed pause gets shorter than this, whatever the reference measured. */
+export declare const PAUSE_TRIM_FLOOR_S = 0.05;
+/** The longest target make_ugc takes; a reference pause above it is compiled to it, with a plan note. */
+export declare const PAUSE_TRIM_CEILING_S = 2;
+/** make_ugc's opt-in: per gap class, the length a longer pause is cut down to; quiet audio only, a joint that would click is kept. */
+export declare const pauseTrim: z.ZodObject<{
+    sentence_end_s: z.ZodOptional<z.ZodNumber>;
+    comma_s: z.ZodOptional<z.ZodNumber>;
+    mid_phrase_s: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+export type PauseTrimTargets = z.infer<typeof pauseTrim>;
+declare const referenceVoiceSpeaker: z.ZodObject<{
+    speaker: z.ZodString;
+    word_count: z.ZodNumber;
+    sentence_count: z.ZodNumber;
+    pace: z.ZodObject<{
+        status: z.ZodEnum<{
+            measured: "measured";
+            unmeasured: "unmeasured";
+        }>;
+        words_per_second: z.ZodNullable<z.ZodNumber>;
+        basis: z.ZodEnum<{
+            sentence_spans: "sentence_spans";
+            turn_spans: "turn_spans";
+        }>;
+    }, z.core.$strict>;
+    pauses: z.ZodObject<{
+        sentence_end: z.ZodObject<{
+            timestamp: z.ZodObject<{
+                count: z.ZodNumber;
+                median_s: z.ZodNullable<z.ZodNumber>;
+                p90_s: z.ZodNullable<z.ZodNumber>;
+                count_ge150ms: z.ZodNumber;
+            }, z.core.$strict>;
+            acoustic_pause: z.ZodObject<{
+                count: z.ZodNumber;
+                median_s: z.ZodNullable<z.ZodNumber>;
+                p90_s: z.ZodNullable<z.ZodNumber>;
+                count_ge150ms: z.ZodNumber;
+            }, z.core.$strict>;
+            cut_safe: z.ZodObject<{
+                count: z.ZodNumber;
+                median_s: z.ZodNullable<z.ZodNumber>;
+                p90_s: z.ZodNullable<z.ZodNumber>;
+                count_ge150ms: z.ZodNumber;
+            }, z.core.$strict>;
+            acoustic_no_dip_count: z.ZodNumber;
+            acoustic_unconfirmed_count: z.ZodNumber;
+        }, z.core.$strict>;
+        comma: z.ZodObject<{
+            timestamp: z.ZodObject<{
+                count: z.ZodNumber;
+                median_s: z.ZodNullable<z.ZodNumber>;
+                p90_s: z.ZodNullable<z.ZodNumber>;
+                count_ge150ms: z.ZodNumber;
+            }, z.core.$strict>;
+            acoustic_pause: z.ZodObject<{
+                count: z.ZodNumber;
+                median_s: z.ZodNullable<z.ZodNumber>;
+                p90_s: z.ZodNullable<z.ZodNumber>;
+                count_ge150ms: z.ZodNumber;
+            }, z.core.$strict>;
+            cut_safe: z.ZodObject<{
+                count: z.ZodNumber;
+                median_s: z.ZodNullable<z.ZodNumber>;
+                p90_s: z.ZodNullable<z.ZodNumber>;
+                count_ge150ms: z.ZodNumber;
+            }, z.core.$strict>;
+            acoustic_no_dip_count: z.ZodNumber;
+            acoustic_unconfirmed_count: z.ZodNumber;
+        }, z.core.$strict>;
+        mid_phrase: z.ZodObject<{
+            timestamp: z.ZodObject<{
+                count: z.ZodNumber;
+                median_s: z.ZodNullable<z.ZodNumber>;
+                p90_s: z.ZodNullable<z.ZodNumber>;
+                count_ge150ms: z.ZodNumber;
+            }, z.core.$strict>;
+            acoustic_pause: z.ZodObject<{
+                count: z.ZodNumber;
+                median_s: z.ZodNullable<z.ZodNumber>;
+                p90_s: z.ZodNullable<z.ZodNumber>;
+                count_ge150ms: z.ZodNumber;
+            }, z.core.$strict>;
+            cut_safe: z.ZodObject<{
+                count: z.ZodNumber;
+                median_s: z.ZodNullable<z.ZodNumber>;
+                p90_s: z.ZodNullable<z.ZodNumber>;
+                count_ge150ms: z.ZodNumber;
+            }, z.core.$strict>;
+            acoustic_no_dip_count: z.ZodNumber;
+            acoustic_unconfirmed_count: z.ZodNumber;
+        }, z.core.$strict>;
+    }, z.core.$strict>;
+    long_pause_count: z.ZodNumber;
+    hinge: z.ZodObject<{
+        status: z.ZodEnum<{
+            measured: "measured";
+            not_evaluated: "not_evaluated";
+        }>;
+        sentence_share: z.ZodNullable<z.ZodNumber>;
+        evaluated_sentences: z.ZodNumber;
+        coverage: z.ZodNullable<z.ZodNumber>;
+        timestamp_sentence_share: z.ZodNullable<z.ZodNumber>;
+        median_position: z.ZodNullable<z.ZodNumber>;
+        median_seconds: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strict>;
+    pitch: z.ZodObject<{
+        status: z.ZodEnum<{
+            measured: "measured";
+            no_voiced_frames: "no_voiced_frames";
+        }>;
+        ceiling_hz: z.ZodNumber;
+        ceiling_basis: z.ZodEnum<{
+            configured: "configured";
+            default: "default";
+            low_f0: "low_f0";
+        }>;
+        median_hz: z.ZodNullable<z.ZodNumber>;
+        p10_hz: z.ZodNullable<z.ZodNumber>;
+        p90_hz: z.ZodNullable<z.ZodNumber>;
+        range_st: z.ZodNullable<z.ZodNumber>;
+        voiced_frames: z.ZodNumber;
+    }, z.core.$strict>;
+    loudness: z.ZodObject<{
+        status: z.ZodEnum<{
+            measured: "measured";
+            unmeasured: "unmeasured";
+        }>;
+        range_db_p10_p90: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strict>;
+    warnings: z.ZodArray<z.ZodEnum<{
+        background_music_present_f0_and_intensity_may_be_contaminated: "background_music_present_f0_and_intensity_may_be_contaminated";
+        no_sentence_terminal_punctuation_pace_uses_turn_spans: "no_sentence_terminal_punctuation_pace_uses_turn_spans";
+    }>>;
+}, z.core.$strict>;
+export type ReferenceVoiceSpeaker = z.infer<typeof referenceVoiceSpeaker>;
+export declare const referenceVoice: z.ZodObject<{
+    version: z.ZodLiteral<"voice-profile-v1">;
+    method: z.ZodObject<{
+        pause_drop_db: z.ZodNumber;
+        pause_min_run_s: z.ZodNumber;
+        cut_safe_db: z.ZodNumber;
+        pitch: z.ZodLiteral<"yin">;
+        sample_rate: z.ZodNumber;
+    }, z.core.$strict>;
+    presenter_speaker: z.ZodNullable<z.ZodString>;
+    speakers: z.ZodArray<z.ZodObject<{
+        speaker: z.ZodString;
+        word_count: z.ZodNumber;
+        sentence_count: z.ZodNumber;
+        pace: z.ZodObject<{
+            status: z.ZodEnum<{
+                measured: "measured";
+                unmeasured: "unmeasured";
+            }>;
+            words_per_second: z.ZodNullable<z.ZodNumber>;
+            basis: z.ZodEnum<{
+                sentence_spans: "sentence_spans";
+                turn_spans: "turn_spans";
+            }>;
+        }, z.core.$strict>;
+        pauses: z.ZodObject<{
+            sentence_end: z.ZodObject<{
+                timestamp: z.ZodObject<{
+                    count: z.ZodNumber;
+                    median_s: z.ZodNullable<z.ZodNumber>;
+                    p90_s: z.ZodNullable<z.ZodNumber>;
+                    count_ge150ms: z.ZodNumber;
+                }, z.core.$strict>;
+                acoustic_pause: z.ZodObject<{
+                    count: z.ZodNumber;
+                    median_s: z.ZodNullable<z.ZodNumber>;
+                    p90_s: z.ZodNullable<z.ZodNumber>;
+                    count_ge150ms: z.ZodNumber;
+                }, z.core.$strict>;
+                cut_safe: z.ZodObject<{
+                    count: z.ZodNumber;
+                    median_s: z.ZodNullable<z.ZodNumber>;
+                    p90_s: z.ZodNullable<z.ZodNumber>;
+                    count_ge150ms: z.ZodNumber;
+                }, z.core.$strict>;
+                acoustic_no_dip_count: z.ZodNumber;
+                acoustic_unconfirmed_count: z.ZodNumber;
+            }, z.core.$strict>;
+            comma: z.ZodObject<{
+                timestamp: z.ZodObject<{
+                    count: z.ZodNumber;
+                    median_s: z.ZodNullable<z.ZodNumber>;
+                    p90_s: z.ZodNullable<z.ZodNumber>;
+                    count_ge150ms: z.ZodNumber;
+                }, z.core.$strict>;
+                acoustic_pause: z.ZodObject<{
+                    count: z.ZodNumber;
+                    median_s: z.ZodNullable<z.ZodNumber>;
+                    p90_s: z.ZodNullable<z.ZodNumber>;
+                    count_ge150ms: z.ZodNumber;
+                }, z.core.$strict>;
+                cut_safe: z.ZodObject<{
+                    count: z.ZodNumber;
+                    median_s: z.ZodNullable<z.ZodNumber>;
+                    p90_s: z.ZodNullable<z.ZodNumber>;
+                    count_ge150ms: z.ZodNumber;
+                }, z.core.$strict>;
+                acoustic_no_dip_count: z.ZodNumber;
+                acoustic_unconfirmed_count: z.ZodNumber;
+            }, z.core.$strict>;
+            mid_phrase: z.ZodObject<{
+                timestamp: z.ZodObject<{
+                    count: z.ZodNumber;
+                    median_s: z.ZodNullable<z.ZodNumber>;
+                    p90_s: z.ZodNullable<z.ZodNumber>;
+                    count_ge150ms: z.ZodNumber;
+                }, z.core.$strict>;
+                acoustic_pause: z.ZodObject<{
+                    count: z.ZodNumber;
+                    median_s: z.ZodNullable<z.ZodNumber>;
+                    p90_s: z.ZodNullable<z.ZodNumber>;
+                    count_ge150ms: z.ZodNumber;
+                }, z.core.$strict>;
+                cut_safe: z.ZodObject<{
+                    count: z.ZodNumber;
+                    median_s: z.ZodNullable<z.ZodNumber>;
+                    p90_s: z.ZodNullable<z.ZodNumber>;
+                    count_ge150ms: z.ZodNumber;
+                }, z.core.$strict>;
+                acoustic_no_dip_count: z.ZodNumber;
+                acoustic_unconfirmed_count: z.ZodNumber;
+            }, z.core.$strict>;
+        }, z.core.$strict>;
+        long_pause_count: z.ZodNumber;
+        hinge: z.ZodObject<{
+            status: z.ZodEnum<{
+                measured: "measured";
+                not_evaluated: "not_evaluated";
+            }>;
+            sentence_share: z.ZodNullable<z.ZodNumber>;
+            evaluated_sentences: z.ZodNumber;
+            coverage: z.ZodNullable<z.ZodNumber>;
+            timestamp_sentence_share: z.ZodNullable<z.ZodNumber>;
+            median_position: z.ZodNullable<z.ZodNumber>;
+            median_seconds: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strict>;
+        pitch: z.ZodObject<{
+            status: z.ZodEnum<{
+                measured: "measured";
+                no_voiced_frames: "no_voiced_frames";
+            }>;
+            ceiling_hz: z.ZodNumber;
+            ceiling_basis: z.ZodEnum<{
+                configured: "configured";
+                default: "default";
+                low_f0: "low_f0";
+            }>;
+            median_hz: z.ZodNullable<z.ZodNumber>;
+            p10_hz: z.ZodNullable<z.ZodNumber>;
+            p90_hz: z.ZodNullable<z.ZodNumber>;
+            range_st: z.ZodNullable<z.ZodNumber>;
+            voiced_frames: z.ZodNumber;
+        }, z.core.$strict>;
+        loudness: z.ZodObject<{
+            status: z.ZodEnum<{
+                measured: "measured";
+                unmeasured: "unmeasured";
+            }>;
+            range_db_p10_p90: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strict>;
+        warnings: z.ZodArray<z.ZodEnum<{
+            background_music_present_f0_and_intensity_may_be_contaminated: "background_music_present_f0_and_intensity_may_be_contaminated";
+            no_sentence_terminal_punctuation_pace_uses_turn_spans: "no_sentence_terminal_punctuation_pace_uses_turn_spans";
+        }>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type ReferenceVoice = z.infer<typeof referenceVoice>;
+export type NarrationPace = {
+    kind: "paced";
+    target_wps: number;
+    voice_pace: number;
+    wanted: number;
+    clamped: boolean;
+} | {
+    kind: "unmeasured";
+    reason: string;
+};
+/** The presenter's pace as make_ugc's voice_pace against our baseline voice, clamped to the vendor's range. */
+export declare function narrationPaceFromVoice(voice: ReferenceVoice | undefined): NarrationPace;
+export type PauseTrimFromVoice = {
+    targets: PauseTrimTargets;
+    capped: {
+        key: keyof PauseTrimTargets;
+        median_s: number;
+    }[];
+};
+/** The presenter's word-gap medians as trim targets within [floor, ceiling], naming each capped one; undefined when nothing was measured. */
+export declare function pauseTrimFromVoice(voice: ReferenceVoice | undefined): PauseTrimFromVoice | undefined;
+export {};

package/dist/reference-voice.js

@@ -0,0 +1,108 @@
+import { z } from "zod";
+// Voice profile of a reference (reference-elements S7): pace, pauses, pitch and loudness per speaker, measured by our service from the transcribed
+// words and the decoded audio. Numbers only, no words.
+export const REFERENCE_VOICE_VERSION = "voice-profile-v1";
+export const REFERENCE_VOICE_WARNINGS = ["no_sentence_terminal_punctuation_pace_uses_turn_spans",
+    "background_music_present_f0_and_intensity_may_be_contaminated"];
+export const MAX_REFERENCE_VOICE_SPEAKERS = 6;
+/** Words per second of our English default (eleven_v4) at speed 1 on the reference reel's text, as measured. */
+export const NARRATION_BASELINE_WPS = 2.54;
+/** ElevenLabs' speed range; make_ugc's voice_pace accepts the same. */
+export const VOICE_PACE_MIN = 0.7;
+export const VOICE_PACE_MAX = 1.2;
+/** No trimmed pause gets shorter than this, whatever the reference measured. */
+export const PAUSE_TRIM_FLOOR_S = 0.05;
+/** The longest target make_ugc takes; a reference pause above it is compiled to it, with a plan note. */
+export const PAUSE_TRIM_CEILING_S = 2;
+const pauseTarget = z.number().min(PAUSE_TRIM_FLOOR_S).max(PAUSE_TRIM_CEILING_S).optional();
+/** make_ugc's opt-in: per gap class, the length a longer pause is cut down to; quiet audio only, a joint that would click is kept. */
+export const pauseTrim = z.strictObject({ sentence_end_s: pauseTarget, comma_s: pauseTarget, mid_phrase_s: pauseTarget })
+    .refine(targets => Object.values(targets).some(value => value !== undefined), "name at least one gap class");
+const customIssue = "custom";
+const count = z.number().int().min(0);
+const seconds = z.number().min(0);
+const share = z.number().min(0).max(1);
+const pauseSummary = z.strictObject({ count, median_s: seconds.nullable(), p90_s: seconds.nullable(), count_ge150ms: count });
+/** Three layers per gap kind: the ASR word gap, a local energy dip (12 dB below the neighbouring words, 40 ms), and cut-safe quiet (−40 dB). */
+const pauseKind = z.strictObject({ timestamp: pauseSummary, acoustic_pause: pauseSummary, cut_safe: pauseSummary,
+    acoustic_no_dip_count: count, acoustic_unconfirmed_count: count });
+/** A measured value is a number and an unmeasured one null: an absent pitch is never 0 Hz. */
+function pairs(status, measured, values, ctx) {
+    const nulls = Object.entries(values).filter(([, value]) => value === null).map(([key]) => key);
+    if (status === measured && nulls.length)
+        ctx.addIssue({ code: customIssue, message: `${status} needs ${nulls.join(", ")}` });
+    if (status !== measured && nulls.length < Object.keys(values).length)
+        ctx.addIssue({ code: customIssue, message: `${status} keeps its values null` });
+}
+const referenceVoiceSpeaker = z.strictObject({
+    speaker: z.string().regex(/^[A-Za-z0-9_-]{1,40}$/).describe("The transcription vendor's speaker id."),
+    word_count: count,
+    sentence_count: count,
+    pace: z.strictObject({ status: z.enum(["measured", "unmeasured"]), words_per_second: z.number().positive().nullable()
+            .describe("Words over the sum of sentence spans: pauses inside a sentence count, gaps between sentences and other speakers do not."),
+        basis: z.enum(["sentence_spans", "turn_spans"]) })
+        .superRefine((pace, ctx) => pairs(pace.status, "measured", { words_per_second: pace.words_per_second }, ctx)),
+    pauses: z.strictObject({ sentence_end: pauseKind, comma: pauseKind, mid_phrase: pauseKind }),
+    long_pause_count: count.describe("Same-speaker pauses over two seconds, kept with their punctuation kind."),
+    hinge: z.strictObject({ status: z.enum(["measured", "not_evaluated"]),
+        sentence_share: share.nullable().describe("Share of acoustically evaluated sentences with an internal pause of 150 ms or more; not all sentences."),
+        evaluated_sentences: count, coverage: share.nullable(), timestamp_sentence_share: share.nullable(),
+        median_position: share.nullable().describe("Where the hinge falls, as the share of the sentence's words before it."), median_seconds: seconds.nullable() })
+        .superRefine((hinge, ctx) => pairs(hinge.status, "measured", { sentence_share: hinge.sentence_share }, ctx)),
+    pitch: z.strictObject({ status: z.enum(["measured", "no_voiced_frames"]), ceiling_hz: z.number().positive(),
+        ceiling_basis: z.enum(["default", "low_f0", "configured"]).describe("default 400 Hz; low_f0: a median under 165 Hz at 400 is measured again at 300 Hz."),
+        median_hz: z.number().positive().nullable(), p10_hz: z.number().positive().nullable(), p90_hz: z.number().positive().nullable(),
+        range_st: z.number().min(0).nullable(), voiced_frames: count })
+        .superRefine((pitch, ctx) => pairs(pitch.status, "measured", { median_hz: pitch.median_hz, p10_hz: pitch.p10_hz, p90_hz: pitch.p90_hz, range_st: pitch.range_st }, ctx)),
+    loudness: z.strictObject({ status: z.enum(["measured", "unmeasured"]), range_db_p10_p90: z.number().min(0).nullable() })
+        .superRefine((loudness, ctx) => pairs(loudness.status, "measured", { range_db_p10_p90: loudness.range_db_p10_p90 }, ctx)),
+    warnings: z.array(z.enum(REFERENCE_VOICE_WARNINGS)).max(REFERENCE_VOICE_WARNINGS.length),
+});
+export const referenceVoice = z.strictObject({
+    version: z.literal(REFERENCE_VOICE_VERSION),
+    method: z.strictObject({ pause_drop_db: z.number().positive(), pause_min_run_s: z.number().positive(), cut_safe_db: z.number().negative(),
+        pitch: z.literal("yin"), sample_rate: z.number().int().positive() }),
+    presenter_speaker: z.string().nullable(),
+    speakers: z.array(referenceVoiceSpeaker).min(1).max(MAX_REFERENCE_VOICE_SPEAKERS),
+}).superRefine((voice, ctx) => {
+    voice.speakers.forEach((entry, index) => {
+        if (voice.speakers.findIndex(other => other.speaker === entry.speaker) < index) {
+            ctx.addIssue({ code: customIssue, path: ["speakers", index, "speaker"], message: "names a speaker twice" });
+        }
+    });
+    if (voice.presenter_speaker !== null && !voice.speakers.some(entry => entry.speaker === voice.presenter_speaker)) {
+        ctx.addIssue({ code: customIssue, path: ["presenter_speaker"], message: "is not one of the speakers" });
+    }
+});
+/** The presenter's pace as make_ugc's voice_pace against our baseline voice, clamped to the vendor's range. */
+export function narrationPaceFromVoice(voice) {
+    if (!voice)
+        return { kind: "unmeasured", reason: "the reference voice was not measured" };
+    const presenter = voice.speakers.find(entry => entry.speaker === voice.presenter_speaker);
+    if (!presenter)
+        return { kind: "unmeasured", reason: "the reference has no presenter voice" };
+    const target = presenter.pace.words_per_second;
+    if (target === null)
+        return { kind: "unmeasured", reason: "the presenter's pace was not measured" };
+    const wanted = Math.round((target / NARRATION_BASELINE_WPS) * 100) / 100;
+    const pace = Math.min(VOICE_PACE_MAX, Math.max(VOICE_PACE_MIN, wanted));
+    return { kind: "paced", target_wps: Math.round(target * 100) / 100, voice_pace: pace, wanted, clamped: pace !== wanted };
+}
+/** The presenter's word-gap medians as trim targets within [floor, ceiling], naming each capped one; undefined when nothing was measured. */
+export function pauseTrimFromVoice(voice) {
+    const presenter = voice?.speakers.find(entry => entry.speaker === voice.presenter_speaker);
+    if (!presenter)
+        return undefined;
+    const capped = [];
+    const targets = Object.fromEntries([["sentence_end_s", presenter.pauses.sentence_end], ["comma_s", presenter.pauses.comma],
+        ["mid_phrase_s", presenter.pauses.mid_phrase]].flatMap(([key, kind]) => {
+        const median = kind.timestamp.median_s;
+        if (median === null)
+            return [];
+        if (median > PAUSE_TRIM_CEILING_S)
+            capped.push({ key, median_s: median });
+        return [[key, Math.min(PAUSE_TRIM_CEILING_S, Math.max(PAUSE_TRIM_FLOOR_S, median))]];
+    }));
+    return Object.keys(targets).length ? { targets, capped } : undefined;
+}
+//# sourceMappingURL=reference-voice.js.map

package/dist/reference-voice.js.map

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

package/dist/render-backend.d.ts

@@ -58,7 +58,7 @@ export interface BackendCapabilities {
 export interface RenderBackend {
     readonly name: string;
     readonly capabilities: BackendCapabilities;
-    /** Creates the vendor job: PAID and once, apart from the free, resumable poll. Keys vendor */
+    /** Creates the avatar job: PAID and once, apart from the free, resumable poll. Keys vendor */
     /** idempotency on the scope; `retryable` describes the error, and a paid create is never retried. */
     createAvatarJob(req: AvatarClipRequest): Promise<AvatarJobHandle>;
     /** Waits for a terminal state; free and idempotent. Fail-closed: only an explicit success */