@squoosh-kit/resize 0.0.3 → 0.0.5

package/README.md

@@ -4,9 +4,9 @@
 
 **Professional image resizing with uncompromising quality**
 
-Transform your images with the same high-quality resizing algorithm that powers Google's Squoosh. Using the Lanczos3 method for mathematically precise scaling, this package delivers crisp, clear results at any size through WebAssembly acceleration.
+Transform your images with flexible resizing algorithms that balance quality and performance. Using the proven Squoosh WASM codecs with support for Triangular, Catrom, Mitchell, and Lanczos3 methods, this package delivers crisp results at any size.
 
-Whether you need thumbnails for a gallery, responsive images for the web, or batch processing for a media library, this package handles resizing with the quality your users deserve, all while keeping your application smooth and responsive.
+Whether you need fast thumbnails for a gallery, responsive images for the web, or high-quality output for production, this package handles resizing with the algorithm your users deserve, all while keeping your application smooth and responsive.
 
 ## Installation
 
@@ -28,96 +28,161 @@ import type { ImageInput } from '@squoosh-kit/resize';
 const imageData: ImageInput = {
   data: imageBuffer,
   width: 2048,
-  height: 1536
+  height: 1536,
 };
 
-// Smart resizing maintains aspect ratio
+// With cancellation support
+const controller = new AbortController();
 const thumbnail = await resize(
-  new AbortController().signal,
   imageData,
-  { width: 400 } // height calculated automatically
+  { width: 400 }, // height calculated automatically
+  controller.signal
 );
 
-// Exact dimensions when you need them
-const resizedImage = await resize(
-  new AbortController().signal,
-  imageData,
-  { width: 1200, height: 800 }
-);
+// Cancel after 5 seconds if still running
+setTimeout(() => controller.abort(), 5000);
+
+// Without cancellation (operation cannot be stopped once started)
+const resizedImage = await resize(imageData, { width: 1200, height: 800 });
 
 // Create a resizer for batch operations
 const resizer = createResizer('worker');
 const results = await Promise.all([
-  resizer(new AbortController().signal, imageData, { width: 800 }),
-  resizer(new AbortController().signal, imageData, { width: 1200 }),
-  resizer(new AbortController().signal, imageData, { width: 1600 })
+  resizer(imageData, { width: 800 }, new AbortController().signal),
+  resizer(imageData, { width: 1200 }, new AbortController().signal),
+  resizer(imageData, { width: 1600 }, new AbortController().signal),
 ]);
 ```
 
-## The Quality Difference
+## Public API
+
+Only the following exports are part of the public API and guaranteed to be stable across versions:
+
+- `resize(imageData, options, signal?)` - Resize an image
+- `createResizer(mode?)` - Create a reusable resizer function
+- `ImageInput` type - Input image data structure
+- `ResizeOptions` type - Resize configuration options
+- `ResizerFactory` type - Type for reusable resizer functions
+
+Internal implementation details (such as `resizeClient`) are not part of the public API and may change without notice.
+
+## Resize Methods
+
+Control the quality/speed trade-off with the `method` option:
+
+```typescript
+// Balanced quality and speed (default)
+const balanced = await resize(imageData, { width: 800, method: 'mitchell' });
+
+// Fast for real-time preview
+const fast = await resize(imageData, { width: 800, method: 'triangular' });
+
+// Highest quality for production
+const highQuality = await resize(imageData, { width: 800, method: 'lanczos3' });
+```
+
+### Available Methods
+
+All methods are provided by the Squoosh WASM codec:
 
-This isn't your average image resizer. Under the hood, it uses the Lanczos3 algorithm - a sophisticated mathematical approach that considers surrounding pixels when calculating each new pixel value. The result is resizing that maintains sharpness, avoids artifacts, and preserves the visual quality that matters.
+- **triangular** (typ_idx=0): Fastest, lowest quality. Good for real-time previews and large-scale batch processing.
+- **catrom** (typ_idx=1): Medium quality and speed. Good general-purpose option.
+- **mitchell** (typ_idx=2, default): Balanced quality and performance. Recommended for most use cases.
+- **lanczos3** (typ_idx=3): Highest quality, slowest. Use for production output where quality is paramount.
 
-All processing happens in WebAssembly for incredible speed, with Web Workers ensuring your main thread stays free for user interactions.
+### Advanced Options
+
+```typescript
+// Color space control - use linear RGB for more accurate math
+const linearResize = await resize(imageData, {
+  width: 800,
+  method: 'lanczos3',
+  linearRGB: true, // Proper color space conversion
+});
+
+// Alpha channel handling - premultiply for better transparency
+const transparencyResize = await resize(imageData, {
+  width: 800,
+  premultiply: true, // Improves quality with transparent images
+});
+```
+
+## The Quality Difference
+
+This isn't your average image resizer. Choose your trade-off between speed and quality with four proven algorithms from Google Squoosh. All processing happens in WebAssembly for incredible speed, with Web Workers ensuring your main thread stays free for user interactions.
 
 ## Real-World Examples
 
 **Responsive Image Generation**
+
 ```typescript
 // Generate multiple sizes for responsive design
 const sizes = [320, 640, 1024, 1600];
 
 const responsiveImages = await Promise.all(
-  sizes.map(width =>
+  sizes.map((width) =>
     resize(
-      new AbortController().signal,
       originalImage,
-      { width, height: Math.round(width * 0.75) }
+      { width, height: Math.round(width * 0.75) },
+      new AbortController().signal
     )
   )
 );
 ```
 
-**Photo Gallery Thumbnails**
+**Photo Gallery Thumbnails with Timeout**
+
 ```typescript
 const resizer = createResizer('client'); // Direct for server use
 
 for (const photo of photoFiles) {
-  const fullImage = await loadImage(photo);
-  const thumbnail = await resizer(
-    new AbortController().signal,
-    fullImage,
-    { width: 300, height: 200 }
-  );
-
-  await saveThumbnail(photo.name, thumbnail);
+  const controller = new AbortController();
+
+  // Set a 30-second timeout
+  const timeout = setTimeout(() => controller.abort(), 30000);
+
+  try {
+    const fullImage = await loadImage(photo);
+    const thumbnail = await resizer(
+      fullImage,
+      { width: 300, height: 200 },
+      controller.signal
+    );
+
+    await saveThumbnail(photo.name, thumbnail);
+  } catch (error) {
+    if (error.name === 'AbortError') {
+      console.log(`Resize timed out for ${photo.name}`);
+    } else {
+      throw error;
+    }
+  } finally {
+    clearTimeout(timeout);
+  }
 }
 ```
 
 **Dynamic Image Processing**
+
 ```typescript
 // Resize based on user preferences
 const userWidth = getUserPreferredWidth();
-const processedImage = await resize(
-  new AbortController().signal,
-  imageData,
-  {
-    width: userWidth,
-    linearRGB: true,        // Better color accuracy
-    premultiply: false      // Maintain transparency
-  }
-);
+const processedImage = await resize(imageData, {
+  width: userWidth,
+  linearRGB: true, // Better color accuracy
+  premultiply: false, // Maintain transparency
+});
 ```
 
 ## API Reference
 
-### `resize(signal, imageData, options)`
+### `resize(imageData, options, signal?)`
 
 The main resizing function. Smart defaults make it easy to use.
 
-- `signal` - `AbortSignal` to cancel long operations
 - `imageData` - `ImageInput` object with your pixel data
-- `options` - (optional) `ResizeOptions` for dimensions and quality
+- `options` - `ResizeOptions` for dimensions and quality
+- `signal` - (optional) `AbortSignal` to cancel long operations. If provided, you can cancel by calling `controller.abort()` on the associated `AbortController`. If not provided, the operation cannot be cancelled.
 - **Returns** - `Promise<ImageInput>` with resized image data
 
 ### `createResizer(mode?)`
@@ -127,19 +192,247 @@ Creates a reusable resizing function for efficient batch processing.
 - `mode` - (optional) `'worker'` or `'client'`, defaults to `'worker'`
 - **Returns** - A function with the same signature as `resize()`
 
+## Cancellation Support
+
+To cancel a resize operation in progress, pass an `AbortSignal`:
+
+```typescript
+const controller = new AbortController();
+
+// Start resize
+const resizePromise = resize(imageData, { width: 800 }, controller.signal);
+
+// Cancel after 5 seconds if still running
+setTimeout(() => controller.abort(), 5000);
+
+try {
+  const result = await resizePromise;
+} catch (error) {
+  if (error.name === 'AbortError') {
+    console.log('Resize was cancelled');
+  }
+}
+```
+
+**Important**: If no signal is provided, the resize 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 resize(null, { width: 800 });
+
+// Will throw TypeError: image.data is required
+await resize({ width: 32, height: 32 }, { width: 800 });
+
+// Will throw TypeError: image.data must be Uint8Array or Uint8ClampedArray
+await resize({ data: [0, 0, 0, 255], width: 32, height: 32 }, { width: 800 });
+
+// Will throw RangeError: image.width must be a positive integer
+await resize(
+  { data: new Uint8Array(100), width: 0, height: 32 },
+  { width: 800 }
+);
+
+// Will throw RangeError: image.data too small
+// (needs 32 * 32 * 4 = 4096 bytes, but only 100 provided)
+await resize(
+  { data: new Uint8Array(100), width: 32, height: 32 },
+  { width: 800 }
+);
+```
+
+### Options Validation
+
+All resize options are validated for correctness:
+
+```typescript
+// Will throw RangeError: options.width must be a positive integer
+await resize(validImage, { width: -800 });
+
+// Will throw RangeError: options.height must be a positive integer
+await resize(validImage, { height: 0 });
+
+// Will throw TypeError: options.method must be one of: triangular, catrom, mitchell, lanczos3
+await resize(validImage, { width: 800, method: 'invalid' });
+
+// Will throw TypeError: options.premultiply must be boolean
+await resize(validImage, { width: 800, premultiply: 1 });
+```
+
+### Why Validation Matters
+
+Input validation prevents:
+
+- **Cryptic WASM errors** - Clear messages instead of "undefined behavior"
+- **Out-of-bounds buffer access** - Catches undersized buffers early
+- **NaN propagation** - Rejects invalid numeric dimensions
+- **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.
+
+### Edge Case Handling
+
+The library safely handles edge cases that could cause errors or unexpected behavior:
+
+#### Aspect Ratio Preservation with Small Dimensions
+
+When resizing with only width or height specified, the other dimension is calculated while maintaining aspect ratio. Extreme aspect ratios are handled safely:
+
+```typescript
+// Width 1, height calculates automatically - minimum 1 pixel enforced
+const tinyWidth = await resize(
+  { data, width: 1921, height: 1080 },
+  { width: 1 }
+);
+// Result: width=1, height≥1 (never 0)
+
+// Very wide image, height to 1
+const tinyHeight = await resize(
+  { data, width: 1920, height: 1 },
+  { height: 1 }
+);
+// Result: width≥1 (never 0), height=1
+```
+
+#### Rounding Precision
+
+Decimal aspect ratios are rounded carefully to avoid precision loss:
+
+```typescript
+// Calculation: (1080 * 960) / 1920 = 540 (exact)
+const result1 = await resize(
+  { data, width: 1920, height: 1080 },
+  { width: 960 }
+);
+// Result: width=960, height=540
+
+// Calculation: (1081 * 960) / 1920 = 540.5 → rounds to 541
+const result2 = await resize(
+  { data, width: 1920, height: 1081 },
+  { width: 960 }
+);
+// Result: width=960, height=541 (properly rounded)
+```
+
+#### Minimum Dimension Enforcement
+
+Output dimensions must be at least 1x1 pixel (WASM requirement):
+
+```typescript
+// Both dimensions will be at least 1
+const minimal = await resize(
+  { data, width: 100, height: 100 },
+  { width: 0.1 } // Would round to 0, enforced to 1
+);
+// This throws validation error (width must be ≥1)
+
+// But if validation passes, minimum 1x1 is guaranteed
+const valid = await resize({ data, width: 1000, height: 1000 }, { width: 1 });
+// Result: width=1, height≥1
+```
+
+#### Why This Matters
+
+- **No NaN values** - Rounding prevents `Infinity` from division by zero
+- **No 0-pixel images** - Minimum 1x1 ensures valid output
+- **Consistent behavior** - Aspect ratios always preserve proportion
+- **Safe calculations** - `Math.max(1, ...)` protects against negative results
+
+### Package Size
+
+This package includes WebAssembly binaries (~30-50KB gzipped) for the resize codec. These enable fast processing through Web Workers and are essential for optimal performance.
+
+**Size breakdown:**
+
+- JavaScript code: ~5-10KB gzipped
+- TypeScript definitions: ~3KB
+- WASM binaries: ~30-50KB gzipped (required for resizing)
+
+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/resize/dist/wasm/
+```
+
+**Note**: This will cause worker mode to fail. Only remove if using client mode exclusively.
+
+### Worker Cleanup
+
+When using worker mode (`createResizer('worker')`), always clean up the worker when you're done to prevent memory leaks:
+
+```typescript
+const resizer = createResizer('worker');
+
+try {
+  const result = await resizer(imageData, { width: 800 });
+  // Use the result...
+} finally {
+  // Clean up the worker to free resources
+  await resizer.terminate();
+}
+```
+
+For batch operations, keep the resizer alive throughout processing:
+
+```typescript
+const resizer = createResizer('worker');
+
+try {
+  const results = await Promise.all([
+    resizer(image1, { width: 800 }),
+    resizer(image2, { width: 800 }),
+    resizer(image3, { width: 800 }),
+  ]);
+
+  // Process results...
+} finally {
+  // Clean up when all operations are complete
+  await resizer.terminate();
+}
+```
+
+**Note**: In client mode (`createResizer('client')`), calling `terminate()` is a no-op since there are no worker resources to clean up. It's always safe to call for consistency.
+
 ### `ResizeOptions`
 
 Control the quality and behavior of resizing:
 
 ```typescript
 type ResizeOptions = {
-  width?: number;        // Target width (aspect ratio maintained if only width/height set)
-  height?: number;       // Target height (aspect ratio maintained if only width/height set)
+  width?: number; // Target width (aspect ratio maintained if only width/height set)
+  height?: number; // Target height (aspect ratio maintained if only width/height set)
+  method?: 'triangular' | 'catrom' | 'mitchell' | 'lanczos3'; // Resize algorithm (default: 'mitchell')
   premultiply?: boolean; // Premultiply alpha channel (default: false)
-  linearRGB?: boolean;   // Use linear RGB color space (default: false)
+  linearRGB?: boolean; // Use linear RGB color space (default: false)
 };
 ```
 
+### Parameter Reference
+
+All options map directly to the Squoosh WASM resize function:
+
+| Option        | WASM Parameter         | Type                                                 | Default         | Description                                              |
+| ------------- | ---------------------- | ---------------------------------------------------- | --------------- | -------------------------------------------------------- |
+| `width`       | output_width           | number?                                              | original width  | Target width (aspect ratio maintained if height omitted) |
+| `height`      | output_height          | number?                                              | original height | Target height (aspect ratio maintained if width omitted) |
+| `method`      | typ_idx                | 'triangular' \| 'catrom' \| 'mitchell' \| 'lanczos3' | 'mitchell'      | Resize algorithm selection                               |
+| `premultiply` | premultiply            | boolean?                                             | false           | Pre-multiply alpha channel before resizing               |
+| `linearRGB`   | color_space_conversion | boolean?                                             | false           | Use linear RGB color space instead of sRGB               |
+
 ## Pro Tips
 
 - **Maintain aspect ratio** - Set only width or height, and the other dimension calculates automatically

package/dist/bridge.browser.mjs

@@ -0,0 +1,4 @@
+import{b as A,c as E,d as B}from"./resize.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 W(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 q(G){let J=W(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=q(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 resize(G,J,K){return B(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("resize.worker")}async resize(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};E(X);let Q=X.data.buffer;A(Q);try{return await S(Y,"resize:run",{image:X,options:J},K,[Q])}catch(Z){throw console.error("Resize error:",Z),Z}}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=1358BB738EBDD58364756E2164756E21

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 Resize 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 { resizeClient } from './resize.worker.ts';\nimport type { ResizeOptions } from './types.ts';\n\ninterface ResizeBridge {\n  resize(\n    image: ImageInput,\n    options: ResizeOptions,\n    signal?: AbortSignal\n  ): Promise<ImageInput>;\n  terminate(): Promise<void>;\n}\n\nclass ResizeClientBridge implements ResizeBridge {\n  async resize(\n    image: ImageInput,\n    options: ResizeOptions,\n    signal?: AbortSignal\n  ): Promise<ImageInput> {\n    return resizeClient(image, options, signal);\n  }\n\n  async terminate(): Promise<void> {\n    // Client mode has nothing to terminate\n  }\n}\n\nclass ResizeWorkerBridge implements ResizeBridge {\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('resize.worker');\n  }\n\n  async resize(\n    image: ImageInput,\n    options: ResizeOptions,\n    signal?: AbortSignal\n  ): Promise<ImageInput> {\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\n    try {\n      const result = await callWorker<\n        { image: ImageInput; options: ResizeOptions },\n        ImageInput\n      >(worker, 'resize:run', { image: normalizedImage, options }, signal, [\n        buffer,\n      ]);\n\n      return result;\n    } catch (error) {\n      console.error('Resize error:', error);\n      throw error;\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'): ResizeBridge {\n  return mode === 'client'\n    ? new ResizeClientBridge()\n    : new ResizeWorkerBridge();\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "1358BB738EBDD58364756E2164756E21",
+  "names": []
+}

package/dist/bridge.bun.js

@@ -0,0 +1,5 @@
+// @bun
+import{b as A,c as E,d as B}from"./resize.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 W(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 q(G){let J=W(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=q(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 resize(G,J,K){return B(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("resize.worker")}async resize(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};E(X);let Q=X.data.buffer;A(Q);try{return await S(Y,"resize:run",{image:X,options:J},K,[Q])}catch(Z){throw console.error("Resize error:",Z),Z}}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=26D9507FE5210F9564756E2164756E21

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 Resize 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 { resizeClient } from './resize.worker.ts';\nimport type { ResizeOptions } from './types.ts';\n\ninterface ResizeBridge {\n  resize(\n    image: ImageInput,\n    options: ResizeOptions,\n    signal?: AbortSignal\n  ): Promise<ImageInput>;\n  terminate(): Promise<void>;\n}\n\nclass ResizeClientBridge implements ResizeBridge {\n  async resize(\n    image: ImageInput,\n    options: ResizeOptions,\n    signal?: AbortSignal\n  ): Promise<ImageInput> {\n    return resizeClient(image, options, signal);\n  }\n\n  async terminate(): Promise<void> {\n    // Client mode has nothing to terminate\n  }\n}\n\nclass ResizeWorkerBridge implements ResizeBridge {\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('resize.worker');\n  }\n\n  async resize(\n    image: ImageInput,\n    options: ResizeOptions,\n    signal?: AbortSignal\n  ): Promise<ImageInput> {\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\n    try {\n      const result = await callWorker<\n        { image: ImageInput; options: ResizeOptions },\n        ImageInput\n      >(worker, 'resize:run', { image: normalizedImage, options }, signal, [\n        buffer,\n      ]);\n\n      return result;\n    } catch (error) {\n      console.error('Resize error:', error);\n      throw error;\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'): ResizeBridge {\n  return mode === 'client'\n    ? new ResizeClientBridge()\n    : new ResizeWorkerBridge();\n}\n"
+  ],
+  "mappings": ";yDAyBO,SAAS,CAAK,EAAY,CAC/B,OAAO,OAAO,IAAQ,ICTxB,IAAI,EAAY,EAYhB,eAAsB,CAA+B,CACnD,EACA,EACA,EACA,EACA,EACoB,CACpB,OAAO,IAAI,QAAmB,CAAC,EAAS,IAAW,CACjD,IAAM,EAAK,EAAE,EAGb,GAAI,GAAQ,QAAS,CACnB,EAAO,IAAI,aAAa,UAAW,YAAY,CAAC,EAChD,OAGF,IAAM,EAAgB,CAAC,IAAwB,CAC7C,IAAM,EAAW,EAAM,KACvB,GAAI,EAAS,KAAO,EAAI,OAIxB,GAFA,EAAQ,EAEJ,EAAS,IAAM,EAAS,OAAS,OACnC,EAAQ,EAAS,IAAI,EAErB,OAAW,MAAM,EAAS,OAAS,sBAAsB,CAAC,GAIxD,EAAc,CAAC,IAAsB,CACzC,EAAQ,EACR,EAAW,MAAM,iBAAiB,EAAM,SAAS,CAAC,GAG9C,EAAc,IAAM,CACxB,EAAQ,EACR,EAAO,IAAI,aAAa,UAAW,YAAY,CAAC,GAG5C,EAAU,IAAM,CACpB,EAAO,oBAAoB,UAAW,CAAa,EACnD,EAAO,oBAAoB,QAAS,CAAW,EAC/C,GAAQ,oBAAoB,QAAS,CAAW,GAIlD,EAAO,iBAAiB,UAAW,CAAa,EAChD,EAAO,iBAAiB,QAAS,CAAW,EAC5C,GAAQ,iBAAiB,QAAS,CAAW,EAG7C,IAAM,EAAmC,CAAE,OAAM,KAAI,SAAQ,EAE7D,GAAI,GAAY,EAAS,OAAS,EAChC,EAAO,YAAY,EAAS,CAAQ,EAEpC,OAAO,YAAY,CAAO,EAE7B,ECrEI,SAAS,CAAY,CAAC,EAA6B,CAExD,IAAM,EAAiB,EAAe,SAAS,KAAK,EAChD,EACA,GAAG,OAIP,GAAI,OAAO,OAAW,IAAa,CAOjC,IAAM,EALwC,CAC5C,iBAAkB,8CAClB,mBAAoB,iDACtB,EAEkC,GAClC,GAAI,EACF,OAAO,IAAI,IAAI,EAAa,OAAO,SAAS,IAAI,EAMpD,IAAM,EAAc,EAAM,EAAI,UAAY,YAOpC,EALsC,CAC1C,iBAAkB,8BAA8B,IAChD,mBAAoB,kCAAkC,GACxD,EAE6B,GAC7B,GAAI,EACF,OAAO,IAAI,IAAI,EAAU,YAAY,GAAG,EAI1C,OAAO,IAAI,IAAI,EAAgB,YAAY,GAAG,EAazC,SAAS,CAAiB,CAAC,EAAgC,CAChE,IAAM,EAAY,EAAa,CAAc,EAE7C,GAAI,CACF,OAAO,IAAI,OAAO,EAAU,KAAM,CAAE,KAAM,QAAS,CAAC,EACpD,MAAO,EAAO,CACd,IAAM,EAAe,aAAiB,MAAQ,EAAM,QAAU,OAAO,CAAK,EAC1E,MAAU,MACR,gCAAgC,MAAc,oFAEnB,IAAiB,EAAe,SAAS,KAAK,EAAI,GAAK,OACpF,GAeG,SAAS,CAAiB,CAC/B,EACA,EAAoB,IACH,CACjB,OAAO,IAAI,QAAQ,CAAC,EAAS,IAAW,CACtC,IAAM,EAAU,WAAW,IAAM,CAC/B,EACM,MACF,uCAAuC,qBAA6B,GACtE,CACF,GACC,CAAS,EAER,EACJ,GAAI,CACF,EAAS,EAAkB,CAAc,EACzC,MAAO,EAAO,CACd,aAAa,CAAO,EACpB,EAAO,CAAK,EACZ,OAGF,IAAM,EAAgB,CAAC,IAAwB,CAC7C,GAAI,EAAM,MAAM,OAAS,eACvB,aAAa,CAAO,EACpB,EAAO,oBAAoB,UAAW,CAAa,EACnD,EAAQ,CAAM,GAIlB,EAAO,iBAAiB,UAAW,CAAa,EAChD,EAAO,YAAY,CAAE,KAAM,aAAc,CAAC,EAC3C,ECvGH,MAAM,CAA2C,MACzC,OAAM,CACV,EACA,EACA,EACqB,CACrB,OAAO,EAAa,EAAO,EAAS,CAAM,OAGtC,UAAS,EAAkB,EAGnC,CAEA,MAAM,CAA2C,CACvC,OAAwB,KACxB,YAAsC,UAEhC,UAAS,EAAoB,CACzC,GAAI,CAAC,KAAK,OAAQ,CAChB,GAAI,CAAC,KAAK,YACR,KAAK,YAAc,KAAK,aAAa,EAEvC,KAAK,OAAS,MAAM,KAAK,YAE3B,OAAO,KAAK,YAGA,aAAY,EAAoB,CAE5C,OAAO,EAAkB,eAAe,OAGpC,OAAM,CACV,EACA,EACA,EACqB,CACrB,IAAM,EAAS,MAAM,KAAK,UAAU,EAGpC,GAAI,CAAC,GAAS,OAAO,IAAU,SAC7B,MAAU,UAAU,yBAAyB,EAG/C,IAAM,EAAc,EACpB,GAAI,CAAC,EAAY,KACf,MAAU,UAAU,wBAAwB,EAE9C,GAAI,EAAY,QAAU,QAAa,EAAY,SAAW,OAC5D,MAAU,UAAU,2CAA2C,EAGjE,IAAM,EAA8B,CAClC,KAAM,EAAY,KAClB,MAAO,EAAY,MACnB,OAAQ,EAAY,MACtB,EAEA,EAAmB,CAAe,EAClC,IAAM,EAAS,EAAgB,KAAK,OACpC,EAAoB,CAAM,EAE1B,GAAI,CAQF,OAPe,MAAM,EAGnB,EAAQ,aAAc,CAAE,MAAO,EAAiB,SAAQ,EAAG,EAAQ,CACnE,CACF,CAAC,EAGD,MAAO,EAAO,CAEd,MADA,QAAQ,MAAM,gBAAiB,CAAK,EAC9B,QAIJ,UAAS,EAAkB,CAC/B,GAAI,KAAK,OACP,KAAK,OAAO,UAAU,EACtB,KAAK,OAAS,KACd,KAAK,YAAc,KAGzB,CAEO,SAAS,CAAY,CAAC,EAAyC,CACpE,OAAO,IAAS,SACZ,IAAI,EACJ,IAAI",
+  "debugId": "26D9507FE5210F9564756E2164756E21",
+  "names": []
+}

package/dist/bridge.d.ts

@@ -4,7 +4,9 @@
 import { type ImageInput } from '@squoosh-kit/runtime';
 import type { ResizeOptions } from './types.ts';
 interface ResizeBridge {
-    resize(signal: AbortSignal, image: ImageInput, options: ResizeOptions): Promise<ImageInput>;
+    resize(image: ImageInput, options: ResizeOptions, signal?: AbortSignal): Promise<ImageInput>;
+    terminate(): Promise<void>;
 }
 export declare function createBridge(mode: 'worker' | 'client'): ResizeBridge;
 export {};
+//# sourceMappingURL=bridge.d.ts.map

package/dist/bridge.d.ts.map

@@ -0,0 +1 @@
+{"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,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,UAAU,YAAY;IACpB,MAAM,CACJ,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,aAAa,EACtB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CAAC;IACvB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAyFD,wBAAgB,YAAY,CAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,YAAY,CAIpE"}

package/dist/bridge.node.cjs

@@ -0,0 +1,3 @@
+var j={};M(j,{createBridge:()=>b});module.exports=C(j);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 W(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 q(G){let J=W(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=q(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 resize(G,J,K){return B(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("resize.worker")}async resize(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};E(X);let Q=X.data.buffer;A(Q);try{return await S(Y,"resize:run",{image:X,options:J},K,[Q])}catch(Z){throw console.error("Resize error:",Z),Z}}async terminate(){if(this.worker)this.worker.terminate(),this.worker=null,this.workerReady=null}}function b(G){return G==="client"?new P:new I}
+
+//# debugId=814DE931A95A6D5D64756E2164756E21