@iwsdk/core 0.1.0 → 0.2.1

package/dist/camera/camera-source.d.ts

@@ -0,0 +1,61 @@
+/**
+ * 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';
+/**
+ * CameraSource - Component for accessing device cameras
+ * Provides VideoTexture for rendering and HTMLVideoElement for advanced use
+ */
+export declare const CameraSource: import("elics").Component<{
+    deviceId: {
+        type: Types.String;
+        default: string;
+    };
+    facing: {
+        type: Types.Enum;
+        enum: {
+            readonly Back: "back";
+            readonly Front: "front";
+            readonly Unknown: "unknown";
+        };
+        default: "unknown";
+    };
+    width: {
+        type: Types.Int16;
+        default: number;
+    };
+    height: {
+        type: Types.Int16;
+        default: number;
+    };
+    frameRate: {
+        type: Types.Int16;
+        default: number;
+    };
+    state: {
+        type: Types.Enum;
+        enum: {
+            readonly Inactive: "inactive";
+            readonly Starting: "starting";
+            readonly Active: "active";
+            readonly Error: "error";
+        };
+        default: "inactive";
+    };
+    texture: {
+        type: Types.Object;
+        default: null;
+    };
+    videoElement: {
+        type: Types.Object;
+        default: null;
+    };
+    stream: {
+        type: Types.Object;
+        default: null;
+    };
+}>;
+//# sourceMappingURL=camera-source.d.ts.map

package/dist/camera/camera-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"camera-source.d.ts","sourceRoot":"","sources":["../../src/camera/camera-source.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,EAAmB,MAAM,iBAAiB,CAAC;AAGzD;;;GAGG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyBxB,CAAC"}

package/dist/camera/camera-source.js

@@ -0,0 +1,40 @@
+import '@preact/signals-core';
+import '../ecs/world.js';
+import { createComponent, Types } from 'elics';
+import '../ecs/component-registry.js';
+import { CameraState, CameraFacing } from './types.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.
+ */
+/**
+ * CameraSource - Component for accessing device cameras
+ * Provides VideoTexture for rendering and HTMLVideoElement for advanced use
+ */
+const CameraSource = createComponent('CameraSource', {
+    // Input (set by user)
+    deviceId: { type: Types.String, default: '' }, // Empty = auto-select based on facing
+    facing: {
+        type: Types.Enum,
+        enum: CameraFacing,
+        default: CameraFacing.Unknown,
+    }, // 'front' | 'back' | 'unknown' - used for auto-selection (unknown = any camera)
+    width: { type: Types.Int16, default: 1920 },
+    height: { type: Types.Int16, default: 1080 },
+    frameRate: { type: Types.Int16, default: 30 },
+    // Output (managed by system, read-only for users)
+    state: {
+        type: Types.Enum,
+        enum: CameraState,
+        default: CameraState.Inactive,
+    }, // 'inactive' | 'starting' | 'active' | 'error'
+    texture: { type: Types.Object, default: null }, // VideoTexture
+    videoElement: { type: Types.Object, default: null }, // HTMLVideoElement (for advanced use)
+    stream: { type: Types.Object, default: null }, // MediaStream (internal)
+}, 'Camera video source with texture output');
+
+export { CameraSource };
+//# sourceMappingURL=camera-source.js.map

package/dist/camera/camera-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"camera-source.js","sources":["../../src/camera/camera-source.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;AAAA;;;;;AAKG;AAKH;;;AAGG;AACI,MAAM,YAAY,GAAG,eAAe,CACzC,cAAc,EACd;;AAEE,IAAA,QAAQ,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE;AAC7C,IAAA,MAAM,EAAE;QACN,IAAI,EAAE,KAAK,CAAC,IAAI;AAChB,QAAA,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE,YAAY,CAAC,OAAO;AAC9B,KAAA;IACD,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE;IAC3C,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE;IAC5C,SAAS,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE;;AAG7C,IAAA,KAAK,EAAE;QACL,IAAI,EAAE,KAAK,CAAC,IAAI;AAChB,QAAA,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,WAAW,CAAC,QAAQ;AAC9B,KAAA;AACD,IAAA,OAAO,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE;AAC9C,IAAA,YAAY,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE;AACnD,IAAA,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE;CAC9C,EACD,yCAAyC;;;;"}

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

@@ -0,0 +1,139 @@
+/**
+ * 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 CameraSystem_base: import("elics").SystemConstructor<import("elics").SystemSchema, {
+    cameras: {
+        required: import("elics").Component<{
+            deviceId: {
+                type: import("elics/lib/types.js").Types.String;
+                default: string;
+            };
+            facing: {
+                type: import("elics/lib/types.js").Types.Enum;
+                enum: {
+                    readonly Back: "back";
+                    readonly Front: "front";
+                    readonly Unknown: "unknown";
+                };
+                default: "unknown";
+            };
+            width: {
+                type: import("elics/lib/types.js").Types.Int16;
+                default: number;
+            };
+            height: {
+                type: import("elics/lib/types.js").Types.Int16;
+                default: number;
+            };
+            frameRate: {
+                type: import("elics/lib/types.js").Types.Int16;
+                default: number;
+            };
+            state: {
+                type: import("elics/lib/types.js").Types.Enum;
+                enum: {
+                    readonly Inactive: "inactive";
+                    readonly Starting: "starting";
+                    readonly Active: "active";
+                    readonly Error: "error";
+                };
+                default: "inactive";
+            };
+            texture: {
+                type: import("elics/lib/types.js").Types.Object;
+                default: null;
+            };
+            videoElement: {
+                type: import("elics/lib/types.js").Types.Object;
+                default: null;
+            };
+            stream: {
+                type: import("elics/lib/types.js").Types.Object;
+                default: null;
+            };
+        }>[];
+    };
+}, import("../ecs/world.js").World, import("../ecs/system.js").System<import("elics").SystemSchema, {
+    cameras: {
+        required: import("elics").Component<{
+            deviceId: {
+                type: import("elics/lib/types.js").Types.String;
+                default: string;
+            };
+            facing: {
+                type: import("elics/lib/types.js").Types.Enum;
+                enum: {
+                    readonly Back: "back";
+                    readonly Front: "front";
+                    readonly Unknown: "unknown";
+                };
+                default: "unknown";
+            };
+            width: {
+                type: import("elics/lib/types.js").Types.Int16;
+                default: number;
+            };
+            height: {
+                type: import("elics/lib/types.js").Types.Int16;
+                default: number;
+            };
+            frameRate: {
+                type: import("elics/lib/types.js").Types.Int16;
+                default: number;
+            };
+            state: {
+                type: import("elics/lib/types.js").Types.Enum;
+                enum: {
+                    readonly Inactive: "inactive";
+                    readonly Starting: "starting";
+                    readonly Active: "active";
+                    readonly Error: "error";
+                };
+                default: "inactive";
+            };
+            texture: {
+                type: import("elics/lib/types.js").Types.Object;
+                default: null;
+            };
+            videoElement: {
+                type: import("elics/lib/types.js").Types.Object;
+                default: null;
+            };
+            stream: {
+                type: import("elics/lib/types.js").Types.Object;
+                default: null;
+            };
+        }>[];
+    };
+}>>;
+/**
+ * CameraSystem - Manages camera stream lifecycle for CameraSource components
+ * Automatically starts streams when XR session is active, stops when inactive
+ *
+ * System is stateless - all state is stored in CameraSource components
+ */
+export declare class CameraSystem extends CameraSystem_base {
+    init(): void;
+    update(): void;
+    /**
+     * Start camera stream for an entity
+     * Async operation - sets state to Starting, then Active when complete
+     * Users should check state or null-check texture/videoElement before using
+     *
+     * Checks state after each async operation to abort if stopCamera was called
+     */
+    private startCamera;
+    /**
+     * Stop camera stream for an entity
+     */
+    private stopCamera;
+    /**
+     * Clean up camera resources (stream, video element, texture)
+     */
+    private cleanupCameraResources;
+}
+export {};
+//# sourceMappingURL=camera-system.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"camera-system.d.ts","sourceRoot":"","sources":["../../src/camera/camera-system.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAQH;;;;;GAKG;AACH,qBAAa,YAAa,SAAQ,iBAEhC;IACA,IAAI;IAWJ,MAAM;IAkBN;;;;;;OAMG;YACW,WAAW;IAsJzB;;OAEG;IACH,OAAO,CAAC,UAAU;IAuBlB;;OAEG;IACH,OAAO,CAAC,sBAAsB;CAgB/B"}

package/dist/camera/camera-system.js

@@ -0,0 +1,210 @@
+import { createSystem } from '../ecs/system.js';
+import { VisibilityState } from '../ecs/world.js';
+import 'elics';
+import '../ecs/component-registry.js';
+import '../runtime/three.js';
+import { CameraSource } from './camera-source.js';
+import { CameraUtils } from './camera-utils.js';
+import { CameraState, CameraFacing } from './types.js';
+import { VideoTexture, LinearFilter } from 'three';
+
+/**
+ * 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.
+ */
+/**
+ * CameraSystem - Manages camera stream lifecycle for CameraSource components
+ * Automatically starts streams when XR session is active, stops when inactive
+ *
+ * System is stateless - all state is stored in CameraSource components
+ */
+class CameraSystem extends createSystem({
+    cameras: { required: [CameraSource] },
+}) {
+    init() {
+        // Stop all cameras when leaving XR
+        this.world.visibilityState.subscribe((state) => {
+            if (state !== VisibilityState.Visible) {
+                for (const entity of this.queries.cameras.entities) {
+                    this.stopCamera(entity);
+                }
+            }
+        });
+    }
+    update() {
+        // Only manage cameras when XR is active
+        const isXRActive = this.world.visibilityState.value === VisibilityState.Visible;
+        if (!isXRActive) {
+            return;
+        }
+        for (const entity of this.queries.cameras.entities) {
+            const state = entity.getValue(CameraSource, 'state');
+            // Start camera if inactive (not started or errored)
+            if (state === CameraState.Inactive || state === CameraState.Error) {
+                this.startCamera(entity);
+            }
+        }
+    }
+    /**
+     * Start camera stream for an entity
+     * Async operation - sets state to Starting, then Active when complete
+     * Users should check state or null-check texture/videoElement before using
+     *
+     * Checks state after each async operation to abort if stopCamera was called
+     */
+    async startCamera(entity) {
+        // Set state to Starting to prevent duplicate attempts
+        entity.setValue(CameraSource, 'state', CameraState.Starting);
+        try {
+            let deviceId = entity.getValue(CameraSource, 'deviceId');
+            // Auto-select camera if no deviceId provided
+            if (!deviceId) {
+                const devices = await CameraUtils.getDevices();
+                // Check if we should abort (stopCamera was called during async operation)
+                const currentState = entity.getValue(CameraSource, 'state');
+                if (currentState !== CameraState.Starting) {
+                    return; // Aborted
+                }
+                const facing = entity.getValue(CameraSource, 'facing');
+                if (facing === CameraFacing.Unknown) {
+                    // Unknown = any camera is fine, use first available
+                    if (devices.length > 0) {
+                        deviceId = devices[0].deviceId;
+                        entity.setValue(CameraSource, 'deviceId', deviceId);
+                    }
+                    else {
+                        console.error('No cameras available');
+                        entity.setValue(CameraSource, 'state', CameraState.Error);
+                        return;
+                    }
+                }
+                else {
+                    // Specific facing requested - must match or fail
+                    const selected = CameraUtils.findByFacing(devices, facing);
+                    if (selected) {
+                        deviceId = selected.deviceId;
+                        entity.setValue(CameraSource, 'deviceId', deviceId);
+                    }
+                    else {
+                        const facingStr = facing === CameraFacing.Back ? 'back' : 'front';
+                        console.error(`No ${facingStr}-facing camera available (found ${devices.length} camera(s))`);
+                        entity.setValue(CameraSource, 'state', CameraState.Error);
+                        return;
+                    }
+                }
+            }
+            // Get stream constraints
+            const width = entity.getValue(CameraSource, 'width');
+            const height = entity.getValue(CameraSource, 'height');
+            const frameRate = entity.getValue(CameraSource, 'frameRate');
+            // Request camera stream
+            const stream = await navigator.mediaDevices.getUserMedia({
+                video: {
+                    deviceId: { exact: deviceId },
+                    width: { ideal: width },
+                    height: { ideal: height },
+                    frameRate: { ideal: frameRate },
+                },
+            });
+            // Check if we should abort after getting stream
+            const currentState = entity.getValue(CameraSource, 'state');
+            if (currentState !== CameraState.Starting) {
+                // Aborted - clean up the stream we just created
+                this.cleanupCameraResources(stream, null, null);
+                return;
+            }
+            // Create video element
+            const video = document.createElement('video');
+            video.setAttribute('playsinline', '');
+            video.setAttribute('autoplay', '');
+            video.muted = true;
+            video.srcObject = stream;
+            // Wait for video to be ready
+            await new Promise((resolve, reject) => {
+                const onCanPlay = () => {
+                    video.removeEventListener('canplay', onCanPlay);
+                    video.removeEventListener('error', onError);
+                    resolve();
+                };
+                const onError = (error) => {
+                    video.removeEventListener('canplay', onCanPlay);
+                    video.removeEventListener('error', onError);
+                    reject(error);
+                };
+                video.addEventListener('canplay', onCanPlay);
+                video.addEventListener('error', onError);
+            });
+            // Check if we should abort after video ready
+            const finalState = entity.getValue(CameraSource, 'state');
+            if (finalState !== CameraState.Starting) {
+                // Aborted - clean up everything
+                this.cleanupCameraResources(stream, video, null);
+                return;
+            }
+            // Start playback
+            await video.play();
+            // Create VideoTexture
+            const texture = new VideoTexture(video);
+            texture.minFilter = LinearFilter;
+            texture.magFilter = LinearFilter;
+            // Final check before committing - ensure state is still Starting
+            const committingState = entity.getValue(CameraSource, 'state');
+            if (committingState !== CameraState.Starting) {
+                // Aborted at the last moment - clean up everything
+                this.cleanupCameraResources(stream, video, texture);
+                return;
+            }
+            // Commit all resources atomically
+            entity.setValue(CameraSource, 'stream', stream);
+            entity.setValue(CameraSource, 'videoElement', video);
+            entity.setValue(CameraSource, 'texture', texture);
+            entity.setValue(CameraSource, 'state', CameraState.Active);
+        }
+        catch (error) {
+            console.error('Failed to start camera:', error);
+            // Clean up any partial state
+            const stream = entity.getValue(CameraSource, 'stream');
+            const video = entity.getValue(CameraSource, 'videoElement');
+            const texture = entity.getValue(CameraSource, 'texture');
+            this.cleanupCameraResources(stream, video, texture);
+            entity.setValue(CameraSource, 'stream', null);
+            entity.setValue(CameraSource, 'videoElement', null);
+            entity.setValue(CameraSource, 'texture', null);
+            entity.setValue(CameraSource, 'state', CameraState.Error);
+        }
+    }
+    /**
+     * Stop camera stream for an entity
+     */
+    stopCamera(entity) {
+        const stream = entity.getValue(CameraSource, 'stream');
+        const video = entity.getValue(CameraSource, 'videoElement');
+        const texture = entity.getValue(CameraSource, 'texture');
+        this.cleanupCameraResources(stream, video, texture);
+        // Clear component values and set state to Inactive
+        entity.setValue(CameraSource, 'stream', null);
+        entity.setValue(CameraSource, 'videoElement', null);
+        entity.setValue(CameraSource, 'texture', null);
+        entity.setValue(CameraSource, 'state', CameraState.Inactive);
+    }
+    /**
+     * Clean up camera resources (stream, video element, texture)
+     */
+    cleanupCameraResources(stream, video, texture) {
+        if (stream) {
+            stream.getTracks().forEach((track) => track.stop());
+        }
+        if (video) {
+            video.pause();
+            video.srcObject = null;
+        }
+        if (texture) {
+            texture.dispose();
+        }
+    }
+}
+
+export { CameraSystem };
+//# sourceMappingURL=camera-system.js.map

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

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

package/dist/camera/camera-utils.d.ts

@@ -0,0 +1,63 @@
+/**
+ * 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 CameraDeviceInfo, type CameraFacingType } from './types.js';
+/**
+ * CameraUtils - Static utilities for camera discovery and selection
+ * Handles permission requests and device enumeration with caching
+ */
+export declare class CameraUtils {
+    private static cachedDevices;
+    /**
+     * Get available camera devices
+     *
+     * On first call or if refresh=true:
+     * - Requests camera permission (if not granted)
+     * - Enumerates all video input devices
+     * - Caches results for subsequent calls
+     *
+     * On subsequent calls with refresh=false:
+     * - Returns cached results immediately
+     *
+     * @param refresh - Force re-enumeration (useful for hot-plugged devices)
+     * @returns Array of available camera devices
+     */
+    static getDevices(refresh?: boolean): Promise<CameraDeviceInfo[]>;
+    /**
+     * Find camera by facing direction from device list
+     */
+    static findByFacing(devices: CameraDeviceInfo[], facing: CameraFacingType): CameraDeviceInfo | null;
+    /**
+     * Check if camera permission is granted (doesn't request)
+     */
+    static hasPermission(): Promise<boolean>;
+    /**
+     * Capture current video frame as a canvas
+     * Returns canvas at full video resolution, ready for processing
+     *
+     * @param entity - Entity with CameraSource component
+     * @returns HTMLCanvasElement or null if camera not ready
+     *
+     * @example
+     * // Simple texture creation
+     * const canvas = CameraUtils.captureFrame(cameraEntity);
+     * if (canvas) {
+     *   const texture = new CanvasTexture(canvas);
+     * }
+     *
+     * @example
+     * // With post-processing
+     * const canvas = CameraUtils.captureFrame(cameraEntity);
+     * if (canvas) {
+     *   const ctx = canvas.getContext('2d');
+     *   ctx.filter = 'blur(2px)';
+     *   const texture = new CanvasTexture(canvas);
+     * }
+     */
+    static captureFrame(entity: Entity): HTMLCanvasElement | null;
+}
+//# sourceMappingURL=camera-utils.d.ts.map

package/dist/camera/camera-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"camera-utils.d.ts","sourceRoot":"","sources":["../../src/camera/camera-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAEzC,OAAO,EAAgB,KAAK,gBAAgB,EAAE,KAAK,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAExF;;;GAGG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAC,aAAa,CAAmC;IAE/D;;;;;;;;;;;;;OAaG;WACU,UAAU,CAAC,OAAO,UAAQ,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAoDrE;;OAEG;IACH,MAAM,CAAC,YAAY,CACjB,OAAO,EAAE,gBAAgB,EAAE,EAC3B,MAAM,EAAE,gBAAgB,GACvB,gBAAgB,GAAG,IAAI;IAI1B;;OAEG;WACU,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC;IAY9C;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI;CA+B9D"}