streamit-player 1.0.0

package/dist/web-components/src/VolumeControl.styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VolumeControl.styles.d.ts","sourceRoot":"","sources":["../../../web-components/src/VolumeControl.styles.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,MAAM,yBAwLlB,CAAC"}

package/dist/web-components/src/icons/IconRegistry.d.ts

@@ -0,0 +1,24 @@
+import { TemplateResult } from 'lit';
+import { DirectiveResult } from 'lit/directive.js';
+import { UnsafeSVGDirective } from 'lit/directives/unsafe-svg.js';
+
+export type IconName = 'play' | 'pause' | 'replay' | 'loading' | 'volume' | 'volume-mute' | 'volume-low' | 'volume-medium' | 'settings' | 'settings-vertical' | 'fullscreen' | 'fullscreen-exit' | 'pip' | 'captions' | 'seek-backward' | 'seek-forward' | 'live' | 'playlist-prev' | 'playlist-next' | 'chapters' | 'markers' | 'arrow-back' | 'arrow-forward' | 'check' | 'audio-only' | 'speed-feedback';
+export type IconValue = string | TemplateResult | Element | ((params?: Record<string, unknown>) => string | TemplateResult | Element);
+export declare class IconRegistry {
+    private static globalPacks;
+    private static defaultIcons;
+    static registerDefaultIcon(name: IconName, value: IconValue): void;
+    static registerIconPack(packName: string, pack: Record<string, IconValue>): void;
+    static getGlobalPack(packName: string): Record<string, IconValue> | undefined;
+    static getDefaultIcon(name: IconName): IconValue | undefined;
+}
+export declare class PlayerIconRegistry {
+    private overrides;
+    private activePack;
+    constructor(configIcons?: Record<string, IconValue>, packName?: string);
+    setIcon(name: IconName, value: IconValue): void;
+    useIconPack(packName: string): void;
+    getIcon(name: IconName, params?: Record<string, unknown>): string | TemplateResult | Element;
+}
+export declare function renderIcon(value: IconValue): string | TemplateResult | Element | DirectiveResult<typeof UnsafeSVGDirective>;
+//# sourceMappingURL=IconRegistry.d.ts.map

package/dist/web-components/src/icons/IconRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IconRegistry.d.ts","sourceRoot":"","sources":["../../../../web-components/src/icons/IconRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,cAAc,EAAE,MAAM,KAAK,CAAC;AAG3C,MAAM,MAAM,QAAQ,GAChB,MAAM,GACN,OAAO,GACP,QAAQ,GACR,SAAS,GACT,QAAQ,GACR,aAAa,GACb,YAAY,GACZ,eAAe,GACf,UAAU,GACV,mBAAmB,GACnB,YAAY,GACZ,iBAAiB,GACjB,KAAK,GACL,UAAU,GACV,eAAe,GACf,cAAc,GACd,MAAM,GACN,eAAe,GACf,eAAe,GACf,UAAU,GACV,SAAS,GACT,YAAY,GACZ,eAAe,GACf,OAAO,GACP,YAAY,GACZ,gBAAgB,CAAC;AAErB,MAAM,MAAM,SAAS,GACjB,MAAM,GACN,cAAc,GACd,OAAO,GACP,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,GAAG,cAAc,GAAG,OAAO,CAAC,CAAC;AAE9E,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAC,WAAW,CAAgD;IAC1E,OAAO,CAAC,MAAM,CAAC,YAAY,CAAkC;WAE/C,mBAAmB,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS;WAIpD,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC;WAIlE,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,SAAS;WAItE,cAAc,CAAC,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,SAAS;CAGpE;AAED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,SAAS,CAAkC;IACnD,OAAO,CAAC,UAAU,CAA0C;gBAEhD,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,QAAQ,CAAC,EAAE,MAAM;IAW/D,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS;IAIxC,WAAW,CAAC,QAAQ,EAAE,MAAM;IAO5B,OAAO,CACZ,IAAI,EAAE,QAAQ,EACd,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,MAAM,GAAG,cAAc,GAAG,OAAO;CAgBrC;AAED,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAElE,wBAAgB,UAAU,CACxB,KAAK,EAAE,SAAS,GACf,MAAM,GAAG,cAAc,GAAG,OAAO,GAAG,eAAe,CAAC,OAAO,kBAAkB,CAAC,CAQhF"}

package/dist/web-components/src/index.d.ts

@@ -0,0 +1,10 @@
+export { PlayerPlayer } from './Player';
+export { PlayerPlayButton } from './PlayButton';
+export { PlayerSeekbar } from './Seekbar';
+export { PlayerVolumeControl } from './VolumeControl';
+export { PlayerSeekButton } from './SeekButton';
+export { PlayerChaptersButton } from './ChaptersButton';
+export { PlayerVerticalControls } from './VerticalControls';
+export { THEME_PRESETS, compileTheme } from './Themes';
+export * from './icons/IconRegistry';
+//# sourceMappingURL=index.d.ts.map

package/dist/web-components/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../web-components/src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACvD,cAAc,sBAAsB,CAAC"}

package/dist/web-components/src/player-internals/GestureController.d.ts

@@ -0,0 +1,140 @@
+import { PlayerConfiguration, PlayerController, PlayerState } from '../../../core/src/index';
+import { PrefetchController } from './PrefetchController';
+import { SettingsMenuController } from './SettingsMenuController';
+import { ThumbnailCache } from './ThumbnailCache';
+
+export type SpeedLockState = 'IDLE' | 'HOLDING' | 'READY_TO_LOCK' | 'LOCKED' | 'LOCKED_HOLDING' | 'READY_TO_UNLOCK';
+/**
+ * The slice of the `<player-player>` element the gesture layer drives.
+ *
+ * It extends HTMLElement because the gestures are bound to the host itself
+ * (wheel / swipe) as well as to the inner <video>. Everything reactive that a
+ * gesture writes (`speedLockState`, `isVisualTransitioning`, ...) stays a Lit
+ * `@state()` on the element; this controller owns the transitions between those
+ * values, not their storage.
+ */
+export interface GestureHost extends HTMLElement {
+    readonly playerState: PlayerState;
+    readonly controller: PlayerController;
+    config?: PlayerConfiguration;
+    displayMode: 'standard' | 'vertical' | 'audio-only' | 'custom' | 'mini' | 'floating';
+    readonly videoElement: HTMLVideoElement;
+    readonly updateComplete: Promise<boolean>;
+    isVisualTransitioning: boolean;
+    transitionDirection: 'next' | 'prev';
+    transitionStage: 'idle' | 'start' | 'active';
+    speedLockState: SpeedLockState;
+    isSpeedOverlayFadingOut: boolean;
+    activeSpeedFeedback: number | null;
+    speedFeedbackTimer?: number;
+    suppressPlayPauseFeedback: boolean;
+    shouldAutoplayAfterTransition: boolean;
+    readonly thumbnailCache: ThumbnailCache;
+    readonly prefetch: PrefetchController;
+    readonly settingsMenu: SettingsMenuController;
+    requestUpdate(): void;
+    handleActivity(): void;
+    handleReplay(): void;
+    showFeedbackOverlay(type: 'rewind' | 'fastforward'): void;
+    isOverlayEnabled(id: string): boolean;
+    next(): void;
+    previous(): void;
+}
+/**
+ * Pointer/touch gestures for the player surface, plus the canvas double-buffer
+ * transition that vertical-feed navigation animates through.
+ *
+ * Gestures owned here:
+ *  - long-press-to-speed, including its IDLE -> HOLDING -> READY_TO_LOCK ->
+ *    LOCKED -> LOCKED_HOLDING -> READY_TO_UNLOCK lock/unlock state machine
+ *  - double-tap-to-seek (and the single-tap play toggle it defers to)
+ *  - horizontal drag to scrub / vertical drag on the right half to set volume
+ *  - swipe- and wheel-to-navigate between playlist items
+ *
+ * The transition lives here too because the swipe gesture drives it directly: a
+ * drag paints the outgoing and incoming frames into one double-height canvas
+ * and translates it under the finger, then either commits (switching the
+ * source) or springs back.
+ *
+ * Every DOM listener is an arrow-function property, so attach() and detach()
+ * add and remove the exact same reference.
+ */
+export declare class GestureController {
+    private readonly host;
+    private gestureState;
+    private gestureStartX;
+    private gestureStartY;
+    private gestureLastTapTime;
+    private gestureSingleTapTimer;
+    private gestureLongPressTimer;
+    private gestureIsRightSide;
+    private gestureStartVolume;
+    private gestureActiveDrag;
+    private gestureStartTimeVal;
+    private gestureLastTouchType;
+    private isLongPressSpeedActiveInternal;
+    private preLongPressPlaybackRate;
+    private touchStartY;
+    private touchStartX;
+    private touchDeltaY;
+    private isTouchActive;
+    private lastFeedTransitionTime;
+    private isTransitionLockedInternal;
+    private isDragPreviewActive;
+    private dragPreviewDirection;
+    private dragPreviewCanvasHeight;
+    private dragCanvasEl;
+    private dragPreviewPending;
+    constructor(host: GestureHost);
+    /** True while a long-press speed change is active (suppresses tap handling). */
+    get isLongPressSpeedActive(): boolean;
+    /** True while a feed transition is animating; blocks concurrent navigation. */
+    get isTransitionLocked(): boolean;
+    /** Binds wheel + mouse + touch gestures. Mirrored exactly by detach(). */
+    attach(): void;
+    /** Removes every listener attach() added and clears pending gesture timers. */
+    detach(): void;
+    private isTransitionAnimationFinished;
+    private cleanupReadyListener?;
+    private drawFrame;
+    private prepareTransitionFrames;
+    initiateVisualTransition(direction: 'next' | 'prev', loadSourceCallback: () => void): void;
+    private cleanupTransitionListeners?;
+    private onTransitionAnimationEnd;
+    checkTransitionCompletion(): void;
+    endVisualTransition(): void;
+    throttleTransition(callback: () => void): void;
+    /**
+     * Starts a live drag-follow preview: the incoming video's cached thumbnail
+     * slides in tracking the finger, mirroring Reels/Shorts drag behavior.
+     * The canvas is left in transitionStage 'idle' (which has no matching CSS
+     * transform/transition rule) so it is driven purely by inline styles here.
+     */
+    private beginDragPreview;
+    /** Moves the drag-preview canvas to follow the given raw touch deltaY. */
+    private updateDragPreview;
+    /** Finger lifted past the threshold: animate the rest of the way and commit the switch. */
+    private completeDragPreview;
+    /** Finger lifted without passing the threshold: spring the preview back and cancel. */
+    private cancelDragPreview;
+    private handleWheel;
+    private handleVideoDown;
+    private handleVideoMove;
+    private handleVideoUp;
+    private handleVideoTouchStart;
+    private handleVideoTouchMove;
+    private handleVideoTouchEnd;
+    private handleVideoTouchCancel;
+    private handleVideoMouseDown;
+    private handleVideoMouseMove;
+    private handleVideoMouseUp;
+    private handleVideoMouseLeave;
+    private triggerLongPressEnd;
+    private triggerSingleTap;
+    private triggerDoubleTap;
+    private isTouchOnInteractiveElement;
+    private handleTouchStart;
+    private handleTouchMove;
+    private handleTouchEnd;
+}
+//# sourceMappingURL=GestureController.d.ts.map

package/dist/web-components/src/player-internals/GestureController.d.ts.map

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

package/dist/web-components/src/player-internals/PrefetchController.d.ts

@@ -0,0 +1,34 @@
+import { PlayerState } from '../../../core/src/index';
+
+/**
+ * The narrow slice of the `<player-player>` element the prefetcher reads: the
+ * current player state (playlist, active index, status, current source) and
+ * whether a vertical-feed transition is animating.
+ */
+export interface PrefetchHost {
+    readonly playerState: PlayerState;
+    readonly isVisualTransitioning: boolean;
+}
+/**
+ * Idle-callback-scheduled prefetching of the next (or previous) playlist
+ * source, so switching items in a vertical feed starts from a warm cache.
+ *
+ * Only one prefetch is in flight at a time; it is aborted whenever the target
+ * changes, and deliberately *not* aborted when the target is the source that
+ * just became active (aborting then would cancel a request the media element
+ * is about to reuse).
+ */
+export declare class PrefetchController {
+    private readonly host;
+    private direction;
+    private abortController;
+    private activeUrl;
+    constructor(host: PrefetchHost);
+    /** Which neighbour to warm next; set by navigation and drag commits. */
+    setDirection(direction: 'next' | 'prev'): void;
+    getDirection(): 'next' | 'prev';
+    cancel(keepUrl?: string): void;
+    trigger(): void;
+    private execute;
+}
+//# sourceMappingURL=PrefetchController.d.ts.map

package/dist/web-components/src/player-internals/PrefetchController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PrefetchController.d.ts","sourceRoot":"","sources":["../../../../web-components/src/player-internals/PrefetchController.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAc,MAAM,yBAAyB,CAAC;AAEvE;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,CAAC,qBAAqB,EAAE,OAAO,CAAC;CACzC;AAED;;;;;;;;GAQG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAe;IACpC,OAAO,CAAC,SAAS,CAA2B;IAC5C,OAAO,CAAC,eAAe,CAAgC;IACvD,OAAO,CAAC,SAAS,CAAM;gBAEX,IAAI,EAAE,YAAY;IAI9B,wEAAwE;IACxE,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAI9C,YAAY,IAAI,MAAM,GAAG,MAAM;IAI/B,MAAM,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAqB9B,OAAO,IAAI,IAAI;YAmFD,OAAO;CAuEtB"}

package/dist/web-components/src/player-internals/SettingsMenuController.d.ts

@@ -0,0 +1,59 @@
+/**
+ * The narrow slice of the `<player-player>` element the settings menu needs.
+ * `settingsMenuOpen` / `activeMenuScreen` stay on the element itself because
+ * they are Lit `@state()` properties that both `render()` and `updated()`
+ * (via `changedProperties`) depend on; this controller owns the transitions
+ * between them, not their storage.
+ */
+export interface SettingsMenuHost {
+    settingsMenuOpen: boolean;
+    activeMenuScreen: string;
+    readonly shadowRoot: ShadowRoot | null;
+    handleActivity(): void;
+    getDeepActiveElement(): Element | null;
+    requestUpdate(): void;
+}
+/**
+ * The multi-screen settings menu stack: which screen is showing, how the user
+ * moves between screens, and the focus management that goes with it.
+ *
+ * Every handler that a Lit template binds directly (`@click=${...}`) is an
+ * arrow-function property, because Lit invokes a bound listener with the host
+ * *element* as `this` - a plain method would lose this controller.
+ *
+ * The screens themselves are still rendered by `Player.ts`: their templates are
+ * built from `html` tagged literals that read player state, icons and
+ * localization, so splitting them out would only move the coupling around.
+ */
+export declare class SettingsMenuController {
+    private readonly host;
+    private lastFocusedSettingsButton;
+    constructor(host: SettingsMenuHost);
+    get isOpen(): boolean;
+    get activeScreen(): string;
+    /** Opens the menu on a given screen without touching focus. */
+    open: (screen?: string) => void;
+    close: () => void;
+    /** Navigates to a sub-screen of the currently open menu. */
+    goTo: (screen: string) => void;
+    backToMain: () => void;
+    /** Settings button click / `player-settings-toggle`: opens or closes the menu. */
+    toggle: () => void;
+    /** Enter/Space on a menu row behaves like a click. */
+    handleItemKey: (e: KeyboardEvent) => void;
+    getAriaLabel(): string;
+    /** The settings button, which lives in the standard bar or in the vertical rail. */
+    getSettingsButton(): HTMLElement | null;
+    /**
+     * Keyboard navigation while the menu is open. Returns true when the event was
+     * consumed and the caller must stop processing it.
+     */
+    handleKeyDown(e: KeyboardEvent, deepActiveEl: Element | null): boolean;
+    /** Closes the menu when a click / focus lands outside of it. */
+    closeIfOutside(e: Event): void;
+    /** `updated()` hook: move focus to the first row of a newly shown screen. */
+    onScreenChanged(): void;
+    /** `updated()` hook: restore focus to the settings button once the menu closes. */
+    onOpenStateChanged(wasOpen: boolean | undefined): void;
+}
+//# sourceMappingURL=SettingsMenuController.d.ts.map

package/dist/web-components/src/player-internals/SettingsMenuController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SettingsMenuController.d.ts","sourceRoot":"","sources":["../../../../web-components/src/player-internals/SettingsMenuController.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;IACvC,cAAc,IAAI,IAAI,CAAC;IACvB,oBAAoB,IAAI,OAAO,GAAG,IAAI,CAAC;IACvC,aAAa,IAAI,IAAI,CAAC;CACvB;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAmB;IACxC,OAAO,CAAC,yBAAyB,CAA4B;gBAEjD,IAAI,EAAE,gBAAgB;IAIlC,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,+DAA+D;IAC/D,IAAI,GAAI,SAAQ,MAAe,KAAG,IAAI,CAGpC;IAEF,KAAK,QAAO,IAAI,CAEd;IAEF,4DAA4D;IAC5D,IAAI,GAAI,QAAQ,MAAM,KAAG,IAAI,CAE3B;IAEF,UAAU,QAAO,IAAI,CAEnB;IAEF,kFAAkF;IAClF,MAAM,QAAO,IAAI,CAgBf;IAEF,sDAAsD;IACtD,aAAa,GAAI,GAAG,aAAa,KAAG,IAAI,CAKtC;IAEF,YAAY,IAAI,MAAM;IAetB,oFAAoF;IACpF,iBAAiB,IAAI,WAAW,GAAG,IAAI;IAWvC;;;OAGG;IACH,aAAa,CAAC,CAAC,EAAE,aAAa,EAAE,YAAY,EAAE,OAAO,GAAG,IAAI,GAAG,OAAO;IAmFtE,gEAAgE;IAChE,cAAc,CAAC,CAAC,EAAE,KAAK,GAAG,IAAI;IAa9B,6EAA6E;IAC7E,eAAe,IAAI,IAAI;IAevB,mFAAmF;IACnF,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,GAAG,IAAI;CAgBvD"}

package/dist/web-components/src/player-internals/ThumbnailCache.d.ts

@@ -0,0 +1,64 @@
+import { PlayerController, PlayerState, ThumbnailProvider } from '../../../core/src/index';
+
+/**
+ * The narrow slice of the `<player-player>` element that the thumbnail cache
+ * reads. Deliberately not the whole element: the cache only needs the current
+ * player state, the headless controller (to reach the active thumbnail
+ * provider), and whether a vertical-feed transition is currently animating.
+ */
+export interface ThumbnailCacheHost {
+    readonly playerState: PlayerState;
+    readonly controller: PlayerController | undefined;
+    readonly isVisualTransitioning: boolean;
+}
+/**
+ * The public `ThumbnailProvider` contract from `@player/core`, plus the
+ * implementation-detail members every concrete provider happens to expose
+ * (the hidden `<video>` element used for frame capture, and a one-time flag
+ * marking that this cache has already expanded its preload schedule) but
+ * which aren't part of the public interface.
+ */
+interface CachedThumbnailProvider extends ThumbnailProvider {
+    video?: HTMLVideoElement | null;
+    _preloadedIntervalsAdded?: boolean;
+}
+/**
+ * Thumbnail provider cache + idle-callback-scheduled preloading for the
+ * playlist neighbours of the active item.
+ *
+ * Eviction policy (unchanged from the original inline implementation):
+ *  - With no playlist (or a single item), every cached provider except the one
+ *    for the active source is destroyed and dropped.
+ *  - With a playlist, only the active / next / previous sources are kept; every
+ *    other provider is destroyed and dropped.
+ *  - The controller's own "main" provider is never destroyed by an eviction,
+ *    only removed from the map.
+ */
+export declare class ThumbnailCache {
+    private readonly host;
+    private providers;
+    private mainProvider;
+    private pendingTasks;
+    private activeIdleCallbackId;
+    constructor(host: ThumbnailCacheHost);
+    getProvider(url: string): CachedThumbnailProvider | undefined;
+    setProviderForSource(url: string, provider: CachedThumbnailProvider): void;
+    getMainProvider(): CachedThumbnailProvider | null;
+    setMainProvider(provider: CachedThumbnailProvider): void;
+    /**
+     * Best-effort poster frame for a playlist source that has already been
+     * preloaded, used to paint the incoming half of the transition canvas.
+     */
+    getCachedPosterForSource(url: string): string | null;
+    cancelPendingPreloads(): void;
+    /** Re-evaluates the cache against the current playlist and queues preloads. */
+    trigger(): void;
+    /** Destroys every cached provider except the controller's own main one. */
+    destroy(): void;
+    private destroyProvider;
+    private scheduleNextPreloadTask;
+    private runPreloadTask;
+    private expandPreloadTasksForProvider;
+}
+export {};
+//# sourceMappingURL=ThumbnailCache.d.ts.map

package/dist/web-components/src/player-internals/ThumbnailCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThumbnailCache.d.ts","sourceRoot":"","sources":["../../../../web-components/src/player-internals/ThumbnailCache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAgB,WAAW,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE9G;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,CAAC,UAAU,EAAE,gBAAgB,GAAG,SAAS,CAAC;IAClD,QAAQ,CAAC,qBAAqB,EAAE,OAAO,CAAC;CACzC;AAED;;;;;;GAMG;AACH,UAAU,uBAAwB,SAAQ,iBAAiB;IACzD,KAAK,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAChC,wBAAwB,CAAC,EAAE,OAAO,CAAC;CACpC;AASD;;;;;;;;;;;GAWG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAqB;IAC1C,OAAO,CAAC,SAAS,CAA8C;IAC/D,OAAO,CAAC,YAAY,CAAwC;IAC5D,OAAO,CAAC,YAAY,CAAqB;IACzC,OAAO,CAAC,oBAAoB,CAAuB;gBAEvC,IAAI,EAAE,kBAAkB;IAIpC,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,uBAAuB,GAAG,SAAS;IAI7D,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,uBAAuB,GAAG,IAAI;IAI1E,eAAe,IAAI,uBAAuB,GAAG,IAAI;IAIjD,eAAe,CAAC,QAAQ,EAAE,uBAAuB,GAAG,IAAI;IAIxD;;;OAGG;IACH,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAwCpD,qBAAqB,IAAI,IAAI;IAY7B,+EAA+E;IAC/E,OAAO,IAAI,IAAI;IAwHf,2EAA2E;IAC3E,OAAO,IAAI,IAAI;IASf,OAAO,CAAC,eAAe;IAcvB,OAAO,CAAC,uBAAuB;YAmBjB,cAAc;IAmC5B,OAAO,CAAC,6BAA6B;CA8CtC"}

package/package.json

@@ -0,0 +1,84 @@
+{
+  "name": "streamit-player",
+  "version": "1.0.0",
+  "description": "Enterprise-grade HTML5 video player with adaptive streaming (HLS/DASH), multi-DRM, VAST/VMAP/SIMID advertising, and Lit web components.",
+  "license": "Apache-2.0",
+  "author": "Iqonic Design",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/iqonicdesignofficial/streamit-player.git",
+    "directory": "packages/streamit-player"
+  },
+  "homepage": "https://github.com/iqonicdesignofficial/streamit-player#readme",
+  "bugs": {
+    "url": "https://github.com/iqonicdesignofficial/streamit-player/issues"
+  },
+  "keywords": [
+    "video",
+    "player",
+    "hls",
+    "dash",
+    "drm",
+    "vast",
+    "vmap",
+    "ads",
+    "headless",
+    "web-components",
+    "lit",
+    "streamit-player"
+  ],
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/src/index.d.ts",
+  "unpkg": "./dist/streamit-player.iife.min.js",
+  "jsdelivr": "./dist/streamit-player.iife.min.js",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./core": {
+      "types": "./dist/core/src/index.d.ts",
+      "import": "./dist/core/index.js",
+      "require": "./dist/core/index.cjs"
+    },
+    "./web-components": {
+      "types": "./dist/web-components/src/index.d.ts",
+      "import": "./dist/web-components/index.js",
+      "require": "./dist/web-components/index.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "build": "vite build && vite build --mode cdn && vite build --mode cdn-unminified",
+    "prepublishOnly": "npm run build && npm test",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "lit": "^3.1.2"
+  },
+  "peerDependencies": {
+    "dashjs": "^5.1.1",
+    "hls.js": "^1.5.8"
+  },
+  "devDependencies": {
+    "@open-wc/testing-helpers": "^3.0.1",
+    "@vitest/coverage-v8": "^4.1.11",
+    "dashjs": "^5.1.1",
+    "esbuild": "^0.21.5",
+    "hls.js": "^1.5.8",
+    "jsdom": "^27.0.1",
+    "vite": "^5.2.11",
+    "vite-plugin-dts": "^3.9.1",
+    "vitest": "^4.1.11"
+  }
+}