allyhub 0.2.0-next.0 → 0.2.0-next.2

package/node_modules/@allyhub-next/video-core/dist/schema.d.ts

@@ -0,0 +1,352 @@
+import { z } from "zod";
+/** A video format: a preset or even WxH pixels. */
+export declare const VideoFormatSchema: z.ZodString & z.ZodType<import("./formats.js").VideoFormat, string, z.core.$ZodTypeInternals<import("./formats.js").VideoFormat, string>>;
+export declare const ComboSchema: z.ZodRecord<z.ZodString, z.ZodString>;
+export declare const ProblemSchema: z.ZodObject<{
+    code: z.ZodString;
+    level: z.ZodEnum<{
+        error: "error";
+        warn: "warn";
+    }>;
+    message: z.ZodString;
+    piece: z.ZodOptional<z.ZodString>;
+    output: z.ZodOptional<z.ZodString>;
+    combo: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    format: z.ZodOptional<z.ZodString>;
+    part: z.ZodOptional<z.ZodString>;
+    t: z.ZodOptional<z.ZodNumber>;
+    page: z.ZodOptional<z.ZodNumber>;
+    where: z.ZodOptional<z.ZodObject<{
+        file: z.ZodOptional<z.ZodString>;
+        line: z.ZodOptional<z.ZodNumber>;
+        selector: z.ZodOptional<z.ZodString>;
+        bbox: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export declare const Locale: z.ZodString;
+export declare const PieceId: z.ZodString;
+export declare const DimName: z.ZodString;
+export declare const DimValue: z.ZodString;
+export declare const OutputName: z.ZodString;
+export declare const DimsSchema: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>;
+export declare const CandidateSchema: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+    name: z.ZodString;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>]>;
+export declare const SlotSchema: z.ZodUnion<readonly [z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+    name: z.ZodString;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>]>>, z.ZodObject<{
+    pool: z.ZodString;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>]>;
+/** A piece's `matrix`: plain data. */
+export declare const MatrixSchema: z.ZodObject<{
+    dims: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
+    slots: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        name: z.ZodString;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>]>>, z.ZodObject<{
+        pool: z.ZodString;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>]>>>;
+    structures: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
+    combos: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodString>>>;
+    pick: z.ZodOptional<z.ZodNumber>;
+    seed: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+    differ: z.ZodOptional<z.ZodObject<{
+        slots: z.ZodOptional<z.ZodNumber>;
+        first: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodArray<z.ZodString>]>>;
+    }, z.core.$strict>>;
+    rules: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        if: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>>;
+        require: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>>;
+        exclude: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>>;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+/**
+ * A format with its numbers changed ({ format, safe, maxDuration,
+ * loudness }). Its `format` is any string here, like a name in `formats`
+ * (AK-G001 says when it is not one); the rest is checked here.
+ */
+export declare const FormatSpecSchema: z.ZodObject<{
+    format: z.ZodString;
+    safe: z.ZodOptional<z.ZodObject<{
+        top: z.ZodOptional<z.ZodNumber>;
+        bottom: z.ZodOptional<z.ZodNumber>;
+        left: z.ZodOptional<z.ZodNumber>;
+        right: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+    maxDuration: z.ZodOptional<z.ZodNumber>;
+    loudness: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+/** A piece's format: a format's name, or a format with its numbers changed. */
+export declare const FormatEntrySchema: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+    format: z.ZodString;
+    safe: z.ZodOptional<z.ZodObject<{
+        top: z.ZodOptional<z.ZodNumber>;
+        bottom: z.ZodOptional<z.ZodNumber>;
+        left: z.ZodOptional<z.ZodNumber>;
+        right: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+    maxDuration: z.ZodOptional<z.ZodNumber>;
+    loudness: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>]>;
+/** Part defaults: a silent part's length, a voiced part's lead and tail (seconds). */
+export declare const PartDefaultsSchema: z.ZodObject<{
+    dur: z.ZodOptional<z.ZodNumber>;
+    lead: z.ZodOptional<z.ZodNumber>;
+    tail: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+export declare const VideoOptionsMeta: z.ZodObject<{
+    music: z.ZodOptional<z.ZodObject<{
+        file: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>>;
+        from: z.ZodOptional<z.ZodNumber>;
+        loop: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
+            from: z.ZodUnknown;
+            to: z.ZodUnknown;
+        }, z.core.$strict>]>>;
+        play: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            from: z.ZodUnknown;
+            to: z.ZodUnknown;
+        }, z.core.$strict>>>;
+        seam: z.ZodOptional<z.ZodNumber>;
+        meter: z.ZodOptional<z.ZodNumber>;
+        downbeat: z.ZodOptional<z.ZodNumber>;
+        end: z.ZodOptional<z.ZodEnum<{
+            beat: "beat";
+            bar: "bar";
+            film: "film";
+        }>>;
+        snap: z.ZodOptional<z.ZodBoolean>;
+        bpm: z.ZodOptional<z.ZodNumber>;
+        gain: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            at: z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodObject<{
+                part: z.ZodString;
+                at: z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>;
+            }, z.core.$strict>]>;
+            db: z.ZodNumber;
+        }, z.core.$strict>>>;
+        filter: z.ZodOptional<z.ZodString>;
+        eq: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+        compress: z.ZodOptional<z.ZodUnknown>;
+    }, z.core.$strict>>;
+    mix: z.ZodOptional<z.ZodObject<{
+        speech: z.ZodOptional<z.ZodNumber>;
+        music: z.ZodOptional<z.ZodNumber>;
+        musicAlone: z.ZodOptional<z.ZodNumber>;
+        sfx: z.ZodOptional<z.ZodNumber>;
+        footage: z.ZodOptional<z.ZodNumber>;
+        footageUnderSpeech: z.ZodOptional<z.ZodNumber>;
+        duck: z.ZodOptional<z.ZodObject<{
+            db: z.ZodOptional<z.ZodNumber>;
+            attack: z.ZodOptional<z.ZodNumber>;
+            release: z.ZodOptional<z.ZodNumber>;
+            hold: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>;
+        musicFade: z.ZodOptional<z.ZodObject<{
+            in: z.ZodOptional<z.ZodNumber>;
+            out: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    mic: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>, z.ZodLiteral<false>]>>;
+    look: z.ZodOptional<z.ZodString>;
+    defaults: z.ZodOptional<z.ZodObject<{
+        part: z.ZodOptional<z.ZodObject<{
+            dur: z.ZodOptional<z.ZodNumber>;
+            lead: z.ZodOptional<z.ZodNumber>;
+            tail: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    covers: z.ZodOptional<z.ZodLiteral<true>>;
+    fps: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+    transparent: z.ZodOptional<z.ZodBoolean>;
+    maxDuration: z.ZodOptional<z.ZodNumber>;
+    loadLimit: z.ZodOptional<z.ZodNumber>;
+    seekLimit: z.ZodOptional<z.ZodNumber>;
+    deliverable: z.ZodOptional<z.ZodBoolean>;
+    master: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<false>, z.ZodObject<{
+        lufs: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<false>]>>;
+        truePeak: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>]>>;
+    motionBlur: z.ZodOptional<z.ZodObject<{
+        samples: z.ZodNumber;
+        shutter: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+    capture: z.ZodOptional<z.ZodObject<{
+        bloom: z.ZodOptional<z.ZodObject<{
+            threshold: z.ZodOptional<z.ZodNumber>;
+            radius: z.ZodOptional<z.ZodNumber>;
+            strength: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>;
+        aberration: z.ZodOptional<z.ZodNumber>;
+        soften: z.ZodOptional<z.ZodNumber>;
+        vignette: z.ZodOptional<z.ZodNumber>;
+        exposure: z.ZodOptional<z.ZodObject<{
+            drift: z.ZodOptional<z.ZodNumber>;
+            period: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>;
+        grain: z.ZodOptional<z.ZodObject<{
+            amount: z.ZodOptional<z.ZodNumber>;
+            size: z.ZodOptional<z.ZodNumber>;
+            shadows: z.ZodOptional<z.ZodNumber>;
+            highlights: z.ZodOptional<z.ZodNumber>;
+            chroma: z.ZodOptional<z.ZodNumber>;
+            chromaSize: z.ZodOptional<z.ZodNumber>;
+            static: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>;
+        sharpen: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+    post: z.ZodOptional<z.ZodObject<{
+        filter: z.ZodOptional<z.ZodString>;
+        lut: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type VideoOptionsMeta = z.infer<typeof VideoOptionsMeta>;
+export declare const OutputMeta: z.ZodObject<{
+    kind: z.ZodEnum<{
+        video: "video";
+        paged: "paged";
+    }>;
+    options: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strict>;
+export type OutputMeta = z.infer<typeof OutputMeta>;
+export declare const PieceMeta: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>>;
+    format: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        format: z.ZodString;
+        safe: z.ZodOptional<z.ZodObject<{
+            top: z.ZodOptional<z.ZodNumber>;
+            bottom: z.ZodOptional<z.ZodNumber>;
+            left: z.ZodOptional<z.ZodNumber>;
+            right: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>;
+        maxDuration: z.ZodOptional<z.ZodNumber>;
+        loudness: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>]>>;
+    matrix: z.ZodOptional<z.ZodObject<{
+        dims: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
+        slots: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            name: z.ZodString;
+            tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strict>]>>, z.ZodObject<{
+            pool: z.ZodString;
+            tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strict>]>>>;
+        structures: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
+        combos: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodString>>>;
+        pick: z.ZodOptional<z.ZodNumber>;
+        seed: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+        differ: z.ZodOptional<z.ZodObject<{
+            slots: z.ZodOptional<z.ZodNumber>;
+            first: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodArray<z.ZodString>]>>;
+        }, z.core.$strict>>;
+        rules: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            if: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>>;
+            require: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>>;
+            exclude: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>>;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>>;
+    meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    outputs: z.ZodRecord<z.ZodString, z.ZodObject<{
+        kind: z.ZodEnum<{
+            video: "video";
+            paged: "paged";
+        }>;
+        options: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type PieceMeta = z.infer<typeof PieceMeta>;
+/**
+ * The brand's colours, fonts, beat and sounds a project gives every video
+ * and deck, over the clean look (look.ts's LookConfig). allyhub.config.ts
+ * holds it once its schema in @allyhub-next/formats names it.
+ */
+export declare const LookConfigSchema: z.ZodObject<{
+    color: z.ZodOptional<z.ZodObject<{
+        bg: z.ZodOptional<z.ZodString>;
+        fg: z.ZodOptional<z.ZodString>;
+        accent: z.ZodOptional<z.ZodString>;
+        muted: z.ZodOptional<z.ZodString>;
+        surface: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    font: z.ZodOptional<z.ZodObject<{
+        display: z.ZodOptional<z.ZodString>;
+        body: z.ZodOptional<z.ZodString>;
+        mono: z.ZodOptional<z.ZodString>;
+        emoji: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    motion: z.ZodOptional<z.ZodObject<{
+        beat: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+    sfx: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strict>;
+export declare const PropSchemaEntry: z.ZodObject<{
+    type: z.ZodEnum<{
+        number: "number";
+        boolean: "boolean";
+        object: "object";
+        text: "text";
+        color: "color";
+        list: "list";
+        time: "time";
+        asset: "asset";
+    }>;
+}, z.core.$loose>;
+export declare const ComponentEntry: z.ZodObject<{
+    name: z.ZodString;
+    label: z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>;
+    file: z.ZodString;
+    props: z.ZodRecord<z.ZodString, z.ZodObject<{
+        type: z.ZodEnum<{
+            number: "number";
+            boolean: "boolean";
+            object: "object";
+            text: "text";
+            color: "color";
+            list: "list";
+            time: "time";
+            asset: "asset";
+        }>;
+    }, z.core.$loose>>;
+    examples: z.ZodArray<z.ZodString>;
+    hidden: z.ZodBoolean;
+}, z.core.$strict>;
+export type ComponentEntry = z.infer<typeof ComponentEntry>;
+/**
+ * The video module's part of allyhub.config.ts (whose own schema, in
+ * @allyhub-next/formats, leaves `look` and `defaults` to it): the look
+ * every video and deck starts from, and what every video starts from.
+ */
+export declare const VideoConfigSchema: z.ZodObject<{
+    look: z.ZodOptional<z.ZodObject<{
+        color: z.ZodOptional<z.ZodObject<{
+            bg: z.ZodOptional<z.ZodString>;
+            fg: z.ZodOptional<z.ZodString>;
+            accent: z.ZodOptional<z.ZodString>;
+            muted: z.ZodOptional<z.ZodString>;
+            surface: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        font: z.ZodOptional<z.ZodObject<{
+            display: z.ZodOptional<z.ZodString>;
+            body: z.ZodOptional<z.ZodString>;
+            mono: z.ZodOptional<z.ZodString>;
+            emoji: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        motion: z.ZodOptional<z.ZodObject<{
+            beat: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>;
+        sfx: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, z.core.$strict>>;
+    defaults: z.ZodOptional<z.ZodObject<{
+        format: z.ZodOptional<z.ZodString & z.ZodType<import("./formats.js").VideoFormat, string, z.core.$ZodTypeInternals<import("./formats.js").VideoFormat, string>>>;
+        part: z.ZodOptional<z.ZodObject<{
+            dur: z.ZodOptional<z.ZodNumber>;
+            lead: z.ZodOptional<z.ZodNumber>;
+            tail: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+}, z.core.$strip>;
+export type VideoConfig = z.infer<typeof VideoConfigSchema>;
+//# sourceMappingURL=schema.d.ts.map

package/node_modules/@allyhub-next/video-core/dist/script-edit.d.ts

@@ -0,0 +1,176 @@
+import { type SpokenSpan, type TextAnchor } from "./anchors.js";
+import type { ScriptFile, ScriptPart, ScriptText } from "./script.js";
+/** A text of a row, by where it is: "say", "screen.items.0", "screen.price.display". */
+export interface FieldText {
+    field: string;
+    value: string;
+}
+/**
+ * Every text of a row a person can read and change, in the row's order:
+ * what it says, what it shows. A plural or a selection is left
+ * out: its cases are the agent's to write.
+ */
+export declare function partTexts(part: ScriptPart): FieldText[];
+/** The item's own texts (`text`), the same way: "text.url". */
+export declare function itemTexts(script: ScriptFile): FieldText[];
+/** The row with one of its texts changed ("say", "screen.line1"…). */
+export declare function setPartText(part: ScriptPart, field: string, value: string): ScriptPart;
+/** The script with one of the item's own texts changed ("text.url"). */
+export declare function setItemText(script: ScriptFile, field: string, value: string): ScriptFile;
+/** An id no row of either script has: new-1, new-2… The agent names it. */
+export declare function newPartId(...scripts: readonly ScriptFile[]): string;
+/** A row's spoken text, as a field of the row. */
+export declare const SAY = "say";
+/** What a row says, as the words a person edits: as shown, no anchors. */
+export declare const saidText: (part: ScriptPart) => string | undefined;
+/** The anchors of what a row says, by their place in saidText. */
+export declare const saidAnchors: (part: ScriptPart) => TextAnchor[];
+/** The pieces of what a row says that are said another way than shown. */
+export declare const saidSpans: (part: ScriptPart) => SpokenSpan[];
+/** What a row reads aloud, for how long it takes: its line as said. */
+export declare const spokenText: (part: ScriptPart) => string | undefined;
+/**
+ * Where a row the draft removed sits among `rows`: before the next row of
+ * the script that is still there, else after the last one. New rows the
+ * person put before it stay before it.
+ */
+export declare function placeOfRemoved(rows: readonly {
+    id: string;
+}[], base: ScriptFile, id: string): number;
+/** A place in what a row says: the row, and how many characters in. */
+export interface ScriptCaret {
+    id: string;
+    offset: number;
+}
+/** The draft's edits, each a new draft. */
+export declare const draftEdit: {
+    /**
+     * One text of a row. What it says is given as words alone: its anchors
+     * stay with the words the old and the new text share.
+     */
+    text: (draft: ScriptFile, id: string, field: string, value: string) => ScriptFile;
+    title: (draft: ScriptFile, value: string) => ScriptFile;
+    remove: (draft: ScriptFile, id: string) => ScriptFile;
+    /**
+     * Puts a row of the script back where it was, as near as the draft
+     * allows: before the next row of the script the draft still has, else last.
+     */
+    restore(draft: ScriptFile, base: ScriptFile, id: string): ScriptFile;
+    /** A new, empty row after `after` (first when undefined). */
+    add(draft: ScriptFile, base: ScriptFile, after: string | undefined): {
+        script: {
+            parts: ScriptPart[];
+            title?: string;
+            text?: Record<string, ScriptText>;
+        };
+        id: string;
+    };
+    /** Text typed or pasted into what a row says, at a place in it. */
+    insert(draft: ScriptFile, at: ScriptCaret, text: string): {
+        script: ScriptFile;
+        caret: ScriptCaret;
+    };
+    /**
+     * Text typed over a selection. Within one row it is one change, so an
+     * anchor on a word that is typed over stays on the word that takes its
+     * place; across rows, the selection is cut and the text typed where the
+     * rows now join.
+     */
+    replace(draft: ScriptFile, a: ScriptCaret, b: ScriptCaret, text: string): {
+        script: ScriptFile;
+        caret: ScriptCaret;
+    } | {
+        script: {
+            parts: ScriptPart[];
+            title?: string;
+            text?: Record<string, ScriptText>;
+        };
+        caret: undefined;
+    };
+    /**
+     * What a selection covers, removed: within one row, those characters;
+     * across rows, the end of the first row's words, every row between, and
+     * the start of the last row's. A row the selection covers from its first
+     * character goes whole, and so does a last row covered to its end. The
+     * two rows left stay two rows. `caret` is where the text now joins.
+     */
+    cut(draft: ScriptFile, a: ScriptCaret, b: ScriptCaret): {
+        script: {
+            parts: ScriptPart[];
+            title?: string;
+            text?: Record<string, ScriptText>;
+        };
+        caret: {
+            id: string;
+            offset: number;
+        } | undefined;
+    };
+    /** A row one place up (-1) or down (1). */
+    move(draft: ScriptFile, id: string, by: -1 | 1): ScriptFile;
+    /**
+     * A row cut in two at `offset` of what it says: the row keeps the words
+     * before, a new row after it says the rest.
+     */
+    split(draft: ScriptFile, base: ScriptFile, id: string, offset: number): {
+        script: ScriptFile;
+        id: undefined;
+    } | {
+        script: {
+            parts: ScriptPart[];
+            title?: string;
+            text?: Record<string, ScriptText>;
+        };
+        id: string;
+    };
+    /**
+     * A row's words joined to the row before it (or to the row `into`, when
+     * rows that say nothing lie between); the row itself goes.
+     */
+    merge(draft: ScriptFile, id: string, into?: string): ScriptFile;
+};
+/**
+ * The script with a row for every part of the video, in the video's order
+ * where the script has none: an empty row after the row of the nearest
+ * part before it. A part that only shows footage or says a recording has
+ * no words in the script, and is still a part a person can cut, move or
+ * give words to.
+ */
+export declare function withVideoParts(script: ScriptFile, keys: readonly string[]): ScriptFile;
+export type ScriptChange = {
+    kind: "title";
+    before?: string;
+    after?: string;
+}
+/** One text: of a row (`part`), or the item's own. */
+ | {
+    kind: "text";
+    part?: string;
+    field: string;
+    before?: string;
+    after?: string;
+} | {
+    kind: "remove";
+    part: string;
+    said?: string;
+}
+/** A new row, after `after` (first when absent), with its texts. */
+ | {
+    kind: "add";
+    part: string;
+    after?: string;
+    texts: FieldText[];
+}
+/** A row that changed places: now after `after` (first when absent). */
+ | {
+    kind: "move";
+    part: string;
+    after?: string;
+};
+/**
+ * What the draft changes in the script, in the draft's order: the title,
+ * the item's own texts, then row by row; removed rows last.
+ */
+export declare function scriptChanges(base: ScriptFile, draft: ScriptFile): ScriptChange[];
+/** One change as a line an agent can act on. */
+export declare function changeLine(c: ScriptChange): string;
+//# sourceMappingURL=script-edit.d.ts.map

package/node_modules/@allyhub-next/video-core/dist/script.d.ts

@@ -0,0 +1,67 @@
+import { type TextAnchor } from "./anchors.js";
+import { type MessageValue, type MessagesFile, type VariantsMessage } from "./messages.js";
+/** A text, a list of texts, or a group of them by name. */
+export type ScriptText = MessageValue | ScriptText[] | {
+    [name: string]: ScriptText;
+};
+export interface ScriptPart {
+    /** The part's key in the piece. */
+    id: string;
+    /**
+     * What the part says, as written: one line with its anchors and its
+     * <shown|said> pieces, or a plural or a selection.
+     */
+    say?: string | VariantsMessage;
+    /** What it shows, by name. */
+    screen?: Record<string, ScriptText>;
+}
+export interface ScriptFile {
+    title?: string;
+    /** The item's words that belong to no part, by name. */
+    text?: Record<string, ScriptText>;
+    /** In the order they are told; the piece's code decides the video's. */
+    parts: ScriptPart[];
+}
+/** Where a value sits in the script's document: ["parts", 0, "screen", "line1"]. */
+export type ScriptPath = (string | number)[];
+/** A message a script makes, and where it came from. */
+export interface ScriptKey {
+    key: string;
+    value: MessageValue;
+    path: ScriptPath;
+    /** The anchors of what a part says, by their place in the line as spoken. */
+    anchors?: TextAnchor[];
+}
+/** A script file's name: script.<locale>.yaml (or .yml). */
+export declare const SCRIPT_FILE: RegExp;
+/**
+ * A script from the value its YAML holds, or what is wrong with it, each
+ * with where. Numbers and booleans are not text: a line that is only
+ * "2026" or "yes" needs quotes.
+ */
+export declare function parseScript(raw: unknown): {
+    script: ScriptFile;
+} | {
+    problems: string[];
+};
+/**
+ * What a part says as its message, and its anchors apart, by their place
+ * in the line as said. A line with <shown|said> pieces is a message with
+ * both sides.
+ */
+export declare function saidOf(say: MessageValue): {
+    value: MessageValue;
+    anchors: TextAnchor[];
+};
+/**
+ * The messages a script makes under a piece's prefix, in the script's
+ * order, each with where it came from; and the keys it would make twice
+ * (a screen text named `say`, a text named like a part's own key).
+ */
+export declare function scriptKeys(prefix: string, script: ScriptFile): {
+    keys: ScriptKey[];
+    twice: string[];
+};
+/** A script's messages as a messages file. */
+export declare function scriptMessages(prefix: string, script: ScriptFile): MessagesFile;
+//# sourceMappingURL=script.d.ts.map