@jokerized/decksmith 0.9.3 → 0.9.4

package/dist/types/types.d.ts

@@ -26,6 +26,7 @@ export declare const figureSchema: z.ZodObject<{
     kind: z.ZodDefault<z.ZodEnum<{
         image: "image";
         clip: "clip";
+        piece: "piece";
     }>>;
     src: z.ZodString;
     caption: z.ZodString;
@@ -69,6 +70,7 @@ export declare const sourceSchema: z.ZodObject<{
         kind: z.ZodDefault<z.ZodEnum<{
             image: "image";
             clip: "clip";
+            piece: "piece";
         }>>;
         src: z.ZodString;
         caption: z.ZodString;
@@ -129,6 +131,57 @@ export declare const illustrationSchema: z.ZodObject<{
     prompt: z.ZodString;
     caption: z.ZodString;
 }, z.core.$strip>;
+/**
+ * A picture BEHIND a diagram: the frame-filling scene a pipeline, a comparison
+ * or a callout is drawn over, so a deck reads as a sequence of scenes rather
+ * than as cards on one pale ground (the founder's bar, 2026-10-09).
+ *
+ * The same two fields stage takes, for the same reasons: `figureId` first, so
+ * a real figure is looked for before a brief is written; `illustration` when
+ * none fits, which `illustrate` turns into a `gen-<beat>-bd` figure. A backdrop
+ * with a brief and no figure is PENDING exactly as a stage is.
+ *
+ * Optional on every archetype that takes it, and absent means the archetype's
+ * own ground: every storyboard written before this parses and emits the bytes
+ * it did. The emitter draws the panels as dark glass over a scrim when it is
+ * present (`src/emit/backdrop.ts`), so the words' contrast never depends on the
+ * picture.
+ */
+export declare const backdropSchema: z.ZodObject<{
+    figureId: z.ZodOptional<z.ZodString>;
+    illustration: z.ZodOptional<z.ZodObject<{
+        prompt: z.ZodString;
+        caption: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * The archetypes that take a `backdrop`: the diagrams and comparisons, drawn
+ * over a scene, and the two full-bleed ones that are otherwise drawn over a
+ * field of colour (`FIELD_ARCHETYPES`).
+ */
+export declare const BACKDROP_ARCHETYPES: readonly ["pipeline", "split-compare", "callout", "bar-compare", "hero-number", "kinetic"];
+/**
+ * The archetypes that never sit on the pack's pale ground: with no `backdrop`
+ * they are drawn over a deep field of one of the pack's colours instead
+ * (src/emit/backdrop.ts, `overField`).
+ */
+export declare const FIELD_ARCHETYPES: readonly ["hero-number", "kinetic"];
+/**
+ * Archetypes that stand on the field in v2 only. A bar-compare with no backdrop
+ * was the one chart left on the pale ground in round 2 of the 2026-10-09 ko
+ * e2e (b10, a plain bar chart between two panels); classic is v0.8.0 exactly
+ * and keeps drawing it on its ground.
+ */
+export declare const V2_FIELD_ARCHETYPES: readonly ["bar-compare"];
+/**
+ * The id prefix `illustrate` gives every figure it draws (`gen-b03`,
+ * `gen-b04-left`). Such a figure is the DECK's, not the document's: it was
+ * drawn from a brief the planner wrote, so nothing that sizes a deck to what
+ * the document contains may count it (`sourcePoints`).
+ */
+export declare const GENERATED_FIGURE_PREFIX = "gen-";
+/** Whether `illustrate` drew this figure, rather than the document carrying it. */
+export declare function isGeneratedFigure(id: string): boolean;
 export declare const claimFigureParamsSchema: z.ZodObject<{
     eyebrow: z.ZodOptional<z.ZodString>;
     headline: z.ZodString;
@@ -221,6 +274,13 @@ export declare const calloutParamsSchema: z.ZodObject<{
         lines: z.ZodArray<z.ZodString>;
     }, z.core.$strip>>;
     note: z.ZodOptional<z.ZodString>;
+    backdrop: z.ZodOptional<z.ZodObject<{
+        figureId: z.ZodOptional<z.ZodString>;
+        illustration: z.ZodOptional<z.ZodObject<{
+            prompt: z.ZodString;
+            caption: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 /** A labelled stage in a flow. */
 export declare const stageSchema: z.ZodObject<{
@@ -252,6 +312,13 @@ export declare const pipelineParamsSchema: z.ZodObject<{
         label: z.ZodString;
     }, z.core.$strip>>;
     note: z.ZodOptional<z.ZodString>;
+    backdrop: z.ZodOptional<z.ZodObject<{
+        figureId: z.ZodOptional<z.ZodString>;
+        illustration: z.ZodOptional<z.ZodObject<{
+            prompt: z.ZodString;
+            caption: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 export declare const annotatedFigureParamsSchema: z.ZodObject<{
     eyebrow: z.ZodOptional<z.ZodString>;
@@ -310,6 +377,13 @@ export declare const barCompareParamsSchema: z.ZodObject<{
         }>>;
     }, z.core.$strip>>;
     note: z.ZodOptional<z.ZodString>;
+    backdrop: z.ZodOptional<z.ZodObject<{
+        figureId: z.ZodOptional<z.ZodString>;
+        illustration: z.ZodOptional<z.ZodObject<{
+            prompt: z.ZodString;
+            caption: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 export declare const stackParamsSchema: z.ZodObject<{
     eyebrow: z.ZodOptional<z.ZodString>;
@@ -343,6 +417,104 @@ export declare const splitCompareParamsSchema: z.ZodObject<{
         lines: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strip>;
     note: z.ZodOptional<z.ZodString>;
+    backdrop: z.ZodOptional<z.ZodObject<{
+        figureId: z.ZodOptional<z.ZodString>;
+        illustration: z.ZodOptional<z.ZodObject<{
+            prompt: z.ZodString;
+            caption: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * Where a stage beat sets its words over the picture, or `none` for no words.
+ *
+ * A SMALL FIXED SET rather than coordinates: each one is a layout the emitter
+ * has a scrim for, so the contrast under the text is decided once per entry
+ * and never by the planner. An enum, so the model sees exactly these values.
+ */
+export declare const STAGE_PLACEMENTS: readonly ["none", "bottom-left", "center", "top-left", "right"];
+/**
+ * One figure that owns the whole frame — a product UI, a scene, a photo, an
+ * animate piece — edge to edge, with no plate, border or side column.
+ *
+ * `headline` is required even under `placement: "none"`: it is the scene's
+ * label (the composition's title attribute, the deck's notes fallback), and a
+ * beat with nothing to say about its picture has no business being a beat.
+ *
+ * `illustration` is claim-figure's alternative to `figureId`, for the same
+ * reason: without it a source whose only figures are plots — a typical paper —
+ * had no legal way to a full-bleed slide at all, and every slide kept the
+ * headline-over-body layout.
+ */
+export declare const stageParamsSchema: z.ZodObject<{
+    headline: z.ZodString;
+    figureId: z.ZodOptional<z.ZodString>;
+    illustration: z.ZodOptional<z.ZodObject<{
+        prompt: z.ZodString;
+        caption: z.ZodString;
+    }, z.core.$strip>>;
+    placement: z.ZodEnum<{
+        right: "right";
+        none: "none";
+        "bottom-left": "bottom-left";
+        center: "center";
+        "top-left": "top-left";
+    }>;
+    line: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * ONE NUMBER THAT OWNS THE FRAME — the result an explainer video stops on.
+ *
+ * `value` is the figure as the source prints it ("43.63", "1/4", "75.1%"); its
+ * digits are drawn as odometer reels that roll into place, every other
+ * character standing still. `compare` is the number it is read against — the
+ * baseline, the before — drawn as a second figure, and as a pair of bars when
+ * both parse as plain numbers in one unit (`unit`). `label` names what `value`
+ * measures; `headline` is the sentence the number says, set under it.
+ *
+ * Full-bleed like `stage`: over a `backdrop` picture when it has one, else over
+ * a deep field of one of the pack's colours (src/emit/backdrop.ts), never on the pale
+ * ground a deck of cards sits on.
+ */
+export declare const heroNumberParamsSchema: z.ZodObject<{
+    eyebrow: z.ZodOptional<z.ZodString>;
+    headline: z.ZodString;
+    value: z.ZodString;
+    unit: z.ZodOptional<z.ZodString>;
+    label: z.ZodString;
+    compare: z.ZodOptional<z.ZodObject<{
+        value: z.ZodString;
+        label: z.ZodString;
+    }, z.core.$strip>>;
+    backdrop: z.ZodOptional<z.ZodObject<{
+        figureId: z.ZodOptional<z.ZodString>;
+        illustration: z.ZodOptional<z.ZodObject<{
+            prompt: z.ZodString;
+            caption: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * A CLAIM SET AS MOVING TYPE. Two to four phrases, each arriving with its own
+ * move and stopped on, with one `key` word in it struck through by a highlight.
+ *
+ * `headline` labels the slide — the composition's title, the notes fallback —
+ * and is not drawn, as under a stage's `placement: "none"`: the phrases are
+ * what the audience reads. `key` must appear verbatim in its phrase.
+ */
+export declare const kineticParamsSchema: z.ZodObject<{
+    headline: z.ZodString;
+    phrases: z.ZodArray<z.ZodObject<{
+        text: z.ZodString;
+        key: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    backdrop: z.ZodOptional<z.ZodObject<{
+        figureId: z.ZodOptional<z.ZodString>;
+        illustration: z.ZodOptional<z.ZodObject<{
+            prompt: z.ZodString;
+            caption: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 /**
  * "This beat happens inside that part of the beat before it."
@@ -666,6 +838,13 @@ export declare const beatSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             lines: z.ZodArray<z.ZodString>;
         }, z.core.$strip>>;
         note: z.ZodOptional<z.ZodString>;
+        backdrop: z.ZodOptional<z.ZodObject<{
+            figureId: z.ZodOptional<z.ZodString>;
+            illustration: z.ZodOptional<z.ZodObject<{
+                prompt: z.ZodString;
+                caption: z.ZodString;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
     }, z.core.$strip>;
     id: z.ZodString;
     intent: z.ZodString;
@@ -715,6 +894,13 @@ export declare const beatSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             label: z.ZodString;
         }, z.core.$strip>>;
         note: z.ZodOptional<z.ZodString>;
+        backdrop: z.ZodOptional<z.ZodObject<{
+            figureId: z.ZodOptional<z.ZodString>;
+            illustration: z.ZodOptional<z.ZodObject<{
+                prompt: z.ZodString;
+                caption: z.ZodString;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
     }, z.core.$strip>;
     id: z.ZodString;
     intent: z.ZodString;
@@ -860,6 +1046,13 @@ export declare const beatSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             }>>;
         }, z.core.$strip>>;
         note: z.ZodOptional<z.ZodString>;
+        backdrop: z.ZodOptional<z.ZodObject<{
+            figureId: z.ZodOptional<z.ZodString>;
+            illustration: z.ZodOptional<z.ZodObject<{
+                prompt: z.ZodString;
+                caption: z.ZodString;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
     }, z.core.$strip>;
     id: z.ZodString;
     intent: z.ZodString;
@@ -951,6 +1144,148 @@ export declare const beatSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             lines: z.ZodOptional<z.ZodArray<z.ZodString>>;
         }, z.core.$strip>;
         note: z.ZodOptional<z.ZodString>;
+        backdrop: z.ZodOptional<z.ZodObject<{
+            figureId: z.ZodOptional<z.ZodString>;
+            illustration: z.ZodOptional<z.ZodObject<{
+                prompt: z.ZodString;
+                caption: z.ZodString;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+    }, 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;
+        label: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    claim: z.ZodOptional<z.ZodString>;
+    evidence: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        kind: z.ZodEnum<{
+            figure: "figure";
+            equation: "equation";
+            table: "table";
+            section: "section";
+        }>;
+        id: z.ZodString;
+    }, z.core.$strip>>>;
+    weight: z.ZodDefault<z.ZodNumber>;
+    seconds: z.ZodDefault<z.ZodNumber>;
+    bespoke: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>, z.ZodObject<{
+    narration: z.ZodOptional<z.ZodString>;
+    archetype: z.ZodLiteral<"stage">;
+    params: z.ZodObject<{
+        headline: z.ZodString;
+        figureId: z.ZodOptional<z.ZodString>;
+        illustration: z.ZodOptional<z.ZodObject<{
+            prompt: z.ZodString;
+            caption: z.ZodString;
+        }, z.core.$strip>>;
+        placement: z.ZodEnum<{
+            right: "right";
+            none: "none";
+            "bottom-left": "bottom-left";
+            center: "center";
+            "top-left": "top-left";
+        }>;
+        line: z.ZodOptional<z.ZodString>;
+    }, 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;
+        label: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    claim: z.ZodOptional<z.ZodString>;
+    evidence: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        kind: z.ZodEnum<{
+            figure: "figure";
+            equation: "equation";
+            table: "table";
+            section: "section";
+        }>;
+        id: z.ZodString;
+    }, z.core.$strip>>>;
+    weight: z.ZodDefault<z.ZodNumber>;
+    seconds: z.ZodDefault<z.ZodNumber>;
+    bespoke: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>, z.ZodObject<{
+    narration: z.ZodOptional<z.ZodString>;
+    archetype: z.ZodLiteral<"hero-number">;
+    params: z.ZodObject<{
+        eyebrow: z.ZodOptional<z.ZodString>;
+        headline: z.ZodString;
+        value: z.ZodString;
+        unit: z.ZodOptional<z.ZodString>;
+        label: z.ZodString;
+        compare: z.ZodOptional<z.ZodObject<{
+            value: z.ZodString;
+            label: z.ZodString;
+        }, z.core.$strip>>;
+        backdrop: z.ZodOptional<z.ZodObject<{
+            figureId: z.ZodOptional<z.ZodString>;
+            illustration: z.ZodOptional<z.ZodObject<{
+                prompt: z.ZodString;
+                caption: z.ZodString;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+    }, 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;
+        label: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    claim: z.ZodOptional<z.ZodString>;
+    evidence: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        kind: z.ZodEnum<{
+            figure: "figure";
+            equation: "equation";
+            table: "table";
+            section: "section";
+        }>;
+        id: z.ZodString;
+    }, z.core.$strip>>>;
+    weight: z.ZodDefault<z.ZodNumber>;
+    seconds: z.ZodDefault<z.ZodNumber>;
+    bespoke: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>, z.ZodObject<{
+    narration: z.ZodOptional<z.ZodString>;
+    archetype: z.ZodLiteral<"kinetic">;
+    params: z.ZodObject<{
+        headline: z.ZodString;
+        phrases: z.ZodArray<z.ZodObject<{
+            text: z.ZodString;
+            key: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        backdrop: z.ZodOptional<z.ZodObject<{
+            figureId: z.ZodOptional<z.ZodString>;
+            illustration: z.ZodOptional<z.ZodObject<{
+                prompt: z.ZodString;
+                caption: z.ZodString;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
     }, z.core.$strip>;
     id: z.ZodString;
     intent: z.ZodString;
@@ -1309,6 +1644,13 @@ export declare const storyboardSchema: z.ZodObject<{
                 lines: z.ZodArray<z.ZodString>;
             }, z.core.$strip>>;
             note: z.ZodOptional<z.ZodString>;
+            backdrop: z.ZodOptional<z.ZodObject<{
+                figureId: z.ZodOptional<z.ZodString>;
+                illustration: z.ZodOptional<z.ZodObject<{
+                    prompt: z.ZodString;
+                    caption: z.ZodString;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>;
         }, z.core.$strip>;
         id: z.ZodString;
         intent: z.ZodString;
@@ -1358,6 +1700,13 @@ export declare const storyboardSchema: z.ZodObject<{
                 label: z.ZodString;
             }, z.core.$strip>>;
             note: z.ZodOptional<z.ZodString>;
+            backdrop: z.ZodOptional<z.ZodObject<{
+                figureId: z.ZodOptional<z.ZodString>;
+                illustration: z.ZodOptional<z.ZodObject<{
+                    prompt: z.ZodString;
+                    caption: z.ZodString;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>;
         }, z.core.$strip>;
         id: z.ZodString;
         intent: z.ZodString;
@@ -1503,6 +1852,13 @@ export declare const storyboardSchema: z.ZodObject<{
                 }>>;
             }, z.core.$strip>>;
             note: z.ZodOptional<z.ZodString>;
+            backdrop: z.ZodOptional<z.ZodObject<{
+                figureId: z.ZodOptional<z.ZodString>;
+                illustration: z.ZodOptional<z.ZodObject<{
+                    prompt: z.ZodString;
+                    caption: z.ZodString;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>;
         }, z.core.$strip>;
         id: z.ZodString;
         intent: z.ZodString;
@@ -1594,6 +1950,13 @@ export declare const storyboardSchema: z.ZodObject<{
                 lines: z.ZodOptional<z.ZodArray<z.ZodString>>;
             }, z.core.$strip>;
             note: z.ZodOptional<z.ZodString>;
+            backdrop: z.ZodOptional<z.ZodObject<{
+                figureId: z.ZodOptional<z.ZodString>;
+                illustration: z.ZodOptional<z.ZodObject<{
+                    prompt: z.ZodString;
+                    caption: z.ZodString;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>;
         }, z.core.$strip>;
         id: z.ZodString;
         intent: z.ZodString;
@@ -1621,7 +1984,142 @@ export declare const storyboardSchema: z.ZodObject<{
         weight: z.ZodDefault<z.ZodNumber>;
         seconds: z.ZodDefault<z.ZodNumber>;
         bespoke: z.ZodOptional<z.ZodBoolean>;
-    }, z.core.$strip>], "archetype">>;
+    }, z.core.$strip>, z.ZodObject<{
+        narration: z.ZodOptional<z.ZodString>;
+        archetype: z.ZodLiteral<"stage">;
+        params: z.ZodObject<{
+            headline: z.ZodString;
+            figureId: z.ZodOptional<z.ZodString>;
+            illustration: z.ZodOptional<z.ZodObject<{
+                prompt: z.ZodString;
+                caption: z.ZodString;
+            }, z.core.$strip>>;
+            placement: z.ZodEnum<{
+                right: "right";
+                none: "none";
+                "bottom-left": "bottom-left";
+                center: "center";
+                "top-left": "top-left";
+            }>;
+            line: z.ZodOptional<z.ZodString>;
+        }, 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;
+            label: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        claim: z.ZodOptional<z.ZodString>;
+        evidence: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            kind: z.ZodEnum<{
+                figure: "figure";
+                equation: "equation";
+                table: "table";
+                section: "section";
+            }>;
+            id: z.ZodString;
+        }, z.core.$strip>>>;
+        weight: z.ZodDefault<z.ZodNumber>;
+        seconds: z.ZodDefault<z.ZodNumber>;
+        bespoke: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>, z.ZodObject<{
+        narration: z.ZodOptional<z.ZodString>;
+        archetype: z.ZodLiteral<"hero-number">;
+        params: z.ZodObject<{
+            eyebrow: z.ZodOptional<z.ZodString>;
+            headline: z.ZodString;
+            value: z.ZodString;
+            unit: z.ZodOptional<z.ZodString>;
+            label: z.ZodString;
+            compare: z.ZodOptional<z.ZodObject<{
+                value: z.ZodString;
+                label: z.ZodString;
+            }, z.core.$strip>>;
+            backdrop: z.ZodOptional<z.ZodObject<{
+                figureId: z.ZodOptional<z.ZodString>;
+                illustration: z.ZodOptional<z.ZodObject<{
+                    prompt: z.ZodString;
+                    caption: z.ZodString;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>;
+        }, 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;
+            label: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        claim: z.ZodOptional<z.ZodString>;
+        evidence: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            kind: z.ZodEnum<{
+                figure: "figure";
+                equation: "equation";
+                table: "table";
+                section: "section";
+            }>;
+            id: z.ZodString;
+        }, z.core.$strip>>>;
+        weight: z.ZodDefault<z.ZodNumber>;
+        seconds: z.ZodDefault<z.ZodNumber>;
+        bespoke: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>, z.ZodObject<{
+        narration: z.ZodOptional<z.ZodString>;
+        archetype: z.ZodLiteral<"kinetic">;
+        params: z.ZodObject<{
+            headline: z.ZodString;
+            phrases: z.ZodArray<z.ZodObject<{
+                text: z.ZodString;
+                key: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            backdrop: z.ZodOptional<z.ZodObject<{
+                figureId: z.ZodOptional<z.ZodString>;
+                illustration: z.ZodOptional<z.ZodObject<{
+                    prompt: z.ZodString;
+                    caption: z.ZodString;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>;
+        }, 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;
+            label: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        claim: z.ZodOptional<z.ZodString>;
+        evidence: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            kind: z.ZodEnum<{
+                figure: "figure";
+                equation: "equation";
+                table: "table";
+                section: "section";
+            }>;
+            id: z.ZodString;
+        }, z.core.$strip>>>;
+        weight: z.ZodDefault<z.ZodNumber>;
+        seconds: z.ZodDefault<z.ZodNumber>;
+        bespoke: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>], "archetype">>;
 }, z.core.$strip>;
 /**
  * What the person asking for the deck gets to decide.
@@ -1680,9 +2178,10 @@ export declare const prefsSchema: z.ZodObject<{
         max: z.ZodDefault<z.ZodInt>;
     }, z.core.$strip>>;
     bespoke: z.ZodOptional<z.ZodObject<{
-        enabled: z.ZodDefault<z.ZodBoolean>;
+        enabled: z.ZodOptional<z.ZodBoolean>;
         maxCalls: z.ZodDefault<z.ZodInt>;
         maxSeconds: z.ZodDefault<z.ZodInt>;
+        callSeconds: z.ZodDefault<z.ZodInt>;
         model: z.ZodOptional<z.ZodString>;
         cli: z.ZodOptional<z.ZodString>;
         cache: z.ZodOptional<z.ZodString>;
@@ -1840,9 +2339,10 @@ export declare const packSchema: z.ZodObject<{
             max: z.ZodDefault<z.ZodInt>;
         }, z.core.$strip>>;
         bespoke: z.ZodOptional<z.ZodObject<{
-            enabled: z.ZodDefault<z.ZodBoolean>;
+            enabled: z.ZodOptional<z.ZodBoolean>;
             maxCalls: z.ZodDefault<z.ZodInt>;
             maxSeconds: z.ZodDefault<z.ZodInt>;
+            callSeconds: z.ZodDefault<z.ZodInt>;
             model: z.ZodOptional<z.ZodString>;
             cli: z.ZodOptional<z.ZodString>;
             cache: z.ZodOptional<z.ZodString>;
@@ -1871,6 +2371,7 @@ export declare const packSchema: z.ZodObject<{
             kind: z.ZodDefault<z.ZodEnum<{
                 image: "image";
                 clip: "clip";
+                piece: "piece";
             }>>;
             src: z.ZodString;
             caption: z.ZodString;
@@ -2169,6 +2670,13 @@ export declare const packSchema: z.ZodObject<{
                     lines: z.ZodArray<z.ZodString>;
                 }, z.core.$strip>>;
                 note: z.ZodOptional<z.ZodString>;
+                backdrop: z.ZodOptional<z.ZodObject<{
+                    figureId: z.ZodOptional<z.ZodString>;
+                    illustration: z.ZodOptional<z.ZodObject<{
+                        prompt: z.ZodString;
+                        caption: z.ZodString;
+                    }, z.core.$strip>>;
+                }, z.core.$strip>>;
             }, z.core.$strip>;
             id: z.ZodString;
             intent: z.ZodString;
@@ -2218,6 +2726,13 @@ export declare const packSchema: z.ZodObject<{
                     label: z.ZodString;
                 }, z.core.$strip>>;
                 note: z.ZodOptional<z.ZodString>;
+                backdrop: z.ZodOptional<z.ZodObject<{
+                    figureId: z.ZodOptional<z.ZodString>;
+                    illustration: z.ZodOptional<z.ZodObject<{
+                        prompt: z.ZodString;
+                        caption: z.ZodString;
+                    }, z.core.$strip>>;
+                }, z.core.$strip>>;
             }, z.core.$strip>;
             id: z.ZodString;
             intent: z.ZodString;
@@ -2363,6 +2878,13 @@ export declare const packSchema: z.ZodObject<{
                     }>>;
                 }, z.core.$strip>>;
                 note: z.ZodOptional<z.ZodString>;
+                backdrop: z.ZodOptional<z.ZodObject<{
+                    figureId: z.ZodOptional<z.ZodString>;
+                    illustration: z.ZodOptional<z.ZodObject<{
+                        prompt: z.ZodString;
+                        caption: z.ZodString;
+                    }, z.core.$strip>>;
+                }, z.core.$strip>>;
             }, z.core.$strip>;
             id: z.ZodString;
             intent: z.ZodString;
@@ -2454,6 +2976,148 @@ export declare const packSchema: z.ZodObject<{
                     lines: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 }, z.core.$strip>;
                 note: z.ZodOptional<z.ZodString>;
+                backdrop: z.ZodOptional<z.ZodObject<{
+                    figureId: z.ZodOptional<z.ZodString>;
+                    illustration: z.ZodOptional<z.ZodObject<{
+                        prompt: z.ZodString;
+                        caption: z.ZodString;
+                    }, z.core.$strip>>;
+                }, z.core.$strip>>;
+            }, 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;
+                label: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            claim: z.ZodOptional<z.ZodString>;
+            evidence: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                kind: z.ZodEnum<{
+                    figure: "figure";
+                    equation: "equation";
+                    table: "table";
+                    section: "section";
+                }>;
+                id: z.ZodString;
+            }, z.core.$strip>>>;
+            weight: z.ZodDefault<z.ZodNumber>;
+            seconds: z.ZodDefault<z.ZodNumber>;
+            bespoke: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>, z.ZodObject<{
+            narration: z.ZodOptional<z.ZodString>;
+            archetype: z.ZodLiteral<"stage">;
+            params: z.ZodObject<{
+                headline: z.ZodString;
+                figureId: z.ZodOptional<z.ZodString>;
+                illustration: z.ZodOptional<z.ZodObject<{
+                    prompt: z.ZodString;
+                    caption: z.ZodString;
+                }, z.core.$strip>>;
+                placement: z.ZodEnum<{
+                    right: "right";
+                    none: "none";
+                    "bottom-left": "bottom-left";
+                    center: "center";
+                    "top-left": "top-left";
+                }>;
+                line: z.ZodOptional<z.ZodString>;
+            }, 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;
+                label: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            claim: z.ZodOptional<z.ZodString>;
+            evidence: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                kind: z.ZodEnum<{
+                    figure: "figure";
+                    equation: "equation";
+                    table: "table";
+                    section: "section";
+                }>;
+                id: z.ZodString;
+            }, z.core.$strip>>>;
+            weight: z.ZodDefault<z.ZodNumber>;
+            seconds: z.ZodDefault<z.ZodNumber>;
+            bespoke: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>, z.ZodObject<{
+            narration: z.ZodOptional<z.ZodString>;
+            archetype: z.ZodLiteral<"hero-number">;
+            params: z.ZodObject<{
+                eyebrow: z.ZodOptional<z.ZodString>;
+                headline: z.ZodString;
+                value: z.ZodString;
+                unit: z.ZodOptional<z.ZodString>;
+                label: z.ZodString;
+                compare: z.ZodOptional<z.ZodObject<{
+                    value: z.ZodString;
+                    label: z.ZodString;
+                }, z.core.$strip>>;
+                backdrop: z.ZodOptional<z.ZodObject<{
+                    figureId: z.ZodOptional<z.ZodString>;
+                    illustration: z.ZodOptional<z.ZodObject<{
+                        prompt: z.ZodString;
+                        caption: z.ZodString;
+                    }, z.core.$strip>>;
+                }, z.core.$strip>>;
+            }, 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;
+                label: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            claim: z.ZodOptional<z.ZodString>;
+            evidence: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                kind: z.ZodEnum<{
+                    figure: "figure";
+                    equation: "equation";
+                    table: "table";
+                    section: "section";
+                }>;
+                id: z.ZodString;
+            }, z.core.$strip>>>;
+            weight: z.ZodDefault<z.ZodNumber>;
+            seconds: z.ZodDefault<z.ZodNumber>;
+            bespoke: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>, z.ZodObject<{
+            narration: z.ZodOptional<z.ZodString>;
+            archetype: z.ZodLiteral<"kinetic">;
+            params: z.ZodObject<{
+                headline: z.ZodString;
+                phrases: z.ZodArray<z.ZodObject<{
+                    text: z.ZodString;
+                    key: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+                backdrop: z.ZodOptional<z.ZodObject<{
+                    figureId: z.ZodOptional<z.ZodString>;
+                    illustration: z.ZodOptional<z.ZodObject<{
+                        prompt: z.ZodString;
+                        caption: z.ZodString;
+                    }, z.core.$strip>>;
+                }, z.core.$strip>>;
             }, z.core.$strip>;
             id: z.ZodString;
             intent: z.ZodString;
@@ -2623,7 +3287,18 @@ export declare const CAPTION_LINE_RATIO = 1.6;
  * reserving for the worst case that can actually occur.
  */
 export declare const CAPTION_MAX_LINES = 2;
-/** The burned band's font size at this canvas width. */
+/**
+ * The burned caption's size, reference px: `TYPE_SCALE.caption` in
+ * src/emit/type.ts, restated here because this file may import nothing from
+ * `src/emit`. A quiet lower third, the founder's ask on 2026-10-10: 4% of a
+ * 1920 canvas was a 71px caption, larger than the slide's own headline.
+ */
+export declare const CAPTION_FONT_PX = 40;
+/**
+ * The burned band's font size at this canvas width: `CAPTION_FONT_RATIO` of it,
+ * never more than `CAPTION_FONT_PX` — which is what every format's ratio
+ * already gave at its 1080px side, and now also holds at 1920.
+ */
 export declare function captionFontSize(width: number): number;
 /**
  * The bottom strip the burned caption may occupy, `marginV` included, in CANVAS
@@ -2813,6 +3488,7 @@ export type Section = z.infer<typeof sectionSchema>;
 export type Source = z.infer<typeof sourceSchema>;
 export type Term = z.infer<typeof termSchema>;
 export type Illustration = z.infer<typeof illustrationSchema>;
+export type Backdrop = z.infer<typeof backdropSchema>;
 /** 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>;