itube-modern-player 0.1.0

package/dist/player.d.ts

@@ -0,0 +1,142 @@
+import { NormalizedChapter } from './features/chapters';
+import { Level } from './features/hls';
+import { ThumbnailTrack } from './features/thumbnails';
+import { ActionsOptions, ControlsOptions, IconName, PlayerEventMap, PlayerLabels, PlayerOptions, SubtitleTrack, VideoSource } from './types';
+/**
+ * Framework-agnostic video player.
+ *
+ * ```ts
+ * import { Player } from 'itube-modern-player'
+ * import 'itube-modern-player/style.css'
+ *
+ * const player = new Player('#mount', { source: { src: 'video.m3u8', title: 'Demo' } })
+ * ```
+ *
+ * Design rules this codebase follows (deliberately unlike fluid-player):
+ * - no globals, no instance registry — `new Player()` as many times as you like;
+ * - one overlay layer laid out with grid/flex, not a pile of absolute elements;
+ * - `destroy()` returns the mount node to its original state;
+ * - every event is typed, every string and icon is replaceable.
+ */
+export declare class Player {
+    readonly container: HTMLElement;
+    readonly video: HTMLVideoElement;
+    readonly labels: PlayerLabels;
+    readonly icons: Record<IconName, string>;
+    readonly controlsOptions: Required<ControlsOptions>;
+    readonly actionsOptions: ActionsOptions;
+    readonly playbackRates: number[];
+    readonly seekStep: number;
+    /** Set by the controls while the user drags the seek bar. */
+    scrubbing: boolean;
+    private emitter;
+    private mount;
+    private options;
+    private playlistOptions;
+    private abort;
+    private sources;
+    private currentIndex;
+    private sourceController;
+    private loadToken;
+    private chapters;
+    private currentChapter;
+    private progressiveQuality;
+    private thumbTrack;
+    private shuffleMode;
+    private controls;
+    private poster;
+    private pauseScreen;
+    private related;
+    private playlistPanel;
+    private scenesPanel;
+    private spinner;
+    private errorBox;
+    private adManager;
+    private playedOnce;
+    private idleTimer;
+    private destroyed;
+    constructor(target: string | HTMLElement, options?: PlayerOptions);
+    on<K extends keyof PlayerEventMap>(event: K, fn: (payload: PlayerEventMap[K]) => void): () => void;
+    once<K extends keyof PlayerEventMap>(event: K, fn: (payload: PlayerEventMap[K]) => void): () => void;
+    off<K extends keyof PlayerEventMap>(event: K, fn: (payload: PlayerEventMap[K]) => void): void;
+    /** @internal — UI modules emit through the player. */
+    emit<K extends keyof PlayerEventMap>(event: K, payload: PlayerEventMap[K]): void;
+    get paused(): boolean;
+    get ended(): boolean;
+    get currentTime(): number;
+    get duration(): number;
+    get live(): boolean;
+    get bufferedEnd(): number;
+    get adPlaying(): boolean;
+    play(): Promise<void>;
+    pause(): void;
+    togglePlay(): void;
+    seek(time: number): void;
+    /** Relative seek, e.g. `skip(-10)`. */
+    skip(delta: number): void;
+    get volume(): number;
+    get muted(): boolean;
+    setVolume(volume: number): void;
+    setMuted(muted: boolean): void;
+    toggleMute(): void;
+    get playbackRate(): number;
+    setPlaybackRate(rate: number): void;
+    get qualityLevels(): Level[];
+    get qualityAutoAvailable(): boolean;
+    get currentQuality(): number;
+    setQuality(index: number): void;
+    get subtitleTracks(): SubtitleTrack[];
+    get activeSubtitle(): number;
+    setSubtitle(index: number): void;
+    get playlist(): VideoSource[];
+    get index(): number;
+    get source(): VideoSource | null;
+    get hasPlaylist(): boolean;
+    get hasNext(): boolean;
+    get hasPrevious(): boolean;
+    /** Shuffle mode: `next()` and auto-advance pick a random item. */
+    get shuffle(): boolean;
+    setShuffle(on: boolean): void;
+    /** Repeat mode: after the last item the list starts over instead of ending. */
+    get repeat(): boolean;
+    setRepeat(on: boolean): void;
+    next(): void;
+    previous(): void;
+    /** Jump to a playlist item and start playback. */
+    playItem(index: number): void;
+    togglePlaylistPanel(): void;
+    toggleScenesPanel(): void;
+    /** Thumbnail track of the current source (used by the seek tooltip and the scenes panel). */
+    get thumbnails(): ThumbnailTrack | null;
+    /**
+     * Replace what the player is playing. A single source resets the playlist
+     * to one item; an array installs a new playlist.
+     */
+    load(source: VideoSource | VideoSource[], startIndex?: number): void;
+    get isFullscreen(): boolean;
+    toggleFullscreen(): Promise<void>;
+    togglePip(): Promise<void>;
+    /** Normalized chapters of the current source (after metadata is known). */
+    get chapterList(): NormalizedChapter[];
+    get chapter(): NormalizedChapter | null;
+    /**
+     * Share the current video: native share sheet when the device has one,
+     * otherwise the `action` event with `id: "share"` so the app can show
+     * its own dialog.
+     */
+    share(): Promise<void>;
+    /** Highlight the like or dislike button (`null` clears both). */
+    setLikeState(state: 'like' | 'dislike' | null): void;
+    /** Update like/dislike counters shown as tooltips above the buttons (`undefined` leaves one untouched). */
+    setLikeCounts(likeCount?: number | string, dislikeCount?: number | string): void;
+    /** Inject custom pause-screen content (used by the Vue wrapper's slot). */
+    setPauseScreenContent(element: HTMLElement | null): void;
+    destroy(): void;
+    private loadItem;
+    private bindVideoEvents;
+    private handleEnded;
+    private bindIdleHide;
+    private showControlsNow;
+    private scheduleIdle;
+    private bindKeyboard;
+}

package/dist/style.css

@@ -0,0 +1 @@
+.imp-player{--imp-accent: #e53935;--imp-bg: #000;--imp-text: #fff;--imp-control-bg: rgba(20, 20, 20, .85);--imp-track: rgba(255, 255, 255, .25);--imp-track-buffered: rgba(255, 255, 255, .35);--imp-radius: 8px;--imp-font: system-ui, -apple-system, "Segoe UI", Roboto, sans-serif;--imp-controls-height: 48px;--imp-transition: .18s ease;position:relative;width:100%;aspect-ratio:16 / 9;background:var(--imp-bg);color:var(--imp-text);font-family:var(--imp-font);font-size:14px;line-height:1.4;overflow:hidden;border-radius:var(--imp-radius);outline:none;user-select:none;-webkit-user-select:none;container-type:inline-size}.imp-player--fullscreen{border-radius:0}.imp-player [hidden],.imp-ad [hidden]{display:none!important}.imp-video{width:100%;height:100%;display:block;object-fit:contain}.imp-layer{position:absolute;inset:0;display:grid;grid-template-rows:auto 1fr auto;grid-template-columns:minmax(0,1fr);grid-template-areas:"top" "middle" "bottom";pointer-events:none}.imp-layer__middle{grid-area:middle;display:flex;align-items:center;justify-content:center}.imp-center-controls{position:absolute;inset:0;align-items:center;justify-content:center;gap:16px;pointer-events:none;transition:opacity var(--imp-transition)}.imp-player--idle .imp-center-controls{opacity:0}.imp-center-btn{pointer-events:auto;display:inline-flex;align-items:center;justify-content:center;width:42px;height:42px;padding:10px;border:0;border-radius:50%;background:#00000073;color:#fff;cursor:pointer;transition:background var(--imp-transition),transform var(--imp-transition)}.imp-center-btn svg{width:100%;height:100%}.imp-center-btn--play{width:56px;height:56px;padding:14px;background:var(--imp-accent)}.imp-center-btn:hover:not(:disabled){background:#0009}.imp-center-btn--play:hover:not(:disabled){background:var(--imp-accent)}.imp-center-btn:active:not(:disabled){transform:scale(.9)}.imp-center-btn:disabled{opacity:.35;cursor:default}.imp-layer__bottom{grid-area:bottom;display:flex;flex-direction:column;background:linear-gradient(transparent,#000000b3);padding:24px 12px 8px;opacity:1;transition:opacity var(--imp-transition)}.imp-player--idle .imp-layer__bottom{opacity:0}.imp-player--idle{cursor:none}.imp-btn{pointer-events:auto;display:inline-flex;align-items:center;justify-content:center;width:36px;height:36px;padding:6px;border:0;border-radius:6px;background:transparent;color:inherit;cursor:pointer;transition:background var(--imp-transition),transform var(--imp-transition)}.imp-btn svg{width:100%;height:100%}.imp-btn:hover:not(:disabled){background:#ffffff26}.imp-btn:focus-visible{outline:2px solid var(--imp-accent);outline-offset:1px}.imp-btn:disabled{opacity:.35;cursor:default}.imp-btn--active{color:var(--imp-accent)}.imp-btn--like.imp-btn--active{color:var(--imp-like, forestgreen)}.imp-btn--dislike.imp-btn--active{color:var(--imp-dislike, #e53935)}.imp-action{position:relative;display:inline-flex}.imp-count-tooltip{position:absolute;bottom:calc(100% + 6px);left:50%;transform:translate(-50%) scale(.9);padding:3px 7px;border-radius:5px;background:var(--imp-control-bg);color:var(--imp-text);font-size:12px;font-variant-numeric:tabular-nums;line-height:1.2;white-space:nowrap;pointer-events:none;opacity:0;visibility:hidden;transition:opacity var(--imp-transition),transform var(--imp-transition);z-index:5}.imp-action:hover .imp-count-tooltip:not([hidden]){opacity:1;visibility:visible;transform:translate(-50%) scale(1)}.imp-controls{display:flex;flex-direction:column;gap:4px}.imp-controls__row{display:flex;align-items:center;gap:4px;min-height:var(--imp-controls-height)}.imp-controls__group{display:flex;align-items:center;gap:2px;flex:0 0 auto}.imp-controls__row .imp-btn,.imp-controls__menu-anchor,.imp-action,.imp-volume,.imp-controls__time,.imp-controls__live{flex:0 0 auto}.imp-controls__spacer{flex:1;display:flex;align-items:center;justify-content:center;min-width:0}.imp-controls__chapter{font-size:12px;opacity:.85;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}.imp-controls__time{font-variant-numeric:tabular-nums;font-size:13px;margin:0 6px;white-space:nowrap}.imp-controls__live{display:inline-flex;align-items:center;gap:5px;font-size:11px;font-weight:700;letter-spacing:.5px;margin:0 6px}.imp-controls__live:before{content:"";width:8px;height:8px;border-radius:50%;background:var(--imp-accent)}.imp-controls__menu-anchor{position:relative;display:flex}.imp-volume{display:flex;align-items:center}.imp-volume__slider{pointer-events:auto;appearance:none;-webkit-appearance:none;width:0;opacity:0;height:4px;border-radius:2px;background:linear-gradient(to right,var(--imp-text) var(--imp-volume-fill, 100%),var(--imp-track) var(--imp-volume-fill, 100%));cursor:pointer;transition:width var(--imp-transition),opacity var(--imp-transition)}.imp-volume:hover .imp-volume__slider,.imp-volume__slider:focus-visible{width:64px;opacity:1;margin-right:6px}.imp-volume__slider::-webkit-slider-thumb{-webkit-appearance:none;width:12px;height:12px;border-radius:50%;background:var(--imp-text);border:0}.imp-volume__slider::-moz-range-thumb{width:12px;height:12px;border-radius:50%;background:var(--imp-text);border:0}.imp-progress{pointer-events:auto;position:relative;height:16px;display:flex;align-items:center;cursor:pointer;touch-action:none}.imp-progress--live{visibility:hidden}.imp-progress__heatmap{position:absolute;left:0;right:0;bottom:10px;height:36px;pointer-events:none;opacity:0;transition:opacity var(--imp-transition)}.imp-progress:hover .imp-progress__heatmap,.imp-progress--scrubbing .imp-progress__heatmap{opacity:1}.imp-progress__heatmap svg{width:100%;height:100%;display:block}.imp-progress__heatmap path{fill:#ffffff59}.imp-progress__buffered{position:absolute;left:0;height:4px;width:0;border-radius:2px;background:var(--imp-track-buffered);transition:height var(--imp-transition)}.imp-progress__track{position:relative;display:flex;gap:2px;width:100%;height:4px;transition:height var(--imp-transition)}.imp-progress:hover .imp-progress__track,.imp-progress--scrubbing .imp-progress__track,.imp-progress:hover .imp-progress__buffered,.imp-progress--scrubbing .imp-progress__buffered{height:6px}.imp-progress__segment{position:relative;flex-basis:0;height:100%;background:var(--imp-track);border-radius:2px;overflow:hidden}.imp-progress__fill{width:100%;height:100%;background:var(--imp-accent);transform:scaleX(0);transform-origin:left}.imp-progress__handle{position:absolute;width:12px;height:12px;border-radius:50%;background:var(--imp-accent);transform:translate(-50%) scale(0);transition:transform var(--imp-transition);pointer-events:none}.imp-progress:hover .imp-progress__handle,.imp-progress--scrubbing .imp-progress__handle{transform:translate(-50%) scale(1)}.imp-progress__tooltip{position:absolute;bottom:22px;transform:translate(-50%);display:flex;flex-direction:column;align-items:center;gap:4px;padding:4px;border-radius:6px;background:var(--imp-control-bg);opacity:0;visibility:hidden;transition:opacity var(--imp-transition);pointer-events:none;white-space:nowrap}.imp-progress__tooltip--visible{opacity:1;visibility:visible}.imp-progress__thumb{border-radius:4px;background-color:#111;background-repeat:no-repeat}.imp-progress__tooltip-chapter{font-size:12px;font-weight:600;max-width:220px;overflow:hidden;text-overflow:ellipsis}.imp-progress__tooltip-time{font-size:11px;font-variant-numeric:tabular-nums;opacity:.85}.imp-menu{pointer-events:auto;position:absolute;right:0;bottom:44px;min-width:160px;max-height:280px;overflow-y:auto;background:var(--imp-control-bg);border-radius:var(--imp-radius);padding:6px;backdrop-filter:blur(8px);z-index:5}.imp-menu__backdrop{display:none}.imp-menu__section+.imp-menu__section{margin-top:6px;border-top:1px solid rgba(255,255,255,.12);padding-top:6px}.imp-menu__title{font-size:11px;text-transform:uppercase;letter-spacing:.6px;opacity:.6;padding:4px 8px}.imp-menu__item{display:flex;align-items:center;gap:8px;width:100%;text-align:left;border:0;background:transparent;color:inherit;font:inherit;padding:7px 10px;border-radius:5px;cursor:pointer}.imp-menu__icon{display:inline-flex;width:18px;height:18px;flex-shrink:0}.imp-menu__icon svg,.imp-menu__icon img{width:100%;height:100%;object-fit:contain}.imp-menu__label{white-space:nowrap}.imp-menu__item:hover{background:#ffffff1f}.imp-menu__item--active{color:var(--imp-accent);font-weight:600}.imp-poster{position:absolute;inset:0;display:flex;align-items:center;justify-content:center;background:var(--imp-bg)}.imp-poster__image{position:absolute;inset:0;background-size:cover;background-position:center}.imp-poster__play{position:relative;width:72px;height:72px;border-radius:50%;background:var(--imp-accent);padding:16px}.imp-poster__play:hover:not(:disabled){background:var(--imp-accent);transform:scale(1.08)}.imp-error{pointer-events:auto;max-width:80%;padding:10px 16px;border-radius:8px;background:#000000bf;border:1px solid rgba(255,255,255,.2);font-size:13px;text-align:center}.imp-spinner{position:absolute;inset:0;margin:auto;width:48px;height:48px;border:4px solid rgba(255,255,255,.25);border-top-color:var(--imp-text);border-radius:50%;animation:imp-spin .8s linear infinite}@keyframes imp-spin{to{transform:rotate(360deg)}}.imp-pause-screen{grid-area:top;pointer-events:auto;padding:20px 24px;background:linear-gradient(rgba(0,0,0,.7),transparent);animation:imp-fade-in .22s ease}.imp-pause-screen--custom{grid-area:1 / 1 / -1 / -1;display:flex;align-items:center;justify-content:center;padding:16px;background:#0009;z-index:4}.imp-pause-screen__custom{pointer-events:auto;max-width:100%;max-height:100%;overflow:auto}.imp-pause-screen__default{display:flex;align-items:flex-start;justify-content:space-between;gap:14px}.imp-pause-screen__heading{flex:1;min-width:0}.imp-channel{display:flex;align-items:center;gap:10px;border:0;padding:0;background:transparent;color:inherit;font:inherit;text-align:left;flex-shrink:0}.imp-channel--link{cursor:pointer}.imp-channel--link:hover .imp-channel__name{text-decoration:underline}.imp-channel__avatar{width:44px;height:44px;border-radius:50%;background:linear-gradient(135deg,var(--imp-accent),#7b1fa2);background-size:cover;background-position:center}.imp-channel__avatar--rounded{border-radius:10px}.imp-channel__avatar--square{border-radius:0}.imp-channel__avatar--circle{border-radius:50%}.imp-channel__avatar{background-size:cover;background-position:center;display:flex;align-items:center;justify-content:center;font-size:20px;font-weight:700;flex-shrink:0}.imp-channel__name{font-size:14px;font-weight:600;max-width:160px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;text-align:right}.imp-pause-screen__title{font-size:20px;font-weight:700}.imp-pause-screen__description{margin-top:6px;font-size:14px;opacity:.85;display:-webkit-box;-webkit-line-clamp:2;-webkit-box-orient:vertical;overflow:hidden}.imp-sponsor{display:inline-flex;align-items:center;gap:7px;margin-top:10px;padding:5px 11px;border-radius:6px;max-width:100%;background:#00000073;border:1px solid rgba(255,255,255,.25);color:var(--imp-text);font-size:13px;font-weight:600;text-decoration:none;pointer-events:auto;transition:border-color var(--imp-transition),background var(--imp-transition)}.imp-sponsor:hover{border-color:var(--imp-accent);background:#0009}.imp-sponsor__label{flex-shrink:0;padding:1px 6px;border-radius:3px;background:var(--imp-accent);color:#fff;font-size:10px;font-weight:700;text-transform:uppercase;letter-spacing:.4px}.imp-sponsor__text{overflow:hidden;text-overflow:ellipsis;white-space:nowrap}@keyframes imp-fade-in{0%{opacity:0}}.imp-related{grid-area:middle;pointer-events:auto;align-self:stretch;display:flex;flex-direction:column;justify-content:center;gap:12px;padding:24px;background:#000c;animation:imp-fade-in .22s ease;z-index:2}.imp-related__close{align-self:flex-end}.imp-related__title{font-size:16px;font-weight:700}.imp-related__grid{display:grid;grid-template-columns:repeat(auto-fill,minmax(150px,1fr));gap:12px;overflow-y:auto}.imp-related__card{display:flex;flex-direction:column;gap:6px;border:0;padding:0;background:transparent;color:inherit;font:inherit;text-align:left;cursor:pointer}.imp-related__thumb{position:relative;aspect-ratio:16 / 9;border-radius:6px;background-color:#222;background-size:cover;background-position:center;transition:transform var(--imp-transition)}.imp-related__card:hover .imp-related__thumb{transform:scale(1.04)}.imp-related__duration{position:absolute;right:6px;bottom:6px;padding:1px 5px;border-radius:4px;background:#000c;font-size:11px;font-variant-numeric:tabular-nums}.imp-related__card-title{font-size:13px;font-weight:600;display:-webkit-box;-webkit-line-clamp:2;-webkit-box-orient:vertical;overflow:hidden}.imp-playlist{position:absolute;display:flex;flex-direction:column;background:var(--imp-control-bg);backdrop-filter:blur(8px);z-index:6;--imp-thumb-w: 88}.imp-playlist--sidebar{top:0;right:0;bottom:0;width:min(320px,80%);animation:imp-slide-in .2s ease}.imp-playlist--bottom{left:0;right:0;bottom:0;max-height:46%;animation:imp-slide-up .2s ease;--imp-thumb-w: 128}.imp-playlist--bottom .imp-playlist__list{flex-direction:row;overflow-x:auto;overflow-y:hidden;padding:0 12px 12px}.imp-playlist--bottom .imp-playlist__item{flex-direction:column;align-items:stretch;flex:0 0 calc(var(--imp-thumb-w) * 1px + 12px)}.imp-playlist--bottom .imp-playlist__thumb{flex:0 0 auto;width:calc(var(--imp-thumb-w) * 1px)}@keyframes imp-slide-up{0%{transform:translateY(100%)}}.imp-playlist__tools{display:flex;align-items:center;gap:2px}.imp-playlist__heading{min-width:0}.imp-playlist__kicker{font-size:11px;font-weight:400;text-transform:uppercase;letter-spacing:.6px;opacity:.6}.imp-playlist__name{font-size:15px;font-weight:700;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}@keyframes imp-slide-in{0%{transform:translate(100%)}}.imp-playlist__header{display:flex;align-items:center;justify-content:space-between;padding:12px 14px;font-weight:700}.imp-playlist__list{overflow-y:auto;display:flex;flex-direction:column;padding:0 8px 8px;gap:4px}.imp-playlist__item{display:flex;gap:10px;align-items:center;padding:6px;border:0;border-radius:6px;background:transparent;color:inherit;font:inherit;text-align:left;cursor:pointer}.imp-playlist__item:hover{background:#ffffff1a}.imp-playlist__item--active{background:#ffffff24;box-shadow:inset 2px 0 0 var(--imp-accent)}.imp-playlist__thumb{flex:0 0 calc(var(--imp-thumb-w) * 1px);aspect-ratio:16 / 9;border-radius:4px;background-color:#222;background-size:cover;background-position:center;overflow:hidden}.imp-scenes__sprite{background-repeat:no-repeat;transform:scale(calc(var(--imp-thumb-w) / var(--imp-sprite-w, 160)));transform-origin:top left}.imp-playlist__title{font-size:13px;font-weight:600;display:-webkit-box;-webkit-line-clamp:2;-webkit-box-orient:vertical;overflow:hidden}.imp-playlist__duration{font-size:12px;opacity:.7;font-variant-numeric:tabular-nums}.imp-ad{position:absolute;inset:0;display:grid;grid-template-rows:auto 1fr auto;background:var(--imp-bg);z-index:10}.imp-ad__video{grid-row:1 / -1;grid-column:1;width:100%;height:100%;object-fit:contain;cursor:pointer}.imp-ad__spinner{grid-row:2;grid-column:1;justify-self:center;align-self:center;pointer-events:none}.imp-ad__hud{grid-row:1;grid-column:1;display:flex;align-items:center;gap:10px;padding:12px 14px;pointer-events:none}.imp-ad__badge{padding:3px 8px;border-radius:4px;background:#000000b3;border:1px solid rgba(255,255,255,.4);font-size:12px;font-weight:700}.imp-ad__countdown{font-size:12px;font-variant-numeric:tabular-nums;text-shadow:0 1px 2px rgba(0,0,0,.8)}.imp-ad__actions{grid-row:3;grid-column:1;display:flex;justify-content:flex-end;align-items:center;gap:10px;padding:14px}.imp-ad__skip,.imp-ad__visit{border:1px solid rgba(255,255,255,.5);background:#000000bf;color:inherit;font:inherit;font-weight:600;padding:8px 14px;border-radius:6px;cursor:pointer}.imp-ad__skip:disabled{opacity:.7;cursor:default}.imp-ad__skip:hover:not(:disabled),.imp-ad__visit:hover{background:#fff3}.imp-ad--paused:after{content:"▶";position:absolute;inset:0;display:flex;align-items:center;justify-content:center;font-size:48px;background:#0006;pointer-events:none}@media(max-width:767px){.imp-btn{width:28px;height:28px;padding:5px}.imp-controls__row{gap:0;min-height:38px}.imp-controls__group{gap:0}.imp-layer__bottom{padding:12px 6px 5px}.imp-controls__chapter{display:none}.imp-btn--seek-back,.imp-btn--seek-forward{width:26px;height:26px;padding:5px;opacity:.75}.imp-progress{height:12px}.imp-controls__time,.imp-controls__live{font-size:10px;margin:0 3px}.imp-poster__play{width:48px;height:48px;padding:11px}.imp-spinner{width:36px;height:36px;border-width:3px}.imp-pause-screen{padding:8px 10px}.imp-pause-screen__default{align-items:flex-start;gap:8px}.imp-pause-screen__title{font-size:13px;white-space:nowrap;overflow:hidden;text-overflow:ellipsis;margin-bottom:0}.imp-pause-screen__description{display:none}.imp-channel{align-self:flex-start}.imp-channel__name{display:none}.imp-channel__avatar{width:32px;height:32px}.imp-sponsor{margin-top:6px;padding:4px 8px;font-size:11px;gap:5px}.imp-sponsor__label{font-size:9px}.imp-ad__hud{padding:8px 10px;gap:6px}.imp-ad__badge{font-size:10px;padding:2px 6px}.imp-ad__countdown{font-size:11px}.imp-ad__actions{padding:8px;gap:6px}.imp-ad__skip,.imp-ad__visit{padding:6px 10px;font-size:12px}.imp-ad--paused:after{font-size:36px}.imp-controls__menu-anchor{position:static}.imp-menu{position:absolute;inset:auto 0 0;box-sizing:border-box;min-width:0;max-width:none;max-height:80%;overflow-y:auto;border-radius:var(--imp-radius) var(--imp-radius) 0 0;padding:6px 8px calc(6px + env(safe-area-inset-bottom,0px));box-shadow:0 -8px 24px #00000080;animation:imp-slide-up .18s ease;z-index:6}.imp-menu__backdrop{display:block;position:absolute;inset:0;background:#00000080;pointer-events:auto;z-index:5;animation:imp-fade-in .18s ease}.imp-menu__item{padding:10px}.imp-playlist{inset:0;width:auto;max-height:none;border-radius:0;animation:imp-fade-in .18s ease}.imp-playlist--bottom .imp-playlist__list,.imp-playlist__list{flex-direction:column;overflow-x:hidden;overflow-y:auto}.imp-playlist--bottom .imp-playlist__item{flex-direction:row;align-items:center;flex:0 0 auto}.imp-playlist--bottom .imp-playlist__thumb,.imp-playlist__thumb{flex:0 0 120px;width:120px}}

package/dist/types.d.ts

@@ -0,0 +1,443 @@
+/**
+ * Public types of itube-modern-player.
+ * Everything here is re-exported from the package root.
+ */
+/** A subtitle / captions track attached to a video. */
+export interface SubtitleTrack {
+    /** URL of a WebVTT file. */
+    src: string;
+    /** Human readable label shown in the subtitles menu. */
+    label: string;
+    /** BCP-47 language tag, e.g. `"en"`, `"ru"`. */
+    srclang?: string;
+    /** Enable this track by default. */
+    default?: boolean;
+}
+/** A single chapter / time-code on the timeline. */
+export interface Chapter {
+    /** Start time in seconds. */
+    start: number;
+    /** End time in seconds. Defaults to the start of the next chapter (or video end). */
+    end?: number;
+    /** Chapter title shown in the seek tooltip and the chapter label. */
+    title: string;
+}
+/** An alternative quality rendition for progressive (non-HLS) sources. */
+export interface QualityLevel {
+    /** Stream / file URL for this rendition. */
+    src: string;
+    /** Label shown in the quality menu, e.g. `"1080p"`. Falls back to `quality`. */
+    label?: string;
+    /** Quality value, e.g. `1080` or `"hd"` — used as the label when `label` is omitted. */
+    quality?: string | number;
+    type?: string;
+}
+/** Channel / author info, rendered in the pause-screen header. */
+export interface ChannelInfo {
+    name: string;
+    /** Avatar image URL. Without it a styled first-letter placeholder is rendered. */
+    avatar?: string;
+    /** Clicking the channel block opens this URL in a new tab. */
+    url?: string;
+    /** Avatar shape. Default `"circle"`. */
+    avatarShape?: 'circle' | 'rounded' | 'square';
+}
+/**
+ * Sponsor / promo link shown under the description on the pause screen.
+ * Only rendered when present — pass it only for sponsored videos.
+ */
+export interface SponsorLink {
+    /** Click-through URL (opens in a new tab, `rel="nofollow noopener"`). */
+    url: string;
+    /** Link text, e.g. the sponsor name. */
+    text: string;
+    /** Small badge before the text. Defaults to the localized "Sponsored" label. */
+    label?: string;
+}
+/** Custom styling knobs. Extensible — more keys will land here over time. */
+export interface StylingOptions {
+    /** Accent color (progress fill, big play button, active menu items). Overrides the built-in red. */
+    themeColor?: string;
+    /** Color of the active like button. Default `forestgreen`. */
+    likeColor?: string;
+    /** Color of the active dislike button. Default the built-in red (independent from themeColor). */
+    dislikeColor?: string;
+}
+/** Everything the player knows about one video. */
+export interface VideoSource {
+    /** Media URL. `.m3u8` is detected automatically and routed through hls.js. */
+    src: string;
+    /** Explicit MIME type, e.g. `"application/x-mpegurl"` or `"video/mp4"`. */
+    type?: string;
+    title?: string;
+    description?: string;
+    /** Poster image, also used as the preview poster before the first play. */
+    poster?: string;
+    /** Duration in seconds — used in playlist UI before metadata is loaded. */
+    duration?: number;
+    /** URL of a WebVTT file describing preview thumbnails (sprite via `#xywh=`). */
+    thumbnails?: string;
+    /**
+     * Subtitles: a bare VTT URL, a single track, or an array of tracks.
+     * All tracks start disabled unless one has `default: true`.
+     */
+    subtitles?: string | SubtitleTrack | SubtitleTrack[];
+    /** Channel/author shown in the pause screen. */
+    channel?: ChannelInfo;
+    /** Sponsor/promo link under the description (pause screen). Only for sponsored videos. */
+    sponsor?: SponsorLink;
+    /** Chapters as an array, or a URL of a WebVTT chapters file. */
+    chapters?: Chapter[] | string;
+    /** Alternative renditions for progressive sources. Ignored for HLS (levels come from the manifest). */
+    qualities?: QualityLevel[];
+    /**
+     * Popularity samples for the heatmap above the progress bar (YouTube-style
+     * "most replayed"). Sparse — only the moments you have data for.
+     */
+    heatmap?: HeatmapPoint[];
+    /** Free-form user data, carried around untouched. */
+    meta?: Record<string, unknown>;
+}
+/** An item in the related-videos grid. */
+export interface RelatedItem {
+    title: string;
+    poster?: string;
+    /** Pre-formatted duration badge, e.g. `"12:34"`. */
+    duration?: string;
+    /** If set, clicking the item loads this source into the player. */
+    source?: VideoSource;
+    /** If set, clicking the item navigates to this URL instead. */
+    url?: string;
+    meta?: Record<string, unknown>;
+}
+export interface RelatedOptions {
+    items: RelatedItem[];
+    /** When to show the grid. Default: `["ended"]`. */
+    showOn?: Array<'pause' | 'ended'>;
+    /** Heading above the grid. */
+    title?: string;
+}
+/** One ad insertion, fluid-player compatible shape. */
+export interface AdRoll {
+    roll: 'preRoll' | 'midRoll' | 'postRoll';
+    /** URL of a VAST XML tag. */
+    vastTag?: string;
+    /** Direct media file URL — a minimal alternative to VAST. */
+    src?: string;
+    /** For midRoll: playback second at which the ad fires. */
+    timer?: number;
+    /** Click-through URL when `src` is used instead of VAST. */
+    clickUrl?: string;
+}
+export interface AdsOptions {
+    adList: AdRoll[];
+    /** Seconds before the skip button appears. VAST `skipoffset` wins if present. Default 5; `-1` disables skipping. */
+    skipDelay?: number;
+    /** Max VAST wrapper redirects to follow. Default 3. */
+    maxWrapperDepth?: number;
+    /** Request timeout for VAST tags, ms. Default 8000. */
+    requestTimeout?: number;
+    /**
+     * Watchdog for the ad media itself, ms. If the creative does not start (or
+     * stalls mid-play) for this long, the ad is dropped with `aderror` and
+     * content resumes. Default 10000.
+     */
+    mediaTimeout?: number;
+    /**
+     * Playlist behaviour: `"every"` (default) runs the ad list for every video,
+     * `"first"` runs it only for the first video that plays.
+     */
+    playOn?: 'every' | 'first';
+}
+/** A consumer-defined entry in the ⋯ actions dropdown. */
+export interface CustomAction {
+    id: string;
+    title: string;
+    /** Icon: image URL or raw `<svg>` markup. Optional. */
+    icon?: string;
+}
+export type BuiltinActionId = 'like' | 'dislike' | 'addTo' | 'share' | 'report';
+/**
+ * Social action buttons. Everything is OFF by default.
+ * `like`/`dislike` render as visible buttons; `addTo`/`share`/`report` and
+ * all `custom` entries live in a ⋯ dropdown on the right.
+ */
+export interface ActionsOptions {
+    like?: boolean;
+    dislike?: boolean;
+    /** Initial rating state — highlights the corresponding button. Change later via `player.setLikeState()`. */
+    likeState?: 'like' | 'dislike' | null;
+    /** Initial like count, shown as a tooltip above the button. Update later via `player.setLikeCounts()`. */
+    likeCount?: number | string;
+    /** Initial dislike count, shown as a tooltip above the button. */
+    dislikeCount?: number | string;
+    addTo?: boolean;
+    /**
+     * Share: uses the device's native share sheet (`navigator.share`) when
+     * available, otherwise emits the `action` event with `id: "share"`.
+     */
+    share?: boolean;
+    report?: boolean;
+    /** Extra dropdown entries. Click emits `customaction` with the entry id. */
+    custom?: CustomAction[];
+}
+export interface ControlsOptions {
+    play?: boolean;
+    progress?: boolean;
+    time?: boolean;
+    volume?: boolean;
+    fullscreen?: boolean;
+    pip?: boolean;
+    /** Playback-speed menu (speedometer icon). */
+    settings?: boolean;
+    /** Quality menu (gear icon). OFF by default; needs `source.qualities` or an HLS source. */
+    quality?: boolean;
+    /** Scene list button — appears when the source has chapters. Default true. */
+    scenes?: boolean;
+    /** Popularity heatmap above the progress bar (needs `source.heatmap` data). Default true. */
+    heatmap?: boolean;
+    subtitles?: boolean;
+    /** Skip-back / skip-forward buttons. Pass an object to change the step (seconds). */
+    seekButtons?: boolean | {
+        back?: number;
+        forward?: number;
+    };
+    /** Previous / next / list buttons (only rendered when a playlist is present). */
+    playlist?: boolean;
+    /** ms of pointer inactivity before controls fade out during playback. Default 2500. */
+    hideDelay?: number;
+}
+export interface PlaylistOptions {
+    /** Playlist name shown in the panel header under a small "Playlist" kicker. */
+    title?: string;
+    /** Automatically start the next item when one ends. Default true. */
+    autoAdvance?: boolean;
+    /** Repeat: jump from the last item back to the first. Default false. Toggleable in the UI. */
+    loop?: boolean;
+    /** Shuffle: auto-advance picks a random item. Default false. Toggleable in the UI. */
+    shuffle?: boolean;
+    startIndex?: number;
+    /** Panel placement: `"sidebar"` (right, default) or `"bottom"` (horizontal strip). */
+    layout?: 'sidebar' | 'bottom';
+}
+/** Scene (chapter) list panel — timecodes with sprite previews. */
+export interface ScenesOptions {
+    /** Panel placement. Default `"bottom"`. */
+    layout?: 'sidebar' | 'bottom';
+}
+/** Every visible string, overridable for i18n. */
+export interface PlayerLabels {
+    play: string;
+    pause: string;
+    replay: string;
+    mute: string;
+    unmute: string;
+    fullscreen: string;
+    exitFullscreen: string;
+    pip: string;
+    settings: string;
+    subtitles: string;
+    subtitlesOff: string;
+    speed: string;
+    quality: string;
+    qualityAuto: string;
+    next: string;
+    previous: string;
+    playlist: string;
+    scenes: string;
+    shuffle: string;
+    repeat: string;
+    like: string;
+    dislike: string;
+    addTo: string;
+    share: string;
+    report: string;
+    more: string;
+    seekForward: string;
+    seekBack: string;
+    live: string;
+    related: string;
+    adLabel: string;
+    skipAd: string;
+    skipAdIn: string;
+    visitAdvertiser: string;
+    sponsored: string;
+}
+/** SVG icon overrides — raw `<svg>` markup keyed by icon name. */
+export type IconName = 'play' | 'pause' | 'replay' | 'bigPlay' | 'volumeHigh' | 'volumeLow' | 'volumeMute' | 'fullscreen' | 'fullscreenExit' | 'pip' | 'settings' | 'speed' | 'subtitles' | 'list' | 'scenes' | 'next' | 'previous' | 'seekForward' | 'seekBack' | 'shuffle' | 'repeat' | 'like' | 'dislike' | 'addTo' | 'share' | 'report' | 'more' | 'close';
+export interface PlayerOptions {
+    /** Single source or an array (an array enables playlist mode). */
+    source?: VideoSource | VideoSource[];
+    playlist?: PlaylistOptions;
+    autoplay?: boolean;
+    muted?: boolean;
+    loop?: boolean;
+    /** 0..1 */
+    volume?: number;
+    /** Playback-rate choices for the settings menu. Default `[0.5, 0.75, 1, 1.25, 1.5, 2]`. */
+    playbackRates?: number[];
+    /** Seconds for keyboard / double-tap / button seeking. Default 10. */
+    seekStep?: number;
+    /** Enable keyboard shortcuts on the player container. Default true. */
+    keyboard?: boolean;
+    controls?: ControlsOptions;
+    /**
+     * Pause-screen "slot". `true` renders the default title/description overlay,
+     * an element or a factory lets you inject arbitrary markup.
+     */
+    pauseScreen?: boolean | HTMLElement | ((player: unknown) => HTMLElement);
+    related?: RelatedOptions;
+    /** Ad configuration: pre/mid/post rolls, skip timer, playlist frequency. */
+    adConfig?: AdsOptions;
+    /** @deprecated use `adConfig` */
+    ads?: AdsOptions;
+    /** Like/dislike/share/… buttons. All off unless enabled. */
+    actions?: ActionsOptions;
+    /** Custom styling (accent / like / dislike colors). */
+    styling?: StylingOptions;
+    /** Scene list panel configuration. */
+    scenes?: ScenesOptions;
+    /**
+     * UI language — picks one of the built-in static locales.
+     * Individual strings can still be overridden via `labels`.
+     */
+    language?: LocaleCode;
+    labels?: Partial<PlayerLabels>;
+    icons?: Partial<Record<IconName, string>>;
+    /** Extra class added to the player container — hook for external theming. */
+    className?: string;
+    /** `crossorigin` attribute for the video element (needed for canvas/VTT on other origins). */
+    crossOrigin?: '' | 'anonymous' | 'use-credentials';
+    /** Inline playback on iOS. Default true. */
+    playsInline?: boolean;
+}
+/** A single popularity sample: how often users sought/replayed near `time`. */
+export interface HeatmapPoint {
+    /** Position in seconds. Does not have to cover every second — sparse data is fine. */
+    time: number;
+    /** Raw popularity value (clicks, replays, views) — normalized internally. */
+    value: number;
+}
+/** Supported UI languages. */
+export type LocaleCode = 'en' | 'ru' | 'de' | 'es' | 'it' | 'ja' | 'ko' | 'zh' | 'pt' | 'ar' | 'hi';
+/** Parsed preview-thumbnail cue. */
+export interface ThumbnailCue {
+    start: number;
+    end: number;
+    /** Absolute image URL. */
+    src: string;
+    /** Sprite region; undefined when the cue points at a whole image. */
+    xywh?: {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    };
+}
+/** A resolved, playable ad (after VAST unwrapping). */
+export interface ResolvedAd {
+    roll: AdRoll['roll'];
+    mediaUrl: string;
+    mediaType?: string;
+    clickThrough?: string;
+    duration?: number;
+    /** Seconds until skippable; undefined → use AdsOptions.skipDelay. */
+    skipOffset?: number;
+    impressions: string[];
+    tracking: Partial<Record<'start' | 'firstQuartile' | 'midpoint' | 'thirdQuartile' | 'complete' | 'skip' | 'click' | 'pause' | 'resume', string[]>>;
+    adTitle?: string;
+}
+/** Map of every event the player emits → its payload. */
+export interface PlayerEventMap {
+    ready: {
+        player: unknown;
+    };
+    play: undefined;
+    pause: undefined;
+    ended: undefined;
+    timeupdate: {
+        currentTime: number;
+        duration: number;
+    };
+    progress: {
+        buffered: number;
+    };
+    volumechange: {
+        volume: number;
+        muted: boolean;
+    };
+    ratechange: {
+        rate: number;
+    };
+    seeking: {
+        currentTime: number;
+    };
+    seeked: {
+        currentTime: number;
+    };
+    sourcechange: {
+        source: VideoSource;
+        index: number;
+    };
+    playlistitemchange: {
+        source: VideoSource;
+        index: number;
+    };
+    chapterchange: {
+        chapter: Chapter | null;
+    };
+    fullscreenchange: {
+        active: boolean;
+    };
+    pipchange: {
+        active: boolean;
+    };
+    qualitychange: {
+        label: string;
+    };
+    subtitlechange: {
+        track: SubtitleTrack | null;
+    };
+    relatedshow: undefined;
+    relatedclick: {
+        item: RelatedItem;
+    };
+    /** A built-in action button was clicked (share only when native sharing is unavailable). */
+    action: {
+        id: BuiltinActionId;
+    };
+    /** A consumer-defined dropdown entry was clicked. */
+    customaction: {
+        id: string;
+    };
+    adstart: {
+        ad: ResolvedAd;
+    };
+    adend: {
+        ad: ResolvedAd;
+    };
+    adskip: {
+        ad: ResolvedAd;
+    };
+    adclick: {
+        ad: ResolvedAd;
+    };
+    /** The ad creative was paused (click-through, user tap, autoplay block). */
+    adpause: {
+        ad: ResolvedAd;
+    };
+    /** The ad creative resumed after a pause. */
+    adresume: {
+        ad: ResolvedAd;
+    };
+    aderror: {
+        roll: AdRoll;
+        error: Error;
+    };
+    error: {
+        message: string;
+        cause?: unknown;
+    };
+    destroy: undefined;
+}
+export type PlayerEvent = keyof PlayerEventMap;