@metamesh/cli 0.0.0-stage → 0.14.0

package/dist/authoring/render-scene.js

@@ -0,0 +1,139 @@
+import { Box3, BufferAttribute, BufferGeometry, Color, DirectionalLight, Group, HemisphereLight, Mesh, MeshStandardMaterial, OrthographicCamera, Scene, Vector3, } from "three";
+/** @internal Owns one capture's GPU-independent scene resources. */
+export function createCaptureScene(input, resources) {
+    const scene = new Scene();
+    if (input.background !== "transparent")
+        scene.background = new Color(input.background);
+    const group = new Group();
+    const geometries = new Map();
+    const materials = [];
+    function dispose() {
+        for (const geometry of geometries.values())
+            geometry.dispose();
+        for (const material of materials)
+            material.dispose();
+        scene.clear();
+    }
+    try {
+        for (const resource of resources) {
+            if (geometries.has(resource.id))
+                throw new Error(`Duplicate geometry resource ${resource.id}.`);
+            if (resource.positions.length === 0 ||
+                resource.positions.length % 3 !== 0 ||
+                resource.indices.length === 0 ||
+                resource.indices.length % 3 !== 0 ||
+                !resource.positions.every(Number.isFinite) ||
+                resource.indices.some((index) => index >= resource.positions.length / 3)) {
+                throw new Error(`Invalid rendering buffers for resource ${resource.id}.`);
+            }
+            const geometry = new BufferGeometry();
+            geometry.setAttribute("position", new BufferAttribute(resource.positions, 3));
+            geometry.setIndex(new BufferAttribute(resource.indices, 1));
+            geometry.computeVertexNormals();
+            geometries.set(resource.id, geometry);
+        }
+        for (const part of input.parts) {
+            const geometry = geometries.get(part.resourceId);
+            if (!geometry)
+                throw new Error(`Part ${part.id} refers to an unknown geometry resource.`);
+            if (part.position.length !== 3 ||
+                part.rotation.length !== 3 ||
+                !part.position.every(Number.isFinite) ||
+                !part.rotation.every(Number.isFinite)) {
+                throw new Error(`Part ${part.id} requires finite XYZ placement.`);
+            }
+            if (part.color !== undefined && !/^#[\da-f]{6}$/i.test(part.color)) {
+                throw new Error(`Part ${part.id} requires a six-digit RGB color.`);
+            }
+            const material = new MeshStandardMaterial({
+                color: part.color ?? "#94a3b8",
+                roughness: 0.72,
+                metalness: 0,
+                flatShading: true,
+            });
+            materials.push(material);
+            const mesh = new Mesh(geometry, material);
+            mesh.name = part.id;
+            mesh.position.set(...part.position);
+            // Fixed global X, then Y, then Z is the ZYX intrinsic Euler convention.
+            mesh.rotation.set((part.rotation[0] * Math.PI) / 180, (part.rotation[1] * Math.PI) / 180, (part.rotation[2] * Math.PI) / 180, "ZYX");
+            group.add(mesh);
+        }
+        scene.add(group);
+        group.updateMatrixWorld(true);
+        const bounds = new Box3().setFromObject(group, true);
+        if (bounds.isEmpty())
+            throw new Error("Cannot render a captured model with no geometry.");
+        const ambient = new HemisphereLight(0xffffff, 0x64748b, 2.1);
+        ambient.position.set(0, 0, 1);
+        const key = new DirectionalLight(0xffffff, 2.4);
+        key.position.set(2, -3, 5);
+        const fill = new DirectionalLight(0xffffff, 0.8);
+        fill.position.set(-3, 1, 2);
+        scene.add(ambient, key, fill);
+        return { scene, group, bounds, dispose };
+    }
+    catch (error) {
+        dispose();
+        throw error;
+    }
+}
+/** @internal Fits every world-bounds corner in the selected orthographic view. */
+export function createCaptureCamera(bounds, view, width, height) {
+    const target = bounds.getCenter(new Vector3());
+    const diagonal = Math.max(bounds.getSize(new Vector3()).length(), 0.001);
+    const direction = new Vector3(...viewDirection(view)).normalize();
+    const camera = new OrthographicCamera(-1, 1, 1, -1, diagonal * 0.01, diagonal * 8);
+    camera.up.set(0, view === "top" ? 1 : 0, view === "top" ? 0 : 1);
+    camera.position.copy(target).addScaledVector(direction, diagonal * 3);
+    camera.lookAt(target);
+    camera.updateMatrixWorld(true);
+    let halfWidth = 0;
+    let halfHeight = 0;
+    for (const x of [bounds.min.x, bounds.max.x]) {
+        for (const y of [bounds.min.y, bounds.max.y]) {
+            for (const z of [bounds.min.z, bounds.max.z]) {
+                const point = new Vector3(x, y, z).applyMatrix4(camera.matrixWorldInverse);
+                halfWidth = Math.max(halfWidth, Math.abs(point.x));
+                halfHeight = Math.max(halfHeight, Math.abs(point.y));
+            }
+        }
+    }
+    const aspect = width / height;
+    halfHeight = Math.max(halfHeight, halfWidth / aspect, diagonal * 0.001) * 1.12;
+    halfWidth = halfHeight * aspect;
+    camera.left = -halfWidth;
+    camera.right = halfWidth;
+    camera.top = halfHeight;
+    camera.bottom = -halfHeight;
+    camera.updateProjectionMatrix();
+    return {
+        camera,
+        record: {
+            position: camera.position.toArray(),
+            target: target.toArray(),
+            up: camera.up.toArray(),
+            frustum: {
+                left: camera.left,
+                right: camera.right,
+                top: camera.top,
+                bottom: camera.bottom,
+                near: camera.near,
+                far: camera.far,
+            },
+        },
+    };
+}
+function viewDirection(view) {
+    switch (view) {
+        case "isometric":
+            return [1, -1, 1];
+        case "front":
+            return [0, -1, 0];
+        case "top":
+            return [0, 0, 1];
+        case "right":
+            return [1, 0, 0];
+    }
+}
+//# sourceMappingURL=render-scene.js.map

package/dist/authoring/render-scene.js.map

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

package/dist/authoring/render-types.d.ts

@@ -0,0 +1,81 @@
+/** Standard orthographic views in MetaMesh's Z-up coordinate system. */
+export type RenderView = "isometric" | "front" | "top" | "right";
+/** Image encodings; WebP is always lossless. */
+export type RenderFormat = "png" | "webp";
+/** Options for rendering a previously captured model, without executing author code. */
+export interface RenderOptions {
+    readonly views?: readonly RenderView[];
+    readonly width?: number;
+    readonly height?: number;
+    readonly format?: RenderFormat;
+    readonly background?: "transparent" | `#${string}`;
+    /** Parent for a new unique capture directory; defaults to the run's renders directory. */
+    readonly outputDirectory?: string;
+    /** Browser startup, page readiness, and capture deadline; defaults to 30 seconds. */
+    readonly timeoutMs?: number;
+}
+/** Recorded orthographic camera, expressed in millimetres and world coordinates. */
+export interface RenderCamera {
+    readonly position: readonly [number, number, number];
+    readonly target: readonly [number, number, number];
+    readonly up: readonly [number, number, number];
+    readonly frustum: {
+        readonly left: number;
+        readonly right: number;
+        readonly top: number;
+        readonly bottom: number;
+        readonly near: number;
+        readonly far: number;
+    };
+}
+/** A view and its provenance, also written beside the image as JSON. */
+export interface RenderedImage {
+    readonly path: string;
+    readonly metadataPath: string;
+    readonly runId: string;
+    readonly sourceFingerprint: string;
+    readonly view: RenderView;
+    readonly width: number;
+    readonly height: number;
+    readonly format: RenderFormat;
+    readonly background: string;
+    readonly camera: RenderCamera;
+    readonly rendererRevision: string;
+    readonly browserVersion: string;
+}
+/** Images always belong to one captured run and one unique output directory. */
+export interface RenderResult {
+    readonly runId: string;
+    readonly sourceFingerprint: string;
+    readonly directory: string;
+    readonly images: readonly RenderedImage[];
+}
+/** @internal Plain-data scene descriptor served only to the isolated capture page. */
+export interface CaptureScene {
+    readonly resources: readonly {
+        readonly id: string;
+        readonly positionsUrl: string;
+        readonly indicesUrl: string;
+    }[];
+    readonly parts: readonly {
+        readonly id: string;
+        readonly resourceId: string;
+        readonly position: readonly [number, number, number];
+        readonly rotation: readonly [number, number, number];
+        readonly color?: string;
+    }[];
+    readonly width: number;
+    readonly height: number;
+    readonly background: string;
+}
+/** @internal Browser readiness is explicit so failed/blank frames cannot be captured. */
+export type CaptureState = {
+    readonly status: "loading";
+} | {
+    readonly status: "ready";
+    readonly camera: RenderCamera;
+} | {
+    readonly status: "error";
+    readonly message: string;
+};
+//# sourceMappingURL=render-types.d.ts.map

package/dist/authoring/render-types.d.ts.map

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

package/dist/authoring/render-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=render-types.js.map

package/dist/authoring/render-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-types.js","sourceRoot":"","sources":["../../src/authoring/render-types.ts"],"names":[],"mappings":""}

package/dist/authoring/render.d.ts

@@ -0,0 +1,23 @@
+import type { RenderFormat, RenderOptions, RenderResult, RenderView } from "./render-types.js";
+/** Revision of the capture scene, lighting, framing, and encoding policy. */
+export declare const RENDERER_REVISION = "1";
+/** @internal Shared by command parsing and the reusable renderer. */
+export declare function resolveRenderOptions(options?: RenderOptions): {
+    readonly views: readonly RenderView[];
+    readonly width: number;
+    readonly height: number;
+    readonly format: RenderFormat;
+    readonly background: string;
+    readonly timeoutMs: number;
+};
+/** Explicit installation of this package's pinned Chromium. Never called by render. */
+export declare function installAuthoringBrowser(): Promise<{
+    browser: "chromium";
+    executablePath: string;
+}>;
+/**
+ * Render validated persisted local geometry and placements. Source code is never imported,
+ * and a fresh capture directory prevents overlapping calls from overwriting evidence.
+ */
+export declare function renderCapturedRun(directory: string, options?: RenderOptions): Promise<RenderResult>;
+//# sourceMappingURL=render.d.ts.map

package/dist/authoring/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/authoring/render.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAIV,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,UAAU,EACX,MAAM,mBAAmB,CAAC;AAG3B,6EAA6E;AAC7E,eAAO,MAAM,iBAAiB,MAAM,CAAC;AAGrC,qEAAqE;AACrE,wBAAgB,oBAAoB,CAAC,OAAO,GAAE,aAAkB,GAAG;IACjE,QAAQ,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,CAAC;IACtC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B,CAkDA;AAED,uFAAuF;AACvF,wBAAsB,uBAAuB,IAAI,OAAO,CAAC;IACvD,OAAO,EAAE,UAAU,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC,CAuBD;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,YAAY,CAAC,CAkJvB"}

package/dist/authoring/render.js

@@ -0,0 +1,243 @@
+import { spawn } from "node:child_process";
+import { mkdir, mkdtemp, readFile, rename, rm, writeFile } from "node:fs/promises";
+import { createServer } from "node:http";
+import { createRequire } from "node:module";
+import { dirname, join, resolve } from "node:path";
+import { readCapturedRun } from "./artifacts.js";
+import { AuthoringError } from "./errors.js";
+/** Revision of the capture scene, lighting, framing, and encoding policy. */
+export const RENDERER_REVISION = "1";
+const VIEWS = ["isometric", "front", "top", "right"];
+/** @internal Shared by command parsing and the reusable renderer. */
+export function resolveRenderOptions(options = {}) {
+    const views = options.views ?? ["isometric"];
+    if (views.length === 0 ||
+        views.length > 4 ||
+        new Set(views).size !== views.length ||
+        views.some((view) => !VIEWS.includes(view))) {
+        throw new AuthoringError("invocation", "INVALID_RENDER_VIEW", "Choose distinct views from isometric, front, top, and right.");
+    }
+    const width = options.width ?? 1024;
+    const height = options.height ?? 1024;
+    for (const value of [width, height]) {
+        if (!Number.isInteger(value) || value < 16 || value > 4096) {
+            throw new AuthoringError("invocation", "INVALID_RENDER_SIZE", "Image width and height must be integers from 16 to 4096 pixels.");
+        }
+    }
+    const format = options.format ?? "png";
+    if (format !== "png" && format !== "webp") {
+        throw new AuthoringError("invocation", "INVALID_RENDER_FORMAT", "Image format must be png or webp.");
+    }
+    const background = options.background ?? "#f1f5f9";
+    if (background !== "transparent" && !/^#[\da-f]{6}$/i.test(background)) {
+        throw new AuthoringError("invocation", "INVALID_RENDER_BACKGROUND", "Background must be transparent or a six-digit RGB color.");
+    }
+    const timeoutMs = options.timeoutMs ?? 30_000;
+    if (!Number.isSafeInteger(timeoutMs) || timeoutMs < 1 || timeoutMs > 300_000) {
+        throw new AuthoringError("invocation", "INVALID_RENDER_TIMEOUT", "Render timeout must be an integer from 1 to 300000 milliseconds.");
+    }
+    return { views, width, height, format, background, timeoutMs };
+}
+/** Explicit installation of this package's pinned Chromium. Never called by render. */
+export async function installAuthoringBrowser() {
+    const require = createRequire(import.meta.url);
+    const cli = join(dirname(require.resolve("playwright/package.json")), "cli.js");
+    await new Promise((resolveInstall, reject) => {
+        const child = spawn(process.execPath, [cli, "install", "chromium"], {
+            stdio: ["ignore", 2, 2],
+            windowsHide: true,
+        });
+        child.once("error", reject);
+        child.once("exit", (code) => {
+            if (code === 0)
+                resolveInstall();
+            else
+                reject(new AuthoringError("environment", "BROWSER_INSTALL_FAILED", `Chromium installation exited with code ${code ?? "unknown"}.`));
+        });
+    });
+    const { chromium } = await import("playwright");
+    return { browser: "chromium", executablePath: chromium.executablePath() };
+}
+/**
+ * Render validated persisted local geometry and placements. Source code is never imported,
+ * and a fresh capture directory prevents overlapping calls from overwriting evidence.
+ */
+export async function renderCapturedRun(directory, options = {}) {
+    const settings = resolveRenderOptions(options);
+    const run = await readCapturedRun(directory);
+    const { chromium } = await import("playwright");
+    let client;
+    try {
+        client = await readFile(new URL("../../dist/authoring/capture/render-client.js", import.meta.url));
+    }
+    catch {
+        throw new AuthoringError("environment", "RENDERER_NOT_BUILT", "The packaged capture page is missing. Rebuild @metamesh/cli before rendering.");
+    }
+    const scene = {
+        ...settings,
+        resources: run.resources.map((resource, index) => ({
+            id: resource.id,
+            positionsUrl: `/buffers/${index}/positions`,
+            indicesUrl: `/buffers/${index}/indices`,
+        })),
+        parts: run.manifest.parts,
+    };
+    const server = captureServer(run, scene, client);
+    let browser;
+    let output;
+    const started = Date.now();
+    const remaining = () => {
+        const value = settings.timeoutMs - (Date.now() - started);
+        if (value <= 0)
+            throw new AuthoringError("render", "RENDER_TIMEOUT", "Rendering exceeded its capture deadline.");
+        return value;
+    };
+    try {
+        const origin = await listen(server);
+        try {
+            // Headless launch resolves Playwright's pinned shell. executablePath() instead
+            // names the full browser, which CI's explicit --only-shell install omits.
+            browser = await chromium.launch({
+                headless: true,
+                timeout: remaining(),
+                args: [
+                    "--use-angle=swiftshader",
+                    "--enable-unsafe-swiftshader",
+                    "--force-color-profile=srgb",
+                ],
+            });
+        }
+        catch (error) {
+            if (error instanceof Error &&
+                /Executable doesn't exist|playwright install/u.test(error.message)) {
+                throw new AuthoringError("environment", "BROWSER_NOT_INSTALLED", "Rendering needs the pinned Chromium. Run `metamesh browser install` explicitly, then retry.");
+            }
+            throw error;
+        }
+        const context = await browser.newContext({
+            viewport: { width: settings.width, height: settings.height },
+            deviceScaleFactor: 1,
+            colorScheme: "light",
+            reducedMotion: "reduce",
+        });
+        const page = await context.newPage();
+        await page.goto(origin, { waitUntil: "load", timeout: remaining() });
+        await page.waitForFunction(() => globalThis.metameshCaptureState?.status !== undefined &&
+            globalThis.metameshCaptureState.status !== "loading", undefined, { timeout: remaining() });
+        const initial = await page.evaluate(() => globalThis.metameshCaptureState);
+        if (initial.status === "error")
+            throw new AuthoringError("render", "CAPTURE_FAILED", initial.message);
+        const parent = resolve(options.outputDirectory ?? join(run.directory, "renders"));
+        await mkdir(parent, { recursive: true });
+        output = await mkdtemp(join(parent, "capture-"));
+        const images = [];
+        for (const view of settings.views) {
+            const state = await page.evaluate((selected) => {
+                globalThis.metameshCaptureView(selected);
+                return globalThis.metameshCaptureState;
+            }, view);
+            if (state.status !== "ready")
+                throw new AuthoringError("render", "CAPTURE_FAILED", state.status === "error" ? state.message : "Capture frame is not ready.");
+            const path = join(output, `${view}.${settings.format}`);
+            const metadataPath = join(output, `${view}.json`);
+            await page.screenshot({
+                path,
+                type: settings.format,
+                ...(settings.format === "webp" ? { quality: 100 } : {}),
+                omitBackground: settings.background === "transparent",
+                animations: "disabled",
+                timeout: remaining(),
+            });
+            const image = {
+                path,
+                metadataPath,
+                runId: run.manifest.runId,
+                sourceFingerprint: run.manifest.source.fingerprint,
+                view,
+                width: settings.width,
+                height: settings.height,
+                format: settings.format,
+                background: settings.background,
+                camera: state.camera,
+                rendererRevision: RENDERER_REVISION,
+                browserVersion: browser.version(),
+            };
+            await writeFile(`${metadataPath}.tmp`, `${JSON.stringify(image, null, 2)}\n`);
+            await rename(`${metadataPath}.tmp`, metadataPath);
+            images.push(image);
+        }
+        return {
+            runId: run.manifest.runId,
+            sourceFingerprint: run.manifest.source.fingerprint,
+            directory: output,
+            images,
+        };
+    }
+    catch (error) {
+        if (output)
+            await rm(output, { recursive: true, force: true });
+        if (error instanceof AuthoringError)
+            throw error;
+        throw new AuthoringError("render", "CAPTURE_FAILED", error instanceof Error ? error.message : String(error));
+    }
+    finally {
+        await browser?.close();
+        await close(server);
+    }
+}
+function captureServer(run, scene, client) {
+    const buffers = new Map();
+    for (const [index, resource] of run.resources.entries()) {
+        buffers.set(`/buffers/${index}/positions`, Buffer.from(resource.positions.buffer, resource.positions.byteOffset, resource.positions.byteLength));
+        buffers.set(`/buffers/${index}/indices`, Buffer.from(resource.indices.buffer, resource.indices.byteOffset, resource.indices.byteLength));
+    }
+    const html = '<!doctype html><html><head><meta charset="utf-8"><style>html,body{margin:0;overflow:hidden;background:transparent}canvas{display:block}</style></head><body><script src="/render-client.js"></script></body></html>';
+    const json = JSON.stringify(scene);
+    return createServer((request, response) => {
+        response.setHeader("Cache-Control", "no-store");
+        response.setHeader("Content-Security-Policy", "default-src 'none'; script-src 'self'; connect-src 'self'; style-src 'unsafe-inline'");
+        const path = request.url;
+        if (request.method !== "GET") {
+            response.writeHead(405).end();
+        }
+        else if (path === "/") {
+            response.setHeader("Content-Type", "text/html; charset=utf-8");
+            response.end(html);
+        }
+        else if (path === "/scene.json") {
+            response.setHeader("Content-Type", "application/json");
+            response.end(json);
+        }
+        else if (path === "/render-client.js") {
+            response.setHeader("Content-Type", "text/javascript; charset=utf-8");
+            response.end(client);
+        }
+        else if (path && buffers.has(path)) {
+            response.setHeader("Content-Type", "application/octet-stream");
+            response.end(buffers.get(path));
+        }
+        else {
+            response.writeHead(404).end();
+        }
+    });
+}
+async function listen(server) {
+    return new Promise((resolveListen, reject) => {
+        server.once("error", reject);
+        server.listen(0, "127.0.0.1", () => {
+            server.removeListener("error", reject);
+            const address = server.address();
+            if (!address || typeof address === "string")
+                reject(new Error("Capture server has no TCP address."));
+            else
+                resolveListen(`http://127.0.0.1:${address.port}`);
+        });
+    });
+}
+async function close(server) {
+    if (!server.listening)
+        return;
+    server.closeAllConnections();
+    await new Promise((resolveClose, reject) => server.close((error) => (error ? reject(error) : resolveClose())));
+}
+//# sourceMappingURL=render.js.map

package/dist/authoring/render.js.map

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

package/dist/authoring/run.d.ts

@@ -0,0 +1,7 @@
+import type { AuthoringFailure, RunOptions, RunSuccess } from "./types.js";
+/**
+ * Checks and executes trusted local source in a disposable child, then captures its finalized geometry.
+ * Returns a success or failure envelope for this fresh attempt; failed attempts cannot be rendered.
+ */
+export declare function runAuthoringSource(options: RunOptions): Promise<RunSuccess | AuthoringFailure>;
+//# sourceMappingURL=run.d.ts.map

package/dist/authoring/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/authoring/run.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AA2N3E;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,UAAU,GAClB,OAAO,CAAC,UAAU,GAAG,gBAAgB,CAAC,CA2HxC"}