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

package/dist/vehicle/simulateRuntime.d.ts

@@ -0,0 +1,76 @@
+export declare const ENGINE_RUNTIME_SLUG = "humanoid-character";
+export declare const DEFAULT_RUNTIME_RANGE = "^0.3";
+/** The CDN answers a bare client with 403; a browser UA is what the live web runtime sends. */
+export declare const RUNTIME_USER_AGENT = "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/140.0 Safari/537.36 helix-cli";
+/** The runtime exports the instrument needs. Checked after import so a renamed export fails loudly, not as NaN. */
+export declare const REQUIRED_RUNTIME_EXPORTS: readonly ["SYSTEM_VERSION", "vehiclePackageToTuning", "measureVehicle", "measureBraking", "SharedPhysicsWorld", "EmitterVehicleController", "suspensionRestReach"];
+export type FetchLike = (url: string, init?: {
+    redirect?: 'manual' | 'follow';
+    headers?: Record<string, string>;
+}) => Promise<{
+    status: number;
+    ok: boolean;
+    headers: {
+        get(name: string): string | null;
+    };
+    arrayBuffer(): Promise<ArrayBuffer>;
+}>;
+export interface RuntimeInfo {
+    slug: string;
+    range: string;
+    /** SYSTEM_VERSION of the bundle that ran. */
+    version: string;
+    sha256: string;
+    /** `live` = fetched now; `cache` = cached bytes matched the live sha; `cache (offline fallback: …)`; `file`. */
+    source: string;
+    apiUrl?: string;
+    codeUrl?: string;
+    fetchedAt?: string;
+    /** What the engine version's envelope declares vs what this CLI loaded it with. */
+    three: {
+        declared?: string;
+        loaded: string;
+    };
+    rapier: {
+        declared?: string;
+        loaded: string;
+    };
+    warnings: string[];
+}
+/** Engine module namespace (only what the instrument touches is typed loosely). */
+export type EngineRuntime = Record<string, any>;
+export interface LoadedRuntime {
+    info: RuntimeInfo;
+    engine: EngineRuntime;
+}
+export interface RuntimeOptions {
+    apiUrl: string;
+    range?: string;
+    /** Use the last cached bundle; never touch the network. */
+    offline?: boolean;
+    /** A local bundle file or an explicit URL (testing a candidate engine). */
+    runtime?: string;
+    cacheDir?: string;
+    fetchImpl?: FetchLike;
+}
+export declare function runtimeCacheDir(): string;
+/** `SYSTEM_VERSION = "0.3.180"` in the bundle source (the header can be absent on a direct CDN url). */
+export declare function bundleVersion(source: string): string | undefined;
+/**
+ * Point the bundle's bare module specifiers at concrete file URLs. Static `import … from "x"`, side-effect
+ * `import "x"` and dynamic `import("x")` are rewritten; anything else that merely looks like `from "…"` inside a
+ * string is left alone because only specifiers in `map` are touched. Throws when a bare static import remains
+ * that the map cannot satisfy — that is a runtime this CLI cannot load, and it must say so rather than half-run.
+ */
+export declare function rewriteBareSpecifiers(source: string, map: Record<string, string>): {
+    code: string;
+    rewritten: Record<string, number>;
+};
+/** The three / rapier this CLI loads the runtime with, as file URLs (rapier copied to `.mjs` so Node needs no type sniffing). */
+export declare function localEngineDeps(cacheDir: string): {
+    map: Record<string, string>;
+    three: string;
+    rapier: string;
+};
+/** Fetch (or reuse) the runtime bundle and import it. One import per sha per process. */
+export declare function loadEngineRuntime(opts: RuntimeOptions): Promise<LoadedRuntime>;

package/dist/vehicle/simulateRuntime.js

@@ -0,0 +1,252 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.REQUIRED_RUNTIME_EXPORTS = exports.RUNTIME_USER_AGENT = exports.DEFAULT_RUNTIME_RANGE = exports.ENGINE_RUNTIME_SLUG = void 0;
+exports.runtimeCacheDir = runtimeCacheDir;
+exports.bundleVersion = bundleVersion;
+exports.rewriteBareSpecifiers = rewriteBareSpecifiers;
+exports.localEngineDeps = localEngineDeps;
+exports.loadEngineRuntime = loadEngineRuntime;
+/**
+ * The engine runtime that `helix vehicle simulate` drives: the SAME bundle the platform serves to every world.
+ *
+ * WHY NOT A VENDORED COPY. A vendored snapshot measures the car the runtime used to drive. The physics changes
+ * between engine versions (0.3.159 projected add-on drivetrain ops into the v2 driveline, for example), so a
+ * figure is only worth quoting next to the version that produced it. This module therefore:
+ *
+ *   1. fetches `<api>/api/v1/instant-packages/<slug>/runtime/<range>/index.js` (a 307 to the CDN; the CDN refuses a
+ *      bare client, so the request carries a browser user agent), and reads the resolved version;
+ *   2. caches the bytes by sha256 under the CLI cache dir, with a per-(api, range) pointer to the last good fetch;
+ *   3. rewrites the bundle's only bare imports — `three` and `@dimforge/rapier3d-compat` — to file URLs of the
+ *      versions this CLI ships (three 0.185.1 via the `helix-runtime-three` alias, rapier 0.14.0 — the same copies `drive.ts` loads), and checks them against
+ *      the versions the engine version's envelope declares (`manifest.three` / `manifest.rapier`);
+ *   4. falls back to the last cached bundle when the network is unavailable, and SAYS SO in every report.
+ */
+const node_crypto_1 = require("node:crypto");
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const node_url_1 = require("node:url");
+const config_1 = require("../config");
+const esm_1 = require("../character/esm");
+exports.ENGINE_RUNTIME_SLUG = 'humanoid-character';
+exports.DEFAULT_RUNTIME_RANGE = '^0.3';
+/** The CDN answers a bare client with 403; a browser UA is what the live web runtime sends. */
+exports.RUNTIME_USER_AGENT = 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/140.0 Safari/537.36 helix-cli';
+/** The runtime exports the instrument needs. Checked after import so a renamed export fails loudly, not as NaN. */
+exports.REQUIRED_RUNTIME_EXPORTS = [
+    'SYSTEM_VERSION', 'vehiclePackageToTuning', 'measureVehicle', 'measureBraking', 'SharedPhysicsWorld',
+    'EmitterVehicleController', 'suspensionRestReach',
+];
+function runtimeCacheDir() {
+    return process.env.HELIX_ENGINE_RUNTIME_CACHE || (0, node_path_1.join)(config_1.CONFIG_DIR, 'cache', 'engine-runtime');
+}
+const sha256 = (bytes) => (0, node_crypto_1.createHash)('sha256').update(bytes).digest('hex');
+/** `SYSTEM_VERSION = "0.3.180"` in the bundle source (the header can be absent on a direct CDN url). */
+function bundleVersion(source) {
+    return /\bSYSTEM_VERSION\s*=\s*["']([^"']+)["']/.exec(source)?.[1];
+}
+/**
+ * Point the bundle's bare module specifiers at concrete file URLs. Static `import … from "x"`, side-effect
+ * `import "x"` and dynamic `import("x")` are rewritten; anything else that merely looks like `from "…"` inside a
+ * string is left alone because only specifiers in `map` are touched. Throws when a bare static import remains
+ * that the map cannot satisfy — that is a runtime this CLI cannot load, and it must say so rather than half-run.
+ */
+function rewriteBareSpecifiers(source, map) {
+    const rewritten = Object.fromEntries(Object.keys(map).map((k) => [k, 0]));
+    const pattern = /(\bfrom\s*|\bimport\s*\(\s*|\bimport\s*)(["'])([^"'\n]+)\2/g;
+    const code = source.replace(pattern, (whole, lead, quote, spec) => {
+        const target = map[spec];
+        if (target === undefined)
+            return whole;
+        rewritten[spec] = (rewritten[spec] ?? 0) + 1;
+        return `${lead}${quote}${target}${quote}`;
+    });
+    const unresolved = new Set();
+    for (const m of code.matchAll(/(?:^|[;\n}])\s*(?:import|export)\b[^;"'`]*?\bfrom\s*["']([^"'\n]+)["']/g))
+        unresolved.add(m[1]);
+    for (const m of code.matchAll(/(?:^|[;\n])\s*import\s*["']([^"'\n]+)["']/g))
+        unresolved.add(m[1]);
+    const bare = [...unresolved].filter((s) => !/^(?:\.{1,2}\/|\/|file:|https?:|node:|data:)/.test(s));
+    if (bare.length > 0) {
+        throw new Error(`the engine runtime imports ${bare.map((s) => `"${s}"`).join(', ')}, which this CLI does not provide (it provides ${Object.keys(map).join(', ')}); update @hypersoniclabs/helix-cli`);
+    }
+    return { code, rewritten };
+}
+function packageDir(name) {
+    // `require.resolve(name)` returns the CJS entry; walk up to the directory that owns package.json.
+    let dir = (0, node_path_1.dirname)(require.resolve(name));
+    while (!(0, node_fs_1.existsSync)((0, node_path_1.join)(dir, 'package.json')) && (0, node_path_1.dirname)(dir) !== dir)
+        dir = (0, node_path_1.dirname)(dir);
+    return dir;
+}
+/** The three / rapier this CLI loads the runtime with, as file URLs (rapier copied to `.mjs` so Node needs no type sniffing). */
+function localEngineDeps(cacheDir) {
+    const threeDir = packageDir('helix-runtime-three');
+    const three = JSON.parse((0, node_fs_1.readFileSync)((0, node_path_1.join)(threeDir, 'package.json'), 'utf8')).version;
+    const rapierDir = packageDir('@dimforge/rapier3d-compat');
+    const rapier = JSON.parse((0, node_fs_1.readFileSync)((0, node_path_1.join)(rapierDir, 'package.json'), 'utf8')).version;
+    const depsDir = (0, node_path_1.join)(cacheDir, 'deps');
+    (0, node_fs_1.mkdirSync)(depsDir, { recursive: true });
+    const rapierSrc = (0, node_path_1.join)(rapierDir, 'rapier.es.js');
+    const rapierMjs = (0, node_path_1.join)(depsDir, `rapier3d-compat-${rapier}.mjs`);
+    if (!(0, node_fs_1.existsSync)(rapierMjs) || (0, node_fs_1.statSync)(rapierMjs).size !== (0, node_fs_1.statSync)(rapierSrc).size)
+        (0, node_fs_1.copyFileSync)(rapierSrc, rapierMjs);
+    return {
+        map: {
+            three: (0, node_url_1.pathToFileURL)((0, node_path_1.join)(threeDir, 'build', 'three.module.js')).href,
+            '@dimforge/rapier3d-compat': (0, node_url_1.pathToFileURL)(rapierMjs).href,
+        },
+        three,
+        rapier,
+    };
+}
+const pointerName = (apiUrl, slug, range) => `latest-${(() => { try {
+    return new URL(apiUrl).host;
+}
+catch {
+    return 'local';
+} })()}-${slug}-${range}`.replace(/[^A-Za-z0-9._-]/g, '_') + '.json';
+async function fetchBytes(fetchImpl, url) {
+    const headers = { 'user-agent': exports.RUNTIME_USER_AGENT, accept: '*/*' };
+    const first = await fetchImpl(url, { redirect: 'manual', headers });
+    let res = first;
+    let codeUrl = url;
+    const version = first.headers.get('x-helix-resolved-version') ?? undefined;
+    if (first.status >= 300 && first.status < 400) {
+        const location = first.headers.get('location');
+        if (!location)
+            throw new Error(`${url} answered ${first.status} with no location`);
+        codeUrl = new URL(location, url).href;
+        res = await fetchImpl(codeUrl, { headers });
+    }
+    if (!res.ok)
+        throw new Error(`${codeUrl} answered HTTP ${res.status}`);
+    return { bytes: Buffer.from(await res.arrayBuffer()), codeUrl, version };
+}
+async function declaredDeps(fetchImpl, apiUrl, slug, version) {
+    try {
+        const res = await fetchImpl(`${apiUrl.replace(/\/$/, '')}/api/v1/instant-packages/${slug}/versions/${encodeURIComponent(version)}`, { headers: { accept: 'application/json', 'user-agent': exports.RUNTIME_USER_AGENT } });
+        if (!res.ok)
+            return {};
+        const body = JSON.parse(Buffer.from(await res.arrayBuffer()).toString('utf8'));
+        const m = body.item?.manifest;
+        return { three: typeof m?.three === 'string' ? m.three : undefined, rapier: typeof m?.rapier === 'string' ? m.rapier : undefined };
+    }
+    catch {
+        return {};
+    }
+}
+/** The newest cached bundle for this (api, range), or — failing that — the newest cached bundle of this slug at all. */
+function lastCached(cacheDir, apiUrl, slug, range) {
+    const pointer = (0, node_path_1.join)(cacheDir, pointerName(apiUrl, slug, range));
+    if ((0, node_fs_1.existsSync)(pointer)) {
+        const meta = JSON.parse((0, node_fs_1.readFileSync)(pointer, 'utf8'));
+        if ((0, node_fs_1.existsSync)((0, node_path_1.join)(cacheDir, meta.sha256, 'index.mjs')))
+            return meta;
+    }
+    if (!(0, node_fs_1.existsSync)(cacheDir))
+        return undefined;
+    const metas = (0, node_fs_1.readdirSync)(cacheDir)
+        .map((d) => (0, node_path_1.join)(cacheDir, d, 'meta.json'))
+        .filter(node_fs_1.existsSync)
+        .map((f) => JSON.parse((0, node_fs_1.readFileSync)(f, 'utf8')))
+        .filter((m) => m.slug === slug && (0, node_fs_1.existsSync)((0, node_path_1.join)(cacheDir, m.sha256, 'index.mjs')))
+        .sort((a, b) => b.fetchedAt.localeCompare(a.fetchedAt));
+    return metas[0];
+}
+const baseVersion = (v) => v?.replace(/^[^\d]*/, '').split('-')[0];
+let loaded;
+/** Fetch (or reuse) the runtime bundle and import it. One import per sha per process. */
+async function loadEngineRuntime(opts) {
+    const cacheDir = opts.cacheDir ?? runtimeCacheDir();
+    const range = opts.range ?? exports.DEFAULT_RUNTIME_RANGE;
+    const slug = exports.ENGINE_RUNTIME_SLUG;
+    const fetchImpl = opts.fetchImpl ?? globalThis.fetch;
+    const apiUrl = opts.apiUrl.replace(/\/$/, '');
+    const warnings = [];
+    (0, node_fs_1.mkdirSync)(cacheDir, { recursive: true });
+    let source;
+    let bytes;
+    let meta;
+    if (opts.runtime && !/^https?:\/\//.test(opts.runtime)) {
+        bytes = (0, node_fs_1.readFileSync)(opts.runtime);
+        const version = bundleVersion(bytes.toString('utf8')) ?? 'unknown';
+        meta = { sha256: sha256(bytes), version, range, slug, codeUrl: (0, node_url_1.pathToFileURL)(opts.runtime).href, fetchedAt: new Date().toISOString() };
+        source = 'file';
+    }
+    else if (opts.offline) {
+        const cached = lastCached(cacheDir, apiUrl, slug, range);
+        if (!cached)
+            throw new Error(`--offline: no engine runtime is cached under ${cacheDir}; run once with network access`);
+        meta = cached;
+        bytes = (0, node_fs_1.readFileSync)((0, node_path_1.join)(cacheDir, cached.sha256, 'index.mjs'));
+        source = `cache (offline, fetched ${cached.fetchedAt})`;
+    }
+    else {
+        const url = opts.runtime ?? `${apiUrl}/api/v1/instant-packages/${slug}/runtime/${encodeURIComponent(range)}/index.js`;
+        try {
+            const got = await fetchBytes(fetchImpl, url);
+            bytes = got.bytes;
+            const version = bundleVersion(bytes.toString('utf8')) ?? got.version ?? 'unknown';
+            if (got.version && version !== got.version)
+                warnings.push(`the API resolved ${range} to ${got.version} but the bundle declares SYSTEM_VERSION ${version}`);
+            const sha = sha256(bytes);
+            const already = (0, node_fs_1.existsSync)((0, node_path_1.join)(cacheDir, sha, 'index.mjs'));
+            meta = { sha256: sha, version, range, slug, apiUrl, codeUrl: got.codeUrl, fetchedAt: new Date().toISOString(), declared: await declaredDeps(fetchImpl, apiUrl, slug, version) };
+            source = already ? 'cache' : 'live';
+        }
+        catch (error) {
+            const reason = error instanceof Error ? error.message : String(error);
+            const cached = lastCached(cacheDir, apiUrl, slug, range);
+            if (!cached)
+                throw new Error(`could not fetch the engine runtime (${reason}) and none is cached under ${cacheDir}`);
+            meta = cached;
+            bytes = (0, node_fs_1.readFileSync)((0, node_path_1.join)(cacheDir, cached.sha256, 'index.mjs'));
+            source = `cache (offline fallback: ${reason}; fetched ${cached.fetchedAt})`;
+            warnings.push(`using the last cached runtime ${cached.version} (${cached.fetchedAt}) because the live one could not be fetched: ${reason}`);
+        }
+    }
+    // Persist: bytes by sha, meta beside them, and the (api, range) pointer for offline fallback.
+    const shaDir = (0, node_path_1.join)(cacheDir, meta.sha256);
+    (0, node_fs_1.mkdirSync)(shaDir, { recursive: true });
+    if (!(0, node_fs_1.existsSync)((0, node_path_1.join)(shaDir, 'index.mjs')))
+        (0, node_fs_1.writeFileSync)((0, node_path_1.join)(shaDir, 'index.mjs'), bytes);
+    if (source !== 'file') {
+        (0, node_fs_1.writeFileSync)((0, node_path_1.join)(shaDir, 'meta.json'), `${JSON.stringify(meta, null, 2)}\n`);
+        if (!source.startsWith('cache ('))
+            (0, node_fs_1.writeFileSync)((0, node_path_1.join)(cacheDir, pointerName(apiUrl, slug, range)), `${JSON.stringify(meta, null, 2)}\n`);
+    }
+    const deps = localEngineDeps(cacheDir);
+    const declared = meta.declared ?? {};
+    if (declared.three && baseVersion(declared.three) !== baseVersion(deps.three)) {
+        warnings.push(`engine ${meta.version} declares three ${declared.three}; this CLI loads it with three ${deps.three} — update @hypersoniclabs/helix-cli`);
+    }
+    if (declared.rapier && baseVersion(declared.rapier) !== baseVersion(deps.rapier)) {
+        warnings.push(`engine ${meta.version} declares rapier ${declared.rapier}; this CLI loads it with rapier ${deps.rapier} — update @hypersoniclabs/helix-cli`);
+    }
+    const depsKey = sha256(JSON.stringify(deps.map)).slice(0, 12);
+    const moduleFile = (0, node_path_1.join)(shaDir, `index.${depsKey}.mjs`);
+    if (!(0, node_fs_1.existsSync)(moduleFile)) {
+        const { code } = rewriteBareSpecifiers(bytes.toString('utf8'), deps.map);
+        (0, node_fs_1.writeFileSync)(moduleFile, code);
+    }
+    loaded ??= new Map();
+    const href = (0, node_url_1.pathToFileURL)(moduleFile).href;
+    let pending = loaded.get(href);
+    if (!pending) {
+        pending = (0, esm_1.importEsm)(href);
+        loaded.set(href, pending);
+    }
+    const engine = await pending;
+    const missing = exports.REQUIRED_RUNTIME_EXPORTS.filter((name) => engine[name] === undefined);
+    if (missing.length > 0)
+        throw new Error(`engine runtime ${meta.version} does not export ${missing.join(', ')}; update @hypersoniclabs/helix-cli`);
+    const version = typeof engine.SYSTEM_VERSION === 'string' ? engine.SYSTEM_VERSION : meta.version;
+    return {
+        engine,
+        info: {
+            slug, range, version, sha256: meta.sha256, source, apiUrl: meta.apiUrl, codeUrl: meta.codeUrl, fetchedAt: meta.fetchedAt,
+            three: { declared: declared.three, loaded: deps.three }, rapier: { declared: declared.rapier, loaded: deps.rapier }, warnings,
+        },
+    };
+}
+//# sourceMappingURL=simulateRuntime.js.map

package/dist/vehicle/simulateRuntime.js.map

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

package/dist/vehicle/testutil/sourcedAudio.d.ts

@@ -0,0 +1,13 @@
+type Json = Record<string, unknown>;
+export declare const TEST_PROVENANCE: Readonly<{
+    kind: "sim-mod";
+    sim: "beamng";
+    mod: "helix-test-mod";
+    sourceFile: "art/sound/test.wav";
+    sourceSha256: string;
+    extractor: "helix test fixture";
+}>;
+export declare function sourcedAudio<T extends Json>(audio: T, provenance?: Json): T;
+/** A broadband engine-like rung at fundamental `f0` (harmonics 1..20 at 1/h plus a noise floor), mono 16-bit PCM. */
+export declare function harmonicRungWav(f0: number, seconds?: number, rate?: number): Buffer;
+export {};

package/dist/vehicle/testutil/sourcedAudio.js

@@ -0,0 +1,96 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TEST_PROVENANCE = void 0;
+exports.sourcedAudio = sourcedAudio;
+exports.harmonicRungWav = harmonicRungWav;
+/**
+ * Test fixtures: turn a minimal `audio` block into one that satisfies the sourcing gate (audioProvenance.ts), so a spec
+ * about something else (silence, digests, closure membership) is not drowned by AUDIO_SLOT_UNSOURCED for the 29 slots
+ * it does not care about. Every recording gets a sim-mod provenance; every slot the fixture leaves out is added as a
+ * sourced recording the runtime does not consume (so nothing is fetched or decoded for it).
+ */
+const audioSlots_1 = require("../audioSlots");
+const isRecord = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+exports.TEST_PROVENANCE = Object.freeze({
+    kind: 'sim-mod', sim: 'beamng', mod: 'helix-test-mod', sourceFile: 'art/sound/test.wav',
+    sourceSha256: '0'.repeat(64), extractor: 'helix test fixture',
+});
+function sourcedAudio(audio, provenance = { ...exports.TEST_PROVENANCE }) {
+    const out = JSON.parse(JSON.stringify(audio));
+    // The runtime's mix fields (AUDIO_MIX_FIELDS_MISSING otherwise): the engine's defaults unless the spec sets them.
+    for (const [field, value] of Object.entries({ engineGainDb: -8, exhaustGainDb: -5, minLoadMix: 0.15, maxLoadMix: 1, muffling: 0.25 })) {
+        if (!(field in out))
+            out[field] = value;
+    }
+    const bank = isRecord(out.bank) ? out.bank : undefined;
+    if (bank) {
+        for (const asset of Array.isArray(bank.assets) ? bank.assets : [])
+            if (isRecord(asset) && !asset.provenance)
+                asset.provenance = { ...provenance };
+        for (const blend of Object.values(isRecord(bank.blends) ? bank.blends : {}))
+            if (isRecord(blend) && !blend.provenance)
+                blend.provenance = { ...provenance };
+    }
+    const slots = Array.isArray(out.slots) ? out.slots.filter(isRecord) : [];
+    for (const slot of slots) {
+        const assets = Array.isArray(slot.assets) ? slot.assets.filter(isRecord) : [];
+        for (const asset of assets)
+            if (!asset.provenance)
+                asset.provenance = { ...provenance };
+        if (!slot.provenance && (assets.length || (Array.isArray(slot.buffers) && slot.buffers.length)))
+            slot.provenance = { ...provenance };
+    }
+    for (const name of audioSlots_1.VEHICLE_AUDIO_SLOTS) {
+        if (slots.some((s) => s.slot === name))
+            continue;
+        if (name === 'engineLadder' && typeof out.engineBlend === 'string') {
+            slots.push({ slot: name, buffers: [`blend:${out.engineBlend}`], consumed: true, provenance: { ...provenance } });
+        }
+        else if (name === 'exhaustLadder') {
+            slots.push(typeof out.exhaustBlend === 'string'
+                ? { slot: name, buffers: [`blend:${out.exhaustBlend}`], consumed: true, provenance: { ...provenance } }
+                : { slot: name, buffers: [], consumed: false, absent: 'combined-with-engine', reason: 'one combined engine+exhaust recording' });
+        }
+        else if (name === 'turboSpool' || name === 'blowOff' || name === 'reverseBeep') {
+            // The fixture car is a naturally aspirated road car: these parts are legitimately not fitted.
+            slots.push({ slot: name, buffers: [], consumed: false, absent: 'not-fitted', reason: 'fixture: a naturally aspirated road car' });
+        }
+        else {
+            // A sourced recording the spec does not exercise: its provenance satisfies the sourcing gate. It ships no asset
+            // row: audio-check verifies every consumed:false asset still loads, and a placeholder cid has nothing behind it.
+            slots.push({ slot: name, buffers: [`test.${name}`], consumed: false, reason: 'fixture recording the spec does not exercise', provenance: { ...provenance } });
+        }
+    }
+    out.slots = slots;
+    return out;
+}
+/** A broadband engine-like rung at fundamental `f0` (harmonics 1..20 at 1/h plus a noise floor), mono 16-bit PCM. */
+function harmonicRungWav(f0, seconds = 3, rate = 48000) {
+    const n = Math.round(seconds * rate);
+    let seed = 12345;
+    const rand = () => { seed = (seed * 1664525 + 1013904223) >>> 0; return (seed / 0xffffffff) * 2 - 1; };
+    const data = Buffer.alloc(n * 2);
+    for (let i = 0; i < n; i += 1) {
+        let v = 0;
+        for (let h = 1; h <= 20; h += 1)
+            v += (1 / h) * Math.sin((2 * Math.PI * f0 * h * i) / rate);
+        const s = Math.max(-1, Math.min(1, (v * 0.5 + rand() * 0.12) * 0.3));
+        data.writeInt16LE(Math.round(s * 32767), i * 2);
+    }
+    const header = Buffer.alloc(44);
+    header.write('RIFF', 0, 'ascii');
+    header.writeUInt32LE(36 + data.length, 4);
+    header.write('WAVE', 8, 'ascii');
+    header.write('fmt ', 12, 'ascii');
+    header.writeUInt32LE(16, 16);
+    header.writeUInt16LE(1, 20);
+    header.writeUInt16LE(1, 22);
+    header.writeUInt32LE(rate, 24);
+    header.writeUInt32LE(rate * 2, 28);
+    header.writeUInt16LE(2, 32);
+    header.writeUInt16LE(16, 34);
+    header.write('data', 36, 'ascii');
+    header.writeUInt32LE(data.length, 40);
+    return Buffer.concat([header, data]);
+}
+//# sourceMappingURL=sourcedAudio.js.map

package/dist/vehicle/testutil/sourcedAudio.js.map

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