@aura3d/engine 4.1.2 → 4.2.0

package/dist/game/hud/canvasMinimap.d.ts

@@ -0,0 +1,60 @@
+/** Structural subset of CanvasRenderingContext2D the minimap draws with (a recording fake satisfies it in node tests). */
+export interface CanvasMinimapContext {
+    fillStyle: unknown;
+    strokeStyle: unknown;
+    lineWidth: number;
+    clearRect(x: number, y: number, w: number, h: number): void;
+    fillRect(x: number, y: number, w: number, h: number): void;
+    beginPath(): void;
+    moveTo(x: number, y: number): void;
+    lineTo(x: number, y: number): void;
+    closePath(): void;
+    fill(): void;
+    stroke(): void;
+    save(): void;
+    restore(): void;
+    translate(x: number, y: number): void;
+    rotate(angle: number): void;
+    roundRect?(x: number, y: number, w: number, h: number, r: number): void;
+}
+/** World rectangle `[x0, z0, x1, z1]` mapped onto the full square canvas. */
+export type CanvasMinimapBounds = readonly [number, number, number, number];
+export type CanvasMinimapLayer = {
+    readonly kind: "rect";
+    readonly rect: CanvasMinimapBounds;
+    readonly fill: string;
+} | {
+    readonly kind: "lines";
+    readonly segments: readonly CanvasMinimapBounds[];
+    readonly stroke: string;
+    readonly width: number;
+} | {
+    readonly kind: "points";
+    readonly points: readonly (readonly [number, number])[];
+    readonly fill: string;
+    readonly size: number;
+};
+export interface CanvasMinimapMarker {
+    readonly x: number;
+    readonly z: number;
+    /** Radians; the arrow rotates by `-heading` (the convention of the -z-forward game worlds). */
+    readonly heading: number;
+    readonly fill: string;
+    /** Arrow outline in canvas pixels around the origin; default is the 4-point chevron the ports used. */
+    readonly shape?: readonly (readonly [number, number])[];
+}
+export interface CanvasMinimapSpec {
+    /** Canvas side in pixels (the minimap is square). */
+    readonly size: number;
+    readonly bounds: CanvasMinimapBounds;
+    readonly background?: {
+        readonly fill: string;
+        readonly radius?: number;
+    };
+    /** Drawn in order, under the marker. */
+    readonly layers?: readonly CanvasMinimapLayer[];
+    readonly marker?: CanvasMinimapMarker;
+}
+/** Redraw the whole minimap. World to pixel is linear over `bounds`, so the same spec works at any `size`. */
+export declare function drawCanvasMinimap(ctx: CanvasMinimapContext, spec: CanvasMinimapSpec): void;
+//# sourceMappingURL=canvasMinimap.d.ts.map

package/dist/game/hud/canvasMinimap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canvasMinimap.d.ts","sourceRoot":"","sources":["../../../../../packages/game/src/hud/canvasMinimap.ts"],"names":[],"mappings":"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"}

package/dist/game/hud/canvasMinimap.js

@@ -0,0 +1,62 @@
+const CHEVRON = [[0, -8], [5.5, 7], [0, 3.5], [-5.5, 7]];
+/** Redraw the whole minimap. World to pixel is linear over `bounds`, so the same spec works at any `size`. */
+export function drawCanvasMinimap(ctx, spec) {
+    const e = spec.size;
+    const [bx0, bz0, bx1, bz1] = spec.bounds;
+    const nx = (x) => ((x - bx0) / (bx1 - bx0)) * e;
+    const nz = (z) => ((z - bz0) / (bz1 - bz0)) * e;
+    ctx.clearRect(0, 0, e, e);
+    if (spec.background) {
+        ctx.fillStyle = spec.background.fill;
+        ctx.beginPath();
+        if (ctx.roundRect && spec.background.radius)
+            ctx.roundRect(0, 0, e, e, spec.background.radius);
+        else {
+            ctx.moveTo(0, 0);
+            ctx.lineTo(e, 0);
+            ctx.lineTo(e, e);
+            ctx.lineTo(0, e);
+            ctx.closePath();
+        }
+        ctx.fill();
+    }
+    for (const layer of spec.layers ?? []) {
+        if (layer.kind === "rect") {
+            const [x0, z0, x1, z1] = layer.rect;
+            ctx.fillStyle = layer.fill;
+            ctx.fillRect(nx(x0), nz(z0), nx(x1) - nx(x0), nz(z1) - nz(z0));
+        }
+        else if (layer.kind === "lines") {
+            ctx.strokeStyle = layer.stroke;
+            ctx.lineWidth = layer.width;
+            for (const [x0, z0, x1, z1] of layer.segments) {
+                ctx.beginPath();
+                ctx.moveTo(nx(x0), nz(z0));
+                ctx.lineTo(nx(x1), nz(z1));
+                ctx.stroke();
+            }
+        }
+        else {
+            ctx.fillStyle = layer.fill;
+            const h = layer.size / 2;
+            for (const [x, z] of layer.points)
+                ctx.fillRect(nx(x) - h, nz(z) - h, layer.size, layer.size);
+        }
+    }
+    const m = spec.marker;
+    if (m) {
+        ctx.save();
+        ctx.translate(nx(m.x), nz(m.z));
+        ctx.rotate(-m.heading);
+        ctx.fillStyle = m.fill;
+        ctx.beginPath();
+        const shape = m.shape ?? CHEVRON;
+        ctx.moveTo(shape[0][0], shape[0][1]);
+        for (let i = 1; i < shape.length; i++)
+            ctx.lineTo(shape[i][0], shape[i][1]);
+        ctx.closePath();
+        ctx.fill();
+        ctx.restore();
+    }
+}
+//# sourceMappingURL=canvasMinimap.js.map

package/dist/game/hud/canvasMinimap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canvasMinimap.js","sourceRoot":"","sources":["../../../../../packages/game/src/hud/canvasMinimap.ts"],"names":[],"mappings":"AAgDA,MAAM,OAAO,GAA2C,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;AAEjG,8GAA8G;AAC9G,MAAM,UAAU,iBAAiB,CAAC,GAAyB,EAAE,IAAuB;IAClF,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC;IACpB,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;IACzC,MAAM,EAAE,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;IAChE,MAAM,EAAE,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;IAChE,GAAG,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1B,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;QACpB,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QACrC,GAAG,CAAC,SAAS,EAAE,CAAC;QAChB,IAAI,GAAG,CAAC,SAAS,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM;YAAE,GAAG,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;aAC1F,CAAC;YACJ,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YACjB,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YACjB,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YACjB,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YACjB,GAAG,CAAC,SAAS,EAAE,CAAC;QAClB,CAAC;QACD,GAAG,CAAC,IAAI,EAAE,CAAC;IACb,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;QACtC,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC1B,MAAM,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC;YACpC,GAAG,CAAC,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC;YAC3B,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QACjE,CAAC;aAAM,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAClC,GAAG,CAAC,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC;YAC/B,GAAG,CAAC,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC;YAC5B,KAAK,MAAM,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;gBAC9C,GAAG,CAAC,SAAS,EAAE,CAAC;gBAChB,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;gBAC3B,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;gBAC3B,GAAG,CAAC,MAAM,EAAE,CAAC;YACf,CAAC;QACH,CAAC;aAAM,CAAC;YACN,GAAG,CAAC,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC;YAC3B,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC;YACzB,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM;gBAAE,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAChG,CAAC;IACH,CAAC;IACD,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,CAAC;QACN,GAAG,CAAC,IAAI,EAAE,CAAC;QACX,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAChC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QACvB,GAAG,CAAC,SAAS,GAAG,CAAC,CAAC,IAAI,CAAC;QACvB,GAAG,CAAC,SAAS,EAAE,CAAC;QAChB,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,IAAI,OAAO,CAAC;QACjC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QACvC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE;YAAE,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9E,GAAG,CAAC,SAAS,EAAE,CAAC;QAChB,GAAG,CAAC,IAAI,EAAE,CAAC;QACX,GAAG,CAAC,OAAO,EAAE,CAAC;IAChB,CAAC;AACH,CAAC"}

package/dist/game/hud/compass.d.ts

@@ -0,0 +1,16 @@
+export interface CompassPoint {
+    readonly x: number;
+    readonly z: number;
+}
+/** Signed bearing (radians) from `from` to `to` relative to the heading `yaw`; 0 means dead ahead (-z at yaw 0). */
+export declare function compassBearing(from: CompassPoint, to: CompassPoint, yaw: number): number;
+/** CSS rotation (degrees) for a needle drawn pointing up so it points at the target. */
+export declare function compassRotationDeg(bearing: number): number;
+export interface CompassNeedle {
+    readonly style: Record<string, string> | {
+        transform: string;
+    };
+}
+/** Rotate `needle` toward `to` and return the bearing it used. */
+export declare function updateCompass(needle: CompassNeedle, from: CompassPoint, to: CompassPoint, yaw: number): number;
+//# sourceMappingURL=compass.d.ts.map

package/dist/game/hud/compass.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compass.d.ts","sourceRoot":"","sources":["../../../../../packages/game/src/hud/compass.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,oHAAoH;AACpH,wBAAgB,cAAc,CAAC,IAAI,EAAE,YAAY,EAAE,EAAE,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAExF;AAED,wFAAwF;AACxF,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;CAChE;AAED,kEAAkE;AAClE,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAI9G"}

package/dist/game/hud/compass.js

@@ -0,0 +1,15 @@
+/** Signed bearing (radians) from `from` to `to` relative to the heading `yaw`; 0 means dead ahead (-z at yaw 0). */
+export function compassBearing(from, to, yaw) {
+    return Math.atan2(-(to.x - from.x), -(to.z - from.z)) - yaw;
+}
+/** CSS rotation (degrees) for a needle drawn pointing up so it points at the target. */
+export function compassRotationDeg(bearing) {
+    return (-bearing * 180) / Math.PI;
+}
+/** Rotate `needle` toward `to` and return the bearing it used. */
+export function updateCompass(needle, from, to, yaw) {
+    const bearing = compassBearing(from, to, yaw);
+    needle.style.transform = `rotate(${compassRotationDeg(bearing)}deg)`;
+    return bearing;
+}
+//# sourceMappingURL=compass.js.map

package/dist/game/hud/compass.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compass.js","sourceRoot":"","sources":["../../../../../packages/game/src/hud/compass.ts"],"names":[],"mappings":"AAKA,oHAAoH;AACpH,MAAM,UAAU,cAAc,CAAC,IAAkB,EAAE,EAAgB,EAAE,GAAW;IAC9E,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;AAC9D,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,kBAAkB,CAAC,OAAe;IAChD,OAAO,CAAC,CAAC,OAAO,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC;AACpC,CAAC;AAMD,kEAAkE;AAClE,MAAM,UAAU,aAAa,CAAC,MAAqB,EAAE,IAAkB,EAAE,EAAgB,EAAE,GAAW;IACpG,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC;IAC7C,MAAM,CAAC,KAA+B,CAAC,SAAS,GAAG,UAAU,kBAAkB,CAAC,OAAO,CAAC,MAAM,CAAC;IAChG,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/game/index.d.ts

@@ -16,7 +16,12 @@ export { createGameImpl, type Prd09Game } from "./createGame.js";
 export { GameSessionImpl } from "./session/GameSession.js";
 export { attachSessionLifecycle } from "./session/lifecycle.js";
 export { createAccessibility } from "./session/accessibility.js";
+export { warmPrograms, type WarmableApp, type WarmProgramsOptions, type WarmProgramsResult } from "./session/warmPrograms.js";
 export { installGameBeacon } from "./evidence/beacon.js";
+export { summarizeTextureUpgrade, texturedNodesReady } from "./evidence/textureStatus.js";
+export type { TexturedMaterialRow, TextureUpgradeSummary } from "./evidence/textureStatus.js";
+export { smoothDamp, createSmoothFollow3, lerpAngle, createRenderInterpolator, secondDifferenceRms, jitterReport, createLocomotion, proceduralLegSwing, createFootSlideMeter, createImpactWorld, createHitStop, createCameraShake, createImpactFeedback, attachToBone, resolveBone, boneAliases, boneWorldPosition, attachmentDistance, checkDoubleFrame, detectSharedSkeleton, detectCoincidentModels, detectDoubleBlend, createFixedStepPresenter, createRecordBlend, runMotionGate, clearCameraEye, createCameraClearance } from "./motion/index.js";
+export type { DampResult, SmoothFollow3, RenderInterpolator, JitterReport, LocomotionGait, LocomotionOptions, LocomotionFrame, Locomotion, LegPose, ProceduralGait, FootSlideOptions, FootSlideReport, FootSlideMeter, ImpactBoxCollider, ImpactSphereCollider, ImpactCollider, ImpactBody, Impact, ImpactWorldOptions, ImpactWorld, HitStop, CameraShake, ParticleBurst, ImpactFeedbackOptions, ImpactFeedbackResult, BoneRole, SocketLike, AttachableActor, AttachToBoneOptions, BoneAttachment, DrawEntry, ModelInstance, AnimLayer, DoubleFrameFinding, DoubleFrameReport, AlphaSource, FixedStepPresenterOptions, FixedStepPresenter, RecordBlendOptions, MotionGateOptions, MotionGateReport, CameraVec3, ClearEyeOptions, ClearEye, CameraClearanceOptions, CameraClearance } from "./motion/index.js";
 export { installEvidenceChannel, createPerfRing, type EvidenceChannelContract } from "./evidence/channel.js";
 export type { Prd09CreateGameOptions } from "./createGame.js";
 export type { Game, CreateGameOptions, GameSession, GameSessionState, GameShell, Hud, TouchControls, GameFxLayer, CaptureContext, GameBeacon } from "../engine/index.js";
@@ -39,6 +44,10 @@ export type { SfxId, SfxPack } from "./sfx.js";
 export { mountHud } from "./hud/HudKit.js";
 export { HUD_THEMES, HUD_FONT_FACES } from "./hud/themes.js";
 export { screenFraction } from "./hud/screenFraction.js";
+export { compassBearing, compassRotationDeg, updateCompass } from "./hud/compass.js";
+export type { CompassPoint, CompassNeedle } from "./hud/compass.js";
+export { drawCanvasMinimap } from "./hud/canvasMinimap.js";
+export type { CanvasMinimapBounds, CanvasMinimapContext, CanvasMinimapLayer, CanvasMinimapMarker, CanvasMinimapSpec } from "./hud/canvasMinimap.js";
 export type { Hud as GameHud, HudMountOptions as GameHudMountOptions, HudSnapshot, HudWidgetSnapshot, HudBannerOptions, HudKitDeps, Vec3Like as HudVec3Like } from "./hud/HudKit.js";
 export type { HudThemePreset, HudThemeVars } from "./hud/themes.js";
 export type { HudAnchor, HudWidgetBase, HudWidgetSpec as GameHudWidgetSpec, HudWidgetInstance, HudValue } from "./hud/widgets/index.js";

package/dist/game/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../packages/game/src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../packages/game/src/index.ts"],"names":[],"mappings":"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"}

package/dist/game/index.js

@@ -44,7 +44,10 @@ export { createGameImpl } from "./createGame.js";
 export { GameSessionImpl } from "./session/GameSession.js";
 export { attachSessionLifecycle } from "./session/lifecycle.js";
 export { createAccessibility } from "./session/accessibility.js";
+export { warmPrograms } from "./session/warmPrograms.js";
 export { installGameBeacon } from "./evidence/beacon.js";
+export { summarizeTextureUpgrade, texturedNodesReady } from "./evidence/textureStatus.js";
+export { smoothDamp, createSmoothFollow3, lerpAngle, createRenderInterpolator, secondDifferenceRms, jitterReport, createLocomotion, proceduralLegSwing, createFootSlideMeter, createImpactWorld, createHitStop, createCameraShake, createImpactFeedback, attachToBone, resolveBone, boneAliases, boneWorldPosition, attachmentDistance, checkDoubleFrame, detectSharedSkeleton, detectCoincidentModels, detectDoubleBlend, createFixedStepPresenter, createRecordBlend, runMotionGate, clearCameraEye, createCameraClearance } from "./motion/index.js";
 export { installEvidenceChannel, createPerfRing } from "./evidence/channel.js";
 // PRD-09 juice surface (§7.6): tween engine, Juice facade, overlay driver,
 // fx pools (instanced backend A / particle-pass backend B), rumble adapter.
@@ -60,6 +63,8 @@ export { sfx, SFX_IDS, sfxUrl } from "./sfx.js";
 export { mountHud } from "./hud/HudKit.js";
 export { HUD_THEMES, HUD_FONT_FACES } from "./hud/themes.js";
 export { screenFraction } from "./hud/screenFraction.js";
+export { compassBearing, compassRotationDeg, updateCompass } from "./hud/compass.js";
+export { drawCanvasMinimap } from "./hud/canvasMinimap.js";
 export { createWidget } from "./hud/widgets/index.js";
 // PRD-09 Phase 4 — shell, transitions, context loss, touch (§6.2, §6.11, §7.2).
 export { createGameShell } from "./shell/GameShell.js";

package/dist/game/index.js.map

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

package/dist/game/motion/boneAttach.d.ts

@@ -0,0 +1,42 @@
+export type BoneRole = "rightHand" | "leftHand" | "head" | "hips" | "spine" | "rightFoot" | "leftFoot" | "rightForearm" | "leftForearm" | "rightLowerArm" | "leftLowerArm" | "rightUpperArm" | "leftUpperArm" | "rightShoulder" | "leftShoulder" | "rightShin" | "leftShin" | "rightThigh" | "leftThigh";
+/** Candidate bone names to probe for a role, ordered from most to least common rig naming. */
+export declare function boneAliases(role: BoneRole): readonly string[];
+/** Resolve a role or exact bone name against a skeleton's bone names; case-, punctuation- and rig-prefix-insensitive. */
+export declare function resolveBone(boneNames: readonly string[], roleOrName: BoneRole | string): string | undefined;
+export interface SocketLike {
+    readonly valid: boolean;
+    worldMatrix(out?: Float32Array): Float32Array;
+}
+export interface AttachableActor {
+    socket(bone: string): SocketLike;
+    attach(spec: {
+        readonly socket: string;
+        readonly target: string | object;
+        readonly position?: readonly [number, number, number];
+        readonly rotation?: readonly [number, number, number];
+        readonly scale?: number;
+    }): () => void;
+}
+export interface AttachToBoneOptions {
+    /** A role (for example "rightHand") or an exact bone name. */
+    readonly bone: BoneRole | string;
+    readonly target: string | object;
+    /** Skeleton bone names if known; otherwise aliases are probed with `socket(name).valid`. */
+    readonly boneNames?: readonly string[];
+    /** Offset in bone space. */
+    readonly position?: readonly [number, number, number];
+    /** XYZ Euler radians in bone space. */
+    readonly rotation?: readonly [number, number, number];
+    readonly scale?: number;
+}
+export interface BoneAttachment {
+    readonly bone: string;
+    detach(): void;
+}
+/** Pin a node to a bone (bat to hand, club to hand, ball to hand) with bone-name resolution and a loud failure. */
+export declare function attachToBone(actor: AttachableActor, options: AttachToBoneOptions): BoneAttachment;
+/** World position of a bone (translation of its world matrix). */
+export declare function boneWorldPosition(actor: Pick<AttachableActor, "socket">, bone: string): [number, number, number];
+/** Distance in metres between an attached node and its bone (accounts for no offset: pass the expected offset-free node position). */
+export declare function attachmentDistance(nodePosition: readonly [number, number, number], bonePosition: readonly [number, number, number]): number;
+//# sourceMappingURL=boneAttach.d.ts.map

package/dist/game/motion/boneAttach.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"boneAttach.d.ts","sourceRoot":"","sources":["../../../../../packages/game/src/motion/boneAttach.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAChB,WAAW,GAAG,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,WAAW,GAAG,UAAU,GAC/E,cAAc,GAAG,aAAa,GAAG,eAAe,GAAG,cAAc,GACjE,eAAe,GAAG,cAAc,GAAG,eAAe,GAAG,cAAc,GACnE,WAAW,GAAG,UAAU,GAAG,YAAY,GAAG,WAAW,CAAC;AAkF1D,8FAA8F;AAC9F,wBAAgB,WAAW,CAAC,IAAI,EAAE,QAAQ,GAAG,SAAS,MAAM,EAAE,CAiC7D;AAED,yHAAyH;AACzH,wBAAgB,WAAW,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,EAAE,UAAU,EAAE,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAM3G;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,WAAW,CAAC,GAAG,CAAC,EAAE,YAAY,GAAG,YAAY,CAAC;CAC/C;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAAC;IACjC,MAAM,CAAC,IAAI,EAAE;QACX,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;QACjC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QACtD,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QACtD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;KACzB,GAAG,MAAM,IAAI,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,8DAA8D;IAC9D,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACjC,4FAA4F;IAC5F,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,4BAA4B;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACtD,uCAAuC;IACvC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACtD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,MAAM,IAAI,IAAI,CAAC;CAChB;AAED,mHAAmH;AACnH,wBAAgB,YAAY,CAAC,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,mBAAmB,GAAG,cAAc,CA4BjG;AAED,kEAAkE;AAClE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,IAAI,CAAC,eAAe,EAAE,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAGhH;AAED,sIAAsI;AACtI,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,YAAY,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAE3I"}

package/dist/game/motion/boneAttach.js

@@ -0,0 +1,166 @@
+const ROLE_PARTS = {
+    rightHand: { side: "right", part: "hand" }, leftHand: { side: "left", part: "hand" },
+    rightForearm: { side: "right", part: "forearm" }, leftForearm: { side: "left", part: "forearm" },
+    rightLowerArm: { side: "right", part: "forearm" }, leftLowerArm: { side: "left", part: "forearm" },
+    rightUpperArm: { side: "right", part: "upperArm" }, leftUpperArm: { side: "left", part: "upperArm" },
+    rightShoulder: { side: "right", part: "shoulder" }, leftShoulder: { side: "left", part: "shoulder" },
+    rightThigh: { side: "right", part: "thigh" }, leftThigh: { side: "left", part: "thigh" },
+    rightShin: { side: "right", part: "shin" }, leftShin: { side: "left", part: "shin" },
+    rightFoot: { side: "right", part: "foot" }, leftFoot: { side: "left", part: "foot" },
+    hips: { side: "none", part: "hips" }, spine: { side: "none", part: "spine" }, head: { side: "none", part: "head" }
+};
+/** Normalised synonyms per part (lowercase, no punctuation). Mixamo, Meshy, Rigify, Unreal, glTF Avatar (VRM, Ready Player Me), 3ds Max Biped. */
+const PART_WORDS = {
+    hand: ["hand"],
+    forearm: ["forearm", "lowerarm", "lowarm"],
+    upperArm: ["upperarm", "uparm", "arm"],
+    shoulder: ["shoulder", "clavicle"],
+    thigh: ["upleg", "upperleg", "thigh"],
+    shin: ["leg", "lowerleg", "lowleg", "shin", "calf"],
+    foot: ["foot"],
+    hips: ["hips", "pelvis", "hip"],
+    spine: ["spine", "spine1", "chest"],
+    head: ["head"]
+};
+const RIG_PREFIXES = ["mixamorig", "bip001", "bip01", "def", "org", "tweak", "ctrl"];
+/** Written forms tried when probing without a bone list, most common rigs first. */
+const PART_WRITTEN = {
+    hand: ["Hand", "hand"],
+    forearm: ["ForeArm", "Forearm", "forearm", "LowerArm", "lowerarm"],
+    upperArm: ["Arm", "UpperArm", "upperarm", "arm"],
+    shoulder: ["Shoulder", "shoulder", "clavicle"],
+    thigh: ["UpLeg", "UpperLeg", "Thigh", "upperleg", "thigh"],
+    shin: ["Leg", "LowerLeg", "calf", "shin", "leg"],
+    foot: ["Foot", "foot"],
+    hips: ["Hips", "hips", "Pelvis", "pelvis"],
+    spine: ["Spine", "spine", "Spine1", "Chest"],
+    head: ["Head", "head"]
+};
+const normalize = (name) => {
+    const colon = name.lastIndexOf(":");
+    let base = (colon >= 0 ? name.slice(colon + 1) : name).toLowerCase().replace(/[^a-z0-9]/g, "");
+    for (const prefix of RIG_PREFIXES) {
+        if (base.startsWith(prefix) && base.length > prefix.length) {
+            base = base.slice(prefix.length);
+            break;
+        }
+    }
+    return base;
+};
+const sideForms = (side) => side === "none"
+    ? { prefix: [""], suffix: [] }
+    : side === "right"
+        ? { prefix: ["Right", "right_", "R_", "right", "R"], suffix: [".R", "_R", "_r", ".r", "Right", "_right"] }
+        : { prefix: ["Left", "left_", "L_", "left", "L"], suffix: [".L", "_L", "_l", ".l", "Left", "_left"] };
+/** Normalised strings that name a role: side+part and part+side forms of every synonym. */
+function roleNormals(role) {
+    const { side, part } = ROLE_PARTS[role];
+    const out = new Set();
+    const sideWords = side === "none" ? [""] : side === "right" ? ["right", "r"] : ["left", "l"];
+    for (const word of PART_WORDS[part]) {
+        if (side === "none")
+            out.add(word);
+        for (const sw of sideWords) {
+            if (side === "none")
+                continue;
+            out.add(sw + word);
+            out.add(word + sw);
+        }
+    }
+    return out;
+}
+/** Candidate bone names to probe for a role, ordered from most to least common rig naming. */
+export function boneAliases(role) {
+    const { side, part } = ROLE_PARTS[role];
+    const forms = sideForms(side);
+    const out = [];
+    const add = (n) => {
+        if (!out.includes(n))
+            out.push(n);
+    };
+    for (const w of PART_WRITTEN[part]) {
+        for (const pre of forms.prefix)
+            add(`mixamorig:${pre}${w}`);
+        for (const pre of forms.prefix)
+            add(`${pre}${w}`);
+    }
+    for (const w of PART_WRITTEN[part]) {
+        for (const suf of forms.suffix) {
+            add(`${w}${suf}`);
+            add(`${w.toLowerCase()}${suf}`);
+        }
+    }
+    if (side !== "none") {
+        const letter = side === "right" ? "R" : "L";
+        for (const w of PART_WRITTEN[part])
+            add(`Bip01 ${letter} ${w}`);
+        for (const w of PART_WRITTEN[part])
+            for (const suf of forms.suffix)
+                add(`DEF-${w.toLowerCase()}${suf}`);
+    }
+    else {
+        for (const w of PART_WRITTEN[part]) {
+            add(`mixamorig:${w}`);
+            add(`Bip01 ${w}`);
+        }
+    }
+    // Exotic casing last, so common rigs hit within the first probes.
+    for (const n of [...out]) {
+        add(n.toLowerCase());
+        add(n.toUpperCase());
+    }
+    return out;
+}
+/** Resolve a role or exact bone name against a skeleton's bone names; case-, punctuation- and rig-prefix-insensitive. */
+export function resolveBone(boneNames, roleOrName) {
+    const exact = boneNames.find((b) => b === roleOrName);
+    if (exact !== undefined)
+        return exact;
+    const wanted = new Set([normalize(roleOrName)]);
+    if (roleOrName in ROLE_PARTS)
+        for (const n of roleNormals(roleOrName))
+            wanted.add(n);
+    return boneNames.find((b) => wanted.has(normalize(b)));
+}
+/** Pin a node to a bone (bat to hand, club to hand, ball to hand) with bone-name resolution and a loud failure. */
+export function attachToBone(actor, options) {
+    let bone;
+    let tried = [];
+    if (options.boneNames !== undefined) {
+        bone = resolveBone(options.boneNames, options.bone);
+        tried = [String(options.bone), ...(options.bone in ROLE_PARTS ? [...roleNormals(options.bone)] : [])];
+    }
+    else {
+        const candidates = [options.bone, ...(options.bone in ROLE_PARTS ? boneAliases(options.bone) : [])];
+        tried = candidates;
+        bone = candidates.find((c) => actor.socket(c).valid);
+    }
+    if (bone === undefined) {
+        const key = normalize(String(options.bone)).slice(0, 4);
+        const near = options.boneNames?.filter((b) => normalize(b).includes(key)).slice(0, 8) ?? [];
+        const shown = tried.slice(0, 24).join(", ") + (tried.length > 24 ? `, +${tried.length - 24} more` : "");
+        throw new Error(`ATTACH_BONE_NOT_FOUND: no bone matches "${String(options.bone)}". Tried: ${shown}.${near.length ? ` Similar bones: ${near.join(", ")}.` : ""} Pass boneNames from the skeleton or an exact bone name.`);
+    }
+    const spec = {
+        socket: bone,
+        target: options.target
+    };
+    if (options.position !== undefined)
+        spec.position = options.position;
+    if (options.rotation !== undefined)
+        spec.rotation = options.rotation;
+    if (options.scale !== undefined)
+        spec.scale = options.scale;
+    const detach = actor.attach(spec);
+    return { bone, detach };
+}
+/** World position of a bone (translation of its world matrix). */
+export function boneWorldPosition(actor, bone) {
+    const m = actor.socket(bone).worldMatrix();
+    return [m[12], m[13], m[14]];
+}
+/** Distance in metres between an attached node and its bone (accounts for no offset: pass the expected offset-free node position). */
+export function attachmentDistance(nodePosition, bonePosition) {
+    return Math.hypot(nodePosition[0] - bonePosition[0], nodePosition[1] - bonePosition[1], nodePosition[2] - bonePosition[2]);
+}
+//# sourceMappingURL=boneAttach.js.map

package/dist/game/motion/boneAttach.js.map

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

package/dist/game/motion/cameraClear.d.ts

@@ -0,0 +1,35 @@
+export type CameraVec3 = readonly [number, number, number];
+export interface ClearEyeOptions {
+    /** What the camera looks at (the rider, ball or car), already above the ground. */
+    readonly focus: CameraVec3;
+    /** Where the chase rig wants the eye. */
+    readonly eye: CameraVec3;
+    /** True when a point is inside solid space (a collider with margin, or below the floor). */
+    readonly blocked: (x: number, y: number, z: number) => boolean;
+    /** Never pull closer than this to the focus unless the focus itself is blocked. Default 2. */
+    readonly minDistance?: number;
+    /** Samples along the focus-to-eye segment. Default 24. */
+    readonly samples?: number;
+}
+export interface ClearEye {
+    readonly eye: [number, number, number];
+    /** 1 when the wanted eye is clear, lower when the eye was pulled toward the focus. */
+    readonly t: number;
+}
+/** Pulls the camera eye along the focus-to-eye segment to just before the first solid sample, so a chase camera never sits inside scenery. */
+export declare function clearCameraEye(options: ClearEyeOptions): ClearEye;
+export interface CameraClearanceOptions {
+    /** Exponential rate (1/s) at which the eye moves in when something blocks it. Default 18. */
+    readonly pullRate?: number;
+    /** Exponential rate (1/s) at which it moves back out once clear. Default 2. */
+    readonly releaseRate?: number;
+}
+export interface CameraClearance {
+    /** Smoothed clearance factor in (0, 1]: 1 means the full chase distance. */
+    readonly factor: number;
+    update(dt: number, options: ClearEyeOptions): [number, number, number];
+    reset(): void;
+}
+/** Stateful wrapper: snaps in fast when blocked and eases back out, so the camera does not pop at a doorway. */
+export declare function createCameraClearance(options?: CameraClearanceOptions): CameraClearance;
+//# sourceMappingURL=cameraClear.d.ts.map

package/dist/game/motion/cameraClear.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cameraClear.d.ts","sourceRoot":"","sources":["../../../../../packages/game/src/motion/cameraClear.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAE3D,MAAM,WAAW,eAAe;IAC9B,mFAAmF;IACnF,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,yCAAyC;IACzC,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC;IACzB,4FAA4F;IAC5F,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;IAC/D,8FAA8F;IAC9F,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,0DAA0D;IAC1D,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,sFAAsF;IACtF,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,8IAA8I;AAC9I,wBAAgB,cAAc,CAAC,OAAO,EAAE,eAAe,GAAG,QAAQ,CAyBjE;AAED,MAAM,WAAW,sBAAsB;IACrC,6FAA6F;IAC7F,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,+EAA+E;IAC/E,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,eAAe;IAC9B,4EAA4E;IAC5E,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACvE,KAAK,IAAI,IAAI,CAAC;CACf;AAED,gHAAgH;AAChH,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,sBAA2B,GAAG,eAAe,CAyB3F"}

package/dist/game/motion/cameraClear.js

@@ -0,0 +1,64 @@
+/** Pulls the camera eye along the focus-to-eye segment to just before the first solid sample, so a chase camera never sits inside scenery. */
+export function clearCameraEye(options) {
+    const { focus, eye, blocked } = options;
+    const samples = Math.max(2, Math.trunc(options.samples ?? 24));
+    const dx = eye[0] - focus[0], dy = eye[1] - focus[1], dz = eye[2] - focus[2];
+    const length = Math.hypot(dx, dy, dz);
+    const point = (t) => [focus[0] + dx * t, focus[1] + dy * t, focus[2] + dz * t];
+    if (length < 1e-6)
+        return { eye: point(1), t: 1 };
+    const tMin = Math.min(1, (options.minDistance ?? 2) / length);
+    let clear = 0;
+    let hit = -1;
+    for (let i = 1; i <= samples; i += 1) {
+        const t = i / samples;
+        const p = point(t);
+        if (blocked(p[0], p[1], p[2])) {
+            hit = t;
+            break;
+        }
+        clear = t;
+    }
+    if (hit < 0)
+        return { eye: point(1), t: 1 };
+    let lo = clear, hi = hit;
+    for (let i = 0; i < 6; i += 1) {
+        const mid = (lo + hi) / 2;
+        const p = point(mid);
+        if (blocked(p[0], p[1], p[2]))
+            hi = mid;
+        else
+            lo = mid;
+    }
+    const t = Math.max(Math.min(lo, 1), Math.min(tMin, 1));
+    return { eye: point(t), t };
+}
+/** Stateful wrapper: snaps in fast when blocked and eases back out, so the camera does not pop at a doorway. */
+export function createCameraClearance(options = {}) {
+    const pullRate = options.pullRate ?? 18;
+    const releaseRate = options.releaseRate ?? 2;
+    let factor = 1;
+    return {
+        get factor() { return factor; },
+        update(dt, eyeOptions) {
+            const { t } = clearCameraEye(eyeOptions);
+            const rate = t < factor ? pullRate : releaseRate;
+            const k = dt > 0 ? 1 - Math.exp(-dt * rate) : 1;
+            factor += (t - factor) * k;
+            if (t >= 1 && factor > 0.9995)
+                factor = 1;
+            const f = eyeOptions.focus, e = eyeOptions.eye;
+            const wanted = Math.min(factor, 1);
+            const out = [f[0] + (e[0] - f[0]) * wanted, f[1] + (e[1] - f[1]) * wanted, f[2] + (e[2] - f[2]) * wanted];
+            // The smoothed eye can lag behind a hard wall on the pull-in frame: never return a blocked point when a clear one exists.
+            if (eyeOptions.blocked(out[0], out[1], out[2])) {
+                const clear = clearCameraEye(eyeOptions);
+                factor = Math.min(factor, clear.t);
+                return clear.eye;
+            }
+            return out;
+        },
+        reset() { factor = 1; }
+    };
+}
+//# sourceMappingURL=cameraClear.js.map

package/dist/game/motion/cameraClear.js.map

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