paperlab 0.3.1 → 0.5.0

package/dist/stage.d.cts

@@ -1,163 +1,7 @@
 import * as react from 'react';
-import { F as FieldPaperSlot, a as PaperConfigInput } from './slots-DUMR64HB.cjs';
+import { F as FieldPaperSlot, a as PaperConfigInput } from './slots-CIo7FnlY.cjs';
 import { z } from 'zod';
 
-/**
- * The room the walk is in.
- *
- * Stage mode was a void with a horizon: a graded dome, a flat plane, and a
- * bright rectangle at the end, none of it a knowable size. That is why the
- * walking figure was carrying the whole scale burden by itself — and why
- * simply removing the figure would have left an abstraction rather than a
- * hall. Architecture is the better answer: objects whose size the viewer
- * already knows, made of flat surfaces under good light, which is the one
- * thing a renderer never gets wrong.
- */
-/**
- * What holds the paper up.
- *
- * Every paper installation shows its hardware — monofilament from a ceiling
- * grid, steel wire, bulldog clips, a rod — and in the scattered-sheet pieces
- * the threads are half the composition. Stage mode's banners hung from
- * nothing at all, which is a bigger realism gap than any shader in the
- * backlog and closes for a few thin lines of geometry.
- */
-declare const stageSuspensionSchema: z.ZodObject<{
-    /**
-     * What carries the load.
-     *
-     * `thread` is monofilament to the ceiling — one straight line per sheet.
-     * `rod` is a dowel across each sheet's top edge, hung from the ceiling at
-     * both ends, which is a different image entirely: a rank on threads reads
-     * as sheets floating in a row, and a rank on rods reads as sheets that
-     * were HUNG, by someone, on something. `none` is for a stage where the
-     * paper is meant to be impossible.
-     */
-    type: z.ZodDefault<z.ZodEnum<["none", "thread", "rod"]>>;
-    color: z.ZodDefault<z.ZodString>;
-    /**
-     * What grips the sheet.
-     *
-     * A clip is wide and shallow — the bulldog clip of a gallery. A peg is
-     * narrow and deep, and grips DOWN the face of the sheet rather than
-     * across its edge: the domestic one, a line of paper on a washing line.
-     * They are told apart by silhouette at any distance, which is the only
-     * thing that survives being one instanced box at the top of an
-     * eight-metre banner.
-     *
-     * This replaced a `clips: boolean`. Two of the four pieces of hardware the
-     * plan named — pegs, and a rod — had no way to be asked for, and a boolean
-     * cannot grow a third answer.
-     */
-    hardware: z.ZodDefault<z.ZodEnum<["none", "clip", "peg"]>>;
-}, "strip", z.ZodTypeAny, {
-    type: "none" | "thread" | "rod";
-    color: string;
-    hardware: "none" | "clip" | "peg";
-}, {
-    type?: "none" | "thread" | "rod" | undefined;
-    color?: string | undefined;
-    hardware?: "none" | "clip" | "peg" | undefined;
-}>;
-declare const stageRoomSchema: z.ZodObject<{
-    enabled: z.ZodDefault<z.ZodBoolean>;
-    /**
-     * Ceiling height, as a multiple of the paper's own height.
-     *
-     * Relative rather than absolute because the banners ARE the architecture
-     * here: a hall whose ceiling sits just above its hangings reads as built
-     * for them, and one at a fixed world height reads as whatever the paper
-     * happened to be scaled to that day.
-     */
-    height: z.ZodDefault<z.ZodNumber>;
-    color: z.ZodDefault<z.ZodString>;
-    /** Columns flanking the walk — see `stageColumnsSchema`. */
-    columns: z.ZodDefault<z.ZodObject<{
-        enabled: z.ZodDefault<z.ZodBoolean>;
-        /** Centres this far apart along the walk. Roughly a bay. */
-        spacing: z.ZodDefault<z.ZodNumber>;
-        /** Shaft width. The number doing the work — a column is a known size. */
-        width: z.ZodDefault<z.ZodNumber>;
-        /**
-         * How far off the walk's centreline each rank stands.
-         *
-         * Outside the banners, always. Columns are the room; the paper is the
-         * subject, and a column standing between the viewer and a banner has
-         * swapped the two over. Default clears a `colonnade`'s widest sensible
-         * aisle with room to spare.
-         */
-        offset: z.ZodDefault<z.ZodNumber>;
-        /**
-         * Stone, and darker than paper on purpose.
-         *
-         * The brightest thing in any of these frames has to be the light, and the
-         * second brightest has to be the paper. A column the same value as a
-         * banner does not read as architecture behind the subject; it reads as
-         * more banners, and the eye stops being able to tell what the room is made
-         * of from what is hanging in it.
-         */
-        color: z.ZodDefault<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        width: number;
-        offset: number;
-        color: string;
-        spacing: number;
-        enabled: boolean;
-    }, {
-        width?: number | undefined;
-        offset?: number | undefined;
-        color?: string | undefined;
-        spacing?: number | undefined;
-        enabled?: boolean | undefined;
-    }>>;
-    /** A wall at the end of the walk with the source in it. */
-    doorway: z.ZodDefault<z.ZodObject<{
-        enabled: z.ZodDefault<z.ZodBoolean>;
-        /** Opening size, as a multiple of the source's own. 1 frames it exactly. */
-        opening: z.ZodDefault<z.ZodNumber>;
-        color: z.ZodDefault<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        color: string;
-        enabled: boolean;
-        opening: number;
-    }, {
-        color?: string | undefined;
-        enabled?: boolean | undefined;
-        opening?: number | undefined;
-    }>>;
-}, "strip", z.ZodTypeAny, {
-    height: number;
-    color: string;
-    enabled: boolean;
-    columns: {
-        width: number;
-        offset: number;
-        color: string;
-        spacing: number;
-        enabled: boolean;
-    };
-    doorway: {
-        color: string;
-        enabled: boolean;
-        opening: number;
-    };
-}, {
-    height?: number | undefined;
-    color?: string | undefined;
-    enabled?: boolean | undefined;
-    columns?: {
-        width?: number | undefined;
-        offset?: number | undefined;
-        color?: string | undefined;
-        spacing?: number | undefined;
-        enabled?: boolean | undefined;
-    } | undefined;
-    doorway?: {
-        color?: string | undefined;
-        enabled?: boolean | undefined;
-        opening?: number | undefined;
-    } | undefined;
-}>;
 /**
  * The print: what happens to the frame after the scene is drawn.
  *
@@ -374,15 +218,15 @@ declare const stageSchema: z.ZodObject<{
         spread: z.ZodDefault<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
         color: string;
-        enabled: boolean;
         spread: number;
+        enabled: boolean;
         zenith: string;
         beyond: number;
         surround: boolean;
     }, {
         color?: string | undefined;
-        enabled?: boolean | undefined;
         spread?: number | undefined;
+        enabled?: boolean | undefined;
         zenith?: string | undefined;
         beyond?: number | undefined;
         surround?: boolean | undefined;
@@ -634,6 +478,17 @@ declare const stageSchema: z.ZodObject<{
         closed: boolean;
     };
     lighting: "studio" | "window" | "leaves" | "goldenhour" | "noir" | "nave" | "raking" | "lightbox";
+    light: {
+        key?: number | undefined;
+        height?: number | undefined;
+        color?: string | undefined;
+        studio?: number | undefined;
+        exposure?: number | undefined;
+        film?: "agx" | "neutral" | "filmic" | undefined;
+        direction?: number | undefined;
+        ambient?: number | undefined;
+        haze?: number | undefined;
+    };
     figure: {
         height: number;
         speed: number;
@@ -646,23 +501,12 @@ declare const stageSchema: z.ZodObject<{
     };
     source: {
         color: string;
-        enabled: boolean;
         spread: number;
+        enabled: boolean;
         zenith: string;
         beyond: number;
         surround: boolean;
     };
-    light: {
-        key?: number | undefined;
-        height?: number | undefined;
-        color?: string | undefined;
-        studio?: number | undefined;
-        exposure?: number | undefined;
-        film?: "agx" | "neutral" | "filmic" | undefined;
-        direction?: number | undefined;
-        ambient?: number | undefined;
-        haze?: number | undefined;
-    };
     shot: {
         height: number;
         offset: number;
@@ -711,6 +555,17 @@ declare const stageSchema: z.ZodObject<{
         closed?: boolean | undefined;
     } | undefined;
     lighting?: "studio" | "window" | "leaves" | "goldenhour" | "noir" | "nave" | "raking" | "lightbox" | undefined;
+    light?: {
+        key?: number | undefined;
+        height?: number | undefined;
+        color?: string | undefined;
+        studio?: number | undefined;
+        exposure?: number | undefined;
+        film?: "agx" | "neutral" | "filmic" | undefined;
+        direction?: number | undefined;
+        ambient?: number | undefined;
+        haze?: number | undefined;
+    } | undefined;
     figure?: {
         height?: number | undefined;
         speed?: number | undefined;
@@ -723,23 +578,12 @@ declare const stageSchema: z.ZodObject<{
     } | undefined;
     source?: {
         color?: string | undefined;
-        enabled?: boolean | undefined;
         spread?: number | undefined;
+        enabled?: boolean | undefined;
         zenith?: string | undefined;
         beyond?: number | undefined;
         surround?: boolean | undefined;
     } | undefined;
-    light?: {
-        key?: number | undefined;
-        height?: number | undefined;
-        color?: string | undefined;
-        studio?: number | undefined;
-        exposure?: number | undefined;
-        film?: "agx" | "neutral" | "filmic" | undefined;
-        direction?: number | undefined;
-        ambient?: number | undefined;
-        haze?: number | undefined;
-    } | undefined;
     shot?: {
         height?: number | undefined;
         offset?: number | undefined;
@@ -895,6 +739,28 @@ declare const qualityNames: readonly ["auto", "low", "medium", "high"];
 type QualityName = (typeof qualityNames)[number];
 type QualityTier = Exclude<QualityName, 'auto'>;
 
+/**
+ * Stage mode: paper as architecture, with a figure walking through it.
+ *
+ * The one guarantee worth stating — every part of the scene reads the SAME
+ * walk. The layout arranges along it, the figure follows it, the camera is
+ * stationed on it, and the source stands at the end of it. Handing those
+ * four their own copies of a path is the failure this component exists to
+ * prevent: a colonnade whose aisle the figure does not walk down is not a
+ * near-miss, it is a completely different picture.
+ */
+/** A banner: tall, translucent, with folds running the length of its drop. */
+/**
+ * The sheet a stage hangs when the caller does not name one.
+ *
+ * Exported because it is the base anyone RESHAPING a banner has to start
+ * from. A caller who wants a wider drop wants this stock, this grain and
+ * this drape with different dimensions — and rebuilding it from the schema
+ * defaults instead gives a sheet of printer paper with no fold in it, which
+ * is a different object. A second copy of these numbers in a caller is a
+ * copy free to drift from the one the scene actually falls back to.
+ */
+declare const stageBanner: PaperConfigInput;
 interface PaperStageSceneProps {
     /** Walk, shot, figure, lighting — see `stageSchema`. */
     stage?: StageConfigInput;
@@ -962,16 +828,6 @@ declare function PaperStageScene({ stage: stageInput, quality, onQualityChange,
 /** `<PaperStage />` owns its Canvas; `<PaperStageScene />` drops into an existing one. */
 declare function PaperStage({ children, className, style, ...sceneProps }: PaperStageProps): react.JSX.Element;
 
-/**
- * The source's default burn, in linear light.
- *
- * Chosen by matching: at 3.4 the tone-mapped source lands on the same read
- * as the un-mapped plane it replaces, so a stage that never mounts a
- * composer looks the way it always did, and one that does gets a source
- * that blooms instead of a rectangle that clips.
- */
-declare const SOURCE_INTENSITY = 3.4;
-
 /**
  * Named stages. A mode with no presets asks its visitor to invent a space
  * out of eleven sliders before it will show them anything — and stage mode
@@ -1128,24 +984,16 @@ interface StageExportInput {
     paper?: PaperConfigInput;
     /** The words the space is built from. Omitted renders blank banners. */
     text?: string;
+    /** Pictures on the banners, one per drop, instead of words. */
+    images?: string[];
     count?: number;
     /** Bind the walk to page scroll, pinned, rather than to the clock. */
     scroll?: boolean;
     /** Exported component name. */
     componentName?: string;
 }
-/** Which named walk these points are, if any — the export reads better for it. */
-declare function walkNameFor(path: StageConfig['path']): WalkName | undefined;
 /** The stage config with defaults removed — what actually needs writing down. */
 declare function diffStage(stage: StageConfigInput): Record<string, unknown>;
-/**
- * JSON.stringify, except an array of plain numbers stays on one line. A walk
- * is a list of coordinate pairs, and the default pretty-printer spreads each
- * `[6, 17]` over four lines — twenty lines of punctuation for one gentle
- * curve. Exported code is a product surface; it should read like something a
- * person wrote.
- */
-declare function stringifyStage(value: unknown, indent?: number): string;
 /** The one-line visual an agent verifies after `npm run dev`. */
 declare function describeStage(input: StageExportInput): string;
 /** Component source shared by the JSX snippet and the agent payload. */
@@ -1153,4 +1001,4 @@ declare function buildStageComponentSource(input: StageExportInput): string;
 /** The self-contained stage integration brief — one paste into a coding agent. */
 declare function buildStageAgentPayload(input: StageExportInput): string;
 
-export { type Ground, PaperStage, type PaperStageProps, PaperStageScene, type PaperStageSceneProps, type QualityName, type QualityTier, SOURCE_INTENSITY, type ShotName, type ShotOptions, type StageConfig, type StageConfigInput, type StageExportInput, type StageGradeConfig, type StageMotion, type StageMotionInput, type StagePreset, type StageScale, type StageShot, type WalkName, type WalkPath, type WalkPathOptions, buildStageAgentPayload, buildStageComponentSource, createWalkPath, describeStage, diffStage, getStagePreset, getWalk, listStagePresets, qualityNames, shotNames, stageGradeSchema, stageMotionSchema, stagePresets, stageRoomSchema, stageSchema, stageSuspensionSchema, stringifyStage, walkNameFor, walkNames, walks };
+export { type Ground, PaperStage, type PaperStageProps, PaperStageScene, type PaperStageSceneProps, type QualityName, type QualityTier, type ShotName, type ShotOptions, type StageConfig, type StageConfigInput, type StageExportInput, type StageGradeConfig, type StageMotion, type StageMotionInput, type StagePreset, type StageScale, type StageShot, type WalkName, type WalkPath, type WalkPathOptions, buildStageAgentPayload, buildStageComponentSource, createWalkPath, describeStage, diffStage, getStagePreset, getWalk, listStagePresets, qualityNames, shotNames, stageBanner, stagePresets, stageSchema, walkNames, walks };

package/dist/stage.d.ts

@@ -1,163 +1,7 @@
 import * as react from 'react';
-import { F as FieldPaperSlot, a as PaperConfigInput } from './slots-DUMR64HB.js';
+import { F as FieldPaperSlot, a as PaperConfigInput } from './slots-CIo7FnlY.js';
 import { z } from 'zod';
 
-/**
- * The room the walk is in.
- *
- * Stage mode was a void with a horizon: a graded dome, a flat plane, and a
- * bright rectangle at the end, none of it a knowable size. That is why the
- * walking figure was carrying the whole scale burden by itself — and why
- * simply removing the figure would have left an abstraction rather than a
- * hall. Architecture is the better answer: objects whose size the viewer
- * already knows, made of flat surfaces under good light, which is the one
- * thing a renderer never gets wrong.
- */
-/**
- * What holds the paper up.
- *
- * Every paper installation shows its hardware — monofilament from a ceiling
- * grid, steel wire, bulldog clips, a rod — and in the scattered-sheet pieces
- * the threads are half the composition. Stage mode's banners hung from
- * nothing at all, which is a bigger realism gap than any shader in the
- * backlog and closes for a few thin lines of geometry.
- */
-declare const stageSuspensionSchema: z.ZodObject<{
-    /**
-     * What carries the load.
-     *
-     * `thread` is monofilament to the ceiling — one straight line per sheet.
-     * `rod` is a dowel across each sheet's top edge, hung from the ceiling at
-     * both ends, which is a different image entirely: a rank on threads reads
-     * as sheets floating in a row, and a rank on rods reads as sheets that
-     * were HUNG, by someone, on something. `none` is for a stage where the
-     * paper is meant to be impossible.
-     */
-    type: z.ZodDefault<z.ZodEnum<["none", "thread", "rod"]>>;
-    color: z.ZodDefault<z.ZodString>;
-    /**
-     * What grips the sheet.
-     *
-     * A clip is wide and shallow — the bulldog clip of a gallery. A peg is
-     * narrow and deep, and grips DOWN the face of the sheet rather than
-     * across its edge: the domestic one, a line of paper on a washing line.
-     * They are told apart by silhouette at any distance, which is the only
-     * thing that survives being one instanced box at the top of an
-     * eight-metre banner.
-     *
-     * This replaced a `clips: boolean`. Two of the four pieces of hardware the
-     * plan named — pegs, and a rod — had no way to be asked for, and a boolean
-     * cannot grow a third answer.
-     */
-    hardware: z.ZodDefault<z.ZodEnum<["none", "clip", "peg"]>>;
-}, "strip", z.ZodTypeAny, {
-    type: "none" | "thread" | "rod";
-    color: string;
-    hardware: "none" | "clip" | "peg";
-}, {
-    type?: "none" | "thread" | "rod" | undefined;
-    color?: string | undefined;
-    hardware?: "none" | "clip" | "peg" | undefined;
-}>;
-declare const stageRoomSchema: z.ZodObject<{
-    enabled: z.ZodDefault<z.ZodBoolean>;
-    /**
-     * Ceiling height, as a multiple of the paper's own height.
-     *
-     * Relative rather than absolute because the banners ARE the architecture
-     * here: a hall whose ceiling sits just above its hangings reads as built
-     * for them, and one at a fixed world height reads as whatever the paper
-     * happened to be scaled to that day.
-     */
-    height: z.ZodDefault<z.ZodNumber>;
-    color: z.ZodDefault<z.ZodString>;
-    /** Columns flanking the walk — see `stageColumnsSchema`. */
-    columns: z.ZodDefault<z.ZodObject<{
-        enabled: z.ZodDefault<z.ZodBoolean>;
-        /** Centres this far apart along the walk. Roughly a bay. */
-        spacing: z.ZodDefault<z.ZodNumber>;
-        /** Shaft width. The number doing the work — a column is a known size. */
-        width: z.ZodDefault<z.ZodNumber>;
-        /**
-         * How far off the walk's centreline each rank stands.
-         *
-         * Outside the banners, always. Columns are the room; the paper is the
-         * subject, and a column standing between the viewer and a banner has
-         * swapped the two over. Default clears a `colonnade`'s widest sensible
-         * aisle with room to spare.
-         */
-        offset: z.ZodDefault<z.ZodNumber>;
-        /**
-         * Stone, and darker than paper on purpose.
-         *
-         * The brightest thing in any of these frames has to be the light, and the
-         * second brightest has to be the paper. A column the same value as a
-         * banner does not read as architecture behind the subject; it reads as
-         * more banners, and the eye stops being able to tell what the room is made
-         * of from what is hanging in it.
-         */
-        color: z.ZodDefault<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        width: number;
-        offset: number;
-        color: string;
-        spacing: number;
-        enabled: boolean;
-    }, {
-        width?: number | undefined;
-        offset?: number | undefined;
-        color?: string | undefined;
-        spacing?: number | undefined;
-        enabled?: boolean | undefined;
-    }>>;
-    /** A wall at the end of the walk with the source in it. */
-    doorway: z.ZodDefault<z.ZodObject<{
-        enabled: z.ZodDefault<z.ZodBoolean>;
-        /** Opening size, as a multiple of the source's own. 1 frames it exactly. */
-        opening: z.ZodDefault<z.ZodNumber>;
-        color: z.ZodDefault<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        color: string;
-        enabled: boolean;
-        opening: number;
-    }, {
-        color?: string | undefined;
-        enabled?: boolean | undefined;
-        opening?: number | undefined;
-    }>>;
-}, "strip", z.ZodTypeAny, {
-    height: number;
-    color: string;
-    enabled: boolean;
-    columns: {
-        width: number;
-        offset: number;
-        color: string;
-        spacing: number;
-        enabled: boolean;
-    };
-    doorway: {
-        color: string;
-        enabled: boolean;
-        opening: number;
-    };
-}, {
-    height?: number | undefined;
-    color?: string | undefined;
-    enabled?: boolean | undefined;
-    columns?: {
-        width?: number | undefined;
-        offset?: number | undefined;
-        color?: string | undefined;
-        spacing?: number | undefined;
-        enabled?: boolean | undefined;
-    } | undefined;
-    doorway?: {
-        color?: string | undefined;
-        enabled?: boolean | undefined;
-        opening?: number | undefined;
-    } | undefined;
-}>;
 /**
  * The print: what happens to the frame after the scene is drawn.
  *
@@ -374,15 +218,15 @@ declare const stageSchema: z.ZodObject<{
         spread: z.ZodDefault<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
         color: string;
-        enabled: boolean;
         spread: number;
+        enabled: boolean;
         zenith: string;
         beyond: number;
         surround: boolean;
     }, {
         color?: string | undefined;
-        enabled?: boolean | undefined;
         spread?: number | undefined;
+        enabled?: boolean | undefined;
         zenith?: string | undefined;
         beyond?: number | undefined;
         surround?: boolean | undefined;
@@ -634,6 +478,17 @@ declare const stageSchema: z.ZodObject<{
         closed: boolean;
     };
     lighting: "studio" | "window" | "leaves" | "goldenhour" | "noir" | "nave" | "raking" | "lightbox";
+    light: {
+        key?: number | undefined;
+        height?: number | undefined;
+        color?: string | undefined;
+        studio?: number | undefined;
+        exposure?: number | undefined;
+        film?: "agx" | "neutral" | "filmic" | undefined;
+        direction?: number | undefined;
+        ambient?: number | undefined;
+        haze?: number | undefined;
+    };
     figure: {
         height: number;
         speed: number;
@@ -646,23 +501,12 @@ declare const stageSchema: z.ZodObject<{
     };
     source: {
         color: string;
-        enabled: boolean;
         spread: number;
+        enabled: boolean;
         zenith: string;
         beyond: number;
         surround: boolean;
     };
-    light: {
-        key?: number | undefined;
-        height?: number | undefined;
-        color?: string | undefined;
-        studio?: number | undefined;
-        exposure?: number | undefined;
-        film?: "agx" | "neutral" | "filmic" | undefined;
-        direction?: number | undefined;
-        ambient?: number | undefined;
-        haze?: number | undefined;
-    };
     shot: {
         height: number;
         offset: number;
@@ -711,6 +555,17 @@ declare const stageSchema: z.ZodObject<{
         closed?: boolean | undefined;
     } | undefined;
     lighting?: "studio" | "window" | "leaves" | "goldenhour" | "noir" | "nave" | "raking" | "lightbox" | undefined;
+    light?: {
+        key?: number | undefined;
+        height?: number | undefined;
+        color?: string | undefined;
+        studio?: number | undefined;
+        exposure?: number | undefined;
+        film?: "agx" | "neutral" | "filmic" | undefined;
+        direction?: number | undefined;
+        ambient?: number | undefined;
+        haze?: number | undefined;
+    } | undefined;
     figure?: {
         height?: number | undefined;
         speed?: number | undefined;
@@ -723,23 +578,12 @@ declare const stageSchema: z.ZodObject<{
     } | undefined;
     source?: {
         color?: string | undefined;
-        enabled?: boolean | undefined;
         spread?: number | undefined;
+        enabled?: boolean | undefined;
         zenith?: string | undefined;
         beyond?: number | undefined;
         surround?: boolean | undefined;
     } | undefined;
-    light?: {
-        key?: number | undefined;
-        height?: number | undefined;
-        color?: string | undefined;
-        studio?: number | undefined;
-        exposure?: number | undefined;
-        film?: "agx" | "neutral" | "filmic" | undefined;
-        direction?: number | undefined;
-        ambient?: number | undefined;
-        haze?: number | undefined;
-    } | undefined;
     shot?: {
         height?: number | undefined;
         offset?: number | undefined;
@@ -895,6 +739,28 @@ declare const qualityNames: readonly ["auto", "low", "medium", "high"];
 type QualityName = (typeof qualityNames)[number];
 type QualityTier = Exclude<QualityName, 'auto'>;
 
+/**
+ * Stage mode: paper as architecture, with a figure walking through it.
+ *
+ * The one guarantee worth stating — every part of the scene reads the SAME
+ * walk. The layout arranges along it, the figure follows it, the camera is
+ * stationed on it, and the source stands at the end of it. Handing those
+ * four their own copies of a path is the failure this component exists to
+ * prevent: a colonnade whose aisle the figure does not walk down is not a
+ * near-miss, it is a completely different picture.
+ */
+/** A banner: tall, translucent, with folds running the length of its drop. */
+/**
+ * The sheet a stage hangs when the caller does not name one.
+ *
+ * Exported because it is the base anyone RESHAPING a banner has to start
+ * from. A caller who wants a wider drop wants this stock, this grain and
+ * this drape with different dimensions — and rebuilding it from the schema
+ * defaults instead gives a sheet of printer paper with no fold in it, which
+ * is a different object. A second copy of these numbers in a caller is a
+ * copy free to drift from the one the scene actually falls back to.
+ */
+declare const stageBanner: PaperConfigInput;
 interface PaperStageSceneProps {
     /** Walk, shot, figure, lighting — see `stageSchema`. */
     stage?: StageConfigInput;
@@ -962,16 +828,6 @@ declare function PaperStageScene({ stage: stageInput, quality, onQualityChange,
 /** `<PaperStage />` owns its Canvas; `<PaperStageScene />` drops into an existing one. */
 declare function PaperStage({ children, className, style, ...sceneProps }: PaperStageProps): react.JSX.Element;
 
-/**
- * The source's default burn, in linear light.
- *
- * Chosen by matching: at 3.4 the tone-mapped source lands on the same read
- * as the un-mapped plane it replaces, so a stage that never mounts a
- * composer looks the way it always did, and one that does gets a source
- * that blooms instead of a rectangle that clips.
- */
-declare const SOURCE_INTENSITY = 3.4;
-
 /**
  * Named stages. A mode with no presets asks its visitor to invent a space
  * out of eleven sliders before it will show them anything — and stage mode
@@ -1128,24 +984,16 @@ interface StageExportInput {
     paper?: PaperConfigInput;
     /** The words the space is built from. Omitted renders blank banners. */
     text?: string;
+    /** Pictures on the banners, one per drop, instead of words. */
+    images?: string[];
     count?: number;
     /** Bind the walk to page scroll, pinned, rather than to the clock. */
     scroll?: boolean;
     /** Exported component name. */
     componentName?: string;
 }
-/** Which named walk these points are, if any — the export reads better for it. */
-declare function walkNameFor(path: StageConfig['path']): WalkName | undefined;
 /** The stage config with defaults removed — what actually needs writing down. */
 declare function diffStage(stage: StageConfigInput): Record<string, unknown>;
-/**
- * JSON.stringify, except an array of plain numbers stays on one line. A walk
- * is a list of coordinate pairs, and the default pretty-printer spreads each
- * `[6, 17]` over four lines — twenty lines of punctuation for one gentle
- * curve. Exported code is a product surface; it should read like something a
- * person wrote.
- */
-declare function stringifyStage(value: unknown, indent?: number): string;
 /** The one-line visual an agent verifies after `npm run dev`. */
 declare function describeStage(input: StageExportInput): string;
 /** Component source shared by the JSX snippet and the agent payload. */
@@ -1153,4 +1001,4 @@ declare function buildStageComponentSource(input: StageExportInput): string;
 /** The self-contained stage integration brief — one paste into a coding agent. */
 declare function buildStageAgentPayload(input: StageExportInput): string;
 
-export { type Ground, PaperStage, type PaperStageProps, PaperStageScene, type PaperStageSceneProps, type QualityName, type QualityTier, SOURCE_INTENSITY, type ShotName, type ShotOptions, type StageConfig, type StageConfigInput, type StageExportInput, type StageGradeConfig, type StageMotion, type StageMotionInput, type StagePreset, type StageScale, type StageShot, type WalkName, type WalkPath, type WalkPathOptions, buildStageAgentPayload, buildStageComponentSource, createWalkPath, describeStage, diffStage, getStagePreset, getWalk, listStagePresets, qualityNames, shotNames, stageGradeSchema, stageMotionSchema, stagePresets, stageRoomSchema, stageSchema, stageSuspensionSchema, stringifyStage, walkNameFor, walkNames, walks };
+export { type Ground, PaperStage, type PaperStageProps, PaperStageScene, type PaperStageSceneProps, type QualityName, type QualityTier, type ShotName, type ShotOptions, type StageConfig, type StageConfigInput, type StageExportInput, type StageGradeConfig, type StageMotion, type StageMotionInput, type StagePreset, type StageScale, type StageShot, type WalkName, type WalkPath, type WalkPathOptions, buildStageAgentPayload, buildStageComponentSource, createWalkPath, describeStage, diffStage, getStagePreset, getWalk, listStagePresets, qualityNames, shotNames, stageBanner, stagePresets, stageSchema, walkNames, walks };