libbitsub 1.7.0 → 1.7.1

package/README.md

@@ -384,222 +384,225 @@ console.log({
 - If worker startup fails, the high-level API falls back to main-thread parsing.
 - The library only handles bitmap subtitle formats. It does not parse text subtitle formats such as SRT or ASS.
 
-## Low-Level API (Programmatic Use)
+## API Reference
 
-For more control over rendering, use the low-level parsers directly.
+### Top-level exports
 
-### PGS Subtitles (Low-Level)
+- `initWasm(): Promise<void>` initializes the WASM module.
+- `isWasmInitialized(): boolean` reports whether initialization has completed.
+- `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.
+- Legacy aliases remain exported: `PGSRenderer`, `VobsubRenderer`, `UnifiedSubtitleRenderer`.
 
-```typescript
-import { initWasm, PgsParser } from 'libbitsub'
+### High-level renderers
 
-await initWasm()
+#### `PgsRenderer`
 
-const parser = new PgsParser()
+- `constructor(options: VideoSubtitleOptions)` creates a video-synced PGS renderer.
+- `getDisplaySettings(): SubtitleDisplaySettings` returns the current layout settings.
+- `setDisplaySettings(settings: Partial<SubtitleDisplaySettings>): void` updates layout settings.
+- `resetDisplaySettings(): void` resets layout settings to defaults.
+- `getStats(): SubtitleRendererStats` returns render statistics.
+- `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.
+- `getCacheLimit(): number` returns the active frame-cache limit.
+- `setCacheLimit(limit: number): void` updates the frame-cache limit.
+- `clearFrameCache(): void` clears the renderer-side and parser-side frame cache.
+- `prefetchRange(startIndex: number, endIndex: number): Promise<void>` prefetches decoded frames for a cue range.
+- `prefetchAroundTime(time: number, before?: number, after?: number): Promise<void>` prefetches around a playback time in seconds.
+- `dispose(): void` releases DOM, parser, and worker resources.
 
-// Load PGS data from a .sup file
-const response = await fetch('subtitles.sup')
-const data = new Uint8Array(await response.arrayBuffer())
-parser.load(data)
+#### `VobSubRenderer`
 
-// Get timestamps
-const timestamps = parser.getTimestamps() // Float64Array in milliseconds
+- Supports all `PgsRenderer` methods above.
+- `setDebandEnabled(enabled: boolean): void` enables or disables debanding.
+- `setDebandThreshold(threshold: number): void` updates the deband threshold.
+- `setDebandRange(range: number): void` updates the deband sample range.
+- `debandEnabled: boolean` reports whether debanding is enabled.
 
-// Render at a specific time
-const subtitleData = parser.renderAtTimestamp(currentTimeInSeconds)
-if (subtitleData) {
-  for (const comp of subtitleData.compositionData) {
-    ctx.putImageData(comp.pixelData, comp.x, comp.y)
-  }
-}
+### Low-level parsers
 
-// Clean up
-parser.dispose()
-```
+#### `PgsParser`
 
-### VobSub Subtitles (Low-Level)
+- `load(data: Uint8Array): number` loads PGS data and returns the cue count.
+- `getTimestamps(): Float64Array` returns cue timestamps in milliseconds.
+- `count: number` returns the number of cues.
+- `findIndexAtTimestamp(timeSeconds: number): number` finds the cue index for a playback time in seconds.
+- `renderAtIndex(index: number): SubtitleData | undefined` renders a cue by index.
+- `renderAtTimestamp(timeSeconds: number): SubtitleData | undefined` renders a cue at a playback time.
+- `getMetadata(): SubtitleParserMetadata` returns parser metadata.
+- `getCueMetadata(index: number): SubtitleCueMetadata | null` returns cue metadata.
+- `clearCache(): void` clears parser-side caches.
+- `dispose(): void` frees parser resources.
 
-```typescript
-import { initWasm, VobSubParserLowLevel } from 'libbitsub'
+#### `VobSubParserLowLevel`
 
-await initWasm()
+- `loadFromData(idxContent: string, subData: Uint8Array): void` loads IDX and SUB data.
+- `loadFromSubOnly(subData: Uint8Array): void` loads SUB-only VobSub data.
+- `getTimestamps(): Float64Array`, `count`, `findIndexAtTimestamp()`, `renderAtIndex()`, `renderAtTimestamp()`, `getMetadata()`, `getCueMetadata()`, `clearCache()`, and `dispose()` behave like `PgsParser`.
+- `setDebandEnabled(enabled: boolean): void`, `setDebandThreshold(threshold: number): void`, `setDebandRange(range: number): void`, and `debandEnabled` control debanding.
 
-const parser = new VobSubParserLowLevel()
+#### `UnifiedSubtitleParser`
 
-// Load from IDX + SUB files
-const idxResponse = await fetch('subtitles.idx')
-const idxContent = await idxResponse.text()
-const subResponse = await fetch('subtitles.sub')
-const subData = new Uint8Array(await subResponse.arrayBuffer())
+- `loadPgs(data: Uint8Array): number` loads PGS data.
+- `loadVobSub(idxContent: string, subData: Uint8Array): void` loads VobSub from IDX and SUB.
+- `loadVobSubOnly(subData: Uint8Array): void` loads SUB-only VobSub data.
+- `loadAuto(source: AutoSubtitleSource): SubtitleFormatName` detects and loads a supported bitmap subtitle format.
+- `format: 'pgs' | 'vobsub' | null` returns the active format.
+- `getTimestamps()`, `count`, `findIndexAtTimestamp()`, `renderAtIndex()`, `renderAtTimestamp()`, `getMetadata()`, `getCueMetadata()`, `clearCache()`, and `dispose()` are available as on the format-specific parsers.
 
-parser.loadFromData(idxContent, subData)
+### Core option and data types
 
-// Or load from SUB file only
-// parser.loadFromSubOnly(subData);
+#### `VideoSubtitleOptions`
 
-// Render
-const subtitleData = parser.renderAtTimestamp(currentTimeInSeconds)
-if (subtitleData) {
-  for (const comp of subtitleData.compositionData) {
-    ctx.putImageData(comp.pixelData, comp.x, comp.y)
+```ts
+interface VideoSubtitleOptions {
+  video: HTMLVideoElement
+  subUrl?: string
+  subContent?: ArrayBuffer
+  workerUrl?: string
+  onLoading?: () => void
+  onLoaded?: () => void
+  onError?: (error: Error) => void
+  onWebGPUFallback?: () => void
+  onWebGL2Fallback?: () => void
+  displaySettings?: Partial<SubtitleDisplaySettings>
+  cacheLimit?: number
+  prefetchWindow?: {
+    before?: number
+    after?: number
   }
+  onEvent?: (event: SubtitleRendererEvent) => void
 }
-
-parser.dispose()
 ```
 
-### Unified Parser
-
-For handling both formats with a single API:
-
-```typescript
-import { initWasm, UnifiedSubtitleParser } from 'libbitsub'
-
-await initWasm()
-
-const parser = new UnifiedSubtitleParser()
-
-// Load PGS
-parser.loadPgs(pgsData)
-
-// Or load VobSub
-// parser.loadVobSub(idxContent, subData);
-
-console.log(parser.format) // 'pgs' or 'vobsub'
-
-const subtitleData = parser.renderAtTimestamp(time)
-// ... render to canvas
+#### `VideoVobSubOptions`
 
-parser.dispose()
+```ts
+interface VideoVobSubOptions extends VideoSubtitleOptions {
+  idxUrl?: string
+  idxContent?: string
+}
 ```
 
-## API Reference
-
-### High-Level (Video-Integrated)
-
-#### `PgsRenderer`
-
-- `constructor(options: VideoSubtitleOptions)` - Create video-integrated PGS renderer
-- `getDisplaySettings(): SubtitleDisplaySettings` - Get current display settings
-- `setDisplaySettings(settings: Partial<SubtitleDisplaySettings>): void` - Update display settings
-- `resetDisplaySettings(): void` - Reset display settings to defaults
-- `getStats(): SubtitleRendererStats` - Get performance statistics
-- `dispose(): void` - Clean up all resources
+#### `AutoVideoSubtitleOptions`
 
-#### `VobSubRenderer`
-
-- `constructor(options: VideoVobSubOptions)` - Create video-integrated VobSub renderer
-- `getDisplaySettings(): SubtitleDisplaySettings` - Get current display settings
-- `setDisplaySettings(settings: Partial<SubtitleDisplaySettings>): void` - Update display settings
-- `resetDisplaySettings(): void` - Reset display settings to defaults
-- `getStats(): SubtitleRendererStats` - Get performance statistics
-- `setDebandEnabled(enabled: boolean): void` - Enable/disable debanding filter
-- `setDebandThreshold(threshold: number): void` - Set debanding threshold (0.0-255.0)
-- `setDebandRange(range: number): void` - Set debanding sample range (1-64)
-- `debandEnabled: boolean` - Check if debanding is enabled
-- `dispose(): void` - Clean up all resources
-
-### Low-Level (Programmatic)
+```ts
+interface AutoVideoSubtitleOptions extends Omit<VideoVobSubOptions, 'subUrl' | 'idxUrl'> {
+  subUrl?: string
+  idxUrl?: string
+  fileName?: string
+}
+```
 
-#### `PgsParser`
+#### `SubtitleDisplaySettings`
 
-- `load(data: Uint8Array): number` - Load PGS data, returns display set count
-- `getTimestamps(): Float64Array` - Get all timestamps in milliseconds
-- `count: number` - Number of display sets
-- `findIndexAtTimestamp(timeSeconds: number): number` - Find index for timestamp
-- `renderAtIndex(index: number): SubtitleData | undefined` - Render at index
-- `renderAtTimestamp(timeSeconds: number): SubtitleData | undefined` - Render at time
-- `clearCache(): void` - Clear decoded bitmap cache
-- `dispose(): void` - Release resources
+```ts
+interface SubtitleDisplaySettings {
+  scale: number
+  verticalOffset: number
+  horizontalOffset: number
+  horizontalAlign: 'left' | 'center' | 'right'
+  bottomPadding: number
+  safeArea: number
+  opacity: number
+}
+```
 
-#### `VobSubParserLowLevel`
+#### `SubtitleRendererEvent`
 
-- `loadFromData(idxContent: string, subData: Uint8Array): void` - Load IDX + SUB
-- `loadFromSubOnly(subData: Uint8Array): void` - Load SUB only
-- `setDebandEnabled(enabled: boolean): void` - Enable/disable debanding filter
-- `setDebandThreshold(threshold: number): void` - Set debanding threshold (0.0-255.0)
-- `setDebandRange(range: number): void` - Set debanding sample range (1-64)
-- `debandEnabled: boolean` - Check if debanding is enabled
-- Same rendering methods as PgsParser
+```ts
+type SubtitleRendererEvent =
+  | { type: 'loading'; format: SubtitleFormatName }
+  | { type: 'loaded'; format: SubtitleFormatName; metadata: SubtitleParserMetadata }
+  | { type: 'error'; format: SubtitleFormatName; error: Error }
+  | { 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 }
+  | { type: 'cue-change'; cue: SubtitleCueMetadata | null }
+  | { type: 'stats'; stats: SubtitleRendererStatsSnapshot }
+```
 
-#### `UnifiedSubtitleParser`
+#### `SubtitleRendererStats` and `SubtitleRendererStatsSnapshot`
 
-- `loadPgs(data: Uint8Array): number` - Load PGS data
-- `loadVobSub(idxContent: string, subData: Uint8Array): void` - Load VobSub
-- `loadVobSubOnly(subData: Uint8Array): void` - Load SUB only
-- `format: 'pgs' | 'vobsub' | null` - Current format
-- Same rendering methods as above
+Both shapes expose:
 
-### Types
+- `framesRendered`
+- `framesDropped`
+- `avgRenderTime`
+- `maxRenderTime`
+- `minRenderTime`
+- `lastRenderTime`
+- `renderFps`
+- `usingWorker`
+- `cachedFrames`
+- `pendingRenders`
+- `totalEntries`
+- `currentIndex`
 
-#### `VideoSubtitleOptions`
+#### `SubtitleParserMetadata`
 
-```typescript
-interface VideoSubtitleOptions {
-  video: HTMLVideoElement // Video element to sync with
-  subUrl?: string // URL to subtitle file (provide this OR subContent)
-  subContent?: ArrayBuffer // Direct subtitle content (provide this OR subUrl)
-  workerUrl?: string // Worker URL (for API compatibility)
-  onLoading?: () => void // Called when subtitle loading starts
-  onLoaded?: () => void // Called when subtitle loading completes
-  onError?: (error: Error) => void // Called when subtitle loading fails
-  onWebGPUFallback?: () => void // Called when WebGPU init fails
-  onWebGL2Fallback?: () => void // Called when WebGL2 init fails
+```ts
+interface SubtitleParserMetadata {
+  format: 'pgs' | 'vobsub'
+  cueCount: number
+  screenWidth: number
+  screenHeight: number
+  language?: string | null
+  trackId?: string | null
+  hasIdxMetadata?: boolean
 }
 ```
 
-#### `VideoVobSubOptions`
+#### `SubtitleCueMetadata`
 
-```typescript
-interface VideoVobSubOptions extends VideoSubtitleOptions {
-  idxUrl?: string // URL to .idx file (optional, defaults to subUrl with .idx extension)
-  idxContent?: string // Direct .idx content (provide this OR idxUrl)
+```ts
+interface SubtitleCueMetadata {
+  index: number
+  format: 'pgs' | 'vobsub'
+  startTime: number
+  endTime: number
+  duration: number
+  screenWidth: number
+  screenHeight: number
+  bounds: SubtitleCueBounds | null
+  compositionCount: number
+  paletteId?: number
+  compositionState?: number
+  language?: string | null
+  trackId?: string | null
+  filePosition?: number
 }
 ```
 
-#### `SubtitleDisplaySettings`
-
-```typescript
-interface SubtitleDisplaySettings {
-  // Scale factor (1.0 = 100%, 0.5 = 50%, 2.0 = 200%)
-  scale: number
-  // Vertical offset as % of video height (-50 to 50)
-  verticalOffset: number
-}
-```
+#### `AutoSubtitleSource`
 
-#### `SubtitleRendererStats`
-
-```typescript
-interface SubtitleRendererStats {
-  framesRendered: number // Total frames rendered since initialization
-  framesDropped: number // Frames dropped due to slow rendering
-  avgRenderTime: number // Average render time in milliseconds
-  maxRenderTime: number // Maximum render time in milliseconds
-  minRenderTime: number // Minimum render time in milliseconds
-  lastRenderTime: number // Last render time in milliseconds
-  renderFps: number // Current FPS (renders per second)
-  usingWorker: boolean // Whether rendering is using web worker
-  cachedFrames: number // Number of cached frames
-  pendingRenders: number // Number of pending renders
-  totalEntries: number // Total subtitle entries/display sets
-  currentIndex: number // Current subtitle index being displayed
+```ts
+interface AutoSubtitleSource {
+  data?: ArrayBuffer | Uint8Array
+  subData?: ArrayBuffer | Uint8Array
+  idxContent?: string
+  fileName?: string
+  subUrl?: string
+  idxUrl?: string
 }
 ```
 
 #### `SubtitleData`
 
-```typescript
+```ts
 interface SubtitleData {
-  width: number // Screen width
-  height: number // Screen height
+  width: number
+  height: number
   compositionData: SubtitleCompositionData[]
 }
 
 interface SubtitleCompositionData {
-  pixelData: ImageData // RGBA pixel data
-  x: number // X position
-  y: number // Y position
+  pixelData: ImageData
+  x: number
+  y: number
 }
 ```
 

package/dist/ts/webgpu-renderer.d.ts

@@ -31,11 +31,14 @@ export declare class WebGPURenderer {
     private _canvas;
     private _initPromise;
     private _initialized;
+    private _lastCanvasWidth;
+    private _lastCanvasHeight;
     /**
      * Initialize the WebGPU renderer.
      * Returns a promise that resolves when initialization is complete.
      */
     init(): Promise<void>;
+    private assertShaderModuleValid;
     private _initDevice;
     /**
      * Configure the canvas for WebGPU rendering.

package/dist/ts/webgpu-renderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"webgpu-renderer.d.ts","sourceRoot":"","sources":["../../src/ts/webgpu-renderer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAA;AAqEtD,UAAU,WAAW;IACnB,OAAO,EAAE,UAAU,CAAA;IACnB,IAAI,EAAE,cAAc,CAAA;IACpB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,+GAA+G;IAC/G,UAAU,EAAE,iBAAiB,GAAG,IAAI,CAAA;IACpC,yFAAyF;IACzF,SAAS,EAAE,YAAY,GAAG,IAAI,CAAA;CAC/B;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AAED;;;GAGG;AACH,qBAAa,cAAc;IACzB,MAAM,EAAE,SAAS,GAAG,IAAI,CAAO;IAC/B,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAAO;IACvC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAAO;IACzC,OAAO,EAAE,UAAU,GAAG,IAAI,CAAO;IACjC,eAAe,EAAE,kBAAkB,GAAG,IAAI,CAAO;IAGjD,aAAa,EAAE,SAAS,GAAG,IAAI,CAAO;IAGtC,eAAe,EAAE,SAAS,EAAE,CAAK;IAGjC,QAAQ,EAAE,WAAW,EAAE,CAAK;IAC5B,sBAAsB,EAAE,UAAU,EAAE,CAAK;IAEzC,MAAM,EAAE,gBAAgB,CAAe;IAEvC,OAAO,CAAC,OAAO,CAAiC;IAChD,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,YAAY,CAAQ;IAE5B;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAI1B;YAEa,WAAW;IA0GzB;;OAEG;IACG,SAAS,CAAC,MAAM,EAAE,iBAAiB,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA6BvF;IAED;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAO9C;IAED,OAAO,CAAC,iBAAiB;IAiBzB;;OAEG;IACH,MAAM,CACJ,YAAY,EAAE,uBAAuB,EAAE,EACvC,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd,IAAI,CAqJN;IAED;;OAEG;IACH,KAAK,IAAI,IAAI,CAmBZ;IAED;;OAEG;IACH,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED;;OAEG;IACH,OAAO,IAAI,IAAI,CAuBd;CACF"}
+{"version":3,"file":"webgpu-renderer.d.ts","sourceRoot":"","sources":["../../src/ts/webgpu-renderer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAA;AA2EtD,UAAU,WAAW;IACnB,OAAO,EAAE,UAAU,CAAA;IACnB,IAAI,EAAE,cAAc,CAAA;IACpB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,+GAA+G;IAC/G,UAAU,EAAE,iBAAiB,GAAG,IAAI,CAAA;IACpC,yFAAyF;IACzF,SAAS,EAAE,YAAY,GAAG,IAAI,CAAA;CAC/B;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AAED;;;GAGG;AACH,qBAAa,cAAc;IACzB,MAAM,EAAE,SAAS,GAAG,IAAI,CAAO;IAC/B,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAAO;IACvC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAAO;IACzC,OAAO,EAAE,UAAU,GAAG,IAAI,CAAO;IACjC,eAAe,EAAE,kBAAkB,GAAG,IAAI,CAAO;IAGjD,aAAa,EAAE,SAAS,GAAG,IAAI,CAAO;IAGtC,eAAe,EAAE,SAAS,EAAE,CAAK;IAGjC,QAAQ,EAAE,WAAW,EAAE,CAAK;IAC5B,sBAAsB,EAAE,UAAU,EAAE,CAAK;IAEzC,MAAM,EAAE,gBAAgB,CAAe;IAEvC,OAAO,CAAC,OAAO,CAAiC;IAChD,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,YAAY,CAAQ;IAC5B,OAAO,CAAC,gBAAgB,CAAI;IAC5B,OAAO,CAAC,iBAAiB,CAAI;IAE7B;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAI1B;YAEa,uBAAuB;YAgBvB,WAAW;IA6GzB;;OAEG;IACG,SAAS,CAAC,MAAM,EAAE,iBAAiB,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAkCvF;IAED;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAU9C;IAED,OAAO,CAAC,iBAAiB;IAiBzB;;OAEG;IACH,MAAM,CACJ,YAAY,EAAE,uBAAuB,EAAE,EACvC,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd,IAAI,CA6JN;IAED;;OAEG;IACH,KAAK,IAAI,IAAI,CAwBZ;IAED;;OAEG;IACH,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED;;OAEG;IACH,OAAO,IAAI,IAAI,CAyBd;CACF"}

package/dist/ts/webgpu-renderer.js

@@ -51,6 +51,12 @@ fn vertexMain(@builtin(vertex_index) vertexIndex: u32) -> VertexOutput {
 `;
 // WGSL Fragment Shader - sample RGBA texture directly
 const FRAGMENT_SHADER = /* wgsl */ `
+struct Uniforms {
+  resolution: vec2f,
+  opacity: f32,
+}
+
+@group(0) @binding(0) var<uniform> uniforms: Uniforms;
 @group(0) @binding(2) var texSampler: sampler;
 @group(0) @binding(3) var tex: texture_2d<f32>;
 
@@ -91,6 +97,8 @@ export class WebGPURenderer {
     _canvas = null;
     _initPromise = null;
     _initialized = false;
+    _lastCanvasWidth = 0;
+    _lastCanvasHeight = 0;
     /**
      * Initialize the WebGPU renderer.
      * Returns a promise that resolves when initialization is complete.
@@ -101,6 +109,19 @@ export class WebGPURenderer {
         this._initPromise = this._initDevice();
         return this._initPromise;
     }
+    async assertShaderModuleValid(module, label) {
+        const info = await module.getCompilationInfo();
+        const errors = info.messages.filter(message => message.type === 'error');
+        if (errors.length === 0)
+            return;
+        const formatted = errors
+            .map(message => {
+            const line = message.lineNum > 0 ? `:${message.lineNum}:${message.linePos}` : '';
+            return `${label}${line} ${message.message}`;
+        })
+            .join('\n');
+        throw new Error(`WebGPU ${label} shader compilation failed:\n${formatted}`);
+    }
     async _initDevice() {
         if (!navigator.gpu) {
             throw new Error('WebGPU not supported');
@@ -120,6 +141,8 @@ export class WebGPURenderer {
         const fragmentModule = this.device.createShaderModule({
             code: FRAGMENT_SHADER
         });
+        await this.assertShaderModuleValid(vertexModule, 'vertex');
+        await this.assertShaderModuleValid(fragmentModule, 'fragment');
         // Create sampler - use linear filtering for smooth scaling
         this.sampler = this.device.createSampler({
             magFilter: 'linear',
@@ -162,7 +185,7 @@ export class WebGPURenderer {
             bindGroupLayouts: [this.bindGroupLayout]
         });
         // Create render pipeline with alpha blending
-        this.pipeline = this.device.createRenderPipeline({
+        this.pipeline = await this.device.createRenderPipelineAsync({
             layout: pipelineLayout,
             vertex: {
                 module: vertexModule,
@@ -203,7 +226,15 @@ export class WebGPURenderer {
         if (!this.device) {
             throw new Error('WebGPU device not initialized');
         }
+        if (width <= 0 || height <= 0) {
+            return;
+        }
         this._canvas = canvas;
+        // Update canvas size before configuring to keep the swap chain in sync.
+        canvas.width = width;
+        canvas.height = height;
+        this._lastCanvasWidth = width;
+        this._lastCanvasHeight = height;
         // Get WebGPU context
         if (!this.context) {
             this.context = canvas.getContext('webgpu');
@@ -216,9 +247,6 @@ export class WebGPURenderer {
                 alphaMode: 'premultiplied'
             });
         }
-        // Update canvas size
-        canvas.width = width;
-        canvas.height = height;
         // Update uniform buffer with resolution
         this.device.queue.writeBuffer(this.uniformBuffer, 0, new Float32Array([width, height, 1, 0]));
     }
@@ -226,10 +254,14 @@ export class WebGPURenderer {
      * Update canvas dimensions.
      */
     updateSize(width, height) {
-        if (!this.device || !this._canvas)
+        if (!this.device || !this._canvas || width <= 0 || height <= 0)
+            return;
+        if (width === this._lastCanvasWidth && height === this._lastCanvasHeight)
             return;
         this._canvas.width = width;
         this._canvas.height = height;
+        this._lastCanvasWidth = width;
+        this._lastCanvasHeight = height;
         this.device.queue.writeBuffer(this.uniformBuffer, 0, new Float32Array([width, height, 1, 0]));
     }
     createTextureInfo(width, height) {
@@ -251,11 +283,20 @@ export class WebGPURenderer {
      * Render subtitle compositions to the canvas.
      */
     render(compositions, screenWidth, screenHeight, scaleX, scaleY, shiftX, shiftY, opacity) {
-        if (!this.device || !this.context || !this.pipeline)
+        if (!this.device || !this.context || !this.pipeline || !this._canvas)
             return;
+        let textureView;
+        try {
+            const currentTexture = this.context.getCurrentTexture();
+            if (currentTexture.width === 0 || currentTexture.height === 0)
+                return;
+            textureView = currentTexture.createView();
+        }
+        catch {
+            return;
+        }
         this.device.queue.writeBuffer(this.uniformBuffer, 0, new Float32Array([this._canvas.width, this._canvas.height, opacity, 0]));
         const commandEncoder = this.device.createCommandEncoder();
-        const textureView = this.context.getCurrentTexture().createView();
         // Begin render pass with clear
         const renderPass = commandEncoder.beginRenderPass({
             colorAttachments: [
@@ -380,20 +421,27 @@ export class WebGPURenderer {
     clear() {
         if (!this.device || !this.context)
             return;
-        const commandEncoder = this.device.createCommandEncoder();
-        const textureView = this.context.getCurrentTexture().createView();
-        const renderPass = commandEncoder.beginRenderPass({
-            colorAttachments: [
-                {
-                    view: textureView,
-                    clearValue: { r: 0, g: 0, b: 0, a: 0 },
-                    loadOp: 'clear',
-                    storeOp: 'store'
-                }
-            ]
-        });
-        renderPass.end();
-        this.device.queue.submit([commandEncoder.finish()]);
+        try {
+            const currentTexture = this.context.getCurrentTexture();
+            if (currentTexture.width === 0 || currentTexture.height === 0)
+                return;
+            const commandEncoder = this.device.createCommandEncoder();
+            const renderPass = commandEncoder.beginRenderPass({
+                colorAttachments: [
+                    {
+                        view: currentTexture.createView(),
+                        clearValue: { r: 0, g: 0, b: 0, a: 0 },
+                        loadOp: 'clear',
+                        storeOp: 'store'
+                    }
+                ]
+            });
+            renderPass.end();
+            this.device.queue.submit([commandEncoder.finish()]);
+        }
+        catch {
+            return;
+        }
     }
     /**
      * Check if renderer is initialized.
@@ -424,6 +472,8 @@ export class WebGPURenderer {
         this._canvas = null;
         this._initialized = false;
         this._initPromise = null;
+        this._lastCanvasWidth = 0;
+        this._lastCanvasHeight = 0;
     }
 }
 //# sourceMappingURL=webgpu-renderer.js.map

package/dist/ts/webgpu-renderer.js.map

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

package/package.json

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

package/pkg/README.md

@@ -384,222 +384,225 @@ console.log({
 - If worker startup fails, the high-level API falls back to main-thread parsing.
 - The library only handles bitmap subtitle formats. It does not parse text subtitle formats such as SRT or ASS.
 
-## Low-Level API (Programmatic Use)
+## API Reference
 
-For more control over rendering, use the low-level parsers directly.
+### Top-level exports
 
-### PGS Subtitles (Low-Level)
+- `initWasm(): Promise<void>` initializes the WASM module.
+- `isWasmInitialized(): boolean` reports whether initialization has completed.
+- `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.
+- Legacy aliases remain exported: `PGSRenderer`, `VobsubRenderer`, `UnifiedSubtitleRenderer`.
 
-```typescript
-import { initWasm, PgsParser } from 'libbitsub'
+### High-level renderers
 
-await initWasm()
+#### `PgsRenderer`
 
-const parser = new PgsParser()
+- `constructor(options: VideoSubtitleOptions)` creates a video-synced PGS renderer.
+- `getDisplaySettings(): SubtitleDisplaySettings` returns the current layout settings.
+- `setDisplaySettings(settings: Partial<SubtitleDisplaySettings>): void` updates layout settings.
+- `resetDisplaySettings(): void` resets layout settings to defaults.
+- `getStats(): SubtitleRendererStats` returns render statistics.
+- `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.
+- `getCacheLimit(): number` returns the active frame-cache limit.
+- `setCacheLimit(limit: number): void` updates the frame-cache limit.
+- `clearFrameCache(): void` clears the renderer-side and parser-side frame cache.
+- `prefetchRange(startIndex: number, endIndex: number): Promise<void>` prefetches decoded frames for a cue range.
+- `prefetchAroundTime(time: number, before?: number, after?: number): Promise<void>` prefetches around a playback time in seconds.
+- `dispose(): void` releases DOM, parser, and worker resources.
 
-// Load PGS data from a .sup file
-const response = await fetch('subtitles.sup')
-const data = new Uint8Array(await response.arrayBuffer())
-parser.load(data)
+#### `VobSubRenderer`
 
-// Get timestamps
-const timestamps = parser.getTimestamps() // Float64Array in milliseconds
+- Supports all `PgsRenderer` methods above.
+- `setDebandEnabled(enabled: boolean): void` enables or disables debanding.
+- `setDebandThreshold(threshold: number): void` updates the deband threshold.
+- `setDebandRange(range: number): void` updates the deband sample range.
+- `debandEnabled: boolean` reports whether debanding is enabled.
 
-// Render at a specific time
-const subtitleData = parser.renderAtTimestamp(currentTimeInSeconds)
-if (subtitleData) {
-  for (const comp of subtitleData.compositionData) {
-    ctx.putImageData(comp.pixelData, comp.x, comp.y)
-  }
-}
+### Low-level parsers
 
-// Clean up
-parser.dispose()
-```
+#### `PgsParser`
 
-### VobSub Subtitles (Low-Level)
+- `load(data: Uint8Array): number` loads PGS data and returns the cue count.
+- `getTimestamps(): Float64Array` returns cue timestamps in milliseconds.
+- `count: number` returns the number of cues.
+- `findIndexAtTimestamp(timeSeconds: number): number` finds the cue index for a playback time in seconds.
+- `renderAtIndex(index: number): SubtitleData | undefined` renders a cue by index.
+- `renderAtTimestamp(timeSeconds: number): SubtitleData | undefined` renders a cue at a playback time.
+- `getMetadata(): SubtitleParserMetadata` returns parser metadata.
+- `getCueMetadata(index: number): SubtitleCueMetadata | null` returns cue metadata.
+- `clearCache(): void` clears parser-side caches.
+- `dispose(): void` frees parser resources.
 
-```typescript
-import { initWasm, VobSubParserLowLevel } from 'libbitsub'
+#### `VobSubParserLowLevel`
 
-await initWasm()
+- `loadFromData(idxContent: string, subData: Uint8Array): void` loads IDX and SUB data.
+- `loadFromSubOnly(subData: Uint8Array): void` loads SUB-only VobSub data.
+- `getTimestamps(): Float64Array`, `count`, `findIndexAtTimestamp()`, `renderAtIndex()`, `renderAtTimestamp()`, `getMetadata()`, `getCueMetadata()`, `clearCache()`, and `dispose()` behave like `PgsParser`.
+- `setDebandEnabled(enabled: boolean): void`, `setDebandThreshold(threshold: number): void`, `setDebandRange(range: number): void`, and `debandEnabled` control debanding.
 
-const parser = new VobSubParserLowLevel()
+#### `UnifiedSubtitleParser`
 
-// Load from IDX + SUB files
-const idxResponse = await fetch('subtitles.idx')
-const idxContent = await idxResponse.text()
-const subResponse = await fetch('subtitles.sub')
-const subData = new Uint8Array(await subResponse.arrayBuffer())
+- `loadPgs(data: Uint8Array): number` loads PGS data.
+- `loadVobSub(idxContent: string, subData: Uint8Array): void` loads VobSub from IDX and SUB.
+- `loadVobSubOnly(subData: Uint8Array): void` loads SUB-only VobSub data.
+- `loadAuto(source: AutoSubtitleSource): SubtitleFormatName` detects and loads a supported bitmap subtitle format.
+- `format: 'pgs' | 'vobsub' | null` returns the active format.
+- `getTimestamps()`, `count`, `findIndexAtTimestamp()`, `renderAtIndex()`, `renderAtTimestamp()`, `getMetadata()`, `getCueMetadata()`, `clearCache()`, and `dispose()` are available as on the format-specific parsers.
 
-parser.loadFromData(idxContent, subData)
+### Core option and data types
 
-// Or load from SUB file only
-// parser.loadFromSubOnly(subData);
+#### `VideoSubtitleOptions`
 
-// Render
-const subtitleData = parser.renderAtTimestamp(currentTimeInSeconds)
-if (subtitleData) {
-  for (const comp of subtitleData.compositionData) {
-    ctx.putImageData(comp.pixelData, comp.x, comp.y)
+```ts
+interface VideoSubtitleOptions {
+  video: HTMLVideoElement
+  subUrl?: string
+  subContent?: ArrayBuffer
+  workerUrl?: string
+  onLoading?: () => void
+  onLoaded?: () => void
+  onError?: (error: Error) => void
+  onWebGPUFallback?: () => void
+  onWebGL2Fallback?: () => void
+  displaySettings?: Partial<SubtitleDisplaySettings>
+  cacheLimit?: number
+  prefetchWindow?: {
+    before?: number
+    after?: number
   }
+  onEvent?: (event: SubtitleRendererEvent) => void
 }
-
-parser.dispose()
 ```
 
-### Unified Parser
-
-For handling both formats with a single API:
-
-```typescript
-import { initWasm, UnifiedSubtitleParser } from 'libbitsub'
-
-await initWasm()
-
-const parser = new UnifiedSubtitleParser()
-
-// Load PGS
-parser.loadPgs(pgsData)
-
-// Or load VobSub
-// parser.loadVobSub(idxContent, subData);
-
-console.log(parser.format) // 'pgs' or 'vobsub'
-
-const subtitleData = parser.renderAtTimestamp(time)
-// ... render to canvas
+#### `VideoVobSubOptions`
 
-parser.dispose()
+```ts
+interface VideoVobSubOptions extends VideoSubtitleOptions {
+  idxUrl?: string
+  idxContent?: string
+}
 ```
 
-## API Reference
-
-### High-Level (Video-Integrated)
-
-#### `PgsRenderer`
-
-- `constructor(options: VideoSubtitleOptions)` - Create video-integrated PGS renderer
-- `getDisplaySettings(): SubtitleDisplaySettings` - Get current display settings
-- `setDisplaySettings(settings: Partial<SubtitleDisplaySettings>): void` - Update display settings
-- `resetDisplaySettings(): void` - Reset display settings to defaults
-- `getStats(): SubtitleRendererStats` - Get performance statistics
-- `dispose(): void` - Clean up all resources
+#### `AutoVideoSubtitleOptions`
 
-#### `VobSubRenderer`
-
-- `constructor(options: VideoVobSubOptions)` - Create video-integrated VobSub renderer
-- `getDisplaySettings(): SubtitleDisplaySettings` - Get current display settings
-- `setDisplaySettings(settings: Partial<SubtitleDisplaySettings>): void` - Update display settings
-- `resetDisplaySettings(): void` - Reset display settings to defaults
-- `getStats(): SubtitleRendererStats` - Get performance statistics
-- `setDebandEnabled(enabled: boolean): void` - Enable/disable debanding filter
-- `setDebandThreshold(threshold: number): void` - Set debanding threshold (0.0-255.0)
-- `setDebandRange(range: number): void` - Set debanding sample range (1-64)
-- `debandEnabled: boolean` - Check if debanding is enabled
-- `dispose(): void` - Clean up all resources
-
-### Low-Level (Programmatic)
+```ts
+interface AutoVideoSubtitleOptions extends Omit<VideoVobSubOptions, 'subUrl' | 'idxUrl'> {
+  subUrl?: string
+  idxUrl?: string
+  fileName?: string
+}
+```
 
-#### `PgsParser`
+#### `SubtitleDisplaySettings`
 
-- `load(data: Uint8Array): number` - Load PGS data, returns display set count
-- `getTimestamps(): Float64Array` - Get all timestamps in milliseconds
-- `count: number` - Number of display sets
-- `findIndexAtTimestamp(timeSeconds: number): number` - Find index for timestamp
-- `renderAtIndex(index: number): SubtitleData | undefined` - Render at index
-- `renderAtTimestamp(timeSeconds: number): SubtitleData | undefined` - Render at time
-- `clearCache(): void` - Clear decoded bitmap cache
-- `dispose(): void` - Release resources
+```ts
+interface SubtitleDisplaySettings {
+  scale: number
+  verticalOffset: number
+  horizontalOffset: number
+  horizontalAlign: 'left' | 'center' | 'right'
+  bottomPadding: number
+  safeArea: number
+  opacity: number
+}
+```
 
-#### `VobSubParserLowLevel`
+#### `SubtitleRendererEvent`
 
-- `loadFromData(idxContent: string, subData: Uint8Array): void` - Load IDX + SUB
-- `loadFromSubOnly(subData: Uint8Array): void` - Load SUB only
-- `setDebandEnabled(enabled: boolean): void` - Enable/disable debanding filter
-- `setDebandThreshold(threshold: number): void` - Set debanding threshold (0.0-255.0)
-- `setDebandRange(range: number): void` - Set debanding sample range (1-64)
-- `debandEnabled: boolean` - Check if debanding is enabled
-- Same rendering methods as PgsParser
+```ts
+type SubtitleRendererEvent =
+  | { type: 'loading'; format: SubtitleFormatName }
+  | { type: 'loaded'; format: SubtitleFormatName; metadata: SubtitleParserMetadata }
+  | { type: 'error'; format: SubtitleFormatName; error: Error }
+  | { 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 }
+  | { type: 'cue-change'; cue: SubtitleCueMetadata | null }
+  | { type: 'stats'; stats: SubtitleRendererStatsSnapshot }
+```
 
-#### `UnifiedSubtitleParser`
+#### `SubtitleRendererStats` and `SubtitleRendererStatsSnapshot`
 
-- `loadPgs(data: Uint8Array): number` - Load PGS data
-- `loadVobSub(idxContent: string, subData: Uint8Array): void` - Load VobSub
-- `loadVobSubOnly(subData: Uint8Array): void` - Load SUB only
-- `format: 'pgs' | 'vobsub' | null` - Current format
-- Same rendering methods as above
+Both shapes expose:
 
-### Types
+- `framesRendered`
+- `framesDropped`
+- `avgRenderTime`
+- `maxRenderTime`
+- `minRenderTime`
+- `lastRenderTime`
+- `renderFps`
+- `usingWorker`
+- `cachedFrames`
+- `pendingRenders`
+- `totalEntries`
+- `currentIndex`
 
-#### `VideoSubtitleOptions`
+#### `SubtitleParserMetadata`
 
-```typescript
-interface VideoSubtitleOptions {
-  video: HTMLVideoElement // Video element to sync with
-  subUrl?: string // URL to subtitle file (provide this OR subContent)
-  subContent?: ArrayBuffer // Direct subtitle content (provide this OR subUrl)
-  workerUrl?: string // Worker URL (for API compatibility)
-  onLoading?: () => void // Called when subtitle loading starts
-  onLoaded?: () => void // Called when subtitle loading completes
-  onError?: (error: Error) => void // Called when subtitle loading fails
-  onWebGPUFallback?: () => void // Called when WebGPU init fails
-  onWebGL2Fallback?: () => void // Called when WebGL2 init fails
+```ts
+interface SubtitleParserMetadata {
+  format: 'pgs' | 'vobsub'
+  cueCount: number
+  screenWidth: number
+  screenHeight: number
+  language?: string | null
+  trackId?: string | null
+  hasIdxMetadata?: boolean
 }
 ```
 
-#### `VideoVobSubOptions`
+#### `SubtitleCueMetadata`
 
-```typescript
-interface VideoVobSubOptions extends VideoSubtitleOptions {
-  idxUrl?: string // URL to .idx file (optional, defaults to subUrl with .idx extension)
-  idxContent?: string // Direct .idx content (provide this OR idxUrl)
+```ts
+interface SubtitleCueMetadata {
+  index: number
+  format: 'pgs' | 'vobsub'
+  startTime: number
+  endTime: number
+  duration: number
+  screenWidth: number
+  screenHeight: number
+  bounds: SubtitleCueBounds | null
+  compositionCount: number
+  paletteId?: number
+  compositionState?: number
+  language?: string | null
+  trackId?: string | null
+  filePosition?: number
 }
 ```
 
-#### `SubtitleDisplaySettings`
-
-```typescript
-interface SubtitleDisplaySettings {
-  // Scale factor (1.0 = 100%, 0.5 = 50%, 2.0 = 200%)
-  scale: number
-  // Vertical offset as % of video height (-50 to 50)
-  verticalOffset: number
-}
-```
+#### `AutoSubtitleSource`
 
-#### `SubtitleRendererStats`
-
-```typescript
-interface SubtitleRendererStats {
-  framesRendered: number // Total frames rendered since initialization
-  framesDropped: number // Frames dropped due to slow rendering
-  avgRenderTime: number // Average render time in milliseconds
-  maxRenderTime: number // Maximum render time in milliseconds
-  minRenderTime: number // Minimum render time in milliseconds
-  lastRenderTime: number // Last render time in milliseconds
-  renderFps: number // Current FPS (renders per second)
-  usingWorker: boolean // Whether rendering is using web worker
-  cachedFrames: number // Number of cached frames
-  pendingRenders: number // Number of pending renders
-  totalEntries: number // Total subtitle entries/display sets
-  currentIndex: number // Current subtitle index being displayed
+```ts
+interface AutoSubtitleSource {
+  data?: ArrayBuffer | Uint8Array
+  subData?: ArrayBuffer | Uint8Array
+  idxContent?: string
+  fileName?: string
+  subUrl?: string
+  idxUrl?: string
 }
 ```
 
 #### `SubtitleData`
 
-```typescript
+```ts
 interface SubtitleData {
-  width: number // Screen width
-  height: number // Screen height
+  width: number
+  height: number
   compositionData: SubtitleCompositionData[]
 }
 
 interface SubtitleCompositionData {
-  pixelData: ImageData // RGBA pixel data
-  x: number // X position
-  y: number // Y position
+  pixelData: ImageData
+  x: number
+  y: number
 }
 ```
 

package/pkg/libbitsub.js

@@ -865,7 +865,7 @@ export function init() {
 function __wbg_get_imports() {
     const import0 = {
         __proto__: null,
-        __wbg___wbindgen_throw_df03e93053e0f4bc: function(arg0, arg1) {
+        __wbg___wbindgen_throw_6ddd609b62940d55: function(arg0, arg1) {
             throw new Error(getStringFromWasm0(arg0, arg1));
         },
         __wbg_error_a6fa202b58aa1cd3: function(arg0, arg1) {
@@ -879,7 +879,7 @@ function __wbg_get_imports() {
                 wasm.__wbindgen_free(deferred0_0, deferred0_1, 1);
             }
         },
-        __wbg_length_5e07cf181b2745fb: function(arg0) {
+        __wbg_length_ea16607d7b61445b: function(arg0) {
             const ret = arg0.length;
             return ret;
         },
@@ -887,22 +887,22 @@ function __wbg_get_imports() {
             const ret = new Error();
             return ret;
         },
-        __wbg_new_from_slice_e98c2bb0a59c32a0: function(arg0, arg1) {
+        __wbg_new_from_slice_22da9388ac046e50: function(arg0, arg1) {
             const ret = new Uint8Array(getArrayU8FromWasm0(arg0, arg1));
             return ret;
         },
-        __wbg_new_with_length_9b57e4a9683723fa: function(arg0) {
+        __wbg_new_with_length_825018a1616e9e55: function(arg0) {
             const ret = new Uint8Array(arg0 >>> 0);
             return ret;
         },
-        __wbg_new_with_length_fbe257d20500214d: function(arg0) {
+        __wbg_new_with_length_eae667475c36c4e4: function(arg0) {
             const ret = new Float64Array(arg0 >>> 0);
             return ret;
         },
-        __wbg_prototypesetcall_d1a7133bc8d83aa9: function(arg0, arg1, arg2) {
+        __wbg_prototypesetcall_d62e5099504357e6: function(arg0, arg1, arg2) {
             Uint8Array.prototype.set.call(getArrayU8FromWasm0(arg0, arg1), arg2);
         },
-        __wbg_set_index_0a7915ae2e548e40: function(arg0, arg1, arg2) {
+        __wbg_set_index_a56629feb5ac0ffa: function(arg0, arg1, arg2) {
             arg0[arg1 >>> 0] = arg2;
         },
         __wbg_stack_3b0d974bbf31e44f: function(arg0, arg1) {

package/pkg/package.json

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