@clipwright/core 0.34.0 → 0.36.0

package/dist/reference-profile.d.ts

@@ -0,0 +1,671 @@
+import { z } from "zod";
+import { type ReferenceGraphicKind, type ReferenceSourceKind } from "./reference-kinds.js";
+export { REFERENCE_DESCRIBED_KINDS, REFERENCE_GRAPHIC_KINDS, REFERENCE_SOURCE_KINDS, type ReferenceGraphicKind, type ReferenceSourceKind } from "./reference-kinds.js";
+export declare const REFERENCE_PROFILE_VERSION = "reference-profile-v1";
+export declare const REFERENCE_FORMATS: readonly ["talking_head_graphics", "faceless", "broll", "other"];
+export declare const REFERENCE_BEAT_ROLES: readonly ["hook", "problem", "agitation", "solution", "demo", "proof", "before_after", "social_proof", "offer", "cta", "other"];
+export declare const REFERENCE_POSITIONS: readonly ["full_screen", "top", "center", "bottom", "top_left", "top_right", "bottom_left", "bottom_right", "split_top", "split_bottom", "other"];
+export type ReferencePosition = (typeof REFERENCE_POSITIONS)[number];
+export declare const REFERENCE_CAMERAS: readonly ["static", "punch_in", "zoom_out", "shake", "other"];
+export declare const REFERENCE_TRANSITIONS: readonly ["none", "cut", "wipe", "flash", "zoom", "other"];
+export declare const REFERENCE_SOUND_KINDS: readonly ["click", "toggle", "ring", "answer", "notify", "step", "whoosh", "flash", "pop", "hangup", "money", "edit", "music", "recorded_audio", "other"];
+export declare const REFERENCE_PRESENTER_BEHAVIOURS: readonly ["speaking", "listening", "reacting", "absent"];
+export declare const REFERENCE_CAPTION_POSITIONS: readonly ["top", "middle", "lower", "bottom"];
+export declare const MAX_REFERENCE_SUMMARY_CHARS = 200;
+export declare const MAX_REFERENCE_LABEL_CHARS = 120;
+/** The transcribed words of a 120 s reference stay well under this (Ana, 69 s: 147 words). */
+export declare const MAX_REFERENCE_TRANSCRIPT_WORDS = 1000;
+/** The hook is the reference's first 3 s, carried to the end of its sentence but never past 6 s. */
+export declare const REFERENCE_HOOK_SECONDS = 3;
+export declare const REFERENCE_HOOK_MAX_SECONDS = 6;
+/** What a graphic does at a state change, in a closed set. The reference's words live in transcript, hook, spoken_summary and label_hint. */
+export declare const REFERENCE_STATE_CHANGES: readonly ["appears", "disappears", "toggles_on", "toggles_off", "checked", "value_changes", "highlighted", "other"];
+export type ReferenceStateChange = (typeof REFERENCE_STATE_CHANGES)[number];
+export declare const referenceWord: z.ZodObject<{
+    text: z.ZodString;
+    start_s: z.ZodNumber;
+    end_s: z.ZodNumber;
+    speaker: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const referenceHook: z.ZodObject<{
+    text: z.ZodString;
+    end_s: z.ZodNumber;
+    caption: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const referenceProfile: z.ZodObject<{
+    version: z.ZodLiteral<"reference-profile-v1">;
+    source: z.ZodObject<{
+        digest: z.ZodString;
+        duration_s: z.ZodNumber;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+        url: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    format: z.ZodEnum<{
+        broll: "broll";
+        faceless: "faceless";
+        other: "other";
+        talking_head_graphics: "talking_head_graphics";
+    }>;
+    beats: z.ZodArray<z.ZodObject<{
+        start_frac: z.ZodNumber;
+        end_frac: z.ZodNumber;
+        start_s: z.ZodNumber;
+        end_s: z.ZodNumber;
+        role: z.ZodEnum<{
+            agitation: "agitation";
+            before_after: "before_after";
+            cta: "cta";
+            demo: "demo";
+            hook: "hook";
+            offer: "offer";
+            other: "other";
+            problem: "problem";
+            proof: "proof";
+            social_proof: "social_proof";
+            solution: "solution";
+        }>;
+        spoken_summary: z.ZodString;
+        graphics: z.ZodArray<z.ZodObject<{
+            kind: z.ZodEnum<{
+                callout: "callout";
+                checklist: "checklist";
+                compare: "compare";
+                end_card: "end_card";
+                insert_media: "insert_media";
+                layout_split: "layout_split";
+                lower_third: "lower_third";
+                notification: "notification";
+                overlay_media: "overlay_media";
+                particles: "particles";
+                phone_call: "phone_call";
+                progress: "progress";
+                quote: "quote";
+                rating: "rating";
+                stat: "stat";
+                tag: "tag";
+                title_card: "title_card";
+                unmapped: "unmapped";
+            }>;
+            source_kind: z.ZodEnum<{
+                banner: "banner";
+                before_after_split: "before_after_split";
+                callout: "callout";
+                checklist: "checklist";
+                comment_box: "comment_box";
+                compare: "compare";
+                concept_card: "concept_card";
+                end_card: "end_card";
+                insert_media: "insert_media";
+                layout_split: "layout_split";
+                logo_card: "logo_card";
+                lower_third: "lower_third";
+                notification: "notification";
+                other: "other";
+                overlay_media: "overlay_media";
+                particles: "particles";
+                phone_call: "phone_call";
+                price_card: "price_card";
+                product_ui: "product_ui";
+                progress: "progress";
+                quote: "quote";
+                rating: "rating";
+                screenshot: "screenshot";
+                split_screen: "split_screen";
+                stat: "stat";
+                tag: "tag";
+                title_card: "title_card";
+                toggle_checklist: "toggle_checklist";
+                unmapped: "unmapped";
+            }>;
+            position: z.ZodEnum<{
+                bottom: "bottom";
+                bottom_left: "bottom_left";
+                bottom_right: "bottom_right";
+                center: "center";
+                full_screen: "full_screen";
+                other: "other";
+                split_bottom: "split_bottom";
+                split_top: "split_top";
+                top: "top";
+                top_left: "top_left";
+                top_right: "top_right";
+            }>;
+            state_changes: z.ZodArray<z.ZodObject<{
+                at_frac: z.ZodNumber;
+                change: z.ZodEnum<{
+                    appears: "appears";
+                    checked: "checked";
+                    disappears: "disappears";
+                    highlighted: "highlighted";
+                    other: "other";
+                    toggles_off: "toggles_off";
+                    toggles_on: "toggles_on";
+                    value_changes: "value_changes";
+                }>;
+            }, z.core.$strict>>;
+            label_hint: z.ZodString;
+        }, z.core.$strict>>;
+        camera: z.ZodEnum<{
+            other: "other";
+            punch_in: "punch_in";
+            shake: "shake";
+            static: "static";
+            zoom_out: "zoom_out";
+        }>;
+        transition_in: z.ZodEnum<{
+            cut: "cut";
+            flash: "flash";
+            none: "none";
+            other: "other";
+            wipe: "wipe";
+            zoom: "zoom";
+        }>;
+        sounds: z.ZodArray<z.ZodObject<{
+            at_frac: z.ZodNumber;
+            kind: z.ZodEnum<{
+                answer: "answer";
+                click: "click";
+                edit: "edit";
+                flash: "flash";
+                hangup: "hangup";
+                money: "money";
+                music: "music";
+                notify: "notify";
+                other: "other";
+                pop: "pop";
+                recorded_audio: "recorded_audio";
+                ring: "ring";
+                step: "step";
+                toggle: "toggle";
+                whoosh: "whoosh";
+            }>;
+        }, z.core.$strict>>;
+        presenter_behaviour: z.ZodEnum<{
+            absent: "absent";
+            listening: "listening";
+            reacting: "reacting";
+            speaking: "speaking";
+        }>;
+    }, z.core.$strict>>;
+    captions: z.ZodObject<{
+        present: z.ZodBoolean;
+        words_per_caption_max: z.ZodNumber;
+        position: z.ZodEnum<{
+            bottom: "bottom";
+            lower: "lower";
+            middle: "middle";
+            top: "top";
+        }>;
+        emphasis_style: z.ZodEnum<{
+            color: "color";
+            none: "none";
+            pill: "pill";
+            punch: "punch";
+        }>;
+        hidden_under_graphics: z.ZodBoolean;
+    }, z.core.$strict>;
+    pacing: z.ZodObject<{
+        layer_change_every_s: z.ZodNumber;
+        face_share: z.ZodNumber;
+    }, z.core.$strict>;
+    palette: z.ZodArray<z.ZodString>;
+    music: z.ZodString;
+    unmapped: z.ZodArray<z.ZodObject<{
+        what: z.ZodString;
+        beat_index: z.ZodNumber;
+        suggested_substitute: z.ZodString;
+    }, z.core.$strict>>;
+    analysis: z.ZodObject<{
+        models: z.ZodArray<z.ZodString>;
+        cost_usd: z.ZodOptional<z.ZodNumber>;
+        latency_ms: z.ZodNumber;
+        warnings: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>;
+    voice: z.ZodOptional<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>>;
+    presenter_framing: z.ZodOptional<z.ZodEnum<{
+        close: "close";
+        wide: "wide";
+    }>>;
+    presenter_mic: z.ZodOptional<z.ZodBoolean>;
+    staging: z.ZodOptional<z.ZodObject<{
+        version: z.ZodLiteral<"reference-staging-v1">;
+        analysis_width: z.ZodNumber;
+        anchors: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            t_s: z.ZodNumber;
+        }, z.core.$strict>>;
+        elements: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            beat_index: z.ZodNumber;
+            graphic_index: z.ZodNullable<z.ZodNumber>;
+            kind: z.ZodEnum<{
+                banner: "banner";
+                before_after_split: "before_after_split";
+                callout: "callout";
+                checklist: "checklist";
+                comment_box: "comment_box";
+                compare: "compare";
+                concept_card: "concept_card";
+                end_card: "end_card";
+                insert_media: "insert_media";
+                layout_split: "layout_split";
+                logo_card: "logo_card";
+                lower_third: "lower_third";
+                notification: "notification";
+                other: "other";
+                overlay_media: "overlay_media";
+                particles: "particles";
+                phone_call: "phone_call";
+                price_card: "price_card";
+                product_ui: "product_ui";
+                progress: "progress";
+                quote: "quote";
+                rating: "rating";
+                screenshot: "screenshot";
+                split_screen: "split_screen";
+                stat: "stat";
+                tag: "tag";
+                title_card: "title_card";
+                toggle_checklist: "toggle_checklist";
+                unmapped: "unmapped";
+            }>;
+            rect_hold: z.ZodOptional<z.ZodObject<{
+                left: z.ZodNumber;
+                top: z.ZodNumber;
+                width: z.ZodNumber;
+                height: z.ZodNumber;
+            }, z.core.$strict>>;
+            rect_hold_face: z.ZodOptional<z.ZodObject<{
+                left: z.ZodNumber;
+                top: z.ZodNumber;
+                width: z.ZodNumber;
+                height: z.ZodNumber;
+            }, z.core.$strict>>;
+            rect_method: z.ZodOptional<z.ZodEnum<{
+                "cv-before-after/v1": "cv-before-after/v1";
+                "cv-cells/v1": "cv-cells/v1";
+                "cv-parallax/v1": "cv-parallax/v1";
+                "cv-template/v1": "cv-template/v1";
+                "vision-still": "vision-still";
+                "vision-video": "vision-video";
+                "yunet-native/v1": "yunet-native/v1";
+            }>>;
+            rects: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                t_s: z.ZodNumber;
+                rect: z.ZodObject<{
+                    left: z.ZodNumber;
+                    top: z.ZodNumber;
+                    width: z.ZodNumber;
+                    height: z.ZodNumber;
+                }, z.core.$strict>;
+                visible: z.ZodNumber;
+            }, z.core.$strict>>>;
+            entry: z.ZodOptional<z.ZodObject<{
+                first_visible_s: z.ZodOptional<z.ZodNumber>;
+                settled_s: z.ZodOptional<z.ZodNumber>;
+                anchors: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    id: z.ZodString;
+                    offset_s: z.ZodNumber;
+                }, z.core.$strict>>>;
+                style: z.ZodOptional<z.ZodEnum<{
+                    blur_in: "blur_in";
+                    fade: "fade";
+                    pop: "pop";
+                    scale_up: "scale_up";
+                    slide: "slide";
+                    tilt_in: "tilt_in";
+                    typewriter: "typewriter";
+                    unknown: "unknown";
+                    wipe: "wipe";
+                }>>;
+                from: z.ZodOptional<z.ZodEnum<{
+                    bottom: "bottom";
+                    left: "left";
+                    lower_left: "lower_left";
+                    lower_right: "lower_right";
+                    none: "none";
+                    right: "right";
+                    top: "top";
+                    upper_left: "upper_left";
+                    upper_right: "upper_right";
+                }>>;
+                duration_s: z.ZodOptional<z.ZodNumber>;
+                displacement: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
+                scale_from: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+                method: z.ZodOptional<z.ZodEnum<{
+                    "cv-before-after/v1": "cv-before-after/v1";
+                    "cv-cells/v1": "cv-cells/v1";
+                    "cv-parallax/v1": "cv-parallax/v1";
+                    "cv-template/v1": "cv-template/v1";
+                    "vision-still": "vision-still";
+                    "vision-video": "vision-video";
+                    "yunet-native/v1": "yunet-native/v1";
+                }>>;
+            }, z.core.$strict>>;
+            exit: z.ZodOptional<z.ZodObject<{
+                last_visible_s: z.ZodOptional<z.ZodNumber>;
+                anchors: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    id: z.ZodString;
+                    offset_s: z.ZodNumber;
+                }, z.core.$strict>>>;
+                style: z.ZodOptional<z.ZodEnum<{
+                    blur_in: "blur_in";
+                    cut: "cut";
+                    fade: "fade";
+                    flash: "flash";
+                    pop: "pop";
+                    scale_up: "scale_up";
+                    slide: "slide";
+                    tilt_in: "tilt_in";
+                    typewriter: "typewriter";
+                    unknown: "unknown";
+                    wipe: "wipe";
+                }>>;
+                to: z.ZodOptional<z.ZodEnum<{
+                    bottom: "bottom";
+                    left: "left";
+                    lower_left: "lower_left";
+                    lower_right: "lower_right";
+                    none: "none";
+                    right: "right";
+                    top: "top";
+                    upper_left: "upper_left";
+                    upper_right: "upper_right";
+                }>>;
+                duration_s: z.ZodOptional<z.ZodNumber>;
+                displacement: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
+                method: z.ZodOptional<z.ZodEnum<{
+                    "cv-before-after/v1": "cv-before-after/v1";
+                    "cv-cells/v1": "cv-cells/v1";
+                    "cv-parallax/v1": "cv-parallax/v1";
+                    "cv-template/v1": "cv-template/v1";
+                    "vision-still": "vision-still";
+                    "vision-video": "vision-video";
+                    "yunet-native/v1": "yunet-native/v1";
+                }>>;
+            }, z.core.$strict>>;
+            layer: z.ZodOptional<z.ZodObject<{
+                value: z.ZodEnum<{
+                    behind_presenter: "behind_presenter";
+                    in_front_of_presenter: "in_front_of_presenter";
+                    no_overlap: "no_overlap";
+                    presenter_absent: "presenter_absent";
+                    unknown: "unknown";
+                }>;
+                method: z.ZodEnum<{
+                    "cv-before-after/v1": "cv-before-after/v1";
+                    "cv-cells/v1": "cv-cells/v1";
+                    "cv-parallax/v1": "cv-parallax/v1";
+                    "cv-template/v1": "cv-template/v1";
+                    "vision-still": "vision-still";
+                    "vision-video": "vision-video";
+                    "yunet-native/v1": "yunet-native/v1";
+                }>;
+                covered_by: z.ZodArray<z.ZodEnum<{
+                    body: "body";
+                    chair: "chair";
+                    desk: "desk";
+                    face: "face";
+                    hair: "hair";
+                    hand: "hand";
+                    microphone: "microphone";
+                    other: "other";
+                    shoulder: "shoulder";
+                }>>;
+                face_clear: z.ZodOptional<z.ZodBoolean>;
+                face_core_cover_max: z.ZodOptional<z.ZodNumber>;
+                face_covered_share: z.ZodOptional<z.ZodNumber>;
+                blurs_presenter: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strict>>;
+            motion: z.ZodOptional<z.ZodObject<{
+                kind: z.ZodOptional<z.ZodEnum<{
+                    drift: "drift";
+                    float: "float";
+                    moves_with_frame: "moves_with_frame";
+                    pushed: "pushed";
+                    scale: "scale";
+                    static: "static";
+                }>>;
+                drift_per_s: z.ZodOptional<z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>>;
+                scale_per_s: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+                wobble: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+                    amplitude: z.ZodNumber;
+                    period_s: z.ZodNumber;
+                }, z.core.$strict>>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+        freezes: z.ZodArray<z.ZodObject<{
+            start_s: z.ZodNumber;
+            end_s: z.ZodNumber;
+            anchors: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                offset_s: z.ZodNumber;
+            }, z.core.$strict>>;
+            face_box_start: z.ZodObject<{
+                left: z.ZodNumber;
+                top: z.ZodNumber;
+                width: z.ZodNumber;
+                height: z.ZodNumber;
+            }, z.core.$strict>;
+            face_box_end: z.ZodObject<{
+                left: z.ZodNumber;
+                top: z.ZodNumber;
+                width: z.ZodNumber;
+                height: z.ZodNumber;
+            }, z.core.$strict>;
+            roll_deg: z.ZodNumber;
+            yaw: z.ZodNumber;
+            pitch: z.ZodNumber;
+            gaze: z.ZodOptional<z.ZodEnum<{
+                camera: "camera";
+                closed: "closed";
+                down: "down";
+                element: "element";
+                left: "left";
+                right: "right";
+                up_left: "up_left";
+                up_right: "up_right";
+            }>>;
+            head_roll: z.ZodEnum<{
+                left: "left";
+                right: "right";
+                upright: "upright";
+            }>;
+            expression: z.ZodOptional<z.ZodEnum<{
+                neutral: "neutral";
+                other: "other";
+                smile: "smile";
+                surprised: "surprised";
+                thinking: "thinking";
+            }>>;
+            hands: z.ZodOptional<z.ZodEnum<{
+                at_chest: "at_chest";
+                gesturing: "gesturing";
+                other: "other";
+                out_of_frame: "out_of_frame";
+            }>>;
+            frame_motion: z.ZodOptional<z.ZodObject<{
+                scale_end: z.ZodNumber;
+                centre_shift: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+            }, z.core.$strict>>;
+            ends_with: z.ZodEnum<{
+                cut: "cut";
+                end: "end";
+                flash: "flash";
+                unfreeze: "unfreeze";
+            }>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    transcript: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        text: z.ZodString;
+        start_s: z.ZodNumber;
+        end_s: z.ZodNumber;
+        speaker: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    hook: z.ZodOptional<z.ZodObject<{
+        text: z.ZodString;
+        end_s: z.ZodNumber;
+        caption: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type ReferenceProfile = z.infer<typeof referenceProfile>;
+/** Readers keep a newer profile whole and need only the gaps it names. */
+export declare const referenceProfileRead: z.ZodObject<{
+    version: z.ZodString;
+    beats: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        role: z.ZodString;
+    }, z.core.$loose>>>;
+    unmapped: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        what: z.ZodString;
+        beat_index: z.ZodNumber;
+        suggested_substitute: z.ZodString;
+    }, z.core.$loose>>>;
+}, z.core.$loose>;
+/** What the plan does not reproduce from its reference, one warning per unmapped entry (rule 3, C5). */
+export declare function referenceProfileWarnings(profile: z.input<typeof referenceProfileRead> | undefined): string[];
+/** An analyser's free-text state change as one of our categories; an unrecognised one is other, never kept as text. */
+export declare function mapAnalyserStateChange(text: string): ReferenceStateChange;
+/** The analyser's name for a graphic when it is one we know, else the kind its description names, else other. */
+export declare function mapAnalyserSourceKind(text: string, description?: string): ReferenceSourceKind;
+/** Our kind for an analyser's graphic: product UI and screenshots fill the frame as an insert, or sit over the presenter; what we cannot draw
+ * carries its substitute. */
+export declare function mapAnalyserGraphic(kind: string, position?: ReferencePosition): {
+    kind: ReferenceGraphicKind;
+    unmapped?: string;
+};