@jokerized/decksmith 0.3.0 → 0.3.2

package/dist/types/source/transcode.d.ts

@@ -0,0 +1,83 @@
+export interface TranscodeOptions {
+    /** Longest edge of the box to fit inside, in pixels. Default 1280. */
+    maxEdgePx?: number;
+    /** Seconds to keep. A longer video is TRUNCATED, and the trim is warned. */
+    maxSeconds?: number;
+    /** Wall clock for the ffmpeg run before it is killed. Default 10 minutes. */
+    timeoutMs?: number;
+    /**
+     * TEST SEAM: the binary to run. Only ever "ffmpeg" in src.
+     *
+     * It exists so test/transcode.test.ts can prove the skip path by naming a
+     * binary that is not installed, which is the one branch here that cannot be
+     * exercised on a machine where the feature works.
+     */
+    ffmpeg?: string;
+}
+export interface Transcoded {
+    /** The `out` given, or the `input` given back when nothing was done to it. */
+    path: string;
+    /** Measured off the file `path` names — never the arithmetic that asked for it. */
+    width: number;
+    height: number;
+    /** Absent when the container declares no usable duration, as `Measured` says. */
+    seconds?: number;
+    /** False when `path` is still the original's bytes. */
+    transcoded: boolean;
+    /** What was skipped or traded, and why. Empty when nothing was. */
+    warnings: string[];
+}
+/**
+ * The even box `width`x`height` fits inside, never larger than it started.
+ *
+ * FLOOR to even rather than round, on both edges. Even because VP9 in yuv420p
+ * refuses odd dimensions and says so in a way nobody reads as "your width is
+ * odd"; floor because rounding UP a 1919-wide source that needs no scaling at
+ * all would enlarge it by a pixel, and "never upscale" is easier to keep than to
+ * qualify.
+ *
+ * Rounding each edge independently moves the aspect ratio by up to a pixel's
+ * worth, and there is one place downstream where that is visible: claim-figure
+ * picks a full-width layout at exactly `width / height >= 3` (claim-figure.ts:197),
+ * so a source sitting on that boundary can land either side of it afterwards.
+ * That is a layout choice moving one step, not a deck disagreeing with its file
+ * — the figure carries the measured box, so the planner and the emitter still
+ * describe the same rectangle.
+ */
+export declare function fitBox(width: number, height: number, maxEdgePx: number): {
+    width: number;
+    height: number;
+};
+/**
+ * The command, built where it can be read and tested without running anything.
+ *
+ * The house pattern from src/render/ffmpeg.ts: an exported pure args builder and
+ * a one-line `runTool` at the use site, so the flags are assertable on a machine
+ * with no ffmpeg on it.
+ *
+ * `-an` drops the audio track outright. A clip is emitted muted on purpose — the
+ * deck already spends its single audio track on narration (claim-figure.ts:121)
+ * — so carrying the audio is pure bytes for something nothing will ever unmute.
+ *
+ * `-crf 32 -b:v 0` is libvpx-vp9's constant-quality mode; `-deadline good
+ * -cpu-used 4 -row-mt 1` is the speed setting that makes this affordable at
+ * ingest time (4 seconds of 1080p in 0.8s of wall clock, measured) rather than
+ * the several-minutes-per-clip the encoder's defaults cost. The three bitexact
+ * and metadata flags are the determinism story in the header.
+ */
+export declare function transcodeArgs(input: string, out: string, plan: {
+    width: number;
+    height: number;
+    seconds?: number;
+}): string[];
+/**
+ * Shrink `input` into `out`, and say what the result actually is.
+ *
+ * Throws for exactly one thing: an `input` this cannot measure. That is a bug at
+ * the call site rather than a machine missing a tool — `grabVideo` in harvest
+ * measures the same bytes with the same function before it writes them, and
+ * refuses what it cannot read — and there is no honest box to hand back for a
+ * file whose header says nothing. Everything else that can go wrong comes back
+ * as the original plus a warning.
+ */
+export declare function transcode(input: string, out: string, opts?: TranscodeOptions): Promise<Transcoded>;

package/dist/types/types.d.ts

@@ -23,12 +23,19 @@ export declare const refSchema: z.ZodObject<{
 }, z.core.$strip>;
 export declare const figureSchema: z.ZodObject<{
     id: z.ZodString;
+    kind: z.ZodDefault<z.ZodEnum<{
+        image: "image";
+        clip: "clip";
+    }>>;
     src: z.ZodString;
     caption: z.ZodString;
     width: z.ZodInt;
     height: z.ZodInt;
     sectionId: z.ZodOptional<z.ZodString>;
     mention: z.ZodOptional<z.ZodString>;
+    poster: z.ZodOptional<z.ZodString>;
+    seconds: z.ZodOptional<z.ZodNumber>;
+    href: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export declare const equationSchema: z.ZodObject<{
     id: z.ZodString;
@@ -59,12 +66,19 @@ export declare const sourceSchema: z.ZodObject<{
     }, z.core.$strip>>;
     figures: z.ZodArray<z.ZodObject<{
         id: z.ZodString;
+        kind: z.ZodDefault<z.ZodEnum<{
+            image: "image";
+            clip: "clip";
+        }>>;
         src: z.ZodString;
         caption: z.ZodString;
         width: z.ZodInt;
         height: z.ZodInt;
         sectionId: z.ZodOptional<z.ZodString>;
         mention: z.ZodOptional<z.ZodString>;
+        poster: z.ZodOptional<z.ZodString>;
+        seconds: z.ZodOptional<z.ZodNumber>;
+        href: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
     equations: z.ZodArray<z.ZodObject<{
         id: z.ZodString;
@@ -352,6 +366,33 @@ export declare const insideSchema: z.ZodObject<{
     element: z.ZodString;
     label: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
+/**
+ * The structural job a beat does in a paper-shaped deck.
+ *
+ * A ROLE IS NOT AN ARCHETYPE AND NOT A HEADING. Position and archetype cannot
+ * tell these beats apart — a limitation and a conclusion are both naturally a
+ * `callout`, and the prompt lists both under one tell — and a check on headline
+ * wording is the failure `scanHeadlines` documents, where a sharpened rule was
+ * answered by swapping one verb. So the plan SAYS which beat is which, and
+ * everything downstream reads the declaration rather than guessing at prose.
+ *
+ * AN ENUM, DELIBERATELY, AND THAT IS WHY IT MAY BE SHOWN TO THE MODEL.
+ * `forStructuredOutput` strips numeric and length bounds, which is how `tilt`
+ * came to be required as an unbounded number that `safeParse` then rejected,
+ * discarding whole runs. `enum` is not in that stripped set, so the model sees
+ * exactly the values `storyboardSchema` will accept and cannot cross a bound it
+ * was never shown.
+ *
+ * Optional, and hidden from the planner's schema entirely unless the paper arc
+ * was asked for — see `plannerInvisible` in src/plan/codex.ts. A deck that did
+ * not ask for the arc is byte-for-byte what it was.
+ */
+export declare const beatRoleSchema: z.ZodEnum<{
+    intro: "intro";
+    background: "background";
+    limitations: "limitations";
+    conclusion: "conclusion";
+}>;
 export declare const beatSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     narration: z.ZodOptional<z.ZodString>;
     archetype: z.ZodLiteral<"title">;
@@ -362,6 +403,12 @@ export declare const beatSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     }, z.core.$strip>;
     id: z.ZodString;
     intent: z.ZodString;
+    role: z.ZodOptional<z.ZodEnum<{
+        intro: "intro";
+        background: "background";
+        limitations: "limitations";
+        conclusion: "conclusion";
+    }>>;
     inside: z.ZodOptional<z.ZodObject<{
         beat: z.ZodString;
         element: z.ZodString;
@@ -394,6 +441,12 @@ export declare const beatSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     }, z.core.$strip>;
     id: z.ZodString;
     intent: z.ZodString;
+    role: z.ZodOptional<z.ZodEnum<{
+        intro: "intro";
+        background: "background";
+        limitations: "limitations";
+        conclusion: "conclusion";
+    }>>;
     inside: z.ZodOptional<z.ZodObject<{
         beat: z.ZodString;
         element: z.ZodString;
@@ -431,6 +484,12 @@ export declare const beatSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     }, z.core.$strip>;
     id: z.ZodString;
     intent: z.ZodString;
+    role: z.ZodOptional<z.ZodEnum<{
+        intro: "intro";
+        background: "background";
+        limitations: "limitations";
+        conclusion: "conclusion";
+    }>>;
     inside: z.ZodOptional<z.ZodObject<{
         beat: z.ZodString;
         element: z.ZodString;
@@ -469,6 +528,12 @@ export declare const beatSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     }, z.core.$strip>;
     id: z.ZodString;
     intent: z.ZodString;
+    role: z.ZodOptional<z.ZodEnum<{
+        intro: "intro";
+        background: "background";
+        limitations: "limitations";
+        conclusion: "conclusion";
+    }>>;
     inside: z.ZodOptional<z.ZodObject<{
         beat: z.ZodString;
         element: z.ZodString;
@@ -507,6 +572,12 @@ export declare const beatSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     }, z.core.$strip>;
     id: z.ZodString;
     intent: z.ZodString;
+    role: z.ZodOptional<z.ZodEnum<{
+        intro: "intro";
+        background: "background";
+        limitations: "limitations";
+        conclusion: "conclusion";
+    }>>;
     inside: z.ZodOptional<z.ZodObject<{
         beat: z.ZodString;
         element: z.ZodString;
@@ -541,6 +612,12 @@ export declare const beatSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     }, z.core.$strip>;
     id: z.ZodString;
     intent: z.ZodString;
+    role: z.ZodOptional<z.ZodEnum<{
+        intro: "intro";
+        background: "background";
+        limitations: "limitations";
+        conclusion: "conclusion";
+    }>>;
     inside: z.ZodOptional<z.ZodObject<{
         beat: z.ZodString;
         element: z.ZodString;
@@ -572,6 +649,12 @@ export declare const beatSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     }, z.core.$strip>;
     id: z.ZodString;
     intent: z.ZodString;
+    role: z.ZodOptional<z.ZodEnum<{
+        intro: "intro";
+        background: "background";
+        limitations: "limitations";
+        conclusion: "conclusion";
+    }>>;
     inside: z.ZodOptional<z.ZodObject<{
         beat: z.ZodString;
         element: z.ZodString;
@@ -614,6 +697,12 @@ export declare const beatSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     }, z.core.$strip>;
     id: z.ZodString;
     intent: z.ZodString;
+    role: z.ZodOptional<z.ZodEnum<{
+        intro: "intro";
+        background: "background";
+        limitations: "limitations";
+        conclusion: "conclusion";
+    }>>;
     inside: z.ZodOptional<z.ZodObject<{
         beat: z.ZodString;
         element: z.ZodString;
@@ -658,6 +747,12 @@ export declare const beatSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     }, z.core.$strip>;
     id: z.ZodString;
     intent: z.ZodString;
+    role: z.ZodOptional<z.ZodEnum<{
+        intro: "intro";
+        background: "background";
+        limitations: "limitations";
+        conclusion: "conclusion";
+    }>>;
     inside: z.ZodOptional<z.ZodObject<{
         beat: z.ZodString;
         element: z.ZodString;
@@ -700,6 +795,12 @@ export declare const beatSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     }, z.core.$strip>;
     id: z.ZodString;
     intent: z.ZodString;
+    role: z.ZodOptional<z.ZodEnum<{
+        intro: "intro";
+        background: "background";
+        limitations: "limitations";
+        conclusion: "conclusion";
+    }>>;
     inside: z.ZodOptional<z.ZodObject<{
         beat: z.ZodString;
         element: z.ZodString;
@@ -738,6 +839,12 @@ export declare const beatSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     }, z.core.$strip>;
     id: z.ZodString;
     intent: z.ZodString;
+    role: z.ZodOptional<z.ZodEnum<{
+        intro: "intro";
+        background: "background";
+        limitations: "limitations";
+        conclusion: "conclusion";
+    }>>;
     inside: z.ZodOptional<z.ZodObject<{
         beat: z.ZodString;
         element: z.ZodString;
@@ -770,6 +877,12 @@ export declare const beatSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     }, z.core.$strip>;
     id: z.ZodString;
     intent: z.ZodString;
+    role: z.ZodOptional<z.ZodEnum<{
+        intro: "intro";
+        background: "background";
+        limitations: "limitations";
+        conclusion: "conclusion";
+    }>>;
     inside: z.ZodOptional<z.ZodObject<{
         beat: z.ZodString;
         element: z.ZodString;
@@ -815,6 +928,12 @@ export declare const beatSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     }, z.core.$strip>;
     id: z.ZodString;
     intent: z.ZodString;
+    role: z.ZodOptional<z.ZodEnum<{
+        intro: "intro";
+        background: "background";
+        limitations: "limitations";
+        conclusion: "conclusion";
+    }>>;
     inside: z.ZodOptional<z.ZodObject<{
         beat: z.ZodString;
         element: z.ZodString;
@@ -883,6 +1002,12 @@ export declare const storyboardSchema: z.ZodObject<{
         }, z.core.$strip>;
         id: z.ZodString;
         intent: z.ZodString;
+        role: z.ZodOptional<z.ZodEnum<{
+            intro: "intro";
+            background: "background";
+            limitations: "limitations";
+            conclusion: "conclusion";
+        }>>;
         inside: z.ZodOptional<z.ZodObject<{
             beat: z.ZodString;
             element: z.ZodString;
@@ -915,6 +1040,12 @@ export declare const storyboardSchema: z.ZodObject<{
         }, z.core.$strip>;
         id: z.ZodString;
         intent: z.ZodString;
+        role: z.ZodOptional<z.ZodEnum<{
+            intro: "intro";
+            background: "background";
+            limitations: "limitations";
+            conclusion: "conclusion";
+        }>>;
         inside: z.ZodOptional<z.ZodObject<{
             beat: z.ZodString;
             element: z.ZodString;
@@ -952,6 +1083,12 @@ export declare const storyboardSchema: z.ZodObject<{
         }, z.core.$strip>;
         id: z.ZodString;
         intent: z.ZodString;
+        role: z.ZodOptional<z.ZodEnum<{
+            intro: "intro";
+            background: "background";
+            limitations: "limitations";
+            conclusion: "conclusion";
+        }>>;
         inside: z.ZodOptional<z.ZodObject<{
             beat: z.ZodString;
             element: z.ZodString;
@@ -990,6 +1127,12 @@ export declare const storyboardSchema: z.ZodObject<{
         }, z.core.$strip>;
         id: z.ZodString;
         intent: z.ZodString;
+        role: z.ZodOptional<z.ZodEnum<{
+            intro: "intro";
+            background: "background";
+            limitations: "limitations";
+            conclusion: "conclusion";
+        }>>;
         inside: z.ZodOptional<z.ZodObject<{
             beat: z.ZodString;
             element: z.ZodString;
@@ -1028,6 +1171,12 @@ export declare const storyboardSchema: z.ZodObject<{
         }, z.core.$strip>;
         id: z.ZodString;
         intent: z.ZodString;
+        role: z.ZodOptional<z.ZodEnum<{
+            intro: "intro";
+            background: "background";
+            limitations: "limitations";
+            conclusion: "conclusion";
+        }>>;
         inside: z.ZodOptional<z.ZodObject<{
             beat: z.ZodString;
             element: z.ZodString;
@@ -1062,6 +1211,12 @@ export declare const storyboardSchema: z.ZodObject<{
         }, z.core.$strip>;
         id: z.ZodString;
         intent: z.ZodString;
+        role: z.ZodOptional<z.ZodEnum<{
+            intro: "intro";
+            background: "background";
+            limitations: "limitations";
+            conclusion: "conclusion";
+        }>>;
         inside: z.ZodOptional<z.ZodObject<{
             beat: z.ZodString;
             element: z.ZodString;
@@ -1093,6 +1248,12 @@ export declare const storyboardSchema: z.ZodObject<{
         }, z.core.$strip>;
         id: z.ZodString;
         intent: z.ZodString;
+        role: z.ZodOptional<z.ZodEnum<{
+            intro: "intro";
+            background: "background";
+            limitations: "limitations";
+            conclusion: "conclusion";
+        }>>;
         inside: z.ZodOptional<z.ZodObject<{
             beat: z.ZodString;
             element: z.ZodString;
@@ -1135,6 +1296,12 @@ export declare const storyboardSchema: z.ZodObject<{
         }, z.core.$strip>;
         id: z.ZodString;
         intent: z.ZodString;
+        role: z.ZodOptional<z.ZodEnum<{
+            intro: "intro";
+            background: "background";
+            limitations: "limitations";
+            conclusion: "conclusion";
+        }>>;
         inside: z.ZodOptional<z.ZodObject<{
             beat: z.ZodString;
             element: z.ZodString;
@@ -1179,6 +1346,12 @@ export declare const storyboardSchema: z.ZodObject<{
         }, z.core.$strip>;
         id: z.ZodString;
         intent: z.ZodString;
+        role: z.ZodOptional<z.ZodEnum<{
+            intro: "intro";
+            background: "background";
+            limitations: "limitations";
+            conclusion: "conclusion";
+        }>>;
         inside: z.ZodOptional<z.ZodObject<{
             beat: z.ZodString;
             element: z.ZodString;
@@ -1221,6 +1394,12 @@ export declare const storyboardSchema: z.ZodObject<{
         }, z.core.$strip>;
         id: z.ZodString;
         intent: z.ZodString;
+        role: z.ZodOptional<z.ZodEnum<{
+            intro: "intro";
+            background: "background";
+            limitations: "limitations";
+            conclusion: "conclusion";
+        }>>;
         inside: z.ZodOptional<z.ZodObject<{
             beat: z.ZodString;
             element: z.ZodString;
@@ -1259,6 +1438,12 @@ export declare const storyboardSchema: z.ZodObject<{
         }, z.core.$strip>;
         id: z.ZodString;
         intent: z.ZodString;
+        role: z.ZodOptional<z.ZodEnum<{
+            intro: "intro";
+            background: "background";
+            limitations: "limitations";
+            conclusion: "conclusion";
+        }>>;
         inside: z.ZodOptional<z.ZodObject<{
             beat: z.ZodString;
             element: z.ZodString;
@@ -1291,6 +1476,12 @@ export declare const storyboardSchema: z.ZodObject<{
         }, z.core.$strip>;
         id: z.ZodString;
         intent: z.ZodString;
+        role: z.ZodOptional<z.ZodEnum<{
+            intro: "intro";
+            background: "background";
+            limitations: "limitations";
+            conclusion: "conclusion";
+        }>>;
         inside: z.ZodOptional<z.ZodObject<{
             beat: z.ZodString;
             element: z.ZodString;
@@ -1336,6 +1527,12 @@ export declare const storyboardSchema: z.ZodObject<{
         }, z.core.$strip>;
         id: z.ZodString;
         intent: z.ZodString;
+        role: z.ZodOptional<z.ZodEnum<{
+            intro: "intro";
+            background: "background";
+            limitations: "limitations";
+            conclusion: "conclusion";
+        }>>;
         inside: z.ZodOptional<z.ZodObject<{
             beat: z.ZodString;
             element: z.ZodString;
@@ -1376,6 +1573,10 @@ export declare const prefsSchema: z.ZodObject<{
         normal: "normal";
         dense: "dense";
     }>>;
+    genre: z.ZodDefault<z.ZodEnum<{
+        general: "general";
+        paper: "paper";
+    }>>;
     duration: z.ZodOptional<z.ZodNumber>;
     theme: z.ZodDefault<z.ZodString>;
     animationSpeed: z.ZodDefault<z.ZodNumber>;
@@ -1490,6 +1691,10 @@ export declare const packSchema: z.ZodObject<{
             normal: "normal";
             dense: "dense";
         }>>;
+        genre: z.ZodDefault<z.ZodEnum<{
+            general: "general";
+            paper: "paper";
+        }>>;
         duration: z.ZodOptional<z.ZodNumber>;
         theme: z.ZodDefault<z.ZodString>;
         animationSpeed: z.ZodDefault<z.ZodNumber>;
@@ -1529,12 +1734,19 @@ export declare const packSchema: z.ZodObject<{
         }, z.core.$strip>>;
         figures: z.ZodArray<z.ZodObject<{
             id: z.ZodString;
+            kind: z.ZodDefault<z.ZodEnum<{
+                image: "image";
+                clip: "clip";
+            }>>;
             src: z.ZodString;
             caption: z.ZodString;
             width: z.ZodInt;
             height: z.ZodInt;
             sectionId: z.ZodOptional<z.ZodString>;
             mention: z.ZodOptional<z.ZodString>;
+            poster: z.ZodOptional<z.ZodString>;
+            seconds: z.ZodOptional<z.ZodNumber>;
+            href: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
         equations: z.ZodArray<z.ZodObject<{
             id: z.ZodString;
@@ -1563,6 +1775,12 @@ export declare const packSchema: z.ZodObject<{
             }, z.core.$strip>;
             id: z.ZodString;
             intent: z.ZodString;
+            role: z.ZodOptional<z.ZodEnum<{
+                intro: "intro";
+                background: "background";
+                limitations: "limitations";
+                conclusion: "conclusion";
+            }>>;
             inside: z.ZodOptional<z.ZodObject<{
                 beat: z.ZodString;
                 element: z.ZodString;
@@ -1595,6 +1813,12 @@ export declare const packSchema: z.ZodObject<{
             }, z.core.$strip>;
             id: z.ZodString;
             intent: z.ZodString;
+            role: z.ZodOptional<z.ZodEnum<{
+                intro: "intro";
+                background: "background";
+                limitations: "limitations";
+                conclusion: "conclusion";
+            }>>;
             inside: z.ZodOptional<z.ZodObject<{
                 beat: z.ZodString;
                 element: z.ZodString;
@@ -1632,6 +1856,12 @@ export declare const packSchema: z.ZodObject<{
             }, z.core.$strip>;
             id: z.ZodString;
             intent: z.ZodString;
+            role: z.ZodOptional<z.ZodEnum<{
+                intro: "intro";
+                background: "background";
+                limitations: "limitations";
+                conclusion: "conclusion";
+            }>>;
             inside: z.ZodOptional<z.ZodObject<{
                 beat: z.ZodString;
                 element: z.ZodString;
@@ -1670,6 +1900,12 @@ export declare const packSchema: z.ZodObject<{
             }, z.core.$strip>;
             id: z.ZodString;
             intent: z.ZodString;
+            role: z.ZodOptional<z.ZodEnum<{
+                intro: "intro";
+                background: "background";
+                limitations: "limitations";
+                conclusion: "conclusion";
+            }>>;
             inside: z.ZodOptional<z.ZodObject<{
                 beat: z.ZodString;
                 element: z.ZodString;
@@ -1708,6 +1944,12 @@ export declare const packSchema: z.ZodObject<{
             }, z.core.$strip>;
             id: z.ZodString;
             intent: z.ZodString;
+            role: z.ZodOptional<z.ZodEnum<{
+                intro: "intro";
+                background: "background";
+                limitations: "limitations";
+                conclusion: "conclusion";
+            }>>;
             inside: z.ZodOptional<z.ZodObject<{
                 beat: z.ZodString;
                 element: z.ZodString;
@@ -1742,6 +1984,12 @@ export declare const packSchema: z.ZodObject<{
             }, z.core.$strip>;
             id: z.ZodString;
             intent: z.ZodString;
+            role: z.ZodOptional<z.ZodEnum<{
+                intro: "intro";
+                background: "background";
+                limitations: "limitations";
+                conclusion: "conclusion";
+            }>>;
             inside: z.ZodOptional<z.ZodObject<{
                 beat: z.ZodString;
                 element: z.ZodString;
@@ -1773,6 +2021,12 @@ export declare const packSchema: z.ZodObject<{
             }, z.core.$strip>;
             id: z.ZodString;
             intent: z.ZodString;
+            role: z.ZodOptional<z.ZodEnum<{
+                intro: "intro";
+                background: "background";
+                limitations: "limitations";
+                conclusion: "conclusion";
+            }>>;
             inside: z.ZodOptional<z.ZodObject<{
                 beat: z.ZodString;
                 element: z.ZodString;
@@ -1815,6 +2069,12 @@ export declare const packSchema: z.ZodObject<{
             }, z.core.$strip>;
             id: z.ZodString;
             intent: z.ZodString;
+            role: z.ZodOptional<z.ZodEnum<{
+                intro: "intro";
+                background: "background";
+                limitations: "limitations";
+                conclusion: "conclusion";
+            }>>;
             inside: z.ZodOptional<z.ZodObject<{
                 beat: z.ZodString;
                 element: z.ZodString;
@@ -1859,6 +2119,12 @@ export declare const packSchema: z.ZodObject<{
             }, z.core.$strip>;
             id: z.ZodString;
             intent: z.ZodString;
+            role: z.ZodOptional<z.ZodEnum<{
+                intro: "intro";
+                background: "background";
+                limitations: "limitations";
+                conclusion: "conclusion";
+            }>>;
             inside: z.ZodOptional<z.ZodObject<{
                 beat: z.ZodString;
                 element: z.ZodString;
@@ -1901,6 +2167,12 @@ export declare const packSchema: z.ZodObject<{
             }, z.core.$strip>;
             id: z.ZodString;
             intent: z.ZodString;
+            role: z.ZodOptional<z.ZodEnum<{
+                intro: "intro";
+                background: "background";
+                limitations: "limitations";
+                conclusion: "conclusion";
+            }>>;
             inside: z.ZodOptional<z.ZodObject<{
                 beat: z.ZodString;
                 element: z.ZodString;
@@ -1939,6 +2211,12 @@ export declare const packSchema: z.ZodObject<{
             }, z.core.$strip>;
             id: z.ZodString;
             intent: z.ZodString;
+            role: z.ZodOptional<z.ZodEnum<{
+                intro: "intro";
+                background: "background";
+                limitations: "limitations";
+                conclusion: "conclusion";
+            }>>;
             inside: z.ZodOptional<z.ZodObject<{
                 beat: z.ZodString;
                 element: z.ZodString;
@@ -1971,6 +2249,12 @@ export declare const packSchema: z.ZodObject<{
             }, z.core.$strip>;
             id: z.ZodString;
             intent: z.ZodString;
+            role: z.ZodOptional<z.ZodEnum<{
+                intro: "intro";
+                background: "background";
+                limitations: "limitations";
+                conclusion: "conclusion";
+            }>>;
             inside: z.ZodOptional<z.ZodObject<{
                 beat: z.ZodString;
                 element: z.ZodString;
@@ -2016,6 +2300,12 @@ export declare const packSchema: z.ZodObject<{
             }, z.core.$strip>;
             id: z.ZodString;
             intent: z.ZodString;
+            role: z.ZodOptional<z.ZodEnum<{
+                intro: "intro";
+                background: "background";
+                limitations: "limitations";
+                conclusion: "conclusion";
+            }>>;
             inside: z.ZodOptional<z.ZodObject<{
                 beat: z.ZodString;
                 element: z.ZodString;
@@ -2273,6 +2563,7 @@ export type Illustration = z.infer<typeof illustrationSchema>;
 /** The `images` block of the preferences, resolved. What `illustrate` reads. */
 export type ImagesPrefs = z.infer<typeof prefsSchema>["images"];
 export type Beat = z.infer<typeof beatSchema>;
+export type BeatRole = z.infer<typeof beatRoleSchema>;
 export type Inside = z.infer<typeof insideSchema>;
 export type Archetype = Beat["archetype"];
 export type Storyboard = z.infer<typeof storyboardSchema>;