libbitsub 1.12.0 → 1.13.0

package/dist/ts/video-frame-scheduler.js

@@ -1,3 +1,10 @@
+const defaultWatchdogTimer = {
+    now: () => performance.now(),
+    request: (callback, delay) => setTimeout(callback, delay),
+    cancel: (handle) => clearTimeout(handle)
+};
+const watchdogInterval = 250;
+const watchdogGrace = 1000;
 const defaultAnimationFrameScheduler = {
     request: (callback) => requestAnimationFrame(callback),
     cancel: (handle) => cancelAnimationFrame(handle)
@@ -13,14 +20,21 @@ export class VideoFrameScheduler {
     video;
     onFrame;
     animationFrames;
+    watchdogTimer;
     animationFrameHandle = null;
     videoFrameHandle = null;
+    watchdogHandle = null;
+    lastWatchdogTime = 0;
+    lastProgressTime = 0;
+    lastVideoTime = 0;
+    progressingSince = null;
     generation = 0;
     useVideoFrames;
-    constructor(video, frameAware, onFrame, animationFrames = defaultAnimationFrameScheduler) {
+    constructor(video, frameAware, onFrame, animationFrames = defaultAnimationFrameScheduler, watchdogTimer = defaultWatchdogTimer) {
         this.video = video;
         this.onFrame = onFrame;
         this.animationFrames = animationFrames;
+        this.watchdogTimer = watchdogTimer;
         this.useVideoFrames = supportsFrameAwareSync(video, frameAware);
     }
     get mode() {
@@ -28,11 +42,21 @@ export class VideoFrameScheduler {
     }
     start() {
         this.stop();
+        // Fallback is deliberate and permanent for this scheduler's lifetime,
+        // including restarts. Re-probing a stalled native-HLS callback source
+        // would repeatedly freeze subtitles for the watchdog grace period.
         const generation = this.generation;
+        this.resetWatchdogEvidence();
         this.schedule(generation);
+        if (this.useVideoFrames)
+            this.scheduleWatchdog(generation);
     }
     stop() {
         this.generation++;
+        if (this.watchdogHandle !== null) {
+            this.watchdogTimer.cancel(this.watchdogHandle);
+            this.watchdogHandle = null;
+        }
         if (this.videoFrameHandle !== null) {
             const cancelVideoFrameCallback = this.video.cancelVideoFrameCallback;
             if (typeof cancelVideoFrameCallback === 'function') {
@@ -50,6 +74,56 @@ export class VideoFrameScheduler {
             this.animationFrameHandle = null;
         }
     }
+    resetWatchdogEvidence() {
+        this.lastWatchdogTime = this.watchdogTimer.now();
+        this.lastProgressTime = this.lastWatchdogTime;
+        this.lastVideoTime = this.video.currentTime;
+        this.progressingSince = null;
+    }
+    scheduleWatchdog(generation) {
+        this.watchdogHandle = this.watchdogTimer.request(() => {
+            if (generation !== this.generation || !this.useVideoFrames)
+                return;
+            this.watchdogHandle = null;
+            const now = this.watchdogTimer.now();
+            const currentTime = this.video.currentTime;
+            const elapsed = now - this.lastWatchdogTime;
+            const playing = !this.video.paused &&
+                !this.video.seeking &&
+                !this.video.ended &&
+                (this.video.readyState === undefined || this.video.readyState >= 3);
+            if (!playing ||
+                !Number.isFinite(elapsed) ||
+                elapsed < 0 ||
+                elapsed > watchdogInterval * 3 ||
+                !Number.isFinite(currentTime) ||
+                !Number.isFinite(this.lastVideoTime) ||
+                currentTime < this.lastVideoTime) {
+                this.progressingSince = null;
+                this.lastProgressTime = now;
+            }
+            else if (currentTime > this.lastVideoTime) {
+                this.lastProgressTime = now;
+                this.progressingSince ??= this.lastWatchdogTime;
+                if (now - this.progressingSince >= watchdogGrace) {
+                    // Invalidate the pending video callback before cancellation: some
+                    // implementations can still deliver a cancelled callback.
+                    this.useVideoFrames = false;
+                    this.stop();
+                    this.schedule(this.generation);
+                    return;
+                }
+            }
+            else if (now - this.lastProgressTime >= watchdogGrace) {
+                // Brief equal samples can come from a quantized media clock. Only
+                // sustained inactivity discards progress, and only advancement fails.
+                this.progressingSince = null;
+            }
+            this.lastWatchdogTime = now;
+            this.lastVideoTime = currentTime;
+            this.scheduleWatchdog(generation);
+        }, watchdogInterval);
+    }
     schedule(generation) {
         if (generation !== this.generation)
             return;
@@ -58,9 +132,10 @@ export class VideoFrameScheduler {
             if (typeof requestVideoFrameCallback === 'function') {
                 try {
                     this.videoFrameHandle = requestVideoFrameCallback.call(this.video, (_now, metadata) => {
-                        this.videoFrameHandle = null;
-                        if (generation !== this.generation)
+                        if (generation !== this.generation || !this.useVideoFrames)
                             return;
+                        this.videoFrameHandle = null;
+                        this.resetWatchdogEvidence();
                         const mediaTime = Number.isFinite(metadata.mediaTime) ? metadata.mediaTime : this.video.currentTime;
                         try {
                             this.onFrame({
@@ -82,10 +157,14 @@ export class VideoFrameScheduler {
                 this.useVideoFrames = false;
             }
         }
+        if (this.watchdogHandle !== null) {
+            this.watchdogTimer.cancel(this.watchdogHandle);
+            this.watchdogHandle = null;
+        }
         this.animationFrameHandle = this.animationFrames.request(() => {
-            this.animationFrameHandle = null;
             if (generation !== this.generation)
                 return;
+            this.animationFrameHandle = null;
             try {
                 this.onFrame({ mediaTime: this.video.currentTime, presentedFrames: null });
             }

package/dist/ts/video-frame-scheduler.js.map

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

package/dist/ts/worker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../src/ts/worker.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAiB5D,0CAA0C;AAC1C,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AA0sBD,kEAAkE;AAClE,wBAAgB,aAAa,IAAI,OAAO,CAEvC;AAED,gDAAgD;AAChD,wBAAgB,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC,CAgBnD;AAED,iDAAiD;AACjD,wBAAgB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAEtC;AAED,uEAAuE;AACvE,wBAAsB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAI3C;AAuED,yDAAyD;AACzD,wBAAgB,YAAY,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,SAAiB,GAAG,OAAO,CAAC,cAAc,CAAC,CAMtG;AAkDD;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAc1C"}
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../src/ts/worker.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAiB5D,0CAA0C;AAC1C,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AAmtBD,kEAAkE;AAClE,wBAAgB,aAAa,IAAI,OAAO,CAEvC;AAED,gDAAgD;AAChD,wBAAgB,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC,CAgBnD;AAED,iDAAiD;AACjD,wBAAgB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAEtC;AAED,uEAAuE;AACvE,wBAAsB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAI3C;AAuED,yDAAyD;AACzD,wBAAgB,YAAY,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,SAAiB,GAAG,OAAO,CAAC,cAAc,CAAC,CAMtG;AAkDD;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAc1C"}

package/dist/ts/worker.js

@@ -276,10 +276,12 @@ self.onmessage = async function(event) {
                     parser.reset();
                     pgsParsers.set(request.sessionId, parser);
                 }
+                // Send only timestamps added by this chunk (from timestampBase).
+                const timestampBase = parser.count;
                 const added = parser.feed(new Uint8Array(request.data));
-                const timestamps = parser.getTimestamps();
+                const timestamps = parser.getTimestampsFrom(timestampBase);
                 postResponse(
-                    { type: 'pgsProgress', count: parser.count, added, partial: true, metadata: buildPgsMetadata(parser), timestamps },
+                    { type: 'pgsProgress', count: parser.count, added, partial: true, metadata: buildPgsMetadata(parser), timestamps, timestampBase },
                     [timestamps.buffer],
                     _id
                 );
@@ -350,11 +352,15 @@ self.onmessage = async function(event) {
                     parser.reset();
                     dvbParsers.set(request.sessionId, parser);
                 }
+                // Send only changed entries: new cues plus the previous last cue,
+                // whose end time a new cue can shorten.
+                const previousCount = parser.count;
                 const added = parser.feed(new Uint8Array(request.data));
-                const timestamps = parser.getTimestamps();
-                const endTimestamps = parser.getEndTimestamps();
+                const timestampBase = added > 0 ? Math.max(0, previousCount - 1) : parser.count;
+                const timestamps = parser.getTimestampsFrom(timestampBase);
+                const endTimestamps = parser.getEndTimestampsFrom(timestampBase);
                 postResponse(
-                    { type: 'dvbProgress', count: parser.count, added, partial: true, metadata: buildDvbMetadata(parser), timestamps, endTimestamps },
+                    { type: 'dvbProgress', count: parser.count, added, partial: true, metadata: buildDvbMetadata(parser), timestamps, endTimestamps, timestampBase },
                     [timestamps.buffer, endTimestamps.buffer],
                     _id
                 );
@@ -533,7 +539,10 @@ self.onmessage = async function(event) {
             }
             case 'getVobSubTimestamps': {
                 const parser = vobSubParsers.get(request.sessionId);
-                postResponse({ type: 'vobSubTimestamps', timestamps: parser ? parser.getTimestamps() : new Float64Array(0) }, [], _id);
+                const timestamps = parser ? parser.getTimestamps() : new Float64Array(0);
+                const endTimestamps = new Float64Array(timestamps.length);
+                for (let i = 0; i < timestamps.length; i++) endTimestamps[i] = parser.getCueEndTime(i);
+                postResponse({ type: 'vobSubTimestamps', timestamps, endTimestamps }, [], _id);
                 break;
             }
             case 'clearPgsCache': {

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "libbitsub",
-  "version": "1.12.0",
+  "version": "1.13.0",
   "author": "altqx",
   "license": "MIT",
   "description": "High-performance WASM renderer for graphical subtitles (PGS, VobSub, and DVB)",
@@ -78,6 +78,9 @@
     "build:wasm:bundler": "wasm-pack build --target bundler --out-dir pkg-bundler",
     "build:ts": "tsc",
     "build": "bun run build:wasm:release && bun run build:ts",
+    "demo:build": "bun demo/build.ts",
+    "demo:dev": "bun run demo:build && wrangler dev --config demo/wrangler.jsonc",
+    "demo:deploy": "bun run demo:build && wrangler deploy --config demo/wrangler.jsonc",
     "clean": "rm -rf pkg pkg-bundler dist target",
     "test": "cargo test --workspace",
     "test:ts": "bun test src/ts",
@@ -88,8 +91,10 @@
   },
   "devDependencies": {
     "@types/react": "^19.2.17",
+    "dashjs": "5.2.1",
     "prettier": "^3.9.6",
     "react": "^19.2.8",
+    "libbitsub-registry": "npm:libbitsub@1.12.0",
     "typescript": "^7.0.2"
   },
   "peerDependencies": {

package/pkg/README.md

@@ -34,7 +34,7 @@ https://gist.github.com/user-attachments/assets/a89ae9fe-23e4-4bc3-8cad-16a3f0fe
 
 ### Live demo
 
-https://a.rafasu.com/v
+https://libbitsub.altqx.com
 
 ## Installation
 
@@ -293,9 +293,10 @@ selection does not transfer a caller-owned canvas to a worker; request
 
 Frame-aware synchronization is enabled by default. On browsers with
 `requestVideoFrameCallback()`, cue lookup uses the `mediaTime` of the frame sent
-to the compositor instead of polling `video.currentTime`. Older browsers fall
-back to `requestAnimationFrame()` automatically; set `frameAwareSync: false` to
-force that compatibility path. The active path is available as
+to the compositor instead of polling `video.currentTime`. The scheduler falls
+back to `requestAnimationFrame()` automatically when frame callbacks are unavailable
+or stop arriving during advancing playback; set `frameAwareSync: false` to force
+that compatibility path. The active path is available as
 `renderer.getSynchronizationMode()` and as `getStats().syncMode`.
 
 ### VobSub renderer
@@ -934,6 +935,7 @@ interface VideoSubtitleOptions {
   }
   streamingLoad?: boolean // default true — progressive URL loads
   rangeRequests?: boolean // default true — use HTTP Range when supported
+  maxSubtitleBytes?: number // default 256 MiB — larger downloads are rejected
   onEvent?: (event: SubtitleRendererEvent) => void
 }
 ```

package/pkg/libbitsub.d.ts

@@ -16,7 +16,15 @@ export class DvbParser {
     getCuePageState(index: number): number;
     getCueStartTime(index: number): number;
     getEndTimestamps(): Float64Array;
+    /**
+     * Get cue end times starting at cue `start`, for incremental updates.
+     */
+    getEndTimestampsFrom(start: number): Float64Array;
     getTimestamps(): Float64Array;
+    /**
+     * Get cue start times starting at cue `start`, for incremental updates.
+     */
+    getTimestampsFrom(start: number): Float64Array;
     constructor();
     parse(data: Uint8Array): number;
     renderAtIndex(index: number): SubtitleFrame | undefined;
@@ -44,6 +52,10 @@ export class PgsParser {
     getCuePaletteId(index: number): number;
     getCueStartTime(index: number): number;
     getTimestamps(): Float64Array;
+    /**
+     * Get timestamps starting at cue `start`, for incremental updates.
+     */
+    getTimestampsFrom(start: number): Float64Array;
     constructor();
     parse(data: Uint8Array): number;
     renderAtIndex(index: number): SubtitleFrame | undefined;
@@ -217,7 +229,9 @@ export interface InitOutput {
     readonly dvbparser_getCuePageState: (a: number, b: number) => number;
     readonly dvbparser_getCueStartTime: (a: number, b: number) => number;
     readonly dvbparser_getEndTimestamps: (a: number) => any;
+    readonly dvbparser_getEndTimestampsFrom: (a: number, b: number) => any;
     readonly dvbparser_getTimestamps: (a: number) => any;
+    readonly dvbparser_getTimestampsFrom: (a: number, b: number) => any;
     readonly dvbparser_lastRenderIssue: (a: number) => [number, number];
     readonly dvbparser_new: () => number;
     readonly dvbparser_parse: (a: number, b: number, c: number) => number;
@@ -238,6 +252,7 @@ export interface InitOutput {
     readonly pgsparser_getCuePaletteId: (a: number, b: number) => number;
     readonly pgsparser_getCueStartTime: (a: number, b: number) => number;
     readonly pgsparser_getTimestamps: (a: number) => any;
+    readonly pgsparser_getTimestampsFrom: (a: number, b: number) => any;
     readonly pgsparser_lastRenderIssue: (a: number) => [number, number];
     readonly pgsparser_new: () => number;
     readonly pgsparser_parse: (a: number, b: number, c: number) => number;

package/pkg/libbitsub.js

@@ -88,6 +88,15 @@ export class DvbParser {
         const ret = wasm.dvbparser_getEndTimestamps(this.__wbg_ptr);
         return ret;
     }
+    /**
+     * Get cue end times starting at cue `start`, for incremental updates.
+     * @param {number} start
+     * @returns {Float64Array}
+     */
+    getEndTimestampsFrom(start) {
+        const ret = wasm.dvbparser_getEndTimestampsFrom(this.__wbg_ptr, start);
+        return ret;
+    }
     /**
      * @returns {Float64Array}
      */
@@ -95,6 +104,15 @@ export class DvbParser {
         const ret = wasm.dvbparser_getTimestamps(this.__wbg_ptr);
         return ret;
     }
+    /**
+     * Get cue start times starting at cue `start`, for incremental updates.
+     * @param {number} start
+     * @returns {Float64Array}
+     */
+    getTimestampsFrom(start) {
+        const ret = wasm.dvbparser_getTimestampsFrom(this.__wbg_ptr, start);
+        return ret;
+    }
     /**
      * @returns {string}
      */
@@ -257,6 +275,15 @@ export class PgsParser {
         const ret = wasm.pgsparser_getTimestamps(this.__wbg_ptr);
         return ret;
     }
+    /**
+     * Get timestamps starting at cue `start`, for incremental updates.
+     * @param {number} start
+     * @returns {Float64Array}
+     */
+    getTimestampsFrom(start) {
+        const ret = wasm.pgsparser_getTimestampsFrom(this.__wbg_ptr, start);
+        return ret;
+    }
     /**
      * @returns {string}
      */

package/pkg/libbitsub_bg.wasm.d.ts

@@ -19,7 +19,9 @@ export const dvbparser_getCueEndTime: (a: number, b: number) => number;
 export const dvbparser_getCuePageState: (a: number, b: number) => number;
 export const dvbparser_getCueStartTime: (a: number, b: number) => number;
 export const dvbparser_getEndTimestamps: (a: number) => any;
+export const dvbparser_getEndTimestampsFrom: (a: number, b: number) => any;
 export const dvbparser_getTimestamps: (a: number) => any;
+export const dvbparser_getTimestampsFrom: (a: number, b: number) => any;
 export const dvbparser_lastRenderIssue: (a: number) => [number, number];
 export const dvbparser_new: () => number;
 export const dvbparser_parse: (a: number, b: number, c: number) => number;
@@ -40,6 +42,7 @@ export const pgsparser_getCueEndTime: (a: number, b: number) => number;
 export const pgsparser_getCuePaletteId: (a: number, b: number) => number;
 export const pgsparser_getCueStartTime: (a: number, b: number) => number;
 export const pgsparser_getTimestamps: (a: number) => any;
+export const pgsparser_getTimestampsFrom: (a: number, b: number) => any;
 export const pgsparser_lastRenderIssue: (a: number) => [number, number];
 export const pgsparser_new: () => number;
 export const pgsparser_parse: (a: number, b: number, c: number) => number;

package/pkg/package.json

@@ -5,7 +5,7 @@
     "altqx"
   ],
   "description": "High-performance WASM renderer for graphical subtitles (PGS, VobSub, and DVB)",
-  "version": "1.12.0",
+  "version": "1.13.0",
   "license": "MIT",
   "repository": {
     "type": "git",

package/src/integrations/hlsjs.ts

@@ -4,6 +4,8 @@
  * hls.js handles HLS media and WebVTT/IMSC text tracks; use this helper for
  * external PGS/VobSub/MKS bitmap overlays on the same media element.
  *
+ * @module
+ *
  * @example
  * ```ts
  * import Hls from 'hls.js'
@@ -33,8 +35,10 @@ export interface HlsLike {
   }
 }
 
+/** Options for attachBitSubToHls(). */
 export type BitSubHlsOptions = AttachBitSubOptions
 
+/** Handle returned by attachBitSubToHls(). */
 export interface BitSubHlsHandle extends BitSubController {
   /** Underlying hls.js instance. */
   readonly hls: HlsLike
@@ -150,5 +154,7 @@ export function attachBitSubToHls(hls: HlsLike, options: BitSubHlsOptions = {}):
   }
 }
 
+/** Shared attach options and controller types. */
 export type { AttachBitSubOptions, BitSubController, BitSubSourceOptions, BitSubRenderer } from './shared'
+/** Attach or construct a libbitsub controller. */
 export { attachBitSub, createBitSubRenderer } from './shared'

package/src/integrations/index.ts

@@ -1,9 +1,13 @@
 /**
  * Optional player integrations for libbitsub.
- * Prefer deep imports (`libbitsub/videojs`, `libbitsub/shaka`, `libbitsub/hlsjs`, `libbitsub/react`)
- * so unused peer dependencies stay out of your bundle.
+ *
+ * Prefer deep imports (`libbitsub/videojs`, `libbitsub/shaka`, `libbitsub/hlsjs`,
+ * `libbitsub/react`) so unused peer dependencies stay out of your bundle.
+ *
+ * @module
  */
 
+/** Shared attach/create helpers used by every player adapter. */
 export {
   attachBitSub,
   createBitSubRenderer,
@@ -13,6 +17,7 @@ export {
   type BitSubSourceOptions
 } from './shared'
 
+/** Video.js plugin and player typings. */
 export {
   registerBitSubPlugin,
   type BitSubVideoJsApi,
@@ -22,10 +27,13 @@ export {
   type VideoJsPlayerLike
 } from './videojs'
 
+/** Shaka Player adapter. */
 export { attachBitSubToShaka, type BitSubShakaHandle, type BitSubShakaOptions, type ShakaPlayerLike } from './shaka'
 
+/** hls.js adapter. */
 export { attachBitSubToHls, type BitSubHlsHandle, type BitSubHlsOptions, type HlsLike } from './hlsjs'
 
+/** React hook and overlay component. */
 export {
   BitSubOverlay,
   useBitSub,

package/src/integrations/react.tsx

@@ -1,7 +1,9 @@
 /**
  * Optional React bindings for libbitsub bitmap subtitles.
  *
- * Peer dependency: react >= 18
+ * Peer dependency: react >= 18.
+ *
+ * @module
  *
  * @example
  * ```tsx
@@ -26,13 +28,16 @@ import { useEffect, useRef, useState, type CSSProperties, type ReactElement, typ
 import { attachBitSub, type AttachBitSubOptions, type BitSubController, type BitSubSourceOptions } from './shared'
 import type { SubtitleDisplaySettings, SubtitleDiagnosticWarning, SubtitleRendererEvent } from '../wrapper'
 
+/** Subtitle source fields accepted by the React bindings. */
 export type BitSubReactSource = BitSubSourceOptions
 
+/** Options for useBitSub(). */
 export interface UseBitSubOptions extends BitSubReactSource {
   /** When false, do not load even if source fields are set. Default true. */
   enabled?: boolean
 }
 
+/** Return value of useBitSub(). */
 export interface UseBitSubResult {
   controller: BitSubController | null
   error: Error | null
@@ -152,6 +157,7 @@ export function useBitSub(
   return { controller, error }
 }
 
+/** Props for BitSubOverlay. */
 export interface BitSubOverlayProps extends UseBitSubOptions {
   videoRef: RefObject<HTMLVideoElement | null>
   /** Optional class name applied to a zero-size host span for debugging. */
@@ -171,6 +177,9 @@ export function BitSubOverlay(props: BitSubOverlayProps): ReactElement | null {
   return <span className={className} style={{ display: 'none', ...style }} aria-hidden='true' />
 }
 
+/** Shared attach options and controller types. */
 export type { AttachBitSubOptions, BitSubController, BitSubSourceOptions, BitSubRenderer } from './shared'
+/** Attach or construct a libbitsub controller. */
 export { attachBitSub, createBitSubRenderer } from './shared'
+/** Runtime overlay display settings. */
 export type { SubtitleDisplaySettings }

package/src/integrations/shaka.ts

@@ -4,6 +4,8 @@
  * Bitmap PGS/VobSub tracks are not native Shaka text tracks — this helper
  * overlays libbitsub on the player media element.
  *
+ * @module
+ *
  * @example
  * ```ts
  * import shaka from 'shaka-player'
@@ -26,8 +28,10 @@ export interface ShakaPlayerLike {
   removeEventListener?(type: string, listener: (...args: unknown[]) => void): void
 }
 
+/** Options for attachBitSubToShaka(). */
 export type BitSubShakaOptions = AttachBitSubOptions
 
+/** Handle returned by attachBitSubToShaka(). */
 export interface BitSubShakaHandle extends BitSubController {
   /** Underlying Shaka player reference. */
   readonly player: ShakaPlayerLike
@@ -88,5 +92,7 @@ export function attachBitSubToShaka(player: ShakaPlayerLike, options: BitSubShak
   }
 }
 
+/** Shared attach options and controller types. */
 export type { AttachBitSubOptions, BitSubController, BitSubSourceOptions, BitSubRenderer } from './shared'
+/** Attach or construct a libbitsub controller. */
 export { attachBitSub, createBitSubRenderer } from './shared'

package/src/integrations/shared.ts

@@ -19,6 +19,7 @@ export type BitSubRenderer = PgsRenderer | VobSubRenderer | DvbRenderer
 /** Subtitle source + renderer options without a bound video element. */
 export type BitSubSourceOptions = Omit<AutoVideoSubtitleOptions, 'video'>
 
+/** Handle returned by player adapters. */
 export interface BitSubController {
   /** Active renderer, or null when no track is loaded. */
   readonly renderer: BitSubRenderer | null
@@ -40,6 +41,7 @@ export interface BitSubController {
   setVideo(video: HTMLVideoElement | null): void
 }
 
+/** Options for attachBitSub(). */
 export interface AttachBitSubOptions extends BitSubSourceOptions {
   /** When false, skip the initial load even if source fields are present. Default true. */
   autoLoad?: boolean

package/src/integrations/videojs.ts

@@ -1,6 +1,8 @@
 /**
  * Optional Video.js plugin for libbitsub bitmap subtitles.
  *
+ * @module
+ *
  * @example
  * ```ts
  * import videojs from 'video.js'
@@ -26,24 +28,29 @@ export interface VideoJsPlayerLike {
   trigger?(event: string, data?: unknown): void
 }
 
+/** Minimal Video.js plugin instance surface. */
 export interface VideoJsPluginBase {
   player: VideoJsPlayerLike
   options_: unknown
   dispose(): void
 }
 
+/** Minimal Video.js plugin constructor surface. */
 export interface VideoJsPluginConstructor {
   new (player: VideoJsPlayerLike, options?: unknown): VideoJsPluginBase
   prototype: VideoJsPluginBase
 }
 
+/** Minimal video.js factory used by the plugin. */
 export interface VideoJsLike {
   getPlugin(name: string): VideoJsPluginConstructor
   registerPlugin(name: string, plugin: unknown): void
 }
 
+/** Options for player.bitsub(). */
 export type BitSubVideoJsOptions = AttachBitSubOptions
 
+/** Video.js player.bitsub() API. */
 export interface BitSubVideoJsApi {
   /** Active controller, if any. */
   controller(): BitSubController | null
@@ -196,5 +203,7 @@ export type VideoJsBitSubPlayer = VideoJsPlayerLike & {
   bitsub(options?: BitSubVideoJsOptions): BitSubVideoJsApi
 }
 
+/** Shared attach options and controller types. */
 export type { AttachBitSubOptions, BitSubController, BitSubSourceOptions, BitSubRenderer } from './shared'
+/** Attach or construct a libbitsub controller. */
 export { attachBitSub, createBitSubRenderer } from './shared'