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

package/dist/vehicle/lampCoverage.js

@@ -0,0 +1,252 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MIN_NO_REAR_INDICATORS_REASON_CHARS = void 0;
+exports.lampRows = lampRows;
+exports.indicatorSide = indicatorSide;
+exports.noRearIndicatorsReason = noRearIndicatorsReason;
+exports.checkLampCoverage = checkLampCoverage;
+const isRecord = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+const r3 = (n) => Math.round(n * 1000) / 1000;
+/** `lights.noRearIndicators` is a free-text reason; anything shorter than this is not a reason. */
+exports.MIN_NO_REAR_INDICATORS_REASON_CHARS = 20;
+/** three's `PropertyBinding.sanitizeNodeName`: the name the runtime actually matches a slot against. */
+const sanitize = (name) => name.replace(/\s/g, '_').replace(/[[\].:/]/g, '');
+const LENS_NAME = /(lamp|light|lens|indicator|blinker|signal|repeater|amber)/i;
+const NOT_A_LENS = /(housing|bezel|surround|trim|frame|chrome|reflector|cover|bracket|mount|stalk|switch|interior|cabin|dome|ceiling|dash|gauge|spotlight|lightbar|lightweight|highlight|daylight|skylight)/i;
+const INDICATOR_NAME = /(indicator|blinker|turn_?sig|signal|repeater|amber|side_?marker)/i;
+const REPEATER_NAME = /(repeater|side_?marker|side_?indicator|mirror_?(indicator|signal|blinker))/i;
+/** Each emissive-driving row of `specialty.componentBuild.materials`, with the signal that drives it. */
+function lampRows(pkg) {
+    const specialty = pkg && isRecord(pkg.specialty) ? pkg.specialty : undefined;
+    const build = specialty && isRecord(specialty.componentBuild) ? specialty.componentBuild : undefined;
+    const materials = build && Array.isArray(build.materials) ? build.materials : [];
+    const rows = [];
+    materials.forEach((row, index) => {
+        if (!isRecord(row) || typeof row.slot !== 'string')
+            return;
+        if (row.property !== undefined && row.property !== 'emissive')
+            return;
+        const drive = isRecord(row.drive) ? row.drive : undefined;
+        const source = drive && isRecord(drive.source) ? drive.source : undefined;
+        rows.push({ slot: row.slot, signal: typeof source?.signal === 'string' ? source.signal : undefined, index });
+    });
+    return rows;
+}
+/** Which side an indicator row serves: by its signal name (`signal_L`, `indicatorRight`, `hazards`), else undefined. */
+function indicatorSide(signal) {
+    if (signal === undefined)
+        return undefined;
+    const s = signal.toLowerCase();
+    if (/hazard/.test(s))
+        return 'both';
+    if (/(^|[^a-z])(signal|indicator|blinker|turn)[_-]?(l|left)$/.test(s) || /^(signal|indicator|blinker|turn)(l|left)$/.test(s) || /(^|_)left($|_)/.test(s))
+        return 'left';
+    if (/(^|[^a-z])(signal|indicator|blinker|turn)[_-]?(r|right)$/.test(s) || /^(signal|indicator|blinker|turn)(r|right)$/.test(s) || /(^|_)right($|_)/.test(s))
+        return 'right';
+    return undefined;
+}
+const emissiveOf = (material) => {
+    if (!material)
+        return false;
+    if (material.emissiveTexture !== undefined)
+        return true;
+    return Array.isArray(material.emissiveFactor) && material.emissiveFactor.some((c) => typeof c === 'number' && c > 0);
+};
+/** Every mesh-bearing node with the aliases the runtime indexes it by: its name, its material names, its named ancestors. */
+function meshNodes(gltf, facts) {
+    const out = [];
+    const nodes = gltf.nodes ?? [];
+    for (const fact of facts.values()) {
+        const node = nodes[fact.index];
+        if (!node || node.mesh === undefined)
+            continue;
+        const materialNames = [];
+        let emissive = false;
+        for (const primitive of gltf.meshes?.[node.mesh]?.primitives ?? []) {
+            const material = primitive.material === undefined ? undefined : gltf.materials?.[primitive.material];
+            if (material?.name)
+                materialNames.push(material.name);
+            if (emissiveOf(material))
+                emissive = true;
+        }
+        const aliases = new Set();
+        if (fact.name)
+            aliases.add(sanitize(fact.name));
+        for (const name of materialNames)
+            aliases.add(sanitize(name));
+        // The runtime stops at the loaded scene root; the glTF's own top-level root node is a named ancestor like any other.
+        for (let p = fact.parent; p !== undefined; p = facts.get(p)?.parent) {
+            const name = facts.get(p)?.name;
+            if (name)
+                aliases.add(sanitize(name));
+        }
+        out.push({ index: fact.index, name: fact.name, aliases, materialNames, emissive, box: fact.ownBox });
+    }
+    return out;
+}
+const unionBox = (nodes) => {
+    let box;
+    for (const n of nodes) {
+        if (!n.box)
+            continue;
+        box = box === undefined ? { min: [...n.box.min], max: [...n.box.max] } : box;
+        for (let a = 0; a < 3; a += 1) {
+            if (n.box.min[a] < box.min[a])
+                box.min[a] = n.box.min[a];
+            if (n.box.max[a] > box.max[a])
+                box.max[a] = n.box.max[a];
+        }
+    }
+    return box;
+};
+/** What each lamp function needs lit, by the signal names the platform's control bundle defines. */
+const FUNCTION_SIGNALS = [
+    { node: 'headlamps', needs: [{ label: 'lowbeam', test: /^low.?beam$/i }, { label: 'highbeam', test: /^high.?beam$/i }] },
+    { node: 'foglights', needs: [{ label: 'fog', test: /^fog/i }] },
+    { node: 'taillamps', needs: [{ label: 'brakelights', test: /^brake/i }, { label: 'lowhighbeam', test: /^(lowhigh.?beam|tail|position|lowbeam)/i }] },
+    { node: 'reverselights', needs: [{ label: 'reverse', test: /^rev/i }] },
+    { node: 'chmsl', needs: [{ label: 'brakelights', test: /^brake/i }] },
+];
+/** The reason a package gives for a car with no rear indicators, if it gives one. */
+function noRearIndicatorsReason(pkg) {
+    const lights = pkg && isRecord(pkg.lights) ? pkg.lights : undefined;
+    const raw = lights?.noRearIndicators;
+    if (raw === undefined || raw === false)
+        return { declared: false, reason: '' };
+    return { declared: true, reason: typeof raw === 'string' ? raw.trim() : '' };
+}
+function checkLampCoverage(input) {
+    const { pkg, gltf, facts, indicesFor } = input;
+    const issues = [];
+    const add = (code, level, path, message, fix) => { issues.push({ code, level, path, message, fix }); };
+    const rows = lampRows(pkg);
+    const meshes = meshNodes(gltf, facts);
+    if (meshes.length === 0)
+        return issues;
+    // A car with no lighting rows at all is the platform-default-controls car: its lamps cannot be lit by this contract.
+    if (rows.length === 0) {
+        const lens = meshes.filter((m) => m.emissive);
+        if (lens.length > 0) {
+            add('LAMP_NO_LIGHTING_ROWS', 'warn', 'specialty.componentBuild.materials', `the model has ${lens.length} emissive lamp node(s) (${lens.slice(0, 6).map((m) => `'${m.name}'`).join(', ')}) but the package declares no specialty.componentBuild.materials rows, so no lamp can ever light`, 'copy the reference package\'s specialty block (read_skill helix-vehicles reference-package) and rename its row slots to your lamp nodes');
+        }
+        return issues;
+    }
+    // slot → the mesh nodes a row on that slot lights (exact alias match, as the runtime indexes them)
+    const litBy = (slot) => meshes.filter((m) => m.aliases.has(sanitize(slot)));
+    const litIndices = new Set();
+    rows.forEach((row) => {
+        const hits = litBy(row.slot);
+        hits.forEach((m) => litIndices.add(m.index));
+        if (hits.length === 0) {
+            add('LAMP_ROW_NO_TARGET', 'warn', `specialty.componentBuild.materials[${row.index}].slot`, `row "${row.slot}"${row.signal ? ` (driven by ${row.signal})` : ''} matches no mesh name, material name or named ancestor in the model, so it lights nothing (the runtime resolves an unknown slot to no target without a warning)`, `rename the slot to a node, material or ancestor name that exists in the GLB, or drop the row if the car has no such lamp`);
+        }
+    });
+    // ── 1. indicators: each side lights geometry that reaches the front AND the rear of the car ──
+    let carBox;
+    for (const fact of facts.values()) {
+        if (!fact.ownBox)
+            continue;
+        carBox = carBox ?? { min: [...fact.ownBox.min], max: [...fact.ownBox.max] };
+        for (let a = 0; a < 3; a += 1) {
+            carBox.min[a] = Math.min(carBox.min[a], fact.ownBox.min[a]);
+            carBox.max[a] = Math.max(carBox.max[a], fact.ownBox.max[a]);
+        }
+    }
+    const indicatorRows = rows.filter((row) => row.signal !== undefined && /(signal|indicator|blinker|turn|hazard)/i.test(row.signal));
+    const lengthM = carBox ? carBox.max[2] - carBox.min[2] : 0;
+    const frontLine = carBox ? carBox.max[2] - 0.25 * lengthM : 0;
+    const rearLine = carBox ? carBox.min[2] + 0.25 * lengthM : 0;
+    const sideNodes = (side) => {
+        const set = new Map();
+        for (const row of indicatorRows) {
+            const s = indicatorSide(row.signal);
+            if (s !== side && s !== 'both')
+                continue;
+            for (const m of litBy(row.slot))
+                set.set(m.index, m);
+        }
+        return [...set.values()];
+    };
+    const optOut = noRearIndicatorsReason(pkg);
+    const rearOptOutValid = optOut.declared && optOut.reason.length >= exports.MIN_NO_REAR_INDICATORS_REASON_CHARS;
+    if (optOut.declared && !rearOptOutValid) {
+        add('LAMP_INDICATOR_OPTOUT_INVALID', 'error', 'lights.noRearIndicators', `lights.noRearIndicators must be a sentence (at least ${exports.MIN_NO_REAR_INDICATORS_REASON_CHARS} characters) saying why the REAL car has no rear indicators; got ${JSON.stringify(optOut.declared ? optOut.reason : '')}`, 'write the reason, citing the source (e.g. "the 19xx model\'s rear turn signals are combined with the tail lamps and have no separate lens: <source>"), or remove the field and light the rear lenses');
+    }
+    // lens-like mesh nodes nothing lights, split by rear/front half for the message
+    const unlit = meshes.filter((m) => !litIndices.has(m.index) && (m.emissive || (LENS_NAME.test(m.name) && !NOT_A_LENS.test(m.name)) || m.materialNames.some((n) => LENS_NAME.test(n) && !NOT_A_LENS.test(n))));
+    const centreZ = (m) => (m.box ? (m.box.min[2] + m.box.max[2]) / 2 : 0);
+    const midZ = carBox ? (carBox.min[2] + carBox.max[2]) / 2 : 0;
+    const unlitIndicators = unlit.filter((m) => INDICATOR_NAME.test(m.name) || m.materialNames.some((n) => INDICATOR_NAME.test(n)));
+    const unlitRearIndicators = unlitIndicators.filter((m) => centreZ(m) < midZ);
+    const describeUnlit = (list) => list.slice(0, 8).map((m) => `'${m.name}'`).join(', ');
+    if (indicatorRows.length === 0) {
+        if (indicesFor('indicator_l').length > 0 || indicesFor('indicator_r').length > 0) {
+            add('LAMP_INDICATOR_NO_ROWS', 'error', 'specialty.componentBuild.materials', 'the model has indicator lamp nodes but no componentBuild.materials row is driven by an indicator signal (signal_L / signal_R / hazards), so no indicator ever lights', 'copy the reference package\'s signal_L/signal_R rows (slot = your indicator node) into specialty.componentBuild.materials');
+        }
+    }
+    else if (carBox && lengthM > 0) {
+        for (const side of ['left', 'right']) {
+            const lit = sideNodes(side);
+            const box = unionBox(lit);
+            const code = side === 'left' ? 'indicator_l' : 'indicator_r';
+            if (lit.length === 0 || !box) {
+                add('LAMP_INDICATOR_SIDE_UNLIT', 'error', 'specialty.componentBuild.materials', `no ${side} indicator lights anything: no componentBuild row driven by the ${side} signal (or hazards) matches a mesh in the model`, `add a ${side === 'left' ? 'signal_L' : 'signal_R'} row whose slot is the '${code}' node (or its material / an ancestor)`);
+                continue;
+            }
+            const frontOk = box.max[2] >= frontLine;
+            const rearOk = box.min[2] <= rearLine;
+            const span = `z ${r3(box.min[2])}..${r3(box.max[2])} m of a car spanning ${r3(carBox.min[2])}..${r3(carBox.max[2])}`;
+            if (!frontOk) {
+                add('LAMP_INDICATOR_FRONT_MISSING', 'error', 'specialty.componentBuild.materials', `the ${side} indicator lights ${describeUnlit(lit)} (${span}), which does not reach the front quarter of the car (front of z ${r3(frontLine)}); the front ${side} lens never flashes`, `model the front ${side} indicator lens and let the ${code} row light it (merge front and rear lens of one side into one node when they share an image)`);
+            }
+            if (!rearOk) {
+                if (rearOptOutValid && unlitRearIndicators.length === 0) {
+                    add('LAMP_INDICATOR_REAR_OPTED_OUT', 'warn', 'lights.noRearIndicators', `the ${side} indicator lights nothing at the rear (${span}); accepted because the package declares lights.noRearIndicators: "${optOut.reason}"`, 'nothing to do — a reviewer should still confirm the real car has no rear indicator');
+                }
+                else if (unlitRearIndicators.length > 0) {
+                    add('LAMP_INDICATOR_REAR_MISSING', 'error', 'specialty.componentBuild.materials', `the ${side} indicator lights ${describeUnlit(lit)} (${span}) and never reaches the rear of the car, yet the model has indicator-like lens node(s) at the rear that no componentBuild row lights: ${describeUnlit(unlitRearIndicators)}. On hazards and ${side} turns the rear lens stays dark`, `add rows for the rear lens (slot ${unlitRearIndicators.slice(0, 3).map((m) => `'${m.name}'`).join(' / ')}, driven by ${side === 'left' ? 'signal_L' : 'signal_R'}), or fold it into the '${code}' node`);
+                }
+                else {
+                    add('LAMP_INDICATOR_REAR_MISSING', 'error', 'specialty.componentBuild.materials', `the ${side} indicator lights ${describeUnlit(lit)} (${span}) and never reaches the rear of the car, and the model has no separate rear indicator lens: either the amber rear lens is painted into the body (it can never light) or the car has none. A car whose indicators light at one end only reads as a bug on every hazard and turn`, `model the rear ${side} indicator lens as its own mesh inside the '${code}' node (own emissive material) so the ${side} row lights front and rear, or, only if the real car truly has no rear indicators, set lights.noRearIndicators to a sentence saying so with its source`);
+                }
+            }
+        }
+    }
+    // ── 2. every lens-like node of the model is reached by a row ──
+    const reportedAsRear = new Set(indicatorRows.length > 0 ? unlitRearIndicators.map((m) => m.index) : []);
+    for (const m of unlit) {
+        if (reportedAsRear.has(m.index))
+            continue; // already named in LAMP_INDICATOR_REAR_MISSING
+        const repeater = REPEATER_NAME.test(m.name);
+        add(repeater ? 'LAMP_REPEATER_UNLIT' : 'LAMP_NODE_UNLIT', 'error', `glb:node:${m.name}`, `${repeater ? 'side repeater' : 'lens'} node '${m.name}' is not lit by any specialty.componentBuild.materials row (no row's slot matches its name, its material ${m.materialNames.length ? `'${m.materialNames.join("', '")}'` : '(none)'} or a named ancestor), so it never lights`, repeater ? `add the repeater to the indicator rows (slot '${m.name}', driven by signal_L / signal_R) or fold it into the indicator node` : `add a row for it (slot '${m.name}') driven by the signal its function needs, rename it so it is not a lamp, or delete it`);
+    }
+    // ── 3. each lamp function the model has carries the rows its function needs ──
+    for (const fn of FUNCTION_SIGNALS) {
+        const own = indicesFor(fn.node);
+        if (own.length === 0)
+            continue;
+        const ownSet = new Set(own);
+        const signals = new Set();
+        for (const row of rows) {
+            if (row.signal === undefined)
+                continue;
+            const hits = litBy(row.slot);
+            // a row serves the function when it lights the function's node (or a mesh under it)
+            if (hits.some((m) => ownSet.has(m.index) || [...ownSet].some((i) => isDescendant(facts, m.index, i))))
+                signals.add(row.signal);
+        }
+        for (const need of fn.needs) {
+            if (![...signals].some((signal) => need.test.test(signal))) {
+                add('LAMP_FUNCTION_NO_ROW', 'error', 'specialty.componentBuild.materials', `lamp node '${fn.node}' is in the model but no componentBuild row lights it from ${need.label}${signals.size ? ` (it is driven by: ${[...signals].join(', ')})` : ' (no row lights it at all)'}`, `add a row { slot: '${fn.node}', drive: { source: { signal: '${need.label}' } }, property: 'emissive' } (copy it from the reference package)`);
+            }
+        }
+    }
+    return issues;
+}
+function isDescendant(facts, index, ancestor) {
+    for (let p = index; p !== undefined; p = facts.get(p)?.parent)
+        if (p === ancestor)
+            return true;
+    return false;
+}
+//# sourceMappingURL=lampCoverage.js.map

package/dist/vehicle/lampCoverage.js.map

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

package/dist/vehicle/mintAddOn.d.ts

@@ -0,0 +1,110 @@
+import type { CliCredentials } from '../config';
+import { checkAddOn, type AddOnCheckReport } from './addon';
+import type { DriveEffect } from './drive';
+import { type MakeItemRequest, type PackagePin } from './mintVehicle';
+import { type BytesFetch, type Json, type Requester } from './platform';
+import { type SealIssue } from './sealCheck';
+import type { ContinuumObjects } from './publish';
+export { ADDON_DEFINITION_SCHEMA, addOnDefinition } from './addOnDefinition';
+export declare const ADDON_MODEL_ROLE = "addon.model.web";
+export interface AddOnMintOptions {
+    dir: string;
+    glb?: string;
+    contentRating?: string;
+    out?: string;
+    /** Package Version to seal (default addon.json `version`, else 1.0.0). With `--item`, the NEW version of that part. */
+    version?: string;
+    /** Publish a NEW VERSION of this existing add-on Item instead of minting one. */
+    itemId?: string;
+    /** 1-500 chars; the version move's audit reason (default names the version). */
+    reason?: string;
+    /** Run the full check and the seal-side validation only; nothing is uploaded. */
+    dryRun?: boolean;
+}
+export interface AddOnMintLedger {
+    schema: 'helix.vehicle-addon-mint-ledger/1';
+    intentId: string;
+    glb?: {
+        sha: string;
+        bytes: number;
+    } | null;
+    rootSha?: string;
+    pin?: PackagePin;
+    itemId?: string;
+    versionMove?: 'moved' | 'staged-awaiting-visual-qa';
+    steps: Array<{
+        at: string;
+        step: string;
+        detail?: unknown;
+    }>;
+}
+export interface AddOnMintResult {
+    ok: boolean;
+    dryRun: boolean;
+    check: AddOnCheckReport;
+    itemId?: string;
+    packagePin?: PackagePin | null;
+    tuneOnly?: boolean;
+    /** `minted` (first publish), `moved` (a new Version of an existing Item), or sealed but waiting on visual QA. */
+    versionMove?: 'minted' | 'moved' | 'staged-awaiting-visual-qa';
+    /** Seal-side refusals found before anything was uploaded (provenance, rating, Package shape, version clash). */
+    seal?: SealIssue[];
+    readBack?: {
+        pinned: boolean;
+        fitsHosts: Record<string, boolean>;
+        listedOnHosts: Record<string, boolean>;
+        status: string;
+    };
+    files: {
+        ledger: string;
+        definition?: string;
+        descriptor?: string;
+        receipt?: string;
+    };
+    next: string[];
+}
+export interface AddOnMintDeps {
+    api: Requester;
+    objects: ContinuumObjects;
+    publishPackage(intent: Json): Promise<Json>;
+    makeItem(input: MakeItemRequest): Promise<{
+        item: {
+            id: string;
+            slug?: string;
+            packagePin: PackagePin;
+        };
+    }>;
+    fetchBytes?: BytesFetch;
+    measureDrive?: (vehiclePackage: Json, ops: Json[], slotType: string) => Promise<DriveEffect>;
+    /** Injectable for tests; defaults to the real `checkAddOn`. */
+    check?: typeof checkAddOn;
+    onProgress?: (message: string) => void;
+}
+/**
+ * The exact Package publication intent an add-on seal sends, built from values only (no network, no upload) so the real
+ * publish and the dry run's seal-side validation judge the SAME object. `glb` is null for a tune-only part.
+ */
+export declare function addOnSealIntent(a: {
+    packageId: string;
+    slug: string;
+    name: string;
+    version: string;
+    rootBytes: Uint8Array;
+    rootSha: string;
+    glb: {
+        sha: string;
+        bytes: number;
+    } | null;
+    slotType: string;
+    provenance?: {
+        kind?: string;
+        source?: string;
+    };
+    dirName: string;
+    stage: boolean;
+}): {
+    intent: Json;
+    objects: Json[];
+};
+export declare function mintVehicleAddOn(opts: AddOnMintOptions, creds: CliCredentials, deps: AddOnMintDeps): Promise<AddOnMintResult>;
+export declare function formatAddOnMint(r: AddOnMintResult, checkText: string): string;