@appinternalleads/ui 0.4.0 → 0.4.2

package/dist/esm/native/RiveReceiptStage.js

@@ -1,13 +1,8 @@
 'use client';
 import { jsx as _jsx } from "react/jsx-runtime";
-import { useEffect, useRef, useState } from 'react';
 import { Fit, RiveFileFactory, RiveView } from '@rive-app/react-native';
-import { Box } from '../core';
-import { HUE, blockRadii } from '../tokens';
-import { ReceiptPaper } from '../components/onboarding/receipt-printer/ReceiptPaper';
-import { RECEIPT_PRINTER_RIV } from '../components/onboarding/receipt-printer/riv';
-import { stageAspect } from '../components/onboarding/receipt-printer/ReceiptStage.types';
 import { ReceiptPrinter } from '../components/onboarding/receipt-printer/ReceiptPrinterView';
+import { createRiveReceiptStage } from './riveReceiptStageFactory';
 /**
  * **The Receipt Printer's Rive printer, on iOS and Android** — the same `.riv`, the same feed, the
  * same tear-off as the web, through `@rive-app/react-native` (which needs
@@ -22,153 +17,17 @@ import { ReceiptPrinter } from '../components/onboarding/receipt-printer/Receipt
  * and trigger is followed by `playIfNeeded()`. Found on Android: without it, Print again after a
  * print fired the trigger into a paused view, and nothing moved.
  *
- * Its own entry point — importing it is the opt-in, and it pulls in nothing else native:
+ * **Since 29 Sep 2026 this is also the default** on native: the main entry point's `ReceiptPrinter`
+ * loads the runtime through an optional `require` and uses this printer whenever the app has
+ * installed `@rive-app/react-native`, falling back to the still when it has not. This entry point
+ * stays for apps that want to name the stage explicitly, or want a missing runtime to fail the
+ * build rather than fall back to the still:
  *
  *   import { NativeReceiptPrinter } from '@comppack/ui/native/receipt-printer';
  *   <NativeReceiptPrinter preset="case1" />
  *   // or: <ReceiptPrinter stage={RiveReceiptStage} />
  */
-const ARTBOARD = 'ReceiptPrinter';
-const MACHINE = 'ReceiptPrinterMachine';
-const LINE_KEYS = ['title', 'badge', 'total', 'meta', 'paymentMethod', 'message', 'paymentLabel', 'totalLabel'];
-let bytes = null;
-function rivBytes() {
-    if (!bytes) {
-        const bin = atob(RECEIPT_PRINTER_RIV);
-        const out = new Uint8Array(bin.length);
-        for (let i = 0; i < bin.length; i++)
-            out[i] = bin.charCodeAt(i);
-        bytes = out.buffer;
-    }
-    return bytes;
-}
-/** One file per app: parsing 280 kB once is enough for every printer on every screen. */
-let filePromise = null;
-const loadFile = () => (filePromise ??= RiveFileFactory.fromBytes(rivBytes(), undefined, false)
-    /* A load that failed is not kept: the next printer to mount tries again. */
-    .catch(e => { filePromise = null; throw e; }));
-async function syncList(vm, path, model, rows) {
-    const list = vm.listProperty(path);
-    if (!list)
-        return;
-    let length = await list.getLengthAsync();
-    while (length > rows.length) {
-        await list.removeInstanceAtAsync(length - 1);
-        length--;
-    }
-    while (length < rows.length && model) {
-        const inst = await model.createBlankInstanceAsync();
-        if (!inst)
-            break;
-        await list.addInstanceAsync(inst);
-        length++;
-    }
-    for (let i = 0; i < rows.length; i++) {
-        const inst = await list.getInstanceAtAsync(i);
-        for (const [k, v] of Object.entries(rows[i]))
-            inst?.stringProperty(k)?.set(v);
-    }
-}
-async function writeLines(l, lines) {
-    for (const k of LINE_KEYS)
-        l.vm.stringProperty(k)?.set(lines[k]);
-    await syncList(l.vm, 'details', l.models.detail, lines.details);
-    await syncList(l.vm, 'items', l.models.item, lines.items);
-    l.vm.numberProperty('lineCount')?.set(Math.max(1, lines.items.length));
-    l.vm.numberProperty('detailCount')?.set(lines.details.length);
-}
-export function RiveReceiptStage({ lines, job, phase, reduceMotion, onPrinted, label, maxWidth, testID }) {
-    const [loaded, setLoaded] = useState(null);
-    const [failed, setFailed] = useState(false);
-    const [shown, setShown] = useState({ lines: Math.max(1, lines.items.length), fields: lines.details.length });
-    const view = useRef(null);
-    const queue = useRef(Promise.resolve());
-    /* Every change to the view model, in order — then wake the view, which pauses once it settles. */
-    const enqueue = (work) => {
-        queue.current = queue.current.then(work).then(() => view.current?.playIfNeeded()).catch(() => { });
-    };
-    const status = useRef('idle');
-    const started = useRef(null);
-    const latest = useRef(lines);
-    latest.current = lines;
-    const printed = useRef(onPrinted);
-    printed.current = onPrinted;
-    const write = (l, next) => enqueue(async () => {
-        await writeLines(l, next);
-        setShown({ lines: Math.max(1, next.items.length), fields: next.details.length });
-    });
-    /* Load the file, make the `Receipt` instance this view binds, and listen to where the paper is. */
-    useEffect(() => {
-        let alive = true;
-        let stop;
-        (async () => {
-            const file = await loadFile();
-            const model = await file.viewModelByNameAsync('Receipt');
-            const vm = await model?.createDefaultInstanceAsync();
-            if (!vm)
-                throw new Error('The Receipt view model is missing.');
-            const l = {
-                file, vm,
-                models: { detail: await file.viewModelByNameAsync('ReceiptDetail'), item: await file.viewModelByNameAsync('ReceiptItem') },
-            };
-            /* The first lines go on before the view mounts, so its first frame is this receipt's length. */
-            await writeLines(l, latest.current);
-            if (!alive)
-                return;
-            setShown({ lines: Math.max(1, latest.current.items.length), fields: latest.current.details.length });
-            stop = vm.stringProperty('status')?.addListener(value => {
-                status.current = value;
-                /* Past a tear-off — a fresh feed, or the idle stub: the lines held back go on now. */
-                if (value === 'printing' || value === 'idle')
-                    write(l, latest.current);
-                if (value === 'printed' && started.current !== null)
-                    printed.current(started.current);
-            });
-            setLoaded(l);
-        })().catch(() => { if (alive)
-            setFailed(true); });
-        return () => { alive = false; stop?.(); };
-    }, []);
-    /* 1 · The lines — never onto a receipt on its way out (a reprint or a reset, with motion). */
-    useEffect(() => {
-        if (!loaded)
-            return;
-        loaded.vm.booleanProperty('reduceMotion')?.set(reduceMotion);
-        const leaving = status.current === 'tearing'
-            || (status.current === 'printed' && !reduceMotion && (phase === 'idle' || started.current !== job));
-        if (!leaving)
-            write(loaded, lines);
-    }, [loaded, lines, phase, job, reduceMotion]);
-    /* 2 · The phase, as triggers — queued behind the lines. Each job is started once. */
-    useEffect(() => {
-        if (!loaded)
-            return;
-        if (phase === 'idle') {
-            started.current = null;
-            enqueue(() => { if (status.current !== 'idle')
-                loaded.vm.triggerProperty('reset')?.trigger(); });
-            return;
-        }
-        if (started.current === job)
-            return;
-        started.current = job;
-        const reveal = reduceMotion || phase === 'printed';
-        enqueue(() => {
-            /* A reveal over a receipt already at rest changes no status: the new lines are this job's paper. */
-            if (reveal && status.current === 'printed') {
-                printed.current(job);
-                return;
-            }
-            loaded.vm.triggerProperty(reveal ? 'reveal' : 'print')?.trigger();
-        });
-    }, [loaded, phase, job, reduceMotion]);
-    /* Without the runtime, the still — and a print completes at once. */
-    useEffect(() => { if (failed && phase === 'printing')
-        onPrinted(job); }, [failed, phase, job]);
-    if (failed)
-        return _jsx(ReceiptPaper, { lines: lines, phase: phase, maxWidth: maxWidth, label: label, testID: testID });
-    return (_jsx(Box, { testID: testID, role: "img", "aria-label": label, style: { width: '100%', maxWidth, aspectRatio: stageAspect(shown.lines, shown.fields), borderRadius: blockRadii.mid, overflow: 'hidden', backgroundColor: HUE.butter.hs }, children: loaded ? (_jsx(RiveView, { file: loaded.file, artboardName: ARTBOARD, stateMachineName: MACHINE, dataBind: loaded.vm, autoPlay: true, fit: Fit.Contain, onError: () => setFailed(true), hybridRef: { f: (ref) => { view.current = ref; } }, style: { width: '100%', height: '100%' } })) : null }));
-}
+export const RiveReceiptStage = createRiveReceiptStage({ Fit, RiveFileFactory, RiveView });
 /** `ReceiptPrinter` with the animated Rive printer — for React Native apps that installed the runtime. */
 export function NativeReceiptPrinter(props) {
     return _jsx(ReceiptPrinter, { ...props, stage: RiveReceiptStage });

package/dist/esm/native/RiveReceiptStage.js.map

@@ -1 +1 @@
-{"version":3,"file":"RiveReceiptStage.js","sourceRoot":"","sources":["../../../src/native/RiveReceiptStage.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"RiveReceiptStage.js","sourceRoot":"","sources":["../../../src/native/RiveReceiptStage.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,GAAG,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACxE,OAAO,EAAE,cAAc,EAA4B,MAAM,6DAA6D,CAAC;AACvH,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAEnE;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,sBAAsB,CAAC,EAAE,GAAG,EAAE,eAAe,EAAE,QAAQ,EAAE,CAAC,CAAC;AAE3F,0GAA0G;AAC1G,MAAM,UAAU,oBAAoB,CAAC,KAAmE;IACtG,OAAO,KAAC,cAAc,OAAK,KAAK,EAAE,KAAK,EAAE,gBAAgB,GAAI,CAAC;AAChE,CAAC"}

package/dist/esm/native/riveReceiptStageFactory.d.ts

@@ -0,0 +1,26 @@
+import { type ComponentType } from 'react';
+import type { Fit as RiveFit, RiveFileFactory as RiveFileFactoryT, RiveView as RiveViewT } from '@rive-app/react-native';
+import { type ReceiptStageProps } from '../components/onboarding/receipt-printer/ReceiptStage.types';
+/**
+ * **The Receipt Printer's Rive printer on iOS and Android, as a factory over the runtime.**
+ *
+ * Everything about driving the printer is here: the view model, the ordered write queue,
+ * `playIfNeeded()` after every change, and the still when the runtime or file cannot load (see
+ * `RiveReceiptStage.tsx`). The runtime itself is passed in. That is why the default native stage
+ * (`components/onboarding/receipt-printer/ReceiptStage.tsx`) can animate with Rive whenever the
+ * app has installed it, without making every React Native app install it.
+ */
+export type RiveRuntime = {
+    Fit: typeof RiveFit;
+    RiveFileFactory: typeof RiveFileFactoryT;
+    RiveView: typeof RiveViewT;
+};
+/**
+ * Build the stage around a Rive runtime module. Taking the runtime as an argument — rather than
+ * importing it — is what lets the MAIN entry point use this file: its only reference to
+ * `@rive-app/react-native` is a type import, erased at build, so nothing here makes Metro resolve
+ * the runtime. Whoever calls this has already loaded it (statically in the opt-in entry point,
+ * through an optional `require` in the default native stage).
+ */
+export declare function createRiveReceiptStage({ Fit, RiveFileFactory, RiveView }: RiveRuntime): ComponentType<ReceiptStageProps>;
+//# sourceMappingURL=riveReceiptStageFactory.d.ts.map

package/dist/esm/native/riveReceiptStageFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"riveReceiptStageFactory.d.ts","sourceRoot":"","sources":["../../../src/native/riveReceiptStageFactory.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA+B,KAAK,aAAa,EAAE,MAAM,OAAO,CAAC;AACxE,OAAO,KAAK,EAAE,GAAG,IAAI,OAAO,EAAY,eAAe,IAAI,gBAAgB,EAAE,QAAQ,IAAI,SAAS,EAA6C,MAAM,wBAAwB,CAAC;AAM9K,OAAO,EAAe,KAAK,iBAAiB,EAAE,MAAM,6DAA6D,CAAC;AAElH;;;;;;;;GAQG;AACH,MAAM,MAAM,WAAW,GAAG;IAAE,GAAG,EAAE,OAAO,OAAO,CAAC;IAAC,eAAe,EAAE,OAAO,gBAAgB,CAAC;IAAC,QAAQ,EAAE,OAAO,SAAS,CAAA;CAAE,CAAC;AA2CxH;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,EAAE,GAAG,EAAE,eAAe,EAAE,QAAQ,EAAE,EAAE,WAAW,GAAG,aAAa,CAAC,iBAAiB,CAAC,CA0GxH"}

package/dist/esm/native/riveReceiptStageFactory.js

@@ -0,0 +1,159 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useEffect, useRef, useState } from 'react';
+import { Box } from '../core';
+import { HUE, blockRadii } from '../tokens';
+import { ReceiptPaper } from '../components/onboarding/receipt-printer/ReceiptPaper';
+import { RECEIPT_PRINTER_RIV } from '../components/onboarding/receipt-printer/riv';
+import { stageAspect } from '../components/onboarding/receipt-printer/ReceiptStage.types';
+const ARTBOARD = 'ReceiptPrinter';
+const MACHINE = 'ReceiptPrinterMachine';
+const LINE_KEYS = ['title', 'badge', 'total', 'meta', 'paymentMethod', 'message', 'paymentLabel', 'totalLabel'];
+let bytes = null;
+function rivBytes() {
+    if (!bytes) {
+        const bin = atob(RECEIPT_PRINTER_RIV);
+        const out = new Uint8Array(bin.length);
+        for (let i = 0; i < bin.length; i++)
+            out[i] = bin.charCodeAt(i);
+        bytes = out.buffer;
+    }
+    return bytes;
+}
+async function syncList(vm, path, model, rows) {
+    const list = vm.listProperty(path);
+    if (!list)
+        return;
+    let length = await list.getLengthAsync();
+    while (length > rows.length) {
+        await list.removeInstanceAtAsync(length - 1);
+        length--;
+    }
+    while (length < rows.length && model) {
+        const inst = await model.createBlankInstanceAsync();
+        if (!inst)
+            break;
+        await list.addInstanceAsync(inst);
+        length++;
+    }
+    for (let i = 0; i < rows.length; i++) {
+        const inst = await list.getInstanceAtAsync(i);
+        for (const [k, v] of Object.entries(rows[i]))
+            inst?.stringProperty(k)?.set(v);
+    }
+}
+async function writeLines(l, lines) {
+    for (const k of LINE_KEYS)
+        l.vm.stringProperty(k)?.set(lines[k]);
+    await syncList(l.vm, 'details', l.models.detail, lines.details);
+    await syncList(l.vm, 'items', l.models.item, lines.items);
+    l.vm.numberProperty('lineCount')?.set(Math.max(1, lines.items.length));
+    l.vm.numberProperty('detailCount')?.set(lines.details.length);
+}
+/**
+ * Build the stage around a Rive runtime module. Taking the runtime as an argument — rather than
+ * importing it — is what lets the MAIN entry point use this file: its only reference to
+ * `@rive-app/react-native` is a type import, erased at build, so nothing here makes Metro resolve
+ * the runtime. Whoever calls this has already loaded it (statically in the opt-in entry point,
+ * through an optional `require` in the default native stage).
+ */
+export function createRiveReceiptStage({ Fit, RiveFileFactory, RiveView }) {
+    /** One file per app: parsing 280 kB once is enough for every printer on every screen. */
+    let filePromise = null;
+    const loadFile = () => (filePromise ??= RiveFileFactory.fromBytes(rivBytes(), undefined, false)
+        /* A load that failed is not kept: the next printer to mount tries again. */
+        .catch(e => { filePromise = null; throw e; }));
+    return function RiveReceiptStage({ lines, job, phase, reduceMotion, onPrinted, label, maxWidth, testID }) {
+        const [loaded, setLoaded] = useState(null);
+        const [failed, setFailed] = useState(false);
+        const [shown, setShown] = useState({ lines: Math.max(1, lines.items.length), fields: lines.details.length });
+        const view = useRef(null);
+        const queue = useRef(Promise.resolve());
+        /* Every change to the view model, in order — then wake the view, which pauses once it settles. */
+        const enqueue = (work) => {
+            queue.current = queue.current.then(work).then(() => view.current?.playIfNeeded()).catch(() => { });
+        };
+        const status = useRef('idle');
+        const started = useRef(null);
+        const latest = useRef(lines);
+        latest.current = lines;
+        const printed = useRef(onPrinted);
+        printed.current = onPrinted;
+        const write = (l, next) => enqueue(async () => {
+            await writeLines(l, next);
+            setShown({ lines: Math.max(1, next.items.length), fields: next.details.length });
+        });
+        /* Load the file, make the `Receipt` instance this view binds, and listen to where the paper is. */
+        useEffect(() => {
+            let alive = true;
+            let stop;
+            (async () => {
+                const file = await loadFile();
+                const model = await file.viewModelByNameAsync('Receipt');
+                const vm = await model?.createDefaultInstanceAsync();
+                if (!vm)
+                    throw new Error('The Receipt view model is missing.');
+                const l = {
+                    file, vm,
+                    models: { detail: await file.viewModelByNameAsync('ReceiptDetail'), item: await file.viewModelByNameAsync('ReceiptItem') },
+                };
+                /* The first lines go on before the view mounts, so its first frame is this receipt's length. */
+                await writeLines(l, latest.current);
+                if (!alive)
+                    return;
+                setShown({ lines: Math.max(1, latest.current.items.length), fields: latest.current.details.length });
+                stop = vm.stringProperty('status')?.addListener(value => {
+                    status.current = value;
+                    /* Past a tear-off — a fresh feed, or the idle stub: the lines held back go on now. */
+                    if (value === 'printing' || value === 'idle')
+                        write(l, latest.current);
+                    if (value === 'printed' && started.current !== null)
+                        printed.current(started.current);
+                });
+                setLoaded(l);
+            })().catch(() => { if (alive)
+                setFailed(true); });
+            return () => { alive = false; stop?.(); };
+        }, []);
+        /* 1 · The lines — never onto a receipt on its way out (a reprint or a reset, with motion). */
+        useEffect(() => {
+            if (!loaded)
+                return;
+            loaded.vm.booleanProperty('reduceMotion')?.set(reduceMotion);
+            const leaving = status.current === 'tearing'
+                || (status.current === 'printed' && !reduceMotion && (phase === 'idle' || started.current !== job));
+            if (!leaving)
+                write(loaded, lines);
+        }, [loaded, lines, phase, job, reduceMotion]);
+        /* 2 · The phase, as triggers — queued behind the lines. Each job is started once. */
+        useEffect(() => {
+            if (!loaded)
+                return;
+            if (phase === 'idle') {
+                started.current = null;
+                enqueue(() => { if (status.current !== 'idle')
+                    loaded.vm.triggerProperty('reset')?.trigger(); });
+                return;
+            }
+            if (started.current === job)
+                return;
+            started.current = job;
+            const reveal = reduceMotion || phase === 'printed';
+            enqueue(() => {
+                /* A reveal over a receipt already at rest changes no status: the new lines are this job's paper. */
+                if (reveal && status.current === 'printed') {
+                    printed.current(job);
+                    return;
+                }
+                loaded.vm.triggerProperty(reveal ? 'reveal' : 'print')?.trigger();
+            });
+        }, [loaded, phase, job, reduceMotion]);
+        /* Without the runtime, the still — and a print completes at once. */
+        useEffect(() => { if (failed && phase === 'printing')
+            onPrinted(job); }, [failed, phase, job]);
+        if (failed)
+            return _jsx(ReceiptPaper, { lines: lines, phase: phase, maxWidth: maxWidth, label: label, testID: testID });
+        return (_jsx(Box, { testID: testID, role: "img", "aria-label": label, style: { width: '100%', maxWidth, aspectRatio: stageAspect(shown.lines, shown.fields), borderRadius: blockRadii.mid, overflow: 'hidden', backgroundColor: HUE.butter.hs }, children: loaded ? (_jsx(RiveView, { file: loaded.file, artboardName: ARTBOARD, stateMachineName: MACHINE, dataBind: loaded.vm, autoPlay: true, fit: Fit.Contain, onError: () => setFailed(true), hybridRef: { f: (ref) => { view.current = ref; } }, style: { width: '100%', height: '100%' } })) : null }));
+    };
+}
+//# sourceMappingURL=riveReceiptStageFactory.js.map

package/dist/esm/native/riveReceiptStageFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"riveReceiptStageFactory.js","sourceRoot":"","sources":["../../../src/native/riveReceiptStageFactory.tsx"],"names":[],"mappings":"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"}

package/dist/esm/tokens/stage.d.ts

@@ -0,0 +1,7 @@
+/**
+ * **The ground a Rive animation is drawn on.** Animated Status's artboard (`rive/animated-status`)
+ * paints its white scenes on pure white; the stage behind the canvas, and the still that stands in
+ * for it, use the same so no seam shows while the runtime loads. Fixed design, not a theme colour.
+ */
+export declare const ANIMATION_GROUND = "#FFFFFF";
+//# sourceMappingURL=stage.d.ts.map

package/dist/esm/tokens/stage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stage.d.ts","sourceRoot":"","sources":["../../../src/tokens/stage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,YAAY,CAAC"}

package/dist/esm/tokens/stage.js

@@ -0,0 +1,7 @@
+/**
+ * **The ground a Rive animation is drawn on.** Animated Status's artboard (`rive/animated-status`)
+ * paints its white scenes on pure white; the stage behind the canvas, and the still that stands in
+ * for it, use the same so no seam shows while the runtime loads. Fixed design, not a theme colour.
+ */
+export const ANIMATION_GROUND = '#FFFFFF';
+//# sourceMappingURL=stage.js.map

package/dist/esm/tokens/stage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stage.js","sourceRoot":"","sources":["../../../src/tokens/stage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,SAAS,CAAC"}

package/docs/TYPE-SURFACE.md

@@ -0,0 +1,183 @@
+# Typography × Surface — a lab for text that physically meets a surface
+
+**Live:** `/animations/type-surface` · **Code:** `src/motion/typesurface/` (exported from `@comppack/ui/motion` as `TypeSurface`, plus `TypeSurfaceCanvas`)
+· **Playground:** `site/components/TypeSurfaceStudio.tsx` · **Tests:** `tests/motion/typeSurface.test.ts`, `typeSurfaceConstruct.test.ts` · **Decisions:** `DECISIONS.md` §30
+
+Type any words and they meet a surface. They wrap around it, land letter by letter, fold across a crease, crumple with the
+paper, roll up with it, and finally sink into it as printed ink. The text is never painted into the artwork. It stays its own
+editable layer the whole time, so changing BREAKING NEWS to SUMMER SALE, or the font, colour or size, never touches the newspaper.
+
+Surfaces: **newspaper** (the detailed one), paper, bottle, wrapper and fabric. The lab also shows the library's existing
+**paper-fold promo** (`PaperFoldPlayer`, unchanged) with the lab's text as its headline. Its result is the fold performed (the
+middle of its folded hold), and it covers the stage. Neon has its own page
+(`/animations/neon-text`) and is not part of the lab. Glass and metal were removed at the user's request.
+
+Presets and states open on their **result**, with the operation already performed. **Replay** plays the transformation, and the timeline scrubs it.
+The camera looks straight down with a narrow lens. Perspective was removed from every preset and state (`deformation.perspective` stays 0),
+because it looked bad.
+
+---
+
+## 1. How text geometry is represented
+
+`layout.ts` lays the text out once into a **block** in *surface units* (every surface is 1000 wide). The block has lines, and each
+glyph's box on its line, with kerning kept: a glyph starts where the width of everything before it ends. `text.ts` rasterises exactly
+this layout, as white letters on nothing, into an alpha texture, using the live font. Colour, gradient, blend mode and ink are applied
+in the shader on top of that mask. So a colour change repaints nothing, and only new words or a new font repaint the raster.
+
+## 2. How surfaces are represented
+
+`surfaces.ts`: a surface is **data**. It has a size in world units, a mesh resolution, an artwork painter (`art.ts`), a shading
+model, what it lies on, its natural text material, and named **states** (flat, folded, double folded, rolled, partially folded,
+crumpled, heavily crumpled…). Only a few have their own shape: a wrapper inflates and has crimped seals, and fabric drapes. Everything else comes from shared operators.
+Every surface has full artwork, procedural and seeded (`art.ts`):
+
+| surface | artwork | shading |
+|---|---|---|
+| newspaper | masthead, dateline, justified columns of real words, halftoned photos, advert, markets, delivery crease, fibres, the next page showing through; a back page, stacked pages, a loose page on the desk | newsprint: matte, a little light through the sheet |
+| bottle | a paper label: winery line, descriptors, a red pen scribble, vintage and volume, a back label with a barcode where it wraps behind. The bottle is geometry: dark glass reflecting a studio (key softbox and strip light) with a crinkled foil capsule | label: satin paper; glass and foil use the studio reflection |
+| wrapper | a glossy snack pack: brand band, sale burst behind the words, crisps, flavour ribbon, net weight, silver crimped seals | film: sharp specular plus studio reflection |
+| paper | a ruled note sheet: blue rules, red margin, three real punched holes (the table shows through) | paper |
+| fabric | twill-woven cotton with slubs, a hemmed edge with running stitch, a woven care label | cloth: rough, with sheen at grazing angles |
+
+## 3. How deformation is applied
+
+`ops.ts` holds the shared operators, and every one is an isometry of the sheet or close to one:
+
+| operator | what it does |
+|---|---|
+| `bend` | a crease: one side turns about a line through a rounded zone. Height above the sheet is carried through, so stacked layers fold together (`core` stops an inner layer from turning inside out on a second fold) |
+| `roll` | winds the sheet up from an edge onto a tightening spiral, printed side outward |
+| `cylinder` | wraps a cylinder, keeping arc length (a bottle label) |
+| `crumpleField` | a seeded network of straight ridges and valleys with planar flanks, plus the in-plane pull the ridges take up |
+| `rotate` | rigid turns of the whole object |
+
+**Up to four folds and four wraps.** `fold`, `fold2`, `fold3` and `fold4` are creases. Each has a position, angle, crease width,
+orientation, direction (over/under) and `side` (which part moves). `wrap1`–`wrap4` wrap the sheet round a rod from a line, with
+a radius and an angle up to 360°. All eight are the same `bend` operator, applied in that order. A later one in the same
+direction wraps the layers the earlier ones laid on its inner side. Parallel creases fold correctly when the farthest is
+listed first, as the accordion preset does. Each has its own timeline key (`fold`…`fold4`, `wrap1`…`wrap4`).
+
+`engine.ts` runs every sheet vertex through **shape → wrinkles → crumple → fold → second fold → roll → cylinder → turns**,
+then computes normals, cavity (valleys darken) and crease light. The crumple field is cached per seed, and every buffer is
+allocated once per surface, so a frame allocates nothing.
+
+**The text mesh is made of the sheet's own cells** under the text block, with the same triangle diagonals. Each text vertex
+blends from its *floating* position (the flat sheet, lifted above everything) to *the sheet vertex it belongs to*. A conformed
+letter therefore lies on exactly the paper's triangles, crease for crease, and depth testing hides it behind folds. This is tested.
+
+- **wrap** conforms the block, sweeping slightly left to right.
+- **morph** lands glyphs one at a time: each glyph has its own window, the letters spread apart mid-way (`morphGap`), and in-flight letters arc up.
+
+## 4. How material blending works
+
+`material.blend` runs 0 → 1: **floating** (a flat graphic that casts a real shadow in the shadow map) → **surface** (takes the
+key light, shadow and crease light) → **printed** (the blend mode is computed against the paper's own albedo under the letter, and
+the paper grain breaks the ink up) → **embedded** (ragged edges, spread into the fibres, misregistration, and an optional halftone screen).
+The sliders are ink strength, spread, roughness, paper influence, grain influence, halftone, displacement, surface contrast, float height,
+float shadow, gloss and emboss.
+
+## 5. How animation states are interpolated
+
+`timeline.ts`: sliders say how **far** each transformation goes, and `animation.stages` say **when**. At progress p, a driven amount is
+`value × envelope(p)`. The envelope is an eased ramp between `start` and `end`, optionally falling back between `outStart` and `outEnd`.
+Envelopes are continuous, so scrubbing never jumps. The test samples every preset at 400 points to prove it.
+
+## 6. Adding a surface
+
+```ts
+TypeSurface.registerSurface({ ...TypeSurface.SURFACES.paper, id: 'poster', name: 'Poster', width: 1, height: 1.4,
+  states: { flat: { label: 'Flat', deformation: {} }, curled: { label: 'Curled', deformation: { roll: { amount: 0.3 } } } }, defaultState: 'flat' });
+```
+
+The id becomes a valid `surface.type`, and it gets every operator, the text mesh and the materials. The typography code is not touched.
+
+## 7. Configuring an experiment (agents)
+
+The whole experiment is one JSON object: `text`, `typography`, `placement`, `surface`, `deformation`, `material`, `view` and `animation`.
+
+```ts
+import { TypeSurface, TypeSurfaceCanvas } from '@comppack/ui/motion';
+const config = TypeSurface.createTypeSurface({ text: 'SUMMER SALE', surface: 'newspaper', state: 'crumpled', font: 'Anton', color: '#E0271B' });
+TypeSurface.validateTypeSurface(config);   // [] or [{ path, message }] — never throws
+TypeSurface.TS_CONTROLS;                   // every knob: path, range, unit, what it does
+<TypeSurfaceCanvas config={config} progress={1} />
+```
+
+`sanitizeTypeSurface` replaces each bad field with its default and names it, so a config always draws.
+
+## 8. Constructing objects (agents)
+
+A surface catalogue never covers what a user asks for, so objects are **built, not listed**. `construct.ts` is the construction
+layer, and an object is JSON in the config's `object` field. When `object` is set it is what the text meets, and `surface.type` is ignored.
+
+| level | what | where |
+|---|---|---|
+| primitives | `cylinder` (optionally hollow), `sphere`, `ring`, `revolve` (any `[radius, y]` profile), `tube` (a bar along a path), `box` | `TS_PRIMITIVES` |
+| manipulators | `taper`, `flare`, `bulge`, `twist`, `bend`, `scale`, applied to a part in order | `TS_MANIPULATORS` |
+| materials | `plastic`, `matte`, `ceramic`, `glass`, `metal`, `chrome`, in any colour | `TS_OBJECT_MATERIALS` |
+| recipes | `tumbler`, `mug`, `can`, `bottle`: compositions of the above, returned as a plain spec to edit | `TS_RECIPES`, `createObject` |
+| presets | the config an agent ends up with; save the JSON, edit it later | `object-tumbler`, `object-mug` |
+
+`TypeSurface.describeConstruction()` is the machine-readable manifest: every primitive with its parameters (type, range, default,
+hint) and the manipulators it accepts, every material, how text attaches, and a `limits` list of what cannot be done. Validation
+reads the same tables, so the manifest cannot drift from what is accepted.
+
+```ts
+// "a teal tumbler with Shekhar on it": a recipe, then edits
+const cfg = TypeSurface.createTypeSurface({ text: 'Shekhar', object: 'tumbler', objectColor: '#1F8A8A', color: '#FFFFFF' });
+
+// something with no recipe: compose it from the manifest
+const vase: TypeSurface.TSObjectSpec = {
+  name: 'Vase',
+  parts: [
+    { id: 'body', shape: 'revolve', params: { profile: [[0, 0], [0.22, 0], [0.4, 0.45], [0.3, 0.95], [0.16, 1.25], [0.2, 1.5]], smooth: true },
+      ops: [], material: { type: 'ceramic', color: '#2E5E8C' }, at: [0, 0, 0], rotate: [0, 0, 0] },
+    { id: 'lip', shape: 'ring', params: { radius: 0.2, thickness: 0.018 }, ops: [], material: { type: 'ceramic', color: '#2E5E8C' }, at: [0, 1.5, 0], rotate: [0, 0, 0] },
+  ],
+  text: { on: 'body', y: 0.3, height: 0.3, arc: 140, label: null },   // label: a hex colour for a paper label, null prints on the part
+  scene: { table: 'studio', backdrop: ['#d9dadc', '#b9bbbf'] },
+};
+TypeSurface.validateObject(vase);                       // [] or [{ path: 'object.parts.0.params.radius', message }]; never throws
+const onVase = TypeSurface.createTypeSurface({ text: 'Iris', object: vase });
+```
+
+**How it draws.** `objectSurface(spec)` turns the spec into a `SurfaceDef`: the parts become the solid (one triangle range and one
+material per part), and a sheet the size of the text area wraps the part named in `text.on`. The sheet follows that part's radius at
+every height (`radiusAt`), so text sits on a taper or a bulge. The sheet is hidden unless `text.label` asks for a paper label, so the
+words read as printed on the object. Everything else is unchanged: the text is still its own layer with every typography, placement,
+material and timeline control.
+
+**Repair, not rejection.** `sanitizeObject` clamps numbers into range, fills omitted parameters from the manifest, drops parts and
+manipulators that make no sense, moves the text to a part that can carry it, and names each fix by path. `object` becomes null only
+when nothing in it can be drawn, and the config then falls back to its surface.
+
+**Text size and ink.** `fitObjectText(config)` sets the font size to the largest that fits the part's front face (`OBJECT_FRONT_ARC`,
+110° of the circumference) and the text area's height. `createTypeSurface({ object })` calls it, and with no `color` picks near-white
+or near-black against the part. The rule itself is in the manifest under `text.sizing`.
+
+**Looking at an object.** Turn the object, not the camera: the states `wrapped`, `lying`, `turned` and `tipped`, or `deformation.tiltX`
+(turn) and `tiltY` (tip; negative shows the top). `view.yaw` and `view.pitch` orbit about the table and are wrong for a standing
+object. The manifest's `view` section says this.
+
+**Ready.** `TypeSurfaceCanvas` calls `onReady` and sets `data-ts-ready="true"` after the frame drawn with the loaded fonts
+(`renderer.whenReady(config)` underneath). A screenshot script waits for that instead of a timeout.
+
+**An object config says so.** `withObject` sets `surface.type` to `object`; no built-in surface name is left beside the object.
+
+**Limits** (also in the manifest): no boolean cut or union; text wraps round parts only (cylinder, sphere, revolve, on the axis, kept
+round); one text block per object; materials are opaque (glass is dark and reflective, not see-through); the lighting is fixed.
+
+Rendered from this code: `docs/type-surface/constructed-objects.png` (tumbler, mug, steel tumbler, can, bottle, a vase with no recipe, a labelled bottle).
+
+## 9. Debug view
+
+The Debug tab shows the surface mesh, fold and roll lines, a deformation heat map, text bounds, baselines, surface normals,
+control points and a mapping-coordinate checker, and can switch shadows off. **MOVE TEXT** drags the text across the surface by picking the nearest sheet vertex.
+
+## 10. Known limits
+
+- Renders with WebGL2. Without it, the component says so and does not draw.
+- `next dev` returns 500 on this page, the same pre-existing CJS/React-Refresh bug as the neon page (DECISIONS §29). Use `next build && next start`.
+- From the straight-down camera, gentle relief (a shallow accordion) reads through shading only. Orbit (drag) to see it from the side.
+- A second fold over a stack is not strictly length-preserving on the inner layer (real stacked paper slips too).