@iwsdk/core 0.1.0

package/dist/audio/audio-utils.js

@@ -0,0 +1,145 @@
+import { AudioSource } from './audio.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.
+ */
+/** Utility helpers to control {@link AudioSource} without touching Three audio.
+ * @category Audio
+ */
+class AudioUtils {
+    /**
+     * Play audio on an entity
+     * @param entity - Entity with Audio component
+     * @param fadeIn - Fade in duration in seconds
+     */
+    static play(entity, fadeIn = 0) {
+        const index = entity.index;
+        // Check if entity has audio by checking if data exists
+        if (AudioSource.data.src[index] === undefined) {
+            console.warn('Entity does not have Audio component');
+            return;
+        }
+        AudioSource.data._playRequested[index] = 1;
+        AudioSource.data._fadeIn[index] = fadeIn;
+    }
+    /**
+     * Pause audio on an entity
+     * @param entity - Entity with Audio component
+     * @param fadeOut - Fade out duration in seconds
+     */
+    static pause(entity, fadeOut = 0) {
+        const index = entity.index;
+        if (AudioSource.data.src[index] === undefined) {
+            console.warn('Entity does not have Audio component');
+            return;
+        }
+        AudioSource.data._pauseRequested[index] = 1;
+        AudioSource.data._fadeOut[index] = fadeOut;
+    }
+    /**
+     * Stop audio on an entity
+     * @param entity - Entity with Audio component
+     */
+    static stop(entity) {
+        const index = entity.index;
+        if (AudioSource.data.src[index] === undefined) {
+            console.warn('Entity does not have Audio component');
+            return;
+        }
+        AudioSource.data._stopRequested[index] = 1;
+    }
+    /**
+     * Check if audio is playing on an entity
+     * @param entity - Entity with Audio component
+     * @returns True if audio is playing
+     */
+    static isPlaying(entity) {
+        const index = entity.index;
+        if (AudioSource.data.src[index] === undefined) {
+            return false;
+        }
+        return AudioSource.data._isPlaying[index] === 1;
+    }
+    /**
+     * Set volume on an entity's audio
+     * @param entity - Entity with Audio component
+     * @param volume - Volume level (0.0 to 1.0)
+     */
+    static setVolume(entity, volume) {
+        const index = entity.index;
+        if (AudioSource.data.src[index] === undefined) {
+            console.warn('Entity does not have Audio component');
+            return;
+        }
+        AudioSource.data.volume[index] = Math.max(0, Math.min(1, volume));
+    }
+    /**
+     * Get volume from an entity's audio
+     * @param entity - Entity with Audio component
+     * @returns Current volume level
+     */
+    static getVolume(entity) {
+        const index = entity.index;
+        if (AudioSource.data.src[index] === undefined) {
+            return 0;
+        }
+        return AudioSource.data.volume[index];
+    }
+    /**
+     * Preload audio for an entity
+     * @param entity - Entity with Audio component
+     * @returns Promise that resolves when audio is loaded
+     */
+    static async preload(entity) {
+        const index = entity.index;
+        if (AudioSource.data.src[index] === undefined) {
+            throw new Error('Entity does not have Audio component');
+        }
+        // Wait for loading to complete
+        return new Promise((resolve) => {
+            const checkLoaded = () => {
+                if (AudioSource.data._loaded[index]) {
+                    resolve();
+                }
+                else if (!AudioSource.data._loading[index] &&
+                    !AudioSource.data._loaded[index]) {
+                    // Not loading and not loaded, might need to wait for system update
+                    setTimeout(checkLoaded, 16);
+                }
+                else {
+                    // Currently loading
+                    setTimeout(checkLoaded, 16);
+                }
+            };
+            checkLoaded();
+        });
+    }
+    /**
+     * Create a one-shot audio entity that auto-removes after playing
+     * @param world - World instance
+     * @param src - Audio source path
+     * @param options - Additional audio options
+     * @returns Created entity
+     */
+    static createOneShot(world, src, options = {}) {
+        var _a, _b;
+        const entity = world.createEntity();
+        entity.addComponent(AudioSource, {
+            src,
+            volume: (_a = options.volume) !== null && _a !== void 0 ? _a : 1.0,
+            positional: (_b = options.positional) !== null && _b !== void 0 ? _b : false,
+            autoplay: true,
+            loop: false,
+        });
+        if (options.positional && options.position) ;
+        // Auto-remove entity when sound ends
+        // This would be handled by the AudioSystem when detecting ended non-looping sounds
+        return entity;
+    }
+}
+
+export { AudioUtils };
+//# sourceMappingURL=audio-utils.js.map

package/dist/audio/audio-utils.js.map

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

package/dist/audio/audio.d.ts

@@ -0,0 +1,178 @@
+/**
+ * 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';
+/**
+ * Playback behavior when a new play is requested.
+ *
+ * @category Audio
+ */
+export declare const PlaybackMode: {
+    readonly Restart: "restart";
+    readonly Overlap: "overlap";
+    readonly Ignore: "ignore";
+    readonly FadeRestart: "fade-restart";
+};
+/**
+ * Policy used when the instance pool is full and a new play is requested.
+ *
+ * @category Audio
+ */
+export declare const InstanceStealPolicy: {
+    readonly Oldest: "oldest";
+    readonly Quietest: "quietest";
+    readonly Furthest: "furthest";
+};
+/**
+ * Distance attenuation model for positional audio.
+ *
+ * @category Audio
+ */
+export declare const DistanceModel: {
+    readonly Linear: "linear";
+    readonly Inverse: "inverse";
+    readonly Exponential: "exponential";
+};
+/**
+ * Configurable audio playback component for positional and ambient sounds.
+ *
+ * @remarks
+ * - The {@link AudioSystem} loads sources via {@link AssetManager} and manages
+ *   instance pooling, crossfades, and XR session lifecycle.
+ * - For positional audio, attach the component to an entity with a valid
+ *   Object3D; non-positional audio plays from the listener.
+ * - Use `_playRequested/_pauseRequested/_stopRequested` to trigger actions
+ *   without directly reaching into Three.js audio objects.
+ *
+ * @category Audio
+ */
+export declare const AudioSource: import("elics").Component<{
+    src: {
+        type: Types.String;
+        default: string;
+    };
+    volume: {
+        type: Types.Float32;
+        default: number;
+    };
+    loop: {
+        type: Types.Boolean;
+        default: false;
+    };
+    autoplay: {
+        type: Types.Boolean;
+        default: false;
+    };
+    positional: {
+        type: Types.Boolean;
+        default: true;
+    };
+    refDistance: {
+        type: Types.Float32;
+        default: number;
+    };
+    rolloffFactor: {
+        type: Types.Float32;
+        default: number;
+    };
+    maxDistance: {
+        type: Types.Float32;
+        default: number;
+    };
+    distanceModel: {
+        type: Types.Enum;
+        enum: {
+            readonly Linear: "linear";
+            readonly Inverse: "inverse";
+            readonly Exponential: "exponential";
+        };
+        default: "inverse";
+    };
+    coneInnerAngle: {
+        type: Types.Float32;
+        default: number;
+    };
+    coneOuterAngle: {
+        type: Types.Float32;
+        default: number;
+    };
+    coneOuterGain: {
+        type: Types.Float32;
+        default: number;
+    };
+    playbackMode: {
+        type: Types.Enum;
+        enum: {
+            readonly Restart: "restart";
+            readonly Overlap: "overlap";
+            readonly Ignore: "ignore";
+            readonly FadeRestart: "fade-restart";
+        };
+        default: "restart";
+    };
+    maxInstances: {
+        type: Types.Int8;
+        default: number;
+    };
+    crossfadeDuration: {
+        type: Types.Float32;
+        default: number;
+    };
+    instanceStealPolicy: {
+        type: Types.Enum;
+        enum: {
+            readonly Oldest: "oldest";
+            readonly Quietest: "quietest";
+            readonly Furthest: "furthest";
+        };
+        default: "oldest";
+    };
+    _playRequested: {
+        type: Types.Boolean;
+        default: false;
+    };
+    _pauseRequested: {
+        type: Types.Boolean;
+        default: false;
+    };
+    _stopRequested: {
+        type: Types.Boolean;
+        default: false;
+    };
+    _fadeIn: {
+        type: Types.Float32;
+        default: number;
+    };
+    _fadeOut: {
+        type: Types.Float32;
+        default: number;
+    };
+    _pool: {
+        type: Types.Object;
+        default: undefined;
+    };
+    _instances: {
+        type: Types.Object;
+        default: undefined;
+    };
+    _isPlaying: {
+        type: Types.Boolean;
+        default: false;
+    };
+    _buffer: {
+        type: Types.Object;
+        default: undefined;
+    };
+    _loaded: {
+        type: Types.Boolean;
+        default: false;
+    };
+    _loading: {
+        type: Types.Boolean;
+        default: false;
+    };
+}>;
+//# sourceMappingURL=audio.d.ts.map

package/dist/audio/audio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio.d.ts","sourceRoot":"","sources":["../../src/audio/audio.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,EAAmB,MAAM,iBAAiB,CAAC;AAEzD;;;;GAIG;AACH,eAAO,MAAM,YAAY;;;;;CAKf,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,mBAAmB;;;;CAItB,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,aAAa;;;;CAIhB,CAAC;AAEX;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqDvB,CAAC"}

package/dist/audio/audio.js

@@ -0,0 +1,104 @@
+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.
+ */
+/**
+ * Playback behavior when a new play is requested.
+ *
+ * @category Audio
+ */
+const PlaybackMode = {
+    Restart: 'restart',
+    Overlap: 'overlap',
+    Ignore: 'ignore',
+    FadeRestart: 'fade-restart',
+};
+/**
+ * Policy used when the instance pool is full and a new play is requested.
+ *
+ * @category Audio
+ */
+const InstanceStealPolicy = {
+    Oldest: 'oldest',
+    Quietest: 'quietest',
+    Furthest: 'furthest',
+};
+/**
+ * Distance attenuation model for positional audio.
+ *
+ * @category Audio
+ */
+const DistanceModel = {
+    Linear: 'linear',
+    Inverse: 'inverse',
+    Exponential: 'exponential',
+};
+/**
+ * Configurable audio playback component for positional and ambient sounds.
+ *
+ * @remarks
+ * - The {@link AudioSystem} loads sources via {@link AssetManager} and manages
+ *   instance pooling, crossfades, and XR session lifecycle.
+ * - For positional audio, attach the component to an entity with a valid
+ *   Object3D; non-positional audio plays from the listener.
+ * - Use `_playRequested/_pauseRequested/_stopRequested` to trigger actions
+ *   without directly reaching into Three.js audio objects.
+ *
+ * @category Audio
+ */
+const AudioSource = createComponent('AudioSource', {
+    // Core properties
+    src: { type: Types.String, default: '' }, // URL or cache key for an audio buffer
+    volume: { type: Types.Float32, default: 1.0 }, // Linear gain [0..1]
+    loop: { type: Types.Boolean, default: false }, // When true, newly created instances loop
+    autoplay: { type: Types.Boolean, default: false }, // Trigger a single play on first update after load
+    // Spatial properties
+    positional: { type: Types.Boolean, default: true }, // true: PositionalAudio; false: ambient Audio
+    refDistance: { type: Types.Float32, default: 1 }, // Distance at which volume is 1.0
+    rolloffFactor: { type: Types.Float32, default: 1 }, // Rolloff curve steepness
+    maxDistance: { type: Types.Float32, default: 10000 }, // Distance after which volume is 0
+    distanceModel: {
+        type: Types.Enum,
+        enum: DistanceModel,
+        default: DistanceModel.Inverse,
+    },
+    coneInnerAngle: { type: Types.Float32, default: 360 }, // Degrees of full-volume cone
+    coneOuterAngle: { type: Types.Float32, default: 360 }, // Degrees until falloff reaches outer gain
+    coneOuterGain: { type: Types.Float32, default: 0 }, // Gain at the edge/outside of the cone
+    // Playback behavior control
+    playbackMode: {
+        type: Types.Enum,
+        enum: PlaybackMode,
+        default: PlaybackMode.Restart,
+    }, // Behavior when play is triggered while another instance is active
+    maxInstances: { type: Types.Int8, default: 1 }, // Max simultaneous instances in pool
+    crossfadeDuration: { type: Types.Float32, default: 0.1 }, // Seconds used for FadeRestart
+    instanceStealPolicy: {
+        type: Types.Enum,
+        enum: InstanceStealPolicy,
+        default: InstanceStealPolicy.Oldest,
+    }, // Which instance to replace when pool is full
+    // Playback control flags (internal)
+    _playRequested: { type: Types.Boolean, default: false }, // Set true to request play on next update
+    _pauseRequested: { type: Types.Boolean, default: false }, // Set true to request pause (optional fade)
+    _stopRequested: { type: Types.Boolean, default: false }, // Set true to stop and clear instances
+    _fadeIn: { type: Types.Float32, default: 0 }, // Seconds to fade in on next play
+    _fadeOut: { type: Types.Float32, default: 0 }, // Seconds to fade out on pause
+    // Runtime state (managed by AudioSystem)
+    _pool: { type: Types.Object, default: undefined }, // Assigned AudioPool for this entity
+    _instances: { type: Types.Object, default: undefined }, // Active instance list (internal)
+    _isPlaying: { type: Types.Boolean, default: false }, // True if any instance is currently playing
+    _buffer: { type: Types.Object, default: undefined }, // Loaded AudioBuffer
+    _loaded: { type: Types.Boolean, default: false }, // True once buffer is loaded
+    _loading: { type: Types.Boolean, default: false }, // True while buffer is loading
+}, 'AudioSource playback component for positional and non-positional sounds');
+
+export { AudioSource, DistanceModel, InstanceStealPolicy, PlaybackMode };
+//# sourceMappingURL=audio.js.map

package/dist/audio/audio.js.map

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

package/dist/audio/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 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 { AudioSource, PlaybackMode, InstanceStealPolicy, DistanceModel, } from './audio.js';
+export { AudioSystem } from './audio-system.js';
+export { AudioUtils } from './audio-utils.js';
+export { AudioPool, type AudioInstance } from './audio-pool.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/audio/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,WAAW,EACX,YAAY,EACZ,mBAAmB,EACnB,aAAa,GACd,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/ecs/component-registry.d.ts

@@ -0,0 +1,54 @@
+/**
+ * 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 type { Component } from 'elics';
+import type { Entity } from './entity.js';
+import { World } from './world.js';
+/** Field shape for GLXF component metadata. @category ECS */
+export interface GLXFComponentData {
+    [key: string]: {
+        keyString: string;
+        type: string;
+        value: any;
+        alias?: string;
+    };
+}
+/** Mapping entry from GLXF name → component class and optional mapper. @category ECS */
+export interface ComponentRegistryEntry {
+    componentClass: Component<any>;
+    description?: string;
+    mapper?: (glxfData: GLXFComponentData) => Record<string, any>;
+}
+/**
+ * Registry that maps GLXF component names to ECS component classes.
+ *
+ * @remarks
+ * - Separate from `elics`' built-in registry to avoid naming conflicts.
+ * - Supports custom field mappers to translate GLXF metadata to component props.
+ *
+ * @category ECS
+ */
+export declare class GLXFComponentRegistry {
+    private static registry;
+    private static componentToName;
+    /** Register an ECS component class under a GLXF component name. */
+    static register(glxfComponentName: string, componentClass: Component<any>, description?: string, mapper?: (glxfData: GLXFComponentData) => Record<string, any>): void;
+    /** Return the GLXF name for a given component class. */
+    static getComponentName(component: Component<any>): string | undefined;
+    /** Lookup a registered mapping entry by GLXF name. */
+    static getComponent(glxfComponentName: string): ComponentRegistryEntry | undefined;
+    /** Apply mapped components from GLXF metadata to an entity. */
+    static applyComponents(entity: Entity, world: World, glxfComponents: Record<string, GLXFComponentData>): void;
+    /** Default mapper converting GLXF `{ key: { value } }` shape to props. */
+    private static defaultMapper;
+    /** List all registered GLXF component names. */
+    static getRegisteredComponents(): string[];
+    /** Clear the registry (useful for tests). */
+    static clear(): void;
+    /** Placeholder to wire built‑in mappings from generated metadata. */
+    static setupBuiltinComponents(): void;
+}
+//# sourceMappingURL=component-registry.d.ts.map

package/dist/ecs/component-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-registry.d.ts","sourceRoot":"","sources":["../../src/ecs/component-registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAGnC,6DAA6D;AAC7D,MAAM,WAAW,iBAAiB;IAChC,CAAC,GAAG,EAAE,MAAM,GAAG;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,GAAG,CAAC;QACX,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAGD,wFAAwF;AACxF,MAAM,WAAW,sBAAsB;IACrC,cAAc,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,iBAAiB,KAAK,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC/D;AAED;;;;;;;;GAQG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA6C;IACpE,OAAO,CAAC,MAAM,CAAC,eAAe,CAAqC;IAEnE,mEAAmE;IACnE,MAAM,CAAC,QAAQ,CACb,iBAAiB,EAAE,MAAM,EACzB,cAAc,EAAE,SAAS,CAAC,GAAG,CAAC,EAC9B,WAAW,CAAC,EAAE,MAAM,EACpB,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,iBAAiB,KAAK,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC5D,IAAI;IASP,wDAAwD;IACxD,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,SAAS,CAAC,GAAG,CAAC,GAAG,MAAM,GAAG,SAAS;IAItE,sDAAsD;IACtD,MAAM,CAAC,YAAY,CACjB,iBAAiB,EAAE,MAAM,GACxB,sBAAsB,GAAG,SAAS;IAIrC,+DAA+D;IAC/D,MAAM,CAAC,eAAe,CACpB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,KAAK,EACZ,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAChD,IAAI;IA2BP,0EAA0E;IAC1E,OAAO,CAAC,MAAM,CAAC,aAAa;IAc5B,gDAAgD;IAChD,MAAM,CAAC,uBAAuB,IAAI,MAAM,EAAE;IAI1C,6CAA6C;IAC7C,MAAM,CAAC,KAAK,IAAI,IAAI;IAKpB,qEAAqE;IACrE,MAAM,CAAC,sBAAsB,IAAI,IAAI;CAOtC"}

package/dist/ecs/component-registry.js

@@ -0,0 +1,86 @@
+/**
+ * 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.
+ */
+/**
+ * Registry that maps GLXF component names to ECS component classes.
+ *
+ * @remarks
+ * - Separate from `elics`' built-in registry to avoid naming conflicts.
+ * - Supports custom field mappers to translate GLXF metadata to component props.
+ *
+ * @category ECS
+ */
+class GLXFComponentRegistry {
+    /** Register an ECS component class under a GLXF component name. */
+    static register(glxfComponentName, componentClass, description, mapper) {
+        this.registry.set(glxfComponentName, {
+            componentClass,
+            description,
+            mapper,
+        });
+        this.componentToName.set(componentClass, glxfComponentName);
+    }
+    /** Return the GLXF name for a given component class. */
+    static getComponentName(component) {
+        return this.componentToName.get(component);
+    }
+    /** Lookup a registered mapping entry by GLXF name. */
+    static getComponent(glxfComponentName) {
+        return this.registry.get(glxfComponentName);
+    }
+    /** Apply mapped components from GLXF metadata to an entity. */
+    static applyComponents(entity, world, glxfComponents) {
+        Object.entries(glxfComponents).forEach(([componentName, componentData]) => {
+            const entry = this.getComponent(componentName);
+            if (entry) {
+                // Use custom mapper if provided, otherwise use default mapping
+                const componentProps = entry.mapper
+                    ? entry.mapper(componentData)
+                    : this.defaultMapper(componentData);
+                console.log(`Applying component "${componentName}" to entity with props:`, componentProps);
+                if (!entry.componentClass.bitmask) {
+                    world.registerComponent(entry.componentClass);
+                }
+                entity.addComponent(entry.componentClass, componentProps);
+            }
+            else {
+                console.warn(`Component "${componentName}" not found in registry. Available components:`, Array.from(this.registry.keys()));
+            }
+        });
+    }
+    /** Default mapper converting GLXF `{ key: { value } }` shape to props. */
+    static defaultMapper(glxfData) {
+        const props = {};
+        Object.entries(glxfData).forEach(([key, fieldData]) => {
+            if (fieldData && typeof fieldData === 'object' && 'value' in fieldData) {
+                props[key] = fieldData.value;
+            }
+        });
+        return props;
+    }
+    /** List all registered GLXF component names. */
+    static getRegisteredComponents() {
+        return Array.from(this.registry.keys());
+    }
+    /** Clear the registry (useful for tests). */
+    static clear() {
+        this.registry.clear();
+        this.componentToName.clear();
+    }
+    /** Placeholder to wire built‑in mappings from generated metadata. */
+    static setupBuiltinComponents() {
+        // This will be populated with the actual component imports
+        // For now, we'll register the components we know about
+        // Note: This is a temporary solution. In a real implementation,
+        // we would need to import the actual component objects and register them
+        // with their correct names from the components.json
+    }
+}
+GLXFComponentRegistry.registry = new Map();
+GLXFComponentRegistry.componentToName = new Map();
+
+export { GLXFComponentRegistry };
+//# sourceMappingURL=component-registry.js.map

package/dist/ecs/component-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-registry.js","sources":["../../src/ecs/component-registry.ts"],"sourcesContent":[null],"names":[],"mappings":"AAAA;;;;;AAKG;AAyBH;;;;;;;;AAQG;MACU,qBAAqB,CAAA;;IAKhC,OAAO,QAAQ,CACb,iBAAyB,EACzB,cAA8B,EAC9B,WAAoB,EACpB,MAA6D,EAAA;AAE7D,QAAA,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,iBAAiB,EAAE;YACnC,cAAc;YACd,WAAW;YACX,MAAM;AACP,SAAA,CAAC;QACF,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,cAAc,EAAE,iBAAiB,CAAC;IAC7D;;IAGA,OAAO,gBAAgB,CAAC,SAAyB,EAAA;QAC/C,OAAO,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,SAAS,CAAC;IAC5C;;IAGA,OAAO,YAAY,CACjB,iBAAyB,EAAA;QAEzB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,iBAAiB,CAAC;IAC7C;;AAGA,IAAA,OAAO,eAAe,CACpB,MAAc,EACd,KAAY,EACZ,cAAiD,EAAA;AAEjD,QAAA,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,aAAa,EAAE,aAAa,CAAC,KAAI;YACxE,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,aAAa,CAAC;YAC9C,IAAI,KAAK,EAAE;;AAET,gBAAA,MAAM,cAAc,GAAG,KAAK,CAAC;AAC3B,sBAAE,KAAK,CAAC,MAAM,CAAC,aAAa;AAC5B,sBAAE,IAAI,CAAC,aAAa,CAAC,aAAa,CAAC;gBAErC,OAAO,CAAC,GAAG,CACT,CAAA,oBAAA,EAAuB,aAAa,CAAA,uBAAA,CAAyB,EAC7D,cAAc,CACf;AAED,gBAAA,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,OAAO,EAAE;AACjC,oBAAA,KAAK,CAAC,iBAAiB,CAAC,KAAK,CAAC,cAAc,CAAC;gBAC/C;gBACA,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,cAAc,EAAE,cAAc,CAAC;YAC3D;iBAAO;AACL,gBAAA,OAAO,CAAC,IAAI,CACV,cAAc,aAAa,CAAA,8CAAA,CAAgD,EAC3E,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CACjC;YACH;AACF,QAAA,CAAC,CAAC;IACJ;;IAGQ,OAAO,aAAa,CAC1B,QAA2B,EAAA;QAE3B,MAAM,KAAK,GAAwB,EAAE;AAErC,QAAA,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,SAAS,CAAC,KAAI;YACpD,IAAI,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,OAAO,IAAI,SAAS,EAAE;AACtE,gBAAA,KAAK,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,KAAK;YAC9B;AACF,QAAA,CAAC,CAAC;AAEF,QAAA,OAAO,KAAK;IACd;;AAGA,IAAA,OAAO,uBAAuB,GAAA;QAC5B,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;IACzC;;AAGA,IAAA,OAAO,KAAK,GAAA;AACV,QAAA,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE;AACrB,QAAA,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE;IAC9B;;AAGA,IAAA,OAAO,sBAAsB,GAAA;;;;;;IAM7B;;AA/Fe,qBAAA,CAAA,QAAQ,GAAG,IAAI,GAAG,EAAkC;AACpD,qBAAA,CAAA,eAAe,GAAG,IAAI,GAAG,EAA0B;;;;"}

package/dist/ecs/component.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.
+ */
+import { ComponentRegistry, Types, createComponent } from 'elics';
+/** Elics query operators re-export. @category ECS */
+export { eq, ne, lt, le, gt, ge, isin, nin } from 'elics';
+/** ECS component helpers and Types re-export. @category ECS */
+export { Types, createComponent, ComponentRegistry };
+//# sourceMappingURL=component.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"component.d.ts","sourceRoot":"","sources":["../../src/ecs/component.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,iBAAiB,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,OAAO,CAAC;AAElE,qDAAqD;AACrD,OAAO,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAE1D,+DAA+D;AAC/D,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,CAAC"}

package/dist/ecs/entity.d.ts

@@ -0,0 +1,17 @@
+/**
+ * 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 type { PointerEventsMap } from '@pmndrs/pointer-events';
+import type { Object3D, Object3DEventMap } from '../runtime/index.js';
+declare module 'elics' {
+    interface Entity {
+        object3D?: Object3D<Object3DEventMap & PointerEventsMap>;
+    }
+}
+export { Entity } from 'elics';
+/** Sentinel value used for “no parent” in Transform.parent. @category ECS */
+export declare const NullEntity = -1;
+//# sourceMappingURL=entity.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"entity.d.ts","sourceRoot":"","sources":["../../src/ecs/entity.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEtE,OAAO,QAAQ,OAAO,CAAC;IACrB,UAAU,MAAM;QACd,QAAQ,CAAC,EAAE,QAAQ,CAAC,gBAAgB,GAAG,gBAAgB,CAAC,CAAC;KAC1D;CACF;AAED,OAAO,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAC/B,6EAA6E;AAC7E,eAAO,MAAM,UAAU,KAAK,CAAC"}

package/dist/ecs/entity.js

@@ -0,0 +1,13 @@
+export { Entity } from 'elics';
+
+/**
+ * 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.
+ */
+/** Sentinel value used for “no parent” in Transform.parent. @category ECS */
+const NullEntity = -1;
+
+export { NullEntity };
+//# sourceMappingURL=entity.js.map

package/dist/ecs/entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity.js","sources":["../../src/ecs/entity.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAAA;;;;;AAKG;AAYH;AACO,MAAM,UAAU,GAAG;;;;"}