@relu-interactives/spatial-ecs 0.2.21 → 0.2.22

package/dist/{chunk-5U3YS4JD.js → chunk-GZ2NKSMV.js}

@@ -1,5 +1,5 @@
-import { resolveDracoDecoderPath, applyTransform } from './chunk-AXRCGF63.js';
-import { AnimationComponent, ModelComponent, CameraComponent, Object3DRef, Environment, Postprocessing, TransformComponent, PhysicsComponent, LightComponent, MaterialComponent, DEFAULT_MESH_GEOMETRY_PARAMETERS, MeshGeometryComponent, InstancedMeshComponent, ParentId, ScriptComponent, InstanceSlotComponent, Name, ImageComponent, SpriteComponent, VideoComponent, AudioComponent, ImageTarget, Selectable, PrefabNode, PrefabInstance } from './chunk-V7BNVTJW.js';
+import { resolveDracoDecoderPath, applyTransform, SHARED_MODEL_RESOURCE_FLAG } from './chunk-WKGCC7YL.js';
+import { AnimationComponent, ModelComponent, CameraComponent, Object3DRef, Environment, Postprocessing, TransformComponent, PhysicsComponent, LightComponent, MaterialComponent, DEFAULT_MESH_GEOMETRY_PARAMETERS, MeshGeometryComponent, InstancedMeshComponent, ParentId, ScriptComponent, ScriptObjectComponent, InstanceSlotComponent, Name, ImageComponent, SpriteComponent, VideoComponent, AudioComponent, ImageTarget, Selectable, PrefabNode, PrefabInstance } from './chunk-JHCPRVBC.js';
 import { __name } from './chunk-OY7ZODZP.js';
 import * as THREE7 from 'three';
 import { DRACOLoader } from 'three/examples/jsm/loaders/DRACOLoader.js';
@@ -2741,6 +2741,10 @@ function buildComponentValueMaps(snapshot) {
     animationValues: readByComponent(snapshot.components, "AnimationComponent"),
     imageTargetAnchorValues: readByComponent(snapshot.components, "ImageTargetAnchor"),
     scriptValues: readByComponent(snapshot.components, "ScriptComponent"),
+    scriptObjectValues: readByComponent(
+      snapshot.components,
+      "ScriptObjectComponent"
+    ),
     instancedMeshValues: readByComponent(snapshot.components, "InstancedMeshComponent"),
     instanceSlotValues: readByComponent(snapshot.components, "InstanceSlotComponent"),
     prefabNodeValues: readByComponent(snapshot.components, "PrefabNode"),
@@ -2858,6 +2862,14 @@ function restorePostCreateComponents(world, objectManagementSystem, targetEntity
       new ScriptComponent(entries)
     );
   }
+  const sourceScriptObject = asRecord(values.scriptObjectValues.get(sourceEntityId));
+  if (sourceScriptObject) {
+    const soc = world.getComponent(targetEntityId, ScriptObjectComponent);
+    const data = asRecord(sourceScriptObject.data);
+    if (soc && data) {
+      soc.data = remapEntityRefsInScriptData(data, idMap);
+    }
+  }
   {
     const imComponent = world.getComponent(targetEntityId, InstancedMeshComponent);
     if (imComponent && imComponent.instanceEntityIds.length > 0) {
@@ -3444,7 +3456,8 @@ var HYDRATABLE_ENTITY_KINDS = /* @__PURE__ */ new Set([
   "spotLight",
   "areaLight",
   "instancedMesh",
-  "instanceSlot"
+  "instanceSlot",
+  "scriptObject"
 ]);
 
 // core/hydration/hydrateWorld.ts
@@ -3546,6 +3559,16 @@ function buildEntityCreationPayload(sourceEntityId, kind, componentValues) {
       };
     }
   }
+  if (kind === "scriptObject") {
+    const so = asRecord(componentValues.scriptObjectValues.get(sourceEntityId));
+    if (so) {
+      payload.options = {
+        scriptUrl: typeof so.scriptUrl === "string" ? so.scriptUrl : null,
+        className: typeof so.className === "string" ? so.className : null,
+        enabled: typeof so.enabled === "boolean" ? so.enabled : true
+      };
+    }
+  }
   return payload;
 }
 __name(buildEntityCreationPayload, "buildEntityCreationPayload");
@@ -3877,6 +3900,33 @@ var toRefOrRaw = /* @__PURE__ */ __name((id, idToNode) => {
   const nodeId = idToNode.get(id);
   return nodeId !== void 0 ? makeNodeRef(nodeId) : id;
 }, "toRefOrRaw");
+function canonicalizeScriptDataFields(data, idToNode) {
+  const canonicalData = {};
+  for (const [key, fieldValue] of Object.entries(data)) {
+    const field = asRecord3(fieldValue);
+    if (field?.type === "entity" && typeof field.value === "number") {
+      canonicalData[key] = {
+        ...field,
+        value: toRefOrRaw(field.value, idToNode)
+      };
+      continue;
+    }
+    const componentRef = asRecord3(field?.value);
+    if (field?.type === "component" && componentRef && typeof componentRef.entityId === "number") {
+      canonicalData[key] = {
+        ...field,
+        value: {
+          ...componentRef,
+          entityId: toRefOrRaw(componentRef.entityId, idToNode)
+        }
+      };
+      continue;
+    }
+    canonicalData[key] = fieldValue;
+  }
+  return canonicalData;
+}
+__name(canonicalizeScriptDataFields, "canonicalizeScriptDataFields");
 function canonicalizeComponentValue(componentName, value, idToNode) {
   const cloned = clone(value);
   const record = asRecord3(cloned);
@@ -3902,39 +3952,23 @@ function canonicalizeComponentValue(componentName, value, idToNode) {
         if (!entry) {
           return rawEntry;
         }
-        const data = asRecord3(entry.data) ?? {};
-        const canonicalData = {};
-        for (const [key, fieldValue] of Object.entries(data)) {
-          const field = asRecord3(fieldValue);
-          if (field?.type === "entity" && typeof field.value === "number") {
-            canonicalData[key] = {
-              ...field,
-              value: toRefOrRaw(field.value, idToNode)
-            };
-            continue;
-          }
-          const componentRef = asRecord3(field?.value);
-          if (field?.type === "component" && componentRef && typeof componentRef.entityId === "number") {
-            canonicalData[key] = {
-              ...field,
-              value: {
-                ...componentRef,
-                entityId: toRefOrRaw(componentRef.entityId, idToNode)
-              }
-            };
-            continue;
-          }
-          canonicalData[key] = fieldValue;
-        }
         return {
           className: typeof entry.className === "string" ? entry.className : "",
           scriptUrl: typeof entry.scriptUrl === "string" ? entry.scriptUrl : "",
           enabled: typeof entry.enabled === "boolean" ? entry.enabled : true,
-          data: canonicalData
+          data: canonicalizeScriptDataFields(asRecord3(entry.data) ?? {}, idToNode)
         };
       })
     };
   }
+  if (componentName === "ScriptObjectComponent") {
+    return {
+      scriptUrl: typeof record.scriptUrl === "string" ? record.scriptUrl : null,
+      className: typeof record.className === "string" ? record.className : null,
+      enabled: typeof record.enabled === "boolean" ? record.enabled : true,
+      data: canonicalizeScriptDataFields(asRecord3(record.data) ?? {}, idToNode)
+    };
+  }
   if (componentName === "InstancedMeshComponent") {
     if (Array.isArray(record.instanceEntityIds)) {
       record.instanceEntityIds = record.instanceEntityIds.map(
@@ -4637,22 +4671,14 @@ var _Behaviour = class _Behaviour {
   /**
    * Called once before the first {@link Behaviour.onUpdate}. Override to
    * default and validate {@link Behaviour.data}, cache references, or set
-   * initial state.
-   *
-   * @remarks
-   * Also called in editor mode when `executeInEditor` is `true` on the script
-   * entry.
+   * initial state. Runs at preview/runtime only — never in the editor.
    */
   init() {
   }
   /**
    * Called every frame while the script is enabled. Override with the
-   * script's main per-frame logic.
-   *
-   * @remarks
-   * Also called every frame in editor mode when `executeInEditor` is `true`.
-   * Access the Three.js scene with `this.world.getScene()` for editor-only
-   * rendering work such as custom shaders or procedural geometry.
+   * script's main per-frame logic. Runs at preview/runtime only — never in the
+   * editor (use {@link ScriptObject} for editor-visible visuals).
    */
   onUpdate() {
   }
@@ -4691,7 +4717,14 @@ __name(_Behaviour, "Behaviour");
 _Behaviour.__reluBehaviourClass = true;
 var Behaviour = _Behaviour;
 
-// core/systems/ScriptBehaviourSystem.ts
+// core/systems/scriptShared.ts
+async function defaultModuleLoader(scriptUrl) {
+  return await import(
+    /* webpackIgnore: true */
+    scriptUrl
+  );
+}
+__name(defaultModuleLoader, "defaultModuleLoader");
 function toErrorMessage(error) {
   const sanitize = /* @__PURE__ */ __name((value) => value.replace(/localasset:\/\/[^/]+\//g, "localasset://").replace(/\/Users\/[^\s)]+/g, "[local path]"), "sanitize");
   if (error instanceof Error && error.message) {
@@ -4703,26 +4736,22 @@ function toErrorMessage(error) {
   return "Unknown script error.";
 }
 __name(toErrorMessage, "toErrorMessage");
-function buildInstanceKey(entityId, scriptUrl, className) {
-  return `${entityId}:${scriptUrl}:${className}`;
-}
-__name(buildInstanceKey, "buildInstanceKey");
-function resolveBehaviourCtor(moduleValue, className) {
+function resolveScriptCtor(moduleValue, className, options) {
   const named = moduleValue[className];
   const fallback = moduleValue.default;
   const candidate = typeof named === "function" ? named : typeof fallback === "function" ? fallback : null;
   if (!candidate) {
     return null;
   }
-  if (!(candidate.prototype instanceof Behaviour)) {
-    const isBehaviourSubclass = !!candidate.__reluBehaviourClass;
-    if (!isBehaviourSubclass) {
+  if (!(candidate.prototype instanceof options.baseClass)) {
+    const marker = candidate[options.markerKey];
+    if (!marker) {
       return null;
     }
   }
   return candidate;
 }
-__name(resolveBehaviourCtor, "resolveBehaviourCtor");
+__name(resolveScriptCtor, "resolveScriptCtor");
 function normalizeScriptData(value) {
   return value && typeof value === "object" && !Array.isArray(value) ? value : {};
 }
@@ -4804,8 +4833,8 @@ function resolveInputData(world, rawData) {
   return resolved;
 }
 __name(resolveInputData, "resolveInputData");
-function serializeDataForStorage(rawData, behaviourData) {
-  const result = { ...behaviourData };
+function serializeDataForStorage(rawData, instanceData) {
+  const result = { ...instanceData };
   for (const [key, rawValue] of Object.entries(rawData)) {
     if (isRawEntityInput(rawValue) || isRawComponentInput(rawValue)) {
       result[key] = rawValue;
@@ -4814,13 +4843,25 @@ function serializeDataForStorage(rawData, behaviourData) {
   return result;
 }
 __name(serializeDataForStorage, "serializeDataForStorage");
+
+// core/systems/ScriptBehaviourSystem.ts
+function buildInstanceKey(entityId, scriptUrl, className) {
+  return `${entityId}:${scriptUrl}:${className}`;
+}
+__name(buildInstanceKey, "buildInstanceKey");
+function resolveBehaviourCtor(moduleValue, className) {
+  return resolveScriptCtor(moduleValue, className, {
+    baseClass: Behaviour,
+    markerKey: "__reluBehaviourClass"
+  });
+}
+__name(resolveBehaviourCtor, "resolveBehaviourCtor");
 function normalizeEntry(value, fallbackEntityId) {
   return {
     entityId: typeof value?.entityId === "number" ? value.entityId : fallbackEntityId,
     className: typeof value?.className === "string" ? value.className : "",
     scriptUrl: typeof value?.scriptUrl === "string" ? value.scriptUrl : "",
     enabled: typeof value?.enabled === "boolean" ? value.enabled : true,
-    executeInEditor: typeof value?.executeInEditor === "boolean" ? value.executeInEditor : false,
     data: normalizeScriptData(value?.data),
     runtimeState: value?.runtimeState === "idle" || value?.runtimeState === "loading" || value?.runtimeState === "ready" || value?.runtimeState === "error" ? value.runtimeState : void 0,
     runtimeMessage: typeof value?.runtimeMessage === "string" ? value.runtimeMessage : void 0
@@ -4843,13 +4884,6 @@ function writeScriptEntries(component, entries) {
   }
 }
 __name(writeScriptEntries, "writeScriptEntries");
-async function defaultModuleLoader(scriptUrl) {
-  return await import(
-    /* webpackIgnore: true */
-    scriptUrl
-  );
-}
-__name(defaultModuleLoader, "defaultModuleLoader");
 var _ScriptBehaviourSystem = class _ScriptBehaviourSystem {
   constructor(moduleLoader, selectionContext) {
     this.instances = /* @__PURE__ */ new Map();
@@ -4965,11 +4999,11 @@ var _ScriptBehaviourSystem = class _ScriptBehaviourSystem {
       let hasEnabledScript = false;
       for (let entryIndex = 0; entryIndex < nextEntries.length; entryIndex += 1) {
         const entry = nextEntries[entryIndex];
-        const skipInEditor = world.isEditorMode() && !entry.executeInEditor;
+        const skipInEditor = world.isEditorMode();
         if (!entry.enabled || !entry.scriptUrl || skipInEditor) {
           nextEntries[entryIndex] = {
             ...entry,
-            runtimeState: skipInEditor ? "idle" : "idle",
+            runtimeState: "idle",
             runtimeMessage: void 0
           };
           continue;
@@ -5156,7 +5190,7 @@ var _ScriptBehaviourSystem = class _ScriptBehaviourSystem {
     const mergedData = mergeDataByCurrentDefaults(defaults, currentData);
     const resolvedData = resolveInputData(world, mergedData);
     behaviour.data = resolvedData;
-    if (!world.isEditorMode() || liveEntry.executeInEditor === true) {
+    if (!world.isEditorMode()) {
       behaviour.init();
     }
     liveEntries[entryIndex] = {
@@ -5184,6 +5218,328 @@ __name(_ScriptBehaviourSystem, "ScriptBehaviourSystem");
 _ScriptBehaviourSystem.CLICK_THRESHOLD = 6;
 var ScriptBehaviourSystem = _ScriptBehaviourSystem;
 
+// core/ScriptObject.ts
+var _ScriptObject = class _ScriptObject {
+  /**
+   * Engine-managed constructor. `ScriptObjectSystem` instantiates subclasses
+   * with the owning world, the entity id, and the component's `data`. User code
+   * should not call this directly.
+   */
+  constructor(world, entityId, data) {
+    /**
+     * The script's data payload (the `ScriptObjectComponent.data`). Declare a
+     * concrete shape on subclasses with `declare data: MyShape` for type safety.
+     * Use the same typed input envelopes as Behaviours (`ColorInput`,
+     * `SliderInput`, `EntityInput`, …) to get inspector fields.
+     */
+    this.data = {};
+    /**
+     * The Object3D returned by {@link ScriptObject.build}. Assigned by
+     * `ScriptObjectSystem` after `build()` runs; `null` until then.
+     */
+    this.root = null;
+    this.world = world;
+    this.entityId = entityId;
+    if (data) this.data = data;
+  }
+  /**
+   * REQUIRED — build and return the visual root. Called once by
+   * `ScriptObjectSystem` after construction. The returned object is attached
+   * under the entity's Object3D (so it inherits the entity transform, selection
+   * and visibility). Subclasses MUST override.
+   */
+  build() {
+    throw new Error("ScriptObject subclasses must implement build()");
+  }
+};
+__name(_ScriptObject, "ScriptObject");
+/**
+ * Static marker used by `ScriptObjectSystem` to detect `ScriptObject`
+ * subclasses even when a bundler ships a second copy of the package into the
+ * script blob (breaking `instanceof`). Do NOT override.
+ */
+_ScriptObject.__reluScriptObjectClass = true;
+var ScriptObject = _ScriptObject;
+
+// core/systems/ScriptObjectSystem.ts
+var SCRIPT_OBJECT_ROOT_FLAG = "__scriptObjectRoot";
+function setInstanceRef(component, value) {
+  Object.defineProperty(component, "instance", {
+    value,
+    writable: true,
+    configurable: true,
+    enumerable: false
+  });
+}
+__name(setInstanceRef, "setInstanceRef");
+function disposeBuiltObject(root) {
+  root.parent?.remove(root);
+  root.traverse((node) => {
+    const mesh = node;
+    const geometry = mesh.geometry;
+    if (geometry?.dispose && !geometry.userData?.[SHARED_MODEL_RESOURCE_FLAG]) {
+      geometry.dispose();
+    }
+    const material = mesh.material;
+    const materials = Array.isArray(material) ? material : material ? [material] : [];
+    for (const mat of materials) {
+      if (mat.userData?.[SHARED_MODEL_RESOURCE_FLAG]) continue;
+      for (const value of Object.values(mat)) {
+        if (value instanceof THREE7.Texture) value.dispose();
+      }
+      mat.dispose?.();
+    }
+  });
+}
+__name(disposeBuiltObject, "disposeBuiltObject");
+var _ScriptObjectSystem = class _ScriptObjectSystem {
+  constructor(moduleLoader) {
+    this.instances = /* @__PURE__ */ new Map();
+    this.loading = /* @__PURE__ */ new Map();
+    /** Bumped by invalidate*() so in-flight loads that predate it are discarded. */
+    this.epoch = 0;
+    this.moduleLoader = moduleLoader ?? defaultModuleLoader;
+  }
+  update(world, deltaTime) {
+    const active = /* @__PURE__ */ new Map();
+    for (const entityId of world.query(ScriptObjectComponent)) {
+      const component = world.getComponent(entityId, ScriptObjectComponent);
+      if (!component) continue;
+      const wantsRun = component.enabled && typeof component.scriptUrl === "string" && typeof component.className === "string";
+      if (!wantsRun) {
+        const record = this.instances.get(entityId);
+        if (record) this.teardownRecord(world, entityId, record, false);
+        this.loading.delete(entityId);
+        if (component.runtimeState !== "idle") {
+          component.runtimeState = "idle";
+          component.runtimeMessage = void 0;
+        }
+        continue;
+      }
+      active.set(entityId, component);
+    }
+    for (const [entityId, record] of this.instances) {
+      const component = active.get(entityId);
+      const identityChanged = !component || record.scriptUrl !== component.scriptUrl || record.className !== component.className;
+      if (!world.hasEntity(entityId) || identityChanged) {
+        this.teardownRecord(world, entityId, record, false);
+      }
+    }
+    for (const [entityId, component] of active) {
+      const record = this.instances.get(entityId);
+      if (!record || record.status !== "ready" || !record.instance) continue;
+      if (!world.isEntityVisible(entityId)) continue;
+      if (component.data !== record.lastWrittenData) {
+        try {
+          const merged = mergeDataByCurrentDefaults(
+            record.rawData,
+            normalizeScriptData(component.data)
+          );
+          record.rawData = merged;
+          record.instance.data = resolveInputData(world, merged);
+          const stored = serializeDataForStorage(merged, merged);
+          component.data = stored;
+          record.lastWrittenData = stored;
+        } catch (error) {
+          this.markError(world, entityId, component, error);
+          continue;
+        }
+      }
+      try {
+        record.instance.update?.(deltaTime);
+      } catch (error) {
+        this.markError(world, entityId, component, error);
+      }
+    }
+    for (const [entityId, component] of active) {
+      if (this.instances.has(entityId) || this.loading.has(entityId)) continue;
+      const scriptUrl = component.scriptUrl;
+      const className = component.className;
+      if (component.runtimeState !== "loading") {
+        component.runtimeState = "loading";
+        component.runtimeMessage = void 0;
+      }
+      const epochAtStart = this.epoch;
+      const key = `${epochAtStart}:${scriptUrl}:${className}`;
+      const promise = this.loadScriptObject(
+        world,
+        entityId,
+        scriptUrl,
+        className,
+        key,
+        epochAtStart
+      ).catch((error) => {
+        this.markError(world, entityId, void 0, error);
+        console.error(
+          `[ScriptObjectSystem] Failed loading ${className} (${scriptUrl})`,
+          error
+        );
+      }).finally(() => {
+        if (this.loading.get(entityId)?.key === key) {
+          this.loading.delete(entityId);
+        }
+      });
+      this.loading.set(entityId, { key, promise });
+    }
+    for (const entityId of this.loading.keys()) {
+      if (!active.has(entityId)) this.loading.delete(entityId);
+    }
+  }
+  async loadScriptObject(world, entityId, scriptUrl, className, key, epochAtStart) {
+    const moduleValue = await this.moduleLoader(scriptUrl);
+    if (this.loading.get(entityId)?.key !== key || epochAtStart !== this.epoch || !world.hasEntity(entityId)) {
+      return;
+    }
+    const component = world.getComponent(entityId, ScriptObjectComponent);
+    if (!component || !component.enabled || component.scriptUrl !== scriptUrl || component.className !== className) {
+      return;
+    }
+    const ctor = resolveScriptCtor(moduleValue, className, {
+      baseClass: ScriptObject,
+      markerKey: "__reluScriptObjectClass"
+    });
+    if (!ctor) {
+      throw new Error(
+        `Missing ScriptObject export '${className}' in ${scriptUrl}`
+      );
+    }
+    const currentData = normalizeScriptData(component.data);
+    let instance;
+    try {
+      instance = new ctor(world, entityId, void 0);
+    } catch {
+      instance = new ctor(world, entityId, currentData);
+    }
+    const defaults = normalizeScriptData(instance.data);
+    const merged = mergeDataByCurrentDefaults(defaults, currentData);
+    instance.data = resolveInputData(world, merged);
+    const parent = world.getComponent(entityId, Object3DRef)?.object;
+    if (!parent) {
+      throw new Error("Script object entity has no Object3D to attach to.");
+    }
+    for (const child of [...parent.children]) {
+      if (child.userData?.[SCRIPT_OBJECT_ROOT_FLAG]) {
+        disposeBuiltObject(child);
+      }
+    }
+    let built;
+    try {
+      built = instance.build();
+    } catch (error) {
+      try {
+        instance.dispose?.();
+      } catch {
+      }
+      throw error;
+    }
+    if (!built || built.isObject3D !== true) {
+      try {
+        instance.dispose?.();
+      } catch {
+      }
+      throw new Error("build() must return a THREE.Object3D.");
+    }
+    built.userData[SCRIPT_OBJECT_ROOT_FLAG] = true;
+    parent.add(built);
+    instance.root = built;
+    const stored = serializeDataForStorage(merged, merged);
+    component.data = stored;
+    component.runtimeState = "ready";
+    component.runtimeMessage = void 0;
+    setInstanceRef(component, instance);
+    this.instances.set(entityId, {
+      entityId,
+      scriptUrl,
+      className,
+      status: "ready",
+      instance,
+      root: built,
+      rawData: merged,
+      lastWrittenData: stored
+    });
+  }
+  /** Dispose a record's instance + built subtree. `keepTombstone` leaves an error marker. */
+  teardownRecord(world, entityId, record, keepTombstone) {
+    try {
+      record.instance?.dispose?.();
+    } catch {
+    }
+    if (record.root) disposeBuiltObject(record.root);
+    const component = world.getComponent(entityId, ScriptObjectComponent);
+    if (component) setInstanceRef(component, null);
+    if (keepTombstone) {
+      this.instances.set(entityId, {
+        ...record,
+        status: "error",
+        instance: null,
+        root: null
+      });
+    } else {
+      this.instances.delete(entityId);
+    }
+  }
+  markError(world, entityId, component, error) {
+    const comp = component ?? world.getComponent(entityId, ScriptObjectComponent) ?? null;
+    if (comp) {
+      comp.runtimeState = "error";
+      comp.runtimeMessage = toErrorMessage(error);
+    }
+    const record = this.instances.get(entityId);
+    if (record) {
+      this.teardownRecord(world, entityId, record, true);
+    } else {
+      this.instances.set(entityId, {
+        entityId,
+        scriptUrl: comp?.scriptUrl ?? "",
+        className: comp?.className ?? "",
+        status: "error",
+        instance: null,
+        root: null,
+        rawData: {},
+        lastWrittenData: null
+      });
+    }
+  }
+  /** Dispose all live instances so the next update() reloads with fresh modules. */
+  invalidateAll() {
+    this.epoch += 1;
+    for (const [entityId, record] of [...this.instances]) {
+      try {
+        record.instance?.dispose?.();
+      } catch {
+      }
+      if (record.root) disposeBuiltObject(record.root);
+      this.instances.delete(entityId);
+    }
+    this.loading.clear();
+  }
+  /** Invalidate only the entities whose script matches `scriptUrl`. */
+  invalidate(scriptUrl) {
+    this.epoch += 1;
+    for (const [entityId, record] of [...this.instances]) {
+      if (record.scriptUrl !== scriptUrl) continue;
+      try {
+        record.instance?.dispose?.();
+      } catch {
+      }
+      if (record.root) disposeBuiltObject(record.root);
+      this.instances.delete(entityId);
+    }
+    for (const [entityId, entry] of [...this.loading]) {
+      if (entry.key.includes(`:${scriptUrl}:`)) this.loading.delete(entityId);
+    }
+  }
+  dispose(world) {
+    for (const [entityId, record] of [...this.instances]) {
+      this.teardownRecord(world, entityId, record, false);
+    }
+    this.instances.clear();
+    this.loading.clear();
+  }
+};
+__name(_ScriptObjectSystem, "ScriptObjectSystem");
+var ScriptObjectSystem = _ScriptObjectSystem;
+
 // core/systems/TransformSyncSystem.ts
 var _TransformSyncSystem = class _TransformSyncSystem {
   update(world) {
@@ -5445,6 +5801,6 @@ var _VideoSystem = class _VideoSystem {
 __name(_VideoSystem, "VideoSystem");
 var VideoSystem = _VideoSystem;
 
-export { ADDED_NODE_MARKER_COMPONENT, AnimationSystem, AudioSystem, Behaviour, CameraSyncSystem, EnvironmentSyncSystem, HYDRATABLE_ENTITY_KINDS, InputSystem, InstancedMeshSystem, KeyboardKeys, LightSyncSystem, MaterialSyncSystem, MeshGeometrySystem, NODE_KEY_SEPARATOR, OVERRIDE_DIFF_EXCLUDED_COMPONENTS, OVERRIDE_ROOT_EXCLUDED_COMPONENTS, ObjectVisibilitySystem, PREFAB_FILE_VERSION, PREFAB_FILE_VERSION_NESTED, PhysicsSyncSystem, PostprocessingSyncSystem, RenderSystem, ScriptBehaviourSystem, TransformSyncSystem, VideoSystem, buildComponentValueMaps, buildNodeKeyMapsFromSnapshot, buildNodeMapsFromSnapshot, canonicalizeComponentValue, clearPrefabCache, collectDiffPaths, collectEntitySubtree, collectSnapshotSubtreeIds, computeInstanceOverrides, decanonicalizeComponentValue, despawnPrefab, encodeOverride, findSnapshotRootEntityIds, findTopLevelNestedRegions, groupOverridePaths, hydrateWorldFromSnapshot, hydrateWorldFromSnapshotDetailed, indexSnapshotByEntity, instantiateSubtree, loadPrefab, mergeComponentValue, parseOverride, parsePrefabAsset, prefabFileVersionFor, restoreComponentState, restorePostCreateComponents, setPrefabAssetUrlResolver, spawnPrefab };
-//# sourceMappingURL=chunk-5U3YS4JD.js.map
-//# sourceMappingURL=chunk-5U3YS4JD.js.map
+export { ADDED_NODE_MARKER_COMPONENT, AnimationSystem, AudioSystem, Behaviour, CameraSyncSystem, EnvironmentSyncSystem, HYDRATABLE_ENTITY_KINDS, InputSystem, InstancedMeshSystem, KeyboardKeys, LightSyncSystem, MaterialSyncSystem, MeshGeometrySystem, NODE_KEY_SEPARATOR, OVERRIDE_DIFF_EXCLUDED_COMPONENTS, OVERRIDE_ROOT_EXCLUDED_COMPONENTS, ObjectVisibilitySystem, PREFAB_FILE_VERSION, PREFAB_FILE_VERSION_NESTED, PhysicsSyncSystem, PostprocessingSyncSystem, RenderSystem, SCRIPT_OBJECT_ROOT_FLAG, ScriptBehaviourSystem, ScriptObject, ScriptObjectSystem, TransformSyncSystem, VideoSystem, buildComponentValueMaps, buildNodeKeyMapsFromSnapshot, buildNodeMapsFromSnapshot, canonicalizeComponentValue, clearPrefabCache, collectDiffPaths, collectEntitySubtree, collectSnapshotSubtreeIds, computeInstanceOverrides, decanonicalizeComponentValue, despawnPrefab, encodeOverride, findSnapshotRootEntityIds, findTopLevelNestedRegions, groupOverridePaths, hydrateWorldFromSnapshot, hydrateWorldFromSnapshotDetailed, indexSnapshotByEntity, instantiateSubtree, loadPrefab, mergeComponentValue, parseOverride, parsePrefabAsset, prefabFileVersionFor, restoreComponentState, restorePostCreateComponents, setPrefabAssetUrlResolver, spawnPrefab };
+//# sourceMappingURL=chunk-GZ2NKSMV.js.map
+//# sourceMappingURL=chunk-GZ2NKSMV.js.map