@vizor-vr/react 0.2.0

package/dist/__tests__/build-attributes.test.js

@@ -0,0 +1,76 @@
+import { describe, it, expect, vi } from 'vitest';
+vi.mock('@vizor-vr/player', () => ({}));
+import { buildAttributes } from '../use-vizor-element.js';
+describe('buildAttributes', () => {
+    it('returns empty object for no props', () => {
+        expect(buildAttributes({})).toEqual({});
+    });
+    it('maps format to string', () => {
+        const attrs = buildAttributes({ format: 'MONO_360' });
+        expect(attrs.format).toBe('MONO_360');
+    });
+    it('maps boolean props to empty string', () => {
+        const attrs = buildAttributes({ loop: true, muted: true });
+        expect(attrs.loop).toBe('');
+        expect(attrs.muted).toBe('');
+    });
+    it('does not include false boolean props', () => {
+        const attrs = buildAttributes({ loop: false });
+        expect(attrs.loop).toBeUndefined();
+    });
+    it('maps apiKey to api-key attribute', () => {
+        const attrs = buildAttributes({ apiKey: 'test-key' });
+        expect(attrs['api-key']).toBe('test-key');
+    });
+    it('maps licenseKey to license-key attribute', () => {
+        const attrs = buildAttributes({ licenseKey: 'lic-123' });
+        expect(attrs['license-key']).toBe('lic-123');
+    });
+    it('maps contentId to content-id attribute', () => {
+        const attrs = buildAttributes({ contentId: 'content-456' });
+        expect(attrs['content-id']).toBe('content-456');
+    });
+    it('maps apiEndpoint to api-endpoint', () => {
+        const attrs = buildAttributes({ apiEndpoint: 'https://api.example.com' });
+        expect(attrs['api-endpoint']).toBe('https://api.example.com');
+    });
+    it('maps controlsBehavior to controls-behavior', () => {
+        const attrs = buildAttributes({ controlsBehavior: 'autohide' });
+        expect(attrs['controls-behavior']).toBe('autohide');
+    });
+    it('maps hideControls to hide-controls', () => {
+        const attrs = buildAttributes({ hideControls: true });
+        expect(attrs['hide-controls']).toBe('');
+    });
+    it('maps primaryColor to primary-color', () => {
+        const attrs = buildAttributes({ primaryColor: '#ff0000' });
+        expect(attrs['primary-color']).toBe('#ff0000');
+    });
+    it('maps multiple props correctly', () => {
+        const attrs = buildAttributes({
+            format: 'STEREO_360_SBS',
+            title: 'Test Video',
+            poster: 'thumb.jpg',
+            loop: true,
+            muted: true,
+            preload: 'auto',
+            apiKey: 'key-123',
+        });
+        expect(attrs.format).toBe('STEREO_360_SBS');
+        expect(attrs.title).toBe('Test Video');
+        expect(attrs.poster).toBe('thumb.jpg');
+        expect(attrs.loop).toBe('');
+        expect(attrs.muted).toBe('');
+        expect(attrs.preload).toBe('auto');
+        expect(attrs['api-key']).toBe('key-123');
+    });
+    it('does not include undefined string props', () => {
+        const attrs = buildAttributes({ title: undefined });
+        expect(attrs.title).toBeUndefined();
+    });
+    it('does not include hideControls when false', () => {
+        const attrs = buildAttributes({ hideControls: false });
+        expect(attrs['hide-controls']).toBeUndefined();
+    });
+});
+//# sourceMappingURL=build-attributes.test.js.map

package/dist/__tests__/build-attributes.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-attributes.test.js","sourceRoot":"","sources":["../../src/__tests__/build-attributes.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/vz-annotation.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=vz-annotation.test.d.ts.map

package/dist/__tests__/vz-annotation.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vz-annotation.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/vz-annotation.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/vz-annotation.test.js

@@ -0,0 +1,29 @@
+import { describe, it, expect, vi } from 'vitest';
+// Mock @vizor-vr/player since we don't need the actual Web Components in unit tests
+vi.mock('@vizor-vr/player', () => ({}));
+describe('VzAnnotation', () => {
+    it('exports VzAnnotation component', async () => {
+        const mod = await import('../index.js');
+        expect(mod.VzAnnotation).toBeDefined();
+        expect(typeof mod.VzAnnotation).toBe('object'); // forwardRef returns object
+    });
+    it('exports VzAnnotationProps type (compile-time check)', async () => {
+        // Type-only import verified at compile time
+        const mod = await import('../VzAnnotation.js');
+        expect(mod.VzAnnotation).toBeDefined();
+    });
+    it('VzAnnotation props interface has correct shape', async () => {
+        // Verify the component accepts the expected props by checking its existence
+        const { VzAnnotation } = await import('../VzAnnotation.js');
+        expect(VzAnnotation).toBeDefined();
+        // The component is a forwardRef, so it has $$typeof
+        expect(VzAnnotation).toHaveProperty('$$typeof');
+    });
+    it('VzAnnotation is a forwardRef component', async () => {
+        const { VzAnnotation } = await import('../VzAnnotation.js');
+        // forwardRef components have $$typeof symbol
+        expect(VzAnnotation.$$typeof).toBeDefined();
+        expect(VzAnnotation.$$typeof.toString()).toContain('react.forward_ref');
+    });
+});
+//# sourceMappingURL=vz-annotation.test.js.map

package/dist/__tests__/vz-annotation.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vz-annotation.test.js","sourceRoot":"","sources":["../../src/__tests__/vz-annotation.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAElD,oFAAoF;AACpF,EAAE,CAAC,IAAI,CAAC,kBAAkB,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAExC,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,EAAE,CAAC,gCAAgC,EAAE,KAAK,IAAI,EAAE;QAC9C,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;QACxC,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,WAAW,EAAE,CAAC;QACvC,MAAM,CAAC,OAAO,GAAG,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,4BAA4B;IAC9E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,KAAK,IAAI,EAAE;QACnE,4CAA4C;QAC5C,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;QAC/C,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,WAAW,EAAE,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gDAAgD,EAAE,KAAK,IAAI,EAAE;QAC9D,4EAA4E;QAC5E,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;QAC5D,MAAM,CAAC,YAAY,CAAC,CAAC,WAAW,EAAE,CAAC;QACnC,oDAAoD;QACpD,MAAM,CAAC,YAAY,CAAC,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,KAAK,IAAI,EAAE;QACtD,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;QAC5D,6CAA6C;QAC7C,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;QAC5C,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/vz-caption.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=vz-caption.test.d.ts.map

package/dist/__tests__/vz-caption.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vz-caption.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/vz-caption.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/vz-caption.test.js

@@ -0,0 +1,20 @@
+import { describe, it, expect, vi } from 'vitest';
+// Mock @vizor-vr/player since we don't need the actual Web Components in unit tests
+vi.mock('@vizor-vr/player', () => ({}));
+describe('VzCaption', () => {
+    it('exports VzCaption component from package index', async () => {
+        const mod = await import('../index.js');
+        expect(mod.VzCaption).toBeDefined();
+    });
+    it('is a forwardRef component', async () => {
+        const { VzCaption } = await import('../VzCaption.js');
+        // forwardRef components have $$typeof symbol
+        expect(VzCaption.$$typeof).toBeDefined();
+        expect(VzCaption.$$typeof.toString()).toContain('react.forward_ref');
+    });
+    it('has displayName set to VzCaption', async () => {
+        const { VzCaption } = await import('../VzCaption.js');
+        expect(VzCaption.displayName).toBe('VzCaption');
+    });
+});
+//# sourceMappingURL=vz-caption.test.js.map

package/dist/__tests__/vz-caption.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vz-caption.test.js","sourceRoot":"","sources":["../../src/__tests__/vz-caption.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAElD,oFAAoF;AACpF,EAAE,CAAC,IAAI,CAAC,kBAAkB,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAExC,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE;IACzB,EAAE,CAAC,gDAAgD,EAAE,KAAK,IAAI,EAAE;QAC9D,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;QACxC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2BAA2B,EAAE,KAAK,IAAI,EAAE;QACzC,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC;QACtD,6CAA6C;QAC7C,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;QACzC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAC;IACvE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kCAAkC,EAAE,KAAK,IAAI,EAAE;QAChD,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC;QACtD,MAAM,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/vz-components.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=vz-components.test.d.ts.map

package/dist/__tests__/vz-components.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vz-components.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/vz-components.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/vz-components.test.js

@@ -0,0 +1,106 @@
+import { describe, it, expect, vi } from 'vitest';
+// Mock @vizor-vr/player since we don't need the actual Web Components in unit tests
+vi.mock('@vizor-vr/player', () => ({}));
+import { buildAttributes } from '../use-vizor-element.js';
+// ─── buildAttributes utility tests ───────────────────────────────
+describe('buildAttributes', () => {
+    it('converts camelCase licenseKey to kebab-case license-key attribute', () => {
+        const attrs = buildAttributes({ licenseKey: 'LK-123-ABC' });
+        expect(attrs['license-key']).toBe('LK-123-ABC');
+    });
+    it('sets boolean true attributes as empty string', () => {
+        const attrs = buildAttributes({ loop: true, muted: true, hideControls: true });
+        expect(attrs.loop).toBe('');
+        expect(attrs.muted).toBe('');
+        expect(attrs['hide-controls']).toBe('');
+    });
+    it('omits boolean false attributes entirely', () => {
+        const attrs = buildAttributes({ loop: false, muted: false, hideControls: false });
+        expect(attrs.loop).toBeUndefined();
+        expect(attrs.muted).toBeUndefined();
+        expect(attrs['hide-controls']).toBeUndefined();
+    });
+    it('converts apiKey prop to api-key attribute', () => {
+        const attrs = buildAttributes({ apiKey: 'ak_test_xyz' });
+        expect(attrs['api-key']).toBe('ak_test_xyz');
+    });
+    it('passes format prop through unchanged', () => {
+        const attrs = buildAttributes({ format: 'MONO_360' });
+        expect(attrs.format).toBe('MONO_360');
+    });
+    it('passes src-like string props through unchanged (poster, title)', () => {
+        const attrs = buildAttributes({ poster: 'thumb.jpg', title: 'My Video' });
+        expect(attrs.poster).toBe('thumb.jpg');
+        expect(attrs.title).toBe('My Video');
+    });
+    it('excludes event handler props (onPlay, onPause, etc.) from attributes', () => {
+        const props = {
+            format: 'MONO_360',
+            onPlay: () => { },
+            onPause: () => { },
+            onReady: () => { },
+            onEnded: () => { },
+        };
+        const attrs = buildAttributes(props);
+        expect(attrs).not.toHaveProperty('onPlay');
+        expect(attrs).not.toHaveProperty('onPause');
+        expect(attrs).not.toHaveProperty('onReady');
+        expect(attrs).not.toHaveProperty('onEnded');
+        expect(attrs.format).toBe('MONO_360');
+    });
+    it('excludes className from DOM attributes', () => {
+        const props = { className: 'my-player' };
+        const attrs = buildAttributes(props);
+        expect(attrs).not.toHaveProperty('className');
+        expect(attrs).not.toHaveProperty('class');
+    });
+    it('excludes style from DOM attributes', () => {
+        const props = { style: { width: '100%' } };
+        const attrs = buildAttributes(props);
+        expect(attrs).not.toHaveProperty('style');
+    });
+    it('maps controlsBehavior to controls-behavior attribute', () => {
+        const attrs = buildAttributes({ controlsBehavior: 'autohide' });
+        expect(attrs['controls-behavior']).toBe('autohide');
+    });
+    it('maps apiEndpoint to api-endpoint attribute', () => {
+        const attrs = buildAttributes({ apiEndpoint: 'https://api.vizor.dev' });
+        expect(attrs['api-endpoint']).toBe('https://api.vizor.dev');
+    });
+    it('maps contentId to content-id attribute', () => {
+        const attrs = buildAttributes({ contentId: 'vid-001' });
+        expect(attrs['content-id']).toBe('vid-001');
+    });
+    it('does not include undefined string props', () => {
+        const attrs = buildAttributes({});
+        expect(Object.keys(attrs)).toHaveLength(0);
+    });
+});
+// ─── EVENT_MAP tests ─────────────────────────────────────────────
+describe('EVENT_MAP (via use-vizor-element)', () => {
+    // We test event mapping by importing the module and checking the
+    // exported event map structure indirectly through the hook behavior.
+    // Since EVENT_MAP is not exported, we verify the contract via integration:
+    // the module maps React prop names to DOM event names.
+    it('onReady maps to vz-ready event', async () => {
+        // Verify by checking that the module attaches the correct DOM event.
+        // We import the full module and inspect its internal EVENT_MAP via the
+        // module's source structure.
+        const mod = await import('../use-vizor-element.js');
+        // buildAttributes should NOT include event props, confirming they are
+        // handled separately via EVENT_MAP
+        const attrs = mod.buildAttributes({ onReady: () => { } });
+        expect(attrs).not.toHaveProperty('onReady');
+    });
+    it('all 7 component exports exist in package index', async () => {
+        const mod = await import('../index.js');
+        expect(mod.VzVideo).toBeDefined();
+        expect(mod.VzImg).toBeDefined();
+        expect(mod.VzTour).toBeDefined();
+        expect(mod.VzCinema).toBeDefined();
+        expect(mod.VzLive).toBeDefined();
+        expect(mod.VzPlaylist).toBeDefined();
+        expect(mod.VzAnnotation).toBeDefined();
+    });
+});
+//# sourceMappingURL=vz-components.test.js.map

package/dist/__tests__/vz-components.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vz-components.test.js","sourceRoot":"","sources":["../../src/__tests__/vz-components.test.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @vizor-vr/react — React wrappers for the Vizor VR Player
+ *
+ * This is a client-only package — the components render browser custom elements.
+ * The directive above marks the client boundary for React Server Components
+ * (Next.js App Router), so apps can import these from Server Components safely.
+ *
+ * @example
+ * ```tsx
+ * import { VzVideo, VzImg, VzLive, VzPlaylist } from '@vizor-vr/react';
+ *
+ * function App() {
+ *   return (
+ *     <VzVideo
+ *       src="video.mp4"
+ *       format="MONO_360"
+ *       style={{ width: '100%', aspectRatio: '16/9' }}
+ *       onReady={() => console.log('Player ready')}
+ *     />
+ *   );
+ * }
+ * ```
+ */
+export { VzVideo } from './VzVideo.js';
+export { VzImg } from './VzImg.js';
+export { VzTour } from './VzTour.js';
+export type { VzTourProps } from './VzTour.js';
+export { VzCinema } from './VzCinema.js';
+export { VzLive } from './VzLive.js';
+export type { VzLiveHandle } from './VzLive.js';
+export { VzPlaylist } from './VzPlaylist.js';
+export { VzAnnotation } from './VzAnnotation.js';
+export type { VzAnnotationProps } from './VzAnnotation.js';
+export { VzCaption } from './VzCaption.js';
+export type { VzCaptionProps } from './VzCaption.js';
+export type { VzSource, VzCommonProps, VzVideoProps, VzImgProps, VzLiveProps, VzPlaylistProps, } from './types.js';
+export { useVizorEvents, buildAttributes, useVizorRef } from './use-vizor-element.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGrD,YAAY,EACV,QAAQ,EACR,aAAa,EACb,YAAY,EACZ,UAAU,EACV,WAAW,EACX,eAAe,GAChB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/index.js

@@ -0,0 +1,36 @@
+'use client';
+/**
+ * @vizor-vr/react — React wrappers for the Vizor VR Player
+ *
+ * This is a client-only package — the components render browser custom elements.
+ * The directive above marks the client boundary for React Server Components
+ * (Next.js App Router), so apps can import these from Server Components safely.
+ *
+ * @example
+ * ```tsx
+ * import { VzVideo, VzImg, VzLive, VzPlaylist } from '@vizor-vr/react';
+ *
+ * function App() {
+ *   return (
+ *     <VzVideo
+ *       src="video.mp4"
+ *       format="MONO_360"
+ *       style={{ width: '100%', aspectRatio: '16/9' }}
+ *       onReady={() => console.log('Player ready')}
+ *     />
+ *   );
+ * }
+ * ```
+ */
+// Components
+export { VzVideo } from './VzVideo.js';
+export { VzImg } from './VzImg.js';
+export { VzTour } from './VzTour.js';
+export { VzCinema } from './VzCinema.js';
+export { VzLive } from './VzLive.js';
+export { VzPlaylist } from './VzPlaylist.js';
+export { VzAnnotation } from './VzAnnotation.js';
+export { VzCaption } from './VzCaption.js';
+// Hooks (advanced usage)
+export { useVizorEvents, buildAttributes, useVizorRef } from './use-vizor-element.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,aAAa;AACb,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAa3C,yBAAyB;AACzB,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,127 @@
+import type { VzFormat } from '@vizor-vr/player';
+/** Source definition for React components */
+export interface VzSource {
+    src: string;
+    type?: string;
+    quality?: string;
+}
+/** Common props shared by all Vizor player React components */
+export interface VzCommonProps {
+    /** Video/image format (MONO_360, STEREO_360_LR, etc.) */
+    format?: VzFormat | string;
+    /** Content title */
+    title?: string;
+    /** Poster image URL */
+    poster?: string;
+    /** Whether to loop playback */
+    loop?: boolean;
+    /** Whether to start muted */
+    muted?: boolean;
+    /** Preload strategy */
+    preload?: 'auto' | 'metadata' | 'none';
+    /** API key for license validation */
+    apiKey?: string;
+    /** Standalone license key */
+    licenseKey?: string;
+    /** API endpoint for license/analytics */
+    apiEndpoint?: string;
+    /** Content ID for analytics */
+    contentId?: string;
+    /** Controls behavior */
+    controlsBehavior?: 'autohide' | 'always' | 'minimal';
+    /** Hide controls entirely */
+    hideControls?: boolean;
+    /** Primary accent color */
+    primaryColor?: string;
+    /** Collaborative viewing server URL */
+    collabServer?: string;
+    /** Collaborative viewing room name */
+    collabRoom?: string;
+    /** Collaborative viewing role */
+    collabRole?: 'host' | 'viewer';
+    /** Collaborative viewing user ID */
+    collabUserId?: string;
+    /** Collaborative viewing display name */
+    collabDisplayName?: string;
+    /** Collaborative viewing room password */
+    collabPassword?: string;
+    /** CSS class name */
+    className?: string;
+    /** Inline styles */
+    style?: React.CSSProperties;
+    /** Sources array (alternative to children) */
+    sources?: VzSource[];
+    onReady?: () => void;
+    onPlay?: () => void;
+    onPause?: () => void;
+    onEnded?: () => void;
+    onTimeUpdate?: (e: Event) => void;
+    onError?: (detail: {
+        code: string;
+        message: string;
+    }) => void;
+    onQualityChange?: (detail: {
+        quality: string;
+        auto: boolean;
+    }) => void;
+    onFullscreenEnter?: () => void;
+    onFullscreenExit?: () => void;
+    onXrSessionStart?: () => void;
+    onXrSessionEnd?: () => void;
+    onAnnotationClick?: (detail: {
+        id: string;
+        lat: number;
+        lon: number;
+    }) => void;
+    onOrientationChange?: (detail: {
+        lat: number;
+        lon: number;
+    }) => void;
+    onLicenseValidated?: (detail: {
+        tier: string;
+        valid: boolean;
+    }) => void;
+    onCaptionChange?: (detail: {
+        lang: string;
+        label: string;
+    }) => void;
+}
+/** Props specific to video elements */
+export interface VzVideoProps extends VzCommonProps {
+    /** Direct source URL */
+    src?: string;
+}
+/** Props specific to image elements */
+export interface VzImgProps extends Omit<VzCommonProps, 'loop' | 'muted' | 'preload'> {
+    /** Image source URL */
+    src?: string;
+}
+/** Props specific to live elements */
+export interface VzLiveProps extends VzCommonProps {
+    /** Stream source URL */
+    src?: string;
+}
+/** Props for playlist elements */
+export interface VzPlaylistProps {
+    /** Auto-advance to next item on end */
+    autoplay?: boolean;
+    /** Loop back to first item after last */
+    loopPlaylist?: boolean;
+    /** Panel mode */
+    panel?: 'none' | 'expandable';
+    /** CSS class name */
+    className?: string;
+    /** Inline styles */
+    style?: React.CSSProperties;
+    /** Child elements */
+    children?: React.ReactNode;
+    /** Playlist change handler */
+    onPlaylistChange?: (detail: {
+        index: number;
+        title: string;
+        total: number;
+    }) => void;
+    /** Playlist end handler */
+    onPlaylistEnd?: () => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/use-vizor-element.d.ts

@@ -0,0 +1,18 @@
+import { type RefObject } from 'react';
+import type { VzCommonProps } from './types.js';
+import '@vizor-vr/player/register';
+/**
+ * Hook that attaches event listeners to a Vizor custom element ref.
+ * Handles cleanup on unmount and re-attaching when handlers change.
+ */
+export declare function useVizorEvents(ref: RefObject<HTMLElement | null>, props: VzCommonProps): void;
+/**
+ * Build HTML attributes object from common props.
+ * React passes unknown props to custom elements as attributes.
+ */
+export declare function buildAttributes(props: VzCommonProps): Record<string, string | undefined>;
+/**
+ * Create a forwarded ref for the custom element.
+ */
+export declare function useVizorRef(): RefObject<HTMLElement | null>;
+//# sourceMappingURL=use-vizor-element.d.ts.map

package/dist/use-vizor-element.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-vizor-element.d.ts","sourceRoot":"","sources":["../src/use-vizor-element.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAKhD,OAAO,2BAA2B,CAAC;AAyBnC;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,EAClC,KAAK,EAAE,aAAa,GACnB,IAAI,CA4CN;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,aAAa,GACnB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAwBpC;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAE3D"}