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

package/dist/vehicle/keyboardLaunch.js

@@ -0,0 +1,340 @@
+"use strict";
+/**
+ * THE KEYBOARD LAUNCH — what a player on W/A/D actually gets, in the same runtime solver the instrument uses.
+ *
+ * WHY. `measureVehicle` launches with `throttle: 1, steer: 0` on a perfectly symmetric pad. That IS a digital launch,
+ * but nothing ever disturbs the car's heading, so a car that is directionally UNSTABLE under power — the rear spinning,
+ * its lateral grip gone — still runs dead straight and posts its best figure. A keyboard player cannot modulate the
+ * throttle (W is 0 or 1; the platform does not ramp it, `VehicleDriveAbility` passes it straight to `setInput`), so on
+ * such a car every heading correction meets a rear that has no grip to give, and the car snaps. A round-8 car posted
+ * 4.38 s 0-100 in the instrument and hit the arena wall 3 runs out of 3 on a live keyboard launch.
+ *
+ * Two measurements, both in the served runtime (Rapier, land solver v2, 60 Hz):
+ *
+ *   1. THE RUN. A full-throttle launch from rest exactly as the live drive ability sends it: auto-hold brake released,
+ *      throttle 0 → 1 in one tick, automatic shifts. Steering is a keyboard PLAYER: every 100 ms it looks at what it saw
+ *      100 ms ago (reaction time), decides a correction from the heading error to the lane (with a 30 m look-ahead on
+ *      the lateral offset) plus the yaw rate, and taps A or D for a fraction of the next 100 ms. While a steer key is
+ *      down the platform's keyboard `move` vector is normalised (`InputService`: |(x, y)| ≤ 1), so W+A sends throttle
+ *      0.707 and steer −0.707 — modelled here exactly. The car starts 2° off its lane, so the player has to steer.
+ *      Reported: keyboard 0-100 against the instrument's, wheelspin (driven slip ratio > 0.2) time and peak slip per
+ *      gear, and for 1.5 s after each upshift re-engages the peak yaw rate, heading error and sideslip; the worst
+ *      heading error, sideslip and lane offset of the whole run.
+ *   2. THE PROBE. The same launch HANDS OFF (steer 0), with a 0.2 rad/s yaw-rate nudge — less than one short keyboard
+ *      tap — at 20, 40, 60 and 100 km/h and at the moment each of the first two upshifts re-engages, each in a fresh
+ *      run, both directions. A drivable car damps it: the yaw rate decays and the sideslip stays small. A car that is
+ *      unstable under power amplifies it into a spin; the player then has to catch every disturbance within a few
+ *      tenths of a second, which a keyboard cannot do reliably.
+ *
+ * VERDICT.
+ *   FAIL (not drivable on a keyboard): any probe spins (sideslip ≥ 20°, or the yaw rate grows to ≥ 3× the nudge), or the
+ *        run spins (sideslip or heading error ≥ 20°) or leaves its 3.5 m lane (centre more than 1.75 m off).
+ *   WARN: the run needs big corrections (heading error or sideslip > 0.1 rad ≈ 5.7°); a probe does not settle (yaw rate
+ *        still > half the nudge after 1 s, or sideslip > 0.1 rad); or the keyboard 0-100 is > 15 % slower than the
+ *        instrument's (or never reached).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KEYBOARD_LAUNCH = void 0;
+exports.keyboardInput = keyboardInput;
+exports.playerTap = playerTap;
+exports.measureKeyboardLaunch = measureKeyboardLaunch;
+exports.formatKeyboardLaunch = formatKeyboardLaunch;
+const HZ = 60;
+const H = 1 / HZ;
+exports.KEYBOARD_LAUNCH = {
+    /** Player: decisions every this many ticks (100 ms), each on what it saw this many ticks earlier (100 ms reaction). */
+    decisionTicks: 6,
+    reactionTicks: 6,
+    /** The car starts this far off its lane heading, so the player has to steer from the first moment. */
+    misalignDeg: 2,
+    /** Lateral offset → heading demand: aim at the lane centre this far ahead. */
+    lookAheadM: 30,
+    /** Correction u = kp·heading + kd·yawRate, as a fraction of a 100 ms tap; |u| below the deadband is "leave it". */
+    kp: 3,
+    kd: 0.6,
+    deadband: 0.08,
+    /** Half a 3.5 m lane. */
+    laneHalfM: 1.75,
+    /** Probe nudge, rad/s of yaw rate — about a third of what one short keyboard tap commands at 80 km/h. */
+    nudgeRadS: 0.2,
+    probeKph: [20, 40, 60, 100],
+    probeUpshifts: 2,
+    probeWatchS: 2.5,
+    spinSideslipRad: 0.35,
+    spinYawGain: 3,
+    marginalRad: 0.1,
+    unsettledFraction: 0.5,
+    wheelspinSlip: 0.2,
+    gapWarn: 0.15,
+    postShiftS: 1.5,
+    endKph: 160,
+    maxS: 20,
+};
+const wrap = (a) => Math.atan2(Math.sin(a), Math.cos(a));
+const yawOf = (q) => Math.atan2(2 * (q.x * q.z + q.w * q.y), 1 - 2 * (q.x * q.x + q.y * q.y));
+async function rig(hc, tuning) {
+    const world = await hc.SharedPhysicsWorld.create(-9.81, { stepMode: 'fixed', fixedHz: HZ });
+    world.addStaticCuboid({ x: 12000, y: 1, z: 12000 }, { x: 0, y: -1, z: 0 });
+    const id = 'keyboard-launch';
+    const car = new hc.EmitterVehicleController({ world, id, tuning, position: { x: 0, y: hc.suspensionRestReach(tuning.contacts), z: 0 }, onTuningIssues: () => undefined });
+    // The live drive ability's AUTO-HOLD: a driver at rest with no input has the brake on (the v2 automatic creeps on idle
+    // torque otherwise, and the run would start rolling).
+    car.setInput({ throttle: 0, brake: 1, steer: 0, forwardIntent: 0 });
+    for (let i = 0; i < 180; i += 1)
+        world.step(H);
+    return { world, car, dispose: () => world.dispose() };
+}
+/** One state read, relative to the lane (heading `laneYaw`, through `origin`). */
+function sample(car, laneYaw, origin, t) {
+    const s = car.getState();
+    const yawAbs = yawOf(s.orientation);
+    const fx = Math.sin(yawAbs);
+    const fz = Math.cos(yawAbs);
+    const v = s.linearVelocity;
+    const vLat = v.x * fz - v.z * fx;
+    const dx = s.position.x - origin.x;
+    const dz = s.position.z - origin.z;
+    const tel = car.landDriveline?.telemetry;
+    let slip = typeof tel?.peakDriveSlip === 'number' ? tel.peakDriveSlip : 0;
+    if (!tel)
+        for (const w of s.wheels ?? [])
+            slip = Math.max(slip, Math.abs(w.relaxedSlipRatio ?? 0));
+    return {
+        t, kph: s.forwardSpeed * 3.6, gear: s.gear, yaw: wrap(yawAbs - laneYaw),
+        lat: dx * Math.cos(laneYaw) - dz * Math.sin(laneYaw),
+        beta: Math.atan2(vLat, Math.max(1, Math.abs(s.forwardSpeed))),
+        r: s.angularVelocity.y, slip, shifting: tel?.shifting === true,
+        ...(tel?.tractionControl ? { tc: tel.tractionControl.active === true } : {}),
+    };
+}
+/** The keyboard composite: W held, A/D as a tap; normalised like `InputService` normalises `move`. */
+function keyboardInput(steerKey) {
+    const len = Math.hypot(steerKey, 1);
+    return { throttle: 1 / len, steer: steerKey / len };
+}
+/** The player's tap for the next decision window: [ticks held, direction]. */
+function playerTap(headingRad, lateralM, yawRateRadS, p = exports.KEYBOARD_LAUNCH) {
+    const e = wrap(headingRad + lateralM / p.lookAheadM);
+    const u = Math.max(-1, Math.min(1, p.kp * e + p.kd * yawRateRadS));
+    if (Math.abs(u) < p.deadband)
+        return { ticks: 0, dir: 0 };
+    return { ticks: Math.round(Math.abs(u) * p.decisionTicks), dir: u > 0 ? 1 : -1 };
+}
+async function launchRun(hc, tuning, p = exports.KEYBOARD_LAUNCH) {
+    const r = await rig(hc, tuning);
+    try {
+        const s0 = r.car.getState();
+        const laneYaw = yawOf(s0.orientation) - (p.misalignDeg * Math.PI) / 180;
+        const origin = { x: s0.position.x, z: s0.position.z };
+        const hist = [];
+        let tap = { ticks: 0, dir: 0 };
+        let t100 = null;
+        const gears = new Map();
+        const upshifts = [];
+        let open = null;
+        let prev = sample(r.car, laneYaw, origin, 0);
+        let maxHeading = 0;
+        let maxBeta = 0;
+        let maxLat = 0;
+        let maxR = 0;
+        let spun = false;
+        let tcS = null;
+        let cur = prev;
+        for (let i = 0; i < p.maxS * HZ; i += 1) {
+            hist.push(prev);
+            if (i % p.decisionTicks === 0) {
+                const seen = hist[Math.max(0, hist.length - 1 - p.reactionTicks)];
+                tap = playerTap(seen.yaw, seen.lat, seen.r, p);
+            }
+            const key = (i % p.decisionTicks) < tap.ticks ? tap.dir : 0;
+            r.car.setInput({ ...keyboardInput(key), forwardIntent: 1, brake: 0 });
+            r.world.step(H);
+            cur = sample(r.car, laneYaw, origin, (i + 1) * H);
+            if (t100 === null && cur.kph >= 100)
+                t100 = cur.t;
+            if (cur.tc !== undefined)
+                tcS = (tcS ?? 0) + (cur.tc ? H : 0);
+            maxHeading = Math.max(maxHeading, Math.abs(cur.yaw));
+            maxBeta = Math.max(maxBeta, Math.abs(cur.beta));
+            maxLat = Math.max(maxLat, Math.abs(cur.lat));
+            maxR = Math.max(maxR, Math.abs(cur.r));
+            if (cur.gear > 0) {
+                const g = gears.get(cur.gear) ?? { gear: cur.gear, seconds: 0, wheelspinS: 0, peakSlip: 0 };
+                g.seconds += H;
+                if (cur.slip > p.wheelspinSlip)
+                    g.wheelspinS += H;
+                g.peakSlip = Math.max(g.peakSlip, cur.slip);
+                gears.set(cur.gear, g);
+            }
+            // An upshift has re-engaged when the box stops shifting into a higher gear.
+            if (prev.shifting && !cur.shifting && cur.gear > 0 && upshifts.length < 8) {
+                const from = [...hist].reverse().find((h) => !h.shifting)?.gear ?? cur.gear - 1;
+                if (cur.gear > from) {
+                    open = { from, to: cur.gear, kph: cur.kph, atS: cur.t, peakYawRateRadS: 0, peakHeadingRad: 0, peakSideslipRad: 0, peakSlip: 0 };
+                    upshifts.push(open);
+                }
+            }
+            if (open) {
+                if (cur.t - open.atS <= p.postShiftS) {
+                    open.peakYawRateRadS = Math.max(open.peakYawRateRadS, Math.abs(cur.r));
+                    open.peakHeadingRad = Math.max(open.peakHeadingRad, Math.abs(cur.yaw));
+                    open.peakSideslipRad = Math.max(open.peakSideslipRad, Math.abs(cur.beta));
+                    open.peakSlip = Math.max(open.peakSlip, cur.slip);
+                }
+                else
+                    open = null;
+            }
+            if (Math.abs(cur.beta) >= 1.2 || Math.abs(cur.yaw) >= 1.2) {
+                spun = true;
+                break;
+            }
+            const settledAfterShifts = upshifts.length >= 2 && cur.t - upshifts[1].atS > p.postShiftS;
+            if (t100 !== null && (settledAfterShifts || cur.kph >= p.endKph))
+                break;
+            prev = cur;
+        }
+        spun ||= maxBeta >= p.spinSideslipRad || maxHeading >= p.spinSideslipRad;
+        const round = (v, d = 3) => Math.round(v * 10 ** d) / 10 ** d;
+        return {
+            zeroToHundredKphS: t100 === null ? null : round(t100), instrumentZeroToHundredKphS: null, gapS: null, gapFraction: null,
+            maxHeadingRad: round(maxHeading, 4), maxSideslipRad: round(maxBeta, 4), maxLaneOffsetM: round(maxLat), maxYawRateRadS: round(maxR),
+            spun, endKph: round(cur.kph, 1), endS: round(cur.t), tractionControlS: tcS === null ? null : round(tcS, 2),
+            gears: [...gears.values()].sort((a, b) => a.gear - b.gear).map((g) => ({ gear: g.gear, seconds: round(g.seconds, 2), wheelspinS: round(g.wheelspinS, 2), peakSlip: round(g.peakSlip, 2) })),
+            upshifts: upshifts.map((u) => ({ ...u, kph: round(u.kph, 1), atS: round(u.atS), peakYawRateRadS: round(u.peakYawRateRadS), peakHeadingRad: round(u.peakHeadingRad, 4), peakSideslipRad: round(u.peakSideslipRad, 4), peakSlip: round(u.peakSlip, 2) })),
+        };
+    }
+    finally {
+        r.dispose();
+    }
+}
+/** One hands-off nudge. `at` is a speed (km/h) or the n-th upshift's re-engagement. */
+async function probeOnce(hc, tuning, at, direction, p = exports.KEYBOARD_LAUNCH) {
+    const r = await rig(hc, tuning);
+    try {
+        const s0 = r.car.getState();
+        const laneYaw = yawOf(s0.orientation);
+        const origin = { x: s0.position.x, z: s0.position.z };
+        const handle = r.world.getBody?.('keyboard-launch')?.body;
+        if (!handle?.angvel || !handle?.setAngvel)
+            return null;
+        let prev = sample(r.car, laneYaw, origin, 0);
+        let ups = 0;
+        let from = prev.gear;
+        let nudged = null;
+        let peakR = 0;
+        let peakB = 0;
+        let r1 = null;
+        for (let i = 0; i < p.maxS * HZ; i += 1) {
+            r.car.setInput({ throttle: 1, steer: 0, forwardIntent: 1, brake: 0 });
+            r.world.step(H);
+            const cur = sample(r.car, laneYaw, origin, (i + 1) * H);
+            if (!nudged) {
+                if (!prev.shifting)
+                    from = prev.gear;
+                let trigger = false;
+                if ('kph' in at)
+                    trigger = cur.kph >= at.kph;
+                else if (prev.shifting && !cur.shifting && cur.gear > from) {
+                    ups += 1;
+                    trigger = ups === at.upshift;
+                }
+                if (trigger) {
+                    const w = handle.angvel();
+                    handle.setAngvel({ x: w.x, y: w.y + direction * p.nudgeRadS, z: w.z }, true);
+                    nudged = { i, s: cur };
+                }
+            }
+            else {
+                peakR = Math.max(peakR, Math.abs(cur.r));
+                peakB = Math.max(peakB, Math.abs(cur.beta));
+                if (r1 === null && i - nudged.i >= HZ)
+                    r1 = Math.abs(cur.r);
+                if (i - nudged.i >= p.probeWatchS * HZ || peakB >= 1.2)
+                    break;
+            }
+            prev = cur;
+        }
+        if (!nudged)
+            return null;
+        const spins = peakB >= p.spinSideslipRad || peakR >= p.spinYawGain * p.nudgeRadS;
+        const unsettled = !spins && ((r1 ?? peakR) > p.unsettledFraction * p.nudgeRadS || peakB > p.marginalRad);
+        const round = (v, d = 3) => Math.round(v * 10 ** d) / 10 ** d;
+        return {
+            at: 'kph' in at ? `${at.kph} km/h` : `upshift ${at.upshift} re-engages`,
+            kph: round(nudged.s.kph, 1), gear: nudged.s.gear, slipAtNudge: round(nudged.s.slip, 2), direction,
+            peakYawRateRadS: round(peakR), peakSideslipRad: round(peakB), yawRateAfter1sRadS: round(r1 ?? peakR),
+            outcome: spins ? 'spins' : unsettled ? 'unsettled' : 'settles',
+        };
+    }
+    finally {
+        r.dispose();
+    }
+}
+const deg = (rad) => `${((rad * 180) / Math.PI).toFixed(1)}°`;
+/** Run the keyboard launch and the hands-off probe and judge them. Needs the real runtime (Rapier). */
+async function measureKeyboardLaunch(hc, tuning, instrumentZeroToHundredKphS, p = exports.KEYBOARD_LAUNCH) {
+    const run = await launchRun(hc, tuning, p);
+    if (run.zeroToHundredKphS !== null && instrumentZeroToHundredKphS !== null && instrumentZeroToHundredKphS > 0) {
+        run.instrumentZeroToHundredKphS = instrumentZeroToHundredKphS;
+        run.gapS = Math.round((run.zeroToHundredKphS - instrumentZeroToHundredKphS) * 1000) / 1000;
+        run.gapFraction = Math.round((run.gapS / instrumentZeroToHundredKphS) * 1000) / 1000;
+    }
+    else
+        run.instrumentZeroToHundredKphS = instrumentZeroToHundredKphS;
+    const probe = [];
+    const events = [
+        ...p.probeKph.filter((k) => k < 100).map((kph) => ({ kph })),
+        ...Array.from({ length: p.probeUpshifts }, (_, k) => ({ upshift: k + 1 })),
+        ...p.probeKph.filter((k) => k >= 100).map((kph) => ({ kph })),
+    ];
+    for (const at of events) {
+        // Both directions: a car is only as drivable as its worse side (an offset centre of mass, an asymmetric diff).
+        const pair = [await probeOnce(hc, tuning, at, 1, p), await probeOnce(hc, tuning, at, -1, p)].filter((x) => x !== null);
+        if (pair.length === 0)
+            continue;
+        const rank = { spins: 2, unsettled: 1, settles: 0 };
+        probe.push(pair.reduce((a, b) => (rank[b.outcome] > rank[a.outcome] || (rank[b.outcome] === rank[a.outcome] && b.peakSideslipRad > a.peakSideslipRad) ? b : a)));
+    }
+    const fail = [];
+    const warn = [];
+    const spins = probe.filter((x) => x.outcome === 'spins');
+    if (spins.length > 0) {
+        fail.push(`the rear lets go under full throttle: a ${p.nudgeRadS} rad/s yaw nudge with the wheel straight grows into a spin at ${spins.map((x) => `${x.at} (gear ${x.gear}, ${x.kph} km/h, driven slip ${x.slipAtNudge}: yaw rate ${x.peakYawRateRadS} rad/s, sideslip ${deg(x.peakSideslipRad)})`).join('; ')}`);
+    }
+    if (run.spun)
+        fail.push(`the keyboard player lost it: sideslip ${deg(run.maxSideslipRad)}, heading error ${deg(run.maxHeadingRad)}`);
+    else if (run.maxLaneOffsetM > p.laneHalfM)
+        fail.push(`the keyboard player could not keep it in a 3.5 m lane: ${run.maxLaneOffsetM} m off centre`);
+    if (!run.spun && (run.maxHeadingRad > p.marginalRad || run.maxSideslipRad > p.marginalRad)) {
+        warn.push(`the keyboard player had to fight it: heading error up to ${deg(run.maxHeadingRad)}, sideslip up to ${deg(run.maxSideslipRad)} (warn above ${deg(p.marginalRad)})`);
+    }
+    const unsettled = probe.filter((x) => x.outcome === 'unsettled');
+    if (unsettled.length > 0)
+        warn.push(`a ${p.nudgeRadS} rad/s yaw nudge does not settle within 1 s at ${unsettled.map((x) => `${x.at} (yaw rate ${x.yawRateAfter1sRadS} rad/s after 1 s, sideslip ${deg(x.peakSideslipRad)})`).join('; ')}`);
+    if (run.zeroToHundredKphS === null)
+        warn.push(`the keyboard launch never reached 100 km/h (ended at ${run.endKph} km/h after ${run.endS} s)`);
+    else if (run.gapFraction !== null && run.gapFraction > p.gapWarn)
+        warn.push(`keyboard 0-100 ${run.zeroToHundredKphS} s is ${(run.gapFraction * 100).toFixed(0)} % slower than the instrument's ${run.instrumentZeroToHundredKphS} s (warn above ${p.gapWarn * 100} %)`);
+    const verdict = fail.length > 0 ? 'FAIL' : warn.length > 0 ? 'WARN' : 'PASS';
+    return { verdict, reasons: [...fail.map((x) => `FAIL: ${x}`), ...warn.map((x) => `WARN: ${x}`)], run, probe, player: p };
+}
+/** Human-readable block for `formatSimulationReport`. */
+function formatKeyboardLaunch(k) {
+    const lines = [];
+    const r = k.run;
+    const f = (v, d = 2) => (v === null ? '—' : v.toFixed(d));
+    lines.push(`  keyboard launch (W from rest, A/D taps with 100 ms reactions, start ${k.player.misalignDeg}° off the lane): 0-100 ${f(r.zeroToHundredKphS)} s vs instrument ${f(r.instrumentZeroToHundredKphS)} s${r.gapS !== null ? ` (${r.gapS >= 0 ? '+' : ''}${r.gapS.toFixed(2)} s, ${r.gapFraction >= 0 ? '+' : ''}${(r.gapFraction * 100).toFixed(1)} %)` : ''}; worst heading ${deg(r.maxHeadingRad)}, sideslip ${deg(r.maxSideslipRad)}, lane offset ${r.maxLaneOffsetM.toFixed(2)} m${r.spun ? ' — SPUN' : ''}`);
+    lines.push(`    wheelspin (driven slip > ${k.player.wheelspinSlip}): ${r.gears.map((g) => `gear ${g.gear} ${g.wheelspinS.toFixed(2)} of ${g.seconds.toFixed(2)} s, peak slip ${g.peakSlip}`).join(' · ') || '—'}${r.tractionControlS === null || r.tractionControlS === undefined ? '' : ` · traction control cutting ${r.tractionControlS.toFixed(2)} s`}`);
+    for (const u of r.upshifts) {
+        lines.push(`    ${u.from}->${u.to} at ${u.kph} km/h, next ${k.player.postShiftS} s: yaw rate ${u.peakYawRateRadS} rad/s, heading ${deg(u.peakHeadingRad)}, sideslip ${deg(u.peakSideslipRad)}, driven slip ${u.peakSlip}`);
+    }
+    lines.push(`  hands-off ${k.player.nudgeRadS} rad/s yaw nudge at full throttle: ${k.probe.map((x) => `${x.at} (g${x.gear}, slip ${x.slipAtNudge}) ${x.outcome === 'spins' ? 'SPINS' : x.outcome} [${x.peakYawRateRadS} rad/s, ${deg(x.peakSideslipRad)}]`).join(' · ') || '—'}`);
+    for (const reason of k.reasons)
+        lines.push(`  ${reason.startsWith('FAIL') ? '✖' : '⚠'} keyboard launch ${reason}`);
+    if (k.verdict === 'FAIL')
+        lines.push('  ✖ keyboard launch: FAIL — not drivable on a keyboard (see skills/helix-vehicles/references/physics-from-specs.md, "Drivable on a keyboard" and "Traction control")');
+    else
+        lines.push(`  ${k.verdict === 'PASS' ? '✔' : '⚠'} keyboard launch: ${k.verdict}`);
+    return lines;
+}
+//# sourceMappingURL=keyboardLaunch.js.map

package/dist/vehicle/keyboardLaunch.js.map

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

package/dist/vehicle/lampCoverage.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Lamp COVERAGE for `helix vehicle validate` (docs/vehicles.md §4): does every lens the model carries actually light,
+ * and does each light function cover the whole car?
+ *
+ * WHY THIS EXISTS. Round 8's Ferrari F40 shipped with every lamp node present, each with its own emissive material,
+ * and was accepted by the node-level lamp checks (`LAMP_*` in validate.ts) — yet the car had a front indicator pair only.
+ * The rear amber lenses were painted into the body, so on hazards nothing at the back of the car changed. Nothing in
+ * the contract says WHICH nodes a function lights; what lights a lens is a `specialty.componentBuild.materials` row
+ * whose `slot` matches a mesh name, a material name or a named ancestor (the engine's `componentPresentation.ts`
+ * indexes exactly those aliases). So this judges the LIT GEOMETRY — the nodes the rows resolve to — never node names:
+ *
+ *   1. every indicator side must light something that reaches BOTH the front and the rear quarter of the car
+ *      (front-only is the F40); a car that really has no rear indicators must say so and why
+ *      (`lights.noRearIndicators`), because nothing else separates "the real car has none" from "the author did not
+ *      model them";
+ *   2. every lens-like mesh node (an emissive material, or a lamp/lens/indicator/repeater name) must be reached by a
+ *      row — an unlit lens of a declared function is dead geometry, and the error names it;
+ *   3. each lamp function the model has must have the rows its function needs (low+high beam, fog, tail+brake, reverse).
+ *
+ * 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>;
+/** `lights.noRearIndicators` is a free-text reason; anything shorter than this is not a reason. */
+export declare const MIN_NO_REAR_INDICATORS_REASON_CHARS = 20;
+export interface LampRow {
+    slot: string;
+    signal: string | undefined;
+    index: number;
+}
+/** Each emissive-driving row of `specialty.componentBuild.materials`, with the signal that drives it. */
+export declare function lampRows(pkg: Json | undefined): LampRow[];
+type Side = 'left' | 'right' | 'both' | undefined;
+/** Which side an indicator row serves: by its signal name (`signal_L`, `indicatorRight`, `hazards`), else undefined. */
+export declare function indicatorSide(signal: string | undefined): Side;
+export interface LampCoverageInput {
+    pkg: Json | undefined;
+    gltf: Gltf;
+    facts: Map<number, NodeFacts>;
+    /** Node identity (`headlamps`, `indicator_l`, …) → node indices, as the lamp checks already resolve them. */
+    indicesFor: (name: string) => number[];
+}
+/** The reason a package gives for a car with no rear indicators, if it gives one. */
+export declare function noRearIndicatorsReason(pkg: Json | undefined): {
+    declared: boolean;
+    reason: string;
+};
+export declare function checkLampCoverage(input: LampCoverageInput): VehicleIssue[];
+export {};