@aura3d/engine 2.0.4 → 3.0.1

package/dist/engine/agent-api/NavigationCrowds.d.ts

@@ -0,0 +1,174 @@
+/**
+ * Structural mirrors of the `@aura3d/navigation-recast` value-object shapes,
+ * kept LOCAL (never imported) so the packed engine carries no hard link —
+ * type-level or runtime — to the optional peer. The peer stays resolvable
+ * through the bare specifier in `loadNavigationPeer` below (dynamic import,
+ * fail-closed when absent) and through workspace aliases in source builds.
+ * If the peer shapes change, update these mirrors to match; assignability
+ * with the real peer holds structurally (loader returns are covariant).
+ */
+type NavigationVec3 = readonly [number, number, number];
+interface NavigationTriangleSoup {
+    readonly positions: readonly number[] | Float32Array;
+    readonly indices: readonly number[] | Uint32Array;
+}
+interface NavigationPathResult {
+    readonly success: boolean;
+    readonly points: readonly NavigationVec3[];
+    readonly error?: string;
+}
+interface NavigationCrowdAgentOptions {
+    readonly radius?: number;
+    readonly height?: number;
+    readonly maxAcceleration?: number;
+    readonly maxSpeed?: number;
+    readonly collisionQueryRange?: number;
+    readonly pathOptimizationRange?: number;
+    readonly separationWeight?: number;
+}
+interface RecastCrowdAgentState {
+    readonly position: NavigationVec3;
+    readonly velocity: NavigationVec3;
+    readonly speed: number;
+}
+interface RecastNavigationOptions {
+    readonly moduleLoader?: () => Promise<unknown>;
+    readonly generatorLoader?: () => Promise<unknown>;
+}
+/**
+ * Root navigation + crowds builders (muse3jsparity-PRD O1).
+ *
+ * Recast stays an OPTIONAL peer: this module never statically imports
+ * `@aura3d/navigation-recast` (the optional-boundary test forbids it from
+ * engine manifests, and a static value import would hard-require the peer for
+ * every route). The peer loads through an injected loader — tests inject
+ * fakes, routes rely on the default dynamic import — and every failure keeps
+ * the package's fail-closed "optional peer unavailable + install step" error.
+ * Nothing here falls back to a silent no-op navigator.
+ */
+/**
+ * Minimal structural peer surface: the real `createRecastNavigation` return
+ * satisfies this (extra methods allowed); fakes implement only what the root
+ * builders call. This keeps unit tests hermetic without importing the
+ * optional package.
+ */
+export interface AuraNavigationPeer {
+    createRecastNavigation(options?: RecastNavigationOptions): Promise<{
+        generateSolo(input: NavigationTriangleSoup, config: Record<string, number | string | boolean>): {
+            computePath(from: NavigationVec3, to: NavigationVec3): NavigationPathResult;
+            dispose(): void;
+            createCrowd(maxAgents: number, maxAgentRadius: number): {
+                readonly maxAgents: number;
+                count(): number;
+                addAgent(position: NavigationVec3, options?: NavigationCrowdAgentOptions): unknown;
+                setTarget(agent: unknown, target: NavigationVec3): boolean;
+                update(dt: number): void;
+                agentStates(): readonly RecastCrowdAgentState[];
+                dispose(): void;
+            };
+        };
+    }>;
+}
+export interface AuraNavigationPeerLoaders extends RecastNavigationOptions {
+    /**
+     * Fully hermetic peer injection for tests: when supplied, no dynamic
+     * import runs at all, so the suite never needs the optional package.
+     */
+    readonly peer?: AuraNavigationPeer;
+}
+export interface AuraNavMeshBakeOptions {
+    readonly positions: readonly number[] | Float32Array;
+    readonly indices: readonly number[] | Uint32Array;
+    readonly settings?: Record<string, number | string | boolean>;
+}
+export interface AuraCrowdCreateOptions {
+    readonly maxAgents: number;
+    readonly maxAgentRadius: number;
+}
+export type AuraNavMeshHandle = Awaited<ReturnType<AuraNavigationPeer["createRecastNavigation"]>> extends {
+    generateSolo(input: NavigationTriangleSoup, config: Record<string, number | string | boolean>): infer M;
+} ? M : never;
+export type AuraCrowdHandle = AuraNavMeshHandle extends {
+    createCrowd(maxAgents: number, maxAgentRadius: number): infer C;
+} ? C : never;
+declare function bakeNavMesh(options: AuraNavMeshBakeOptions, loaders?: AuraNavigationPeerLoaders): Promise<AuraNavMeshHandle>;
+declare function queryPath(mesh: AuraNavMeshHandle, from: NavigationVec3, to: NavigationVec3): NavigationPathResult;
+declare function navigationIsAvailable(loaders?: AuraNavigationPeerLoaders): Promise<boolean>;
+export declare const navigation: {
+    readonly bake: typeof bakeNavMesh;
+    readonly path: typeof queryPath;
+    readonly dispose: (mesh: AuraNavMeshHandle) => void;
+    readonly isAvailable: typeof navigationIsAvailable;
+};
+declare function createCrowd(mesh: AuraNavMeshHandle, options: AuraCrowdCreateOptions): AuraCrowdHandle;
+declare function crowdAgents(crowd: AuraCrowdHandle): readonly RecastCrowdAgentState[];
+export declare const crowds: {
+    readonly create: typeof createCrowd;
+    readonly dispose: (crowd: AuraCrowdHandle) => void;
+    readonly addAgent: (crowd: AuraCrowdHandle, position: NavigationVec3, options?: NavigationCrowdAgentOptions) => unknown;
+    readonly setTarget: (crowd: AuraCrowdHandle, agent: unknown, target: NavigationVec3) => boolean;
+    readonly update: (crowd: AuraCrowdHandle, dt: number) => void;
+    readonly agents: typeof crowdAgents;
+    readonly count: (crowd: AuraCrowdHandle) => number;
+    readonly maxAgents: (crowd: AuraCrowdHandle) => number;
+    readonly bindRepresentations: typeof bindCrowdRepresentations;
+    readonly diagnostics: typeof describeCrowd;
+};
+/** LOD tier per agent: full actors near, billboard/marker impostors past `farDistance`. */
+export type AuraCrowdLodTier = "near" | "mid" | "impostor" | "unknown";
+export interface AuraCrowdLodOptions {
+    /** Camera position in the same space as agent positions. Without it every tier is "unknown". */
+    readonly camera?: NavigationVec3;
+    /** At or below this distance an agent renders full (default 6). */
+    readonly nearDistance?: number;
+    /** Past this distance an agent falls back to an impostor/marker (default 14). */
+    readonly farDistance?: number;
+}
+export interface AuraCrowdAgentLod {
+    readonly position: NavigationVec3;
+    readonly distance: number | null;
+    readonly tier: AuraCrowdLodTier;
+}
+export interface AuraCrowdDiagnostics {
+    readonly count: number;
+    readonly maxAgents: number;
+    /** True once `addAgent` would throw instead of spawning (fail-closed cap). */
+    readonly atCap: boolean;
+    /** Present exactly when `atCap` — the over-budget warning for route evidence. */
+    readonly capWarning?: string;
+    readonly tiers: Record<AuraCrowdLodTier, number>;
+    readonly agents: readonly AuraCrowdAgentLod[];
+}
+/**
+ * O1 crowd LOD + cap diagnostics over LIVE crowd state (never the fixture sampler).
+ *
+ * Distances are Euclidean from `camera` to each live agent position; tiers split at
+ * `nearDistance`/`farDistance`. Throws on inverted bounds so a misconfigured LOD
+ * can never silently report every agent as near.
+ */
+export declare function describeCrowd(crowd: AuraCrowdHandle, options?: AuraCrowdLodOptions): AuraCrowdDiagnostics;
+/** A mounted render representation, retained across distance transitions. */
+export interface AuraCrowdRepresentation {
+    update(state: {
+        readonly position: NavigationVec3;
+        readonly heading: number;
+        readonly selected: boolean;
+    }): void;
+    setVisible(visible: boolean): void;
+    dispose(): void;
+}
+export interface AuraCrowdRepresentationOptions {
+    readonly nearDistance?: number;
+    readonly farDistance?: number;
+    /** Absolute world-space dead band around each distance boundary. */
+    readonly hysteresis?: number;
+    /** Create real mounted meshes/billboards, not a diagnostic counter. */
+    readonly create: (agentIndex: number, tier: Exclude<AuraCrowdLodTier, "unknown">) => AuraCrowdRepresentation;
+}
+/** Lazily allocates each agent/tier once; switches visibility without resetting agent identity. */
+export declare function bindCrowdRepresentations(crowd: AuraCrowdHandle, options: AuraCrowdRepresentationOptions): {
+    update(camera: NavigationVec3, selected?: ReadonlySet<number>, hidden?: ReadonlySet<number>): ("near" | "impostor" | "mid")[];
+    dispose(): void;
+};
+export {};
+//# sourceMappingURL=NavigationCrowds.d.ts.map

package/dist/engine/agent-api/NavigationCrowds.d.ts.map

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

package/dist/engine/agent-api/NavigationCrowds.js

@@ -0,0 +1,176 @@
+async function loadNavigationPeer(loaders) {
+    if (loaders?.peer)
+        return loaders.peer;
+    // Literal bare specifier (never rewritten: finalize-dist exempts the
+    // optional peer). Workspace source builds resolve it through the
+    // `@aura3d/navigation-recast` alias and bundle it; installed consumers
+    // keep it external (the scaffold vite config marks it
+    // `build.rollupOptions.external`) so builds pass without shipping the
+    // peer, and it resolves via node_modules only if a route actually uses
+    // crowds — otherwise the fail-closed error below fires.
+    const peer = (await import("../../navigation-recast/index.js"));
+    if (typeof peer.createRecastNavigation !== "function") {
+        throw new Error("Recast navigation peer unavailable: the optional \"@aura3d/navigation-recast\" package did not export createRecastNavigation.");
+    }
+    return peer;
+}
+async function bakeNavMesh(options, loaders) {
+    const peer = await loadNavigationPeer(loaders);
+    const baked = await peer.createRecastNavigation(loaders ?? {});
+    const soup = { positions: options.positions, indices: options.indices };
+    return baked.generateSolo(soup, options.settings ?? {});
+}
+function queryPath(mesh, from, to) {
+    // Retained waypoints: the caller owns the returned array; empty + error on failure.
+    const result = mesh.computePath(from, to);
+    return { success: result.success, points: [...result.points], ...(result.error ? { error: result.error } : {}) };
+}
+async function navigationIsAvailable(loaders) {
+    try {
+        const peer = await loadNavigationPeer(loaders);
+        await peer.createRecastNavigation(loaders ?? {});
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export const navigation = {
+    bake: bakeNavMesh,
+    path: queryPath,
+    dispose: (mesh) => mesh.dispose(),
+    isAvailable: navigationIsAvailable
+};
+function createCrowd(mesh, options) {
+    return mesh.createCrowd(options.maxAgents, options.maxAgentRadius);
+}
+function crowdAgents(crowd) {
+    // Rendered from live Detour state, never the fixture sampler.
+    return crowd.agentStates();
+}
+export const crowds = {
+    create: createCrowd,
+    dispose: (crowd) => crowd.dispose(),
+    addAgent: (crowd, position, options = {}) => crowd.addAgent(position, options),
+    setTarget: (crowd, agent, target) => crowd.setTarget(agent, target),
+    update: (crowd, dt) => {
+        if (!Number.isFinite(dt) || dt <= 0)
+            throw new RangeError("Crowd dt must be positive and finite.");
+        crowd.update(dt);
+    },
+    agents: crowdAgents,
+    count: (crowd) => crowd.count(),
+    maxAgents: (crowd) => crowd.maxAgents,
+    bindRepresentations: bindCrowdRepresentations,
+    diagnostics: describeCrowd
+};
+/**
+ * O1 crowd LOD + cap diagnostics over LIVE crowd state (never the fixture sampler).
+ *
+ * Distances are Euclidean from `camera` to each live agent position; tiers split at
+ * `nearDistance`/`farDistance`. Throws on inverted bounds so a misconfigured LOD
+ * can never silently report every agent as near.
+ */
+export function describeCrowd(crowd, options = {}) {
+    const near = options.nearDistance ?? 6;
+    const far = options.farDistance ?? 14;
+    if (!Number.isFinite(near) || near <= 0)
+        throw new RangeError("Crowd LOD nearDistance must be positive and finite.");
+    if (!Number.isFinite(far) || far < near)
+        throw new RangeError("Crowd LOD farDistance must be finite and >= nearDistance.");
+    if (options.camera !== undefined && options.camera.some((entry) => !Number.isFinite(entry))) {
+        throw new TypeError("Crowd LOD camera coordinates must be finite.");
+    }
+    const count = crowd.count();
+    const maxAgents = crowd.maxAgents;
+    const atCap = count >= maxAgents;
+    const tiers = { near: 0, mid: 0, impostor: 0, unknown: 0 };
+    const agents = crowd.agentStates().map((state) => {
+        if (options.camera === undefined) {
+            tiers.unknown += 1;
+            return { position: state.position, distance: null, tier: "unknown" };
+        }
+        const distance = Math.hypot(state.position[0] - options.camera[0], state.position[1] - options.camera[1], state.position[2] - options.camera[2]);
+        const tier = distance <= near ? "near" : distance <= far ? "mid" : "impostor";
+        tiers[tier] += 1;
+        return { position: state.position, distance, tier };
+    });
+    return {
+        count,
+        maxAgents,
+        atCap,
+        ...(atCap ? { capWarning: `Recast crowd is at capacity (${count}/${maxAgents} agents). Raise maxAgents at creation; extra addAgent calls throw instead of silently dropping agents.` } : {}),
+        tiers,
+        agents
+    };
+}
+/** Lazily allocates each agent/tier once; switches visibility without resetting agent identity. */
+export function bindCrowdRepresentations(crowd, options) {
+    const near = options.nearDistance ?? 6;
+    const far = options.farDistance ?? 14;
+    const band = options.hysteresis ?? 0.5;
+    if (!Number.isFinite(near) || near <= 0 || !Number.isFinite(far) || far <= near ||
+        !Number.isFinite(band) || band < 0 || band * 2 >= far - near) {
+        throw new RangeError("Crowd representation thresholds require 0 < near < far and non-overlapping hysteresis.");
+    }
+    const entries = new Map();
+    let disposed = false;
+    return {
+        update(camera, selected = new Set(), hidden = new Set()) {
+            if (disposed)
+                throw new Error("Crowd representations have been disposed.");
+            if (camera.some(value => !Number.isFinite(value)))
+                throw new TypeError("Crowd camera must be finite.");
+            const states = crowd.agentStates();
+            const result = [];
+            states.forEach((state, index) => {
+                const distance = Math.hypot(...state.position.map((value, axis) => value - camera[axis]));
+                let entry = entries.get(index);
+                let tier = distance <= near ? "near" : distance <= far ? "mid" : "impostor";
+                if (entry) {
+                    if (entry.tier === "near" && distance <= near + band)
+                        tier = "near";
+                    if (entry.tier === "mid" && distance >= near - band && distance <= far + band)
+                        tier = "mid";
+                    if (entry.tier === "impostor" && distance >= far - band)
+                        tier = "impostor";
+                }
+                else {
+                    entry = { tier, heading: 0, resources: new Map() };
+                    entries.set(index, entry);
+                }
+                // Retain heading while stopped instead of snapping every stationary agent north.
+                if (Math.hypot(state.velocity[0], state.velocity[2]) > 1e-6)
+                    entry.heading = Math.atan2(state.velocity[0], state.velocity[2]);
+                let resource = entry.resources.get(tier);
+                if (!resource) {
+                    resource = options.create(index, tier);
+                    resource.setVisible(false);
+                    entry.resources.set(tier, resource);
+                }
+                resource.update({ position: state.position, heading: entry.heading, selected: selected.has(index) });
+                for (const [candidate, mounted] of entry.resources)
+                    mounted.setVisible(candidate === tier && !hidden.has(index));
+                entry.tier = tier;
+                result.push(tier);
+            });
+            for (const [index, entry] of entries)
+                if (index >= states.length) {
+                    for (const resource of entry.resources.values())
+                        resource.dispose();
+                    entries.delete(index);
+                }
+            return result;
+        },
+        dispose() {
+            if (disposed)
+                return;
+            disposed = true;
+            for (const entry of entries.values())
+                for (const resource of entry.resources.values())
+                    resource.dispose();
+            entries.clear();
+        }
+    };
+}
+//# sourceMappingURL=NavigationCrowds.js.map

package/dist/engine/agent-api/NavigationCrowds.js.map

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

package/dist/engine/agent-api/PhysicsRuntime.d.ts

@@ -26,7 +26,7 @@
  * genuinely supports — an unsupported shape throws with an actionable message rather
  * than silently doing nothing.
  */
-import type { CollisionEvent, PhysicsWorld, RaycastHit, RigidBody } from "../../physics/index.js";
+import type { CollisionEvent, PhysicsBackendSelection, PhysicsWorld, RaycastHit, RigidBody } from "../../physics/index.js";
 export type PhysicsVec3 = readonly [number, number, number];
 /** A live handle onto one simulated body. */
 export interface AuraBodyHandle {
@@ -130,11 +130,27 @@ export interface AuraDebugLine {
     /** What the segment represents, for filtering or a legend. */
     readonly category?: string | undefined;
 }
+export interface AuraDebugBudgetTelemetry {
+    /** Lines the world would have emitted without a budget. */
+    readonly requested: number;
+    /** Lines actually returned. */
+    readonly emitted: number;
+    /** Lines dropped by the budget (`requested - emitted`). */
+    readonly dropped: number;
+    /** True when a `maxLines` budget was applied. */
+    readonly budgeted: boolean;
+    /** Emitted line counts by category. */
+    readonly byCategory: Readonly<Record<string, number>>;
+}
 export interface AuraPhysicsDebugOptions {
+    /** Master toggle: `false` returns zero lines. Defaults to on. */
+    readonly enabled?: boolean | undefined;
     readonly contacts?: boolean | undefined;
     readonly joints?: boolean | undefined;
     readonly sleeping?: boolean | undefined;
     readonly normalLength?: number | undefined;
+    /** Line budget: truncate the tail and report drops in `debugBudget()`. */
+    readonly maxLines?: number | undefined;
     /** Rays to draw. The world cannot know about a query you ran, so pass it here. */
     readonly raycasts?: readonly {
         readonly origin: PhysicsVec3;
@@ -165,6 +181,15 @@ export interface AuraBodySpec {
     readonly sensor?: boolean | undefined;
     /** Layer name, resolved against the layers passed to {@link createPhysicsRuntime}. */
     readonly layer?: string | undefined;
+    /**
+     * Hull vertices, `convexHull` only. The H1 root promotion for convex colliders:
+     * Rapier (the sole physical-simulation owner) builds a native convex hull from
+     * these points, so a crate chunk or rock needs no deep import to collide as one
+     * solid volume rather than a box approximation.
+     */
+    readonly vertices?: readonly PhysicsVec3[] | undefined;
+    /** Hull triangle indices, `convexHull` only. Must reference `vertices`. */
+    readonly indices?: readonly number[] | undefined;
 }
 export interface AuraPhysicsRuntime {
     readonly bodies: AuraBodyRegistry;
@@ -195,6 +220,12 @@ export interface AuraPhysicsRuntime {
      * plain line segments so a route can render them with whatever it already uses.
      */
     debugLines(options?: AuraPhysicsDebugOptions): readonly AuraDebugLine[];
+    /**
+     * Budget telemetry for the debug overlay: requested/emitted/dropped counts plus
+     * per-category breakdown, so a route can prove the overlay stayed within budget.
+     * Honors the same `enabled` toggle and `maxLines` budget as `debugLines`.
+     */
+    debugBudget(options?: AuraPhysicsDebugOptions): AuraDebugBudgetTelemetry;
     /** Every collision, including resting contacts. */
     onCollision(handler: AuraCollisionHandler): AuraUnsubscribe;
     /** Collisions involving one named node, which is what gameplay code usually wants. */
@@ -205,6 +236,16 @@ export interface AuraPhysicsRuntime {
     /** Gravity currently applied by the world. */
     gravity(): PhysicsVec3;
     setGravity(gravity: PhysicsVec3): void;
+    /**
+     * Backend provenance (H1 promotion): the sole physical-simulation owner
+     * (`rapier`), the adaptive-substep CCD selection with per-step telemetry
+     * (`lastSubSteps`, `lastMaxMotion`, limit flags), and the repeatability seed
+     * when the world was constructed with one.
+     *
+     * Read this after `step()` to confirm the tunnel-guard actually engaged on a
+     * fast-body frame rather than assuming it did.
+     */
+    backend(): PhysicsBackendSelection;
 }
 /**
  * Layer membership and masks.
@@ -225,8 +266,16 @@ export declare function layersCollide(layers: AuraCollisionLayers, a: string, b:
 /** Bitmask for a layer name, for backends that take masks directly. */
 export declare function layerMask(layers: AuraCollisionLayers, name: string): number;
 export declare function collisionMaskFor(layers: AuraCollisionLayers, name: string): number;
-/** Joint kinds this runtime exposes. Every one is backed by a solver constraint. */
-export type AuraJointKind = "fixed" | "hinge" | "slider" | "ball-socket" | "spring" | "motorised-hinge";
+/**
+ * Joint kinds this runtime exposes. Every one is backed by a solver constraint.
+ *
+ * `revolute` is the Rapier-native name for `hinge`; `prismatic` is the
+ * Rapier-native name for `slider`. Both spellings build the same native joint,
+ * so the H1 fixed/revolute/prismatic promotion reads identically at root and in
+ * the adapter. Authored arcade motion (vehicles, characters) stays non-physical
+ * and never routes through these joints.
+ */
+export type AuraJointKind = "fixed" | "hinge" | "revolute" | "slider" | "prismatic" | "ball-socket" | "spring" | "motorised-hinge";
 export interface AuraJointSpec {
     readonly kind: AuraJointKind;
     readonly bodyA: number | string;
@@ -274,7 +323,7 @@ export declare function validateJointSpec(spec: AuraJointSpec): void;
  * | `box` | yes | yes | yes |
  * | `sphere` | yes | yes | yes |
  * | `capsule` | yes | yes | yes |
- * | `convexHull` | yes | yes | no — needs vertices |
+ * | `convexHull` | yes | yes | with spec `vertices` + `indices` (not dimensions-alone) |
  * | `mesh` | no | yes | no — needs geometry |
  * | `plane` | no | yes | yes |
  * | `heightfield` | no | yes | no — needs a height grid |
@@ -291,7 +340,14 @@ export type AuraColliderShape = "box" | "sphere" | "capsule" | "plane" | "convex
  */
 export declare const AURA_DYNAMIC_CAPABLE_SHAPES: readonly AuraColliderShape[];
 export declare const AURA_STATIC_ONLY_SHAPES: readonly AuraColliderShape[];
-/** Shapes {@link AuraPhysicsRuntime.createBody} can build from dimensions alone. */
+/**
+ * Shapes {@link AuraPhysicsRuntime.createBody} can build from dimensions alone.
+ *
+ * `convexHull` is deliberately absent: it is supported from a spec (H1 promotion)
+ * but needs `vertices` + `indices`, so a bare `{ shape: "convexHull" }` throws an
+ * actionable error instead of silently becoming a box. The existing
+ * "refuses a shape it cannot build from a spec" contract pins this list.
+ */
 export declare const AURA_SPEC_CONSTRUCTIBLE_SHAPES: readonly AuraColliderShape[];
 export declare function assertShapeSupported(shape: AuraColliderShape, bodyType: "static" | "dynamic" | "kinematic"): void;
 /**

package/dist/engine/agent-api/PhysicsRuntime.d.ts.map

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