@12ui/design 0.2.71 → 0.2.73

package/dist/scene/camera-solve.js

@@ -0,0 +1,288 @@
+import { degrees, projectPoints, radians, rotationMatrix, } from './camera-model.js';
+import { multistart } from './least-squares.js';
+import { fixed, roundTo } from './numbers.js';
+import { seededRandom } from './seeded-random.js';
+import { compileSpecCoordinate } from './spec-expression.js';
+/**
+ * The least-squares camera (position, yaw, pitch, roll, vertical fov) that puts
+ * a spec's world landmarks on their source pixels. A port of the proven
+ * `solve_camera.py camera`: same parameterisation, bounds, penalty, multistart
+ * and diagnostics, and the same cam.json keys, so scene folders built with the
+ * Python helper keep working.
+ */
+export const CAMERA_KEYS = ['cx', 'cy', 'cz', 'yaw', 'pitch', 'roll', 'fov'];
+const ANGLE_KEYS = new Set(['yaw', 'pitch', 'roll']);
+export class CameraSpecError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'CameraSpecError';
+    }
+}
+const isFiniteNumber = (value) => typeof value === 'number' && Number.isFinite(value);
+/** Validates and compiles a spec.json value; every refusal names the field. */
+export const parseCameraSpec = (value, source = 'spec') => {
+    const fail = (message) => { throw new CameraSpecError(`${source}: ${message}`); };
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        fail('must be a JSON object');
+    const spec = value;
+    const image = spec.image;
+    if (!Array.isArray(image) || image.length !== 2 || !image.every((v) => isFiniteNumber(v) && v > 0)) {
+        fail('"image" must be [width, height] of the source image in pixels');
+    }
+    const freeValue = spec.free ?? {};
+    if (!freeValue || typeof freeValue !== 'object' || Array.isArray(freeValue))
+        fail('"free" must be an object of name: [low, high]');
+    const free = Object.entries(freeValue).map(([name, range]) => {
+        if (!/^[A-Za-z_][A-Za-z0-9_]*$/u.test(name))
+            fail(`free name "${name}" must be an identifier`);
+        if (CAMERA_KEYS.includes(name))
+            fail(`free name "${name}" collides with a camera key`);
+        if (!Array.isArray(range) || range.length !== 2 || !range.every(isFiniteNumber) || !(range[0] < range[1])) {
+            fail(`free "${name}" must be [low, high] with low < high`);
+        }
+        const [low, high] = range;
+        return { name, low, high };
+    });
+    const names = free.map((entry) => entry.name);
+    const fixValue = spec.fix ?? {};
+    if (!fixValue || typeof fixValue !== 'object' || Array.isArray(fixValue))
+        fail('"fix" must be an object of key: number');
+    const fix = new Map();
+    for (const [key, pinned] of Object.entries(fixValue)) {
+        if (!CAMERA_KEYS.includes(key) && !names.includes(key)) {
+            fail(`fix "${key}" is neither a camera key (${CAMERA_KEYS.join(' ')}) nor a free name`);
+        }
+        if (!isFiniteNumber(pinned))
+            fail(`fix "${key}" must be a number`);
+        fix.set(key, pinned);
+    }
+    // Almost every image is upright; a free roll trades against yaw near top-down and eats accuracy.
+    if (!fix.has('roll') && spec.solve_roll !== true)
+        fix.set('roll', 0);
+    const landmarksValue = spec.landmarks;
+    if (!Array.isArray(landmarksValue) || landmarksValue.length < 2)
+        fail('"landmarks" must list at least two landmarks');
+    const landmarks = landmarksValue.map((entry, index) => {
+        const record = entry;
+        const name = typeof record?.name === 'string' ? record.name : String(index);
+        const where = `${source} landmark "${name}"`;
+        const px = record?.px;
+        const world = record?.world;
+        if (!Array.isArray(px) || px.length !== 2 || !px.every(isFiniteNumber))
+            fail(`landmark "${name}": "px" must be [u, v]`);
+        if (!Array.isArray(world) || world.length !== 3)
+            fail(`landmark "${name}": "world" must be [x, y, z]`);
+        const coordinates = world.map((coordinate) => compileSpecCoordinate(coordinate, names, where));
+        return {
+            name,
+            px: [px[0], px[1]],
+            world: [coordinates[0], coordinates[1], coordinates[2]],
+        };
+    });
+    return { image: [image[0], image[1]], free, fix, landmarks };
+};
+const cameraOf = (p) => ({
+    pos: [p[0], p[1], p[2]],
+    yaw: p[3],
+    pitch: p[4],
+    roll: p[5],
+    fov: p[6],
+});
+/** Singular values of centred points: square roots of the covariance eigenvalues (Jacobi). */
+const centredSingularValues = (points) => {
+    const mean = [0, 0, 0];
+    for (const point of points)
+        for (let axis = 0; axis < 3; axis += 1)
+            mean[axis] += point[axis] / points.length;
+    const a = [[0, 0, 0], [0, 0, 0], [0, 0, 0]];
+    for (const point of points) {
+        const c = [point[0] - mean[0], point[1] - mean[1], point[2] - mean[2]];
+        for (let i = 0; i < 3; i += 1)
+            for (let j = 0; j < 3; j += 1)
+                a[i][j] += c[i] * c[j];
+    }
+    for (let sweep = 0; sweep < 64; sweep += 1) {
+        const off = a[0][1] ** 2 + a[0][2] ** 2 + a[1][2] ** 2;
+        if (off < 1e-30)
+            break;
+        for (let p = 0; p < 2; p += 1) {
+            for (let q = p + 1; q < 3; q += 1) {
+                if (Math.abs(a[p][q]) < 1e-300)
+                    continue;
+                const theta = (a[q][q] - a[p][p]) / (2 * a[p][q]);
+                const t = Math.sign(theta || 1) / (Math.abs(theta) + Math.sqrt(theta * theta + 1));
+                const c = 1 / Math.sqrt(t * t + 1);
+                const s = t * c;
+                for (let k = 0; k < 3; k += 1) {
+                    const akp = a[k][p], akq = a[k][q];
+                    a[k][p] = c * akp - s * akq;
+                    a[k][q] = s * akp + c * akq;
+                }
+                for (let k = 0; k < 3; k += 1) {
+                    const apk = a[p][k], aqk = a[q][k];
+                    a[p][k] = c * apk - s * aqk;
+                    a[q][k] = s * apk + c * aqk;
+                }
+            }
+        }
+    }
+    return [a[0][0], a[1][1], a[2][2]].map((value) => Math.sqrt(Math.max(value, 0))).sort((x, y) => y - x);
+};
+export const solveCamera = (spec, { starts = 500, sensitivityStarts = 100 } = {}) => {
+    const [width, height] = spec.image;
+    const freeNames = spec.free.map((entry) => entry.name);
+    const names = [...CAMERA_KEYS, ...freeNames];
+    const low = [-1e4, -1e4, -1e4, -Math.PI, -1.5533, -0.5, 4, ...spec.free.map((entry) => entry.low)];
+    const high = [1e4, 1e4, 1e4, Math.PI, 1.5533, 0.5, 120, ...spec.free.map((entry) => entry.high)];
+    const pixels = spec.landmarks.map((landmark) => landmark.px);
+    const world = (freeValues) => spec.landmarks.map((landmark) => [
+        landmark.world[0](freeValues),
+        landmark.world[1](freeValues),
+        landmark.world[2](freeValues),
+    ]);
+    const run = (fixMap, startCount) => {
+        const fixed = new Map();
+        for (const [key, value] of fixMap) {
+            fixed.set(names.indexOf(key), ANGLE_KEYS.has(key) ? radians(value) : value);
+        }
+        const variable = names.map((_, index) => index).filter((index) => !fixed.has(index));
+        const full = (v) => {
+            const p = new Float64Array(names.length);
+            for (const [index, value] of fixed)
+                p[index] = value;
+            variable.forEach((index, position) => { p[index] = v[position]; });
+            return p;
+        };
+        const residuals = (v) => {
+            const p = full(v);
+            const camera = cameraOf(p);
+            const projected = projectPoints(camera, world(p.subarray(7)), spec.image, rotationMatrix(p[3], p[4], p[5]));
+            const out = new Float64Array(projected.length * 2);
+            projected.forEach((projection, index) => {
+                // Penalty: a landmark behind the camera.
+                const penalty = Math.max(projection.depth + 0.01, 0) * 1e4;
+                out[2 * index] = projection.u - pixels[index][0] + penalty;
+                out[2 * index + 1] = projection.v - pixels[index][1] + penalty;
+            });
+            return out;
+        };
+        const random = seededRandom(1);
+        const mid = spec.free.map((entry) => (entry.low + entry.high) / 2);
+        const w0 = world(mid);
+        const centre = [0, 0, 0];
+        for (const point of w0)
+            for (let axis = 0; axis < 3; axis += 1)
+                centre[axis] += point[axis] / w0.length;
+        let spread = 0;
+        for (let axis = 0; axis < 3; axis += 1) {
+            const values = w0.map((point) => point[axis]);
+            spread = Math.max(spread, Math.max(...values) - Math.min(...values));
+        }
+        const radius = Math.max(spread, 1e-3);
+        const startsList = [];
+        for (let index = 0; index < startCount; index += 1) {
+            const distance = radius * random.uniform(1.2, 8);
+            const direction = [random.normal(), random.normal(), random.normal()];
+            direction[1] = Math.abs(direction[1]) * random.uniform(0.05, 1.0);
+            const length = Math.hypot(...direction);
+            const pos = [
+                centre[0] + (direction[0] / length) * distance,
+                centre[1] + (direction[1] / length) * distance,
+                centre[2] + (direction[2] / length) * distance,
+            ];
+            const forward = [centre[0] - pos[0], centre[1] - pos[1], centre[2] - pos[2]];
+            const forwardLength = Math.hypot(...forward);
+            const fw = [forward[0] / forwardLength, forward[1] / forwardLength, forward[2] / forwardLength];
+            const p = new Float64Array(names.length);
+            p[0] = pos[0];
+            p[1] = pos[1];
+            p[2] = pos[2];
+            p[3] = Math.atan2(-fw[0], -fw[2]);
+            p[4] = Math.asin(Math.min(Math.max(fw[1], -1), 1));
+            p[6] = random.uniform(10, 70);
+            spec.free.forEach((entry, position) => { p[7 + position] = random.uniform(entry.low, entry.high); });
+            for (const [fixedIndex, value] of fixed)
+                p[fixedIndex] = value;
+            startsList.push(Float64Array.from(variable.map((variableIndex) => p[variableIndex])));
+        }
+        const best = multistart(residuals, startsList, variable.map((index) => low[index]), variable.map((index) => high[index]));
+        const p = full(best.parameters);
+        const camera = cameraOf(p);
+        const projected = projectPoints(camera, world(p.subarray(7)), spec.image);
+        const errors = projected.map((projection, index) => Math.hypot(projection.u - pixels[index][0], projection.v - pixels[index][1]));
+        const rms = Math.sqrt(errors.reduce((total, error) => total + error * error, 0) / errors.length);
+        return { parameters: p, camera, errors, rms };
+    };
+    const solved = run(spec.fix, starts);
+    const p = solved.parameters;
+    const warnings = [];
+    const worldPoints = world(p.subarray(7));
+    const singular = centredSingularValues(worldPoints);
+    const coplanar = singular[2] / Math.max(singular[0], 1e-9) < 0.03;
+    let sensitivity;
+    if (!spec.fix.has('fov')) {
+        sensitivity = [0.6, 0.8, 1.25, 1.6].map((factor) => {
+            const fov = Math.min(Math.max(p[6] * factor, 5), 110);
+            const pinned = new Map(spec.fix);
+            pinned.set('fov', fov);
+            return { fov: roundTo(fov, 1), rmsPx: roundTo(run(pinned, sensitivityStarts).rms, 2) };
+        });
+        const rmsValues = [...sensitivity.map((entry) => entry.rmsPx), solved.rms];
+        const spread = Math.max(...rmsValues) - Math.min(...rmsValues);
+        if (coplanar || spread < 2.0) {
+            warnings.push(`fov is weakly determined (rms only varies ${fixed(spread, 1)} px across fov`
+                + ` ${fixed(sensitivity[0].fov, 1)}..${fixed(sensitivity.at(-1).fov, 1)} deg): `
+                + (coplanar ? 'the landmarks are coplanar. ' : '')
+                + 'Add a landmark off the plane (an object\'s top edge above its base), or pin it with "fix": {"fov": 35}.'
+                + ' Pin a value from the source\'s look: 20-30 tele/product shot, 35-50 normal, 60+ wide/room.');
+        }
+        if (p[6] === 4 || p[6] === 120)
+            warnings.push('fov hit its bound.');
+    }
+    else if (coplanar) {
+        warnings.push('landmarks are coplanar: with fov pinned, distance and height trade against each other;'
+            + ' the result is a consistent view but not unique.');
+    }
+    if (Math.abs(degrees(p[4])) > 75) {
+        warnings.push(`near top-down (pitch ${fixed(degrees(p[4]), 0)} deg): yaw and roll are coupled and pitch is near its bound.`
+            + ' Roll is pinned to 0 (use "solve_roll": true to free it); if rms stays high, check the landmark readings'
+            + ' before blaming the model.');
+    }
+    if (solved.rms > 4) {
+        warnings.push('rms > 4 px: a landmark is misread, the world model is wrong (a circle drawn as an ellipse, an object that is'
+            + ' not flat), or the image is lens-distorted. Drop the worst landmark and re-solve rather than adding more.');
+    }
+    const centre = [0, 0, 0];
+    for (const point of worldPoints)
+        for (let axis = 0; axis < 3; axis += 1)
+            centre[axis] += point[axis] / worldPoints.length;
+    const distance = Math.hypot(p[0] - centre[0], p[1] - centre[1], p[2] - centre[2]);
+    const clip = { near: roundTo(distance / 10, 3), far: roundTo(distance * 4, 3) };
+    const residuals = {};
+    spec.landmarks.forEach((landmark, index) => { residuals[landmark.name] = roundTo(solved.errors[index], 1); });
+    const result = {
+        image: [width, height],
+        pos: [roundTo(p[0], 5), roundTo(p[1], 5), roundTo(p[2], 5)],
+        yawDeg: roundTo(degrees(p[3]), 4),
+        pitchDeg: roundTo(degrees(p[4]), 4),
+        rollDeg: roundTo(degrees(p[5]), 4),
+        vfovDeg: roundTo(p[6], 4),
+        free: Object.fromEntries(freeNames.map((name, index) => [name, roundTo(p[7 + index], 5)])),
+        rmsPx: roundTo(solved.rms, 2),
+        residuals,
+        clip,
+        'camera.js': `export const CAM = { pos: [${fixed(p[0], 5)}, ${fixed(p[1], 5)}, ${fixed(p[2], 5)}],`
+            + ` yawDeg: ${fixed(degrees(p[3]), 4)}, pitchDeg: ${fixed(degrees(p[4]), 4)},`
+            + ` rollDeg: ${fixed(degrees(p[5]), 4)}, vfov: ${fixed(p[6], 4)} };`
+            + `  export const CLIP = { near: ${clip.near}, far: ${clip.far} };`,
+        threejs: `camera.position.set(${fixed(p[0], 5)},${fixed(p[1], 5)},${fixed(p[2], 5)});`
+            + ` camera.rotation.order='YXZ'; camera.rotation.set(${fixed(p[4], 6)},${fixed(p[3], 6)},${fixed(p[5], 6)});`
+            + ` camera.fov=${fixed(p[6], 4)};`,
+    };
+    if (sensitivity)
+        result.fovSensitivity = sensitivity;
+    if (warnings.length)
+        result.warnings = warnings;
+    return result;
+};
+//# sourceMappingURL=camera-solve.js.map

package/dist/scene/camera-solve.js.map

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

package/dist/scene/capture-plan.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Whether a request stays on this machine. Loopback http(s)/ws(s) and local
+ * schemes pass; every other host is a remote request, which capture blocks
+ * and counts.
+ */
+export declare const isLocalRequestUrl: (url: string) => boolean;
+/** Only a page served on this machine can be captured (`12ui scene serve`). */
+export declare const isLoopbackPageUrl: (url: string) => boolean;
+export type CaptureView = {
+    name: string;
+    azimuth: number;
+    elevation: number;
+    actions: Array<{
+        name: string;
+        t: number;
+    }>;
+};
+/**
+ * One view: `name=azimuth:elevation[:action=t,action=t]`, degrees about the
+ * scene pivot and each action's t in 0..1, e.g. `half=0:0:lid=0.5`.
+ */
+export declare const parseCaptureView: (text: string) => CaptureView;
+/** The default set: landing, each orbit angle, and every action at t = 1. */
+export declare const defaultCaptureViews: (orbits: readonly number[], actions: readonly string[]) => CaptureView[];
+export declare const parseOrbits: (text: string) => number[];
+/** Console noise from software GL that says nothing about the scene. */
+export declare const isCaptureNoise: (line: string) => boolean;
+//# sourceMappingURL=capture-plan.d.ts.map

package/dist/scene/capture-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture-plan.d.ts","sourceRoot":"","sources":["../../src/scene/capture-plan.ts"],"names":[],"mappings":"AAWA;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,GAAI,KAAK,MAAM,KAAG,OAW/C,CAAC;AAEF,+EAA+E;AAC/E,eAAO,MAAM,iBAAiB,GAAI,KAAK,MAAM,KAAG,OAO/C,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC7C,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,GAAI,MAAM,MAAM,KAAG,WAqB/C,CAAC;AAEF,6EAA6E;AAC7E,eAAO,MAAM,mBAAmB,GAAI,QAAQ,SAAS,MAAM,EAAE,EAAE,SAAS,SAAS,MAAM,EAAE,KAAG,WAAW,EAItG,CAAC;AAEF,eAAO,MAAM,WAAW,GAAI,MAAM,MAAM,KAAG,MAAM,EAI/C,CAAC;AAEH,wEAAwE;AACxE,eAAO,MAAM,cAAc,GAAI,MAAM,MAAM,KAAG,OAAmD,CAAC"}

package/dist/scene/capture-plan.js

@@ -0,0 +1,79 @@
+import { SceneArgumentError } from './numbers.js';
+/**
+ * The pure half of `12ui scene capture`: which URLs a scene may load, and which
+ * views to shoot. Kept apart from the browser so both are testable without one.
+ */
+const LOOPBACK_HOSTS = new Set(['127.0.0.1', 'localhost', '[::1]', '::1']);
+/** Schemes that never leave the machine: the page's own bytes, not a request. */
+const LOCAL_SCHEMES = new Set(['data:', 'blob:', 'about:', 'file:']);
+/**
+ * Whether a request stays on this machine. Loopback http(s)/ws(s) and local
+ * schemes pass; every other host is a remote request, which capture blocks
+ * and counts.
+ */
+export const isLocalRequestUrl = (url) => {
+    let parsed;
+    try {
+        parsed = new URL(url);
+    }
+    catch {
+        return false;
+    }
+    if (LOCAL_SCHEMES.has(parsed.protocol))
+        return true;
+    if (!['http:', 'https:', 'ws:', 'wss:'].includes(parsed.protocol))
+        return false;
+    const host = parsed.hostname.toLowerCase();
+    return LOOPBACK_HOSTS.has(host) || /^127\.\d{1,3}\.\d{1,3}\.\d{1,3}$/u.test(host) || host.endsWith('.localhost');
+};
+/** Only a page served on this machine can be captured (`12ui scene serve`). */
+export const isLoopbackPageUrl = (url) => {
+    try {
+        const parsed = new URL(url);
+        return ['http:', 'https:'].includes(parsed.protocol) && isLocalRequestUrl(url);
+    }
+    catch {
+        return false;
+    }
+};
+/**
+ * One view: `name=azimuth:elevation[:action=t,action=t]`, degrees about the
+ * scene pivot and each action's t in 0..1, e.g. `half=0:0:lid=0.5`.
+ */
+export const parseCaptureView = (text) => {
+    const equals = text.indexOf('=');
+    const name = equals > 0 ? text.slice(0, equals) : '';
+    if (!/^[A-Za-z0-9._+-]+$/u.test(name)) {
+        throw new SceneArgumentError(`view "${text}" must be name=azimuth:elevation[:action=t,...] with a file-safe name`);
+    }
+    const [az = '0', el = '0', ...rest] = text.slice(equals + 1).split(':');
+    const azimuth = Number(az || '0');
+    const elevation = Number(el || '0');
+    if (!Number.isFinite(azimuth) || !Number.isFinite(elevation)) {
+        throw new SceneArgumentError(`view "${text}": azimuth and elevation must be numbers of degrees`);
+    }
+    const actions = rest.join(':').split(',').filter(Boolean).map((pair) => {
+        const [action, t] = pair.split('=');
+        const value = Number(t);
+        if (!action || t === undefined || !Number.isFinite(value)) {
+            throw new SceneArgumentError(`view "${text}": each action must be name=t with t in 0..1`);
+        }
+        return { name: action, t: value };
+    });
+    return { name, azimuth, elevation, actions };
+};
+/** The default set: landing, each orbit angle, and every action at t = 1. */
+export const defaultCaptureViews = (orbits, actions) => [
+    { name: 'landing', azimuth: 0, elevation: 0, actions: [] },
+    ...orbits.map((azimuth) => ({ name: `az${azimuth > 0 ? '+' : ''}${azimuth}`, azimuth, elevation: 0, actions: [] })),
+    ...actions.map((action) => ({ name: `act-${action}`, azimuth: 0, elevation: 0, actions: [{ name: action, t: 1 }] })),
+];
+export const parseOrbits = (text) => text.split(',').filter(Boolean).map((value) => {
+    const angle = Number(value);
+    if (!Number.isFinite(angle))
+        throw new SceneArgumentError(`--orbit must be comma-separated degrees, got "${text}"`);
+    return angle;
+});
+/** Console noise from software GL that says nothing about the scene. */
+export const isCaptureNoise = (line) => /GPU stall|Clock|ReadPixels/u.test(line);
+//# sourceMappingURL=capture-plan.js.map

package/dist/scene/capture-plan.js.map

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

package/dist/scene/capture.d.ts

@@ -0,0 +1,21 @@
+import { type CaptureView } from './capture-plan.js';
+export type CaptureOptions = {
+    url: string;
+    outDir: string;
+    size: [number, number];
+    orbits: readonly number[];
+    hide: readonly string[];
+    evalScript?: string;
+    views: readonly CaptureView[];
+};
+export type CaptureReport = {
+    written: string[];
+    blocked: string[];
+    fonts: {
+        loaded: number;
+        failed: string[];
+    };
+    console: string[];
+};
+export declare const captureScene: (options: CaptureOptions, log: (line: string) => void) => Promise<CaptureReport>;
+//# sourceMappingURL=capture.d.ts.map

package/dist/scene/capture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture.d.ts","sourceRoot":"","sources":["../../src/scene/capture.ts"],"names":[],"mappings":"AAQA,OAAO,EAIL,KAAK,WAAW,EACjB,MAAM,mBAAmB,CAAC;AAsB3B,MAAM,MAAM,cAAc,GAAG;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvB,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,SAAS,WAAW,EAAE,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAC5C,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC;AAcF,eAAO,MAAM,YAAY,GACvB,SAAS,cAAc,EACvB,KAAK,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,KAC1B,OAAO,CAAC,aAAa,CAwFvB,CAAC"}

package/dist/scene/capture.js

@@ -0,0 +1,118 @@
+import { mkdir } from 'node:fs/promises';
+import path from 'node:path';
+import { isMissingPrototypeBrowserOutput, missingPrototypeBrowserMessage, resolvePrototypeBrowserProvisioning, } from '../prototype-browsers.js';
+import { defaultCaptureViews, isCaptureNoise, isLocalRequestUrl, } from './capture-plan.js';
+/**
+ * Headless captures of a served scene with the CLI's managed Chromium.
+ *
+ * This is where the local-first rule is enforced: every request that would
+ * leave the machine is aborted and counted, and the report says how many and
+ * which fonts loaded, so a remote font or texture is a visible defect rather
+ * than a silent dependency. Nothing is ever downloaded: a missing browser stops
+ * with the managed install command.
+ */
+const SOFTWARE_GL_ARGS = [
+    '--use-angle=swiftshader',
+    '--use-gl=angle',
+    '--enable-unsafe-swiftshader',
+    '--enable-webgl',
+    '--ignore-gpu-blocklist',
+    '--force-color-profile=srgb',
+    '--hide-scrollbars',
+];
+export const captureScene = async (options, log) => {
+    const provisioning = await resolvePrototypeBrowserProvisioning();
+    process.env.PLAYWRIGHT_BROWSERS_PATH = provisioning.browsersPath;
+    const { chromium } = await import('@playwright/test');
+    let browser;
+    try {
+        browser = await chromium.launch({ args: SOFTWARE_GL_ARGS });
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        if (isMissingPrototypeBrowserOutput(message)) {
+            throw new Error(missingPrototypeBrowserMessage({ subject: 'Scene capture', provisioning }));
+        }
+        throw error;
+    }
+    const report = { written: [], blocked: [], fonts: { loaded: 0, failed: [] }, console: [] };
+    try {
+        const page = await browser.newPage({
+            viewport: { width: options.size[0], height: options.size[1] },
+            deviceScaleFactor: 1,
+        });
+        await page.route('**/*', async (route) => {
+            const url = route.request().url();
+            if (isLocalRequestUrl(url)) {
+                await route.continue();
+                return;
+            }
+            report.blocked.push(url);
+            await route.abort('blockedbyclient');
+        });
+        page.on('console', (message) => {
+            if (message.type() === 'error' || message.type() === 'warning') {
+                report.console.push(`[${message.type()}] ${message.text()}`);
+            }
+        });
+        page.on('pageerror', (error) => { report.console.push(`[pageerror] ${error.message}`); });
+        await mkdir(options.outDir, { recursive: true });
+        await page.goto(options.url, { waitUntil: 'load' });
+        await page.waitForFunction(() => window.__ready === true, null, { timeout: 120_000 });
+        await page.evaluate(() => document.fonts.ready.then(() => undefined));
+        await page.waitForTimeout(500);
+        const fonts = await page.evaluate(() => {
+            const faces = [];
+            document.fonts.forEach((face) => { faces.push({ family: face.family, status: face.status }); });
+            return faces;
+        });
+        report.fonts.loaded = fonts.filter((face) => face.status === 'loaded').length;
+        report.fonts.failed = fonts.filter((face) => face.status === 'error').map((face) => face.family);
+        if (options.evalScript)
+            await page.evaluate(options.evalScript);
+        const actions = await page.evaluate(() => window.__scene?.actions ?? []);
+        const views = options.views.length ? options.views : defaultCaptureViews(options.orbits, actions);
+        for (const view of views) {
+            await page.evaluate((v) => {
+                const scene = window.__scene;
+                scene.reset();
+                for (const action of v.actions)
+                    scene.setAction(action.name, action.t);
+                scene.setOrbit(v.azimuth, v.elevation);
+                scene.render();
+            }, view);
+            if (options.hide.length) {
+                await page.evaluate((patterns) => {
+                    const scene = window.__scene;
+                    for (const pattern of patterns)
+                        scene.setVisible?.(pattern, false);
+                    scene.render();
+                }, [...options.hide]);
+            }
+            await page.waitForTimeout(250);
+            const file = path.join(options.outDir, `${view.name}.png`);
+            await page.screenshot({ path: file });
+            report.written.push(file);
+            log(`wrote ${file}`);
+            if (options.hide.length) {
+                await page.evaluate((patterns) => {
+                    const scene = window.__scene;
+                    for (const pattern of patterns)
+                        scene.setVisible?.(pattern, true);
+                }, [...options.hide]);
+            }
+        }
+    }
+    finally {
+        await browser.close();
+    }
+    log(`remote requests blocked: ${report.blocked.length}`);
+    for (const url of report.blocked.slice(0, 10))
+        log(`  blocked ${url}`);
+    log(`fonts: ${report.fonts.loaded} loaded, ${report.fonts.failed.length} failed${report.fonts.failed.length ? `: ${[...new Set(report.fonts.failed)].join(', ')}` : ''}`);
+    const consoleLines = report.console.filter((line) => !isCaptureNoise(line)).slice(0, 30);
+    for (const line of consoleLines)
+        log(line);
+    return report;
+};
+//# sourceMappingURL=capture.js.map

package/dist/scene/capture.js.map

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

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

@@ -0,0 +1,25 @@
+/**
+ * Where does the render differ most from the source, and what colour should a
+ * region be? A port of `sample_colors.py`. Boxes are x0,y0,x1,y1 in SOURCE
+ * pixels, clamped to the image; the render is resized to the source size first.
+ */
+export type Box = [number, number, number, number];
+export type NamedRegion = {
+    name: string;
+    box: Box;
+};
+/** The source colour of one box: the hex to put in a material. */
+export declare const sampleSourceBox: (sourceFile: string, box: Box) => Promise<string>;
+/**
+ * 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 declare const compareWithSource: (args: {
+    sourceFile: string;
+    renderFile: string;
+    exclude: readonly Box[];
+    regions: readonly NamedRegion[];
+}) => Promise<string[]>;
+//# sourceMappingURL=image-colors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"image-colors.d.ts","sourceRoot":"","sources":["../../src/scene/image-colors.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AAEH,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AACnD,MAAM,MAAM,WAAW,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,GAAG,CAAA;CAAE,CAAC;AA8BrD,kEAAkE;AAClE,eAAO,MAAM,eAAe,GAAU,YAAY,MAAM,EAAE,KAAK,GAAG,KAAG,OAAO,CAAC,MAAM,CAKlF,CAAC;AAWF;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAAU,MAAM;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,SAAS,GAAG,EAAE,CAAC;IACxB,OAAO,EAAE,SAAS,WAAW,EAAE,CAAC;CACjC,KAAG,OAAO,CAAC,MAAM,EAAE,CAyDnB,CAAC"}