@12ui/design 0.2.70 → 0.2.72

package/dist/scene/seeded-random.d.ts

@@ -0,0 +1,20 @@
+/**
+ * A small seeded PRNG for the scene solvers' multistart.
+ *
+ * The camera and rectangle solves draw hundreds of random starting points and
+ * keep the best local minimum. Their answer must not depend on the draw (the
+ * Python solver gave the identical camera for five different seeds), but a
+ * fixed seed keeps two runs of the same spec byte-identical, which is what
+ * makes a parity fixture meaningful. sfc32 is fast, has a 128-bit state and no
+ * short cycles for any seed.
+ */
+export type SeededRandom = {
+    /** Uniform in [0, 1). */
+    next: () => number;
+    /** Uniform in [low, high). */
+    uniform: (low: number, high: number) => number;
+    /** Standard normal (Box-Muller, the spare value is kept for the next call). */
+    normal: () => number;
+};
+export declare const seededRandom: (seed: number) => SeededRandom;
+//# sourceMappingURL=seeded-random.d.ts.map

package/dist/scene/seeded-random.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seeded-random.d.ts","sourceRoot":"","sources":["../../src/scene/seeded-random.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,yBAAyB;IACzB,IAAI,EAAE,MAAM,MAAM,CAAC;IACnB,8BAA8B;IAC9B,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAC/C,+EAA+E;IAC/E,MAAM,EAAE,MAAM,MAAM,CAAC;CACtB,CAAC;AAEF,eAAO,MAAM,YAAY,GAAI,MAAM,MAAM,KAAG,YAmC3C,CAAC"}

package/dist/scene/seeded-random.js

@@ -0,0 +1,42 @@
+export const seededRandom = (seed) => {
+    let a = 0x9e3779b9 ^ (seed >>> 0);
+    let b = 0x243f6a88 ^ Math.imul(seed >>> 0, 0x85ebca6b);
+    let c = 0xb7e15162;
+    let d = 1;
+    const next = () => {
+        a >>>= 0;
+        b >>>= 0;
+        c >>>= 0;
+        d >>>= 0;
+        const t = (a + b + d) >>> 0;
+        d = (d + 1) >>> 0;
+        a = b ^ (b >>> 9);
+        b = (c + (c << 3)) >>> 0;
+        c = (c << 21) | (c >>> 11);
+        c = (c + t) >>> 0;
+        return t / 4294967296;
+    };
+    // Discard the warm-up outputs so nearby seeds decorrelate.
+    for (let index = 0; index < 16; index += 1)
+        next();
+    let spare = null;
+    return {
+        next,
+        uniform: (low, high) => low + (high - low) * next(),
+        normal: () => {
+            if (spare !== null) {
+                const value = spare;
+                spare = null;
+                return value;
+            }
+            let u = 0;
+            while (u <= Number.EPSILON)
+                u = next();
+            const v = next();
+            const radius = Math.sqrt(-2 * Math.log(u));
+            spare = radius * Math.sin(2 * Math.PI * v);
+            return radius * Math.cos(2 * Math.PI * v);
+        },
+    };
+};
+//# sourceMappingURL=seeded-random.js.map

package/dist/scene/seeded-random.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seeded-random.js","sourceRoot":"","sources":["../../src/scene/seeded-random.ts"],"names":[],"mappings":"AAmBA,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,IAAY,EAAgB,EAAE;IACzD,IAAI,CAAC,GAAG,UAAU,GAAG,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC;IAClC,IAAI,CAAC,GAAG,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,EAAE,UAAU,CAAC,CAAC;IACvD,IAAI,CAAC,GAAG,UAAU,CAAC;IACnB,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,MAAM,IAAI,GAAG,GAAW,EAAE;QACxB,CAAC,MAAM,CAAC,CAAC;QAAC,CAAC,MAAM,CAAC,CAAC;QAAC,CAAC,MAAM,CAAC,CAAC;QAAC,CAAC,MAAM,CAAC,CAAC;QACvC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;QAClB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;QAClB,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QACzB,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QAC3B,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;QAClB,OAAO,CAAC,GAAG,UAAU,CAAC;IACxB,CAAC,CAAC;IACF,2DAA2D;IAC3D,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,EAAE,EAAE,KAAK,IAAI,CAAC;QAAE,IAAI,EAAE,CAAC;IACnD,IAAI,KAAK,GAAkB,IAAI,CAAC;IAChC,OAAO;QACL,IAAI;QACJ,OAAO,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,GAAG,IAAI,EAAE;QACnD,MAAM,EAAE,GAAG,EAAE;YACX,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBACnB,MAAM,KAAK,GAAG,KAAK,CAAC;gBACpB,KAAK,GAAG,IAAI,CAAC;gBACb,OAAO,KAAK,CAAC;YACf,CAAC;YACD,IAAI,CAAC,GAAG,CAAC,CAAC;YACV,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO;gBAAE,CAAC,GAAG,IAAI,EAAE,CAAC;YACvC,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC;YACjB,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YAC3C,KAAK,GAAG,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;YAC3C,OAAO,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;QAC5C,CAAC;KACF,CAAC;AACJ,CAAC,CAAC"}

package/dist/scene/spec-expression.d.ts

@@ -0,0 +1,25 @@
+/**
+ * A safe compiler for the maths a camera spec writes in its world coordinates.
+ *
+ * Specs written for the Python solver use Python expression syntax ("D/2",
+ * "-0.5*cos(t)+D/2*sin(t)", "W**2"), which Python evaluated with `eval`. This
+ * accepts exactly the arithmetic subset: numbers, the spec's free names, the
+ * constants pi e tau inf nan, `+ - * / // % **`, unary signs, parentheses, and
+ * calls to the math functions below. Anything else (attribute access, strings,
+ * subscripts, unknown names) is refused with the landmark and the offending
+ * token named, before any solve starts.
+ */
+export type CompiledExpression = (values: ArrayLike<number>) => number;
+export declare class SpecExpressionError extends Error {
+    constructor(message: string);
+}
+export declare const SPEC_MATH_FUNCTIONS: readonly string[];
+/**
+ * Compiles one coordinate expression. `names` are the spec's free names in the
+ * order the solver passes their values; a free name shadows a constant or
+ * function of the same spelling, as it did in the Python evaluator.
+ */
+export declare const compileSpecExpression: (source: string, names: readonly string[], where: string) => CompiledExpression;
+/** A spec coordinate: a JSON number, or an expression string. */
+export declare const compileSpecCoordinate: (value: unknown, names: readonly string[], where: string) => CompiledExpression;
+//# sourceMappingURL=spec-expression.d.ts.map

package/dist/scene/spec-expression.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-expression.d.ts","sourceRoot":"","sources":["../../src/scene/spec-expression.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,KAAK,MAAM,CAAC;AAEvE,qBAAa,mBAAoB,SAAQ,KAAK;gBAChC,OAAO,EAAE,MAAM;CAI5B;AAqDD,eAAO,MAAM,mBAAmB,EAAE,SAAS,MAAM,EAAgC,CAAC;AA2ClF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,GAChC,QAAQ,MAAM,EACd,OAAO,SAAS,MAAM,EAAE,EACxB,OAAO,MAAM,KACZ,kBAsHF,CAAC;AAEF,iEAAiE;AACjE,eAAO,MAAM,qBAAqB,GAChC,OAAO,OAAO,EACd,OAAO,SAAS,MAAM,EAAE,EACxB,OAAO,MAAM,KACZ,kBAIF,CAAC"}

package/dist/scene/spec-expression.js

@@ -0,0 +1,234 @@
+/**
+ * A safe compiler for the maths a camera spec writes in its world coordinates.
+ *
+ * Specs written for the Python solver use Python expression syntax ("D/2",
+ * "-0.5*cos(t)+D/2*sin(t)", "W**2"), which Python evaluated with `eval`. This
+ * accepts exactly the arithmetic subset: numbers, the spec's free names, the
+ * constants pi e tau inf nan, `+ - * / // % **`, unary signs, parentheses, and
+ * calls to the math functions below. Anything else (attribute access, strings,
+ * subscripts, unknown names) is refused with the landmark and the offending
+ * token named, before any solve starts.
+ */
+export class SpecExpressionError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'SpecExpressionError';
+    }
+}
+const pythonMod = (a, b) => {
+    if (b === 0)
+        return Number.NaN;
+    const r = a % b;
+    return r !== 0 && (r < 0) !== (b < 0) ? r + b : r;
+};
+const MATH_FUNCTIONS = {
+    sin: { arity: [1, 1], apply: Math.sin },
+    cos: { arity: [1, 1], apply: Math.cos },
+    tan: { arity: [1, 1], apply: Math.tan },
+    asin: { arity: [1, 1], apply: Math.asin },
+    acos: { arity: [1, 1], apply: Math.acos },
+    atan: { arity: [1, 1], apply: Math.atan },
+    atan2: { arity: [2, 2], apply: Math.atan2 },
+    sinh: { arity: [1, 1], apply: Math.sinh },
+    cosh: { arity: [1, 1], apply: Math.cosh },
+    tanh: { arity: [1, 1], apply: Math.tanh },
+    asinh: { arity: [1, 1], apply: Math.asinh },
+    acosh: { arity: [1, 1], apply: Math.acosh },
+    atanh: { arity: [1, 1], apply: Math.atanh },
+    exp: { arity: [1, 1], apply: Math.exp },
+    exp2: { arity: [1, 1], apply: (x) => 2 ** x },
+    expm1: { arity: [1, 1], apply: Math.expm1 },
+    log: { arity: [1, 2], apply: (x, base) => (base === undefined ? Math.log(x) : Math.log(x) / Math.log(base)) },
+    log10: { arity: [1, 1], apply: Math.log10 },
+    log2: { arity: [1, 1], apply: Math.log2 },
+    log1p: { arity: [1, 1], apply: Math.log1p },
+    sqrt: { arity: [1, 1], apply: Math.sqrt },
+    cbrt: { arity: [1, 1], apply: Math.cbrt },
+    pow: { arity: [2, 2], apply: (x, y) => x ** y },
+    fabs: { arity: [1, 1], apply: Math.abs },
+    floor: { arity: [1, 1], apply: Math.floor },
+    ceil: { arity: [1, 1], apply: Math.ceil },
+    trunc: { arity: [1, 1], apply: Math.trunc },
+    degrees: { arity: [1, 1], apply: (x) => (x * 180) / Math.PI },
+    radians: { arity: [1, 1], apply: (x) => (x * Math.PI) / 180 },
+    hypot: { arity: [1, 64], apply: Math.hypot },
+    copysign: { arity: [2, 2], apply: (x, y) => (Object.is(Math.sign(y), -0) || y < 0 ? -Math.abs(x) : Math.abs(x)) },
+    fmod: { arity: [2, 2], apply: (x, y) => x % y },
+};
+const CONSTANTS = {
+    pi: Math.PI,
+    e: Math.E,
+    tau: 2 * Math.PI,
+    inf: Number.POSITIVE_INFINITY,
+    nan: Number.NaN,
+};
+export const SPEC_MATH_FUNCTIONS = Object.keys(MATH_FUNCTIONS);
+const tokenize = (source, where) => {
+    const tokens = [];
+    let index = 0;
+    while (index < source.length) {
+        const rest = source.slice(index);
+        const space = /^\s+/u.exec(rest);
+        if (space) {
+            index += space[0].length;
+            continue;
+        }
+        const number = /^(?:\d+\.?\d*|\.\d+)(?:[eE][+-]?\d+)?/u.exec(rest);
+        if (number) {
+            tokens.push({ kind: 'number', value: Number(number[0]), text: number[0] });
+            index += number[0].length;
+            continue;
+        }
+        const name = /^[A-Za-z_][A-Za-z0-9_]*/u.exec(rest);
+        if (name) {
+            tokens.push({ kind: 'name', text: name[0] });
+            index += name[0].length;
+            continue;
+        }
+        const op = /^(?:\*\*|\/\/|[-+*/%(),])/u.exec(rest);
+        if (op) {
+            tokens.push({ kind: 'op', text: op[0] });
+            index += op[0].length;
+            continue;
+        }
+        throw new SpecExpressionError(`${where}: "${source}" uses ${JSON.stringify(rest[0])}, which a spec expression cannot contain.`
+            + ' Use numbers, the free names, + - * / // % **, parentheses and math functions.');
+    }
+    return tokens;
+};
+/**
+ * Compiles one coordinate expression. `names` are the spec's free names in the
+ * order the solver passes their values; a free name shadows a constant or
+ * function of the same spelling, as it did in the Python evaluator.
+ */
+export const compileSpecExpression = (source, names, where) => {
+    const tokens = tokenize(source, where);
+    let position = 0;
+    const peek = () => tokens[position];
+    const isOp = (text) => {
+        const token = peek();
+        return token?.kind === 'op' && token.text === text;
+    };
+    const fail = (detail) => {
+        throw new SpecExpressionError(`${where}: "${source}" ${detail}`);
+    };
+    const expect = (text) => {
+        if (!isOp(text))
+            fail(`expects ${JSON.stringify(text)} at ${describe(peek())}`);
+        position += 1;
+    };
+    const describe = (token) => (token ? JSON.stringify(token.text) : 'the end');
+    const expression = () => {
+        let left = term();
+        while (isOp('+') || isOp('-')) {
+            const op = peek().text;
+            position += 1;
+            const right = term();
+            const l = left;
+            left = op === '+' ? (v) => l(v) + right(v) : (v) => l(v) - right(v);
+        }
+        return left;
+    };
+    const term = () => {
+        let left = unary();
+        while (isOp('*') || isOp('/') || isOp('//') || isOp('%')) {
+            const op = peek().text;
+            position += 1;
+            const right = unary();
+            const l = left;
+            left = op === '*' ? (v) => l(v) * right(v)
+                : op === '/' ? (v) => l(v) / right(v)
+                    : op === '//' ? (v) => Math.floor(l(v) / right(v))
+                        : (v) => pythonMod(l(v), right(v));
+        }
+        return left;
+    };
+    const unary = () => {
+        if (isOp('-')) {
+            position += 1;
+            const operand = unary();
+            return (v) => -operand(v);
+        }
+        if (isOp('+')) {
+            position += 1;
+            return unary();
+        }
+        return power();
+    };
+    // Python: power ::= primary ["**" u_expr], so -2**2 is -4 and 2**-1 is 0.5.
+    const power = () => {
+        const base = atom();
+        if (!isOp('**'))
+            return base;
+        position += 1;
+        const exponent = unary();
+        return (v) => base(v) ** exponent(v);
+    };
+    const atom = () => {
+        const token = peek();
+        if (!token)
+            return fail('ends where a value is expected');
+        if (token.kind === 'number') {
+            position += 1;
+            const value = token.value;
+            return () => value;
+        }
+        if (isOp('(')) {
+            position += 1;
+            const inner = expression();
+            expect(')');
+            return inner;
+        }
+        if (token.kind === 'name') {
+            position += 1;
+            const freeIndex = names.indexOf(token.text);
+            if (freeIndex >= 0) {
+                if (isOp('('))
+                    fail(`calls the free name ${JSON.stringify(token.text)} as a function`);
+                return (v) => v[freeIndex];
+            }
+            const fn = Object.hasOwn(MATH_FUNCTIONS, token.text) ? MATH_FUNCTIONS[token.text] : undefined;
+            if (fn) {
+                if (!isOp('('))
+                    fail(`uses the function ${JSON.stringify(token.text)} without calling it`);
+                position += 1;
+                const args = [];
+                if (!isOp(')')) {
+                    args.push(expression());
+                    while (isOp(',')) {
+                        position += 1;
+                        if (isOp(')'))
+                            break;
+                        args.push(expression());
+                    }
+                }
+                expect(')');
+                const [min, max] = fn.arity;
+                if (args.length < min || args.length > max) {
+                    fail(`calls ${token.text} with ${args.length} argument(s)`);
+                }
+                return (v) => fn.apply(...args.map((arg) => arg(v)));
+            }
+            if (Object.hasOwn(CONSTANTS, token.text)) {
+                const value = CONSTANTS[token.text];
+                return () => value;
+            }
+            return fail(`names ${JSON.stringify(token.text)}, which is neither a free name`
+                + ` (${names.length ? names.join(', ') : 'none declared'}) nor a math function or constant.`);
+        }
+        return fail(`has ${describe(token)} where a value is expected`);
+    };
+    const compiled = expression();
+    if (position < tokens.length)
+        fail(`has an unexpected ${describe(peek())}`);
+    return compiled;
+};
+/** A spec coordinate: a JSON number, or an expression string. */
+export const compileSpecCoordinate = (value, names, where) => {
+    if (typeof value === 'number' && Number.isFinite(value))
+        return () => value;
+    if (typeof value === 'string')
+        return compileSpecExpression(value, names, where);
+    throw new SpecExpressionError(`${where}: ${JSON.stringify(value)} is not a number or an expression string`);
+};
+//# sourceMappingURL=spec-expression.js.map

package/dist/scene/spec-expression.js.map

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

package/dist/scene/static-server.d.ts

@@ -0,0 +1,13 @@
+export declare const contentTypeFor: (file: string) => string;
+/** The file a request path names inside `root`, or null when it would leave the folder. */
+export declare const resolveInsideRoot: (root: string, requestPath: string) => string | null;
+export type StaticServer = {
+    url: string;
+    port: number;
+    close: () => Promise<void>;
+};
+export declare const startStaticServer: (args: {
+    directory: string;
+    port: number;
+}) => Promise<StaticServer>;
+//# sourceMappingURL=static-server.d.ts.map

package/dist/scene/static-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"static-server.d.ts","sourceRoot":"","sources":["../../src/scene/static-server.ts"],"names":[],"mappings":"AAgCA,eAAO,MAAM,cAAc,GAAI,MAAM,MAAM,KAAG,MAE7C,CAAC;AAEF,2FAA2F;AAC3F,eAAO,MAAM,iBAAiB,GAAI,MAAM,MAAM,EAAE,aAAa,MAAM,KAAG,MAAM,GAAG,IAW9E,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAAC;AAErF,eAAO,MAAM,iBAAiB,GAAU,MAAM;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,KAAG,OAAO,CAAC,YAAY,CA8CvG,CAAC"}

package/dist/scene/static-server.js

@@ -0,0 +1,99 @@
+import { createReadStream } from 'node:fs';
+import { realpath, stat } from 'node:fs/promises';
+import http from 'node:http';
+import path from 'node:path';
+/**
+ * A static file server for one scene folder, bound to 127.0.0.1 only. It
+ * serves nothing outside the folder (a `..` or a symlink out of it is a 403)
+ * and never caches, so every capture sees the files as they are now.
+ */
+const CONTENT_TYPES = {
+    '.html': 'text/html; charset=utf-8',
+    '.js': 'text/javascript; charset=utf-8',
+    '.mjs': 'text/javascript; charset=utf-8',
+    '.css': 'text/css; charset=utf-8',
+    '.png': 'image/png',
+    '.jpg': 'image/jpeg',
+    '.jpeg': 'image/jpeg',
+    '.webp': 'image/webp',
+    '.svg': 'image/svg+xml',
+    '.json': 'application/json',
+    '.glb': 'model/gltf-binary',
+    '.gltf': 'model/gltf+json',
+    '.bin': 'application/octet-stream',
+    '.ttf': 'font/ttf',
+    '.otf': 'font/otf',
+    '.woff': 'font/woff',
+    '.woff2': 'font/woff2',
+};
+export const contentTypeFor = (file) => (CONTENT_TYPES[path.extname(file).toLowerCase()] ?? 'application/octet-stream');
+/** The file a request path names inside `root`, or null when it would leave the folder. */
+export const resolveInsideRoot = (root, requestPath) => {
+    let decoded;
+    try {
+        decoded = decodeURIComponent(requestPath.split('?')[0].split('#')[0]);
+    }
+    catch {
+        return null;
+    }
+    if (decoded.includes('\0'))
+        return null;
+    const resolved = path.resolve(root, `.${path.posix.normalize(`/${decoded}`)}`);
+    const withIndex = decoded.endsWith('/') ? path.join(resolved, 'index.html') : resolved;
+    return withIndex === root || withIndex.startsWith(`${root}${path.sep}`) ? withIndex : null;
+};
+export const startStaticServer = async (args) => {
+    const root = await realpath(path.resolve(args.directory));
+    const server = http.createServer((request, response) => {
+        const refuse = (status) => {
+            response.writeHead(status, { 'cache-control': 'no-store' });
+            response.end();
+        };
+        if (request.method !== 'GET' && request.method !== 'HEAD')
+            return refuse(405);
+        const candidate = resolveInsideRoot(root, request.url ?? '/');
+        if (!candidate)
+            return refuse(403);
+        void (async () => {
+            let file = candidate;
+            try {
+                if ((await stat(file)).isDirectory())
+                    file = path.join(file, 'index.html');
+                const real = await realpath(file);
+                if (real !== root && !real.startsWith(`${root}${path.sep}`))
+                    return refuse(403);
+                const info = await stat(real);
+                if (!info.isFile())
+                    return refuse(404);
+                response.writeHead(200, {
+                    'content-type': contentTypeFor(real),
+                    'content-length': info.size,
+                    'cache-control': 'no-store',
+                });
+                if (request.method === 'HEAD')
+                    return response.end();
+                createReadStream(real).on('error', () => response.destroy()).pipe(response);
+            }
+            catch {
+                refuse(404);
+            }
+        })();
+    });
+    await new Promise((resolve, reject) => {
+        server.once('error', reject);
+        server.listen(args.port, '127.0.0.1', () => {
+            server.off('error', reject);
+            resolve();
+        });
+    });
+    const port = server.address().port;
+    return {
+        url: `http://127.0.0.1:${port}/`,
+        port,
+        close: () => new Promise((resolve) => {
+            server.close(() => resolve());
+            server.closeAllConnections();
+        }),
+    };
+};
+//# sourceMappingURL=static-server.js.map

package/dist/scene/static-server.js.map

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

package/open-design.json

@@ -3,7 +3,7 @@
   "specVersion": "1.0.0",
   "name": "12ui-design",
   "title": "12UI Design",
-  "version": "0.2.70",
+  "version": "0.2.72",
   "description": "Explore corpus-grounded interface directions, choose one, and convert it into production-ready responsive or native artifacts with 12UI.",
   "author": {
     "name": "Just Every",
@@ -49,7 +49,7 @@
           "command": "npx",
           "args": [
             "-y",
-            "@12ui/design@0.2.70",
+            "@12ui/design@0.2.72",
             "mcp"
           ]
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@12ui/design",
-  "version": "0.2.70",
+  "version": "0.2.72",
   "type": "module",
   "description": "The canonical 12ui CLI, SDK, MCP server, and visual interface design skills",
   "main": "dist/index.js",
@@ -11,6 +11,7 @@
   "files": [
     "dist/**/*",
     "prototype-kit/**/*",
+    "scene-kit/**/*",
     "skills/**/*",
     "runtime/**/*",
     "SKILL.md",
@@ -25,6 +26,7 @@
     "test": "node ../../scripts/codex-runtime-bundle.mjs && node ../../scripts/sync-improve-core.mjs && vitest",
     "test:run": "node ../../scripts/codex-runtime-bundle.mjs && node ../../scripts/sync-improve-core.mjs && tsc --noEmit && vitest run",
     "test:prototype": "node prototype-kit/polish/tests/rules-check.mjs && node prototype-kit/polish/tests/harm-check.mjs && node prototype-kit/polish/tests/breathing-check.mjs && node prototype-kit/polish/tests/report-check.mjs && node prototype-kit/tests/rules-check.mjs && node prototype-kit/tests/offline-check.mjs && node prototype-kit/tests/shell-stitching-runtime.mjs && node prototype-kit/tests/shell-stitching-runtime.mjs --reintroduce-defect && node prototype-kit/tests/adversarial-runtime.mjs --assert",
+    "test:scene": "npm run build && node scripts/scene-starter-check.mjs",
     "typecheck": "node ../../scripts/sync-improve-core.mjs && tsc --noEmit && tsc -p tsconfig.type-tests.json",
     "prepublishOnly": "npm run build"
   },

package/scene-kit/starter/camera.js

@@ -0,0 +1,10 @@
+// Paste the "camera.js" line from `12ui scene solve spec.json --out cam.json` here. It uses the same keys and units as cam.json:
+// yawDeg / pitchDeg / rollDeg / vfov are DEGREES (main.js converts to radians). Scene units are yours.
+export const FRAME = { w: 1536, h: 1024 };            // source image size = design frame
+export const CAM = { pos: [0, 2, 6], yawDeg: 0, pitchDeg: -11, rollDeg: 0, vfov: 30 };
+// Depth range: tight. Keep far/near under ~100 or headless GL z-fights (edge-on cylinder walls, decals sitting 1 mm off a
+// surface, shadow-map leaks that show as dotted arcs). The solver prints a "clip" for this camera; also keep coincident
+// surfaces at least ~0.002 x the camera distance apart, and give thin parts real thickness or a chamfered rim.
+export const CLIP = { near: 0.5, far: 60 };
+export const PIVOT = [0, 0, 0];                       // orbit centre: where the optical axis meets the subject
+export const ORBIT_LIMIT = 15;                        // degrees each way for pointer/drag orbit

package/scene-kit/starter/gobo.js

@@ -0,0 +1,60 @@
+// Window light, leaf shadows, dappled patterns: a SpotLight with `.map` (a gobo). The pattern is DRAWN IN SOURCE-IMAGE
+// PIXELS (where the shadows sit in the design) and resampled through the solved camera onto the surface plane, so it lands
+// exactly where drawn at the landing view but is real light: it darkens whatever stands there and moves with the orbit.
+//
+//   const spot = new THREE.SpotLight(0xfff1e0, 900, 0, 0.6, 0.7, 2);  // angle = half-angle: it must cover the whole visible surface
+//   spot.position.set(-2, 8, 3); spot.target.position.set(0.5, 0, 0); spot.castShadow = true;   // .map is ignored unless castShadow is true
+//   scene.add(spot, spot.target);
+//   spot.map = goboTexture(spot, (g, w, h) => { g.fillStyle = '#fff'; g.fillRect(0, 0, w, h);   // white = light, dark = shadow
+//     g.filter = 'blur(38px)'; g.fillStyle = 'rgba(120,98,86,0.5)'; /* draw shadow shapes at source pixel coordinates */ });
+//
+// Orientation, pinned down: texture rows run from the spot's view-bottom (row 0) to view-top, flipY = false, and the pattern
+// is written through CAM (camera.js), not through the light. So DO NOT flip or mirror anything by hand. Verify once by
+// drawing a bright red square at a known source pixel (say the top-left of the sleeve) and checking that it lands there.
+// Draw past the frame edges: outside the source frame the edge value is held, so patterns fade instead of ending in a seam.
+import * as THREE from 'three';
+import { CAM, FRAME } from './camera.js';
+import { rng } from './lib.js';
+
+const D2R = THREE.MathUtils.degToRad;
+
+export function goboTexture(light, draw, { size = 1536, planeY = 0 } = {}) {
+  const src = document.createElement('canvas'); src.width = FRAME.w; src.height = FRAME.h;
+  draw(src.getContext('2d'), FRAME.w, FRAME.h);
+  const sd = src.getContext('2d').getImageData(0, 0, FRAME.w, FRAME.h).data;
+  const P = light.position.clone(), T = light.target.position.clone();
+  const f = T.clone().sub(P).normalize();
+  const right = new THREE.Vector3().crossVectors(f, new THREE.Vector3(0, 1, 0)).normalize(), up = new THREE.Vector3().crossVectors(right, f);
+  const th = Math.tan(light.angle);
+  const q = new THREE.Quaternion().setFromEuler(new THREE.Euler(D2R(CAM.pitchDeg), D2R(CAM.yawDeg), D2R(CAM.rollDeg), 'YXZ')).invert();
+  const F = (FRAME.h / 2) / Math.tan(D2R(CAM.vfov) / 2), cp = new THREE.Vector3(...CAM.pos), d = new THREE.Vector3(), c = new THREE.Vector3();
+  const out = document.createElement('canvas'); out.width = out.height = size;
+  const og = out.getContext('2d'), od = og.createImageData(size, size);
+  for (let j = 0; j < size; j++) for (let i = 0; i < size; i++) {
+    const x = 2 * (i + 0.5) / size - 1, y = 2 * (j + 0.5) / size - 1;
+    d.copy(f).addScaledVector(right, x * th).addScaledVector(up, y * th);
+    let v = 255;
+    if (d.y < -1e-4) {                       // ray from the light hits the plane y = planeY
+      const t = (planeY - P.y) / d.y;
+      c.set(P.x + d.x * t, planeY, P.z + d.z * t).sub(cp).applyQuaternion(q);   // world -> camera
+      const u = FRAME.w / 2 + F * c.x / -c.z, w = FRAME.h / 2 - F * c.y / -c.z;
+      const ux = Math.min(FRAME.w - 1, Math.max(0, Math.round(u))), uy = Math.min(FRAME.h - 1, Math.max(0, Math.round(w)));
+      v = sd[(uy * FRAME.w + ux) * 4];
+    }
+    const o = (j * size + i) * 4; od.data[o] = od.data[o + 1] = od.data[o + 2] = v; od.data[o + 3] = 255;
+  }
+  og.putImageData(od, 0, 0);
+  const t = new THREE.CanvasTexture(out); t.flipY = false; t.colorSpace = THREE.SRGBColorSpace; return t;
+}
+
+// One leaf/frond as ONE path segment set. Call several times between g.beginPath() and a single g.fill() so overlapping
+// leaflets union into one shadow (separate fills stack and read as dark blotches).
+export function frond(g, x, y, ang, len, wid, seed = 4) {
+  const r = rng(seed + Math.round(x + y)); g.save(); g.translate(x, y); g.rotate(ang);
+  g.moveTo(0, 0); g.quadraticCurveTo(len * 0.5, -len * 0.03, len, 0); g.quadraticCurveTo(len * 0.5, len * 0.03, 0, 0);
+  for (let i = 0; i < 6; i++) {
+    const t = 0.2 + i * 0.13, px = len * t, l = len * 0.36 * Math.sin(Math.PI * (0.1 + t * 0.8));
+    for (const s of [-1, 1]) { g.save(); g.translate(px, 0); g.rotate(s * (0.95 + r() * 0.2)); g.moveTo(l, 0); g.ellipse(l / 2, 0, l / 2, wid * (0.8 + r() * 0.4), 0, 0, 7); g.restore(); }
+  }
+  g.restore();
+}

package/scene-kit/starter/index.html

@@ -0,0 +1,23 @@
+<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>Scene</title>
+<style>
+  html, body { margin: 0; height: 100%; overflow: hidden; background: #000; }
+  canvas#gl { position: fixed; inset: 0; width: 100%; height: 100%; display: block; }
+  /* #stage is the source image's pixel frame; main.js scales it to sit exactly over the contain-fitted canvas */
+  #stage { position: fixed; left: 0; top: 0; width: 1536px; height: 1024px; transform-origin: 0 0; pointer-events: none; }
+  #stage a, #stage button, #stage [data-hit] { pointer-events: auto; }
+  /* real page text goes here, positioned in source pixels, e.g.
+     <h1 style="position:absolute; left:56px; top:232px; font: 800 78px/0.9 'Chivo', sans-serif">TITLE</h1> */
+</style>
+<script type="importmap">{ "imports": { "three": "./vendor/three.module.js", "three/addons/": "./vendor/addons/" } }</script>
+</head>
+<body>
+<canvas id="gl"></canvas>
+<div id="stage"></div>
+<script type="module" src="./main.js"></script>
+</body>
+</html>