@squoosh-kit/webp 0.0.17 → 0.0.19

package/README.md

@@ -2,11 +2,20 @@
 
 [![npm version](https://badge.fury.io/js/%40squoosh-kit%2Fwebp.svg)](https://badge.fury.io/js/%40squoosh-kit%2Fwebp)
 
-**Professional WebP encoding that doesn't get in your way**
+<img width="2560" height="688" alt="image" src="https://github.com/user-attachments/assets/05ee874f-4f53-4070-9383-77bb083b5d2d" />
 
-Transform your images into the modern WebP format with the same technology that powers Google's Squoosh. Built on WebAssembly for incredible speed, this package handles the heavy lifting while keeping your application responsive through intelligent worker management.
+## Squoosh Kit
 
-Perfect for optimizing images in web applications, processing user uploads, or building image conversion services. Whether you're working with Bun, Node.js, or the browser, WebP encoding has never been this straightforward.
+Squoosh Kit is built on a simple idea: provide a lightweight and modular bridge to the powerful, production-tested codecs from Google's Squoosh project. This package (`@squoosh-kit/webp`) is one of those modules.
+
+**Directly from the Source**
+We don't modify the core WebP codec. The WebAssembly (`.wasm`) binary is taken directly from the official Squoosh repository builds. This means you get the exact same performance, quality, and reliability you'd expect from Squoosh.
+
+**A Thin, Modern Wrapper**
+Our goal is to provide a minimal, modern JavaScript wrapper around the codec. We handle the tricky parts—like loading WASM, managing web workers, and providing a clean, type-safe API—so you can focus on your application. The library is designed to be a thin bridge, not a heavy framework.
+
+**Modular by Design**
+We believe you should only install what you need. As a standalone package, `@squoosh-kit/webp` allows you to add professional WebP encoding to your project without pulling in other unrelated image processing tools.
 
 ## Installation
 
@@ -18,8 +27,6 @@ npm install @squoosh-kit/webp
 
 ## Quick Start
 
-Get started with minimal fuss:
-
 ```typescript
 import { encode, createWebpEncoder } from '@squoosh-kit/webp';
 import type { ImageInput } from '@squoosh-kit/webp';
@@ -59,12 +66,6 @@ Only the following exports are part of the public API and guaranteed to be stabl
 
 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.
-
-You get the same quality and performance as the original Squoosh tool, but wrapped in a clean JavaScript API that fits naturally into modern applications.
-
 ## Real-World Examples
 
 **Image Upload Processing with Timeout**

package/dist/index.browser.mjs

@@ -1,3 +1,3 @@
-import{a as E}from"./bridge.browser.mjs";import"./chunk-eqkkc09z.js";import"./chunk-bhj61bkd.js";var z=null;async function I(q,j,y){if(!z)z=E("worker");return z.encode(q,j,y)}function J(q="worker"){let j=E(q);return{encode:(y,F,G)=>{return j.encode(y,F,G)},terminate:async()=>await j.terminate()}}export{I as encode,J as createWebpEncoder};
+import{a as E}from"./bridge.browser.mjs";import"./chunk-eqkkc09z.js";import"./chunk-bhj61bkd.js";var z=null;async function I(q,j,y){if(!z)z=E("worker");return z.encode(q,j,y)}function J(q="worker"){let j=E(q);return Object.assign((y,F,G)=>{return j.encode(y,F,G)},{terminate:async()=>{await j.terminate()}})}export{I as encode,J as createWebpEncoder};
 
-//# debugId=0842051C6B15E5D864756E2164756E21
+//# debugId=90E601329CA59A6864756E2164756E21

package/dist/index.browser.mjs.map

@@ -2,9 +2,9 @@
   "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 { EncodeInputOptions } from './types';\n\nexport type { ImageInput, EncodeInputOptions };\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?: EncodeInputOptions,\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?: EncodeInputOptions,\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(mode: 'worker' | 'client' = 'worker') {\n  const bridge = createBridge(mode);\n\n  return {\n    encode: (\n      imageData: ImageInput,\n      options?: EncodeInputOptions,\n      signal?: AbortSignal\n    ) => {\n      return bridge.encode(imageData, options, signal);\n    },\n    terminate: async () => await bridge.terminate(),\n  };\n}\n"
+    "/**\n * @squoosh-kit/webp public API\n */\n\nimport type { ImageInput } from '@squoosh-kit/runtime';\nimport { createBridge } from './bridge';\nimport type { EncodeInputOptions } from './types';\n\nexport type { ImageInput, EncodeInputOptions };\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?: EncodeInputOptions,\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?: EncodeInputOptions,\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  return Object.assign(\n    (\n      imageData: ImageInput,\n      options?: EncodeInputOptions,\n      signal?: AbortSignal\n    ) => {\n      return bridge.encode(imageData, options, signal);\n    },\n    {\n      terminate: async () => {\n        await bridge.terminate();\n      },\n    }\n  );\n}\n"
   ],
-  "mappings": "6GAWA,FAAI,JAA6D,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,CAAC,EAA4B,SAAU,CACtE,IAAM,EAAS,EAAa,CAAI,EAEhC,MAAO,CACL,OAAQ,CACN,EACA,EACA,IACG,CACH,OAAO,EAAO,OAAO,EAAW,EAAS,CAAM,GAEjD,UAAW,SAAY,MAAM,EAAO,UAAU,CAChD",
-  "debugId": "0842051C6B15E5D864756E2164756E21",
+  "mappings": "6GAWA,FAAI,JAA6D,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,EAEhC,OAAO,OAAO,OACZ,CACE,EACA,EACA,IACG,CACH,OAAO,EAAO,OAAO,EAAW,EAAS,CAAM,GAEjD,CACE,UAAW,SAAY,CACrB,MAAM,EAAO,UAAU,EAE3B,CACF",
+  "debugId": "90E601329CA59A6864756E2164756E21",
   "names": []
 }

package/dist/index.bun.js

@@ -1,4 +1,4 @@
 // @bun
-import{a as E}from"./bridge.bun.js";import"./chunk-m5rj68ef.js";import"./chunk-8y42hv65.js";var z=null;async function I(q,j,y){if(!z)z=E("worker");return z.encode(q,j,y)}function J(q="worker"){let j=E(q);return{encode:(y,F,G)=>{return j.encode(y,F,G)},terminate:async()=>await j.terminate()}}export{I as encode,J as createWebpEncoder};
+import{a as E}from"./bridge.bun.js";import"./chunk-m5rj68ef.js";import"./chunk-8y42hv65.js";var z=null;async function I(q,j,y){if(!z)z=E("worker");return z.encode(q,j,y)}function J(q="worker"){let j=E(q);return Object.assign((y,F,G)=>{return j.encode(y,F,G)},{terminate:async()=>{await j.terminate()}})}export{I as encode,J as createWebpEncoder};
 
-//# debugId=A26C59DF4BDF73A964756E2164756E21
+//# debugId=CD24F8BD50B2DFDA64756E2164756E21

package/dist/index.bun.js.map

@@ -2,9 +2,9 @@
   "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 { EncodeInputOptions } from './types';\n\nexport type { ImageInput, EncodeInputOptions };\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?: EncodeInputOptions,\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?: EncodeInputOptions,\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(mode: 'worker' | 'client' = 'worker') {\n  const bridge = createBridge(mode);\n\n  return {\n    encode: (\n      imageData: ImageInput,\n      options?: EncodeInputOptions,\n      signal?: AbortSignal\n    ) => {\n      return bridge.encode(imageData, options, signal);\n    },\n    terminate: async () => await bridge.terminate(),\n  };\n}\n"
+    "/**\n * @squoosh-kit/webp public API\n */\n\nimport type { ImageInput } from '@squoosh-kit/runtime';\nimport { createBridge } from './bridge';\nimport type { EncodeInputOptions } from './types';\n\nexport type { ImageInput, EncodeInputOptions };\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?: EncodeInputOptions,\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?: EncodeInputOptions,\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  return Object.assign(\n    (\n      imageData: ImageInput,\n      options?: EncodeInputOptions,\n      signal?: AbortSignal\n    ) => {\n      return bridge.encode(imageData, options, signal);\n    },\n    {\n      terminate: async () => {\n        await bridge.terminate();\n      },\n    }\n  );\n}\n"
   ],
-  "mappings": ";wGAWA,FAAI,JAA6D,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,CAAC,EAA4B,SAAU,CACtE,IAAM,EAAS,EAAa,CAAI,EAEhC,MAAO,CACL,OAAQ,CACN,EACA,EACA,IACG,CACH,OAAO,EAAO,OAAO,EAAW,EAAS,CAAM,GAEjD,UAAW,SAAY,MAAM,EAAO,UAAU,CAChD",
-  "debugId": "A26C59DF4BDF73A964756E2164756E21",
+  "mappings": ";wGAWA,FAAI,JAA6D,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,EAEhC,OAAO,OAAO,OACZ,CACE,EACA,EACA,IACG,CACH,OAAO,EAAO,OAAO,EAAW,EAAS,CAAM,GAEjD,CACE,UAAW,SAAY,CACrB,MAAM,EAAO,UAAU,EAE3B,CACF",
+  "debugId": "CD24F8BD50B2DFDA64756E2164756E21",
   "names": []
 }

package/dist/index.d.ts

@@ -53,8 +53,5 @@ export declare function encode(imageData: ImageInput, options?: EncodeInputOptio
  * @param mode - The execution mode, either 'worker' or 'client'.
  * @returns A function that encodes an image to WebP format with optional AbortSignal.
  */
-export declare function createWebpEncoder(mode?: 'worker' | 'client'): {
-    encode: (imageData: ImageInput, options?: EncodeInputOptions, signal?: AbortSignal) => Promise<Uint8Array<ArrayBufferLike>>;
-    terminate: () => Promise<void>;
-};
+export declare function createWebpEncoder(mode?: 'worker' | 'client'): WebpEncoderFactory;
 //# 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;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAElD,YAAY,EAAE,UAAU,EAAE,kBAAkB,EAAE,CAAC;AAK/C;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAChC,SAAS,EAAE,UAAU,EACrB,OAAO,CAAC,EAAE,kBAAkB,EAC5B,MAAM,CAAC,EAAE,WAAW,KACjB,OAAO,CAAC,UAAU,CAAC,CAAC,GAAG;IAC1B;;;;;;;;;;;OAWG;IACH,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,MAAM,CAC1B,SAAS,EAAE,UAAU,EACrB,OAAO,CAAC,EAAE,kBAAkB,EAC5B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CAOrB;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,GAAE,QAAQ,GAAG,QAAmB;wBAKrD,UAAU,YACX,kBAAkB,WACnB,WAAW;;EAMzB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAElD,YAAY,EAAE,UAAU,EAAE,kBAAkB,EAAE,CAAC;AAK/C;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAChC,SAAS,EAAE,UAAU,EACrB,OAAO,CAAC,EAAE,kBAAkB,EAC5B,MAAM,CAAC,EAAE,WAAW,KACjB,OAAO,CAAC,UAAU,CAAC,CAAC,GAAG;IAC1B;;;;;;;;;;;OAWG;IACH,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,MAAM,CAC1B,SAAS,EAAE,UAAU,EACrB,OAAO,CAAC,EAAE,kBAAkB,EAC5B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CAOrB;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,GAAE,QAAQ,GAAG,QAAmB,GACnC,kBAAkB,CAiBpB"}

package/dist/index.node.cjs

@@ -1,3 +1,3 @@
-var L={};I(L,{encode:()=>J,createWebpEncoder:()=>K});module.exports=H(L);var z=null;async function J(q,j,y){if(!z)z=E("worker");return z.encode(q,j,y)}function K(q="worker"){let j=E(q);return{encode:(y,F,G)=>{return j.encode(y,F,G)},terminate:async()=>await j.terminate()}}
+var L={};I(L,{encode:()=>J,createWebpEncoder:()=>K});module.exports=H(L);var z=null;async function J(q,j,y){if(!z)z=E("worker");return z.encode(q,j,y)}function K(q="worker"){let j=E(q);return Object.assign((y,F,G)=>{return j.encode(y,F,G)},{terminate:async()=>{await j.terminate()}})}
 
-//# debugId=DC4F3BB4777C292A64756E2164756E21
+//# debugId=AC064DDE983490B364756E2164756E21

package/dist/index.node.cjs.map

@@ -2,9 +2,9 @@
   "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 { EncodeInputOptions } from './types';\n\nexport type { ImageInput, EncodeInputOptions };\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?: EncodeInputOptions,\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?: EncodeInputOptions,\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(mode: 'worker' | 'client' = 'worker') {\n  const bridge = createBridge(mode);\n\n  return {\n    encode: (\n      imageData: ImageInput,\n      options?: EncodeInputOptions,\n      signal?: AbortSignal\n    ) => {\n      return bridge.encode(imageData, options, signal);\n    },\n    terminate: async () => await bridge.terminate(),\n  };\n}\n"
+    "/**\n * @squoosh-kit/webp public API\n */\n\nimport type { ImageInput } from '@squoosh-kit/runtime';\nimport { createBridge } from './bridge';\nimport type { EncodeInputOptions } from './types';\n\nexport type { ImageInput, EncodeInputOptions };\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?: EncodeInputOptions,\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?: EncodeInputOptions,\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  return Object.assign(\n    (\n      imageData: ImageInput,\n      options?: EncodeInputOptions,\n      signal?: AbortSignal\n    ) => {\n      return bridge.encode(imageData, options, signal);\n    },\n    {\n      terminate: async () => {\n        await bridge.terminate();\n      },\n    }\n  );\n}\n"
   ],
-  "mappings": "yEAWA,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,CAAC,EAA4B,SAAU,CACtE,IAAM,EAAS,EAAa,CAAI,EAEhC,MAAO,CACL,OAAQ,CACN,EACA,EACA,IACG,CACH,OAAO,EAAO,OAAO,EAAW,EAAS,CAAM,GAEjD,UAAW,SAAY,MAAM,EAAO,UAAU,CAChD",
-  "debugId": "DC4F3BB4777C292A64756E2164756E21",
+  "mappings": "yEAWA,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,EAEhC,OAAO,OAAO,OACZ,CACE,EACA,EACA,IACG,CACH,OAAO,EAAO,OAAO,EAAW,EAAS,CAAM,GAEjD,CACE,UAAW,SAAY,CACrB,MAAM,EAAO,UAAU,EAE3B,CACF",
+  "debugId": "AC064DDE983490B364756E2164756E21",
   "names": []
 }

package/dist/index.node.mjs

@@ -1,3 +1,3 @@
-import{a as E}from"./bridge.node.mjs";import"./chunk-eqkkc09z.js";import"./chunk-c6cx0d7q.js";var z=null;async function I(q,j,y){if(!z)z=E("worker");return z.encode(q,j,y)}function J(q="worker"){let j=E(q);return{encode:(y,F,G)=>{return j.encode(y,F,G)},terminate:async()=>await j.terminate()}}export{I as encode,J as createWebpEncoder};
+import{a as E}from"./bridge.node.mjs";import"./chunk-eqkkc09z.js";import"./chunk-c6cx0d7q.js";var z=null;async function I(q,j,y){if(!z)z=E("worker");return z.encode(q,j,y)}function J(q="worker"){let j=E(q);return Object.assign((y,F,G)=>{return j.encode(y,F,G)},{terminate:async()=>{await j.terminate()}})}export{I as encode,J as createWebpEncoder};
 
-//# debugId=7EBF8333A709D21264756E2164756E21
+//# debugId=F3256E444F0CF21A64756E2164756E21

package/dist/index.node.mjs.map

@@ -2,9 +2,9 @@
   "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 { EncodeInputOptions } from './types';\n\nexport type { ImageInput, EncodeInputOptions };\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?: EncodeInputOptions,\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?: EncodeInputOptions,\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(mode: 'worker' | 'client' = 'worker') {\n  const bridge = createBridge(mode);\n\n  return {\n    encode: (\n      imageData: ImageInput,\n      options?: EncodeInputOptions,\n      signal?: AbortSignal\n    ) => {\n      return bridge.encode(imageData, options, signal);\n    },\n    terminate: async () => await bridge.terminate(),\n  };\n}\n"
+    "/**\n * @squoosh-kit/webp public API\n */\n\nimport type { ImageInput } from '@squoosh-kit/runtime';\nimport { createBridge } from './bridge';\nimport type { EncodeInputOptions } from './types';\n\nexport type { ImageInput, EncodeInputOptions };\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?: EncodeInputOptions,\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?: EncodeInputOptions,\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  return Object.assign(\n    (\n      imageData: ImageInput,\n      options?: EncodeInputOptions,\n      signal?: AbortSignal\n    ) => {\n      return bridge.encode(imageData, options, signal);\n    },\n    {\n      terminate: async () => {\n        await bridge.terminate();\n      },\n    }\n  );\n}\n"
   ],
-  "mappings": "0GAWA,FAAI,JAA6D,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,CAAC,EAA4B,SAAU,CACtE,IAAM,EAAS,EAAa,CAAI,EAEhC,MAAO,CACL,OAAQ,CACN,EACA,EACA,IACG,CACH,OAAO,EAAO,OAAO,EAAW,EAAS,CAAM,GAEjD,UAAW,SAAY,MAAM,EAAO,UAAU,CAChD",
-  "debugId": "7EBF8333A709D21264756E2164756E21",
+  "mappings": "0GAWA,FAAI,JAA6D,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,EAEhC,OAAO,OAAO,OACZ,CACE,EACA,EACA,IACG,CACH,OAAO,EAAO,OAAO,EAAW,EAAS,CAAM,GAEjD,CACE,UAAW,SAAY,CACrB,MAAM,EAAO,UAAU,EAE3B,CACF",
+  "debugId": "F3256E444F0CF21A64756E2164756E21",
   "names": []
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@squoosh-kit/webp",
-  "version": "0.0.17",
+  "version": "0.0.19",
   "type": "module",
   "description": "WebP codec for squoosh-kit, providing encoding functionality.",
   "author": "Bartosz Nowak <bnowak008@gmail.com>",
@@ -45,6 +45,6 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@squoosh-kit/runtime": "0.0.16"
+    "@squoosh-kit/runtime": "0.0.18"
   }
 }