@hypersoniclabs/helix-cli 0.1.7 → 0.1.24-helix3.438

package/dist/visualQa/commonAsserts.d.ts

@@ -0,0 +1,68 @@
+import type { Frame } from 'playwright';
+import type { VisualQaAssert, VisualQaCategory } from './types';
+export interface SceneStats {
+    meshes: number;
+    visibleMeshes: number;
+    triangles: number;
+    nanMeshes: string[];
+    zeroScaleMeshes: string[];
+    /**
+     * Meshes under an engine-contract hidden template (a weapon's `Shell` ejected-casing node, authored at zero
+     * scale on purpose). Reported for the record; never counted as visible and never a collapsed-transform defect.
+     */
+    hiddenTemplateMeshes?: string[];
+    invisibleMaterialMeshes: string[];
+    materials: number;
+    texturedMaterials: number;
+    vertexColourMeshes: number;
+    distinctColours: number;
+    /** Up to 32 distinct base colours (hex, no #) of untextured materials, for the placeholder check. */
+    colourHexes?: string[];
+    /** World-space bounds of the drawn geometry. */
+    bounds: {
+        min: [number, number, number];
+        max: [number, number, number];
+        size: [number, number, number];
+    } | null;
+}
+/**
+ * Installs `globalThis.__vqaStats(root)` in a frame. Call with the item's own root Object3D:
+ *   await frame.evaluate(() => __vqaStats(myRoot))
+ */
+export declare const INSTALL_SCENE_STATS = "globalThis.__vqaStats = function (root, opts) {\n  opts = opts || {};\n  const out = { meshes: 0, visibleMeshes: 0, triangles: 0, nanMeshes: [], zeroScaleMeshes: [], hiddenTemplateMeshes: [], invisibleMaterialMeshes: [],\n    materials: 0, texturedMaterials: 0, vertexColourMeshes: 0, distinctColours: 0, colourHexes: [], bounds: null };\n  if (!root) return out;\n  root.updateMatrixWorld(true);\n  const mn = [Infinity, Infinity, Infinity], mx = [-Infinity, -Infinity, -Infinity];\n  const mats = new Set(); const colours = new Set();\n  const isVisible = (o) => { for (let p = o; p; p = p.parent) { if (p.visible === false) return false; if (p === root) break; } return true; };\n  const e = new Float64Array(16);\n  // The engine's weapon-shell contract (ShellEjector.registerWeaponShell, GunFxSystem.#resolveShellNode): a node named\n  // exactly \"Shell\" is the ejected-casing TEMPLATE, authored at ZERO scale so the casing never draws on the held or\n  // displayed weapon. Meshes under it are deliberately collapsed, not a transform defect.\n  const underShellTemplate = (o) => {\n    for (let p = o.parent; p; p = p.parent) {\n      if (/^shell$/i.test(p.name || '')) { const s = p.scale; if (s && (Math.abs(s.x) < 1e-6 || Math.abs(s.y) < 1e-6 || Math.abs(s.z) < 1e-6)) return true; }\n      if (p === root) break;\n    }\n    return false;\n  };\n  // VEHICLE BATCHING (engine vehicleBatchedDraw.ts): the runtime packs a car's static parts \u2014 and fitted add-on parts \u2014\n  // into `helix:vehicle-batch:*` BatchedMeshes. Each original mesh stays in the graph with its real transform as a\n  // PROXY whose material clone is `visible = false`; the batch draws it at the proxy's pose. So a proxy whose instance\n  // intends to be visible IS drawn and is measured from its own geometry and matrix, a proxy hidden on purpose (a\n  // hide op) is not drawn, and the batch itself (every part packed in its local frame) is never measured.\n  const proxies = new Map();\n  const sceneRoot = (globalThis.__vqa && globalThis.__vqa.scene) || root;\n  if (sceneRoot && sceneRoot.traverse) {\n    sceneRoot.traverse((b) => { if (b.isBatchedMesh && Array.isArray(b.instances)) for (const inst of b.instances) if (inst && inst.mesh) proxies.set(inst.mesh, inst); });\n  }\n  root.traverse((o) => {\n    if (!o.isMesh || !o.geometry || o.isBatchedMesh) return;\n    out.meshes++;\n    if (!isVisible(o)) return;\n    if (opts.exclude && opts.exclude(o)) return;\n    if (underShellTemplate(o)) { if (out.hiddenTemplateMeshes.length < 40) out.hiddenTemplateMeshes.push(o.name || o.uuid.slice(0, 8)); return; }\n    const g = o.geometry; const pos = g.attributes && g.attributes.position; if (!pos) return;\n    const proxy = proxies.get(o);\n    if (proxy && proxy.visibleIntent === false) return;\n    const ms = Array.isArray(o.material) ? o.material : [o.material];\n    const allInvisible = !proxy && ms.every((m) => !m || m.visible === false || (m.transparent && (m.opacity ?? 1) < 0.02) || m.colorWrite === false);\n    if (allInvisible) { if (out.invisibleMaterialMeshes.length < 40) out.invisibleMaterialMeshes.push(o.name || o.uuid.slice(0, 8)); return; }\n    out.visibleMeshes++;\n    const me = o.matrixWorld.elements; let nan = false; for (let i = 0; i < 16; i++) { e[i] = me[i]; if (!Number.isFinite(me[i])) nan = true; }\n    const sx = Math.hypot(me[0], me[1], me[2]), sy = Math.hypot(me[4], me[5], me[6]), sz = Math.hypot(me[8], me[9], me[10]);\n    if (sx < 1e-6 || sy < 1e-6 || sz < 1e-6) { if (out.zeroScaleMeshes.length < 40) out.zeroScaleMeshes.push(o.name || o.uuid.slice(0, 8)); return; }\n    const idx = g.index ? g.index.array : null;\n    const n = idx ? idx.length : pos.count;\n    const start = (g.drawRange && g.drawRange.start) || 0;\n    const count = Math.min(n - start, (g.drawRange && Number.isFinite(g.drawRange.count)) ? g.drawRange.count : n);\n    out.triangles += Math.floor(count / 3);\n    const step = Math.max(1, Math.floor(count / 20000));\n    const skinned = o.isSkinnedMesh && typeof o.getVertexPosition === 'function';\n    const tmp = skinned ? new (o.position.constructor)() : null;\n    for (let k = start; k < start + count; k += step) {\n      const vi = idx ? idx[k] : k;\n      let x, y, z;\n      if (skinned) { o.getVertexPosition(vi, tmp); x = tmp.x; y = tmp.y; z = tmp.z; }\n      else { x = pos.getX(vi); y = pos.getY(vi); z = pos.getZ(vi); }\n      if (!Number.isFinite(x) || !Number.isFinite(y) || !Number.isFinite(z)) { nan = true; continue; }\n      const wx = e[0] * x + e[4] * y + e[8] * z + e[12];\n      const wy = e[1] * x + e[5] * y + e[9] * z + e[13];\n      const wz = e[2] * x + e[6] * y + e[10] * z + e[14];\n      if (wx < mn[0]) mn[0] = wx; if (wy < mn[1]) mn[1] = wy; if (wz < mn[2]) mn[2] = wz;\n      if (wx > mx[0]) mx[0] = wx; if (wy > mx[1]) mx[1] = wy; if (wz > mx[2]) mx[2] = wz;\n    }\n    if (nan && out.nanMeshes.length < 40) out.nanMeshes.push(o.name || o.uuid.slice(0, 8));\n    if (g.attributes.color) out.vertexColourMeshes++;\n    for (const m of ms) {\n      if (!m || mats.has(m)) continue; mats.add(m);\n      if (m.map || m.emissiveMap || m.normalMap || m.colorNode || m.baseColorMap) out.texturedMaterials++;\n      if (m.color && m.color.getHexString) colours.add(m.color.getHexString());\n    }\n  });\n  out.materials = mats.size; out.distinctColours = colours.size; out.colourHexes = [...colours].slice(0, 32);\n  if (mn[0] <= mx[0]) {\n    const r = (v) => Math.round(v * 10000) / 10000;\n    out.bounds = { min: mn.map(r), max: mx.map(r), size: mx.map((v, i) => r(v - mn[i])) };\n  }\n  return out;\n};";
+export declare function installSceneStats(frame: Frame): Promise<void>;
+/** Size envelope (largest dimension, metres) per category: [min, max]. Deliberately wide — catches 26 cm "outfits"
+ *  and 40 m cars, not taste. Wearables are measured ON the body, so the envelope is the garment's own extent. */
+export declare const SCALE_ENVELOPE: Record<VisualQaCategory, [number, number]>;
+/**
+ * Per-slot MINIMUM for a worn garment, as a fraction of the base body's height, applied to the garment's largest
+ * on-body dimension. The test is "is this the right order of magnitude for the slot" (the 26 cm Male Police Uniform
+ * shipped as an outfit), NOT "is this a full-length garment": a mini dress, crop top, bikini bottom or short skirt is
+ * a short garment and a legitimate one.
+ *
+ * Calibrated 2026-10-02 from the 143 gated garments in these five slots in the whole-catalogue sweep (largest on-body dimension / base
+ * body height, bodies 1.53-1.87 m). Smallest legitimate garment per slot -> the floor, with the lump as the reject:
+ *   outfit/full_body  0.351 (evening dress)      floor 0.25   rejects the 26 cm Police Uniform lump (0.164 of Base Male)
+ *   top               0.163 (bandeau crop top)   floor 0.10
+ *   bottom            0.128 (tankini bottoms)    floor 0.09
+ *   footwear          0.156 (wedge pumps)        floor 0.10   (unchanged: 0.18 m on a 1.75 m body)
+ *   headwear          0.128 (cap)                floor 0.07   (unchanged: 0.12 m on a 1.75 m body)
+ * The old flat minimums (outfit 1.1, top 0.45, bottom 0.6 m) failed 23 legitimate garments: every dress under 1 m,
+ * crop tops and blouses, and every pair of shorts, skirts and tankini bottoms. Relative, because the bases span
+ * 1.53 m (Kemonomimi) to 1.87 m (Sims 4) and a metre value is only right for one of them.
+ */
+export declare const WEARABLE_SLOT_MIN_FRACTION: Record<string, number>;
+/** Body height assumed when the harness could not measure the base (or measured an implausible one). */
+export declare const REFERENCE_BODY_HEIGHT_M = 1.75;
+export interface ImageStats {
+    file: string;
+    lumaStdev: number;
+    meanLuma: number;
+}
+export declare function imageStats(file: string): Promise<ImageStats>;
+export declare function commonAsserts(category: VisualQaCategory, stats: SceneStats, images: ImageStats[], opts?: {
+    subject?: string;
+    slot?: string | null;
+    minTriangles?: number;
+    bodyHeight?: number | null;
+}): VisualQaAssert[];

package/dist/visualQa/commonAsserts.js

@@ -0,0 +1,239 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.REFERENCE_BODY_HEIGHT_M = exports.WEARABLE_SLOT_MIN_FRACTION = exports.SCALE_ENVELOPE = exports.INSTALL_SCENE_STATS = void 0;
+exports.installSceneStats = installSceneStats;
+exports.imageStats = imageStats;
+exports.commonAsserts = commonAsserts;
+// Asserts every category shares: the frame is not empty, the scene has no NaN / invisible geometry, the item is
+// textured, and its size is sane for what it claims to be.
+//
+// Measured on the DRAWN geometry: bounds come from index-referenced vertices (a POSITION accessor's min/max spans the
+// whole uncompacted buffer and has already mis-sized ears, shoes and a tail once), and only meshes that are visible
+// in the scene graph count.
+const sharp_1 = __importDefault(require("sharp"));
+/**
+ * Installs `globalThis.__vqaStats(root)` in a frame. Call with the item's own root Object3D:
+ *   await frame.evaluate(() => __vqaStats(myRoot))
+ */
+exports.INSTALL_SCENE_STATS = `globalThis.__vqaStats = function (root, opts) {
+  opts = opts || {};
+  const out = { meshes: 0, visibleMeshes: 0, triangles: 0, nanMeshes: [], zeroScaleMeshes: [], hiddenTemplateMeshes: [], invisibleMaterialMeshes: [],
+    materials: 0, texturedMaterials: 0, vertexColourMeshes: 0, distinctColours: 0, colourHexes: [], bounds: null };
+  if (!root) return out;
+  root.updateMatrixWorld(true);
+  const mn = [Infinity, Infinity, Infinity], mx = [-Infinity, -Infinity, -Infinity];
+  const mats = new Set(); const colours = new Set();
+  const isVisible = (o) => { for (let p = o; p; p = p.parent) { if (p.visible === false) return false; if (p === root) break; } return true; };
+  const e = new Float64Array(16);
+  // The engine's weapon-shell contract (ShellEjector.registerWeaponShell, GunFxSystem.#resolveShellNode): a node named
+  // exactly "Shell" is the ejected-casing TEMPLATE, authored at ZERO scale so the casing never draws on the held or
+  // displayed weapon. Meshes under it are deliberately collapsed, not a transform defect.
+  const underShellTemplate = (o) => {
+    for (let p = o.parent; p; p = p.parent) {
+      if (/^shell$/i.test(p.name || '')) { const s = p.scale; if (s && (Math.abs(s.x) < 1e-6 || Math.abs(s.y) < 1e-6 || Math.abs(s.z) < 1e-6)) return true; }
+      if (p === root) break;
+    }
+    return false;
+  };
+  // VEHICLE BATCHING (engine vehicleBatchedDraw.ts): the runtime packs a car's static parts — and fitted add-on parts —
+  // into \`helix:vehicle-batch:*\` BatchedMeshes. Each original mesh stays in the graph with its real transform as a
+  // PROXY whose material clone is \`visible = false\`; the batch draws it at the proxy's pose. So a proxy whose instance
+  // intends to be visible IS drawn and is measured from its own geometry and matrix, a proxy hidden on purpose (a
+  // hide op) is not drawn, and the batch itself (every part packed in its local frame) is never measured.
+  const proxies = new Map();
+  const sceneRoot = (globalThis.__vqa && globalThis.__vqa.scene) || root;
+  if (sceneRoot && sceneRoot.traverse) {
+    sceneRoot.traverse((b) => { if (b.isBatchedMesh && Array.isArray(b.instances)) for (const inst of b.instances) if (inst && inst.mesh) proxies.set(inst.mesh, inst); });
+  }
+  root.traverse((o) => {
+    if (!o.isMesh || !o.geometry || o.isBatchedMesh) return;
+    out.meshes++;
+    if (!isVisible(o)) return;
+    if (opts.exclude && opts.exclude(o)) return;
+    if (underShellTemplate(o)) { if (out.hiddenTemplateMeshes.length < 40) out.hiddenTemplateMeshes.push(o.name || o.uuid.slice(0, 8)); return; }
+    const g = o.geometry; const pos = g.attributes && g.attributes.position; if (!pos) return;
+    const proxy = proxies.get(o);
+    if (proxy && proxy.visibleIntent === false) return;
+    const ms = Array.isArray(o.material) ? o.material : [o.material];
+    const allInvisible = !proxy && ms.every((m) => !m || m.visible === false || (m.transparent && (m.opacity ?? 1) < 0.02) || m.colorWrite === false);
+    if (allInvisible) { if (out.invisibleMaterialMeshes.length < 40) out.invisibleMaterialMeshes.push(o.name || o.uuid.slice(0, 8)); return; }
+    out.visibleMeshes++;
+    const me = o.matrixWorld.elements; let nan = false; for (let i = 0; i < 16; i++) { e[i] = me[i]; if (!Number.isFinite(me[i])) nan = true; }
+    const sx = Math.hypot(me[0], me[1], me[2]), sy = Math.hypot(me[4], me[5], me[6]), sz = Math.hypot(me[8], me[9], me[10]);
+    if (sx < 1e-6 || sy < 1e-6 || sz < 1e-6) { if (out.zeroScaleMeshes.length < 40) out.zeroScaleMeshes.push(o.name || o.uuid.slice(0, 8)); return; }
+    const idx = g.index ? g.index.array : null;
+    const n = idx ? idx.length : pos.count;
+    const start = (g.drawRange && g.drawRange.start) || 0;
+    const count = Math.min(n - start, (g.drawRange && Number.isFinite(g.drawRange.count)) ? g.drawRange.count : n);
+    out.triangles += Math.floor(count / 3);
+    const step = Math.max(1, Math.floor(count / 20000));
+    const skinned = o.isSkinnedMesh && typeof o.getVertexPosition === 'function';
+    const tmp = skinned ? new (o.position.constructor)() : null;
+    for (let k = start; k < start + count; k += step) {
+      const vi = idx ? idx[k] : k;
+      let x, y, z;
+      if (skinned) { o.getVertexPosition(vi, tmp); x = tmp.x; y = tmp.y; z = tmp.z; }
+      else { x = pos.getX(vi); y = pos.getY(vi); z = pos.getZ(vi); }
+      if (!Number.isFinite(x) || !Number.isFinite(y) || !Number.isFinite(z)) { nan = true; continue; }
+      const wx = e[0] * x + e[4] * y + e[8] * z + e[12];
+      const wy = e[1] * x + e[5] * y + e[9] * z + e[13];
+      const wz = e[2] * x + e[6] * y + e[10] * z + e[14];
+      if (wx < mn[0]) mn[0] = wx; if (wy < mn[1]) mn[1] = wy; if (wz < mn[2]) mn[2] = wz;
+      if (wx > mx[0]) mx[0] = wx; if (wy > mx[1]) mx[1] = wy; if (wz > mx[2]) mx[2] = wz;
+    }
+    if (nan && out.nanMeshes.length < 40) out.nanMeshes.push(o.name || o.uuid.slice(0, 8));
+    if (g.attributes.color) out.vertexColourMeshes++;
+    for (const m of ms) {
+      if (!m || mats.has(m)) continue; mats.add(m);
+      if (m.map || m.emissiveMap || m.normalMap || m.colorNode || m.baseColorMap) out.texturedMaterials++;
+      if (m.color && m.color.getHexString) colours.add(m.color.getHexString());
+    }
+  });
+  out.materials = mats.size; out.distinctColours = colours.size; out.colourHexes = [...colours].slice(0, 32);
+  if (mn[0] <= mx[0]) {
+    const r = (v) => Math.round(v * 10000) / 10000;
+    out.bounds = { min: mn.map(r), max: mx.map(r), size: mx.map((v, i) => r(v - mn[i])) };
+  }
+  return out;
+};`;
+async function installSceneStats(frame) {
+    await frame.evaluate(exports.INSTALL_SCENE_STATS);
+}
+/** Size envelope (largest dimension, metres) per category: [min, max]. Deliberately wide — catches 26 cm "outfits"
+ *  and 40 m cars, not taste. Wearables are measured ON the body, so the envelope is the garment's own extent. */
+exports.SCALE_ENVELOPE = {
+    vehicle: [1.2, 30],
+    'vehicle-addon': [0.03, 6],
+    'character-addon': [0.02, 1.6],
+    wearable: [0.05, 2.4],
+    avatar: [0.5, 3.5],
+    animation: [0.5, 3.5],
+    scene: [2, 5000],
+    prop: [0.02, 40],
+};
+/**
+ * Per-slot MINIMUM for a worn garment, as a fraction of the base body's height, applied to the garment's largest
+ * on-body dimension. The test is "is this the right order of magnitude for the slot" (the 26 cm Male Police Uniform
+ * shipped as an outfit), NOT "is this a full-length garment": a mini dress, crop top, bikini bottom or short skirt is
+ * a short garment and a legitimate one.
+ *
+ * Calibrated 2026-10-02 from the 143 gated garments in these five slots in the whole-catalogue sweep (largest on-body dimension / base
+ * body height, bodies 1.53-1.87 m). Smallest legitimate garment per slot -> the floor, with the lump as the reject:
+ *   outfit/full_body  0.351 (evening dress)      floor 0.25   rejects the 26 cm Police Uniform lump (0.164 of Base Male)
+ *   top               0.163 (bandeau crop top)   floor 0.10
+ *   bottom            0.128 (tankini bottoms)    floor 0.09
+ *   footwear          0.156 (wedge pumps)        floor 0.10   (unchanged: 0.18 m on a 1.75 m body)
+ *   headwear          0.128 (cap)                floor 0.07   (unchanged: 0.12 m on a 1.75 m body)
+ * The old flat minimums (outfit 1.1, top 0.45, bottom 0.6 m) failed 23 legitimate garments: every dress under 1 m,
+ * crop tops and blouses, and every pair of shorts, skirts and tankini bottoms. Relative, because the bases span
+ * 1.53 m (Kemonomimi) to 1.87 m (Sims 4) and a metre value is only right for one of them.
+ */
+exports.WEARABLE_SLOT_MIN_FRACTION = {
+    outfit: 0.25, full_body: 0.25, top: 0.10, bottom: 0.09, footwear: 0.10, headwear: 0.07,
+};
+/** Body height assumed when the harness could not measure the base (or measured an implausible one). */
+exports.REFERENCE_BODY_HEIGHT_M = 1.75;
+/** A measured base-body height outside this range is a bad measurement (a half-drawn body would shrink every
+ *  floor and fail the check open), so the reference height is used instead. */
+const PLAUSIBLE_BODY_HEIGHT_M = [1.2, 2.3];
+async function imageStats(file) {
+    const s = await (0, sharp_1.default)(file).greyscale().stats();
+    const c = s.channels[0];
+    return { file, lumaStdev: +c.stdev.toFixed(2), meanLuma: +c.mean.toFixed(2) };
+}
+function commonAsserts(category, stats, images, opts = {}) {
+    const subject = opts.subject;
+    const asserts = [];
+    const flat = images.filter((i) => i.lumaStdev < 6 || i.meanLuma < 4 || i.meanLuma > 251);
+    asserts.push({
+        id: 'frame.non_empty',
+        pass: images.length > 0 && flat.length === 0 && stats.visibleMeshes > 0,
+        severity: 'block',
+        subject,
+        detail: images.length === 0
+            ? 'no frames were captured'
+            : flat.length
+                ? `${flat.length} of ${images.length} frames are blank or uniform (luma stdev < 6)`
+                : `${images.length} frames, all with visible content; ${stats.visibleMeshes} visible meshes`,
+        measured: { frames: images.length, flat: flat.map((f) => f.file), visibleMeshes: stats.visibleMeshes },
+    });
+    const invisibleShare = stats.meshes ? stats.invisibleMaterialMeshes.length / stats.meshes : 0;
+    asserts.push({
+        id: 'scene.no_nan_or_invisible',
+        pass: stats.nanMeshes.length === 0 && stats.zeroScaleMeshes.length === 0 && stats.visibleMeshes > 0 && invisibleShare < 0.5
+            && stats.triangles >= (opts.minTriangles ?? 12),
+        severity: 'block',
+        subject,
+        detail: stats.nanMeshes.length
+            ? `NaN/infinite vertex or transform data in ${stats.nanMeshes.length} meshes (${stats.nanMeshes.slice(0, 5).join(', ')})`
+            : stats.zeroScaleMeshes.length
+                ? `${stats.zeroScaleMeshes.length} meshes collapsed to zero scale (${stats.zeroScaleMeshes.slice(0, 5).join(', ')})`
+                : stats.visibleMeshes === 0
+                    ? 'the item has no visible mesh in the scene'
+                    : invisibleShare >= 0.5
+                        ? `${stats.invisibleMaterialMeshes.length}/${stats.meshes} meshes have invisible materials`
+                        : `${stats.visibleMeshes} visible meshes, ${stats.triangles} drawn triangles, no NaN or collapsed transforms`,
+        measured: { ...stats, bounds: undefined },
+    });
+    // Flat-coloured but deliberately coloured items (a black wing, a tan table) are not placeholders; an item that
+    // renders as nothing but default white/light-grey with no maps is. The first blocks, the second only warns.
+    const hasMaps = stats.texturedMaterials > 0 || stats.vertexColourMeshes > 0;
+    const hexes = stats.colourHexes ?? [];
+    const placeholderLike = (hex) => {
+        const n = parseInt(hex, 16);
+        const r = ((n >> 16) & 255) / 255, g = ((n >> 8) & 255) / 255, b = (n & 255) / 255;
+        const max = Math.max(r, g, b), min = Math.min(r, g, b);
+        const sat = max === 0 ? 0 : (max - min) / max;
+        const lum = 0.2126 * r + 0.7152 * g + 0.0722 * b;
+        return sat < 0.08 && lum > 0.55;
+    };
+    const allPlaceholder = !hasMaps && (hexes.length === 0 || hexes.every(placeholderLike));
+    asserts.push({
+        id: 'render.textured',
+        pass: !allPlaceholder,
+        severity: 'block',
+        subject,
+        detail: hasMaps
+            ? `${stats.texturedMaterials}/${stats.materials} materials carry texture maps, ${stats.vertexColourMeshes} meshes have vertex colour`
+            : allPlaceholder
+                ? `no texture maps or vertex colours, and every material is default white/light grey (${hexes.slice(0, 4).join(', ') || 'none'}) — renders as an untextured placeholder`
+                : `no texture maps; ${stats.distinctColours} deliberate flat colour(s) (${hexes.slice(0, 4).join(', ')})`,
+        measured: { materials: stats.materials, textured: stats.texturedMaterials, vertexColour: stats.vertexColourMeshes, colours: hexes },
+    });
+    if (!hasMaps && !allPlaceholder && stats.distinctColours < 3) {
+        asserts.push({
+            id: 'render.flat_shaded',
+            pass: false,
+            severity: 'warn',
+            subject,
+            detail: `untextured: only ${stats.distinctColours} flat colour(s) and no maps — reads as low-detail`,
+            measured: { colours: hexes },
+        });
+    }
+    const size = stats.bounds?.size ?? [0, 0, 0];
+    const largest = Math.max(...size);
+    let [lo, hi] = exports.SCALE_ENVELOPE[category];
+    const slot = opts.slot ? /^character\.([a-z_]+)@/.exec(opts.slot)?.[1] : undefined;
+    const measuredBody = opts.bodyHeight;
+    const bodyKnown = typeof measuredBody === 'number' && measuredBody >= PLAUSIBLE_BODY_HEIGHT_M[0] && measuredBody <= PLAUSIBLE_BODY_HEIGHT_M[1];
+    const bodyHeight = bodyKnown ? measuredBody : exports.REFERENCE_BODY_HEIGHT_M;
+    const slotFraction = category === 'wearable' && slot ? exports.WEARABLE_SLOT_MIN_FRACTION[slot] : undefined;
+    if (slotFraction)
+        lo = Math.round(slotFraction * bodyHeight * 1000) / 1000;
+    asserts.push({
+        id: 'scale.sane_for_category',
+        pass: largest >= lo && largest <= hi,
+        severity: 'block',
+        subject,
+        detail: `largest dimension ${largest.toFixed(3)} m (${size.map((v) => v.toFixed(2)).join(' × ')}); ${category}${slot ? ` ${slot}` : ''} envelope ${lo}–${hi} m`,
+        measured: {
+            size, largest, envelope: [lo, hi], slot: slot ?? null,
+            ...(slotFraction ? { minFractionOfBody: slotFraction, bodyHeight: Math.round(bodyHeight * 1000) / 1000, bodyHeightSource: bodyKnown ? 'measured' : 'reference' } : {}),
+        },
+    });
+    return asserts;
+}
+//# sourceMappingURL=commonAsserts.js.map

package/dist/visualQa/commonAsserts.js.map

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

package/dist/visualQa/contactSheet.d.ts

@@ -0,0 +1,32 @@
+import type { VisualQaAssert, VisualQaCriticResult, VisualQaVerdict } from './types';
+/** Word-wrap to lines of at most `n` characters (a word longer than a line is split). Nothing is dropped. */
+export declare function wrapText(s: string, n: number): string[];
+export interface ContactSheetInput {
+    title: string;
+    subtitle: string;
+    verdict: VisualQaVerdict;
+    reasons: string[];
+    frames: Array<{
+        label: string;
+        bytes: Buffer;
+    }>;
+    asserts: VisualQaAssert[];
+    critic: VisualQaCriticResult | null;
+}
+export declare function renderContactSheet(input: ContactSheetInput): Promise<Buffer>;
+export interface PoseSheetInput {
+    title: string;
+    subtitle: string;
+    /** Every pose id in its fixed order; a pose that could not be made has no bytes and says why. */
+    poses: Array<{
+        id: string;
+        label: string;
+        bytes: Buffer | null;
+        why: string | null;
+    }>;
+}
+/**
+ * The appearance poses on one sheet (`poses.jpg`), in their fixed order, each tile captioned with its id: the picture an
+ * author puts beside the reference photos. A pose that could not be made keeps its tile, grey, with the reason.
+ */
+export declare function renderPoseSheet(input: PoseSheetInput): Promise<Buffer>;

package/dist/visualQa/contactSheet.js

@@ -0,0 +1,153 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.wrapText = wrapText;
+exports.renderContactSheet = renderContactSheet;
+exports.renderPoseSheet = renderPoseSheet;
+// Contact sheet: every frame on one JPEG with its caption, the verdict, and every assert + critic check with its
+// reason. This is what the publisher (and a reviewer) looks at — a verdict without the pictures is not evidence.
+const sharp_1 = __importDefault(require("sharp"));
+const esc = (s) => s.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;');
+const clip = (s, n) => (s.length > n ? `${s.slice(0, n - 1)}…` : s);
+/** Word-wrap to lines of at most `n` characters (a word longer than a line is split). Nothing is dropped. */
+function wrapText(s, n) {
+    const out = [];
+    let line = '';
+    for (let word of s.split(/\s+/).filter(Boolean)) {
+        while (word.length > n) {
+            if (line) {
+                out.push(line);
+                line = '';
+            }
+            out.push(word.slice(0, n));
+            word = word.slice(n);
+        }
+        if (!line)
+            line = word;
+        else if (line.length + 1 + word.length <= n)
+            line += ` ${word}`;
+        else {
+            out.push(line);
+            line = word;
+        }
+    }
+    if (line)
+        out.push(line);
+    return out.length ? out : [''];
+}
+async function renderContactSheet(input) {
+    const W = 1920;
+    const cols = 4;
+    const pad = 12;
+    const tileW = Math.floor((W - pad * (cols + 1)) / cols);
+    const tileH = Math.round(tileW * 0.625);
+    const capLine = 20;
+    const CAP_CHARS = 52;
+    const headerH = 120;
+    const rows = Math.ceil(input.frames.length / cols);
+    // captions are wrapped, never cut: each row is as tall as its longest caption
+    const capLines = input.frames.map((f) => wrapText(f.label, CAP_CHARS));
+    const rowCapH = Array.from({ length: rows }, (_, r) => Math.max(1, ...capLines.slice(r * cols, r * cols + cols).map((l) => l.length)) * capLine + 12);
+    const rowTop = (r) => headerH + pad + rowCapH.slice(0, r).reduce((a, h) => a + tileH + h + pad, 0);
+    const gridH = rows ? rowTop(rows) - headerH : pad;
+    const lines = [];
+    for (const r of input.reasons)
+        lines.push({ ok: false, text: r });
+    for (const a of input.asserts)
+        lines.push({ ok: a.pass ? true : a.severity === 'warn' ? null : false, text: `${a.id}${a.rendition ? ` (${a.rendition})` : ''}${a.subject ? ` [${a.subject.slice(0, 8)}]` : ''} — ${a.detail}` });
+    if (input.critic) {
+        lines.push({ ok: input.critic.overall === 'pass', text: `vision critic (${input.critic.model}) — ${input.critic.summary}` });
+        for (const c of input.critic.checks)
+            lines.push({ ok: c.verdict === 'pass', text: `critic ${c.id} — ${c.reason}` });
+    }
+    const lineH = 22;
+    const LIST_CHARS = 200;
+    const wrapped = lines.map((l) => ({ ...l, rows: wrapText(l.text, LIST_CHARS) }));
+    const listH = wrapped.reduce((n, l) => n + l.rows.length, 0) * lineH + 40;
+    const H = headerH + gridH + listH;
+    const colour = input.verdict === 'pass' ? '#1f9d55' : input.verdict === 'fail' ? '#d64545' : '#c07c1a';
+    // The sheet is generated before server submission, so its badge describes only local capture checks.
+    const badge = input.verdict === 'pass' ? ['CAPTURE CHECKS', 'PASSED'] : input.verdict === 'fail' ? ['CAPTURE CHECKS', 'FAILED'] : ['CAPTURE', 'ERROR'];
+    const tiles = await Promise.all(input.frames.map(async (f) => (0, sharp_1.default)(f.bytes).resize(tileW, tileH, { fit: 'cover' }).jpeg({ quality: 80 }).toBuffer()));
+    const composites = tiles.map((buf, i) => ({
+        input: buf,
+        left: pad + (i % cols) * (tileW + pad),
+        top: rowTop(Math.floor(i / cols)),
+    }));
+    const svg = [
+        `<svg width="${W}" height="${H}" xmlns="http://www.w3.org/2000/svg" font-family="Helvetica, Arial, DejaVu Sans, sans-serif">`,
+        `<rect x="0" y="0" width="${W}" height="${headerH}" fill="#111"/>`,
+        `<rect x="${W - 260}" y="28" width="230" height="64" rx="8" fill="${colour}"/>`,
+        `<text x="${W - 145}" y="54" font-size="19" font-weight="700" fill="#fff" text-anchor="middle">${badge[0]}</text>`,
+        `<text x="${W - 145}" y="79" font-size="25" font-weight="700" fill="#fff" text-anchor="middle">${badge[1]}</text>`,
+        `<text x="24" y="54" font-size="34" font-weight="700" fill="#fff">${esc(clip(input.title, 70))}</text>`,
+        `<text x="24" y="92" font-size="20" fill="#bbb">${esc(clip(input.subtitle, 140))}</text>`,
+        ...input.frames.map((_, i) => {
+            const x = pad + (i % cols) * (tileW + pad);
+            const y = rowTop(Math.floor(i / cols)) + tileH + 18;
+            return capLines[i].map((t, k) => `<text x="${x + 4}" y="${y + k * capLine}" font-size="16" fill="#ddd">${esc(t)}</text>`).join('');
+        }),
+        ...(() => {
+            const out = [];
+            let row = 0;
+            for (const l of wrapped) {
+                const mark = l.ok === true ? '✓' : l.ok === false ? '✗' : '!';
+                const c = l.ok === true ? '#4cc38a' : l.ok === false ? '#ff6b6b' : '#f0b429';
+                l.rows.forEach((t, k) => {
+                    const y = headerH + gridH + 30 + (row + k) * lineH;
+                    out.push(`${k === 0 ? `<text x="24" y="${y}" font-size="16" fill="${c}">${mark}</text>` : ''}<text x="48" y="${y}" font-size="16" fill="#ddd">${esc(t)}</text>`);
+                });
+                row += l.rows.length;
+            }
+            return out;
+        })(),
+        '</svg>',
+    ].join('');
+    return (0, sharp_1.default)({ create: { width: W, height: H, channels: 3, background: '#1b1b1b' } })
+        .composite([{ input: Buffer.from(svg), left: 0, top: 0 }, ...composites])
+        .jpeg({ quality: 82 })
+        .toBuffer();
+}
+/**
+ * The appearance poses on one sheet (`poses.jpg`), in their fixed order, each tile captioned with its id: the picture an
+ * author puts beside the reference photos. A pose that could not be made keeps its tile, grey, with the reason.
+ */
+async function renderPoseSheet(input) {
+    const W = 1920;
+    const cols = 4;
+    const pad = 12;
+    const tileW = Math.floor((W - pad * (cols + 1)) / cols);
+    const tileH = Math.round(tileW * 0.625);
+    const capH = 52;
+    const headerH = 100;
+    const rows = Math.ceil(input.poses.length / cols);
+    const H = headerH + rows * (tileH + capH + pad) + pad;
+    const at = (i) => ({ left: pad + (i % cols) * (tileW + pad), top: headerH + pad + Math.floor(i / cols) * (tileH + capH + pad) });
+    const composites = [];
+    for (const [i, p] of input.poses.entries()) {
+        const buf = p.bytes
+            ? await (0, sharp_1.default)(p.bytes).resize(tileW, tileH, { fit: 'cover' }).jpeg({ quality: 85 }).toBuffer()
+            : await (0, sharp_1.default)({ create: { width: tileW, height: tileH, channels: 3, background: '#3a3a3a' } }).jpeg().toBuffer();
+        composites.push({ input: buf, ...at(i) });
+    }
+    const svg = [
+        `<svg width="${W}" height="${H}" xmlns="http://www.w3.org/2000/svg" font-family="Helvetica, Arial, DejaVu Sans, sans-serif">`,
+        `<rect x="0" y="0" width="${W}" height="${headerH}" fill="#111"/>`,
+        `<text x="24" y="48" font-size="32" font-weight="700" fill="#fff">${esc(clip(input.title, 90))}</text>`,
+        `<text x="24" y="82" font-size="19" fill="#bbb">${esc(clip(input.subtitle, 160))}</text>`,
+        ...input.poses.map((p, i) => {
+            const { left, top } = at(i);
+            const y = top + tileH + 22;
+            const miss = p.bytes ? '' : `<text x="${left + tileW / 2}" y="${top + tileH / 2}" font-size="20" fill="#ddd" text-anchor="middle">not made: ${esc(clip(p.why ?? 'unknown', 60))}</text>`;
+            return `${miss}<text x="${left + 4}" y="${y}" font-size="20" font-weight="700" fill="#fff">${esc(p.id)}</text><text x="${left + 4}" y="${y + 22}" font-size="15" fill="#aaa">${esc(clip(p.label, 70))}</text>`;
+        }),
+        '</svg>',
+    ].join('');
+    return (0, sharp_1.default)({ create: { width: W, height: H, channels: 3, background: '#1b1b1b' } })
+        .composite([...composites, { input: Buffer.from(svg), left: 0, top: 0 }])
+        .jpeg({ quality: 86 })
+        .toBuffer();
+}
+//# sourceMappingURL=contactSheet.js.map

package/dist/visualQa/contactSheet.js.map

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

package/dist/visualQa/critic.d.ts

@@ -0,0 +1,18 @@
+import type { VisualQaCategory, VisualQaCriticLocation, VisualQaCriticResult, VisualQaFrame } from './types';
+export declare const CRITIC_SYSTEM: string;
+/** Mirrors the backend's `VISUAL_QA_LOCATION_*` (helix-backend-api src/continuum/visual-qa/visual-qa.critic.ts). */
+export declare const LOCATION_BODY_PARTS: readonly ["head", "torso", "arm", "hand", "hip", "thigh", "knee", "leg", "foot", "other"];
+export declare const LOCATION_CABIN_PARTS: readonly ["roof", "pillar", "door", "seat", "dash", "wheel", "pedals", "floor", "console", "other"];
+/** Strict parse of one `location` (the schema's shape, nothing more); null when it does not match. */
+export declare function parseCriticLocation(value: unknown): VisualQaCriticLocation | null;
+export interface CriticInput {
+    category: VisualQaCategory;
+    title: string;
+    /** Extra context for the critic: what the item is, which host/base each frame shows. */
+    context?: string;
+    frames: Array<VisualQaFrame & {
+        bytes?: Buffer;
+    }>;
+    bundleDir?: string;
+}
+export declare function runCritic(input: CriticInput): Promise<VisualQaCriticResult>;