@iwsdk/core 0.1.0 → 0.2.0

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

@@ -0,0 +1,51 @@
+/**
+ * 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';
+import { CameraState } from './types.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.String;
+        default: string;
+    };
+    width: {
+        type: Types.Int16;
+        default: number;
+    };
+    height: {
+        type: Types.Int16;
+        default: number;
+    };
+    frameRate: {
+        type: Types.Int16;
+        default: number;
+    };
+    state: {
+        type: Types.String;
+        default: CameraState;
+    };
+    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;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC;;;GAGG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiBxB,CAAC"}

package/dist/camera/camera-source.js

@@ -0,0 +1,32 @@
+import '@preact/signals-core';
+import '../ecs/world.js';
+import { createComponent, Types } from 'elics';
+import '../ecs/component-registry.js';
+import { CameraState } 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.String, default: 'back' }, // 'front' | 'back' - used for auto-selection
+    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.String, 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,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE;IAC/C,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,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,WAAW,CAAC,QAAQ,EAAE;AAC5D,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,114 @@
+/**
+ * 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 { CameraState } from './types.js';
+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.String;
+                default: string;
+            };
+            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.String;
+                default: CameraState;
+            };
+            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.String;
+                default: string;
+            };
+            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.String;
+                default: CameraState;
+            };
+            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;
+}
+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;AAMH,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEzC;;;;;GAKG;AACH,qBAAa,YAAa,SAAQ,iBAEhC;IACA,IAAI;IAWJ,MAAM;IAkBN;;;;;;OAMG;YACW,WAAW;IAuJzB;;OAEG;IACH,OAAO,CAAC,UAAU;CAoCnB"}

package/dist/camera/camera-system.js

@@ -0,0 +1,208 @@
+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 } 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');
+                const selected = CameraUtils.findByFacing(devices, facing);
+                if (selected) {
+                    deviceId = selected.deviceId;
+                    entity.setValue(CameraSource, 'deviceId', deviceId);
+                }
+                else if (devices.length > 0) {
+                    // Fallback to first camera
+                    deviceId = devices[0].deviceId;
+                    entity.setValue(CameraSource, 'deviceId', deviceId);
+                }
+                else {
+                    console.error('No cameras available');
+                    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
+                stream.getTracks().forEach((track) => track.stop());
+                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
+                stream.getTracks().forEach((track) => track.stop());
+                video.srcObject = 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
+                stream.getTracks().forEach((track) => track.stop());
+                video.srcObject = null;
+                texture.dispose();
+                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');
+            if (stream) {
+                stream.getTracks().forEach((track) => track.stop());
+            }
+            const video = entity.getValue(CameraSource, 'videoElement');
+            if (video) {
+                video.pause();
+                video.srcObject = null;
+            }
+            const texture = entity.getValue(CameraSource, 'texture');
+            if (texture) {
+                texture.dispose();
+            }
+            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');
+        // Stop stream
+        if (stream) {
+            stream.getTracks().forEach((track) => track.stop());
+        }
+        // Clean up video element
+        if (video) {
+            video.pause();
+            video.srcObject = null;
+        }
+        // Dispose texture
+        if (texture) {
+            texture.dispose();
+        }
+        // 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);
+    }
+}
+
+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 } 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: 'front' | 'back'): 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,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD;;;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,OAAO,GAAG,MAAM,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"}

package/dist/camera/camera-utils.js

@@ -0,0 +1,140 @@
+import { CameraSource } from './camera-source.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.
+ */
+/**
+ * CameraUtils - Static utilities for camera discovery and selection
+ * Handles permission requests and device enumeration with caching
+ */
+class CameraUtils {
+    /**
+     * 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 async getDevices(refresh = false) {
+        // Return cache if available and not forcing refresh
+        if (this.cachedDevices && !refresh) {
+            return this.cachedDevices;
+        }
+        try {
+            // Request permission by getting a temporary stream
+            const tempStream = await navigator.mediaDevices.getUserMedia({
+                video: true,
+            });
+            // Immediately stop the stream - we just needed permission
+            tempStream.getTracks().forEach((track) => track.stop());
+            // Enumerate all video devices
+            const devices = await navigator.mediaDevices.enumerateDevices();
+            const videoDevices = devices.filter((d) => d.kind === 'videoinput');
+            // Map to our interface with facing detection
+            this.cachedDevices = videoDevices.map((device) => {
+                const label = device.label.toLowerCase();
+                let facing = 'unknown';
+                if (label.includes('back') ||
+                    label.includes('environment') ||
+                    label.includes('rear')) {
+                    facing = 'back';
+                }
+                else if (label.includes('front') ||
+                    label.includes('user') ||
+                    label.includes('face')) {
+                    facing = 'front';
+                }
+                return {
+                    deviceId: device.deviceId,
+                    label: device.label,
+                    facing,
+                };
+            });
+            return this.cachedDevices;
+        }
+        catch (error) {
+            console.error('Failed to enumerate camera devices:', error);
+            throw error;
+        }
+    }
+    /**
+     * Find camera by facing direction from device list
+     */
+    static findByFacing(devices, facing) {
+        return devices.find((d) => d.facing === facing) || null;
+    }
+    /**
+     * Check if camera permission is granted (doesn't request)
+     */
+    static async hasPermission() {
+        try {
+            const result = await navigator.permissions.query({
+                name: 'camera',
+            });
+            return result.state === 'granted';
+        }
+        catch (_a) {
+            // Permissions API not supported
+            return false;
+        }
+    }
+    /**
+     * 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) {
+        // Get video element from CameraSource component
+        const videoElement = entity.getValue(CameraSource, 'videoElement');
+        if (!videoElement) {
+            return null;
+        }
+        // Validate video has valid dimensions
+        if (videoElement.videoWidth === 0 || videoElement.videoHeight === 0) {
+            return null;
+        }
+        // Create canvas at video resolution
+        const canvas = document.createElement('canvas');
+        canvas.width = videoElement.videoWidth;
+        canvas.height = videoElement.videoHeight;
+        // Draw current video frame to canvas
+        const ctx = canvas.getContext('2d', { colorSpace: 'srgb' });
+        if (!ctx) {
+            return null;
+        }
+        ctx.drawImage(videoElement, 0, 0);
+        return canvas;
+    }
+}
+CameraUtils.cachedDevices = null;
+
+export { CameraUtils };
+//# sourceMappingURL=camera-utils.js.map

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

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

package/dist/camera/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 * from './types.js';
+export * from './camera-utils.js';
+export * from './camera-source.js';
+export * from './camera-system.js';
+//# sourceMappingURL=index.d.ts.map

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

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