@appinternalleads/ui 0.4.0 → 0.4.2

package/dist/esm/motion/typesurface/config.js

@@ -0,0 +1,280 @@
+import { sanitizeObject } from './construct';
+import { hasSurface } from './surfaces';
+export const TS_SURFACES = ['newspaper', 'paper', 'bottle', 'wrapper', 'fabric'];
+export const TS_TEXT_MATERIALS = ['ink', 'print', 'foil', 'emboss'];
+export const TS_BLEND_MODES = ['normal', 'multiply', 'screen', 'overlay', 'darken', 'lighten', 'color-burn', 'soft-light'];
+export const TS_ALIGNS = ['left', 'center', 'right'];
+export const TS_FOLD_ORIENTATIONS = ['vertical', 'horizontal'];
+export const TS_FOLD_DIRECTIONS = ['over', 'under'];
+export const TS_ROLL_EDGES = ['bottom', 'top', 'left', 'right'];
+export const TS_FOLD_SIDES = ['far', 'near'];
+/** The folds and the wraps, in the order they are applied. Up to four of each. */
+export const TS_FOLD_KEYS = ['fold', 'fold2', 'fold3', 'fold4'];
+export const TS_WRAP_KEYS = ['wrap1', 'wrap2', 'wrap3', 'wrap4'];
+export const TS_ANIMATABLE = ['wrap', 'morph', 'perspective', 'curve', 'fold', 'fold2', 'fold3', 'fold4', 'wrap1', 'wrap2', 'wrap3', 'wrap4', 'roll', 'crumple', 'wave', 'wrinkle', 'blend'];
+/** Where each animatable amount lives in the config. */
+export const TS_ANIMATABLE_PATHS = {
+    wrap: 'deformation.wrap', morph: 'deformation.morph', perspective: 'deformation.perspective', curve: 'deformation.curve',
+    fold: 'deformation.fold.amount', fold2: 'deformation.fold2.amount', fold3: 'deformation.fold3.amount', fold4: 'deformation.fold4.amount',
+    wrap1: 'deformation.wrap1.amount', wrap2: 'deformation.wrap2.amount', wrap3: 'deformation.wrap3.amount', wrap4: 'deformation.wrap4.amount', roll: 'deformation.roll.amount',
+    crumple: 'deformation.crumple.amount', wave: 'deformation.wave', wrinkle: 'deformation.wrinkle', blend: 'material.blend',
+};
+const FOLD_OFF = { amount: 0, position: 0.5, angle: 180, width: 0.035, influence: 0.7, orientation: 'vertical', direction: 'over', side: 'far' };
+const WRAP_OFF = { amount: 0, position: 0.7, radius: 0.06, angle: 300, orientation: 'vertical', direction: 'under', side: 'far' };
+/** Every transformation at rest: flat, floating, un-inked. States and presets start here. */
+export const REST_DEFORMATION = {
+    wrap: 0, morph: 0, perspective: 0, tiltX: 0, tiltY: 0, skew: 0, curve: 0,
+    fold: FOLD_OFF,
+    fold2: { ...FOLD_OFF, orientation: 'horizontal' },
+    fold3: { ...FOLD_OFF, position: 0.25 },
+    fold4: { ...FOLD_OFF, position: 0.25, orientation: 'horizontal' },
+    wrap1: WRAP_OFF,
+    wrap2: { ...WRAP_OFF, side: 'near', position: 0.3 },
+    wrap3: { ...WRAP_OFF, orientation: 'horizontal' },
+    wrap4: { ...WRAP_OFF, orientation: 'horizontal', side: 'near', position: 0.3 },
+    roll: { amount: 0, edge: 'bottom', radius: 0.085, direction: 'under' },
+    crumple: { amount: 0, scale: 1 },
+    wave: 0, wrinkle: 0,
+};
+export const DEFAULT_TYPE_SURFACE = {
+    version: 1,
+    text: 'BREAKING NEWS',
+    typography: {
+        fontFamily: "'Anton', 'Impact', sans-serif", fontWeight: 400, fontStyle: 'normal', fontSize: 128, letterSpacing: 2, lineHeight: 1,
+        align: 'center', color: '#E0271B', gradient: { enabled: false, from: '#E0271B', to: '#7A0C06', angle: 90 }, opacity: 1, blendMode: 'multiply',
+    },
+    placement: { x: 0.5, y: 0.34, rotation: 0, maxWidth: 900 },
+    surface: { type: 'newspaper', state: 'flat', seed: 7, color: null },
+    object: null,
+    deformation: { ...REST_DEFORMATION, wrap: 1 },
+    material: {
+        type: 'ink', blend: 0.75, inkStrength: 0.9, inkSpread: 0.35, inkRoughness: 0.4, paperInfluence: 0.75, grainInfluence: 0.5, halftone: 0,
+        displacement: 0.6, surfaceContrast: 1, lift: 0.1, shadow: 0.6, gloss: 0.1, emboss: 0.15,
+    },
+    view: { yaw: 0, pitch: 0, zoom: 1, roll: 0, autoCenter: true, motion: 1 },
+    animation: {
+        duration: 9000, loop: true,
+        stages: [
+            { key: 'wrap', start: 0.04, end: 0.24, easing: 'ease-in-out', label: 'wrap' },
+            { key: 'blend', start: 0.3, end: 0.62, easing: 'ease-in-out', label: 'print' },
+        ],
+    },
+};
+const n = (path, label, group, min, max, step, hint, unit) => ({ path, label, group, kind: 'number', min, max, step, hint, unit });
+const e = (path, label, group, options, hint) => ({ path, label, group, kind: 'enum', options, hint });
+const c = (path, label, group, hint) => ({ path, label, group, kind: 'color', hint });
+const b = (path, label, group, hint) => ({ path, label, group, kind: 'boolean', hint });
+const foldControls = (key, name) => [
+    n(`deformation.${key}.amount`, `${name} amount`, 'fold', 0, 1, 0.01, 'how far the fold has gone; the angle reached is angle × amount'),
+    n(`deformation.${key}.position`, `${name} position`, 'fold', 0.05, 0.95, 0.005, 'where the crease runs, across the surface'),
+    n(`deformation.${key}.angle`, `${name} angle`, 'fold', 0, 180, 1, 'the angle at full amount; 180 folds flat', '°'),
+    n(`deformation.${key}.width`, `${name} width`, 'fold', 0.004, 0.5, 0.001, 'the rounded crease, as a share of the width'),
+    n(`deformation.${key}.influence`, `${name} influence`, 'fold', 0, 1, 0.01, 'how strongly the crease shades the paper and the letters'),
+    e(`deformation.${key}.orientation`, `${name} orientation`, 'fold', TS_FOLD_ORIENTATIONS, 'a vertical crease folds left/right; horizontal folds top/bottom'),
+    e(`deformation.${key}.direction`, `${name} direction`, 'fold', TS_FOLD_DIRECTIONS, 'over lifts toward the camera; under tucks beneath'),
+    e(`deformation.${key}.side`, `${name} side`, 'fold', TS_FOLD_SIDES, 'which side moves: far = right/below the crease, near = left/above'),
+];
+const wrapControls = (key, name) => [
+    n(`deformation.${key}.amount`, `${name} amount`, 'wraps', 0, 1, 0.01, 'how far round the rod the sheet has wrapped'),
+    n(`deformation.${key}.position`, `${name} position`, 'wraps', 0.02, 0.98, 0.005, 'where the wrap starts, across the surface'),
+    n(`deformation.${key}.radius`, `${name} radius`, 'wraps', 0.01, 0.5, 0.005, 'the rod, as a share of the width'),
+    n(`deformation.${key}.angle`, `${name} angle`, 'wraps', 0, 360, 1, 'how far round at full amount; 360 goes all the way', '°'),
+    e(`deformation.${key}.orientation`, `${name} orientation`, 'wraps', TS_FOLD_ORIENTATIONS, 'vertical rod or horizontal rod'),
+    e(`deformation.${key}.direction`, `${name} direction`, 'wraps', TS_FOLD_DIRECTIONS, 'over wraps toward the camera; under wraps away'),
+    e(`deformation.${key}.side`, `${name} side`, 'wraps', TS_FOLD_SIDES, 'which side wraps: far = right/below, near = left/above'),
+];
+/** Every knob: path, range, unit and what it does. Validation, the playground and agents all read this. */
+export const TS_CONTROLS = [
+    { path: 'text', label: 'Text', group: 'text', kind: 'text', hint: 'any words; \\n breaks a line' },
+    { path: 'typography.fontFamily', label: 'Font family', group: 'typography', kind: 'text', hint: 'any CSS font-family list the page has loaded' },
+    n('typography.fontWeight', 'Weight', 'typography', 100, 900, 100, 'font weight'),
+    e('typography.fontStyle', 'Style', 'typography', ['normal', 'italic'], 'upright or italic'),
+    n('typography.fontSize', 'Size', 'typography', 12, 400, 1, 'surface units; the surface is 1000 wide', 'u'),
+    n('typography.letterSpacing', 'Letter spacing', 'typography', -40, 120, 1, 'extra space between letters', 'u'),
+    n('typography.lineHeight', 'Line height', 'typography', 0.6, 2.5, 0.01, 'line pitch as a multiple of the size'),
+    e('typography.align', 'Alignment', 'typography', TS_ALIGNS, 'how lines align in the block'),
+    c('typography.color', 'Colour', 'typography', 'the letters'),
+    b('typography.gradient.enabled', 'Gradient', 'typography', 'fill the letters with a two-colour gradient'),
+    c('typography.gradient.from', 'Gradient from', 'typography', 'first stop'),
+    c('typography.gradient.to', 'Gradient to', 'typography', 'last stop'),
+    n('typography.gradient.angle', 'Gradient angle', 'typography', 0, 360, 1, '0 runs left → right; 90 runs top → bottom', '°'),
+    n('typography.opacity', 'Opacity', 'typography', 0, 1, 0.01, 'of the letters'),
+    e('typography.blendMode', 'Blend mode', 'typography', TS_BLEND_MODES, 'how the letters combine with the surface once printed'),
+    n('placement.x', 'Position X', 'placement', 0, 1, 0.001, 'centre of the text, 0–1 across the surface'),
+    n('placement.y', 'Position Y', 'placement', 0, 1, 0.001, 'centre of the text, 0–1 down the surface'),
+    n('placement.rotation', 'Rotation', 'placement', -180, 180, 0.5, 'on the surface, clockwise', '°'),
+    n('placement.maxWidth', 'Max width', 'placement', 0, 1000, 5, 'lines wrap past this width; 0 never wraps', 'u'),
+    e('surface.type', 'Surface', 'surface', TS_SURFACES, 'what the text meets'),
+    { path: 'surface.state', label: 'State', group: 'surface', kind: 'text', hint: 'a named state of the surface (flat, folded, crumpled…)' },
+    n('surface.seed', 'Seed', 'surface', 0, 99999, 1, 'every crease, wrinkle, photo and line of copy'),
+    n('deformation.wrap', 'Wrap', 'deformation', 0, 1, 0.01, 'floating typography → conformed to the surface'),
+    n('deformation.morph', 'Morph', 'deformation', 0, 1, 0.01, 'letters peel off and land one at a time'),
+    n('deformation.perspective', 'Perspective', 'deformation', 0, 1, 0.01, 'from straight above to a low, wide-angle view'),
+    n('deformation.tiltX', 'Horizontal distortion', 'deformation', -1, 1, 0.01, 'turns the object left/right'),
+    n('deformation.tiltY', 'Vertical distortion', 'deformation', -1, 1, 0.01, 'tips the object toward/away'),
+    n('deformation.skew', 'Skew', 'deformation', -1, 1, 0.01, 'shears the surface in its own plane'),
+    n('deformation.curve', 'Curve', 'deformation', 0, 1, 0.01, 'cylindrical curvature: a label on a bottle, a bent plate, an inflated pack'),
+    ...foldControls('fold', 'Fold'),
+    ...foldControls('fold2', 'Second fold'),
+    ...foldControls('fold3', 'Third fold'),
+    ...foldControls('fold4', 'Fourth fold'),
+    ...wrapControls('wrap1', 'Wrap 1'),
+    ...wrapControls('wrap2', 'Wrap 2'),
+    ...wrapControls('wrap3', 'Wrap 3'),
+    ...wrapControls('wrap4', 'Wrap 4'),
+    n('deformation.roll.amount', 'Roll', 'deformation', 0, 1, 0.01, 'rolls the surface up from one edge'),
+    e('deformation.roll.edge', 'Roll from', 'deformation', TS_ROLL_EDGES, 'the edge that rolls first'),
+    n('deformation.roll.radius', 'Roll radius', 'deformation', 0.03, 0.3, 0.005, 'outer radius of the roll, as a share of the width'),
+    e('deformation.roll.direction', 'Roll direction', 'deformation', TS_FOLD_DIRECTIONS, 'under keeps the printed side outside'),
+    n('deformation.crumple.amount', 'Crumple', 'deformation', 0, 1, 0.01, 'creased facets; past 0.6 the sheet is crushed'),
+    n('deformation.crumple.scale', 'Crumple scale', 'deformation', 0.4, 2.5, 0.01, 'size of the facets'),
+    n('deformation.wave', 'Wave', 'deformation', 0, 1, 0.01, 'soft waves: fabric drape, a rippled pane'),
+    n('deformation.wrinkle', 'Wrinkle', 'deformation', 0, 1, 0.01, 'fine wrinkles: film, creased cloth'),
+    e('material.type', 'Material', 'material', TS_TEXT_MATERIALS, 'how the letters join the surface'),
+    n('material.blend', 'Blend', 'material', 0, 1, 0.01, 'floating → lit by the surface → printed → embedded'),
+    n('material.inkStrength', 'Ink strength', 'material', 0, 1, 0.01, 'how dark and saturated the ink prints'),
+    n('material.inkSpread', 'Ink spread', 'material', 0, 1, 0.01, 'ink bleeding into the fibres'),
+    n('material.inkRoughness', 'Ink roughness', 'material', 0, 1, 0.01, 'ragged, uneven ink edges'),
+    n('material.paperInfluence', 'Paper influence', 'material', 0, 1, 0.01, 'how much of the surface colour shows through'),
+    n('material.grainInfluence', 'Grain influence', 'material', 0, 1, 0.01, 'paper grain breaking up the ink'),
+    n('material.halftone', 'Halftone', 'material', 0, 1, 0.01, 'embedded ink becomes a printing screen'),
+    n('material.displacement', 'Displacement', 'material', 0, 4, 0.05, 'ink misregistration, surface units', 'u'),
+    n('material.surfaceContrast', 'Surface contrast', 'material', 0, 1.5, 0.01, 'how much surface light and shadow fall on the letters'),
+    n('material.lift', 'Float height', 'material', 0, 0.4, 0.005, 'how high floating letters hover'),
+    n('material.shadow', 'Float shadow', 'material', 0, 1, 0.01, 'the shadow the letters cast while floating'),
+    n('material.gloss', 'Gloss', 'material', 0, 1, 0.01, 'varnish on the letters'),
+    n('material.emboss', 'Emboss', 'material', 0, 1, 0.01, 'relief depth'),
+    n('view.yaw', 'Orbit', 'view', -180, 180, 0.5, 'camera left/right', '°'),
+    n('view.pitch', 'Tilt', 'view', -30, 60, 0.5, 'camera tilt, added to perspective', '°'),
+    n('view.zoom', 'Zoom', 'view', 0.4, 3, 0.01, '1 fills the frame'),
+    n('view.roll', 'Object angle', 'view', -180, 180, 0.5, 'turns the object on the table', '°'),
+    b('view.autoCenter', 'Auto-centre', 'view', 'keep the object centred while it folds and rolls'),
+    n('view.motion', 'Ambient motion', 'view', 0, 2, 0.01, 'time-driven motion: fabric in a breeze, a bottle turning'),
+    n('animation.duration', 'Length', 'animation', 1000, 60000, 100, 'one pass of the timeline', 'ms'),
+    b('animation.loop', 'Loop', 'animation', 'play again from the start'),
+];
+export const MAX_TS_TEXT_LENGTH = 160;
+const isObj = (v) => typeof v === 'object' && v !== null && !Array.isArray(v);
+export const isHexColor = (v) => typeof v === 'string' && /^#(?:[0-9a-f]{3}|[0-9a-f]{6})$/i.test(v);
+export function getPath(obj, path) {
+    return path.split('.').reduce((o, k) => (isObj(o) ? o[k] : undefined), obj);
+}
+export function setPath(obj, path, value) {
+    const [head, ...rest] = path.split('.');
+    const o = (isObj(obj) ? obj : {});
+    return { ...o, [head]: rest.length ? setPath(o[head], rest.join('.'), value) : value };
+}
+/** Deep merge of plain objects; arrays and scalars in `over` replace. */
+function merge(base, over) {
+    if (!isObj(base) || !isObj(over))
+        return (over === undefined ? base : over);
+    const out = { ...base };
+    // An object replaces the one before it: merging two part lists means nothing.
+    for (const [k, v] of Object.entries(over))
+        out[k] = v === undefined ? out[k] : k === 'object' ? v : merge(base[k], v);
+    return out;
+}
+/** Defaults ← input. Pure; does not validate (see `validateTypeSurface` / `sanitizeTypeSurface`). */
+export function resolveTypeSurface(input = {}, base = DEFAULT_TYPE_SURFACE) {
+    return merge(base, input);
+}
+function checkControl(ctl, v) {
+    switch (ctl.kind) {
+        case 'number':
+            if (typeof v !== 'number' || !Number.isFinite(v))
+                return `${ctl.label} must be a number.`;
+            if (v < ctl.min || v > ctl.max)
+                return `${ctl.label} must be between ${ctl.min} and ${ctl.max}.`;
+            return null;
+        case 'enum':
+            if (ctl.path === 'surface.type' && typeof v === 'string' && hasSurface(v))
+                return null;
+            return ctl.options.includes(v) ? null : `${ctl.label} must be one of: ${ctl.options.join(', ')}.`;
+        case 'color': return isHexColor(v) ? null : `${ctl.label} must be a hex colour like #E0271B.`;
+        case 'boolean': return typeof v === 'boolean' ? null : `${ctl.label} must be true or false.`;
+        case 'text':
+            if (typeof v !== 'string')
+                return `${ctl.label} must be text.`;
+            if (ctl.path === 'text' && v.length > MAX_TS_TEXT_LENGTH)
+                return `Text is limited to ${MAX_TS_TEXT_LENGTH} characters.`;
+            if (ctl.path === 'typography.fontFamily' && !v.trim())
+                return 'Font family must name a font.';
+            return null;
+    }
+}
+function checkStages(stages) {
+    if (!Array.isArray(stages))
+        return [{ path: 'animation.stages', message: 'Stages must be a list.' }];
+    const errors = [];
+    stages.forEach((s, i) => {
+        const p = `animation.stages.${i}`;
+        if (!isObj(s)) {
+            errors.push({ path: p, message: 'A stage must be an object.' });
+            return;
+        }
+        if (!TS_ANIMATABLE.includes(s.key))
+            errors.push({ path: `${p}.key`, message: `A stage drives one of: ${TS_ANIMATABLE.join(', ')}.` });
+        const t = (k) => typeof s[k] === 'number' && Number.isFinite(s[k]) && s[k] >= 0 && s[k] <= 1;
+        if (!t('start') || !t('end'))
+            errors.push({ path: p, message: 'start and end are 0–1 of the timeline.' });
+        else if (s.end < s.start)
+            errors.push({ path: p, message: 'end must not come before start.' });
+        if ((s.outStart !== undefined || s.outEnd !== undefined)) {
+            if (!t('outStart') || !t('outEnd'))
+                errors.push({ path: p, message: 'outStart and outEnd are 0–1 of the timeline.' });
+            else if (s.outEnd < s.outStart || s.outStart < s.end)
+                errors.push({ path: p, message: 'A stage goes out after it comes in: end ≤ outStart ≤ outEnd.' });
+        }
+    });
+    return errors;
+}
+/** `[]` when the config can be drawn; otherwise every problem as `{ path, message }`. Never throws. */
+export function validateTypeSurface(config) {
+    if (!isObj(config))
+        return [{ path: '', message: 'The config must be an object.' }];
+    const errors = [];
+    const built = config.object !== undefined && config.object !== null;
+    for (const ctl of TS_CONTROLS) {
+        // `surface.type: 'object'` says the object is the surface; it needs one.
+        if (ctl.path === 'surface.type' && config.surface && config.surface.type === 'object') {
+            if (!built)
+                errors.push({ path: ctl.path, message: 'Surface is “object” but the config has no object.' });
+            continue;
+        }
+        const msg = checkControl(ctl, getPath(config, ctl.path));
+        if (msg)
+            errors.push({ path: ctl.path, message: msg });
+    }
+    errors.push(...checkStages(getPath(config, 'animation.stages')));
+    if (built)
+        errors.push(...sanitizeObject(config.object).errors);
+    return errors;
+}
+/**
+ * A config that always draws: every invalid field is replaced by its default and named in
+ * `invalid`. The renderer draws the result and the playground lists what it replaced.
+ */
+export function sanitizeTypeSurface(input) {
+    let config = resolveTypeSurface(isObj(input) ? input : {});
+    const invalid = [];
+    // An object is repaired as a whole: numbers clamped, bad parts dropped, null if nothing can be drawn.
+    if (config.object !== null) {
+        const fixed = sanitizeObject(config.object);
+        if (fixed.errors.length) {
+            config = { ...config, object: fixed.object };
+            invalid.push(...fixed.errors.map((e) => e.path));
+        }
+    }
+    for (const err of validateTypeSurface(config)) {
+        if (err.path.startsWith('animation.stages')) {
+            config = { ...config, animation: { ...config.animation, stages: [] } };
+            if (!invalid.includes('animation.stages'))
+                invalid.push('animation.stages');
+            continue;
+        }
+        config = setPath(config, err.path, getPath(DEFAULT_TYPE_SURFACE, err.path));
+        invalid.push(err.path);
+    }
+    return { config, invalid };
+}
+//# sourceMappingURL=config.js.map

package/dist/esm/motion/typesurface/config.js.map

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

package/dist/esm/motion/typesurface/construct.d.ts

@@ -0,0 +1,284 @@
+/**
+ * **The construction layer** — objects built from parts, not a catalogue of finished objects.
+ *
+ *   primitives     cylinder, sphere, ring, revolve (any profile), tube (along a path), box
+ *   manipulators   taper, flare, bulge, twist, bend, scale: applied to a part, in order
+ *   materials      plastic, matte, ceramic, glass, metal, chrome, in any colour
+ *   text           wraps one round part: printed straight onto it, or on a paper label
+ *   recipes        tumbler, mug, can, bottle: compositions of the above, nothing they alone can do
+ *
+ * An object is JSON (`TSObjectSpec`) and lives in the config as `object`, so what an agent builds
+ * is a preset it can save and edit later. `describeConstruction()` is the machine-readable
+ * manifest: every primitive, what can be done to it, and every parameter with its range, so an
+ * agent composes a tumbler (cylinder + taper + ring) without one having been written for it.
+ * `sanitizeObject` reads the same manifest: it never throws and always returns something drawable.
+ *
+ * Frame: y is up and is the object's axis; x is to the right of the camera, z toward it. Units are
+ * the lab's world units (the wine bottle's body is 0.36 in radius); the camera frames whatever is
+ * built. Pure; no DOM, no React.
+ */
+import { type Vec3 } from './ops';
+export type TSParam = {
+    type: 'number';
+    min: number;
+    max: number;
+    default: number;
+    unit?: string;
+    hint: string;
+} | {
+    type: 'boolean';
+    default: boolean;
+    hint: string;
+} | {
+    type: 'enum';
+    options: readonly string[];
+    default: string;
+    hint: string;
+}
+/** A list of points: `dims` numbers each, at least `min` of them. */
+ | {
+    type: 'points';
+    dims: 2 | 3;
+    min: number;
+    max: number;
+    hint: string;
+};
+export declare const TS_MANIPULATOR_IDS: readonly ["taper", "flare", "bulge", "twist", "bend", "scale"];
+export type TSManipulatorId = (typeof TS_MANIPULATOR_IDS)[number];
+/** What can be done to a part. Each acts in the part's own frame, before it is turned and placed. */
+export declare const TS_MANIPULATORS: Record<TSManipulatorId, {
+    summary: string;
+    keepsRound: boolean;
+    params: Record<string, TSParam>;
+}>;
+export declare const TS_PRIMITIVE_IDS: readonly ["cylinder", "sphere", "ring", "revolve", "tube", "box"];
+export type TSPrimitiveId = (typeof TS_PRIMITIVE_IDS)[number];
+/** A manipulator a primitive accepts, plus `material` (every part) and `text-wrap` (it can carry the text). */
+export type TSCapability = TSManipulatorId | 'material' | 'text-wrap';
+/** What an object is built from. `origin` says where `at` puts the part. */
+export declare const TS_PRIMITIVES: Record<TSPrimitiveId, {
+    summary: string;
+    origin: 'base' | 'centre' | 'path';
+    capabilities: readonly TSCapability[];
+    params: Record<string, TSParam>;
+}>;
+export declare const TS_OBJECT_MATERIAL_IDS: readonly ["plastic", "matte", "ceramic", "glass", "metal", "chrome"];
+export type TSObjectMaterialId = (typeof TS_OBJECT_MATERIAL_IDS)[number];
+/** How a part shades. `metalness` tints the reflection with the colour; `reflection` is how much of the studio it shows. */
+export declare const TS_OBJECT_MATERIALS: Record<TSObjectMaterialId, {
+    summary: string;
+    metalness: number;
+    roughness: number;
+    reflection: number;
+    gain: number;
+}>;
+export declare const TS_OBJECT_TABLES: readonly ["studio", "desk", "wood"];
+export type TSOp = {
+    op: TSManipulatorId;
+} & Record<string, number | string>;
+export type TSPartMaterial = {
+    type: TSObjectMaterialId;
+    color: string;
+    /** Override the material's own roughness / metalness, 0–1. */
+    roughness?: number;
+    metalness?: number;
+};
+export type TSPart = {
+    /** Unique within the object; `text.on` names one. */
+    id: string;
+    shape: TSPrimitiveId;
+    /** The primitive's parameters (`TS_PRIMITIVES[shape].params`); anything omitted takes its default. */
+    params: Record<string, unknown>;
+    /** Manipulators, applied in order. */
+    ops: TSOp[];
+    material: TSPartMaterial;
+    /** Where the part goes, in the object's frame. */
+    at: [number, number, number];
+    /** Degrees about x, then y, then z. */
+    rotate: [number, number, number];
+};
+export type TSObjectText = {
+    /** The part the text wraps. It must be round, on the axis and unturned. */
+    on: string;
+    /** Centre of the text area along the part's height, 0 bottom – 1 top. */
+    y: number;
+    /** Height of the text area, as a share of the part's height. */
+    height: number;
+    /** How far round the part the text area reaches, degrees (360 goes all the way). */
+    arc: number;
+    /** A paper label in this colour; null prints straight onto the part. */
+    label: string | null;
+};
+export type TSObjectSpec = {
+    name: string;
+    parts: TSPart[];
+    text: TSObjectText;
+    scene: {
+        table: (typeof TS_OBJECT_TABLES)[number];
+        backdrop: [string, string];
+    };
+};
+export declare const TS_OBJECT_TEXT_PARAMS: Record<'y' | 'height' | 'arc', TSParam>;
+export declare const MAX_OBJECT_PARTS = 24;
+/** How much of a round part's circumference reads from the front, degrees: text wider than this runs out of sight. */
+export declare const OBJECT_FRONT_ARC = 110;
+export type TSObjectError = {
+    path: string;
+    message: string;
+};
+/**
+ * A spec that always builds: every bad field is replaced (numbers are clamped, the rest take their
+ * default, parts and manipulators that make no sense are dropped) and named in `errors`. Returns
+ * `object: null` only when nothing in it can be drawn.
+ */
+export declare function sanitizeObject(input: unknown, base?: string): {
+    object: TSObjectSpec | null;
+    errors: TSObjectError[];
+};
+/** `[]` when the spec is drawable as written; otherwise every problem as `{ path, message }`. Never throws. */
+export declare function validateObject(spec: unknown, base?: string): TSObjectError[];
+export type ResolvedMaterial = {
+    color: string;
+    metalness: number;
+    roughness: number;
+    reflection: number;
+    gain: number;
+};
+/** One part's triangles in the object's index buffer, and how they shade. */
+export type PartRange = {
+    id: string;
+    start: number;
+    count: number;
+    material: ResolvedMaterial;
+};
+export type BuiltObject = {
+    positions: Float32Array;
+    normals: Float32Array;
+    indices: Uint32Array;
+    count: number;
+    ranges: PartRange[];
+    bounds: {
+        min: Vec3;
+        max: Vec3;
+    };
+    /** The part that carries the text: its extent along y and its outer radius at any height. */
+    host: {
+        id: string;
+        y0: number;
+        y1: number;
+        radiusAt: (y: number) => number;
+        color: string;
+    };
+};
+export declare function resolveMaterial(m: TSPartMaterial): ResolvedMaterial;
+/**
+ * Build a spec into one mesh in the object's frame: every part through its manipulators, turned and
+ * placed, with smooth normals and a triangle range per part. The spec is repaired first (omitted
+ * parameters take their defaults); it throws only when nothing in it can be drawn.
+ */
+export declare function buildObject(input: TSObjectSpec): BuiltObject;
+export type TSRecipeOptions = {
+    color?: string;
+    material?: TSObjectMaterialId;
+    accent?: string;
+    label?: string | null;
+};
+/**
+ * Semantic starting points. A recipe is only a composition of the primitives and manipulators above,
+ * returned as a plain spec to edit: nothing here is special-cased anywhere else, so an object with
+ * no recipe is built the same way, part by part.
+ */
+export declare const TS_RECIPES: Record<string, {
+    summary: string;
+    composition: string;
+    build: (o?: TSRecipeOptions) => TSObjectSpec;
+}>;
+/** A recipe's spec, ready to edit; unknown names fall back to a plain cylinder so something always draws. */
+export declare function createObject(recipe: string, options?: TSRecipeOptions): TSObjectSpec;
+/**
+ * Everything an agent needs to compose an object, as JSON: the primitives and what each can take,
+ * the manipulators, the materials, how text attaches, the recipes and what cannot be done.
+ */
+export declare function describeConstruction(): {
+    frame: string;
+    part: {
+        shape: string;
+        origin: {
+            base: string;
+            centre: string;
+            path: string;
+        };
+    };
+    primitives: Record<"box" | "ring" | "tube" | "cylinder" | "sphere" | "revolve", {
+        summary: string;
+        origin: "base" | "centre" | "path";
+        capabilities: readonly TSCapability[];
+        params: Record<string, TSParam>;
+    }>;
+    manipulators: Record<"scale" | "taper" | "flare" | "bulge" | "twist" | "bend", {
+        summary: string;
+        keepsRound: boolean;
+        params: Record<string, TSParam>;
+    }>;
+    materials: Record<"glass" | "plastic" | "matte" | "ceramic" | "metal" | "chrome", {
+        summary: string;
+        metalness: number;
+        roughness: number;
+        reflection: number;
+        gain: number;
+    }>;
+    text: {
+        summary: string;
+        params: Record<"y" | "height" | "arc", TSParam>;
+        label: string;
+        carriers: ("box" | "ring" | "tube" | "cylinder" | "sphere" | "revolve")[];
+        sizing: {
+            unit: string;
+            frontArc: number;
+            rule: string;
+            helper: string;
+        };
+        rules: string[];
+    };
+    scene: {
+        table: readonly ["studio", "desk", "wood"];
+        backdrop: string;
+    };
+    view: {
+        summary: string;
+        states: {
+            wrapped: string;
+            lying: string;
+            turned: string;
+            tipped: string;
+        };
+        apply: string;
+        controls: {
+            'deformation.tiltX': string;
+            'deformation.tiltY': string;
+            'view.roll': string;
+            'view.zoom': string;
+        };
+        avoid: string;
+    };
+    recipes: {
+        [k: string]: {
+            summary: string;
+            composition: string;
+            defaults: {
+                color: string;
+                material: "glass" | "plastic" | "matte" | "ceramic" | "metal" | "chrome";
+                label: null;
+            };
+            options: {
+                color: string;
+                material: string;
+                accent: string;
+                label: string;
+            };
+            use: string;
+        };
+    };
+    limits: string[];
+};
+//# sourceMappingURL=construct.d.ts.map

package/dist/esm/motion/typesurface/construct.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"construct.d.ts","sourceRoot":"","sources":["../../../../src/motion/typesurface/construct.ts"],"names":[],"mappings":"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"}