import { VzBaseElement } from './base-element.js';
import { VzRenderer } from '../renderer/renderer.js';
import { SourceManager } from '../streaming/source-manager.js';
/**
 * Abstract base class for all media-playing elements (video, live-video, cinema).
 *
 * Extends VzBaseElement with:
 * - Three.js renderer initialization
 * - Hidden <video> element creation and management
 * - Source parsing from <source> children
 * - HTML5 Media API mirroring
 * - Controls overlay rendering
 */
/**
 * WS-D autoplay: honor the browser muted-autoplay policy. Autoplay without
 * muted is force-muted (with a console.info) — browsers block audible
 * autoplay — and playback is attempted ONCE when the video can play; a
 * rejected play() promise is swallowed (the poster/controls remain usable).
 */
export declare function applyAutoplayPolicy(video: HTMLVideoElement, config: {
    autoplay?: boolean;
    muted: boolean;
}): void;
export declare abstract class VzMediaElement extends VzBaseElement {
    protected renderer: VzRenderer;
    protected videoElement: HTMLVideoElement;
    protected containerEl: HTMLDivElement;
    protected sourceManager: SourceManager;
    /** When true, base class skips auto-setupVideo in loadeddata (used by cinema) */
    protected suppressAutoSetup: boolean;
    private cleanupFullscreen;
    private timeUpdateTimer;
    private controlsOverlay;
    private playButton;
    private seekBar;
    private volumeControl;
    private fullscreenButton;
    private vrButton;
    private compass;
    private qualityMenu;
    private speedMenu;
    private motionButton;
    private shortcutsOverlay;
    private sceneClickTracker;
    private keyboardShortcuts;
    private xrManager;
    private audioManager;
    private liveIndicator;
    private analyticsHandle;
    private annotationManager;
    private chapterManager;
    private pendingChapters;
    private captionRenderer;
    private ccButton;
    private collabClient;
    private gazeCursorManager;
    private gazeSender;
    private chatPanel;
    private chatButton;
    private voiceManager;
    private voiceButton;
    private drmConfig;
    private deferredDrmSources;
    /** Resolved UI strings: DEFAULT_STRINGS merged with the `strings` attribute overrides. */
    private strings;
    /**
     * A content-id embed (`<vz-video content-id api-key>` with no DOM `<source>`)
     * fetches its config from the delivery API and injects the equivalent
     * `<source>`/`<vz-annotation>`/`<track>` DOM children before onConnected() runs
     * — so authored content actually reaches the viewer. A DOM-authored embed
     * (any `<source>` child) wins and skips the fetch entirely.
     */
    protected beforeConnect(): Promise<void> | void;
    private hydrateFromDeliveryApi;
    protected onConnected(): void;
    protected onDisconnected(): void;
    protected onResize(): void;
    /** After license resolves, enforce theme + format/feature tier gating */
    protected onLicenseResolved(): void;
    /**
     * Manual chapters are a paid feature. Once the license is known, wire the
     * chapter UI (seek-bar markers + menu) and active-chapter tracking that fires
     * `vz-chapter-change`, but only when the tier includes chapters. Unlicensed
     * tiers degrade gracefully: no markers, no menu, no event (the video plays
     * unaffected).
     */
    private applyChaptersGate;
    /**
     * WebXR (Enter-VR) is a paid feature. Once the license is known, if the tier
     * doesn't include it, remove the VR button so it can't be used — flat/pointer
     * viewing continues unaffected (graceful downgrade). Licensed users keep the
     * button, which reveals itself only when the device reports XR support.
     */
    private applyWebxrGate;
    /**
     * Spatial (ambisonic) audio is a paid feature. When the source is authored as
     * ambix and the tier includes it, wire up the AudioManager here (license is
     * now known). When the tier lacks it, we do nothing — the hidden <video>'s
     * own audio track plays as ordinary stereo, the graceful fallback.
     */
    private applySpatialAudioGate;
    /**
     * Enforce format tier gating once the license is known. A stereo format the
     * tier doesn't include is downgraded to its mono equivalent (re-projecting if
     * the renderer already set up the ungated one); a format with no fallback (a
     * 180 half-sphere) is blocked behind an upgrade overlay. Prevents free users
     * from silently receiving paid formats.
     */
    private applyFormatGate;
    private showFormatUpgradeOverlay;
    private showUpgradeOverlay;
    /**
     * DRM assets are encrypted-only (no plain fallback). Once the license is known:
     * a tier WITHOUT `drm` is blocked behind an upgrade overlay (and NO license
     * request is made); a licensed tier performs the deferred encrypted source load
     * with the DRM context (license URLs + api-key) so the adapter can drive EME.
     * EME/CDM errors during playback surface via the adapter's existing error events.
     */
    private applyDrmGate;
    protected onAttributeChanged(name: string, _oldVal: string | null, _newVal: string | null): void;
    play(): Promise<void>;
    pause(): void;
    seek(time: number): void;
    get duration(): number;
    get currentTime(): number;
    set currentTime(t: number);
    get paused(): boolean;
    get volume(): number;
    set volume(v: number);
    get muted(): boolean;
    set muted(m: boolean);
    get playbackRate(): number;
    set playbackRate(r: number);
    toggleFullscreen(): void;
    /** Get the Three.js renderer (for advanced use / WebXR) */
    getRenderer(): VzRenderer;
    protected abstract onMediaConnected(): void;
    protected abstract onMediaDisconnected(): void;
    /** Parse <vz-annotation> children and create annotation manager if any exist */
    private initAnnotations;
    /**
     * Parse `<vz-chapter>` children into a normalized pending list. The chapter UI
     * (markers/menu/event) is wired later in applyChaptersGate() once the license
     * is known, since chapters are tier-gated.
     */
    private initChapters;
    /** Initialize collaborative viewing if collab attributes are set */
    private initCollab;
    /** Initialize caption system from <track> children */
    private initCaptions;
    private createVideoElement;
    /** Get the source manager (for quality switching) */
    getSourceManager(): SourceManager;
    /** Parse <source> children and set up video sources */
    private loadSources;
    /** Mirror HTML5 media events from the hidden video to the custom element */
    private mirrorMediaEvents;
    /** True for look-around formats (360/180) where gyro magic-window applies. */
    private isPanoramicFormat;
    /** Sync the reactive state from the current video element state */
    private syncStateFromVideo;
}
//# sourceMappingURL=media-element.d.ts.map