@relu-interactives/spatial-ecs 0.5.2 → 0.8.0

package/dist/index.d.cts

@@ -1,16 +1,18 @@
-import { k as EcsSystem, C as Component, W as WorldEntityView, T as TransformComponent, l as World, S as SpawnPrefabSource, m as SpawnPrefabOptions, n as ComponentClass, o as ParentLookup, p as EcsEntityKind, O as ObjectManagementSystem, q as SubtreeSnapshot, r as EntityId, s as ExternalRefWarning } from './System-V_mv07le.cjs';
-export { A as AssetInput, t as CheckboxInput, u as ColorInput, v as ComponentFactory, w as ComponentInput, x as ComponentKind, y as DropdownInput, z as DropdownOption, B as EcsComponentFactoryKind, F as EcsEntityEditorKind, G as EntityInput, H as FloatInput, I as InputSystem, J as IntersectionResult, K as KeyboardKey, L as KeyboardKeys, M as MouseButton, N as PREFAB_FILE_VERSION, Q as PREFAB_FILE_VERSION_NESTED, R as PrefabAsset, U as RemapSnapshotOptions, X as RenderSystem, Y as SelectionListener, Z as SliderInput, _ as TextInput, $ as ToggleInput, a0 as TransformSyncSystem, a1 as Vec3, a2 as Vector2Input, a3 as Vector3Input, a4 as clearPrefabCache, a5 as despawnPrefab, a6 as loadPrefab, a7 as parsePrefabAsset, a8 as prefabFileVersionFor, a9 as remapSnapshotEntityIds, aa as setPrefabAssetUrlResolver, ab as spawnPrefab } from './System-V_mv07le.cjs';
+import { B as EcsSystem, C as Component, K as WorldEntityView, T as TransformComponent, W as World, S as SpawnPrefabSource, L as SpawnPrefabOptions, H as NetworkHandle, N as NetValue, M as PlaySlotOptions, O as ComponentClass, Q as ParentLookup, R as RenderBackend, U as EcsEntityKind, X as ObjectManagementSystem, Y as SubtreeSnapshot, G as EntityId, Z as ExternalRefWarning, _ as AudioBus } from './System-8D-XBDKZ.cjs';
+export { $ as AssetInput, a0 as AudioSystem, a1 as CheckboxInput, a2 as ChromaKeyOptions, a3 as ColorInput, a4 as ComponentFactory, a5 as ComponentInput, a6 as ComponentKind, a7 as DropdownInput, a8 as DropdownOption, a9 as EcsComponentFactoryKind, aa as EcsEntityEditorKind, ab as EcsRenderer, ac as EntityInput, ad as FloatInput, ae as IKSystem, af as InputSystem, ag as IntersectionResult, ah as KeyboardKey, ai as KeyboardKeys, aj as ModelBoneInfo, ak as MouseButton, J as NetSpawnOptions, al as PREFAB_FILE_VERSION, am as PREFAB_FILE_VERSION_NESTED, an as PostprocessingBuildContext, ao as PostprocessingPipeline, ap as PrefabAsset, aq as RemapSnapshotOptions, ar as RenderSystem, as as RendererKind, at as ScriptErrorEvent, au as ScriptErrorListener, av as ScriptErrorPhase, aw as ScriptErrorReport, ax as ScriptErrorSource, ay as SelectionListener, az as SliderInput, aA as SlotChooser, aB as SoundBankAsset, aC as SoundSlot, aD as SoundTake, aE as TextInput, aF as ToggleInput, aG as TransformSyncSystem, aH as Vec3, aI as Vector2Input, aJ as Vector3Input, aK as clearPrefabCache, aL as despawnPrefab, aM as findModelBone, aN as listModelBones, aO as loadPrefab, aP as parsePrefabAsset, aQ as prefabFileVersionFor, aR as remapSnapshotEntityIds, aS as setPrefabAssetUrlResolver, aT as soundBankFiles, aU as spawnPrefab } from './System-8D-XBDKZ.cjs';
 import * as THREE from 'three';
-import { O as Object3DRef, aE as XrHandPreset } from './XRHandPose-CQTLGxFC.cjs';
-export { aQ as AnimationStateCallbacks, aR as AnimationStateMachine, aS as AnimationStateManager, aT as StateMachine } from './XRHandPose-CQTLGxFC.cjs';
-import { X as XrCapabilities, a as XrInputState, b as XrHandPoseEventDetail } from './index-DaG03vyN.cjs';
-export { A as AnimationSystem, c as AudioSystem, C as CameraSyncSystem, E as EnvironmentSyncSystem, I as InstancedMeshSystem, L as LightSyncSystem, M as MaterialSyncSystem, d as MeshGeometrySystem, e as ModuleLoader, N as NO_XR_CAPABILITIES, O as ObjectVisibilitySystem, P as PhysicsSyncSystem, f as PostprocessingSyncSystem, S as SCRIPT_OBJECT_ROOT_FLAG, g as ScriptBehaviourSystem, h as ScriptObjectSystem, i as SelectionContext, U as UIInteractionSystem, j as UIPanelSystem, k as UiCanvasLike, V as VRTeleportAreaSystem, l as VideoSystem, m as XRAnchorSystem, n as XRControllerVisualSystem, o as XREnvironmentSystem, p as XRHandPoseSystem, q as XRHitTestSystem, r as XRHoverVisualSystem, s as XRInputSystem, t as XRInteractionSystem, u as XRLocomotionSystem, v as XRSessionSystem, w as XRTeleportVisualSystem, x as XR_HOVER_SHELL_FLAG, y as XrHandedness, z as XrHitResult, B as XrInputKind, D as readXrCapabilities } from './index-DaG03vyN.cjs';
-export { i as CoreComponents } from './index-Dlr-7-4m.cjs';
-export { createAnimationComponent, createAudioComponent, createCameraComponent, createEntityTypeComponent, createEnvironmentComponent, createImageComponent, createImageTargetAnchorComponent, createImageTargetComponent, createInstanceSlotComponent, createInstancedMeshComponent, createLightComponent, createMaterialComponent, createMeshComponent, createMeshGeometryComponent, createModelComponent, createNameComponent, createObject3DRefComponent, createParentIdComponent, createPhysicsComponent, createPostprocessingComponent, createScriptComponent, createScriptObjectComponent, createSelectableComponent, createSelectionTransformStateComponent, createSpriteComponent, createTransformComponent, createUIButtonComponent, createUIPanelComponent, createUISliderComponent, createUITextComponent, createUIToggleComponent, createVRTeleportAreaComponent, createVideoComponent, createXRAnchorComponent, createXRHandPoseComponent, createXRInteractableComponent, createXRInteractorComponent, createXRInteractorSideComponent, createXRRigComponent, registerDefaultComponentFactories, registerDefaultFactories } from './factories/index.cjs';
-import { GLTF } from 'three/examples/jsm/loaders/GLTFLoader.js';
+import { T as Object3DRef, aJ as XrHandPreset } from './XRHandPose-VQMT1WXj.cjs';
+export { aW as AnimationStateCallbacks, aX as AnimationStateMachine, aY as AnimationStateManager, aZ as StateMachine } from './XRHandPose-VQMT1WXj.cjs';
+import { X as XrCapabilities, a as XrInputState, b as XrHandPoseEventDetail } from './index-C70N4BYG.cjs';
+export { A as AnimationSystem, C as CameraSyncSystem, D as DEFAULT_SCRIPT_ERROR_RETRY_DELAY, E as EnvironmentSyncSystem, I as InstancedMeshSystem, L as LightSyncSystem, M as MaterialSyncSystem, c as MeshGeometrySystem, d as ModuleLoader, N as NO_XR_CAPABILITIES, O as ObjectVisibilitySystem, P as PhysicsSyncSystem, e as PostprocessingSyncSystem, S as SCRIPT_OBJECT_ROOT_FLAG, f as ScriptBehaviourSystem, g as ScriptBehaviourSystemOptions, h as ScriptObjectSystem, i as SelectionContext, U as UIInteractionSystem, j as UIPanelSystem, k as UiCanvasLike, V as VRTeleportAreaSystem, l as VideoSystem, m as XRAnchorSystem, n as XRControllerVisualSystem, o as XREnvironmentSystem, p as XRHandPoseSystem, q as XRHitTestSystem, r as XRHoverVisualSystem, s as XRInputSystem, t as XRInteractionSystem, u as XRLocomotionSystem, v as XRSessionSystem, w as XRTeleportVisualSystem, x as XR_HOVER_SHELL_FLAG, y as XrHandedness, z as XrHitResult, B as XrInputKind, F as readXrCapabilities } from './index-C70N4BYG.cjs';
+export { i as CoreComponents } from './index-D9DjrUn3.cjs';
+export { createAnimationComponent, createAudioComponent, createBoneAttachmentComponent, createCameraComponent, createEntityTypeComponent, createEnvironmentComponent, createIKComponent, createImageComponent, createImageTargetAnchorComponent, createImageTargetComponent, createInstanceSlotComponent, createInstancedMeshComponent, createLightComponent, createMaterialComponent, createMeshComponent, createMeshGeometryComponent, createModelComponent, createNameComponent, createNetworkIdentityComponent, createNetworkSpawnerComponent, createNetworkTransformComponent, createNetworkedPropsComponent, createObject3DRefComponent, createParentIdComponent, createPhysicsComponent, createPostprocessingComponent, createScriptComponent, createScriptObjectComponent, createSelectableComponent, createSelectionTransformStateComponent, createSpriteComponent, createTransformComponent, createUIButtonComponent, createUIPanelComponent, createUISliderComponent, createUITextComponent, createUIToggleComponent, createVRTeleportAreaComponent, createVideoComponent, createXRAnchorComponent, createXRHandPoseComponent, createXRInteractableComponent, createXRInteractorComponent, createXRInteractorSideComponent, createXRRigComponent, registerDefaultComponentFactories, registerDefaultFactories } from './factories/index.cjs';
+import { GLTF, GLTFLoader } from 'three/examples/jsm/loaders/GLTFLoader.js';
 import { X as XrHandPoseDefinition, a as XrFinger, b as XrHandPoseOrientation, c as XrHandPoseDirection } from './handPose-DlcTtqgx.cjs';
 export { C as CURLED_COS, D as DEFAULT_DIRECTION_TOLERANCE, d as DEFAULT_ENTER_CONFIDENCE, e as DEFAULT_EXIT_CONFIDENCE, f as DEFAULT_LOST_GRACE_SECONDS, g as DEFAULT_MIN_HOLD_SECONDS, F as FALLBACK_HAND_SCALE, H as HandPoseTracker, h as HandPoseTrackerOptions, M as MATCH_FALLOFF, P as PINCH_FINGERS, S as STRAIGHT_COS, i as XR_FINGERS, j as XrFingerCurl, k as XrFingerTarget, l as XrHandJointName, m as XrHandJoints, n as XrHandPoseAxis, o as XrHandPoseContext, p as XrHandPoseEvent, q as XrHandPoseMatch, r as XrHandShape, s as XrPalmPose, t as computeFingerCurl, u as computeHandShape, v as computePalmPose, w as computePalmWidth, x as computePinch, y as computeSpread, z as estimateHandScale, A as matchHandPose } from './handPose-DlcTtqgx.cjs';
 import '@dimforge/rapier3d-compat';
+import './animation/index.cjs';
+import 'three/webgpu';
 
 interface CustomEcsSystem extends EcsSystem {
     data: Component | Record<string, unknown>;
@@ -170,6 +172,37 @@ declare class Behaviour implements CustomEcsSystem {
      * ```
      */
     spawnPrefab(source: SpawnPrefabSource, options?: SpawnPrefabOptions): Promise<number>;
+    /**
+     * The shared world, or `null` in a single-player run, so a script can work
+     * both ways:
+     *
+     * ```ts
+     * if (this.network && !this.network.isOwner) return; // someone else moves this
+     * ```
+     */
+    get network(): NetworkHandle | null;
+    /** Someone joined the room. `playerId` is their session id. */
+    onPlayerJoin(_playerId: string): void;
+    /** Someone left the room. */
+    onPlayerLeave(_playerId: string): void;
+    /** A shared value on this entity changed. */
+    onNetworkProp(_key: string, _value: NetValue): void;
+    /**
+     * Load a `.soundbank.json` asset so {@link Behaviour.playSlot} can play it.
+     * `source` is an asset path or an `AssetInput` field.
+     */
+    loadSoundBank(source: string | {
+        path: string;
+    }): Promise<void>;
+    /**
+     * Play a named sound from a loaded bank, as a random take. Returns whether it
+     * sounded: its chance, cooldown or priority may keep it quiet.
+     *
+     * ```ts
+     * this.playSlot("hit", { position: this.transform.position });
+     * ```
+     */
+    playSlot(id: string, options?: PlaySlotOptions): boolean;
     /**
      * Remove a spawned prefab instance (the root entity and all descendants).
      * Returns the number of entities removed.
@@ -453,6 +486,12 @@ declare class ScriptObject {
     dispose?(): void;
 }
 
+/**
+ * The default {@link RenderBackend}: three's `WebGLRenderer`, post-processing
+ * through `EffectComposer`, GLSL chroma key.
+ */
+declare const webglBackend: RenderBackend;
+
 type ComponentValueMaps = {
     object3DRefValues: Map<number, unknown>;
     nameValues: Map<number, unknown>;
@@ -481,6 +520,12 @@ type ComponentValueMaps = {
     xrInteractorValues: Map<number, unknown>;
     xrHandPoseValues: Map<number, unknown>;
     xrAnchorValues: Map<number, unknown>;
+    boneAttachmentValues: Map<number, unknown>;
+    ikValues: Map<number, unknown>;
+    networkIdentityValues: Map<number, unknown>;
+    networkTransformValues: Map<number, unknown>;
+    networkedPropsValues: Map<number, unknown>;
+    networkSpawnerValues: Map<number, unknown>;
     uiPanelValues: Map<number, unknown>;
     uiTextValues: Map<number, unknown>;
     uiButtonValues: Map<number, unknown>;
@@ -632,7 +677,7 @@ declare function collectDirectPrefabDependencies(snapshot: SubtreeSnapshot): str
 declare const NODE_KEY_SEPARATOR = "/";
 /**
  * Reserved override "component" marking a node ADDED by the host document
- * inside a nested instance region (`"<nodeKey>|+node|"`). File patching
+ * inside a nested instance region (`"&lt;nodeKey&gt;|+node|"`). File patching
  * trusts stored overrides (the old base is unavailable), so without the
  * marker a host-authored node inside the region would be indistinguishable
  * from a node the child prefab removed — and get deleted.
@@ -841,6 +886,63 @@ declare function sampleTeleportArc(origin: THREE.Vector3, direction: THREE.Vecto
  */
 declare function arcGroundCrossing(points: THREE.Vector3[], groundY: number): THREE.Vector3 | null;
 
+/** Sets a node's world rotation, keeping its position (children follow). */
+declare function setWorldQuaternion(o: THREE.Object3D, q: THREE.Quaternion): void;
+/**
+ * Two-bone IK: rotates `upper` and `lower` so `end`'s origin (the wrist or
+ * ankle) reaches `target`, bending toward `pole` (pass the animated
+ * elbow/knee position to keep the animation's style). Unreachable targets are
+ * reached for as far as the limb allows. Returns how far the end stayed from
+ * the target (0 when reachable).
+ */
+declare function twoBoneIK(upper: THREE.Object3D, lower: THREE.Object3D, end: THREE.Object3D, target: THREE.Vector3, pole: THREE.Vector3): number;
+/**
+ * World rotation for a hand gripping a bar along `axis` (unit), for hands
+ * whose bones run +X across the knuckles, +Y along the fingers and +Z out of
+ * the palm (the editor's fixed rigs). The back of the hand faces `back`
+ * (projected off the axis); the fingers continue away from the elbow
+ * (`forearm` = elbow → wrist).
+ */
+declare function gripQuaternion(axis: THREE.Vector3, back: THREE.Vector3, forearm: THREE.Vector3, out?: THREE.Quaternion): THREE.Quaternion;
+
+/**
+ * The one GLTFLoader setup for every model and clip the engine loads.
+ *
+ * - Draco (`KHR_draco_mesh_compression`): decoder files resolved per loader,
+ *   so a `setDracoDecoderPath()` override made after module load still
+ *   applies.
+ * - meshopt (`EXT_meshopt_compression`): what the editor's model optimiser
+ *   writes (gltf-transform + meshoptimizer, the pipeline the Akofena
+ *   characters shipped with). The decoder carries its wasm inline, so there
+ *   is no path to configure.
+ *
+ * Quantized meshes (`KHR_mesh_quantization`) and WebP textures
+ * (`EXT_texture_webp`) need no decoder: GLTFLoader reads them natively.
+ */
+declare function createGLTFLoader(): GLTFLoader;
+
+/**
+ * The volume groups every sound plays through: each sound's output goes to its
+ * bus instead of straight to the listener, so a game can turn music down
+ * without touching a single sound, and music dips while a voice plays.
+ */
+declare class AudioMixer {
+    readonly listener: THREE.AudioListener;
+    private readonly buses;
+    private readonly volumes;
+    private readonly routed;
+    constructor(listener: THREE.AudioListener);
+    /** The node a sound connects to for this bus. */
+    input(bus: AudioBus): GainNode;
+    /** Send a three.js sound through a bus. Does nothing when it's already there. */
+    route(sound: THREE.Audio<GainNode> | THREE.PositionalAudio, bus: AudioBus): void;
+    setVolume(bus: AudioBus, volume: number): void;
+    getVolume(bus: AudioBus): number;
+    /** Dip the music for `seconds`, then bring it back. A later duck replaces this one. */
+    duckMusic(seconds: number): void;
+    dispose(): void;
+}
+
 /**
  * Decides when a teleport may actually commit.
  *
@@ -1002,4 +1104,4 @@ declare class ThrowVelocityTracker {
  */
 declare function angularVelocityFrom(previous: THREE.Quaternion, current: THREE.Quaternion, deltaTime: number): THREE.Vector3;
 
-export { ADDED_NODE_MARKER_COMPONENT, ARC_GRAVITY, ARC_MAX_TIME, ARC_SPEED, ARC_STEPS, type ApplyPrefabToSnapshotResult, Behaviour, Component, type ComponentValueMaps, EcsEntityKind, EcsSystem, type EcsWorldComponentSnapshot, type EcsWorldStateSnapshotLike, EntityId, ExternalRefWarning, HAND_POSE_PRESETS, HAND_POSE_PRESET_IDS, HYDRATABLE_ENTITY_KINDS, type HandMaterialOptions, type HydrateOptions, type HydrateWorldFromSnapshotResult, type InstantiateSubtreeResult, MAX_PLAUSIBLE_SPEED, MAX_SAMPLE_AGE_SECONDS, NODE_KEY_SEPARATOR, type NestedRegion, type NodeKeyMaps, type NodeMaps, OVERRIDE_DIFF_EXCLUDED_COMPONENTS, OVERRIDE_ROOT_EXCLUDED_COMPONENTS, ObjectManagementSystem, ParentLookup, SHARED_MODEL_RESOURCE_FLAG, ScriptObject, type SerializeEntitySubtreeResult, SpawnPrefabOptions, SpawnPrefabSource, SubtreeSnapshot, TeleportAimGate, ThrowVelocityTracker, type UiInteractionEvent, VELOCITY_SAMPLES, type VelocitySample, World, WorldEntityView, XrCapabilities, XrFinger, XrHandPoseDefinition, XrHandPoseDirection, XrHandPoseEventDetail, XrHandPoseOrientation, XrInputState, angularVelocityFrom, applyHandMaterial, applyPrefabToSnapshotInstances, arcGroundCrossing, buildComponentValueMaps, buildNodeKeyMapsFromSnapshot, buildNodeMapsFromSnapshot, canonicalizeComponentValue, clearModelCache, cloneHandPose, collectDiffPaths, collectDirectPrefabDependencies, collectEntitySubtree, collectSnapshotSubtreeIds, computeInstanceOverrides, createHandMaterial, decanonicalizeComponentValue, encodeOverride, findSnapshotRootEntityIds, findTopLevelNestedRegions, getHandPosePreset, groupOverridePaths, handPoseFromCurls, hydrateWorldFromSnapshot, hydrateWorldFromSnapshotDetailed, indexSnapshotByEntity, instantiateSubtree, loadSharedGltf, mergeComponentValue, parseOverride, resolveDracoDecoderPath, restoreComponentState, restorePostCreateComponents, sampleTeleportArc, serializeEntitySubtree, setDracoDecoderPath };
+export { ADDED_NODE_MARKER_COMPONENT, ARC_GRAVITY, ARC_MAX_TIME, ARC_SPEED, ARC_STEPS, type ApplyPrefabToSnapshotResult, AudioBus, AudioMixer, Behaviour, Component, type ComponentValueMaps, EcsEntityKind, EcsSystem, type EcsWorldComponentSnapshot, type EcsWorldStateSnapshotLike, EntityId, ExternalRefWarning, HAND_POSE_PRESETS, HAND_POSE_PRESET_IDS, HYDRATABLE_ENTITY_KINDS, type HandMaterialOptions, type HydrateOptions, type HydrateWorldFromSnapshotResult, type InstantiateSubtreeResult, MAX_PLAUSIBLE_SPEED, MAX_SAMPLE_AGE_SECONDS, NODE_KEY_SEPARATOR, type NestedRegion, NetworkHandle, type NodeKeyMaps, type NodeMaps, OVERRIDE_DIFF_EXCLUDED_COMPONENTS, OVERRIDE_ROOT_EXCLUDED_COMPONENTS, ObjectManagementSystem, ParentLookup, PlaySlotOptions, RenderBackend, SHARED_MODEL_RESOURCE_FLAG, ScriptObject, type SerializeEntitySubtreeResult, SpawnPrefabOptions, SpawnPrefabSource, SubtreeSnapshot, TeleportAimGate, ThrowVelocityTracker, type UiInteractionEvent, VELOCITY_SAMPLES, type VelocitySample, World, WorldEntityView, XrCapabilities, XrFinger, XrHandPoseDefinition, XrHandPoseDirection, XrHandPoseEventDetail, XrHandPoseOrientation, XrInputState, angularVelocityFrom, applyHandMaterial, applyPrefabToSnapshotInstances, arcGroundCrossing, buildComponentValueMaps, buildNodeKeyMapsFromSnapshot, buildNodeMapsFromSnapshot, canonicalizeComponentValue, clearModelCache, cloneHandPose, collectDiffPaths, collectDirectPrefabDependencies, collectEntitySubtree, collectSnapshotSubtreeIds, computeInstanceOverrides, createGLTFLoader, createHandMaterial, decanonicalizeComponentValue, encodeOverride, findSnapshotRootEntityIds, findTopLevelNestedRegions, getHandPosePreset, gripQuaternion, groupOverridePaths, handPoseFromCurls, hydrateWorldFromSnapshot, hydrateWorldFromSnapshotDetailed, indexSnapshotByEntity, instantiateSubtree, loadSharedGltf, mergeComponentValue, parseOverride, resolveDracoDecoderPath, restoreComponentState, restorePostCreateComponents, sampleTeleportArc, serializeEntitySubtree, setDracoDecoderPath, setWorldQuaternion, twoBoneIK, webglBackend };

package/dist/index.d.ts

@@ -1,16 +1,18 @@
-import { k as EcsSystem, C as Component, W as WorldEntityView, T as TransformComponent, l as World, S as SpawnPrefabSource, m as SpawnPrefabOptions, n as ComponentClass, o as ParentLookup, p as EcsEntityKind, O as ObjectManagementSystem, q as SubtreeSnapshot, r as EntityId, s as ExternalRefWarning } from './System-V_mv07le.js';
-export { A as AssetInput, t as CheckboxInput, u as ColorInput, v as ComponentFactory, w as ComponentInput, x as ComponentKind, y as DropdownInput, z as DropdownOption, B as EcsComponentFactoryKind, F as EcsEntityEditorKind, G as EntityInput, H as FloatInput, I as InputSystem, J as IntersectionResult, K as KeyboardKey, L as KeyboardKeys, M as MouseButton, N as PREFAB_FILE_VERSION, Q as PREFAB_FILE_VERSION_NESTED, R as PrefabAsset, U as RemapSnapshotOptions, X as RenderSystem, Y as SelectionListener, Z as SliderInput, _ as TextInput, $ as ToggleInput, a0 as TransformSyncSystem, a1 as Vec3, a2 as Vector2Input, a3 as Vector3Input, a4 as clearPrefabCache, a5 as despawnPrefab, a6 as loadPrefab, a7 as parsePrefabAsset, a8 as prefabFileVersionFor, a9 as remapSnapshotEntityIds, aa as setPrefabAssetUrlResolver, ab as spawnPrefab } from './System-V_mv07le.js';
+import { K as EcsSystem, d as Component, S as WorldEntityView, T as TransformComponent, W as World, U as SpawnPrefabSource, X as SpawnPrefabOptions, O as NetworkHandle, N as NetValue, Y as PlaySlotOptions, Z as ComponentClass, _ as ParentLookup, R as RenderBackend, $ as EcsEntityKind, a0 as ObjectManagementSystem, a1 as SubtreeSnapshot, M as EntityId, a2 as ExternalRefWarning, a3 as AudioBus } from './System-DPMAW30g.js';
+export { a4 as AssetInput, a5 as AudioSystem, a6 as CheckboxInput, C as ChromaKeyOptions, a7 as ColorInput, a8 as ComponentFactory, a9 as ComponentInput, aa as ComponentKind, ab as DropdownInput, ac as DropdownOption, ad as EcsComponentFactoryKind, ae as EcsEntityEditorKind, E as EcsRenderer, af as EntityInput, ag as FloatInput, ah as IKSystem, ai as InputSystem, aj as IntersectionResult, ak as KeyboardKey, al as KeyboardKeys, am as ModelBoneInfo, an as MouseButton, Q as NetSpawnOptions, ao as PREFAB_FILE_VERSION, ap as PREFAB_FILE_VERSION_NESTED, a as PostprocessingBuildContext, P as PostprocessingPipeline, aq as PrefabAsset, ar as RemapSnapshotOptions, as as RenderSystem, c as RendererKind, at as ScriptErrorEvent, au as ScriptErrorListener, av as ScriptErrorPhase, aw as ScriptErrorReport, ax as ScriptErrorSource, ay as SelectionListener, az as SliderInput, aA as SlotChooser, aB as SoundBankAsset, aC as SoundSlot, aD as SoundTake, aE as TextInput, aF as ToggleInput, aG as TransformSyncSystem, aH as Vec3, aI as Vector2Input, aJ as Vector3Input, aK as clearPrefabCache, aL as despawnPrefab, aM as findModelBone, aN as listModelBones, aO as loadPrefab, aP as parsePrefabAsset, aQ as prefabFileVersionFor, aR as remapSnapshotEntityIds, aS as setPrefabAssetUrlResolver, aT as soundBankFiles, aU as spawnPrefab } from './System-DPMAW30g.js';
 import * as THREE from 'three';
-import { O as Object3DRef, aE as XrHandPreset } from './XRHandPose-CU3vNFuS.js';
-export { aQ as AnimationStateCallbacks, aR as AnimationStateMachine, aS as AnimationStateManager, aT as StateMachine } from './XRHandPose-CU3vNFuS.js';
-import { X as XrCapabilities, a as XrInputState, b as XrHandPoseEventDetail } from './index-D2Jt_JzH.js';
-export { A as AnimationSystem, c as AudioSystem, C as CameraSyncSystem, E as EnvironmentSyncSystem, I as InstancedMeshSystem, L as LightSyncSystem, M as MaterialSyncSystem, d as MeshGeometrySystem, e as ModuleLoader, N as NO_XR_CAPABILITIES, O as ObjectVisibilitySystem, P as PhysicsSyncSystem, f as PostprocessingSyncSystem, S as SCRIPT_OBJECT_ROOT_FLAG, g as ScriptBehaviourSystem, h as ScriptObjectSystem, i as SelectionContext, U as UIInteractionSystem, j as UIPanelSystem, k as UiCanvasLike, V as VRTeleportAreaSystem, l as VideoSystem, m as XRAnchorSystem, n as XRControllerVisualSystem, o as XREnvironmentSystem, p as XRHandPoseSystem, q as XRHitTestSystem, r as XRHoverVisualSystem, s as XRInputSystem, t as XRInteractionSystem, u as XRLocomotionSystem, v as XRSessionSystem, w as XRTeleportVisualSystem, x as XR_HOVER_SHELL_FLAG, y as XrHandedness, z as XrHitResult, B as XrInputKind, D as readXrCapabilities } from './index-D2Jt_JzH.js';
-export { i as CoreComponents } from './index-C3ik3sA1.js';
-export { createAnimationComponent, createAudioComponent, createCameraComponent, createEntityTypeComponent, createEnvironmentComponent, createImageComponent, createImageTargetAnchorComponent, createImageTargetComponent, createInstanceSlotComponent, createInstancedMeshComponent, createLightComponent, createMaterialComponent, createMeshComponent, createMeshGeometryComponent, createModelComponent, createNameComponent, createObject3DRefComponent, createParentIdComponent, createPhysicsComponent, createPostprocessingComponent, createScriptComponent, createScriptObjectComponent, createSelectableComponent, createSelectionTransformStateComponent, createSpriteComponent, createTransformComponent, createUIButtonComponent, createUIPanelComponent, createUISliderComponent, createUITextComponent, createUIToggleComponent, createVRTeleportAreaComponent, createVideoComponent, createXRAnchorComponent, createXRHandPoseComponent, createXRInteractableComponent, createXRInteractorComponent, createXRInteractorSideComponent, createXRRigComponent, registerDefaultComponentFactories, registerDefaultFactories } from './factories/index.js';
-import { GLTF } from 'three/examples/jsm/loaders/GLTFLoader.js';
+import { T as Object3DRef, aJ as XrHandPreset } from './XRHandPose-G0Dl-F0w.js';
+export { aW as AnimationStateCallbacks, aX as AnimationStateMachine, aY as AnimationStateManager, aZ as StateMachine } from './XRHandPose-G0Dl-F0w.js';
+import { X as XrCapabilities, a as XrInputState, b as XrHandPoseEventDetail } from './index-C61n65PE.js';
+export { A as AnimationSystem, C as CameraSyncSystem, D as DEFAULT_SCRIPT_ERROR_RETRY_DELAY, E as EnvironmentSyncSystem, I as InstancedMeshSystem, L as LightSyncSystem, M as MaterialSyncSystem, c as MeshGeometrySystem, d as ModuleLoader, N as NO_XR_CAPABILITIES, O as ObjectVisibilitySystem, P as PhysicsSyncSystem, e as PostprocessingSyncSystem, S as SCRIPT_OBJECT_ROOT_FLAG, f as ScriptBehaviourSystem, g as ScriptBehaviourSystemOptions, h as ScriptObjectSystem, i as SelectionContext, U as UIInteractionSystem, j as UIPanelSystem, k as UiCanvasLike, V as VRTeleportAreaSystem, l as VideoSystem, m as XRAnchorSystem, n as XRControllerVisualSystem, o as XREnvironmentSystem, p as XRHandPoseSystem, q as XRHitTestSystem, r as XRHoverVisualSystem, s as XRInputSystem, t as XRInteractionSystem, u as XRLocomotionSystem, v as XRSessionSystem, w as XRTeleportVisualSystem, x as XR_HOVER_SHELL_FLAG, y as XrHandedness, z as XrHitResult, B as XrInputKind, F as readXrCapabilities } from './index-C61n65PE.js';
+export { i as CoreComponents } from './index-DppafVu4.js';
+export { createAnimationComponent, createAudioComponent, createBoneAttachmentComponent, createCameraComponent, createEntityTypeComponent, createEnvironmentComponent, createIKComponent, createImageComponent, createImageTargetAnchorComponent, createImageTargetComponent, createInstanceSlotComponent, createInstancedMeshComponent, createLightComponent, createMaterialComponent, createMeshComponent, createMeshGeometryComponent, createModelComponent, createNameComponent, createNetworkIdentityComponent, createNetworkSpawnerComponent, createNetworkTransformComponent, createNetworkedPropsComponent, createObject3DRefComponent, createParentIdComponent, createPhysicsComponent, createPostprocessingComponent, createScriptComponent, createScriptObjectComponent, createSelectableComponent, createSelectionTransformStateComponent, createSpriteComponent, createTransformComponent, createUIButtonComponent, createUIPanelComponent, createUISliderComponent, createUITextComponent, createUIToggleComponent, createVRTeleportAreaComponent, createVideoComponent, createXRAnchorComponent, createXRHandPoseComponent, createXRInteractableComponent, createXRInteractorComponent, createXRInteractorSideComponent, createXRRigComponent, registerDefaultComponentFactories, registerDefaultFactories } from './factories/index.js';
+import { GLTF, GLTFLoader } from 'three/examples/jsm/loaders/GLTFLoader.js';
 import { X as XrHandPoseDefinition, a as XrFinger, b as XrHandPoseOrientation, c as XrHandPoseDirection } from './handPose-DlcTtqgx.js';
 export { C as CURLED_COS, D as DEFAULT_DIRECTION_TOLERANCE, d as DEFAULT_ENTER_CONFIDENCE, e as DEFAULT_EXIT_CONFIDENCE, f as DEFAULT_LOST_GRACE_SECONDS, g as DEFAULT_MIN_HOLD_SECONDS, F as FALLBACK_HAND_SCALE, H as HandPoseTracker, h as HandPoseTrackerOptions, M as MATCH_FALLOFF, P as PINCH_FINGERS, S as STRAIGHT_COS, i as XR_FINGERS, j as XrFingerCurl, k as XrFingerTarget, l as XrHandJointName, m as XrHandJoints, n as XrHandPoseAxis, o as XrHandPoseContext, p as XrHandPoseEvent, q as XrHandPoseMatch, r as XrHandShape, s as XrPalmPose, t as computeFingerCurl, u as computeHandShape, v as computePalmPose, w as computePalmWidth, x as computePinch, y as computeSpread, z as estimateHandScale, A as matchHandPose } from './handPose-DlcTtqgx.js';
 import '@dimforge/rapier3d-compat';
+import './animation/index.js';
+import 'three/webgpu';
 
 interface CustomEcsSystem extends EcsSystem {
     data: Component | Record<string, unknown>;
@@ -170,6 +172,37 @@ declare class Behaviour implements CustomEcsSystem {
      * ```
      */
     spawnPrefab(source: SpawnPrefabSource, options?: SpawnPrefabOptions): Promise<number>;
+    /**
+     * The shared world, or `null` in a single-player run, so a script can work
+     * both ways:
+     *
+     * ```ts
+     * if (this.network && !this.network.isOwner) return; // someone else moves this
+     * ```
+     */
+    get network(): NetworkHandle | null;
+    /** Someone joined the room. `playerId` is their session id. */
+    onPlayerJoin(_playerId: string): void;
+    /** Someone left the room. */
+    onPlayerLeave(_playerId: string): void;
+    /** A shared value on this entity changed. */
+    onNetworkProp(_key: string, _value: NetValue): void;
+    /**
+     * Load a `.soundbank.json` asset so {@link Behaviour.playSlot} can play it.
+     * `source` is an asset path or an `AssetInput` field.
+     */
+    loadSoundBank(source: string | {
+        path: string;
+    }): Promise<void>;
+    /**
+     * Play a named sound from a loaded bank, as a random take. Returns whether it
+     * sounded: its chance, cooldown or priority may keep it quiet.
+     *
+     * ```ts
+     * this.playSlot("hit", { position: this.transform.position });
+     * ```
+     */
+    playSlot(id: string, options?: PlaySlotOptions): boolean;
     /**
      * Remove a spawned prefab instance (the root entity and all descendants).
      * Returns the number of entities removed.
@@ -453,6 +486,12 @@ declare class ScriptObject {
     dispose?(): void;
 }
 
+/**
+ * The default {@link RenderBackend}: three's `WebGLRenderer`, post-processing
+ * through `EffectComposer`, GLSL chroma key.
+ */
+declare const webglBackend: RenderBackend;
+
 type ComponentValueMaps = {
     object3DRefValues: Map<number, unknown>;
     nameValues: Map<number, unknown>;
@@ -481,6 +520,12 @@ type ComponentValueMaps = {
     xrInteractorValues: Map<number, unknown>;
     xrHandPoseValues: Map<number, unknown>;
     xrAnchorValues: Map<number, unknown>;
+    boneAttachmentValues: Map<number, unknown>;
+    ikValues: Map<number, unknown>;
+    networkIdentityValues: Map<number, unknown>;
+    networkTransformValues: Map<number, unknown>;
+    networkedPropsValues: Map<number, unknown>;
+    networkSpawnerValues: Map<number, unknown>;
     uiPanelValues: Map<number, unknown>;
     uiTextValues: Map<number, unknown>;
     uiButtonValues: Map<number, unknown>;
@@ -632,7 +677,7 @@ declare function collectDirectPrefabDependencies(snapshot: SubtreeSnapshot): str
 declare const NODE_KEY_SEPARATOR = "/";
 /**
  * Reserved override "component" marking a node ADDED by the host document
- * inside a nested instance region (`"<nodeKey>|+node|"`). File patching
+ * inside a nested instance region (`"&lt;nodeKey&gt;|+node|"`). File patching
  * trusts stored overrides (the old base is unavailable), so without the
  * marker a host-authored node inside the region would be indistinguishable
  * from a node the child prefab removed — and get deleted.
@@ -841,6 +886,63 @@ declare function sampleTeleportArc(origin: THREE.Vector3, direction: THREE.Vecto
  */
 declare function arcGroundCrossing(points: THREE.Vector3[], groundY: number): THREE.Vector3 | null;
 
+/** Sets a node's world rotation, keeping its position (children follow). */
+declare function setWorldQuaternion(o: THREE.Object3D, q: THREE.Quaternion): void;
+/**
+ * Two-bone IK: rotates `upper` and `lower` so `end`'s origin (the wrist or
+ * ankle) reaches `target`, bending toward `pole` (pass the animated
+ * elbow/knee position to keep the animation's style). Unreachable targets are
+ * reached for as far as the limb allows. Returns how far the end stayed from
+ * the target (0 when reachable).
+ */
+declare function twoBoneIK(upper: THREE.Object3D, lower: THREE.Object3D, end: THREE.Object3D, target: THREE.Vector3, pole: THREE.Vector3): number;
+/**
+ * World rotation for a hand gripping a bar along `axis` (unit), for hands
+ * whose bones run +X across the knuckles, +Y along the fingers and +Z out of
+ * the palm (the editor's fixed rigs). The back of the hand faces `back`
+ * (projected off the axis); the fingers continue away from the elbow
+ * (`forearm` = elbow → wrist).
+ */
+declare function gripQuaternion(axis: THREE.Vector3, back: THREE.Vector3, forearm: THREE.Vector3, out?: THREE.Quaternion): THREE.Quaternion;
+
+/**
+ * The one GLTFLoader setup for every model and clip the engine loads.
+ *
+ * - Draco (`KHR_draco_mesh_compression`): decoder files resolved per loader,
+ *   so a `setDracoDecoderPath()` override made after module load still
+ *   applies.
+ * - meshopt (`EXT_meshopt_compression`): what the editor's model optimiser
+ *   writes (gltf-transform + meshoptimizer, the pipeline the Akofena
+ *   characters shipped with). The decoder carries its wasm inline, so there
+ *   is no path to configure.
+ *
+ * Quantized meshes (`KHR_mesh_quantization`) and WebP textures
+ * (`EXT_texture_webp`) need no decoder: GLTFLoader reads them natively.
+ */
+declare function createGLTFLoader(): GLTFLoader;
+
+/**
+ * The volume groups every sound plays through: each sound's output goes to its
+ * bus instead of straight to the listener, so a game can turn music down
+ * without touching a single sound, and music dips while a voice plays.
+ */
+declare class AudioMixer {
+    readonly listener: THREE.AudioListener;
+    private readonly buses;
+    private readonly volumes;
+    private readonly routed;
+    constructor(listener: THREE.AudioListener);
+    /** The node a sound connects to for this bus. */
+    input(bus: AudioBus): GainNode;
+    /** Send a three.js sound through a bus. Does nothing when it's already there. */
+    route(sound: THREE.Audio<GainNode> | THREE.PositionalAudio, bus: AudioBus): void;
+    setVolume(bus: AudioBus, volume: number): void;
+    getVolume(bus: AudioBus): number;
+    /** Dip the music for `seconds`, then bring it back. A later duck replaces this one. */
+    duckMusic(seconds: number): void;
+    dispose(): void;
+}
+
 /**
  * Decides when a teleport may actually commit.
  *
@@ -1002,4 +1104,4 @@ declare class ThrowVelocityTracker {
  */
 declare function angularVelocityFrom(previous: THREE.Quaternion, current: THREE.Quaternion, deltaTime: number): THREE.Vector3;
 
-export { ADDED_NODE_MARKER_COMPONENT, ARC_GRAVITY, ARC_MAX_TIME, ARC_SPEED, ARC_STEPS, type ApplyPrefabToSnapshotResult, Behaviour, Component, type ComponentValueMaps, EcsEntityKind, EcsSystem, type EcsWorldComponentSnapshot, type EcsWorldStateSnapshotLike, EntityId, ExternalRefWarning, HAND_POSE_PRESETS, HAND_POSE_PRESET_IDS, HYDRATABLE_ENTITY_KINDS, type HandMaterialOptions, type HydrateOptions, type HydrateWorldFromSnapshotResult, type InstantiateSubtreeResult, MAX_PLAUSIBLE_SPEED, MAX_SAMPLE_AGE_SECONDS, NODE_KEY_SEPARATOR, type NestedRegion, type NodeKeyMaps, type NodeMaps, OVERRIDE_DIFF_EXCLUDED_COMPONENTS, OVERRIDE_ROOT_EXCLUDED_COMPONENTS, ObjectManagementSystem, ParentLookup, SHARED_MODEL_RESOURCE_FLAG, ScriptObject, type SerializeEntitySubtreeResult, SpawnPrefabOptions, SpawnPrefabSource, SubtreeSnapshot, TeleportAimGate, ThrowVelocityTracker, type UiInteractionEvent, VELOCITY_SAMPLES, type VelocitySample, World, WorldEntityView, XrCapabilities, XrFinger, XrHandPoseDefinition, XrHandPoseDirection, XrHandPoseEventDetail, XrHandPoseOrientation, XrInputState, angularVelocityFrom, applyHandMaterial, applyPrefabToSnapshotInstances, arcGroundCrossing, buildComponentValueMaps, buildNodeKeyMapsFromSnapshot, buildNodeMapsFromSnapshot, canonicalizeComponentValue, clearModelCache, cloneHandPose, collectDiffPaths, collectDirectPrefabDependencies, collectEntitySubtree, collectSnapshotSubtreeIds, computeInstanceOverrides, createHandMaterial, decanonicalizeComponentValue, encodeOverride, findSnapshotRootEntityIds, findTopLevelNestedRegions, getHandPosePreset, groupOverridePaths, handPoseFromCurls, hydrateWorldFromSnapshot, hydrateWorldFromSnapshotDetailed, indexSnapshotByEntity, instantiateSubtree, loadSharedGltf, mergeComponentValue, parseOverride, resolveDracoDecoderPath, restoreComponentState, restorePostCreateComponents, sampleTeleportArc, serializeEntitySubtree, setDracoDecoderPath };
+export { ADDED_NODE_MARKER_COMPONENT, ARC_GRAVITY, ARC_MAX_TIME, ARC_SPEED, ARC_STEPS, type ApplyPrefabToSnapshotResult, AudioBus, AudioMixer, Behaviour, Component, type ComponentValueMaps, EcsEntityKind, EcsSystem, type EcsWorldComponentSnapshot, type EcsWorldStateSnapshotLike, EntityId, ExternalRefWarning, HAND_POSE_PRESETS, HAND_POSE_PRESET_IDS, HYDRATABLE_ENTITY_KINDS, type HandMaterialOptions, type HydrateOptions, type HydrateWorldFromSnapshotResult, type InstantiateSubtreeResult, MAX_PLAUSIBLE_SPEED, MAX_SAMPLE_AGE_SECONDS, NODE_KEY_SEPARATOR, type NestedRegion, NetworkHandle, type NodeKeyMaps, type NodeMaps, OVERRIDE_DIFF_EXCLUDED_COMPONENTS, OVERRIDE_ROOT_EXCLUDED_COMPONENTS, ObjectManagementSystem, ParentLookup, PlaySlotOptions, RenderBackend, SHARED_MODEL_RESOURCE_FLAG, ScriptObject, type SerializeEntitySubtreeResult, SpawnPrefabOptions, SpawnPrefabSource, SubtreeSnapshot, TeleportAimGate, ThrowVelocityTracker, type UiInteractionEvent, VELOCITY_SAMPLES, type VelocitySample, World, WorldEntityView, XrCapabilities, XrFinger, XrHandPoseDefinition, XrHandPoseDirection, XrHandPoseEventDetail, XrHandPoseOrientation, XrInputState, angularVelocityFrom, applyHandMaterial, applyPrefabToSnapshotInstances, arcGroundCrossing, buildComponentValueMaps, buildNodeKeyMapsFromSnapshot, buildNodeMapsFromSnapshot, canonicalizeComponentValue, clearModelCache, cloneHandPose, collectDiffPaths, collectDirectPrefabDependencies, collectEntitySubtree, collectSnapshotSubtreeIds, computeInstanceOverrides, createGLTFLoader, createHandMaterial, decanonicalizeComponentValue, encodeOverride, findSnapshotRootEntityIds, findTopLevelNestedRegions, getHandPosePreset, gripQuaternion, groupOverridePaths, handPoseFromCurls, hydrateWorldFromSnapshot, hydrateWorldFromSnapshotDetailed, indexSnapshotByEntity, instantiateSubtree, loadSharedGltf, mergeComponentValue, parseOverride, resolveDracoDecoderPath, restoreComponentState, restorePostCreateComponents, sampleTeleportArc, serializeEntitySubtree, setDracoDecoderPath, setWorldQuaternion, twoBoneIK, webglBackend };