@iwsdk/core 0.4.2 → 0.5.0

package/dist/ecs/world.d.ts

@@ -4,15 +4,17 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
+import type { SceneDocument } from '@iwsdk/scene-composition';
+import type { SceneComponentCatalog } from '@iwsdk/scene-composition';
 import { XROrigin } from '@iwsdk/xr-input';
 import { Signal } from '@preact/signals-core';
 import { AnyComponent, World as ElicsWorld } from 'elics';
-import { AssetManager } from '../asset/index.js';
+import { AssetManager, RenderableAssetRegistry } from '../asset/index.js';
 import type { WorldOptions } from '../init/world-initializer.js';
 import type { XROptions } from '../init/xr.js';
 import type { InputManager } from '../input/index.js';
 import type { MCPRuntime } from '../mcp/index.js';
-import { Object3D, PerspectiveCamera, Scene, WebGLRenderer } from '../runtime/index.js';
+import { Object3D, PerspectiveCamera, Scene, Vector3, WebGLRenderer } from '../runtime/index.js';
 import { Entity } from './entity.js';
 export declare enum VisibilityState {
     NonImmersive = "non-immersive",
@@ -25,6 +27,17 @@ export type GradientColors = {
     equator: number;
     ground: number;
 };
+/**
+ * Callback invoked once per render-loop tick while an XR session is active,
+ * registered via {@link World.onXRFrame}.
+ *
+ * @param frame The live {@link XRFrame} for this tick. Only valid synchronously
+ *   inside the callback — do not retain it across ticks.
+ * @param delta Seconds since the previous frame.
+ * @param time  Accumulated render-loop time in seconds (monotonic within a session).
+ * @category XR Runtime
+ */
+export type OnXRFrameCallback = (frame: XRFrame, delta: number, time: number) => void;
 /**
  * World is the root ECS container, Three.js scene/renderer owner, and XR session gateway.
  *
@@ -44,7 +57,7 @@ export type GradientColors = {
  * const world = await World.create(container, {
  *   xr: { sessionMode: SessionMode.ImmersiveVR },
  *   features: { enableLocomotion: true, enableGrabbing: true },
- *   level: '/glxf/Composition.glxf'
+ *   level: '/scenes/main.iwsdk.scene.json'
  * });
  * ```
  */
@@ -52,6 +65,10 @@ export declare class World extends ElicsWorld {
     input: InputManager;
     player: XROrigin;
     assetManager: typeof AssetManager;
+    /** Renderable assets registered by the application manifest. */
+    assets: RenderableAssetRegistry;
+    /** Component definitions shared by scene validation and editor tooling. */
+    componentCatalog: SceneComponentCatalog;
     scene: Scene;
     sceneEntity: Entity;
     activeLevel: Signal<Entity>;
@@ -61,12 +78,24 @@ export declare class World extends ElicsWorld {
     renderer: WebGLRenderer;
     session: XRSession | undefined;
     visibilityState: Signal<VisibilityState>;
+    /** Whether this world was created with XR support enabled. */
+    xrEnabled: boolean;
     requestedLevelUrl: string | undefined;
+    requestedLevelDocument: SceneDocument | undefined;
     _resolveLevelLoad: (() => void) | undefined;
+    _rejectLevelLoad: ((reason: unknown) => void) | undefined;
     /** Default XR options used when calling {@link World.launchXR} without overrides. */
     xrDefaults: import('../init/xr.js').XROptions | undefined;
     /** MCP runtime for framework-specific tools. Set automatically during World.create(). */
     mcpRuntime?: MCPRuntime;
+    /** Teardown callbacks run by {@link World.destroy} (render loop, global listeners). */
+    private worldCleanupFuncs;
+    /** Guards {@link World.destroy} so a second call is a no-op. */
+    private destroyed;
+    private authoredPlayerPosition?;
+    private authoredPlayerPositionListeners;
+    /** Per-frame XR callbacks registered via {@link World.onXRFrame}. */
+    private xrFrameCallbacks;
     /** Entity wrapping the XROrigin Group (persistent, survives level changes). */
     playerEntity: Entity;
     /** Entity wrapping the player head Group (persistent). */
@@ -98,14 +127,139 @@ export declare class World extends ElicsWorld {
      */
     private disposeObject3DResources;
     createEntity(): Entity;
+    /** @internal Publish scene-authored player placement to locomotion owners. */
+    setAuthoredPlayerPosition(position: Vector3): void;
+    /** @internal Reconcile a locomotion owner with scene-authored placement. */
+    onAuthoredPlayerPosition(listener: (position: Vector3) => void): () => void;
     createTransformEntity(object?: Object3D, parentOrOptions?: Entity | {
         parent?: Entity;
         persistent?: boolean;
     }): Entity;
+    /** Find an authored scene object by its stable scene node id. */
+    getSceneObject<T extends Object3D = Object3D>(nodeId: string): T | undefined;
+    /** Find an authored scene object or throw a node-oriented lookup error. */
+    requireSceneObject<T extends Object3D = Object3D>(nodeId: string): T;
+    /** Find the ECS entity that owns an authored scene node. */
+    getSceneEntity(nodeId: string): Entity | undefined;
+    /** Find the ECS entity for an authored scene node or throw. */
+    requireSceneEntity(nodeId: string): Entity;
     launchXR(xrOptions?: Partial<XROptions>): void;
-    /** Request a level change; LevelSystem performs the work and resolves. */
+    /** Request a native scene JSON level change; LevelSystem performs the work and resolves. */
     loadLevel(url?: string): Promise<void>;
+    /** Request an in-memory native scene document level load; LevelSystem performs the work and resolves. */
+    loadSceneDocument(document: SceneDocument): Promise<void>;
     exitXR(): void;
+    private rejectPendingLevelLoad;
+    /**
+     * The active {@link XRSession}, or `undefined` outside XR. Alias of
+     * {@link World.session}, exposed for discoverability alongside
+     * {@link World.xrFrame} and {@link World.xrReferenceSpace}.
+     *
+     * @remarks
+     * Enable WebXR features your app needs (e.g. hit-test, depth sensing) via
+     * `World.create(container, { xr: { features: { hitTest: true, depthSensing: true } } })`.
+     * Once granted, they appear in `world.xrSession.enabledFeatures`.
+     * @category XR Runtime
+     */
+    get xrSession(): XRSession | undefined;
+    /**
+     * The current {@link XRFrame} for this animation-loop tick, or `null` outside
+     * XR. Use it for raw WebXR access such as `frame.getViewerPose(...)`,
+     * `frame.getHitTestResults(...)`, or `frame.getDepthInformation(...)`.
+     *
+     * @remarks
+     * Read this synchronously inside an {@link World.onXRFrame} callback or a
+     * System `update()` — the frame object is only valid for the current tick and
+     * must not be retained across frames.
+     * @category XR Runtime
+     */
+    get xrFrame(): XRFrame | null;
+    /**
+     * The active {@link XRReferenceSpace} that IWSDK resolved for the session, or
+     * `null` outside XR. Pass it to `XRHitTestResult.getPose(space)` or
+     * `XRFrame.getViewerPose(space)` to obtain poses in the world's tracking space.
+     * @category XR Runtime
+     */
+    get xrReferenceSpace(): XRReferenceSpace | null;
+    /**
+     * Register a callback that runs once per render-loop tick with the live
+     * {@link XRFrame}, without having to author a System. Useful for per-pixel
+     * world alignment, hit-test queries, depth sampling, and object-anchored
+     * overlays.
+     *
+     * @param callback Invoked with `(frame, delta, time)` while an XR session is active.
+     * @returns An unsubscribe function; call it to stop receiving frames.
+     * @category XR Runtime
+     * @example
+     * ```ts
+     * const source = await world.requestHitTestSource({ space: world.xrReferenceSpace! });
+     * const stop = world.onXRFrame((frame) => {
+     *   if (!source) return;
+     *   const [hit] = world.getHitTestResults(source);
+     *   const pose = hit?.getPose(world.xrReferenceSpace!);
+     *   // place a world-locked label at pose.transform.position ...
+     * });
+     * ```
+     */
+    onXRFrame(callback: OnXRFrameCallback): () => void;
+    /**
+     * Invoke all callbacks registered via {@link World.onXRFrame}. Called by the
+     * render loop after systems update and before rendering.
+     * @internal
+     */
+    runXRFrameCallbacks(frame: XRFrame, delta: number, time: number): void;
+    /**
+     * Request an {@link XRHitTestSource} on the active session. Requires the
+     * `hit-test` feature (enable via
+     * `World.create(container, { xr: { features: { hitTest: true } } })`).
+     *
+     * @returns The hit-test source, or `undefined` if there is no active session
+     *   or the request is unavailable/unsupported. The underlying
+     *   `XRSession.requestHitTestSource` rejects when the `hit-test` feature was
+     *   not granted; that rejection is caught and surfaced as `undefined` (logged
+     *   as a warning) so callers can `await` without their own `try/catch`.
+     * @category XR Runtime
+     */
+    requestHitTestSource(options: XRHitTestOptionsInit): Promise<XRHitTestSource | undefined>;
+    /**
+     * Request an {@link XRTransientInputHitTestSource} (e.g. for screen taps or
+     * transient controllers). Requires the `hit-test` feature.
+     *
+     * @returns The transient hit-test source, or `undefined` if unavailable. As
+     *   with {@link World.requestHitTestSource}, a rejection from the underlying
+     *   WebXR call (e.g. feature not granted) is caught and surfaced as
+     *   `undefined`.
+     * @category XR Runtime
+     */
+    requestHitTestSourceForTransientInput(options: XRTransientInputHitTestOptionsInit): Promise<XRTransientInputHitTestSource | undefined>;
+    /**
+     * Read the hit-test results for a source from the current {@link XRFrame}.
+     * Returns an empty array when there is no active frame.
+     * @category XR Runtime
+     */
+    getHitTestResults(source: XRHitTestSource): XRHitTestResult[];
+    /**
+     * Register a teardown callback to run on {@link World.destroy}. Used by the
+     * initializer to undo global side effects such as the render loop and the
+     * window `resize` listener.
+     *
+     * @internal
+     */
+    addCleanup(fn: () => void): void;
+    /**
+     * Tear down the world: destroy all registered systems (running their
+     * `cleanupFuncs`), then run world-level teardown callbacks (stop the render
+     * loop, remove the window `resize` listener). After calling this the world
+     * instance should be discarded.
+     *
+     * @remarks
+     * Not invoked during normal single-world app usage (where the world lives for
+     * the page lifetime); provided so tests, hot-reload, and multi-world hosts can
+     * release the render loop, listeners, and per-system subscriptions instead of
+     * leaking them. Individual failures are caught so one bad teardown does not
+     * block the rest.
+     */
+    destroy(): void;
     update(delta: number, time: number): void;
     registerComponent(component: AnyComponent): this;
     getActiveRoot(): Object3D;

package/dist/ecs/world.d.ts.map

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

package/dist/ecs/world.js

@@ -3,8 +3,10 @@ import { World as World$1 } from 'elics';
 import { launchXR } from '../init/xr.js';
 import { LevelTag } from '../level/level-tag.js';
 import '../runtime/three.js';
-import { Transform } from '../transform/transform.js';
-import { Object3D } from 'three';
+import '../transform/transform.js';
+import { Visibility } from '../visibility/visibility-component.js';
+import { Transform } from '../transform/transform-component.js';
+import { Vector3, Object3D } from 'three';
 
 /**
  * Copyright (c) Meta Platforms, Inc. and affiliates.
@@ -38,7 +40,7 @@ var VisibilityState;
  * const world = await World.create(container, {
  *   xr: { sessionMode: SessionMode.ImmersiveVR },
  *   features: { enableLocomotion: true, enableGrabbing: true },
- *   level: '/glxf/Composition.glxf'
+ *   level: '/scenes/main.iwsdk.scene.json'
  * });
  * ```
  */
@@ -47,11 +49,25 @@ class World extends World$1 {
         super();
         this.activeLevelId = 'level:default';
         this.visibilityState = signal(VisibilityState.NonImmersive);
+        /** Whether this world was created with XR support enabled. */
+        this.xrEnabled = true;
+        /** Teardown callbacks run by {@link World.destroy} (render loop, global listeners). */
+        this.worldCleanupFuncs = [];
+        /** Guards {@link World.destroy} so a second call is a no-op. */
+        this.destroyed = false;
+        this.authoredPlayerPositionListeners = new Set();
+        /** Per-frame XR callbacks registered via {@link World.onXRFrame}. */
+        this.xrFrameCallbacks = new Set();
         const originalReleaseFunc = this.entityManager.releaseEntityInstance.bind(this.entityManager);
         this.entityManager.releaseEntityInstance = (entity) => {
             originalReleaseFunc(entity);
             const obj = entity.object3D;
             if (obj) {
+                const disposeAsset = obj.userData.iwsdkDisposeAsset;
+                if (typeof disposeAsset === 'function') {
+                    obj.userData.iwsdkDisposeAsset = null;
+                    disposeAsset();
+                }
                 // Check if entity was marked for resource disposal
                 if (entity._disposeResources) {
                     this.disposeObject3DResources(obj);
@@ -100,10 +116,28 @@ class World extends World$1 {
     createEntity() {
         return super.createEntity();
     }
+    /** @internal Publish scene-authored player placement to locomotion owners. */
+    setAuthoredPlayerPosition(position) {
+        var _a;
+        (_a = this.authoredPlayerPosition) !== null && _a !== void 0 ? _a : (this.authoredPlayerPosition = new Vector3());
+        this.authoredPlayerPosition.copy(position);
+        for (const listener of this.authoredPlayerPositionListeners) {
+            listener(this.authoredPlayerPosition);
+        }
+    }
+    /** @internal Reconcile a locomotion owner with scene-authored placement. */
+    onAuthoredPlayerPosition(listener) {
+        this.authoredPlayerPositionListeners.add(listener);
+        if (this.authoredPlayerPosition != null) {
+            listener(this.authoredPlayerPosition);
+        }
+        return () => this.authoredPlayerPositionListeners.delete(listener);
+    }
     createTransformEntity(object, parentOrOptions) {
         var _a, _b;
         const entity = super.createEntity();
         const obj = object !== null && object !== void 0 ? object : new Object3D();
+        const initialVisible = obj.visible;
         // Cast to pointer-events-capable Object3D event map for downstream typing
         entity.object3D = obj;
         let parent = undefined;
@@ -131,27 +165,292 @@ class World extends World$1 {
                     : ((_b = (_a = this.activeLevel) === null || _a === void 0 ? void 0 : _a.value) !== null && _b !== void 0 ? _b : this.sceneEntity);
             }
         }
+        const parentObject = parent === null || parent === void 0 ? void 0 : parent.object3D;
+        if (parentObject && parentObject !== obj && obj.parent !== parentObject) {
+            parentObject.add(obj);
+        }
         entity.addComponent(Transform, { parent });
+        entity.addComponent(Visibility, { isVisible: initialVisible });
         // Tag entity with current level, unless persistent
         if (!persistent) {
             entity.addComponent(LevelTag, { id: this.activeLevelId });
         }
         return entity;
     }
+    /** Find an authored scene object by its stable scene node id. */
+    getSceneObject(nodeId) {
+        var _a, _b, _c;
+        let result;
+        for (const root of [
+            (_b = (_a = this.activeLevel) === null || _a === void 0 ? void 0 : _a.value) === null || _b === void 0 ? void 0 : _b.object3D,
+            (_c = this.playerEntity) === null || _c === void 0 ? void 0 : _c.object3D,
+        ]) {
+            if (root == null) {
+                continue;
+            }
+            root.traverse((object) => {
+                if (!result &&
+                    object.userData.iwsdkSceneNodeId === nodeId &&
+                    (object.userData.iwsdkSceneLevelId == null ||
+                        object.userData.iwsdkSceneLevelId === this.activeLevelId)) {
+                    result = object;
+                }
+            });
+        }
+        return result;
+    }
+    /** Find an authored scene object or throw a node-oriented lookup error. */
+    requireSceneObject(nodeId) {
+        const object = this.getSceneObject(nodeId);
+        if (!object) {
+            throw new Error(`Scene object "${nodeId}" was not found in the active level`);
+        }
+        return object;
+    }
+    /** Find the ECS entity that owns an authored scene node. */
+    getSceneEntity(nodeId) {
+        var _a;
+        const index = (_a = this.getSceneObject(nodeId)) === null || _a === void 0 ? void 0 : _a.entityIdx;
+        return typeof index === 'number'
+            ? this.entityManager.getEntityByIndex(index)
+            : undefined;
+    }
+    /** Find the ECS entity for an authored scene node or throw. */
+    requireSceneEntity(nodeId) {
+        const entity = this.getSceneEntity(nodeId);
+        if (!entity) {
+            throw new Error(`Scene entity "${nodeId}" was not found in the active level`);
+        }
+        return entity;
+    }
     launchXR(xrOptions) {
         launchXR(this, xrOptions);
     }
-    /** Request a level change; LevelSystem performs the work and resolves. */
+    /** Request a native scene JSON level change; LevelSystem performs the work and resolves. */
     async loadLevel(url) {
+        this.rejectPendingLevelLoad();
+        this.requestedLevelDocument = undefined;
         this.requestedLevelUrl = url !== null && url !== void 0 ? url : '';
-        return new Promise((resolve) => {
+        return new Promise((resolve, reject) => {
+            this._resolveLevelLoad = resolve;
+            this._rejectLevelLoad = reject;
+        });
+    }
+    /** Request an in-memory native scene document level load; LevelSystem performs the work and resolves. */
+    async loadSceneDocument(document) {
+        this.rejectPendingLevelLoad();
+        this.requestedLevelUrl = undefined;
+        this.requestedLevelDocument = document;
+        return new Promise((resolve, reject) => {
             this._resolveLevelLoad = resolve;
+            this._rejectLevelLoad = reject;
         });
     }
     exitXR() {
         var _a;
         (_a = this.session) === null || _a === void 0 ? void 0 : _a.end();
     }
+    rejectPendingLevelLoad() {
+        if (this._resolveLevelLoad == null && this._rejectLevelLoad == null) {
+            return;
+        }
+        const reject = this._rejectLevelLoad;
+        this._resolveLevelLoad = undefined;
+        this._rejectLevelLoad = undefined;
+        reject === null || reject === void 0 ? void 0 : reject(new Error('Level load was superseded by a newer request'));
+    }
+    /**
+     * The active {@link XRSession}, or `undefined` outside XR. Alias of
+     * {@link World.session}, exposed for discoverability alongside
+     * {@link World.xrFrame} and {@link World.xrReferenceSpace}.
+     *
+     * @remarks
+     * Enable WebXR features your app needs (e.g. hit-test, depth sensing) via
+     * `World.create(container, { xr: { features: { hitTest: true, depthSensing: true } } })`.
+     * Once granted, they appear in `world.xrSession.enabledFeatures`.
+     * @category XR Runtime
+     */
+    get xrSession() {
+        return this.session;
+    }
+    /**
+     * The current {@link XRFrame} for this animation-loop tick, or `null` outside
+     * XR. Use it for raw WebXR access such as `frame.getViewerPose(...)`,
+     * `frame.getHitTestResults(...)`, or `frame.getDepthInformation(...)`.
+     *
+     * @remarks
+     * Read this synchronously inside an {@link World.onXRFrame} callback or a
+     * System `update()` — the frame object is only valid for the current tick and
+     * must not be retained across frames.
+     * @category XR Runtime
+     */
+    get xrFrame() {
+        var _a, _b;
+        return (_b = (_a = this.renderer) === null || _a === void 0 ? void 0 : _a.xr.getFrame()) !== null && _b !== void 0 ? _b : null;
+    }
+    /**
+     * The active {@link XRReferenceSpace} that IWSDK resolved for the session, or
+     * `null` outside XR. Pass it to `XRHitTestResult.getPose(space)` or
+     * `XRFrame.getViewerPose(space)` to obtain poses in the world's tracking space.
+     * @category XR Runtime
+     */
+    get xrReferenceSpace() {
+        var _a, _b;
+        return (_b = (_a = this.renderer) === null || _a === void 0 ? void 0 : _a.xr.getReferenceSpace()) !== null && _b !== void 0 ? _b : null;
+    }
+    /**
+     * Register a callback that runs once per render-loop tick with the live
+     * {@link XRFrame}, without having to author a System. Useful for per-pixel
+     * world alignment, hit-test queries, depth sampling, and object-anchored
+     * overlays.
+     *
+     * @param callback Invoked with `(frame, delta, time)` while an XR session is active.
+     * @returns An unsubscribe function; call it to stop receiving frames.
+     * @category XR Runtime
+     * @example
+     * ```ts
+     * const source = await world.requestHitTestSource({ space: world.xrReferenceSpace! });
+     * const stop = world.onXRFrame((frame) => {
+     *   if (!source) return;
+     *   const [hit] = world.getHitTestResults(source);
+     *   const pose = hit?.getPose(world.xrReferenceSpace!);
+     *   // place a world-locked label at pose.transform.position ...
+     * });
+     * ```
+     */
+    onXRFrame(callback) {
+        this.xrFrameCallbacks.add(callback);
+        return () => {
+            this.xrFrameCallbacks.delete(callback);
+        };
+    }
+    /**
+     * Invoke all callbacks registered via {@link World.onXRFrame}. Called by the
+     * render loop after systems update and before rendering.
+     * @internal
+     */
+    runXRFrameCallbacks(frame, delta, time) {
+        if (this.xrFrameCallbacks.size === 0) {
+            return;
+        }
+        for (const callback of this.xrFrameCallbacks) {
+            try {
+                callback(frame, delta, time);
+            }
+            catch (error) {
+                console.error('[World] onXRFrame callback failed:', error);
+            }
+        }
+    }
+    /**
+     * Request an {@link XRHitTestSource} on the active session. Requires the
+     * `hit-test` feature (enable via
+     * `World.create(container, { xr: { features: { hitTest: true } } })`).
+     *
+     * @returns The hit-test source, or `undefined` if there is no active session
+     *   or the request is unavailable/unsupported. The underlying
+     *   `XRSession.requestHitTestSource` rejects when the `hit-test` feature was
+     *   not granted; that rejection is caught and surfaced as `undefined` (logged
+     *   as a warning) so callers can `await` without their own `try/catch`.
+     * @category XR Runtime
+     */
+    async requestHitTestSource(options) {
+        const session = this.session;
+        if (!(session === null || session === void 0 ? void 0 : session.requestHitTestSource)) {
+            return undefined;
+        }
+        try {
+            return await session.requestHitTestSource(options);
+        }
+        catch (error) {
+            console.warn("[World] requestHitTestSource failed (is the 'hit-test' feature enabled?):", error);
+            return undefined;
+        }
+    }
+    /**
+     * Request an {@link XRTransientInputHitTestSource} (e.g. for screen taps or
+     * transient controllers). Requires the `hit-test` feature.
+     *
+     * @returns The transient hit-test source, or `undefined` if unavailable. As
+     *   with {@link World.requestHitTestSource}, a rejection from the underlying
+     *   WebXR call (e.g. feature not granted) is caught and surfaced as
+     *   `undefined`.
+     * @category XR Runtime
+     */
+    async requestHitTestSourceForTransientInput(options) {
+        const session = this.session;
+        if (!(session === null || session === void 0 ? void 0 : session.requestHitTestSourceForTransientInput)) {
+            return undefined;
+        }
+        try {
+            return await session.requestHitTestSourceForTransientInput(options);
+        }
+        catch (error) {
+            console.warn("[World] requestHitTestSourceForTransientInput failed (is the 'hit-test' feature enabled?):", error);
+            return undefined;
+        }
+    }
+    /**
+     * Read the hit-test results for a source from the current {@link XRFrame}.
+     * Returns an empty array when there is no active frame.
+     * @category XR Runtime
+     */
+    getHitTestResults(source) {
+        const frame = this.xrFrame;
+        if (!frame) {
+            return [];
+        }
+        return frame.getHitTestResults(source);
+    }
+    /**
+     * Register a teardown callback to run on {@link World.destroy}. Used by the
+     * initializer to undo global side effects such as the render loop and the
+     * window `resize` listener.
+     *
+     * @internal
+     */
+    addCleanup(fn) {
+        this.worldCleanupFuncs.push(fn);
+    }
+    /**
+     * Tear down the world: destroy all registered systems (running their
+     * `cleanupFuncs`), then run world-level teardown callbacks (stop the render
+     * loop, remove the window `resize` listener). After calling this the world
+     * instance should be discarded.
+     *
+     * @remarks
+     * Not invoked during normal single-world app usage (where the world lives for
+     * the page lifetime); provided so tests, hot-reload, and multi-world hosts can
+     * release the render loop, listeners, and per-system subscriptions instead of
+     * leaking them. Individual failures are caught so one bad teardown does not
+     * block the rest.
+     */
+    destroy() {
+        var _a, _b;
+        // Idempotent: getSystems() keeps returning the same systems, so without
+        // this guard a second destroy() would re-run every system's destroy().
+        if (this.destroyed) {
+            return;
+        }
+        this.destroyed = true;
+        for (const system of this.getSystems()) {
+            try {
+                (_b = (_a = system).destroy) === null || _b === void 0 ? void 0 : _b.call(_a);
+            }
+            catch (error) {
+                console.error('[World] system destroy failed:', error);
+            }
+        }
+        const fns = this.worldCleanupFuncs.splice(0);
+        for (const fn of fns) {
+            try {
+                fn();
+            }
+            catch (error) {
+                console.error('[World] cleanup failed:', error);
+            }
+        }
+    }
     update(delta, time) {
         super.update(delta, time);
     }

package/dist/ecs/world.js.map

@@ -1 +1 @@
-{"version":3,"file":"world.js","sources":["../../src/ecs/world.ts"],"sourcesContent":[null],"names":["ElicsWorld"],"mappings":"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"}
+{"version":3,"file":"world.js","sources":["../../src/ecs/world.ts"],"sourcesContent":[null],"names":["ElicsWorld"],"mappings":";;;;;;;;;;AAAA;;;;;AAKG;IA2CS;AAAZ,CAAA,UAAY,eAAe,EAAA;AACzB,IAAA,eAAA,CAAA,cAAA,CAAA,GAAA,eAA8B;AAC9B,IAAA,eAAA,CAAA,QAAA,CAAA,GAAA,QAAiB;AACjB,IAAA,eAAA,CAAA,SAAA,CAAA,GAAA,SAAmB;AACnB,IAAA,eAAA,CAAA,gBAAA,CAAA,GAAA,iBAAkC;AACpC,CAAC,EALW,eAAe,KAAf,eAAe,GAAA,EAAA,CAAA,CAAA;AA6B3B;;;;;;;;;;;;;;;;;;;;;;AAsBG;AACG,MAAO,KAAM,SAAQA,OAAU,CAAA;AAmDnC,IAAA,WAAA,GAAA;AACE,QAAA,KAAK,EAAE;QAzCF,IAAA,CAAA,aAAa,GAAW,eAAe;AAKvC,QAAA,IAAA,CAAA,eAAe,GAAG,MAAM,CAAC,eAAe,CAAC,YAAY,CAAC;;QAEtD,IAAA,CAAA,SAAS,GAAG,IAAI;;QAWf,IAAA,CAAA,iBAAiB,GAAsB,EAAE;;QAEzC,IAAA,CAAA,SAAS,GAAG,KAAK;AAEjB,QAAA,IAAA,CAAA,+BAA+B,GAAG,IAAI,GAAG,EAE9C;;AAEK,QAAA,IAAA,CAAA,gBAAgB,GAAG,IAAI,GAAG,EAAqB;AAgBrD,QAAA,MAAM,mBAAmB,GAAG,IAAI,CAAC,aAAa,CAAC,qBAAqB,CAAC,IAAI,CACvE,IAAI,CAAC,aAAa,CACnB;QACD,IAAI,CAAC,aAAa,CAAC,qBAAqB,GAAG,CAAC,MAAc,KAAI;YAC5D,mBAAmB,CAAC,MAAM,CAAC;AAC3B,YAAA,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ;YAC3B,IAAI,GAAG,EAAE;AACP,gBAAA,MAAM,YAAY,GAAG,GAAG,CAAC,QAAQ,CAAC,iBAAiB;AACnD,gBAAA,IAAI,OAAO,YAAY,KAAK,UAAU,EAAE;AACtC,oBAAA,GAAG,CAAC,QAAQ,CAAC,iBAAiB,GAAG,IAAI;AACrC,oBAAA,YAAY,EAAE;gBAChB;;AAEA,gBAAA,IAAK,MAAc,CAAC,iBAAiB,EAAE;AACrC,oBAAA,IAAI,CAAC,wBAAwB,CAAC,GAAG,CAAC;oBAClC,OAAQ,MAAc,CAAC,iBAAiB;gBAC1C;gBACA,GAAG,CAAC,gBAAgB,EAAE;gBACtB,OAAO,MAAM,CAAC,QAAQ;YACxB;AACF,QAAA,CAAC;IACH;AAEA;;;;;;;AAOG;AACK,IAAA,wBAAwB,CAAC,MAAgB,EAAA;AAC/C,QAAA,MAAM,CAAC,QAAQ,CAAC,CAAC,KAAU,KAAI;;AAE7B,YAAA,IAAI,KAAK,CAAC,QAAQ,EAAE;AAClB,gBAAA,KAAK,CAAC,QAAQ,CAAC,OAAO,EAAE;YAC1B;;AAGA,YAAA,IAAI,KAAK,CAAC,QAAQ,EAAE;gBAClB,MAAM,SAAS,GAAe,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ;sBACtD,KAAK,CAAC;AACR,sBAAE,CAAC,KAAK,CAAC,QAAQ,CAAC;AAEpB,gBAAA,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE;;oBAEhC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE;AACvC,wBAAA,MAAM,KAAK,GAAI,QAAgB,CAAC,GAAG,CAAC;wBACpC,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,UAAU,EAAE;;AAEhD,4BAAA,IAAI,KAAK,CAAC,SAAS,EAAE;gCACnB,KAAK,CAAC,OAAO,EAAE;4BACjB;wBACF;oBACF;oBACA,QAAQ,CAAC,OAAO,EAAE;gBACpB;YACF;AACF,QAAA,CAAC,CAAC;IACJ;IAEA,YAAY,GAAA;AACV,QAAA,OAAO,KAAK,CAAC,YAAY,EAAY;IACvC;;AAGA,IAAA,yBAAyB,CAAC,QAAiB,EAAA;;QACzC,CAAA,EAAA,GAAA,IAAI,CAAC,sBAAsB,MAAA,IAAA,IAAA,EAAA,KAAA,MAAA,GAAA,EAAA,IAA3B,IAAI,CAAC,sBAAsB,GAAK,IAAI,OAAO,EAAE,CAAA;AAC7C,QAAA,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,QAAQ,CAAC;AAC1C,QAAA,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,+BAA+B,EAAE;AAC3D,YAAA,QAAQ,CAAC,IAAI,CAAC,sBAAsB,CAAC;QACvC;IACF;;AAGA,IAAA,wBAAwB,CAAC,QAAqC,EAAA;AAC5D,QAAA,IAAI,CAAC,+BAA+B,CAAC,GAAG,CAAC,QAAQ,CAAC;AAClD,QAAA,IAAI,IAAI,CAAC,sBAAsB,IAAI,IAAI,EAAE;AACvC,YAAA,QAAQ,CAAC,IAAI,CAAC,sBAAsB,CAAC;QACvC;QACA,OAAO,MAAM,IAAI,CAAC,+BAA+B,CAAC,MAAM,CAAC,QAAQ,CAAC;IACpE;IAEA,qBAAqB,CACnB,MAAiB,EACjB,eAAoE,EAAA;;AAEpE,QAAA,MAAM,MAAM,GAAG,KAAK,CAAC,YAAY,EAAY;QAC7C,MAAM,GAAG,GAAG,MAAM,KAAA,IAAA,IAAN,MAAM,KAAA,MAAA,GAAN,MAAM,GAAI,IAAI,QAAQ,EAAE;AACpC,QAAA,MAAM,cAAc,GAAG,GAAG,CAAC,OAAO;;AAElC,QAAA,MAAM,CAAC,QAAQ,GAAG,GAEjB;QAED,IAAI,MAAM,GAAuB,SAAS;QAC1C,IAAI,UAAU,GAAG,KAAK;QAEtB,IAAI,eAAe,EAAE;AACnB,YAAA,IAAI,OAAQ,eAAuB,CAAC,KAAK,KAAK,QAAQ,EAAE;gBACtD,MAAM,GAAG,eAAyB;YACpC;iBAAO;gBACL,MAAM,IAAI,GAAG,eAGZ;AACD,gBAAA,MAAM,GAAG,IAAI,CAAC,MAAM;AACpB,gBAAA,UAAU,GAAG,CAAC,CAAC,IAAI,CAAC,UAAU;YAChC;QACF;QAEA,IAAI,CAAC,MAAM,EAAE;;AAEX,YAAA,MAAM,aAAa,GAAG,CAAC,GAAa,KAAM,GAAW,CAAC,OAAO,KAAK,IAAI;AACtE,YAAA,IAAI,MAAM,IAAI,aAAa,CAAC,MAAM,CAAC,EAAE;gBACnC,MAAM,GAAG,SAAS;gBAClB,UAAU,GAAG,IAAI;YACnB;iBAAO;AACL,gBAAA,MAAM,GAAG;sBACL,IAAI,CAAC;AACP,uBAAG,CAAA,EAAA,GAAA,CAAA,EAAA,GAAA,IAAI,CAAC,WAAW,MAAA,IAAA,IAAA,EAAA,KAAA,MAAA,GAAA,MAAA,GAAA,EAAA,CAAE,KAAK,MAAA,IAAA,IAAA,EAAA,KAAA,MAAA,GAAA,EAAA,GAAI,IAAI,CAAC,WAAW,CAAC;YACnD;QACF;QAEA,MAAM,YAAY,GAAG,MAAM,KAAA,IAAA,IAAN,MAAM,KAAA,MAAA,GAAA,MAAA,GAAN,MAAM,CAAE,QAAQ;AACrC,QAAA,IAAI,YAAY,IAAI,YAAY,KAAK,GAAG,IAAI,GAAG,CAAC,MAAM,KAAK,YAAY,EAAE;AACvE,YAAA,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC;QACvB;QAEA,MAAM,CAAC,YAAY,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,CAAC;QAC1C,MAAM,CAAC,YAAY,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,cAAc,EAAE,CAAC;;QAG9D,IAAI,CAAC,UAAU,EAAE;AACf,YAAA,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,aAAa,EAAE,CAAC;QAC3D;AACA,QAAA,OAAO,MAAM;IACf;;AAGA,IAAA,cAAc,CAAgC,MAAc,EAAA;;AAC1D,QAAA,IAAI,MAA4B;QAChC,KAAK,MAAM,IAAI,IAAI;AACjB,YAAA,CAAA,EAAA,GAAA,MAAA,IAAI,CAAC,WAAW,MAAA,IAAA,IAAA,EAAA,KAAA,MAAA,GAAA,MAAA,GAAA,EAAA,CAAE,KAAK,0CAAE,QAAQ;AACjC,YAAA,CAAA,EAAA,GAAA,IAAI,CAAC,YAAY,MAAA,IAAA,IAAA,EAAA,KAAA,MAAA,GAAA,MAAA,GAAA,EAAA,CAAE,QAAQ;AAC5B,SAAA,EAAE;AACD,YAAA,IAAI,IAAI,IAAI,IAAI,EAAE;gBAChB;YACF;AACA,YAAA,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,KAAI;AACvB,gBAAA,IACE,CAAC,MAAM;AACP,oBAAA,MAAM,CAAC,QAAQ,CAAC,gBAAgB,KAAK,MAAM;AAC3C,qBAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,IAAI,IAAI;wBACxC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,KAAK,IAAI,CAAC,aAAa,CAAC,EAC3D;oBACA,MAAM,GAAG,MAAM;gBACjB;AACF,YAAA,CAAC,CAAC;QACJ;AACA,QAAA,OAAO,MAAuB;IAChC;;AAGA,IAAA,kBAAkB,CAAgC,MAAc,EAAA;QAC9D,MAAM,MAAM,GAAG,IAAI,CAAC,cAAc,CAAI,MAAM,CAAC;QAC7C,IAAI,CAAC,MAAM,EAAE;AACX,YAAA,MAAM,IAAI,KAAK,CACb,iBAAiB,MAAM,CAAA,mCAAA,CAAqC,CAC7D;QACH;AACA,QAAA,OAAO,MAAM;IACf;;AAGA,IAAA,cAAc,CAAC,MAAc,EAAA;;QAC3B,MAAM,KAAK,GAAG,CAAA,EAAA,GAAA,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,MAAA,IAAA,IAAA,EAAA,KAAA,MAAA,GAAA,MAAA,GAAA,EAAA,CAAE,SAAS;QACpD,OAAO,OAAO,KAAK,KAAK;cACnB,IAAI,CAAC,aAAa,CAAC,gBAAgB,CAAC,KAAK;cAC1C,SAAS;IACf;;AAGA,IAAA,kBAAkB,CAAC,MAAc,EAAA;QAC/B,MAAM,MAAM,GAAG,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC;QAC1C,IAAI,CAAC,MAAM,EAAE;AACX,YAAA,MAAM,IAAI,KAAK,CACb,iBAAiB,MAAM,CAAA,mCAAA,CAAqC,CAC7D;QACH;AACA,QAAA,OAAO,MAAM;IACf;AAEA,IAAA,QAAQ,CAAC,SAA8B,EAAA;AACrC,QAAA,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAC3B;;IAGA,MAAM,SAAS,CAAC,GAAY,EAAA;QAC1B,IAAI,CAAC,sBAAsB,EAAE;AAC7B,QAAA,IAAI,CAAC,sBAAsB,GAAG,SAAS;QACvC,IAAI,CAAC,iBAAiB,GAAG,GAAG,KAAA,IAAA,IAAH,GAAG,KAAA,MAAA,GAAH,GAAG,GAAI,EAAE;QAClC,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,KAAI;AAC3C,YAAA,IAAI,CAAC,iBAAiB,GAAG,OAAO;AAChC,YAAA,IAAI,CAAC,gBAAgB,GAAG,MAAM;AAChC,QAAA,CAAC,CAAC;IACJ;;IAGA,MAAM,iBAAiB,CAAC,QAAuB,EAAA;QAC7C,IAAI,CAAC,sBAAsB,EAAE;AAC7B,QAAA,IAAI,CAAC,iBAAiB,GAAG,SAAS;AAClC,QAAA,IAAI,CAAC,sBAAsB,GAAG,QAAQ;QACtC,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,KAAI;AAC3C,YAAA,IAAI,CAAC,iBAAiB,GAAG,OAAO;AAChC,YAAA,IAAI,CAAC,gBAAgB,GAAG,MAAM;AAChC,QAAA,CAAC,CAAC;IACJ;IAEA,MAAM,GAAA;;AACJ,QAAA,CAAA,EAAA,GAAA,IAAI,CAAC,OAAO,MAAA,IAAA,IAAA,EAAA,KAAA,MAAA,GAAA,MAAA,GAAA,EAAA,CAAE,GAAG,EAAE;IACrB;IAEQ,sBAAsB,GAAA;AAC5B,QAAA,IAAI,IAAI,CAAC,iBAAiB,IAAI,IAAI,IAAI,IAAI,CAAC,gBAAgB,IAAI,IAAI,EAAE;YACnE;QACF;AACA,QAAA,MAAM,MAAM,GAAG,IAAI,CAAC,gBAAgB;AACpC,QAAA,IAAI,CAAC,iBAAiB,GAAG,SAAS;AAClC,QAAA,IAAI,CAAC,gBAAgB,GAAG,SAAS;QACjC,MAAM,KAAA,IAAA,IAAN,MAAM,KAAA,MAAA,GAAA,MAAA,GAAN,MAAM,CAAG,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IACrE;AAEA;;;;;;;;;;AAUG;AACH,IAAA,IAAI,SAAS,GAAA;QACX,OAAO,IAAI,CAAC,OAAO;IACrB;AAEA;;;;;;;;;;AAUG;AACH,IAAA,IAAI,OAAO,GAAA;;AACT,QAAA,OAAO,CAAA,EAAA,GAAA,CAAA,EAAA,GAAA,IAAI,CAAC,QAAQ,MAAA,IAAA,IAAA,EAAA,KAAA,MAAA,GAAA,MAAA,GAAA,EAAA,CAAE,EAAE,CAAC,QAAQ,EAAE,MAAA,IAAA,IAAA,EAAA,KAAA,MAAA,GAAA,EAAA,GAAI,IAAI;IAC7C;AAEA;;;;;AAKG;AACH,IAAA,IAAI,gBAAgB,GAAA;;AAClB,QAAA,OAAO,CAAA,EAAA,GAAA,CAAA,EAAA,GAAA,IAAI,CAAC,QAAQ,MAAA,IAAA,IAAA,EAAA,KAAA,MAAA,GAAA,MAAA,GAAA,EAAA,CAAE,EAAE,CAAC,iBAAiB,EAAE,MAAA,IAAA,IAAA,EAAA,KAAA,MAAA,GAAA,EAAA,GAAI,IAAI;IACtD;AAEA;;;;;;;;;;;;;;;;;;;AAmBG;AACH,IAAA,SAAS,CAAC,QAA2B,EAAA;AACnC,QAAA,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,QAAQ,CAAC;AACnC,QAAA,OAAO,MAAK;AACV,YAAA,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,QAAQ,CAAC;AACxC,QAAA,CAAC;IACH;AAEA;;;;AAIG;AACH,IAAA,mBAAmB,CAAC,KAAc,EAAE,KAAa,EAAE,IAAY,EAAA;QAC7D,IAAI,IAAI,CAAC,gBAAgB,CAAC,IAAI,KAAK,CAAC,EAAE;YACpC;QACF;AACA,QAAA,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,gBAAgB,EAAE;AAC5C,YAAA,IAAI;AACF,gBAAA,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC;YAC9B;YAAE,OAAO,KAAK,EAAE;AACd,gBAAA,OAAO,CAAC,KAAK,CAAC,oCAAoC,EAAE,KAAK,CAAC;YAC5D;QACF;IACF;AAEA;;;;;;;;;;;AAWG;IACH,MAAM,oBAAoB,CACxB,OAA6B,EAAA;AAE7B,QAAA,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO;QAC5B,IAAI,EAAC,OAAO,KAAA,IAAA,IAAP,OAAO,KAAA,MAAA,GAAA,MAAA,GAAP,OAAO,CAAE,oBAAoB,CAAA,EAAE;AAClC,YAAA,OAAO,SAAS;QAClB;AACA,QAAA,IAAI;AACF,YAAA,OAAO,MAAM,OAAO,CAAC,oBAAoB,CAAC,OAAO,CAAC;QACpD;QAAE,OAAO,KAAK,EAAE;AACd,YAAA,OAAO,CAAC,IAAI,CACV,2EAA2E,EAC3E,KAAK,CACN;AACD,YAAA,OAAO,SAAS;QAClB;IACF;AAEA;;;;;;;;;AASG;IACH,MAAM,qCAAqC,CACzC,OAA2C,EAAA;AAE3C,QAAA,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO;QAC5B,IAAI,EAAC,OAAO,KAAA,IAAA,IAAP,OAAO,KAAA,MAAA,GAAA,MAAA,GAAP,OAAO,CAAE,qCAAqC,CAAA,EAAE;AACnD,YAAA,OAAO,SAAS;QAClB;AACA,QAAA,IAAI;AACF,YAAA,OAAO,MAAM,OAAO,CAAC,qCAAqC,CAAC,OAAO,CAAC;QACrE;QAAE,OAAO,KAAK,EAAE;AACd,YAAA,OAAO,CAAC,IAAI,CACV,4FAA4F,EAC5F,KAAK,CACN;AACD,YAAA,OAAO,SAAS;QAClB;IACF;AAEA;;;;AAIG;AACH,IAAA,iBAAiB,CAAC,MAAuB,EAAA;AACvC,QAAA,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO;QAC1B,IAAI,CAAC,KAAK,EAAE;AACV,YAAA,OAAO,EAAE;QACX;AACA,QAAA,OAAO,KAAK,CAAC,iBAAiB,CAAC,MAAM,CAAC;IACxC;AAEA;;;;;;AAMG;AACH,IAAA,UAAU,CAAC,EAAc,EAAA;AACvB,QAAA,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC;IACjC;AAEA;;;;;;;;;;;;AAYG;IACH,OAAO,GAAA;;;;AAGL,QAAA,IAAI,IAAI,CAAC,SAAS,EAAE;YAClB;QACF;AACA,QAAA,IAAI,CAAC,SAAS,GAAG,IAAI;QACrB,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,UAAU,EAAE,EAAE;AACtC,YAAA,IAAI;AACF,gBAAA,CAAA,EAAA,GAAA,CAAA,EAAA,GAAC,MAAmC,EAAC,OAAO,kDAAI;YAClD;YAAE,OAAO,KAAK,EAAE;AACd,gBAAA,OAAO,CAAC,KAAK,CAAC,gCAAgC,EAAE,KAAK,CAAC;YACxD;QACF;QACA,MAAM,GAAG,GAAG,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC;AAC5C,QAAA,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE;AACpB,YAAA,IAAI;AACF,gBAAA,EAAE,EAAE;YACN;YAAE,OAAO,KAAK,EAAE;AACd,gBAAA,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,KAAK,CAAC;YACjD;QACF;IACF;IAEA,MAAM,CAAC,KAAa,EAAE,IAAY,EAAA;AAChC,QAAA,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC;IAC3B;AAEA,IAAA,iBAAiB,CAAC,SAAuB,EAAA;AACvC,QAAA,OAAO,KAAK,CAAC,iBAAiB,CAAC,SAAS,CAAC;IAC3C;;IAGA,aAAa,GAAA;;AACX,QAAA,OAAO,CAAA,EAAA,GAAA,CAAA,EAAA,GAAA,CAAA,EAAA,GAAA,IAAI,CAAC,WAAW,MAAA,IAAA,IAAA,EAAA,KAAA,MAAA,GAAA,MAAA,GAAA,EAAA,CAAE,KAAK,MAAA,IAAA,IAAA,EAAA,KAAA,MAAA,GAAA,MAAA,GAAA,EAAA,CAAE,QAAQ,MAAA,IAAA,IAAA,EAAA,KAAA,MAAA,GAAA,EAAA,GAAI,IAAI,CAAC,KAAK;IACxD;IAEA,iBAAiB,GAAA;QACf,OAAO,IAAI,CAAC,KAAK;IACnB;AAEA;;;;;;;AAOG;AACH;;;;;;;;;;;;AAYG;AACH,IAAA,aAAa,MAAM,CACjB,SAAyB,EACzB,OAAsB,EAAA;QAEtB,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,OAAO,8BAA8B,CAAC;AACxE,QAAA,OAAO,eAAe,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5C;AACD;;;;"}

package/dist/environment/dome-gradient.d.ts

@@ -9,7 +9,8 @@ import { Types } from '../ecs/component.js';
  * Procedural gradient background dome.
  *
  * @remarks
- * - Renders an inward‑facing sphere and writes to `scene.background`.
+ * - Renders an inward-facing, translation-free sky sphere behind the scene.
+ * - Clip-space depth keeps it independent of camera near/far planes.
  * - Colors are Unity‑style sky/equator/ground; intensity multiplies shader output.
  *
  * @category Environment & Lighting

package/dist/environment/dome-gradient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dome-gradient.d.ts","sourceRoot":"","sources":["../../src/environment/dome-gradient.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,EAAmB,MAAM,qBAAqB,CAAC;AAC7D;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;EAUxB,CAAC"}
+{"version":3,"file":"dome-gradient.d.ts","sourceRoot":"","sources":["../../src/environment/dome-gradient.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,EAAmB,MAAM,qBAAqB,CAAC;AAC7D;;;;;;;;;GASG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;EAUxB,CAAC"}

package/dist/environment/dome-gradient.js

@@ -10,7 +10,8 @@ import { createComponent, Types } from 'elics';
  * Procedural gradient background dome.
  *
  * @remarks
- * - Renders an inward‑facing sphere and writes to `scene.background`.
+ * - Renders an inward-facing, translation-free sky sphere behind the scene.
+ * - Clip-space depth keeps it independent of camera near/far planes.
  * - Colors are Unity‑style sky/equator/ground; intensity multiplies shader output.
  *
  * @category Environment & Lighting