taglib-wasm 0.3.3 → 0.3.9

package/dist/src/utils/write.ts

@@ -0,0 +1,61 @@
+/**
+ * File writing utilities for taglib-wasm
+ * Provides cross-runtime support for writing files
+ */
+
+import { EnvironmentError, FileOperationError } from "../errors.ts";
+
+/**
+ * Write data to a file across different runtimes.
+ * Supports Node.js, Deno, and Bun environments.
+ *
+ * @param path - File path to write to
+ * @param data - Data to write (Uint8Array)
+ * @throws {FileOperationError} If file write fails
+ * @throws {EnvironmentError} If environment doesn't support file writing
+ */
+export async function writeFileData(
+  path: string,
+  data: Uint8Array,
+): Promise<void> {
+  try {
+    // Deno
+    if (typeof Deno !== "undefined") {
+      await Deno.writeFile(path, data);
+      return;
+    }
+
+    // Node.js
+    if (
+      typeof process !== "undefined" && process.versions &&
+      process.versions.node
+    ) {
+      const { writeFile } = await import("fs/promises");
+      await writeFile(path, data);
+      return;
+    }
+
+    // Bun
+    if (typeof (globalThis as any).Bun !== "undefined") {
+      await (globalThis as any).Bun.write(path, data);
+      return;
+    }
+  } catch (error) {
+    // Convert system file errors to FileOperationError
+    throw new FileOperationError(
+      "write",
+      (error as Error).message,
+      path
+    );
+  }
+
+  const env = typeof Deno !== "undefined" ? "Deno" :
+              typeof process !== "undefined" ? "Node.js" :
+              typeof (globalThis as any).Bun !== "undefined" ? "Bun" :
+              "Browser";
+  throw new EnvironmentError(
+    env,
+    "does not support file path writing",
+    "filesystem access"
+  );
+}

package/dist/src/wasm-workers.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @fileoverview WebAssembly module interface for Cloudflare Workers
+ */
+import type { TagLibConfig, TagLibModule } from "./types.ts";
+export type { TagLibModule };
+/**
+ * Load and initialize the TagLib WebAssembly module for Cloudflare Workers
+ *
+ * @param wasmBinary - The WebAssembly binary as Uint8Array
+ * @param config - Optional configuration for the Wasm module
+ * @returns Promise resolving to initialized TagLib module
+ *
+ * @example
+ * ```typescript
+ * import wasmBinary from "../build/taglib.wasm";
+ *
+ * const taglib = await loadTagLibModuleForWorkers(wasmBinary);
+ * ```
+ */
+export declare function loadTagLibModuleForWorkers(wasmBinary: Uint8Array, config?: TagLibConfig): Promise<TagLibModule>;
+/**
+ * Convert a C string pointer to JavaScript string (Workers-compatible)
+ */
+export declare function cStringToJS(module: TagLibModule, ptr: number): string;
+/**
+ * Convert JavaScript string to C string (Workers-compatible)
+ */
+export declare function jsToCString(module: TagLibModule, str: string): number;
+/**
+ * Utility function to check if we're running in Cloudflare Workers
+ */
+export declare function isCloudflareWorkers(): boolean;
+//# sourceMappingURL=wasm-workers.d.ts.map

package/dist/src/wasm-workers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wasm-workers.d.ts","sourceRoot":"","sources":["../../src/wasm-workers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAI7D,YAAY,EAAE,YAAY,EAAE,CAAC;AAc7B;;;;;;;;;;;;;GAaG;AACH,wBAAsB,0BAA0B,CAC9C,UAAU,EAAE,UAAU,EACtB,MAAM,GAAE,YAAiB,GACxB,OAAO,CAAC,YAAY,CAAC,CAkEvB;AA4BD;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAQrE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAYrE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,CAS7C"}

package/dist/src/wasm-workers.ts

@@ -0,0 +1,176 @@
+/**
+ * @fileoverview WebAssembly module interface for Cloudflare Workers
+ */
+
+import type { TagLibConfig, TagLibModule } from "./types.ts";
+import { TagLibInitializationError } from "./errors.ts";
+
+// Re-export TagLibModule for convenience
+export type { TagLibModule };
+
+/**
+ * Default configuration for taglib-wasm module in Workers environment
+ * Reduced memory limits to fit within Workers constraints
+ */
+const DEFAULT_WORKERS_CONFIG: Required<TagLibConfig> = {
+  memory: {
+    initial: 8 * 1024 * 1024, // 8MB (reduced from 16MB)
+    maximum: 64 * 1024 * 1024, // 64MB (reduced from 256MB)
+  },
+  debug: false,
+};
+
+/**
+ * Load and initialize the TagLib WebAssembly module for Cloudflare Workers
+ *
+ * @param wasmBinary - The WebAssembly binary as Uint8Array
+ * @param config - Optional configuration for the Wasm module
+ * @returns Promise resolving to initialized TagLib module
+ *
+ * @example
+ * ```typescript
+ * import wasmBinary from "../build/taglib.wasm";
+ *
+ * const taglib = await loadTagLibModuleForWorkers(wasmBinary);
+ * ```
+ */
+export async function loadTagLibModuleForWorkers(
+  wasmBinary: Uint8Array,
+  config: TagLibConfig = {},
+): Promise<TagLibModule> {
+  const mergedConfig = { ...DEFAULT_WORKERS_CONFIG, ...config };
+
+  // Create Emscripten module configuration for Workers
+  const moduleConfig = {
+    wasmBinary,
+    wasmMemory: new WebAssembly.Memory({
+      initial: mergedConfig.memory.initial! / (64 * 1024),
+      maximum: mergedConfig.memory.maximum! / (64 * 1024),
+    }),
+    print: mergedConfig.debug ? console.log : () => {},
+    printErr: mergedConfig.debug ? console.error : () => {},
+    onRuntimeInitialized: () => {
+      if (mergedConfig.debug) {
+        console.log("taglib-wasm module initialized in Workers");
+      }
+    },
+    // Workers-specific settings
+    locateFile: () => {
+      // Return empty string since we're providing wasmBinary directly
+      return "";
+    },
+    // Disable file system access
+    noFSInit: true,
+    noExitRuntime: true,
+  };
+
+  try {
+    // For Workers, we need to use a modified version of the Emscripten output
+    // that doesn't include Node.js/CommonJS dependencies
+    const TagLibWasm = await createWorkersCompatibleModule();
+
+    if (typeof TagLibWasm !== "function") {
+      throw new TagLibInitializationError(
+        "Failed to load taglib-wasm module for Workers. " +
+          "The module may not be properly bundled for the Workers environment.",
+      );
+    }
+
+    const wasmInstance = await TagLibWasm(moduleConfig);
+
+    // Ensure proper memory arrays are set up
+    if (!wasmInstance.HEAPU8) {
+      const buffer = wasmInstance.buffer || wasmInstance.wasmMemory?.buffer;
+      if (buffer) {
+        wasmInstance.HEAPU8 = new Uint8Array(buffer);
+        wasmInstance.HEAP8 = new Int8Array(buffer);
+        wasmInstance.HEAP16 = new Int16Array(buffer);
+        wasmInstance.HEAP32 = new Int32Array(buffer);
+        wasmInstance.HEAPU16 = new Uint16Array(buffer);
+        wasmInstance.HEAPU32 = new Uint32Array(buffer);
+        wasmInstance.HEAPF32 = new Float32Array(buffer);
+        wasmInstance.HEAPF64 = new Float64Array(buffer);
+      }
+    }
+
+    return wasmInstance as TagLibModule;
+  } catch (error) {
+    if (error instanceof TagLibInitializationError) {
+      throw error;
+    }
+    throw new TagLibInitializationError(
+      `Failed to load taglib-wasm for Workers: ${(error as Error).message}`,
+      { error: (error as Error).message },
+    );
+  }
+}
+
+/**
+ * Create a Workers-compatible version of the Emscripten module
+ * This function loads the Wasm module without Node.js/CommonJS dependencies
+ */
+async function createWorkersCompatibleModule(): Promise<any> {
+  // In a real Workers environment, you would typically:
+  // 1. Use a build process to create a Workers-compatible version of taglib.js
+  // 2. Or inline the essential parts of the Emscripten runtime here
+  // 3. Or use dynamic import with proper bundling
+
+  // For now, we'll attempt to load the existing module with Workers compatibility
+  try {
+    // Try to import the existing module
+    const wasmModule = await import("../build/taglib-wrapper.js");
+    return wasmModule.default || wasmModule;
+  } catch (error) {
+    // If that fails, provide a fallback implementation
+    throw new TagLibInitializationError(
+      "Workers-compatible Wasm module not available. " +
+        "Please build with Workers target or use a bundler that supports Wasm modules. " +
+        `Original error: ${(error as Error).message}`,
+      { error: (error as Error).message },
+    );
+  }
+}
+
+/**
+ * Convert a C string pointer to JavaScript string (Workers-compatible)
+ */
+export function cStringToJS(module: TagLibModule, ptr: number): string {
+  if (ptr === 0) return "";
+
+  const view = new Uint8Array(module.HEAPU8.buffer, ptr);
+  let length = 0;
+  while (view[length] !== 0) length++;
+
+  return new TextDecoder().decode(view.subarray(0, length));
+}
+
+/**
+ * Convert JavaScript string to C string (Workers-compatible)
+ */
+export function jsToCString(module: TagLibModule, str: string): number {
+  const encoder = new TextEncoder();
+  const bytes = encoder.encode(str + "\0");
+
+  // Use allocate if available, otherwise use _malloc
+  if (module.allocate && module.ALLOC_NORMAL !== undefined) {
+    return module.allocate(bytes, module.ALLOC_NORMAL);
+  } else {
+    const ptr = module._malloc(bytes.length);
+    module.HEAPU8.set(bytes, ptr);
+    return ptr;
+  }
+}
+
+/**
+ * Utility function to check if we're running in Cloudflare Workers
+ */
+export function isCloudflareWorkers(): boolean {
+  return (
+    typeof globalThis !== "undefined" &&
+    typeof globalThis.caches !== "undefined" &&
+    typeof globalThis.Request !== "undefined" &&
+    typeof globalThis.Response !== "undefined" &&
+    typeof (globalThis as any).process === "undefined" &&
+    typeof (globalThis as any).Deno === "undefined"
+  );
+}

package/dist/src/wasm.d.ts

@@ -0,0 +1,97 @@
+/**
+ * @fileoverview WebAssembly module interface types for Emscripten
+ */
+export interface EmscriptenModule {
+    HEAP8: Int8Array;
+    HEAP16: Int16Array;
+    HEAP32: Int32Array;
+    HEAPU8: Uint8Array;
+    HEAPU16: Uint16Array;
+    HEAPU32: Uint32Array;
+    HEAPF32: Float32Array;
+    HEAPF64: Float64Array;
+    _malloc(size: number): number;
+    _free(ptr: number): void;
+    allocate?(data: number[] | Uint8Array, allocator: number): number;
+    ALLOC_NORMAL?: number;
+    ccall?(ident: string, returnType: string, argTypes: string[], args: any[]): any;
+    cwrap?(ident: string, returnType: string, argTypes: string[]): (...args: any[]) => any;
+    FS?: any;
+    then?(callback: (module: EmscriptenModule) => void): void;
+    onRuntimeInitialized?: () => void;
+}
+export interface FileHandle {
+    loadFromBuffer(data: Uint8Array): boolean;
+    isValid(): boolean;
+    save(): boolean;
+    getFormat(): string;
+    getProperties(): any;
+    setProperties(props: any): void;
+    getProperty(key: string): string;
+    setProperty(key: string, value: string): void;
+    isMP4(): boolean;
+    getMP4Item(key: string): string;
+    setMP4Item(key: string, value: string): void;
+    removeMP4Item(key: string): void;
+    getTag(): TagWrapper;
+    getAudioProperties(): AudioPropertiesWrapper;
+}
+export interface TagWrapper {
+    title(): string;
+    artist(): string;
+    album(): string;
+    comment(): string;
+    genre(): string;
+    year(): number;
+    track(): number;
+    setTitle(value: string): void;
+    setArtist(value: string): void;
+    setAlbum(value: string): void;
+    setComment(value: string): void;
+    setGenre(value: string): void;
+    setYear(value: number): void;
+    setTrack(value: number): void;
+}
+export interface AudioPropertiesWrapper {
+    lengthInSeconds(): number;
+    lengthInMilliseconds(): number;
+    bitrate(): number;
+    sampleRate(): number;
+    channels(): number;
+}
+export interface TagLibModule extends Omit<EmscriptenModule, 'then'> {
+    FileHandle: new () => FileHandle;
+    TagWrapper: new () => TagWrapper;
+    AudioPropertiesWrapper: new () => AudioPropertiesWrapper;
+    createFileHandle(): FileHandle;
+    _taglib_file_new_from_buffer?(ptr: number, size: number): number;
+    _taglib_file_delete?(fileId: number): void;
+    _taglib_file_is_valid?(fileId: number): number;
+    _taglib_file_format?(fileId: number): number;
+    _taglib_file_tag?(fileId: number): number;
+    _taglib_file_audioproperties?(fileId: number): number;
+    _taglib_file_save?(fileId: number): number;
+    _taglib_tag_title?(tagPtr: number): number;
+    _taglib_tag_artist?(tagPtr: number): number;
+    _taglib_tag_album?(tagPtr: number): number;
+    _taglib_tag_comment?(tagPtr: number): number;
+    _taglib_tag_genre?(tagPtr: number): number;
+    _taglib_tag_year?(tagPtr: number): number;
+    _taglib_tag_track?(tagPtr: number): number;
+    _taglib_tag_set_title?(tagPtr: number, titlePtr: number): void;
+    _taglib_tag_set_artist?(tagPtr: number, artistPtr: number): void;
+    _taglib_tag_set_album?(tagPtr: number, albumPtr: number): void;
+    _taglib_tag_set_comment?(tagPtr: number, commentPtr: number): void;
+    _taglib_tag_set_genre?(tagPtr: number, genrePtr: number): void;
+    _taglib_tag_set_year?(tagPtr: number, year: number): void;
+    _taglib_tag_set_track?(tagPtr: number, track: number): void;
+    _taglib_audioproperties_length?(propsPtr: number): number;
+    _taglib_audioproperties_bitrate?(propsPtr: number): number;
+    _taglib_audioproperties_samplerate?(propsPtr: number): number;
+    _taglib_audioproperties_channels?(propsPtr: number): number;
+}
+export interface WasmModule extends EmscriptenModule {
+    FileHandle?: new () => FileHandle;
+    createFileHandle?(): FileHandle;
+}
+//# sourceMappingURL=wasm.d.ts.map

package/dist/src/wasm.d.ts.map

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

package/dist/src/wasm.ts

@@ -0,0 +1,133 @@
+/**
+ * @fileoverview WebAssembly module interface types for Emscripten
+ */
+
+// Basic Emscripten module interface
+export interface EmscriptenModule {
+  // Memory
+  HEAP8: Int8Array;
+  HEAP16: Int16Array;
+  HEAP32: Int32Array;
+  HEAPU8: Uint8Array;
+  HEAPU16: Uint16Array;
+  HEAPU32: Uint32Array;
+  HEAPF32: Float32Array;
+  HEAPF64: Float64Array;
+
+  // Memory management
+  _malloc(size: number): number;
+  _free(ptr: number): void;
+  allocate?(data: number[] | Uint8Array, allocator: number): number;
+  ALLOC_NORMAL?: number;
+
+  // String conversion
+  ccall?(
+    ident: string,
+    returnType: string,
+    argTypes: string[],
+    args: any[],
+  ): any;
+  cwrap?(
+    ident: string,
+    returnType: string,
+    argTypes: string[],
+  ): (...args: any[]) => any;
+
+  // File system (if enabled)
+  FS?: any;
+
+  // Runtime
+  then?(callback: (module: EmscriptenModule) => void): void;
+  onRuntimeInitialized?: () => void;
+}
+
+// Embind class interfaces
+export interface FileHandle {
+  loadFromBuffer(data: Uint8Array): boolean;
+  isValid(): boolean;
+  save(): boolean;
+  getFormat(): string;
+  getProperties(): any;
+  setProperties(props: any): void;
+  getProperty(key: string): string;
+  setProperty(key: string, value: string): void;
+  isMP4(): boolean;
+  getMP4Item(key: string): string;
+  setMP4Item(key: string, value: string): void;
+  removeMP4Item(key: string): void;
+  getTag(): TagWrapper;
+  getAudioProperties(): AudioPropertiesWrapper;
+}
+
+export interface TagWrapper {
+  title(): string;
+  artist(): string;
+  album(): string;
+  comment(): string;
+  genre(): string;
+  year(): number;
+  track(): number;
+  setTitle(value: string): void;
+  setArtist(value: string): void;
+  setAlbum(value: string): void;
+  setComment(value: string): void;
+  setGenre(value: string): void;
+  setYear(value: number): void;
+  setTrack(value: number): void;
+}
+
+export interface AudioPropertiesWrapper {
+  lengthInSeconds(): number;
+  lengthInMilliseconds(): number;
+  bitrate(): number;
+  sampleRate(): number;
+  channels(): number;
+}
+
+export interface TagLibModule extends Omit<EmscriptenModule, 'then'> {
+  // Embind classes
+  FileHandle: new () => FileHandle;
+  TagWrapper: new () => TagWrapper;
+  AudioPropertiesWrapper: new () => AudioPropertiesWrapper;
+
+  // Embind functions
+  createFileHandle(): FileHandle;
+
+  // C-style functions (optional - used by Workers API)
+  _taglib_file_new_from_buffer?(ptr: number, size: number): number;
+  _taglib_file_delete?(fileId: number): void;
+  _taglib_file_is_valid?(fileId: number): number;
+  _taglib_file_format?(fileId: number): number;
+  _taglib_file_tag?(fileId: number): number;
+  _taglib_file_audioproperties?(fileId: number): number;
+  _taglib_file_save?(fileId: number): number;
+
+  _taglib_tag_title?(tagPtr: number): number;
+  _taglib_tag_artist?(tagPtr: number): number;
+  _taglib_tag_album?(tagPtr: number): number;
+  _taglib_tag_comment?(tagPtr: number): number;
+  _taglib_tag_genre?(tagPtr: number): number;
+  _taglib_tag_year?(tagPtr: number): number;
+  _taglib_tag_track?(tagPtr: number): number;
+
+  _taglib_tag_set_title?(tagPtr: number, titlePtr: number): void;
+  _taglib_tag_set_artist?(tagPtr: number, artistPtr: number): void;
+  _taglib_tag_set_album?(tagPtr: number, albumPtr: number): void;
+  _taglib_tag_set_comment?(tagPtr: number, commentPtr: number): void;
+  _taglib_tag_set_genre?(tagPtr: number, genrePtr: number): void;
+  _taglib_tag_set_year?(tagPtr: number, year: number): void;
+  _taglib_tag_set_track?(tagPtr: number, track: number): void;
+
+  _taglib_audioproperties_length?(propsPtr: number): number;
+  _taglib_audioproperties_bitrate?(propsPtr: number): number;
+  _taglib_audioproperties_samplerate?(propsPtr: number): number;
+  _taglib_audioproperties_channels?(propsPtr: number): number;
+}
+
+export interface WasmModule extends EmscriptenModule {
+  // Alias for compatibility
+  FileHandle?: new () => FileHandle;
+  createFileHandle?(): FileHandle;
+}
+
+// Module loading function removed for modular imports

package/dist/src/web-utils.d.ts

@@ -0,0 +1,180 @@
+/**
+ * @fileoverview Web browser utilities for working with cover art in taglib-wasm
+ *
+ * This module provides browser-specific helpers for integrating taglib-wasm
+ * with web applications, including canvas integration and data URL support.
+ *
+ * @example
+ * ```typescript
+ * import { pictureToDataURL, setCoverArtFromCanvas } from "taglib-wasm/web-utils";
+ *
+ * // Display cover art in an <img> element
+ * const pictures = await readPictures("song.mp3");
+ * if (pictures.length > 0) {
+ *   const dataURL = pictureToDataURL(pictures[0]);
+ *   document.getElementById('cover').src = dataURL;
+ * }
+ *
+ * // Set cover art from a canvas
+ * const canvas = document.getElementById('myCanvas') as HTMLCanvasElement;
+ * const modifiedBuffer = await setCoverArtFromCanvas("song.mp3", canvas);
+ * ```
+ */
+import type { Picture } from "./types.ts";
+import { PictureType } from "./types.ts";
+/**
+ * Convert a Picture object to a data URL for display in web browsers
+ *
+ * @param picture - Picture object from taglib-wasm
+ * @returns Data URL string that can be used as src for <img> elements
+ *
+ * @example
+ * ```typescript
+ * const pictures = await readPictures("song.mp3");
+ * const imgElement = document.getElementById('coverArt') as HTMLImageElement;
+ * imgElement.src = pictureToDataURL(pictures[0]);
+ * ```
+ */
+export declare function pictureToDataURL(picture: Picture): string;
+/**
+ * Convert a data URL to a Picture object
+ *
+ * @param dataURL - Data URL string (e.g., "data:image/jpeg;base64,...")
+ * @param type - Picture type (defaults to FrontCover)
+ * @param description - Optional description
+ * @returns Picture object
+ *
+ * @example
+ * ```typescript
+ * const dataURL = canvas.toDataURL('image/jpeg');
+ * const picture = dataURLToPicture(dataURL, PictureType.FrontCover);
+ * const modifiedBuffer = await applyPictures("song.mp3", [picture]);
+ * ```
+ */
+export declare function dataURLToPicture(dataURL: string, type?: PictureType, description?: string): Picture;
+/**
+ * Set cover art from an HTML canvas element
+ *
+ * @param file - File path, Uint8Array buffer, ArrayBuffer, or File object
+ * @param canvas - HTMLCanvasElement containing the image
+ * @param options - Options for image format and quality
+ * @returns Modified file buffer with cover art from canvas
+ *
+ * @example
+ * ```typescript
+ * const canvas = document.getElementById('albumArt') as HTMLCanvasElement;
+ * const modifiedBuffer = await setCoverArtFromCanvas("song.mp3", canvas, {
+ *   format: 'image/jpeg',
+ *   quality: 0.9
+ * });
+ * ```
+ */
+export declare function setCoverArtFromCanvas(file: string | Uint8Array | ArrayBuffer | File, canvas: HTMLCanvasElement, options?: {
+    format?: 'image/jpeg' | 'image/png' | 'image/webp';
+    quality?: number;
+    type?: PictureType;
+    description?: string;
+}): Promise<Uint8Array>;
+/**
+ * Convert canvas to Picture object using blob for better performance
+ *
+ * This is more efficient than toDataURL for large images as it avoids
+ * the base64 encoding/decoding step.
+ *
+ * @param canvas - HTMLCanvasElement containing the image
+ * @param options - Options for image format and quality
+ * @returns Promise resolving to Picture object
+ *
+ * @example
+ * ```typescript
+ * const canvas = document.getElementById('albumArt') as HTMLCanvasElement;
+ * const picture = await canvasToPicture(canvas, {
+ *   format: 'image/png',
+ *   type: PictureType.BackCover
+ * });
+ * ```
+ */
+export declare function canvasToPicture(canvas: HTMLCanvasElement, options?: {
+    format?: 'image/jpeg' | 'image/png' | 'image/webp';
+    quality?: number;
+    type?: PictureType;
+    description?: string;
+}): Promise<Picture>;
+/**
+ * Load an image file into a Picture object
+ *
+ * @param file - File object from <input type="file"> or drag-and-drop
+ * @param type - Picture type (defaults to FrontCover)
+ * @param description - Optional description
+ * @returns Promise resolving to Picture object
+ *
+ * @example
+ * ```typescript
+ * // From file input
+ * const input = document.getElementById('fileInput') as HTMLInputElement;
+ * input.addEventListener('change', async (e) => {
+ *   const file = e.target.files[0];
+ *   const picture = await imageFileToPicture(file);
+ *   const modifiedBuffer = await applyPictures("song.mp3", [picture]);
+ * });
+ * ```
+ */
+export declare function imageFileToPicture(file: File, type?: PictureType, description?: string): Promise<Picture>;
+/**
+ * Display a Picture in an HTML img element
+ *
+ * @param picture - Picture object from taglib-wasm
+ * @param imgElement - HTMLImageElement to display the picture in
+ *
+ * @example
+ * ```typescript
+ * const pictures = await readPictures("song.mp3");
+ * const img = document.getElementById('coverArt') as HTMLImageElement;
+ * displayPicture(pictures[0], img);
+ * ```
+ */
+export declare function displayPicture(picture: Picture, imgElement: HTMLImageElement): void;
+/**
+ * Create a download link for a Picture
+ *
+ * @param picture - Picture object to download
+ * @param filename - Suggested filename for download
+ * @returns Temporary download URL (remember to revoke it after use)
+ *
+ * @example
+ * ```typescript
+ * const pictures = await readPictures("song.mp3");
+ * const downloadUrl = createPictureDownloadURL(pictures[0], "cover.jpg");
+ *
+ * const link = document.createElement('a');
+ * link.href = downloadUrl;
+ * link.download = "cover.jpg";
+ * link.click();
+ *
+ * // Clean up
+ * URL.revokeObjectURL(downloadUrl);
+ * ```
+ */
+export declare function createPictureDownloadURL(picture: Picture, filename?: string): string;
+/**
+ * Extract all pictures and create a gallery
+ *
+ * @param file - Audio file to extract pictures from
+ * @param container - HTML element to append gallery items to
+ * @param options - Gallery display options
+ *
+ * @example
+ * ```typescript
+ * const galleryDiv = document.getElementById('pictureGallery');
+ * await createPictureGallery("song.mp3", galleryDiv, {
+ *   className: 'album-art',
+ *   includeDescription: true
+ * });
+ * ```
+ */
+export declare function createPictureGallery(file: string | Uint8Array | ArrayBuffer | File, container: HTMLElement, options?: {
+    className?: string;
+    includeDescription?: boolean;
+    onClick?: (picture: Picture, index: number) => void;
+}): Promise<void>;
+//# sourceMappingURL=web-utils.d.ts.map