@iwsdk/core 0.1.0

package/dist/ecs/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+export * from './system.js';
+export * from './world.js';
+export * from './component.js';
+export * from './entity.js';
+export * from './component-registry.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ecs/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,yBAAyB,CAAC"}

package/dist/ecs/system.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import { XRInputManager, XROrigin } from '@iwsdk/xr-input';
+import { Signal } from '@preact/signals-core';
+import { System as ElicsSystem, Query, SystemConstructor, SystemQueries, SystemSchema, TypeValueToType } from 'elics';
+import type { QueryManager } from 'elics/lib/query-manager.js';
+import { PerspectiveCamera, Scene, WebGLRenderer, WebXRManager } from '../runtime/index.js';
+import { Entity } from './entity.js';
+import type { VisibilityState, World } from './world';
+type SystemConfigSignals<S extends SystemSchema> = {
+    [K in keyof S]: Signal<TypeValueToType<S[K]['type']>>;
+};
+/**
+ * System base interface wired to the IWSDK World, renderer, and XR runtime.
+ *
+ * @remarks
+ * - `createSystem(queries, schema)` returns a class that implements this interface.
+ * - Config values are exposed as reactive Signals on `this.config.<key>`.
+ * - Common world resources are available as readonly properties (`player`, `input`,
+ *   `scene`, `camera`, `renderer`, `visibilityState`).
+ * - Use `cleanupFuncs.push(() => ...)` to register teardown callbacks.
+ *
+ * @category ECS
+ */
+export interface System<S extends SystemSchema, Q extends SystemQueries> extends ElicsSystem<S, Q> {
+    isPaused: boolean;
+    config: SystemConfigSignals<S>;
+    queries: Record<keyof Q, Query>;
+    world: World;
+    queryManager: QueryManager;
+    priority: number;
+    globals: Record<string, any>;
+    xrManager: WebXRManager;
+    xrFrame: XRFrame;
+    readonly player: XROrigin;
+    readonly input: XRInputManager;
+    readonly scene: Scene;
+    readonly camera: PerspectiveCamera;
+    readonly renderer: WebGLRenderer;
+    readonly visibilityState: Signal<VisibilityState>;
+    readonly cleanupFuncs: Array<() => void>;
+    init(): void;
+    update(delta: number, time: number): void;
+    play(): void;
+    stop(): void;
+    createEntity: () => Entity;
+}
+/**
+ * Create a strongly-typed System class with query bindings and reactive config.
+ *
+ * @param queries Elics query descriptors keyed by name.
+ * @param schema Option map of config defaults and Types.
+ * @returns A System constructor to `export class MySystem extends createSystem(...) { ... }`.
+ *
+ * @example
+ * export class Rotator extends createSystem({ items: { required: [Transform] } }, {
+ *   speed: { type: Types.Float32, default: 1 }
+ * }) {
+ *   update(dt:number){ this.queries.items.entities.forEach(e=> e.object3D.rotateY(dt*this.config.speed.value)) }
+ * }
+ *
+ * @category ECS
+ */
+export declare function createSystem<S extends SystemSchema, Q extends SystemQueries>(queries?: Q, schema?: S): SystemConstructor<S, Q, World, System<S, Q>>;
+export {};
+//# sourceMappingURL=system.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"system.d.ts","sourceRoot":"","sources":["../../src/ecs/system.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,MAAM,EAAU,MAAM,sBAAsB,CAAC;AACtD,OAAO,EACL,MAAM,IAAI,WAAW,EACrB,KAAK,EACL,iBAAiB,EACjB,aAAa,EACb,YAAY,EACZ,eAAe,EAChB,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE/D,OAAO,EACL,iBAAiB,EACjB,KAAK,EACL,aAAa,EACb,YAAY,EACb,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEtD,KAAK,mBAAmB,CAAC,CAAC,SAAS,YAAY,IAAI;KAChD,CAAC,IAAI,MAAM,CAAC,GAAG,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;CACtD,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,MAAM,CAAC,CAAC,SAAS,YAAY,EAAE,CAAC,SAAS,aAAa,CACrE,SAAQ,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC;IACzB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,CAAC,CAAC;IAChC,KAAK,EAAE,KAAK,CAAC;IACb,YAAY,EAAE,YAAY,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7B,SAAS,EAAE,YAAY,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;IAEjB,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC,eAAe,CAAC,CAAC;IAClD,QAAQ,CAAC,YAAY,EAAE,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC;IAEzC,IAAI,IAAI,IAAI,CAAC;IACb,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,IAAI,IAAI,IAAI,CAAC;IACb,IAAI,IAAI,IAAI,CAAC;IACb,YAAY,EAAE,MAAM,MAAM,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,YAAY,EAAE,CAAC,SAAS,aAAa,EAC1E,OAAO,GAAE,CAAW,EACpB,MAAM,GAAE,CAAW,GAClB,iBAAiB,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAsE9C"}

package/dist/ecs/system.js

@@ -0,0 +1,79 @@
+import { signal } from '@preact/signals-core';
+
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+/**
+ * Create a strongly-typed System class with query bindings and reactive config.
+ *
+ * @param queries Elics query descriptors keyed by name.
+ * @param schema Option map of config defaults and Types.
+ * @returns A System constructor to `export class MySystem extends createSystem(...) { ... }`.
+ *
+ * @example
+ * export class Rotator extends createSystem({ items: { required: [Transform] } }, {
+ *   speed: { type: Types.Float32, default: 1 }
+ * }) {
+ *   update(dt:number){ this.queries.items.entities.forEach(e=> e.object3D.rotateY(dt*this.config.speed.value)) }
+ * }
+ *
+ * @category ECS
+ */
+function createSystem(queries = {}, schema = {}) {
+    var _a;
+    return _a = class {
+            constructor(world, queryManager, priority) {
+                this.world = world;
+                this.queryManager = queryManager;
+                this.priority = priority;
+                this.isPaused = false;
+                this.config = {};
+                this.cleanupFuncs = [];
+                for (const key in schema) {
+                    this.config[key] = signal(schema[key].default);
+                }
+                this.player = world.player;
+                this.input = world.input;
+                this.scene = world.scene;
+                this.camera = world.camera;
+                this.renderer = world.renderer;
+                this.visibilityState = world.visibilityState;
+            }
+            get globals() {
+                return this.world.globals;
+            }
+            get xrManager() {
+                return this.world.renderer.xr;
+            }
+            get xrFrame() {
+                return this.xrManager.getFrame();
+            }
+            createEntity() {
+                return this.world.createEntity();
+            }
+            createTransformEntity(object, parent) {
+                return this.world.createTransformEntity(object, parent);
+            }
+            init() { }
+            update(_delta, _time) { }
+            play() {
+                this.isPaused = false;
+            }
+            stop() {
+                this.isPaused = true;
+            }
+            destroy() {
+                this.cleanupFuncs.forEach((func) => func());
+            }
+        },
+        _a.schema = schema,
+        _a.isSystem = true,
+        _a.queries = queries,
+        _a;
+}
+
+export { createSystem };
+//# sourceMappingURL=system.js.map

package/dist/ecs/system.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system.js","sources":["../../src/ecs/system.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAAA;;;;;AAKG;AAkEH;;;;;;;;;;;;;;;AAeG;SACa,YAAY,CAC1B,UAAa,EAAO,EACpB,SAAY,EAAO,EAAA;;IAEnB,OAAA,EAAA,GAAO,MAAA;AAiBL,YAAA,WAAA,CACkB,KAAY,EACrB,YAA0B,EAC1B,QAAgB,EAAA;gBAFP,IAAA,CAAA,KAAK,GAAL,KAAK;gBACd,IAAA,CAAA,YAAY,GAAZ,YAAY;gBACZ,IAAA,CAAA,QAAQ,GAAR,QAAQ;gBAfV,IAAA,CAAA,QAAQ,GAAY,KAAK;gBAEzB,IAAA,CAAA,MAAM,GAAG,EAA4B;gBAQ5B,IAAA,CAAA,YAAY,GAAsB,EAAE;AAOlD,gBAAA,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE;AACxB,oBAAA,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,OAAc,CAAC;gBACvD;AACA,gBAAA,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM;AAC1B,gBAAA,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK;AACxB,gBAAA,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK;AACxB,gBAAA,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM;AAC1B,gBAAA,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ;AAC9B,gBAAA,IAAI,CAAC,eAAe,GAAG,KAAK,CAAC,eAAe;YAC9C;AAEA,YAAA,IAAI,OAAO,GAAA;AACT,gBAAA,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO;YAC3B;AAEA,YAAA,IAAI,SAAS,GAAA;AACX,gBAAA,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE;YAC/B;AAEA,YAAA,IAAI,OAAO,GAAA;AACT,gBAAA,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE;YAClC;YAEA,YAAY,GAAA;AACV,gBAAA,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE;YAClC;YAEA,qBAAqB,CAAC,MAAiB,EAAE,MAAe,EAAA;gBACtD,OAAO,IAAI,CAAC,KAAK,CAAC,qBAAqB,CAAC,MAAM,EAAE,MAAM,CAAC;YACzD;AAEA,YAAA,IAAI,KAAU;AAEd,YAAA,MAAM,CAAC,MAAc,EAAE,KAAa,IAAS;YAE7C,IAAI,GAAA;AACF,gBAAA,IAAI,CAAC,QAAQ,GAAG,KAAK;YACvB;YAEA,IAAI,GAAA;AACF,gBAAA,IAAI,CAAC,QAAQ,GAAG,IAAI;YACtB;YAEA,OAAO,GAAA;AACL,gBAAA,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;YAC7C;AACD,SAAA;AAnEQ,QAAA,EAAA,CAAA,MAAM,GAAG,MAAO;AAChB,QAAA,EAAA,CAAA,QAAQ,GAAG,IAAK;AAChB,QAAA,EAAA,CAAA,OAAO,GAAG,OAAQ;AAiEzB,QAAA,EAAA;AACJ;;;;"}

package/dist/ecs/world.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import { XRInputManager, 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 { WorldOptions, XROptions } from '../init/index.js';
+import { Object3D, PerspectiveCamera, Scene, WebGLRenderer } from '../runtime/index.js';
+import { Entity } from './entity.js';
+export declare enum VisibilityState {
+    NonImmersive = "non-immersive",
+    Hidden = "hidden",
+    Visible = "visible",
+    VisibleBlurred = "visible-blurred"
+}
+export type GradientColors = {
+    sky: number;
+    equator: number;
+    ground: number;
+};
+/**
+ * World is the root ECS container, Three.js scene/renderer owner, and XR session gateway.
+ *
+ * @remarks
+ * - Construct a world with {@link World.create} (recommended) which wires the renderer, scene, default systems
+ *   (Input, UI, Audio, Level) and starts the render loop.
+ * - The world exposes convenience handles like {@link World.input | input} (XRInputManager),
+ *   {@link World.player | player} (XROrigin), and {@link World.assetManager}.
+ * - Feature systems (Grabbing, Locomotion) are opt‑in via {@link WorldOptions.features}.
+ *
+ * @category Runtime
+ * @example
+ * ```ts
+ * import { World, SessionMode } from '@iwsdk/core';
+ *
+ * const container = document.getElementById('scene-container') as HTMLDivElement;
+ * const world = await World.create(container, {
+ *   xr: { sessionMode: SessionMode.ImmersiveVR },
+ *   features: { enableLocomotion: true, enableGrabbing: true },
+ *   level: '/glxf/Composition.glxf'
+ * });
+ * ```
+ */
+export declare class World extends ElicsWorld {
+    input: XRInputManager;
+    player: XROrigin;
+    assetManager: typeof AssetManager;
+    scene: Scene;
+    sceneEntity: Entity;
+    activeLevel: Signal<Entity>;
+    activeLevelId: string;
+    camera: PerspectiveCamera;
+    renderer: WebGLRenderer;
+    session: XRSession | undefined;
+    visibilityState: Signal<VisibilityState>;
+    requestedLevelUrl: string | undefined;
+    _resolveLevelLoad: (() => void) | undefined;
+    /** Default XR options used when calling {@link World.launchXR} without overrides. */
+    xrDefaults: import('../init/xr.js').XROptions | undefined;
+    constructor();
+    createEntity(): Entity;
+    createTransformEntity(object?: Object3D, parentOrOptions?: Entity | {
+        parent?: Entity;
+        persistent?: boolean;
+    }): Entity;
+    launchXR(xrOptions?: Partial<XROptions>): void;
+    /** Request a level change; LevelSystem performs the work and resolves. */
+    loadLevel(url?: string): Promise<void>;
+    exitXR(): void;
+    update(delta: number, time: number): void;
+    registerComponent(component: AnyComponent): this;
+    getActiveRoot(): Object3D;
+    getPersistentRoot(): Object3D;
+    /**
+     * Initialize a new WebXR world with all required systems and setup
+     *
+     * @param sceneContainer - HTML container for the renderer canvas
+     * @param assets - Asset manifest for preloading
+     * @param options - Configuration options for the world
+     * @returns Promise that resolves to the initialized World instance
+     */
+    /**
+     * Initialize a new WebXR world with renderer, scene, default systems, and optional level.
+     *
+     * @param container HTML container to which the renderer canvas will be appended.
+     * @param options Runtime configuration, see {@link WorldOptions}.
+     * @returns A promise that resolves to the initialized {@link World}.
+     *
+     * @remarks
+     * - This call enables the Input, UI and Audio systems by default.
+     * - Use {@link WorldOptions.features} to enable Locomotion or Grabbing.
+     * - If {@link WorldOptions.level} is provided, the LevelSystem will load it after assets are preloaded.
+     * @see /getting-started/01-hello-xr
+     */
+    static create(container: HTMLDivElement, options?: WorldOptions): Promise<World>;
+}
+//# sourceMappingURL=world.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"world.d.ts","sourceRoot":"","sources":["../../src/ecs/world.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3D,OAAO,EAAE,MAAM,EAAU,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,KAAK,IAAI,UAAU,EAAE,MAAM,OAAO,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EACL,YAAY,EAEZ,SAAS,EAEV,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,QAAQ,EACR,iBAAiB,EACjB,KAAK,EACL,aAAa,EACd,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,oBAAY,eAAe;IACzB,YAAY,kBAAkB;IAC9B,MAAM,WAAW;IACjB,OAAO,YAAY;IACnB,cAAc,oBAAoB;CACnC;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,KAAM,SAAQ,UAAU;IAC5B,KAAK,EAAG,cAAc,CAAC;IACvB,MAAM,EAAG,QAAQ,CAAC;IAClB,YAAY,EAAG,OAAO,YAAY,CAAC;IACnC,KAAK,EAAG,KAAK,CAAC;IACd,WAAW,EAAG,MAAM,CAAC;IACrB,WAAW,EAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IAC7B,aAAa,EAAE,MAAM,CAAmB;IACxC,MAAM,EAAG,iBAAiB,CAAC;IAC3B,QAAQ,EAAG,aAAa,CAAC;IACzB,OAAO,EAAE,SAAS,GAAG,SAAS,CAAC;IAC/B,eAAe,0BAAwC;IACvD,iBAAiB,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,iBAAiB,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC;IACnD,qFAAqF;IAC9E,UAAU,EAAE,OAAO,eAAe,EAAE,SAAS,GAAG,SAAS,CAAC;;IAcjE,YAAY,IAAI,MAAM;IAItB,qBAAqB,CACnB,MAAM,CAAC,EAAE,QAAQ,EACjB,eAAe,CAAC,EAAE,MAAM,GAAG;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,OAAO,CAAA;KAAE,GACnE,MAAM;IA8CT,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC;IAIvC,0EAA0E;IACpE,SAAS,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO5C,MAAM;IAIN,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAIzC,iBAAiB,CAAC,SAAS,EAAE,YAAY,GAAG,IAAI;IAKhD,aAAa,IAAI,QAAQ;IAIzB,iBAAiB,IAAI,QAAQ;IAI7B;;;;;;;OAOG;IACH;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,MAAM,CACX,SAAS,EAAE,cAAc,EACzB,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,KAAK,CAAC;CAGlB"}

package/dist/ecs/world.js

@@ -0,0 +1,165 @@
+import { signal } from '@preact/signals-core';
+import { World as World$1 } from 'elics';
+import { launchXR } from '../init/xr.js';
+import { initializeWorld } from '../init/world-initializer.js';
+import '../level/level-system.js';
+import { LevelTag } from '../level/level-tag.js';
+import '@iwsdk/glxf';
+import '../asset/asset-manager.js';
+import '../asset/cache-manager.js';
+import './component-registry.js';
+import '@pmndrs/uikit';
+import { Object3D } from 'three';
+import '../ui/ui.js';
+import '../ui/follow.js';
+import '../ui/screenspace.js';
+import '../level/level-root.js';
+import '../runtime/three.js';
+import { Transform } from '../transform/transform.js';
+
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+var VisibilityState;
+(function (VisibilityState) {
+    VisibilityState["NonImmersive"] = "non-immersive";
+    VisibilityState["Hidden"] = "hidden";
+    VisibilityState["Visible"] = "visible";
+    VisibilityState["VisibleBlurred"] = "visible-blurred";
+})(VisibilityState || (VisibilityState = {}));
+/**
+ * World is the root ECS container, Three.js scene/renderer owner, and XR session gateway.
+ *
+ * @remarks
+ * - Construct a world with {@link World.create} (recommended) which wires the renderer, scene, default systems
+ *   (Input, UI, Audio, Level) and starts the render loop.
+ * - The world exposes convenience handles like {@link World.input | input} (XRInputManager),
+ *   {@link World.player | player} (XROrigin), and {@link World.assetManager}.
+ * - Feature systems (Grabbing, Locomotion) are opt‑in via {@link WorldOptions.features}.
+ *
+ * @category Runtime
+ * @example
+ * ```ts
+ * import { World, SessionMode } from '@iwsdk/core';
+ *
+ * const container = document.getElementById('scene-container') as HTMLDivElement;
+ * const world = await World.create(container, {
+ *   xr: { sessionMode: SessionMode.ImmersiveVR },
+ *   features: { enableLocomotion: true, enableGrabbing: true },
+ *   level: '/glxf/Composition.glxf'
+ * });
+ * ```
+ */
+class World extends World$1 {
+    constructor() {
+        super();
+        this.activeLevelId = 'level:default';
+        this.visibilityState = signal(VisibilityState.NonImmersive);
+        const originalReleaseFunc = this.entityManager.releaseEntityInstance.bind(this.entityManager);
+        this.entityManager.releaseEntityInstance = (entity) => {
+            var _a;
+            originalReleaseFunc(entity);
+            (_a = entity.object3D) === null || _a === void 0 ? void 0 : _a.removeFromParent();
+            delete entity.object3D;
+        };
+    }
+    createEntity() {
+        return super.createEntity();
+    }
+    createTransformEntity(object, parentOrOptions) {
+        var _a, _b;
+        const entity = super.createEntity();
+        const obj = object !== null && object !== void 0 ? object : new Object3D();
+        // Cast to pointer-events-capable Object3D event map for downstream typing
+        entity.object3D = obj;
+        let parent = undefined;
+        let persistent = false;
+        if (parentOrOptions) {
+            if (typeof parentOrOptions.index === 'number') {
+                parent = parentOrOptions;
+            }
+            else {
+                const opts = parentOrOptions;
+                parent = opts.parent;
+                persistent = !!opts.persistent;
+            }
+        }
+        if (!parent) {
+            // Avoid self-parenting for the Scene root
+            const isSceneObject = (obj) => obj.isScene === true;
+            if (object && isSceneObject(object)) {
+                parent = undefined;
+                persistent = true;
+            }
+            else {
+                parent = persistent
+                    ? this.sceneEntity
+                    : ((_b = (_a = this.activeLevel) === null || _a === void 0 ? void 0 : _a.value) !== null && _b !== void 0 ? _b : this.sceneEntity);
+            }
+        }
+        entity.addComponent(Transform, { parent });
+        // Tag entity with current level, unless persistent
+        if (!persistent) {
+            entity.addComponent(LevelTag, { id: this.activeLevelId });
+        }
+        return entity;
+    }
+    launchXR(xrOptions) {
+        launchXR(this, xrOptions);
+    }
+    /** Request a level change; LevelSystem performs the work and resolves. */
+    async loadLevel(url) {
+        this.requestedLevelUrl = url !== null && url !== void 0 ? url : '';
+        return new Promise((resolve) => {
+            this._resolveLevelLoad = resolve;
+        });
+    }
+    exitXR() {
+        var _a;
+        (_a = this.session) === null || _a === void 0 ? void 0 : _a.end();
+    }
+    update(delta, time) {
+        super.update(delta, time);
+    }
+    registerComponent(component) {
+        return super.registerComponent(component);
+    }
+    // Level root helpers
+    getActiveRoot() {
+        var _a, _b, _c;
+        return (_c = (_b = (_a = this.activeLevel) === null || _a === void 0 ? void 0 : _a.value) === null || _b === void 0 ? void 0 : _b.object3D) !== null && _c !== void 0 ? _c : this.scene;
+    }
+    getPersistentRoot() {
+        return this.scene;
+    }
+    /**
+     * Initialize a new WebXR world with all required systems and setup
+     *
+     * @param sceneContainer - HTML container for the renderer canvas
+     * @param assets - Asset manifest for preloading
+     * @param options - Configuration options for the world
+     * @returns Promise that resolves to the initialized World instance
+     */
+    /**
+     * Initialize a new WebXR world with renderer, scene, default systems, and optional level.
+     *
+     * @param container HTML container to which the renderer canvas will be appended.
+     * @param options Runtime configuration, see {@link WorldOptions}.
+     * @returns A promise that resolves to the initialized {@link World}.
+     *
+     * @remarks
+     * - This call enables the Input, UI and Audio systems by default.
+     * - Use {@link WorldOptions.features} to enable Locomotion or Grabbing.
+     * - If {@link WorldOptions.level} is provided, the LevelSystem will load it after assets are preloaded.
+     * @see /getting-started/01-hello-xr
+     */
+    static create(container, options) {
+        return initializeWorld(container, options);
+    }
+}
+
+export { VisibilityState, World };
+//# sourceMappingURL=world.js.map

package/dist/ecs/world.js.map

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

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

@@ -0,0 +1,39 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import { Types } from '../ecs/index.js';
+/**
+ * Procedural gradient background dome.
+ *
+ * @remarks
+ * - Renders an inward‑facing sphere and writes to `scene.background`.
+ * - Colors are Unity‑style sky/equator/ground; intensity multiplies shader output.
+ *
+ * @category Environment & Lighting
+ */
+export declare const DomeGradient: import("elics").Component<{
+    sky: {
+        type: Types.Color;
+        default: [number, number, number, number];
+    };
+    equator: {
+        type: Types.Color;
+        default: [number, number, number, number];
+    };
+    ground: {
+        type: Types.Color;
+        default: [number, number, number, number];
+    };
+    intensity: {
+        type: Types.Float32;
+        default: number;
+    };
+    _needsUpdate: {
+        type: Types.Boolean;
+        default: true;
+    };
+}>;
+//# sourceMappingURL=dome-gradient.d.ts.map

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

@@ -0,0 +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,iBAAiB,CAAC;AAEzD;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;EAUxB,CAAC"}

package/dist/environment/dome-gradient.js

@@ -0,0 +1,30 @@
+import '@preact/signals-core';
+import '../ecs/world.js';
+import { createComponent, Types } from 'elics';
+import '../ecs/component-registry.js';
+
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+/**
+ * Procedural gradient background dome.
+ *
+ * @remarks
+ * - Renders an inward‑facing sphere and writes to `scene.background`.
+ * - Colors are Unity‑style sky/equator/ground; intensity multiplies shader output.
+ *
+ * @category Environment & Lighting
+ */
+const DomeGradient = createComponent('DomeGradient', {
+    sky: { type: Types.Color, default: [0.2423, 0.6172, 0.8308, 1.0] },
+    equator: { type: Types.Color, default: [0.6584, 0.7084, 0.7913, 1.0] },
+    ground: { type: Types.Color, default: [0.807, 0.7758, 0.7454, 1.0] },
+    intensity: { type: Types.Float32, default: 1.0 },
+    _needsUpdate: { type: Types.Boolean, default: true },
+}, 'Background dome using a gradient');
+
+export { DomeGradient };
+//# sourceMappingURL=dome-gradient.js.map

package/dist/environment/dome-gradient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dome-gradient.js","sources":["../../src/environment/dome-gradient.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;AAAA;;;;;AAKG;AAIH;;;;;;;;AAQG;AACI,MAAM,YAAY,GAAG,eAAe,CACzC,cAAc,EACd;AACE,IAAA,GAAG,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE;AAClE,IAAA,OAAO,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE;AACtE,IAAA,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE;IACpE,SAAS,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE;IAChD,YAAY,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE;CACrD,EACD,kCAAkC;;;;"}

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

@@ -0,0 +1,39 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import { Types } from '../ecs/index.js';
+/**
+ * Background dome driven by a single equirectangular texture.
+ *
+ * @remarks
+ * - `src` may be HDR/EXR or LDR (png/jpg/ktx2). Mapping is set to equirect when needed.
+ * - Affects only `scene.background` and optional `scene.backgroundRotation`/`backgroundIntensity`.
+ *
+ * @category Environment & Lighting
+ */
+export declare const DomeTexture: import("elics").Component<{
+    src: {
+        type: Types.String;
+        default: string;
+    };
+    blurriness: {
+        type: Types.Float32;
+        default: number;
+    };
+    intensity: {
+        type: Types.Float32;
+        default: number;
+    };
+    rotation: {
+        type: Types.Vec3;
+        default: [number, number, number];
+    };
+    _needsUpdate: {
+        type: Types.Boolean;
+        default: true;
+    };
+}>;
+//# sourceMappingURL=dome-texture.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dome-texture.d.ts","sourceRoot":"","sources":["../../src/environment/dome-texture.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,EAAmB,MAAM,iBAAiB,CAAC;AAEzD;;;;;;;;GAQG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;EAUvB,CAAC"}

package/dist/environment/dome-texture.js

@@ -0,0 +1,30 @@
+import '@preact/signals-core';
+import '../ecs/world.js';
+import { createComponent, Types } from 'elics';
+import '../ecs/component-registry.js';
+
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+/**
+ * Background dome driven by a single equirectangular texture.
+ *
+ * @remarks
+ * - `src` may be HDR/EXR or LDR (png/jpg/ktx2). Mapping is set to equirect when needed.
+ * - Affects only `scene.background` and optional `scene.backgroundRotation`/`backgroundIntensity`.
+ *
+ * @category Environment & Lighting
+ */
+const DomeTexture = createComponent('DomeTexture', {
+    src: { type: Types.String, default: '' },
+    blurriness: { type: Types.Float32, default: 0.0 },
+    intensity: { type: Types.Float32, default: 1.0 },
+    rotation: { type: Types.Vec3, default: [0, 0, 0] }, // radians [x,y,z]
+    _needsUpdate: { type: Types.Boolean, default: true },
+}, 'Background dome using a single equirectangular texture');
+
+export { DomeTexture };
+//# sourceMappingURL=dome-texture.js.map

package/dist/environment/dome-texture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dome-texture.js","sources":["../../src/environment/dome-texture.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;AAAA;;;;;AAKG;AAIH;;;;;;;;AAQG;AACI,MAAM,WAAW,GAAG,eAAe,CACxC,aAAa,EACb;IACE,GAAG,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE;IACxC,UAAU,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE;IACjD,SAAS,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE;AAChD,IAAA,QAAQ,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE;IAClD,YAAY,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE;CACrD,EACD,wDAAwD;;;;"}