@squoosh-kit/webp 0.0.4 → 0.0.5

package/README.md

@@ -28,25 +28,37 @@ import type { ImageInput } from '@squoosh-kit/webp';
 const imageData: ImageInput = {
   data: imageBuffer,
   width: 1920,
-  height: 1080
+  height: 1080,
 };
 
-// One-off encoding (worker spins up automatically)
-const webpBuffer = await encode(
-  new AbortController().signal,
-  imageData,
-  { quality: 85 }
-);
+// With cancellation support
+const controller = new AbortController();
+const webpBuffer = await encode(imageData, { quality: 85 }, controller.signal);
 
 // For multiple images, create a persistent encoder
 const encoder = createWebpEncoder('worker');
 const optimized = await encoder(
-  new AbortController().signal,
   imageData,
-  { quality: 90, lossless: false }
+  { quality: 90, lossless: false },
+  new AbortController().signal
 );
+
+// Without cancellation (operation cannot be stopped once started)
+const simple = await encode(imageData, { quality: 85 });
 ```
 
+## Public API
+
+Only the following exports are part of the public API and guaranteed to be stable across versions:
+
+- `encode(imageData, options?, signal?)` - Encode an image to WebP format
+- `createWebpEncoder(mode?)` - Create a reusable encoder function
+- `ImageInput` type - Input image data structure
+- `WebpOptions` type - WebP encoding configuration options
+- `WebpEncoderFactory` type - Type for reusable encoder functions
+
+Internal implementation details (such as `webpEncodeClient`) are not part of the public API and may change without notice.
+
 ## How It Works
 
 Under the hood, this package leverages Google's Squoosh WebP encoder compiled to WebAssembly. The heavy processing happens in a Web Worker by default, so your main thread stays free for user interactions.
@@ -55,32 +67,45 @@ You get the same quality and performance as the original Squoosh tool, but wrapp
 
 ## Real-World Examples
 
-**Image Upload Processing**
+**Image Upload Processing with Timeout**
+
 ```typescript
 // In your upload handler
-const processedImage = await encode(
-  new AbortController().signal,
-  uploadedImage,
-  {
-    quality: 85,
-    lossless: false // Perfect for photos
-  }
-);
+const controller = new AbortController();
+
+// Set a 30-second timeout
+const timeout = setTimeout(() => controller.abort(), 30000);
+
+try {
+  const processedImage = await encode(
+    uploadedImage,
+    {
+      quality: 85,
+      lossless: false, // Perfect for photos
+    },
+    controller.signal
+  );
 
-await saveToStorage('optimized.webp', processedImage);
+  await saveToStorage('optimized.webp', processedImage);
+} catch (error) {
+  if (error.name === 'AbortError') {
+    console.log('Encoding timed out');
+  } else {
+    throw error;
+  }
+} finally {
+  clearTimeout(timeout);
+}
 ```
 
 **Batch Conversion Service**
+
 ```typescript
 const encoder = createWebpEncoder('client'); // Direct encoding, no worker
 
 for (const imagePath of imageFiles) {
   const imageData = await loadImage(imagePath);
-  const webpData = await encoder(
-    new AbortController().signal,
-    imageData,
-    { quality: 75 }
-  );
+  const webpData = await encoder(imageData, { quality: 75 });
 
   await writeFile(`${imagePath}.webp`, webpData);
 }
@@ -88,13 +113,13 @@ for (const imagePath of imageFiles) {
 
 ## API Reference
 
-### `encode(signal, imageData, options?)`
+### `encode(imageData, options?, signal?)`
 
 The main encoding function. Handles everything automatically and returns a Promise.
 
-- `signal` - `AbortSignal` to cancel long-running operations
 - `imageData` - `ImageInput` object with your pixel data
 - `options` - (optional) `WebpOptions` for quality and format settings
+- `signal` - (optional) `AbortSignal` to cancel long-running operations. If provided, you can cancel by calling `controller.abort()` on the associated `AbortController`. If not provided, the operation cannot be cancelled.
 - **Returns** - `Promise<Uint8Array>` with your encoded WebP data
 
 ### `createWebpEncoder(mode?)`
@@ -104,14 +129,158 @@ Creates a reusable encoder function. More efficient for processing multiple imag
 - `mode` - (optional) `'worker'` or `'client'`, defaults to `'worker'`
 - **Returns** - A function with the same signature as `encode()`
 
+## Cancellation Support
+
+To cancel an encoding operation in progress, pass an `AbortSignal`:
+
+```typescript
+const controller = new AbortController();
+
+// Start encoding
+const encodePromise = encode(imageData, { quality: 85 }, controller.signal);
+
+// Cancel after 5 seconds if still running
+setTimeout(() => controller.abort(), 5000);
+
+try {
+  const result = await encodePromise;
+} catch (error) {
+  if (error.name === 'AbortError') {
+    console.log('Encoding was cancelled');
+  }
+}
+```
+
+**Important**: If no signal is provided, the encoding operation cannot be cancelled. It will run to completion.
+
+## Input Validation
+
+All inputs are automatically validated before processing to provide clear error messages:
+
+### Image Validation
+
+The `ImageInput` must contain valid image data:
+
+```typescript
+// Valid image data
+const validImage: ImageInput = {
+  data: new Uint8Array(4096), // or Uint8ClampedArray
+  width: 32,
+  height: 32,
+};
+
+// Will throw TypeError: image must be an object
+await encode(null, { quality: 85 });
+
+// Will throw TypeError: image.data is required
+await encode({ width: 32, height: 32 }, { quality: 85 });
+
+// Will throw TypeError: image.data must be Uint8Array or Uint8ClampedArray
+await encode({ data: [0, 0, 0, 255], width: 32, height: 32 }, { quality: 85 });
+
+// Will throw RangeError: image.width must be a positive integer
+await encode(
+  { data: new Uint8Array(100), width: 0, height: 32 },
+  { quality: 85 }
+);
+
+// Will throw RangeError: image.data too small
+// (needs 32 * 32 * 4 = 4096 bytes, but only 100 provided)
+await encode(
+  { data: new Uint8Array(100), width: 32, height: 32 },
+  { quality: 85 }
+);
+```
+
+### Options Validation
+
+All encoding options are validated for correctness:
+
+```typescript
+// Will throw RangeError: options.quality must be an integer between 0 and 100
+await encode(validImage, { quality: 150 });
+
+// Will throw TypeError: options.lossless must be boolean
+await encode(validImage, { lossless: 1 });
+
+// Will throw TypeError: options.nearLossless must be boolean
+await encode(validImage, { nearLossless: 'true' });
+```
+
+### Why Validation Matters
+
+Input validation prevents:
+
+- **Cryptic WASM errors** - Clear messages instead of "undefined behavior"
+- **Out-of-bounds buffer access** - Catches undersized buffers early
+- **Silent failures** - Invalid options are caught immediately
+- **Type confusion** - Ensures data is in the correct format
+
+All validation happens synchronously before WASM processing, so you get errors immediately without starting an async operation.
+
+### Package Size
+
+This package includes WebAssembly binaries (~30-40KB gzipped) for the WebP encoder. These enable fast processing through Web Workers and are essential for optimal performance.
+
+**Size breakdown:**
+
+- JavaScript code: ~5-8KB gzipped
+- TypeScript definitions: ~3KB
+- WASM binaries: ~30-40KB gzipped (required for encoding)
+
+If you're using client mode only and want to reduce package size, you can safely remove the WASM files:
+
+```bash
+rm -rf node_modules/@squoosh-kit/webp/dist/wasm/
+```
+
+**Note**: This will cause worker mode to fail. Only remove if using client mode exclusively.
+
+### Worker Cleanup
+
+When using worker mode (`createWebpEncoder('worker')`), always clean up the worker when you're done to prevent memory leaks:
+
+```typescript
+const encoder = createWebpEncoder('worker');
+
+try {
+  const webpData = await encoder(imageData, { quality: 85 });
+  // Use the encoded data...
+} finally {
+  // Clean up the worker to free resources
+  await encoder.terminate();
+}
+```
+
+For batch operations, keep the encoder alive throughout processing:
+
+```typescript
+const encoder = createWebpEncoder('worker');
+
+try {
+  const webpImages = await Promise.all([
+    encoder(image1, { quality: 85 }),
+    encoder(image2, { quality: 85 }),
+    encoder(image3, { quality: 85 }),
+  ]);
+
+  // Save encoded images...
+} finally {
+  // Clean up when all operations are complete
+  await encoder.terminate();
+}
+```
+
+**Note**: In client mode (`createWebpEncoder('client')`), calling `terminate()` is a no-op since there are no worker resources to clean up. It's always safe to call for consistency.
+
 ### `WebpOptions`
 
 Fine-tune your encoding:
 
 ```typescript
 type WebpOptions = {
-  quality?: number;     // 0-100, controls file size vs quality (default: 82)
-  lossless?: boolean;   // Lossless compression, larger files (default: false)
+  quality?: number; // 0-100, controls file size vs quality (default: 82)
+  lossless?: boolean; // Lossless compression, larger files (default: false)
   nearLossless?: boolean; // Near-lossless mode, best of both worlds (default: false)
 };
 ```

package/dist/bridge.browser.mjs

@@ -0,0 +1,4 @@
+import{b as A,c as B,d as E}from"./webp.worker.browser.mjs";function N(){return typeof Bun<"u"}var T=0;async function S(G,J,K,Y,H){return new Promise((X,Q)=>{let Z=++T;if(Y?.aborted){Q(new DOMException("Aborted","AbortError"));return}let V=(D)=>{let _=D.data;if(_.id!==Z)return;if($(),_.ok&&_.data!==void 0)X(_.data);else Q(Error(_.error||"Unknown worker error"))},O=(D)=>{$(),Q(Error(`Worker error: ${D.message}`))},x=()=>{$(),Q(new DOMException("Aborted","AbortError"))},$=()=>{G.removeEventListener("message",V),G.removeEventListener("error",O),Y?.removeEventListener("abort",x)};G.addEventListener("message",V),G.addEventListener("error",O),Y?.addEventListener("abort",x);let L={type:J,id:Z,payload:K};if(H&&H.length>0)G.postMessage(L,H);else G.postMessage(L)})}function q(G){let J=G.endsWith(".js")?G:`${G}.js`;if(typeof window<"u"){let Q={"webp.worker.js":"/dist/features/webp/webp.worker.browser.mjs","resize.worker.js":"/dist/features/resize/resize.worker.browser.mjs"}[J];if(Q)return new URL(Q,window.location.href)}let K=N()?".bun.js":".node.mjs",H={"webp.worker.js":`../../webp/dist/webp.worker${K}`,"resize.worker.js":`../../resize/dist/resize.worker${K}`}[J];if(H)return new URL(H,import.meta.url);return new URL(J,import.meta.url)}function z(G){let J=q(G);try{return new Worker(J.href,{type:"module"})}catch(K){let Y=K instanceof Error?K.message:String(K);throw Error(`Failed to create worker from ${J}: ${Y}. Ensure the worker file exists at the expected location. Expected worker file: ${G}${G.endsWith(".js")?"":".js"}`)}}function U(G,J=1e4){return new Promise((K,Y)=>{let H=setTimeout(()=>{Y(Error(`Worker initialization timeout after ${J}ms. Worker file: ${G}`))},J),X;try{X=z(G)}catch(Z){clearTimeout(H),Y(Z);return}let Q=(Z)=>{if(Z.data?.type==="worker:ready")clearTimeout(H),X.removeEventListener("message",Q),K(X)};X.addEventListener("message",Q),X.postMessage({type:"worker:ping"})})}class P{async encode(G,J,K){return E(G,J,K)}async terminate(){}}class I{worker=null;workerReady=null;async getWorker(){if(!this.worker){if(!this.workerReady)this.workerReady=this.createWorker();this.worker=await this.workerReady}return this.worker}async createWorker(){return U("webp.worker")}async encode(G,J,K){let Y=await this.getWorker();if(!G||typeof G!=="object")throw TypeError("image must be an object");let H=G;if(!H.data)throw TypeError("image.data is required");if(H.width===void 0||H.height===void 0)throw TypeError("image.width and image.height are required");let X={data:H.data,width:H.width,height:H.height};B(X);let Q=X.data.buffer;return A(Q),S(Y,"webp:encode",{image:X,options:J},K,[Q])}async terminate(){if(this.worker)this.worker.terminate(),this.worker=null,this.workerReady=null}}function v(G){return G==="client"?new P:new I}export{v as createBridge};
+export{v as a};
+
+//# debugId=A53D8DE6F4ECB82364756E2164756E21

package/dist/bridge.browser.mjs.map

@@ -0,0 +1,13 @@
+{
+  "version": 3,
+  "sources": ["../../runtime/src/env.ts", "../../runtime/src/worker-call.ts", "../../runtime/src/worker-helper.ts", "../src/bridge.ts"],
+  "sourcesContent": [
+    "/**\n * Runtime environment detection utilities\n */\n\n/**\n * Detect if running in a Web Worker context\n */\nexport function isWorker(): boolean {\n  return (\n    typeof self !== 'undefined' &&\n    typeof (globalThis as unknown as { DedicatedWorkerGlobalScope?: unknown })\n      .DedicatedWorkerGlobalScope !== 'undefined'\n  );\n}\n\n/**\n * Detect if running in a browser context\n */\nexport function isBrowser(): boolean {\n  return typeof window !== 'undefined' && typeof document !== 'undefined';\n}\n\n/**\n * Detect if running in Bun\n */\nexport function isBun(): boolean {\n  return typeof Bun !== 'undefined';\n}\n\n/**\n * Detect if running in Node.js\n */\nexport function isNode(): boolean {\n  return (\n    typeof process !== 'undefined' &&\n    process.versions != null &&\n    process.versions.node != null\n  );\n}\n\n/**\n * Check if ImageData is available in the current environment\n */\nexport function hasImageData(): boolean {\n  return typeof ImageData !== 'undefined';\n}\n",
+    "/**\n * Generic worker communication helper with support for transferables and AbortSignal\n */\n\nexport interface WorkerRequest<T = unknown> {\n  type: string;\n  id: number;\n  payload: T;\n}\n\nexport interface WorkerResponse<T = unknown> {\n  id: number;\n  ok: boolean;\n  data?: T;\n  error?: string;\n}\n\nlet requestId = 0;\n\n/**\n * Call a worker with a typed request and wait for response\n *\n * @param worker - The worker instance to call\n * @param type - The message type\n * @param payload - The payload to send\n * @param signal - Optional AbortSignal to cancel the operation\n * @param transfer - Optional list of Transferable objects to transfer\n * @returns Promise that resolves with the worker's response data\n */\nexport async function callWorker<TPayload, TResponse>(\n  worker: Worker,\n  type: string,\n  payload: TPayload,\n  signal?: AbortSignal,\n  transfer?: Transferable[]\n): Promise<TResponse> {\n  return new Promise<TResponse>((resolve, reject) => {\n    const id = ++requestId;\n\n    // Check if already aborted\n    if (signal?.aborted) {\n      reject(new DOMException('Aborted', 'AbortError'));\n      return;\n    }\n\n    const handleMessage = (event: MessageEvent) => {\n      const response = event.data as WorkerResponse<TResponse>;\n      if (response.id !== id) return;\n\n      cleanup();\n\n      if (response.ok && response.data !== undefined) {\n        resolve(response.data);\n      } else {\n        reject(new Error(response.error || 'Unknown worker error'));\n      }\n    };\n\n    const handleError = (error: ErrorEvent) => {\n      cleanup();\n      reject(new Error(`Worker error: ${error.message}`));\n    };\n\n    const handleAbort = () => {\n      cleanup();\n      reject(new DOMException('Aborted', 'AbortError'));\n    };\n\n    const cleanup = () => {\n      worker.removeEventListener('message', handleMessage);\n      worker.removeEventListener('error', handleError);\n      signal?.removeEventListener('abort', handleAbort);\n    };\n\n    // Set up listeners\n    worker.addEventListener('message', handleMessage);\n    worker.addEventListener('error', handleError);\n    signal?.addEventListener('abort', handleAbort);\n\n    // Send the request\n    const request: WorkerRequest<TPayload> = { type, id, payload };\n\n    if (transfer && transfer.length > 0) {\n      worker.postMessage(request, transfer);\n    } else {\n      worker.postMessage(request);\n    }\n  });\n}\n",
+    "/**\n * Worker helper utilities for creating and managing Web Workers\n *\n * This module provides centralized logic for locating and creating worker files\n * in different environments (development, npm package, bundled, etc.)\n */\n\nimport { isBun } from './env';\n\n/**\n * Get the URL for a worker file\n *\n * This helper abstracts away the complexity of locating worker files\n * in different environments (development, npm package, bundled, etc.)\n *\n * @param workerFilename - The name of the worker file (with or without .js extension)\n * @returns URL object pointing to the worker file\n */\nexport function getWorkerURL(workerFilename: string): URL {\n  // Ensure filename has correct format\n  const normalizedName = workerFilename.endsWith('.js')\n    ? workerFilename\n    : `${workerFilename}.js`;\n\n  // In browser contexts, use absolute paths from the server root\n  // The server will route these to the correct locations\n  if (typeof window !== 'undefined') {\n    // Browser environment - use absolute paths with platform-specific extension\n    const workerPathMap: Record<string, string> = {\n      'webp.worker.js': '/dist/features/webp/webp.worker.browser.mjs',\n      'resize.worker.js': '/dist/features/resize/resize.worker.browser.mjs',\n    };\n\n    const browserPath = workerPathMap[normalizedName];\n    if (browserPath) {\n      return new URL(browserPath, window.location.href);\n    }\n  }\n\n  // Node.js/Bun: use relative path from runtime package location\n  // Determine which platform variant to use\n  const platformExt = isBun() ? '.bun.js' : '.node.mjs';\n\n  const nodePathMap: Record<string, string> = {\n    'webp.worker.js': `../../webp/dist/webp.worker${platformExt}`,\n    'resize.worker.js': `../../resize/dist/resize.worker${platformExt}`,\n  };\n\n  const nodePath = nodePathMap[normalizedName];\n  if (nodePath) {\n    return new URL(nodePath, import.meta.url);\n  }\n\n  // Fallback: assume worker is in same directory as this module\n  return new URL(normalizedName, import.meta.url);\n}\n\n/**\n * Create a Web Worker for a specific codec\n *\n * Handles environment-specific worker creation logic and provides\n * clear error messages when worker creation fails.\n *\n * @param workerFilename - The name of the worker file (e.g., 'resize.worker' or 'webp.worker')\n * @returns Worker instance\n * @throws Error if worker creation fails with detailed error message\n */\nexport function createCodecWorker(workerFilename: string): Worker {\n  const workerURL = getWorkerURL(workerFilename);\n\n  try {\n    return new Worker(workerURL.href, { type: 'module' });\n  } catch (error) {\n    const errorMessage = error instanceof Error ? error.message : String(error);\n    throw new Error(\n      `Failed to create worker from ${workerURL}: ${errorMessage}. ` +\n        `Ensure the worker file exists at the expected location. ` +\n        `Expected worker file: ${workerFilename}${workerFilename.endsWith('.js') ? '' : '.js'}`\n    );\n  }\n}\n\n/**\n * Create a worker with initialization timeout and ready signal handling\n *\n * This is a higher-level function that creates a worker and waits for it\n * to signal that it's ready to receive messages.\n *\n * @param workerFilename - The name of the worker file\n * @param timeoutMs - Timeout in milliseconds (default: 10000)\n * @returns Promise that resolves to a ready Worker instance\n * @throws Error if worker creation fails or times out\n */\nexport function createReadyWorker(\n  workerFilename: string,\n  timeoutMs: number = 10000\n): Promise<Worker> {\n  return new Promise((resolve, reject) => {\n    const timeout = setTimeout(() => {\n      reject(\n        new Error(\n          `Worker initialization timeout after ${timeoutMs}ms. Worker file: ${workerFilename}`\n        )\n      );\n    }, timeoutMs);\n\n    let worker: Worker;\n    try {\n      worker = createCodecWorker(workerFilename);\n    } catch (error) {\n      clearTimeout(timeout);\n      reject(error);\n      return;\n    }\n\n    const handleMessage = (event: MessageEvent) => {\n      if (event.data?.type === 'worker:ready') {\n        clearTimeout(timeout);\n        worker.removeEventListener('message', handleMessage);\n        resolve(worker);\n      }\n    };\n\n    worker.addEventListener('message', handleMessage);\n    worker.postMessage({ type: 'worker:ping' });\n  });\n}\n",
+    "/**\n * Bridge implementation for the WebP package, handling worker and client modes.\n */\n\nimport {\n  callWorker,\n  createReadyWorker,\n  type ImageInput,\n} from '@squoosh-kit/runtime';\nimport { validateArrayBuffer, validateImageInput } from '@squoosh-kit/runtime';\nimport { webpEncodeClient } from './webp.worker.js';\nimport type { WebpOptions } from './types.js';\n\ninterface WebPBridge {\n  encode(\n    image: ImageInput,\n    options?: WebpOptions,\n    signal?: AbortSignal\n  ): Promise<Uint8Array>;\n  terminate(): Promise<void>;\n}\n\nclass WebpClientBridge implements WebPBridge {\n  async encode(\n    image: ImageInput,\n    options?: WebpOptions,\n    signal?: AbortSignal\n  ): Promise<Uint8Array> {\n    return webpEncodeClient(image, options, signal);\n  }\n\n  async terminate(): Promise<void> {\n    // Client mode has nothing to terminate\n  }\n}\n\nclass WebpWorkerBridge implements WebPBridge {\n  private worker: Worker | null = null;\n  private workerReady: Promise<Worker> | null = null;\n\n  private async getWorker(): Promise<Worker> {\n    if (!this.worker) {\n      if (!this.workerReady) {\n        this.workerReady = this.createWorker();\n      }\n      this.worker = await this.workerReady;\n    }\n    return this.worker;\n  }\n\n  private async createWorker(): Promise<Worker> {\n    // Use the centralized worker helper for robust path resolution\n    return createReadyWorker('webp.worker');\n  }\n\n  async encode(\n    image: ImageInput,\n    options?: WebpOptions,\n    signal?: AbortSignal\n  ): Promise<Uint8Array> {\n    const worker = await this.getWorker();\n\n    // Validate and normalize image - ensure all required properties exist\n    if (!image || typeof image !== 'object') {\n      throw new TypeError('image must be an object');\n    }\n\n    const imageRecord = image as Record<string, unknown>;\n    if (!imageRecord.data) {\n      throw new TypeError('image.data is required');\n    }\n    if (imageRecord.width === undefined || imageRecord.height === undefined) {\n      throw new TypeError('image.width and image.height are required');\n    }\n\n    const normalizedImage: ImageInput = {\n      data: imageRecord.data as Uint8Array | Uint8ClampedArray,\n      width: imageRecord.width as number,\n      height: imageRecord.height as number,\n    };\n\n    validateImageInput(normalizedImage);\n    const buffer = normalizedImage.data.buffer;\n    validateArrayBuffer(buffer);\n    return callWorker(\n      worker,\n      'webp:encode',\n      { image: normalizedImage, options },\n      signal,\n      [buffer]\n    );\n  }\n\n  async terminate(): Promise<void> {\n    if (this.worker) {\n      this.worker.terminate();\n      this.worker = null;\n      this.workerReady = null;\n    }\n  }\n}\n\nexport function createBridge(mode: 'worker' | 'client'): WebPBridge {\n  return mode === 'client' ? new WebpClientBridge() : new WebpWorkerBridge();\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "A53D8DE6F4ECB82364756E2164756E21",
+  "names": []
+}

package/dist/bridge.bun.js

@@ -0,0 +1,5 @@
+// @bun
+import{b as A,c as B,d as E}from"./webp.worker.bun.js";function N(){return typeof Bun<"u"}var T=0;async function S(G,J,K,Y,H){return new Promise((X,Q)=>{let Z=++T;if(Y?.aborted){Q(new DOMException("Aborted","AbortError"));return}let V=(D)=>{let _=D.data;if(_.id!==Z)return;if($(),_.ok&&_.data!==void 0)X(_.data);else Q(Error(_.error||"Unknown worker error"))},O=(D)=>{$(),Q(Error(`Worker error: ${D.message}`))},x=()=>{$(),Q(new DOMException("Aborted","AbortError"))},$=()=>{G.removeEventListener("message",V),G.removeEventListener("error",O),Y?.removeEventListener("abort",x)};G.addEventListener("message",V),G.addEventListener("error",O),Y?.addEventListener("abort",x);let L={type:J,id:Z,payload:K};if(H&&H.length>0)G.postMessage(L,H);else G.postMessage(L)})}function q(G){let J=G.endsWith(".js")?G:`${G}.js`;if(typeof window<"u"){let Q={"webp.worker.js":"/dist/features/webp/webp.worker.browser.mjs","resize.worker.js":"/dist/features/resize/resize.worker.browser.mjs"}[J];if(Q)return new URL(Q,window.location.href)}let K=N()?".bun.js":".node.mjs",H={"webp.worker.js":`../../webp/dist/webp.worker${K}`,"resize.worker.js":`../../resize/dist/resize.worker${K}`}[J];if(H)return new URL(H,import.meta.url);return new URL(J,import.meta.url)}function z(G){let J=q(G);try{return new Worker(J.href,{type:"module"})}catch(K){let Y=K instanceof Error?K.message:String(K);throw Error(`Failed to create worker from ${J}: ${Y}. Ensure the worker file exists at the expected location. Expected worker file: ${G}${G.endsWith(".js")?"":".js"}`)}}function U(G,J=1e4){return new Promise((K,Y)=>{let H=setTimeout(()=>{Y(Error(`Worker initialization timeout after ${J}ms. Worker file: ${G}`))},J),X;try{X=z(G)}catch(Z){clearTimeout(H),Y(Z);return}let Q=(Z)=>{if(Z.data?.type==="worker:ready")clearTimeout(H),X.removeEventListener("message",Q),K(X)};X.addEventListener("message",Q),X.postMessage({type:"worker:ping"})})}class P{async encode(G,J,K){return E(G,J,K)}async terminate(){}}class I{worker=null;workerReady=null;async getWorker(){if(!this.worker){if(!this.workerReady)this.workerReady=this.createWorker();this.worker=await this.workerReady}return this.worker}async createWorker(){return U("webp.worker")}async encode(G,J,K){let Y=await this.getWorker();if(!G||typeof G!=="object")throw TypeError("image must be an object");let H=G;if(!H.data)throw TypeError("image.data is required");if(H.width===void 0||H.height===void 0)throw TypeError("image.width and image.height are required");let X={data:H.data,width:H.width,height:H.height};B(X);let Q=X.data.buffer;return A(Q),S(Y,"webp:encode",{image:X,options:J},K,[Q])}async terminate(){if(this.worker)this.worker.terminate(),this.worker=null,this.workerReady=null}}function v(G){return G==="client"?new P:new I}export{v as createBridge};
+export{v as a};
+
+//# debugId=480F678DC127BB6164756E2164756E21

package/dist/bridge.bun.js.map

@@ -0,0 +1,13 @@
+{
+  "version": 3,
+  "sources": ["../../runtime/src/env.ts", "../../runtime/src/worker-call.ts", "../../runtime/src/worker-helper.ts", "../src/bridge.ts"],
+  "sourcesContent": [
+    "/**\n * Runtime environment detection utilities\n */\n\n/**\n * Detect if running in a Web Worker context\n */\nexport function isWorker(): boolean {\n  return (\n    typeof self !== 'undefined' &&\n    typeof (globalThis as unknown as { DedicatedWorkerGlobalScope?: unknown })\n      .DedicatedWorkerGlobalScope !== 'undefined'\n  );\n}\n\n/**\n * Detect if running in a browser context\n */\nexport function isBrowser(): boolean {\n  return typeof window !== 'undefined' && typeof document !== 'undefined';\n}\n\n/**\n * Detect if running in Bun\n */\nexport function isBun(): boolean {\n  return typeof Bun !== 'undefined';\n}\n\n/**\n * Detect if running in Node.js\n */\nexport function isNode(): boolean {\n  return (\n    typeof process !== 'undefined' &&\n    process.versions != null &&\n    process.versions.node != null\n  );\n}\n\n/**\n * Check if ImageData is available in the current environment\n */\nexport function hasImageData(): boolean {\n  return typeof ImageData !== 'undefined';\n}\n",
+    "/**\n * Generic worker communication helper with support for transferables and AbortSignal\n */\n\nexport interface WorkerRequest<T = unknown> {\n  type: string;\n  id: number;\n  payload: T;\n}\n\nexport interface WorkerResponse<T = unknown> {\n  id: number;\n  ok: boolean;\n  data?: T;\n  error?: string;\n}\n\nlet requestId = 0;\n\n/**\n * Call a worker with a typed request and wait for response\n *\n * @param worker - The worker instance to call\n * @param type - The message type\n * @param payload - The payload to send\n * @param signal - Optional AbortSignal to cancel the operation\n * @param transfer - Optional list of Transferable objects to transfer\n * @returns Promise that resolves with the worker's response data\n */\nexport async function callWorker<TPayload, TResponse>(\n  worker: Worker,\n  type: string,\n  payload: TPayload,\n  signal?: AbortSignal,\n  transfer?: Transferable[]\n): Promise<TResponse> {\n  return new Promise<TResponse>((resolve, reject) => {\n    const id = ++requestId;\n\n    // Check if already aborted\n    if (signal?.aborted) {\n      reject(new DOMException('Aborted', 'AbortError'));\n      return;\n    }\n\n    const handleMessage = (event: MessageEvent) => {\n      const response = event.data as WorkerResponse<TResponse>;\n      if (response.id !== id) return;\n\n      cleanup();\n\n      if (response.ok && response.data !== undefined) {\n        resolve(response.data);\n      } else {\n        reject(new Error(response.error || 'Unknown worker error'));\n      }\n    };\n\n    const handleError = (error: ErrorEvent) => {\n      cleanup();\n      reject(new Error(`Worker error: ${error.message}`));\n    };\n\n    const handleAbort = () => {\n      cleanup();\n      reject(new DOMException('Aborted', 'AbortError'));\n    };\n\n    const cleanup = () => {\n      worker.removeEventListener('message', handleMessage);\n      worker.removeEventListener('error', handleError);\n      signal?.removeEventListener('abort', handleAbort);\n    };\n\n    // Set up listeners\n    worker.addEventListener('message', handleMessage);\n    worker.addEventListener('error', handleError);\n    signal?.addEventListener('abort', handleAbort);\n\n    // Send the request\n    const request: WorkerRequest<TPayload> = { type, id, payload };\n\n    if (transfer && transfer.length > 0) {\n      worker.postMessage(request, transfer);\n    } else {\n      worker.postMessage(request);\n    }\n  });\n}\n",
+    "/**\n * Worker helper utilities for creating and managing Web Workers\n *\n * This module provides centralized logic for locating and creating worker files\n * in different environments (development, npm package, bundled, etc.)\n */\n\nimport { isBun } from './env';\n\n/**\n * Get the URL for a worker file\n *\n * This helper abstracts away the complexity of locating worker files\n * in different environments (development, npm package, bundled, etc.)\n *\n * @param workerFilename - The name of the worker file (with or without .js extension)\n * @returns URL object pointing to the worker file\n */\nexport function getWorkerURL(workerFilename: string): URL {\n  // Ensure filename has correct format\n  const normalizedName = workerFilename.endsWith('.js')\n    ? workerFilename\n    : `${workerFilename}.js`;\n\n  // In browser contexts, use absolute paths from the server root\n  // The server will route these to the correct locations\n  if (typeof window !== 'undefined') {\n    // Browser environment - use absolute paths with platform-specific extension\n    const workerPathMap: Record<string, string> = {\n      'webp.worker.js': '/dist/features/webp/webp.worker.browser.mjs',\n      'resize.worker.js': '/dist/features/resize/resize.worker.browser.mjs',\n    };\n\n    const browserPath = workerPathMap[normalizedName];\n    if (browserPath) {\n      return new URL(browserPath, window.location.href);\n    }\n  }\n\n  // Node.js/Bun: use relative path from runtime package location\n  // Determine which platform variant to use\n  const platformExt = isBun() ? '.bun.js' : '.node.mjs';\n\n  const nodePathMap: Record<string, string> = {\n    'webp.worker.js': `../../webp/dist/webp.worker${platformExt}`,\n    'resize.worker.js': `../../resize/dist/resize.worker${platformExt}`,\n  };\n\n  const nodePath = nodePathMap[normalizedName];\n  if (nodePath) {\n    return new URL(nodePath, import.meta.url);\n  }\n\n  // Fallback: assume worker is in same directory as this module\n  return new URL(normalizedName, import.meta.url);\n}\n\n/**\n * Create a Web Worker for a specific codec\n *\n * Handles environment-specific worker creation logic and provides\n * clear error messages when worker creation fails.\n *\n * @param workerFilename - The name of the worker file (e.g., 'resize.worker' or 'webp.worker')\n * @returns Worker instance\n * @throws Error if worker creation fails with detailed error message\n */\nexport function createCodecWorker(workerFilename: string): Worker {\n  const workerURL = getWorkerURL(workerFilename);\n\n  try {\n    return new Worker(workerURL.href, { type: 'module' });\n  } catch (error) {\n    const errorMessage = error instanceof Error ? error.message : String(error);\n    throw new Error(\n      `Failed to create worker from ${workerURL}: ${errorMessage}. ` +\n        `Ensure the worker file exists at the expected location. ` +\n        `Expected worker file: ${workerFilename}${workerFilename.endsWith('.js') ? '' : '.js'}`\n    );\n  }\n}\n\n/**\n * Create a worker with initialization timeout and ready signal handling\n *\n * This is a higher-level function that creates a worker and waits for it\n * to signal that it's ready to receive messages.\n *\n * @param workerFilename - The name of the worker file\n * @param timeoutMs - Timeout in milliseconds (default: 10000)\n * @returns Promise that resolves to a ready Worker instance\n * @throws Error if worker creation fails or times out\n */\nexport function createReadyWorker(\n  workerFilename: string,\n  timeoutMs: number = 10000\n): Promise<Worker> {\n  return new Promise((resolve, reject) => {\n    const timeout = setTimeout(() => {\n      reject(\n        new Error(\n          `Worker initialization timeout after ${timeoutMs}ms. Worker file: ${workerFilename}`\n        )\n      );\n    }, timeoutMs);\n\n    let worker: Worker;\n    try {\n      worker = createCodecWorker(workerFilename);\n    } catch (error) {\n      clearTimeout(timeout);\n      reject(error);\n      return;\n    }\n\n    const handleMessage = (event: MessageEvent) => {\n      if (event.data?.type === 'worker:ready') {\n        clearTimeout(timeout);\n        worker.removeEventListener('message', handleMessage);\n        resolve(worker);\n      }\n    };\n\n    worker.addEventListener('message', handleMessage);\n    worker.postMessage({ type: 'worker:ping' });\n  });\n}\n",
+    "/**\n * Bridge implementation for the WebP package, handling worker and client modes.\n */\n\nimport {\n  callWorker,\n  createReadyWorker,\n  type ImageInput,\n} from '@squoosh-kit/runtime';\nimport { validateArrayBuffer, validateImageInput } from '@squoosh-kit/runtime';\nimport { webpEncodeClient } from './webp.worker.js';\nimport type { WebpOptions } from './types.js';\n\ninterface WebPBridge {\n  encode(\n    image: ImageInput,\n    options?: WebpOptions,\n    signal?: AbortSignal\n  ): Promise<Uint8Array>;\n  terminate(): Promise<void>;\n}\n\nclass WebpClientBridge implements WebPBridge {\n  async encode(\n    image: ImageInput,\n    options?: WebpOptions,\n    signal?: AbortSignal\n  ): Promise<Uint8Array> {\n    return webpEncodeClient(image, options, signal);\n  }\n\n  async terminate(): Promise<void> {\n    // Client mode has nothing to terminate\n  }\n}\n\nclass WebpWorkerBridge implements WebPBridge {\n  private worker: Worker | null = null;\n  private workerReady: Promise<Worker> | null = null;\n\n  private async getWorker(): Promise<Worker> {\n    if (!this.worker) {\n      if (!this.workerReady) {\n        this.workerReady = this.createWorker();\n      }\n      this.worker = await this.workerReady;\n    }\n    return this.worker;\n  }\n\n  private async createWorker(): Promise<Worker> {\n    // Use the centralized worker helper for robust path resolution\n    return createReadyWorker('webp.worker');\n  }\n\n  async encode(\n    image: ImageInput,\n    options?: WebpOptions,\n    signal?: AbortSignal\n  ): Promise<Uint8Array> {\n    const worker = await this.getWorker();\n\n    // Validate and normalize image - ensure all required properties exist\n    if (!image || typeof image !== 'object') {\n      throw new TypeError('image must be an object');\n    }\n\n    const imageRecord = image as Record<string, unknown>;\n    if (!imageRecord.data) {\n      throw new TypeError('image.data is required');\n    }\n    if (imageRecord.width === undefined || imageRecord.height === undefined) {\n      throw new TypeError('image.width and image.height are required');\n    }\n\n    const normalizedImage: ImageInput = {\n      data: imageRecord.data as Uint8Array | Uint8ClampedArray,\n      width: imageRecord.width as number,\n      height: imageRecord.height as number,\n    };\n\n    validateImageInput(normalizedImage);\n    const buffer = normalizedImage.data.buffer;\n    validateArrayBuffer(buffer);\n    return callWorker(\n      worker,\n      'webp:encode',\n      { image: normalizedImage, options },\n      signal,\n      [buffer]\n    );\n  }\n\n  async terminate(): Promise<void> {\n    if (this.worker) {\n      this.worker.terminate();\n      this.worker = null;\n      this.workerReady = null;\n    }\n  }\n}\n\nexport function createBridge(mode: 'worker' | 'client'): WebPBridge {\n  return mode === 'client' ? new WebpClientBridge() : new WebpWorkerBridge();\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "480F678DC127BB6164756E2164756E21",
+  "names": []
+}

package/dist/bridge.d.ts

@@ -4,7 +4,8 @@
 import { type ImageInput } from '@squoosh-kit/runtime';
 import type { WebpOptions } from './types.js';
 interface WebPBridge {
-    encode(signal: AbortSignal, image: ImageInput, options?: WebpOptions): Promise<Uint8Array>;
+    encode(image: ImageInput, options?: WebpOptions, signal?: AbortSignal): Promise<Uint8Array>;
+    terminate(): Promise<void>;
 }
 export declare function createBridge(mode: 'worker' | 'client'): WebPBridge;
 export {};

package/dist/bridge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../src/bridge.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAc,KAAK,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEnE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,UAAU,UAAU;IAClB,MAAM,CACJ,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,UAAU,EACjB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,UAAU,CAAC,CAAC;CACxB;AAoCD,wBAAgB,YAAY,CAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAElE"}
+{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../src/bridge.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAGL,KAAK,UAAU,EAChB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,UAAU,UAAU;IAClB,MAAM,CACJ,KAAK,EAAE,UAAU,EACjB,OAAO,CAAC,EAAE,WAAW,EACrB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CAAC;IACvB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAkFD,wBAAgB,YAAY,CAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAElE"}

package/dist/bridge.node.cjs

@@ -0,0 +1,3 @@
+var W={};M(W,{createBridge:()=>R});module.exports=C(W);function N(){return typeof Bun<"u"}var T=0;async function S(G,J,K,Y,H){return new Promise((X,Q)=>{let Z=++T;if(Y?.aborted){Q(new DOMException("Aborted","AbortError"));return}let V=(D)=>{let _=D.data;if(_.id!==Z)return;if($(),_.ok&&_.data!==void 0)X(_.data);else Q(Error(_.error||"Unknown worker error"))},O=(D)=>{$(),Q(Error(`Worker error: ${D.message}`))},x=()=>{$(),Q(new DOMException("Aborted","AbortError"))},$=()=>{G.removeEventListener("message",V),G.removeEventListener("error",O),Y?.removeEventListener("abort",x)};G.addEventListener("message",V),G.addEventListener("error",O),Y?.addEventListener("abort",x);let L={type:J,id:Z,payload:K};if(H&&H.length>0)G.postMessage(L,H);else G.postMessage(L)})}function q(G){let J=G.endsWith(".js")?G:`${G}.js`;if(typeof window<"u"){let Q={"webp.worker.js":"/dist/features/webp/webp.worker.browser.mjs","resize.worker.js":"/dist/features/resize/resize.worker.browser.mjs"}[J];if(Q)return new URL(Q,window.location.href)}let K=N()?".bun.js":".node.mjs",H={"webp.worker.js":`../../webp/dist/webp.worker${K}`,"resize.worker.js":`../../resize/dist/resize.worker${K}`}[J];if(H)return new URL(H,"file:///home/bnowak/repos/squoosh-lite/packages/runtime/src/worker-helper.ts");return new URL(J,"file:///home/bnowak/repos/squoosh-lite/packages/runtime/src/worker-helper.ts")}function z(G){let J=q(G);try{return new Worker(J.href,{type:"module"})}catch(K){let Y=K instanceof Error?K.message:String(K);throw Error(`Failed to create worker from ${J}: ${Y}. Ensure the worker file exists at the expected location. Expected worker file: ${G}${G.endsWith(".js")?"":".js"}`)}}function U(G,J=1e4){return new Promise((K,Y)=>{let H=setTimeout(()=>{Y(Error(`Worker initialization timeout after ${J}ms. Worker file: ${G}`))},J),X;try{X=z(G)}catch(Z){clearTimeout(H),Y(Z);return}let Q=(Z)=>{if(Z.data?.type==="worker:ready")clearTimeout(H),X.removeEventListener("message",Q),K(X)};X.addEventListener("message",Q),X.postMessage({type:"worker:ping"})})}class P{async encode(G,J,K){return E(G,J,K)}async terminate(){}}class I{worker=null;workerReady=null;async getWorker(){if(!this.worker){if(!this.workerReady)this.workerReady=this.createWorker();this.worker=await this.workerReady}return this.worker}async createWorker(){return U("webp.worker")}async encode(G,J,K){let Y=await this.getWorker();if(!G||typeof G!=="object")throw TypeError("image must be an object");let H=G;if(!H.data)throw TypeError("image.data is required");if(H.width===void 0||H.height===void 0)throw TypeError("image.width and image.height are required");let X={data:H.data,width:H.width,height:H.height};B(X);let Q=X.data.buffer;return A(Q),S(Y,"webp:encode",{image:X,options:J},K,[Q])}async terminate(){if(this.worker)this.worker.terminate(),this.worker=null,this.workerReady=null}}function R(G){return G==="client"?new P:new I}
+
+//# debugId=0D11351578D67A2764756E2164756E21

package/dist/bridge.node.cjs.map

@@ -0,0 +1,13 @@
+{
+  "version": 3,
+  "sources": ["../../runtime/src/env.ts", "../../runtime/src/worker-call.ts", "../../runtime/src/worker-helper.ts", "../src/bridge.ts"],
+  "sourcesContent": [
+    "/**\n * Runtime environment detection utilities\n */\n\n/**\n * Detect if running in a Web Worker context\n */\nexport function isWorker(): boolean {\n  return (\n    typeof self !== 'undefined' &&\n    typeof (globalThis as unknown as { DedicatedWorkerGlobalScope?: unknown })\n      .DedicatedWorkerGlobalScope !== 'undefined'\n  );\n}\n\n/**\n * Detect if running in a browser context\n */\nexport function isBrowser(): boolean {\n  return typeof window !== 'undefined' && typeof document !== 'undefined';\n}\n\n/**\n * Detect if running in Bun\n */\nexport function isBun(): boolean {\n  return typeof Bun !== 'undefined';\n}\n\n/**\n * Detect if running in Node.js\n */\nexport function isNode(): boolean {\n  return (\n    typeof process !== 'undefined' &&\n    process.versions != null &&\n    process.versions.node != null\n  );\n}\n\n/**\n * Check if ImageData is available in the current environment\n */\nexport function hasImageData(): boolean {\n  return typeof ImageData !== 'undefined';\n}\n",
+    "/**\n * Generic worker communication helper with support for transferables and AbortSignal\n */\n\nexport interface WorkerRequest<T = unknown> {\n  type: string;\n  id: number;\n  payload: T;\n}\n\nexport interface WorkerResponse<T = unknown> {\n  id: number;\n  ok: boolean;\n  data?: T;\n  error?: string;\n}\n\nlet requestId = 0;\n\n/**\n * Call a worker with a typed request and wait for response\n *\n * @param worker - The worker instance to call\n * @param type - The message type\n * @param payload - The payload to send\n * @param signal - Optional AbortSignal to cancel the operation\n * @param transfer - Optional list of Transferable objects to transfer\n * @returns Promise that resolves with the worker's response data\n */\nexport async function callWorker<TPayload, TResponse>(\n  worker: Worker,\n  type: string,\n  payload: TPayload,\n  signal?: AbortSignal,\n  transfer?: Transferable[]\n): Promise<TResponse> {\n  return new Promise<TResponse>((resolve, reject) => {\n    const id = ++requestId;\n\n    // Check if already aborted\n    if (signal?.aborted) {\n      reject(new DOMException('Aborted', 'AbortError'));\n      return;\n    }\n\n    const handleMessage = (event: MessageEvent) => {\n      const response = event.data as WorkerResponse<TResponse>;\n      if (response.id !== id) return;\n\n      cleanup();\n\n      if (response.ok && response.data !== undefined) {\n        resolve(response.data);\n      } else {\n        reject(new Error(response.error || 'Unknown worker error'));\n      }\n    };\n\n    const handleError = (error: ErrorEvent) => {\n      cleanup();\n      reject(new Error(`Worker error: ${error.message}`));\n    };\n\n    const handleAbort = () => {\n      cleanup();\n      reject(new DOMException('Aborted', 'AbortError'));\n    };\n\n    const cleanup = () => {\n      worker.removeEventListener('message', handleMessage);\n      worker.removeEventListener('error', handleError);\n      signal?.removeEventListener('abort', handleAbort);\n    };\n\n    // Set up listeners\n    worker.addEventListener('message', handleMessage);\n    worker.addEventListener('error', handleError);\n    signal?.addEventListener('abort', handleAbort);\n\n    // Send the request\n    const request: WorkerRequest<TPayload> = { type, id, payload };\n\n    if (transfer && transfer.length > 0) {\n      worker.postMessage(request, transfer);\n    } else {\n      worker.postMessage(request);\n    }\n  });\n}\n",
+    "/**\n * Worker helper utilities for creating and managing Web Workers\n *\n * This module provides centralized logic for locating and creating worker files\n * in different environments (development, npm package, bundled, etc.)\n */\n\nimport { isBun } from './env';\n\n/**\n * Get the URL for a worker file\n *\n * This helper abstracts away the complexity of locating worker files\n * in different environments (development, npm package, bundled, etc.)\n *\n * @param workerFilename - The name of the worker file (with or without .js extension)\n * @returns URL object pointing to the worker file\n */\nexport function getWorkerURL(workerFilename: string): URL {\n  // Ensure filename has correct format\n  const normalizedName = workerFilename.endsWith('.js')\n    ? workerFilename\n    : `${workerFilename}.js`;\n\n  // In browser contexts, use absolute paths from the server root\n  // The server will route these to the correct locations\n  if (typeof window !== 'undefined') {\n    // Browser environment - use absolute paths with platform-specific extension\n    const workerPathMap: Record<string, string> = {\n      'webp.worker.js': '/dist/features/webp/webp.worker.browser.mjs',\n      'resize.worker.js': '/dist/features/resize/resize.worker.browser.mjs',\n    };\n\n    const browserPath = workerPathMap[normalizedName];\n    if (browserPath) {\n      return new URL(browserPath, window.location.href);\n    }\n  }\n\n  // Node.js/Bun: use relative path from runtime package location\n  // Determine which platform variant to use\n  const platformExt = isBun() ? '.bun.js' : '.node.mjs';\n\n  const nodePathMap: Record<string, string> = {\n    'webp.worker.js': `../../webp/dist/webp.worker${platformExt}`,\n    'resize.worker.js': `../../resize/dist/resize.worker${platformExt}`,\n  };\n\n  const nodePath = nodePathMap[normalizedName];\n  if (nodePath) {\n    return new URL(nodePath, import.meta.url);\n  }\n\n  // Fallback: assume worker is in same directory as this module\n  return new URL(normalizedName, import.meta.url);\n}\n\n/**\n * Create a Web Worker for a specific codec\n *\n * Handles environment-specific worker creation logic and provides\n * clear error messages when worker creation fails.\n *\n * @param workerFilename - The name of the worker file (e.g., 'resize.worker' or 'webp.worker')\n * @returns Worker instance\n * @throws Error if worker creation fails with detailed error message\n */\nexport function createCodecWorker(workerFilename: string): Worker {\n  const workerURL = getWorkerURL(workerFilename);\n\n  try {\n    return new Worker(workerURL.href, { type: 'module' });\n  } catch (error) {\n    const errorMessage = error instanceof Error ? error.message : String(error);\n    throw new Error(\n      `Failed to create worker from ${workerURL}: ${errorMessage}. ` +\n        `Ensure the worker file exists at the expected location. ` +\n        `Expected worker file: ${workerFilename}${workerFilename.endsWith('.js') ? '' : '.js'}`\n    );\n  }\n}\n\n/**\n * Create a worker with initialization timeout and ready signal handling\n *\n * This is a higher-level function that creates a worker and waits for it\n * to signal that it's ready to receive messages.\n *\n * @param workerFilename - The name of the worker file\n * @param timeoutMs - Timeout in milliseconds (default: 10000)\n * @returns Promise that resolves to a ready Worker instance\n * @throws Error if worker creation fails or times out\n */\nexport function createReadyWorker(\n  workerFilename: string,\n  timeoutMs: number = 10000\n): Promise<Worker> {\n  return new Promise((resolve, reject) => {\n    const timeout = setTimeout(() => {\n      reject(\n        new Error(\n          `Worker initialization timeout after ${timeoutMs}ms. Worker file: ${workerFilename}`\n        )\n      );\n    }, timeoutMs);\n\n    let worker: Worker;\n    try {\n      worker = createCodecWorker(workerFilename);\n    } catch (error) {\n      clearTimeout(timeout);\n      reject(error);\n      return;\n    }\n\n    const handleMessage = (event: MessageEvent) => {\n      if (event.data?.type === 'worker:ready') {\n        clearTimeout(timeout);\n        worker.removeEventListener('message', handleMessage);\n        resolve(worker);\n      }\n    };\n\n    worker.addEventListener('message', handleMessage);\n    worker.postMessage({ type: 'worker:ping' });\n  });\n}\n",
+    "/**\n * Bridge implementation for the WebP package, handling worker and client modes.\n */\n\nimport {\n  callWorker,\n  createReadyWorker,\n  type ImageInput,\n} from '@squoosh-kit/runtime';\nimport { validateArrayBuffer, validateImageInput } from '@squoosh-kit/runtime';\nimport { webpEncodeClient } from './webp.worker.js';\nimport type { WebpOptions } from './types.js';\n\ninterface WebPBridge {\n  encode(\n    image: ImageInput,\n    options?: WebpOptions,\n    signal?: AbortSignal\n  ): Promise<Uint8Array>;\n  terminate(): Promise<void>;\n}\n\nclass WebpClientBridge implements WebPBridge {\n  async encode(\n    image: ImageInput,\n    options?: WebpOptions,\n    signal?: AbortSignal\n  ): Promise<Uint8Array> {\n    return webpEncodeClient(image, options, signal);\n  }\n\n  async terminate(): Promise<void> {\n    // Client mode has nothing to terminate\n  }\n}\n\nclass WebpWorkerBridge implements WebPBridge {\n  private worker: Worker | null = null;\n  private workerReady: Promise<Worker> | null = null;\n\n  private async getWorker(): Promise<Worker> {\n    if (!this.worker) {\n      if (!this.workerReady) {\n        this.workerReady = this.createWorker();\n      }\n      this.worker = await this.workerReady;\n    }\n    return this.worker;\n  }\n\n  private async createWorker(): Promise<Worker> {\n    // Use the centralized worker helper for robust path resolution\n    return createReadyWorker('webp.worker');\n  }\n\n  async encode(\n    image: ImageInput,\n    options?: WebpOptions,\n    signal?: AbortSignal\n  ): Promise<Uint8Array> {\n    const worker = await this.getWorker();\n\n    // Validate and normalize image - ensure all required properties exist\n    if (!image || typeof image !== 'object') {\n      throw new TypeError('image must be an object');\n    }\n\n    const imageRecord = image as Record<string, unknown>;\n    if (!imageRecord.data) {\n      throw new TypeError('image.data is required');\n    }\n    if (imageRecord.width === undefined || imageRecord.height === undefined) {\n      throw new TypeError('image.width and image.height are required');\n    }\n\n    const normalizedImage: ImageInput = {\n      data: imageRecord.data as Uint8Array | Uint8ClampedArray,\n      width: imageRecord.width as number,\n      height: imageRecord.height as number,\n    };\n\n    validateImageInput(normalizedImage);\n    const buffer = normalizedImage.data.buffer;\n    validateArrayBuffer(buffer);\n    return callWorker(\n      worker,\n      'webp:encode',\n      { image: normalizedImage, options },\n      signal,\n      [buffer]\n    );\n  }\n\n  async terminate(): Promise<void> {\n    if (this.worker) {\n      this.worker.terminate();\n      this.worker = null;\n      this.workerReady = null;\n    }\n  }\n}\n\nexport function createBridge(mode: 'worker' | 'client'): WebPBridge {\n  return mode === 'client' ? new WebpClientBridge() : new WebpWorkerBridge();\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "0D11351578D67A2764756E2164756E21",
+  "names": []
+}

package/dist/bridge.node.mjs

@@ -0,0 +1,4 @@
+import{b as A,c as B,d as E}from"./webp.worker.node.mjs";function N(){return typeof Bun<"u"}var T=0;async function S(G,J,K,Y,H){return new Promise((X,Q)=>{let Z=++T;if(Y?.aborted){Q(new DOMException("Aborted","AbortError"));return}let V=(D)=>{let _=D.data;if(_.id!==Z)return;if($(),_.ok&&_.data!==void 0)X(_.data);else Q(Error(_.error||"Unknown worker error"))},O=(D)=>{$(),Q(Error(`Worker error: ${D.message}`))},x=()=>{$(),Q(new DOMException("Aborted","AbortError"))},$=()=>{G.removeEventListener("message",V),G.removeEventListener("error",O),Y?.removeEventListener("abort",x)};G.addEventListener("message",V),G.addEventListener("error",O),Y?.addEventListener("abort",x);let L={type:J,id:Z,payload:K};if(H&&H.length>0)G.postMessage(L,H);else G.postMessage(L)})}function q(G){let J=G.endsWith(".js")?G:`${G}.js`;if(typeof window<"u"){let Q={"webp.worker.js":"/dist/features/webp/webp.worker.browser.mjs","resize.worker.js":"/dist/features/resize/resize.worker.browser.mjs"}[J];if(Q)return new URL(Q,window.location.href)}let K=N()?".bun.js":".node.mjs",H={"webp.worker.js":`../../webp/dist/webp.worker${K}`,"resize.worker.js":`../../resize/dist/resize.worker${K}`}[J];if(H)return new URL(H,import.meta.url);return new URL(J,import.meta.url)}function z(G){let J=q(G);try{return new Worker(J.href,{type:"module"})}catch(K){let Y=K instanceof Error?K.message:String(K);throw Error(`Failed to create worker from ${J}: ${Y}. Ensure the worker file exists at the expected location. Expected worker file: ${G}${G.endsWith(".js")?"":".js"}`)}}function U(G,J=1e4){return new Promise((K,Y)=>{let H=setTimeout(()=>{Y(Error(`Worker initialization timeout after ${J}ms. Worker file: ${G}`))},J),X;try{X=z(G)}catch(Z){clearTimeout(H),Y(Z);return}let Q=(Z)=>{if(Z.data?.type==="worker:ready")clearTimeout(H),X.removeEventListener("message",Q),K(X)};X.addEventListener("message",Q),X.postMessage({type:"worker:ping"})})}class P{async encode(G,J,K){return E(G,J,K)}async terminate(){}}class I{worker=null;workerReady=null;async getWorker(){if(!this.worker){if(!this.workerReady)this.workerReady=this.createWorker();this.worker=await this.workerReady}return this.worker}async createWorker(){return U("webp.worker")}async encode(G,J,K){let Y=await this.getWorker();if(!G||typeof G!=="object")throw TypeError("image must be an object");let H=G;if(!H.data)throw TypeError("image.data is required");if(H.width===void 0||H.height===void 0)throw TypeError("image.width and image.height are required");let X={data:H.data,width:H.width,height:H.height};B(X);let Q=X.data.buffer;return A(Q),S(Y,"webp:encode",{image:X,options:J},K,[Q])}async terminate(){if(this.worker)this.worker.terminate(),this.worker=null,this.workerReady=null}}function v(G){return G==="client"?new P:new I}export{v as createBridge};
+export{v as a};
+
+//# debugId=5071F7E57E5AA63164756E2164756E21

package/dist/bridge.node.mjs.map

@@ -0,0 +1,13 @@
+{
+  "version": 3,
+  "sources": ["../../runtime/src/env.ts", "../../runtime/src/worker-call.ts", "../../runtime/src/worker-helper.ts", "../src/bridge.ts"],
+  "sourcesContent": [
+    "/**\n * Runtime environment detection utilities\n */\n\n/**\n * Detect if running in a Web Worker context\n */\nexport function isWorker(): boolean {\n  return (\n    typeof self !== 'undefined' &&\n    typeof (globalThis as unknown as { DedicatedWorkerGlobalScope?: unknown })\n      .DedicatedWorkerGlobalScope !== 'undefined'\n  );\n}\n\n/**\n * Detect if running in a browser context\n */\nexport function isBrowser(): boolean {\n  return typeof window !== 'undefined' && typeof document !== 'undefined';\n}\n\n/**\n * Detect if running in Bun\n */\nexport function isBun(): boolean {\n  return typeof Bun !== 'undefined';\n}\n\n/**\n * Detect if running in Node.js\n */\nexport function isNode(): boolean {\n  return (\n    typeof process !== 'undefined' &&\n    process.versions != null &&\n    process.versions.node != null\n  );\n}\n\n/**\n * Check if ImageData is available in the current environment\n */\nexport function hasImageData(): boolean {\n  return typeof ImageData !== 'undefined';\n}\n",
+    "/**\n * Generic worker communication helper with support for transferables and AbortSignal\n */\n\nexport interface WorkerRequest<T = unknown> {\n  type: string;\n  id: number;\n  payload: T;\n}\n\nexport interface WorkerResponse<T = unknown> {\n  id: number;\n  ok: boolean;\n  data?: T;\n  error?: string;\n}\n\nlet requestId = 0;\n\n/**\n * Call a worker with a typed request and wait for response\n *\n * @param worker - The worker instance to call\n * @param type - The message type\n * @param payload - The payload to send\n * @param signal - Optional AbortSignal to cancel the operation\n * @param transfer - Optional list of Transferable objects to transfer\n * @returns Promise that resolves with the worker's response data\n */\nexport async function callWorker<TPayload, TResponse>(\n  worker: Worker,\n  type: string,\n  payload: TPayload,\n  signal?: AbortSignal,\n  transfer?: Transferable[]\n): Promise<TResponse> {\n  return new Promise<TResponse>((resolve, reject) => {\n    const id = ++requestId;\n\n    // Check if already aborted\n    if (signal?.aborted) {\n      reject(new DOMException('Aborted', 'AbortError'));\n      return;\n    }\n\n    const handleMessage = (event: MessageEvent) => {\n      const response = event.data as WorkerResponse<TResponse>;\n      if (response.id !== id) return;\n\n      cleanup();\n\n      if (response.ok && response.data !== undefined) {\n        resolve(response.data);\n      } else {\n        reject(new Error(response.error || 'Unknown worker error'));\n      }\n    };\n\n    const handleError = (error: ErrorEvent) => {\n      cleanup();\n      reject(new Error(`Worker error: ${error.message}`));\n    };\n\n    const handleAbort = () => {\n      cleanup();\n      reject(new DOMException('Aborted', 'AbortError'));\n    };\n\n    const cleanup = () => {\n      worker.removeEventListener('message', handleMessage);\n      worker.removeEventListener('error', handleError);\n      signal?.removeEventListener('abort', handleAbort);\n    };\n\n    // Set up listeners\n    worker.addEventListener('message', handleMessage);\n    worker.addEventListener('error', handleError);\n    signal?.addEventListener('abort', handleAbort);\n\n    // Send the request\n    const request: WorkerRequest<TPayload> = { type, id, payload };\n\n    if (transfer && transfer.length > 0) {\n      worker.postMessage(request, transfer);\n    } else {\n      worker.postMessage(request);\n    }\n  });\n}\n",
+    "/**\n * Worker helper utilities for creating and managing Web Workers\n *\n * This module provides centralized logic for locating and creating worker files\n * in different environments (development, npm package, bundled, etc.)\n */\n\nimport { isBun } from './env';\n\n/**\n * Get the URL for a worker file\n *\n * This helper abstracts away the complexity of locating worker files\n * in different environments (development, npm package, bundled, etc.)\n *\n * @param workerFilename - The name of the worker file (with or without .js extension)\n * @returns URL object pointing to the worker file\n */\nexport function getWorkerURL(workerFilename: string): URL {\n  // Ensure filename has correct format\n  const normalizedName = workerFilename.endsWith('.js')\n    ? workerFilename\n    : `${workerFilename}.js`;\n\n  // In browser contexts, use absolute paths from the server root\n  // The server will route these to the correct locations\n  if (typeof window !== 'undefined') {\n    // Browser environment - use absolute paths with platform-specific extension\n    const workerPathMap: Record<string, string> = {\n      'webp.worker.js': '/dist/features/webp/webp.worker.browser.mjs',\n      'resize.worker.js': '/dist/features/resize/resize.worker.browser.mjs',\n    };\n\n    const browserPath = workerPathMap[normalizedName];\n    if (browserPath) {\n      return new URL(browserPath, window.location.href);\n    }\n  }\n\n  // Node.js/Bun: use relative path from runtime package location\n  // Determine which platform variant to use\n  const platformExt = isBun() ? '.bun.js' : '.node.mjs';\n\n  const nodePathMap: Record<string, string> = {\n    'webp.worker.js': `../../webp/dist/webp.worker${platformExt}`,\n    'resize.worker.js': `../../resize/dist/resize.worker${platformExt}`,\n  };\n\n  const nodePath = nodePathMap[normalizedName];\n  if (nodePath) {\n    return new URL(nodePath, import.meta.url);\n  }\n\n  // Fallback: assume worker is in same directory as this module\n  return new URL(normalizedName, import.meta.url);\n}\n\n/**\n * Create a Web Worker for a specific codec\n *\n * Handles environment-specific worker creation logic and provides\n * clear error messages when worker creation fails.\n *\n * @param workerFilename - The name of the worker file (e.g., 'resize.worker' or 'webp.worker')\n * @returns Worker instance\n * @throws Error if worker creation fails with detailed error message\n */\nexport function createCodecWorker(workerFilename: string): Worker {\n  const workerURL = getWorkerURL(workerFilename);\n\n  try {\n    return new Worker(workerURL.href, { type: 'module' });\n  } catch (error) {\n    const errorMessage = error instanceof Error ? error.message : String(error);\n    throw new Error(\n      `Failed to create worker from ${workerURL}: ${errorMessage}. ` +\n        `Ensure the worker file exists at the expected location. ` +\n        `Expected worker file: ${workerFilename}${workerFilename.endsWith('.js') ? '' : '.js'}`\n    );\n  }\n}\n\n/**\n * Create a worker with initialization timeout and ready signal handling\n *\n * This is a higher-level function that creates a worker and waits for it\n * to signal that it's ready to receive messages.\n *\n * @param workerFilename - The name of the worker file\n * @param timeoutMs - Timeout in milliseconds (default: 10000)\n * @returns Promise that resolves to a ready Worker instance\n * @throws Error if worker creation fails or times out\n */\nexport function createReadyWorker(\n  workerFilename: string,\n  timeoutMs: number = 10000\n): Promise<Worker> {\n  return new Promise((resolve, reject) => {\n    const timeout = setTimeout(() => {\n      reject(\n        new Error(\n          `Worker initialization timeout after ${timeoutMs}ms. Worker file: ${workerFilename}`\n        )\n      );\n    }, timeoutMs);\n\n    let worker: Worker;\n    try {\n      worker = createCodecWorker(workerFilename);\n    } catch (error) {\n      clearTimeout(timeout);\n      reject(error);\n      return;\n    }\n\n    const handleMessage = (event: MessageEvent) => {\n      if (event.data?.type === 'worker:ready') {\n        clearTimeout(timeout);\n        worker.removeEventListener('message', handleMessage);\n        resolve(worker);\n      }\n    };\n\n    worker.addEventListener('message', handleMessage);\n    worker.postMessage({ type: 'worker:ping' });\n  });\n}\n",
+    "/**\n * Bridge implementation for the WebP package, handling worker and client modes.\n */\n\nimport {\n  callWorker,\n  createReadyWorker,\n  type ImageInput,\n} from '@squoosh-kit/runtime';\nimport { validateArrayBuffer, validateImageInput } from '@squoosh-kit/runtime';\nimport { webpEncodeClient } from './webp.worker.js';\nimport type { WebpOptions } from './types.js';\n\ninterface WebPBridge {\n  encode(\n    image: ImageInput,\n    options?: WebpOptions,\n    signal?: AbortSignal\n  ): Promise<Uint8Array>;\n  terminate(): Promise<void>;\n}\n\nclass WebpClientBridge implements WebPBridge {\n  async encode(\n    image: ImageInput,\n    options?: WebpOptions,\n    signal?: AbortSignal\n  ): Promise<Uint8Array> {\n    return webpEncodeClient(image, options, signal);\n  }\n\n  async terminate(): Promise<void> {\n    // Client mode has nothing to terminate\n  }\n}\n\nclass WebpWorkerBridge implements WebPBridge {\n  private worker: Worker | null = null;\n  private workerReady: Promise<Worker> | null = null;\n\n  private async getWorker(): Promise<Worker> {\n    if (!this.worker) {\n      if (!this.workerReady) {\n        this.workerReady = this.createWorker();\n      }\n      this.worker = await this.workerReady;\n    }\n    return this.worker;\n  }\n\n  private async createWorker(): Promise<Worker> {\n    // Use the centralized worker helper for robust path resolution\n    return createReadyWorker('webp.worker');\n  }\n\n  async encode(\n    image: ImageInput,\n    options?: WebpOptions,\n    signal?: AbortSignal\n  ): Promise<Uint8Array> {\n    const worker = await this.getWorker();\n\n    // Validate and normalize image - ensure all required properties exist\n    if (!image || typeof image !== 'object') {\n      throw new TypeError('image must be an object');\n    }\n\n    const imageRecord = image as Record<string, unknown>;\n    if (!imageRecord.data) {\n      throw new TypeError('image.data is required');\n    }\n    if (imageRecord.width === undefined || imageRecord.height === undefined) {\n      throw new TypeError('image.width and image.height are required');\n    }\n\n    const normalizedImage: ImageInput = {\n      data: imageRecord.data as Uint8Array | Uint8ClampedArray,\n      width: imageRecord.width as number,\n      height: imageRecord.height as number,\n    };\n\n    validateImageInput(normalizedImage);\n    const buffer = normalizedImage.data.buffer;\n    validateArrayBuffer(buffer);\n    return callWorker(\n      worker,\n      'webp:encode',\n      { image: normalizedImage, options },\n      signal,\n      [buffer]\n    );\n  }\n\n  async terminate(): Promise<void> {\n    if (this.worker) {\n      this.worker.terminate();\n      this.worker = null;\n      this.workerReady = null;\n    }\n  }\n}\n\nexport function createBridge(mode: 'worker' | 'client'): WebPBridge {\n  return mode === 'client' ? new WebpClientBridge() : new WebpWorkerBridge();\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "5071F7E57E5AA63164756E2164756E21",
+  "names": []
+}

package/dist/chunk-djaabg7r.js

@@ -0,0 +1,3 @@
+var j=Object.create;var{getPrototypeOf:k,defineProperty:e,getOwnPropertyNames:h,getOwnPropertyDescriptor:l}=Object,i=Object.prototype.hasOwnProperty;var m=(a,b,c)=>{c=a!=null?j(k(a)):{};let d=b||!a||!a.__esModule?e(c,"default",{value:a,enumerable:!0}):c;for(let f of h(a))if(!i.call(d,f))e(d,f,{get:()=>a[f],enumerable:!0});return d},g=new WeakMap,n=(a)=>{var b=g.get(a),c;if(b)return b;if(b=e({},"__esModule",{value:!0}),a&&typeof a==="object"||typeof a==="function")h(a).map((d)=>!i.call(b,d)&&e(b,d,{get:()=>a[d],enumerable:!(c=l(a,d))||c.enumerable}));return g.set(a,b),b};var o=(a,b)=>{for(var c in b)e(a,c,{get:b[c],enumerable:!0,configurable:!0,set:(d)=>b[c]=()=>d})};
+
+//# debugId=13132CCCB2E09AB364756E2164756E21

package/dist/chunk-djaabg7r.js.map

@@ -0,0 +1,9 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [
+  ],
+  "mappings": "",
+  "debugId": "13132CCCB2E09AB364756E2164756E21",
+  "names": []
+}

package/dist/index.browser.mjs

@@ -0,0 +1,3 @@
+import{a as E}from"./bridge.browser.mjs";import"./webp.worker.browser.mjs";var z=null;async function J(y,j,q){if(!z)z=E("worker");return z.encode(y,j,q)}function K(y="worker"){let j=E(y),q=(F,G,H)=>{return j.encode(F,G,H)};return q.terminate=async()=>{await j.terminate()},q}export{J as encode,K as createWebpEncoder};
+
+//# debugId=56B5D79F936C056264756E2164756E21

package/dist/index.browser.mjs.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/index.ts"],
+  "sourcesContent": [
+    "/**\n * @squoosh-kit/webp public API\n */\n\nimport type { ImageInput } from '@squoosh-kit/runtime';\nimport { createBridge } from './bridge';\nimport type { WebpOptions } from './types';\n\nexport type { ImageInput, WebpOptions };\n\n// Global bridge instance for reuse\nlet globalClientBridge: ReturnType<typeof createBridge> | null = null;\n\n/**\n * A WebP image encoder that can be reused for multiple operations.\n * Can be terminated to clean up associated resources (especially workers).\n */\nexport type WebpEncoderFactory = ((\n  imageData: ImageInput,\n  options?: WebpOptions,\n  signal?: AbortSignal\n) => Promise<Uint8Array>) & {\n  /**\n   * Terminates the encoder and cleans up resources.\n   * Important for worker mode to prevent memory leaks.\n   *\n   * @example\n   * const encoder = createWebpEncoder('worker');\n   * try {\n   *   const result = await encoder(imageData, options);\n   * } finally {\n   *   await encoder.terminate();\n   * }\n   */\n  terminate(): Promise<void>;\n};\n\n/**\n * Encodes an image to WebP format. Uses worker mode for UI responsiveness.\n *\n * @param imageData - The image data to encode.\n * @param options - WebP encoding options.\n * @param signal - (Optional) AbortSignal to cancel the encoding operation.\n *                 If provided, you can cancel the operation by calling\n *                 `controller.abort()` on the associated AbortController.\n *                 If not provided, the operation cannot be cancelled.\n * @returns A Promise resolving to the encoded WebP data as a Uint8Array.\n *\n * @example\n * // With cancellation support\n * const controller = new AbortController();\n * const result = await encode(imageData, { quality: 85 }, controller.signal);\n * setTimeout(() => controller.abort(), 5000);\n *\n * @example\n * // Without cancellation (operation cannot be stopped)\n * const result = await encode(imageData, { quality: 85 });\n */\nexport async function encode(\n  imageData: ImageInput,\n  options?: WebpOptions,\n  signal?: AbortSignal\n): Promise<Uint8Array> {\n  // Use worker mode for UI responsiveness - prevents blocking the main thread\n  if (!globalClientBridge) {\n    globalClientBridge = createBridge('worker');\n  }\n\n  return globalClientBridge.encode(imageData, options, signal);\n}\n\n/**\n * Creates a reusable WebP encoder function for a specific execution mode.\n * This is useful for processing multiple images without the overhead of\n * creating a new worker or client instance each time.\n *\n * @param mode - The execution mode, either 'worker' or 'client'.\n * @returns A function that encodes an image to WebP format with optional AbortSignal.\n */\nexport function createWebpEncoder(\n  mode: 'worker' | 'client' = 'worker'\n): WebpEncoderFactory {\n  const bridge = createBridge(mode);\n\n  const encoder = (\n    imageData: ImageInput,\n    options?: WebpOptions,\n    signal?: AbortSignal\n  ) => {\n    return bridge.encode(imageData, options, signal);\n  };\n\n  encoder.terminate = async () => {\n    await bridge.terminate();\n  };\n\n  return encoder as WebpEncoderFactory;\n}\n"
+  ],
+  "mappings": "2EAWA,IAAI,EAA6D,KA+CjE,eAAsB,CAAM,CAC1B,EACA,EACA,EACqB,CAErB,GAAI,CAAC,EACH,EAAqB,EAAa,QAAQ,EAG5C,OAAO,EAAmB,OAAO,EAAW,EAAS,CAAM,EAWtD,SAAS,CAAiB,CAC/B,EAA4B,SACR,CACpB,IAAM,EAAS,EAAa,CAAI,EAE1B,EAAU,CACd,EACA,EACA,IACG,CACH,OAAO,EAAO,OAAO,EAAW,EAAS,CAAM,GAOjD,OAJA,EAAQ,UAAY,SAAY,CAC9B,MAAM,EAAO,UAAU,GAGlB",
+  "debugId": "56B5D79F936C056264756E2164756E21",
+  "names": []
+}

package/dist/index.bun.js

@@ -0,0 +1,4 @@
+// @bun
+import{a as E}from"./bridge.bun.js";import"./webp.worker.bun.js";var z=null;async function J(y,j,q){if(!z)z=E("worker");return z.encode(y,j,q)}function K(y="worker"){let j=E(y),q=(F,G,H)=>{return j.encode(F,G,H)};return q.terminate=async()=>{await j.terminate()},q}export{J as encode,K as createWebpEncoder};
+
+//# debugId=F933FA0AE193052664756E2164756E21

package/dist/index.bun.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/index.ts"],
+  "sourcesContent": [
+    "/**\n * @squoosh-kit/webp public API\n */\n\nimport type { ImageInput } from '@squoosh-kit/runtime';\nimport { createBridge } from './bridge';\nimport type { WebpOptions } from './types';\n\nexport type { ImageInput, WebpOptions };\n\n// Global bridge instance for reuse\nlet globalClientBridge: ReturnType<typeof createBridge> | null = null;\n\n/**\n * A WebP image encoder that can be reused for multiple operations.\n * Can be terminated to clean up associated resources (especially workers).\n */\nexport type WebpEncoderFactory = ((\n  imageData: ImageInput,\n  options?: WebpOptions,\n  signal?: AbortSignal\n) => Promise<Uint8Array>) & {\n  /**\n   * Terminates the encoder and cleans up resources.\n   * Important for worker mode to prevent memory leaks.\n   *\n   * @example\n   * const encoder = createWebpEncoder('worker');\n   * try {\n   *   const result = await encoder(imageData, options);\n   * } finally {\n   *   await encoder.terminate();\n   * }\n   */\n  terminate(): Promise<void>;\n};\n\n/**\n * Encodes an image to WebP format. Uses worker mode for UI responsiveness.\n *\n * @param imageData - The image data to encode.\n * @param options - WebP encoding options.\n * @param signal - (Optional) AbortSignal to cancel the encoding operation.\n *                 If provided, you can cancel the operation by calling\n *                 `controller.abort()` on the associated AbortController.\n *                 If not provided, the operation cannot be cancelled.\n * @returns A Promise resolving to the encoded WebP data as a Uint8Array.\n *\n * @example\n * // With cancellation support\n * const controller = new AbortController();\n * const result = await encode(imageData, { quality: 85 }, controller.signal);\n * setTimeout(() => controller.abort(), 5000);\n *\n * @example\n * // Without cancellation (operation cannot be stopped)\n * const result = await encode(imageData, { quality: 85 });\n */\nexport async function encode(\n  imageData: ImageInput,\n  options?: WebpOptions,\n  signal?: AbortSignal\n): Promise<Uint8Array> {\n  // Use worker mode for UI responsiveness - prevents blocking the main thread\n  if (!globalClientBridge) {\n    globalClientBridge = createBridge('worker');\n  }\n\n  return globalClientBridge.encode(imageData, options, signal);\n}\n\n/**\n * Creates a reusable WebP encoder function for a specific execution mode.\n * This is useful for processing multiple images without the overhead of\n * creating a new worker or client instance each time.\n *\n * @param mode - The execution mode, either 'worker' or 'client'.\n * @returns A function that encodes an image to WebP format with optional AbortSignal.\n */\nexport function createWebpEncoder(\n  mode: 'worker' | 'client' = 'worker'\n): WebpEncoderFactory {\n  const bridge = createBridge(mode);\n\n  const encoder = (\n    imageData: ImageInput,\n    options?: WebpOptions,\n    signal?: AbortSignal\n  ) => {\n    return bridge.encode(imageData, options, signal);\n  };\n\n  encoder.terminate = async () => {\n    await bridge.terminate();\n  };\n\n  return encoder as WebpEncoderFactory;\n}\n"
+  ],
+  "mappings": ";sEAWA,DAAI,EAA6D,KA+CjE,eAAsB,CAAM,CAC1B,EACA,EACA,EACqB,CAErB,GAAI,CAAC,EACH,EAAqB,EAAa,QAAQ,EAG5C,OAAO,EAAmB,OAAO,EAAW,EAAS,CAAM,EAWtD,SAAS,CAAiB,CAC/B,EAA4B,SACR,CACpB,IAAM,EAAS,EAAa,CAAI,EAE1B,EAAU,CACd,EACA,EACA,IACG,CACH,OAAO,EAAO,OAAO,EAAW,EAAS,CAAM,GAOjD,OAJA,EAAQ,UAAY,SAAY,CAC9B,MAAM,EAAO,UAAU,GAGlB",
+  "debugId": "F933FA0AE193052664756E2164756E21",
+  "names": []
+}