@ngxsplayer/ngx-smart-player-ui-video 0.1.0

package/index.d.ts

@@ -0,0 +1,853 @@
+import * as i0 from '@angular/core';
+import { EventEmitter, ElementRef } from '@angular/core';
+import { PlayerConfig, PlayerPlugin, PlayerPorts, EngineFactory, SmartPlayerIconName, SmartSettingsSection, PlayerMenuLabels, SmartPlayerProgress, SmartCompactMode, SmartSettingChange, SmartSettingAction, PlayerState } from '@ngxsplayer/ngx-smart-player';
+import { NgxspTimelineMarker } from '@ngxsplayer/ngx-smart-player-ui-core';
+
+type VideoUiMediaKind = 'movie' | 'series' | 'episode' | 'clip' | 'live';
+/** Something that can be done to one video, offered on its card rather than somewhere else. */
+interface VideoUiCardAction {
+    id: string;
+    label: string;
+    icon: SmartPlayerIconName;
+    /** Whether it takes something away for good, which the menu says in its colours. */
+    danger?: boolean;
+}
+interface VideoUiMediaCard {
+    id: string;
+    title: string;
+    subtitle?: string;
+    meta?: string;
+    duration?: string;
+    sourceUrl?: string;
+    artworkUrl?: string;
+    active?: boolean;
+    kind?: VideoUiMediaKind;
+    kindLabel?: string;
+    parentTitle?: string;
+    seasonLabel?: string;
+    episodeLabel?: string;
+    releaseYear?: string;
+    progressPercent?: number;
+    tags?: string[];
+    /** What can be done to this one video. Cards with none keep their single gesture: open it. */
+    actions?: VideoUiCardAction[];
+}
+interface VideoUiQueueActionLabels {
+    play?: string;
+    moveUp?: string;
+    moveDown?: string;
+    remove?: string;
+}
+interface VideoUiSearchFilter {
+    id: string;
+    label: string;
+    count?: number;
+    active?: boolean;
+    disabled?: boolean;
+}
+interface VideoUiSearchActionLabels {
+    play?: string;
+    queue?: string;
+    watchLater?: string;
+    favorite?: string;
+    download?: string;
+}
+/**
+ * One strip along the bottom of the shell, for the two things a view has to say from outside
+ * the flow of cards: a question that wants an answer before something happens, and how far a
+ * long job has got. The viewer is told once and then left alone.
+ */
+interface VideoUiPromptBar {
+    /** What is happening, or what is being asked. */
+    message: string;
+    /** Both present when an answer is wanted, and the strip then waits for one. */
+    confirmLabel?: string;
+    cancelLabel?: string;
+    /** Present while something is running: 0 to 100. */
+    percent?: number;
+    /** A second line: the file in hand, or what the answer decides. */
+    hint?: string;
+    /** Whether the answer takes something away for good, which the strip says in its colours. */
+    danger?: boolean;
+    /** Which question this is, so an answer cannot be taken for the answer to another. */
+    id?: string;
+}
+interface VideoUiSection {
+    id: string;
+    title: string;
+    items: VideoUiMediaCard[];
+}
+/** Where the menu goes, which is the viewer's choice and not a guess from the window's width. */
+type VideoUiMenuLayout = 'vertical' | 'horizontal' | 'hidden';
+/** One step of the way down: where the view is, and what it took to get there. */
+interface VideoUiTrailStep {
+    id: string;
+    label: string;
+}
+interface VideoUiMediaDetailEpisode {
+    id: string;
+    title: string;
+    subtitle?: string;
+    duration?: string;
+    artworkUrl?: string;
+    progressPercent?: number;
+    active?: boolean;
+}
+interface VideoUiMediaDetailAction {
+    id: string;
+    label: string;
+    icon: SmartPlayerIconName;
+    primary?: boolean;
+    disabled?: boolean;
+}
+type VideoUiMediaWorkspaceTone = 'teal' | 'red' | 'blue' | 'gold' | 'neutral';
+interface VideoUiMediaChapter {
+    id: string;
+    title: string;
+    label?: string;
+    time?: string;
+    timeSec?: number;
+    summary?: string;
+    actionId?: string;
+    active?: boolean;
+}
+interface VideoUiMediaChecklistItem {
+    id: string;
+    label: string;
+    value?: string;
+    description?: string;
+    tone?: VideoUiMediaWorkspaceTone;
+}
+interface VideoUiMediaDetail {
+    id: string;
+    title: string;
+    kicker?: string;
+    subtitle?: string;
+    summary?: string;
+    posterUrl?: string;
+    kindLabel?: string;
+    metaItems?: string[];
+    tags?: string[];
+    progressPercent?: number;
+    progressLabel?: string;
+    actions?: VideoUiMediaDetailAction[];
+    workspaceTitle?: string;
+    workspaceSummary?: string;
+    chaptersTitle?: string;
+    chapters?: VideoUiMediaChapter[];
+    checklistTitle?: string;
+    checklist?: VideoUiMediaChecklistItem[];
+    episodesTitle?: string;
+    episodes?: VideoUiMediaDetailEpisode[];
+}
+interface VideoUiNavItem {
+    id: string;
+    label: string;
+    icon: SmartPlayerIconName;
+    active?: boolean;
+    disabled?: boolean;
+}
+type VideoUiToolTone = 'teal' | 'red' | 'blue' | 'gold' | 'neutral';
+type VideoUiRuntimeMode = 'online' | 'offline';
+type VideoUiPlaybackIntent = 'play' | 'pause';
+interface VideoUiToolCard {
+    id: string;
+    label: string;
+    value: string;
+    icon: SmartPlayerIconName;
+    active?: boolean;
+    tone?: VideoUiToolTone;
+}
+type VideoUiInspectorTone = 'neutral' | 'success' | 'warning';
+interface VideoUiInspectorMetric {
+    label: string;
+    value: string;
+    tone?: VideoUiInspectorTone;
+}
+interface VideoUiInspectorItem {
+    label: string;
+    value?: string;
+    description?: string;
+    tone?: VideoUiInspectorTone;
+}
+interface VideoUiInspectorAction {
+    id: string;
+    label: string;
+    icon: SmartPlayerIconName;
+    primary?: boolean;
+    disabled?: boolean;
+}
+/** A server type of the connection form. */
+interface VideoUiServerKind {
+    id: string;
+    label: string;
+    /** False for servers without accounts (DLNA): the user name and password fields are hidden. */
+    credentials?: boolean;
+    /** Placeholder of the address field for this type. */
+    addressPlaceholder?: string;
+    /** The app can look for servers of this type on the local network. */
+    discoverable?: boolean;
+}
+interface VideoUiServerDiscovery {
+    searchLabel: string;
+    searchingLabel: string;
+    connectLabel: string;
+    /** Shown after a search that found nothing. */
+    emptyLabel?: string;
+    busy?: boolean;
+    servers: Array<{
+        id: string;
+        name: string;
+        subtitle?: string;
+    }>;
+}
+/** Media servers the viewer connected, and the form to add one: shown in the inspector panel, after its settings. */
+interface VideoUiServerForm {
+    /** Title of the servers part of the panel. */
+    heading?: string;
+    title: string;
+    /** Server types to choose from; the first one is selected by default. */
+    kinds?: VideoUiServerKind[];
+    kindLabel?: string;
+    addressPlaceholder: string;
+    usernamePlaceholder: string;
+    passwordPlaceholder: string;
+    submitLabel: string;
+    disconnectLabel: string;
+    openLabel: string;
+    hint?: string;
+    busy?: boolean;
+    servers: Array<{
+        id: string;
+        name: string;
+        subtitle?: string;
+        active?: boolean;
+    }>;
+    /** Servers found on the local network, for the kinds marked `discoverable`. */
+    discovery?: VideoUiServerDiscovery;
+}
+/** A list the viewer created, shown in the side panel. */
+interface VideoUiPlaylistOption {
+    id: string;
+    name: string;
+    itemCount?: number;
+    active?: boolean;
+    /** The panel's target is already in this list: the button takes it out instead of adding it. */
+    containsTarget?: boolean;
+}
+/** Everything the side panel needs to manage lists; hidden entirely when null. */
+interface VideoUiPlaylistPanel {
+    title: string;
+    namePlaceholder: string;
+    renamePlaceholder: string;
+    createLabel: string;
+    addLabel: string;
+    openLabel: string;
+    renameLabel: string;
+    deleteLabel: string;
+    saveLabel: string;
+    cancelLabel: string;
+    itemsCountLabel: string;
+    emptyLabel: string;
+    removeLabel: string;
+    /** Item the "add" buttons file; without one the buttons are hidden. */
+    target?: {
+        id: string;
+        title: string;
+    } | null;
+    targetLabel?: string;
+    playlists: VideoUiPlaylistOption[];
+}
+/** A tab of the info panel over the video: its id is the id of the panel it opens. */
+/**
+ * A video loaded where it was left: the player says so, and offers to start it over. The point itself is not shown
+ * (resume stays private); a new key shows the offer again.
+ */
+interface VideoUiResumeOffer {
+    key: string;
+    message: string;
+    resumeLabel: string;
+    restartLabel: string;
+}
+interface VideoUiInfoTab {
+    id: string;
+    label: string;
+    icon: SmartPlayerIconName;
+}
+interface VideoUiInspectorPanel {
+    id: string;
+    title: string;
+    subtitle?: string;
+    status?: string;
+    icon?: SmartPlayerIconName;
+    metrics?: VideoUiInspectorMetric[];
+    items?: VideoUiInspectorItem[];
+    /** Settings shown in the panel; changes and actions come back through `settingChange` and `settingAction`. */
+    settings?: SmartSettingsSection[];
+    /** Settings shown after the servers (`serverForm`), which follow `settings`. */
+    trailingSettings?: SmartSettingsSection[];
+    actions?: VideoUiInspectorAction[];
+}
+type VideoUiViewMode = 'grid' | 'list';
+interface VideoUiLanguageOption {
+    id: string;
+    label: string;
+}
+type VideoUiStatusKind = 'info' | 'success' | 'error';
+interface VideoUiCardRef {
+    sectionId: string;
+    item: VideoUiMediaCard;
+    index: number;
+}
+declare class NgxSmartPlayerVideoUiComponent {
+    /**
+     * Keeps what is playing in sight in the queue. One scrolls down a queue to see what is
+     * coming, and the next video then starts out of view; it only scrolls when what plays
+     * changes, and inside the list rather than moving the page under everything else.
+     */
+    ngAfterViewChecked(): void;
+    constructor();
+    config: PlayerConfig | null;
+    /** The host app's logo in the masthead (an image URL); without it, a generic play tile. */
+    brandLogoSrc: string;
+    plugins: PlayerPlugin[];
+    ports?: Partial<PlayerPorts>;
+    engines?: EngineFactory[];
+    debug: boolean;
+    startTimeSec: number | null;
+    /** Incremented by the host when the viewer picks something to watch; the poster preview then gives way to the player. */
+    set playRequest(value: number);
+    get playRequest(): number;
+    private playRequestValue;
+    canPrev: boolean;
+    canNext: boolean;
+    previousLabel: string;
+    playerBackLabel: string;
+    nextLabel: string;
+    playLabel: string;
+    pauseLabel: string;
+    transportLabel: string;
+    cinemaMode: boolean;
+    cinemaLabel: string;
+    cinemaActiveLabel: string;
+    shuffleActive: boolean;
+    shuffleLabel: string;
+    repeatMode: 'off' | 'one' | 'all';
+    repeatLabel: string;
+    hasPlaylistControls: boolean;
+    castEnabled: boolean;
+    castConnected: boolean;
+    /** Set when the video loads where it was left (see `VideoUiResumeOffer`). */
+    set resumeOffer(offer: VideoUiResumeOffer | null);
+    get resumeOffer(): VideoUiResumeOffer | null;
+    private offer;
+    resumePromptShown: boolean;
+    private resumePromptTimer?;
+    chooseResume(choice: 'resume' | 'restart'): void;
+    private closeResumePrompt;
+    private clearResumePromptTimer;
+    /** Tabs of the info panel (library, engine, tracks, subtitles, progress, telemetry): their ids are panel ids. */
+    infoTabs: VideoUiInfoTab[];
+    infoLabel: string;
+    /** The info panel open, shown over the video (in the sheet on phones); null when closed. */
+    set infoPanel(panel: VideoUiInspectorPanel | null);
+    get infoPanel(): VideoUiInspectorPanel | null;
+    private info;
+    /** The words of the player's menus (tracks, speed, subtitles). */
+    playerMenuLabels: Partial<PlayerMenuLabels>;
+    heroEyebrow: string;
+    heroTitle: string;
+    heroSubtitle: string;
+    heroMeta: string;
+    heroArtworkUrl: string;
+    preferPosterPreview: boolean;
+    runtimeModeLabel: string;
+    onlineLabel: string;
+    offlineLabel: string;
+    navigationLabel: string;
+    menuLabel: string;
+    searchPlaceholder: string;
+    searchLabel: string;
+    searchResultsTitle: string;
+    searchResultsSummary: string;
+    searchResultsEmptyTitle: string;
+    searchResultsEmptyBody: string;
+    searchClearLabel: string;
+    searchFilterLabel: string;
+    searchFilters: VideoUiSearchFilter[];
+    searchActionLabels: VideoUiSearchActionLabels;
+    notificationsLabel: string;
+    settingsLabel: string;
+    sourceChangeLabel: string;
+    sourceChangeTitle: string;
+    sourceDropTitle: string;
+    sourceDropHint: string;
+    sourceChangeAccept: string;
+    /** When set (desktop shell), the title bar offers folder import and keeps single-file import as a secondary action. */
+    folderImportLabel: string;
+    libraryStatus: string;
+    /**
+     * Sliding a finger up or down over the picture: brightness on the left half, sound on the
+     * right. Off where it would get in the way — a pointer that only ever clicks, say.
+     */
+    touchAdjust: boolean;
+    /** How bright the picture is, 10 to 100. Below 100 a veil is drawn over it; nothing is brightened past its own. */
+    brightness: number;
+    brightnessChange: EventEmitter<number>;
+    /** "More": what opens a card's own menu, for a screen reader and for a tooltip. */
+    cardActionsLabel: string;
+    /** The way out of a card's menu, for whoever cannot see where the menu stops. */
+    cardMenuCloseLabel: string;
+    /** The action chosen on a card's menu: which action, on which video. */
+    cardAction: EventEmitter<{
+        actionId: string;
+        cardId: string;
+    }>;
+    /** The strip along the bottom: a question, or how far a long job has got. Null when there is nothing to say. */
+    promptBar: VideoUiPromptBar | null;
+    /** True when the viewer took the first way out, false for the second. */
+    promptAnswer: EventEmitter<boolean>;
+    libraryBusy: boolean;
+    sourceTypeLocalLabel: string;
+    sourceTypeStreamLabel: string;
+    languageLabel: string;
+    activeLanguage: string;
+    languageOptions: VideoUiLanguageOption[];
+    statusMessage: string;
+    statusKind: VideoUiStatusKind;
+    likeLabel: string;
+    likeActive: boolean;
+    dislikeLabel: string;
+    shareLabel: string;
+    watchLaterLabel: string;
+    watchLaterActive: boolean;
+    queueActionLabel: string;
+    queueShortLabel: string;
+    queueAddActiveLabel: string;
+    queueAddActiveShortLabel: string;
+    queueActionLabels: VideoUiQueueActionLabels;
+    moreLabel: string;
+    moreShortLabel: string;
+    browseLibraryLabel: string;
+    /**
+     * Where the view stands, from its own name down to what is open. Entering a series or a folder
+     * is not another page: it is another step here, and everything else keeps its shape.
+     */
+    trail: VideoUiTrailStep[];
+    trailLabel: string;
+    showAllLabel: string;
+    showLessLabel: string;
+    emptyCatalogLabel: string;
+    continueWatchingMeta: string;
+    continueWatching: VideoUiMediaCard[];
+    managedQueue: boolean;
+    upNextItems: VideoUiMediaCard[];
+    /** Lists the viewer created; null hides the block entirely. */
+    playlistPanel: VideoUiPlaylistPanel | null;
+    /** Media servers block above the library grid; null hides it entirely. */
+    serverForm: VideoUiServerForm | null;
+    showResumeProgress: boolean;
+    mediaDetail: VideoUiMediaDetail | null;
+    sidePanelTitle: string;
+    sidePanelMeta: string;
+    sections: VideoUiSection[];
+    navItems: VideoUiNavItem[];
+    toolCards: VideoUiToolCard[];
+    /** The tools open their panel inside the queue column, which is a sheet on a phone. */
+    set inspectorPanel(panel: VideoUiInspectorPanel | null);
+    get inspectorPanel(): VideoUiInspectorPanel | null;
+    /** What the side column shows: its own panel, or on phones the info panel. */
+    get sidePanel(): VideoUiInspectorPanel | null;
+    private inspector;
+    /**
+     * Every panel the host offers the side column. It used to hand one at a time, so a single
+     * panel still works: it is the list of one.
+     */
+    inspectorPanels: VideoUiInspectorPanel[];
+    /** The queue's own switch, which used to be "whatever showed when no panel did". */
+    queueOpen: boolean;
+    private readonly collapsedPanels;
+    private readonly closedPanels;
+    get knownPanels(): VideoUiInspectorPanel[];
+    /** The ones actually stacked: what the host offers, minus what the viewer put away. */
+    get openPanels(): VideoUiInspectorPanel[];
+    isPanelOpen(id: string): boolean;
+    isPanelCollapsed(id: string): boolean;
+    /** Folds a panel to its header, so several open ones stay usable without hiding any. */
+    togglePanelCollapsed(id: string): void;
+    togglePanel(id: string): void;
+    /**
+     * Puts a panel away. The host is told, since it is the one that decides what it offers; a host
+     * that keeps offering it gets it back from the pill, with no round trip.
+     */
+    closePanel(id: string): void;
+    inspectorCloseLabel: string;
+    libraryVisible: boolean;
+    /**
+     * Whether the area shows the player. A host with views of its own shows it only while watching, and gives the whole
+     * area to the view being browsed the rest of the time; the player then fills that area rather than sitting in it.
+     */
+    playerView: boolean;
+    /**
+     * Whether liking, sharing and keeping a video for later sit in the player's own controls. A host whose player has
+     * the screen to itself needs them there: there is no page around it to put them on.
+     */
+    watchActionsInPlayer: boolean;
+    /**
+     * Whether the area leads with the video being watched — its title, its buttons, its details. A home view turns it
+     * off so it opens on where videos come from, rather than on the last one that was played.
+     */
+    showActiveMedia: boolean;
+    closeLabel: string;
+    queueVisible: boolean;
+    /**
+     * What the side panel lists: the queue, or the videos of `sections` (a library, a collection, a list) in full. With
+     * `sections`, the library grid under the player gives way to the panel while the panel is beside it; on phones,
+     * where the panel is a sheet, the grid stays and shows them all.
+     */
+    sidePanelContent: 'queue' | 'sections';
+    /** "Back to Lists": shown above the side panel's title while something is open inside it; null at the top. */
+    sideBackLabel: string | null;
+    searchTerm: string;
+    runtimeMode: VideoUiRuntimeMode;
+    /** False when the host offers the online/offline choice elsewhere (its settings). */
+    runtimeModeInHeader: boolean;
+    set activeViewMode(value: VideoUiViewMode);
+    get activeViewMode(): VideoUiViewMode;
+    libraryTitle: string;
+    nowPlayingLabel: string;
+    fullscreenHintLabel: string;
+    fullscreenLabel: string;
+    readyStatusLabel: string;
+    playingStatusLabel: string;
+    pausedStatusLabel: string;
+    bufferingStatusLabel: string;
+    loadingStatusLabel: string;
+    endedStatusLabel: string;
+    errorStatusLabel: string;
+    miniPlayerVisible: boolean;
+    miniPlayerMeta: string;
+    miniPlayerPlayLabel: string;
+    miniPlayerPauseLabel: string;
+    miniPlayerFocusLabel: string;
+    miniPlayerCloseLabel: string;
+    miniPlayerRestoreLabel: string;
+    outputVolume: number;
+    outputVolumeLabel: string;
+    outputMuteLabel: string;
+    outputUnmuteLabel: string;
+    ended: EventEmitter<void>;
+    videoSize: EventEmitter<{
+        width: number;
+        height: number;
+    }>;
+    progress: EventEmitter<SmartPlayerProgress>;
+    /** The window's size (desktop): the whole app or a floating mini player ('bar' is an audio layout, shown in full). */
+    compactMode: SmartCompactMode;
+    /** True where the host can resize its window: shows the button that makes it a mini player. */
+    compactModes: boolean;
+    /**
+     * Down the side, across the top, or away. A narrow window still takes the row whatever is
+     * chosen — there is no side to put it down — but away stays away.
+     */
+    menuLayout: VideoUiMenuLayout;
+    compactMiniLabel: string;
+    compactRestoreLabel: string;
+    compactModeChange: EventEmitter<SmartCompactMode>;
+    /** "Show in Finder" for the video playing, where the host can show its file (desktop); empty hides the button. */
+    revealFileLabel: string;
+    revealFile: EventEmitter<void>;
+    prev: EventEmitter<void>;
+    next: EventEmitter<void>;
+    toggleShuffle: EventEmitter<void>;
+    cycleRepeat: EventEmitter<void>;
+    cast: EventEmitter<void>;
+    /** A subtitle file the viewer chose was read (ok), or could not be. */
+    /** The Infos button: open the info panel on its last tab, or close it. */
+    infoToggle: EventEmitter<void>;
+    /** Back out of what the side panel shows: a server folder, a list, a search (see `sideBackLabel`). */
+    sideBack: EventEmitter<void>;
+    /** Leaving the player. Reaching it from the mini player left nothing behind to go back to. */
+    playerBack: EventEmitter<void>;
+    /** The viewer's answer to `resumeOffer`: keep going from where it was, or start over (the player went back to 0). */
+    resumeChoice: EventEmitter<"resume" | "restart">;
+    infoTabSelect: EventEmitter<string>;
+    subtitlesLoaded: EventEmitter<{
+        label: string;
+        ok: boolean;
+        error?: string;
+    }>;
+    selectContinueWatching: EventEmitter<string>;
+    selectSectionItem: EventEmitter<{
+        sectionId: string;
+        itemId: string;
+    }>;
+    selectDetailEpisode: EventEmitter<string>;
+    chapterSeek: EventEmitter<{
+        id: string;
+        timeSec: number;
+    }>;
+    navSelect: EventEmitter<string>;
+    toolSelect: EventEmitter<string>;
+    detailAction: EventEmitter<string>;
+    inspectorAction: EventEmitter<string>;
+    settingChange: EventEmitter<SmartSettingChange>;
+    settingAction: EventEmitter<SmartSettingAction>;
+    closeInspector: EventEmitter<void>;
+    /** Which panel the viewer put away, when the host offers several. */
+    panelClosed: EventEmitter<string>;
+    openSource: EventEmitter<void>;
+    toggleLibrary: EventEmitter<void>;
+    /** A step of the trail the viewer asked to go back to. */
+    trailStep: EventEmitter<string>;
+    toggleQueue: EventEmitter<void>;
+    toggleCinema: EventEmitter<void>;
+    miniPlayerFocus: EventEmitter<void>;
+    miniPlayerClose: EventEmitter<void>;
+    miniPlayerRestore: EventEmitter<void>;
+    queueAddActive: EventEmitter<void>;
+    connectServer: EventEmitter<{
+        kind?: string;
+        address: string;
+        username: string;
+        password: string;
+    }>;
+    /** Looks for servers of this kind on the local network. */
+    discoverServers: EventEmitter<string>;
+    connectDiscoveredServer: EventEmitter<string>;
+    selectServer: EventEmitter<string>;
+    disconnectServer: EventEmitter<string>;
+    createPlaylist: EventEmitter<string>;
+    selectPlaylist: EventEmitter<string>;
+    /** Files the panel's target item in the given list. */
+    addToPlaylist: EventEmitter<string>;
+    /** Takes the panel's target out of the given list. */
+    removeFromPlaylist: EventEmitter<string>;
+    renamePlaylist: EventEmitter<{
+        id: string;
+        name: string;
+    }>;
+    deletePlaylist: EventEmitter<string>;
+    watchLaterToggle: EventEmitter<void>;
+    queueMoveUp: EventEmitter<string>;
+    queueMoveDown: EventEmitter<string>;
+    queueRemove: EventEmitter<string>;
+    searchFilterChange: EventEmitter<string>;
+    searchResultQueueAdd: EventEmitter<string>;
+    searchResultWatchLater: EventEmitter<string>;
+    searchResultFavorite: EventEmitter<string>;
+    searchResultDownload: EventEmitter<string>;
+    search: EventEmitter<void>;
+    searchTermChange: EventEmitter<string>;
+    viewModeChange: EventEmitter<VideoUiViewMode>;
+    runtimeModeChange: EventEmitter<VideoUiRuntimeMode>;
+    primaryPlay: EventEmitter<void>;
+    primaryPlaybackToggle: EventEmitter<VideoUiPlaybackIntent>;
+    playerStateChange: EventEmitter<PlayerState>;
+    sourceFileChange: EventEmitter<File>;
+    addFolder: EventEmitter<void>;
+    languageChange: EventEmitter<string>;
+    outputVolumeChange: EventEmitter<number>;
+    outputMuteToggle: EventEmitter<void>;
+    readonly waveformBars: number[];
+    searchOpen: boolean;
+    railExpanded: boolean;
+    fileDragActive: boolean;
+    playerState: PlayerState | null;
+    private posterPreviewDismissed;
+    private viewMode;
+    private readonly cdr;
+    private readonly host;
+    private fileDragDepth;
+    private cardMenuBox?;
+    private smartPlayer?;
+    private readonly document;
+    private contentScroll?;
+    private queueListEl?;
+    private queueFollowed;
+    private videoFileInput?;
+    set queuePanel(panel: ElementRef<HTMLElement> | undefined);
+    private isSheetLayout;
+    queueSheetOpen: boolean;
+    get queuePanelActive(): boolean;
+    onQueueAction(): void;
+    closeQueueSheet(): void;
+    /** True when the detail block only repeats the title bar above it, as it does for the playing media. */
+    get detailEchoesHeader(): boolean;
+    get isPlaying(): boolean;
+    get isLiveSource(): boolean;
+    get cinemaButtonLabel(): string;
+    get miniPlayerPlaybackLabel(): string;
+    get isOfflineMode(): boolean;
+    get showPosterPreview(): boolean;
+    get sourceTypeLabel(): string;
+    get playbackStateLabel(): string;
+    get primarySourceLabel(): string;
+    get primarySourceShortLabel(): string;
+    get primarySourceIcon(): SmartPlayerIconName;
+    get emptyKicker(): string;
+    get emptyTitle(): string;
+    get emptyBody(): string;
+    get libraryMeta(): string;
+    get railMeta(): string;
+    get displayHeroTitle(): string;
+    get displayHeroSubtitle(): string;
+    get displayHeroMeta(): string;
+    get displayHeroArtwork(): string;
+    get timelineMarkers(): NgxspTimelineMarker[];
+    get timelineDurationSec(): number | null;
+    get hasSearchQuery(): boolean;
+    get searchResultItems(): VideoUiCardRef[];
+    private readonly expandedSections;
+    isSectionExpanded(id: string): boolean;
+    /** Shows the rest of a shelf, or puts it back to a row. */
+    toggleSection(id: string): void;
+    /**
+     * The view as a stack of titled shelves — one per section, empty ones left out, each holding a
+     * row until it is asked for the rest. A view with nothing to shelve keeps what it showed before,
+     * under no heading of its own.
+     */
+    get librarySections(): Array<{
+        id: string;
+        title: string;
+        count: number;
+        titled: boolean;
+        hidden: boolean;
+        cards: VideoUiCardRef[];
+    }>;
+    get featuredItems(): VideoUiCardRef[];
+    get railItems(): VideoUiCardRef[];
+    /** The sections listed by the side panel when it shows them (`sidePanelContent`). */
+    get sideSectionGroups(): Array<{
+        id: string;
+        title: string;
+        cards: VideoUiCardRef[];
+    }>;
+    /** How many videos the side panel lists. */
+    get sidePanelCount(): number;
+    get displayQueueItems(): VideoUiCardRef[];
+    get hasManagedQueue(): boolean;
+    get isLibraryFocused(): boolean;
+    queueItemActionLabel(action: keyof VideoUiQueueActionLabels, card: VideoUiCardRef): string;
+    searchResultActionLabel(action: keyof VideoUiSearchActionLabels, card: VideoUiCardRef): string;
+    canMoveQueueItem(card: VideoUiCardRef, direction: 'up' | 'down'): boolean;
+    toggleRail(): void;
+    selectNav(item: VideoUiNavItem): void;
+    selectViewMode(mode: VideoUiViewMode): void;
+    selectSearchFilter(filter: VideoUiSearchFilter): void;
+    selectRuntimeMode(mode: VideoUiRuntimeMode): void;
+    onPrimarySourceAction(): void;
+    playlistDraftName: string;
+    playlistRenameDraft: string;
+    renamingPlaylistId: string | null;
+    serverKindDraft: string;
+    serverAddressDraft: string;
+    serverUsernameDraft: string;
+    serverPasswordDraft: string;
+    selectedServerKind(form: VideoUiServerForm): VideoUiServerKind | undefined;
+    onServerKindChange(event: Event): void;
+    onServerAddressInput(event: Event): void;
+    onServerUsernameInput(event: Event): void;
+    onServerPasswordInput(event: Event): void;
+    submitServer(event: Event): void;
+    onPlaylistDraftInput(event: Event): void;
+    submitCreatePlaylist(event: Event): void;
+    startRenamePlaylist(list: VideoUiPlaylistOption): void;
+    onPlaylistRenameInput(event: Event): void;
+    submitRenamePlaylist(event: Event): void;
+    cancelRenamePlaylist(): void;
+    selectCard(card: VideoUiCardRef): void;
+    selectMediaChapter(chapter: VideoUiMediaChapter): void;
+    private chapterTimeSec;
+    private timeLabelToSeconds;
+    isSyntheticSection(sectionId: string): boolean;
+    private get itemCount();
+    private get fallbackCards();
+    private get activeCard();
+    private toRefs;
+    toggleSearch(): void;
+    clearSearch(): void;
+    onSearchInput(event: Event): void;
+    togglePrimaryPlayback(): void;
+    toggleMiniPlayerPlayback(): void;
+    /**
+     * How far the area is scrolled. A host that moves between views reads it before leaving one, so coming back
+     * can put the viewer where they were rather than at the top of a list they had already walked down. On a
+     * narrow layout the page scrolls instead of the panel, so whichever one moved is the one reported.
+     */
+    contentScrollTop(): number;
+    /** Puts the area back where it was, or at the top with 0 on entering a view for the first time. */
+    setContentScrollTop(value: number): void;
+    /** Moves the playhead, for a host driven from outside the page: a lock screen scrubber, a remote, another device. */
+    seekTo(timeSec: number): void;
+    setOutputVolumePercent(value: number): void;
+    onOutputVolumeRatioChange(value: number): void;
+    openSourcePicker(): void;
+    onSourceFileInput(event: Event): void;
+    onFileDragEnter(event: DragEvent): void;
+    onFileDragOver(event: DragEvent): void;
+    onFileDragLeave(event: DragEvent): void;
+    onFileDrop(event: DragEvent): void;
+    onPlayerStateChange(state: PlayerState): void;
+    posterInitial(title: string): string;
+    mediaCardMeta(card: VideoUiMediaCard): string;
+    /** What a finger is changing right now, and where it stands. Null when nothing is being changed. */
+    protected touchAdjusting: {
+        kind: 'brightness' | 'volume';
+        value: number;
+    } | null;
+    private touchStart;
+    /** A drag is not a click: the one that follows it is swallowed rather than reaching a control. */
+    private swallowNextClick;
+    /** How far the picture has to be crossed to go from nothing to everything. */
+    private static readonly TOUCH_TRAVEL;
+    private static readonly TOUCH_THRESHOLD;
+    private static readonly MIN_BRIGHTNESS;
+    /**
+     * A gesture starts on the picture, never on something built to be pressed: a button, a slider,
+     * a menu. Those keep the events that belong to them.
+     */
+    protected onFramePointerDown(event: PointerEvent): void;
+    /**
+     * Nothing happens until the finger has travelled further down than across: a tap stays a tap,
+     * and a sideways drag is somebody else's gesture.
+     */
+    protected onFramePointerMove(event: PointerEvent): void;
+    protected onFramePointerUp(event: PointerEvent): void;
+    /**
+     * Le clic qui clôt un glissement mettrait sinon en pause la vidéo dont le glissement ne
+     * parlait pas. Posé ici plutôt que dans le gabarit : avaler un clic n'est pas une interaction,
+     * et en capture il est arrêté avant d'atteindre la moindre commande.
+     */
+    private swallowTheClickThatEndsADrag;
+    /** The card menu while it is open: which card, and where the gesture put it. */
+    protected cardMenu: {
+        card: VideoUiMediaCard;
+        x: number;
+        y: number;
+    } | null;
+    /**
+     * Opens a card's own menu where the gesture happened — a right click, or the button that
+     * appears on the card — and keeps it inside the window rather than off its edge.
+     */
+    protected openCardMenu(event: MouseEvent, card: VideoUiMediaCard): void;
+    protected closeCardMenu(): void;
+    protected chooseCardAction(action: VideoUiCardAction): void;
+    /** Whether the strip is waiting for an answer rather than reporting: both ways out have a name. */
+    get promptAsking(): boolean;
+    safeProgressPercent(value: number): number;
+    artVariant(card: VideoUiCardRef): string;
+    private normalizeOutputVolume;
+    private dragHasFiles;
+    static ɵfac: i0.ɵɵFactoryDeclaration<NgxSmartPlayerVideoUiComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<NgxSmartPlayerVideoUiComponent, "ngxsp-video-player-ui", never, { "config": { "alias": "config"; "required": false; }; "brandLogoSrc": { "alias": "brandLogoSrc"; "required": false; }; "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; }; "playRequest": { "alias": "playRequest"; "required": false; }; "canPrev": { "alias": "canPrev"; "required": false; }; "canNext": { "alias": "canNext"; "required": false; }; "previousLabel": { "alias": "previousLabel"; "required": false; }; "playerBackLabel": { "alias": "playerBackLabel"; "required": false; }; "nextLabel": { "alias": "nextLabel"; "required": false; }; "playLabel": { "alias": "playLabel"; "required": false; }; "pauseLabel": { "alias": "pauseLabel"; "required": false; }; "transportLabel": { "alias": "transportLabel"; "required": false; }; "cinemaMode": { "alias": "cinemaMode"; "required": false; }; "cinemaLabel": { "alias": "cinemaLabel"; "required": false; }; "cinemaActiveLabel": { "alias": "cinemaActiveLabel"; "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; }; "castEnabled": { "alias": "castEnabled"; "required": false; }; "castConnected": { "alias": "castConnected"; "required": false; }; "resumeOffer": { "alias": "resumeOffer"; "required": false; }; "infoTabs": { "alias": "infoTabs"; "required": false; }; "infoLabel": { "alias": "infoLabel"; "required": false; }; "infoPanel": { "alias": "infoPanel"; "required": false; }; "playerMenuLabels": { "alias": "playerMenuLabels"; "required": false; }; "heroEyebrow": { "alias": "heroEyebrow"; "required": false; }; "heroTitle": { "alias": "heroTitle"; "required": false; }; "heroSubtitle": { "alias": "heroSubtitle"; "required": false; }; "heroMeta": { "alias": "heroMeta"; "required": false; }; "heroArtworkUrl": { "alias": "heroArtworkUrl"; "required": false; }; "preferPosterPreview": { "alias": "preferPosterPreview"; "required": false; }; "runtimeModeLabel": { "alias": "runtimeModeLabel"; "required": false; }; "onlineLabel": { "alias": "onlineLabel"; "required": false; }; "offlineLabel": { "alias": "offlineLabel"; "required": false; }; "navigationLabel": { "alias": "navigationLabel"; "required": false; }; "menuLabel": { "alias": "menuLabel"; "required": false; }; "searchPlaceholder": { "alias": "searchPlaceholder"; "required": false; }; "searchLabel": { "alias": "searchLabel"; "required": false; }; "searchResultsTitle": { "alias": "searchResultsTitle"; "required": false; }; "searchResultsSummary": { "alias": "searchResultsSummary"; "required": false; }; "searchResultsEmptyTitle": { "alias": "searchResultsEmptyTitle"; "required": false; }; "searchResultsEmptyBody": { "alias": "searchResultsEmptyBody"; "required": false; }; "searchClearLabel": { "alias": "searchClearLabel"; "required": false; }; "searchFilterLabel": { "alias": "searchFilterLabel"; "required": false; }; "searchFilters": { "alias": "searchFilters"; "required": false; }; "searchActionLabels": { "alias": "searchActionLabels"; "required": false; }; "notificationsLabel": { "alias": "notificationsLabel"; "required": false; }; "settingsLabel": { "alias": "settingsLabel"; "required": false; }; "sourceChangeLabel": { "alias": "sourceChangeLabel"; "required": false; }; "sourceChangeTitle": { "alias": "sourceChangeTitle"; "required": false; }; "sourceDropTitle": { "alias": "sourceDropTitle"; "required": false; }; "sourceDropHint": { "alias": "sourceDropHint"; "required": false; }; "sourceChangeAccept": { "alias": "sourceChangeAccept"; "required": false; }; "folderImportLabel": { "alias": "folderImportLabel"; "required": false; }; "libraryStatus": { "alias": "libraryStatus"; "required": false; }; "touchAdjust": { "alias": "touchAdjust"; "required": false; }; "brightness": { "alias": "brightness"; "required": false; }; "cardActionsLabel": { "alias": "cardActionsLabel"; "required": false; }; "cardMenuCloseLabel": { "alias": "cardMenuCloseLabel"; "required": false; }; "promptBar": { "alias": "promptBar"; "required": false; }; "libraryBusy": { "alias": "libraryBusy"; "required": false; }; "sourceTypeLocalLabel": { "alias": "sourceTypeLocalLabel"; "required": false; }; "sourceTypeStreamLabel": { "alias": "sourceTypeStreamLabel"; "required": false; }; "languageLabel": { "alias": "languageLabel"; "required": false; }; "activeLanguage": { "alias": "activeLanguage"; "required": false; }; "languageOptions": { "alias": "languageOptions"; "required": false; }; "statusMessage": { "alias": "statusMessage"; "required": false; }; "statusKind": { "alias": "statusKind"; "required": false; }; "likeLabel": { "alias": "likeLabel"; "required": false; }; "likeActive": { "alias": "likeActive"; "required": false; }; "dislikeLabel": { "alias": "dislikeLabel"; "required": false; }; "shareLabel": { "alias": "shareLabel"; "required": false; }; "watchLaterLabel": { "alias": "watchLaterLabel"; "required": false; }; "watchLaterActive": { "alias": "watchLaterActive"; "required": false; }; "queueActionLabel": { "alias": "queueActionLabel"; "required": false; }; "queueShortLabel": { "alias": "queueShortLabel"; "required": false; }; "queueAddActiveLabel": { "alias": "queueAddActiveLabel"; "required": false; }; "queueAddActiveShortLabel": { "alias": "queueAddActiveShortLabel"; "required": false; }; "queueActionLabels": { "alias": "queueActionLabels"; "required": false; }; "moreLabel": { "alias": "moreLabel"; "required": false; }; "moreShortLabel": { "alias": "moreShortLabel"; "required": false; }; "browseLibraryLabel": { "alias": "browseLibraryLabel"; "required": false; }; "trail": { "alias": "trail"; "required": false; }; "trailLabel": { "alias": "trailLabel"; "required": false; }; "showAllLabel": { "alias": "showAllLabel"; "required": false; }; "showLessLabel": { "alias": "showLessLabel"; "required": false; }; "emptyCatalogLabel": { "alias": "emptyCatalogLabel"; "required": false; }; "continueWatchingMeta": { "alias": "continueWatchingMeta"; "required": false; }; "continueWatching": { "alias": "continueWatching"; "required": false; }; "managedQueue": { "alias": "managedQueue"; "required": false; }; "upNextItems": { "alias": "upNextItems"; "required": false; }; "playlistPanel": { "alias": "playlistPanel"; "required": false; }; "serverForm": { "alias": "serverForm"; "required": false; }; "showResumeProgress": { "alias": "showResumeProgress"; "required": false; }; "mediaDetail": { "alias": "mediaDetail"; "required": false; }; "sidePanelTitle": { "alias": "sidePanelTitle"; "required": false; }; "sidePanelMeta": { "alias": "sidePanelMeta"; "required": false; }; "sections": { "alias": "sections"; "required": false; }; "navItems": { "alias": "navItems"; "required": false; }; "toolCards": { "alias": "toolCards"; "required": false; }; "inspectorPanel": { "alias": "inspectorPanel"; "required": false; }; "inspectorPanels": { "alias": "inspectorPanels"; "required": false; }; "inspectorCloseLabel": { "alias": "inspectorCloseLabel"; "required": false; }; "libraryVisible": { "alias": "libraryVisible"; "required": false; }; "playerView": { "alias": "playerView"; "required": false; }; "watchActionsInPlayer": { "alias": "watchActionsInPlayer"; "required": false; }; "showActiveMedia": { "alias": "showActiveMedia"; "required": false; }; "closeLabel": { "alias": "closeLabel"; "required": false; }; "queueVisible": { "alias": "queueVisible"; "required": false; }; "sidePanelContent": { "alias": "sidePanelContent"; "required": false; }; "sideBackLabel": { "alias": "sideBackLabel"; "required": false; }; "searchTerm": { "alias": "searchTerm"; "required": false; }; "runtimeMode": { "alias": "runtimeMode"; "required": false; }; "runtimeModeInHeader": { "alias": "runtimeModeInHeader"; "required": false; }; "activeViewMode": { "alias": "activeViewMode"; "required": false; }; "libraryTitle": { "alias": "libraryTitle"; "required": false; }; "nowPlayingLabel": { "alias": "nowPlayingLabel"; "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; }; "miniPlayerVisible": { "alias": "miniPlayerVisible"; "required": false; }; "miniPlayerMeta": { "alias": "miniPlayerMeta"; "required": false; }; "miniPlayerPlayLabel": { "alias": "miniPlayerPlayLabel"; "required": false; }; "miniPlayerPauseLabel": { "alias": "miniPlayerPauseLabel"; "required": false; }; "miniPlayerFocusLabel": { "alias": "miniPlayerFocusLabel"; "required": false; }; "miniPlayerCloseLabel": { "alias": "miniPlayerCloseLabel"; "required": false; }; "miniPlayerRestoreLabel": { "alias": "miniPlayerRestoreLabel"; "required": false; }; "outputVolume": { "alias": "outputVolume"; "required": false; }; "outputVolumeLabel": { "alias": "outputVolumeLabel"; "required": false; }; "outputMuteLabel": { "alias": "outputMuteLabel"; "required": false; }; "outputUnmuteLabel": { "alias": "outputUnmuteLabel"; "required": false; }; "compactMode": { "alias": "compactMode"; "required": false; }; "compactModes": { "alias": "compactModes"; "required": false; }; "menuLayout": { "alias": "menuLayout"; "required": false; }; "compactMiniLabel": { "alias": "compactMiniLabel"; "required": false; }; "compactRestoreLabel": { "alias": "compactRestoreLabel"; "required": false; }; "revealFileLabel": { "alias": "revealFileLabel"; "required": false; }; }, { "brightnessChange": "brightnessChange"; "cardAction": "cardAction"; "promptAnswer": "promptAnswer"; "ended": "ended"; "videoSize": "videoSize"; "progress": "progress"; "compactModeChange": "compactModeChange"; "revealFile": "revealFile"; "prev": "prev"; "next": "next"; "toggleShuffle": "toggleShuffle"; "cycleRepeat": "cycleRepeat"; "cast": "cast"; "infoToggle": "infoToggle"; "sideBack": "sideBack"; "playerBack": "playerBack"; "resumeChoice": "resumeChoice"; "infoTabSelect": "infoTabSelect"; "subtitlesLoaded": "subtitlesLoaded"; "selectContinueWatching": "selectContinueWatching"; "selectSectionItem": "selectSectionItem"; "selectDetailEpisode": "selectDetailEpisode"; "chapterSeek": "chapterSeek"; "navSelect": "navSelect"; "toolSelect": "toolSelect"; "detailAction": "detailAction"; "inspectorAction": "inspectorAction"; "settingChange": "settingChange"; "settingAction": "settingAction"; "closeInspector": "closeInspector"; "panelClosed": "panelClosed"; "openSource": "openSource"; "toggleLibrary": "toggleLibrary"; "trailStep": "trailStep"; "toggleQueue": "toggleQueue"; "toggleCinema": "toggleCinema"; "miniPlayerFocus": "miniPlayerFocus"; "miniPlayerClose": "miniPlayerClose"; "miniPlayerRestore": "miniPlayerRestore"; "queueAddActive": "queueAddActive"; "connectServer": "connectServer"; "discoverServers": "discoverServers"; "connectDiscoveredServer": "connectDiscoveredServer"; "selectServer": "selectServer"; "disconnectServer": "disconnectServer"; "createPlaylist": "createPlaylist"; "selectPlaylist": "selectPlaylist"; "addToPlaylist": "addToPlaylist"; "removeFromPlaylist": "removeFromPlaylist"; "renamePlaylist": "renamePlaylist"; "deletePlaylist": "deletePlaylist"; "watchLaterToggle": "watchLaterToggle"; "queueMoveUp": "queueMoveUp"; "queueMoveDown": "queueMoveDown"; "queueRemove": "queueRemove"; "searchFilterChange": "searchFilterChange"; "searchResultQueueAdd": "searchResultQueueAdd"; "searchResultWatchLater": "searchResultWatchLater"; "searchResultFavorite": "searchResultFavorite"; "searchResultDownload": "searchResultDownload"; "search": "search"; "searchTermChange": "searchTermChange"; "viewModeChange": "viewModeChange"; "runtimeModeChange": "runtimeModeChange"; "primaryPlay": "primaryPlay"; "primaryPlaybackToggle": "primaryPlaybackToggle"; "playerStateChange": "playerStateChange"; "sourceFileChange": "sourceFileChange"; "addFolder": "addFolder"; "languageChange": "languageChange"; "outputVolumeChange": "outputVolumeChange"; "outputMuteToggle": "outputMuteToggle"; }, never, never, true, never>;
+}
+
+declare class NgxSmartPlayerVideoUiModule {
+    static ɵfac: i0.ɵɵFactoryDeclaration<NgxSmartPlayerVideoUiModule, never>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<NgxSmartPlayerVideoUiModule, never, [typeof NgxSmartPlayerVideoUiComponent], [typeof NgxSmartPlayerVideoUiComponent]>;
+    static ɵinj: i0.ɵɵInjectorDeclaration<NgxSmartPlayerVideoUiModule>;
+}
+
+export { NgxSmartPlayerVideoUiComponent, NgxSmartPlayerVideoUiModule };
+export type { VideoUiCardAction, VideoUiInfoTab, VideoUiInspectorAction, VideoUiInspectorItem, VideoUiInspectorMetric, VideoUiInspectorPanel, VideoUiInspectorTone, VideoUiLanguageOption, VideoUiMediaCard, VideoUiMediaChapter, VideoUiMediaChecklistItem, VideoUiMediaDetail, VideoUiMediaDetailAction, VideoUiMediaDetailEpisode, VideoUiMediaKind, VideoUiMediaWorkspaceTone, VideoUiMenuLayout, VideoUiNavItem, VideoUiPlaybackIntent, VideoUiPlaylistOption, VideoUiPlaylistPanel, VideoUiPromptBar, VideoUiQueueActionLabels, VideoUiResumeOffer, VideoUiRuntimeMode, VideoUiSearchActionLabels, VideoUiSearchFilter, VideoUiSection, VideoUiServerDiscovery, VideoUiServerForm, VideoUiServerKind, VideoUiStatusKind, VideoUiToolCard, VideoUiToolTone, VideoUiTrailStep, VideoUiViewMode };