libbitsub 1.0.0

package/dist/ts/parsers.js

@@ -0,0 +1,366 @@
+/**
+ * Low-level subtitle parsers for libbitsub.
+ * Use these for programmatic access to subtitle data without video integration.
+ */
+import { getWasm } from './wasm';
+/**
+ * Low-level PGS subtitle parser using WASM.
+ * Use this for programmatic access to PGS data without video integration.
+ */
+export class PgsParser {
+    parser = null;
+    timestamps = new Float64Array(0);
+    constructor() {
+        const wasm = getWasm();
+        this.parser = new wasm.PgsParser();
+    }
+    /**
+     * Load PGS subtitle data from a Uint8Array.
+     */
+    load(data) {
+        if (!this.parser)
+            throw new Error('Parser not initialized');
+        const count = this.parser.parse(data);
+        this.timestamps = this.parser.getTimestamps();
+        return count;
+    }
+    /**
+     * Get all timestamps in milliseconds.
+     */
+    getTimestamps() {
+        return this.timestamps;
+    }
+    /**
+     * Get the number of display sets.
+     */
+    get count() {
+        return this.parser?.count ?? 0;
+    }
+    /**
+     * Find the display set index for a given timestamp in seconds.
+     */
+    findIndexAtTimestamp(timeSeconds) {
+        if (!this.parser)
+            return -1;
+        return this.parser.findIndexAtTimestamp(timeSeconds * 1000);
+    }
+    /**
+     * Render subtitle at the given index.
+     */
+    renderAtIndex(index) {
+        if (!this.parser)
+            return undefined;
+        const frame = this.parser.renderAtIndex(index);
+        if (!frame)
+            return undefined;
+        return this.convertFrame(frame);
+    }
+    /**
+     * Render subtitle at the given timestamp in seconds.
+     */
+    renderAtTimestamp(timeSeconds) {
+        const index = this.findIndexAtTimestamp(timeSeconds);
+        if (index < 0)
+            return undefined;
+        return this.renderAtIndex(index);
+    }
+    /**
+     * Convert WASM frame to SubtitleData.
+     */
+    convertFrame(frame) {
+        const compositionData = [];
+        for (let i = 0; i < frame.compositionCount; i++) {
+            const comp = frame.getComposition(i);
+            if (!comp)
+                continue;
+            const rgba = comp.getRgba();
+            const expectedLength = comp.width * comp.height * 4;
+            // Validate buffer size
+            if (rgba.length !== expectedLength || comp.width === 0 || comp.height === 0) {
+                console.warn(`Invalid composition data: expected ${expectedLength} bytes, got ${rgba.length}, size=${comp.width}x${comp.height}`);
+                continue;
+            }
+            // Copy to new Uint8ClampedArray to ensure proper buffer ownership
+            const clampedData = new Uint8ClampedArray(rgba.length);
+            clampedData.set(rgba);
+            const imageData = new ImageData(clampedData, comp.width, comp.height);
+            compositionData.push({
+                pixelData: imageData,
+                x: comp.x,
+                y: comp.y
+            });
+        }
+        return {
+            width: frame.width,
+            height: frame.height,
+            compositionData
+        };
+    }
+    /**
+     * Clear internal caches.
+     */
+    clearCache() {
+        this.parser?.clearCache();
+    }
+    /**
+     * Dispose of resources.
+     */
+    dispose() {
+        this.parser?.free();
+        this.parser = null;
+        this.timestamps = new Float64Array(0);
+    }
+}
+/**
+ * Low-level VobSub subtitle parser using WASM.
+ * Use this for programmatic access to VobSub data without video integration.
+ */
+export class VobSubParserLowLevel {
+    parser = null;
+    timestamps = new Float64Array(0);
+    constructor() {
+        const wasm = getWasm();
+        this.parser = new wasm.VobSubParser();
+    }
+    /**
+     * Load VobSub from IDX and SUB data.
+     */
+    loadFromData(idxContent, subData) {
+        if (!this.parser)
+            throw new Error('Parser not initialized');
+        this.parser.loadFromData(idxContent, subData);
+        this.timestamps = this.parser.getTimestamps();
+    }
+    /**
+     * Load VobSub from SUB file only.
+     */
+    loadFromSubOnly(subData) {
+        if (!this.parser)
+            throw new Error('Parser not initialized');
+        this.parser.loadFromSubOnly(subData);
+        this.timestamps = this.parser.getTimestamps();
+    }
+    /**
+     * Get all timestamps in milliseconds.
+     */
+    getTimestamps() {
+        return this.timestamps;
+    }
+    /**
+     * Get the number of subtitle entries.
+     */
+    get count() {
+        return this.parser?.count ?? 0;
+    }
+    /**
+     * Find the subtitle index for a given timestamp in seconds.
+     */
+    findIndexAtTimestamp(timeSeconds) {
+        if (!this.parser)
+            return -1;
+        return this.parser.findIndexAtTimestamp(timeSeconds * 1000);
+    }
+    /**
+     * Render subtitle at the given index.
+     */
+    renderAtIndex(index) {
+        if (!this.parser)
+            return undefined;
+        const frame = this.parser.renderAtIndex(index);
+        if (!frame)
+            return undefined;
+        return this.convertFrame(frame);
+    }
+    /**
+     * Render subtitle at the given timestamp in seconds.
+     */
+    renderAtTimestamp(timeSeconds) {
+        const index = this.findIndexAtTimestamp(timeSeconds);
+        if (index < 0)
+            return undefined;
+        return this.renderAtIndex(index);
+    }
+    /**
+     * Convert WASM frame to SubtitleData.
+     */
+    convertFrame(frame) {
+        const rgba = frame.getRgba();
+        const expectedLength = frame.width * frame.height * 4;
+        // Validate buffer size
+        if (rgba.length !== expectedLength || frame.width === 0 || frame.height === 0) {
+            console.warn(`Invalid VobSub frame: expected ${expectedLength} bytes, got ${rgba.length}, size=${frame.width}x${frame.height}`);
+            return {
+                width: frame.screenWidth,
+                height: frame.screenHeight,
+                compositionData: []
+            };
+        }
+        // Copy to new Uint8ClampedArray to ensure proper buffer ownership
+        const clampedData = new Uint8ClampedArray(rgba.length);
+        clampedData.set(rgba);
+        const imageData = new ImageData(clampedData, frame.width, frame.height);
+        return {
+            width: frame.screenWidth,
+            height: frame.screenHeight,
+            compositionData: [
+                {
+                    pixelData: imageData,
+                    x: frame.x,
+                    y: frame.y
+                }
+            ]
+        };
+    }
+    /**
+     * Clear internal caches.
+     */
+    clearCache() {
+        this.parser?.clearCache();
+    }
+    /**
+     * Dispose of resources.
+     */
+    dispose() {
+        this.parser?.free();
+        this.parser = null;
+        this.timestamps = new Float64Array(0);
+    }
+}
+/**
+ * Unified subtitle parser that handles both PGS and VobSub formats.
+ */
+export class UnifiedSubtitleParser {
+    renderer = null;
+    timestamps = new Float64Array(0);
+    constructor() {
+        const wasm = getWasm();
+        this.renderer = new wasm.SubtitleRenderer();
+    }
+    /**
+     * Load PGS subtitle data.
+     */
+    loadPgs(data) {
+        if (!this.renderer)
+            throw new Error('Renderer not initialized');
+        const count = this.renderer.loadPgs(data);
+        this.timestamps = this.renderer.getTimestamps();
+        return count;
+    }
+    /**
+     * Load VobSub from IDX and SUB data.
+     */
+    loadVobSub(idxContent, subData) {
+        if (!this.renderer)
+            throw new Error('Renderer not initialized');
+        this.renderer.loadVobSub(idxContent, subData);
+        this.timestamps = this.renderer.getTimestamps();
+    }
+    /**
+     * Load VobSub from SUB file only.
+     */
+    loadVobSubOnly(subData) {
+        if (!this.renderer)
+            throw new Error('Renderer not initialized');
+        this.renderer.loadVobSubOnly(subData);
+        this.timestamps = this.renderer.getTimestamps();
+    }
+    /**
+     * Get the current subtitle format.
+     */
+    get format() {
+        const fmt = this.renderer?.format;
+        if (fmt === 0)
+            return 'pgs';
+        if (fmt === 1)
+            return 'vobsub';
+        return null;
+    }
+    /**
+     * Get all timestamps in milliseconds.
+     */
+    getTimestamps() {
+        return this.timestamps;
+    }
+    /**
+     * Get the number of subtitle entries.
+     */
+    get count() {
+        return this.renderer?.count ?? 0;
+    }
+    /**
+     * Find the subtitle index for a given timestamp in seconds.
+     */
+    findIndexAtTimestamp(timeSeconds) {
+        if (!this.renderer)
+            return -1;
+        return this.renderer.findIndexAtTimestamp(timeSeconds * 1000);
+    }
+    /**
+     * Render subtitle at the given index.
+     */
+    renderAtIndex(index) {
+        if (!this.renderer)
+            return undefined;
+        const result = this.renderer.renderAtIndex(index);
+        if (!result)
+            return undefined;
+        return this.convertResult(result);
+    }
+    /**
+     * Render subtitle at the given timestamp in seconds.
+     */
+    renderAtTimestamp(timeSeconds) {
+        if (!this.renderer)
+            return undefined;
+        const result = this.renderer.renderAtTimestamp(timeSeconds);
+        if (!result)
+            return undefined;
+        return this.convertResult(result);
+    }
+    /**
+     * Convert WASM result to SubtitleData.
+     */
+    convertResult(result) {
+        const compositionData = [];
+        for (let i = 0; i < result.compositionCount; i++) {
+            const rgba = result.getCompositionRgba(i);
+            const width = result.getCompositionWidth(i);
+            const height = result.getCompositionHeight(i);
+            const expectedLength = width * height * 4;
+            if (width > 0 && height > 0 && rgba.length === expectedLength) {
+                const clampedData = new Uint8ClampedArray(rgba.length);
+                clampedData.set(rgba);
+                const imageData = new ImageData(clampedData, width, height);
+                compositionData.push({
+                    pixelData: imageData,
+                    x: result.getCompositionX(i),
+                    y: result.getCompositionY(i)
+                });
+            }
+            else if (width > 0 && height > 0) {
+                console.warn(`Invalid unified result: expected ${expectedLength} bytes, got ${rgba.length}, size=${width}x${height}`);
+            }
+        }
+        return {
+            width: result.screenWidth,
+            height: result.screenHeight,
+            compositionData
+        };
+    }
+    /**
+     * Clear internal caches.
+     */
+    clearCache() {
+        this.renderer?.clearCache();
+    }
+    /**
+     * Dispose of resources.
+     */
+    dispose() {
+        this.renderer?.dispose();
+        this.renderer?.free();
+        this.renderer = null;
+        this.timestamps = new Float64Array(0);
+    }
+}
+//# sourceMappingURL=parsers.js.map

package/dist/ts/parsers.js.map

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

package/dist/ts/renderers.d.ts

@@ -0,0 +1,155 @@
+/**
+ * High-level video-integrated subtitle renderers for libbitsub.
+ * Handles canvas overlay, video sync, and subtitle fetching.
+ */
+import type { SubtitleData, SubtitleDisplaySettings, VideoSubtitleOptions, VideoVobSubOptions } from './types';
+/** Performance statistics for subtitle renderer */
+export interface SubtitleRendererStats {
+    /** Total frames rendered since initialization */
+    framesRendered: number;
+    /** Frames dropped due to slow rendering */
+    framesDropped: number;
+    /** Average render time in milliseconds */
+    avgRenderTime: number;
+    /** Maximum render time in milliseconds */
+    maxRenderTime: number;
+    /** Minimum render time in milliseconds */
+    minRenderTime: number;
+    /** Last render time in milliseconds */
+    lastRenderTime: number;
+    /** Current FPS (renders per second) */
+    renderFps: number;
+    /** Whether rendering is using web worker */
+    usingWorker: boolean;
+    /** Number of cached frames */
+    cachedFrames: number;
+    /** Number of pending renders */
+    pendingRenders: number;
+    /** Total subtitle entries/display sets */
+    totalEntries: number;
+    /** Current subtitle index being displayed */
+    currentIndex: number;
+}
+/**
+ * Base class for video-integrated subtitle renderers.
+ * Handles canvas overlay, video sync, and subtitle fetching.
+ */
+declare abstract class BaseVideoSubtitleRenderer {
+    protected video: HTMLVideoElement;
+    protected subUrl: string;
+    protected canvas: HTMLCanvasElement | null;
+    protected ctx: CanvasRenderingContext2D | null;
+    protected animationFrameId: number | null;
+    protected isLoaded: boolean;
+    protected lastRenderedIndex: number;
+    protected lastRenderedTime: number;
+    protected disposed: boolean;
+    protected resizeObserver: ResizeObserver | null;
+    protected tempCanvas: HTMLCanvasElement | null;
+    protected tempCtx: CanvasRenderingContext2D | null;
+    protected lastRenderedData: SubtitleData | null;
+    /** Display settings for subtitle rendering */
+    protected displaySettings: SubtitleDisplaySettings;
+    protected perfStats: {
+        framesRendered: number;
+        framesDropped: number;
+        renderTimes: number[];
+        lastRenderTime: number;
+        fpsTimestamps: number[];
+        lastFrameTime: number;
+    };
+    constructor(options: VideoSubtitleOptions);
+    /** Get current display settings */
+    getDisplaySettings(): SubtitleDisplaySettings;
+    /** Get performance statistics */
+    abstract getStats(): SubtitleRendererStats;
+    /** Get base stats common to all renderers */
+    protected getBaseStats(): Omit<SubtitleRendererStats, 'usingWorker' | 'cachedFrames' | 'pendingRenders' | 'totalEntries'>;
+    /** Set display settings and force re-render */
+    setDisplaySettings(settings: Partial<SubtitleDisplaySettings>): void;
+    /** Reset display settings to defaults */
+    resetDisplaySettings(): void;
+    /** Start initialization. */
+    protected startInit(): void;
+    /** Initialize the renderer. */
+    protected init(): Promise<void>;
+    /** Create the canvas overlay positioned over the video. */
+    protected createCanvas(): void;
+    /** Called when video seeks. */
+    protected onSeek(): void;
+    /** Calculate the actual video content bounds, accounting for letterboxing/pillarboxing */
+    protected getVideoContentBounds(): {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    /** Update canvas size to match video content area. */
+    protected updateCanvasSize(): void;
+    protected abstract loadSubtitles(): Promise<void>;
+    protected abstract renderAtTime(time: number): SubtitleData | undefined;
+    protected abstract findCurrentIndex(time: number): number;
+    protected abstract renderAtIndex(index: number): SubtitleData | undefined;
+    /** Check if a render is pending for the given index (async loading in progress) */
+    protected abstract isPendingRender(index: number): boolean;
+    /** Start the render loop. */
+    protected startRenderLoop(): void;
+    /** Render a subtitle frame to the canvas. */
+    protected renderFrame(time: number, index: number): void;
+    /** Dispose of all resources. */
+    dispose(): void;
+}
+/**
+ * High-level PGS subtitle renderer with Web Worker support.
+ * Compatible with the old libpgs-js API.
+ */
+export declare class PgsRenderer extends BaseVideoSubtitleRenderer {
+    private pgsParser;
+    private state;
+    private onLoading?;
+    private onLoaded?;
+    private onError?;
+    constructor(options: VideoSubtitleOptions);
+    protected loadSubtitles(): Promise<void>;
+    private loadOnMainThread;
+    /** Yield to main thread to prevent UI blocking */
+    private yieldToMain;
+    protected renderAtTime(time: number): SubtitleData | undefined;
+    protected findCurrentIndex(time: number): number;
+    protected renderAtIndex(index: number): SubtitleData | undefined;
+    protected isPendingRender(index: number): boolean;
+    protected onSeek(): void;
+    /** Get performance statistics for PGS renderer */
+    getStats(): SubtitleRendererStats;
+    dispose(): void;
+}
+/**
+ * High-level VobSub subtitle renderer with Web Worker support.
+ * Compatible with the old libpgs-js API.
+ */
+export declare class VobSubRenderer extends BaseVideoSubtitleRenderer {
+    private vobsubParser;
+    private idxUrl;
+    private state;
+    private onLoading?;
+    private onLoaded?;
+    private onError?;
+    private cachedIndex;
+    private cachedIndexTime;
+    private pendingIndexLookup;
+    constructor(options: VideoVobSubOptions);
+    protected loadSubtitles(): Promise<void>;
+    private loadOnMainThread;
+    /** Yield to main thread to prevent UI blocking */
+    private yieldToMain;
+    protected renderAtTime(time: number): SubtitleData | undefined;
+    protected findCurrentIndex(time: number): number;
+    protected renderAtIndex(index: number): SubtitleData | undefined;
+    protected isPendingRender(index: number): boolean;
+    protected onSeek(): void;
+    /** Get performance statistics for VobSub renderer */
+    getStats(): SubtitleRendererStats;
+    dispose(): void;
+}
+export {};
+//# sourceMappingURL=renderers.d.ts.map

package/dist/ts/renderers.d.ts.map

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