@relu-interactives/spatial-ecs 0.5.3 → 0.8.0

package/dist/{chunk-BUEKOSR5.js → chunk-NNDUOQ7O.js}

@@ -1,4 +1,5 @@
-import { __export, __name, Component } from './chunk-OY7ZODZP.js';
+import { Component } from './chunk-CKTHDXPS.js';
+import { __export, __name } from './chunk-XE4OXN2W.js';
 import * as THREE5 from 'three';
 import { Vector3, Euler, Quaternion } from 'three';
 
@@ -7,8 +8,10 @@ var components_exports = {};
 __export(components_exports, {
   AnimationComponent: () => AnimationComponent,
   AudioComponent: () => AudioComponent,
+  BoneAttachmentComponent: () => BoneAttachmentComponent,
   CameraComponent: () => CameraComponent,
   DEFAULT_COLLIDER_STATE: () => DEFAULT_COLLIDER_STATE,
+  DEFAULT_ENVIRONMENT_LIGHTING: () => DEFAULT_ENVIRONMENT_LIGHTING,
   DEFAULT_ENVIRONMENT_STATE: () => DEFAULT_ENVIRONMENT_STATE,
   DEFAULT_INSTANCED_MESH_PARAMETERS: () => DEFAULT_INSTANCED_MESH_PARAMETERS,
   DEFAULT_INSTANCE_TRANSFORM: () => DEFAULT_INSTANCE_TRANSFORM,
@@ -20,17 +23,23 @@ __export(components_exports, {
   DEFAULT_RIGIDBODY_STATE: () => DEFAULT_RIGIDBODY_STATE,
   EntityType: () => EntityType,
   Environment: () => Environment,
+  IKComponent: () => IKComponent,
   ImageComponent: () => ImageComponent,
   ImageTarget: () => ImageTarget,
   ImageTargetAnchor: () => ImageTargetAnchor,
   InstanceSlotComponent: () => InstanceSlotComponent,
   InstancedMeshComponent: () => InstancedMeshComponent,
   LightComponent: () => LightComponent,
+  MODEL_NO_PATH_MESSAGE: () => MODEL_NO_PATH_MESSAGE,
   MaterialComponent: () => MaterialComponent,
   MeshComponent: () => MeshComponent,
   MeshGeometryComponent: () => MeshGeometryComponent,
   ModelComponent: () => ModelComponent,
   Name: () => Name,
+  NetworkIdentityComponent: () => NetworkIdentityComponent,
+  NetworkSpawnerComponent: () => NetworkSpawnerComponent,
+  NetworkTransformComponent: () => NetworkTransformComponent,
+  NetworkedPropsComponent: () => NetworkedPropsComponent,
   Object3DRef: () => Object3DRef,
   ParentId: () => ParentId,
   PhysicsComponent: () => PhysicsComponent,
@@ -61,7 +70,10 @@ __export(components_exports, {
   createHandPoseEntry: () => createHandPoseEntry,
   defaultMaterialValue: () => defaultMaterialValue,
   handPoseDefinitionFor: () => handPoseDefinitionFor,
+  normalizeEnvironmentLighting: () => normalizeEnvironmentLighting,
+  normalizeIKChain: () => normalizeIKChain,
   normalizePhysicsState: () => normalizePhysicsState,
+  setModelLoadState: () => setModelLoadState,
   setPhysicsLiveRef: () => setPhysicsLiveRef
 });
 
@@ -575,7 +587,8 @@ var DEFAULT_AUDIO_OPTIONS = {
   positional: false,
   refDistance: 1,
   distanceModel: "inverse",
-  rolloffFactor: 1
+  rolloffFactor: 1,
+  bus: "sfx"
 };
 var _AudioComponent = class _AudioComponent extends Component {
   constructor(path, options = {}) {
@@ -631,6 +644,16 @@ __name(_AudioComponent, "AudioComponent");
 var AudioComponent = _AudioComponent;
 
 // core/components/Environment.ts
+var DEFAULT_ENVIRONMENT_LIGHTING = {
+  envMapUrl: "",
+  envIntensity: 1,
+  envRotationY: 0,
+  useAsBackground: false,
+  backgroundBlurriness: 0,
+  backgroundIntensity: 1,
+  toneMapping: "none",
+  exposure: 1
+};
 var DEFAULT_ENVIRONMENT_STATE = {
   skybox: {
     type: "none",
@@ -703,22 +726,62 @@ function toFiniteNumber(value, fallback) {
   return value;
 }
 __name(toFiniteNumber, "toFiniteNumber");
+function normalizeImageProjection(value) {
+  return value === "screen" || value === "equirect" ? value : void 0;
+}
+__name(normalizeImageProjection, "normalizeImageProjection");
+function normalizeToneMapping(value) {
+  if (value === "none" || value === "aces" || value === "agx" || value === "neutral") {
+    return value;
+  }
+  return DEFAULT_ENVIRONMENT_LIGHTING.toneMapping;
+}
+__name(normalizeToneMapping, "normalizeToneMapping");
+function normalizeEnvironmentLighting(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    return void 0;
+  }
+  const lighting = value;
+  const defaults = DEFAULT_ENVIRONMENT_LIGHTING;
+  return {
+    envMapUrl: typeof lighting.envMapUrl === "string" ? lighting.envMapUrl : defaults.envMapUrl,
+    envIntensity: Math.max(0, toFiniteNumber(lighting.envIntensity, defaults.envIntensity)),
+    envRotationY: toFiniteNumber(lighting.envRotationY, defaults.envRotationY),
+    useAsBackground: typeof lighting.useAsBackground === "boolean" ? lighting.useAsBackground : defaults.useAsBackground,
+    backgroundBlurriness: Math.min(
+      1,
+      Math.max(0, toFiniteNumber(lighting.backgroundBlurriness, defaults.backgroundBlurriness))
+    ),
+    backgroundIntensity: Math.max(
+      0,
+      toFiniteNumber(lighting.backgroundIntensity, defaults.backgroundIntensity)
+    ),
+    toneMapping: normalizeToneMapping(lighting.toneMapping),
+    exposure: Math.max(0, toFiniteNumber(lighting.exposure, defaults.exposure))
+  };
+}
+__name(normalizeEnvironmentLighting, "normalizeEnvironmentLighting");
 var _Environment = class _Environment extends Component {
   constructor(values) {
     super();
     const skybox = values?.skybox;
     const fog = values?.fog;
     const gravity = values?.gravity;
+    const skyboxState = {
+      type: normalizeSkyboxType(skybox?.type),
+      color: typeof skybox?.color === "string" ? skybox.color : DEFAULT_ENVIRONMENT_STATE.skybox.color,
+      imageUrl: typeof skybox?.imageUrl === "string" ? skybox.imageUrl : DEFAULT_ENVIRONMENT_STATE.skybox.imageUrl,
+      gradient: {
+        colors: normalizeColors(skybox?.gradient?.colors),
+        effect: normalizeGradientEffect(skybox?.gradient?.effect)
+      }
+    };
+    const imageProjection = normalizeImageProjection(skybox?.imageProjection);
+    if (imageProjection) {
+      skyboxState.imageProjection = imageProjection;
+    }
     this.values = {
-      skybox: {
-        type: normalizeSkyboxType(skybox?.type),
-        color: typeof skybox?.color === "string" ? skybox.color : DEFAULT_ENVIRONMENT_STATE.skybox.color,
-        imageUrl: typeof skybox?.imageUrl === "string" ? skybox.imageUrl : DEFAULT_ENVIRONMENT_STATE.skybox.imageUrl,
-        gradient: {
-          colors: normalizeColors(skybox?.gradient?.colors),
-          effect: normalizeGradientEffect(skybox?.gradient?.effect)
-        }
-      },
+      skybox: skyboxState,
       fog: {
         type: normalizeFogType(fog?.type),
         color: typeof fog?.color === "string" ? fog.color : DEFAULT_ENVIRONMENT_STATE.fog.color,
@@ -749,6 +812,10 @@ var _Environment = class _Environment extends Component {
         DEFAULT_ENVIRONMENT_STATE.fixedTimeStep
       )
     };
+    const lighting = normalizeEnvironmentLighting(values?.lighting);
+    if (lighting) {
+      this.values.lighting = lighting;
+    }
   }
 };
 __name(_Environment, "Environment");
@@ -1616,11 +1683,32 @@ __name(_MeshComponent, "MeshComponent");
 var MeshComponent = _MeshComponent;
 
 // core/components/Model.ts
+var MODEL_NO_PATH_MESSAGE = "No model path set.";
+function setModelLoadState(component, state, error) {
+  Object.defineProperty(component, "loadState", {
+    value: state,
+    writable: true,
+    configurable: true,
+    enumerable: false
+  });
+  Object.defineProperty(component, "loadError", {
+    value: state === "error" ? error ?? "Failed to load model." : void 0,
+    writable: true,
+    configurable: true,
+    enumerable: false
+  });
+}
+__name(setModelLoadState, "setModelLoadState");
 var _ModelComponent = class _ModelComponent extends Component {
   constructor(path) {
     super();
     this.path = path;
     this.object = null;
+    if (path) {
+      setModelLoadState(this, "loading");
+    } else {
+      setModelLoadState(this, "error", MODEL_NO_PATH_MESSAGE);
+    }
   }
 };
 __name(_ModelComponent, "ModelComponent");
@@ -2039,6 +2127,92 @@ var _XRAnchorComponent = class _XRAnchorComponent extends Component {
 __name(_XRAnchorComponent, "XRAnchorComponent");
 var XRAnchorComponent = _XRAnchorComponent;
 
+// core/components/BoneAttachment.ts
+var _BoneAttachmentComponent = class _BoneAttachmentComponent extends Component {
+  constructor(options) {
+    super();
+    this.bone = options?.bone ?? "";
+    this.humanoid = options?.humanoid ?? null;
+    this.compensateScale = options?.compensateScale ?? true;
+    this.enabled = options?.enabled ?? true;
+  }
+};
+__name(_BoneAttachmentComponent, "BoneAttachmentComponent");
+var BoneAttachmentComponent = _BoneAttachmentComponent;
+
+// core/components/Network.ts
+var _NetworkIdentityComponent = class _NetworkIdentityComponent extends Component {
+  constructor() {
+    super();
+    for (const key of ["networkId", "owner"]) {
+      Object.defineProperty(this, key, {
+        value: "",
+        writable: true,
+        configurable: true,
+        enumerable: false
+      });
+    }
+  }
+};
+__name(_NetworkIdentityComponent, "NetworkIdentityComponent");
+var NetworkIdentityComponent = _NetworkIdentityComponent;
+var _NetworkTransformComponent = class _NetworkTransformComponent extends Component {
+  constructor(options = {}) {
+    super();
+    this.enabled = true;
+    /** Updates per second the owner sends. */
+    this.sendRate = 20;
+    /** How far in the past others see it, in ms. More is smoother; less is more current. */
+    this.interpolationMs = 100;
+    this.syncRotation = true;
+    /** A jump longer than this (m) snaps instead of sliding, for respawns and teleports. */
+    this.teleportDistance = 5;
+    Object.assign(this, options);
+  }
+};
+__name(_NetworkTransformComponent, "NetworkTransformComponent");
+var NetworkTransformComponent = _NetworkTransformComponent;
+var _NetworkedPropsComponent = class _NetworkedPropsComponent extends Component {
+  constructor(values = {}) {
+    super();
+    this.values = values;
+  }
+};
+__name(_NetworkedPropsComponent, "NetworkedPropsComponent");
+var NetworkedPropsComponent = _NetworkedPropsComponent;
+var _NetworkSpawnerComponent = class _NetworkSpawnerComponent extends Component {
+  constructor(playerPrefab = "", spawnRadius = 2) {
+    super();
+    this.playerPrefab = playerPrefab;
+    this.spawnRadius = spawnRadius;
+  }
+};
+__name(_NetworkSpawnerComponent, "NetworkSpawnerComponent");
+var NetworkSpawnerComponent = _NetworkSpawnerComponent;
+
+// core/components/IK.ts
+function normalizeIKChain(chain) {
+  const weight = typeof chain.weight === "number" && Number.isFinite(chain.weight) ? chain.weight : 1;
+  return {
+    limb: chain.limb,
+    target: typeof chain.target === "number" ? chain.target : null,
+    pole: typeof chain.pole === "number" ? chain.pole : null,
+    weight: Math.min(1, Math.max(0, weight)),
+    matchRotation: chain.matchRotation ?? false,
+    enabled: chain.enabled ?? true
+  };
+}
+__name(normalizeIKChain, "normalizeIKChain");
+var _IKComponent = class _IKComponent extends Component {
+  constructor(options) {
+    super();
+    this.chains = (options?.chains ?? []).map(normalizeIKChain);
+    this.enabled = options?.enabled ?? true;
+  }
+};
+__name(_IKComponent, "IKComponent");
+var IKComponent = _IKComponent;
+
 // core/components/UIPanel.ts
 var _UIPanelComponent = class _UIPanelComponent extends Component {
   constructor(options) {
@@ -2391,6 +2565,6 @@ var _XRHandPoseComponent = class _XRHandPoseComponent extends Component {
 __name(_XRHandPoseComponent, "XRHandPoseComponent");
 var XRHandPoseComponent = _XRHandPoseComponent;
 
-export { AnimationComponent, AnimationStateMachine, AnimationStateManager, AudioComponent, CameraComponent, DEFAULT_COLLIDER_STATE, DEFAULT_ENVIRONMENT_STATE, DEFAULT_INSTANCED_MESH_PARAMETERS, DEFAULT_INSTANCE_TRANSFORM, DEFAULT_MESH_GEOMETRY_PARAMETERS, DEFAULT_PHYSICS_STATE, DEFAULT_POSE_CURLS, DEFAULT_POSE_DIRECTIONS, DEFAULT_POSTPROCESSING_STATE, DEFAULT_RIGIDBODY_STATE, EntityType, Environment, HAND_POSE_PRESETS, HAND_POSE_PRESET_IDS, ImageComponent, ImageTarget, ImageTargetAnchor, InstanceSlotComponent, InstancedMeshComponent, LightComponent, MaterialComponent, MeshComponent, MeshGeometryComponent, ModelComponent, Name, Object3DRef, ParentId, PhysicsComponent, Postprocessing, PrefabInstance, PrefabNode, ScriptComponent, ScriptObjectComponent, Selectable, SelectionTransformState, SpriteComponent, TransformComponent, UIButtonComponent, UIPanelComponent, UISliderComponent, UITextComponent, UIToggleComponent, VRTeleportAreaComponent, VideoComponent, XRAnchorComponent, XREnvironmentComponent, XRHandPoseComponent, XRInteractableComponent, XRInteractorComponent, XRInteractorSideComponent, XRRigComponent, cloneHandPose, components_exports, createAttachPoint, createHandPoseEntry, defaultMaterialValue, getHandPosePreset, handPoseDefinitionFor, handPoseFromCurls, normalizePhysicsState, setPhysicsLiveRef };
-//# sourceMappingURL=chunk-BUEKOSR5.js.map
-//# sourceMappingURL=chunk-BUEKOSR5.js.map
+export { AnimationComponent, AnimationStateMachine, AnimationStateManager, AudioComponent, BoneAttachmentComponent, CameraComponent, DEFAULT_COLLIDER_STATE, DEFAULT_ENVIRONMENT_LIGHTING, DEFAULT_ENVIRONMENT_STATE, DEFAULT_INSTANCED_MESH_PARAMETERS, DEFAULT_INSTANCE_TRANSFORM, DEFAULT_MESH_GEOMETRY_PARAMETERS, DEFAULT_PHYSICS_STATE, DEFAULT_POSE_CURLS, DEFAULT_POSE_DIRECTIONS, DEFAULT_POSTPROCESSING_STATE, DEFAULT_RIGIDBODY_STATE, EntityType, Environment, HAND_POSE_PRESETS, HAND_POSE_PRESET_IDS, IKComponent, ImageComponent, ImageTarget, ImageTargetAnchor, InstanceSlotComponent, InstancedMeshComponent, LightComponent, MODEL_NO_PATH_MESSAGE, MaterialComponent, MeshComponent, MeshGeometryComponent, ModelComponent, Name, NetworkIdentityComponent, NetworkSpawnerComponent, NetworkTransformComponent, NetworkedPropsComponent, Object3DRef, ParentId, PhysicsComponent, Postprocessing, PrefabInstance, PrefabNode, ScriptComponent, ScriptObjectComponent, Selectable, SelectionTransformState, SpriteComponent, TransformComponent, UIButtonComponent, UIPanelComponent, UISliderComponent, UITextComponent, UIToggleComponent, VRTeleportAreaComponent, VideoComponent, XRAnchorComponent, XREnvironmentComponent, XRHandPoseComponent, XRInteractableComponent, XRInteractorComponent, XRInteractorSideComponent, XRRigComponent, cloneHandPose, components_exports, createAttachPoint, createHandPoseEntry, defaultMaterialValue, getHandPosePreset, handPoseDefinitionFor, handPoseFromCurls, normalizeEnvironmentLighting, normalizeIKChain, normalizePhysicsState, setModelLoadState, setPhysicsLiveRef };
+//# sourceMappingURL=chunk-NNDUOQ7O.js.map
+//# sourceMappingURL=chunk-NNDUOQ7O.js.map