@keeratita/heic-converter 0.4.2 → 0.5.0

package/dist/index.d.ts

@@ -1,8 +1,59 @@
 interface DecodedImage {
     width: number;
     height: number;
+    /**
+     * RGBA pixel data, interleaved, row-major, 4 bytes per pixel.
+     *
+     * The buffer is always a plain `ArrayBuffer` owned by the returned array
+     * (never a view into the WASM heap), so it stays valid after
+     * `LibheifDecoder.free()` and can be passed directly to
+     * `new ImageData(...)` / `putImageData` — including the `ImageData`
+     * overload that requires `Uint8ClampedArray<ArrayBuffer>` under TS >= 5.7.
+     */
     data: Uint8ClampedArray;
+    /**
+     * Raw EXIF block copied from the source file, normalized to the JPEG APP1
+     * payload form: `"Exif\0\0"` followed by the TIFF structure. Present when
+     * the file carries an Exif item — including files where libheif already
+     * applied `irot`/`imir` (the block is reported independently of
+     * {@link DecodedImage.orientation}).
+     *
+     * `convertHeic` re-injects this block into JPEG (APP1) and PNG (`eXIf`)
+     * output when `preserveExif: true`; raw-decode consumers can attach it to
+     * their own encoder output (e.g. `sharp`'s `.withMetadata({ exif })`).
+     * Owned by the returned object; never a WASM-heap view.
+     */
+    exif?: Uint8Array;
+    /**
+     * EXIF orientation of the **stored** pixels (1–8, EXIF tag 274 semantics;
+     * 1 = upright). Absent or 1 means no rotation is pending.
+     *
+     * libheif already applies `irot`/`imir` container transforms during
+     * decode — for those files this is 1 and the pixels are upright. A value
+     * > 1 means the orientation comes only from the Exif item: `convertHeic`
+     * applies it automatically (unless `applyOrientation: false`), while raw
+     * `decode()` consumers get stored pixels and must apply it themselves.
+     * Decoders that do not report orientation may omit this field.
+     */
+    orientation?: number;
 }
+/**
+ * Decoder contract used by {@link ConvertOptions.decoder} /
+ * {@link ConvertManyOptions.decoder} and implemented by `LibheifDecoder`.
+ *
+ * Lifecycle rules followed by the library (implementations may rely on them):
+ * - `initialize()` is called before every `decode()`; implementations must
+ *   make repeated/concurrent calls cheap (e.g. memoize the load promise).
+ * - `decode()` is awaited before the library calls `free()`; the returned
+ *   `DecodedImage` must therefore not reference decoder-owned memory that
+ *   `free()` releases (copy pixels out, as `LibheifDecoder` does).
+ * - `free()` is called at most once per conversion. Decoders **injected** via
+ *   options are never freed by the library — the caller owns their lifetime.
+ *
+ * Concurrency: with `convertMany`, a single injected decoder is shared by
+ * all concurrent conversions, so `decode()` must be safe to call concurrently
+ * on one instance (no shared mutable state across in-flight decodes).
+ */
 interface IHeicDecoder {
     /**
      * Initializes the decoder (e.g., loading WebAssembly module).
@@ -15,12 +66,51 @@ interface IHeicDecoder {
      */
     decode(data: Uint8Array, onProgress?: (percent: number) => void): Promise<DecodedImage>;
     /**
-     * Cleans up allocated resources.
+     * Cleans up allocated resources. Idempotent: safe to call multiple times.
      */
     free(): void;
 }
-type ImageFormat = 'jpeg' | 'jpg' | 'png' | 'svg' | 'webp';
+type ImageFormat = 'jpeg' | 'jpg' | 'png' | 'svg' | 'webp' | 'avif';
+/**
+ * Formats accepted by {@link ConvertOptions.to} (case-insensitive).
+ * `'jpg'` is an alias of `'jpeg'`. `'avif'` requires an environment whose
+ * canvas can encode AVIF (Chromium/Firefox today); elsewhere it rejects with
+ * `format_unsupported`.
+ */
+declare const SUPPORTED_FORMATS: readonly ImageFormat[];
+/** Default JPEG/WebP encoding quality used when `quality` is not provided. */
+declare const DEFAULT_QUALITY = 0.92;
 type HeicInput = Blob | File | ArrayBuffer | Uint8Array;
+/**
+ * How {@link convertHeic} returns the converted image.
+ * - `'blob'` — a `Blob` (the default; browser-native, works everywhere)
+ * - `'dataUrl'` — a `data:image/...;base64,…` string (previews, `<img src>`)
+ * - `'arrayBuffer'` — raw bytes (uploads, WebCodecs, Node-friendly transfer)
+ */
+type OutputShape = 'blob' | 'dataUrl' | 'arrayBuffer';
+/** Resolved return type of `convertHeic`/`convertMany` for an output shape. */
+type ConvertResult<S extends OutputShape> = S extends 'dataUrl' ? string : S extends 'arrayBuffer' ? ArrayBuffer : Blob;
+/** Crop rectangle in **post-orientation display pixels** (top-left origin). */
+interface CropOptions {
+    /** Left edge of the crop box. @default 0 */
+    x?: number;
+    /** Top edge of the crop box. @default 0 */
+    y?: number;
+    /** Crop width in pixels. Must be a positive integer and fit inside the image. */
+    width: number;
+    /** Crop height in pixels. Must be a positive integer and fit inside the image. */
+    height: number;
+}
+/** Per-item outcome when `continueOnError: true`. */
+type ConvertItemResult<T = Blob> = {
+    index: number;
+    ok: true;
+    result: T;
+} | {
+    index: number;
+    ok: false;
+    error: Error;
+};
 interface ResizeOptions {
     /**
      * Maximum width in pixels. The image is downscaled to fit within this
@@ -42,25 +132,70 @@ interface ResizeOptions {
 }
 interface ConvertOptions extends ResizeOptions {
     /**
-     * Target format for the conversion.
+     * Target format for the conversion. Must be one of the values in
+     * {@link SUPPORTED_FORMATS}; an unknown value is rejected up front,
+     * before the input is decoded.
      * @default 'jpeg'
      */
     to?: ImageFormat;
     /**
-     * Quality of the converted image (between 0.0 and 1.0).
-     * Applicable for 'jpeg', 'jpg', and 'webp' formats.
+     * Quality of the converted image, between 0.0 and 1.0 (inclusive).
+     * Applicable for 'jpeg', 'jpg', 'webp', and 'avif' formats — but validated
+     * for every format: passing an out-of-range value (e.g. `90` from a 0-100
+     * scale) throws regardless of `to`.
      * @default 0.92
      */
     quality?: number;
     /**
      * Optional custom decoder implementation to inject.
      * If not provided, a default LibheifDecoder is used.
+     * The library never calls `free()` on an injected decoder.
      */
     decoder?: IHeicDecoder;
     /**
-     * Optional progress callback that receives the progress percentage (0 to 100) during decoding.
+     * Optional progress callback that receives the progress percentage during
+     * decoding. Values are normalized and clamped to the range 0 to 100; the
+     * final 100% is emitted only when the conversion succeeds. A callback that
+     * throws rejects the conversion with `progress_callback_failed`.
      */
     onProgress?: (percent: number) => void;
+    /**
+     * Rotate/flip the output so it matches the source's EXIF orientation
+     * (applied as a canvas transform during rendering; `irot`/`imir` container
+     * transforms are already applied by the decoder and never stacked on top).
+     * Set `false` to keep the exact stored-pixel geometry. A non-boolean value
+     * is rejected up front with `invalid_input`.
+     * @default true
+     */
+    applyOrientation?: boolean;
+    /**
+     * Representation of the converted image. See {@link OutputShape}.
+     * @default 'blob'
+     */
+    output?: OutputShape;
+    /**
+     * AbortSignal that cancels the conversion. Cancellation is checked at
+     * stage boundaries (input read, decoder init, before/after decode,
+     * before encode) and aborts `convertHeicInWorker` calls immediately by
+     * terminating the worker; the synchronous WASM decode itself cannot be
+     * preempted mid-call. An aborted signal rejects with code `aborted`.
+     */
+    signal?: AbortSignal;
+    /**
+     * Crop rectangle in post-orientation display pixels (the geometry the
+     * image will be displayed in). Applied before resize: `scale`/`maxWidth`/
+     * `maxHeight` then downscale the cropped region. Out-of-bounds crops
+     * reject with `invalid_crop`.
+     */
+    crop?: CropOptions;
+    /**
+     * Copy the source HEIC's EXIF block into JPEG (APP1) and PNG (`eXIf`
+     * chunk) output so converted files keep camera metadata (orientation,
+     * GPS, timestamps). Note this **preserves private data** like GPS — set
+     * deliberately. Ignored for `webp`/`svg` output.
+     * @default false
+     */
+    preserveExif?: boolean;
 }
 interface ConvertManyOptions extends Omit<ConvertOptions, 'onProgress'> {
     /**
@@ -69,17 +204,36 @@ interface ConvertManyOptions extends Omit<ConvertOptions, 'onProgress'> {
      */
     concurrency?: number;
     /**
-     * Optional progress callback that receives the item index and its
-     * progress percentage (0 to 100) during decoding.
+     * Optional progress callback that receives the item index (0-based) and
+     * its progress percentage (normalized to 0 to 100) during decoding.
      */
     onProgress?: (index: number, percent: number) => void;
     /**
      * Optional custom decoder implementation to inject. When provided, the
      * same instance is shared by all concurrent conversions, so it must be
-     * safe for concurrent `decode()` calls. If not provided, a fresh
-     * default LibheifDecoder is created per item.
+     * safe for concurrent `decode()` calls (see {@link IHeicDecoder}). If not
+     * provided, a fresh default LibheifDecoder is created per item.
      */
     decoder?: IHeicDecoder;
+    /**
+     * Resolve with per-item results instead of rejecting the whole batch on
+     * the first failure: the promise fulfills with `ConvertItemResult[]` in
+     * input order, each item `{ index, ok: true, result }` or
+     * `{ index, ok: false, error }`. All items always run to completion.
+     * Up-front option validation failures still reject normally (a typo is a
+     * caller bug, not an item failure).
+     * @default false
+     */
+    continueOnError?: boolean;
+    /**
+     * Reuse one library-owned `LibheifDecoder` per concurrent runner across
+     * items instead of creating (and WASM-initializing) a fresh instance per
+     * item — amortizes the module load in large batches while preserving the
+     * exclusive-use invariant (an instance is only ever held by one runner,
+     * never decodes concurrently). Ignored when `decoder` is injected.
+     * @default false
+     */
+    reuseDecoders?: boolean;
 }
 
 interface LibheifDecoderOptions {
@@ -90,9 +244,18 @@ interface LibheifDecoderOptions {
     locateFile?: (path: string, prefix: string) => string;
     /**
      * Raw WASM binary buffer. If provided, the library will use this buffer
-     * directly instead of attempting to fetch the WASM file.
+     * directly instead of attempting to fetch the WASM file. Accepts an
+     * `ArrayBuffer` or any `ArrayBufferView` (e.g. a Node.js `Buffer` from
+     * `fs.readFileSync`).
+     */
+    wasmBinary?: ArrayBuffer | ArrayBufferView;
+    /**
+     * Advanced: extra properties merged into the Emscripten module argument
+     * object (e.g. `instantiateWasm` for streaming compilation). Prefer
+     * `locateFile`/`wasmBinary` for the common cases; keys provided here must
+     * not collide with them.
      */
-    wasmBinary?: ArrayBuffer;
+    moduleOverrides?: Record<string, unknown>;
 }
 declare class LibheifDecoder implements IHeicDecoder {
     private options?;
@@ -101,8 +264,15 @@ declare class LibheifDecoder implements IHeicDecoder {
     /**
      * Memoized module-loading promise so concurrent initialize()/decode() calls
      * on the same instance never instantiate (or mutate) the module twice.
+     * Resolves null when a concurrent free() discarded the freshly created
+     * instance (see initGeneration).
      */
     private initPromise;
+    /**
+     * Generation counter for init/free races: a load that finishes after a
+     * concurrent free() must not resurrect module/decoderInstance.
+     */
+    private initGeneration;
     constructor(options?: LibheifDecoderOptions);
     /**
      * Initializes the WebAssembly module and instantiates the HEIC decoder.
@@ -112,18 +282,23 @@ declare class LibheifDecoder implements IHeicDecoder {
     /**
      * Decodes HEIC binary data into raw RGBA pixel data.
      * @param data The HEIC file contents as a Uint8Array.
-     * @param onProgress Optional progress callback.
+     * @param onProgress Optional progress callback (receives a normalized
+     * percentage clamped to 0-100).
      */
     decode(data: Uint8Array, onProgress?: (percent: number) => void): Promise<DecodedImage>;
     /**
      * Cleans up the WebAssembly decoder instance and resources.
-     * Idempotent: safe to call multiple times. After free(), the instance must
-     * be re-initialized (createHeicDecoderModule runs again on the next call).
+     * Idempotent: safe to call multiple times. After free(), the next
+     * initialize() — or decode() directly, which re-initializes transparently
+     * — loads a fresh module.
+     *
+     * free() is also safe to call while initialize() is in flight: a load that
+     * completes after free() discards its fresh instance instead of leaking it.
      */
     free(): void;
 }
 
-interface WorkerConvertOptions extends ConvertOptions {
+interface WorkerConvertOptions extends Omit<ConvertOptions, 'decoder'> {
     /**
      * URL of the worker script that performs the conversion. Should be a
      * compile-time constant (e.g. `new URL('./worker.js', import.meta.url)`
@@ -132,8 +307,8 @@ interface WorkerConvertOptions extends ConvertOptions {
     workerUrl: string | URL;
     /**
      * Maximum time in milliseconds to wait for the worker result before
-     * rejecting with a timeout. Defaults to 60000 (60s). Set to 0 to
-     * disable the timeout.
+     * rejecting with a timeout (queueing for a free worker slot counts toward
+     * this). Defaults to 60000 (60s). Set to 0 to disable the timeout.
      */
     timeoutMs?: number;
     /**
@@ -143,16 +318,44 @@ interface WorkerConvertOptions extends ConvertOptions {
      * @default 'classic'
      */
     workerType?: 'classic' | 'module';
+    /**
+     * Upper bound on simultaneously live workers for this worker script.
+     * Calls beyond the bound queue until a slot frees, which keeps bulk
+     * conversions (`inputs.map(i => convertHeicInWorker(i, …))`) from
+     * exhausting memory or the browser's worker limit.
+     * Defaults to `navigator.hardwareConcurrency` clamped to 1–8.
+     */
+    maxConcurrentWorkers?: number;
+}
+/** Progress message a worker script posts to report decode progress. */
+interface WorkerProgressMessage {
+    type: 'progress';
+    percent: number;
+}
+/** Result message a worker script posts to settle a conversion. */
+interface WorkerResultMessage {
+    type: 'result';
+    ok: boolean;
+    /**
+     * The converted image exactly as `convertHeic` returned it inside the
+     * worker: a Blob, a data-URL string (`output: 'dataUrl'`), or an
+     * ArrayBuffer (`output: 'arrayBuffer'`). The field name `blob` is kept
+     * for protocol compatibility.
+     */
+    blob?: Blob | string | ArrayBuffer;
+    error?: string;
 }
 /**
  * Converts a HEIC image inside a Web Worker so the main thread stays
  * responsive during the (potentially slow) WASM decode.
  *
  * The worker script is user-provided and must handle the following message
- * protocol:
+ * protocol (types are exported as {@link WorkerProgressMessage} and
+ * {@link WorkerResultMessage}):
  *
  * ```js
- * // converter.worker.js
+ * // converter.worker.js — keep in sync with docs/worker.js,
+ * // test/browser/worker.js, and this JSDoc example.
  * import { convertHeic } from '@keeratita/heic-converter';
  *
  * self.onmessage = async (event) => {
@@ -178,15 +381,106 @@ interface WorkerConvertOptions extends ConvertOptions {
  * ```
  *
  * Only `progress` and `result` messages are understood; any other message
- * type is ignored. Use `workerType: 'module'` when the script uses ES
- * module imports (as in the example above); `'classic'` scripts must be
+ * type is ignored (the first unknown type is reported in the timeout
+ * diagnostic). Use `workerType: 'module'` when the script uses ES module
+ * imports (as in the example above); `'classic'` scripts must be
  * pre-bundled, since static ES imports are not supported there.
  *
+ * The `decoder` option is rejected: class instances cannot cross the
+ * worker boundary; the worker creates its own decoder.
+ *
  * @param input HEIC image as a Blob, File, ArrayBuffer, or Uint8Array.
  * @param options Conversion options plus the worker script URL.
- * @returns A Promise resolving to the converted image as a Blob.
+ * @returns The converted image as a Blob, data URL string, or ArrayBuffer
+ *   depending on `options.output` (default Blob).
  */
-declare function convertHeicInWorker(input: HeicInput, options: WorkerConvertOptions): Promise<Blob>;
+declare function convertHeicInWorker<S extends OutputShape = 'blob'>(input: HeicInput, options: WorkerConvertOptions & {
+    output?: S;
+}): Promise<ConvertResult<S>>;
+/**
+ * Options for {@link convertManyInWorker}: the {@link convertHeicInWorker}
+ * worker options plus the batch semantics of `convertMany`.
+ */
+interface WorkerBatchOptions extends Omit<WorkerConvertOptions, 'onProgress'> {
+    /**
+     * Per-item progress callback: receives the 0-based item index and its
+     * progress percentage (normalized 0–100). Fires only for successful items.
+     */
+    onProgress?: (index: number, percent: number) => void;
+    /**
+     * Resolve with per-item results instead of rejecting the batch on the
+     * first failure; all items run to completion (see
+     * `ConvertManyOptions.continueOnError`).
+     * @default false
+     */
+    continueOnError?: boolean;
+}
+/**
+ * Converts multiple HEIC images inside Web Workers, mirroring
+ * {@link convertMany} semantics (input order, bounded concurrency,
+ * `batch_item_failed` aggregation or `continueOnError` per-item results).
+ * Concurrency is bounded by `maxConcurrentWorkers` (default
+ * `navigator.hardwareConcurrency` clamped to 1–8): items queue behind the
+ * worker semaphore, so a large batch never exhausts memory or the browser's
+ * worker limit. Each item runs in its own worker instance via
+ * {@link convertHeicInWorker}, which means `decoder` cannot be injected and
+ * `workerUrl` is required.
+ *
+ * ```ts
+ * const blobs = await convertManyInWorker(heicFiles, {
+ *   workerUrl: new URL('./converter.worker.js', import.meta.url),
+ *   workerType: 'module',
+ *   to: 'webp',
+ *   continueOnError: true, // get per-item results instead of batch rejection
+ * });
+ * ```
+ *
+ * @param inputs HEIC images as Blobs, Files, ArrayBuffers, or Uint8Arrays.
+ * @param options Batch + worker conversion options (see {@link WorkerBatchOptions}).
+ * @returns The converted images in input order, or per-item result entries
+ *   when `continueOnError: true`.
+ */
+declare function convertManyInWorker<S extends OutputShape = 'blob'>(inputs: HeicInput[], options: WorkerBatchOptions & {
+    output?: S;
+    continueOnError: true;
+}): Promise<ConvertItemResult<ConvertResult<S>>[]>;
+declare function convertManyInWorker<S extends OutputShape = 'blob'>(inputs: HeicInput[], options: WorkerBatchOptions & {
+    output?: S;
+    continueOnError?: false;
+}): Promise<ConvertResult<S>[]>;
+declare function convertManyInWorker<S extends OutputShape = 'blob'>(inputs: HeicInput[], options: WorkerBatchOptions & {
+    output?: S;
+    continueOnError: boolean;
+}): Promise<Array<ConvertResult<S> | ConvertItemResult<ConvertResult<S>>>>;
+
+/**
+ * Stable, machine-readable error codes attached to every error the library
+ * throws (as `HeicConverterError.code`). Codes are part of the public API:
+ * they are additive-only and never repurposed, so callers can branch on
+ * `error.code` instead of matching on message strings.
+ */
+type HeicConverterErrorCode = 'invalid_input' | 'invalid_quality' | 'invalid_resize' | 'invalid_format' | 'invalid_crop' | 'invalid_concurrency' | 'decoder_init_failed' | 'decode_failed' | 'progress_callback_failed' | 'render_encode_failed' | 'unsupported_environment' | 'format_unsupported' | 'aborted' | 'worker_unsupported' | 'worker_create_failed' | 'worker_post_failed' | 'worker_failed' | 'worker_timeout' | 'batch_item_failed';
+/**
+ * Error thrown by all first-party code paths. Extends `Error` so existing
+ * `instanceof Error` / message-based handling keeps working; the `code`
+ * (and, for batch failures, `itemIndex`/`itemTotal`/`failedCount`) fields
+ * add a structured discriminator without changing message text.
+ */
+declare class HeicConverterError extends Error {
+    readonly code: HeicConverterErrorCode;
+    /** 0-based index of the failing input. Only set on `batch_item_failed` errors. */
+    readonly itemIndex?: number;
+    /** Total number of inputs in the batch. Only set on `batch_item_failed` errors. */
+    readonly itemTotal?: number;
+    /** How many items failed overall. Only set on `batch_item_failed` errors. */
+    readonly failedCount?: number;
+    constructor(code: HeicConverterErrorCode, message: string, options?: {
+        cause?: unknown;
+        itemIndex?: number;
+        itemTotal?: number;
+        failedCount?: number;
+    });
+}
 
 /**
  * Releases any cached decoder resources.
@@ -196,26 +490,57 @@ declare function convertHeicInWorker(input: HeicInput, options: WorkerConvertOpt
  */
 declare function freeSharedDecoder(): void;
 /**
- * Converts HEIC image data to a standard web format (JPEG, PNG, WebP, or SVG).
+ * Converts HEIC image data to a standard web format (JPEG, PNG, WebP, AVIF,
+ * or SVG).
  *
  * @param input HEIC image as a Blob, File, ArrayBuffer, or Uint8Array.
- * @param options Conversion configuration options.
- * @returns A Promise resolving to the converted image as a Blob.
+ * @param options Conversion configuration options (see {@link ConvertOptions}).
+ * @returns The converted image as a Blob, data URL string, or ArrayBuffer
+ *   depending on `options.output` (default Blob).
+ * @throws HeicConverterError with a machine-readable `code`:
+ *   `invalid_input` (unsupported input type or option value),
+ *   `invalid_quality`, `invalid_resize`, `invalid_crop`,
+ *   `invalid_format` (unknown `to` value), `decoder_init_failed` (WASM
+ *   module could not load), `decode_failed` (invalid/corrupt HEIC),
+ *   `unsupported_environment` (no canvas APIs — e.g. Node.js, where raw RGBA
+ *   decoding via `LibheifDecoder` is the supported path),
+ *   `format_unsupported` (environment cannot encode the format, e.g. AVIF
+ *   in Safari), `aborted` (`options.signal` aborted), or
+ *   `render_encode_failed`.
  */
-declare function convertHeic(input: HeicInput, options?: ConvertOptions): Promise<Blob>;
+declare function convertHeic<S extends OutputShape = 'blob'>(input: HeicInput, options?: ConvertOptions & {
+    output?: S;
+}): Promise<ConvertResult<S>>;
 /**
  * Converts multiple HEIC images to a standard web format.
  *
  * Conversions run with a bounded concurrency (default 4) and results are
- * returned in the same order as the inputs. If any conversion fails, the
- * returned promise rejects as soon as the failure is known (in-flight
- * conversions are allowed to finish in the background) with an error that
- * identifies the failing item index.
+ * returned in the same order as the inputs. By default, if any conversion
+ * fails, the returned promise rejects as soon as the failure is known
+ * (in-flight conversions are allowed to finish in the background) with a
+ * `batch_item_failed` HeicConverterError carrying `itemIndex`, `itemTotal`,
+ * and `failedCount` — a batch is all-or-nothing. With
+ * `options.continueOnError: true` the promise instead fulfills with
+ * per-item `ConvertItemResult` entries and all items run to completion
+ * (a mid-batch abort completes not-yet-started items with `aborted`
+ * entries instead of launching them).
  *
  * @param inputs HEIC images as Blobs, Files, ArrayBuffers, or Uint8Arrays.
- * @param options Batch conversion options.
- * @returns A Promise resolving to the converted images as Blobs, in input order.
+ * @param options Batch conversion options (see {@link ConvertManyOptions}).
+ * @returns The converted images in input order: results array by default,
+ *   or per-item result entries when `continueOnError: true`.
  */
-declare function convertMany(inputs: HeicInput[], options?: ConvertManyOptions): Promise<Blob[]>;
+declare function convertMany<S extends OutputShape = 'blob'>(inputs: HeicInput[], options: ConvertManyOptions & {
+    output?: S;
+    continueOnError: true;
+}): Promise<ConvertItemResult<ConvertResult<S>>[]>;
+declare function convertMany<S extends OutputShape = 'blob'>(inputs: HeicInput[], options?: ConvertManyOptions & {
+    output?: S;
+    continueOnError?: false;
+}): Promise<ConvertResult<S>[]>;
+declare function convertMany<S extends OutputShape = 'blob'>(inputs: HeicInput[], options: ConvertManyOptions & {
+    output?: S;
+    continueOnError: boolean;
+}): Promise<Array<ConvertResult<S> | ConvertItemResult<ConvertResult<S>>>>;
 
-export { type ConvertManyOptions, type ConvertOptions, type DecodedImage, type HeicInput, type IHeicDecoder, type ImageFormat, LibheifDecoder, type LibheifDecoderOptions, type ResizeOptions, type WorkerConvertOptions, convertHeic, convertHeicInWorker, convertMany, freeSharedDecoder };
+export { type ConvertItemResult, type ConvertManyOptions, type ConvertOptions, type ConvertResult, type CropOptions, DEFAULT_QUALITY, type DecodedImage, HeicConverterError, type HeicConverterErrorCode, type HeicInput, type IHeicDecoder, type ImageFormat, LibheifDecoder, type LibheifDecoderOptions, type OutputShape, type ResizeOptions, SUPPORTED_FORMATS, type WorkerBatchOptions, type WorkerConvertOptions, type WorkerProgressMessage, type WorkerResultMessage, convertHeic, convertHeicInWorker, convertMany, convertManyInWorker, freeSharedDecoder };

package/dist/index.js

@@ -1,3 +1,3 @@
-'use strict';var i={QualityInvalid:e=>`Quality must be a number between 0.0 and 1.0, got: ${e}`,UnsupportedInputType:e=>`Unsupported input type. Expected Blob, File, ArrayBuffer, or Uint8Array. Got: ${e}`,DecoderInitFailed:e=>`Failed to initialize HEIC decoder: ${e}`,RenderEncodeFailed:(e,r)=>`Failed to render and encode image as ${e}: ${r}`,ConcurrencyInvalid:e=>`Concurrency must be a positive integer, got: ${e}`,ScaleInvalid:e=>`Scale must be a positive finite number, got: ${e}`,MaxWidthInvalid:e=>`maxWidth must be a positive finite number, got: ${e}`,MaxHeightInvalid:e=>`maxHeight must be a positive finite number, got: ${e}`,TargetSizeTooLarge:(e,r,n)=>`Target image size ${e}x${r} exceeds the maximum supported dimension of ${n}px`,BlobToBase64Failed:"Failed to convert Blob to base64 string",BlobToBase64FailedWithCause:e=>`Failed to convert Blob to base64 string: ${e}`,CanvasToBlobFailed:e=>`Failed to convert canvas to blob (type: ${e})`,CanvasUnsupported:"Canvas is not supported in the current environment. Conversion requires a browser environment or canvas polyfills.",InvalidDimensions:(e,r)=>`Invalid image dimensions: ${e}x${r}. Width and height must be positive integers.`,DataLengthMismatch:(e,r,n,t)=>`Image data length mismatch. Expected ${e} bytes for ${r}x${n}, got ${t}`,ContextUnavailable:"Failed to acquire 2D rendering context from canvas",UnsupportedFormat:e=>`Unsupported output format: ${e}`,DecodeFailed:"HEIC decoding failed",DecodeFailedWithDetail:e=>`HEIC decoding failed: ${e}`,WorkerUnsupported:"Web Worker is not supported in the current environment",WorkerCreateFailed:e=>`Failed to create Web Worker: ${e}`,WorkerPostFailed:e=>`Failed to post message to Web Worker: ${e}`,WorkerConversionFailed:"Worker conversion failed",WorkerFailed:"Worker failed",WorkerTimeout:"Web Worker conversion timed out",InputsMustBeArray:"Inputs must be an array of HEIC images",ConvertManyItemFailed:(e,r,n)=>`Conversion of item ${e} of ${r} failed: ${n}`};var y=class{options;module=null;decoderInstance=null;initPromise=null;constructor(r){this.options=r;}async initialize(){if(!this.initPromise){let r={};this.options?.locateFile&&(r.locateFile=this.options.locateFile),this.options?.wasmBinary&&(r.wasmBinary=this.options.wasmBinary),this.initPromise=import('./heic-decoder-L3ME46HT.js').then(({default:n})=>n(r)).then(n=>(this.module=n,this.decoderInstance=new n.HeicDecoder,n)).catch(n=>{throw this.initPromise=null,n});}await this.initPromise;}async decode(r,n){(!this.module||!this.decoderInstance)&&await this.initialize();let t=this.decoderInstance.decode(r,n??null);if(!t)throw new Error(i.DecodeFailed);if(typeof t=="string")throw new Error(i.DecodeFailedWithDetail(t));let o=t.width,a=t.height,s=new Uint8ClampedArray(t.data);return {width:o,height:a,data:s}}free(){this.decoderInstance&&(this.decoderInstance.delete(),this.decoderInstance=null),this.module=null,this.initPromise=null;}};var E=16384;function C(e){if(!e)return;let{maxWidth:r,maxHeight:n,scale:t}=e;if(t!==void 0&&(typeof t!="number"||!Number.isFinite(t)||t<=0))throw new Error(i.ScaleInvalid(t));if(r!==void 0&&(typeof r!="number"||!Number.isFinite(r)||r<=0))throw new Error(i.MaxWidthInvalid(r));if(n!==void 0&&(typeof n!="number"||!Number.isFinite(n)||n<=0))throw new Error(i.MaxHeightInvalid(n))}function B(e,r,n){if(C(n),!n)return {width:e,height:r};let{maxWidth:t,maxHeight:o,scale:a}=n;if(a!==void 0){let g=Math.max(1,Math.round(e*a)),c=Math.max(1,Math.round(r*a));return F(g,c),{width:g,height:c}}if(t===void 0&&o===void 0)return {width:e,height:r};let s=Math.min(t!==void 0?t/e:Number.POSITIVE_INFINITY,o!==void 0?o/r:Number.POSITIVE_INFINITY);if(s>=1)return {width:e,height:r};let l=Math.min(Math.max(1,Math.round(e*s)),t!==void 0?Math.floor(t):Number.POSITIVE_INFINITY),d=Math.min(Math.max(1,Math.round(r*s)),o!==void 0?Math.floor(o):Number.POSITIVE_INFINITY);return F(l,d),{width:l,height:d}}function F(e,r){if(!Number.isFinite(e)||!Number.isFinite(r)||e>E||r>E)throw new Error(i.TargetSizeTooLarge(e,r,E))}async function W(e){if(typeof FileReader<"u")return new Promise((r,n)=>{let t=new FileReader;t.onloadend=()=>{typeof t.result=="string"?r(t.result):n(new Error(i.BlobToBase64Failed));},t.onerror=()=>n(t.error),t.readAsDataURL(e);});try{let r=await e.arrayBuffer(),n=new Uint8Array(r),t="",o=32768;for(let s=0;s<n.length;s+=o)t+=String.fromCharCode(...n.subarray(s,s+o));let a=btoa(t);return `data:${e.type};base64,${a}`}catch(r){throw new Error(i.BlobToBase64FailedWithCause(r instanceof Error?r.message:String(r)),{cause:r})}}function I(e,r,n){return "convertToBlob"in e?e.convertToBlob({type:r,quality:n}):new Promise((t,o)=>{e.toBlob(a=>{a?t(a):o(new Error(i.CanvasToBlobFailed(r)));},r,n);})}function M(e,r){if(typeof OffscreenCanvas<"u")return new OffscreenCanvas(e,r);if(typeof document<"u"){let n=document.createElement("canvas");return n.width=e,n.height=r,n}throw new Error(i.CanvasUnsupported)}function T(e){typeof e.close=="function"?e.close():e.width=0;}function D(e,r,n,t){if(typeof ImageData<"u")e.putImageData(new ImageData(r,n,t),0,0);else {let o=e.createImageData(n,t);o.data.set(r),e.putImageData(o,0,0);}}async function x(e,r,n,t){let{width:o,height:a,data:s}=e;if(!Number.isInteger(o)||o<=0||!Number.isInteger(a)||a<=0)throw new Error(i.InvalidDimensions(o,a));let l=o*a*4;if(s.length!==l)throw new Error(i.DataLengthMismatch(l,o,a,s.length));let d=B(o,a,t),g=d.width!==o||d.height!==a,c=M(d.width,d.height),m=c.getContext("2d");if(!m)throw new Error(i.ContextUnavailable);if(g){let w=M(o,a),f=w.getContext("2d");if(!f)throw new Error(i.ContextUnavailable);D(f,s,o,a),m.drawImage(w,0,0,d.width,d.height),T(w);}else D(m,s,o,a);let p=r.toLowerCase();if(p==="png")return I(c,"image/png");if(p==="jpeg"||p==="jpg")return I(c,"image/jpeg",n);if(p==="webp")return I(c,"image/webp",n);if(p==="svg"){let w=await I(c,"image/png"),f=await W(w),b=`<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 ${d.width} ${d.height}" width="${d.width}" height="${d.height}">
-  <image width="${d.width}" height="${d.height}" href="${f}" />
-</svg>`;return new Blob([b],{type:"image/svg+xml"})}else throw new Error(i.UnsupportedFormat(r))}function $(e,r){return new Promise((n,t)=>{if(typeof Worker>"u"){t(new Error(i.WorkerUnsupported));return}let o;try{o=new Worker(r.workerUrl,r.workerType==="module"?{type:"module"}:void 0);}catch(u){t(new Error(i.WorkerCreateFailed(u instanceof Error?u.message:String(u)),{cause:u}));return}let a=r.timeoutMs??6e4,s;a>0&&(s=setTimeout(()=>{c(),t(new Error(i.WorkerTimeout));},a));let l=u=>{let h=u.data;if(h?.type==="progress"){try{let v=Number(h.percent);r.onProgress?.(Number.isFinite(v)?Math.min(100,Math.max(0,v)):0);}catch(v){c(),t(v instanceof Error?v:new Error(String(v)));}return}h?.type==="result"&&(c(),h.ok&&h.blob?n(h.blob):t(new Error(h.error??i.WorkerConversionFailed)));},d=u=>{c();let h=u.filename?` (${u.filename}:${u.lineno})`:"";t(new Error(`${u.message||i.WorkerFailed}${h}`));},g=u=>{c();let h=u.data;t(h instanceof Error?h:new Error(h!==void 0?String(h):i.WorkerFailed));},c=()=>{s!==void 0&&clearTimeout(s),o.removeEventListener("message",l),o.removeEventListener("messageerror",g),o.removeEventListener("error",d),o.terminate();};o.addEventListener("message",l),o.addEventListener("messageerror",g),o.addEventListener("error",d);let{workerUrl:m,decoder:p,onProgress:w,timeoutMs:f,workerType:b,...k}=r;try{o.postMessage({input:e,options:k});}catch(u){c(),t(new Error(i.WorkerPostFailed(u instanceof Error?u.message:String(u)),{cause:u}));}})}function Q(){}function O(e){if(typeof e!="number"||Number.isNaN(e)||e<0||e>1)throw new Error(i.QualityInvalid(e))}async function H(e,r){r?.quality!==void 0&&O(r.quality);let n=r?.maxWidth!==void 0||r?.maxHeight!==void 0||r?.scale!==void 0?r:void 0;C(n);let t;if(e instanceof Uint8Array)t=e;else if(e instanceof ArrayBuffer)t=new Uint8Array(e);else if(typeof Blob<"u"&&e instanceof Blob){let d=await e.arrayBuffer();t=new Uint8Array(d);}else throw new Error(i.UnsupportedInputType(Object.prototype.toString.call(e)));let o=r?.decoder??new y,a=!r?.decoder,s=false,l=()=>{if(!(!a||s)){s=true;try{o.free();}catch{}}};try{try{await o.initialize();}catch(m){throw new Error(i.DecoderInitFailed(m instanceof Error?m.message:String(m)),{cause:m})}let d=await o.decode(t,r?.onProgress);l();let g=r?.to||"jpeg",c=r?.quality!==void 0?r.quality:.92;try{return n?await x(d,g,c,n):await x(d,g,c)}catch(m){throw new Error(i.RenderEncodeFailed(g,m instanceof Error?m.message:String(m)),{cause:m})}}finally{l();}}async function Y(e,r){if(!Array.isArray(e))throw new Error(i.InputsMustBeArray);let n=r?.concurrency??4;if(!Number.isInteger(n)||n<1)throw new Error(i.ConcurrencyInvalid(n));let t=new Array(e.length),o=r?.onProgress,a=0,s=false,l=null,d=-1,g,c=new Promise(f=>{g=f;}),m=async()=>{for(;!s;){let f=a;if(a+=1,f>=e.length)return;try{t[f]=await H(e[f],{...r,onProgress:o!==void 0?b=>o(f,b):void 0});}catch(b){s||(s=true,l=b,d=f,g?.());}}},p=Math.min(n,e.length),w=Array.from({length:p},()=>m());if(await Promise.race([Promise.all(w),c]),s){let f=l instanceof Error?l.message:String(l);throw new Error(i.ConvertManyItemFailed(d+1,e.length,f),{cause:l})}return t}exports.LibheifDecoder=y;exports.convertHeic=H;exports.convertHeicInWorker=$;exports.convertMany=Y;exports.freeSharedDecoder=Q;
+'use strict';var s={QualityInvalid:e=>`Quality must be a number between 0.0 and 1.0, got: ${e}`,ApplyOrientationInvalid:e=>`applyOrientation must be a boolean, got: ${e}`,UnsupportedInputType:e=>`Unsupported input type. Expected Blob, File, ArrayBuffer, or Uint8Array. Got: ${e}`,DecoderInitFailed:e=>`Failed to initialize HEIC decoder: ${e} \u2014 verify heic-decoder.wasm is served (dist/heic-decoder.wasm; see the README "Serving and Locating WASM" section / locateFile option) and that your CSP allows 'wasm-unsafe-eval'`,RenderEncodeFailed:(e,r)=>`Failed to render and encode image as ${e}: ${r}`,ConcurrencyInvalid:e=>`Concurrency must be a positive integer, got: ${e}`,MaxConcurrentWorkersInvalid:e=>`maxConcurrentWorkers must be a positive integer, got: ${e}`,TimeoutInvalid:e=>`timeoutMs must be a finite number >= 0 (0 disables the timeout), got: ${e}`,InputsMustBeArray:"Inputs must be an array of HEIC images",OutputShapeInvalid:e=>`output must be one of 'blob', 'dataUrl', 'arrayBuffer', got: ${e}`,ReuseDecodersInvalid:e=>`reuseDecoders must be a boolean, got: ${e}`,ContinueOnErrorInvalid:e=>`continueOnError must be a boolean, got: ${e}`,PreserveExifInvalid:e=>`preserveExif must be a boolean, got: ${e}`,SignalInvalid:e=>`signal must be an AbortSignal, got: ${e}`,Aborted:"Conversion aborted (AbortSignal was aborted)",ConvertManyItemFailed:(e,r,t)=>`Conversion of item ${e} of ${r} failed: ${t}`,ConvertManyExtraFailures:(e,r)=>` (${e} of ${r} items failed in total)`,ConvertManyOtherErrors:e=>`; other errors: ${e.join(" | ")}`,BatchItemProducedNoResult:e=>`Item ${String(e)} produced no result`,BatchEndedWithoutResult:"Batch ended without a result",ScaleInvalid:e=>`Scale must be a positive finite number, got: ${e}`,MaxWidthInvalid:e=>`maxWidth must be a positive finite number, got: ${e}`,MaxHeightInvalid:e=>`maxHeight must be a positive finite number, got: ${e}`,TargetSizeTooLarge:(e,r,t)=>`Target image size ${e}x${r} exceeds the maximum supported dimension of ${t}px`,BlobToBase64Failed:"Failed to convert Blob to base64 string",BlobToBase64FailedWithCause:e=>`Failed to convert Blob to base64 string: ${e}`,CanvasToBlobFailed:e=>`Failed to convert canvas to blob (type: ${e})`,CanvasUnsupported:"Canvas is not supported in the current environment. In a browser this requires OffscreenCanvas or HTMLCanvasElement. In Node.js there is no canvas: decode raw RGBA with LibheifDecoder and encode externally (see the Node.js section of the README).",InvalidDimensions:(e,r)=>`Invalid image dimensions: ${e}x${r}. Width and height must be positive integers.`,DataLengthMismatch:(e,r,t,n)=>`Image data length mismatch. Expected ${e} bytes for ${r}x${t}, got ${n}`,ContextUnavailable:"Failed to acquire 2D rendering context from canvas",UnsupportedFormat:e=>`Unsupported output format: ${e}`,FormatUnsupported:e=>`The current environment cannot encode '${e}' \u2014 canvas encoding produced no '${e}' image (e.g. AVIF encoding is not supported in this browser). Try 'jpeg', 'png', or 'webp' instead.`,CropInvalid:(e,r)=>`crop.${e} must be ${e==="width"||e==="height"?"a positive integer":"a non-negative integer"}, got: ${r}`,CropOutOfBounds:(e,r,t,n,o,i)=>`crop ${t}x${n} at (${e}, ${r}) exceeds the ${o}x${i} image (crop coordinates are in post-orientation display pixels)`,DecoderFreedDuringDecode:"Decoder was freed before decoding completed; call initialize() again.",DecodeInputAllocFailed:e=>`Failed to allocate ${e} bytes in the WASM heap for decode input`,DecodeFailed:e=>`HEIC decoding failed (no result returned; input: ${e} bytes \u2014 is the file truncated or empty?)`,DecodeFailedWithDetail:(e,r)=>`HEIC decoding failed: ${e} (input: ${r} bytes)`,ProgressCallbackThrew:e=>`onProgress callback threw during decode: ${e}`,WorkerUnsupported:"Web Worker is not supported in the current environment",WorkerCreateFailed:e=>`Failed to create Web Worker: ${e}`,WorkerPostFailed:e=>`Failed to post message to Web Worker: ${e}`,WorkerConversionFailed:"Worker conversion failed",WorkerDecoderUnsupported:"The decoder option is not supported by convertHeicInWorker: the worker creates its own decoder (functions and class instances cannot cross the worker boundary). Use convertHeic with an injected decoder instead.",WorkerFailed:e=>"Worker failed"+(e!==void 0?` (could not load worker script at ${String(e)}; check the path resolves and the script is served as JavaScript, e.g. Content-Type: text/javascript)`:""),WorkerTimeout:(e,r)=>{let t=[`${r.progressMessages} progress message(s) received`];return r.lastPercent!==void 0&&t.push(`last percent ${r.lastPercent}`),r.unknownType!==void 0&&t.push(`last unknown message type '${r.unknownType}' (worker may not implement the progress/result protocol)`),r.workerUrl!==void 0&&t.push(`worker ${String(r.workerUrl)}`),`Web Worker conversion timed out after ${e}ms (${t.join("; ")}). Increase timeoutMs for large images, set timeoutMs to 0 to disable the timeout, and verify the worker script implements the { type: "progress" | "result" } protocol.`}};function T(e){let r=Number(e);return Number.isFinite(r)?Math.min(100,Math.max(0,r)):0}var a=class extends Error{code;itemIndex;itemTotal;failedCount;constructor(r,t,n){super(t,{cause:n?.cause}),this.name="HeicConverterError",this.code=r,n?.itemIndex!==void 0&&(this.itemIndex=n.itemIndex),n?.itemTotal!==void 0&&(this.itemTotal=n.itemTotal),n?.failedCount!==void 0&&(this.failedCount=n.failedCount);}};var _=class{options;module=null;decoderInstance=null;initPromise=null;initGeneration=0;constructor(r){this.options=r;}async initialize(){if(!this.initPromise){let r=++this.initGeneration,t={};this.options?.moduleOverrides&&Object.assign(t,this.options.moduleOverrides),this.options?.locateFile&&(t.locateFile=this.options.locateFile),this.options?.wasmBinary&&(t.wasmBinary=this.options.wasmBinary);let n=import('./heic-decoder-7BA7NJOA.js').then(({default:o})=>o(t)).then(o=>{let i=new o.HeicDecoder;return r!==this.initGeneration?(i.delete(),null):(this.module=o,this.decoderInstance=i,o)}).catch(o=>{throw this.initPromise===n&&(this.initPromise=null),o});this.initPromise=n;}await this.initPromise;}async decode(r,t){if((!this.module||!this.decoderInstance)&&await this.initialize(),!this.module||!this.decoderInstance)throw new a("decode_failed",s.DecoderFreedDuringDecode);let n,o=t?O=>{try{t(T(O));}catch(k){n=n??k;}}:null,i=this.module,c=this.decoderInstance,u;if(typeof c.decodeFromPointer=="function"&&typeof i._malloc=="function"&&typeof i._free=="function"&&i.HEAPU8 instanceof Uint8Array&&r.buffer!==i.HEAPU8.buffer){let O=i._malloc(r.byteLength);if(O===0)throw new a("decode_failed",s.DecodeInputAllocFailed(r.byteLength));try{i.HEAPU8.set(r,O),u=c.decodeFromPointer(O,r.byteLength,o);}finally{i._free(O);}}else u=c.decode(r,o);if(typeof u=="string")throw new a("decode_failed",s.DecodeFailedWithDetail(u,r.byteLength));if(!u)throw new a("decode_failed",s.DecodeFailed(r.byteLength));if(n!==void 0)throw new a("progress_callback_failed",s.ProgressCallbackThrew(n instanceof Error?n.message:String(n)),{cause:n});let d=u.width,l=u.height,m=u.orientation,y=typeof m=="number"&&Number.isInteger(m)&&m>=1&&m<=8?m:1,h=i.HEAPU8 instanceof Uint8Array?i.HEAPU8.buffer:void 0,w=h!==void 0&&u.data.buffer!==h?new Uint8ClampedArray(u.data.buffer,u.data.byteOffset,u.data.byteLength):new Uint8ClampedArray(u.data),g={width:d,height:l,data:w};y>1&&(g.orientation=y);let p=u.exif;return p instanceof Uint8Array&&p.length>=14&&(g.exif=h!==void 0&&p.buffer!==h?new Uint8Array(p.buffer,p.byteOffset,p.byteLength):new Uint8Array(p)),g}free(){this.initGeneration+=1,this.decoderInstance&&(this.decoderInstance.delete(),this.decoderInstance=null),this.module=null,this.initPromise=null;}};var ie=["jpeg","jpg","png","svg","webp","avif"],Se=.92;function R(e){$(e?.to??"jpeg"),e?.quality!==void 0&&ke(e.quality),Ae(e?.applyOrientation),_e(e?.output),Te(e?.signal),X(e?.crop),Me(e?.preserveExif),Q(e?.maxWidth!==void 0||e?.maxHeight!==void 0||e?.scale!==void 0?e:void 0);}function ae(e){Y(e?.continueOnError),Pe(e?.reuseDecoders);}function ke(e){if(typeof e!="number"||!Number.isFinite(e)||e<0||e>1)throw new a("invalid_quality",s.QualityInvalid(e))}function Ae(e){if(e!==void 0&&typeof e!="boolean")throw new a("invalid_input",s.ApplyOrientationInvalid(e))}function _e(e){if(e!==void 0&&e!=="blob"&&e!=="dataUrl"&&e!=="arrayBuffer")throw new a("invalid_input",s.OutputShapeInvalid(e))}function Pe(e){if(e!==void 0&&typeof e!="boolean")throw new a("invalid_input",s.ReuseDecodersInvalid(e))}function Y(e){if(e!==void 0&&typeof e!="boolean")throw new a("invalid_input",s.ContinueOnErrorInvalid(e))}function Me(e){if(e!==void 0&&typeof e!="boolean")throw new a("invalid_input",s.PreserveExifInvalid(e))}function Te(e){if(e!==void 0&&(typeof e!="object"||e===null||typeof e.addEventListener!="function"))throw new a("invalid_input",s.SignalInvalid(e))}function U(e){if(e?.aborted)throw new a("aborted",s.Aborted)}function $(e){let r=String(e).toLowerCase();if(!ie.includes(r))throw new a("invalid_format",s.UnsupportedFormat(String(e)))}function Q(e){if(!e)return;let{maxWidth:r,maxHeight:t,scale:n}=e;if(n!==void 0&&(typeof n!="number"||!Number.isFinite(n)||n<=0))throw new a("invalid_resize",s.ScaleInvalid(n));if(r!==void 0&&(typeof r!="number"||!Number.isFinite(r)||r<=0))throw new a("invalid_resize",s.MaxWidthInvalid(r));if(t!==void 0&&(typeof t!="number"||!Number.isFinite(t)||t<=0))throw new a("invalid_resize",s.MaxHeightInvalid(t))}function X(e){if(!e)return;let{x:r=0,y:t=0,width:n,height:o}=e;if(!Number.isInteger(n)||n<=0)throw new a("invalid_crop",s.CropInvalid("width",n));if(!Number.isInteger(o)||o<=0)throw new a("invalid_crop",s.CropInvalid("height",o));if(!Number.isInteger(r)||r<0)throw new a("invalid_crop",s.CropInvalid("x",r));if(!Number.isInteger(t)||t<0)throw new a("invalid_crop",s.CropInvalid("y",t))}function J(e){if(e!==void 0&&(!Number.isInteger(e)||e<1))throw new a("invalid_concurrency",s.MaxConcurrentWorkersInvalid(e))}function K(e){if(e!==void 0&&(typeof e!="number"||!Number.isFinite(e)||e<0))throw new a("invalid_input",s.TimeoutInvalid(e))}var B=new Uint8Array([69,120,105,102,0,0]),se=new Uint8Array([137,80,78,71,13,10,26,10]);function Z(e){if(e.length<B.length+8)return  false;for(let r=0;r<B.length;r++)if(e[r]!==B[r])return  false;return Re(e,B.length)}function Re(e,r){if(r+8>e.length)return  false;let t=e[r]===73&&e[r+1]===73,n=e[r]===77&&e[r+1]===77;return !t&&!n?false:(t?e[r+2]|e[r+3]<<8:e[r+2]<<8|e[r+3])===42}function Ue(e,r){return e[r]<<8|e[r+1]}function ue(e,r){return (e[r]<<24|e[r+1]<<16|e[r+2]<<8|e[r+3])>>>0}function de(e){try{if(!Z(e))return e;let r=B.length,t=e[r]===73,n=d=>t?e[d]|e[d+1]<<8:e[d]<<8|e[d+1],o=d=>t?(e[d+3]<<24|e[d+2]<<16|e[d+1]<<8|e[d])>>>0:(e[d]<<24|e[d+1]<<16|e[d+2]<<8|e[d+3])>>>0,i=o(r+4);if(i<8||r+i+2>e.length)return e;let c=r+i,u=n(c);for(let d=0;d<u;d++){let l=c+2+d*12;if(l+12>e.length)return e;if(n(l)!==274)continue;let m=n(l+2),y=o(l+4);if(m!==3||y!==1||(t?e[l+8]|e[l+9]<<8:e[l+8]<<8|e[l+9])===1)return e;let w=e.slice();return w[l+8]=t?1:0,w[l+9]=t?0:1,w[l+10]=0,w[l+11]=0,w}return e}catch{return e}}function ce(e,r){try{if(e.length<4||e[0]!==255||e[1]!==216||!Z(r))return e;let t=r.length+2;if(t>65535)return e;let n=2;for(;n<e.length;){if(n+4>e.length||e[n]!==255)return e;let i=e[n+1];if(i===255){n+=1;continue}if(!(i>=224&&i<=239||i===254))break;let u=Ue(e,n+2);if(u<2||n+2+u>e.length)return e;n+=2+u;}let o=new Uint8Array(e.length+4+r.length);return o.set(e.subarray(0,n),0),o[n]=255,o[n+1]=225,o[n+2]=t>>8&255,o[n+3]=t&255,o.set(r,n+4),o.set(e.subarray(n),n+4+r.length),o}catch{return e}}var L;function Be(){if(!L){L=new Uint32Array(256);for(let e=0;e<256;e++){let r=e;for(let t=0;t<8;t++)r=r&1?3988292384^r>>>1:r>>>1;L[e]=r>>>0;}}return L}function Fe(e){let r=Be(),t=4294967295;for(let n=0;n<e.length;n++)t=r[(t^e[n])&255]^t>>>8;return (t^4294967295)>>>0}function N(e,r,t){return e[r]===t.charCodeAt(0)&&e[r+1]===t.charCodeAt(1)&&e[r+2]===t.charCodeAt(2)&&e[r+3]===t.charCodeAt(3)}function le(e,r){try{if(e.length<33)return e;for(let u=0;u<se.length;u++)if(e[u]!==se[u])return e;if(ue(e,8)!==13||!N(e,12,"IHDR")||!Z(r))return e;let t=r.subarray(B.length),n=33;for(;n+8<=e.length;){let u=ue(e,n);if(u>e.length||n+12+u>e.length)return e;if(N(e,n+4,"IDAT")||N(e,n+4,"IEND"))break;if(N(e,n+4,"eXIf"))return e;n+=12+u;}let o=new Uint8Array(12+t.length);o[0]=t.length>>>24&255,o[1]=t.length>>>16&255,o[2]=t.length>>>8&255,o[3]=t.length&255,o.set([101,88,73,102],4),o.set(t,8);let i=Fe(o.subarray(4,8+t.length));o[8+t.length]=i>>>24&255,o[9+t.length]=i>>>16&255,o[10+t.length]=i>>>8&255,o[11+t.length]=i&255;let c=new Uint8Array(e.length+o.length);return c.set(e.subarray(0,n),0),c.set(o,n),c.set(e.subarray(n),n+o.length),c}catch{return e}}var j=16384;function re(){if(typeof OffscreenCanvas>"u"&&typeof document>"u")throw new a("unsupported_environment",s.CanvasUnsupported)}var z=null,De=5e3;async function We(){let e=ee(1,1),r=F(e,"image/avif"),t,n=new Promise(o=>{t=setTimeout(()=>o("timeout"),De);});try{let o=await Promise.race([r,n]);return o==="timeout"?(z=null,!1):o.type==="image/avif"&&o.size>0}finally{t!==void 0&&clearTimeout(t),P(e);}}function ge(){return z===null&&(z=We().catch(()=>false)),z}async function ne(e){if($(e),String(e).toLowerCase()==="avif"&&!await ge())throw new a("format_unsupported",s.FormatUnsupported("avif"))}function He(e,r,t){if(Q(t),!t)return {width:e,height:r};let{maxWidth:n,maxHeight:o,scale:i}=t;if(i!==void 0){let l=Math.max(1,Math.round(e*i)),m=Math.max(1,Math.round(r*i));return fe(l,m),{width:l,height:m}}if(n===void 0&&o===void 0)return {width:e,height:r};let c=Math.min(n!==void 0?n/e:Number.POSITIVE_INFINITY,o!==void 0?o/r:Number.POSITIVE_INFINITY);if(c>=1)return {width:e,height:r};let u=Math.min(Math.max(1,Math.round(e*c)),n!==void 0?Math.floor(n):Number.POSITIVE_INFINITY),d=Math.min(Math.max(1,Math.round(r*c)),o!==void 0?Math.floor(o):Number.POSITIVE_INFINITY);return fe(u,d),{width:u,height:d}}function fe(e,r){if(!Number.isFinite(e)||!Number.isFinite(r)||e>j||r>j)throw new a("invalid_resize",s.TargetSizeTooLarge(e,r,j))}async function te(e){if(typeof FileReader<"u")return new Promise((r,t)=>{let n=new FileReader;n.onloadend=()=>{typeof n.result=="string"?r(n.result):t(new a("render_encode_failed",s.BlobToBase64Failed));},n.onerror=()=>t(new a("render_encode_failed",s.BlobToBase64FailedWithCause(n.error?.message??"FileReader failed"),{cause:n.error??void 0})),n.readAsDataURL(e);});try{let r=await e.arrayBuffer(),t=new Uint8Array(r),n="",o=32768;for(let c=0;c<t.length;c+=o)n+=String.fromCharCode(...t.subarray(c,c+o));let i=btoa(n);return `data:${e.type};base64,${i}`}catch(r){throw new a("render_encode_failed",s.BlobToBase64FailedWithCause(r instanceof Error?r.message:String(r)),{cause:r})}}function F(e,r,t){return "convertToBlob"in e?e.convertToBlob({type:r,quality:t}):new Promise((n,o)=>{e.toBlob(i=>{i?n(i):o(new a("render_encode_failed",s.CanvasToBlobFailed(r)));},r,t);})}function ee(e,r){if(typeof OffscreenCanvas<"u")return new OffscreenCanvas(e,r);if(typeof document<"u"){let t=document.createElement("canvas");return t.width=e,t.height=r,t}throw new a("unsupported_environment",s.CanvasUnsupported)}function P(e){let r=e;typeof r.close=="function"?r.close():e.width=0;}function me(e,r,t,n){if(typeof ImageData<"u")e.putImageData(new ImageData(r,t,n),0,0);else {let o=e.createImageData(t,n);o.data.set(r),e.putImageData(o,0,0);}}function $e(e,r,t){switch(e){case 2:return [-1,0,0,1,r,0];case 3:return [-1,0,0,-1,r,t];case 4:return [1,0,0,-1,0,t];case 5:return [0,1,1,0,0,0];case 6:return [0,1,-1,0,t,0];case 7:return [0,-1,-1,0,t,r];case 8:return [0,-1,1,0,0,r];default:return null}}function Le(e,r){return !r||typeof e!="number"||!Number.isInteger(e)?1:e>=1&&e<=8?e:1}async function pe(e,r,t,n,o){let i=r.exif;if(!t||!i||i.length===0)return e;let c=o?de(i):i,u=new Uint8Array(await e.arrayBuffer()),d=n==="jpeg"?ce(u,c):le(u,c);return d===u?e:new Blob([d.buffer],{type:e.type})}async function he(e,r,t,n,o=true,i,c=false){$(r),X(i);let u=r.toLowerCase();if(u==="avif"&&!await ge())throw new a("format_unsupported",s.FormatUnsupported("avif"));let{width:d,height:l,data:m}=e;if(!Number.isInteger(d)||d<=0||!Number.isInteger(l)||l<=0)throw new a("render_encode_failed",s.InvalidDimensions(d,l));let y=d*l*4;if(m.length!==y)throw new a("render_encode_failed",s.DataLengthMismatch(y,d,l,m.length));let h=Le(e.orientation,o),g=!(e.orientation!==void 0&&e.orientation>=2&&e.orientation<=8)||o,p=$e(h,d,l),O=h>=5,k=O?l:d,M=O?d:l,A=i?.x??0,v=i?.y??0,b=i?i.width:k,E=i?i.height:M;if(i&&(A+b>k||v+E>M))throw new a("invalid_crop",s.CropOutOfBounds(A,v,b,E,k,M));let C=He(b,E,n),q=C.width!==b||C.height!==E,I=p!==null||i!==void 0,f=ee(C.width,C.height),S=f.getContext("2d");if(!S)throw new a("render_encode_failed",s.ContextUnavailable);if(I||q){let x=ee(d,l),H=x.getContext("2d");if(!H)throw new a("render_encode_failed",s.ContextUnavailable);if(me(H,m,d,l),I){let D=C.width/b,W=C.height/E,ye=p?p[0]:1,xe=p?p[1]:0,Ce=p?p[2]:0,Ie=p?p[3]:1,Oe=p?p[4]:0,Ee=p?p[5]:0;S.setTransform(ye*D,xe*W,Ce*D,Ie*W,D*(Oe-A),W*(Ee-v)),S.drawImage(x,0,0);}else S.drawImage(x,0,0,C.width,C.height);P(x);}else me(S,m,d,l);if(u==="png"){let x=await F(f,"image/png");return P(f),pe(x,e,c,"png",g)}if(u==="jpeg"||u==="jpg"){let x=await F(f,"image/jpeg",t);return P(f),pe(x,e,c,"jpeg",g)}if(u==="webp"){let x=await F(f,"image/webp",t);return P(f),x}if(u==="avif"){let x=await F(f,"image/avif",t);if(P(f),x.type!=="image/avif")throw new a("format_unsupported",s.FormatUnsupported("avif"));return x}if(u==="svg"){let x=await F(f,"image/png");P(f);let H=await te(x),D=`<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 ${C.width} ${C.height}" width="${C.width}" height="${C.height}">
+  <image width="${C.width}" height="${C.height}" href="`,W=`" />
+</svg>`;return new Blob([D,H,W],{type:"image/svg+xml"})}throw new a("invalid_format",s.UnsupportedFormat(String(r)))}async function V(e,r,t,n){let o=n?.continueOnError===true,i=n?.signal,c=new Array(e.length),u=0,d=false,l=0,m=null,y=-1,h=0,w=[],g,p=new Promise(v=>{g=v;}),O=()=>g?.();i&&!o&&i.addEventListener("abort",O,{once:true});let k=async()=>{for(;!d&&!i?.aborted||o;){let v=u;if(u+=1,v>=e.length)return;if(o&&i?.aborted){let b=new a("aborted",s.Aborted);for(let E=v;E<e.length;E++)c[E]={index:E,ok:false,error:b};u=e.length;return}try{let b=await t(e[v],v);c[v]={index:v,ok:!0,result:b},l+=1;}catch(b){if(h+=1,o){c[v]={index:v,ok:false,error:b instanceof Error?b:new Error(String(b))};continue}d?w.length<2&&w.push(b instanceof Error?b.message:String(b)):(d=true,m=b,y=v,g?.());}}},M=Math.min(r,e.length),A=Array.from({length:M},()=>k());try{if(o)return await Promise.all(A),c;if(await Promise.race([Promise.all(A),p]),l===e.length)return c.map(v=>{if(!v||!v.ok)throw new a("batch_item_failed",s.BatchItemProducedNoResult(v?.index));return v.result});if(i?.aborted)throw new a("aborted",s.Aborted);if(d){let v=m instanceof Error?m.message:String(m),b=s.ConvertManyItemFailed(y+1,e.length,v);throw h>1&&(b+=s.ConvertManyExtraFailures(h,e.length),w.length>0&&(b+=s.ConvertManyOtherErrors(w))),new a("batch_item_failed",b,{cause:m,itemIndex:y,itemTotal:e.length,failedCount:h})}throw new a("batch_item_failed",s.BatchEndedWithoutResult)}finally{i?.removeEventListener("abort",O);}}function Ne(){let e=typeof navigator<"u"&&typeof navigator.hardwareConcurrency=="number"?navigator.hardwareConcurrency:4;return Math.max(1,Math.min(e,8))}var G=new Map;function ze(e,r,t){let n=G.get(e);n||(n={active:0,waiters:[]},G.set(e,n));let o={granted:false,released:false},i=()=>{let d=n.waiters.shift();d?d():n.active===0&&n.waiters.length===0&&G.delete(e);},c=()=>{if(!o.released)if(o.released=true,o.granted)o.granted=false,n.active-=1,i();else {let d=n.waiters.indexOf(u);d!==-1&&n.waiters.splice(d,1),n.active===0&&n.waiters.length===0&&G.delete(e);}},u=()=>{o.released||(o.granted=true,n.active+=1,t(c));};return n.active<r?u():n.waiters.push(u),c}function ve(e){return new a("progress_callback_failed",s.ProgressCallbackThrew(e instanceof Error?e.message:String(e)),{cause:e})}function be(e,r){return new Promise((t,n)=>{if(typeof Worker>"u"){n(new a("worker_unsupported",s.WorkerUnsupported));return}if(r.decoder!==void 0){n(new a("invalid_input",s.WorkerDecoderUnsupported));return}try{R(r),J(r?.maxConcurrentWorkers),K(r?.timeoutMs);}catch(I){n(I);return}if(r.signal?.aborted){n(new a("aborted",s.Aborted));return}let o={progressMessages:0},i,c=false,u,d,l=()=>{c||(c=true,u!==void 0&&clearTimeout(u),r.signal?.removeEventListener("abort",m),i&&(i.removeEventListener("message",h),i.removeEventListener("messageerror",g),i.removeEventListener("error",w),i.terminate()),d?.());},m=()=>{l(),n(new a("aborted",s.Aborted));};r.signal?.addEventListener("abort",m,{once:true});let y=r.timeoutMs??6e4;y>0&&(u=setTimeout(()=>{l(),n(new a("worker_timeout",s.WorkerTimeout(y,{progressMessages:o.progressMessages,lastPercent:o.lastPercent,unknownType:o.unknownType,workerUrl:r.workerUrl})));},y));let h=I=>{let f=I.data;if(f?.type==="progress"){o.progressMessages+=1;let S=T(f.percent);if(o.lastPercent=S,S>=100)return;try{r.onProgress?.(S);}catch(x){l(),n(ve(x));}return}if(f?.type!=="result"){typeof f?.type=="string"&&(o.unknownType=f.type);return}if(l(),f.ok&&f.blob!==void 0){try{r.onProgress?.(100);}catch(S){n(ve(S));return}t(f.blob);}else n(new a("worker_failed",f.error??s.WorkerConversionFailed));},w=I=>{l();let f=I.filename?` (${I.filename}:${I.lineno})`:"";n(new a("worker_failed",`${I.message||s.WorkerFailed(r.workerUrl)}${f}`));},g=I=>{l();let f=I.data;n(new a("worker_failed",f instanceof Error?f.message:f!==void 0?String(f):s.WorkerFailed(r.workerUrl),{cause:f}));},{workerUrl:p,onProgress:O,timeoutMs:k,workerType:M,maxConcurrentWorkers:A,signal:v,...b}=r,E=I=>{if(d=I,!c){try{i=new Worker(p,r.workerType==="module"?{type:"module"}:void 0);}catch(f){l(),n(new a("worker_create_failed",s.WorkerCreateFailed(f instanceof Error?f.message:String(f)),{cause:f}));return}i.addEventListener("message",h),i.addEventListener("messageerror",g),i.addEventListener("error",w);try{i.postMessage({input:e,options:b});}catch(f){l(),n(new a("worker_post_failed",s.WorkerPostFailed(f instanceof Error?f.message:String(f)),{cause:f}));}}},C=`${String(p)}|${r.workerType??"classic"}`,q=we(r.maxConcurrentWorkers);d=ze(C,q,E);})}function we(e){return typeof e=="number"&&Number.isInteger(e)?Math.max(1,e):Ne()}async function Ve(e,r){if(!Array.isArray(e))throw new a("invalid_input",s.InputsMustBeArray);if(typeof Worker>"u")throw new a("worker_unsupported",s.WorkerUnsupported);if(r.decoder!==void 0)throw new a("invalid_input",s.WorkerDecoderUnsupported);R(r),Y(r?.continueOnError),J(r?.maxConcurrentWorkers),K(r?.timeoutMs);let{onProgress:t,continueOnError:n,...o}=r??{};return V(e,we(r?.maxConcurrentWorkers),(i,c)=>be(i,{...o,...t!==void 0?{onProgress:u=>t(c,u)}:{}}),{continueOnError:r?.continueOnError===true,signal:r?.signal})}function _r(){}async function Ge(e,r){return r==="dataUrl"?await te(e):r==="arrayBuffer"?await e.arrayBuffer():e}async function qe(e){if(e instanceof Uint8Array)return e;if(e instanceof ArrayBuffer)return new Uint8Array(e);if(typeof Blob<"u"&&e instanceof Blob)return new Uint8Array(await e.arrayBuffer());if(e!==null&&typeof e=="object"&&typeof e.arrayBuffer=="function"){let r=await e.arrayBuffer();if(r instanceof ArrayBuffer)return new Uint8Array(r)}if(ArrayBuffer.isView(e)){let r=e;return new Uint8Array(r.buffer,r.byteOffset,r.byteLength)}throw new a("invalid_input",s.UnsupportedInputType(Object.prototype.toString.call(e)))}function Ye(e){if(typeof e!="function")return;let r=false,t,n=o=>{try{e(o);}catch(i){throw new a("progress_callback_failed",s.ProgressCallbackThrew(i instanceof Error?i.message:String(i)),{cause:i})}};return {report:o=>{if(r)return;let i=T(o);if(!(i>=100))try{e(i);}catch(c){t=t??c;}},complete:()=>{if(!r){if(r=true,t!==void 0)throw new a("progress_callback_failed",s.ProgressCallbackThrew(t instanceof Error?t.message:String(t)),{cause:t});n(100);}}}}async function Qe(e,r){let t=r?.to??"jpeg";R(r),re(),await ne(t);let n=r?.signal;U(n);let o=r?.maxWidth!==void 0||r?.maxHeight!==void 0||r?.scale!==void 0?r:void 0,i=await qe(e);U(n);let c=r?.decoder??new _,u=!r?.decoder,d=false,l=()=>{if(!(!u||d)){d=true;try{c.free();}catch{}}};try{try{await c.initialize();}catch(g){throw new a("decoder_init_failed",s.DecoderInitFailed(g instanceof Error?g.message:String(g)),{cause:g})}U(n);let m=Ye(r?.onProgress),y=await c.decode(i,m?m.report:void 0);l(),U(n);let h=r?.quality!==void 0?r.quality:.92,w;try{w=await he(y,t,h,o,r?.applyOrientation??!0,r?.crop,r?.preserveExif??!1);}catch(g){throw g instanceof a?g:new a("render_encode_failed",s.RenderEncodeFailed(t,g instanceof Error?g.message:String(g)),{cause:g})}return U(n),m?.complete(),Ge(w,r?.output??"blob")}finally{l();}}var oe=class{max;idle=[];waiters=[];leasedCount=0;disposed=false;constructor(r){this.max=Math.max(1,r);}async acquire(){let r=this.idle.pop();return r||(this.leasedCount<this.max?(this.leasedCount+=1,new _):new Promise(t=>this.waiters.push(t)))}release(r){if(this.disposed){try{r.free();}catch{}return}let t=this.waiters.shift();t?t(r):this.idle.push(r);}dispose(){this.disposed=true;for(let r of this.idle)try{r.free();}catch{}this.idle.length=0;for(let r of this.waiters.splice(0))r(new _);}};async function Pr(e,r){if(!Array.isArray(e))throw new a("invalid_input",s.InputsMustBeArray);let t=r?.concurrency??4;if(!Number.isInteger(t)||t<1)throw new a("invalid_concurrency",s.ConcurrencyInvalid(t));R(r),ae(r),re(),await ne(r?.to??"jpeg");let{concurrency:n,onProgress:o,continueOnError:i,reuseDecoders:c,...u}=r??{},l=c===true&&r?.decoder===void 0?new oe(Math.min(t,e.length)):null;try{return await V(e,t,async(m,y)=>{let h=l?await l.acquire():null;try{return await Qe(m,{...u,...h?{decoder:h}:{},onProgress:o!==void 0?w=>o(y,w):void 0})}finally{h&&l.release(h);}},{continueOnError:r?.continueOnError===!0,signal:r?.signal})}finally{l?.dispose();}}exports.DEFAULT_QUALITY=Se;exports.HeicConverterError=a;exports.LibheifDecoder=_;exports.SUPPORTED_FORMATS=ie;exports.convertHeic=Qe;exports.convertHeicInWorker=be;exports.convertMany=Pr;exports.convertManyInWorker=Ve;exports.freeSharedDecoder=_r;