libbitsub 1.10.2 → 1.11.0

package/README.md

@@ -11,6 +11,7 @@ Started as a fork of Arcus92's [libpgs-js](https://github.com/Arcus92/libpgs-js)
 - Matroska `.mks` extraction for embedded `S_VOBSUB` tracks
 - WebGPU, WebGL2, and Canvas2D rendering with automatic fallback
 - Worker-backed parsing/rendering for large subtitle files
+- HTTP Range / streaming loads for large `.sup`, `.sub`, `.idx`, and `.mks` assets (progressive indexing where feasible)
 - 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
@@ -18,6 +19,7 @@ Started as a fork of Arcus92's [libpgs-js](https://github.com/Arcus92/libpgs-js)
 - 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
+- Optional player integrations for Video.js, Shaka Player, hls.js, and React (core stays dependency-free)
 
 ## Showcase
 
@@ -67,11 +69,11 @@ deno add jsr:@altq/libbitsub
 
 In most bundler-based projects, no manual worker setup is required. `libbitsub` now resolves the WASM asset relative to the package module URL, so bundlers such as Vite, webpack, and Rollup can emit the asset automatically.
 
-If your app serves package files in a way that does not expose that emitted WASM asset to the browser, you can still provide the legacy public fallback by copying the WASM file to `/libbitsub/libbitsub_bg.wasm`:
+If your app serves package files in a way that does not expose that emitted WASM asset to the browser, you can still provide the legacy public fallback by copying the WASM file and its JS glue to `/libbitsub/`:
 
 ```bash
 mkdir -p public/libbitsub
-cp node_modules/libbitsub/pkg/libbitsub_bg.wasm public/libbitsub/
+cp node_modules/libbitsub/pkg/libbitsub_bg.wasm node_modules/libbitsub/pkg/libbitsub.js public/libbitsub/
 ```
 
 The worker is still created inline. `workerUrl` remains in the option type only for compatibility and does not change runtime behavior.
@@ -110,6 +112,129 @@ const parser = new PgsParser()
 
 Calling `initWasm()` multiple times is safe (it deduplicates).
 
+### Worker prewarm (TV / players)
+
+On devices where the first subtitle track switch should not pay worker + WASM startup cost (for example TV apps), prewarm the shared parsing worker during app startup:
+
+```ts
+import { warmup, ready, PgsRenderer } from 'libbitsub'
+
+// Fire-and-forget at app boot (safe to call multiple times).
+void warmup()
+
+// Before the user changes tracks, ensure the worker is ready.
+await ready()
+
+const renderer = new PgsRenderer({ video: videoElement, subContent: trackBytes })
+```
+
+`warmup()` and `ready()` share a single worker-init promise with renderer creation. The shared worker is only published after in-worker WASM initialization succeeds. When Web Workers are unavailable, both resolve immediately and renderers use the main thread.
+
+### Range / streaming loads (TV / slow networks)
+
+URL-based loads (`subUrl` / `idxUrl`) use progressive fetch by default:
+
+- Probe HTTP Range support and, for large assets, download with Range chunks when the origin allows it
+- Stream the response body otherwise and report `load-progress` events
+- **PGS (`.sup`)**: feed chunks into the parser as they arrive so cues can be indexed before the full file finishes
+- **VobSub (`.idx` + `.sub`)**: parse the small `.idx` first for timestamps, then stream/Range-download the `.sub` body and attach packets
+- **MKS**: stream/Range-download the container first (Matroska extraction still needs the assembled payload), then parse
+- **In-memory** `subContent` / `idxContent` remains the simple full-buffer path
+
+```ts
+import { PgsRenderer } from 'libbitsub'
+
+const renderer = new PgsRenderer({
+  video: videoElement,
+  subUrl: '/subtitles/movie.sup',
+  // streamingLoad: true,  // default
+  // rangeRequests: true,  // default
+  onEvent: (event) => {
+    if (event.type === 'load-progress') {
+      console.log(event.strategy, event.loadedBytes, event.totalBytes, event.indexedCues)
+    }
+    if (event.type === 'indexed') {
+      console.log('cues ready', event.metadata.cueCount, event.partial ? '(partial)' : '(final)')
+    }
+  }
+})
+```
+
+Disable progressive behavior when you want a single blocking GET:
+
+```ts
+new PgsRenderer({ video, subUrl, streamingLoad: false, rangeRequests: false })
+```
+
+Low-level helpers are also exported: `probeRangeSupport()`, `fetchSubtitleAsset()`, and `fetchSubtitleText()`.
+
+## Player integrations
+
+Optional adapters ship as **subpath exports**. They wrap the high-level renderers for common players while keeping the core package free of player/React dependencies (peer deps are optional and only needed when you import that adapter).
+
+| Import                   | Adapter                                  | Optional peer       |
+| ------------------------ | ---------------------------------------- | ------------------- |
+| `libbitsub/videojs`      | Video.js plugin (`registerBitSubPlugin`) | `video.js` >= 7     |
+| `libbitsub/shaka`        | `attachBitSubToShaka(player, options)`   | `shaka-player` >= 4 |
+| `libbitsub/hlsjs`        | `attachBitSubToHls(hls, options)`        | `hls.js` >= 1       |
+| `libbitsub/react`        | `useBitSub` / `BitSubOverlay`            | `react` >= 18       |
+| `libbitsub/integrations` | Shared `attachBitSub` controller         | —                   |
+
+Copy-paste recipes live under [`examples/`](./examples).
+
+### Video.js
+
+```ts
+import videojs from 'video.js'
+import { registerBitSubPlugin } from 'libbitsub/videojs'
+
+registerBitSubPlugin(videojs)
+const player = videojs('my-video')
+const bitsub = player.bitsub({ subUrl: '/subs/movie.sup' })
+bitsub.load({ subUrl: '/subs/other.sup' })
+```
+
+### Shaka Player
+
+```ts
+import { attachBitSubToShaka } from 'libbitsub/shaka'
+
+const bitsub = attachBitSubToShaka(player, { subUrl: '/subs/movie.sup' })
+// later
+bitsub.dispose()
+```
+
+### hls.js
+
+```ts
+import Hls from 'hls.js'
+import { attachBitSubToHls } from 'libbitsub/hlsjs'
+
+const hls = new Hls()
+hls.loadSource(url)
+hls.attachMedia(video)
+const bitsub = attachBitSubToHls(hls, { subUrl: '/subs/movie.sup' })
+```
+
+### React
+
+```tsx
+import { useRef } from 'react'
+import { useBitSub } from 'libbitsub/react'
+
+function Player({ src, subUrl }: { src: string; subUrl: string }) {
+  const videoRef = useRef<HTMLVideoElement>(null)
+  useBitSub(videoRef, { subUrl })
+  return (
+    <div style={{ position: 'relative' }}>
+      <video ref={videoRef} src={src} controls playsInline />
+    </div>
+  )
+}
+```
+
+Bitmap PGS/VobSub/MKS tracks are external canvas overlays, not native HTML/TextTrack entries. Prefer deep imports so unused adapters stay out of your bundle.
+
 ## High-level video renderers
 
 The high-level API manages subtitle loading, canvas overlay creation, playback sync, resize handling, worker usage, and renderer fallback.
@@ -207,16 +332,16 @@ renderer.resetDisplaySettings()
 
 `SubtitleDisplaySettings`:
 
-| Field | Type | Range / values | Meaning |
-| --- | --- | --- | --- |
-| `scale` | number | `0.1` to `3.0` | Overall subtitle scale |
-| `aspectMode` | `'stretch' \| 'contain' \| 'cover'` | fixed set | How subtitle screen coordinates map into the visible video box |
-| `verticalOffset` | number | `-50` to `50` | Vertical movement as percent of video height |
-| `horizontalOffset` | number | `-50` to `50` | Horizontal movement as percent of video width |
-| `horizontalAlign` | `'left' \| 'center' \| 'right'` | fixed set | Anchor used when scaling subtitle groups |
-| `bottomPadding` | number | `0` to `50` | Extra padding from the bottom edge |
-| `safeArea` | number | `0` to `25` | Clamp subtitles inside a video-safe area |
-| `opacity` | number | `0.0` to `1.0` | Global subtitle opacity |
+| Field              | Type                                | Range / values | Meaning                                                        |
+| ------------------ | ----------------------------------- | -------------- | -------------------------------------------------------------- |
+| `scale`            | number                              | `0.1` to `3.0` | Overall subtitle scale                                         |
+| `aspectMode`       | `'stretch' \| 'contain' \| 'cover'` | fixed set      | How subtitle screen coordinates map into the visible video box |
+| `verticalOffset`   | number                              | `-50` to `50`  | Vertical movement as percent of video height                   |
+| `horizontalOffset` | number                              | `-50` to `50`  | Horizontal movement as percent of video width                  |
+| `horizontalAlign`  | `'left' \| 'center' \| 'right'`     | fixed set      | Anchor used when scaling subtitle groups                       |
+| `bottomPadding`    | number                              | `0` to `50`    | Extra padding from the bottom edge                             |
+| `safeArea`         | number                              | `0` to `25`    | Clamp subtitles inside a video-safe area                       |
+| `opacity`          | number                              | `0.0` to `1.0` | Global subtitle opacity                                        |
 
 ## Metadata and introspection
 
@@ -291,14 +416,7 @@ Like `UnifiedSubtitleParser.loadAuto()`, this is a low-level in-memory API: pass
 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'
+import { PgsParser, initWasm, renderFrameData, toBlob, toCanvas, toImageBitmap } from 'libbitsub'
 
 await initWasm()
 
@@ -385,7 +503,7 @@ Structured diagnostic error codes currently include:
 - `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.
+Warnings use a smaller code set focused on non-fatal conditions such as malformed bitmap buffers, worker fallback, progressive/Range fallback (`RANGE_FALLBACK`), and missing PGS palettes during render.
 
 ## MKS security and corruption checks
 
@@ -415,6 +533,8 @@ const renderer = new PgsRenderer({
   onEvent: (event) => {
     switch (event.type) {
       case 'loading':
+      case 'load-progress':
+      case 'indexed':
       case 'loaded':
       case 'error':
       case 'warning':
@@ -482,17 +602,17 @@ renderer.dispose()
 
 Emitted events:
 
-| Event | Payload |
-| --- | --- |
-| `loading` | subtitle format |
-| `loaded` | subtitle format and parser metadata |
-| `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 |
-| `cue-change` | current cue metadata or `null` when nothing is displayed |
-| `stats` | periodic renderer stats snapshot |
+| Event             | Payload                                                                           |
+| ----------------- | --------------------------------------------------------------------------------- |
+| `loading`         | subtitle format                                                                   |
+| `loaded`          | subtitle format and parser metadata                                               |
+| `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                   |
+| `cue-change`      | current cue metadata or `null` when nothing is displayed                          |
+| `stats`           | periodic renderer stats snapshot                                                  |
 
 ## Performance stats
 
@@ -581,6 +701,25 @@ console.log({
 
 WebGL2 and Canvas2D fallback remain automatic. Use `onWebGPUFallback`, `onWebGL2Fallback`, `onEvent`, or `onWarning` if you need to observe backend changes.
 
+## Compatibility & visual regression
+
+A formal suite locks decoder edge cases and backend pixel parity:
+
+- Malformed PGS / VobSub / MKS fixtures
+- Palette edge cases and zero-length RLE runs
+- Alternate display sizes (SD → 4K)
+- Slow worker startup / shared init
+- Pixel-level goldens across software, Canvas2D, WebGL2, and WebGPU
+
+```bash
+bun run test        # Rust core (includes compatibility fixtures)
+bun run test:ts     # TypeScript fixtures, goldens, worker startup
+bun run test:visual # Headless Chromium backend parity
+bun run test:all    # All of the above
+```
+
+Browser/device support matrix (including webOS TV): [docs/COMPATIBILITY.md](./docs/COMPATIBILITY.md).
+
 ## Notes
 
 - Worker mode is shared, but subtitle parser state is isolated per renderer session.
@@ -594,10 +733,13 @@ WebGL2 and Canvas2D fallback remain automatic. Use `onWebGPUFallback`, `onWebGL2
 
 - `initWasm(): Promise<void>` initializes the WASM module. Called automatically by high-level renderers and on first import in browser environments. Safe to call multiple times. Only needed explicitly for low-level parser usage.
 - `isWasmInitialized(): boolean` reports whether initialization has completed.
+- `warmup(): Promise<void>` / `ready(): Promise<void>` pre-initialize the shared subtitle worker (including in-worker WASM). Safe to call multiple times; concurrent callers share one init promise. Prefer these in TV/player apps before the first track switch.
+- `isWorkerAvailable(): boolean` / `isWorkerReady(): boolean` report worker support and whether the shared worker has finished initializing.
 - `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.
+- `probeRangeSupport(url, options?)` / `fetchSubtitleAsset(url, options?, onChunk?)` / `fetchSubtitleText(url, options?)` perform Range-aware progressive asset downloads for custom loaders.
 - `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.
@@ -605,6 +747,7 @@ WebGL2 and Canvas2D fallback remain automatic. Use `onWebGPUFallback`, `onWebGL2
 - `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`.
+- Optional integration entry points: `libbitsub/videojs`, `libbitsub/shaka`, `libbitsub/hlsjs`, `libbitsub/react`, `libbitsub/integrations` (see [examples/](./examples) and [references/api.md](./references/api.md)).
 
 ### High-level renderers
 
@@ -639,7 +782,9 @@ WebGL2 and Canvas2D fallback remain automatic. Use `onWebGPUFallback`, `onWebGL2
 
 #### `PgsParser`
 
-- `load(data: Uint8Array): number` loads PGS data and returns the cue count.
+- `load(data: Uint8Array): number` loads PGS data and returns the cue count (simple in-memory path).
+- `reset(): void` / `feed(data: Uint8Array): number` / `finishFeed(): number` progressive indexing APIs for streamed chunks.
+- `pendingLen: number` incomplete trailing bytes retained between `feed()` calls.
 - `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.
@@ -652,7 +797,10 @@ WebGL2 and Canvas2D fallback remain automatic. Use `onWebGPUFallback`, `onWebGL2
 
 #### `VobSubParserLowLevel`
 
-- `loadFromData(idxContent: string, subData: Uint8Array): void` loads IDX and SUB data.
+- `loadFromData(idxContent: string, subData: Uint8Array): void` loads IDX and SUB data (simple in-memory path).
+- `loadFromIdx(idxContent: string): void` indexes timestamps from IDX before packet bytes arrive.
+- `attachSubData(subData: Uint8Array): void` attaches `.sub` packets after an IDX-first load.
+- `hasSubData: boolean` whether packet bytes are currently attached.
 - `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.
@@ -687,6 +835,8 @@ interface VideoSubtitleOptions {
     before?: number
     after?: number
   }
+  streamingLoad?: boolean // default true — progressive URL loads
+  rangeRequests?: boolean // default true — use HTTP Range when supported
   onEvent?: (event: SubtitleRendererEvent) => void
 }
 ```

package/dist/index.d.ts

@@ -5,7 +5,7 @@
  */
 export { PgsRenderer, VobSubRenderer, createAutoSubtitleRenderer, type VideoSubtitleOptions, type VideoVobSubOptions, type SubtitleRendererStats } from './wrapper';
 export { PgsParser, VobSubParserLowLevel, UnifiedSubtitleParser, openSubtitles } from './wrapper';
-export { initWasm, isWasmInitialized, isWebGPUSupported, detectSubtitleFormat, renderFrameData, toBlob, toCanvas, toImageBitmap, createSubtitleDiagnosticError, normalizeSubtitleError, SubtitleDiagnosticError, type AutoSubtitleSource, type AutoVideoSubtitleOptions, type OpenedSubtitles, type SubtitleAspectMode, type SubtitleCacheStats, type SubtitleCueBounds, type SubtitleCueMetadata, type SubtitleData, type SubtitleDiagnosticDetailValue, type SubtitleDiagnosticErrorCode, type SubtitleDiagnosticErrorLike, type SubtitleDiagnosticsOptions, type SubtitleDiagnosticWarning, type SubtitleDiagnosticWarningCode, type SubtitleCompositionData, type SubtitleDisplaySettings, type SubtitleFrameCanvasOptions, type SubtitleFrameCanvasTarget, type SubtitleFrameCropMode, type SubtitleFrameRenderOptions, type SubtitleRenderedFrameData, type SubtitleFormatName, type SubtitleHorizontalAlign, type SubtitleLastRenderInfo, type SubtitleParserMetadata, type SubtitleRendererBackend, type SubtitleRendererEvent, type SubtitleRendererStatsSnapshot } from './wrapper';
+export { initWasm, isWasmInitialized, isWebGPUSupported, isWorkerAvailable, isWorkerReady, warmup, ready, detectSubtitleFormat, fetchSubtitleAsset, fetchSubtitleText, probeRangeSupport, renderFrameData, toBlob, toCanvas, toImageBitmap, createSubtitleDiagnosticError, normalizeSubtitleError, SubtitleDiagnosticError, type AssetFetchOptions, type AssetFetchProgress, type AssetFetchStrategy, type AutoSubtitleSource, type AutoVideoSubtitleOptions, type OpenedSubtitles, type RangeProbeResult, type SubtitleAspectMode, type SubtitleCacheStats, type SubtitleCueBounds, type SubtitleCueMetadata, type SubtitleData, type SubtitleDiagnosticDetailValue, type SubtitleDiagnosticErrorCode, type SubtitleDiagnosticErrorLike, type SubtitleDiagnosticsOptions, type SubtitleDiagnosticWarning, type SubtitleDiagnosticWarningCode, type SubtitleCompositionData, type SubtitleDisplaySettings, type SubtitleFrameCanvasOptions, type SubtitleFrameCanvasTarget, type SubtitleFrameCropMode, type SubtitleFrameRenderOptions, type SubtitleRenderedFrameData, type SubtitleFormatName, type SubtitleHorizontalAlign, type SubtitleLastRenderInfo, type SubtitleParserMetadata, type SubtitleRendererBackend, type SubtitleRendererEvent, type SubtitleRendererStatsSnapshot } from './wrapper';
 export type { RenderResult, SubtitleFrame, VobSubFrame } from './wrapper';
 export { PGSRenderer, VobsubRenderer, UnifiedSubtitleRenderer } from './wrapper';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,WAAW,EACX,cAAc,EACd,0BAA0B,EAC1B,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC3B,MAAM,WAAW,CAAA;AAGlB,OAAO,EAAE,SAAS,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAGjG,OAAO,EACL,QAAQ,EACR,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,eAAe,EACf,MAAM,EACN,QAAQ,EACR,aAAa,EACb,6BAA6B,EAC7B,sBAAsB,EACtB,uBAAuB,EACvB,KAAK,kBAAkB,EACvB,KAAK,wBAAwB,EAC7B,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,YAAY,EACjB,KAAK,6BAA6B,EAClC,KAAK,2BAA2B,EAChC,KAAK,2BAA2B,EAChC,KAAK,0BAA0B,EAC/B,KAAK,yBAAyB,EAC9B,KAAK,6BAA6B,EAClC,KAAK,uBAAuB,EAC5B,KAAK,uBAAuB,EAC5B,KAAK,0BAA0B,EAC/B,KAAK,yBAAyB,EAC9B,KAAK,qBAAqB,EAC1B,KAAK,0BAA0B,EAC/B,KAAK,yBAAyB,EAC9B,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,6BAA6B,EACnC,MAAM,WAAW,CAAA;AAGlB,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAGzE,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,WAAW,EACX,cAAc,EACd,0BAA0B,EAC1B,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC3B,MAAM,WAAW,CAAA;AAGlB,OAAO,EAAE,SAAS,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAGjG,OAAO,EACL,QAAQ,EACR,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,EACb,MAAM,EACN,KAAK,EACL,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,MAAM,EACN,QAAQ,EACR,aAAa,EACb,6BAA6B,EAC7B,sBAAsB,EACtB,uBAAuB,EACvB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,wBAAwB,EAC7B,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,YAAY,EACjB,KAAK,6BAA6B,EAClC,KAAK,2BAA2B,EAChC,KAAK,2BAA2B,EAChC,KAAK,0BAA0B,EAC/B,KAAK,yBAAyB,EAC9B,KAAK,6BAA6B,EAClC,KAAK,uBAAuB,EAC5B,KAAK,uBAAuB,EAC5B,KAAK,0BAA0B,EAC/B,KAAK,yBAAyB,EAC9B,KAAK,qBAAqB,EAC1B,KAAK,0BAA0B,EAC/B,KAAK,yBAAyB,EAC9B,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,6BAA6B,EACnC,MAAM,WAAW,CAAA;AAGlB,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAGzE,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAA"}

package/dist/index.js

@@ -8,7 +8,7 @@ export { PgsRenderer, VobSubRenderer, createAutoSubtitleRenderer } from './wrapp
 // Low-level parsers for programmatic use
 export { PgsParser, VobSubParserLowLevel, UnifiedSubtitleParser, openSubtitles } from './wrapper';
 // Utility exports
-export { initWasm, isWasmInitialized, isWebGPUSupported, detectSubtitleFormat, renderFrameData, toBlob, toCanvas, toImageBitmap, createSubtitleDiagnosticError, normalizeSubtitleError, SubtitleDiagnosticError } from './wrapper';
+export { initWasm, isWasmInitialized, isWebGPUSupported, isWorkerAvailable, isWorkerReady, warmup, ready, detectSubtitleFormat, fetchSubtitleAsset, fetchSubtitleText, probeRangeSupport, renderFrameData, toBlob, toCanvas, toImageBitmap, createSubtitleDiagnosticError, normalizeSubtitleError, SubtitleDiagnosticError } from './wrapper';
 // Legacy aliases
 export { PGSRenderer, VobsubRenderer, UnifiedSubtitleRenderer } from './wrapper';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,4EAA4E;AAC5E,OAAO,EACL,WAAW,EACX,cAAc,EACd,0BAA0B,EAI3B,MAAM,WAAW,CAAA;AAElB,yCAAyC;AACzC,OAAO,EAAE,SAAS,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAEjG,kBAAkB;AAClB,OAAO,EACL,QAAQ,EACR,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,eAAe,EACf,MAAM,EACN,QAAQ,EACR,aAAa,EACb,6BAA6B,EAC7B,sBAAsB,EACtB,uBAAuB,EA6BxB,MAAM,WAAW,CAAA;AAKlB,iBAAiB;AACjB,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,4EAA4E;AAC5E,OAAO,EACL,WAAW,EACX,cAAc,EACd,0BAA0B,EAI3B,MAAM,WAAW,CAAA;AAElB,yCAAyC;AACzC,OAAO,EAAE,SAAS,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAEjG,kBAAkB;AAClB,OAAO,EACL,QAAQ,EACR,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,EACb,MAAM,EACN,KAAK,EACL,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,MAAM,EACN,QAAQ,EACR,aAAa,EACb,6BAA6B,EAC7B,sBAAsB,EACtB,uBAAuB,EAiCxB,MAAM,WAAW,CAAA;AAKlB,iBAAiB;AACjB,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAA"}

package/dist/integrations/hlsjs.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Optional hls.js adapter for libbitsub bitmap subtitles.
+ *
+ * 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.
+ *
+ * @example
+ * ```ts
+ * import Hls from 'hls.js'
+ * import { attachBitSubToHls } from 'libbitsub/hlsjs'
+ *
+ * const hls = new Hls()
+ * hls.loadSource(playlistUrl)
+ * hls.attachMedia(video)
+ * const bitsub = attachBitSubToHls(hls, { subUrl: '/subs/movie.sup' })
+ * // later
+ * bitsub.dispose()
+ * ```
+ */
+import { type AttachBitSubOptions, type BitSubController } from './shared';
+/** Minimal hls.js surface used by the adapter. */
+export interface HlsLike {
+    media: HTMLMediaElement | null;
+    on?(event: string, listener: (...args: unknown[]) => void): void;
+    off?(event: string, listener: (...args: unknown[]) => void): void;
+    /** hls.js Events map — optional so callers can pass event name strings. */
+    Events?: {
+        MEDIA_ATTACHED?: string;
+        MEDIA_DETACHED?: string;
+        DESTROYING?: string;
+    };
+}
+export type BitSubHlsOptions = AttachBitSubOptions;
+export interface BitSubHlsHandle extends BitSubController {
+    /** Underlying hls.js instance. */
+    readonly hls: HlsLike;
+}
+/**
+ * Attach libbitsub to an hls.js instance.
+ * Binds to `hls.media` and re-attaches on MEDIA_ATTACHED when event APIs exist.
+ */
+export declare function attachBitSubToHls(hls: HlsLike, options?: BitSubHlsOptions): BitSubHlsHandle;
+export type { AttachBitSubOptions, BitSubController, BitSubSourceOptions, BitSubRenderer } from './shared';
+export { attachBitSub, createBitSubRenderer } from './shared';
+//# sourceMappingURL=hlsjs.d.ts.map

package/dist/integrations/hlsjs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hlsjs.d.ts","sourceRoot":"","sources":["../../src/integrations/hlsjs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAgB,KAAK,mBAAmB,EAAE,KAAK,gBAAgB,EAA4B,MAAM,UAAU,CAAA;AAElH,kDAAkD;AAClD,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAAA;IAC9B,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,IAAI,CAAA;IAChE,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,IAAI,CAAA;IACjE,2EAA2E;IAC3E,MAAM,CAAC,EAAE;QACP,cAAc,CAAC,EAAE,MAAM,CAAA;QACvB,cAAc,CAAC,EAAE,MAAM,CAAA;QACvB,UAAU,CAAC,EAAE,MAAM,CAAA;KACpB,CAAA;CACF;AAED,MAAM,MAAM,gBAAgB,GAAG,mBAAmB,CAAA;AAElD,MAAM,WAAW,eAAgB,SAAQ,gBAAgB;IACvD,kCAAkC;IAClC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAA;CACtB;AAUD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,GAAE,gBAAqB,GAAG,eAAe,CAgG/F;AAED,YAAY,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAC1G,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAA"}

package/dist/integrations/hlsjs.js

@@ -0,0 +1,121 @@
+/**
+ * Optional hls.js adapter for libbitsub bitmap subtitles.
+ *
+ * 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.
+ *
+ * @example
+ * ```ts
+ * import Hls from 'hls.js'
+ * import { attachBitSubToHls } from 'libbitsub/hlsjs'
+ *
+ * const hls = new Hls()
+ * hls.loadSource(playlistUrl)
+ * hls.attachMedia(video)
+ * const bitsub = attachBitSubToHls(hls, { subUrl: '/subs/movie.sup' })
+ * // later
+ * bitsub.dispose()
+ * ```
+ */
+import { attachBitSub } from './shared';
+function eventName(hls, key, fallback) {
+    return hls.Events?.[key] ?? fallback;
+}
+function hasSubtitleSource(source) {
+    return Boolean(source.subUrl || source.subContent || source.idxUrl || source.idxContent || source.fileName);
+}
+/**
+ * Attach libbitsub to an hls.js instance.
+ * Binds to `hls.media` and re-attaches on MEDIA_ATTACHED when event APIs exist.
+ */
+export function attachBitSubToHls(hls, options = {}) {
+    const initialMedia = hls.media;
+    if (initialMedia && !(initialMedia instanceof HTMLVideoElement)) {
+        throw new Error('libbitsub hls.js adapter requires hls.media to be an HTMLVideoElement');
+    }
+    // Allow constructing before attachMedia(); load waits until a video is available.
+    const placeholderVideo = initialMedia instanceof HTMLVideoElement ? initialMedia : document.createElement('video');
+    const { autoLoad: initialAutoLoad = true, ...initialSource } = options;
+    let lastSource = { ...initialSource };
+    let autoLoad = initialAutoLoad;
+    const controller = attachBitSub(placeholderVideo, {
+        ...initialSource,
+        autoLoad: initialMedia instanceof HTMLVideoElement ? initialAutoLoad : false
+    });
+    const bindMedia = (media) => {
+        if (controller.disposed)
+            return;
+        if (media && !(media instanceof HTMLVideoElement)) {
+            throw new Error('libbitsub hls.js adapter requires hls.media to be an HTMLVideoElement');
+        }
+        if (!media) {
+            controller.setVideo(null);
+            return;
+        }
+        // setVideo reloads the last source when present; otherwise load explicitly if autoLoad.
+        const needsExplicitLoad = autoLoad && hasSubtitleSource(lastSource) && controller.renderer === null;
+        controller.setVideo(media);
+        if (needsExplicitLoad && controller.renderer === null && hasSubtitleSource(lastSource)) {
+            controller.load(lastSource);
+        }
+    };
+    const onMediaAttached = () => bindMedia(hls.media);
+    const onMediaDetached = () => {
+        if (!controller.disposed)
+            controller.clear();
+    };
+    const onDestroying = () => dispose();
+    const mediaAttached = eventName(hls, 'MEDIA_ATTACHED', 'hlsMediaAttached');
+    const mediaDetached = eventName(hls, 'MEDIA_DETACHED', 'hlsMediaDetached');
+    const destroying = eventName(hls, 'DESTROYING', 'hlsDestroying');
+    hls.on?.(mediaAttached, onMediaAttached);
+    hls.on?.(mediaDetached, onMediaDetached);
+    hls.on?.(destroying, onDestroying);
+    if (initialMedia instanceof HTMLVideoElement) {
+        bindMedia(initialMedia);
+    }
+    const dispose = () => {
+        hls.off?.(mediaAttached, onMediaAttached);
+        hls.off?.(mediaDetached, onMediaDetached);
+        hls.off?.(destroying, onDestroying);
+        controller.dispose();
+    };
+    return {
+        hls,
+        get renderer() {
+            return controller.renderer;
+        },
+        get video() {
+            return controller.video;
+        },
+        get disposed() {
+            return controller.disposed;
+        },
+        load: (source) => {
+            lastSource = { ...source };
+            autoLoad = true;
+            if (!(controller.video instanceof HTMLVideoElement) || controller.video === placeholderVideo) {
+                const media = hls.media;
+                if (media instanceof HTMLVideoElement) {
+                    controller.setVideo(media);
+                }
+                else {
+                    throw new Error('libbitsub hls.js adapter: call hls.attachMedia(video) before load()');
+                }
+            }
+            return controller.load(source);
+        },
+        clear: () => {
+            autoLoad = false;
+            controller.clear();
+        },
+        dispose,
+        getDisplaySettings: () => controller.getDisplaySettings(),
+        setDisplaySettings: (settings) => controller.setDisplaySettings(settings),
+        resetDisplaySettings: () => controller.resetDisplaySettings(),
+        getStats: () => controller.getStats(),
+        setVideo: (video) => controller.setVideo(video)
+    };
+}
+export { attachBitSub, createBitSubRenderer } from './shared';
+//# sourceMappingURL=hlsjs.js.map

package/dist/integrations/hlsjs.js.map

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

package/dist/integrations/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 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.
+ */
+export { attachBitSub, createBitSubRenderer, type AttachBitSubOptions, type BitSubController, type BitSubRenderer, type BitSubSourceOptions } from './shared';
+export { registerBitSubPlugin, type BitSubVideoJsApi, type BitSubVideoJsOptions, type VideoJsBitSubPlayer, type VideoJsLike, type VideoJsPlayerLike } from './videojs';
+export { attachBitSubToShaka, type BitSubShakaHandle, type BitSubShakaOptions, type ShakaPlayerLike } from './shaka';
+export { attachBitSubToHls, type BitSubHlsHandle, type BitSubHlsOptions, type HlsLike } from './hlsjs';
+export { BitSubOverlay, useBitSub, type BitSubOverlayProps, type BitSubReactSource, type UseBitSubOptions, type UseBitSubResult } from './react';
+//# sourceMappingURL=index.d.ts.map

package/dist/integrations/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/integrations/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,YAAY,EACZ,oBAAoB,EACpB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACzB,MAAM,UAAU,CAAA;AAEjB,OAAO,EACL,oBAAoB,EACpB,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACvB,MAAM,WAAW,CAAA;AAElB,OAAO,EAAE,mBAAmB,EAAE,KAAK,iBAAiB,EAAE,KAAK,kBAAkB,EAAE,KAAK,eAAe,EAAE,MAAM,SAAS,CAAA;AAEpH,OAAO,EAAE,iBAAiB,EAAE,KAAK,eAAe,EAAE,KAAK,gBAAgB,EAAE,KAAK,OAAO,EAAE,MAAM,SAAS,CAAA;AAEtG,OAAO,EACL,aAAa,EACb,SAAS,EACT,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACrB,MAAM,SAAS,CAAA"}

package/dist/integrations/index.js

@@ -0,0 +1,11 @@
+/**
+ * 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.
+ */
+export { attachBitSub, createBitSubRenderer } from './shared';
+export { registerBitSubPlugin } from './videojs';
+export { attachBitSubToShaka } from './shaka';
+export { attachBitSubToHls } from './hlsjs';
+export { BitSubOverlay, useBitSub } from './react';
+//# sourceMappingURL=index.js.map

package/dist/integrations/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/integrations/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,YAAY,EACZ,oBAAoB,EAKrB,MAAM,UAAU,CAAA;AAEjB,OAAO,EACL,oBAAoB,EAMrB,MAAM,WAAW,CAAA;AAElB,OAAO,EAAE,mBAAmB,EAAyE,MAAM,SAAS,CAAA;AAEpH,OAAO,EAAE,iBAAiB,EAA6D,MAAM,SAAS,CAAA;AAEtG,OAAO,EACL,aAAa,EACb,SAAS,EAKV,MAAM,SAAS,CAAA"}

package/dist/integrations/react.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Optional React bindings for libbitsub bitmap subtitles.
+ *
+ * Peer dependency: react >= 18
+ *
+ * @example
+ * ```tsx
+ * import { useRef } from 'react'
+ * import { useBitSub } from 'libbitsub/react'
+ *
+ * function Player({ src, subUrl }: { src: string; subUrl: string }) {
+ *   const videoRef = useRef<HTMLVideoElement>(null)
+ *   useBitSub(videoRef, { subUrl })
+ *   return (
+ *     <div style={{ position: 'relative' }}>
+ *       <video ref={videoRef} src={src} controls playsInline />
+ *     </div>
+ *   )
+ * }
+ * ```
+ *
+ * Prefer either `useBitSub` *or* `BitSubOverlay` for a given video — not both.
+ */
+import { type CSSProperties, type ReactElement, type RefObject } from 'react';
+import { type BitSubController, type BitSubSourceOptions } from './shared';
+import type { SubtitleDisplaySettings } from '../wrapper';
+export type BitSubReactSource = BitSubSourceOptions;
+export interface UseBitSubOptions extends BitSubReactSource {
+    /** When false, do not load even if source fields are set. Default true. */
+    enabled?: boolean;
+}
+export interface UseBitSubResult {
+    controller: BitSubController | null;
+    error: Error | null;
+}
+/**
+ * Bind a libbitsub renderer to a video element ref for the lifetime of the source.
+ * Cleans up automatically on unmount or when the source identity changes.
+ */
+export declare function useBitSub(videoRef: RefObject<HTMLVideoElement | null>, options: UseBitSubOptions | null): UseBitSubResult;
+export interface BitSubOverlayProps extends UseBitSubOptions {
+    videoRef: RefObject<HTMLVideoElement | null>;
+    /** Optional class name applied to a zero-size host span for debugging. */
+    className?: string;
+    style?: CSSProperties;
+}
+/**
+ * Declarative overlay helper. Renders nothing visible itself — libbitsub attaches
+ * its canvas next to the video element. Useful when you want JSX-configured tracks.
+ */
+export declare function BitSubOverlay(props: BitSubOverlayProps): ReactElement | null;
+export type { AttachBitSubOptions, BitSubController, BitSubSourceOptions, BitSubRenderer } from './shared';
+export { attachBitSub, createBitSubRenderer } from './shared';
+export type { SubtitleDisplaySettings };
+//# sourceMappingURL=react.d.ts.map

package/dist/integrations/react.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../../src/integrations/react.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAA+B,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAC1G,OAAO,EAA0C,KAAK,gBAAgB,EAAE,KAAK,mBAAmB,EAAE,MAAM,UAAU,CAAA;AAClH,OAAO,KAAK,EAAE,uBAAuB,EAAoD,MAAM,YAAY,CAAA;AAE3G,MAAM,MAAM,iBAAiB,GAAG,mBAAmB,CAAA;AAEnD,MAAM,WAAW,gBAAiB,SAAQ,iBAAiB;IACzD,2EAA2E;IAC3E,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,gBAAgB,GAAG,IAAI,CAAA;IACnC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;CACpB;AAoBD;;;GAGG;AACH,wBAAgB,SAAS,CACvB,QAAQ,EAAE,SAAS,CAAC,gBAAgB,GAAG,IAAI,CAAC,EAC5C,OAAO,EAAE,gBAAgB,GAAG,IAAI,GAC/B,eAAe,CAiFjB;AAED,MAAM,WAAW,kBAAmB,SAAQ,gBAAgB;IAC1D,QAAQ,EAAE,SAAS,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAA;IAC5C,0EAA0E;IAC1E,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,KAAK,CAAC,EAAE,aAAa,CAAA;CACtB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,YAAY,GAAG,IAAI,CAM5E;AAED,YAAY,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAC1G,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAA;AAC7D,YAAY,EAAE,uBAAuB,EAAE,CAAA"}