@iwsdk/core 0.1.0

package/dist/init/xr.js

@@ -0,0 +1,193 @@
+/**
+ * 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.
+ */
+/** WebXR session modes supported by IWSDK. @category Runtime */
+var SessionMode;
+(function (SessionMode) {
+    SessionMode["ImmersiveVR"] = "immersive-vr";
+    SessionMode["ImmersiveAR"] = "immersive-ar";
+})(SessionMode || (SessionMode = {}));
+/** Common WebXR reference spaces. @category Runtime */
+var ReferenceSpaceType;
+(function (ReferenceSpaceType) {
+    ReferenceSpaceType["BoundedFloor"] = "bounded-floor";
+    ReferenceSpaceType["Local"] = "local";
+    ReferenceSpaceType["LocalFloor"] = "local-floor";
+    ReferenceSpaceType["Unbounded"] = "unbounded";
+    ReferenceSpaceType["Viewer"] = "viewer";
+})(ReferenceSpaceType || (ReferenceSpaceType = {}));
+/** Default optional features appended to requests/offers. */
+const defaultOffers = ['local-floor', 'bounded-floor', 'layers'];
+/** Normalize a {@link FeatureFlag} to `{ required?: boolean } | undefined`. */
+function normalizeFlag(flag) {
+    if (flag === undefined || flag === false) {
+        return undefined;
+    }
+    if (flag === true) {
+        return {};
+    }
+    return { required: !!flag.required };
+}
+function isDepthFlagObject(flag) {
+    return typeof flag === 'object';
+}
+/** Build `XRSessionInit` from structured feature flags. */
+function buildSessionInit(opts) {
+    var _a;
+    const requiredFeatures = [];
+    // Always offer helpful optional features by default
+    const optionalFeatures = Array.from(new Set(defaultOffers));
+    const f = (_a = opts.features) !== null && _a !== void 0 ? _a : {};
+    const map = {
+        handTracking: 'hand-tracking',
+        anchors: 'anchors',
+        hitTest: 'hit-test',
+        planeDetection: 'plane-detection',
+        meshDetection: 'mesh-detection',
+        lightEstimation: 'light-estimation',
+        depthSensing: 'depth-sensing',
+        layers: 'layers',
+    };
+    const push = (key, normalized) => {
+        if (!normalized) {
+            return;
+        }
+        const token = map[key];
+        if (normalized.required) {
+            requiredFeatures.push(token);
+        }
+        else {
+            optionalFeatures.push(token);
+        }
+    };
+    // Simple flags
+    push('handTracking', normalizeFlag(f.handTracking));
+    push('anchors', normalizeFlag(f.anchors));
+    push('hitTest', normalizeFlag(f.hitTest));
+    push('planeDetection', normalizeFlag(f.planeDetection));
+    push('meshDetection', normalizeFlag(f.meshDetection));
+    push('lightEstimation', normalizeFlag(f.lightEstimation));
+    push('layers', normalizeFlag(f.layers));
+    // Depth sensing (may include preferences)
+    if (f.depthSensing) {
+        const normalized = normalizeFlag(isDepthFlagObject(f.depthSensing)
+            ? { required: f.depthSensing.required }
+            : f.depthSensing);
+        push('depthSensing', normalized);
+    }
+    const sessionInit = {
+        requiredFeatures: Array.from(new Set(requiredFeatures)),
+        optionalFeatures: Array.from(new Set(optionalFeatures)),
+    };
+    if (isDepthFlagObject(f.depthSensing)) {
+        const usage = f.depthSensing.usage
+            ? [f.depthSensing.usage]
+            : undefined;
+        const format = f.depthSensing.format
+            ? [f.depthSensing.format]
+            : undefined;
+        // Use DOM XRDepthStateInit typing where available
+        sessionInit.depthSensing = {
+            ...(usage ? { usagePreference: usage } : {}),
+            ...(format ? { dataFormatPreference: format } : {}),
+        };
+    }
+    return sessionInit;
+}
+function normalizeReferenceSpec(spec) {
+    var _a, _b, _c;
+    if (!spec || typeof spec === 'string') {
+        return {
+            type: (_a = spec) !== null && _a !== void 0 ? _a : ReferenceSpaceType.LocalFloor,
+            required: false,
+            fallbackOrder: [ReferenceSpaceType.Local, ReferenceSpaceType.Viewer],
+        };
+    }
+    return {
+        type: (_b = spec.type) !== null && _b !== void 0 ? _b : ReferenceSpaceType.LocalFloor,
+        required: !!spec.required,
+        fallbackOrder: (_c = spec.fallbackOrder) !== null && _c !== void 0 ? _c : [
+            ReferenceSpaceType.Local,
+            ReferenceSpaceType.Viewer,
+        ],
+    };
+}
+function mergeXROptions(base, overrides) {
+    var _a, _b, _c, _d, _e;
+    const b = base !== null && base !== void 0 ? base : {};
+    const o = overrides !== null && overrides !== void 0 ? overrides : {};
+    const mergedFeatures = { ...((_a = b.features) !== null && _a !== void 0 ? _a : {}), ...((_b = o.features) !== null && _b !== void 0 ? _b : {}) };
+    const merged = {
+        sessionMode: (_d = (_c = o.sessionMode) !== null && _c !== void 0 ? _c : b.sessionMode) !== null && _d !== void 0 ? _d : SessionMode.ImmersiveVR,
+        referenceSpace: (_e = o.referenceSpace) !== null && _e !== void 0 ? _e : b.referenceSpace,
+        features: Object.keys(mergedFeatures).length ? mergedFeatures : undefined,
+    };
+    return merged;
+}
+async function resolveReferenceSpaceType(session, preferred, fallbacks) {
+    const candidates = [];
+    for (const t of [preferred, ...fallbacks]) {
+        if (!candidates.includes(t)) {
+            candidates.push(t);
+        }
+    }
+    for (const type of candidates) {
+        try {
+            // Probe support; three.js will request again using the resolved type.
+            await session.requestReferenceSpace(type);
+            return type;
+        }
+        catch (_err) {
+            // continue
+        }
+    }
+    // If nothing worked, throw; caller will end the session.
+    throw new Error('No supported reference space available');
+}
+/**
+ * Explicitly request a WebXR session with the given options.
+ *
+ * @param world Target world.
+ * @param options Partial overrides merged with {@link World.xrDefaults}.
+ * @category Runtime
+ */
+function launchXR(world, options) {
+    var _a, _b;
+    const merged = mergeXROptions(world.xrDefaults, options);
+    const { sessionMode = SessionMode.ImmersiveVR } = merged;
+    const refSpec = normalizeReferenceSpec(merged.referenceSpace);
+    const sessionOptions = buildSessionInit(merged);
+    const onSessionStart = async (session) => {
+        session.addEventListener('end', onSessionEnd);
+        try {
+            const resolvedType = await resolveReferenceSpaceType(session, refSpec.type, refSpec.required ? [] : refSpec.fallbackOrder);
+            world.renderer.xr.setReferenceSpaceType(resolvedType);
+            await world.renderer.xr.setSession(session);
+            world.session = session;
+        }
+        catch (err) {
+            console.error('[XR] Failed to acquire reference space:', err);
+            try {
+                await session.end();
+            }
+            catch (_a) { }
+        }
+    };
+    const onSessionEnd = () => {
+        var _a;
+        (_a = world.session) === null || _a === void 0 ? void 0 : _a.removeEventListener('end', onSessionEnd);
+        world.session = undefined;
+    };
+    if (!world.session) {
+        (_b = (_a = navigator.xr) === null || _a === void 0 ? void 0 : _a.requestSession) === null || _b === void 0 ? void 0 : _b.call(_a, sessionMode, sessionOptions).then(onSessionStart);
+    }
+    else {
+        console.error('XRSession already exists');
+    }
+}
+
+export { ReferenceSpaceType, SessionMode, buildSessionInit, launchXR, normalizeReferenceSpec, resolveReferenceSpaceType };
+//# sourceMappingURL=xr.js.map

package/dist/init/xr.js.map

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

package/dist/input/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 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 './input-system.js';
+export * from './state-tags.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/input/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC"}

package/dist/input/input-system.d.ts

@@ -0,0 +1,52 @@
+/**
+ * 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.
+ */
+declare const InputSystem_base: import("elics").SystemConstructor<{}, {
+    interactable: {
+        required: import("elics").Component<{}>[];
+    };
+}, import("../ecs/world.js").World, import("../ecs/system.js").System<{}, {
+    interactable: {
+        required: import("elics").Component<{}>[];
+    };
+}>>;
+/**
+ * Samples XR poses (hands/controllers/head) and gamepads, curates the set of
+ * interactables for pointer raycasting, and attaches minimal event listeners.
+ *
+ * @remarks
+ * - Scheduled after player movement so pointers reflect updated transforms.
+ * - Maintains a filtered list of interactable Object3D roots when XR visibility is `Visible`.
+ * - Adds transient `Hovered` / `Pressed` tags so other systems can react declaratively.
+ *
+ * @category Input
+ * @example React to Hovered / Pressed
+ * ```ts
+ * export class HighlightSystem extends createSystem({
+ *   items: { required: [Interactable] }
+ * }) {
+ *   update() {
+ *     this.queries.items.entities.forEach(e => {
+ *       e.object3D.visible = !e.hasComponent(Pressed);
+ *     })
+ *   }
+ * }
+ * ```
+ */
+export declare class InputSystem extends InputSystem_base {
+    private intersectables;
+    private shouldSetIntersectables;
+    private dirty;
+    private listeners;
+    private lastBVHUpdate;
+    init(): void;
+    update(delta: number, time: number): void;
+    private setupEventListeners;
+    private computeBoundsTreeForEntity;
+    private cleanupEventListeners;
+}
+export {};
+//# sourceMappingURL=input-system.d.ts.map

package/dist/input/input-system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-system.d.ts","sourceRoot":"","sources":["../../src/input/input-system.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;;;;;;;;;;AAQH;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,WAAY,SAAQ,gBAKhC;IACC,OAAO,CAAC,cAAc,CAAkB;IACxC,OAAO,CAAC,uBAAuB,CAAS;IACxC,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,SAAS,CAQb;IACJ,OAAO,CAAC,aAAa,CAAmC;IAExD,IAAI,IAAI,IAAI;IAuBZ,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAsBzC,OAAO,CAAC,mBAAmB;IAqD3B,OAAO,CAAC,0BAA0B;IAkBlC,OAAO,CAAC,qBAAqB;CAe9B"}

package/dist/input/input-system.js

@@ -0,0 +1,176 @@
+import { createSystem } from '../ecs/system.js';
+import { VisibilityState } from '../ecs/world.js';
+import 'elics';
+import '../ecs/component-registry.js';
+import { Transform } from '../transform/transform.js';
+import '../runtime/three.js';
+import { Interactable, Hovered, Pressed } from './state-tags.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.
+ */
+/**
+ * Samples XR poses (hands/controllers/head) and gamepads, curates the set of
+ * interactables for pointer raycasting, and attaches minimal event listeners.
+ *
+ * @remarks
+ * - Scheduled after player movement so pointers reflect updated transforms.
+ * - Maintains a filtered list of interactable Object3D roots when XR visibility is `Visible`.
+ * - Adds transient `Hovered` / `Pressed` tags so other systems can react declaratively.
+ *
+ * @category Input
+ * @example React to Hovered / Pressed
+ * ```ts
+ * export class HighlightSystem extends createSystem({
+ *   items: { required: [Interactable] }
+ * }) {
+ *   update() {
+ *     this.queries.items.entities.forEach(e => {
+ *       e.object3D.visible = !e.hasComponent(Pressed);
+ *     })
+ *   }
+ * }
+ * ```
+ */
+class InputSystem extends createSystem({
+    interactable: { required: [Interactable, Transform] },
+}, {}) {
+    constructor() {
+        super(...arguments);
+        this.intersectables = [];
+        this.shouldSetIntersectables = false;
+        this.dirty = true;
+        this.listeners = new WeakMap();
+        this.lastBVHUpdate = new WeakMap();
+    }
+    init() {
+        // React to XR visibility for enabling scoped intersections
+        this.cleanupFuncs.push(this.visibilityState.subscribe((value) => {
+            const nextVisible = value === VisibilityState.Visible;
+            if (this.shouldSetIntersectables !== nextVisible) {
+                this.shouldSetIntersectables = nextVisible;
+                this.dirty = true;
+            }
+        }));
+        // Handle additions/removals of interactables
+        this.queries.interactable.subscribe('qualify', (entity) => {
+            this.setupEventListeners(entity);
+            this.dirty = true;
+        });
+        this.queries.interactable.subscribe('disqualify', (entity) => {
+            this.cleanupEventListeners(entity);
+            this.dirty = true;
+        });
+    }
+    update(delta, time) {
+        // Update input sampling first
+        this.input.update(this.xrManager, delta, time);
+        // Maintain the filtered list of interactables for pointer raycasting
+        if (this.dirty) {
+            this.dirty = false;
+            this.intersectables.length = 0;
+            if (this.shouldSetIntersectables) {
+                for (const entity of this.queries.interactable.entities) {
+                    const obj = entity.object3D;
+                    if (isDescendantOf(obj, this.scene)) {
+                        this.intersectables.push(obj);
+                    }
+                }
+                this.scene.interactableDescendants = this.intersectables;
+            }
+            else {
+                this.scene.interactableDescendants = undefined;
+            }
+        }
+    }
+    setupEventListeners(entity) {
+        const object3D = entity.object3D;
+        if (!object3D) {
+            return;
+        }
+        // Compute BVH for all meshes in the entity hierarchy for fast raycasting
+        this.computeBoundsTreeForEntity(object3D);
+        // Enable pointer events for raycasting
+        object3D.pointerEvents = 'auto';
+        // Throttled subtree BVH refresh helper
+        const maybeRefreshBVH = () => {
+            var _a;
+            const now = typeof performance !== 'undefined' && performance.now
+                ? performance.now()
+                : Date.now();
+            const last = (_a = this.lastBVHUpdate.get(object3D)) !== null && _a !== void 0 ? _a : 0;
+            if (now - last > 250) {
+                this.computeBoundsTreeForEntity(object3D);
+                this.lastBVHUpdate.set(object3D, now);
+            }
+        };
+        const enter = () => {
+            maybeRefreshBVH();
+            if (!entity.hasComponent(Hovered)) {
+                entity.addComponent(Hovered);
+            }
+        };
+        const leave = () => {
+            entity.removeComponent(Hovered);
+        };
+        const down = () => {
+            maybeRefreshBVH();
+            if (!entity.hasComponent(Pressed)) {
+                entity.addComponent(Pressed);
+            }
+        };
+        const up = () => {
+            entity.removeComponent(Pressed);
+        };
+        this.listeners.set(object3D, { enter, leave, down, up });
+        object3D.addEventListener('pointerenter', enter);
+        object3D.addEventListener('pointerleave', leave);
+        object3D.addEventListener('pointerdown', down);
+        object3D.addEventListener('pointerup', up);
+    }
+    computeBoundsTreeForEntity(object3D) {
+        object3D.traverse((child) => {
+            if (child.isMesh) {
+                const mesh = child;
+                if (mesh.geometry && !mesh.geometry.boundsTree) {
+                    try {
+                        mesh.geometry.computeBoundsTree();
+                    }
+                    catch (error) {
+                        console.warn(`[InputSystem] Failed to compute BVH for ${mesh.name || 'unnamed'}:`, error);
+                    }
+                }
+            }
+        });
+    }
+    cleanupEventListeners(entity) {
+        const object3D = entity.object3D;
+        if (!object3D) {
+            return;
+        }
+        const fns = this.listeners.get(object3D);
+        if (fns) {
+            object3D.removeEventListener('pointerenter', fns.enter);
+            object3D.removeEventListener('pointerleave', fns.leave);
+            object3D.removeEventListener('pointerdown', fns.down);
+            object3D.removeEventListener('pointerup', fns.up);
+            this.listeners.delete(object3D);
+        }
+        entity.removeComponent(Hovered).removeComponent(Pressed);
+    }
+}
+function isDescendantOf(object, parent) {
+    while (object) {
+        if (object === parent) {
+            return true;
+        }
+        object = object.parent;
+    }
+    return false;
+}
+
+export { InputSystem };
+//# sourceMappingURL=input-system.js.map

package/dist/input/input-system.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-system.js","sources":["../../src/input/input-system.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;;;AAAA;;;;;AAKG;AAQH;;;;;;;;;;;;;;;;;;;;;;AAsBG;AACG,MAAO,WAAY,SAAQ,YAAY,CAC3C;IACE,YAAY,EAAE,EAAE,QAAQ,EAAE,CAAC,YAAY,EAAE,SAAS,CAAC,EAAE;AACtD,CAAA,EACD,EAAE,CACH,CAAA;AALD,IAAA,WAAA,GAAA;;QAMU,IAAA,CAAA,cAAc,GAAe,EAAE;QAC/B,IAAA,CAAA,uBAAuB,GAAG,KAAK;QAC/B,IAAA,CAAA,KAAK,GAAG,IAAI;AACZ,QAAA,IAAA,CAAA,SAAS,GAAG,IAAI,OAAO,EAQ5B;AACK,QAAA,IAAA,CAAA,aAAa,GAAG,IAAI,OAAO,EAAoB;IAqIzD;IAnIE,IAAI,GAAA;;AAEF,QAAA,IAAI,CAAC,YAAY,CAAC,IAAI,CACpB,IAAI,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,KAAK,KAAI;AACvC,YAAA,MAAM,WAAW,GAAG,KAAK,KAAK,eAAe,CAAC,OAAO;AACrD,YAAA,IAAI,IAAI,CAAC,uBAAuB,KAAK,WAAW,EAAE;AAChD,gBAAA,IAAI,CAAC,uBAAuB,GAAG,WAAW;AAC1C,gBAAA,IAAI,CAAC,KAAK,GAAG,IAAI;YACnB;QACF,CAAC,CAAC,CACH;;AAGD,QAAA,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC,MAAM,KAAI;AACxD,YAAA,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC;AAChC,YAAA,IAAI,CAAC,KAAK,GAAG,IAAI;AACnB,QAAA,CAAC,CAAC;AACF,QAAA,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,SAAS,CAAC,YAAY,EAAE,CAAC,MAAM,KAAI;AAC3D,YAAA,IAAI,CAAC,qBAAqB,CAAC,MAAM,CAAC;AAClC,YAAA,IAAI,CAAC,KAAK,GAAG,IAAI;AACnB,QAAA,CAAC,CAAC;IACJ;IAEA,MAAM,CAAC,KAAa,EAAE,IAAY,EAAA;;AAEhC,QAAA,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,IAAI,CAAC;;AAG9C,QAAA,IAAI,IAAI,CAAC,KAAK,EAAE;AACd,YAAA,IAAI,CAAC,KAAK,GAAG,KAAK;AAClB,YAAA,IAAI,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC;AAC9B,YAAA,IAAI,IAAI,CAAC,uBAAuB,EAAE;gBAChC,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,QAAQ,EAAE;AACvD,oBAAA,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ;oBAC3B,IAAI,cAAc,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE;AACnC,wBAAA,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,GAAI,CAAC;oBAChC;gBACF;gBACC,IAAI,CAAC,KAAa,CAAC,uBAAuB,GAAG,IAAI,CAAC,cAAc;YACnE;iBAAO;AACJ,gBAAA,IAAI,CAAC,KAAa,CAAC,uBAAuB,GAAG,SAAS;YACzD;QACF;IACF;AAEQ,IAAA,mBAAmB,CAAC,MAAc,EAAA;AACxC,QAAA,MAAM,QAAQ,GAAG,MAAM,CAAC,QAEvB;QACD,IAAI,CAAC,QAAQ,EAAE;YACb;QACF;;AAGA,QAAA,IAAI,CAAC,0BAA0B,CAAC,QAAQ,CAAC;;AAGxC,QAAA,QAAgB,CAAC,aAAa,GAAG,MAAM;;QAGxC,MAAM,eAAe,GAAG,MAAK;;YAC3B,MAAM,GAAG,GACP,OAAO,WAAW,KAAK,WAAW,IAAI,WAAW,CAAC;AAChD,kBAAE,WAAW,CAAC,GAAG;AACjB,kBAAE,IAAI,CAAC,GAAG,EAAE;AAChB,YAAA,MAAM,IAAI,GAAG,CAAA,EAAA,GAAA,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAA,IAAA,IAAA,EAAA,KAAA,MAAA,GAAA,EAAA,GAAI,CAAC;AAClD,YAAA,IAAI,GAAG,GAAG,IAAI,GAAG,GAAG,EAAE;AACpB,gBAAA,IAAI,CAAC,0BAA0B,CAAC,QAAQ,CAAC;gBACzC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC;YACvC;AACF,QAAA,CAAC;QAED,MAAM,KAAK,GAAG,MAAK;AACjB,YAAA,eAAe,EAAE;YACjB,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE;AACjC,gBAAA,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC;YAC9B;AACF,QAAA,CAAC;QACD,MAAM,KAAK,GAAG,MAAK;AACjB,YAAA,MAAM,CAAC,eAAe,CAAC,OAAO,CAAC;AACjC,QAAA,CAAC;QACD,MAAM,IAAI,GAAG,MAAK;AAChB,YAAA,eAAe,EAAE;YACjB,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE;AACjC,gBAAA,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC;YAC9B;AACF,QAAA,CAAC;QACD,MAAM,EAAE,GAAG,MAAK;AACd,YAAA,MAAM,CAAC,eAAe,CAAC,OAAO,CAAC;AACjC,QAAA,CAAC;AAED,QAAA,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;AACvD,QAAA,QAAgB,CAAC,gBAAgB,CAAC,cAAc,EAAE,KAAK,CAAC;AACxD,QAAA,QAAgB,CAAC,gBAAgB,CAAC,cAAc,EAAE,KAAK,CAAC;AACxD,QAAA,QAAgB,CAAC,gBAAgB,CAAC,aAAa,EAAE,IAAI,CAAC;AACtD,QAAA,QAAgB,CAAC,gBAAgB,CAAC,WAAW,EAAE,EAAE,CAAC;IACrD;AAEQ,IAAA,0BAA0B,CAAC,QAAkB,EAAA;AACnD,QAAA,QAAQ,CAAC,QAAQ,CAAC,CAAC,KAAK,KAAI;AAC1B,YAAA,IAAK,KAAc,CAAC,MAAM,EAAE;gBAC1B,MAAM,IAAI,GAAG,KAAa;gBAC1B,IAAK,IAAY,CAAC,QAAQ,IAAI,CAAE,IAAY,CAAC,QAAQ,CAAC,UAAU,EAAE;AAChE,oBAAA,IAAI;AACD,wBAAA,IAAY,CAAC,QAAQ,CAAC,iBAAiB,EAAE;oBAC5C;oBAAE,OAAO,KAAK,EAAE;AACd,wBAAA,OAAO,CAAC,IAAI,CACV,CAAA,wCAAA,EAA2C,IAAI,CAAC,IAAI,IAAI,SAAS,CAAA,CAAA,CAAG,EACpE,KAAK,CACN;oBACH;gBACF;YACF;AACF,QAAA,CAAC,CAAC;IACJ;AAEQ,IAAA,qBAAqB,CAAC,MAAc,EAAA;AAC1C,QAAA,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAe;QACvC,IAAI,CAAC,QAAQ,EAAE;YACb;QACF;QACA,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC;QACxC,IAAI,GAAG,EAAE;YACP,QAAQ,CAAC,mBAAmB,CAAC,cAAc,EAAE,GAAG,CAAC,KAAK,CAAC;YACvD,QAAQ,CAAC,mBAAmB,CAAC,cAAc,EAAE,GAAG,CAAC,KAAK,CAAC;YACvD,QAAQ,CAAC,mBAAmB,CAAC,aAAa,EAAE,GAAG,CAAC,IAAI,CAAC;YACrD,QAAQ,CAAC,mBAAmB,CAAC,WAAW,EAAE,GAAG,CAAC,EAAE,CAAC;AACjD,YAAA,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC;QACjC;QACA,MAAM,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,eAAe,CAAC,OAAO,CAAC;IAC1D;AACD;AAED,SAAS,cAAc,CACrB,MAAmC,EACnC,MAAgB,EAAA;IAEhB,OAAO,MAAM,EAAE;AACb,QAAA,IAAI,MAAM,KAAK,MAAM,EAAE;AACrB,YAAA,OAAO,IAAI;QACb;AACA,QAAA,MAAM,GAAG,MAAM,CAAC,MAAa;IAC/B;AACA,IAAA,OAAO,KAAK;AACd;;;;"}

package/dist/input/state-tags.d.ts

@@ -0,0 +1,56 @@
+/**
+ * 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.
+ */
+/**
+ * Marks an entity as eligible for XR/UI pointer interaction.
+ *
+ * @remarks
+ * - The {@link InputSystem} discovers all entities with `Interactable` and, when
+ *   XR visibility is Visible, registers their Object3D roots as raycast targets
+ *   (computing BVHs for meshes to accelerate intersection tests).
+ * - When a pointer enters/leaves or presses/releases on the entity, the system
+ *   adds/removes the transient tags {@link Hovered} and {@link Pressed} so other
+ *   systems can react declaratively without manual event wiring.
+ * - Add this tag to the root Object3D of your UI/interactive object. Children
+ *   are implicitly covered because the InputSystem registers the whole subtree.
+ *
+ * @category Input
+ * @example Highlight on hover
+ * ```ts
+ * export class HighlightSystem extends createSystem({ items: { required: [Interactable] } }) {
+ *   update() {
+ *     this.queries.items.entities.forEach(e => {
+ *       e.object3D.visible = !e.hasComponent(Pressed);
+ *       e.object3D.material.emissiveIntensity = e.hasComponent(Hovered) ? 1.0 : 0.0;
+ *     });
+ *   }
+ * }
+ * ```
+ */
+export declare const Interactable: import("elics").Component<{}>;
+/**
+ * A transient tag set while a pointer ray is intersecting an `Interactable`.
+ *
+ * @remarks
+ * - Managed by {@link InputSystem}; do not add/remove this component manually in normal usage.
+ * - Use as a declarative condition for hover effects, tooltips, or affordances.
+ *
+ * @category Input
+ * @hideineditor
+ */
+export declare const Hovered: import("elics").Component<{}>;
+/**
+ * A transient tag set while a pointer is actively pressing an `Interactable`.
+ *
+ * @remarks
+ * - Managed by {@link InputSystem}; do not add/remove this component manually in normal usage.
+ * - Often used to gate activation logic or pressed-state visuals.
+ *
+ * @category Input
+ * @hideineditor
+ */
+export declare const Pressed: import("elics").Component<{}>;
+//# sourceMappingURL=state-tags.d.ts.map

package/dist/input/state-tags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-tags.d.ts","sourceRoot":"","sources":["../../src/input/state-tags.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,YAAY,+BAIxB,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,OAAO,+BAInB,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,OAAO,+BAInB,CAAC"}

package/dist/input/state-tags.js

@@ -0,0 +1,63 @@
+import '@preact/signals-core';
+import '../ecs/world.js';
+import { createComponent } 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.
+ */
+/**
+ * Marks an entity as eligible for XR/UI pointer interaction.
+ *
+ * @remarks
+ * - The {@link InputSystem} discovers all entities with `Interactable` and, when
+ *   XR visibility is Visible, registers their Object3D roots as raycast targets
+ *   (computing BVHs for meshes to accelerate intersection tests).
+ * - When a pointer enters/leaves or presses/releases on the entity, the system
+ *   adds/removes the transient tags {@link Hovered} and {@link Pressed} so other
+ *   systems can react declaratively without manual event wiring.
+ * - Add this tag to the root Object3D of your UI/interactive object. Children
+ *   are implicitly covered because the InputSystem registers the whole subtree.
+ *
+ * @category Input
+ * @example Highlight on hover
+ * ```ts
+ * export class HighlightSystem extends createSystem({ items: { required: [Interactable] } }) {
+ *   update() {
+ *     this.queries.items.entities.forEach(e => {
+ *       e.object3D.visible = !e.hasComponent(Pressed);
+ *       e.object3D.material.emissiveIntensity = e.hasComponent(Hovered) ? 1.0 : 0.0;
+ *     });
+ *   }
+ * }
+ * ```
+ */
+const Interactable = createComponent('Interactable', {}, 'Marks an entity as eligible for XR pointer interaction (ray/proximity).');
+/**
+ * A transient tag set while a pointer ray is intersecting an `Interactable`.
+ *
+ * @remarks
+ * - Managed by {@link InputSystem}; do not add/remove this component manually in normal usage.
+ * - Use as a declarative condition for hover effects, tooltips, or affordances.
+ *
+ * @category Input
+ * @hideineditor
+ */
+const Hovered = createComponent('Hovered', {}, 'A tag added by InputSystem while a pointer is hovering over the entity.');
+/**
+ * A transient tag set while a pointer is actively pressing an `Interactable`.
+ *
+ * @remarks
+ * - Managed by {@link InputSystem}; do not add/remove this component manually in normal usage.
+ * - Often used to gate activation logic or pressed-state visuals.
+ *
+ * @category Input
+ * @hideineditor
+ */
+const Pressed = createComponent('Pressed', {}, 'A tag added by InputSystem while the entity is actively pressed.');
+
+export { Hovered, Interactable, Pressed };
+//# sourceMappingURL=state-tags.js.map

package/dist/input/state-tags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-tags.js","sources":["../../src/input/state-tags.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;AAAA;;;;;AAKG;AAIH;;;;;;;;;;;;;;;;;;;;;;;;;AAyBG;AACI,MAAM,YAAY,GAAG,eAAe,CACzC,cAAc,EACd,EAAE,EACF,yEAAyE;AAG3E;;;;;;;;;AASG;AACI,MAAM,OAAO,GAAG,eAAe,CACpC,SAAS,EACT,EAAE,EACF,yEAAyE;AAG3E;;;;;;;;;AASG;AACI,MAAM,OAAO,GAAG,eAAe,CACpC,SAAS,EACT,EAAE,EACF,kEAAkE;;;;"}

package/dist/level/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 './level-system.js';
+export * from './level-tag.js';
+export * from './level-glxf-importer.js';
+export * from './level-entity-creator.js';
+export * from './level-root.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/level/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,iBAAiB,CAAC"}

package/dist/level/level-entity-creator.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 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 { Entity } from '../ecs/index.js';
+import type { World } from '../ecs/index.js';
+import { Object3D } from '../runtime/index.js';
+/**
+ * Creates ECS entities from Three.js Object3D graphs and applies IWSDK components
+ * found in GLXF `meta_spatial.components` extras.
+ *
+ * @remarks
+ * - Only nodes present in the GLXF `nodes` array are converted to entities.
+ * - Component ids are matched against the registry by `com.iwsdk.components.<id>`.
+ * - Panel UI extras are mapped to {@link PanelUI} with JSON config paths.
+ *
+ * @category Scene
+ */
+export declare class EntityCreator {
+    static createEntitiesFromObject3D(object: Object3D, nodes: Object3D[], parentEntity: Entity, world: World): void;
+    private static applyComponents;
+    private static mapGLXFDataToProps;
+    private static handleMetaSpatialPanelComponents;
+}
+//# sourceMappingURL=level-entity-creator.d.ts.map

package/dist/level/level-entity-creator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"level-entity-creator.d.ts","sourceRoot":"","sources":["../../src/level/level-entity-creator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAS,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAM/C;;;;;;;;;;GAUG;AACH,qBAAa,aAAa;IACxB,MAAM,CAAC,0BAA0B,CAC/B,MAAM,EAAE,QAAQ,EAChB,KAAK,EAAE,QAAQ,EAAE,EACjB,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,KAAK,GACX,IAAI;IAsCP,OAAO,CAAC,MAAM,CAAC,eAAe;IAoC9B,OAAO,CAAC,MAAM,CAAC,kBAAkB;IAiBjC,OAAO,CAAC,MAAM,CAAC,gCAAgC;CAuBhD"}