@jokerized/decksmith 0.3.0 → 0.3.1

package/dist/types/types.d.ts

@@ -352,6 +352,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 +389,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 +427,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 +470,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 +514,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 +558,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 +598,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 +635,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 +683,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 +733,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 +781,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 +825,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 +863,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 +914,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 +988,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 +1026,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 +1069,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 +1113,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 +1157,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 +1197,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 +1234,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 +1282,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 +1332,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 +1380,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 +1424,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 +1462,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 +1513,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 +1559,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 +1677,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>;
@@ -1563,6 +1754,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 +1792,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 +1835,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 +1879,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 +1923,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 +1963,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 +2000,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 +2048,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 +2098,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 +2146,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 +2190,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 +2228,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 +2279,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 +2542,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>;

package/dist/types/verify/index.d.ts

@@ -242,6 +242,70 @@ export declare function scanUnusedFigures(storyboard: Storyboard, source: Source
  * decision cannot be made by accident.
  */
 export declare function scanBeatCount(storyboard: Storyboard, prefs: Prefs): Finding[];
+/**
+ * Where a paper-shaped deck missed the shape it was asked for.
+ *
+ * SILENT UNLESS THE ARC WAS DECLARED. `prefs.genre` defaults to `general`, so
+ * every deck built before this existed, and every deck whose author did not say
+ * `--genre paper`, gets exactly nothing from this scan. That is not timidity: a
+ * ten-role heading lexicon over all 351 markdown files in this repository found
+ * 345 with zero hits, so there is no honest way to infer the genre, and a scan
+ * that guessed would mislabel the Korean fixture and every hypepaper analysis
+ * the tool actually ingests.
+ *
+ * REPORTED, NEVER REPAIRED, and a WARNING. It joins the four scans that already
+ * take that shape, and `scanBeatCount`'s header settles the class: `build`
+ * prints every content loss and fails on none of them, because the alternative
+ * is re-asking, and the only possible second instruction — "return more" — is a
+ * padding request with extra steps. Promoting this one is a decision about all
+ * of them.
+ *
+ * WHAT IT CANNOT DO. It cannot tell whether a beat labelled `limitations` really
+ * discusses one; `role` is the plan's own declaration, and a declaration can be
+ * false. What it checks instead is the part that is mechanical and that no
+ * committed plan has ever got right on its own: that the roles exist, that they
+ * are unique, that the ending is in the right ORDER, and that the closing pair
+ * does not collapse into two of the same picture. A rule about wording would be
+ * met cosmetically, exactly as `scanHeadlines` records a sharpened rule being
+ * answered by swapping one verb.
+ */
+export declare function scanPaperArc(storyboard: Storyboard, prefs: Prefs): Finding[];
+/**
+ * Narration that belongs to a different version of this storyboard.
+ *
+ * `narration.json` is keyed by BEAT ID and carries nothing that ties it to the
+ * plan it was made for, so an id that still exists is an id `build` will happily
+ * speak — even when the beat behind it has been replaced. Renumbering is the way
+ * in: inserting one beat and shifting the ids after it leaves every later id
+ * pointing at its neighbour's voice.
+ *
+ * FOUND IN THE SHIPPED DEMO, and it is the seventh green-gate case this project
+ * has recorded. A thirteenth beat was inserted at position six and the rest
+ * renumbered; the audio on disk predated it, so beats six through twelve each
+ * spoke the slide after them and the thirteenth spoke nothing. `build` reported
+ * `PASS — 0 error(s), 0 warning(s)`, because every id it looked for was present
+ * and nothing compared what was SAID against what the beat says it says.
+ *
+ * AN ERROR, NOT A WARNING, and it is the one member of this family that earns
+ * it. The other storyboard scans are editorial judgements only an author can
+ * settle; this is a string comparison between two authored fields that must
+ * agree, and the artifact it lets through is a video whose voice describes the
+ * wrong pictures. Missing narration audio is already an error here, and audio
+ * that is present and wrong is not the better failure.
+ *
+ * NARROW ON PURPOSE. It compares only beats that have BOTH a narration text and
+ * segments, so a deck narrated at a lower density — where some beats are
+ * deliberately silent — says nothing, and the existing missing-audio error keeps
+ * its own case. Whitespace is normalised because the splitter re-joins sentences
+ * at stop boundaries; on the demo's thirteen beats the concatenation reproduces
+ * the authored text exactly, which is what makes the comparison safe to make
+ * fatal.
+ */
+export declare function scanNarrationDrift(storyboard: Storyboard, narration: {
+    beats: Record<string, {
+        text: string;
+    }[]>;
+}): Finding[];
 /**
  * How far a name may precede the thing it names before a viewer notices.
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jokerized/decksmith",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Turn a source document into an animated explanation deck.",
   "type": "module",
   "license": "MIT",