taglib-wasm 0.3.13 → 0.3.15

package/README.md

@@ -4,32 +4,30 @@
 [![npm version](https://img.shields.io/npm/v/taglib-wasm.svg?logo=nodedotjs&logoColor=f5f5f5)](https://www.npmjs.com/package/taglib-wasm)
 [![npm downloads](https://img.shields.io/npm/dm/taglib-wasm.svg)](https://www.npmjs.com/package/taglib-wasm)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://github.com/CharlesWiltgen/taglib-wasm/blob/main/LICENSE)
-<br>[![TypeScript](https://img.shields.io/badge/TypeScript-5-3178c6.svg?logo=typescript&logoColor=f5f5f5)](https://www.typescriptlang.org/)
+<br>[![Built with](https://img.shields.io/badge/TypeScript-5-3178c6.svg?logo=typescript&logoColor=f5f5f5)](https://www.typescriptlang.org/)
 [![Built with Emscripten](https://img.shields.io/badge/Built%20with-Emscripten-4B9BFF.svg)](https://emscripten.org/)
+[![Built with WebAssembly](https://img.shields.io/badge/Built%20with-WebAssembly-654ff0.svg?logo=webassembly&logoColor=white)](https://webassembly.org/)
 [![Built with TagLib](https://img.shields.io/badge/Built%20with-TagLib-brightgreen.svg)](https://taglib.org/)
 <br>[![Deno](https://img.shields.io/badge/Deno-000000?logo=deno&logoColor=white)](https://deno.land/)
 [![Node.js](https://img.shields.io/badge/Node.js-339933?logo=nodedotjs&logoColor=white)](https://nodejs.org/)
 [![Bun](https://img.shields.io/badge/Bun-000000?logo=bun&logoColor=white)](https://bun.sh/)
 [![Cloudflare Workers](https://img.shields.io/badge/Cloudflare%20Workers-F38020?logo=cloudflare&logoColor=white)](https://workers.cloudflare.com/)
 [![Electron](https://img.shields.io/badge/Electron-47848F?logo=electron&logoColor=white)](https://www.electronjs.org/)
-[![Browsers](https://img.shields.io/badge/Browser-4285F4?logo=googlechrome&logoColor=white)]()
+[![Browsers](https://img.shields.io/badge/Browsers-E34C26?logo=html5&logoColor=white)](https://html.spec.whatwg.org/multipage/)
 
-**TagLib-Wasm** is the universal tagging library for TypeScript platforms: Deno,
-Node.js, Bun, Cloudflare Workers, Electron, and browsers. It’s the answer to the
-question:
+TagLib-Wasm is the **universal tagging library for TypeScript/JavaScript**
+(TS|JS) platforms: **Deno**, **Node.js**, **Bun**, **Cloudflare Workers**,
+**Electron**, and **browsers**.
 
-> “What if [**TagLib**](https://taglib.org/), but TypeScript?”
-
-This project exists because the TypeScipt/JavaScript ecosystem had no
-battle-tested audio tagging library that supports reading and writing music
-metadata to all popular audio formats. It aspires to be a universal solution for
-all **TypeScript**-capable platforms — Deno, Node.js, Bun, Electron, Cloudflare
-Workers, and browsers.
+This project exists because the TS|JS ecosystem had no battle-tested audio
+tagging library that supports reading and writing music metadata to all popular
+audio formats. It aspires to be a universal solution for all TS|JS-capable
+platforms — Deno, Node.js, Bun, Electron, Cloudflare Workers, and browsers.
 
 TagLib-Wasm stands on the shoulders of giants, including
 [TagLib](https://taglib.org/) itself, [Emscripten](https://emscripten.org/), and
 [Wasm](https://webassembly.org/) ([WebAssembly](https://webassembly.org/)).
-TagLib itself is legendary and a core dependency of many music apps.
+TagLib itself is legendary, and a core dependency of many music apps.
 
 ## 🎯 Features
 
@@ -60,24 +58,9 @@ import { TagLib } from "npm:taglib-wasm";
 npm install taglib-wasm
 ```
 
-The package uses TypeScript. You have two options:
-
-#### Option 1: Use Node’s native TypeScript support
-
-```bash
-# Node.js 22.6.0+ with experimental flag
-node --experimental-strip-types your-script.ts
-
-# Node.js 23.6.0+ (no flag needed)
-node your-script.ts
-```
-
-#### Option 2: TypeScript loader (recommended for production)
-
-```bash
-npm install --save-dev tsx
-npx tsx your-script.ts
-```
+> **Note:** Requires Node.js v22.6.0 or higher. If you want to use the
+> TypeScript version with Node.js, see the
+> [installation guide](https://charleswiltgen.github.io/taglib-wasm/guide/installation.html).
 
 ### Bun
 
@@ -103,10 +86,10 @@ const { TagLib } = require("taglib-wasm");
 
 ## 🚀 Quick Start
 
-### Simple API (Recommended)
+### Simple API
 
 ```typescript
-import { readTags, applyTags, updateTags } from "taglib-wasm/simple";
+import { applyTags, readTags, updateTags } from "taglib-wasm/simple";
 
 // Read tags - just one function call!
 const tags = await readTags("song.mp3");
@@ -126,7 +109,10 @@ await updateTags("song.mp3", {
 });
 ```
 
-### Core API (Advanced)
+### Core API
+
+The full Core API might be a better choice for apps and utilities focused on
+advanced metadata management.
 
 ```typescript
 import { TagLib } from "taglib-wasm";
@@ -199,7 +185,8 @@ const modifiedBuffer = await setCoverArt("song.mp3", imageData, "image/jpeg");
 - ✅ **.flac** – Vorbis comments and audio properties
 - ✅ **.ogg** – Ogg Vorbis format with full metadata support
 - ✅ **.wav** – INFO chunk metadata
-- ✅ **Additional formats** – Opus, APE, MPC, WavPack, TrueAudio, AIFF, WMA, and more
+- ✅ **Additional formats** – Opus, APE, MPC, WavPack, TrueAudio, AIFF, WMA, and
+  more
 
 ## 🎯 Key Features
 

package/dist/index.d.ts

@@ -38,7 +38,7 @@
  * @see {@link AudioFile} - Audio file interface
  * @see {@link createTagLib} - Factory function for creating TagLib instances
  */
-export { AudioFileImpl as AudioFile, createTagLib, TagLib, } from "./src/taglib.ts";
+export { AudioFileImpl as AudioFile, createTagLib, TagLib, } from "./src/taglib";
 /**
  * Error types for proper error handling and debugging.
  * @see {@link TagLibError} - Base error class for all TagLib errors
@@ -50,7 +50,7 @@ export { AudioFileImpl as AudioFile, createTagLib, TagLib, } from "./src/taglib.
  * @see {@link MemoryError} - Wasm memory allocation issues
  * @see {@link EnvironmentError} - Runtime/environment issues
  */
-export { EnvironmentError, FileOperationError, InvalidFormatError, isEnvironmentError, isFileOperationError, isInvalidFormatError, isMemoryError, isMetadataError, isTagLibError, isUnsupportedFormatError, MemoryError, MetadataError, SUPPORTED_FORMATS, TagLibError, TagLibInitializationError, UnsupportedFormatError, } from "./src/errors.ts";
+export { EnvironmentError, FileOperationError, InvalidFormatError, isEnvironmentError, isFileOperationError, isInvalidFormatError, isMemoryError, isMetadataError, isTagLibError, isUnsupportedFormatError, MemoryError, MetadataError, SUPPORTED_FORMATS, TagLibError, TagLibInitializationError, UnsupportedFormatError, } from "./src/errors";
 /**
  * Simple API exports for easy tag reading and writing.
  * @see {@link readTags} - Read metadata from audio files
@@ -63,7 +63,7 @@ export { EnvironmentError, FileOperationError, InvalidFormatError, isEnvironment
  * @see {@link getCoverArt} - Get primary cover art data
  * @see {@link setCoverArt} - Set primary cover art
  */
-export { addPicture, applyPictures, applyTags, clearPictures, clearTags, findPictureByType, getCoverArt, getFormat, getPictureMetadata, isValidAudioFile, readPictures, readProperties, readTags, replacePictureByType, setCoverArt, updateTags } from "./src/simple.ts";
+export { addPicture, applyPictures, applyTags, clearPictures, clearTags, findPictureByType, getCoverArt, getFormat, getPictureMetadata, isValidAudioFile, readPictures, readProperties, readTags, replacePictureByType, setCoverArt, updateTags, } from "./src/simple";
 /**
  * Constants and utilities for tag name validation.
  * @see {@link Tags} - Standard tag name constants
@@ -71,21 +71,21 @@ export { addPicture, applyPictures, applyTags, clearPictures, clearTags, findPic
  * @see {@link isValidTagName} - Validate tag names
  * @see {@link getAllTagNames} - Get all valid tag names
  */
-export { FormatMappings, getAllTagNames, isValidTagName, Tags, } from "./src/constants.ts";
+export { FormatMappings, getAllTagNames, isValidTagName, Tags, } from "./src/constants";
 /**
  * File I/O utilities for cover art operations.
  * @see {@link exportCoverArt} - Export cover art to file
  * @see {@link importCoverArt} - Import cover art from file
  * @see {@link copyCoverArt} - Copy cover art between files
  */
-export { copyCoverArt, exportAllPictures, exportCoverArt, exportPictureByType, findCoverArtFiles, importCoverArt, importPictureWithType, loadPictureFromFile, savePictureToFile, } from "./src/file-utils.ts";
+export { copyCoverArt, exportAllPictures, exportCoverArt, exportPictureByType, findCoverArtFiles, importCoverArt, importPictureWithType, loadPictureFromFile, savePictureToFile, } from "./src/file-utils";
 /**
  * Web browser utilities for cover art operations.
  * @see {@link pictureToDataURL} - Convert picture to data URL
  * @see {@link setCoverArtFromCanvas} - Set cover art from HTML canvas
  * @see {@link displayPicture} - Display picture in HTML img element
  */
-export { canvasToPicture, createPictureDownloadURL, createPictureGallery, dataURLToPicture, displayPicture, imageFileToPicture, pictureToDataURL, setCoverArtFromCanvas, } from "./src/web-utils.ts";
+export { canvasToPicture, createPictureDownloadURL, createPictureGallery, dataURLToPicture, displayPicture, imageFileToPicture, pictureToDataURL, setCoverArtFromCanvas, } from "./src/web-utils";
 /**
  * Type exports for TypeScript users.
  * These types define the structure of metadata, audio properties,
@@ -96,18 +96,18 @@ export { canvasToPicture, createPictureDownloadURL, createPictureGallery, dataUR
  * @see {@link AudioProperties} - Audio technical properties
  * @see {@link TagLibConfig} - Configuration options
  */
-export type { AudioFormat, AudioProperties, ExtendedTag, FieldMapping, FileType, Picture, PropertyMap, Tag, TagLibConfig, TagName, } from "./src/types.ts";
+export type { AudioFormat, AudioProperties, ExtendedTag, FieldMapping, FileType, Picture, PropertyMap, Tag, TagLibConfig, TagName, } from "./src/types";
 /**
  * Enum exports
  */
-export { PictureType } from "./src/types.ts";
+export { PictureType } from "./src/types";
 /**
  * Wasm module types for advanced usage.
  * @see {@link TagLibModule} - Full TagLib Wasm module interface
  * @see {@link WasmModule} - Base Emscripten module interface
  */
-export type { TagLibModule, WasmModule } from "./src/wasm.ts";
-import type { TagLibModule } from "./src/wasm.ts";
+export type { TagLibModule, WasmModule } from "./src/wasm";
+import type { TagLibModule } from "./src/wasm";
 /**
  * Load the TagLib Wasm module.
  * This function initializes the WebAssembly module and returns

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH;;;;;GAKG;AACH,OAAO,EACL,aAAa,IAAI,SAAS,EAC1B,YAAY,EACZ,MAAM,GACP,MAAM,iBAAiB,CAAC;AAEzB;;;;;;;;;;GAUG;AACH,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,aAAa,EACb,eAAe,EACf,aAAa,EACb,wBAAwB,EACxB,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,WAAW,EACX,yBAAyB,EACzB,sBAAsB,GACvB,MAAM,iBAAiB,CAAC;AAEzB;;;;;;;;;;;GAWG;AACH,OAAO,EACL,UAAU,EACV,aAAa,EACb,SAAS,EACT,aAAa,EACb,SAAS,EACT,iBAAiB,EACjB,WAAW,EACX,SAAS,EACT,kBAAkB,EAClB,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,QAAQ,EACR,oBAAoB,EACpB,WAAW,EACX,UAAU,EACX,MAAM,iBAAiB,CAAC;AAEzB;;;;;;GAMG;AACH,OAAO,EACL,cAAc,EACd,cAAc,EACd,cAAc,EACd,IAAI,GACL,MAAM,oBAAoB,CAAC;AAC5B;;;;;GAKG;AACH,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,mBAAmB,EACnB,iBAAiB,EACjB,cAAc,EACd,qBAAqB,EACrB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAE7B;;;;;GAKG;AACH,OAAO,EACL,eAAe,EACf,wBAAwB,EACxB,oBAAoB,EACpB,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,oBAAoB,CAAC;AAE5B;;;;;;;;;GASG;AACH,YAAY,EACV,WAAW,EACX,eAAe,EACf,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,OAAO,EACP,WAAW,EACX,GAAG,EACH,YAAY,EACZ,OAAO,GACR,MAAM,gBAAgB,CAAC;AAExB;;GAEG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C;;;;GAIG;AACH,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAG9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,YAAY,CAAC,CAO9D"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH;;;;;GAKG;AACH,OAAO,EACL,aAAa,IAAI,SAAS,EAC1B,YAAY,EACZ,MAAM,GACP,MAAM,cAAc,CAAC;AAEtB;;;;;;;;;;GAUG;AACH,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,aAAa,EACb,eAAe,EACf,aAAa,EACb,wBAAwB,EACxB,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,WAAW,EACX,yBAAyB,EACzB,sBAAsB,GACvB,MAAM,cAAc,CAAC;AAEtB;;;;;;;;;;;GAWG;AACH,OAAO,EACL,UAAU,EACV,aAAa,EACb,SAAS,EACT,aAAa,EACb,SAAS,EACT,iBAAiB,EACjB,WAAW,EACX,SAAS,EACT,kBAAkB,EAClB,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,QAAQ,EACR,oBAAoB,EACpB,WAAW,EACX,UAAU,GACX,MAAM,cAAc,CAAC;AAEtB;;;;;;GAMG;AACH,OAAO,EACL,cAAc,EACd,cAAc,EACd,cAAc,EACd,IAAI,GACL,MAAM,iBAAiB,CAAC;AACzB;;;;;GAKG;AACH,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,mBAAmB,EACnB,iBAAiB,EACjB,cAAc,EACd,qBAAqB,EACrB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAE1B;;;;;GAKG;AACH,OAAO,EACL,eAAe,EACf,wBAAwB,EACxB,oBAAoB,EACpB,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,iBAAiB,CAAC;AAEzB;;;;;;;;;GASG;AACH,YAAY,EACV,WAAW,EACX,eAAe,EACf,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,OAAO,EACP,WAAW,EACX,GAAG,EACH,YAAY,EACZ,OAAO,GACR,MAAM,aAAa,CAAC;AAErB;;GAEG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C;;;;GAIG;AACH,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAG3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,YAAY,CAAC,CAO9D"}

package/dist/index.js

@@ -1,135 +1,118 @@
-// index.ts
-import {
-  AudioFileImpl,
-  createTagLib,
-  TagLib
-} from "./src/taglib.ts";
-import {
-  EnvironmentError,
-  FileOperationError,
-  InvalidFormatError,
-  isEnvironmentError,
-  isFileOperationError,
-  isInvalidFormatError,
-  isMemoryError,
-  isMetadataError,
-  isTagLibError,
-  isUnsupportedFormatError,
-  MemoryError,
-  MetadataError,
-  SUPPORTED_FORMATS,
-  TagLibError,
-  TagLibInitializationError,
-  UnsupportedFormatError
-} from "./src/errors.ts";
-import {
-  addPicture,
-  applyPictures,
-  applyTags,
-  clearPictures,
-  clearTags,
-  findPictureByType,
-  getCoverArt,
-  getFormat,
-  getPictureMetadata,
-  isValidAudioFile,
-  readPictures,
-  readProperties,
-  readTags,
-  replacePictureByType,
-  setCoverArt,
-  updateTags
-} from "./src/simple.ts";
-import {
-  FormatMappings,
-  getAllTagNames,
-  isValidTagName,
-  Tags
-} from "./src/constants.ts";
-import {
-  copyCoverArt,
-  exportAllPictures,
-  exportCoverArt,
-  exportPictureByType,
-  findCoverArtFiles,
-  importCoverArt,
-  importPictureWithType,
-  loadPictureFromFile,
-  savePictureToFile
-} from "./src/file-utils.ts";
-import {
-  canvasToPicture,
-  createPictureDownloadURL,
-  createPictureGallery,
-  dataURLToPicture,
-  displayPicture,
-  imageFileToPicture,
-  pictureToDataURL,
-  setCoverArtFromCanvas
-} from "./src/web-utils.ts";
-import { PictureType } from "./src/types.ts";
-async function loadTagLibModule() {
-  const { default: createTagLibModule } = await import("./build/taglib-wrapper.js");
-  const module = await createTagLibModule();
-  return module;
+/**
+ * @fileoverview Main module exports for taglib-wasm
+ *
+ * TagLib v2.1 compiled to WebAssembly with TypeScript bindings
+ * for universal audio metadata handling across all JavaScript runtimes.
+ *
+ * @module taglib-wasm
+ *
+ * @example
+ * ```typescript
+ * // Using the Core API
+ * import { TagLib } from "taglib-wasm";
+ *
+ * const taglib = await TagLib.initialize();
+ * const file = await taglib.open(audioBuffer);
+ * const tag = file.tag();
+ * console.log(tag.title);
+ * file.dispose();
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Using the Simple API
+ * import { readTags, applyTags } from "taglib-wasm/simple";
+ *
+ * const tags = await readTags("song.mp3");
+ * console.log(tags.artist);
+ *
+ * const modified = await applyTags("song.mp3", {
+ *   artist: "New Artist",
+ *   album: "New Album"
+ * });
+ * ```
+ */
+/**
+ * Core API exports for advanced usage with full control.
+ * @see {@link TagLib} - Main TagLib class
+ * @see {@link AudioFile} - Audio file interface
+ * @see {@link createTagLib} - Factory function for creating TagLib instances
+ */
+export { AudioFileImpl as AudioFile, createTagLib, TagLib, } from "./src/taglib.js";
+/**
+ * Error types for proper error handling and debugging.
+ * @see {@link TagLibError} - Base error class for all TagLib errors
+ * @see {@link TagLibInitializationError} - Wasm initialization failures
+ * @see {@link InvalidFormatError} - Invalid or corrupted file format
+ * @see {@link UnsupportedFormatError} - Valid but unsupported format
+ * @see {@link FileOperationError} - File read/write/save failures
+ * @see {@link MetadataError} - Tag reading/writing failures
+ * @see {@link MemoryError} - Wasm memory allocation issues
+ * @see {@link EnvironmentError} - Runtime/environment issues
+ */
+export { EnvironmentError, FileOperationError, InvalidFormatError, isEnvironmentError, isFileOperationError, isInvalidFormatError, isMemoryError, isMetadataError, isTagLibError, isUnsupportedFormatError, MemoryError, MetadataError, SUPPORTED_FORMATS, TagLibError, TagLibInitializationError, UnsupportedFormatError, } from "./src/errors.js";
+/**
+ * Simple API exports for easy tag reading and writing.
+ * @see {@link readTags} - Read metadata from audio files
+ * @see {@link applyTags} - Apply metadata changes and return modified buffer
+ * @see {@link updateTags} - Update metadata and save to disk
+ * @see {@link writeTags} - Deprecated alias for applyTags
+ * @see {@link readProperties} - Read audio properties
+ * @see {@link readPictures} - Read cover art/pictures
+ * @see {@link applyPictures} - Apply pictures to audio files
+ * @see {@link getCoverArt} - Get primary cover art data
+ * @see {@link setCoverArt} - Set primary cover art
+ */
+export { addPicture, applyPictures, applyTags, clearPictures, clearTags, findPictureByType, getCoverArt, getFormat, getPictureMetadata, isValidAudioFile, readPictures, readProperties, readTags, replacePictureByType, setCoverArt, updateTags, } from "./src/simple.js";
+/**
+ * Constants and utilities for tag name validation.
+ * @see {@link Tags} - Standard tag name constants
+ * @see {@link FormatMappings} - Format-specific field mappings
+ * @see {@link isValidTagName} - Validate tag names
+ * @see {@link getAllTagNames} - Get all valid tag names
+ */
+export { FormatMappings, getAllTagNames, isValidTagName, Tags, } from "./src/constants.js";
+/**
+ * File I/O utilities for cover art operations.
+ * @see {@link exportCoverArt} - Export cover art to file
+ * @see {@link importCoverArt} - Import cover art from file
+ * @see {@link copyCoverArt} - Copy cover art between files
+ */
+export { copyCoverArt, exportAllPictures, exportCoverArt, exportPictureByType, findCoverArtFiles, importCoverArt, importPictureWithType, loadPictureFromFile, savePictureToFile, } from "./src/file-utils.js";
+/**
+ * Web browser utilities for cover art operations.
+ * @see {@link pictureToDataURL} - Convert picture to data URL
+ * @see {@link setCoverArtFromCanvas} - Set cover art from HTML canvas
+ * @see {@link displayPicture} - Display picture in HTML img element
+ */
+export { canvasToPicture, createPictureDownloadURL, createPictureGallery, dataURLToPicture, displayPicture, imageFileToPicture, pictureToDataURL, setCoverArtFromCanvas, } from "./src/web-utils.js";
+/**
+ * Enum exports
+ */
+export { PictureType } from "./src/types.js";
+/**
+ * Load the TagLib Wasm module.
+ * This function initializes the WebAssembly module and returns
+ * the loaded module for use with the Core API.
+ *
+ * @returns Promise resolving to the initialized TagLib module
+ *
+ * @example
+ * ```typescript
+ * import { loadTagLibModule, createTagLib } from "taglib-wasm";
+ *
+ * // Manual module loading for advanced configuration
+ * const module = await loadTagLibModule();
+ * const taglib = await createTagLib(module);
+ * ```
+ *
+ * @note Most users should use `TagLib.initialize()` instead,
+ * which handles module loading automatically.
+ */
+export async function loadTagLibModule() {
+    // Now that we're using ES6 modules, we can use dynamic import directly
+    const { default: createTagLibModule } = await import("./build/taglib-wrapper.js");
+    const module = await createTagLibModule();
+    return module;
 }
-export {
-  AudioFileImpl as AudioFile,
-  EnvironmentError,
-  FileOperationError,
-  FormatMappings,
-  InvalidFormatError,
-  MemoryError,
-  MetadataError,
-  PictureType,
-  SUPPORTED_FORMATS,
-  TagLib,
-  TagLibError,
-  TagLibInitializationError,
-  Tags,
-  UnsupportedFormatError,
-  addPicture,
-  applyPictures,
-  applyTags,
-  canvasToPicture,
-  clearPictures,
-  clearTags,
-  copyCoverArt,
-  createPictureDownloadURL,
-  createPictureGallery,
-  createTagLib,
-  dataURLToPicture,
-  displayPicture,
-  exportAllPictures,
-  exportCoverArt,
-  exportPictureByType,
-  findCoverArtFiles,
-  findPictureByType,
-  getAllTagNames,
-  getCoverArt,
-  getFormat,
-  getPictureMetadata,
-  imageFileToPicture,
-  importCoverArt,
-  importPictureWithType,
-  isEnvironmentError,
-  isFileOperationError,
-  isInvalidFormatError,
-  isMemoryError,
-  isMetadataError,
-  isTagLibError,
-  isUnsupportedFormatError,
-  isValidAudioFile,
-  isValidTagName,
-  loadPictureFromFile,
-  loadTagLibModule,
-  pictureToDataURL,
-  readPictures,
-  readProperties,
-  readTags,
-  replacePictureByType,
-  savePictureToFile,
-  setCoverArt,
-  setCoverArtFromCanvas,
-  updateTags
-};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH;;;;;GAKG;AACH,OAAO,EACL,aAAa,IAAI,SAAS,EAC1B,YAAY,EACZ,MAAM,GACP,MAAM,cAAc,CAAC;AAEtB;;;;;;;;;;GAUG;AACH,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,aAAa,EACb,eAAe,EACf,aAAa,EACb,wBAAwB,EACxB,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,WAAW,EACX,yBAAyB,EACzB,sBAAsB,GACvB,MAAM,cAAc,CAAC;AAEtB;;;;;;;;;;;GAWG;AACH,OAAO,EACL,UAAU,EACV,aAAa,EACb,SAAS,EACT,aAAa,EACb,SAAS,EACT,iBAAiB,EACjB,WAAW,EACX,SAAS,EACT,kBAAkB,EAClB,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,QAAQ,EACR,oBAAoB,EACpB,WAAW,EACX,UAAU,GACX,MAAM,cAAc,CAAC;AAEtB;;;;;;GAMG;AACH,OAAO,EACL,cAAc,EACd,cAAc,EACd,cAAc,EACd,IAAI,GACL,MAAM,iBAAiB,CAAC;AACzB;;;;;GAKG;AACH,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,mBAAmB,EACnB,iBAAiB,EACjB,cAAc,EACd,qBAAqB,EACrB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAE1B;;;;;GAKG;AACH,OAAO,EACL,eAAe,EACf,wBAAwB,EACxB,oBAAoB,EACpB,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,iBAAiB,CAAC;AAyBzB;;GAEG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAY1C;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB;IACpC,uEAAuE;IACvE,MAAM,EAAE,OAAO,EAAE,kBAAkB,EAAE,GAAG,MAAM,MAAM,CAClD,2BAA2B,CAC5B,CAAC;IACF,MAAM,MAAM,GAAG,MAAM,kBAAkB,EAAE,CAAC;IAC1C,OAAO,MAAsB,CAAC;AAChC,CAAC"}

package/dist/src/constants.js

@@ -0,0 +1,211 @@
+/**
+ * Standard tag property names used by TagLib.
+ * These constants provide type-safe access to tag properties with IDE autocomplete.
+ *
+ * @example
+ * ```typescript
+ * import { Tags } from 'taglib-wasm';
+ *
+ * // Read tags
+ * const title = file.tag.properties.get(Tags.Title);
+ * const artist = file.tag.properties.get(Tags.Artist);
+ *
+ * // Write tags
+ * file.tag.properties.set(Tags.Album, "Dark Side of the Moon");
+ * file.tag.properties.set(Tags.Year, "1973");
+ * ```
+ */
+export const Tags = {
+    // Basic Properties
+    /** Track/song title */
+    Title: "TITLE",
+    /** Primary performer(s) */
+    Artist: "ARTIST",
+    /** Album/collection name */
+    Album: "ALBUM",
+    /** Date of recording (year) */
+    Date: "DATE",
+    /** Track number on album */
+    TrackNumber: "TRACKNUMBER",
+    /** Musical genre */
+    Genre: "GENRE",
+    /** Comments/notes */
+    Comment: "COMMENT",
+    // Extended Properties
+    /** Band/orchestra/ensemble */
+    AlbumArtist: "ALBUMARTIST",
+    /** Original composer(s) */
+    Composer: "COMPOSER",
+    /** Copyright information */
+    Copyright: "COPYRIGHT",
+    /** Encoding software/person */
+    EncodedBy: "ENCODEDBY",
+    /** Disc number for multi-disc sets */
+    DiscNumber: "DISCNUMBER",
+    /** Beats per minute */
+    Bpm: "BPM",
+    /** Lyrics/text writer(s) */
+    Lyricist: "LYRICIST",
+    /** Conductor */
+    Conductor: "CONDUCTOR",
+    /** Person who remixed */
+    Remixer: "REMIXEDBY",
+    /** Language of vocals/lyrics */
+    Language: "LANGUAGE",
+    /** Publisher */
+    Publisher: "PUBLISHER",
+    /** Mood/atmosphere */
+    Mood: "MOOD",
+    /** Media type (CD, vinyl, etc.) */
+    Media: "MEDIA",
+    /** Radio station owner */
+    RadioStationOwner: "RADIOSTATIONOWNER",
+    /** Producer */
+    Producer: "PRODUCER",
+    /** Album subtitle */
+    Subtitle: "SUBTITLE",
+    /** Release label */
+    Label: "LABEL",
+    // Sorting Properties
+    /** Sort name for title */
+    TitleSort: "TITLESORT",
+    /** Sort name for artist */
+    ArtistSort: "ARTISTSORT",
+    /** Sort name for album artist */
+    AlbumArtistSort: "ALBUMARTISTSORT",
+    /** Sort name for album */
+    AlbumSort: "ALBUMSORT",
+    /** Sort name for composer */
+    ComposerSort: "COMPOSERSORT",
+    // Identifiers
+    /** International Standard Recording Code */
+    Isrc: "ISRC",
+    /** Amazon Standard Identification Number */
+    Asin: "ASIN",
+    /** Catalog number */
+    CatalogNumber: "CATALOGNUMBER",
+    /** Barcode (EAN/UPC) */
+    Barcode: "BARCODE",
+    // MusicBrainz Identifiers
+    /** MusicBrainz Artist ID */
+    MusicBrainzArtistId: "MUSICBRAINZ_ARTISTID",
+    /** MusicBrainz Release Artist ID */
+    MusicBrainzReleaseArtistId: "MUSICBRAINZ_ALBUMARTISTID",
+    /** MusicBrainz Work ID */
+    MusicBrainzWorkId: "MUSICBRAINZ_WORKID",
+    /** MusicBrainz Release ID */
+    MusicBrainzReleaseId: "MUSICBRAINZ_ALBUMID",
+    /** MusicBrainz Recording ID */
+    MusicBrainzRecordingId: "MUSICBRAINZ_TRACKID",
+    /** MusicBrainz Track ID (deprecated, use RecordingId) */
+    MusicBrainzTrackId: "MUSICBRAINZ_TRACKID",
+    /** MusicBrainz Release Group ID */
+    MusicBrainzReleaseGroupId: "MUSICBRAINZ_RELEASEGROUPID",
+    /** MusicBrainz Release Track ID */
+    MusicBrainzReleaseTrackId: "MUSICBRAINZ_RELEASETRACKID",
+    // Podcast Properties
+    /** Podcast identifier */
+    PodcastId: "PODCASTID",
+    /** Podcast URL */
+    PodcastUrl: "PODCASTURL",
+    // Grouping and Work
+    /** Content group/work */
+    Grouping: "GROUPING",
+    /** Work name */
+    Work: "WORK",
+    // Additional Metadata
+    /** Lyrics content */
+    Lyrics: "LYRICS",
+    /** Album gain (ReplayGain) */
+    AlbumGain: "REPLAYGAIN_ALBUM_GAIN",
+    /** Album peak (ReplayGain) */
+    AlbumPeak: "REPLAYGAIN_ALBUM_PEAK",
+    /** Track gain (ReplayGain) */
+    TrackGain: "REPLAYGAIN_TRACK_GAIN",
+    /** Track peak (ReplayGain) */
+    TrackPeak: "REPLAYGAIN_TRACK_PEAK",
+    // Special handling
+    /** Original artist for covers */
+    OriginalArtist: "ORIGINALARTIST",
+    /** Original album */
+    OriginalAlbum: "ORIGINALALBUM",
+    /** Original release date */
+    OriginalDate: "ORIGINALDATE",
+    /** Script/writing system */
+    Script: "SCRIPT",
+    /** Involved people list */
+    InvolvedPeopleList: "INVOLVEDPEOPLELIST",
+    // Technical Properties
+    /** Encoder settings/software */
+    EncoderSettings: "ENCODERSETTINGS",
+    /** Source media */
+    SourceMedia: "SOURCEMEDIA",
+};
+/**
+ * Type guard to check if a string is a valid tag name
+ */
+export function isValidTagName(name) {
+    return Object.values(Tags).includes(name);
+}
+/**
+ * Get all available tag names as an array
+ */
+export function getAllTagNames() {
+    return Object.values(Tags);
+}
+/**
+ * Format-specific tag mappings (for reference only - TagLib handles these automatically)
+ * This shows how standard property names map to format-specific identifiers.
+ */
+export const FormatMappings = {
+    Title: {
+        id3v2: "TIT2",
+        mp4: "©nam",
+        vorbis: "TITLE",
+        ape: "Title",
+        riff: "INAM",
+    },
+    Artist: {
+        id3v2: "TPE1",
+        mp4: "©ART",
+        vorbis: "ARTIST",
+        ape: "Artist",
+        riff: "IART",
+    },
+    Album: {
+        id3v2: "TALB",
+        mp4: "©alb",
+        vorbis: "ALBUM",
+        ape: "Album",
+        riff: "IPRD",
+    },
+    Date: {
+        id3v2: "TDRC",
+        mp4: "©day",
+        vorbis: "DATE",
+        ape: "Year",
+        riff: "ICRD",
+    },
+    Genre: {
+        id3v2: "TCON",
+        mp4: "©gen",
+        vorbis: "GENRE",
+        ape: "Genre",
+        riff: "IGNR",
+    },
+    Comment: {
+        id3v2: "COMM",
+        mp4: "©cmt",
+        vorbis: "COMMENT",
+        ape: "Comment",
+        riff: "ICMT",
+    },
+    TrackNumber: {
+        id3v2: "TRCK",
+        mp4: "trkn",
+        vorbis: "TRACKNUMBER",
+        ape: "Track",
+        riff: "ITRK",
+    },
+};
+//# sourceMappingURL=constants.js.map