@adatechnology/game-vehicles-three 0.5.0 → 0.6.0

package/dist/index.js

@@ -1,47 +1,87 @@
 import {
+  BIKE_ENGINE,
+  CAR_ENGINE,
+  CRASH_SPEEDS,
   DEFAULT_TEST_VEHICLES,
   DEFAULT_TEST_WRECKS,
+  DEFAULT_VEHICLE_SOUND_KEYS,
+  ENGINE_PROFILES,
   LITE_CLASSES,
   PAGE_ITEM_ALIASES,
   PAGE_SCENARIO_ALIASES,
+  PROVING_AREA_ID,
+  PROVING_TEXT,
   PRUNE_BELOW,
+  TRUCK_ENGINE,
   VEHICLES_AREA_ID,
   VEHICLE_LOD_DISTANCE,
+  VEHICLE_LOOPS,
+  VEHICLE_LOOP_FALLOFF,
   VEHICLE_SCENARIO_IDS,
+  VEHICLE_SOUNDS,
+  VEHICLE_SOUND_BANK,
   classColor,
   classify,
   createCabinSmoke,
+  createGearGuess,
+  createProvingModule,
   createVehicleLod,
+  createVehicleSound,
   createVehiclesTestModule,
   createVehiclesThree,
   defaultEffectIds,
   defaultSoundIds,
+  engineMix,
+  firingHz,
   fuse,
+  layerWeight,
   liteMaterials,
   liteMeshes,
-  loadVehiclesTestModule
-} from "./chunk-GAO7ZJP7.js";
+  loadProvingModule,
+  loadVehiclesTestModule,
+  rpmShare
+} from "./chunk-4SUQMRS3.js";
 export {
+  BIKE_ENGINE,
+  CAR_ENGINE,
+  CRASH_SPEEDS,
   DEFAULT_TEST_VEHICLES,
   DEFAULT_TEST_WRECKS,
+  DEFAULT_VEHICLE_SOUND_KEYS,
+  ENGINE_PROFILES,
   LITE_CLASSES,
   PAGE_ITEM_ALIASES,
   PAGE_SCENARIO_ALIASES,
+  PROVING_AREA_ID,
+  PROVING_TEXT,
   PRUNE_BELOW,
+  TRUCK_ENGINE,
   VEHICLES_AREA_ID,
   VEHICLE_LOD_DISTANCE,
+  VEHICLE_LOOPS,
+  VEHICLE_LOOP_FALLOFF,
   VEHICLE_SCENARIO_IDS,
+  VEHICLE_SOUNDS,
+  VEHICLE_SOUND_BANK,
   classColor,
   classify,
   createCabinSmoke,
+  createGearGuess,
+  createProvingModule,
   createVehicleLod,
+  createVehicleSound,
   createVehiclesTestModule,
   createVehiclesThree,
   defaultEffectIds,
   defaultSoundIds,
+  engineMix,
+  firingHz,
   fuse,
+  layerWeight,
   liteMaterials,
   liteMeshes,
-  loadVehiclesTestModule
+  loadProvingModule,
+  loadVehiclesTestModule,
+  rpmShare
 };
 //# sourceMappingURL=index.js.map

package/dist/{testing-DmGv7Gpb.d.ts → testing-gEnSqEF6.d.ts}

@@ -1,5 +1,6 @@
 import { EffectSink, Vec3, TestableModule } from '@adatechnology/game-contracts';
 import { Damageable, VehicleContext, VehicleKit } from '@adatechnology/game-vehicles';
+import { ProvingSubject, ProvingTestRegistry, ProvingCertificate } from '@adatechnology/game-vehicles-proving';
 
 type VehicleQuality = 'high' | 'lite';
 /** The measured size of a fleet vehicle in metres (the shape of `FleetDims` of `game-vehicles-fleet`). */
@@ -76,6 +77,69 @@ interface VehiclesThreeOptions {
  */
 declare function createVehiclesThree(THREE: any, options: VehiclesThreeOptions): VehiclesThree;
 
+/**
+ * How a vehicle sounds, as data. An engine is a few loops crossfaded by RPM (idle, low/mid, high) plus a load layer (intake and exhaust roar) that
+ * follows the throttle, the way a sampled engine is mixed: when recorded loops arrive they take the same ids and the same crossfade. The pitch of
+ * each tone layer is the firing frequency of the engine (`rpm / 60 × cylinders / 2` for a four-stroke) times its harmonic.
+ */
+/** One tone layer of the engine: the loop id, where in the RPM range it is loudest (0 idle … 1 redline), and its level and cutoff. */
+type EngineLayer = {
+    readonly sound: string;
+    /** Normalised RPM (0 at idle, 1 at the redline) where the layer is loudest. */
+    readonly centre: number;
+    /** How far from `centre` the layer fades out (equal-power crossfade). */
+    readonly width: number;
+    /** Multiple of the firing frequency the oscillator plays at. */
+    readonly harmonic: number;
+    /** Level at full load. */
+    readonly gain: number;
+    /** Low-pass cutoff, Hz, from no load at idle to full load at the redline. */
+    readonly cutoff: readonly [min: number, max: number];
+};
+/** The roar of the intake and exhaust: a noise loop that opens with the throttle and the RPM. */
+type EngineLoadLayer = {
+    readonly sound: string;
+    readonly gain: number;
+    readonly cutoff: readonly [min: number, max: number];
+};
+type EngineProfile = {
+    readonly id: string;
+    readonly cylinders: number;
+    readonly idleRpm: number;
+    readonly redlineRpm: number;
+    /** Gear ratios times final drive per m/s, to guess the RPM from the speed when the driver has no engine model (the arcade driver). */
+    readonly rpmPerMps: readonly number[];
+    readonly layers: readonly EngineLayer[];
+    readonly load: EngineLoadLayer;
+    /** Level with the throttle closed, as a share of full load (engine braking is quieter and darker). */
+    readonly closedThrottle: number;
+};
+/** The sound ids a vehicle plays besides its engine. Every one is a key of `VEHICLE_SOUND_BANK`, and a game can point any of them elsewhere. */
+type VehicleSoundKeys = {
+    readonly start: string;
+    readonly stop: string;
+    readonly fail: string;
+    readonly crashLight: string;
+    readonly crashMedium: string;
+    readonly crashHeavy: string;
+    readonly skidAsphalt: string;
+    readonly skidDirt: string;
+    readonly roll: string;
+};
+declare const DEFAULT_VEHICLE_SOUND_KEYS: VehicleSoundKeys;
+/** The speed of the hit, m/s, where a crash stops being light (≈ 22 km/h: dents and plastic) and where it turns heavy (≈ 50 km/h: metal folds, glass goes). */
+declare const CRASH_SPEEDS: {
+    readonly medium: 6;
+    readonly heavy: 14;
+};
+/** A four-cylinder petrol car: 800 to 6 500 rpm. */
+declare const CAR_ENGINE: EngineProfile;
+/** A six-cylinder diesel truck or bus: 650 to 2 600 rpm, low and clattering. */
+declare const TRUCK_ENGINE: EngineProfile;
+/** A four-cylinder sport bike: 1 300 to 12 000 rpm, bright and fast to rev. */
+declare const BIKE_ENGINE: EngineProfile;
+declare const ENGINE_PROFILES: Readonly<Record<string, EngineProfile>>;
+
 /** The fleet the area runs on: its palettes and sizes, and how it is installed in a kit (`defaultVehicleFleet()` of `game-kit-defaults`). */
 type VehiclesTestFleet = VehicleFleetContent & {
     installFleet(kit: VehicleKit): void;
@@ -98,12 +162,13 @@ type VehicleEffectIds = {
     readonly exhaust: string;
 };
 declare const defaultEffectIds: VehicleEffectIds;
-/** The sounds the module asks of `host.audio`, by id of the host's banks. `engine` is a loop (the game's saw through a 400 Hz low-pass), `horn` and `crash` one-shots. */
+/**
+ * The sounds the module asks of `host.audio`, by id of the host's banks: the horn (placed at the car), and the vehicle's own sounds (`createVehicleSound`: the starter, the
+ * crashes by speed, the tyres). The engine loops come from the engine profile.
+ */
 type VehicleSoundIds = {
-    readonly engine: string;
     readonly horn: string;
-    readonly crash: string;
-};
+} & VehicleSoundKeys;
 declare const defaultSoundIds: VehicleSoundIds;
 /** A damaged vehicle of the area: the item id, the fleet vehicle it is built from and the scenario of the kit applied while building. */
 type VehicleWreck = {
@@ -131,7 +196,7 @@ type VehiclesTestOptions = {
     readonly wrecks?: readonly VehicleWreck[];
     /** Effect ids requested through `host.effects` (the defaults are ids of `game-vfx`: the Garagem's `car_fuel_tank` blast, the `vehicle_fire`, `vehicle_leak` (pool and drips only), `vehicle_leak_ignited` (the whole sequence) and `vehicle_exhaust` recipes written around a car from `engine_smoke` and `fuel_leak`, and the point-based `glass_burst` and `impact_metal`). */
     readonly effects?: Partial<VehicleEffectIds>;
-    /** Sound ids requested through `host.audio` (the defaults are the `game-audio` ones: `engine_saw`, `horn`, `sfx_impact`). */
+    /** Sound ids requested through `host.audio` (the defaults: the vehicle bank of this package). */
     readonly sounds?: Partial<VehicleSoundIds>;
 };
 /** The part of the test room the scenarios use (the room's `ScenarioContext.room` has all of it). */
@@ -216,4 +281,69 @@ declare const VEHICLE_SCENARIO_IDS: readonly string[];
 declare const PAGE_SCENARIO_ALIASES: Readonly<Record<string, string>>;
 declare const PAGE_ITEM_ALIASES: Readonly<Record<string, string>>;
 
-export { type BuildVehicleOptions as B, DEFAULT_TEST_VEHICLES as D, type EffectsLike as E, type FleetDims as F, type ModuleRoomLike as M, PAGE_ITEM_ALIASES as P, VEHICLES_AREA_ID as V, type BuiltVehicle as a, DEFAULT_TEST_WRECKS as b, type DocumentLike as c, PAGE_SCENARIO_ALIASES as d, VEHICLE_SCENARIO_IDS as e, type VehicleEffectIds as f, type VehicleFleetContent as g, type VehicleQuality as h, type VehicleSoundIds as i, type VehicleWreck as j, type VehiclesContext as k, type VehiclesRoom as l, type VehiclesTestFleet as m, type VehiclesTestOptions as n, type VehiclesThree as o, type VehiclesThreeOptions as p, createVehiclesTestModule as q, createVehiclesThree as r, defaultEffectIds as s, defaultSoundIds as t, loadVehiclesTestModule as u };
+declare const PROVING_AREA_ID = "vehicles_proving";
+type Three = any;
+/** Content comes in by option (the adapter does not import a content pack): the example wires the kit's fleet, a game its own catalogue. */
+interface ProvingModuleOptions {
+    locale?: string;
+    /** Vehicles offered on the bench, by catalogue id. */
+    vehicles: readonly string[];
+    /** The proving subject of a vehicle (`fleetProvingSubject` of game-vehicles-fleet); `mass` is the kit's own when it has one. Null hides the vehicle. */
+    subject(id: string, mass: number | undefined): ProvingSubject | null;
+    /** The vehicle's name on the bench and the board (default: the id). */
+    nameOf?(id: string): string | undefined;
+    /** The tests (default: the kit's, see `createProvingTests`). */
+    tests?: ProvingTestRegistry;
+    /** Builds the vehicle kit, with the catalogue installed, for a three.js namespace. */
+    createKit(THREE: Three): VehicleKit;
+    sounds?: Partial<VehicleSoundIds>;
+    /** Called whenever a certificate changes (a result in, a sign-off), so a page can keep or show them. */
+    onCertificate?(certificate: ProvingCertificate): void;
+}
+/**
+ * The proving ground as a `TestableModule`: a track where a fleet vehicle runs the measured tests of `game-vehicles-proving` live (0-100, top speed, braking, turning circle, wet braking, mud)
+ * on the same semi-simulation driver the headless runner uses, with the vehicle cameras of `game-camera` (chase, cockpit, hood) taking over the room's view, the rear-view and side mirrors
+ * and the reversing camera with its guide lines as extra views of the host, a board by the track with the vehicle's certificate, and the sign-off of the visual checks.
+ */
+declare function createProvingModule(options: ProvingModuleOptions): TestableModule & {
+    certificates(): ProvingCertificate[];
+    certificate(id: string): ProvingCertificate | undefined;
+};
+/** What `loadProvingModule` needs of a room: `TestRoom.loadModule` has it. */
+type ProvingRoomLike = {
+    loadModule(module: never): unknown;
+    openArea?(id: string): unknown;
+};
+declare function loadProvingModule<Room extends ProvingRoomLike>(room: Room, options: ProvingModuleOptions): ReturnType<Room['loadModule']>;
+
+/** Texts of the proving ground, in Brazilian Portuguese and English. */
+type ProvingText = {
+    name: string;
+    controls: Record<'vehicle' | 'test' | 'camera' | 'time_scale' | 'visual_check', string>;
+    hints: Record<'vehicle' | 'test' | 'camera' | 'time_scale' | 'visual_check', string>;
+    actions: Record<'run_test' | 'run_all' | 'certify_now' | 'reverse_park' | 'sign_ok' | 'sign_fail' | 'reset', string>;
+    layers: Record<'mirrors' | 'reverse_camera' | 'scoreboard', string>;
+    metrics: Record<'speed' | 'time' | 'value' | 'passed' | 'failed' | 'pending' | 'status', string>;
+    cameras: Record<'room' | 'chase' | 'cockpit' | 'hood', string>;
+    tests: Record<string, string>;
+    status: Record<'approved' | 'rejected' | 'pending', string>;
+    verdict: Record<'pass' | 'fail' | 'pending', string>;
+    board: {
+        title: string;
+        test: string;
+        value: string;
+        range: string;
+        verdict: string;
+        notRun: string;
+        running: string;
+    };
+    log: {
+        start: string;
+        result: string;
+        signed: string;
+        certified: string;
+    };
+};
+declare const PROVING_TEXT: Record<string, ProvingText>;
+
+export { type VehiclesTestOptions as A, BIKE_ENGINE as B, CAR_ENGINE as C, DEFAULT_TEST_VEHICLES as D, type EngineProfile as E, type FleetDims as F, type VehiclesThree as G, type VehiclesThreeOptions as H, createProvingModule as I, createVehiclesTestModule as J, createVehiclesThree as K, defaultEffectIds as L, type ModuleRoomLike as M, defaultSoundIds as N, loadProvingModule as O, PAGE_ITEM_ALIASES as P, loadVehiclesTestModule as Q, TRUCK_ENGINE as T, type VehicleSoundKeys as V, type BuildVehicleOptions as a, type BuiltVehicle as b, CRASH_SPEEDS as c, DEFAULT_TEST_WRECKS as d, DEFAULT_VEHICLE_SOUND_KEYS as e, type DocumentLike as f, ENGINE_PROFILES as g, type EffectsLike as h, type EngineLayer as i, type EngineLoadLayer as j, PAGE_SCENARIO_ALIASES as k, PROVING_AREA_ID as l, PROVING_TEXT as m, type ProvingModuleOptions as n, type ProvingRoomLike as o, type ProvingText as p, VEHICLES_AREA_ID as q, VEHICLE_SCENARIO_IDS as r, type VehicleEffectIds as s, type VehicleFleetContent as t, type VehicleQuality as u, type VehicleSoundIds as v, type VehicleWreck as w, type VehiclesContext as x, type VehiclesRoom as y, type VehiclesTestFleet as z };

package/dist/testing.d.ts

@@ -1,3 +1,4 @@
-export { D as DEFAULT_TEST_VEHICLES, b as DEFAULT_TEST_WRECKS, c as DocumentLike, E as EffectsLike, M as ModuleRoomLike, P as PAGE_ITEM_ALIASES, d as PAGE_SCENARIO_ALIASES, V as VEHICLES_AREA_ID, e as VEHICLE_SCENARIO_IDS, f as VehicleEffectIds, i as VehicleSoundIds, j as VehicleWreck, k as VehiclesContext, l as VehiclesRoom, m as VehiclesTestFleet, n as VehiclesTestOptions, q as createVehiclesTestModule, s as defaultEffectIds, t as defaultSoundIds, u as loadVehiclesTestModule } from './testing-DmGv7Gpb.js';
+export { D as DEFAULT_TEST_VEHICLES, d as DEFAULT_TEST_WRECKS, f as DocumentLike, h as EffectsLike, M as ModuleRoomLike, P as PAGE_ITEM_ALIASES, k as PAGE_SCENARIO_ALIASES, l as PROVING_AREA_ID, m as PROVING_TEXT, n as ProvingModuleOptions, o as ProvingRoomLike, p as ProvingText, q as VEHICLES_AREA_ID, r as VEHICLE_SCENARIO_IDS, s as VehicleEffectIds, v as VehicleSoundIds, w as VehicleWreck, x as VehiclesContext, y as VehiclesRoom, z as VehiclesTestFleet, A as VehiclesTestOptions, I as createProvingModule, J as createVehiclesTestModule, L as defaultEffectIds, N as defaultSoundIds, O as loadProvingModule, Q as loadVehiclesTestModule } from './testing-gEnSqEF6.js';
 import '@adatechnology/game-contracts';
 import '@adatechnology/game-vehicles';
+import '@adatechnology/game-vehicles-proving';

package/dist/testing.js

@@ -3,23 +3,31 @@ import {
   DEFAULT_TEST_WRECKS,
   PAGE_ITEM_ALIASES,
   PAGE_SCENARIO_ALIASES,
+  PROVING_AREA_ID,
+  PROVING_TEXT,
   VEHICLES_AREA_ID,
   VEHICLE_SCENARIO_IDS,
+  createProvingModule,
   createVehiclesTestModule,
   defaultEffectIds,
   defaultSoundIds,
+  loadProvingModule,
   loadVehiclesTestModule
-} from "./chunk-GAO7ZJP7.js";
+} from "./chunk-4SUQMRS3.js";
 export {
   DEFAULT_TEST_VEHICLES,
   DEFAULT_TEST_WRECKS,
   PAGE_ITEM_ALIASES,
   PAGE_SCENARIO_ALIASES,
+  PROVING_AREA_ID,
+  PROVING_TEXT,
   VEHICLES_AREA_ID,
   VEHICLE_SCENARIO_IDS,
+  createProvingModule,
   createVehiclesTestModule,
   defaultEffectIds,
   defaultSoundIds,
+  loadProvingModule,
   loadVehiclesTestModule
 };
 //# sourceMappingURL=testing.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adatechnology/game-vehicles-three",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "license": "MIT",
   "description": "three.js output of the vehicles of @adatechnology/game-vehicles: a vehicle in a game frame (front on +z, centred, on the ground) at full detail or fused into six meshes (the team's Frota Leve light mode), coloured by seed, with its damageable boxes; and the vehicles test module.",
   "keywords": [
@@ -41,13 +41,15 @@
     "dist"
   ],
   "dependencies": {
-    "@adatechnology/game-contracts": "^0.22.0",
+    "@adatechnology/game-audio": "^0.5.0",
+    "@adatechnology/game-camera": "^0.2.0",
+    "@adatechnology/game-contracts": "^0.23.0",
     "@adatechnology/game-render-three": "^0.1.0",
-    "@adatechnology/game-shapes-three": "^0.3.0",
-    "@adatechnology/game-vehicles": "^0.6.0",
-    "@adatechnology/game-audio": "^0.4.0",
-    "@adatechnology/game-vehicles-driving": "^0.2.9",
-    "@adatechnology/game-vehicles-fleet": "^6.0.0"
+    "@adatechnology/game-shapes-three": "^0.3.1",
+    "@adatechnology/game-vehicles": "^0.6.1",
+    "@adatechnology/game-vehicles-driving": "^0.2.10",
+    "@adatechnology/game-vehicles-fleet": "^6.0.0",
+    "@adatechnology/game-vehicles-proving": "^0.1.1"
   },
   "devDependencies": {
     "@types/node": "^22.10.7",
@@ -58,7 +60,7 @@
     "typescript": "^5.7.3",
     "vitest": "^3.2.4",
     "@adatechnology/game-kit-defaults": "^0.2.0",
-    "@adatechnology/game-test-room": "^0.21.0",
+    "@adatechnology/game-test-room": "^0.22.0",
     "@adatechnology/golden-tool": "^0.0.0"
   },
   "peerDependencies": {