@holoscript/core 6.1.3 → 8.0.0

package/dist/{chunk-EOBB6A4B.js → chunk-RVBHAXFG.js}

@@ -4,33 +4,15 @@ import { botanicalLotusHandler } from './chunk-VECQYRXL.js';
 import { SimulationSolverFactory } from './chunk-YQELFNJV.js';
 import { createTensor, createNoOpInferenceAdapter, add, matmul } from './chunk-FHP6LXJS.js';
 import { absorbHandler, hotReloadHandler, scriptTestHandler } from './chunk-2M2DPHKB.js';
-import { mitosisHandler, embeddingHandler, jepObjectiveHandler, orbitalHandler } from './chunk-77V4GTCA.js';
+import { mitosisHandler, embeddingHandler, jepObjectiveHandler, orbitalHandler } from './chunk-H652NHX5.js';
 import { logger } from './chunk-PHENW4MQ.js';
 import { init_safeJsonParse, readJson } from './chunk-VVKVQZI6.js';
 import { __require } from './chunk-OL46QLBJ.js';
-import { getNavigationEngine } from '@holoscript/engine/runtime/NavigationEngine';
-import { getVoiceSynthesizer, voiceSynthesizerRegistry } from '@holoscript/engine/runtime/VoiceSynthesizer';
-import { getEmotionDetector } from '@holoscript/engine/runtime/EmotionDetector';
-import { getPhysicsEngine } from '@holoscript/engine/runtime/PhysicsEngine';
-import { IslandDetector } from '@holoscript/engine/physics/IslandDetector';
-import { SoftBodyAdapter } from '@holoscript/engine/physics/SoftBodyAdapter';
-import { MLSMPMFluid } from '@holoscript/engine/physics/MLSMPMFluid';
-import { weatherBlackboard } from '@holoscript/engine/environment/WeatherBlackboard';
-import { SoftBodySolver } from '@holoscript/engine/physics/SoftBodySolver';
-import { ChoreographyPlanner, ChoreographyEngine } from '@holoscript/engine/choreography';
-import { getNegotiationProtocol, getTrustWeight } from '@holoscript/framework/negotiation';
-import { SYNC_TIER_RATES, WebRTCTransport, WebSocketTransport, RaftConsensus, ConsensusManager, SyncProtocol } from '@holoscript/mesh';
-import { getDefaultRegistry } from '@holoscript/framework/agents';
-import { getMQTTClient, createMQTTClient, registerMQTTClient, MQTTClient } from '@holoscript/engine/runtime/protocols/MQTTClient';
-import { BoneSystem } from '@holoscript/engine/animation/BoneSystem';
-import { IKSolver } from '@holoscript/engine/animation/IKSolver';
-import { AvatarController } from '@holoscript/engine/animation/AvatarController';
-import { getDefaultAIAdapter } from '@holoscript/framework/ai';
-import { SpringAnimator, SpringPresets } from '@holoscript/engine/animation/SpringAnimator';
 import { EventEmitter } from 'events';
-import { DEFAULT_SPATIAL_CONFIG, SpatialContextProvider } from '@holoscript/engine/spatial';
 import { jwtVerify, SignJWT } from 'jose';
 
+// src/traits/FlowFieldTrait.ts
+var _navigationEngine = null;
 function toTuple(v) {
   if (Array.isArray(v)) return v;
   return [v[0] ?? 0, v[1] ?? 0, v[2] ?? 0];
@@ -53,9 +35,11 @@ var flowFieldHandler = {
   onDetach(node) {
     delete node.__flowFieldState;
   },
-  onUpdate(node, config, context, delta) {
+  async onUpdate(node, config, context, delta) {
     const state = node.__flowFieldState;
     if (!state || !config.destinationId) return;
+    _navigationEngine ?? (_navigationEngine = await import('@holoscript/engine/runtime/NavigationEngine'));
+    const { getNavigationEngine } = _navigationEngine;
     const navEngine = getNavigationEngine("gpu_flowfield") || getNavigationEngine("default");
     if (!navEngine) return;
     const currentPos = toTuple(node.properties?.position || [0, 0, 0]);
@@ -964,6 +948,9 @@ var rbacHandler = {
     }
   }
 };
+
+// src/traits/EmotionalVoiceTrait.ts
+var _voiceSynthesizer = null;
 var emotionalVoiceHandler = {
   name: "emotional_voice",
   defaultConfig: {
@@ -1001,6 +988,8 @@ var emotionalVoiceHandler = {
   }
 };
 emotionalVoiceHandler.handleSpeak = async function(node, config, state, request) {
+  _voiceSynthesizer ?? (_voiceSynthesizer = await import('@holoscript/engine/runtime/VoiceSynthesizer'));
+  const { getVoiceSynthesizer, voiceSynthesizerRegistry } = _voiceSynthesizer;
   const synthesizer = getVoiceSynthesizer("default") || Array.from(voiceSynthesizerRegistry.values())[0];
   if (!synthesizer) {
     console.warn("No VoiceSynthesizer registered. Skipping speech for", node.name);
@@ -1031,8 +1020,13 @@ emotionalVoiceHandler.handleSpeak = async function(node, config, state, request)
     request
   });
 };
+
+// src/traits/UserMonitorTrait.ts
+var _emotionDetector = null;
 var traitState = /* @__PURE__ */ new WeakMap();
-function performInference(node, config, _context, state) {
+async function performInference(node, config, _context, state) {
+  _emotionDetector ?? (_emotionDetector = await import('@holoscript/engine/runtime/EmotionDetector'));
+  const { getEmotionDetector } = _emotionDetector;
   const detector = getEmotionDetector("default") || getEmotionDetector("lite");
   if (!detector) return;
   const headStability = calculateStability(state.headPositions);
@@ -1077,7 +1071,7 @@ var userMonitorHandler = {
     traitState.delete(node);
     delete node.__userMonitorState;
   },
-  onUpdate(node, config, context, delta) {
+  async onUpdate(node, config, context, delta) {
     const state = traitState.get(node);
     if (!state) return;
     const headPos = context.vr.headset.position;
@@ -1098,7 +1092,7 @@ var userMonitorHandler = {
     state.lastInferenceTime += delta;
     if (state.lastInferenceTime >= (config.updateRate ?? 0.2)) {
       state.lastInferenceTime = 0;
-      performInference(node, config, context, state);
+      await performInference(node, config, context, state);
     }
   },
   onEvent(node, config, context, event) {
@@ -7055,6 +7049,11 @@ var gpuParticleHandler = {
     }
   }
 };
+
+// src/traits/GPUPhysicsTrait.ts
+var _physicsEngineModule = null;
+var _islandDetectorModule = null;
+var _softBodyAdapterModule = null;
 function extractPosition(node) {
   const pos = node?.properties?.position ?? node?.position;
   if (Array.isArray(pos) && pos.length >= 3) {
@@ -7079,8 +7078,12 @@ var gpuPhysicsHandler = {
     restitution: 0.3,
     isStatic: false
   },
-  onAttach(node, config, _context) {
+  async onAttach(node, config, _context) {
+    _islandDetectorModule ?? (_islandDetectorModule = await import('@holoscript/engine/physics/IslandDetector'));
+    const { IslandDetector } = _islandDetectorModule;
     if (config.sim_type === "soft_body") {
+      _softBodyAdapterModule ?? (_softBodyAdapterModule = await import('@holoscript/engine/physics/SoftBodyAdapter'));
+      const { SoftBodyAdapter } = _softBodyAdapterModule;
       const softBody = new SoftBodyAdapter(node, config);
       node.__gpuPhysicsState = {
         engineId: "soft_body_solver",
@@ -7091,6 +7094,8 @@ var gpuPhysicsHandler = {
       };
       return;
     }
+    _physicsEngineModule ?? (_physicsEngineModule = await import('@holoscript/engine/runtime/PhysicsEngine'));
+    const { getPhysicsEngine } = _physicsEngineModule;
     const engine = getPhysicsEngine("webgpu") || getPhysicsEngine("default");
     if (!engine) {
       console.warn("No GPU PhysicsEngine found. Physics will be disabled for", node.name);
@@ -7115,23 +7120,27 @@ var gpuPhysicsHandler = {
       restitution: config.restitution
     });
   },
-  onDetach(node) {
+  async onDetach(node) {
     const state = node.__gpuPhysicsState;
     if (state) {
       if (state.softBody) ; else {
+        _physicsEngineModule ?? (_physicsEngineModule = await import('@holoscript/engine/runtime/PhysicsEngine'));
+        const { getPhysicsEngine } = _physicsEngineModule;
         const engine = getPhysicsEngine(state.engineId);
         engine?.removeBody(node.name || "");
       }
       delete node.__gpuPhysicsState;
     }
   },
-  onUpdate(node, _config, _context, _delta) {
+  async onUpdate(node, _config, _context, _delta) {
     const state = node.__gpuPhysicsState;
     if (!state || !state.isSimulating) return;
     if (state.softBody) {
       state.softBody.update(_delta);
       return;
     }
+    _physicsEngineModule ?? (_physicsEngineModule = await import('@holoscript/engine/runtime/PhysicsEngine'));
+    const { getPhysicsEngine } = _physicsEngineModule;
     const engine = getPhysicsEngine(state.engineId);
     if (!engine) return;
     const states = engine.getStates();
@@ -7141,12 +7150,14 @@ var gpuPhysicsHandler = {
       node.rotation = bodyState.rotation;
     }
   },
-  onEvent(node, config, context, event) {
+  async onEvent(node, config, context, event) {
     const state = node.__gpuPhysicsState;
     if (!state) return;
     const eventType = typeof event === "string" ? event : event.type;
     if (eventType === "apply-force") {
       if (state.softBody) ; else {
+        _physicsEngineModule ?? (_physicsEngineModule = await import('@holoscript/engine/runtime/PhysicsEngine'));
+        const { getPhysicsEngine } = _physicsEngineModule;
         const engine = getPhysicsEngine(state.engineId || "webgpu");
         engine?.applyForce(
           node.name || "",
@@ -16771,6 +16782,10 @@ function initializeClothMesh(state, config) {
     }
   }
 }
+
+// src/traits/FluidTrait.ts
+var _mlsMpmModule = null;
+var _weatherModule = null;
 var fluidHandler = {
   name: "fluid",
   defaultConfig: {
@@ -16793,7 +16808,7 @@ var fluidHandler = {
     absorption_color: [0.4, 0.04, 0],
     absorption_strength: 2
   },
-  onAttach(node, config, context) {
+  async onAttach(node, config, context) {
     const state = {
       isSimulating: false,
       particleCount: 0,
@@ -16809,6 +16824,8 @@ var fluidHandler = {
     };
     node.__fluidState = state;
     if (config.method === "mls_mpm" && context.gpuDevice) {
+      _mlsMpmModule ?? (_mlsMpmModule = await import('@holoscript/engine/physics/MLSMPMFluid'));
+      const { MLSMPMFluid } = _mlsMpmModule;
       const sim = new MLSMPMFluid({
         type: "liquid",
         particleCount: config.particle_count,
@@ -16857,10 +16874,12 @@ var fluidHandler = {
     }
     delete node.__fluidState;
   },
-  onUpdate(node, config, context, delta) {
+  async onUpdate(node, config, context, delta) {
     const state = node.__fluidState;
     if (!state || !state.isSimulating) return;
     if (state.mlsMpm && state.gpuReady) {
+      _weatherModule ?? (_weatherModule = await import('@holoscript/engine/environment/WeatherBlackboard'));
+      const { weatherBlackboard } = _weatherModule;
       if (config.wind_sensitivity > 0 && weatherBlackboard.wind_speed > 0) {
         const s = config.wind_sensitivity;
         const wv = weatherBlackboard.wind_vector;
@@ -16978,6 +16997,9 @@ var fluidHandler = {
     }
   }
 };
+
+// src/traits/SoftBodyTrait.ts
+var _softBodySolverModule = null;
 function autoPopulateFromMesh(node, config) {
   const meshData = node.properties?.meshData;
   if (!meshData || !meshData.positions || !meshData.indices) {
@@ -17039,7 +17061,7 @@ var softBodyHandler = {
     surface_stiffness: 0.5,
     bending_stiffness: 0.3
   },
-  onAttach(node, config, context) {
+  async onAttach(node, config, context) {
     const state = {
       isSimulating: false,
       isDeformed: false,
@@ -17051,6 +17073,8 @@ var softBodyHandler = {
       solver: null
     };
     node.__softBodyState = state;
+    _softBodySolverModule ?? (_softBodySolverModule = await import('@holoscript/engine/physics/SoftBodySolver'));
+    const { SoftBodySolver } = _softBodySolverModule;
     const { particles, constraints } = autoPopulateFromMesh(node, config);
     state.solver = new SoftBodySolver(particles, constraints);
     state.isSimulating = true;
@@ -18632,6 +18656,9 @@ var layerAwareHandler = {
   onUpdate(node, config, context, _delta) {
   }
 };
+
+// src/traits/ChoreographyTrait.ts
+var _choreography = null;
 var DEFAULT_CHOREOGRAPHY_CONFIG = {
   mode: "participant",
   auto_start: true,
@@ -18670,7 +18697,9 @@ function addEvent(state, type, planId, config, stepId) {
 var choreographyHandler = {
   name: "choreography",
   defaultConfig: DEFAULT_CHOREOGRAPHY_CONFIG,
-  onAttach(node, config, _context) {
+  async onAttach(node, config, _context) {
+    _choreography ?? (_choreography = await import('@holoscript/engine/choreography'));
+    const { ChoreographyEngine, ChoreographyPlanner } = _choreography;
     const cfg = { ...DEFAULT_CHOREOGRAPHY_CONFIG, ...config };
     const state = createDefaultState();
     state.mode = cfg.mode;
@@ -18729,6 +18758,9 @@ var choreographyHandler = {
     delete n.__choreography_state;
   }
 };
+
+// src/traits/NegotiationTrait.ts
+var _negotiationMod = null;
 var DEFAULT_NEGOTIATION_CONFIG = {
   role: "participant",
   default_mechanism: "majority",
@@ -18801,6 +18833,8 @@ async function autoVoteInternal(node, sessionId, config) {
     default:
       return null;
   }
+  _negotiationMod ?? (_negotiationMod = await import('@holoscript/framework/negotiation'));
+  const { getTrustWeight } = _negotiationMod;
   const voteResult = await state.protocol.vote(sessionId, {
     agentId: state.agentId,
     ranking,
@@ -18818,12 +18852,14 @@ async function autoVoteInternal(node, sessionId, config) {
 var negotiationHandler = {
   name: "negotiation",
   defaultConfig: DEFAULT_NEGOTIATION_CONFIG,
-  onAttach(node, config, _context) {
+  async onAttach(node, config, _context) {
     const cfg = { ...DEFAULT_NEGOTIATION_CONFIG, ...config };
     const state = createDefaultState2();
     state.role = cfg.role;
     state.agentId = cfg.agent_id || node.id || `agent-${Date.now()}`;
     node.__negotiation_state = state;
+    _negotiationMod ?? (_negotiationMod = await import('@holoscript/framework/negotiation'));
+    const { getNegotiationProtocol } = _negotiationMod;
     state.protocol = getNegotiationProtocol();
     const unsub1 = state.protocol.on("sessionStarted", ({ session }) => {
       if (session.participants.includes(state.agentId)) {
@@ -18911,6 +18947,8 @@ async function vote(node, sessionId, ranking, options) {
   if (state.role === "observer") {
     throw new Error("Observers cannot vote");
   }
+  _negotiationMod ?? (_negotiationMod = await import('@holoscript/framework/negotiation'));
+  const { getTrustWeight } = _negotiationMod;
   const voteResult = await state.protocol.vote(sessionId, {
     agentId: state.agentId,
     ranking,
@@ -19033,9 +19071,14 @@ function getNegotiationMethods(node) {
     leave: (sessionId) => leave(node, sessionId)
   };
 }
+
+// src/traits/NetworkedTrait.ts
 init_safeJsonParse();
+var _mesh = null;
 var syncProtocolPool = /* @__PURE__ */ new Map();
-function getOrCreateSyncProtocol(roomId, transport = "local", serverUrl) {
+async function getOrCreateSyncProtocol(roomId, transport = "local", serverUrl) {
+  _mesh ?? (_mesh = await import('@holoscript/mesh'));
+  const { SyncProtocol } = _mesh;
   const isTestEnv = process.env.NODE_ENV === "test" || !!process.env.VITEST;
   if (isTestEnv) {
     return new SyncProtocol({
@@ -19105,6 +19148,8 @@ var NetworkedTrait = class {
    */
   async connect(transport = "local", serverUrl) {
     const roomId = this.config.room || "default-room";
+    _mesh ?? (_mesh = await import('@holoscript/mesh'));
+    const { WebRTCTransport, WebSocketTransport } = _mesh;
     if (transport === "auto" && serverUrl) {
       try {
         this.rtcTransport = new WebRTCTransport(serverUrl);
@@ -19171,7 +19216,7 @@ var NetworkedTrait = class {
         logger.warn(`[NetworkedTrait] WebRTC connection failed, using local sync: ${error}`);
       }
     }
-    this.syncProtocol = getOrCreateSyncProtocol(roomId, "local", serverUrl);
+    this.syncProtocol = await getOrCreateSyncProtocol(roomId, "local", serverUrl);
     this.syncProtocol.on("state-updated", (event) => {
       const data = event.data;
       if (data.entityId === this.entityId && !this.isOwner) {
@@ -19724,6 +19769,9 @@ function createNetworkedTrait(config) {
     ...config
   });
 }
+
+// src/traits/NetworkedTraitHandler.ts
+var _mesh2 = null;
 var handlerStates = /* @__PURE__ */ new Map();
 function getNodeKey(node) {
   return node.id || `__anon_${Math.random().toString(36).slice(2, 8)}`;
@@ -19833,11 +19881,13 @@ var networkedHandler = {
   // ===========================================================================
   // onUpdate — per-frame sync
   // ===========================================================================
-  onUpdate(node, config, context, delta) {
+  async onUpdate(node, config, context, delta) {
     const key = getNodeKey(node);
     const state = handlerStates.get(key);
     if (!state || !state.registered) return;
     const trait = state.trait;
+    _mesh2 ?? (_mesh2 = await import('@holoscript/mesh'));
+    const { SYNC_TIER_RATES } = _mesh2;
     const baseSyncRate = SYNC_TIER_RATES[config.syncTier] ?? config.syncRate;
     const effectiveRate = baseSyncRate * state.priorityWeight;
     const syncIntervalMs = effectiveRate > 0 ? 1e3 / effectiveRate : Infinity;
@@ -24819,6 +24869,9 @@ function average(values) {
 function round(value) {
   return Math.round(value * 1e6) / 1e6;
 }
+
+// src/traits/AgentDiscoveryTrait.ts
+var _frameworkAgents = null;
 function generateAgentId() {
   return `agent_${Date.now()}_${Math.random().toString(36).substring(2, 11)}`;
 }
@@ -24866,7 +24919,9 @@ var agentDiscoveryHandler = {
     registry_config: null,
     tags: []
   },
-  onAttach(node, config, context) {
+  async onAttach(node, config, context) {
+    _frameworkAgents ?? (_frameworkAgents = await import('@holoscript/framework/agents'));
+    const { getDefaultRegistry } = _frameworkAgents;
     const state = {
       registrationStatus: "unregistered",
       manifest: null,
@@ -29576,6 +29631,9 @@ var messagingHandler = {
     });
   }
 };
+
+// src/traits/MQTTSinkTrait.ts
+var _mqttClientMod = null;
 var defaultConfig = {
   broker: "mqtt://localhost:1883",
   topic: "holoscript/{nodeId}/state",
@@ -29589,7 +29647,7 @@ var defaultConfig = {
 var mqttSinkHandler = {
   name: "mqtt_sink",
   defaultConfig,
-  onAttach(node, config, context) {
+  async onAttach(node, config, context) {
     const state = {
       connected: false,
       publishCount: 0,
@@ -29599,6 +29657,8 @@ var mqttSinkHandler = {
       lastStateHash: null
     };
     node.__mqttSinkState = state;
+    _mqttClientMod ?? (_mqttClientMod = await import('@holoscript/engine/runtime/protocols/MQTTClient'));
+    const { createMQTTClient, getMQTTClient, registerMQTTClient } = _mqttClientMod;
     const clientKey = `${config.broker}_${config.clientId || "default"}`;
     let client = getMQTTClient(clientKey);
     if (!client) {
@@ -29754,6 +29814,9 @@ function publishToMQTTSink(node, payload, topic) {
     }
   );
 }
+
+// src/traits/MQTTSourceTrait.ts
+var _mqttClientMod2 = null;
 var defaultConfig2 = {
   broker: "mqtt://localhost:1883",
   topic: "#",
@@ -29765,7 +29828,7 @@ var defaultConfig2 = {
 var mqttSourceHandler = {
   name: "mqtt_source",
   defaultConfig: defaultConfig2,
-  onAttach(node, config, context) {
+  async onAttach(node, config, context) {
     const state = {
       connected: false,
       lastMessage: null,
@@ -29775,6 +29838,8 @@ var mqttSourceHandler = {
       client: null
     };
     node.__mqttSourceState = state;
+    _mqttClientMod2 ?? (_mqttClientMod2 = await import('@holoscript/engine/runtime/protocols/MQTTClient'));
+    const { createMQTTClient, getMQTTClient, registerMQTTClient } = _mqttClientMod2;
     const clientKey = `${config.broker}_${config.clientId || "default"}`;
     let client = getMQTTClient(clientKey);
     if (!client) {
@@ -29816,8 +29881,8 @@ var mqttSourceHandler = {
     };
     client.subscribe({ topic: config.topic, qos: config.qos }, (message) => {
       let value = message.payload;
-      if (config.parseJson) {
-        value = MQTTClient.parsePayload(message);
+      if (config.parseJson && _mqttClientMod2) {
+        value = _mqttClientMod2.MQTTClient.parsePayload(message);
       }
       if (config.debounce && config.debounce > 0) {
         pendingMessage = value;
@@ -30279,13 +30344,24 @@ var multiAgentHandler = {
     }
   }
 };
+
+// src/traits/NetworkedAvatarTrait.ts
+var _boneSystemMod = null;
+var _ikSolverMod = null;
+var _avatarControllerMod = null;
 var networkedAvatarHandler = {
   name: "networked_avatar",
   defaultConfig: {
     isLocal: false,
     updateRate: 30
   },
-  onAttach(node, config, context) {
+  async onAttach(node, config, context) {
+    _boneSystemMod ?? (_boneSystemMod = await import('@holoscript/engine/animation/BoneSystem'));
+    _ikSolverMod ?? (_ikSolverMod = await import('@holoscript/engine/animation/IKSolver'));
+    _avatarControllerMod ?? (_avatarControllerMod = await import('@holoscript/engine/animation/AvatarController'));
+    const { BoneSystem } = _boneSystemMod;
+    const { IKSolver } = _ikSolverMod;
+    const { AvatarController } = _avatarControllerMod;
     const bones = new BoneSystem();
     const solver = new IKSolver();
     const controller = new AvatarController(solver, bones);
@@ -30699,6 +30775,9 @@ var neuralForgeHandler = {
     }
   }
 };
+
+// src/traits/NPCAITrait.ts
+var _frameworkAI = null;
 var npcAIHandler = {
   name: "npc_ai",
   defaultConfig: {
@@ -30727,7 +30806,7 @@ var npcAIHandler = {
     const state = node.__npcAIState;
     if (!state || state.isThinking) return;
   },
-  onEvent(node, config, context, event) {
+  async onEvent(node, config, context, event) {
     const state = node.__npcAIState;
     if (!state) return;
     if (event.type === "npc_ai_prompt") {
@@ -30735,6 +30814,8 @@ var npcAIHandler = {
       state.isThinking = true;
       state.conversationHistory.push({ role: "user", content: prompt });
       context.emit?.("npc_ai_think_begin", { node, prompt });
+      _frameworkAI ?? (_frameworkAI = await import('@holoscript/framework/ai'));
+      const { getDefaultAIAdapter } = _frameworkAI;
       const adapter = getDefaultAIAdapter();
       if (adapter && adapter.chat) {
         adapter.chat(prompt, void 0, state.conversationHistory.slice(0, -1)).then((response) => {
@@ -36257,6 +36338,9 @@ var lotusGenesisTriggerHandler = {
     });
   }
 };
+
+// src/traits/HandMenuTrait.ts
+var _springAnimatorModule = null;
 var getCoord = (v, idx, key) => (Array.isArray(v) ? v[idx] : v[key]) ?? 0;
 var add2 = (v1, v2) => [
   getCoord(v1, 0, "x") + getCoord(v2, 0, "x"),
@@ -36272,7 +36356,9 @@ var handMenuHandler = {
     offset: [0, 0.2, 0],
     scale: 1
   },
-  onAttach(node, config, context) {
+  async onAttach(node, config, context) {
+    _springAnimatorModule ?? (_springAnimatorModule = await import('@holoscript/engine/animation/SpringAnimator'));
+    const { SpringAnimator, SpringPresets } = _springAnimatorModule;
     const spring = new SpringAnimator(0, SpringPresets.gentle);
     menuSprings.set(node.id, spring);
     if (node.properties) {
@@ -36317,6 +36403,9 @@ var handMenuHandler = {
     }
   }
 };
+
+// src/traits/ScrollableTrait.ts
+var _springAnimatorModule2 = null;
 var scrollStates = /* @__PURE__ */ new Map();
 var scrollableHandler = {
   name: "scrollable",
@@ -36327,7 +36416,9 @@ var scrollableHandler = {
     elasticity: 0.1,
     useSpringBounce: true
   },
-  onAttach(node, config, context) {
+  async onAttach(node, config, context) {
+    _springAnimatorModule2 ?? (_springAnimatorModule2 = await import('@holoscript/engine/animation/SpringAnimator'));
+    const { SpringAnimator, SpringPresets } = _springAnimatorModule2;
     const spring = config.useSpringBounce ? new SpringAnimator(0, { ...SpringPresets.gentle, precision: 5e-3 }) : null;
     scrollStates.set(node.id, {
       offset: 0,
@@ -38408,6 +38499,7 @@ var characterHandler = {
     if (typeof instance.onUpdate === "function") instance.onUpdate(node, ctx, dt);
   }
 };
+var _mesh3 = null;
 var DEFAULT_TRAIT_CONFIG = {
   mechanism: "simple_majority",
   timeout: 5e3
@@ -38428,8 +38520,10 @@ var ConsensusTrait = class extends EventEmitter {
   /**
    * Start the consensus trait
    */
-  start() {
+  async start() {
     if (this.isStarted) return;
+    _mesh3 ?? (_mesh3 = await import('@holoscript/mesh'));
+    const { RaftConsensus, ConsensusManager } = _mesh3;
     const nodeId = this.config.nodeId || this.entityId;
     const mechanism = this.config.mechanism || "simple_majority";
     if (mechanism === "raft") {
@@ -44589,15 +44683,26 @@ var slidableHandler = {
     if (typeof instance.onUpdate === "function") instance.onUpdate(node, ctx, dt);
   }
 };
+var _spatial = null;
 var DEFAULT_TRAIT_CONFIG2 = {
-  ...DEFAULT_SPATIAL_CONFIG,
   initialPosition: [0, 0, 0],
   autoStart: true
 };
 var SpatialAwarenessTrait = class extends EventEmitter {
   constructor(id, config = {}) {
     super();
+    /**
+     * The underlying spatial provider. `null` until `ensureInitialized()` has run
+     * (it lazy-imports the optional engine peer to construct it). All sync methods
+     * that touch `this.provider` null-guard and no-op until initialization, since
+     * the trait is not "active" until `start()` / `ensureInitialized()` completes.
+     */
+    this.provider = null;
     this.ownsProvider = false;
+    /** True once `ensureInitialized()` has constructed the provider + wired events. */
+    this.initialized = false;
+    /** In-flight initialization promise so concurrent `ensureInitialized()` calls share one import. */
+    this.initPromise = null;
     this.velocity = [0, 0, 0];
     this.isActive = false;
     this.lastContext = null;
@@ -44606,26 +44711,53 @@ var SpatialAwarenessTrait = class extends EventEmitter {
     this.id = id;
     this.config = { ...DEFAULT_TRAIT_CONFIG2, ...config };
     this.position = this.config.initialPosition || [0, 0, 0];
-    if (this.config.sharedProvider) {
-      this.provider = this.config.sharedProvider;
-      this.ownsProvider = false;
-    } else {
-      this.provider = new SpatialContextProvider();
-      this.ownsProvider = true;
-    }
-    this.setupEventHandlers();
+    this.ownsProvider = !this.config.sharedProvider;
     if (this.config.autoStart) {
-      this.start();
+      void this.start().catch(() => {
+      });
     }
   }
   // ===========================================================================
   // LIFECYCLE
   // ===========================================================================
   /**
-   * Start spatial awareness
+   * Lazily load the optional `@holoscript/engine/spatial` peer, construct the
+   * provider, merge in the spatial defaults, and wire event forwarding.
+   *
+   * This is the single place the optional engine module is dynamically imported,
+   * so a cold `import '@holoscript/core'` never touches it. Safe to call multiple
+   * times — the import + construction happen exactly once (guarded by `initPromise`
+   * and `this.initialized`).
+   *
+   * @throws if `@holoscript/engine/spatial` is not installed (the optional peer).
+   */
+  async ensureInitialized() {
+    if (this.initialized) return;
+    if (this.initPromise) return this.initPromise;
+    this.initPromise = (async () => {
+      _spatial ?? (_spatial = await import('@holoscript/engine/spatial'));
+      this.config = { ..._spatial.DEFAULT_SPATIAL_CONFIG, ...this.config };
+      this.provider = this.config.sharedProvider ?? new _spatial.SpatialContextProvider();
+      this.setupEventHandlers();
+      this.initialized = true;
+    })();
+    try {
+      await this.initPromise;
+    } finally {
+      this.initPromise = null;
+    }
+  }
+  /**
+   * Start spatial awareness.
+   *
+   * Now async: it first awaits `ensureInitialized()` (which lazy-imports the
+   * optional engine peer and constructs the provider), then registers the agent.
    */
-  start() {
+  async start() {
     if (this.isActive) return;
+    await this.ensureInitialized();
+    if (this.isActive) return;
+    if (!this.provider) return;
     this.provider.registerAgent(this.id, this.position, this.config);
     if (this.ownsProvider) {
       this.provider.start();
@@ -44637,6 +44769,10 @@ var SpatialAwarenessTrait = class extends EventEmitter {
    */
   stop() {
     if (!this.isActive) return;
+    if (!this.provider) {
+      this.isActive = false;
+      return;
+    }
     this.provider.unregisterAgent(this.id);
     if (this.ownsProvider) {
       this.provider.stop();
@@ -44664,7 +44800,7 @@ var SpatialAwarenessTrait = class extends EventEmitter {
    */
   setPosition(position) {
     this.position = position;
-    if (this.isActive) {
+    if (this.isActive && this.provider) {
       this.provider.updateAgentPosition(this.id, position, this.velocity);
     }
   }
@@ -44679,7 +44815,7 @@ var SpatialAwarenessTrait = class extends EventEmitter {
    */
   setVelocity(velocity) {
     this.velocity = velocity;
-    if (this.isActive) {
+    if (this.isActive && this.provider) {
       this.provider.updateAgentPosition(this.id, this.position, velocity);
     }
   }
@@ -44696,7 +44832,9 @@ var SpatialAwarenessTrait = class extends EventEmitter {
    * Get current spatial context
    */
   getContext() {
-    return this.lastContext || this.provider.getContext(this.id);
+    if (this.lastContext) return this.lastContext;
+    if (!this.provider) return null;
+    return this.provider.getContext(this.id);
   }
   /**
    * Get nearby entities
@@ -44726,6 +44864,7 @@ var SpatialAwarenessTrait = class extends EventEmitter {
    * Find nearest entity
    */
   findNearest(typeFilter) {
+    if (!this.provider) return null;
     const results = this.provider.findNearest(this.position, 1, typeFilter);
     return results[0] || null;
   }
@@ -44733,12 +44872,14 @@ var SpatialAwarenessTrait = class extends EventEmitter {
    * Find all entities within radius
    */
   findWithin(radius, typeFilter) {
+    if (!this.provider) return [];
     return this.provider.findWithin(this.position, radius, typeFilter);
   }
   /**
    * Find visible entities
    */
   findVisible(direction, fov, maxDistance) {
+    if (!this.provider) return [];
     return this.provider.findVisible(this.position, direction, fov, maxDistance);
   }
   /**
@@ -44766,18 +44907,21 @@ var SpatialAwarenessTrait = class extends EventEmitter {
    * Register an entity for tracking
    */
   registerEntity(entity) {
+    if (!this.provider) return;
     this.provider.setEntity(entity);
   }
   /**
    * Unregister an entity
    */
   unregisterEntity(entityId) {
+    if (!this.provider) return;
     this.provider.removeEntity(entityId);
   }
   /**
    * Batch register entities
    */
   registerEntities(entities) {
+    if (!this.provider) return;
     this.provider.setEntities(entities);
   }
   // ===========================================================================
@@ -44787,24 +44931,28 @@ var SpatialAwarenessTrait = class extends EventEmitter {
    * Register a region
    */
   registerRegion(region) {
+    if (!this.provider) return;
     this.provider.setRegion(region);
   }
   /**
    * Unregister a region
    */
   unregisterRegion(regionId) {
+    if (!this.provider) return;
     this.provider.removeRegion(regionId);
   }
   /**
    * Subscribe to region events
    */
   watchRegion(regionId, callback) {
+    if (!this.provider) return;
     this.provider.subscribeToRegion(this.id, regionId, callback);
   }
   /**
    * Unsubscribe from region events
    */
   unwatchRegion(regionId) {
+    if (!this.provider) return;
     this.provider.unsubscribeFromRegion(this.id, regionId);
   }
   // ===========================================================================
@@ -44815,23 +44963,26 @@ var SpatialAwarenessTrait = class extends EventEmitter {
    */
   setPerceptionRadius(radius) {
     this.config.perceptionRadius = radius;
-    if (this.isActive) {
+    if (this.isActive && this.provider) {
       this.provider.unregisterAgent(this.id);
       this.provider.registerAgent(this.id, this.position, this.config);
     }
   }
   /**
    * Get perception radius
+   *
+   * Returns 0 if the spatial defaults have not yet been merged (i.e. before
+   * `ensureInitialized()` ran and no explicit value was supplied in config).
    */
   getPerceptionRadius() {
-    return this.config.perceptionRadius;
+    return this.config.perceptionRadius ?? 0;
   }
   /**
    * Set entity type filter
    */
   setEntityTypeFilter(types) {
     this.config.entityTypeFilter = types;
-    if (this.isActive) {
+    if (this.isActive && this.provider) {
       this.provider.unregisterAgent(this.id);
       this.provider.registerAgent(this.id, this.position, this.config);
     }
@@ -44843,38 +44994,40 @@ var SpatialAwarenessTrait = class extends EventEmitter {
    * Setup event handlers from provider
    */
   setupEventHandlers() {
-    this.provider.on("entity:entered", (agentId, event) => {
+    const provider = this.provider;
+    if (!provider) return;
+    provider.on("entity:entered", (agentId, event) => {
       if (agentId !== this.id) return;
       if (event.type === "entity_entered") {
         this.emit("entity:entered", event.entity, event.distance);
       }
     });
-    this.provider.on("entity:exited", (agentId, event) => {
+    provider.on("entity:exited", (agentId, event) => {
       if (agentId !== this.id) return;
       if (event.type === "entity_exited") {
         this.emit("entity:exited", event.entity);
       }
     });
-    this.provider.on("region:entered", (agentId, event) => {
+    provider.on("region:entered", (agentId, event) => {
       if (agentId !== this.id) return;
       if (event.type === "region_entered") {
         this.emit("region:entered", event.region, event.previousRegion);
       }
     });
-    this.provider.on("region:exited", (agentId, event) => {
+    provider.on("region:exited", (agentId, event) => {
       if (agentId !== this.id) return;
       if (event.type === "region_exited") {
         this.emit("region:exited", event.region);
       }
     });
-    this.provider.on("visibility:changed", (agentId, event) => {
+    provider.on("visibility:changed", (agentId, event) => {
       if (agentId !== this.id) return;
       if (event.type === "visibility_changed") {
         this.visibleEntities.set(event.entityId, event.visible);
         this.emit("visibility:changed", event.entityId, event.visible);
       }
     });
-    this.provider.on("context:updated", (agentId, context) => {
+    provider.on("context:updated", (agentId, context) => {
       if (agentId !== this.id) return;
       this.lastContext = context;
       this.emit("context:updated", context);
@@ -44884,15 +45037,17 @@ var SpatialAwarenessTrait = class extends EventEmitter {
 function createSpatialAwarenessTrait(id, config) {
   return new SpatialAwarenessTrait(id, config);
 }
-function createSharedSpatialProvider() {
-  return new SpatialContextProvider();
+async function createSharedSpatialProvider() {
+  _spatial ?? (_spatial = await import('@holoscript/engine/spatial'));
+  return new _spatial.SpatialContextProvider();
 }
 var spatialAwarenessHandler = {
   name: "spatial_awareness",
   defaultConfig: {},
-  onAttach(node, config, ctx) {
+  async onAttach(node, config, ctx) {
     const instance = new SpatialAwarenessTrait(node.id || "spatial_awareness", config);
     node.__spatial_awareness_instance = instance;
+    await instance.start();
     ctx.emit("spatial_awareness_attached", { node, config });
   },
   onDetach(node, _config, ctx) {
@@ -56001,5 +56156,5 @@ var VRTraitRegistry = class {
 var vrTraitRegistry = new VRTraitRegistry();
 
 export { AIDriverTrait, ALL_CIRCUITS, ARKIT_MOUTH_SHAPES, AnimationTrait, BUILTIN_CIRCUITS, BarretenbergBackend, BehaviorTreeRunner, CARE_ETHICS_TRAIT, CRDTRoomTraitValidationError, CRDT_ROOM_TRAIT_DEFAULTS, CharacterTrait, ComponentType, ConsensusTrait, DEFAULT_ANIMATION_MAP, DEFAULT_AUTONOMY_GUARD_POLICY, DEFAULT_BEHAVIOR_FACT_TTL_ALERT_RULE, DEFAULT_EXPRESSION_PRESETS, DEFAULT_EXTERNAL_TIMEOUT_MS, DEFAULT_FOVEATED_BLEND, DEFAULT_FREQUENCY_BANDS, DEFAULT_REPUTATION_LEDGER_MAX_FACTS, DEFAULT_REPUTATION_LEDGER_TTL_DAYS, DEFAULT_SYNC_FIELD, DEFAULT_TRAIT_CONFIG2 as DEFAULT_TRAIT_CONFIG, DRAFT_DEFAULTS, DRAFT_TRAIT, DialogTrait, DraftManager, ECSWorld, EmotionDirectiveTrait, EnvironmentalAudioSystem, GEM_RESONANCE_ELEMENT_FREQUENCIES, GOAPPlanner, GOLDEN_ANGLE_DEG, IKTrait, InteractiveGraphTrait, JobQueuePersistence, JointTrait, LOCAL_WEBCAM_VIEW_ID, LipSyncTrait, LobbyTrait, MAX_EXPERIENCE_LOG_ENTRIES, MorphTrait, MultiviewGaussianRendererTrait, NetworkedTrait, OCULUS_VISEME_MAP, PIDControllerTrait, PressableTrait, REFERENCE_SPACE_CHAIN, REFUSED_CARE_OPTIMIZATION_TARGETS, RigidbodyTrait, SPATIAL_PREDICATE_CIRCUITS, SYNC_PRESETS, SandboxExecutionTrait, SlidableTrait, SpatialAwarenessTrait, SyncTierTrait, TIER_DEFAULTS, TriggerTrait, URDFRobotTrait, VRTraitRegistry, VoiceInputTrait, VoiceOutputTrait, VoronoiFractureSystem, WEATHER_PRESETS, aIDriverHandler, abTestHandler, abstain, accessibleHandler, advancedClothHandler, affinityHandler, agentDiscoveryHandler, agentMemoryHandler, agentMovementSystem, agentPortalHandler, aiInpaintingHandler, aiTextureGenHandler, aiUpscalingHandler, ainpcBrainHandler, alertHandler, altTextHandler, ambisonicsHandler, analyticsHandler, anchorHandler, applyFBXAxisConversion, applyStatModifiers, applyUSDAxisConversion, approve, audioMaterialHandler, audioOcclusionHandler, audioPortalHandler, auditLogHandler, autoVote, avatarEmbodimentHandler, behaviorTreeHandler, biofeedbackHandler, blackboardHandler, bloomReactiveHandler, bodyTrackingHandler, bufferHandler, buildBehaviorFactDisclosure, buoyancyHandler, cRDTRoomHandler, careEthicsHandler, chainHandler, characterHandler, choreographyHandler, circuitBreakerHandler, clothHandler, coLocatedHandler, compareSemVer, computeHandler, computePhyllotaxisPosition, computerUseHandler, consensusHandler, consentGateHandler, controlNetHandler, controllerInputHandler, controlnetHandler, createAIDriverTrait, createAnimationTrait, createApprovalRequest, createBaseMainnetAccountingAdapter, createBehaviorFactTtlAlertRule, createCRDTRoomTraitConfig, createCanBusAccountingAdapter, createCareField, createCharacterTrait, createConsensusTrait, createDialogTrait, createEdiX12AccountingAdapter, createEmotionDirectiveTrait, createHl7FhirAccountingAdapter, createIKTrait, createJointTrait, createLipSyncTrait, createLobbyTrait, createMorphTrait, createNetworkedTrait, createRepairLoop, createRigidbodyTrait, createRollbackCheckpoint, createSelectiveDisclosure, createSharedSpatialProvider, createSimulatedController, createSpatialAwarenessTrait, createTriggerTrait, createURDFRobotTrait, createVoiceInputTrait, createVoiceOutputTrait, cronHandler, dataBindingHandler, deriveBloomReactiveOutput, deriveLotusCenterPhase, deriveLotusGardenerSchedule, deriveLotusGenesisGate, deriveLotusGenesisSeed, deriveLotusPetalVisual, deriveLotusRootEmissive, deriveLotusStalkPosture, deriveWalkableNavmesh, destructionHandler, deviceProfiles, dialogHandler, dialogueHandler, diffusionRealtimeHandler, digitalTwinHandler, dropTableHandler, economyPrimitivesHandler, effectiveWeight, embeddingSearchHandler, emissiveAt, emotionDirectiveHandler, emotionHandler, emotionalVoiceHandler, encounterHandler, environmentalAudioHandler, evaluateAction, evaluateAutonomyGuard, evaluateCareEthicsTurn, extractLotusGenesisAnchorHash, extractPayload, eyeTrackedHandler, faceTrackingHandler, factionHandler, fbxHandler, feedbackLoopHandler, findReachablePath, findWalkableNodeAt, flowFieldHandler, fluidHandler, gardenerPulseJitter, gaussianSplatHandler, gemResonanceHandler, geospatialAnchorHandler, geospatialEnvHandler, gestureHandler, getActiveSessions, getAgentId, getAirAbsorption, getAuditLog, getCachedThingDescription, getCapabilities, getCareEthicsState, getEventHistory, getFBXAnimationStacks, getFBXBoneNames, getFBXMorphTargets, getFBXState, getGLTFAnimations, getGLTFMorphTargets, getGLTFState, getMQTTSinkClient, getMQTTSinkState, getMQTTSourceClient, getMQTTSourceState, getMyProposals, getMyVotes, getNegotiationMethods, getPredicateCircuitId, getSession, getUSDActiveVariant, getUSDAnimation, getUSDBlendShapes, getUSDJointNames, getUSDState, getUSDVariantSets, getWoTThingState, gltfHandler, goalOrientedHandler, gpuBufferHandler, gpuParticleHandler, gpuPhysicsHandler, granularMaterialHandler, handMenuHandler, handMeshAIHandler, handTrackingHandler, hapticCueHandler, hapticHandler, hasMQTTSinkTrait, hasMQTTSourceTrait, hasVoted, hasWoTThingTrait, hashGardenerSeed, hashSeed, headTrackedAudioHandler, heatmap3dHandler, highContrastHandler, hitlHandler, hrtfHandler, iKHandler, initiate, invalidateThingDescription, isConsentGranted, isFBXLoaded, isGLTFLoaded, isInSession, isMQTTSinkConnected, isMQTTSourceConnected, isReservedPaperId, isUSDLoaded, isUSDZ, isWalkableAt, jointHandler, layerAwareHandler, leave, lightEstimationHandler, lipSyncHandler, llmAgentHandler, lobbyHandler, localLLMHandler, lodSystem, lotusCenterHandler, lotusGardenerHandler, lotusGenesisTriggerHandler, lotusPetalHandler, lotusRootHandler, lotusStalkHandler, luckHandler, magnifiableHandler, marketplaceHandler, marketplaceIntegrationHandler, matchesCondition, materialXHandler, memoryHandler, meshDetectionHandler, messagingHandler, modifiedThreshold, morphHandler, motionReducedHandler, mqttSinkHandler, mqttSourceHandler, multiAgentHandler, multiviewGaussianRendererHandler, negotiationHandler, nerfHandler, networkedAvatarHandler, networkedHandler, neuralAnimationHandler, neuralForgeHandler, neuralLinkHandler, neuralUpscalingHandler, nftHandler, normalizeCenter, normalizeLotusSeed, normalizePointCloud, npcAIHandler, objectTrackingHandler, occlusionHandler, openXRHALHandler, parseCRDTRoomEntityConfig, parseCRDTRoomTraitConfig, partnerSDKHandler, patrolHandler, perceptionHandler, persistentAnchorHandler, photogrammetryHandler, phyllotaxisHandler, physicsSystem, pickByWeight, planeDetectionHandler, poiHandler, pointCloudHandler, portableHandler, poseEstimationHandler, pressableHandler, propose, publishToMQTTSink, quotaHandler, ragKnowledgeHandler, rateLimiterHandler, rbacHandler, realityKitMeshHandler, recordGratitude, rememberRelationalContext, remotePresenceHandler, renderNetworkHandler, reputationLedgerHandler, resolveBloomStage, resolveCRDTRoomTraitConfig, resolvePulseHz, resourceAccountingHandler, reverbZoneHandler, rigidbodyHandler, roadmapNodeHandler, roleHandler, rooftopAnchorHandler, roomMeshHandler, ropeHandler, runECSBenchmark, runResourceAccountingAudit, sceneGraphHandler, sceneReconstructionHandler, schedulerHandler, screenReaderHandler, scrollableHandler, seatedHandler, secondsToUSDTimeCode, seededRand01, sensorHandler, setAgentManifest, sharePlayHandler, sharedAnchorHandler, sharedWorldHandler, shouldFire, signRequest, skillRegistryHandler, slidableHandler, softBodyHandler, sonificationHandler, spatialAccessoryHandler, spatialAudioCueHandler, spatialAwarenessHandler, spatialNavigationHandler, spatialPersonaHandler, spectatorHandler, ssoOidcHandler, ssoSamlHandler, stableDiffusionHandler, stableResourceAccountingReceiptHash, statHandler, structuredLoggerHandler, subtitleHandler, syncTierHandler, tenantHandler, terrainAnchorHandler, timeoutGuardHandler, tokenGatedHandler, transformHandler, triggerHandler, urdfRobotHandler, usdHandler, usdTimeCodeToSeconds, userMonitorHandler, validateCRDTRoomTraitConfig, validateCareField, validateSemVer, vectorDBHandler, verifyWebhookSignature, visionHandler, voiceInputHandler, voiceMeshHandler, voiceOutputHandler, voiceProximityHandler, volumetricHandler, volumetricVideoHandler, volumetricWindowHandler, voronoiFractureHandler, vote, vpsHandler, vrTraitRegistry, walletHandler, wasmBridgeHandler, windHandler, withNegotiation, wotThingHandler, zkPrivateHandler };
-//# sourceMappingURL=chunk-EOBB6A4B.js.map
-//# sourceMappingURL=chunk-EOBB6A4B.js.map
+//# sourceMappingURL=chunk-RVBHAXFG.js.map
+//# sourceMappingURL=chunk-RVBHAXFG.js.map