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

package/dist/vehicle/paintHue.js

@@ -0,0 +1,248 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PAINT_LIMITS = exports.hexToHue = void 0;
+exports.hexToRgb = hexToRgb;
+exports.rgbHue = rgbHue;
+exports.hueDistanceDeg = hueDistanceDeg;
+exports.rgbToHsv = rgbToHsv;
+exports.paintReference = paintReference;
+exports.samplePaintView = samplePaintView;
+exports.paintFixAdvice = paintFixAdvice;
+exports.rgbToHex = rgbToHex;
+exports.judgePaint = judgePaint;
+/**
+ * Body-paint gate: does the RENDERED body read as the reference colour in the light Try Now draws it in?
+ *
+ * WHY. Rounds 3, 5 and 8 all shipped a car whose authored paint was a red but whose Try Now daylight frame read orange /
+ * salmon with a white bonnet hotspot. The first gate sampled the fixed `side` pose, which hides the world's local
+ * lights and sits on a plain backdrop, and judged hue alone: it passed the round-8 F40 (8 degrees off) while the owner
+ * measured saturation 0.70 (0.39 under glare) against 0.85-0.88 in the reference photos.
+ *
+ * HOW. The route renders the BODY PAINT ALONE (every other mesh hidden) from the six exterior pose cameras in the real
+ * test-grounds world, with its sun, environment, exposure, tone mapping and local lights untouched, plus the same camera
+ * with the paint hidden too; the pixels that differ are the paint (vehicle.ts `paint` phase). Here those pixels are
+ * judged against the reference colour: hue (chromatic paints), saturation, lightness and highlight wash. Neutral
+ * paints (white, silver, grey, black) have no hue, so tint and lightness are judged instead.
+ *
+ * Deterministic: fixed cameras, a fixed 2 px edge ring dropped, medians over views.
+ */
+const sharp_1 = __importDefault(require("sharp"));
+/** Reference paint colour: `#rrggbb` or `rrggbb`. Throws on a malformed value. */
+function hexToRgb(hex) {
+    const m = /^#?([0-9a-f]{6})$/i.exec(hex.trim());
+    if (!m)
+        throw new Error(`--reference-paint must be #rrggbb or rrggbb, got "${hex}"`);
+    const v = parseInt(m[1], 16);
+    return { r: (v >> 16) & 0xff, g: (v >> 8) & 0xff, b: v & 0xff };
+}
+/** Hue in degrees (0..360) of an RGB triple, in [0..255]. */
+function rgbHue(r, g, b) {
+    const rn = r / 255, gn = g / 255, bn = b / 255;
+    const max = Math.max(rn, gn, bn);
+    const min = Math.min(rn, gn, bn);
+    const delta = max - min;
+    if (delta === 0)
+        return 0;
+    let h;
+    if (max === rn)
+        h = 60 * (((gn - bn) / delta) % 6);
+    else if (max === gn)
+        h = 60 * ((bn - rn) / delta + 2);
+    else
+        h = 60 * ((rn - gn) / delta + 4);
+    return h < 0 ? h + 360 : h;
+}
+const hexToHue = (hex) => {
+    const { r, g, b } = hexToRgb(hex);
+    return rgbHue(r, g, b);
+};
+exports.hexToHue = hexToHue;
+/** Circular distance between two hues, in degrees (0..180). */
+function hueDistanceDeg(a, b) {
+    const d = Math.abs(a - b) % 360;
+    return Math.min(d, 360 - d);
+}
+function rgbToHsv(r, g, b) {
+    const max = Math.max(r, g, b) / 255, min = Math.min(r, g, b) / 255;
+    return { h: rgbHue(r, g, b), s: max === 0 ? 0 : (max - min) / max, v: max };
+}
+/** Reference paint colour -> what to judge. Under 0.2 saturation (white, silver, grey, black) hue is undefined, so only lightness and tint are judged. */
+function paintReference(hex) {
+    const rgb = hexToRgb(hex);
+    const hsv = rgbToHsv(rgb.r, rgb.g, rgb.b);
+    return { rgb, hsv, kind: hsv.s >= 0.2 && hsv.v >= 0.12 ? 'chromatic' : 'neutral' };
+}
+const median = (xs) => { if (!xs.length)
+    return 0; const a = [...xs].sort((x, y) => x - y); return a[Math.floor(a.length / 2)]; };
+/** Pixels that differ between the paint frame and the empty frame, minus a 2 px ring at the silhouette edge. */
+async function paintMask(paint, empty) {
+    const a = await (0, sharp_1.default)(paint).removeAlpha().raw().toBuffer({ resolveWithObject: true });
+    const b = await (0, sharp_1.default)(empty).removeAlpha().raw().toBuffer({ resolveWithObject: true });
+    if (a.info.width !== b.info.width || a.info.height !== b.info.height)
+        throw new Error('paint frame and empty frame differ in size');
+    const { width: w, height: h, channels: ch } = a.info;
+    // The backdrop can sit a few levels off between two frames (the sky is drawn per camera angle), so the shift is read where the
+    // car never reaches, the outer 12 px of the frame (the poses fill 82% of it), and removed before the two are compared.
+    const bias = [0, 0, 0];
+    for (let c = 0; c < 3; c++) {
+        const ds = [];
+        for (let y = 0; y < h; y += 3)
+            for (let x = 0; x < w; x += 3) {
+                if (x >= 12 && x < w - 12 && y >= 12 && y < h - 12)
+                    continue;
+                ds.push(a.data[(y * w + x) * ch + c] - b.data[(y * w + x) * ch + c]);
+            }
+        bias[c] = median(ds);
+    }
+    const raw = new Uint8Array(w * h);
+    for (let i = 0; i < w * h; i++) {
+        const d = Math.max(Math.abs(a.data[i * ch] - b.data[i * ch] - bias[0]), Math.abs(a.data[i * ch + 1] - b.data[i * ch + 1] - bias[1]), Math.abs(a.data[i * ch + 2] - b.data[i * ch + 2] - bias[2]));
+        raw[i] = d > 16 ? 1 : 0;
+    }
+    const mask = new Uint8Array(w * h);
+    const R = 2;
+    for (let y = R; y < h - R; y++)
+        for (let x = R; x < w - R; x++) {
+            let all = 1;
+            for (let dy = -R; dy <= R && all; dy++)
+                for (let dx = -R; dx <= R; dx++)
+                    if (!raw[(y + dy) * w + x + dx]) {
+                        all = 0;
+                        break;
+                    }
+            mask[y * w + x] = all;
+        }
+    return { data: a.data, w, h, ch, mask };
+}
+async function samplePaintView(view, ref) {
+    const { data, w, h, ch, mask } = await paintMask(view.paint, view.empty);
+    let sumX = 0, sumY = 0, sumW = 0, clipped = 0, washed = 0, n = 0;
+    const sats = [], vals = [];
+    for (let i = 0; i < w * h; i++) {
+        if (!mask[i])
+            continue;
+        const r = data[i * ch], g = data[i * ch + 1], b = data[i * ch + 2];
+        const { h: hue, s, v } = rgbToHsv(r, g, b);
+        n++;
+        sats.push(s);
+        vals.push(v);
+        if (Math.max(r, g, b) >= 250)
+            clipped++;
+        if (ref.kind === 'chromatic' ? (v >= 0.8 && s < ref.hsv.s * 0.5) : (Math.min(r, g, b) >= 245))
+            washed++;
+        if (s >= 0.2) {
+            const rad = hue * Math.PI / 180;
+            sumX += s * Math.cos(rad);
+            sumY += s * Math.sin(rad);
+            sumW += s;
+        }
+    }
+    return {
+        id: view.id, pixels: n,
+        hueDeg: sumW > 0 ? ((Math.atan2(sumY, sumX) * 180 / Math.PI) + 360) % 360 : 0,
+        medianSaturation: median(sats), medianValue: median(vals),
+        clippedFraction: n ? clipped / n : 0, washedFraction: n ? washed / n : 0,
+    };
+}
+// ---------------------------------------------------------------------------------------------------------------------
+// The verdict
+/** Thresholds, all against the reference colour and all documented in the MCP `appearance` reference. */
+exports.PAINT_LIMITS = {
+    /** Rendered saturation (median of the six view medians) as a share of the reference's. Chromatic paints. */
+    saturationShare: 0.75,
+    /** A chromatic body may not render darker than this share of the reference value (a maroon over-correction). */
+    minValueShare: 0.55,
+    /** Mean over the views of the share of paint pixels washed toward white (chromatic: bright and under half the reference saturation; neutral: all channels >= 245). */
+    washedMean: 0.3,
+    /** Neutral paints: tint (saturation) above the reference's by at most this, lightness within this of the reference. */
+    neutralTint: 0.15,
+    neutralValue: 0.25,
+    /** A neutral reference at or above this value is white/silver: near-white pixels are its colour, so wash is not judged. */
+    lightNeutralValue: 0.75,
+    /** Fewer paint pixels than this over all views and the paint cannot be judged. */
+    minPixels: 3000,
+    defaultHueToleranceDeg: 12,
+};
+const r3 = (n) => Math.round(n * 1000) / 1000;
+const r1 = (n) => Math.round(n * 10) / 10;
+const fmt = (n) => n.toFixed(2);
+/** What the creator can change, with the material's real values, appended to every failing paint message. */
+function paintFixAdvice(materials, ref) {
+    const m = materials?.[0];
+    const lin = (c) => { const x = c / 255; return x <= 0.04045 ? x / 12.92 : ((x + 0.055) / 1.055) ** 2.4; };
+    const target = `${lin(ref.rgb.r).toFixed(3)},${lin(ref.rgb.g).toFixed(3)},${lin(ref.rgb.b).toFixed(3)}`;
+    const now = m ? ` Now: ${m.name} baseColorFactor(linear) ${m.baseColorLinear?.map((x) => x.toFixed(3)).join(',') ?? '?'}, metallic ${m.metalness ?? '?'}, roughness ${m.roughness ?? '?'}${m.ior != null && m.ior !== 1.5 ? `, ior ${m.ior}` : ''}.` : '';
+    if (ref.kind === 'neutral')
+        return `Fix the paint MATERIAL, never exposure, tone mapping or emissive: set baseColorFactor in LINEAR values with equal r, g, b (the reference ${rgbToHex(ref.rgb)} is ${target} linear), metallic at most 0.3 and roughness 0.3-0.5 so a highlight does not blow out.${now}`;
+    return `Fix the paint MATERIAL, never exposure, tone mapping or emissive: set baseColorFactor in LINEAR values (the reference ${rgbToHex(ref.rgb)} is ${target} linear; the runtime's daylight is hot, so author roughly 0.4-0.6x of that, not the photo's lit colour), metallic 0.5-0.7 so a highlight keeps the paint's colour instead of going white, roughness about 0.3 (a rougher lobe washes wider), and for a solid colour keep ior at or below 1.5.${now}`;
+}
+function rgbToHex(c) {
+    return '#' + [c.r, c.g, c.b].map((x) => x.toString(16).padStart(2, '0')).join('');
+}
+/** Judge the six paint views against the reference. Pure: numbers in, asserts out. */
+function judgePaint(referenceHex, views, materials, hueToleranceDeg = exports.PAINT_LIMITS.defaultHueToleranceDeg) {
+    const ref = paintReference(referenceHex);
+    const L = exports.PAINT_LIMITS;
+    const lit = views.filter((v) => v.pixels > 0);
+    const pixels = lit.reduce((a, v) => a + v.pixels, 0);
+    const base = { referencePaint: referenceHex, referenceKind: ref.kind, referenceHsv: { h: r1(ref.hsv.h), s: r3(ref.hsv.s), v: r3(ref.hsv.v) }, views: views.map((v) => ({ id: v.id, pixels: v.pixels, hueDeg: r1(v.hueDeg), saturation: r3(v.medianSaturation), value: r3(v.medianValue), washed: r3(v.washedFraction), clipped: r3(v.clippedFraction) })), materials: (materials ?? []).slice(0, 4) };
+    const fix = paintFixAdvice(materials, ref);
+    if (!materials?.length) {
+        return [{ id: 'vehicle.paint.saturation', pass: false, measured: base, detail: 'paint: no body-paint material was found, so the body colour could not be sampled. Name the body materials <node>__vehicle-paint-solid (or -metallic) in the GLB so the runtime and this check can find them.' }];
+    }
+    if (pixels < L.minPixels) {
+        return [{ id: 'vehicle.paint.saturation', pass: false, measured: { ...base, pixels }, detail: `paint: only ${pixels} body-paint pixels showed across the six daylight views (need ${L.minPixels}); the paint-named materials cover almost none of the body. Name every body panel's material <node>__vehicle-paint-solid|metallic.` }];
+    }
+    const med = (xs) => { const a = [...xs].sort((x, y) => x - y); return a.length % 2 ? a[(a.length - 1) / 2] : (a[a.length / 2 - 1] + a[a.length / 2]) / 2; };
+    const sat = med(lit.map((v) => v.medianSaturation));
+    const val = med(lit.map((v) => v.medianValue));
+    const washed = lit.reduce((a, v) => a + v.washedFraction, 0) / lit.length;
+    const out = [];
+    const where = `across ${lit.length} daylight views lit as Try Now lights the car`;
+    if (ref.kind === 'chromatic') {
+        let sx = 0, sy = 0, sw = 0;
+        for (const v of lit) {
+            const w = v.pixels * v.medianSaturation;
+            const rad = v.hueDeg * Math.PI / 180;
+            sx += w * Math.cos(rad);
+            sy += w * Math.sin(rad);
+            sw += w;
+        }
+        const hue = sw > 0 ? ((Math.atan2(sy, sx) * 180 / Math.PI) + 360) % 360 : 0;
+        const dh = hueDistanceDeg(hue, ref.hsv.h);
+        out.push({ id: 'vehicle.paint.hue', pass: dh <= hueToleranceDeg, measured: { ...base, renderedHueDeg: r1(hue), hueDistanceDeg: r1(dh), toleranceDeg: hueToleranceDeg },
+            detail: dh <= hueToleranceDeg ? `paint hue: rendered ${hue.toFixed(1)}° vs reference ${ref.hsv.h.toFixed(1)}° (Δ ${dh.toFixed(1)}°, ≤ ${hueToleranceDeg}°) ${where}`
+                : `paint hue: rendered ${hue.toFixed(1)}° is ${dh.toFixed(1)}° from the reference ${referenceHex} (${ref.hsv.h.toFixed(1)}°, tolerance ${hueToleranceDeg}°) ${where}. ${fix}` });
+        const need = ref.hsv.s * L.saturationShare;
+        out.push({ id: 'vehicle.paint.saturation', pass: sat >= need, measured: { ...base, renderedSaturation: r3(sat), referenceSaturation: r3(ref.hsv.s), required: r3(need) },
+            detail: sat >= need ? `paint saturation: rendered ${fmt(sat)} vs reference ${fmt(ref.hsv.s)} (needs ≥ ${fmt(need)}) ${where}`
+                : `paint saturation: the body renders washed out, median saturation ${fmt(sat)} vs the reference ${referenceHex}'s ${fmt(ref.hsv.s)} (needs ≥ ${fmt(need)}) ${where}: it reads pastel / salmon instead of the paint colour. ${fix}` });
+        const minV = ref.hsv.v * L.minValueShare;
+        out.push({ id: 'vehicle.paint.lightness', pass: val >= minV, measured: { ...base, renderedValue: r3(val), referenceValue: r3(ref.hsv.v), required: r3(minV) },
+            detail: val >= minV ? `paint lightness: rendered value ${fmt(val)} vs reference ${fmt(ref.hsv.v)} (needs ≥ ${fmt(minV)}) ${where}`
+                : `paint lightness: the body renders too dark, median value ${fmt(val)} vs the reference's ${fmt(ref.hsv.v)} (needs ≥ ${fmt(minV)}) ${where}: raise the baseColorFactor or lower metallic. ${fix}` });
+        out.push({ id: 'vehicle.paint.glare', pass: washed <= L.washedMean, measured: { ...base, washedMean: r3(washed), limit: L.washedMean },
+            detail: washed <= L.washedMean ? `paint glare: ${(washed * 100).toFixed(0)}% of the paint is washed toward white (≤ ${(L.washedMean * 100).toFixed(0)}%) ${where}`
+                : `paint glare: ${(washed * 100).toFixed(0)}% of the body paint is blown toward white (limit ${(L.washedMean * 100).toFixed(0)}%) ${where}; worst views ${[...lit].sort((a, b) => b.washedFraction - a.washedFraction).slice(0, 2).map((v) => `${v.id.replace('pose.', '')} ${(v.washedFraction * 100).toFixed(0)}%`).join(', ')} (the bonnet and roof hotspots). ${fix}` });
+    }
+    else {
+        const tintMax = Math.max(ref.hsv.s, 0.1) + L.neutralTint;
+        out.push({ id: 'vehicle.paint.saturation', pass: sat <= tintMax, measured: { ...base, renderedSaturation: r3(sat), referenceSaturation: r3(ref.hsv.s), allowed: r3(tintMax) },
+            detail: sat <= tintMax ? `paint tint: neutral paint renders at saturation ${fmt(sat)} (reference ${fmt(ref.hsv.s)}, allowed ≤ ${fmt(tintMax)}) ${where}`
+                : `paint tint: the reference ${referenceHex} is a neutral paint but the body renders tinted, median saturation ${fmt(sat)} (allowed ≤ ${fmt(tintMax)}) ${where}. Keep baseColorFactor neutral (equal linear r, g, b).` });
+        const lightOk = val >= ref.hsv.v - L.neutralValue && (val <= ref.hsv.v + L.neutralValue || ref.hsv.v >= L.lightNeutralValue);
+        out.push({ id: 'vehicle.paint.lightness', pass: lightOk, measured: { ...base, renderedValue: r3(val), referenceValue: r3(ref.hsv.v), tolerance: L.neutralValue },
+            detail: lightOk ? `paint lightness: rendered value ${fmt(val)} vs reference ${fmt(ref.hsv.v)} (±${L.neutralValue}) ${where}`
+                : `paint lightness: the neutral body renders at value ${fmt(val)} vs the reference ${referenceHex}'s ${fmt(ref.hsv.v)} (±${L.neutralValue}) ${where}. ${fix}` });
+        if (ref.hsv.v < L.lightNeutralValue) {
+            out.push({ id: 'vehicle.paint.glare', pass: washed <= L.washedMean, measured: { ...base, washedMean: r3(washed), limit: L.washedMean },
+                detail: washed <= L.washedMean ? `paint glare: ${(washed * 100).toFixed(0)}% of the paint is blown to white (≤ ${(L.washedMean * 100).toFixed(0)}%) ${where}`
+                    : `paint glare: ${(washed * 100).toFixed(0)}% of this dark/mid neutral paint is blown to white (limit ${(L.washedMean * 100).toFixed(0)}%) ${where}. ${fix}` });
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=paintHue.js.map

package/dist/vehicle/paintHue.js.map

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

package/dist/vehicle/panelCoverage.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Opening-panel COVERAGE for `helix vehicle validate` (docs/vehicles.md §6): a car should open what the real car opens.
+ *
+ * WHY THIS EXISTS. Round 8's Ferrari F40 articulated its two doors and nothing else: the bonnet, engine cover and boot
+ * were part of the body shell, so the owner's `-` / `=` keys did nothing. The package was valid (the contract does not
+ * require a lid) and the preview passed (it exercises every panel the package DECLARES), so a fixed lid was never
+ * flagged. Per-panel validity is not coverage; this is the coverage half.
+ *
+ * Every car has doors; a car also has a bonnet/hood and a boot/trunk (or engine cover / rear clamshell / tailgate, which
+ * all declare `role: boot`). A WARNING, not a refusal: a model that really lacks separate lid geometry is a legitimate
+ * (if lesser) car, and the warning then says how to split it. Skipped for anything that is not a four-wheeled car
+ * (motorcycles, boats, aircraft have different panels).
+ *
+ * Pure: the package JSON, the parsed glTF and the node facts walked by validate.ts. No I/O.
+ */
+import type { Gltf, NodeFacts, VehicleIssue } from './validate';
+type Json = Record<string, unknown>;
+export type PanelRole = 'door' | 'bonnet' | 'boot';
+/** The roles the package articulates, from `mesh.articulation.panels[]` and the `componentBuild.articulators` that move them. */
+export declare function declaredPanelRoles(pkg: Json | undefined): {
+    roles: Set<PanelRole>;
+    panelNodes: Set<string>;
+    panels: Array<{
+        id: string;
+        role: string;
+        nodes: string[];
+    }>;
+};
+export interface PanelCoverageInput {
+    pkg: Json | undefined;
+    gltf: Gltf;
+    facts: Map<number, NodeFacts>;
+    /** How many of the four wheel ids resolved by name; the check applies to four-wheeled cars only. */
+    wheelsFound: number;
+}
+export declare function checkPanelCoverage(input: PanelCoverageInput): VehicleIssue[];
+export {};

package/dist/vehicle/panelCoverage.js

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.declaredPanelRoles = declaredPanelRoles;
+exports.checkPanelCoverage = checkPanelCoverage;
+const isRecord = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+/** Node names that are plausibly a separate lid, by the role they would serve. */
+const LID_NAMES = {
+    bonnet: /(^|[^a-z])(bonnet|hood|frunk|front_?(lid|cover|clam|trunk)|nose_?(cover|clam))/i,
+    boot: /(^|[^a-z])(boot|trunk|tailgate|liftgate|hatch|deck_?lid|engine_?(cover|lid|hood|bay_?cover)|rear_?(cover|clam|deck|lid)|motor_?(cover|lid))/i,
+};
+const DOOR_NAME = /^door_?(l|r)/i;
+const ROLE_LABEL = {
+    door: 'door',
+    bonnet: 'bonnet / hood (or front clamshell)',
+    boot: 'boot / trunk (or engine cover, tailgate, rear clamshell)',
+};
+const HINGE_GUIDANCE = {
+    bonnet: 'put the lid node\'s origin ON the hinge line (the cowl at the windscreen end for a conventional bonnet, the front edge for a front clamshell), declare it in mesh.articulation.panels[] with role "bonnet", axis [1,0,0], pivot on that line and openDeg about 55 (the sign that lifts the free edge), and add the "hood" action to specialty.componentActions',
+    boot: 'put the lid node\'s origin ON the hinge line (the top edge of the rear glass for a boot or tailgate, the rear edge for a rear clamshell or engine cover), declare it in mesh.articulation.panels[] with role "boot", axis [1,0,0], pivot on that line and openDeg about 50 (the sign that lifts the free edge), and add the "trunk" action to specialty.componentActions',
+};
+/** The roles the package articulates, from `mesh.articulation.panels[]` and the `componentBuild.articulators` that move them. */
+function declaredPanelRoles(pkg) {
+    const roles = new Set();
+    const panelNodes = new Set();
+    const panels = [];
+    const mesh = pkg && isRecord(pkg.mesh) ? pkg.mesh : undefined;
+    const articulation = mesh && isRecord(mesh.articulation) ? mesh.articulation : undefined;
+    for (const panel of articulation && Array.isArray(articulation.panels) ? articulation.panels : []) {
+        if (!isRecord(panel))
+            continue;
+        const role = typeof panel.role === 'string' ? panel.role : '';
+        const nodes = Array.isArray(panel.nodes) ? panel.nodes.filter((n) => typeof n === 'string') : [];
+        panels.push({ id: String(panel.id ?? ''), role, nodes });
+        nodes.forEach((n) => panelNodes.add(n));
+        if (role === 'door' || role === 'bonnet' || role === 'boot')
+            roles.add(role);
+    }
+    // The rows are what actually move the car; a panel row's physical kind names its role when `mesh.articulation` is absent.
+    const specialty = pkg && isRecord(pkg.specialty) ? pkg.specialty : undefined;
+    const build = specialty && isRecord(specialty.componentBuild) ? specialty.componentBuild : undefined;
+    for (const row of build && Array.isArray(build.articulators) ? build.articulators : []) {
+        if (!isRecord(row))
+            continue;
+        const physical = isRecord(row.physical) ? row.physical : undefined;
+        const kind = physical && isRecord(physical.panel) ? physical.panel.kind : undefined;
+        if (kind === 'door')
+            roles.add('door');
+        else if (kind === 'hood')
+            roles.add('bonnet');
+        else if (kind === 'trunk')
+            roles.add('boot');
+        if (typeof row.node === 'string')
+            panelNodes.add(row.node);
+    }
+    return { roles, panelNodes, panels };
+}
+function checkPanelCoverage(input) {
+    const { pkg, gltf, facts, wheelsFound } = input;
+    const issues = [];
+    if (wheelsFound !== 4)
+        return issues;
+    const mesh = pkg && isRecord(pkg.mesh) ? pkg.mesh : undefined;
+    if (mesh && typeof mesh.classId === 'string' && /(motorcycle|bike|boat|ship|aircraft|plane|heli|rotor|tractor|forklift|trailer)/i.test(mesh.classId))
+        return issues;
+    const { roles, panelNodes } = declaredPanelRoles(pkg);
+    const nodes = gltf.nodes ?? [];
+    // Nodes that carry geometry in their subtree: an empty socket called `boot` is not a lid.
+    const hasGeometry = (index) => {
+        const visit = (i) => nodes[i]?.mesh !== undefined || (nodes[i]?.children ?? []).some(visit);
+        return visit(index);
+    };
+    const candidates = (role) => [...facts.values()].filter((f) => LID_NAMES[role].test(f.name) && hasGeometry(f.index) && !panelNodes.has(f.name)).map((f) => f.name);
+    const add = (code, path, message, fix) => { issues.push({ code, level: 'warn', path, message, fix }); };
+    if (!roles.has('door')) {
+        const doorNodes = [...facts.values()].filter((f) => DOOR_NAME.test(f.name) && hasGeometry(f.index)).map((f) => f.name);
+        add('PANEL_ROLE_MISSING_DOOR', 'mesh.articulation.panels', `the package declares no opening door panel; every car has doors${doorNodes.length ? ` (the model has ${doorNodes.map((n) => `'${n}'`).join(', ')})` : ' and the model has no separate door node'}`, doorNodes.length
+            ? 'declare each door in mesh.articulation.panels[] with role "door", axis [0,1,0], pivot at the front hinge line and openDeg about +/-62'
+            : 'split each door (and its glass) from the body into its own node with the origin on the front hinge line, then declare it as a door panel');
+    }
+    for (const role of ['bonnet', 'boot']) {
+        if (roles.has(role))
+            continue;
+        const found = candidates(role);
+        if (found.length > 0) {
+            add(`PANEL_ROLE_UNDECLARED_${role.toUpperCase()}`, 'mesh.articulation.panels', `the model has a separate ${ROLE_LABEL[role]} node (${found.map((n) => `'${n}'`).join(', ')}) but the package declares no ${role} panel, so it never opens`, `declare it: ${HINGE_GUIDANCE[role]}`);
+        }
+        else {
+            add(`PANEL_ROLE_NO_NODE_${role.toUpperCase()}`, 'mesh.articulation.panels', `the package declares no ${role} panel and the model has no separate ${ROLE_LABEL[role]} node (the lid is part of the body shell), so it can never open; the real car opens it`, `split the lid from the body shell into its own node (closed shape unchanged, a matching opening left in the body), ${HINGE_GUIDANCE[role]}; if the real car's lid genuinely does not open, say so in the package notes`);
+        }
+    }
+    return issues;
+}
+//# sourceMappingURL=panelCoverage.js.map

package/dist/vehicle/panelCoverage.js.map

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

package/dist/vehicle/platform.d.ts

@@ -0,0 +1,71 @@
+export type Json = Record<string, unknown>;
+export declare const isRecord: (value: unknown) => value is Json;
+export interface Requester {
+    request<T>(method: string, path: string, body?: unknown): Promise<T>;
+}
+export type BytesFetch = (url: string) => Promise<{
+    status: number;
+    bytes: Uint8Array;
+}>;
+export declare const defaultBytesFetch: BytesFetch;
+export declare const sha256Hex: (bytes: Uint8Array | string) => string;
+export declare const cidOf: (sha: string) => string;
+export declare const sleep: (ms: number) => Promise<void>;
+/** RFC 4122 v5 (SHA-1, name-based) UUID. Deterministic Package ids keep a re-run on the same Package. */
+export declare function uuidV5(name: string, namespace: string): string;
+/** Namespace for every vehicle/add-on Package id this CLI derives (a fixed random v4). */
+export declare const VEHICLE_PACKAGE_NAMESPACE = "5b8f2a43-7c1e-4d39-9a0e-2f6c1d4b8e71";
+export interface ItemAsset {
+    id: string;
+    rendition: string;
+    status: string;
+    cdnUrl?: string;
+    sizeBytes?: number;
+    mimeType?: string;
+    metadata?: Json | null;
+}
+export interface ItemRead {
+    id: string;
+    slug: string;
+    title: string;
+    kind: string;
+    status: string;
+    creatorId?: string;
+    hostKind?: string | null;
+    slotType?: string | null;
+    fits?: Json | null;
+    properties?: Json;
+    assets?: ItemAsset[];
+    continuumPackagePin?: {
+        packageId: string;
+        version: string;
+        manifestCid: string;
+    } | null;
+}
+export declare function getItem(api: Requester, itemId: string): Promise<ItemRead>;
+/** Wait until the item's `rendition` asset is `ready` (vehicles and add-ons are verified inline; the web rendition can lag). */
+export declare function waitForAsset(api: Requester, itemId: string, rendition: string, opts?: {
+    timeoutMs?: number;
+    intervalMs?: number;
+    onWait?: (msg: string) => void;
+}): Promise<{
+    item: ItemRead;
+    asset: ItemAsset;
+}>;
+/**
+ * The public, content-addressed URL of a public Continuum object. An object uploaded with audience `public` is served
+ * at `<content origin>/content/sha256/<aa>/<sha>` immediately (verified live on helix3 2026-10-03 — before any seal),
+ * so a package can cite it in the same pass that mints the item. The origin is discovered, never hardcoded: the
+ * `HELIX_CONTENT_ORIGIN` override, then the CDN origins the backend's own item assets use; the backend's public object
+ * route is the fallback. The URL is only returned once it has served the exact bytes.
+ */
+export declare function publicObjectUrl(apiUrl: string, sha: string, bytes: number, deps?: {
+    fetchBytes?: BytesFetch;
+    origins?: string[];
+    attempts?: number;
+    delayMs?: number;
+}): Promise<string>;
+/** Fetch a public Continuum object's exact bytes by sha256 (content URL first, then the API's public object route). */
+export declare function fetchPublicObject(apiUrl: string, sha: string, fetchBytes?: BytesFetch): Promise<Uint8Array | undefined>;
+export declare function contentOrigins(apiUrl: string, fetchImpl?: typeof fetch): Promise<string[]>;
+export { jwtSubject as tokenSubject } from '../config';