@12ui/design 0.2.71 → 0.2.72

package/dist/scene/raster.js

@@ -0,0 +1,31 @@
+import sharp from 'sharp';
+export const readRgb = async (file) => {
+    const { data, info } = await sharp(file)
+        .removeAlpha()
+        .toColourspace('srgb')
+        .raw()
+        .toBuffer({ resolveWithObject: true });
+    if (info.channels !== 3)
+        throw new Error(`${file}: expected RGB pixels, decoded ${info.channels} channels`);
+    return { data, width: info.width, height: info.height };
+};
+const rawInput = (image) => ({
+    raw: { width: image.width, height: image.height, channels: 3 },
+});
+/** Lanczos resize to an exact size; the same size is returned untouched. */
+export const resizeRgb = async (image, width, height) => {
+    if (image.width === width && image.height === height)
+        return image;
+    const { data, info } = await sharp(image.data, rawInput(image))
+        .resize(width, height, { fit: 'fill', kernel: 'lanczos3' })
+        .raw()
+        .toBuffer({ resolveWithObject: true });
+    return { data, width: info.width, height: info.height };
+};
+export const readRgbAt = async (file, width, height) => (resizeRgb(await readRgb(file), width, height));
+/** PNG bytes of an in-memory image. */
+export const encodePng = async (image) => (sharp(image.data, rawInput(image)).png().toBuffer());
+export const writePng = async (image, file) => {
+    await sharp(image.data, rawInput(image)).png().toFile(file);
+};
+//# sourceMappingURL=raster.js.map

package/dist/scene/raster.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"raster.js","sourceRoot":"","sources":["../../src/scene/raster.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAS1B,MAAM,CAAC,MAAM,OAAO,GAAG,KAAK,EAAE,IAAY,EAAqB,EAAE;IAC/D,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC;SACrC,WAAW,EAAE;SACb,aAAa,CAAC,MAAM,CAAC;SACrB,GAAG,EAAE;SACL,QAAQ,CAAC,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC,CAAC;IACzC,IAAI,IAAI,CAAC,QAAQ,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,kCAAkC,IAAI,CAAC,QAAQ,WAAW,CAAC,CAAC;IAC5G,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;AAC1D,CAAC,CAAC;AAEF,MAAM,QAAQ,GAAG,CAAC,KAAe,EAAE,EAAE,CAAC,CAAC;IACrC,GAAG,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAU,EAAE;CACxE,CAAC,CAAC;AAEH,4EAA4E;AAC5E,MAAM,CAAC,MAAM,SAAS,GAAG,KAAK,EAAE,KAAe,EAAE,KAAa,EAAE,MAAc,EAAqB,EAAE;IACnG,IAAI,KAAK,CAAC,KAAK,KAAK,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM;QAAE,OAAO,KAAK,CAAC;IACnE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;SAC5D,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;SAC1D,GAAG,EAAE;SACL,QAAQ,CAAC,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC,CAAC;IACzC,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;AAC1D,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,SAAS,GAAG,KAAK,EAAE,IAAY,EAAE,KAAa,EAAE,MAAc,EAAqB,EAAE,CAAC,CACjG,SAAS,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,CAC9C,CAAC;AAEF,uCAAuC;AACvC,MAAM,CAAC,MAAM,SAAS,GAAG,KAAK,EAAE,KAAe,EAAmB,EAAE,CAAC,CACnE,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CACpD,CAAC;AAEF,MAAM,CAAC,MAAM,QAAQ,GAAG,KAAK,EAAE,KAAe,EAAE,IAAY,EAAiB,EAAE;IAC7E,MAAM,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AAC9D,CAAC,CAAC"}

package/dist/scene/scene-kit.d.ts

@@ -0,0 +1,20 @@
+/**
+ * The starter harness and the pinned three.js that ship inside the package
+ * (`scene-kit/`), and the one operation on them: copy both into a new scene
+ * folder. The payload is stored once in the package, never in agent homes, and
+ * nothing is fetched: three.js r186 and its MIT licence are bundled.
+ */
+export declare const sceneKitRoot: () => string;
+/** Every file `init` writes, as [kit source, path inside the scene folder]. */
+export declare const sceneKitFiles: (kitRoot?: string) => Promise<Array<[string, string]>>;
+export declare class SceneInitConflict extends Error {
+    readonly conflicts: readonly string[];
+    constructor(directory: string, conflicts: readonly string[]);
+}
+/**
+ * Copies the starter and the vendored three.js into `directory`. Refuses before
+ * writing anything when any destination file already exists; the folder itself
+ * may exist (it usually holds the source image).
+ */
+export declare const initSceneFolder: (directory: string, kitRoot?: string) => Promise<string[]>;
+//# sourceMappingURL=scene-kit.d.ts.map

package/dist/scene/scene-kit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-kit.d.ts","sourceRoot":"","sources":["../../src/scene/scene-kit.ts"],"names":[],"mappings":"AAKA;;;;;GAKG;AAEH,eAAO,MAAM,YAAY,QAAO,MAAqE,CAAC;AAsBtG,+EAA+E;AAC/E,eAAO,MAAM,aAAa,GAAU,gBAAwB,KAAG,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAO7F,CAAC;AAEF,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;gBAE1B,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,MAAM,EAAE;CAS5D;AAED;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAC1B,WAAW,MAAM,EACjB,gBAAwB,KACvB,OAAO,CAAC,MAAM,EAAE,CAclB,CAAC"}

package/dist/scene/scene-kit.js

@@ -0,0 +1,74 @@
+import { constants } from 'node:fs';
+import { copyFile, mkdir, readdir, stat } from 'node:fs/promises';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+/**
+ * The starter harness and the pinned three.js that ship inside the package
+ * (`scene-kit/`), and the one operation on them: copy both into a new scene
+ * folder. The payload is stored once in the package, never in agent homes, and
+ * nothing is fetched: three.js r186 and its MIT licence are bundled.
+ */
+export const sceneKitRoot = () => fileURLToPath(new URL('../../scene-kit/', import.meta.url));
+const listFiles = async (root, relative = '') => {
+    const entries = await readdir(path.join(root, relative), { withFileTypes: true });
+    const nested = await Promise.all(entries.map(async (entry) => {
+        const child = path.join(relative, entry.name);
+        if (entry.isDirectory())
+            return listFiles(root, child);
+        return entry.isFile() ? [child] : [];
+    }));
+    return nested.flat().sort();
+};
+const exists = async (target) => {
+    try {
+        await stat(target);
+        return true;
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return false;
+        throw error;
+    }
+};
+/** Every file `init` writes, as [kit source, path inside the scene folder]. */
+export const sceneKitFiles = async (kitRoot = sceneKitRoot()) => {
+    const starter = await listFiles(path.join(kitRoot, 'starter'));
+    const vendor = await listFiles(path.join(kitRoot, 'vendor'));
+    return [
+        ...starter.map((file) => [path.join(kitRoot, 'starter', file), file]),
+        ...vendor.map((file) => [path.join(kitRoot, 'vendor', file), path.join('vendor', file)]),
+    ];
+};
+export class SceneInitConflict extends Error {
+    conflicts;
+    constructor(directory, conflicts) {
+        super(`${directory} already has ${conflicts.length === 1 ? 'a file' : 'files'} the starter would write:`
+            + ` ${conflicts.slice(0, 8).join(', ')}${conflicts.length > 8 ? ', ...' : ''}.`
+            + ' Nothing was written. Choose a new folder, or move those files away first.');
+        this.name = 'SceneInitConflict';
+        this.conflicts = conflicts;
+    }
+}
+/**
+ * Copies the starter and the vendored three.js into `directory`. Refuses before
+ * writing anything when any destination file already exists; the folder itself
+ * may exist (it usually holds the source image).
+ */
+export const initSceneFolder = async (directory, kitRoot = sceneKitRoot()) => {
+    const target = path.resolve(directory);
+    const files = await sceneKitFiles(kitRoot);
+    const conflicts = [];
+    for (const [, relative] of files) {
+        if (await exists(path.join(target, relative)))
+            conflicts.push(relative);
+    }
+    if (conflicts.length > 0)
+        throw new SceneInitConflict(target, conflicts);
+    for (const [source, relative] of files) {
+        const destination = path.join(target, relative);
+        await mkdir(path.dirname(destination), { recursive: true });
+        await copyFile(source, destination, constants.COPYFILE_EXCL);
+    }
+    return files.map(([, relative]) => relative);
+};
+//# sourceMappingURL=scene-kit.js.map

package/dist/scene/scene-kit.js.map

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

package/dist/scene/scene-verbs.d.ts

@@ -0,0 +1,4 @@
+/** The `12ui scene` verbs, named once for the dispatcher and the capability record. */
+export declare const SCENE_VERBS: readonly ["init", "solve", "ray", "project", "rect", "serve", "capture", "sheet", "blend", "colors", "rectify"];
+export type SceneVerb = typeof SCENE_VERBS[number];
+//# sourceMappingURL=scene-verbs.d.ts.map

package/dist/scene/scene-verbs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-verbs.d.ts","sourceRoot":"","sources":["../../src/scene/scene-verbs.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,eAAO,MAAM,WAAW,iHAEd,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC"}

package/dist/scene/scene-verbs.js

@@ -0,0 +1,5 @@
+/** The `12ui scene` verbs, named once for the dispatcher and the capability record. */
+export const SCENE_VERBS = [
+    'init', 'solve', 'ray', 'project', 'rect', 'serve', 'capture', 'sheet', 'blend', 'colors', 'rectify',
+];
+//# sourceMappingURL=scene-verbs.js.map

package/dist/scene/scene-verbs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-verbs.js","sourceRoot":"","sources":["../../src/scene/scene-verbs.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS;CAC5F,CAAC"}

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