libbitsub 1.10.2 → 1.11.0

package/dist/integrations/react.js

@@ -0,0 +1,127 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * Optional React bindings for libbitsub bitmap subtitles.
+ *
+ * Peer dependency: react >= 18
+ *
+ * @example
+ * ```tsx
+ * import { useRef } from 'react'
+ * import { useBitSub } from 'libbitsub/react'
+ *
+ * function Player({ src, subUrl }: { src: string; subUrl: string }) {
+ *   const videoRef = useRef<HTMLVideoElement>(null)
+ *   useBitSub(videoRef, { subUrl })
+ *   return (
+ *     <div style={{ position: 'relative' }}>
+ *       <video ref={videoRef} src={src} controls playsInline />
+ *     </div>
+ *   )
+ * }
+ * ```
+ *
+ * Prefer either `useBitSub` *or* `BitSubOverlay` for a given video — not both.
+ */
+import { useEffect, useRef, useState } from 'react';
+import { attachBitSub } from './shared';
+function sourceKey(source) {
+    if (!source)
+        return '';
+    return JSON.stringify({
+        subUrl: source.subUrl ?? null,
+        idxUrl: source.idxUrl ?? null,
+        fileName: source.fileName ?? null,
+        hasSubContent: Boolean(source.subContent),
+        hasIdxContent: Boolean(source.idxContent),
+        cacheLimit: source.cacheLimit ?? null,
+        timeOffset: source.timeOffset ?? null,
+        streamingLoad: source.streamingLoad ?? null,
+        rangeRequests: source.rangeRequests ?? null,
+        debug: source.debug ?? null,
+        displaySettings: source.displaySettings ?? null,
+        prefetchWindow: source.prefetchWindow ?? null
+    });
+}
+/**
+ * Bind a libbitsub renderer to a video element ref for the lifetime of the source.
+ * Cleans up automatically on unmount or when the source identity changes.
+ */
+export function useBitSub(videoRef, options) {
+    const controllerRef = useRef(null);
+    const [controller, setController] = useState(null);
+    const [error, setError] = useState(null);
+    const onEventRef = useRef(undefined);
+    const onWarningRef = useRef(undefined);
+    const onErrorRef = useRef(undefined);
+    const onLoadingRef = useRef(undefined);
+    const onLoadedRef = useRef(undefined);
+    onEventRef.current = options?.onEvent;
+    onWarningRef.current = options?.onWarning;
+    onErrorRef.current = options?.onError;
+    onLoadingRef.current = options?.onLoading;
+    onLoadedRef.current = options?.onLoaded;
+    const enabled = options?.enabled !== false;
+    const key = sourceKey(options);
+    const displaySettings = options?.displaySettings;
+    useEffect(() => {
+        setError(null);
+        const video = videoRef.current;
+        if (!video || !options || !enabled) {
+            controllerRef.current?.dispose();
+            controllerRef.current = null;
+            setController(null);
+            return;
+        }
+        const { enabled: _enabled, onEvent: _onEvent, onWarning: _onWarning, onError: _onError, onLoading: _onLoading, onLoaded: _onLoaded, ...source } = options;
+        const attachOptions = {
+            ...source,
+            onEvent: (event) => onEventRef.current?.(event),
+            onWarning: (warning) => onWarningRef.current?.(warning),
+            onError: (err) => {
+                setError(err);
+                onErrorRef.current?.(err);
+            },
+            onLoading: () => onLoadingRef.current?.(),
+            onLoaded: () => onLoadedRef.current?.()
+        };
+        try {
+            const next = attachBitSub(video, attachOptions);
+            controllerRef.current = next;
+            setController(next);
+            return () => {
+                next.dispose();
+                if (controllerRef.current === next) {
+                    controllerRef.current = null;
+                    setController(null);
+                }
+            };
+        }
+        catch (err) {
+            const resolved = err instanceof Error ? err : new Error(String(err));
+            setError(resolved);
+            onErrorRef.current?.(resolved);
+            controllerRef.current = null;
+            setController(null);
+        }
+        // key captures source identity; callback props stay fresh via refs
+    }, [videoRef, key, enabled]);
+    useEffect(() => {
+        if (displaySettings) {
+            controllerRef.current?.setDisplaySettings(displaySettings);
+        }
+    }, [displaySettings]);
+    return { controller, error };
+}
+/**
+ * Declarative overlay helper. Renders nothing visible itself — libbitsub attaches
+ * its canvas next to the video element. Useful when you want JSX-configured tracks.
+ */
+export function BitSubOverlay(props) {
+    const { videoRef, className, style, ...options } = props;
+    useBitSub(videoRef, options);
+    if (!className && !style)
+        return null;
+    return _jsx("span", { className: className, style: { display: 'none', ...style }, "aria-hidden": 'true' });
+}
+export { attachBitSub, createBitSubRenderer } from './shared';
+//# sourceMappingURL=react.js.map

package/dist/integrations/react.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.js","sourceRoot":"","sources":["../../src/integrations/react.tsx"],"names":[],"mappings":"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"}

package/dist/integrations/shaka.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Optional Shaka Player adapter for libbitsub bitmap subtitles.
+ *
+ * Bitmap PGS/VobSub tracks are not native Shaka text tracks — this helper
+ * overlays libbitsub on the player media element.
+ *
+ * @example
+ * ```ts
+ * import shaka from 'shaka-player'
+ * import { attachBitSubToShaka } from 'libbitsub/shaka'
+ *
+ * const player = new shaka.Player(video)
+ * await player.load(manifestUri)
+ * const bitsub = attachBitSubToShaka(player, { subUrl: '/subs/movie.sup' })
+ * // later
+ * bitsub.dispose()
+ * ```
+ */
+import { type AttachBitSubOptions, type BitSubController } from './shared';
+/** Minimal Shaka Player surface used by the adapter. */
+export interface ShakaPlayerLike {
+    getMediaElement(): HTMLMediaElement | null;
+    addEventListener?(type: string, listener: (...args: unknown[]) => void): void;
+    removeEventListener?(type: string, listener: (...args: unknown[]) => void): void;
+}
+export type BitSubShakaOptions = AttachBitSubOptions;
+export interface BitSubShakaHandle extends BitSubController {
+    /** Underlying Shaka player reference. */
+    readonly player: ShakaPlayerLike;
+}
+/**
+ * Attach libbitsub to a Shaka Player instance.
+ * Rebinds automatically when Shaka swaps the media element (if event APIs exist).
+ */
+export declare function attachBitSubToShaka(player: ShakaPlayerLike, options?: BitSubShakaOptions): BitSubShakaHandle;
+export type { AttachBitSubOptions, BitSubController, BitSubSourceOptions, BitSubRenderer } from './shared';
+export { attachBitSub, createBitSubRenderer } from './shared';
+//# sourceMappingURL=shaka.d.ts.map

package/dist/integrations/shaka.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shaka.d.ts","sourceRoot":"","sources":["../../src/integrations/shaka.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAgB,KAAK,mBAAmB,EAAE,KAAK,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAExF,wDAAwD;AACxD,MAAM,WAAW,eAAe;IAC9B,eAAe,IAAI,gBAAgB,GAAG,IAAI,CAAA;IAC1C,gBAAgB,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,IAAI,CAAA;IAC7E,mBAAmB,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,IAAI,CAAA;CACjF;AAED,MAAM,MAAM,kBAAkB,GAAG,mBAAmB,CAAA;AAEpD,MAAM,WAAW,iBAAkB,SAAQ,gBAAgB;IACzD,yCAAyC;IACzC,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAA;CACjC;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,eAAe,EAAE,OAAO,GAAE,kBAAuB,GAAG,iBAAiB,CAiDhH;AAED,YAAY,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAC1G,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAA"}

package/dist/integrations/shaka.js

@@ -0,0 +1,71 @@
+/**
+ * Optional Shaka Player adapter for libbitsub bitmap subtitles.
+ *
+ * Bitmap PGS/VobSub tracks are not native Shaka text tracks — this helper
+ * overlays libbitsub on the player media element.
+ *
+ * @example
+ * ```ts
+ * import shaka from 'shaka-player'
+ * import { attachBitSubToShaka } from 'libbitsub/shaka'
+ *
+ * const player = new shaka.Player(video)
+ * await player.load(manifestUri)
+ * const bitsub = attachBitSubToShaka(player, { subUrl: '/subs/movie.sup' })
+ * // later
+ * bitsub.dispose()
+ * ```
+ */
+import { attachBitSub } from './shared';
+/**
+ * Attach libbitsub to a Shaka Player instance.
+ * Rebinds automatically when Shaka swaps the media element (if event APIs exist).
+ */
+export function attachBitSubToShaka(player, options = {}) {
+    const media = player.getMediaElement();
+    if (!(media instanceof HTMLVideoElement)) {
+        throw new Error('libbitsub Shaka adapter requires a player with an HTMLVideoElement media element');
+    }
+    const controller = attachBitSub(media, options);
+    const onLoaded = () => {
+        if (controller.disposed)
+            return;
+        const next = player.getMediaElement();
+        if (next instanceof HTMLVideoElement) {
+            controller.setVideo(next);
+        }
+    };
+    const onUnloading = () => {
+        if (!controller.disposed)
+            controller.clear();
+    };
+    player.addEventListener?.('loaded', onLoaded);
+    player.addEventListener?.('unloading', onUnloading);
+    const dispose = () => {
+        player.removeEventListener?.('loaded', onLoaded);
+        player.removeEventListener?.('unloading', onUnloading);
+        controller.dispose();
+    };
+    return {
+        player,
+        get renderer() {
+            return controller.renderer;
+        },
+        get video() {
+            return controller.video;
+        },
+        get disposed() {
+            return controller.disposed;
+        },
+        load: (source) => controller.load(source),
+        clear: () => controller.clear(),
+        dispose,
+        getDisplaySettings: () => controller.getDisplaySettings(),
+        setDisplaySettings: (settings) => controller.setDisplaySettings(settings),
+        resetDisplaySettings: () => controller.resetDisplaySettings(),
+        getStats: () => controller.getStats(),
+        setVideo: (video) => controller.setVideo(video)
+    };
+}
+export { attachBitSub, createBitSubRenderer } from './shared';
+//# sourceMappingURL=shaka.js.map

package/dist/integrations/shaka.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shaka.js","sourceRoot":"","sources":["../../src/integrations/shaka.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,YAAY,EAAmD,MAAM,UAAU,CAAA;AAgBxF;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAuB,EAAE,OAAO,GAAuB,EAAE;IAC3F,MAAM,KAAK,GAAG,MAAM,CAAC,eAAe,EAAE,CAAA;IACtC,IAAI,CAAC,CAAC,KAAK,YAAY,gBAAgB,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CAAC,kFAAkF,CAAC,CAAA;IACrG,CAAC;IAED,MAAM,UAAU,GAAG,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;IAE/C,MAAM,QAAQ,GAAG,GAAS,EAAE;QAC1B,IAAI,UAAU,CAAC,QAAQ;YAAE,OAAM;QAC/B,MAAM,IAAI,GAAG,MAAM,CAAC,eAAe,EAAE,CAAA;QACrC,IAAI,IAAI,YAAY,gBAAgB,EAAE,CAAC;YACrC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;QAC3B,CAAC;IACH,CAAC,CAAA;IAED,MAAM,WAAW,GAAG,GAAS,EAAE;QAC7B,IAAI,CAAC,UAAU,CAAC,QAAQ;YAAE,UAAU,CAAC,KAAK,EAAE,CAAA;IAC9C,CAAC,CAAA;IAED,MAAM,CAAC,gBAAgB,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAA;IAC7C,MAAM,CAAC,gBAAgB,EAAE,CAAC,WAAW,EAAE,WAAW,CAAC,CAAA;IAEnD,MAAM,OAAO,GAAG,GAAS,EAAE;QACzB,MAAM,CAAC,mBAAmB,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAA;QAChD,MAAM,CAAC,mBAAmB,EAAE,CAAC,WAAW,EAAE,WAAW,CAAC,CAAA;QACtD,UAAU,CAAC,OAAO,EAAE,CAAA;IACtB,CAAC,CAAA;IAED,OAAO;QACL,MAAM;QACN,IAAI,QAAQ;YACV,OAAO,UAAU,CAAC,QAAQ,CAAA;QAC5B,CAAC;QACD,IAAI,KAAK;YACP,OAAO,UAAU,CAAC,KAAK,CAAA;QACzB,CAAC;QACD,IAAI,QAAQ;YACV,OAAO,UAAU,CAAC,QAAQ,CAAA;QAC5B,CAAC;QACD,IAAI,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC;QACzC,KAAK,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE;QAC/B,OAAO;QACP,kBAAkB,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,kBAAkB,EAAE;QACzD,kBAAkB,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,UAAU,CAAC,kBAAkB,CAAC,QAAQ,CAAC;QACzE,oBAAoB,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,oBAAoB,EAAE;QAC7D,QAAQ,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE;QACrC,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC;KAChD,CAAA;AACH,CAAC;AAGD,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAA"}

package/dist/integrations/shared.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Shared player-integration helpers for libbitsub.
+ * Optional adapters build on this surface so the core package stays dependency-free.
+ */
+import { type AutoVideoSubtitleOptions, type PgsRenderer, type SubtitleDisplaySettings, type SubtitleRendererStats, type VobSubRenderer } from '../wrapper';
+/** High-level renderer produced by integrations. */
+export type BitSubRenderer = PgsRenderer | VobSubRenderer;
+/** Subtitle source + renderer options without a bound video element. */
+export type BitSubSourceOptions = Omit<AutoVideoSubtitleOptions, 'video'>;
+export interface BitSubController {
+    /** Active renderer, or null when no track is loaded. */
+    readonly renderer: BitSubRenderer | null;
+    /** Currently bound video element. */
+    readonly video: HTMLVideoElement | null;
+    /** Load or replace the active subtitle track. */
+    load(source: BitSubSourceOptions): BitSubRenderer;
+    /** Remove the active track without disposing the controller. */
+    clear(): void;
+    /** Tear down the renderer and release the controller. */
+    dispose(): void;
+    /** Whether {@link dispose} has already been called. */
+    readonly disposed: boolean;
+    getDisplaySettings(): SubtitleDisplaySettings | null;
+    setDisplaySettings(settings: Partial<SubtitleDisplaySettings>): void;
+    resetDisplaySettings(): void;
+    getStats(): SubtitleRendererStats | null;
+    /** Rebind to another video element, keeping the last source when present. */
+    setVideo(video: HTMLVideoElement | null): void;
+}
+export interface AttachBitSubOptions extends BitSubSourceOptions {
+    /** When false, skip the initial load even if source fields are present. Default true. */
+    autoLoad?: boolean;
+}
+/**
+ * Attach a disposable controller to a video element.
+ * Call {@link BitSubController.load} to start a track, or pass source fields to auto-load.
+ */
+export declare function attachBitSub(video: HTMLVideoElement, options?: AttachBitSubOptions): BitSubController;
+/** Convenience one-shot helper used by thin player wrappers. */
+export declare function createBitSubRenderer(video: HTMLVideoElement, source: BitSubSourceOptions): BitSubRenderer;
+//# sourceMappingURL=shared.d.ts.map

package/dist/integrations/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/integrations/shared.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAEL,KAAK,wBAAwB,EAC7B,KAAK,WAAW,EAChB,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,cAAc,EACpB,MAAM,YAAY,CAAA;AAEnB,oDAAoD;AACpD,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,cAAc,CAAA;AAEzD,wEAAwE;AACxE,MAAM,MAAM,mBAAmB,GAAG,IAAI,CAAC,wBAAwB,EAAE,OAAO,CAAC,CAAA;AAEzE,MAAM,WAAW,gBAAgB;IAC/B,wDAAwD;IACxD,QAAQ,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,CAAA;IACxC,qCAAqC;IACrC,QAAQ,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAAA;IACvC,iDAAiD;IACjD,IAAI,CAAC,MAAM,EAAE,mBAAmB,GAAG,cAAc,CAAA;IACjD,gEAAgE;IAChE,KAAK,IAAI,IAAI,CAAA;IACb,yDAAyD;IACzD,OAAO,IAAI,IAAI,CAAA;IACf,uDAAuD;IACvD,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;IAC1B,kBAAkB,IAAI,uBAAuB,GAAG,IAAI,CAAA;IACpD,kBAAkB,CAAC,QAAQ,EAAE,OAAO,CAAC,uBAAuB,CAAC,GAAG,IAAI,CAAA;IACpE,oBAAoB,IAAI,IAAI,CAAA;IAC5B,QAAQ,IAAI,qBAAqB,GAAG,IAAI,CAAA;IACxC,6EAA6E;IAC7E,QAAQ,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI,GAAG,IAAI,CAAA;CAC/C;AAED,MAAM,WAAW,mBAAoB,SAAQ,mBAAmB;IAC9D,yFAAyF;IACzF,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAcD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,gBAAgB,EAAE,OAAO,GAAE,mBAAwB,GAAG,gBAAgB,CAmGzG;AAED,gEAAgE;AAChE,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,gBAAgB,EAAE,MAAM,EAAE,mBAAmB,GAAG,cAAc,CAKzG"}

package/dist/integrations/shared.js

@@ -0,0 +1,123 @@
+/**
+ * Shared player-integration helpers for libbitsub.
+ * Optional adapters build on this surface so the core package stays dependency-free.
+ */
+import { createAutoSubtitleRenderer } from '../wrapper';
+function hasSubtitleSource(source) {
+    if (!source)
+        return false;
+    return Boolean(source.subUrl || source.subContent || source.idxUrl || source.idxContent || source.fileName);
+}
+function assertVideo(video) {
+    if (!video) {
+        throw new Error('libbitsub integration requires an HTMLVideoElement');
+    }
+    return video;
+}
+/**
+ * Attach a disposable controller to a video element.
+ * Call {@link BitSubController.load} to start a track, or pass source fields to auto-load.
+ */
+export function attachBitSub(video, options = {}) {
+    const { autoLoad = true, ...initialSource } = options;
+    let disposed = false;
+    let boundVideo = video;
+    let renderer = null;
+    let lastSource = hasSubtitleSource(initialSource) ? { ...initialSource } : null;
+    const clearRenderer = () => {
+        if (!renderer)
+            return;
+        renderer.dispose();
+        renderer = null;
+    };
+    const controller = {
+        get renderer() {
+            return renderer;
+        },
+        get video() {
+            return boundVideo;
+        },
+        get disposed() {
+            return disposed;
+        },
+        load(source) {
+            if (disposed) {
+                throw new Error('BitSubController has been disposed');
+            }
+            const activeVideo = assertVideo(boundVideo);
+            if (!hasSubtitleSource(source)) {
+                throw new Error('BitSubController.load requires subUrl, subContent, or a detectable fileName');
+            }
+            clearRenderer();
+            lastSource = { ...source };
+            renderer = createAutoSubtitleRenderer({
+                ...source,
+                video: activeVideo
+            });
+            return renderer;
+        },
+        clear() {
+            if (disposed)
+                return;
+            clearRenderer();
+            lastSource = null;
+        },
+        dispose() {
+            if (disposed)
+                return;
+            disposed = true;
+            clearRenderer();
+            lastSource = null;
+            boundVideo = null;
+        },
+        getDisplaySettings() {
+            return renderer?.getDisplaySettings() ?? null;
+        },
+        setDisplaySettings(settings) {
+            renderer?.setDisplaySettings(settings);
+        },
+        resetDisplaySettings() {
+            renderer?.resetDisplaySettings();
+        },
+        getStats() {
+            return renderer?.getStats() ?? null;
+        },
+        setVideo(nextVideo) {
+            if (disposed) {
+                throw new Error('BitSubController has been disposed');
+            }
+            if (nextVideo === boundVideo) {
+                // Same element: still materialize a pending source (e.g. delayed autoLoad).
+                if (nextVideo && !renderer && lastSource) {
+                    renderer = createAutoSubtitleRenderer({
+                        ...lastSource,
+                        video: nextVideo
+                    });
+                }
+                return;
+            }
+            const previousSource = lastSource;
+            clearRenderer();
+            boundVideo = nextVideo;
+            if (nextVideo && previousSource) {
+                lastSource = previousSource;
+                renderer = createAutoSubtitleRenderer({
+                    ...previousSource,
+                    video: nextVideo
+                });
+            }
+        }
+    };
+    if (autoLoad && lastSource) {
+        controller.load(lastSource);
+    }
+    return controller;
+}
+/** Convenience one-shot helper used by thin player wrappers. */
+export function createBitSubRenderer(video, source) {
+    return createAutoSubtitleRenderer({
+        ...source,
+        video: assertVideo(video)
+    });
+}
+//# sourceMappingURL=shared.js.map

package/dist/integrations/shared.js.map

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

package/dist/integrations/videojs.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Optional Video.js plugin for libbitsub bitmap subtitles.
+ *
+ * @example
+ * ```ts
+ * import videojs from 'video.js'
+ * import { registerBitSubPlugin } from 'libbitsub/videojs'
+ *
+ * registerBitSubPlugin(videojs)
+ * const player = videojs('my-video')
+ * player.bitsub({ subUrl: '/subs/movie.sup' })
+ * ```
+ */
+import { type AttachBitSubOptions, type BitSubController, type BitSubSourceOptions } from './shared';
+/** Minimal Video.js surface used by the plugin (avoids a hard dependency). */
+export interface VideoJsPlayerLike {
+    ready(callback: (this: this) => void): this;
+    el(): HTMLElement | null;
+    tech?: (asHtml?: boolean) => {
+        el?: () => HTMLElement | null;
+    } | HTMLElement | null | undefined;
+    on(type: string, handler: (...args: unknown[]) => void): this;
+    off?(type: string, handler: (...args: unknown[]) => void): this;
+    addClass?(className: string): void;
+    removeClass?(className: string): void;
+    trigger?(event: string, data?: unknown): void;
+}
+export interface VideoJsPluginBase {
+    player: VideoJsPlayerLike;
+    options_: unknown;
+    dispose(): void;
+}
+export interface VideoJsPluginConstructor {
+    new (player: VideoJsPlayerLike, options?: unknown): VideoJsPluginBase;
+    prototype: VideoJsPluginBase;
+}
+export interface VideoJsLike {
+    getPlugin(name: string): VideoJsPluginConstructor;
+    registerPlugin(name: string, plugin: unknown): void;
+}
+export type BitSubVideoJsOptions = AttachBitSubOptions;
+export interface BitSubVideoJsApi {
+    /** Active controller, if any. */
+    controller(): BitSubController | null;
+    /** Load or replace the subtitle track. */
+    load(source: BitSubSourceOptions): void;
+    /** Clear the current track. */
+    clear(): void;
+    /** Dispose plugin-owned resources (also runs on player dispose). */
+    dispose(): void;
+    setDisplaySettings(settings: Parameters<BitSubController['setDisplaySettings']>[0]): void;
+    getDisplaySettings(): ReturnType<BitSubController['getDisplaySettings']>;
+    getStats(): ReturnType<BitSubController['getStats']>;
+}
+/**
+ * Register the `bitsub` Video.js plugin.
+ * Safe to call multiple times — subsequent calls are no-ops once registered.
+ */
+export declare function registerBitSubPlugin(videojs: VideoJsLike, pluginName?: string): void;
+/**
+ * Ambient augmentation helper for apps using the default plugin name `bitsub`.
+ *
+ * @example
+ * ```ts
+ * import 'libbitsub/videojs' // side-effect free; types only when referenced
+ * // or in a global.d.ts:
+ * // import type {} from 'libbitsub/videojs'
+ * ```
+ *
+ * For full player typing, extend your video.js module:
+ * ```ts
+ * import type { BitSubVideoJsApi, BitSubVideoJsOptions } from 'libbitsub/videojs'
+ * declare module 'video.js' {
+ *   interface VideoJsPlayer {
+ *     bitsub(options?: BitSubVideoJsOptions): BitSubVideoJsApi
+ *   }
+ * }
+ * ```
+ */
+export type VideoJsBitSubPlayer = VideoJsPlayerLike & {
+    bitsub(options?: BitSubVideoJsOptions): BitSubVideoJsApi;
+};
+export type { AttachBitSubOptions, BitSubController, BitSubSourceOptions, BitSubRenderer } from './shared';
+export { attachBitSub, createBitSubRenderer } from './shared';
+//# sourceMappingURL=videojs.d.ts.map

package/dist/integrations/videojs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"videojs.d.ts","sourceRoot":"","sources":["../../src/integrations/videojs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAgB,KAAK,mBAAmB,EAAE,KAAK,gBAAgB,EAAE,KAAK,mBAAmB,EAAE,MAAM,UAAU,CAAA;AAElH,8EAA8E;AAC9E,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,GAAG,IAAI,CAAA;IAC3C,EAAE,IAAI,WAAW,GAAG,IAAI,CAAA;IACxB,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,OAAO,KAAK;QAAE,EAAE,CAAC,EAAE,MAAM,WAAW,GAAG,IAAI,CAAA;KAAE,GAAG,WAAW,GAAG,IAAI,GAAG,SAAS,CAAA;IAC/F,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,IAAI,CAAA;IAC7D,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,IAAI,CAAA;IAC/D,QAAQ,CAAC,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IAClC,WAAW,CAAC,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACrC,OAAO,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;CAC9C;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,iBAAiB,CAAA;IACzB,QAAQ,EAAE,OAAO,CAAA;IACjB,OAAO,IAAI,IAAI,CAAA;CAChB;AAED,MAAM,WAAW,wBAAwB;IACvC,KAAK,MAAM,EAAE,iBAAiB,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,iBAAiB,CAAA;IACrE,SAAS,EAAE,iBAAiB,CAAA;CAC7B;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,wBAAwB,CAAA;IACjD,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAAA;CACpD;AAED,MAAM,MAAM,oBAAoB,GAAG,mBAAmB,CAAA;AAEtD,MAAM,WAAW,gBAAgB;IAC/B,iCAAiC;IACjC,UAAU,IAAI,gBAAgB,GAAG,IAAI,CAAA;IACrC,0CAA0C;IAC1C,IAAI,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI,CAAA;IACvC,+BAA+B;IAC/B,KAAK,IAAI,IAAI,CAAA;IACb,oEAAoE;IACpE,OAAO,IAAI,IAAI,CAAA;IACf,kBAAkB,CAAC,QAAQ,EAAE,UAAU,CAAC,gBAAgB,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAA;IACzF,kBAAkB,IAAI,UAAU,CAAC,gBAAgB,CAAC,oBAAoB,CAAC,CAAC,CAAA;IACxE,QAAQ,IAAI,UAAU,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC,CAAA;CACrD;AAgBD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,WAAW,EAAE,UAAU,SAAW,GAAG,IAAI,CA8FtF;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,MAAM,mBAAmB,GAAG,iBAAiB,GAAG;IACpD,MAAM,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,gBAAgB,CAAA;CACzD,CAAA;AAED,YAAY,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAC1G,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAA"}

package/dist/integrations/videojs.js

@@ -0,0 +1,111 @@
+/**
+ * Optional Video.js plugin for libbitsub bitmap subtitles.
+ *
+ * @example
+ * ```ts
+ * import videojs from 'video.js'
+ * import { registerBitSubPlugin } from 'libbitsub/videojs'
+ *
+ * registerBitSubPlugin(videojs)
+ * const player = videojs('my-video')
+ * player.bitsub({ subUrl: '/subs/movie.sup' })
+ * ```
+ */
+import { attachBitSub } from './shared';
+function resolveVideoElement(player) {
+    const tech = typeof player.tech === 'function' ? player.tech(true) : undefined;
+    const techEl = tech && typeof tech.el === 'function'
+        ? tech.el()
+        : tech;
+    if (techEl instanceof HTMLVideoElement)
+        return techEl;
+    const root = player.el();
+    if (!root)
+        return null;
+    return root.querySelector('video');
+}
+/**
+ * Register the `bitsub` Video.js plugin.
+ * Safe to call multiple times — subsequent calls are no-ops once registered.
+ */
+export function registerBitSubPlugin(videojs, pluginName = 'bitsub') {
+    const existing = typeof videojs.getPlugin === 'function' ? videojs.getPlugin(pluginName) : undefined;
+    // Only skip when a previous registerBitSubPlugin call marked the plugin.
+    if (existing && existing.__libbitsubPlugin) {
+        return;
+    }
+    const Plugin = videojs.getPlugin('plugin');
+    class BitSubPlugin extends Plugin {
+        controllerRef = null;
+        onDispose;
+        onLoadedData;
+        initialOptions;
+        constructor(player, options = {}) {
+            super(player, options);
+            this.initialOptions = options;
+            this.onDispose = () => this.disposeController();
+            this.onLoadedData = () => this.ensureController(this.initialOptions, false);
+            player.ready(() => {
+                this.ensureController(options, true);
+                player.on('loadeddata', this.onLoadedData);
+                player.on('dispose', this.onDispose);
+                player.addClass?.('vjs-bitsub');
+            });
+        }
+        controller() {
+            return this.controllerRef;
+        }
+        load(source) {
+            const controller = this.ensureController({}, false);
+            controller.load(source);
+            this.player.trigger?.('bitsubload', source);
+        }
+        clear() {
+            this.controllerRef?.clear();
+            this.player.trigger?.('bitsubclear');
+        }
+        setDisplaySettings(settings) {
+            this.controllerRef?.setDisplaySettings(settings);
+        }
+        getDisplaySettings() {
+            return this.controllerRef?.getDisplaySettings() ?? null;
+        }
+        getStats() {
+            return this.controllerRef?.getStats() ?? null;
+        }
+        dispose() {
+            this.player.off?.('loadeddata', this.onLoadedData);
+            this.player.off?.('dispose', this.onDispose);
+            this.player.removeClass?.('vjs-bitsub');
+            this.disposeController();
+            super.dispose();
+        }
+        disposeController() {
+            this.controllerRef?.dispose();
+            this.controllerRef = null;
+        }
+        ensureController(options, allowAutoload) {
+            const video = resolveVideoElement(this.player);
+            if (!video) {
+                throw new Error('libbitsub Video.js plugin could not resolve an HTMLVideoElement');
+            }
+            if (this.controllerRef && !this.controllerRef.disposed) {
+                if (this.controllerRef.video !== video) {
+                    this.controllerRef.setVideo(video);
+                }
+                return this.controllerRef;
+            }
+            const { autoLoad = true, ...source } = options;
+            this.controllerRef = attachBitSub(video, {
+                ...source,
+                autoLoad: allowAutoload ? autoLoad : false
+            });
+            return this.controllerRef;
+        }
+    }
+    ;
+    BitSubPlugin.__libbitsubPlugin = true;
+    videojs.registerPlugin(pluginName, BitSubPlugin);
+}
+export { attachBitSub, createBitSubRenderer } from './shared';
+//# sourceMappingURL=videojs.js.map

package/dist/integrations/videojs.js.map

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

package/dist/ts/diagnostics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../src/ts/diagnostics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,6BAA6B,EAC7B,2BAA2B,EAC3B,2BAA2B,EAC3B,yBAAyB,EACzB,6BAA6B,EAC7B,kBAAkB,EACnB,MAAM,SAAS,CAAA;AAEhB,UAAU,yBAAyB;IACjC,MAAM,CAAC,EAAE,kBAAkB,CAAA;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,6BAA6B,CAAC,CAAA;IACvD,YAAY,CAAC,EAAE,2BAA2B,CAAA;CAC3C;AAED,qBAAa,uBAAwB,SAAQ,KAAM,YAAW,2BAA2B;IACvF,QAAQ,CAAC,IAAI,EAAE,2BAA2B,CAAA;IAC1C,QAAQ,CAAC,MAAM,CAAC,EAAE,kBAAkB,CAAA;IACpC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,6BAA6B,CAAC,CAAA;IAChE,SAAkB,KAAK,CAAC,EAAE,OAAO,CAAA;IAEjC,YACE,IAAI,EAAE,2BAA2B,EACjC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QACP,MAAM,CAAC,EAAE,kBAAkB,CAAA;QAC3B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,6BAA6B,CAAC,CAAA;QACvD,KAAK,CAAC,EAAE,OAAO,CAAA;KACX,EAQP;CACF;AAED,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,2BAA2B,EACjC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;IACP,MAAM,CAAC,EAAE,kBAAkB,CAAA;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,6BAA6B,CAAC,CAAA;IACvD,KAAK,CAAC,EAAE,OAAO,CAAA;CACX,GACL,uBAAuB,CAEzB;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,yBAA8B,GACtC,uBAAuB,CAazB;AAED,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,6BAA6B,EACnC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;IACP,MAAM,CAAC,EAAE,kBAAkB,CAAA;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,6BAA6B,CAAC,CAAA;CACnD,GACL,yBAAyB,CAQ3B;AAED,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACtC,OAAO,GAAE;IACP,MAAM,CAAC,EAAE,kBAAkB,CAAA;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAA;CACb,GACL,yBAAyB,GAAG,IAAI,CA4BlC;AAED,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,yBAAyB,GAAG,MAAM,CAE1F"}
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../src/ts/diagnostics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,6BAA6B,EAC7B,2BAA2B,EAC3B,2BAA2B,EAC3B,yBAAyB,EACzB,6BAA6B,EAC7B,kBAAkB,EACnB,MAAM,SAAS,CAAA;AAEhB,UAAU,yBAAyB;IACjC,MAAM,CAAC,EAAE,kBAAkB,CAAA;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,6BAA6B,CAAC,CAAA;IACvD,YAAY,CAAC,EAAE,2BAA2B,CAAA;CAC3C;AAED,qBAAa,uBAAwB,SAAQ,KAAM,YAAW,2BAA2B;IACvF,QAAQ,CAAC,IAAI,EAAE,2BAA2B,CAAA;IAC1C,QAAQ,CAAC,MAAM,CAAC,EAAE,kBAAkB,CAAA;IACpC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,6BAA6B,CAAC,CAAA;IAChE,SAAkB,KAAK,CAAC,EAAE,OAAO,CAAA;IAEjC,YACE,IAAI,EAAE,2BAA2B,EACjC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QACP,MAAM,CAAC,EAAE,kBAAkB,CAAA;QAC3B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,6BAA6B,CAAC,CAAA;QACvD,KAAK,CAAC,EAAE,OAAO,CAAA;KACX,EAQP;CACF;AAED,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,2BAA2B,EACjC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;IACP,MAAM,CAAC,EAAE,kBAAkB,CAAA;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,6BAA6B,CAAC,CAAA;IACvD,KAAK,CAAC,EAAE,OAAO,CAAA;CACX,GACL,uBAAuB,CAEzB;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,yBAA8B,GACtC,uBAAuB,CAazB;AAED,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,6BAA6B,EACnC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;IACP,MAAM,CAAC,EAAE,kBAAkB,CAAA;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,6BAA6B,CAAC,CAAA;CACnD,GACL,yBAAyB,CAQ3B;AAED,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACtC,OAAO,GAAE;IACP,MAAM,CAAC,EAAE,kBAAkB,CAAA;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAA;CACb,GACL,yBAAyB,GAAG,IAAI,CAwClC;AAED,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,yBAAyB,GAAG,MAAM,CAE1F"}