@vizor-vr/player 0.2.0

package/dist/register.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Auto-register all Vizor custom elements.
+ * Used by the CDN script tag build.
+ */
+export declare function registerAll(): void;
+//# sourceMappingURL=register.d.ts.map

package/dist/register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../src/register.ts"],"names":[],"mappings":"AAUA;;;GAGG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAYlC"}

package/dist/register.js

@@ -0,0 +1,5 @@
+import { r } from "./register-CwnmiGEs.js";
+export {
+  r as registerAll
+};
+//# sourceMappingURL=register.js.map

package/dist/register.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/renderer/camera-controller.d.ts

@@ -0,0 +1,75 @@
+import { PerspectiveCamera } from 'three';
+import type { PlayerState } from '../core/player-state.js';
+interface CameraConfig {
+    startLat: number;
+    startLon: number;
+    focalLength: number;
+    minFocalLength: number;
+    maxFocalLength: number;
+    isPanoramic: boolean;
+    fovH?: number;
+}
+/**
+ * Unified camera controller for the VR player.
+ *
+ * Handles:
+ * - Mouse drag (desktop)
+ * - Touch drag (mobile)
+ * - Device orientation / gyroscope (mobile magic window)
+ * - Keyboard arrow keys
+ * - FOV zoom (scroll wheel / pinch)
+ *
+ * WebXR head tracking is handled by Three.js WebXRManager directly.
+ */
+export declare class CameraController {
+    private camera;
+    private state;
+    private domElement;
+    private lat;
+    private lon;
+    private targetLat;
+    private targetLon;
+    private fov;
+    private isPanoramic;
+    private minFov;
+    private maxFov;
+    private fovH;
+    private enabled;
+    private isDragging;
+    private lastPointer;
+    private deviceOrientationEnabled;
+    private deviceAlpha;
+    private deviceBeta;
+    private deviceGamma;
+    private boundHandlers;
+    constructor(camera: PerspectiveCamera, domElement: HTMLElement, state: PlayerState, config: CameraConfig);
+    /** Enable or disable input processing (disabled during WebXR) */
+    setEnabled(enabled: boolean): void;
+    /** Switch panoramic mode at runtime (e.g. cinema overrides flat → panoramic) */
+    setPanoramic(panoramic: boolean): void;
+    /** Call per frame in animation loop */
+    update(): void;
+    /** Get current orientation */
+    getOrientation(): {
+        lat: number;
+        lon: number;
+        fov: number;
+    };
+    /** Set orientation programmatically */
+    setOrientation(lat: number, lon: number, snap?: boolean): void;
+    /** Enable device orientation (gyroscope) */
+    enableDeviceOrientation(): void;
+    /** Dispose all event listeners */
+    dispose(): void;
+    private attachListeners;
+    private addHandler;
+    private onPointerDown;
+    private onPointerMove;
+    private onPointerUp;
+    private onWheel;
+    private onKeyDown;
+    private applyDeviceOrientation;
+    private updateCamera;
+}
+export {};
+//# sourceMappingURL=camera-controller.d.ts.map

package/dist/renderer/camera-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"camera-controller.d.ts","sourceRoot":"","sources":["../../src/renderer/camera-controller.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAA8B,MAAM,OAAO,CAAC;AAGtE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,UAAU,YAAY;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,OAAO,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,UAAU,CAAc;IAGhC,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,GAAG,CAAS;IAGpB,OAAO,CAAC,WAAW,CAAU;IAC7B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,IAAI,CAAS;IAGrB,OAAO,CAAC,OAAO,CAAQ;IAGvB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,WAAW,CAAiB;IAGpC,OAAO,CAAC,wBAAwB,CAAS;IACzC,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,WAAW,CAAK;IAGxB,OAAO,CAAC,aAAa,CAAmD;gBAE5D,MAAM,EAAE,iBAAiB,EAAE,UAAU,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY;IAyBxG,iEAAiE;IACjE,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAOlC,gFAAgF;IAChF,YAAY,CAAC,SAAS,EAAE,OAAO,GAAG,IAAI;IAStC,uCAAuC;IACvC,MAAM,IAAI,IAAI;IA4Bd,8BAA8B;IAC9B,cAAc,IAAI;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE;IAQ3D,uCAAuC;IACvC,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,UAAQ,GAAG,IAAI;IAU5D,4CAA4C;IAC5C,uBAAuB,IAAI,IAAI;IAe/B,kCAAkC;IAClC,OAAO,IAAI,IAAI;IAOf,OAAO,CAAC,eAAe;IAmBvB,OAAO,CAAC,UAAU;IAKlB,OAAO,CAAC,aAAa;IAQrB,OAAO,CAAC,aAAa;IAYrB,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,OAAO;IAaf,OAAO,CAAC,SAAS;IAuBjB,OAAO,CAAC,sBAAsB;IAS9B,OAAO,CAAC,YAAY;CAarB"}

package/dist/renderer/projections/cinema-projection.d.ts

@@ -0,0 +1,32 @@
+import { Mesh } from 'three';
+import type { PerspectiveCamera, Texture } from 'three';
+import type { StereoMode } from '@vizor-vr/shared';
+import type { IProjection } from './projection.js';
+export interface CinemaConfig {
+    screenWidth: number;
+    screenHeight: number;
+    screenDistance: number;
+    screenOffsetY: number;
+}
+/**
+ * Cinema projection: flat video screen inside a panoramic room.
+ *
+ * Composes two geometries:
+ * - Inverted sphere for the room environment (equirectangular)
+ * - Flat plane for the video screen positioned at configurable distance/size
+ */
+export declare class CinemaProjection implements IProjection {
+    private meshes;
+    private roomMesh;
+    private config;
+    constructor(config?: Partial<CinemaConfig>);
+    createMeshes(videoTexture: Texture, stereoMode: StereoMode): Mesh[];
+    /** Set the room equirectangular texture */
+    setRoomTexture(texture: Texture): void;
+    configureCamera(camera: PerspectiveCamera): void;
+    update(_camera: PerspectiveCamera, _time: number): void;
+    dispose(): void;
+    private remapUVsHorizontal;
+    private remapUVsVertical;
+}
+//# sourceMappingURL=cinema-projection.d.ts.map

package/dist/renderer/projections/cinema-projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cinema-projection.d.ts","sourceRoot":"","sources":["../../../src/renderer/projections/cinema-projection.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,IAAI,EACL,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;CACvB;AASD;;;;;;GAMG;AACH,qBAAa,gBAAiB,YAAW,WAAW;IAClD,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,MAAM,CAAe;gBAEjB,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC;IAI1C,YAAY,CAAC,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,GAAG,IAAI,EAAE;IAkDnE,2CAA2C;IAC3C,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAQtC,eAAe,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI;IAQhD,MAAM,CAAC,OAAO,EAAE,iBAAiB,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAIvD,OAAO,IAAI,IAAI;IASf,OAAO,CAAC,kBAAkB;IAS1B,OAAO,CAAC,gBAAgB;CAQzB"}

package/dist/renderer/projections/cubemap-projection.d.ts

@@ -0,0 +1,34 @@
+import { Mesh } from 'three';
+import type { PerspectiveCamera, Texture } from 'three';
+import type { StereoMode } from '@vizor-vr/shared';
+import type { IProjection } from './projection.js';
+/**
+ * Cubemap projection for standard 3x2 atlas cubemap content.
+ * Creates an inverted box with each face's UVs remapped to the
+ * corresponding tile in the atlas texture.
+ * For stereo content, creates two boxes on different Three.js layers
+ * with UV remapping for side-by-side or top-bottom layouts.
+ */
+export declare class CubemapProjection implements IProjection {
+    private meshes;
+    createMeshes(texture: Texture, stereoMode: StereoMode): Mesh[];
+    configureCamera(camera: PerspectiveCamera): void;
+    update(_camera: PerspectiveCamera, _time: number): void;
+    dispose(): void;
+    private createBox;
+    /**
+     * Remap UV coordinates for cubemap atlas layout, with optional stereo offset.
+     *
+     * BoxGeometry has 6 faces, each with 4 vertices (indices faceIndex*4 .. faceIndex*4+3).
+     * Default UVs for each face span [0,1] in both U and V.
+     * We remap each face to its tile in the 3x2 atlas, then apply stereo compression
+     * if needed.
+     *
+     * For TB stereo the entire atlas occupies either the top or bottom half of the
+     * texture, so V coordinates are compressed to half and offset accordingly.
+     * For SBS stereo the atlas occupies either the left or right half, so U
+     * coordinates are compressed to half and offset accordingly.
+     */
+    private remapFaceUVs;
+}
+//# sourceMappingURL=cubemap-projection.d.ts.map

package/dist/renderer/projections/cubemap-projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cubemap-projection.d.ts","sourceRoot":"","sources":["../../../src/renderer/projections/cubemap-projection.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,IAAI,EACL,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,EAAE,iBAAiB,EAAE,OAAO,EAAmB,MAAM,OAAO,CAAC;AACzE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAwBnD;;;;;;GAMG;AACH,qBAAa,iBAAkB,YAAW,WAAW;IACnD,OAAO,CAAC,MAAM,CAAc;IAE5B,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,GAAG,IAAI,EAAE;IA2B9D,eAAe,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI;IAQhD,MAAM,CAAC,OAAO,EAAE,iBAAiB,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAIvD,OAAO,IAAI,IAAI;IAQf,OAAO,CAAC,SAAS;IAajB;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,YAAY;CA+DrB"}

package/dist/renderer/projections/eac-projection.d.ts

@@ -0,0 +1,35 @@
+import { Mesh } from 'three';
+import type { PerspectiveCamera, Texture } from 'three';
+import type { StereoMode } from '@vizor-vr/shared';
+import type { IProjection } from './projection.js';
+/**
+ * Equi-Angular Cubemap (EAC) projection for 3x2 atlas cubemap content.
+ * Uses the same box geometry and UV atlas layout as CubemapProjection,
+ * but applies a ShaderMaterial with tan() angular correction in the
+ * fragment shader to correct for the equi-angular sampling distortion.
+ *
+ * For stereo content, creates two boxes on different Three.js layers
+ * with UV remapping for side-by-side or top-bottom layouts.
+ */
+export declare class EacProjection implements IProjection {
+    private meshes;
+    createMeshes(texture: Texture, stereoMode: StereoMode): Mesh[];
+    configureCamera(camera: PerspectiveCamera): void;
+    update(_camera: PerspectiveCamera, _time: number): void;
+    dispose(): void;
+    private createBox;
+    /**
+     * Provide each face's atlas tile as a per-vertex `faceRegion` attribute
+     * (xy = tile origin, zw = tile size), leaving geometry.uv as the default
+     * face-local [0,1] coordinates. The fragment shader applies the equi-angular
+     * correction in that face-local space and then maps the result into the tile
+     * — applying the correction in atlas space (the previous approach) is wrong
+     * because the tan() distortion is per-face.
+     *
+     * BoxGeometry has 6 faces, each with 4 vertices (indices face*4 .. face*4+3).
+     * For TB stereo the atlas occupies the top or bottom half of the texture (V
+     * compressed/offset); for SBS, the left or right half (U compressed/offset).
+     */
+    private setupFaceAtlas;
+}
+//# sourceMappingURL=eac-projection.d.ts.map

package/dist/renderer/projections/eac-projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eac-projection.d.ts","sourceRoot":"","sources":["../../../src/renderer/projections/eac-projection.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,IAAI,EAGL,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAyBnD;;;;;;;;GAQG;AACH,qBAAa,aAAc,YAAW,WAAW;IAC/C,OAAO,CAAC,MAAM,CAAc;IAE5B,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,GAAG,IAAI,EAAE;IA2B9D,eAAe,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI;IAQhD,MAAM,CAAC,OAAO,EAAE,iBAAiB,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAIvD,OAAO,IAAI,IAAI;IAQf,OAAO,CAAC,SAAS;IAgBjB;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,cAAc;CAkDvB"}

package/dist/renderer/projections/equirect-projection.d.ts

@@ -0,0 +1,27 @@
+import { Mesh } from 'three';
+import type { PerspectiveCamera, Texture } from 'three';
+import type { StereoMode } from '@vizor-vr/shared';
+import type { IProjection } from './projection.js';
+/**
+ * Equirectangular projection for 360 and 180 content.
+ * Creates an inverted sphere with the texture mapped on the inside.
+ * For stereo content, creates two spheres on different Three.js layers
+ * with UV remapping for side-by-side or top-bottom layouts.
+ */
+export declare class EquirectProjection implements IProjection {
+    private meshes;
+    private fovH;
+    constructor(fovH?: number);
+    createMeshes(texture: Texture, stereoMode: StereoMode): Mesh[];
+    configureCamera(camera: PerspectiveCamera): void;
+    update(_camera: PerspectiveCamera, _time: number): void;
+    dispose(): void;
+    private createSphere;
+    /**
+     * Remap UV coordinates for stereo content.
+     * SBS: left eye uses left half (u: 0-0.5), right eye uses right half (u: 0.5-1)
+     * TB: left eye uses top half (v: 0.5-1), right eye uses bottom half (v: 0-0.5)
+     */
+    private remapUVs;
+}
+//# sourceMappingURL=equirect-projection.d.ts.map

package/dist/renderer/projections/equirect-projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"equirect-projection.d.ts","sourceRoot":"","sources":["../../../src/renderer/projections/equirect-projection.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,IAAI,EACL,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD;;;;;GAKG;AACH,qBAAa,kBAAmB,YAAW,WAAW;IACpD,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,IAAI,CAAS;gBAET,IAAI,GAAE,MAAY;IAI9B,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,GAAG,IAAI,EAAE;IAwB9D,eAAe,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI;IAQhD,MAAM,CAAC,OAAO,EAAE,iBAAiB,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAIvD,OAAO,IAAI,IAAI;IAQf,OAAO,CAAC,YAAY;IAyBpB;;;;OAIG;IACH,OAAO,CAAC,QAAQ;CAwBjB"}

package/dist/renderer/projections/fisheye-projection.d.ts

@@ -0,0 +1,28 @@
+import { Mesh } from 'three';
+import type { PerspectiveCamera, Texture } from 'three';
+import type { StereoMode } from '@vizor-vr/shared';
+import type { IProjection } from './projection.js';
+/**
+ * Dual fisheye projection for 360 content captured with dual-fisheye cameras
+ * (e.g. Ricoh Theta, Insta360).
+ *
+ * The texture contains two circular fisheye images side by side:
+ *   - Left circle: front hemisphere (z >= 0)
+ *   - Right circle: back hemisphere (z < 0)
+ *
+ * Uses a full inverted SphereGeometry (like equirectangular) but with a
+ * ShaderMaterial that computes fisheye UV mapping from world-space direction
+ * vectors rather than relying on geometry UVs.
+ *
+ * For stereo content, two spheres are created on separate Three.js layers
+ * with shader uniforms selecting the appropriate texture sub-region per eye.
+ */
+export declare class FisheyeProjection implements IProjection {
+    private meshes;
+    createMeshes(texture: Texture, stereoMode: StereoMode): Mesh[];
+    configureCamera(camera: PerspectiveCamera): void;
+    update(_camera: PerspectiveCamera, _time: number): void;
+    dispose(): void;
+    private createSphere;
+}
+//# sourceMappingURL=fisheye-projection.d.ts.map

package/dist/renderer/projections/fisheye-projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fisheye-projection.d.ts","sourceRoot":"","sources":["../../../src/renderer/projections/fisheye-projection.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,IAAI,EAEL,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAgDnD;;;;;;;;;;;;;;GAcG;AACH,qBAAa,iBAAkB,YAAW,WAAW;IACnD,OAAO,CAAC,MAAM,CAAc;IAE5B,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,GAAG,IAAI,EAAE;IAuB9D,eAAe,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI;IAQhD,MAAM,CAAC,OAAO,EAAE,iBAAiB,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAIvD,OAAO,IAAI,IAAI;IAQf,OAAO,CAAC,YAAY;CA8BrB"}

package/dist/renderer/projections/flat-projection.d.ts

@@ -0,0 +1,32 @@
+import { Mesh } from 'three';
+import type { PerspectiveCamera, Texture } from 'three';
+import type { StereoMode } from '@vizor-vr/shared';
+import type { IProjection } from './projection.js';
+/**
+ * Flat projection for standard 2D and 3D (SBS/TB) video.
+ *
+ * Behaves like `object-fit: contain` — the plane preserves the video's
+ * native aspect ratio and scales to fit as large as possible within the
+ * viewport.  Letterbox / pillarbox bars appear only when the video and
+ * container aspect ratios differ.
+ */
+export declare class FlatProjection implements IProjection {
+    private meshes;
+    /** Video aspect ratio (accounts for stereo layout). */
+    private videoAspect;
+    private stereoMode;
+    createMeshes(texture: Texture, stereoMode: StereoMode): Mesh[];
+    configureCamera(camera: PerspectiveCamera): void;
+    /**
+     * Scale the plane every frame to fit inside the camera frustum
+     * while preserving the video's native aspect ratio (`object-fit: contain`).
+     *
+     * Also re-reads the video dimensions so the aspect ratio updates if
+     * the source changes (e.g. adaptive streaming resolution switch).
+     */
+    update(camera: PerspectiveCamera, _time: number): void;
+    dispose(): void;
+    private createPlane;
+    private remapUVs;
+}
+//# sourceMappingURL=flat-projection.d.ts.map

package/dist/renderer/projections/flat-projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flat-projection.d.ts","sourceRoot":"","sources":["../../../src/renderer/projections/flat-projection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoC,IAAI,EAAa,MAAM,OAAO,CAAC;AAC1E,OAAO,KAAK,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAKnD;;;;;;;GAOG;AACH,qBAAa,cAAe,YAAW,WAAW;IAChD,OAAO,CAAC,MAAM,CAAc;IAC5B,uDAAuD;IACvD,OAAO,CAAC,WAAW,CAAU;IAC7B,OAAO,CAAC,UAAU,CAAsB;IAExC,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,GAAG,IAAI,EAAE;IAsC9D,eAAe,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI;IAShD;;;;;;OAMG;IACH,MAAM,CAAC,MAAM,EAAE,iBAAiB,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAuCtD,OAAO,IAAI,IAAI;IAQf,OAAO,CAAC,WAAW;IAQnB,OAAO,CAAC,QAAQ;CAmBjB"}

package/dist/renderer/projections/projection.d.ts

@@ -0,0 +1,18 @@
+import type { PerspectiveCamera, Mesh, Texture } from 'three';
+import type { StereoMode } from '@vizor-vr/shared';
+/**
+ * Interface for projection strategies.
+ * Each VzFormat maps to a specific projection that knows
+ * how to create geometry, materials, and meshes for rendering.
+ */
+export interface IProjection {
+    /** Create meshes for the scene. Returns [mono] or [left, right] for stereo. */
+    createMeshes(texture: Texture, stereoMode: StereoMode): Mesh[];
+    /** Configure camera FOV and constraints for this projection type */
+    configureCamera(camera: PerspectiveCamera): void;
+    /** Per-frame update (e.g., shader uniforms). Called in animation loop. */
+    update(camera: PerspectiveCamera, time: number): void;
+    /** Clean up GPU resources */
+    dispose(): void;
+}
+//# sourceMappingURL=projection.d.ts.map

package/dist/renderer/projections/projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection.d.ts","sourceRoot":"","sources":["../../../src/renderer/projections/projection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAA4B,IAAI,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AACxF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,+EAA+E;IAC/E,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,GAAG,IAAI,EAAE,CAAC;IAE/D,oEAAoE;IACpE,eAAe,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAEjD,0EAA0E;IAC1E,MAAM,CAAC,MAAM,EAAE,iBAAiB,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAEtD,6BAA6B;IAC7B,OAAO,IAAI,IAAI,CAAC;CACjB"}

package/dist/renderer/renderer.d.ts

@@ -0,0 +1,72 @@
+import { Scene, WebGLRenderer, PerspectiveCamera } from 'three';
+import type { Texture } from 'three';
+import type { VzFormat } from '@vizor-vr/shared';
+import type { PlayerConfig } from '@vizor-vr/shared';
+import type { PlayerState } from '../core/player-state.js';
+import type { StereoMode } from '@vizor-vr/shared';
+import type { IProjection } from './projections/projection.js';
+import { CameraController } from './camera-controller.js';
+import type { AudioManager } from '../audio/audio-manager.js';
+/**
+ * Main renderer facade.
+ * Manages the Three.js scene, camera, projection, and animation loop.
+ */
+export declare class VzRenderer {
+    private scene;
+    private renderer;
+    private camera;
+    private cameraController;
+    private projection;
+    private videoTexture;
+    private audioManager;
+    private state;
+    private config;
+    private canvas;
+    private isRunning;
+    private containerEl;
+    private intersectionObserver;
+    private isVisible;
+    private fpsHistory;
+    private lastFrameTime;
+    constructor(shadowRoot: ShadowRoot, containerEl: HTMLElement, state: PlayerState, config: PlayerConfig);
+    /** Set up the projection and texture for a video element */
+    setupVideo(videoElement: HTMLVideoElement, format: VzFormat): void;
+    /** Set up the projection and texture for an image */
+    setupImage(texture: Texture, format: VzFormat): void;
+    /**
+     * Load a compressed KTX2 texture (optional, GPU-compressed).
+     * Falls back gracefully if KTX2Loader is not available.
+     */
+    loadCompressedTexture(url: string, format: VzFormat): Promise<void>;
+    /** Start the animation loop */
+    start(): void;
+    /** Stop the animation loop */
+    stop(): void;
+    /** Handle container resize */
+    resize(): void;
+    /** Get the WebGL renderer (for WebXR integration) */
+    getThreeRenderer(): WebGLRenderer;
+    /** Get the camera (for WebXR integration) */
+    getCamera(): PerspectiveCamera;
+    /** Get the camera controller */
+    getCameraController(): CameraController;
+    /** Get the Three.js scene (for hotspot integration) */
+    getScene(): Scene;
+    /** Set the audio manager for spatial audio orientation updates */
+    setAudioManager(manager: AudioManager): void;
+    /** Clean up all GPU resources */
+    dispose(): void;
+    /** Set a custom projection (for cinema mode) */
+    setCustomProjection(projection: IProjection, texture: Texture, stereoMode: StereoMode): void;
+    /** Dispose all meshes, materials, and textures in the scene */
+    private disposeSceneChildren;
+    private setProjection;
+    private createProjection;
+    private tick;
+    /**
+     * Adaptive quality: adjust pixel ratio based on recent FPS.
+     * Drop at <30fps, increase at >55fps. Checked every 60 frames.
+     */
+    private adaptPixelRatio;
+}
+//# sourceMappingURL=renderer.d.ts.map

package/dist/renderer/renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../../src/renderer/renderer.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,EACL,aAAa,EACb,iBAAiB,EAMlB,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,EAAE,OAAO,EAAY,MAAM,OAAO,CAAC;AAC/C,OAAO,KAAK,EAAE,QAAQ,EAAc,MAAM,kBAAkB,CAAC;AAE7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAM/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAE9D;;;GAGG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,UAAU,CAA4B;IAC9C,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,oBAAoB,CAAqC;IACjE,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,UAAU,CAAgB;IAClC,OAAO,CAAC,aAAa,CAAK;gBAEd,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY;IA0DtG,4DAA4D;IAC5D,UAAU,CAAC,YAAY,EAAE,gBAAgB,EAAE,MAAM,EAAE,QAAQ,GAAG,IAAI;IAkBlE,qDAAqD;IACrD,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,GAAG,IAAI;IAUpD;;;OAGG;IACG,qBAAqB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBzE,+BAA+B;IAC/B,KAAK,IAAI,IAAI;IAMb,8BAA8B;IAC9B,IAAI,IAAI,IAAI;IAKZ,8BAA8B;IAC9B,MAAM,IAAI,IAAI;IAYd,qDAAqD;IACrD,gBAAgB,IAAI,aAAa;IAIjC,6CAA6C;IAC7C,SAAS,IAAI,iBAAiB;IAI9B,gCAAgC;IAChC,mBAAmB,IAAI,gBAAgB;IAIvC,uDAAuD;IACvD,QAAQ,IAAI,KAAK;IAIjB,kEAAkE;IAClE,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI;IAI5C,iCAAiC;IACjC,OAAO,IAAI,IAAI;IAef,gDAAgD;IAChD,mBAAmB,CAAC,UAAU,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,GAAG,IAAI;IAc5F,+DAA+D;IAC/D,OAAO,CAAC,oBAAoB;IAiC5B,OAAO,CAAC,aAAa;IAsBrB,OAAO,CAAC,gBAAgB;IAkBxB,OAAO,CAAC,IAAI;IA8BZ;;;OAGG;IACH,OAAO,CAAC,eAAe;CAuBxB"}

package/dist/renderer/shaders/eac.glsl.d.ts

@@ -0,0 +1,12 @@
+/** EAC vertex shader — passes the face-local UV and the face's atlas tile region. */
+export declare const eacVertexShader = "\nattribute vec4 faceRegion;\nvarying vec2 vUv;\nvarying vec4 vFaceRegion;\n\nvoid main() {\n  vUv = uv;\n  vFaceRegion = faceRegion;\n  gl_Position = projectionMatrix * modelViewMatrix * vec4(position, 1.0);\n}\n";
+/**
+ * EAC fragment shader. The equi-angular (tan) correction must be applied in each
+ * cube face's LOCAL 0..1 space, not in atlas space — so `vUv` is the face-local
+ * coordinate and `vFaceRegion` (xy = tile origin, zw = tile size) maps the
+ * corrected coordinate into the face's tile in the 3x2 atlas. The face edges
+ * (uv 0 and 1) map to themselves and the centre stays centred, so face
+ * orientation is preserved while interior samples are redistributed correctly.
+ */
+export declare const eacFragmentShader = "\nuniform sampler2D map;\nvarying vec2 vUv;\nvarying vec4 vFaceRegion;\n\nconst float PI = 3.14159265359;\n\nvoid main() {\n  // Equi-angular correction in face-local space: 0..1 -> -1..1 -> tan -> 0..1.\n  vec2 ndc = vUv * 2.0 - 1.0;\n  ndc = tan(ndc * PI / 4.0);\n  vec2 faceUv = clamp(ndc * 0.5 + 0.5, 0.0, 1.0);\n\n  // Map the corrected face-local UV into this face's atlas tile.\n  vec2 atlasUv = vFaceRegion.xy + faceUv * vFaceRegion.zw;\n\n  gl_FragColor = texture2D(map, atlasUv);\n}\n";
+//# sourceMappingURL=eac.glsl.d.ts.map

package/dist/renderer/shaders/eac.glsl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eac.glsl.d.ts","sourceRoot":"","sources":["../../../src/renderer/shaders/eac.glsl.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,eAAO,MAAM,eAAe,0NAU3B,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB,mfAkB7B,CAAC"}

package/dist/renderer/shaders/fisheye.glsl.d.ts

@@ -0,0 +1,22 @@
+/**
+ * GLSL shaders for dual fisheye projection.
+ *
+ * A dual fisheye texture contains two circular fisheye images side by side:
+ *   - Left circle: front hemisphere (z >= 0)
+ *   - Right circle: back hemisphere (z < 0)
+ *
+ * For stereo content (SBS or TB), the entire dual-fisheye pair is packed
+ * into a sub-region of the texture. Uniforms uScaleX/uScaleY/uOffsetX/uOffsetY
+ * select the appropriate region per eye.
+ */
+/** Fisheye vertex shader -- passes world position to fragment shader */
+export declare const fisheyeVertexShader = "\nvarying vec3 vWorldPosition;\n\nvoid main() {\n  vec4 worldPos = modelMatrix * vec4(position, 1.0);\n  vWorldPosition = worldPos.xyz;\n  gl_Position = projectionMatrix * modelViewMatrix * vec4(position, 1.0);\n}\n";
+/**
+ * Dual fisheye fragment shader -- maps sphere surface to circular fisheye UV.
+ *
+ * Stereo uniforms allow selecting a sub-region of the texture:
+ *   - uScaleX / uScaleY: scale factor applied to the final UV (1.0 = full, 0.5 = half)
+ *   - uOffsetX / uOffsetY: offset added after scaling (0.0 or 0.5 for stereo halves)
+ */
+export declare const fisheyeFragmentShader = "\nuniform sampler2D map;\nuniform float uScaleX;\nuniform float uScaleY;\nuniform float uOffsetX;\nuniform float uOffsetY;\n\nvarying vec3 vWorldPosition;\n\nconst float PI = 3.14159265359;\n\nvoid main() {\n  vec3 dir = normalize(vWorldPosition);\n\n  // Determine which hemisphere: front (z >= 0) or back (z < 0)\n  bool isFront = dir.z >= 0.0;\n  float faceSign = isFront ? 1.0 : -1.0;\n\n  // Polar angle from the hemisphere pole (0 at pole, PI/2 at equator)\n  float theta = acos(clamp(abs(dir.z), -1.0, 1.0));\n\n  // Azimuthal angle around the hemisphere pole\n  float phi = atan(dir.y, dir.x * faceSign);\n\n  // Map to circular fisheye UV using equidistant projection\n  // r ranges from 0 (pole) to 1 (equator)\n  float r = theta / (PI * 0.5);\n\n  // Convert polar (r, phi) to cartesian circle coordinates, centered at (0.5, 0.5)\n  vec2 circleUV = vec2(r * cos(phi), r * sin(phi)) * 0.5 + 0.5;\n\n  // Place front hemisphere in left half of the dual-fisheye region,\n  // back hemisphere in right half\n  float xOffset = isFront ? 0.0 : 0.5;\n  vec2 uv = vec2(circleUV.x * 0.5 + xOffset, circleUV.y);\n\n  // Apply stereo region selection\n  uv = vec2(uv.x * uScaleX + uOffsetX, uv.y * uScaleY + uOffsetY);\n\n  gl_FragColor = texture2D(map, uv);\n}\n";
+//# sourceMappingURL=fisheye.glsl.d.ts.map

package/dist/renderer/shaders/fisheye.glsl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fisheye.glsl.d.ts","sourceRoot":"","sources":["../../../src/renderer/shaders/fisheye.glsl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,wEAAwE;AACxE,eAAO,MAAM,mBAAmB,4NAQ/B,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,ovCAyCjC,CAAC"}

package/dist/spatial-BeadwNJA.js

@@ -0,0 +1,146 @@
+import { M as Matrix4 } from "./three-Bci7aSeI.js";
+class AmbisonicRenderer {
+  foaRenderer = null;
+  context = null;
+  rotationMatrix = new Matrix4();
+  /**
+   * Initialize the FOA decoder and connect the audio graph.
+   *
+   * @param context - The AudioContext
+   * @param sourceNode - MediaElementAudioSourceNode from the video element
+   */
+  async init(context, sourceNode) {
+    this.context = context;
+    const Omnitone = await this.loadOmnitone();
+    this.foaRenderer = Omnitone.createFOARenderer(context, {
+      // AmbiX channel ordering (ACN) with SN3D normalization
+      channelMap: [0, 1, 2, 3]
+    });
+    await this.foaRenderer.initialize();
+    sourceNode.connect(this.foaRenderer.input);
+    this.foaRenderer.output.connect(context.destination);
+    this.foaRenderer.setRenderingMode("ambisonic");
+  }
+  /**
+   * Update the soundfield rotation from the camera's world matrix.
+   * Called each frame from the renderer tick loop.
+   */
+  updateOrientation(camera) {
+    if (!this.foaRenderer) return;
+    camera.updateMatrixWorld();
+    this.rotationMatrix.extractRotation(camera.matrixWorld);
+    this.foaRenderer.setRotationMatrix4(
+      Array.from(this.rotationMatrix.elements)
+    );
+  }
+  /** Dispose audio resources */
+  dispose() {
+    if (this.foaRenderer) {
+      this.foaRenderer.setRenderingMode("off");
+    }
+    this.foaRenderer = null;
+    this.context = null;
+  }
+  /**
+   * Dynamically import Omnitone.
+   * Falls back to window.Omnitone if a CDN script tag is used.
+   */
+  async loadOmnitone() {
+    try {
+      const mod = await import("omnitone");
+      return mod;
+    } catch {
+      const global = globalThis.Omnitone;
+      if (global) return global;
+      throw new Error(
+        "[Vizor] Omnitone not found. Install with `npm install omnitone` or include via CDN script tag."
+      );
+    }
+  }
+}
+class AudioManager {
+  constructor(state, events) {
+    this.state = state;
+    this.events = events;
+    this.audioFormat = "stereo";
+  }
+  audioContext = null;
+  sourceNode = null;
+  ambisonicRenderer = null;
+  audioFormat;
+  videoElement = null;
+  initialized = false;
+  /**
+   * Initialize audio processing for a video element.
+   * Must be called after a user gesture (click/play) to satisfy autoplay policy.
+   */
+  async init(videoElement, audioFormat = "stereo") {
+    if (this.initialized) return;
+    this.videoElement = videoElement;
+    this.audioFormat = audioFormat;
+    this.audioContext = new AudioContext();
+    this.sourceNode = this.audioContext.createMediaElementSource(videoElement);
+    if (audioFormat === "ambix") {
+      this.ambisonicRenderer = new AmbisonicRenderer();
+      try {
+        await this.ambisonicRenderer.init(this.audioContext, this.sourceNode);
+      } catch (err) {
+        console.warn("[Vizor] Ambisonic init failed, falling back to stereo:", err);
+        this.events.emit("vz-error", {
+          code: "AUDIO_AMBISONIC_FAILED",
+          message: "Ambisonic audio failed, using stereo fallback"
+        });
+        this.ambisonicRenderer = null;
+        this.sourceNode.connect(this.audioContext.destination);
+      }
+    } else {
+      this.sourceNode.connect(this.audioContext.destination);
+    }
+    this.initialized = true;
+  }
+  /**
+   * Resume AudioContext after user gesture.
+   * Browsers require a user interaction before AudioContext can play.
+   */
+  async resume() {
+    if (this.audioContext && this.audioContext.state === "suspended") {
+      await this.audioContext.resume();
+    }
+  }
+  /**
+   * Update listener orientation from camera.
+   * Called each frame from the renderer tick loop.
+   */
+  updateOrientation(camera) {
+    if (!this.ambisonicRenderer || !this.initialized) return;
+    this.ambisonicRenderer.updateOrientation(camera);
+  }
+  /** Get the audio format */
+  getAudioFormat() {
+    return this.audioFormat;
+  }
+  /** Check if initialized */
+  isInitialized() {
+    return this.initialized;
+  }
+  /** Dispose all audio resources */
+  dispose() {
+    this.ambisonicRenderer?.dispose();
+    this.ambisonicRenderer = null;
+    if (this.sourceNode) {
+      this.sourceNode.disconnect();
+      this.sourceNode = null;
+    }
+    if (this.audioContext && this.audioContext.state !== "closed") {
+      this.audioContext.close().catch(() => {
+      });
+    }
+    this.audioContext = null;
+    this.videoElement = null;
+    this.initialized = false;
+  }
+}
+export {
+  AudioManager as A
+};
+//# sourceMappingURL=spatial-BeadwNJA.js.map

package/dist/spatial-BeadwNJA.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spatial-BeadwNJA.js","sources":["../src/audio/ambisonic-renderer.ts","../src/audio/audio-manager.ts"],"sourcesContent":["import type { PerspectiveCamera } from 'three';\nimport { Matrix4 } from 'three';\n\n/**\n * Omnitone FOARenderer types (dynamically imported).\n * We define a minimal interface to avoid a hard dependency.\n */\ninterface OmnitoneFOARenderer {\n  input: AudioNode;\n  output: AudioNode;\n  initialize(): Promise<void>;\n  setRenderingMode(mode: 'ambisonic' | 'bypass' | 'off'): void;\n  setRotationMatrix4(matrix: number[]): void;\n}\n\ninterface OmnitoneModule {\n  createFOARenderer(context: AudioContext, options?: Record<string, unknown>): OmnitoneFOARenderer;\n}\n\n/**\n * Decodes first-order ambisonic (FOA) AmbiX audio to binaural stereo.\n *\n * Uses Omnitone (Google Chrome Labs) for spatial audio decoding.\n * The soundfield rotation is updated each frame from the Three.js camera's\n * world matrix, keeping audio orientation in sync with the visual scene.\n *\n * Audio graph:\n *   MediaElementSource → FOARenderer.input → FOARenderer.output → AudioContext.destination\n */\nexport class AmbisonicRenderer {\n  private foaRenderer: OmnitoneFOARenderer | null = null;\n  private context: AudioContext | null = null;\n  private rotationMatrix = new Matrix4();\n\n  /**\n   * Initialize the FOA decoder and connect the audio graph.\n   *\n   * @param context - The AudioContext\n   * @param sourceNode - MediaElementAudioSourceNode from the video element\n   */\n  async init(context: AudioContext, sourceNode: MediaElementAudioSourceNode): Promise<void> {\n    this.context = context;\n\n    // Dynamic import — omnitone is an optional dependency\n    const Omnitone = await this.loadOmnitone();\n\n    this.foaRenderer = Omnitone.createFOARenderer(context, {\n      // AmbiX channel ordering (ACN) with SN3D normalization\n      channelMap: [0, 1, 2, 3],\n    });\n\n    await this.foaRenderer.initialize();\n\n    // Connect: source → FOA decoder → speakers\n    sourceNode.connect(this.foaRenderer.input);\n    this.foaRenderer.output.connect(context.destination);\n\n    this.foaRenderer.setRenderingMode('ambisonic');\n  }\n\n  /**\n   * Update the soundfield rotation from the camera's world matrix.\n   * Called each frame from the renderer tick loop.\n   */\n  updateOrientation(camera: PerspectiveCamera): void {\n    if (!this.foaRenderer) return;\n\n    // Extract the rotation matrix from the camera's world matrix.\n    // Camera.matrixWorld is automatically updated by Three.js each frame.\n    // We need the inverse rotation — Omnitone expects the listener's rotation\n    // (where the listener is looking), which is the camera's rotation inverted\n    // because the soundfield should rotate opposite to the head movement.\n    camera.updateMatrixWorld();\n    this.rotationMatrix.extractRotation(camera.matrixWorld);\n\n    // Omnitone expects a column-major Float32Array/number[]\n    // Three.js Matrix4.elements is already column-major\n    this.foaRenderer.setRotationMatrix4(\n      Array.from(this.rotationMatrix.elements),\n    );\n  }\n\n  /** Dispose audio resources */\n  dispose(): void {\n    if (this.foaRenderer) {\n      this.foaRenderer.setRenderingMode('off');\n    }\n    this.foaRenderer = null;\n    this.context = null;\n  }\n\n  /**\n   * Dynamically import Omnitone.\n   * Falls back to window.Omnitone if a CDN script tag is used.\n   */\n  private async loadOmnitone(): Promise<OmnitoneModule> {\n    try {\n      // Try ES module import first (npm install omnitone)\n      // eslint-disable-next-line @typescript-eslint/ban-ts-comment\n      // @ts-ignore — omnitone has no type declarations; we define our own interface above\n      const mod = await import('omnitone');\n      return mod as unknown as OmnitoneModule;\n    } catch {\n      // Fall back to global (CDN script tag)\n      const global = (globalThis as Record<string, unknown>).Omnitone as OmnitoneModule | undefined;\n      if (global) return global;\n      throw new Error(\n        '[Vizor] Omnitone not found. Install with `npm install omnitone` or include via CDN script tag.',\n      );\n    }\n  }\n}\n","import type { PerspectiveCamera } from 'three';\nimport type { PlayerState } from '../core/player-state.js';\nimport type { VzEventEmitter } from '../core/event-emitter.js';\nimport { AmbisonicRenderer } from './ambisonic-renderer.js';\n\nexport type AudioFormat = 'ambix' | 'stereo';\n\n/**\n * Manages audio playback and spatial audio decoding.\n *\n * For standard stereo audio: passes through unchanged.\n * For AmbiX FOA audio: decodes 4-channel ambisonic stream to binaural stereo,\n * rotating the soundfield to match camera orientation each frame.\n */\nexport class AudioManager {\n  private audioContext: AudioContext | null = null;\n  private sourceNode: MediaElementAudioSourceNode | null = null;\n  private ambisonicRenderer: AmbisonicRenderer | null = null;\n  private audioFormat: AudioFormat;\n  private videoElement: HTMLVideoElement | null = null;\n  private initialized = false;\n\n  constructor(\n    private state: PlayerState,\n    private events: VzEventEmitter,\n  ) {\n    this.audioFormat = 'stereo';\n  }\n\n  /**\n   * Initialize audio processing for a video element.\n   * Must be called after a user gesture (click/play) to satisfy autoplay policy.\n   */\n  async init(videoElement: HTMLVideoElement, audioFormat: AudioFormat = 'stereo'): Promise<void> {\n    if (this.initialized) return;\n\n    this.videoElement = videoElement;\n    this.audioFormat = audioFormat;\n\n    // Create AudioContext (lazy — created on first init to avoid autoplay issues)\n    this.audioContext = new AudioContext();\n\n    // Create source node from the video element\n    this.sourceNode = this.audioContext.createMediaElementSource(videoElement);\n\n    if (audioFormat === 'ambix') {\n      // Dynamic import of ambisonic renderer\n      this.ambisonicRenderer = new AmbisonicRenderer();\n      try {\n        await this.ambisonicRenderer.init(this.audioContext, this.sourceNode);\n      } catch (err) {\n        console.warn('[Vizor] Ambisonic init failed, falling back to stereo:', err);\n        this.events.emit('vz-error', {\n          code: 'AUDIO_AMBISONIC_FAILED',\n          message: 'Ambisonic audio failed, using stereo fallback',\n        });\n        // Fall back to stereo passthrough\n        this.ambisonicRenderer = null;\n        this.sourceNode.connect(this.audioContext.destination);\n      }\n    } else {\n      // Stereo passthrough — connect source directly to destination\n      this.sourceNode.connect(this.audioContext.destination);\n    }\n\n    this.initialized = true;\n  }\n\n  /**\n   * Resume AudioContext after user gesture.\n   * Browsers require a user interaction before AudioContext can play.\n   */\n  async resume(): Promise<void> {\n    if (this.audioContext && this.audioContext.state === 'suspended') {\n      await this.audioContext.resume();\n    }\n  }\n\n  /**\n   * Update listener orientation from camera.\n   * Called each frame from the renderer tick loop.\n   */\n  updateOrientation(camera: PerspectiveCamera): void {\n    if (!this.ambisonicRenderer || !this.initialized) return;\n    this.ambisonicRenderer.updateOrientation(camera);\n  }\n\n  /** Get the audio format */\n  getAudioFormat(): AudioFormat {\n    return this.audioFormat;\n  }\n\n  /** Check if initialized */\n  isInitialized(): boolean {\n    return this.initialized;\n  }\n\n  /** Dispose all audio resources */\n  dispose(): void {\n    this.ambisonicRenderer?.dispose();\n    this.ambisonicRenderer = null;\n\n    if (this.sourceNode) {\n      this.sourceNode.disconnect();\n      this.sourceNode = null;\n    }\n\n    if (this.audioContext && this.audioContext.state !== 'closed') {\n      this.audioContext.close().catch(() => {});\n    }\n    this.audioContext = null;\n    this.videoElement = null;\n    this.initialized = false;\n  }\n}\n"],"names":[],"mappings":"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"}