libbitsub 1.10.2 → 1.11.0

package/dist/ts/worker.js

@@ -2,7 +2,7 @@
  * Web Worker management for libbitsub.
  * Handles off-main-thread subtitle parsing and rendering.
  */
-import { getWasmUrl } from './wasm';
+import { getWasmGlueUrl, getWasmUrl } from './wasm';
 let sharedWorker = null;
 let workerInitPromise = null;
 let messageId = 0;
@@ -15,61 +15,9 @@ export function isWorkerAvailable() {
 function createWorkerScript() {
     return `
 let wasmModule = null;
-let wasm;
-let cachedUint8Memory = null;
-let WASM_VECTOR_LEN = 0;
-let cachedTextEncoder = new TextEncoder();
-let cachedTextDecoder = new TextDecoder('utf-8', { ignoreBOM: true, fatal: true });
 const pgsParsers = new Map();
 const vobSubParsers = new Map();
 
-function getUint8Memory() {
-    if (cachedUint8Memory === null || cachedUint8Memory.byteLength === 0) {
-        cachedUint8Memory = new Uint8Array(wasm.memory.buffer);
-    }
-    return cachedUint8Memory;
-}
-
-function passArray8ToWasm(arg) {
-    const ptr = wasm.__wbindgen_malloc(arg.length);
-    getUint8Memory().set(arg, ptr);
-    WASM_VECTOR_LEN = arg.length;
-    return ptr;
-}
-
-const encodeString = typeof cachedTextEncoder.encodeInto === 'function'
-    ? function(arg, view) { return cachedTextEncoder.encodeInto(arg, view); }
-    : function(arg, view) {
-            const buf = cachedTextEncoder.encode(arg);
-            view.set(buf);
-            return { read: arg.length, written: buf.length };
-        };
-
-function passStringToWasm(arg) {
-    let len = arg.length;
-    let ptr = wasm.__wbindgen_malloc(len);
-    const mem = getUint8Memory();
-    let offset = 0;
-    for (; offset < len; offset++) {
-        const code = arg.charCodeAt(offset);
-        if (code > 0x7F) break;
-        mem[ptr + offset] = code;
-    }
-    if (offset !== len) {
-        if (offset !== 0) arg = arg.slice(offset);
-        ptr = wasm.__wbindgen_realloc(ptr, len, len = offset + arg.length * 3);
-        const view = getUint8Memory().subarray(ptr + offset, ptr + len);
-        const ret = encodeString(arg, view);
-        offset += ret.written;
-    }
-    WASM_VECTOR_LEN = offset;
-    return ptr;
-}
-
-function getStringFromWasm(ptr, len) {
-    return cachedTextDecoder.decode(getUint8Memory().subarray(ptr, ptr + len));
-}
-
 function buildPgsMetadata(parser) {
     return {
         format: 'pgs',
@@ -104,72 +52,18 @@ function disposeSession(sessionId) {
     }
 }
 
-async function initWasm(wasmUrl) {
-    if (wasm) return;
+async function initWasm(wasmUrl, glueUrl) {
+    if (wasmModule) return;
 
-    const response = await fetch(wasmUrl);
-    if (!response.ok) {
-        throw new Error('Failed to fetch WASM: ' + response.status);
+    let jsGlueUrl = glueUrl;
+    if (!jsGlueUrl) {
+        const derivedUrl = new URL(wasmUrl);
+        derivedUrl.pathname = derivedUrl.pathname.replace(/_bg\.wasm$/, '.js');
+        jsGlueUrl = derivedUrl.href;
     }
-
-    const wasmBytes = await response.arrayBuffer();
-    const result = await WebAssembly.instantiate(wasmBytes, {
-        __wbindgen_placeholder__: {
-            __wbindgen_throw: function(ptr, len) {
-                throw new Error(getStringFromWasm(ptr, len));
-            }
-        }
-    });
-    wasm = result.instance.exports;
-
-    wasmModule = {
-        PgsParser: class {
-            constructor() { this.ptr = wasm.pgsparser_new(); }
-            parse(data) {
-                const ptr = passArray8ToWasm(data);
-                return wasm.pgsparser_parse(this.ptr, ptr, WASM_VECTOR_LEN);
-            }
-            getTimestamps() { return wasm.pgsparser_getTimestamps(this.ptr); }
-            renderAtIndex(idx) { return wasm.pgsparser_renderAtIndex(this.ptr, idx); }
-            findIndexAtTimestamp(ts) { return wasm.pgsparser_findIndexAtTimestamp(this.ptr, ts); }
-            clearCache() { wasm.pgsparser_clearCache(this.ptr); }
-            free() { wasm.pgsparser_free(this.ptr); }
-            get count() { return wasm.pgsparser_count(this.ptr); }
-            get screenWidth() { return wasm.pgsparser_screenWidth(this.ptr); }
-            get screenHeight() { return wasm.pgsparser_screenHeight(this.ptr); }
-        },
-        VobSubParser: class {
-            constructor() { this.ptr = wasm.vobsubparser_new(); }
-            loadFromData(idx, sub) {
-                const idxPtr = passStringToWasm(idx);
-                const idxLen = WASM_VECTOR_LEN;
-                const subPtr = passArray8ToWasm(sub);
-                wasm.vobsubparser_loadFromData(this.ptr, idxPtr, idxLen, subPtr, sub.length);
-            }
-            loadFromMks(sub) {
-                const ptr = passArray8ToWasm(sub);
-                wasm.vobsubparser_loadFromMks(this.ptr, ptr, WASM_VECTOR_LEN);
-            }
-            loadFromSubOnly(sub) {
-                const ptr = passArray8ToWasm(sub);
-                wasm.vobsubparser_loadFromSubOnly(this.ptr, ptr, WASM_VECTOR_LEN);
-            }
-            getTimestamps() { return wasm.vobsubparser_getTimestamps(this.ptr); }
-            renderAtIndex(idx) { return wasm.vobsubparser_renderAtIndex(this.ptr, idx); }
-            findIndexAtTimestamp(ts) { return wasm.vobsubparser_findIndexAtTimestamp(this.ptr, ts); }
-            clearCache() { wasm.vobsubparser_clearCache(this.ptr); }
-            free() { wasm.vobsubparser_free(this.ptr); }
-            setDebandEnabled(enabled) { wasm.vobsubparser_setDebandEnabled(this.ptr, enabled); }
-            setDebandThreshold(threshold) { wasm.vobsubparser_setDebandThreshold(this.ptr, threshold); }
-            setDebandRange(range) { wasm.vobsubparser_setDebandRange(this.ptr, range); }
-            get count() { return wasm.vobsubparser_count(this.ptr); }
-            get screenWidth() { return wasm.vobsubparser_screenWidth(this.ptr); }
-            get screenHeight() { return wasm.vobsubparser_screenHeight(this.ptr); }
-            get language() { return wasm.vobsubparser_language(this.ptr); }
-            get trackId() { return wasm.vobsubparser_trackId(this.ptr); }
-            get hasIdxMetadata() { return !!wasm.vobsubparser_hasIdxMetadata(this.ptr); }
-        }
-    };
+    const mod = await import(jsGlueUrl);
+    await mod.default({ module_or_path: wasmUrl });
+    wasmModule = mod;
 }
 
 function convertFrame(frame, isVobSub) {
@@ -205,7 +99,7 @@ self.onmessage = async function(event) {
     try {
         switch (request.type) {
             case 'init': {
-                await initWasm(request.wasmUrl);
+                await initWasm(request.wasmUrl, request.glueUrl);
                 postResponse({ type: 'initComplete', success: true }, [], _id);
                 break;
             }
@@ -222,6 +116,50 @@ self.onmessage = async function(event) {
                 );
                 break;
             }
+            case 'beginPgs': {
+                disposeSession(request.sessionId);
+                const parser = new wasmModule.PgsParser();
+                parser.reset();
+                pgsParsers.set(request.sessionId, parser);
+                const timestamps = parser.getTimestamps();
+                postResponse(
+                    { type: 'pgsProgress', count: 0, added: 0, partial: true, metadata: buildPgsMetadata(parser), timestamps },
+                    [timestamps.buffer],
+                    _id
+                );
+                break;
+            }
+            case 'appendPgs': {
+                let parser = pgsParsers.get(request.sessionId);
+                if (!parser) {
+                    parser = new wasmModule.PgsParser();
+                    parser.reset();
+                    pgsParsers.set(request.sessionId, parser);
+                }
+                const added = parser.feed(new Uint8Array(request.data));
+                const timestamps = parser.getTimestamps();
+                postResponse(
+                    { type: 'pgsProgress', count: parser.count, added, partial: true, metadata: buildPgsMetadata(parser), timestamps },
+                    [timestamps.buffer],
+                    _id
+                );
+                break;
+            }
+            case 'finishPgs': {
+                const parser = pgsParsers.get(request.sessionId);
+                if (!parser) {
+                    postResponse({ type: 'error', message: 'PGS session not found for finishPgs' }, [], _id);
+                    break;
+                }
+                const count = parser.finishFeed();
+                const timestamps = parser.getTimestamps();
+                postResponse(
+                    { type: 'pgsProgress', count, added: 0, partial: false, metadata: buildPgsMetadata(parser), timestamps },
+                    [timestamps.buffer],
+                    _id
+                );
+                break;
+            }
             case 'loadVobSub': {
                 disposeSession(request.sessionId);
                 const parser = new wasmModule.VobSubParser();
@@ -235,6 +173,48 @@ self.onmessage = async function(event) {
                 );
                 break;
             }
+            case 'loadVobSubIdx': {
+                disposeSession(request.sessionId);
+                const parser = new wasmModule.VobSubParser();
+                parser.loadFromIdx(request.idxContent);
+                const timestamps = parser.getTimestamps();
+                vobSubParsers.set(request.sessionId, parser);
+                postResponse(
+                    {
+                        type: 'vobSubProgress',
+                        count: parser.count,
+                        partial: true,
+                        hasSubData: !!parser.hasSubData,
+                        metadata: buildVobSubMetadata(parser),
+                        timestamps
+                    },
+                    [timestamps.buffer],
+                    _id
+                );
+                break;
+            }
+            case 'attachVobSubData': {
+                const parser = vobSubParsers.get(request.sessionId);
+                if (!parser) {
+                    postResponse({ type: 'error', message: 'VobSub session not found for attachVobSubData' }, [], _id);
+                    break;
+                }
+                parser.attachSubData(new Uint8Array(request.subData));
+                const timestamps = parser.getTimestamps();
+                postResponse(
+                    {
+                        type: 'vobSubProgress',
+                        count: parser.count,
+                        partial: false,
+                        hasSubData: !!parser.hasSubData,
+                        metadata: buildVobSubMetadata(parser),
+                        timestamps
+                    },
+                    [timestamps.buffer],
+                    _id
+                );
+                break;
+            }
             case 'loadVobSubMks': {
                 disposeSession(request.sessionId);
                 const parser = new wasmModule.VobSubParser();
@@ -350,57 +330,108 @@ self.onmessage = async function(event) {
     }
 };`;
 }
+/** Whether the shared worker has finished WASM initialization. */
+export function isWorkerReady() {
+    return sharedWorker !== null;
+}
 /** Create or get the shared worker instance. */
 export function getOrCreateWorker() {
     if (sharedWorker)
         return Promise.resolve(sharedWorker);
     if (workerInitPromise)
         return workerInitPromise;
-    workerInitPromise = new Promise((resolve, reject) => {
+    const initPromise = initializeWorker();
+    workerInitPromise = initPromise;
+    void initPromise.then(() => {
+        if (workerInitPromise === initPromise)
+            workerInitPromise = null;
+    }, () => {
+        if (workerInitPromise === initPromise)
+            workerInitPromise = null;
+    });
+    return initPromise;
+}
+/** Pre-initialize the shared subtitle worker. */
+export function warmup() {
+    return ready();
+}
+/** Wait until the shared worker is ready for parse/render requests. */
+export async function ready() {
+    if (!isWorkerAvailable())
+        return;
+    if (sharedWorker)
+        return;
+    await getOrCreateWorker();
+}
+async function initializeWorker() {
+    const blob = new Blob([createWorkerScript()], { type: 'application/javascript' });
+    const workerUrl = URL.createObjectURL(blob);
+    let worker;
+    try {
+        worker = new Worker(workerUrl, { type: 'module' });
+    }
+    catch (error) {
+        URL.revokeObjectURL(workerUrl);
+        throw error instanceof Error ? error : new Error(String(error));
+    }
+    worker.onmessage = (event) => {
+        const { _id, ...response } = event.data;
+        if (_id === undefined)
+            return;
+        const callback = pendingCallbacks.get(_id);
+        if (!callback)
+            return;
+        pendingCallbacks.delete(_id);
+        if (response.type === 'error' && callback.requestType === 'init') {
+            callback.reject(new Error(response.message));
+        }
+        else {
+            callback.resolve(response);
+        }
+    };
+    worker.onerror = (event) => {
+        const error = event instanceof ErrorEvent ? new Error(event.message) : new Error(String(event));
+        rejectWorkerCallbacks(worker, error);
+        if (sharedWorker === worker)
+            sharedWorker = null;
         try {
-            const blob = new Blob([createWorkerScript()], { type: 'application/javascript' });
-            const workerUrl = URL.createObjectURL(blob);
-            const worker = new Worker(workerUrl, { type: 'module' });
-            let initialized = false;
-            worker.onmessage = (event) => {
-                const { _id, ...response } = event.data;
-                if (_id !== undefined) {
-                    const callback = pendingCallbacks.get(_id);
-                    if (callback) {
-                        pendingCallbacks.delete(_id);
-                        callback.resolve(response);
-                    }
-                }
-            };
-            worker.onerror = (error) => {
-                if (!initialized) {
-                    URL.revokeObjectURL(workerUrl);
-                    worker.terminate();
-                    workerInitPromise = null;
-                    reject(error instanceof ErrorEvent ? new Error(error.message) : new Error(String(error)));
-                }
-            };
-            sendToWorkerInstance(worker, { type: 'init', wasmUrl: getWasmUrl() })
-                .then(() => {
-                URL.revokeObjectURL(workerUrl);
-                initialized = true;
-                sharedWorker = worker;
-                workerInitPromise = null;
-                resolve(worker);
-            })
-                .catch((err) => {
-                URL.revokeObjectURL(workerUrl);
-                worker.terminate();
-                workerInitPromise = null;
-                reject(err);
-            });
+            worker.terminate();
         }
-        catch (error) {
-            workerInitPromise = null;
-            reject(error instanceof Error ? error : new Error(String(error)));
+        catch {
+            /* ignore */
         }
-    });
-    return workerInitPromise;
+    };
+    try {
+        const initResponse = await sendToWorkerInstance(worker, {
+            type: 'init',
+            wasmUrl: getWasmUrl(),
+            glueUrl: getWasmGlueUrl()
+        });
+        if (initResponse.type === 'error') {
+            throw new Error(initResponse.message);
+        }
+        if (initResponse.type !== 'initComplete' || !initResponse.success) {
+            throw new Error('Worker WASM initialization failed');
+        }
+        sharedWorker = worker;
+        return worker;
+    }
+    catch (error) {
+        const workerError = error instanceof Error ? error : new Error(String(error));
+        rejectWorkerCallbacks(worker, workerError);
+        if (sharedWorker === worker)
+            sharedWorker = null;
+        try {
+            worker.terminate();
+        }
+        catch {
+            /* ignore */
+        }
+        throw workerError;
+    }
+    finally {
+        URL.revokeObjectURL(workerUrl);
+    }
 }
 /** Default timeout for worker operations (30 seconds for large files) */
 const WORKER_TIMEOUT = 30000;
@@ -419,6 +450,8 @@ function sendToWorkerInstance(worker, request, timeout = WORKER_TIMEOUT) {
             reject(new Error(`Worker operation timed out after ${timeout}ms`));
         }, timeout);
         pendingCallbacks.set(id, {
+            worker,
+            requestType: request.type,
             resolve: (response) => {
                 clearTimeout(timeoutId);
                 resolve(response);
@@ -433,7 +466,42 @@ function sendToWorkerInstance(worker, request, timeout = WORKER_TIMEOUT) {
             transfers.push(request.data);
         if ('subData' in request && request.subData instanceof ArrayBuffer)
             transfers.push(request.subData);
-        worker.postMessage({ ...request, _id: id }, transfers);
+        try {
+            worker.postMessage({ ...request, _id: id }, transfers);
+        }
+        catch (error) {
+            pendingCallbacks.delete(id);
+            clearTimeout(timeoutId);
+            reject(error instanceof Error ? error : new Error(String(error)));
+        }
     });
 }
+function rejectWorkerCallbacks(worker, error) {
+    for (const [id, callback] of pendingCallbacks) {
+        if (callback.worker !== worker)
+            continue;
+        pendingCallbacks.delete(id);
+        callback.reject(error);
+    }
+}
+/**
+ * Test-only helper: tear down shared worker state between Bun test files.
+ * Not part of the public runtime API.
+ */
+export function resetWorkerForTests() {
+    if (sharedWorker) {
+        try {
+            sharedWorker.terminate();
+        }
+        catch {
+            /* ignore */
+        }
+    }
+    sharedWorker = null;
+    workerInitPromise = null;
+    for (const [, callback] of pendingCallbacks) {
+        callback.reject(new Error('Worker reset for tests'));
+    }
+    pendingCallbacks.clear();
+}
 //# sourceMappingURL=worker.js.map

package/dist/ts/worker.js.map

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

package/dist/wrapper.d.ts

@@ -2,14 +2,16 @@
  * TypeScript wrapper for the libbitsub Rust rendering engine.
  * Provides a compatible API with the original libpgs-js implementation.
  */
-export type { AutoSubtitleSource, AutoVideoSubtitleOptions, OpenedSubtitles, SubtitleAspectMode, SubtitleCacheStats, SubtitleFrameCanvasOptions, SubtitleFrameCanvasTarget, SubtitleFrameCropMode, SubtitleFrameRenderOptions, SubtitleRenderedFrameData, SubtitleCueBounds, SubtitleCueMetadata, SubtitleData, SubtitleDiagnosticDetailValue, SubtitleDiagnosticErrorCode, SubtitleDiagnosticErrorLike, SubtitleDiagnosticsOptions, SubtitleDiagnosticWarning, SubtitleDiagnosticWarningCode, SubtitleCompositionData, SubtitleDisplaySettings, SubtitleFormatName, SubtitleHorizontalAlign, SubtitleLastRenderInfo, SubtitleParserMetadata, SubtitleRendererBackend, SubtitleRendererEvent, SubtitleRendererStatsSnapshot, VideoSubtitleOptions, VideoVobSubOptions, RenderResult, SubtitleFrame, VobSubFrame } from './ts/types';
+export type { AssetFetchStrategy, AutoSubtitleSource, AutoVideoSubtitleOptions, OpenedSubtitles, SubtitleAspectMode, SubtitleCacheStats, SubtitleFrameCanvasOptions, SubtitleFrameCanvasTarget, SubtitleFrameCropMode, SubtitleFrameRenderOptions, SubtitleRenderedFrameData, SubtitleCueBounds, SubtitleCueMetadata, SubtitleData, SubtitleDiagnosticDetailValue, SubtitleDiagnosticErrorCode, SubtitleDiagnosticErrorLike, SubtitleDiagnosticsOptions, SubtitleDiagnosticWarning, SubtitleDiagnosticWarningCode, SubtitleCompositionData, SubtitleDisplaySettings, SubtitleFormatName, SubtitleHorizontalAlign, SubtitleLastRenderInfo, SubtitleParserMetadata, SubtitleRendererBackend, SubtitleRendererEvent, SubtitleRendererStatsSnapshot, VideoSubtitleOptions, VideoVobSubOptions, RenderResult, SubtitleFrame, VobSubFrame } from './ts/types';
 export { SubtitleDiagnosticError, createSubtitleDiagnosticError, normalizeSubtitleError } from './ts/diagnostics';
 export { initWasm, isWasmInitialized } from './ts/wasm';
+export { warmup, ready, isWorkerAvailable, isWorkerReady } from './ts/worker';
 export { isWebGPUSupported } from './ts/webgpu-renderer';
 export { PgsParser, VobSubParserLowLevel, UnifiedSubtitleParser, openSubtitles } from './ts/parsers';
 export { renderFrameData, toBlob, toCanvas, toImageBitmap } from './ts/frame-export';
 export { PgsRenderer, VobSubRenderer, createAutoSubtitleRenderer, type SubtitleRendererStats } from './ts/renderers';
 export { detectSubtitleFormat } from './ts/utils';
+export { fetchSubtitleAsset, fetchSubtitleText, probeRangeSupport, type AssetFetchOptions, type AssetFetchProgress, type RangeProbeResult } from './ts/range-loader';
 import { PgsRenderer as _PgsRenderer, VobSubRenderer as _VobSubRenderer } from './ts/renderers';
 import { UnifiedSubtitleParser as _UnifiedSubtitleParser } from './ts/parsers';
 /** @deprecated Use PgsRenderer instead */

package/dist/wrapper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wrapper.d.ts","sourceRoot":"","sources":["../src/wrapper.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,YAAY,EACV,kBAAkB,EAClB,wBAAwB,EACxB,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,0BAA0B,EAC1B,yBAAyB,EACzB,qBAAqB,EACrB,0BAA0B,EAC1B,yBAAyB,EACzB,iBAAiB,EACjB,mBAAmB,EACnB,YAAY,EACZ,6BAA6B,EAC7B,2BAA2B,EAC3B,2BAA2B,EAC3B,0BAA0B,EAC1B,yBAAyB,EACzB,6BAA6B,EAC7B,uBAAuB,EACvB,uBAAuB,EACvB,kBAAkB,EAClB,uBAAuB,EACvB,sBAAsB,EACtB,sBAAsB,EACtB,uBAAuB,EACvB,qBAAqB,EACrB,6BAA6B,EAC7B,oBAAoB,EACpB,kBAAkB,EAClB,YAAY,EACZ,aAAa,EACb,WAAW,EACZ,MAAM,YAAY,CAAA;AAEnB,OAAO,EAAE,uBAAuB,EAAE,6BAA6B,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAA;AAGjH,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAGvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAGxD,OAAO,EAAE,SAAS,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAGpG,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAGpF,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,0BAA0B,EAAE,KAAK,qBAAqB,EAAE,MAAM,gBAAgB,CAAA;AAGpH,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AAMjD,OAAO,EAAE,WAAW,IAAI,YAAY,EAAE,cAAc,IAAI,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAC/F,OAAO,EAAE,qBAAqB,IAAI,sBAAsB,EAAE,MAAM,cAAc,CAAA;AAE9E,0CAA0C;AAC1C,eAAO,MAAM,WAAW,qBAAe,CAAA;AAEvC,6CAA6C;AAC7C,eAAO,MAAM,cAAc,wBAAkB,CAAA;AAE7C,oDAAoD;AACpD,eAAO,MAAM,uBAAuB,+BAAyB,CAAA"}
+{"version":3,"file":"wrapper.d.ts","sourceRoot":"","sources":["../src/wrapper.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,YAAY,EACV,kBAAkB,EAClB,kBAAkB,EAClB,wBAAwB,EACxB,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,0BAA0B,EAC1B,yBAAyB,EACzB,qBAAqB,EACrB,0BAA0B,EAC1B,yBAAyB,EACzB,iBAAiB,EACjB,mBAAmB,EACnB,YAAY,EACZ,6BAA6B,EAC7B,2BAA2B,EAC3B,2BAA2B,EAC3B,0BAA0B,EAC1B,yBAAyB,EACzB,6BAA6B,EAC7B,uBAAuB,EACvB,uBAAuB,EACvB,kBAAkB,EAClB,uBAAuB,EACvB,sBAAsB,EACtB,sBAAsB,EACtB,uBAAuB,EACvB,qBAAqB,EACrB,6BAA6B,EAC7B,oBAAoB,EACpB,kBAAkB,EAClB,YAAY,EACZ,aAAa,EACb,WAAW,EACZ,MAAM,YAAY,CAAA;AAEnB,OAAO,EAAE,uBAAuB,EAAE,6BAA6B,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAA;AAGjH,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAEvD,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAG7E,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAGxD,OAAO,EAAE,SAAS,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAGpG,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAGpF,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,0BAA0B,EAAE,KAAK,qBAAqB,EAAE,MAAM,gBAAgB,CAAA;AAGpH,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AAEjD,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACtB,MAAM,mBAAmB,CAAA;AAM1B,OAAO,EAAE,WAAW,IAAI,YAAY,EAAE,cAAc,IAAI,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAC/F,OAAO,EAAE,qBAAqB,IAAI,sBAAsB,EAAE,MAAM,cAAc,CAAA;AAE9E,0CAA0C;AAC1C,eAAO,MAAM,WAAW,qBAAe,CAAA;AAEvC,6CAA6C;AAC7C,eAAO,MAAM,cAAc,wBAAkB,CAAA;AAE7C,oDAAoD;AACpD,eAAO,MAAM,uBAAuB,+BAAyB,CAAA"}

package/dist/wrapper.js

@@ -5,6 +5,7 @@
 export { SubtitleDiagnosticError, createSubtitleDiagnosticError, normalizeSubtitleError } from './ts/diagnostics';
 // Re-export WASM management
 export { initWasm, isWasmInitialized } from './ts/wasm';
+export { warmup, ready, isWorkerAvailable, isWorkerReady } from './ts/worker';
 // Re-export WebGPU utilities
 export { isWebGPUSupported } from './ts/webgpu-renderer';
 // Re-export parsers
@@ -15,6 +16,7 @@ export { renderFrameData, toBlob, toCanvas, toImageBitmap } from './ts/frame-exp
 export { PgsRenderer, VobSubRenderer, createAutoSubtitleRenderer } from './ts/renderers';
 // Re-export format detection utilities
 export { detectSubtitleFormat } from './ts/utils';
+export { fetchSubtitleAsset, fetchSubtitleText, probeRangeSupport } from './ts/range-loader';
 // =============================================================================
 // Legacy Aliases (for backward compatibility)
 // =============================================================================

package/dist/wrapper.js.map

@@ -1 +1 @@
-{"version":3,"file":"wrapper.js","sourceRoot":"","sources":["../src/wrapper.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAuCH,OAAO,EAAE,uBAAuB,EAAE,6BAA6B,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAA;AAEjH,4BAA4B;AAC5B,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAEvD,6BAA6B;AAC7B,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAExD,oBAAoB;AACpB,OAAO,EAAE,SAAS,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAEpG,iCAAiC;AACjC,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAEpF,sBAAsB;AACtB,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,0BAA0B,EAA8B,MAAM,gBAAgB,CAAA;AAEpH,uCAAuC;AACvC,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AAEjD,gFAAgF;AAChF,8CAA8C;AAC9C,gFAAgF;AAEhF,OAAO,EAAE,WAAW,IAAI,YAAY,EAAE,cAAc,IAAI,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAC/F,OAAO,EAAE,qBAAqB,IAAI,sBAAsB,EAAE,MAAM,cAAc,CAAA;AAE9E,0CAA0C;AAC1C,MAAM,CAAC,MAAM,WAAW,GAAG,YAAY,CAAA;AAEvC,6CAA6C;AAC7C,MAAM,CAAC,MAAM,cAAc,GAAG,eAAe,CAAA;AAE7C,oDAAoD;AACpD,MAAM,CAAC,MAAM,uBAAuB,GAAG,sBAAsB,CAAA"}
+{"version":3,"file":"wrapper.js","sourceRoot":"","sources":["../src/wrapper.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAwCH,OAAO,EAAE,uBAAuB,EAAE,6BAA6B,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAA;AAEjH,4BAA4B;AAC5B,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAEvD,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAE7E,6BAA6B;AAC7B,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAExD,oBAAoB;AACpB,OAAO,EAAE,SAAS,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAEpG,iCAAiC;AACjC,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAEpF,sBAAsB;AACtB,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,0BAA0B,EAA8B,MAAM,gBAAgB,CAAA;AAEpH,uCAAuC;AACvC,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AAEjD,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EAIlB,MAAM,mBAAmB,CAAA;AAE1B,gFAAgF;AAChF,8CAA8C;AAC9C,gFAAgF;AAEhF,OAAO,EAAE,WAAW,IAAI,YAAY,EAAE,cAAc,IAAI,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAC/F,OAAO,EAAE,qBAAqB,IAAI,sBAAsB,EAAE,MAAM,cAAc,CAAA;AAE9E,0CAA0C;AAC1C,MAAM,CAAC,MAAM,WAAW,GAAG,YAAY,CAAA;AAEvC,6CAA6C;AAC7C,MAAM,CAAC,MAAM,cAAc,GAAG,eAAe,CAAA;AAE7C,oDAAoD;AACpD,MAAM,CAAC,MAAM,uBAAuB,GAAG,sBAAsB,CAAA"}

package/examples/README.md

@@ -0,0 +1,38 @@
+# libbitsub player integration recipes
+
+Optional adapters ship with the core package as **subpath exports**. They keep `libbitsub` itself dependency-free: player/React packages are optional peer dependencies and are only required when you import that adapter.
+
+| Integration       | Import                                    | Peer dependency         |
+| ----------------- | ----------------------------------------- | ----------------------- |
+| Shared controller | `libbitsub/integrations` (`attachBitSub`) | none beyond `libbitsub` |
+| Video.js          | `libbitsub/videojs`                       | `video.js` >= 7         |
+| Shaka Player      | `libbitsub/shaka`                         | `shaka-player` >= 4     |
+| hls.js            | `libbitsub/hlsjs`                         | `hls.js` >= 1           |
+| React             | `libbitsub/react`                         | `react` >= 18           |
+
+Bitmap PGS / VobSub / MKS tracks are **not** native HTML text tracks. Each adapter overlays libbitsub on the player's `HTMLVideoElement`.
+
+See the per-player folders for copy-paste recipes:
+
+- [videojs](./videojs)
+- [shaka](./shaka)
+- [hlsjs](./hlsjs)
+- [react](./react)
+
+## Shared controller
+
+```ts
+import { attachBitSub } from 'libbitsub/integrations'
+
+const bitsub = attachBitSub(videoElement, {
+  subUrl: '/subs/movie.sup',
+  displaySettings: { scale: 1.05, bottomPadding: 4 }
+})
+
+bitsub.setDisplaySettings({ opacity: 0.9 })
+bitsub.load({ subUrl: '/subs/other.sup' })
+bitsub.clear()
+bitsub.dispose()
+```
+
+Prefer deep imports (`libbitsub/videojs`, …) in apps so unused adapters stay out of the bundle graph.

package/examples/hlsjs/README.md

@@ -0,0 +1,53 @@
+# hls.js + libbitsub
+
+## Install
+
+```bash
+npm install libbitsub hls.js
+```
+
+## Recipe
+
+```ts
+import Hls from 'hls.js'
+import { attachBitSubToHls } from 'libbitsub/hlsjs'
+
+const video = document.getElementById('video') as HTMLVideoElement
+const hls = new Hls()
+
+hls.loadSource('/media/master.m3u8')
+hls.attachMedia(video)
+
+// Can be created before or after attachMedia().
+const bitsub = attachBitSubToHls(hls, {
+  subUrl: '/subs/movie.sup',
+  displaySettings: { aspectMode: 'contain' },
+  onEvent: (event) => {
+    if (event.type === 'loaded') {
+      console.log('bitmap track ready', event.metadata)
+    }
+  }
+})
+
+// Runtime swap:
+bitsub.load({ subUrl: '/subs/commentary.sup', fileName: 'commentary.sup' })
+bitsub.clear()
+
+// Cleanup (also runs if hls.destroy() fires DESTROYING)
+bitsub.dispose()
+hls.destroy()
+```
+
+## HTML sketch
+
+```html
+<div style="position: relative">
+  <video id="video" controls playsinline></video>
+</div>
+```
+
+## Notes
+
+- Binds to `hls.media` and re-attaches on `MEDIA_ATTACHED`.
+- Clears on `MEDIA_DETACHED` and disposes on `DESTROYING`.
+- hls.js continues to own HLS text tracks (WebVTT, etc.); libbitsub only draws external bitmap overlays.