libbitsub 1.9.0 → 1.10.0

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,10 +2,12 @@
  * TypeScript wrapper for the libbitsub Rust rendering engine.
  * Provides a compatible API with the original libpgs-js implementation.
  */
-export type { AutoSubtitleSource, AutoVideoSubtitleOptions, SubtitleAspectMode, SubtitleCueBounds, SubtitleCueMetadata, SubtitleData, SubtitleCompositionData, SubtitleDisplaySettings, SubtitleFormatName, SubtitleHorizontalAlign, SubtitleParserMetadata, SubtitleRendererBackend, SubtitleRendererEvent, SubtitleRendererStatsSnapshot, VideoSubtitleOptions, VideoVobSubOptions, RenderResult, SubtitleFrame, VobSubFrame } from './ts/types';
+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 { SubtitleDiagnosticError, createSubtitleDiagnosticError, normalizeSubtitleError } from './ts/diagnostics';
 export { initWasm, isWasmInitialized } from './ts/wasm';
 export { isWebGPUSupported } from './ts/webgpu-renderer';
-export { PgsParser, VobSubParserLowLevel, UnifiedSubtitleParser } from './ts/parsers';
+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';
 import { PgsRenderer as _PgsRenderer, VobSubRenderer as _VobSubRenderer } from './ts/renderers';

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,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,YAAY,EACZ,uBAAuB,EACvB,uBAAuB,EACvB,kBAAkB,EAClB,uBAAuB,EACvB,sBAAsB,EACtB,uBAAuB,EACvB,qBAAqB,EACrB,6BAA6B,EAC7B,oBAAoB,EACpB,kBAAkB,EAClB,YAAY,EACZ,aAAa,EACb,WAAW,EACZ,MAAM,YAAY,CAAA;AAGnB,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,MAAM,cAAc,CAAA;AAGrF,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,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"}

package/dist/wrapper.js

@@ -2,12 +2,15 @@
  * TypeScript wrapper for the libbitsub Rust rendering engine.
  * Provides a compatible API with the original libpgs-js implementation.
  */
+export { SubtitleDiagnosticError, createSubtitleDiagnosticError, normalizeSubtitleError } from './ts/diagnostics';
 // Re-export WASM management
 export { initWasm, isWasmInitialized } from './ts/wasm';
 // Re-export WebGPU utilities
 export { isWebGPUSupported } from './ts/webgpu-renderer';
 // Re-export parsers
-export { PgsParser, VobSubParserLowLevel, UnifiedSubtitleParser } from './ts/parsers';
+export { PgsParser, VobSubParserLowLevel, UnifiedSubtitleParser, openSubtitles } from './ts/parsers';
+// Re-export frame export helpers
+export { renderFrameData, toBlob, toCanvas, toImageBitmap } from './ts/frame-export';
 // Re-export renderers
 export { PgsRenderer, VobSubRenderer, createAutoSubtitleRenderer } from './ts/renderers';
 // Re-export format detection utilities

package/dist/wrapper.js.map

@@ -1 +1 @@
-{"version":3,"file":"wrapper.js","sourceRoot":"","sources":["../src/wrapper.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAyBH,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,MAAM,cAAc,CAAA;AAErF,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;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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "libbitsub",
-  "version": "1.9.0",
+  "version": "1.10.0",
   "author": "altqx",
   "license": "MIT",
   "description": "High-performance WASM renderer for graphical subtitles (PGS and VobSub)",

package/pkg/README.md

@@ -13,8 +13,10 @@ Started as a fork of Arcus92's [libpgs-js](https://github.com/Arcus92/libpgs-js)
 - Worker-backed parsing/rendering for large subtitle files
 - Rich layout controls: scale, aspect mode, horizontal/vertical offsets, alignment, bottom padding, safe area, opacity
 - Cue metadata and parser introspection APIs
+- Rendered-frame export helpers for ImageData, ImageBitmap, Blob, and custom canvas targets
 - Frame prefetching and cache control for high-level renderers
 - Automatic format detection and unified loading helpers
+- First-class diagnostics with structured error codes, warning hooks, and render/cache snapshots
 - TypeScript support with exported event and metadata types
 
 ## Showcase
@@ -104,6 +106,7 @@ import { PgsRenderer } from 'libbitsub'
 const renderer = new PgsRenderer({
   video: videoElement,
   subUrl: '/subtitles/movie.sup',
+  debug: true,
   displaySettings: {
     scale: 1.1,
     aspectMode: 'stretch',
@@ -112,6 +115,9 @@ const renderer = new PgsRenderer({
   },
   cacheLimit: 32,
   prefetchWindow: { before: 1, after: 2 },
+  onWarning: (warning) => {
+    console.warn(warning.code, warning.message, warning.details)
+  },
   onEvent: (event) => {
     if (event.type === 'worker-state') {
       console.log('worker', event.ready ? 'ready' : 'starting', event.sessionId)
@@ -204,12 +210,15 @@ High-level renderers expose parser and cue metadata:
 const metadata = renderer.getMetadata()
 const currentCue = renderer.getCurrentCueMetadata()
 const cue42 = renderer.getCueMetadata(42)
+const stats = renderer.getStats()
+const cache = renderer.getCacheStats()
+const lastRender = renderer.getLastRenderInfo()
 ```
 
 Low-level parsers expose the same model:
 
 ```ts
-import { PgsParser, UnifiedSubtitleParser, VobSubParserLowLevel } from 'libbitsub'
+import { PgsParser, UnifiedSubtitleParser, VobSubParserLowLevel, openSubtitles } from 'libbitsub'
 
 const vob = new VobSubParserLowLevel()
 vob.loadFromMks(new Uint8Array(mksBuffer))
@@ -217,9 +226,13 @@ vob.loadFromMks(new Uint8Array(mksBuffer))
 const parser = new UnifiedSubtitleParser()
 const detected = parser.loadAuto({ data: subtitleBytes, fileName: 'track.mks' })
 
+const opened = await openSubtitles({ data: subtitleBytes, fileName: 'track.mks' })
+
 console.log(detected)
 console.log(parser.getMetadata())
 console.log(parser.getCueMetadata(0))
+console.log(opened.format)
+opened.dispose()
 ```
 
 Metadata includes:
@@ -230,6 +243,134 @@ Metadata includes:
 - PGS composition count, palette ID, composition state
 - VobSub language, track ID, IDX metadata presence, file position where available
 
+## One-shot auto API
+
+If you do not care whether the input is PGS or VobSub and only want one stable low-level surface, use `openSubtitles()`.
+
+```ts
+import { openSubtitles } from 'libbitsub'
+
+const subtitles = await openSubtitles({
+  data: subtitleBytes,
+  fileName: 'track.sup'
+})
+
+console.log(subtitles.format)
+console.log(subtitles.metadata)
+console.log(subtitles.timestamps)
+
+const frame = subtitles.renderAtTimestamp(120.5)
+const rendered = subtitles.renderFrameDataAtTimestamp(120.5)
+const cue = subtitles.getCueMetadata(0)
+
+subtitles.dispose()
+```
+
+`openSubtitles()` initializes WASM for you, auto-detects the format, loads the subtitle source, and returns a normalized handle with snapshot properties plus shared low-level helpers such as `renderAtIndex()`, `renderAtTimestamp()`, `renderFrameDataAtIndex()`, `renderFrameDataAtTimestamp()`, `getCueMetadata()`, `getLastRenderIssue()`, `clearCache()`, and `dispose()`.
+
+Like `UnifiedSubtitleParser.loadAuto()`, this is a low-level in-memory API: pass binary subtitle content via `data` or `subData`, and optionally include `fileName`, `idxContent`, `idxUrl`, or `subUrl` as format hints or companion metadata.
+
+## Frame export helpers
+
+Low-level parser output can be flattened into a single exportable frame for previews, editors, snapshots, fixture generation, or visual diffing.
+
+```ts
+import {
+  PgsParser,
+  initWasm,
+  renderFrameData,
+  toBlob,
+  toCanvas,
+  toImageBitmap
+} from 'libbitsub'
+
+await initWasm()
+
+const parser = new PgsParser()
+parser.load(new Uint8Array(arrayBuffer))
+
+const subtitleFrame = parser.renderAtTimestamp(120.5)
+const rendered = subtitleFrame ? renderFrameData(subtitleFrame, { crop: 'bounds' }) : null
+
+if (rendered) {
+  const canvas = toCanvas(rendered)
+  const bitmap = await toImageBitmap(rendered)
+  const pngBlob = await toBlob(rendered)
+
+  console.log({
+    width: rendered.imageData.width,
+    height: rendered.imageData.height,
+    offsetX: rendered.offsetX,
+    offsetY: rendered.offsetY,
+    bounds: rendered.bounds,
+    canvas,
+    bitmap,
+    pngBlob
+  })
+}
+```
+
+Parser convenience methods avoid the extra `renderAtTimestamp()` step:
+
+```ts
+const rendered = parser.renderFrameDataAtTimestamp(120.5)
+const fullScreenFrame = parser.renderFrameDataAtIndex(42, { crop: 'screen' })
+```
+
+Cropping modes:
+
+- `bounds` is the default. It returns a tightly cropped composed image and records where that image belongs in the original subtitle presentation area via `offsetX` and `offsetY`.
+- `screen` preserves the full subtitle presentation dimensions, which is useful when you need stable frame sizes for test fixtures or when drawing into a presentation-sized surface.
+
+Drawing behavior:
+
+- `toCanvas(frame)` creates a new canvas sized to the rendered export.
+- Passing an existing canvas target resizes it by default before drawing.
+- Passing an existing 2D context draws in place by default, which is useful when you want subtitles composited into your own pre-sized surface.
+
+## Diagnostics mode
+
+Enable `debug: true` on high-level renderers when you need richer field diagnostics for malformed subtitle files. In debug mode, libbitsub records the most recent render attempt and emits structured warnings in addition to the existing lifecycle events.
+
+```ts
+import { PgsRenderer, SubtitleDiagnosticError } from 'libbitsub'
+
+const renderer = new PgsRenderer({
+  video: videoElement,
+  subUrl: '/subtitles/movie.sup',
+  debug: true,
+  onWarning: (warning) => {
+    console.warn('[warning]', warning.code, warning.message, warning.details)
+  },
+  onError: (error) => {
+    if (error instanceof SubtitleDiagnosticError) {
+      console.error('[error]', error.code, error.message, error.details)
+      return
+    }
+
+    console.error(error)
+  }
+})
+
+console.log(renderer.getStats())
+console.log(renderer.getCacheStats())
+console.log(renderer.getLastRenderInfo())
+```
+
+Structured diagnostic error codes currently include:
+
+- `UNSUPPORTED_FORMAT`
+- `BAD_IDX`
+- `MISSING_PALETTE`
+- `TRACK_NOT_FOUND`
+- `MISSING_INPUT`
+- `FETCH_FAILED`
+- `INVALID_SUBTITLE_DATA`
+- `WORKER_FALLBACK`
+- `UNKNOWN`
+
+Warnings use a smaller code set focused on non-fatal conditions such as malformed bitmap buffers, worker fallback, and missing PGS palettes during render.
+
 ## MKS security and corruption checks
 
 The `.mks` path validates Matroska structure before handing payloads to the VobSub decoder. Embedded subtitle blocks are size-checked, compressed blocks use bounded zlib inflation, and extracted SPU packets are rejected if their declared payload lengths or control offsets are inconsistent. Malformed or oversized `.mks` payloads fail fast instead of being partially decoded.
@@ -260,6 +401,7 @@ const renderer = new PgsRenderer({
       case 'loading':
       case 'loaded':
       case 'error':
+      case 'warning':
       case 'renderer-change':
       case 'worker-state':
       case 'cache-change':
@@ -328,7 +470,8 @@ Emitted events:
 | --- | --- |
 | `loading` | subtitle format |
 | `loaded` | subtitle format and parser metadata |
-| `error` | subtitle format and `Error` |
+| `error` | subtitle format and `SubtitleDiagnosticErrorLike` |
+| `warning` | `SubtitleDiagnosticWarning` |
 | `renderer-change` | active backend: `webgpu`, `webgl2`, or `canvas2d` |
 | `worker-state` | whether worker mode is enabled, ready, fallback status, and the active session ID |
 | `cache-change` | cached frame count, pending renders, and configured cache limit |
@@ -356,6 +499,8 @@ const stats = renderer.getStats()
 - `totalEntries`
 - `currentIndex`
 
+`getCacheStats()` adds worker/session state for the current renderer cache, while `getLastRenderInfo()` exposes the most recent render outcome with a status of `rendered`, `cleared`, `pending`, `empty`, or `failed`.
+
 ## Low-level APIs
 
 ### PGS parser
@@ -368,7 +513,9 @@ parser.load(new Uint8Array(arrayBuffer))
 
 const timestamps = parser.getTimestamps()
 const frame = parser.renderAtIndex(0)
+const rendered = parser.renderFrameDataAtTimestamp(120.5)
 const metadata = parser.getMetadata()
+const lastIssue = parser.getLastRenderIssue()
 ```
 
 ### VobSub parser
@@ -381,7 +528,9 @@ parser.loadFromData(idxContent, new Uint8Array(subArrayBuffer))
 parser.setDebandEnabled(true)
 
 const frame = parser.renderAtTimestamp(120.5)
+const rendered = parser.renderFrameDataAtIndex(0, { crop: 'screen' })
 const cue = parser.getCueMetadata(0)
+const lastIssue = parser.getLastRenderIssue()
 ```
 
 ### Unified parser
@@ -391,7 +540,10 @@ import { UnifiedSubtitleParser, detectSubtitleFormat } from 'libbitsub'
 
 const format = detectSubtitleFormat({ data: subtitleBytes, fileName: 'track.sup' })
 
-const parser = new UnifiedSubtitleParser()
+const parser = new UnifiedSubtitleParser({
+  debug: true,
+  onWarning: (warning) => console.warn(warning.code, warning.message)
+})
 parser.loadAuto({ data: subtitleBytes, fileName: 'track.sup' })
 ```
 
@@ -404,19 +556,20 @@ libbitsub prefers:
 3. Canvas2D
 
 ```ts
-import { isWebGL2Supported, isWebGPUSupported } from 'libbitsub'
+import { isWebGPUSupported } from 'libbitsub'
 
 console.log({
-  webgpu: isWebGPUSupported(),
-  webgl2: isWebGL2Supported()
+  webgpu: isWebGPUSupported()
 })
 ```
 
+WebGL2 and Canvas2D fallback remain automatic. Use `onWebGPUFallback`, `onWebGL2Fallback`, `onEvent`, or `onWarning` if you need to observe backend changes.
+
 ## Notes
 
 - Worker mode is shared, but subtitle parser state is isolated per renderer session.
 - Multiple subtitle renderers can coexist without reusing the same parser instance.
-- If worker startup fails, the high-level API falls back to main-thread parsing.
+- If worker startup fails, the high-level API falls back to main-thread parsing and emits a `WORKER_FALLBACK` warning/event when diagnostics are being observed.
 - The library only handles bitmap subtitle formats. It does not parse text subtitle formats such as SRT or ASS.
 
 ## API Reference
@@ -428,6 +581,13 @@ console.log({
 - `isWebGPUSupported(): boolean` checks WebGPU support.
 - `detectSubtitleFormat(source: AutoSubtitleSource): 'pgs' | 'vobsub' | null` detects the bitmap subtitle format from file hints or binary data.
 - `createAutoSubtitleRenderer(options: AutoVideoSubtitleOptions): PgsRenderer | VobSubRenderer` creates a high-level renderer after format detection.
+- `openSubtitles(source, options?): Promise<OpenedSubtitles>` initializes WASM, auto-detects the low-level format, and returns a normalized parser handle.
+- `renderFrameData(frame, options?): SubtitleRenderedFrameData | null` composes a `SubtitleData` frame into exportable pixels.
+- `toCanvas(frame, target?, options?): HTMLCanvasElement | OffscreenCanvas` draws a rendered frame to a new or existing canvas/context.
+- `toImageBitmap(frame, options?): Promise<ImageBitmap>` creates an `ImageBitmap` from a subtitle frame export.
+- `toBlob(frame, type?, quality?, options?): Promise<Blob>` encodes a subtitle frame export, defaulting to PNG.
+- `SubtitleDiagnosticError` is the structured error class libbitsub uses for coded diagnostics.
+- `createSubtitleDiagnosticError(...)` and `normalizeSubtitleError(...)` are exported for integrations that want to preserve libbitsub-style error codes.
 - Legacy aliases remain exported: `PGSRenderer`, `VobsubRenderer`, `UnifiedSubtitleRenderer`.
 
 ### High-level renderers
@@ -439,6 +599,8 @@ console.log({
 - `setDisplaySettings(settings: Partial<SubtitleDisplaySettings>): void` updates layout settings.
 - `resetDisplaySettings(): void` resets layout settings to defaults.
 - `getStats(): SubtitleRendererStats` returns render statistics.
+- `getCacheStats(): SubtitleCacheStats` returns cache occupancy, worker readiness, and session ID details.
+- `getLastRenderInfo(): SubtitleLastRenderInfo | null` returns the last render attempt recorded in debug mode.
 - `getMetadata(): SubtitleParserMetadata | null` returns track-level metadata.
 - `getCurrentCueMetadata(): SubtitleCueMetadata | null` returns the currently displayed cue metadata.
 - `getCueMetadata(index: number): SubtitleCueMetadata | null` returns metadata for a specific cue.
@@ -553,7 +715,8 @@ interface SubtitleDisplaySettings {
 type SubtitleRendererEvent =
   | { type: 'loading'; format: SubtitleFormatName }
   | { type: 'loaded'; format: SubtitleFormatName; metadata: SubtitleParserMetadata }
-  | { type: 'error'; format: SubtitleFormatName; error: Error }
+  | { type: 'error'; format: SubtitleFormatName; error: SubtitleDiagnosticErrorLike }
+  | { type: 'warning'; warning: SubtitleDiagnosticWarning }
   | { type: 'renderer-change'; renderer: 'webgpu' | 'webgl2' | 'canvas2d' }
   | { type: 'worker-state'; enabled: boolean; ready: boolean; sessionId: string | null; fallback?: boolean }
   | { type: 'cache-change'; cachedFrames: number; pendingRenders: number; cacheLimit: number }
@@ -578,6 +741,11 @@ Both shapes expose:
 - `totalEntries`
 - `currentIndex`
 
+Related diagnostics shapes:
+
+- `SubtitleCacheStats` from `getCacheStats()`.
+- `SubtitleLastRenderInfo` from `getLastRenderInfo()` when `debug` is enabled.
+
 #### `SubtitleParserMetadata`
 
 ```ts

package/pkg/libbitsub.d.ts

@@ -57,6 +57,10 @@ export class PgsParser {
      * Get the number of display sets.
      */
     readonly count: number;
+    /**
+     * Get the last non-fatal render issue for diagnostics.
+     */
+    readonly lastRenderIssue: string;
     /**
      * Get the presentation height for this subtitle track.
      */
@@ -231,6 +235,10 @@ export class SubtitleRenderer {
      * Get the VobSub language code if available.
      */
     readonly language: string;
+    /**
+     * Get the last non-fatal render issue for diagnostics.
+     */
+    readonly lastRenderIssue: string;
     /**
      * Get the presentation height for the loaded subtitle track.
      */
@@ -351,6 +359,10 @@ export class VobSubParser {
      * Get the declared language code from IDX metadata.
      */
     readonly language: string;
+    /**
+     * Get the last non-fatal render issue for diagnostics.
+     */
+    readonly lastRenderIssue: string;
     /**
      * Get the presentation height for this subtitle track.
      */
@@ -390,6 +402,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_lastRenderIssue: (a: number) => [number, number];
     readonly pgsparser_new: () => number;
     readonly pgsparser_parse: (a: number, b: number, c: number) => number;
     readonly pgsparser_renderAtIndex: (a: number, b: number) => number;
@@ -420,6 +433,7 @@ export interface InitOutput {
     readonly subtitlerenderer_getTimestamps: (a: number) => any;
     readonly subtitlerenderer_hasIdxMetadata: (a: number) => number;
     readonly subtitlerenderer_language: (a: number) => [number, number];
+    readonly subtitlerenderer_lastRenderIssue: (a: number) => [number, number];
     readonly subtitlerenderer_loadPgs: (a: number, b: number, c: number) => number;
     readonly subtitlerenderer_loadVobSub: (a: number, b: number, c: number, d: number, e: number) => void;
     readonly subtitlerenderer_loadVobSubMks: (a: number, b: number, c: number) => [number, number];
@@ -449,6 +463,7 @@ export interface InitOutput {
     readonly vobsubparser_getTimestamps: (a: number) => any;
     readonly vobsubparser_hasIdxMetadata: (a: number) => number;
     readonly vobsubparser_language: (a: number) => [number, number];
+    readonly vobsubparser_lastRenderIssue: (a: number) => [number, number];
     readonly vobsubparser_loadFromData: (a: number, b: number, c: number, d: number, e: number) => void;
     readonly vobsubparser_loadFromMks: (a: number, b: number, c: number) => [number, number];
     readonly vobsubparser_loadFromSubOnly: (a: number, b: number, c: number) => void;

package/pkg/libbitsub.js

@@ -90,6 +90,22 @@ export class PgsParser {
         const ret = wasm.pgsparser_getTimestamps(this.__wbg_ptr);
         return ret;
     }
+    /**
+     * Get the last non-fatal render issue for diagnostics.
+     * @returns {string}
+     */
+    get lastRenderIssue() {
+        let deferred1_0;
+        let deferred1_1;
+        try {
+            const ret = wasm.pgsparser_lastRenderIssue(this.__wbg_ptr);
+            deferred1_0 = ret[0];
+            deferred1_1 = ret[1];
+            return getStringFromWasm0(ret[0], ret[1]);
+        } finally {
+            wasm.__wbindgen_free(deferred1_0, deferred1_1, 1);
+        }
+    }
     /**
      * Create a new PGS parser.
      */
@@ -471,6 +487,22 @@ export class SubtitleRenderer {
             wasm.__wbindgen_free(deferred1_0, deferred1_1, 1);
         }
     }
+    /**
+     * Get the last non-fatal render issue for diagnostics.
+     * @returns {string}
+     */
+    get lastRenderIssue() {
+        let deferred1_0;
+        let deferred1_1;
+        try {
+            const ret = wasm.subtitlerenderer_lastRenderIssue(this.__wbg_ptr);
+            deferred1_0 = ret[0];
+            deferred1_1 = ret[1];
+            return getStringFromWasm0(ret[0], ret[1]);
+        } finally {
+            wasm.__wbindgen_free(deferred1_0, deferred1_1, 1);
+        }
+    }
     /**
      * Load PGS subtitle data.
      * @param {Uint8Array} data
@@ -772,6 +804,22 @@ export class VobSubParser {
             wasm.__wbindgen_free(deferred1_0, deferred1_1, 1);
         }
     }
+    /**
+     * Get the last non-fatal render issue for diagnostics.
+     * @returns {string}
+     */
+    get lastRenderIssue() {
+        let deferred1_0;
+        let deferred1_1;
+        try {
+            const ret = wasm.vobsubparser_lastRenderIssue(this.__wbg_ptr);
+            deferred1_0 = ret[0];
+            deferred1_1 = ret[1];
+            return getStringFromWasm0(ret[0], ret[1]);
+        } finally {
+            wasm.__wbindgen_free(deferred1_0, deferred1_1, 1);
+        }
+    }
     /**
      * Load VobSub from IDX content and SUB data.
      * @param {string} idx_content

package/pkg/libbitsub_bg.wasm.d.ts

@@ -17,6 +17,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_lastRenderIssue: (a: number) => [number, number];
 export const pgsparser_new: () => number;
 export const pgsparser_parse: (a: number, b: number, c: number) => number;
 export const pgsparser_renderAtIndex: (a: number, b: number) => number;
@@ -47,6 +48,7 @@ export const subtitlerenderer_getCueStartTime: (a: number, b: number) => number;
 export const subtitlerenderer_getTimestamps: (a: number) => any;
 export const subtitlerenderer_hasIdxMetadata: (a: number) => number;
 export const subtitlerenderer_language: (a: number) => [number, number];
+export const subtitlerenderer_lastRenderIssue: (a: number) => [number, number];
 export const subtitlerenderer_loadPgs: (a: number, b: number, c: number) => number;
 export const subtitlerenderer_loadVobSub: (a: number, b: number, c: number, d: number, e: number) => void;
 export const subtitlerenderer_loadVobSubMks: (a: number, b: number, c: number) => [number, number];
@@ -76,6 +78,7 @@ export const vobsubparser_getCueStartTime: (a: number, b: number) => number;
 export const vobsubparser_getTimestamps: (a: number) => any;
 export const vobsubparser_hasIdxMetadata: (a: number) => number;
 export const vobsubparser_language: (a: number) => [number, number];
+export const vobsubparser_lastRenderIssue: (a: number) => [number, number];
 export const vobsubparser_loadFromData: (a: number, b: number, c: number, d: number, e: number) => void;
 export const vobsubparser_loadFromMks: (a: number, b: number, c: number) => [number, number];
 export const vobsubparser_loadFromSubOnly: (a: number, b: number, c: number) => void;

package/pkg/package.json

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

package/src/wrapper.ts

@@ -7,14 +7,28 @@
 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,
@@ -26,6 +40,8 @@ export type {
   VobSubFrame
 } from './ts/types'
 
+export { SubtitleDiagnosticError, createSubtitleDiagnosticError, normalizeSubtitleError } from './ts/diagnostics'
+
 // Re-export WASM management
 export { initWasm, isWasmInitialized } from './ts/wasm'
 
@@ -33,7 +49,10 @@ export { initWasm, isWasmInitialized } from './ts/wasm'
 export { isWebGPUSupported } from './ts/webgpu-renderer'
 
 // Re-export parsers
-export { PgsParser, VobSubParserLowLevel, UnifiedSubtitleParser } from './ts/parsers'
+export { PgsParser, VobSubParserLowLevel, UnifiedSubtitleParser, openSubtitles } from './ts/parsers'
+
+// Re-export frame export helpers
+export { renderFrameData, toBlob, toCanvas, toImageBitmap } from './ts/frame-export'
 
 // Re-export renderers
 export { PgsRenderer, VobSubRenderer, createAutoSubtitleRenderer, type SubtitleRendererStats } from './ts/renderers'