@mediafox/core 1.0.4 → 1.2.0

package/dist/mediafox.d.ts

@@ -1,6 +1,7 @@
 import type { UnsubscribeFn } from './events/types';
+import type { MediaFoxPlugin } from './plugins/types';
 import type { SubtitleTrackRegistration, SubtitleTrackResource } from './tracks/types';
-import type { AudioTrackInfo, LoadOptions, MediaSource, PlayerEventListener, PlayerEventMap, PlayerOptions, PlayerStateData, RendererType, ScreenshotOptions, SeekOptions, Subscription, SubtitleTrackInfo, VideoTrackInfo } from './types';
+import type { AudioTrackInfo, LoadOptions, MediaSource, PlayerEventListener, PlayerEventMap, PlayerOptions, PlayerStateData, PlaylistItem, PlaylistMode, RendererType, ScreenshotOptions, SeekOptions, Subscription, SubtitleTrackInfo, VideoTrackInfo } from './types';
 export declare class MediaFox {
     private emitter;
     private store;
@@ -8,6 +9,8 @@ export declare class MediaFox {
     private sourceManager;
     private playbackController;
     private trackManager;
+    private playlistManager;
+    private pluginManager;
     private options;
     private disposed;
     private getCurrentInput;
@@ -19,7 +22,9 @@ export declare class MediaFox {
      * Load a media source and prepare playback.
      * Emits: loadstart, loadedmetadata, loadeddata, canplay, canplaythrough (or error)
      */
-    load(source: MediaSource, options?: LoadOptions): Promise<void>;
+    load(source: MediaSource, options?: LoadOptions & {
+        replacePlaylist?: boolean;
+    }): Promise<void>;
     /** Start playback. */
     play(): Promise<void>;
     pause(): void;
@@ -43,6 +48,7 @@ export declare class MediaFox {
     get paused(): boolean;
     get ended(): boolean;
     get seeking(): boolean;
+    get waiting(): boolean;
     getVideoTracks(): VideoTrackInfo[];
     getAudioTracks(): AudioTrackInfo[];
     getSubtitleTracks(): SubtitleTrackInfo[];
@@ -55,6 +61,32 @@ export declare class MediaFox {
     /** Capture a screenshot of the current frame. */
     screenshot(options?: ScreenshotOptions): Promise<Blob | null>;
     setRenderTarget(canvas: HTMLCanvasElement | OffscreenCanvas): Promise<void>;
+    getRenderTarget(): HTMLCanvasElement | OffscreenCanvas | null;
+    /** @internal Refresh plugin overlays immediately */
+    refreshOverlays(): void;
+    loadPlaylist(items: Array<MediaSource | {
+        mediaSource: MediaSource;
+        title?: string;
+        poster?: string;
+    }>, options?: {
+        autoplay?: boolean;
+        startTime?: number;
+    }): Promise<void>;
+    addToPlaylist(item: MediaSource | {
+        mediaSource: MediaSource;
+        title?: string;
+        poster?: string;
+    }, index?: number): void;
+    removeFromPlaylist(index: number): Promise<void>;
+    clearPlaylist(): void;
+    next(): Promise<void>;
+    prev(): Promise<void>;
+    jumpTo(index: number): Promise<void>;
+    get playlist(): import("./types").Playlist;
+    get playlistIndex(): number | null;
+    get nowPlaying(): PlaylistItem | null;
+    get playlistMode(): PlaylistMode;
+    set playlistMode(mode: PlaylistMode);
     getRendererType(): RendererType;
     switchRenderer(type: RendererType): Promise<void>;
     /**
@@ -69,6 +101,16 @@ export declare class MediaFox {
     on<K extends keyof PlayerEventMap>(event: K, listener: PlayerEventListener<K>): UnsubscribeFn;
     once<K extends keyof PlayerEventMap>(event: K, listener: PlayerEventListener<K>): UnsubscribeFn;
     off<K extends keyof PlayerEventMap>(event: K, listener?: PlayerEventListener<K>): void;
+    /**
+     * Install a plugin.
+     * @param plugin The plugin to install
+     */
+    use(plugin: MediaFoxPlugin): Promise<void>;
+    /**
+     * Uninstall a plugin by name.
+     * @param name The name of the plugin to uninstall
+     */
+    unuse(name: string): Promise<void>;
     private emit;
     private checkDisposed;
     dispose(): void;

package/dist/mediafox.d.ts.map

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

package/dist/playback/audio.d.ts

@@ -1,4 +1,5 @@
 import { type AudioSample, type InputAudioTrack, type WrappedAudioBuffer } from 'mediabunny';
+import type { PluginManager } from '../plugins/manager';
 export interface AudioManagerOptions {
     audioContext?: AudioContext;
     volume?: number;
@@ -7,6 +8,7 @@ export interface AudioManagerOptions {
 export declare class AudioManager {
     private audioContext;
     private gainNode;
+    private outputNode;
     private bufferSink;
     private sampleSink;
     private bufferIterator;
@@ -20,8 +22,15 @@ export declare class AudioManager {
     private disposed;
     private playbackId;
     private playbackRate;
+    private pluginManager;
     constructor(options?: AudioManagerOptions);
     private setupAudioGraph;
+    setPluginManager(pluginManager: PluginManager): void;
+    /**
+     * Rebuild the audio graph with current plugin hooks.
+     * Call this after installing/uninstalling audio plugins.
+     */
+    rebuildAudioGraph(): void;
     setAudioTrack(track: InputAudioTrack): Promise<void>;
     play(fromTime?: number): Promise<void>;
     private scheduleAudioBuffers;
@@ -41,6 +50,11 @@ export declare class AudioManager {
     getBufferAt(timestamp: number): Promise<WrappedAudioBuffer | null>;
     getSampleAt(timestamp: number): Promise<AudioSample | null>;
     private stopQueuedNodes;
+    /**
+     * Clears iterators to stop any in-flight async operations.
+     * Called before disposing the input to prevent accessing disposed resources.
+     */
+    clearIterators(): Promise<void>;
     dispose(): void;
     destroy(): void;
 }

package/dist/playback/audio.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"audio.d.ts","sourceRoot":"","sources":["../../src/playback/audio.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,WAAW,EAEhB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACxB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,mBAAmB;IAClC,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAyB;IACzC,OAAO,CAAC,UAAU,CAAgC;IAClD,OAAO,CAAC,UAAU,CAAgC;IAClD,OAAO,CAAC,cAAc,CAAkE;IACxF,OAAO,CAAC,WAAW,CAAyC;IAC5D,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,YAAY,CAAK;gBAEb,OAAO,GAAE,mBAAwB;IAmB7C,OAAO,CAAC,eAAe;IAMjB,aAAa,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBpD,IAAI,CAAC,QAAQ,GAAE,MAAuB,GAAG,OAAO,CAAC,IAAI,CAAC;YAuB9C,oBAAoB;YA2CpB,cAAc;IAW5B,KAAK,IAAI,IAAI;IAkBb,IAAI,IAAI,IAAI;IAON,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAc5C,cAAc,IAAI,MAAM;IAQxB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAK/B,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAK9B,OAAO,CAAC,UAAU;IAQlB,SAAS,IAAI,MAAM;IAInB,OAAO,IAAI,OAAO;IAIlB,SAAS,IAAI,OAAO;IAIpB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAkBnC,eAAe,IAAI,YAAY;IAIzB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IAKlE,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAKjE,OAAO,CAAC,eAAe;IAWvB,OAAO,IAAI,IAAI;IAef,OAAO,IAAI,IAAI;CAYhB"}
+{"version":3,"file":"audio.d.ts","sourceRoot":"","sources":["../../src/playback/audio.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,WAAW,EAEhB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACxB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,MAAM,WAAW,mBAAmB;IAClC,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAyB;IACzC,OAAO,CAAC,UAAU,CAA0B;IAC5C,OAAO,CAAC,UAAU,CAAgC;IAClD,OAAO,CAAC,UAAU,CAAgC;IAClD,OAAO,CAAC,cAAc,CAAkE;IACxF,OAAO,CAAC,WAAW,CAAyC;IAC5D,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,aAAa,CAA8B;gBAEvC,OAAO,GAAE,mBAAwB;IAmB7C,OAAO,CAAC,eAAe;IAevB,gBAAgB,CAAC,aAAa,EAAE,aAAa,GAAG,IAAI;IAKpD;;;OAGG;IACH,iBAAiB,IAAI,IAAI;IAkBnB,aAAa,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBpD,IAAI,CAAC,QAAQ,GAAE,MAAuB,GAAG,OAAO,CAAC,IAAI,CAAC;YAuB9C,oBAAoB;YA4CpB,cAAc;IAW5B,KAAK,IAAI,IAAI;IAkBb,IAAI,IAAI,IAAI;IAON,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAc5C,cAAc,IAAI,MAAM;IAQxB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAK/B,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAK9B,OAAO,CAAC,UAAU;IAQlB,SAAS,IAAI,MAAM;IAInB,OAAO,IAAI,OAAO;IAIlB,SAAS,IAAI,OAAO;IAIpB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAkBnC,eAAe,IAAI,YAAY;IAIzB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IAKlE,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAKjE,OAAO,CAAC,eAAe;IAWvB;;;OAGG;IACG,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAcrC,OAAO,IAAI,IAAI;IAef,OAAO,IAAI,IAAI;CAYhB"}

package/dist/playback/controller.d.ts

@@ -1,4 +1,5 @@
 import type { InputAudioTrack, InputVideoTrack } from 'mediabunny';
+import type { PluginManager } from '../plugins/manager';
 import { AudioManager } from './audio';
 import { VideoRenderer } from './renderer';
 export interface PlaybackControllerOptions {
@@ -20,8 +21,11 @@ export declare class PlaybackController {
     private lastFrameTime;
     private syncIntervalId;
     private renderIntervalId;
+    private isWaiting;
     private onTimeUpdate?;
     private onEnded?;
+    private onWaiting?;
+    private onPlaying?;
     constructor(options?: PlaybackControllerOptions);
     setVideoTrack(track: InputVideoTrack | null): Promise<void>;
     /**
@@ -54,6 +58,9 @@ export declare class PlaybackController {
     getPlaybackRate(): number;
     setTimeUpdateCallback(callback: (time: number) => void): void;
     setEndedCallback(callback: () => void): void;
+    setWaitingCallback(callback: () => void): void;
+    setPlayingCallback(callback: () => void): void;
+    isBuffering(): boolean;
     screenshot(options?: {
         format?: 'png' | 'jpeg' | 'webp';
         quality?: number;
@@ -65,6 +72,14 @@ export declare class PlaybackController {
     updateCanvasDimensions(): void;
     setRendererChangeCallback(callback: (type: import('./renderers').RendererType) => void): void;
     setRendererFallbackCallback(callback: (from: import('./renderers').RendererType, to: import('./renderers').RendererType) => void): void;
+    setPluginManager(pluginManager: PluginManager): void;
+    getCanvas(): HTMLCanvasElement | OffscreenCanvas | null;
+    refreshOverlays(): void;
+    /**
+     * Rebuild the audio graph with current plugin hooks.
+     * Call this after installing/uninstalling audio plugins.
+     */
+    rebuildAudioGraph(): void;
     reset(): Promise<void>;
     dispose(): void;
     destroy(): void;

package/dist/playback/controller.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../../src/playback/controller.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../../src/playback/controller.ts"],"names":[],"mappings":"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"}

package/dist/playback/renderer.d.ts

@@ -1,5 +1,15 @@
-import { type InputVideoTrack, type VideoSample, type WrappedCanvas } from 'mediabunny';
+import { CanvasSink, type InputVideoTrack, type VideoSample, type WrappedCanvas } from 'mediabunny';
+import type { PluginManager } from '../plugins/manager';
 import type { RendererType } from './renderers';
+/** @internal */
+interface PrefetchedVideoData {
+    canvasSink: CanvasSink;
+    firstFrame: WrappedCanvas | null;
+}
+/** @internal */
+export declare function registerPrefetchedVideoData(track: InputVideoTrack, data: PrefetchedVideoData): void;
+/** @internal */
+export declare function consumePrefetchedVideoData(track: InputVideoTrack): PrefetchedVideoData | undefined;
 export interface VideoRendererOptions {
     canvas?: HTMLCanvasElement | OffscreenCanvas;
     width?: number;
@@ -31,6 +41,10 @@ export declare class VideoRenderer {
     private lastObservedHeight;
     private videoAspectRatio;
     private debug;
+    private pluginManager;
+    private overlayCanvas;
+    private overlayCtx;
+    private lastOverlayTime;
     constructor(options?: VideoRendererOptions);
     private setupResizeObserver;
     private getCanvasDimensionsFromEntry;
@@ -43,9 +57,22 @@ export declare class VideoRenderer {
     setCanvas(canvas: HTMLCanvasElement | OffscreenCanvas): Promise<void>;
     setVideoTrack(track: InputVideoTrack): Promise<void>;
     seek(timestamp: number): Promise<void>;
-    updateFrame(currentTime: number): boolean;
+    updateFrame(currentTime: number): {
+        frameUpdated: boolean;
+        isStarving: boolean;
+    };
     private fetchNextFrame;
     private renderFrame;
+    private renderFrameWithPlugins;
+    private executeOverlays;
+    /**
+     * Refresh overlays immediately (e.g., when a plugin is installed/uninstalled).
+     * For WebGPU/WebGL, this clears and redraws the overlay canvas.
+     * For canvas2d, this triggers a frame re-render if a current frame exists.
+     */
+    refreshOverlays(): void;
+    private ensureOverlayCanvas;
+    private cleanupOverlayCanvas;
     getFrameAt(timestamp: number): Promise<WrappedCanvas | null>;
     getSampleAt(timestamp: number): Promise<VideoSample | null>;
     extractFrames(startTime: number, endTime: number, interval?: number): Promise<WrappedCanvas[]>;
@@ -66,8 +93,15 @@ export declare class VideoRenderer {
     switchRenderer(type: RendererType): Promise<void>;
     setRendererChangeCallback(callback: (type: RendererType) => void): void;
     setRendererFallbackCallback(callback: (from: RendererType, to: RendererType) => void): void;
+    setPluginManager(pluginManager: PluginManager): void;
     static getSupportedRenderers(): RendererType[];
+    /**
+     * Clears iterators to stop any in-flight async operations.
+     * Called before disposing the input to prevent accessing disposed resources.
+     */
+    clearIterators(): Promise<void>;
     private disposeVideoResources;
     dispose(): void;
 }
+export {};
 //# sourceMappingURL=renderer.d.ts.map

package/dist/playback/renderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../../src/playback/renderer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../../src/playback/renderer.ts"],"names":[],"mappings":"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"}

package/dist/playlist/manager.d.ts

@@ -0,0 +1,36 @@
+import type { TypedEventEmitter } from '../events/types';
+import type { SourceManager } from '../sources/manager';
+import type { StateStore } from '../state/types';
+import type { MediaSource, PlayerEventMap, Playlist, PlaylistItem, PlaylistMode } from '../types';
+interface PlaylistItemConfig {
+    mediaSource: MediaSource;
+    title?: string;
+    poster?: string;
+}
+export declare class PlaylistManager {
+    private store;
+    private emitter;
+    private switchSource?;
+    private sourceManager?;
+    constructor(store: StateStore, emitter: TypedEventEmitter<PlayerEventMap>, switchSource?: (item: PlaylistItem, autoplay: boolean) => Promise<void>, sourceManager?: SourceManager);
+    loadPlaylist(items: Array<MediaSource | PlaylistItemConfig>, options?: {
+        autoplay?: boolean;
+        startTime?: number;
+    }): Promise<void>;
+    addToPlaylist(itemInput: MediaSource | PlaylistItemConfig, index?: number): void;
+    removeFromPlaylist(index: number): Promise<void>;
+    clearPlaylist(): void;
+    next(): Promise<void>;
+    prev(): Promise<void>;
+    jumpTo(index: number): Promise<void>;
+    setMode(mode: PlaylistMode): void;
+    private switchTo;
+    private createPlaylistItem;
+    get playlist(): Playlist;
+    get currentIndex(): number | null;
+    get currentItem(): PlaylistItem | null;
+    get mode(): PlaylistMode;
+    dispose(): void;
+}
+export {};
+//# sourceMappingURL=manager.d.ts.map

package/dist/playlist/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/playlist/manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,QAAQ,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAQlG,UAAU,kBAAkB;IAC1B,WAAW,EAAE,WAAW,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,OAAO,CAAoC;IACnD,OAAO,CAAC,YAAY,CAAC,CAA2D;IAChF,OAAO,CAAC,aAAa,CAAC,CAAgB;gBAGpC,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,iBAAiB,CAAC,cAAc,CAAC,EAC1C,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,EACvE,aAAa,CAAC,EAAE,aAAa;IAQzB,YAAY,CAChB,KAAK,EAAE,KAAK,CAAC,WAAW,GAAG,kBAAkB,CAAC,EAC9C,OAAO,GAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO,GACvD,OAAO,CAAC,IAAI,CAAC;IAqChB,aAAa,CAAC,SAAS,EAAE,WAAW,GAAG,kBAAkB,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAO1E,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA8BtD,aAAa,IAAI,IAAI;IAQf,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA+BrB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IASrB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAY1C,OAAO,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI;YAUnB,QAAQ;IAoCtB,OAAO,CAAC,kBAAkB;IAwB1B,IAAI,QAAQ,IAAI,QAAQ,CAEvB;IAED,IAAI,YAAY,IAAI,MAAM,GAAG,IAAI,CAEhC;IAED,IAAI,WAAW,IAAI,YAAY,GAAG,IAAI,CAGrC;IAED,IAAI,IAAI,IAAI,YAAY,CAEvB;IAED,OAAO,IAAI,IAAI;CAShB"}

package/dist/plugins/context.d.ts

@@ -0,0 +1,9 @@
+import type { MediaFox } from '../mediafox';
+import type { InstalledPlugin, MediaFoxPlugin, PluginContext } from './types';
+/**
+ * Creates a PluginContext for a plugin.
+ * The context provides controlled access to player internals.
+ * @internal
+ */
+export declare function createPluginContext(player: MediaFox, plugin: MediaFoxPlugin, installedPlugin: InstalledPlugin, getInstalledPlugins: () => Map<string, InstalledPlugin>): PluginContext;
+//# sourceMappingURL=context.d.ts.map

package/dist/plugins/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/plugins/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE9E;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,QAAQ,EAChB,MAAM,EAAE,cAAc,EACtB,eAAe,EAAE,eAAe,EAChC,mBAAmB,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,GACtD,aAAa,CA8Ef"}

package/dist/plugins/index.d.ts

@@ -0,0 +1,3 @@
+export { PluginManager } from './manager';
+export type { AudioHooks, EventHooks, HookResult, LifecycleHooks, MaybePromise, MediaFoxPlugin, OverlayDimensions, PluginContext, PluginHooks, RenderHooks, StateHooks, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/plugins/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,YAAY,EACV,UAAU,EACV,UAAU,EACV,UAAU,EACV,cAAc,EACd,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,WAAW,EACX,WAAW,EACX,UAAU,GACX,MAAM,SAAS,CAAC"}

package/dist/plugins/manager.d.ts

@@ -0,0 +1,57 @@
+import type { WrappedCanvas } from 'mediabunny';
+import type { MediaFox } from '../mediafox';
+import type { MediaInfo, MediaSource, PlayerEventMap, PlayerStateData } from '../types';
+import type { HookResult, MediaFoxPlugin, OverlayDimensions } from './types';
+/**
+ * Manages plugin lifecycle and hook execution.
+ * @internal
+ */
+export declare class PluginManager {
+    private player;
+    private plugins;
+    private overlays;
+    private overlaysSorted;
+    private registrationCounter;
+    constructor(player: MediaFox);
+    /**
+     * Install a plugin.
+     */
+    install(plugin: MediaFoxPlugin): Promise<void>;
+    /**
+     * Uninstall a plugin by name.
+     */
+    uninstall(name: string): Promise<void>;
+    /**
+     * Check if a plugin is installed.
+     */
+    has(name: string): boolean;
+    /**
+     * Get installed plugin count.
+     */
+    get size(): number;
+    executeBeforeLoad(source: MediaSource): Promise<HookResult<MediaSource> | undefined>;
+    executeAfterLoad(mediaInfo: MediaInfo): Promise<void>;
+    executeBeforePlay(): Promise<HookResult | undefined>;
+    executeAfterPlay(): void;
+    executeBeforePause(): Promise<HookResult | undefined>;
+    executeAfterPause(): void;
+    executeBeforeSeek(time: number): Promise<HookResult<number> | undefined>;
+    executeAfterSeek(time: number): void;
+    executeBeforeStop(): Promise<HookResult | undefined>;
+    executeAfterStop(): void;
+    executeOnError(error: Error): boolean;
+    executeOnEnded(): void;
+    executeBeforeRender(frame: WrappedCanvas, time: number): {
+        skip?: boolean;
+    } | undefined;
+    executeTransformFrame(frame: WrappedCanvas): WrappedCanvas;
+    executeAfterRender(canvas: HTMLCanvasElement | OffscreenCanvas): void;
+    executeOverlays(ctx: CanvasRenderingContext2D, time: number, dimensions: OverlayDimensions): void;
+    executeBeforeStateUpdate(update: Partial<PlayerStateData>): Partial<PlayerStateData> | null;
+    executeOnStateChange(state: PlayerStateData, prevState: PlayerStateData): void;
+    executeBeforeEvent<K extends keyof PlayerEventMap>(event: K, data: PlayerEventMap[K]): HookResult<PlayerEventMap[K]> | undefined;
+    executeAfterEvent<K extends keyof PlayerEventMap>(event: K, data: PlayerEventMap[K]): void;
+    executeOnAudioNode(audioContext: AudioContext, gainNode: GainNode): AudioNode;
+    dispose(): Promise<void>;
+}
+//# sourceMappingURL=manager.d.ts.map

package/dist/plugins/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/plugins/manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAExF,OAAO,KAAK,EACV,UAAU,EAEV,cAAc,EACd,iBAAiB,EAElB,MAAM,SAAS,CAAC;AAEjB;;;GAGG;AACH,qBAAa,aAAa;IAMZ,OAAO,CAAC,MAAM;IAL1B,OAAO,CAAC,OAAO,CAA2C;IAC1D,OAAO,CAAC,QAAQ,CAAsB;IACtC,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,mBAAmB,CAAK;gBAEZ,MAAM,EAAE,QAAQ;IAEpC;;OAEG;IACG,OAAO,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IA4DpD;;OAEG;IACG,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAsC5C;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAMK,iBAAiB,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,GAAG,SAAS,CAAC;IAgBpF,gBAAgB,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAarD,iBAAiB,IAAI,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAe1D,gBAAgB,IAAI,IAAI;IAalB,kBAAkB,IAAI,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAe3D,iBAAiB,IAAI,IAAI;IAanB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;IAgB9E,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAa9B,iBAAiB,IAAI,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAe1D,gBAAgB,IAAI,IAAI;IAaxB,cAAc,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO;IAgBrC,cAAc,IAAI,IAAI;IAiBtB,mBAAmB,CAAC,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG;QAAE,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,SAAS;IAevF,qBAAqB,CAAC,KAAK,EAAE,aAAa,GAAG,aAAa;IAe1D,kBAAkB,CAAC,MAAM,EAAE,iBAAiB,GAAG,eAAe,GAAG,IAAI;IAarE,eAAe,CAAC,GAAG,EAAE,wBAAwB,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,iBAAiB,GAAG,IAAI;IA0BjG,wBAAwB,CAAC,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI;IAgB3F,oBAAoB,CAAC,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,eAAe,GAAG,IAAI;IAiB9E,kBAAkB,CAAC,CAAC,SAAS,MAAM,cAAc,EAC/C,KAAK,EAAE,CAAC,EACR,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,GACtB,UAAU,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS;IAgB5C,iBAAiB,CAAC,CAAC,SAAS,MAAM,cAAc,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,IAAI;IAiB1F,kBAAkB,CAAC,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,QAAQ,GAAG,SAAS;IAsBvE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAW/B"}

package/dist/plugins/types.d.ts

@@ -0,0 +1,191 @@
+import type { WrappedCanvas } from 'mediabunny';
+import type { MediaFox } from '../mediafox';
+import type { MediaInfo, MediaSource, PlayerEventMap, PlayerStateData } from '../types';
+/** A value that may or may not be a Promise */
+export type MaybePromise<T> = T | Promise<T>;
+/** Result from a hook that can cancel or modify an operation */
+export interface HookResult<T = void> {
+    /** If true, cancel the operation */
+    cancel?: boolean;
+    /** Modified value to use instead of original */
+    data?: T;
+}
+/** Overlay render dimensions */
+export interface OverlayDimensions {
+    width: number;
+    height: number;
+}
+/**
+ * Lifecycle hooks are called at key points during player operations.
+ * These hooks can be async and may cancel or modify operations.
+ */
+export interface LifecycleHooks {
+    /** Called before loading a media source. Can modify source or cancel. */
+    beforeLoad?(source: MediaSource): MaybePromise<HookResult<MediaSource> | undefined>;
+    /** Called after media is loaded successfully. */
+    afterLoad?(mediaInfo: MediaInfo): MaybePromise<void>;
+    /** Called before play starts. Can cancel play. */
+    beforePlay?(): MaybePromise<HookResult | undefined>;
+    /** Called after play has started. */
+    afterPlay?(): void;
+    /** Called before pause. Can cancel pause. */
+    beforePause?(): MaybePromise<HookResult | undefined>;
+    /** Called after pause completes. */
+    afterPause?(): void;
+    /** Called before seeking. Can modify seek time or cancel. */
+    beforeSeek?(time: number): MaybePromise<HookResult<number> | undefined>;
+    /** Called after seek completes. */
+    afterSeek?(time: number): void;
+    /** Called before stop. Can cancel stop. */
+    beforeStop?(): MaybePromise<HookResult | undefined>;
+    /** Called after stop completes. */
+    afterStop?(): void;
+    /** Called when an error occurs. Return { handled: true } to suppress. */
+    onError?(error: Error): {
+        handled?: boolean;
+    } | undefined;
+    /** Called when playback ends naturally. */
+    onEnded?(): void;
+}
+/**
+ * Render hooks are called during the video rendering pipeline.
+ * IMPORTANT: These must be synchronous for performance.
+ */
+export interface RenderHooks {
+    /** Called before a frame is rendered. Return { skip: true } to skip this frame. */
+    beforeRender?(frame: WrappedCanvas, time: number): {
+        skip?: boolean;
+    } | undefined;
+    /** Called to transform a frame before rendering. Return modified frame. */
+    transformFrame?(frame: WrappedCanvas): WrappedCanvas;
+    /** Called after frame is rendered to canvas. */
+    afterRender?(canvas: HTMLCanvasElement | OffscreenCanvas): void;
+    /**
+     * Canvas overlay hook - draws on top of video frame.
+     * zIndex controls layer order (higher = on top).
+     * Default zIndex is 0; plugins with same zIndex render in registration order.
+     */
+    onOverlay?: {
+        /** Layer order - higher values render on top */
+        zIndex?: number;
+        /** Render function called each frame */
+        render(ctx: CanvasRenderingContext2D, time: number, dimensions: OverlayDimensions): void;
+    };
+}
+/**
+ * State hooks are called when player state changes.
+ * These are synchronous.
+ */
+export interface StateHooks {
+    /** Called before state is updated. Return modified update or null to cancel. */
+    beforeStateUpdate?(update: Partial<PlayerStateData>): Partial<PlayerStateData> | null | undefined;
+    /** Called after state has changed. */
+    onStateChange?(state: PlayerStateData, prevState: PlayerStateData): void;
+}
+/**
+ * Event hooks allow intercepting and modifying player events.
+ * These are synchronous.
+ */
+export interface EventHooks {
+    /** Called before an event is emitted. Can modify data or cancel emission. */
+    beforeEvent?<K extends keyof PlayerEventMap>(event: K, data: PlayerEventMap[K]): HookResult<PlayerEventMap[K]> | undefined;
+    /** Called after an event is emitted. */
+    afterEvent?<K extends keyof PlayerEventMap>(event: K, data: PlayerEventMap[K]): void;
+}
+/**
+ * Audio hooks allow modifying the Web Audio graph.
+ * These are synchronous.
+ */
+export interface AudioHooks {
+    /**
+     * Called when audio graph is set up.
+     * Return a modified AudioNode to insert into the chain.
+     */
+    onAudioNode?(audioContext: AudioContext, sourceNode: GainNode): AudioNode | undefined;
+}
+/**
+ * All plugin hooks grouped by category.
+ */
+export interface PluginHooks {
+    lifecycle?: LifecycleHooks;
+    render?: RenderHooks;
+    state?: StateHooks;
+    event?: EventHooks;
+    audio?: AudioHooks;
+}
+/**
+ * Context provided to plugins during installation.
+ * Provides controlled access to player internals.
+ */
+export interface PluginContext {
+    /** Reference to the MediaFox player instance */
+    readonly player: MediaFox;
+    /** Get current player state (read-only) */
+    getState(): Readonly<PlayerStateData>;
+    /** Subscribe to state changes. Returns unsubscribe function. */
+    subscribe(listener: (state: PlayerStateData) => void): () => void;
+    /** Get plugin's private state */
+    getPluginState<T>(): T | undefined;
+    /** Set plugin's private state */
+    setPluginState<T>(state: T): void;
+    /** Subscribe to player event */
+    on<K extends keyof PlayerEventMap>(event: K, handler: (data: PlayerEventMap[K]) => void): void;
+    /** Unsubscribe from player event */
+    off<K extends keyof PlayerEventMap>(event: K, handler: (data: PlayerEventMap[K]) => void): void;
+    /** Get the player's render canvas */
+    getCanvas(): HTMLCanvasElement | OffscreenCanvas | null;
+    /** Get another plugin by name */
+    getPlugin<T extends MediaFoxPlugin>(name: string): T | undefined;
+    /** Check if a plugin is installed */
+    hasPlugin(name: string): boolean;
+    /** Log message with plugin prefix */
+    log(...args: unknown[]): void;
+    /** Log warning with plugin prefix */
+    warn(...args: unknown[]): void;
+    /** Log error with plugin prefix */
+    error(...args: unknown[]): void;
+}
+/**
+ * MediaFox plugin interface.
+ * Plugins must implement this interface to be used with player.use().
+ */
+export interface MediaFoxPlugin {
+    /** Unique plugin name */
+    readonly name: string;
+    /** Plugin version (optional, for debugging) */
+    readonly version?: string;
+    /** Other plugins that must be installed first */
+    readonly dependencies?: string[];
+    /**
+     * Called when plugin is installed.
+     * Use context to set up event listeners and state.
+     */
+    install(context: PluginContext): void | Promise<void>;
+    /**
+     * Called when plugin is uninstalled (optional).
+     * Clean up any external resources here.
+     * Event listeners registered via context.on() are auto-cleaned.
+     */
+    uninstall?(): void | Promise<void>;
+    /**
+     * Plugin hooks (optional).
+     * Define hooks to intercept player operations.
+     */
+    hooks?: PluginHooks;
+}
+/** @internal Installed plugin with context */
+export interface InstalledPlugin {
+    plugin: MediaFoxPlugin;
+    context: PluginContext;
+    eventListeners: Map<keyof PlayerEventMap, Set<(data: unknown) => void>>;
+    stateUnsubscribes: Array<() => void>;
+    pluginState: unknown;
+}
+/** @internal Overlay entry for sorted rendering */
+export interface OverlayEntry {
+    pluginName: string;
+    zIndex: number;
+    registrationOrder: number;
+    render: RenderHooks['onOverlay'];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/plugins/types.d.ts.map

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