@vizor-vr/player 0.2.0

package/dist/utils/fullscreen.d.ts

@@ -0,0 +1,6 @@
+/** Cross-browser fullscreen API wrapper */
+export declare function requestFullscreen(element: HTMLElement): Promise<void>;
+export declare function exitFullscreen(): Promise<void>;
+export declare function isFullscreen(): boolean;
+export declare function onFullscreenChange(callback: () => void): () => void;
+//# sourceMappingURL=fullscreen.d.ts.map

package/dist/utils/fullscreen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fullscreen.d.ts","sourceRoot":"","sources":["../../src/utils/fullscreen.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAC3C,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAUrE;AAED,wBAAgB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAS9C;AAED,wBAAgB,YAAY,IAAI,OAAO,CAEtC;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAOnE"}

package/dist/utils/sanitize.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Sanitize a URL for safe use in an `href` or `src` attribute.
+ *
+ * Allows http(s), protocol-relative (`//host`), and relative URLs. Anything
+ * with a dangerous scheme (`javascript:`, `data:`, `vbscript:`, etc.) is
+ * rejected and the `fallback` is returned instead. Control characters that can
+ * be used to smuggle a scheme (e.g. `java\tscript:`) are stripped first.
+ */
+export declare function sanitizeUrl(url: string | undefined | null, fallback?: string): string;
+/**
+ * Sanitize untrusted annotation HTML with DOMPurify.
+ *
+ * Used both at the source (`<vz-annotation>` parsing) and the render sink
+ * (annotation popup) so the stored content is never an XSS vector regardless of
+ * which consumer reads it. `style` is intentionally NOT allowed (avoids
+ * CSS-based exfiltration); `onerror`/`onload`/etc. are stripped by DOMPurify.
+ */
+export declare function sanitizeAnnotationHtml(html: string): string;
+//# sourceMappingURL=sanitize.d.ts.map

package/dist/utils/sanitize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize.d.ts","sourceRoot":"","sources":["../../src/utils/sanitize.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,EAAE,QAAQ,SAAK,GAAG,MAAM,CA0BjF;AAUD;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAM3D"}

package/dist/vizor.js

@@ -0,0 +1,113 @@
+import { C, a, H, K, P, S, V, b, c, d, e, f, g, h, i, j, k, l, m, X, n, o, p, r, q, s, t, u, v, w, x, y, z, A } from "./register-CwnmiGEs.js";
+import { A as A2 } from "./spatial-BeadwNJA.js";
+import { C as C2, p as p2 } from "./captions-BP0H2E03.js";
+import { A as A3, c as c2, d as d2 } from "./annotations-C0ugfCn4.js";
+import { C as C3, a as a2, b as b2, G, c as c3, V as V2, d as d3 } from "./collab-BXPomrS0.js";
+class QualitySelector {
+  adapter = null;
+  state;
+  constructor(state) {
+    this.state = state;
+  }
+  /** Connect to the current streaming adapter */
+  setAdapter(adapter) {
+    this.adapter = adapter;
+    this.syncState();
+  }
+  /** Get available quality levels */
+  getLevels() {
+    return this.adapter?.getQualityLevels() ?? [];
+  }
+  /** Set quality by index (-1 = auto) */
+  setLevel(index) {
+    if (!this.adapter) return;
+    this.adapter.setQualityLevel(index);
+    const levels = this.adapter.getQualityLevels();
+    this.state.batch({
+      availableQualities: levels,
+      currentQuality: index === -1 ? "auto" : levels[index]?.label ?? "auto",
+      autoQuality: index === -1
+    });
+  }
+  /** Whether auto quality (ABR) is active */
+  get isAuto() {
+    return this.state.get("autoQuality");
+  }
+  /** Whether the adapter supports quality switching */
+  get supportsQuality() {
+    return (this.adapter?.supportsABR ?? false) && this.getLevels().length > 1;
+  }
+  /** Sync state from adapter */
+  syncState() {
+    if (!this.adapter) return;
+    const levels = this.adapter.getQualityLevels();
+    if (levels.length > 0) {
+      this.state.batch({
+        availableQualities: levels,
+        currentQuality: "auto",
+        autoQuality: true
+      });
+    }
+  }
+}
+function isFeatureEnabled(feature, license) {
+  return license.features[feature] === true;
+}
+function getEnabledFeatures(license) {
+  return Object.keys(license.features).filter(
+    (key) => license.features[key]
+  );
+}
+export {
+  A3 as AnnotationManager,
+  c2 as AnnotationPopup,
+  d2 as AnnotationSprite,
+  A2 as AudioManager,
+  C as CameraController,
+  C2 as CaptionRenderer,
+  C3 as ChatButton,
+  a2 as ChatPanel,
+  b2 as CollaborativeClient,
+  a as ControlsOverlay,
+  G as GazeCursorManager,
+  c3 as GazeSender,
+  H as HotspotManager,
+  K as KeyboardShortcuts,
+  P as PlayerState,
+  QualitySelector,
+  S as SourceManager,
+  V2 as VoiceButton,
+  d3 as VoiceManager,
+  V as VzAnnotationElement,
+  b as VzBaseElement,
+  c as VzCinemaElement,
+  d as VzEventEmitter,
+  e as VzImgElement,
+  f as VzLiveElement,
+  g as VzMediaElement,
+  h as VzPlaylistElement,
+  i as VzRenderer,
+  j as VzTourElement,
+  k as VzTourImgElement,
+  l as VzTourPortalElement,
+  m as VzVideoElement,
+  X as XRManager,
+  n as checkLicense,
+  o as createWatermark,
+  getEnabledFeatures,
+  p as initAnalytics,
+  isFeatureEnabled,
+  p2 as parseWebVTT,
+  r as registerAll,
+  q as registerAnnotation,
+  s as registerCinema,
+  t as registerImg,
+  u as registerLive,
+  v as registerPlaylist,
+  w as registerTour,
+  x as registerTourImg,
+  y as registerTourPortal,
+  z as registerVideo,
+  A as removeWatermark
+};
+//# sourceMappingURL=vizor.js.map

package/dist/vizor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vizor.js","sources":["../src/streaming/quality-selector.ts","../src/license/feature-gates.ts"],"sourcesContent":["import type { QualityLevel } from '@vizor-vr/shared';\nimport type { PlayerState } from '../core/player-state.js';\nimport type { IStreamingAdapter } from './types.js';\n\n/**\n * Coordinates quality switching between the streaming adapter and PlayerState.\n * Provides a clean API for the quality menu control.\n */\nexport class QualitySelector {\n  private adapter: IStreamingAdapter | null = null;\n  private state: PlayerState;\n\n  constructor(state: PlayerState) {\n    this.state = state;\n  }\n\n  /** Connect to the current streaming adapter */\n  setAdapter(adapter: IStreamingAdapter): void {\n    this.adapter = adapter;\n    this.syncState();\n  }\n\n  /** Get available quality levels */\n  getLevels(): QualityLevel[] {\n    return this.adapter?.getQualityLevels() ?? [];\n  }\n\n  /** Set quality by index (-1 = auto) */\n  setLevel(index: number): void {\n    if (!this.adapter) return;\n    this.adapter.setQualityLevel(index);\n\n    const levels = this.adapter.getQualityLevels();\n    this.state.batch({\n      availableQualities: levels,\n      currentQuality: index === -1 ? 'auto' : (levels[index]?.label ?? 'auto'),\n      autoQuality: index === -1,\n    });\n  }\n\n  /** Whether auto quality (ABR) is active */\n  get isAuto(): boolean {\n    return this.state.get('autoQuality');\n  }\n\n  /** Whether the adapter supports quality switching */\n  get supportsQuality(): boolean {\n    return (this.adapter?.supportsABR ?? false) && this.getLevels().length > 1;\n  }\n\n  /** Sync state from adapter */\n  private syncState(): void {\n    if (!this.adapter) return;\n    const levels = this.adapter.getQualityLevels();\n    if (levels.length > 0) {\n      this.state.batch({\n        availableQualities: levels,\n        currentQuality: 'auto',\n        autoQuality: true,\n      });\n    }\n  }\n}\n","import type { FeatureFlags, LicenseResult } from '@vizor-vr/shared';\n\n/** Check if a specific feature is enabled for the current license */\nexport function isFeatureEnabled(\n  feature: keyof FeatureFlags,\n  license: LicenseResult,\n): boolean {\n  return license.features[feature] === true;\n}\n\n/** Get all enabled feature names for a license */\nexport function getEnabledFeatures(license: LicenseResult): Array<keyof FeatureFlags> {\n  return (Object.keys(license.features) as Array<keyof FeatureFlags>).filter(\n    (key) => license.features[key],\n  );\n}\n"],"names":[],"mappings":";;;;;AAQO,MAAM,gBAAgB;AAAA,EACnB,UAAoC;AAAA,EACpC;AAAA,EAER,YAAY,OAAoB;AAC9B,SAAK,QAAQ;AAAA,EACf;AAAA;AAAA,EAGA,WAAW,SAAkC;AAC3C,SAAK,UAAU;AACf,SAAK,UAAA;AAAA,EACP;AAAA;AAAA,EAGA,YAA4B;AAC1B,WAAO,KAAK,SAAS,iBAAA,KAAsB,CAAA;AAAA,EAC7C;AAAA;AAAA,EAGA,SAAS,OAAqB;AAC5B,QAAI,CAAC,KAAK,QAAS;AACnB,SAAK,QAAQ,gBAAgB,KAAK;AAElC,UAAM,SAAS,KAAK,QAAQ,iBAAA;AAC5B,SAAK,MAAM,MAAM;AAAA,MACf,oBAAoB;AAAA,MACpB,gBAAgB,UAAU,KAAK,SAAU,OAAO,KAAK,GAAG,SAAS;AAAA,MACjE,aAAa,UAAU;AAAA,IAAA,CACxB;AAAA,EACH;AAAA;AAAA,EAGA,IAAI,SAAkB;AACpB,WAAO,KAAK,MAAM,IAAI,aAAa;AAAA,EACrC;AAAA;AAAA,EAGA,IAAI,kBAA2B;AAC7B,YAAQ,KAAK,SAAS,eAAe,UAAU,KAAK,YAAY,SAAS;AAAA,EAC3E;AAAA;AAAA,EAGQ,YAAkB;AACxB,QAAI,CAAC,KAAK,QAAS;AACnB,UAAM,SAAS,KAAK,QAAQ,iBAAA;AAC5B,QAAI,OAAO,SAAS,GAAG;AACrB,WAAK,MAAM,MAAM;AAAA,QACf,oBAAoB;AAAA,QACpB,gBAAgB;AAAA,QAChB,aAAa;AAAA,MAAA,CACd;AAAA,IACH;AAAA,EACF;AACF;AC3DO,SAAS,iBACd,SACA,SACS;AACT,SAAO,QAAQ,SAAS,OAAO,MAAM;AACvC;AAGO,SAAS,mBAAmB,SAAmD;AACpF,SAAQ,OAAO,KAAK,QAAQ,QAAQ,EAAgC;AAAA,IAClE,CAAC,QAAQ,QAAQ,SAAS,GAAG;AAAA,EAAA;AAEjC;"}

package/dist/xr/xr-controller.d.ts

@@ -0,0 +1,27 @@
+import type { WebGLRenderer } from 'three';
+/**
+ * Handles VR controller input during WebXR sessions.
+ *
+ * Listens for `select` events on controllers (trigger press).
+ * Default behavior: toggle play/pause. Tours can override via setSelectHandler.
+ *
+ * Three.js dispatches XR controller events (select, selectstart, selectend,
+ * squeeze, etc.) on the Group returned by renderer.xr.getController().
+ * These aren't in the typed Object3DEventMap, so we use EventDispatcher directly.
+ */
+export declare class XRControllerInput {
+    private renderer;
+    private onSelect;
+    private cleanups;
+    private controller0;
+    private controller1;
+    constructor(renderer: WebGLRenderer);
+    /** Set custom handler for controller select (trigger press) */
+    setSelectHandler(handler: () => void): void;
+    /** Start listening for controller events */
+    attach(): void;
+    /** Stop listening for controller events */
+    detach(): void;
+    dispose(): void;
+}
+//# sourceMappingURL=xr-controller.d.ts.map

package/dist/xr/xr-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xr-controller.d.ts","sourceRoot":"","sources":["../../src/xr/xr-controller.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAS,MAAM,OAAO,CAAC;AAElD;;;;;;;;;GASG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,QAAQ,CAA6B;IAC7C,OAAO,CAAC,QAAQ,CAAyB;IACzC,OAAO,CAAC,WAAW,CAAsB;IACzC,OAAO,CAAC,WAAW,CAAsB;gBAE7B,QAAQ,EAAE,aAAa;IAInC,+DAA+D;IAC/D,gBAAgB,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI;IAI3C,4CAA4C;IAC5C,MAAM,IAAI,IAAI;IAyBd,2CAA2C;IAC3C,MAAM,IAAI,IAAI;IAOd,OAAO,IAAI,IAAI;CAIhB"}

package/dist/xr/xr-manager.d.ts

@@ -0,0 +1,43 @@
+import type { WebGLRenderer } from 'three';
+import type { PlayerState } from '../core/player-state.js';
+import type { VzEventEmitter } from '../core/event-emitter.js';
+import type { CameraController } from '../renderer/camera-controller.js';
+/**
+ * Manages the WebXR session lifecycle.
+ *
+ * When entering XR:
+ * - Requests an immersive-vr session
+ * - Connects it to Three.js via renderer.xr.setSession()
+ * - Three.js swaps to XRSession.requestAnimationFrame and renders per-eye
+ * - Our layer-based stereo (Layer 1=left, Layer 2=right) maps directly
+ * - CameraController is disabled (headset drives camera)
+ *
+ * When exiting XR:
+ * - Three.js reverts to window.requestAnimationFrame
+ * - CameraController is re-enabled
+ */
+export declare class XRManager {
+    private renderer;
+    private state;
+    private events;
+    private cameraController;
+    private session;
+    private controllerInput;
+    constructor(renderer: WebGLRenderer, state: PlayerState, events: VzEventEmitter, cameraController: CameraController);
+    /** Check if immersive-vr sessions are supported */
+    static isSupported(): Promise<boolean>;
+    /** Request and start an immersive-vr session */
+    enterXR(): Promise<void>;
+    /** End the current XR session */
+    exitXR(): Promise<void>;
+    /** Toggle XR on/off */
+    toggleXR(): Promise<void>;
+    /** Whether an XR session is currently active */
+    get isActive(): boolean;
+    /** Set handler for controller select (trigger press) */
+    setSelectHandler(handler: () => void): void;
+    /** Clean up */
+    dispose(): void;
+    private onSessionEnd;
+}
+//# sourceMappingURL=xr-manager.d.ts.map

package/dist/xr/xr-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xr-manager.d.ts","sourceRoot":"","sources":["../../src/xr/xr-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAGzE;;;;;;;;;;;;;GAaG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,eAAe,CAAoB;gBAGzC,QAAQ,EAAE,aAAa,EACvB,KAAK,EAAE,WAAW,EAClB,MAAM,EAAE,cAAc,EACtB,gBAAgB,EAAE,gBAAgB;IASpC,mDAAmD;WACtC,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAS5C,gDAAgD;IAC1C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAqC9B,iCAAiC;IAC3B,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAM7B,uBAAuB;IACjB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ/B,gDAAgD;IAChD,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,wDAAwD;IACxD,gBAAgB,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI;IAI3C,eAAe;IACf,OAAO,IAAI,IAAI;IASf,OAAO,CAAC,YAAY,CAalB;CACH"}

package/package.json

@@ -0,0 +1,94 @@
+{
+  "name": "@vizor-vr/player",
+  "version": "0.2.0",
+  "description": "VR video player for the modern web — 360°, VR, live streaming, virtual tours",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/vizor.js",
+  "module": "./dist/vizor.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/vizor.js"
+    },
+    "./register": {
+      "types": "./dist/register.d.ts",
+      "import": "./dist/register.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "vr",
+    "360",
+    "video",
+    "player",
+    "webxr",
+    "panorama",
+    "three.js",
+    "web-components",
+    "hls",
+    "dash",
+    "streaming"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/vizor-vr/player.git",
+    "directory": "packages/player"
+  },
+  "homepage": "https://vizor.dev",
+  "dependencies": {
+    "dompurify": "^3.2.4",
+    "three": "^0.170.0",
+    "@vizor-vr/shared": "0.1.0"
+  },
+  "devDependencies": {
+    "@playwright/test": "^1.58.2",
+    "@types/dompurify": "^3.2.0",
+    "@types/three": "^0.170.0",
+    "@types/webxr": "^0.5.24",
+    "@vitest/coverage-v8": "^2.1.0",
+    "jsdom": "^25.0.0",
+    "rimraf": "^6.0.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.0",
+    "vite": "^6.0.0",
+    "vitest": "^2.1.0",
+    "@vizor-vr/ts-config": "0.0.0"
+  },
+  "peerDependencies": {
+    "@noble/ed25519": "^2.0.0",
+    "dashjs": "^4.7.0",
+    "hls.js": "^1.5.0",
+    "omnitone": "^1.3.0"
+  },
+  "peerDependenciesMeta": {
+    "hls.js": {
+      "optional": true
+    },
+    "dashjs": {
+      "optional": true
+    },
+    "omnitone": {
+      "optional": true
+    },
+    "@noble/ed25519": {
+      "optional": true
+    }
+  },
+  "scripts": {
+    "dev": "vite build --watch",
+    "build": "vite build && tsc --emitDeclarationOnly",
+    "postbuild": "tsx scripts/generate-sri.ts",
+    "test": "vitest run",
+    "test:e2e": "playwright test",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "clean": "rimraf dist"
+  }
+}