@ngxsplayer/ngx-smart-player 0.0.1-next.0 → 0.1.0

package/index.d.ts

@@ -1,9 +1,166 @@
-import { PlayerConfig, PlayerPlugin, PlayerPorts, EngineFactory, PlayerState, MediaTrack, SubtitleProvider, MetadataProvider } from '@ngxsp/core';
+import { PlayerConfig, PlayerPlugin, PlayerPorts, EngineFactory, PlayerState, MediaTrack, PlayerError, MetadataProvider, SubtitleProvider } from '@ngxsp/core';
 export * from '@ngxsp/core';
-import * as i0 from '@angular/core';
-import { OnInit, OnDestroy, EventEmitter, ElementRef, EnvironmentProviders } from '@angular/core';
+import * as _angular_core from '@angular/core';
+import { EventEmitter, AfterViewInit, OnChanges, OnInit, OnDestroy, ElementRef, SimpleChanges, InjectionToken, EnvironmentProviders } from '@angular/core';
+import { NgxspTimelineMarker, SourceProfile } from '@ngxsplayer/ngx-smart-player-ui-core';
 
-declare class SmartPlayerComponent implements OnInit, OnDestroy {
+type SmartPlayerIconName = 'play' | 'pause' | 'prev' | 'next' | 'seek-back' | 'seek-forward' | 'volume-mute' | 'volume-low' | 'volume-high' | 'shuffle' | 'repeat' | 'repeat-one' | 'tracks' | 'captions' | 'captions-off' | 'speed' | 'pip' | 'pip-active' | 'airplay' | 'airplay-active' | 'cast' | 'cast-active' | 'devices' | 'devices-active' | 'radio' | 'server' | 'window-mini' | 'window-bar' | 'window-restore' | 'cinema' | 'cinema-active' | 'lyrics' | 'info' | 'bell' | 'thumb-up' | 'thumb-down' | 'share' | 'playlist-plus' | 'clock' | 'home' | 'layers' | 'video' | 'music' | 'broadcast' | 'heart' | 'download' | 'trash' | 'folder' | 'settings' | 'search' | 'grid' | 'list' | 'more' | 'waveform' | 'sliders' | 'network' | 'cloud' | 'spark' | 'disc' | 'user' | 'tag' | 'close' | 'plus' | 'check' | 'menu' | 'panel-right' | 'chevron-left' | 'chevron-right' | 'chevron-up' | 'chevron-down' | 'fullscreen' | 'fullscreen-exit';
+declare class SmartPlayerIconComponent {
+    name: SmartPlayerIconName;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SmartPlayerIconComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SmartPlayerIconComponent, "ngxsp-smart-icon", never, { "name": { "alias": "name"; "required": true; }; }, {}, never, never, true, never>;
+}
+
+interface SmartSettingOption {
+    id: string;
+    label: string;
+}
+/** A line of a list setting, such as a library folder. */
+interface SmartSettingEntry {
+    id: string;
+    label: string;
+    detail?: string;
+    /** An entry the listener always keeps, such as a folder the app owns: it is shown without its remove button. */
+    fixed?: boolean;
+}
+interface SmartSettingBase {
+    id: string;
+    label: string;
+    description?: string;
+}
+/**
+ * One setting. The host owns every value and hears what the listener asks for through the component's outputs:
+ * - `switch`: on or off;
+ * - `choice`: one of a few options, shown side by side;
+ * - `list`: entries the listener can remove one by one, with an optional action for the whole list;
+ * - `action`: a button that does something now (scan again, clear a cache);
+ * - `secret`: something typed that must not be read over a shoulder, sent when it is submitted
+ *   and never held afterwards — the field empties itself, and the host is the only one that
+ *   ever sees what was typed.
+ */
+type SmartSettingItem = (SmartSettingBase & {
+    kind: 'switch';
+    value: boolean;
+    disabled?: boolean;
+}) | (SmartSettingBase & {
+    kind: 'choice';
+    value: string;
+    options: SmartSettingOption[];
+}) | (SmartSettingBase & {
+    kind: 'list';
+    entries: SmartSettingEntry[];
+    removeLabel: string;
+    emptyLabel?: string;
+    actionLabel?: string;
+    busy?: boolean;
+}) | (SmartSettingBase & {
+    kind: 'action';
+    actionLabel: string;
+    busy?: boolean;
+    disabled?: boolean;
+}) | (SmartSettingBase & {
+    kind: 'secret';
+    actionLabel: string;
+    placeholder?: string;
+    /** A second field, when what is typed has to be given twice — an old code and a new one. */
+    secondPlaceholder?: string;
+    /** Digits only, which is what a device's own lock screen asks for. */
+    digits?: boolean;
+    busy?: boolean;
+    disabled?: boolean;
+});
+interface SmartSettingsSection {
+    id: string;
+    title: string;
+    items: SmartSettingItem[];
+}
+interface SmartSettingChange {
+    id: string;
+    value: boolean | string;
+    /** A `secret` setting's second field, when it has one: the old code beside the new one. */
+    previous?: string;
+}
+/** An action: a list's own action (no entry), the removal of one of its entries, or an action setting. */
+interface SmartSettingAction {
+    id: string;
+    entryId?: string;
+}
+/**
+ * The settings of a player, grouped in sections. Colours come from the host through CSS variables
+ * (`--ngxsp-settings-surface`, `-text`, `-muted`, `-line`, `-control`, `-accent`, `-accent-text`, `-radius`).
+ */
+declare class SmartSettingsComponent {
+    sections: SmartSettingsSection[];
+    settingChange: EventEmitter<SmartSettingChange>;
+    settingAction: EventEmitter<SmartSettingAction>;
+    /**
+     * Sends what was typed and empties the fields at once. Nothing secret stays in the component:
+     * the host is the only place it goes, and it does not come back through an input.
+     */
+    protected submitSecret(event: Event, id: string): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SmartSettingsComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SmartSettingsComponent, "ngxsp-settings", never, { "sections": { "alias": "sections"; "required": false; }; }, { "settingChange": "settingChange"; "settingAction": "settingAction"; }, never, never, true, never>;
+}
+
+/**
+ * A question the user answers before anything happens (another device asking to send its playback here). The
+ * cautious answer has the focus and Escape; the dialog stays until one of the two buttons is pressed. Colours come
+ * from the host through CSS variables (`--ngxsp-dialog-surface`, `-text`, `-muted`, `-line`, `-accent`,
+ * `-accent-text`, `-radius`).
+ */
+declare class SmartConfirmDialogComponent implements AfterViewInit {
+    title: string;
+    message: string;
+    confirmLabel: string;
+    cancelLabel: string;
+    confirmed: EventEmitter<void>;
+    cancelled: EventEmitter<void>;
+    private cancelButton?;
+    protected readonly id: string;
+    ngAfterViewInit(): void;
+    protected onEscape(event: Event): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SmartConfirmDialogComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SmartConfirmDialogComponent, "ngxsp-confirm-dialog", never, { "title": { "alias": "title"; "required": false; }; "message": { "alias": "message"; "required": false; }; "confirmLabel": { "alias": "confirmLabel"; "required": false; }; "cancelLabel": { "alias": "cancelLabel"; "required": false; }; }, { "confirmed": "confirmed"; "cancelled": "cancelled"; }, never, never, true, never>;
+}
+
+/**
+ * How much of a desktop player window shows: all of it, a small floating player (`mini`), or a strip along the
+ * bottom of the screen (`bar`, audio only: a video needs a picture). The host resizes the window; the UIs lay the
+ * player out to match.
+ */
+type SmartCompactMode = 'full' | 'mini' | 'bar';
+
+/** The words of the player's menus; English by default. */
+interface PlayerMenuLabels {
+    captions: string;
+    off: string;
+    audio: string;
+    singleAudio: string;
+    quality: string;
+    auto: string;
+    singleQuality: string;
+    speed: string;
+    /** Title of the subtitles menu, and of its button. */
+    subtitles: string;
+    /** Before the name of the subtitles shown now. */
+    current: string;
+    noSubtitles: string;
+    loadSubtitles: string;
+    tracks: string;
+    media: string;
+    /** Locale for the names of languages ("fr" becomes "French"); the device's by default. */
+    locale?: string;
+}
+declare const DEFAULT_PLAYER_MENU_LABELS: PlayerMenuLabels;
+
+/** A playback position and the media it was measured on. */
+interface SmartPlayerProgress {
+    currentTime: number;
+    duration: number;
+    contentId?: string;
+    sourceUrl?: string;
+}
+declare class SmartPlayerComponent implements OnChanges, OnInit, OnDestroy {
     config: PlayerConfig;
     plugins: PlayerPlugin[];
     ports?: Partial<PlayerPorts>;
@@ -11,29 +168,77 @@ declare class SmartPlayerComponent implements OnInit, OnDestroy {
     debug: boolean;
     /** Optional start time (seconds) used for "resume playback". */
     startTimeSec: number | null;
+    /** Starts the first source as soon as it is loaded. WebViews and desktop shells do not block it like browsers do. */
+    autoplayOnInit: boolean;
+    /** Increment when the user picks something to play: a new source starts, the current one resumes. */
+    playRequest: number;
     canPrev: boolean;
     canNext: boolean;
+    previousLabel: string;
+    nextLabel: string;
+    playLabel: string;
+    pauseLabel: string;
     shuffleActive: boolean;
     shuffleLabel: string;
     repeatMode: 'off' | 'one' | 'all';
     repeatLabel: string;
     hasPlaylistControls: boolean;
+    mediaMode: 'video' | 'audio';
+    castEnabled: boolean;
+    /** The media plays on a device the app drives (castEnabled): the devices button shows it. */
+    castConnected: boolean;
+    private airPlayAvailable;
+    private airPlayActive;
+    documentShortcuts: boolean;
+    nowPlayingLabel: string;
+    nowListeningLabel: string;
+    fullscreenHintLabel: string;
+    fullscreenLabel: string;
+    readyStatusLabel: string;
+    playingStatusLabel: string;
+    pausedStatusLabel: string;
+    bufferingStatusLabel: string;
+    loadingStatusLabel: string;
+    endedStatusLabel: string;
+    errorStatusLabel: string;
+    outputVolume: number | null;
+    outputVolumeLabel: string;
+    outputMuteLabel: string;
+    outputUnmuteLabel: string;
+    timelineDurationSec: number | null;
+    timelineMarkers: ReadonlyArray<NgxspTimelineMarker>;
     ended: EventEmitter<void>;
     videoSize: EventEmitter<{
         width: number;
         height: number;
     }>;
-    /** Emits playback position updates. */
-    progress: EventEmitter<{
-        currentTime: number;
-        duration: number;
-    }>;
+    /**
+     * Emits playback position updates, tagged with the media they belong to: a host switching tracks can still receive
+     * a position of the previous one, and must not file it under the new one.
+     */
+    progress: EventEmitter<SmartPlayerProgress>;
     prev: EventEmitter<void>;
     next: EventEmitter<void>;
     toggleShuffle: EventEmitter<void>;
     cycleRepeat: EventEmitter<void>;
+    /** CC pressed; the vod and edition skins also open their subtitles menu. */
     subtitles: EventEmitter<void>;
+    /** A subtitle file was read (ok) or could not be (error). */
+    subtitlesLoaded: EventEmitter<{
+        label: string;
+        ok: boolean;
+        error?: string;
+    }>;
+    /** The words of the player's menus and of its subtitles button. */
+    menuLabels: Partial<PlayerMenuLabels>;
+    cast: EventEmitter<void>;
+    stateChange: EventEmitter<PlayerState>;
+    playbackToggle: EventEmitter<"play" | "pause">;
+    outputVolumeChange: EventEmitter<number>;
     videoEl: ElementRef<HTMLVideoElement>;
+    captionsLayer: ElementRef<HTMLElement>;
+    /** Absent in audio mode, which has no subtitles. */
+    subtitleFileInput?: ElementRef<HTMLInputElement>;
     state: PlayerState | null;
     duration: number;
     currentTime: number;
@@ -42,30 +247,55 @@ declare class SmartPlayerComponent implements OnInit, OnDestroy {
     playbackRate: number;
     bufferAheadSec: number;
     tracks: MediaTrack[];
-    openMenu: 'tracks' | 'speed' | null;
+    openMenu: 'tracks' | 'speed' | 'captions' | null;
     controlsVisible: boolean;
+    surfaceGesture: 'play' | 'pause' | null;
+    castState: 'disconnected' | 'connecting' | 'connected';
     readonly playbackRates: number[];
     private facade;
+    private readonly cdr;
     private sub;
     private hideControlsTimer;
-    get uiSkin(): 'classic' | 'netflix';
+    private surfaceClickTimer;
+    private gestureTimer;
+    private remotePlaybackCleanup;
+    private initialized;
+    private loadedSourceSignature;
+    private loadSequence;
+    private loading;
+    private pendingPlay;
+    /** Whether the load in progress was asked to start playback. */
+    private loadingAutoplay;
+    /** Load whose end was already reported; reset when playback starts again (repeat one). */
+    private endedLoadSequence;
+    private pendingSeekSec;
+    get uiSkin(): 'classic' | 'vod' | 'edition';
+    /** Libellé méta du skin édition (genre · format). */
+    get editionMeta(): string;
     get uiVisible(): boolean;
     get displayTitle(): string;
+    get displaySubtitle(): string;
+    get isAudioMode(): boolean;
+    /** Profil de source transmis aux primitives UI (cf. @ngxsp/ui-core). */
+    get sourceProfile(): SourceProfile;
     get audioTracks(): MediaTrack[];
     get textTracks(): MediaTrack[];
     get videoTracks(): MediaTrack[];
     get selectedAudioTrackId(): string | null;
     get selectedTextTrackId(): string | null;
     get selectedVideoTrackId(): string | null;
+    ngOnChanges(changes: SimpleChanges): void;
     ngOnInit(): void;
     ngOnDestroy(): void;
     tryPlay(): void;
     get debugJson(): string;
-    get autoplayBlocked(): boolean;
+    get currentError(): PlayerError | null;
     copyDebug(): Promise<void>;
     downloadDebug(): void;
     togglePlay(): void;
+    requestPlaybackToggle(): void;
     seekRel(deltaSec: number): void;
+    seekTo(timeSec: number): void;
     onScrub(value: number): void;
     onVolume(value: number): void;
     toggleMute(): void;
@@ -74,7 +304,18 @@ declare class SmartPlayerComponent implements OnInit, OnDestroy {
     onLoadedMetadata(): void;
     onEnded(): void;
     toggleFullscreen(): void;
-    toggleMenu(menu: 'tracks' | 'speed'): void;
+    toggleMenu(menu: 'tracks' | 'speed' | 'captions'): void;
+    get playerMenuLabels(): PlayerMenuLabels;
+    onCaptionsClick(): void;
+    openSubtitlePicker(): void;
+    onSubtitleFileChosen(event: Event): Promise<void>;
+    /** Reads a SubRip or WebVTT file and shows it over the video. */
+    loadSubtitleFile(file: File): Promise<void>;
+    private controlsObserver?;
+    /** While the controls show, the subtitles sit just above them, however tall they are (a menu makes them taller). */
+    private followControlsHeight;
+    /** Draws the cues of the loaded subtitles (their markup parsed by the browser: italics, bold, no script). */
+    private drawCaptions;
     selectTextTrack(trackId: string | null): Promise<void>;
     selectAudioTrack(trackId: string): Promise<void>;
     selectVideoTrack(trackId: string | null): Promise<void>;
@@ -82,45 +323,266 @@ declare class SmartPlayerComponent implements OnInit, OnDestroy {
     isPiPSupported(): boolean;
     pipLabel(): string;
     isPiPActive(): boolean;
+    requestCast(): Promise<void>;
+    isCastSupported(): boolean;
+    isCastActive(): boolean;
+    showCastButton(): boolean;
+    /**
+     * AirPlay, as WebKit offers it: the system decides what is reachable and draws the picker
+     * itself. Nothing is discovered here, and nothing is sent — the route belongs to the device.
+     * Everywhere else these stay false and the button never appears.
+     */
+    showAirPlayButton(): boolean;
+    isAirPlayActive(): boolean;
+    airPlayLabel(): string;
+    openAirPlayPicker(): void;
+    /** Wired to the media element whenever one is created, for video and for audio alike. */
+    private watchAirPlay;
+    castLabel(): string;
+    castHintLabel(): string;
+    onCastClick(): void;
     captionsLabel(): string;
     volumeLabel(): string;
-    volumeIcon(): string;
     playbackRateLabel(): string;
     statusLabel(): string;
     keyboardHintLabel(): string;
     tracksButtonLabel(): string;
-    trackLabel(track: MediaTrack): string;
-    qualityLabel(track: MediaTrack): string;
+    onPrimarySurfaceDoubleClick(): void;
     bufferPercent(): number;
     fmtTime(sec: number): string;
     noop(): void;
+    /**
+     * Music plays in a real <audio> element: mobile browsers and Android WebViews pause <video> elements as soon as
+     * the page is hidden, which would stop the music when the app goes to the background or the screen turns off.
+     */
+    private mediaElementForMode;
     onInteraction(persist?: boolean): void;
     onPointerLeave(): void;
     onRootClick(event: MouseEvent): void;
     onEscape(): void;
     onKeydown(event: KeyboardEvent): void;
+    private loadConfig;
+    private applyStartTime;
+    private applySeek;
+    private safeSeekTime;
+    private sourceSignature;
+    private bindRemotePlaybackState;
     private syncControlVisibility;
+    private applyVolume;
+    private syncOutputVolumeInput;
+    setOutputVolume(value: number): void;
+    private setVolume;
+    private normalizeVolume;
     private clearHideControlsTimer;
+    private queueSurfacePlaybackToggle;
+    private clearSurfaceClickTimer;
+    private playbackToggleIntent;
+    private showSurfaceGesture;
+    private clearGestureTimer;
     private isInteractiveTarget;
-    errorTitle(): string;
-    errorHint(): string;
-    onRetry(): Promise<void>;
-    onUserPlay(): Promise<void>;
     emitNext(): void;
     emitPrev(): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<SmartPlayerComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<SmartPlayerComponent, "ngx-smart-player", never, { "config": { "alias": "config"; "required": true; }; "plugins": { "alias": "plugins"; "required": false; }; "ports": { "alias": "ports"; "required": false; }; "engines": { "alias": "engines"; "required": false; }; "debug": { "alias": "debug"; "required": false; }; "startTimeSec": { "alias": "startTimeSec"; "required": false; }; "canPrev": { "alias": "canPrev"; "required": false; }; "canNext": { "alias": "canNext"; "required": false; }; "shuffleActive": { "alias": "shuffleActive"; "required": false; }; "shuffleLabel": { "alias": "shuffleLabel"; "required": false; }; "repeatMode": { "alias": "repeatMode"; "required": false; }; "repeatLabel": { "alias": "repeatLabel"; "required": false; }; "hasPlaylistControls": { "alias": "hasPlaylistControls"; "required": false; }; }, { "ended": "ended"; "videoSize": "videoSize"; "progress": "progress"; "prev": "prev"; "next": "next"; "toggleShuffle": "toggleShuffle"; "cycleRepeat": "cycleRepeat"; "subtitles": "subtitles"; }, never, never, true, never>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SmartPlayerComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SmartPlayerComponent, "ngx-smart-player", never, { "config": { "alias": "config"; "required": true; }; "plugins": { "alias": "plugins"; "required": false; }; "ports": { "alias": "ports"; "required": false; }; "engines": { "alias": "engines"; "required": false; }; "debug": { "alias": "debug"; "required": false; }; "startTimeSec": { "alias": "startTimeSec"; "required": false; }; "autoplayOnInit": { "alias": "autoplayOnInit"; "required": false; }; "playRequest": { "alias": "playRequest"; "required": false; }; "canPrev": { "alias": "canPrev"; "required": false; }; "canNext": { "alias": "canNext"; "required": false; }; "previousLabel": { "alias": "previousLabel"; "required": false; }; "nextLabel": { "alias": "nextLabel"; "required": false; }; "playLabel": { "alias": "playLabel"; "required": false; }; "pauseLabel": { "alias": "pauseLabel"; "required": false; }; "shuffleActive": { "alias": "shuffleActive"; "required": false; }; "shuffleLabel": { "alias": "shuffleLabel"; "required": false; }; "repeatMode": { "alias": "repeatMode"; "required": false; }; "repeatLabel": { "alias": "repeatLabel"; "required": false; }; "hasPlaylistControls": { "alias": "hasPlaylistControls"; "required": false; }; "mediaMode": { "alias": "mediaMode"; "required": false; }; "castEnabled": { "alias": "castEnabled"; "required": false; }; "castConnected": { "alias": "castConnected"; "required": false; }; "documentShortcuts": { "alias": "documentShortcuts"; "required": false; }; "nowPlayingLabel": { "alias": "nowPlayingLabel"; "required": false; }; "nowListeningLabel": { "alias": "nowListeningLabel"; "required": false; }; "fullscreenHintLabel": { "alias": "fullscreenHintLabel"; "required": false; }; "fullscreenLabel": { "alias": "fullscreenLabel"; "required": false; }; "readyStatusLabel": { "alias": "readyStatusLabel"; "required": false; }; "playingStatusLabel": { "alias": "playingStatusLabel"; "required": false; }; "pausedStatusLabel": { "alias": "pausedStatusLabel"; "required": false; }; "bufferingStatusLabel": { "alias": "bufferingStatusLabel"; "required": false; }; "loadingStatusLabel": { "alias": "loadingStatusLabel"; "required": false; }; "endedStatusLabel": { "alias": "endedStatusLabel"; "required": false; }; "errorStatusLabel": { "alias": "errorStatusLabel"; "required": false; }; "outputVolume": { "alias": "outputVolume"; "required": false; }; "outputVolumeLabel": { "alias": "outputVolumeLabel"; "required": false; }; "outputMuteLabel": { "alias": "outputMuteLabel"; "required": false; }; "outputUnmuteLabel": { "alias": "outputUnmuteLabel"; "required": false; }; "timelineDurationSec": { "alias": "timelineDurationSec"; "required": false; }; "timelineMarkers": { "alias": "timelineMarkers"; "required": false; }; "menuLabels": { "alias": "menuLabels"; "required": false; }; }, { "ended": "ended"; "videoSize": "videoSize"; "progress": "progress"; "prev": "prev"; "next": "next"; "toggleShuffle": "toggleShuffle"; "cycleRepeat": "cycleRepeat"; "subtitles": "subtitles"; "subtitlesLoaded": "subtitlesLoaded"; "cast": "cast"; "stateChange": "stateChange"; "playbackToggle": "playbackToggle"; "outputVolumeChange": "outputVolumeChange"; }, never, ["[ngxsp-player-inline-controls]"], true, never>;
+}
+
+type RepeatMode = 'off' | 'one' | 'all';
+type PlayerMenuKind = 'tracks' | 'speed';
+/**
+ * Barre de contrôle du skin classique, extraite du SmartPlayerComponent
+ * (décomposition, cf. docs/AUDIT.md). Sans accès au moteur ni au <video> :
+ * reçoit l'état + les capacités (cast/PiP) en entrée et émet les commandes ;
+ * l'hôte applique l'action (et possède l'élément vidéo pour PiP/cast).
+ */
+declare class PlayerControlsComponent {
+    readonly playing: _angular_core.InputSignal<boolean>;
+    readonly isAudioMode: _angular_core.InputSignal<boolean>;
+    readonly hasPlaylistControls: _angular_core.InputSignal<boolean>;
+    readonly canPrev: _angular_core.InputSignal<boolean>;
+    readonly canNext: _angular_core.InputSignal<boolean>;
+    readonly shuffleActive: _angular_core.InputSignal<boolean>;
+    readonly shuffleLabel: _angular_core.InputSignal<string>;
+    readonly repeatMode: _angular_core.InputSignal<RepeatMode>;
+    readonly repeatLabel: _angular_core.InputSignal<string>;
+    readonly captionsActive: _angular_core.InputSignal<boolean>;
+    readonly tracksLabel: _angular_core.InputSignal<string>;
+    readonly captionsLabel: _angular_core.InputSignal<string>;
+    readonly speedLabel: _angular_core.InputSignal<string>;
+    readonly volumeLabel: _angular_core.InputSignal<string>;
+    readonly muteLabel: _angular_core.InputSignal<string>;
+    readonly unmuteLabel: _angular_core.InputSignal<string>;
+    readonly showAirPlay: _angular_core.InputSignal<boolean>;
+    readonly airPlayActive: _angular_core.InputSignal<boolean>;
+    readonly airPlayLabel: _angular_core.InputSignal<string>;
+    readonly showCast: _angular_core.InputSignal<boolean>;
+    readonly castActive: _angular_core.InputSignal<boolean>;
+    readonly castLabel: _angular_core.InputSignal<string>;
+    readonly castHint: _angular_core.InputSignal<string>;
+    readonly pipSupported: _angular_core.InputSignal<boolean>;
+    readonly pipActive: _angular_core.InputSignal<boolean>;
+    readonly pipLabel: _angular_core.InputSignal<string>;
+    readonly volume: _angular_core.InputSignal<number>;
+    readonly currentTime: _angular_core.InputSignal<number>;
+    readonly duration: _angular_core.InputSignal<number>;
+    readonly buffered: _angular_core.InputSignal<number>;
+    readonly profile: _angular_core.InputSignal<SourceProfile>;
+    readonly playToggle: _angular_core.OutputEmitterRef<void>;
+    readonly seekRelative: _angular_core.OutputEmitterRef<number>;
+    readonly prev: _angular_core.OutputEmitterRef<void>;
+    readonly next: _angular_core.OutputEmitterRef<void>;
+    readonly toggleShuffle: _angular_core.OutputEmitterRef<void>;
+    readonly cycleRepeat: _angular_core.OutputEmitterRef<void>;
+    readonly openMenu: _angular_core.OutputEmitterRef<PlayerMenuKind>;
+    readonly captions: _angular_core.OutputEmitterRef<void>;
+    readonly airPlay: _angular_core.OutputEmitterRef<void>;
+    readonly cast: _angular_core.OutputEmitterRef<void>;
+    readonly pip: _angular_core.OutputEmitterRef<void>;
+    readonly mute: _angular_core.OutputEmitterRef<void>;
+    readonly scrub: _angular_core.OutputEmitterRef<number>;
+    readonly volumeChange: _angular_core.OutputEmitterRef<number>;
+    fmtTime(sec: number): string;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<PlayerControlsComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<PlayerControlsComponent, "ngxsp-player-controls", never, { "playing": { "alias": "playing"; "required": false; "isSignal": true; }; "isAudioMode": { "alias": "isAudioMode"; "required": false; "isSignal": true; }; "hasPlaylistControls": { "alias": "hasPlaylistControls"; "required": false; "isSignal": true; }; "canPrev": { "alias": "canPrev"; "required": false; "isSignal": true; }; "canNext": { "alias": "canNext"; "required": false; "isSignal": true; }; "shuffleActive": { "alias": "shuffleActive"; "required": false; "isSignal": true; }; "shuffleLabel": { "alias": "shuffleLabel"; "required": false; "isSignal": true; }; "repeatMode": { "alias": "repeatMode"; "required": false; "isSignal": true; }; "repeatLabel": { "alias": "repeatLabel"; "required": false; "isSignal": true; }; "captionsActive": { "alias": "captionsActive"; "required": false; "isSignal": true; }; "tracksLabel": { "alias": "tracksLabel"; "required": false; "isSignal": true; }; "captionsLabel": { "alias": "captionsLabel"; "required": false; "isSignal": true; }; "speedLabel": { "alias": "speedLabel"; "required": false; "isSignal": true; }; "volumeLabel": { "alias": "volumeLabel"; "required": false; "isSignal": true; }; "muteLabel": { "alias": "muteLabel"; "required": false; "isSignal": true; }; "unmuteLabel": { "alias": "unmuteLabel"; "required": false; "isSignal": true; }; "showAirPlay": { "alias": "showAirPlay"; "required": false; "isSignal": true; }; "airPlayActive": { "alias": "airPlayActive"; "required": false; "isSignal": true; }; "airPlayLabel": { "alias": "airPlayLabel"; "required": false; "isSignal": true; }; "showCast": { "alias": "showCast"; "required": false; "isSignal": true; }; "castActive": { "alias": "castActive"; "required": false; "isSignal": true; }; "castLabel": { "alias": "castLabel"; "required": false; "isSignal": true; }; "castHint": { "alias": "castHint"; "required": false; "isSignal": true; }; "pipSupported": { "alias": "pipSupported"; "required": false; "isSignal": true; }; "pipActive": { "alias": "pipActive"; "required": false; "isSignal": true; }; "pipLabel": { "alias": "pipLabel"; "required": false; "isSignal": true; }; "volume": { "alias": "volume"; "required": false; "isSignal": true; }; "currentTime": { "alias": "currentTime"; "required": false; "isSignal": true; }; "duration": { "alias": "duration"; "required": false; "isSignal": true; }; "buffered": { "alias": "buffered"; "required": false; "isSignal": true; }; "profile": { "alias": "profile"; "required": false; "isSignal": true; }; }, { "playToggle": "playToggle"; "seekRelative": "seekRelative"; "prev": "prev"; "next": "next"; "toggleShuffle": "toggleShuffle"; "cycleRepeat": "cycleRepeat"; "openMenu": "openMenu"; "captions": "captions"; "airPlay": "airPlay"; "cast": "cast"; "pip": "pip"; "mute": "mute"; "scrub": "scrub"; "volumeChange": "volumeChange"; }, never, never, true, never>;
+}
+
+/**
+ * Barre de contrôle du skin vod (top bar + center dock + bottom bar),
+ * extraite du SmartPlayerComponent (décomposition, cf. docs/AUDIT.md).
+ * Le menu pistes/vitesse est projeté par l'hôte via <ng-content>.
+ * PiP/cast restent au parent (propriétaire du <video>) : capacités en entrée,
+ * commandes en sortie.
+ */
+declare class PlayerControlsVodComponent {
+    readonly playing: _angular_core.InputSignal<boolean>;
+    readonly isAudioMode: _angular_core.InputSignal<boolean>;
+    readonly displayTitle: _angular_core.InputSignal<string>;
+    readonly nowPlayingLabel: _angular_core.InputSignal<string>;
+    readonly nowListeningLabel: _angular_core.InputSignal<string>;
+    readonly fullscreenHintLabel: _angular_core.InputSignal<string>;
+    readonly statusLabel: _angular_core.InputSignal<string>;
+    readonly keyboardHint: _angular_core.InputSignal<string>;
+    readonly hasPlaylistControls: _angular_core.InputSignal<boolean>;
+    readonly canPrev: _angular_core.InputSignal<boolean>;
+    readonly canNext: _angular_core.InputSignal<boolean>;
+    readonly previousLabel: _angular_core.InputSignal<string>;
+    readonly nextLabel: _angular_core.InputSignal<string>;
+    readonly playLabel: _angular_core.InputSignal<string>;
+    readonly pauseLabel: _angular_core.InputSignal<string>;
+    readonly shuffleActive: _angular_core.InputSignal<boolean>;
+    readonly shuffleLabel: _angular_core.InputSignal<string>;
+    readonly repeatMode: _angular_core.InputSignal<RepeatMode>;
+    readonly repeatLabel: _angular_core.InputSignal<string>;
+    readonly captionsActive: _angular_core.InputSignal<boolean>;
+    readonly tracksLabel: _angular_core.InputSignal<string>;
+    readonly captionsLabel: _angular_core.InputSignal<string>;
+    readonly speedLabel: _angular_core.InputSignal<string>;
+    /** "1×", "1.5×": the rate on the speed pill. */
+    readonly speedBadge: _angular_core.Signal<string>;
+    readonly volumeLabel: _angular_core.InputSignal<string>;
+    readonly muteLabel: _angular_core.InputSignal<string>;
+    readonly unmuteLabel: _angular_core.InputSignal<string>;
+    readonly showAirPlay: _angular_core.InputSignal<boolean>;
+    readonly airPlayActive: _angular_core.InputSignal<boolean>;
+    readonly airPlayLabel: _angular_core.InputSignal<string>;
+    readonly showCast: _angular_core.InputSignal<boolean>;
+    readonly castActive: _angular_core.InputSignal<boolean>;
+    readonly castLabel: _angular_core.InputSignal<string>;
+    readonly castHint: _angular_core.InputSignal<string>;
+    readonly pipSupported: _angular_core.InputSignal<boolean>;
+    readonly pipActive: _angular_core.InputSignal<boolean>;
+    readonly pipLabel: _angular_core.InputSignal<string>;
+    readonly fullscreenLabel: _angular_core.InputSignal<string>;
+    readonly volume: _angular_core.InputSignal<number>;
+    readonly currentTime: _angular_core.InputSignal<number>;
+    readonly duration: _angular_core.InputSignal<number>;
+    readonly buffered: _angular_core.InputSignal<number>;
+    readonly bufferPercent: _angular_core.InputSignal<number>;
+    readonly profile: _angular_core.InputSignal<SourceProfile>;
+    readonly timelineDurationSec: _angular_core.InputSignal<number>;
+    readonly timelineMarkers: _angular_core.InputSignal<readonly NgxspTimelineMarker[]>;
+    readonly playToggle: _angular_core.OutputEmitterRef<void>;
+    readonly seekRelative: _angular_core.OutputEmitterRef<number>;
+    readonly prev: _angular_core.OutputEmitterRef<void>;
+    readonly next: _angular_core.OutputEmitterRef<void>;
+    readonly toggleShuffle: _angular_core.OutputEmitterRef<void>;
+    readonly cycleRepeat: _angular_core.OutputEmitterRef<void>;
+    readonly openMenu: _angular_core.OutputEmitterRef<PlayerMenuKind>;
+    readonly captions: _angular_core.OutputEmitterRef<void>;
+    readonly airPlay: _angular_core.OutputEmitterRef<void>;
+    readonly cast: _angular_core.OutputEmitterRef<void>;
+    readonly pip: _angular_core.OutputEmitterRef<void>;
+    readonly fullscreen: _angular_core.OutputEmitterRef<void>;
+    readonly mute: _angular_core.OutputEmitterRef<void>;
+    readonly scrub: _angular_core.OutputEmitterRef<number>;
+    readonly volumeChange: _angular_core.OutputEmitterRef<number>;
+    fmtTime(sec: number): string;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<PlayerControlsVodComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<PlayerControlsVodComponent, "ngxsp-player-controls-vod", never, { "playing": { "alias": "playing"; "required": false; "isSignal": true; }; "isAudioMode": { "alias": "isAudioMode"; "required": false; "isSignal": true; }; "displayTitle": { "alias": "displayTitle"; "required": false; "isSignal": true; }; "nowPlayingLabel": { "alias": "nowPlayingLabel"; "required": false; "isSignal": true; }; "nowListeningLabel": { "alias": "nowListeningLabel"; "required": false; "isSignal": true; }; "fullscreenHintLabel": { "alias": "fullscreenHintLabel"; "required": false; "isSignal": true; }; "statusLabel": { "alias": "statusLabel"; "required": false; "isSignal": true; }; "keyboardHint": { "alias": "keyboardHint"; "required": false; "isSignal": true; }; "hasPlaylistControls": { "alias": "hasPlaylistControls"; "required": false; "isSignal": true; }; "canPrev": { "alias": "canPrev"; "required": false; "isSignal": true; }; "canNext": { "alias": "canNext"; "required": false; "isSignal": true; }; "previousLabel": { "alias": "previousLabel"; "required": false; "isSignal": true; }; "nextLabel": { "alias": "nextLabel"; "required": false; "isSignal": true; }; "playLabel": { "alias": "playLabel"; "required": false; "isSignal": true; }; "pauseLabel": { "alias": "pauseLabel"; "required": false; "isSignal": true; }; "shuffleActive": { "alias": "shuffleActive"; "required": false; "isSignal": true; }; "shuffleLabel": { "alias": "shuffleLabel"; "required": false; "isSignal": true; }; "repeatMode": { "alias": "repeatMode"; "required": false; "isSignal": true; }; "repeatLabel": { "alias": "repeatLabel"; "required": false; "isSignal": true; }; "captionsActive": { "alias": "captionsActive"; "required": false; "isSignal": true; }; "tracksLabel": { "alias": "tracksLabel"; "required": false; "isSignal": true; }; "captionsLabel": { "alias": "captionsLabel"; "required": false; "isSignal": true; }; "speedLabel": { "alias": "speedLabel"; "required": false; "isSignal": true; }; "volumeLabel": { "alias": "volumeLabel"; "required": false; "isSignal": true; }; "muteLabel": { "alias": "muteLabel"; "required": false; "isSignal": true; }; "unmuteLabel": { "alias": "unmuteLabel"; "required": false; "isSignal": true; }; "showAirPlay": { "alias": "showAirPlay"; "required": false; "isSignal": true; }; "airPlayActive": { "alias": "airPlayActive"; "required": false; "isSignal": true; }; "airPlayLabel": { "alias": "airPlayLabel"; "required": false; "isSignal": true; }; "showCast": { "alias": "showCast"; "required": false; "isSignal": true; }; "castActive": { "alias": "castActive"; "required": false; "isSignal": true; }; "castLabel": { "alias": "castLabel"; "required": false; "isSignal": true; }; "castHint": { "alias": "castHint"; "required": false; "isSignal": true; }; "pipSupported": { "alias": "pipSupported"; "required": false; "isSignal": true; }; "pipActive": { "alias": "pipActive"; "required": false; "isSignal": true; }; "pipLabel": { "alias": "pipLabel"; "required": false; "isSignal": true; }; "fullscreenLabel": { "alias": "fullscreenLabel"; "required": false; "isSignal": true; }; "volume": { "alias": "volume"; "required": false; "isSignal": true; }; "currentTime": { "alias": "currentTime"; "required": false; "isSignal": true; }; "duration": { "alias": "duration"; "required": false; "isSignal": true; }; "buffered": { "alias": "buffered"; "required": false; "isSignal": true; }; "bufferPercent": { "alias": "bufferPercent"; "required": false; "isSignal": true; }; "profile": { "alias": "profile"; "required": false; "isSignal": true; }; "timelineDurationSec": { "alias": "timelineDurationSec"; "required": false; "isSignal": true; }; "timelineMarkers": { "alias": "timelineMarkers"; "required": false; "isSignal": true; }; }, { "playToggle": "playToggle"; "seekRelative": "seekRelative"; "prev": "prev"; "next": "next"; "toggleShuffle": "toggleShuffle"; "cycleRepeat": "cycleRepeat"; "openMenu": "openMenu"; "captions": "captions"; "airPlay": "airPlay"; "cast": "cast"; "pip": "pip"; "fullscreen": "fullscreen"; "mute": "mute"; "scrub": "scrub"; "volumeChange": "volumeChange"; }, never, ["[ngxsp-player-inline-controls]", "ngxsp-player-menu"], true, never>;
 }
 
+/**
+ * Skin « édition » du lecteur : registre instrument (cf. docs/UX_VISION.md).
+ * Titre display, coins francs, libellés en capitales, accent champagne, et le
+ * traitement direct (NgxspLiveBadge + « Au direct ») en profil `live`.
+ * Compose les primitives de @ngxsp/ui-core. Le menu est projeté via <ng-content>.
+ */
+declare class PlayerControlsEditionComponent {
+    readonly profile: _angular_core.InputSignal<SourceProfile>;
+    readonly playing: _angular_core.InputSignal<boolean>;
+    readonly displayTitle: _angular_core.InputSignal<string>;
+    readonly metaLabel: _angular_core.InputSignal<string>;
+    readonly statusLabel: _angular_core.InputSignal<string>;
+    readonly behindSec: _angular_core.InputSignal<number>;
+    readonly liveLabel: _angular_core.InputSignal<string>;
+    readonly captionsActive: _angular_core.InputSignal<boolean>;
+    readonly speedLabel: _angular_core.InputSignal<string>;
+    readonly showAirPlay: _angular_core.InputSignal<boolean>;
+    readonly airPlayActive: _angular_core.InputSignal<boolean>;
+    readonly airPlayLabel: _angular_core.InputSignal<string>;
+    readonly showCast: _angular_core.InputSignal<boolean>;
+    readonly castActive: _angular_core.InputSignal<boolean>;
+    readonly pipSupported: _angular_core.InputSignal<boolean>;
+    readonly pipActive: _angular_core.InputSignal<boolean>;
+    readonly volume: _angular_core.InputSignal<number>;
+    readonly volumeLabel: _angular_core.InputSignal<string>;
+    readonly muteLabel: _angular_core.InputSignal<string>;
+    readonly unmuteLabel: _angular_core.InputSignal<string>;
+    readonly currentTime: _angular_core.InputSignal<number>;
+    readonly duration: _angular_core.InputSignal<number>;
+    readonly buffered: _angular_core.InputSignal<number>;
+    readonly playToggle: _angular_core.OutputEmitterRef<void>;
+    readonly seekRelative: _angular_core.OutputEmitterRef<number>;
+    readonly openMenu: _angular_core.OutputEmitterRef<PlayerMenuKind>;
+    readonly captions: _angular_core.OutputEmitterRef<void>;
+    readonly airPlay: _angular_core.OutputEmitterRef<void>;
+    readonly cast: _angular_core.OutputEmitterRef<void>;
+    readonly pip: _angular_core.OutputEmitterRef<void>;
+    readonly mute: _angular_core.OutputEmitterRef<void>;
+    readonly scrub: _angular_core.OutputEmitterRef<number>;
+    readonly volumeChange: _angular_core.OutputEmitterRef<number>;
+    readonly goLive: _angular_core.OutputEmitterRef<void>;
+    fmtTime(sec: number): string;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<PlayerControlsEditionComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<PlayerControlsEditionComponent, "ngxsp-player-controls-edition", never, { "profile": { "alias": "profile"; "required": false; "isSignal": true; }; "playing": { "alias": "playing"; "required": false; "isSignal": true; }; "displayTitle": { "alias": "displayTitle"; "required": false; "isSignal": true; }; "metaLabel": { "alias": "metaLabel"; "required": false; "isSignal": true; }; "statusLabel": { "alias": "statusLabel"; "required": false; "isSignal": true; }; "behindSec": { "alias": "behindSec"; "required": false; "isSignal": true; }; "liveLabel": { "alias": "liveLabel"; "required": false; "isSignal": true; }; "captionsActive": { "alias": "captionsActive"; "required": false; "isSignal": true; }; "speedLabel": { "alias": "speedLabel"; "required": false; "isSignal": true; }; "showAirPlay": { "alias": "showAirPlay"; "required": false; "isSignal": true; }; "airPlayActive": { "alias": "airPlayActive"; "required": false; "isSignal": true; }; "airPlayLabel": { "alias": "airPlayLabel"; "required": false; "isSignal": true; }; "showCast": { "alias": "showCast"; "required": false; "isSignal": true; }; "castActive": { "alias": "castActive"; "required": false; "isSignal": true; }; "pipSupported": { "alias": "pipSupported"; "required": false; "isSignal": true; }; "pipActive": { "alias": "pipActive"; "required": false; "isSignal": true; }; "volume": { "alias": "volume"; "required": false; "isSignal": true; }; "volumeLabel": { "alias": "volumeLabel"; "required": false; "isSignal": true; }; "muteLabel": { "alias": "muteLabel"; "required": false; "isSignal": true; }; "unmuteLabel": { "alias": "unmuteLabel"; "required": false; "isSignal": true; }; "currentTime": { "alias": "currentTime"; "required": false; "isSignal": true; }; "duration": { "alias": "duration"; "required": false; "isSignal": true; }; "buffered": { "alias": "buffered"; "required": false; "isSignal": true; }; }, { "playToggle": "playToggle"; "seekRelative": "seekRelative"; "openMenu": "openMenu"; "captions": "captions"; "airPlay": "airPlay"; "cast": "cast"; "pip": "pip"; "mute": "mute"; "scrub": "scrub"; "volumeChange": "volumeChange"; "goLive": "goLive"; }, never, ["*"], true, never>;
+}
+
+/**
+ * Jetons d'injection typés pour les providers de sous-titres / métadonnées.
+ * (Remplace les jetons `string` non typés — cf. docs/AUDIT.md, manquement #10.)
+ * Un consommateur peut les injecter directement :
+ * `inject(SMART_PLAYER_SUBTITLE_PROVIDERS)`.
+ */
+declare const SMART_PLAYER_SUBTITLE_PROVIDERS: InjectionToken<SubtitleProvider[]>;
+declare const SMART_PLAYER_METADATA_PROVIDERS: InjectionToken<MetadataProvider[]>;
 interface SmartPlayerProvidersConfig {
     subtitleProviders?: SubtitleProvider[];
     metadataProviders?: MetadataProvider[];
 }
 /**
- * Register provider implementations for subtitles/metadata.
- * You can call this in your app `bootstrapApplication()` providers array.
+ * Enregistre les implémentations de providers (sous-titres / métadonnées).
+ * À appeler dans le tableau `providers` de `bootstrapApplication()`.
  */
 declare function provideSmartPlayer(cfg: SmartPlayerProvidersConfig): EnvironmentProviders;
 
-export { SmartPlayerComponent, provideSmartPlayer };
-export type { SmartPlayerProvidersConfig };
+export { DEFAULT_PLAYER_MENU_LABELS, PlayerControlsComponent, PlayerControlsEditionComponent, PlayerControlsVodComponent, SMART_PLAYER_METADATA_PROVIDERS, SMART_PLAYER_SUBTITLE_PROVIDERS, SmartConfirmDialogComponent, SmartPlayerComponent, SmartPlayerIconComponent, SmartSettingsComponent, provideSmartPlayer };
+export type { RepeatMode as PlayerControlsRepeatMode, PlayerMenuKind, PlayerMenuLabels, SmartCompactMode, SmartPlayerIconName, SmartPlayerProgress, SmartPlayerProvidersConfig, SmartSettingAction, SmartSettingChange, SmartSettingEntry, SmartSettingItem, SmartSettingOption, SmartSettingsSection };