@12ui/design 0.2.71 → 0.2.73

package/dist/scene/image-colors.js

@@ -0,0 +1,110 @@
+import { SceneArgumentError } from './numbers.js';
+import { readRgb, readRgbAt } from './raster.js';
+const hex = (rgb) => `#${rgb.map((value) => (Math.trunc(value).toString(16).padStart(2, '0'))).join('')}`;
+const clampBox = (box, width, height) => [
+    Math.min(Math.max(box[0], 0), width),
+    Math.min(Math.max(box[1], 0), height),
+    Math.min(Math.max(box[2], 0), width),
+    Math.min(Math.max(box[3], 0), height),
+];
+/** Mean colour of the kept pixels in a box, or null when none are kept. */
+const meanColour = (image, keep, box) => {
+    const [x0, y0, x1, y1] = clampBox(box, image.width, image.height);
+    let r = 0, g = 0, b = 0, n = 0;
+    for (let y = y0; y < y1; y += 1) {
+        for (let x = x0; x < x1; x += 1) {
+            const index = y * image.width + x;
+            if (keep && !keep[index])
+                continue;
+            r += image.data[index * 3];
+            g += image.data[index * 3 + 1];
+            b += image.data[index * 3 + 2];
+            n += 1;
+        }
+    }
+    return n ? [r / n, g / n, b / n] : null;
+};
+/** The source colour of one box: the hex to put in a material. */
+export const sampleSourceBox = async (sourceFile, box) => {
+    const source = await readRgb(sourceFile);
+    const mean = meanColour(source, null, box);
+    if (!mean)
+        throw new SceneArgumentError(`box ${box.join(',')} holds no pixels of the ${source.width}x${source.height} source`);
+    return hex(mean);
+};
+const keepMask = (width, height, excluded) => {
+    const keep = new Uint8Array(width * height).fill(1);
+    for (const box of excluded) {
+        const [x0, y0, x1, y1] = clampBox(box, width, height);
+        for (let y = y0; y < y1; y += 1)
+            keep.fill(0, y * width + x0, y * width + x1);
+    }
+    return keep;
+};
+/**
+ * Compares a render with its source. With regions: source hex, render hex and
+ * brightness ratio per region (ratio < 1: the render is darker). Without: the
+ * eight worst cells of a 12x8 grid by mean colour difference, the next thing to
+ * fix. Excluded boxes (DOM text, labels) are masked out of every comparison.
+ */
+export const compareWithSource = async (args) => {
+    const source = await readRgb(args.sourceFile);
+    const render = await readRgbAt(args.renderFile, source.width, source.height);
+    const { width, height } = source;
+    const keep = keepMask(width, height, args.exclude);
+    if (args.regions.length > 0) {
+        return args.regions.map(({ name, box }) => {
+            const a = meanColour(source, keep, box);
+            const c = meanColour(render, keep, box);
+            if (!a || !c)
+                return `${name.padEnd(16)} fully excluded`;
+            const mean = (rgb) => (rgb[0] + rgb[1] + rgb[2]) / 3;
+            return `${name.padEnd(16)} src ${hex(a)}  render ${hex(c)}  ratio ${(mean(c) / Math.max(mean(a), 1)).toFixed(2)}`;
+        });
+    }
+    const columns = 12, rows = 8;
+    const cells = [];
+    for (let row = 0; row < rows; row += 1) {
+        for (let column = 0; column < columns; column += 1) {
+            const box = [
+                Math.floor((column * width) / columns),
+                Math.floor((row * height) / rows),
+                Math.floor(((column + 1) * width) / columns),
+                Math.floor(((row + 1) * height) / rows),
+            ];
+            const a = meanColour(source, keep, box);
+            const c = meanColour(render, keep, box);
+            if (!a || !c)
+                continue;
+            let kept = 0;
+            for (let y = box[1]; y < box[3]; y += 1)
+                for (let x = box[0]; x < box[2]; x += 1)
+                    kept += keep[y * width + x];
+            // Mostly masked: not comparable.
+            if (kept / ((box[2] - box[0]) * (box[3] - box[1])) < 0.4)
+                continue;
+            const difference = (Math.abs(a[0] - c[0]) + Math.abs(a[1] - c[1]) + Math.abs(a[2] - c[2])) / 3;
+            cells.push({ difference, box, source: hex(a), render: hex(c) });
+        }
+    }
+    cells.sort((left, right) => (right.difference - left.difference
+        || right.box[0] - left.box[0]
+        || right.box[1] - left.box[1]));
+    let total = 0, keptPixels = 0;
+    for (let index = 0; index < width * height; index += 1) {
+        if (!keep[index])
+            continue;
+        const o = index * 3;
+        total += (Math.abs(source.data[o] - render.data[o])
+            + Math.abs(source.data[o + 1] - render.data[o + 1])
+            + Math.abs(source.data[o + 2] - render.data[o + 2])) / 3;
+        keptPixels += 1;
+    }
+    const meanDifference = keptPixels ? total / keptPixels : Number.NaN;
+    return [
+        `mean abs diff ${meanDifference.toFixed(1)} / 255 over ${((keptPixels / (width * height)) * 100).toFixed(0)}%`
+            + ' of the frame. Worst cells (source px box, src colour, render colour):',
+        ...cells.slice(0, 8).map((cell) => (`  ${cell.difference.toFixed(1).padStart(5)}  (${cell.box.join(', ')})  src ${cell.source}  render ${cell.render}`)),
+    ];
+};
+//# sourceMappingURL=image-colors.js.map

package/dist/scene/image-colors.js.map

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

package/dist/scene/image-rectify.d.ts

@@ -0,0 +1,25 @@
+import { type RgbImage } from './raster.js';
+/**
+ * Flatten a perspective quad of the source (a screen, poster, label, sleeve
+ * print) into a flat WIDTHxHEIGHT texture.
+ *
+ * This is a true projective inverse: the homography that sends the output
+ * rectangle onto the quad, sampled bicubically. The Python helper used PIL's
+ * QUAD transform, a bilinear corner mapping that is not a perspective inverse,
+ * and returned foreshortened content visibly sheared.
+ */
+export type Point = [number, number];
+/** Row-major 3x3 with h[8] = 1. */
+export type Homography = Float64Array;
+/** The homography sending each `from` point to the matching `to` point (four pairs). */
+export declare const homographyFromPoints: (from: readonly Point[], to: readonly Point[]) => Homography;
+export declare const applyHomography: (h: Homography, x: number, y: number) => Point;
+export declare const rectifyImage: (source: RgbImage, corners: readonly Point[], width: number, height: number) => RgbImage;
+export declare const rectifyFile: (args: {
+    sourceFile: string;
+    corners: readonly Point[];
+    width: number;
+    height: number;
+    outFile: string;
+}) => Promise<void>;
+//# sourceMappingURL=image-rectify.d.ts.map

package/dist/scene/image-rectify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-rectify.d.ts","sourceRoot":"","sources":["../../src/scene/image-rectify.ts"],"names":[],"mappings":"AAEA,OAAO,EAAqB,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE/D;;;;;;;;GAQG;AAEH,MAAM,MAAM,KAAK,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACrC,mCAAmC;AACnC,MAAM,MAAM,UAAU,GAAG,YAAY,CAAC;AAEtC,wFAAwF;AACxF,eAAO,MAAM,oBAAoB,GAAI,MAAM,SAAS,KAAK,EAAE,EAAE,IAAI,SAAS,KAAK,EAAE,KAAG,UAcnF,CAAC;AAEF,eAAO,MAAM,eAAe,GAAI,GAAG,UAAU,EAAE,GAAG,MAAM,EAAE,GAAG,MAAM,KAAG,KAGrE,CAAC;AAiCF,eAAO,MAAM,YAAY,GAAI,QAAQ,QAAQ,EAAE,SAAS,SAAS,KAAK,EAAE,EAAE,OAAO,MAAM,EAAE,QAAQ,MAAM,KAAG,QAgBzG,CAAC;AAEF,eAAO,MAAM,WAAW,GAAU,MAAM;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,SAAS,KAAK,EAAE,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB,KAAG,OAAO,CAAC,IAAI,CAGf,CAAC"}

package/dist/scene/image-rectify.js

@@ -0,0 +1,82 @@
+import { solveLinearSystem } from './least-squares.js';
+import { SceneArgumentError } from './numbers.js';
+import { readRgb, writePng } from './raster.js';
+/** The homography sending each `from` point to the matching `to` point (four pairs). */
+export const homographyFromPoints = (from, to) => {
+    if (from.length !== 4 || to.length !== 4)
+        throw new Error('a homography needs four point pairs');
+    const rows = [];
+    const rhs = new Float64Array(8);
+    for (let index = 0; index < 4; index += 1) {
+        const [x, y] = from[index];
+        const [u, v] = to[index];
+        rows.push(Float64Array.from([x, y, 1, 0, 0, 0, -u * x, -u * y]));
+        rhs[2 * index] = u;
+        rows.push(Float64Array.from([0, 0, 0, x, y, 1, -v * x, -v * y]));
+        rhs[2 * index + 1] = v;
+    }
+    const h = solveLinearSystem(rows, rhs);
+    return Float64Array.from([...h, 1]);
+};
+export const applyHomography = (h, x, y) => {
+    const w = h[6] * x + h[7] * y + h[8];
+    return [(h[0] * x + h[1] * y + h[2]) / w, (h[3] * x + h[4] * y + h[5]) / w];
+};
+/** Catmull-Rom cubic weight (a = -0.5), the kernel PIL's BICUBIC uses. */
+const cubic = (t) => {
+    const a = -0.5;
+    const x = Math.abs(t);
+    if (x <= 1)
+        return (a + 2) * x ** 3 - (a + 3) * x ** 2 + 1;
+    if (x < 2)
+        return a * x ** 3 - 5 * a * x ** 2 + 8 * a * x - 4 * a;
+    return 0;
+};
+/** Bicubic sample at continuous pixel coordinates (pixel centres at +0.5), edges clamped. */
+const sample = (image, u, v, out) => {
+    const fx = u - 0.5, fy = v - 0.5;
+    const x0 = Math.floor(fx), y0 = Math.floor(fy);
+    const dx = fx - x0, dy = fy - y0;
+    out[0] = 0;
+    out[1] = 0;
+    out[2] = 0;
+    for (let j = -1; j <= 2; j += 1) {
+        const wy = cubic(j - dy);
+        if (wy === 0)
+            continue;
+        const y = Math.min(Math.max(y0 + j, 0), image.height - 1);
+        for (let i = -1; i <= 2; i += 1) {
+            const w = wy * cubic(i - dx);
+            if (w === 0)
+                continue;
+            const x = Math.min(Math.max(x0 + i, 0), image.width - 1);
+            const o = (y * image.width + x) * 3;
+            out[0] += w * image.data[o];
+            out[1] += w * image.data[o + 1];
+            out[2] += w * image.data[o + 2];
+        }
+    }
+};
+export const rectifyImage = (source, corners, width, height) => {
+    if (corners.length !== 4)
+        throw new SceneArgumentError('--corners needs four points: TL;TR;BR;BL');
+    const h = homographyFromPoints([[0, 0], [width, 0], [width, height], [0, height]], corners);
+    const data = Buffer.alloc(width * height * 3);
+    const pixel = [0, 0, 0];
+    for (let y = 0; y < height; y += 1) {
+        for (let x = 0; x < width; x += 1) {
+            const [u, v] = applyHomography(h, x + 0.5, y + 0.5);
+            sample(source, u, v, pixel);
+            const o = (y * width + x) * 3;
+            for (let channel = 0; channel < 3; channel += 1) {
+                data[o + channel] = Math.min(255, Math.max(0, Math.round(pixel[channel])));
+            }
+        }
+    }
+    return { data, width, height };
+};
+export const rectifyFile = async (args) => {
+    const source = await readRgb(args.sourceFile);
+    await writePng(rectifyImage(source, args.corners, args.width, args.height), args.outFile);
+};
+//# sourceMappingURL=image-rectify.js.map

package/dist/scene/image-rectify.js.map

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

package/dist/scene/image-sheet.d.ts

@@ -0,0 +1,19 @@
+export declare const writeContactSheet: (args: {
+    sourceFile: string;
+    captureFiles: readonly string[];
+    outFile: string;
+    columns?: number;
+    note?: string;
+}) => Promise<{
+    width: number;
+    height: number;
+}>;
+export declare const writeBlend: (args: {
+    sourceFile: string;
+    renderFile: string;
+    outFile: string;
+}) => Promise<{
+    width: number;
+    height: number;
+}>;
+//# sourceMappingURL=image-sheet.d.ts.map

package/dist/scene/image-sheet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-sheet.d.ts","sourceRoot":"","sources":["../../src/scene/image-sheet.ts"],"names":[],"mappings":"AAqFA,eAAO,MAAM,iBAAiB,GAAU,MAAM;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,KAAG,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAoB5C,CAAC;AAEF,eAAO,MAAM,UAAU,GAAU,MAAM;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB,KAAG,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CA4B5C,CAAC"}

package/dist/scene/image-sheet.js

@@ -0,0 +1,118 @@
+import path from 'node:path';
+import sharp from 'sharp';
+import { SceneArgumentError } from './numbers.js';
+import { encodePng, readRgb, resizeRgb } from './raster.js';
+/**
+ * The two pictures the self-review loop looks at. A port of `sheet.py`.
+ *
+ * Sheet: SOURCE first, then each capture, in 640 px wide tiles with a large
+ * label on each (the file name; --note is added to the SOURCE tile).
+ * Blend (2x2 of 900 px tiles): SOURCE | RENDER above, 50% BLEND | DIFFERENCE x3
+ * below. Labels are Pango text rendered by sharp's bundled libvips: no font file
+ * and no network.
+ */
+const escapeMarkup = (text) => text
+    .replaceAll('&', '&')
+    .replaceAll('<', '&lt;')
+    .replaceAll('>', '&gt;');
+/** A white label on a black box, as a PNG to composite at (x - 6, y - 3) of the text origin. */
+const label = async (text, fontPx) => {
+    const { data, info } = await sharp({
+        text: {
+            text: `<span foreground="white">${escapeMarkup(text)}</span>`,
+            font: `sans ${fontPx}`,
+            dpi: 72,
+            rgba: true,
+        },
+    }).png().toBuffer({ resolveWithObject: true });
+    const width = info.width + 12;
+    const height = info.height + 6;
+    const input = await sharp({
+        create: { width, height, channels: 4, background: { r: 0, g: 0, b: 0, alpha: 1 } },
+    }).composite([{ input: data, left: 6, top: 3 }]).png().toBuffer();
+    return { input, width, height };
+};
+const composeGrid = async (args) => {
+    const rows = Math.ceil(args.tiles.length / args.columns);
+    const width = args.columns * args.tileWidth;
+    const height = rows * args.tileHeight;
+    const layers = [];
+    for (const [index, tile] of args.tiles.entries()) {
+        const left = (index % args.columns) * args.tileWidth;
+        const top = Math.floor(index / args.columns) * args.tileHeight;
+        const resized = await resizeRgb(tile.image, args.tileWidth, args.tileHeight);
+        layers.push({ input: await encodePng(resized), left, top });
+        const tag = await label(tile.name, args.fontPx);
+        layers.push({
+            input: tag.input,
+            left: Math.min(left + args.labelOffset - 6, Math.max(width - tag.width, 0)),
+            top: top + args.labelOffset - 3,
+        });
+    }
+    await sharp({ create: { width, height, channels: 3, background: args.background } })
+        .composite(layers)
+        .png()
+        .toFile(args.outFile);
+    return { width, height };
+};
+/** Python's round() for the tile height: ties go to the even neighbour. */
+const roundHalfEven = (value) => {
+    const floor = Math.floor(value);
+    const fraction = value - floor;
+    if (Math.abs(fraction - 0.5) > 1e-9)
+        return Math.round(value);
+    return floor % 2 === 0 ? floor : floor + 1;
+};
+const captureName = (file) => path.basename(file).replace(/\.[^.]*$/u, '');
+export const writeContactSheet = async (args) => {
+    const columns = args.columns ?? 3;
+    if (!Number.isInteger(columns) || columns < 1)
+        throw new SceneArgumentError('--cols must be a positive integer');
+    const source = await readRgb(args.sourceFile);
+    const tileWidth = 640;
+    const tileHeight = roundHalfEven((source.height * tileWidth) / source.width);
+    const tiles = [
+        { name: `SOURCE${args.note ? `  ${args.note}` : ''}`, image: source },
+        ...await Promise.all(args.captureFiles.map(async (file) => ({ name: captureName(file), image: await readRgb(file) }))),
+    ];
+    return composeGrid({
+        tiles,
+        columns,
+        tileWidth,
+        tileHeight,
+        background: { r: 24, g: 24, b: 24 },
+        labelOffset: 10,
+        fontPx: 22,
+        outFile: args.outFile,
+    });
+};
+export const writeBlend = async (args) => {
+    const source = await readRgb(args.sourceFile);
+    const render = await resizeRgb(await readRgb(args.renderFile), source.width, source.height);
+    const blend = Buffer.alloc(source.data.length);
+    const difference = Buffer.alloc(source.data.length);
+    for (let index = 0; index < source.data.length; index += 1) {
+        const a = source.data[index], b = render.data[index];
+        blend[index] = Math.round((a + b) / 2);
+        difference[index] = Math.min(255, Math.abs(a - b) * 3);
+    }
+    const tileWidth = 900;
+    const tileHeight = roundHalfEven((source.height * tileWidth) / source.width);
+    const same = { width: source.width, height: source.height };
+    return composeGrid({
+        tiles: [
+            { name: 'SOURCE', image: source },
+            { name: 'RENDER', image: render },
+            { name: '50% BLEND', image: { ...same, data: blend } },
+            { name: 'DIFFERENCE x3', image: { ...same, data: difference } },
+        ],
+        columns: 2,
+        tileWidth,
+        tileHeight,
+        background: { r: 0, g: 0, b: 0 },
+        labelOffset: 12,
+        fontPx: 26,
+        outFile: args.outFile,
+    });
+};
+//# sourceMappingURL=image-sheet.js.map

package/dist/scene/image-sheet.js.map

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

package/dist/scene/least-squares.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Box-constrained Levenberg-Marquardt with a numeric Jacobian, and a multistart
+ * around it. A line-for-line port of the proven Python solver
+ * (`solve_camera.py` lm/multistart): the same damping schedule, the same
+ * forward-difference step, the same clamping, so a spec solves to the same
+ * minimum in both.
+ */
+export type Residuals = (parameters: Float64Array) => Float64Array;
+export declare class SingularMatrixError extends Error {
+    constructor();
+}
+/**
+ * Solves `matrix * x = rhs` by Gaussian elimination with partial pivoting.
+ * An exactly zero pivot is a singular system, as LAPACK reports it.
+ */
+export declare const solveLinearSystem: (matrix: readonly Float64Array[], rhs: Float64Array) => Float64Array;
+export type LeastSquaresResult = {
+    parameters: Float64Array;
+    cost: number;
+};
+export declare const levenbergMarquardt: (residuals: Residuals, start: ArrayLike<number>, low: ArrayLike<number>, high: ArrayLike<number>, iterations?: number) => LeastSquaresResult;
+/**
+ * Every start gets a short coarse run; the best `keep` are refined fully and
+ * the lowest cost wins. Ties keep the earlier start, as Python's stable sort did.
+ */
+export declare const multistart: (residuals: Residuals, starts: readonly ArrayLike<number>[], low: ArrayLike<number>, high: ArrayLike<number>, { keep, coarse, refine }?: {
+    keep?: number;
+    coarse?: number;
+    refine?: number;
+}) => LeastSquaresResult;
+//# sourceMappingURL=least-squares.d.ts.map

package/dist/scene/least-squares.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"least-squares.d.ts","sourceRoot":"","sources":["../../src/scene/least-squares.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,UAAU,EAAE,YAAY,KAAK,YAAY,CAAC;AAEnE,qBAAa,mBAAoB,SAAQ,KAAK;;CAK7C;AAgBD;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAAI,QAAQ,SAAS,YAAY,EAAE,EAAE,KAAK,YAAY,KAAG,YAoCtF,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAAE,UAAU,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5E,eAAO,MAAM,kBAAkB,GAC7B,WAAW,SAAS,EACpB,OAAO,SAAS,CAAC,MAAM,CAAC,EACxB,KAAK,SAAS,CAAC,MAAM,CAAC,EACtB,MAAM,SAAS,CAAC,MAAM,CAAC,EACvB,mBAAe,KACd,kBAmEF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,UAAU,GACrB,WAAW,SAAS,EACpB,QAAQ,SAAS,SAAS,CAAC,MAAM,CAAC,EAAE,EACpC,KAAK,SAAS,CAAC,MAAM,CAAC,EACtB,MAAM,SAAS,CAAC,MAAM,CAAC,EACvB,2BAAyC;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,KAChG,kBAeF,CAAC"}

package/dist/scene/least-squares.js

@@ -0,0 +1,173 @@
+/**
+ * Box-constrained Levenberg-Marquardt with a numeric Jacobian, and a multistart
+ * around it. A line-for-line port of the proven Python solver
+ * (`solve_camera.py` lm/multistart): the same damping schedule, the same
+ * forward-difference step, the same clamping, so a spec solves to the same
+ * minimum in both.
+ */
+export class SingularMatrixError extends Error {
+    constructor() {
+        super('singular matrix');
+        this.name = 'SingularMatrixError';
+    }
+}
+const clamp = (values, low, high) => {
+    const out = new Float64Array(values.length);
+    for (let index = 0; index < values.length; index += 1) {
+        out[index] = Math.min(Math.max(values[index], low[index]), high[index]);
+    }
+    return out;
+};
+const sumOfSquares = (values) => {
+    let total = 0;
+    for (const value of values)
+        total += value * value;
+    return total;
+};
+/**
+ * Solves `matrix * x = rhs` by Gaussian elimination with partial pivoting.
+ * An exactly zero pivot is a singular system, as LAPACK reports it.
+ */
+export const solveLinearSystem = (matrix, rhs) => {
+    const size = rhs.length;
+    const a = matrix.map((row) => Float64Array.from(row));
+    const b = Float64Array.from(rhs);
+    for (let column = 0; column < size; column += 1) {
+        let pivotRow = column;
+        let pivotSize = Math.abs(a[column][column]);
+        for (let row = column + 1; row < size; row += 1) {
+            const candidate = Math.abs(a[row][column]);
+            if (candidate > pivotSize) {
+                pivotSize = candidate;
+                pivotRow = row;
+            }
+        }
+        if (pivotSize === 0)
+            throw new SingularMatrixError();
+        if (pivotRow !== column) {
+            [a[column], a[pivotRow]] = [a[pivotRow], a[column]];
+            [b[column], b[pivotRow]] = [b[pivotRow], b[column]];
+        }
+        const pivot = a[column];
+        for (let row = column + 1; row < size; row += 1) {
+            const target = a[row];
+            const factor = target[column] / pivot[column];
+            if (factor === 0)
+                continue;
+            for (let k = column; k < size; k += 1)
+                target[k] -= factor * pivot[k];
+            b[row] -= factor * b[column];
+        }
+    }
+    const x = new Float64Array(size);
+    for (let row = size - 1; row >= 0; row -= 1) {
+        let total = b[row];
+        const current = a[row];
+        for (let k = row + 1; k < size; k += 1)
+            total -= current[k] * x[k];
+        x[row] = total / current[row];
+    }
+    return x;
+};
+export const levenbergMarquardt = (residuals, start, low, high, iterations = 60) => {
+    let p = clamp(start, low, high);
+    let lambda = 1e-2;
+    let r = residuals(p);
+    let cost = sumOfSquares(r);
+    const n = p.length;
+    for (let iteration = 0; iteration < iterations; iteration += 1) {
+        const m = r.length;
+        // Forward-difference Jacobian, column by column.
+        const jacobian = [];
+        for (let i = 0; i < n; i += 1) {
+            const step = 1e-6 * Math.max(1, Math.abs(p[i]));
+            const q = Float64Array.from(p);
+            q[i] += step;
+            const rq = residuals(q);
+            const column = new Float64Array(m);
+            for (let k = 0; k < m; k += 1)
+                column[k] = (rq[k] - r[k]) / step;
+            jacobian.push(column);
+        }
+        const normal = Array.from({ length: n }, () => new Float64Array(n));
+        const gradient = new Float64Array(n);
+        for (let i = 0; i < n; i += 1) {
+            const ci = jacobian[i];
+            let g = 0;
+            for (let k = 0; k < m; k += 1)
+                g += ci[k] * r[k];
+            gradient[i] = g;
+            for (let j = i; j < n; j += 1) {
+                const cj = jacobian[j];
+                let total = 0;
+                for (let k = 0; k < m; k += 1)
+                    total += ci[k] * cj[k];
+                normal[i][j] = total;
+                normal[j][i] = total;
+            }
+        }
+        let improved = false;
+        for (let attempt = 0; attempt < 12; attempt += 1) {
+            const damped = normal.map((row, i) => {
+                const copy = Float64Array.from(row);
+                copy[i] += lambda * (row[i] + 1e-9);
+                return copy;
+            });
+            let step;
+            try {
+                step = solveLinearSystem(damped, gradient.map((value) => -value));
+            }
+            catch (error) {
+                if (error instanceof SingularMatrixError) {
+                    lambda *= 10;
+                    continue;
+                }
+                throw error;
+            }
+            const candidate = clamp(p.map((value, index) => value + step[index]), low, high);
+            const rq = residuals(candidate);
+            const cq = sumOfSquares(rq);
+            if (cq < cost) {
+                p = candidate;
+                r = rq;
+                cost = cq;
+                lambda = Math.max(lambda / 3, 1e-9);
+                improved = true;
+                break;
+            }
+            lambda *= 4;
+        }
+        if (!improved || cost < 1e-10)
+            break;
+    }
+    return { parameters: p, cost };
+};
+/**
+ * Every start gets a short coarse run; the best `keep` are refined fully and
+ * the lowest cost wins. Ties keep the earlier start, as Python's stable sort did.
+ */
+export const multistart = (residuals, starts, low, high, { keep = 6, coarse = 25, refine = 200 } = {}) => {
+    const scored = starts.map((start, index) => ({
+        index,
+        ...levenbergMarquardt(residuals, start, low, high, coarse),
+    }));
+    scored.sort((left, right) => (compareCost(left.cost, right.cost) || left.index - right.index));
+    let best = null;
+    for (const candidate of scored.slice(0, keep)) {
+        const refined = levenbergMarquardt(residuals, candidate.parameters, low, high, refine);
+        if (best === null || refined.cost < best.cost)
+            best = refined;
+    }
+    if (best === null)
+        throw new Error('multistart needs at least one start');
+    return best;
+};
+/** NaN sorts last, like a failed start should. */
+const compareCost = (left, right) => {
+    if (Number.isNaN(left))
+        return Number.isNaN(right) ? 0 : 1;
+    if (Number.isNaN(right))
+        return -1;
+    return left - right;
+};
+//# sourceMappingURL=least-squares.js.map

package/dist/scene/least-squares.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"least-squares.js","sourceRoot":"","sources":["../../src/scene/least-squares.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAC5C;QACE,KAAK,CAAC,iBAAiB,CAAC,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED,MAAM,KAAK,GAAG,CAAC,MAAyB,EAAE,GAAsB,EAAE,IAAuB,EAAgB,EAAE;IACzG,MAAM,GAAG,GAAG,IAAI,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC5C,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACtD,GAAG,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAE,EAAE,GAAG,CAAC,KAAK,CAAE,CAAC,EAAE,IAAI,CAAC,KAAK,CAAE,CAAC,CAAC;IAC7E,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC,CAAC;AAEF,MAAM,YAAY,GAAG,CAAC,MAAoB,EAAU,EAAE;IACpD,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,KAAK,IAAI,MAAM;QAAE,KAAK,IAAI,KAAK,GAAG,KAAK,CAAC;IACnD,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,MAA+B,EAAE,GAAiB,EAAgB,EAAE;IACpG,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC;IACxB,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACtD,MAAM,CAAC,GAAG,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACjC,KAAK,IAAI,MAAM,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,IAAI,CAAC,EAAE,CAAC;QAChD,IAAI,QAAQ,GAAG,MAAM,CAAC;QACtB,IAAI,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAE,CAAC,MAAM,CAAE,CAAC,CAAC;QAC9C,KAAK,IAAI,GAAG,GAAG,MAAM,GAAG,CAAC,EAAE,GAAG,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;YAChD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAE,CAAC,MAAM,CAAE,CAAC,CAAC;YAC7C,IAAI,SAAS,GAAG,SAAS,EAAE,CAAC;gBAC1B,SAAS,GAAG,SAAS,CAAC;gBACtB,QAAQ,GAAG,GAAG,CAAC;YACjB,CAAC;QACH,CAAC;QACD,IAAI,SAAS,KAAK,CAAC;YAAE,MAAM,IAAI,mBAAmB,EAAE,CAAC;QACrD,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;YACxB,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAE,EAAE,CAAC,CAAC,MAAM,CAAE,CAAC,CAAC;YACtD,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAE,EAAE,CAAC,CAAC,MAAM,CAAE,CAAC,CAAC;QACxD,CAAC;QACD,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAE,CAAC;QACzB,KAAK,IAAI,GAAG,GAAG,MAAM,GAAG,CAAC,EAAE,GAAG,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;YAChD,MAAM,MAAM,GAAG,CAAC,CAAC,GAAG,CAAE,CAAC;YACvB,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAE,GAAG,KAAK,CAAC,MAAM,CAAE,CAAC;YAChD,IAAI,MAAM,KAAK,CAAC;gBAAE,SAAS;YAC3B,KAAK,IAAI,CAAC,GAAG,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,IAAI,CAAC;gBAAE,MAAM,CAAC,CAAC,CAAE,IAAI,MAAM,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;YACxE,CAAC,CAAC,GAAG,CAAE,IAAI,MAAM,GAAG,CAAC,CAAC,MAAM,CAAE,CAAC;QACjC,CAAC;IACH,CAAC;IACD,MAAM,CAAC,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC;IACjC,KAAK,IAAI,GAAG,GAAG,IAAI,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;QAC5C,IAAI,KAAK,GAAG,CAAC,CAAC,GAAG,CAAE,CAAC;QACpB,MAAM,OAAO,GAAG,CAAC,CAAC,GAAG,CAAE,CAAC;QACxB,KAAK,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,IAAI,CAAC;YAAE,KAAK,IAAI,OAAO,CAAC,CAAC,CAAE,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC;QACrE,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,GAAG,OAAO,CAAC,GAAG,CAAE,CAAC;IACjC,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC,CAAC;AAIF,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,SAAoB,EACpB,KAAwB,EACxB,GAAsB,EACtB,IAAuB,EACvB,UAAU,GAAG,EAAE,EACK,EAAE;IACtB,IAAI,CAAC,GAAG,KAAK,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;IAChC,IAAI,MAAM,GAAG,IAAI,CAAC;IAClB,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;IACrB,IAAI,IAAI,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;IAC3B,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC;IACnB,KAAK,IAAI,SAAS,GAAG,CAAC,EAAE,SAAS,GAAG,UAAU,EAAE,SAAS,IAAI,CAAC,EAAE,CAAC;QAC/D,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC;QACnB,iDAAiD;QACjD,MAAM,QAAQ,GAAmB,EAAE,CAAC;QACpC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC;YACjD,MAAM,CAAC,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAC/B,CAAC,CAAC,CAAC,CAAE,IAAI,IAAI,CAAC;YACd,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;YACxB,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,CAAC,CAAC,CAAC;YACnC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC;gBAAE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAE,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC,GAAG,IAAI,CAAC;YACnE,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACxB,CAAC;QACD,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,IAAI,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;QACpE,MAAM,QAAQ,GAAG,IAAI,YAAY,CAAC,CAAC,CAAC,CAAC;QACrC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,MAAM,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAE,CAAC;YACxB,IAAI,CAAC,GAAG,CAAC,CAAC;YACV,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC;gBAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAE,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC;YACnD,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YAChB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC9B,MAAM,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAE,CAAC;gBACxB,IAAI,KAAK,GAAG,CAAC,CAAC;gBACd,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC;oBAAE,KAAK,IAAI,EAAE,CAAC,CAAC,CAAE,GAAG,EAAE,CAAC,CAAC,CAAE,CAAC;gBACxD,MAAM,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC;gBACtB,MAAM,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC;YACxB,CAAC;QACH,CAAC;QACD,IAAI,QAAQ,GAAG,KAAK,CAAC;QACrB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,EAAE,EAAE,OAAO,IAAI,CAAC,EAAE,CAAC;YACjD,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;gBACnC,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACpC,IAAI,CAAC,CAAC,CAAE,IAAI,MAAM,GAAG,CAAC,GAAG,CAAC,CAAC,CAAE,GAAG,IAAI,CAAC,CAAC;gBACtC,OAAO,IAAI,CAAC;YACd,CAAC,CAAC,CAAC;YACH,IAAI,IAAkB,CAAC;YACvB,IAAI,CAAC;gBACH,IAAI,GAAG,iBAAiB,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;YACpE,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,KAAK,YAAY,mBAAmB,EAAE,CAAC;oBACzC,MAAM,IAAI,EAAE,CAAC;oBACb,SAAS;gBACX,CAAC;gBACD,MAAM,KAAK,CAAC;YACd,CAAC;YACD,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAE,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;YAClF,MAAM,EAAE,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC;YAChC,MAAM,EAAE,GAAG,YAAY,CAAC,EAAE,CAAC,CAAC;YAC5B,IAAI,EAAE,GAAG,IAAI,EAAE,CAAC;gBACd,CAAC,GAAG,SAAS,CAAC;gBACd,CAAC,GAAG,EAAE,CAAC;gBACP,IAAI,GAAG,EAAE,CAAC;gBACV,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC;gBACpC,QAAQ,GAAG,IAAI,CAAC;gBAChB,MAAM;YACR,CAAC;YACD,MAAM,IAAI,CAAC,CAAC;QACd,CAAC;QACD,IAAI,CAAC,QAAQ,IAAI,IAAI,GAAG,KAAK;YAAE,MAAM;IACvC,CAAC;IACD,OAAO,EAAE,UAAU,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC;AACjC,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CACxB,SAAoB,EACpB,MAAoC,EACpC,GAAsB,EACtB,IAAuB,EACvB,EAAE,IAAI,GAAG,CAAC,EAAE,MAAM,GAAG,EAAE,EAAE,MAAM,GAAG,GAAG,KAA0D,EAAE,EAC7E,EAAE;IACtB,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QAC3C,KAAK;QACL,GAAG,kBAAkB,CAAC,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC;KAC3D,CAAC,CAAC,CAAC;IACJ,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAC3B,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAC/D,CAAC,CAAC;IACH,IAAI,IAAI,GAA8B,IAAI,CAAC;IAC3C,KAAK,MAAM,SAAS,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,CAAC;QAC9C,MAAM,OAAO,GAAG,kBAAkB,CAAC,SAAS,EAAE,SAAS,CAAC,UAAU,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QACvF,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI;YAAE,IAAI,GAAG,OAAO,CAAC;IAChE,CAAC;IACD,IAAI,IAAI,KAAK,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IAC1E,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAEF,kDAAkD;AAClD,MAAM,WAAW,GAAG,CAAC,IAAY,EAAE,KAAa,EAAU,EAAE;IAC1D,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3D,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC,CAAC;IACnC,OAAO,IAAI,GAAG,KAAK,CAAC;AACtB,CAAC,CAAC"}

package/dist/scene/numbers.d.ts

@@ -0,0 +1,17 @@
+/** A malformed scene argument: a refusal, raised before any work starts. */
+export declare class SceneArgumentError extends Error {
+    constructor(message: string);
+}
+/** Round to `digits` decimals for JSON output (the Python helpers' `round`). */
+export declare const roundTo: (value: number, digits: number) => number;
+/** Fixed-point text, like Python's `f"{value:.Nf}"`. */
+export declare const fixed: (value: number, digits: number) => string;
+/** Parses "a,b" or "a,b,c" into numbers, naming the argument when it is malformed. */
+export declare const parseNumberTuple: (text: string, count: number, what: string) => number[];
+/** Parses a box "x0,y0,x1,y1" into integers (fractions truncate, as Python's int() did). */
+export declare const parseBox: (text: string, what: string) => [number, number, number, number];
+/** Splits a `;`-separated list, dropping empty entries. */
+export declare const splitList: (text: string) => string[];
+/** "WxH" into two positive integers. */
+export declare const parseSize: (text: string, what: string) => [number, number];
+//# sourceMappingURL=numbers.d.ts.map