taglib-wasm 1.0.0-beta.9 → 1.0.0

package/LICENSE

@@ -44,4 +44,4 @@ To rebuild the WebAssembly binary with a modified TagLib:
 3. The new binary will be in build/taglib.wasm
 
 For more information about LGPL compliance and dual licensing, see:
-https://github.com/CharlesWiltgen/taglib-wasm#licensing
+https://github.com/CharlesWiltgen/TagLib-Wasm#licensing

package/README.md

@@ -1,9 +1,9 @@
 # TagLib-Wasm
 
-[![Tests](https://github.com/CharlesWiltgen/taglib-wasm/actions/workflows/test.yml/badge.svg)](https://github.com/CharlesWiltgen/taglib-wasm/actions/workflows/test.yml)
+[![Tests](https://github.com/CharlesWiltgen/TagLib-Wasm/actions/workflows/test.yml/badge.svg)](https://github.com/CharlesWiltgen/TagLib-Wasm/actions/workflows/test.yml)
 [![npm version](https://img.shields.io/npm/v/taglib-wasm.svg)](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)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://github.com/CharlesWiltgen/TagLib-Wasm/blob/main/LICENSE)
 <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/)
@@ -52,9 +52,10 @@ import { TagLib } from "@charlesw/taglib-wasm";
 npm install taglib-wasm
 ```
 
-> **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).
+> **Note:** Requires Node.js v22.6.0 or higher (for WebAssembly exception
+> handling and `import.meta.url` support). 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
 
@@ -98,7 +99,7 @@ const taglib = await initializeForDenoCompile();
 ```
 
 See the
-[complete Deno compile guide](https://charleswiltgen.github.io/taglib-wasm/guide/deno-compile.html)
+[complete Deno compile guide](https://charleswiltgen.github.io/TagLib-Wasm/guide/deno-compile.html)
 for more options including CDN loading.
 
 For manual control:
@@ -119,11 +120,11 @@ const taglib = await TagLib.initialize({ wasmBinary });
 ### Simple API
 
 ```typescript
-import { applyTags, readTags, updateTags } from "taglib-wasm/simple";
+import { applyTags, applyTagsToFile, readTags } from "taglib-wasm/simple";
 
-// Read tags
+// Read tags (string fields are arrays to support multi-value metadata)
 const tags = await readTags("song.mp3");
-console.log(tags.title, tags.artist, tags.album);
+console.log(tags.title?.[0], tags.artist?.[0], tags.album?.[0]);
 
 // Apply tags and get modified buffer (in-memory)
 const modifiedBuffer = await applyTags("song.mp3", {
@@ -133,7 +134,7 @@ const modifiedBuffer = await applyTags("song.mp3", {
 });
 
 // Or update tags on disk (requires file path)
-await updateTags("song.mp3", {
+await applyTagsToFile("song.mp3", {
   title: "New Title",
   artist: "New Artist",
 });
@@ -191,18 +192,23 @@ import { findDuplicates, scanFolder } from "taglib-wasm";
 // Scan a music library
 const result = await scanFolder("/path/to/music", {
   recursive: true,
-  concurrency: 4,
   onProgress: (processed, total, file) => {
     console.log(`Processing ${processed}/${total}: ${file}`);
   },
 });
 
-console.log(`Found ${result.totalFound} audio files`);
-console.log(`Successfully processed ${result.totalProcessed} files`);
+console.log(`Found ${result.items.length} audio files`);
+console.log(
+  `Successfully processed ${
+    result.items.filter((i) => i.status === "ok").length
+  } files`,
+);
 
 // Process results
-for (const file of result.files) {
-  console.log(`${file.path}: ${file.tags.artist} - ${file.tags.title}`);
+for (const file of result.items) {
+  console.log(
+    `${file.path}: ${file.tags.artist?.[0]} - ${file.tags.title?.[0]}`,
+  );
   console.log(`Duration: ${file.properties?.duration}s`);
 }
 
@@ -249,7 +255,7 @@ file.setRating(0.8);
 file.save();
 ```
 
-See the [Track Ratings Guide](https://charleswiltgen.github.io/taglib-wasm/guide/ratings.html)
+See the [Track Ratings Guide](https://charleswiltgen.github.io/TagLib-Wasm/guide/ratings.html)
 for RatingUtils API and cross-format conversion details.
 
 ### Container Format and Codec Detection
@@ -266,7 +272,7 @@ console.log(props.isLossless); // false for AAC, true for ALAC
 console.log(props.bitsPerSample); // 16 for most formats
 console.log(props.bitrate); // 256 (kbps)
 console.log(props.sampleRate); // 44100 (Hz)
-console.log(props.length); // 180 (duration in seconds)
+console.log(props.duration); // 180 (duration in seconds)
 ```
 
 Container format vs Codec:
@@ -285,26 +291,26 @@ Supported formats:
 
 ## Documentation
 
-**[View Full Documentation](https://charleswiltgen.github.io/taglib-wasm/)**
+**[View Full Documentation](https://charleswiltgen.github.io/TagLib-Wasm/)**
 
 ### Getting Started
 
-- [Installation Guide](https://charleswiltgen.github.io/taglib-wasm/guide/installation.html)
-- [Quick Start Tutorial](https://charleswiltgen.github.io/taglib-wasm/guide/quick-start.html)
-- [All Examples](https://charleswiltgen.github.io/taglib-wasm/guide/examples.html)
+- [Installation Guide](https://charleswiltgen.github.io/TagLib-Wasm/guide/installation.html)
+- [Quick Start Tutorial](https://charleswiltgen.github.io/TagLib-Wasm/guide/quick-start.html)
+- [All Examples](https://charleswiltgen.github.io/TagLib-Wasm/guide/examples.html)
 
 ### Guides
 
-- [API Reference](https://charleswiltgen.github.io/taglib-wasm/api/)
-- [Performance Guide](https://charleswiltgen.github.io/taglib-wasm/concepts/performance.html)
-- [Album Processing Guide](https://charleswiltgen.github.io/taglib-wasm/guide/album-processing.html) - Process entire albums in seconds
-- [Platform Examples](https://charleswiltgen.github.io/taglib-wasm/guide/platform-examples.html)
-- [Working with Cover Art](https://charleswiltgen.github.io/taglib-wasm/guide/cover-art.html)
-- [Track Ratings](https://charleswiltgen.github.io/taglib-wasm/guide/ratings.html)
-- [Cloudflare Workers Setup](https://charleswiltgen.github.io/taglib-wasm/guide/workers-setup.html)
-- [Error Handling](https://charleswiltgen.github.io/taglib-wasm/concepts/error-handling.html)
-
+- [API Reference](https://charleswiltgen.github.io/TagLib-Wasm/api/)
+- [Performance Guide](https://charleswiltgen.github.io/TagLib-Wasm/concepts/performance.html)
+- [Album Processing Guide](https://charleswiltgen.github.io/TagLib-Wasm/guide/album-processing.html)
+- [Platform Examples](https://charleswiltgen.github.io/TagLib-Wasm/guide/platform-examples.html)
+- [Working with Cover Art](https://charleswiltgen.github.io/TagLib-Wasm/guide/cover-art.html)
+- [Track Ratings](https://charleswiltgen.github.io/TagLib-Wasm/guide/ratings.html)
+- [Cloudflare Workers](https://charleswiltgen.github.io/TagLib-Wasm/advanced/cloudflare-workers.html)
+- [Error Handling](https://charleswiltgen.github.io/TagLib-Wasm/concepts/error-handling.html)
 - [Contributing](CONTRIBUTING.md)
+- [AI Agent Documentation](AGENTS.md)
 
 ## Supported Formats
 
@@ -380,49 +386,25 @@ await file.saveToFile(); // Full file loaded only here
 
 taglib-wasm auto-selects the fastest available backend — no configuration needed:
 
-| Environment              | Backend           | How it works                                           | Performance    |
-| ------------------------ | ----------------- | ------------------------------------------------------ | -------------- |
-| **Deno / Node.js / Bun** | WASI (auto)       | Seek-based filesystem I/O; reads only headers and tags | Fastest        |
-| **Browsers / Workers**   | Emscripten (auto) | Entire file loaded into memory as buffer               | Baseline       |
-| **Opt-in**               | Wasmtime sidecar  | Out-of-process WASI with direct filesystem access      | Best for batch |
+| Environment              | Backend           | How it works                                           | Performance |
+| ------------------------ | ----------------- | ------------------------------------------------------ | ----------- |
+| **Deno / Node.js / Bun** | WASI (auto)       | Seek-based filesystem I/O; reads only headers and tags | Fastest     |
+| **Browsers / Workers**   | Emscripten (auto) | Entire file loaded into memory as buffer               | Baseline    |
 
-On Deno, Node.js, and Bun you get WASI automatically — nothing to configure. For
-heavy batch workloads, the optional Wasmtime sidecar provides direct filesystem
-access via a sandboxed subprocess:
-
-```bash
-# Optional: Install Wasmtime for sidecar mode
-curl https://wasmtime.dev/install.sh -sSf | bash
-```
-
-```typescript
-import { readTags, setSidecarConfig } from "taglib-wasm/simple";
-
-// Enable sidecar mode (requires Wasmtime)
-await setSidecarConfig({
-  preopens: { "/music": "/home/user/Music" },
-});
-
-// Now path-based calls use direct WASI filesystem access
-const tags = await readTags("/music/song.mp3");
-```
-
-See the
-[Runtime Compatibility Guide](https://charleswiltgen.github.io/taglib-wasm/concepts/runtime-compatibility.html)
-for full sidecar configuration options.
+On Deno, Node.js, and Bun you get WASI automatically — nothing to configure.
 
 ## Runtime Compatibility
 
 `taglib-wasm` works across all major JavaScript runtimes:
 
-| Runtime                | Status  | Installation              | Notes                                                                                                   |
-| ---------------------- | ------- | ------------------------- | ------------------------------------------------------------------------------------------------------- |
-| **Deno**               | Full    | `npm:taglib-wasm`         | Native TypeScript                                                                                       |
-| **Node.js**            | Full    | `npm install taglib-wasm` | TypeScript via tsx                                                                                      |
-| **Bun**                | Partial | `bun add taglib-wasm`     | Import + init verified; full test suite is Deno-only                                                    |
-| **Browser**            | Full    | Via bundler               | Full API support                                                                                        |
-| **Cloudflare Workers** | Partial | `taglib-wasm/workers`     | Basic tags only; see [Workers limitations](docs/advanced/cloudflare-workers.md#workers-api-limitations) |
-| **Electron**           | Node.js | `npm install taglib-wasm` | Main process; renderer via IPC                                                                          |
+| Runtime                | Status  | Installation              | Notes                                                                      |
+| ---------------------- | ------- | ------------------------- | -------------------------------------------------------------------------- |
+| **Deno**               | Full    | `npm:taglib-wasm`         | Native TypeScript                                                          |
+| **Node.js**            | Full    | `npm install taglib-wasm` | TypeScript via tsx                                                         |
+| **Bun**                | Partial | `bun add taglib-wasm`     | Import + init verified; full test suite is Deno-only                       |
+| **Browser**            | Full    | Via bundler               | Full API support                                                           |
+| **Cloudflare Workers** | Full    | `npm install taglib-wasm` | Same unified API; see [Workers guide](docs/advanced/cloudflare-workers.md) |
+| **Electron**           | Node.js | `npm install taglib-wasm` | Main process; renderer via IPC                                             |
 
 ## Known Limitations
 
@@ -430,8 +412,6 @@ for full sidecar configuration options.
   into memory. On Deno/Node.js, WASI reads only headers and tags from disk.
 - **Concurrent Access** – Not thread-safe (JavaScript single-threaded nature
   mitigates this)
-- **Cloudflare Workers** – Limited to 128MB memory per request; files larger
-  than ~100MB may fail
 
 ## Contributing
 

package/dist/folder.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Folder scanning and batch operations for audio file collections.
+ *
+ * @module folder
+ *
+ * @example
+ * ```typescript
+ * import { scanFolder, findDuplicates } from "@charlesw/taglib-wasm/folder";
+ *
+ * const result = await scanFolder("/path/to/music");
+ * for (const item of result.items) {
+ *   if (item.status === "ok") {
+ *     console.log(`${item.path}: ${item.tags.artist} - ${item.tags.title}`);
+ *   }
+ * }
+ * ```
+ */
+export * from "./src/folder-api/index.js";
+//# sourceMappingURL=folder.d.ts.map

package/dist/folder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"folder.d.ts","sourceRoot":"","sources":["../folder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,cAAc,2BAA2B,CAAC"}

package/dist/folder.js

@@ -0,0 +1,2 @@
+// folder.ts
+export * from "./src/folder-api/index.js";

package/dist/index.d.ts

@@ -1,10 +1,10 @@
 /**
- * @fileoverview Main module exports for taglib-wasm
+ * @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
+ * @module TagLib-Wasm
  *
  * @example
  * ```typescript
@@ -32,26 +32,27 @@
  * });
  * ```
  */
-export { AudioFileImpl as AudioFile, TagLib } from "./src/taglib.ts";
-export type { MutableTag } from "./src/taglib.ts";
-export { EnvironmentError, FileOperationError, InvalidFormatError, isEnvironmentError, isFileOperationError, isInvalidFormatError, isMemoryError, isMetadataError, isSidecarError, isTagLibError, isUnsupportedFormatError, isWorkerError, MemoryError, MetadataError, SidecarError, SUPPORTED_FORMATS, TagLibError, TagLibInitializationError, UnsupportedFormatError, WorkerError, } from "./src/errors.ts";
-export type { TagLibErrorCode } from "./src/errors.ts";
-export { initializeForDenoCompile, isDenoCompiled, prepareWasmForEmbedding, } from "./src/deno-compile.ts";
-export { addPicture, applyCoverArt, applyPictures, applyTags, applyTagsToBuffer, type BatchOptions, type BatchResult, clearPictures, clearTags, findPictureByType, isValidAudioFile, readCoverArt, readFormat, readMetadataBatch, readPictureMetadata, readPictures, readProperties, readPropertiesBatch, readTags, readTagsBatch, replacePictureByType, setBufferMode, setSidecarConfig, setWorkerPoolMode, updateTags, writeTagsToFile, } from "./src/simple/index.ts";
-export { FormatMappings, getAllProperties, getAllPropertyKeys, getAllTagNames, getPropertiesByFormat, getPropertyMetadata, isValidProperty, isValidTagName, PROPERTIES, Tags, } from "./src/constants.ts";
-export type { PropertyMetadata } from "./src/constants/property-types.ts";
-export { copyCoverArt, exportAllPictures, exportCoverArt, exportPictureByType, findCoverArtFiles, importCoverArt, importPictureWithType, loadPictureFromFile, savePictureToFile, } from "./src/file-utils/index.ts";
-export { type AudioDynamics, type AudioFileMetadata, exportFolderMetadata, findDuplicates, type FolderScanOptions, type FolderScanResult, scanFolder, updateFolderTags, } from "./src/folder-api/index.ts";
-export { canvasToPicture, createPictureDownloadURL, createPictureGallery, dataURLToPicture, displayPicture, imageFileToPicture, pictureToDataURL, setCoverArtFromCanvas, } from "./src/web-utils/index.ts";
-export type { AudioFileInput, AudioFormat, AudioProperties, BitrateControlMode, ExtendedTag, FieldMapping, FileType, OpenOptions, Picture, PictureType, PropertyMap, Tag, TagName, } from "./src/types.ts";
-export { BITRATE_CONTROL_MODE_NAMES, BITRATE_CONTROL_MODE_VALUES, PICTURE_TYPE_NAMES, PICTURE_TYPE_VALUES, } from "./src/types.ts";
-export type { PropertyKey, PropertyValue } from "./src/constants.ts";
-export { COMPLEX_PROPERTIES, COMPLEX_PROPERTY_KEY, } from "./src/constants/complex-properties.ts";
-export type { ComplexPropertyKey, ComplexPropertyKeyMap, ComplexPropertyValueMap, Rating, UnsyncedLyrics, VariantMap, } from "./src/constants/complex-properties.ts";
-export { clamp as clampRating, fromNormalized, fromPercent, fromPopm, fromStars, isValid as isValidRating, RatingUtils, toNormalized, toPercent, toPopm, toStars, } from "./src/utils/rating.ts";
-export { createWorkerPool, getGlobalWorkerPool, TagLibWorkerPool, terminateGlobalWorkerPool, } from "./src/worker-pool/index.ts";
-export type { BatchOperation, WorkerPoolOptions, WorkerTask, } from "./src/worker-pool/index.ts";
-export type { TagLibModule, WasmModule } from "./src/wasm.ts";
-export type { LoadTagLibOptions } from "./src/runtime/loader-types.ts";
-export { loadTagLibModule } from "./src/runtime/module-loader.ts";
+export type { AudioFile, TypedAudioFile, } from "./src/taglib/audio-file-interface.js";
+export { AudioFileImpl, createTagLib, TagLib } from "./src/taglib.js";
+export type { MutableTag } from "./src/taglib.js";
+export { EnvironmentError, FileOperationError, InvalidFormatError, isEnvironmentError, isFileOperationError, isInvalidFormatError, isMemoryError, isMetadataError, isTagLibError, isUnsupportedFormatError, MemoryError, MetadataError, SUPPORTED_FORMATS, TagLibError, TagLibInitializationError, UnsupportedFormatError, } from "./src/errors.js";
+export type { TagLibErrorCode } from "./src/errors.js";
+export { initializeForDenoCompile, isDenoCompiled, prepareWasmForEmbedding, } from "./src/deno-compile.js";
+export { addPicture, applyCoverArt, applyPictures, applyTags, applyTagsToFile, type BatchItem, type BatchOptions, type BatchResult, clearPictures, clearTags, type FileMetadata, findPictureByType, isValidAudioFile, readCoverArt, readFormat, readMetadata, readMetadataBatch, readPictureMetadata, readPictures, readProperties, readPropertiesBatch, readTags, readTagsBatch, replacePictureByType, setBufferMode, } from "./src/simple/index.js";
+export { FormatMappings, getAllProperties, getAllPropertyKeys, getAllTagNames, getPropertiesByFormat, getPropertyMetadata, isValidProperty, isValidTagName, PROPERTIES, Tags, } from "./src/constants.js";
+export type { PropertyMetadata } from "./src/constants/property-types.js";
+export { copyCoverArt, exportAllPictures, exportCoverArt, exportPictureByType, findCoverArtFiles, importCoverArt, importPictureWithType, loadPictureFromFile, savePictureToFile, } from "./src/file-utils/index.js";
+export { type AudioDynamics, type AudioFileMetadata, type DuplicateGroup, exportFolderMetadata, findDuplicates, type FolderScanItem, type FolderScanOptions, type FolderScanResult, type FolderUpdateItem, type FolderUpdateResult, scanFolder, updateFolderTags, } from "./src/folder-api/index.js";
+export { canvasToPicture, createPictureDownloadURL, createPictureGallery, dataURLToPicture, displayPicture, imageFileToPicture, pictureToDataURL, setCoverArtFromCanvas, } from "./src/web-utils/index.js";
+export type { AudioCodec, AudioFileInput, AudioProperties, BitrateControlMode, ContainerFormat, ExtendedTag, FieldMapping, FileType, OpenOptions, Picture, PictureType, PropertyMap, Tag, TagInput, TagName, } from "./src/types.js";
+export { BITRATE_CONTROL_MODE_NAMES, BITRATE_CONTROL_MODE_VALUES, PICTURE_TYPE_NAMES, PICTURE_TYPE_VALUES, } from "./src/types.js";
+export type { PropertyKey, PropertyValue } from "./src/constants.js";
+export type { FormatPropertyKey, TagFormat, } from "./src/types/format-property-keys.js";
+export { COMPLEX_PROPERTIES, COMPLEX_PROPERTY_KEY, } from "./src/constants/complex-properties.js";
+export type { ComplexPropertyKey, ComplexPropertyKeyMap, ComplexPropertyValueMap, Rating, UnsyncedLyrics, VariantMap, } from "./src/constants/complex-properties.js";
+export { RatingUtils } from "./src/utils/rating.js";
+export type { NormalizedRating, PopmRating } from "./src/utils/rating.js";
+export type { TagLibModule, WasmModule } from "./src/wasm.js";
+export type { LoadTagLibOptions } from "./src/runtime/loader-types.js";
+export { loadTagLibModule } from "./src/runtime/module-loader.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAGH,YAAY,EACV,SAAS,EACT,cAAc,GACf,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACtE,YAAY,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAGlD,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;AACzB,YAAY,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAGvD,OAAO,EACL,wBAAwB,EACxB,cAAc,EACd,uBAAuB,GACxB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,UAAU,EACV,aAAa,EACb,aAAa,EACb,SAAS,EACT,eAAe,EACf,KAAK,SAAS,EACd,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,aAAa,EACb,SAAS,EACT,KAAK,YAAY,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,iBAAiB,EACjB,mBAAmB,EACnB,YAAY,EACZ,cAAc,EACd,mBAAmB,EACnB,QAAQ,EACR,aAAa,EACb,oBAAoB,EACpB,aAAa,GACd,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACd,qBAAqB,EACrB,mBAAmB,EACnB,eAAe,EACf,cAAc,EACd,UAAU,EACV,IAAI,GACL,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAG1E,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,mBAAmB,EACnB,iBAAiB,EACjB,cAAc,EACd,qBAAqB,EACrB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,oBAAoB,EACpB,cAAc,EACd,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,UAAU,EACV,gBAAgB,GACjB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EACL,eAAe,EACf,wBAAwB,EACxB,oBAAoB,EACpB,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,0BAA0B,CAAC;AAGlC,YAAY,EACV,UAAU,EACV,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,WAAW,EACX,OAAO,EACP,WAAW,EACX,WAAW,EACX,GAAG,EACH,QAAQ,EACR,OAAO,GACR,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,0BAA0B,EAC1B,2BAA2B,EAC3B,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,gBAAgB,CAAC;AAExB,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACrE,YAAY,EACV,iBAAiB,EACjB,SAAS,GACV,MAAM,qCAAqC,CAAC;AAG7C,OAAO,EACL,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,uCAAuC,CAAC;AAC/C,YAAY,EACV,kBAAkB,EAClB,qBAAqB,EACrB,uBAAuB,EACvB,MAAM,EACN,cAAc,EACd,UAAU,GACX,MAAM,uCAAuC,CAAC;AAG/C,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,YAAY,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAG1E,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC9D,YAAY,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC"}

package/dist/index.js

@@ -1,5 +1,5 @@
 // index.ts
-import { AudioFileImpl, TagLib } from "./src/taglib.js";
+import { AudioFileImpl, createTagLib, TagLib } from "./src/taglib.js";
 import {
   EnvironmentError,
   FileOperationError,
@@ -9,18 +9,14 @@ import {
   isInvalidFormatError,
   isMemoryError,
   isMetadataError,
-  isSidecarError,
   isTagLibError,
   isUnsupportedFormatError,
-  isWorkerError,
   MemoryError,
   MetadataError,
-  SidecarError,
   SUPPORTED_FORMATS,
   TagLibError,
   TagLibInitializationError,
-  UnsupportedFormatError,
-  WorkerError
+  UnsupportedFormatError
 } from "./src/errors.js";
 import {
   initializeForDenoCompile,
@@ -32,13 +28,14 @@ import {
   applyCoverArt,
   applyPictures,
   applyTags,
-  applyTagsToBuffer,
+  applyTagsToFile,
   clearPictures,
   clearTags,
   findPictureByType,
   isValidAudioFile,
   readCoverArt,
   readFormat,
+  readMetadata,
   readMetadataBatch,
   readPictureMetadata,
   readPictures,
@@ -47,11 +44,7 @@ import {
   readTags,
   readTagsBatch,
   replacePictureByType,
-  setBufferMode,
-  setSidecarConfig,
-  setWorkerPoolMode,
-  updateTags,
-  writeTagsToFile
+  setBufferMode
 } from "./src/simple/index.js";
 import {
   FormatMappings,
@@ -102,28 +95,10 @@ import {
   COMPLEX_PROPERTIES,
   COMPLEX_PROPERTY_KEY
 } from "./src/constants/complex-properties.js";
-import {
-  clamp,
-  fromNormalized,
-  fromPercent,
-  fromPopm,
-  fromStars,
-  isValid,
-  RatingUtils,
-  toNormalized,
-  toPercent,
-  toPopm,
-  toStars
-} from "./src/utils/rating.js";
-import {
-  createWorkerPool,
-  getGlobalWorkerPool,
-  TagLibWorkerPool,
-  terminateGlobalWorkerPool
-} from "./src/worker-pool/index.js";
+import { RatingUtils } from "./src/utils/rating.js";
 import { loadTagLibModule } from "./src/runtime/module-loader.js";
 export {
-  AudioFileImpl as AudioFile,
+  AudioFileImpl,
   BITRATE_CONTROL_MODE_NAMES,
   BITRATE_CONTROL_MODE_VALUES,
   COMPLEX_PROPERTIES,
@@ -139,27 +114,23 @@ export {
   PROPERTIES,
   RatingUtils,
   SUPPORTED_FORMATS,
-  SidecarError,
   TagLib,
   TagLibError,
   TagLibInitializationError,
-  TagLibWorkerPool,
   Tags,
   UnsupportedFormatError,
-  WorkerError,
   addPicture,
   applyCoverArt,
   applyPictures,
   applyTags,
-  applyTagsToBuffer,
+  applyTagsToFile,
   canvasToPicture,
-  clamp as clampRating,
   clearPictures,
   clearTags,
   copyCoverArt,
   createPictureDownloadURL,
   createPictureGallery,
-  createWorkerPool,
+  createTagLib,
   dataURLToPicture,
   displayPicture,
   exportAllPictures,
@@ -169,14 +140,9 @@ export {
   findCoverArtFiles,
   findDuplicates,
   findPictureByType,
-  fromNormalized,
-  fromPercent,
-  fromPopm,
-  fromStars,
   getAllProperties,
   getAllPropertyKeys,
   getAllTagNames,
-  getGlobalWorkerPool,
   getPropertiesByFormat,
   getPropertyMetadata,
   imageFileToPicture,
@@ -189,20 +155,18 @@ export {
   isInvalidFormatError,
   isMemoryError,
   isMetadataError,
-  isSidecarError,
   isTagLibError,
   isUnsupportedFormatError,
   isValidAudioFile,
   isValidProperty,
-  isValid as isValidRating,
   isValidTagName,
-  isWorkerError,
   loadPictureFromFile,
   loadTagLibModule,
   pictureToDataURL,
   prepareWasmForEmbedding,
   readCoverArt,
   readFormat,
+  readMetadata,
   readMetadataBatch,
   readPictureMetadata,
   readPictures,
@@ -215,14 +179,5 @@ export {
   scanFolder,
   setBufferMode,
   setCoverArtFromCanvas,
-  setSidecarConfig,
-  setWorkerPoolMode,
-  terminateGlobalWorkerPool,
-  toNormalized,
-  toPercent,
-  toPopm,
-  toStars,
-  updateFolderTags,
-  updateTags,
-  writeTagsToFile
+  updateFolderTags
 };

package/dist/rating.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Rating conversion utilities for cross-format compatibility.
+ *
+ * @module rating
+ *
+ * @example
+ * ```typescript
+ * import { toStars, fromStars, toPopm } from "@charlesw/taglib-wasm/rating";
+ *
+ * const normalized = fromStars(4, 5);  // 0.8
+ * const popm = toPopm(0.8);            // 196
+ * ```
+ */
+export * from "./src/utils/rating.js";
+//# sourceMappingURL=rating.d.ts.map

package/dist/rating.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rating.d.ts","sourceRoot":"","sources":["../rating.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,cAAc,uBAAuB,CAAC"}

package/dist/rating.js

@@ -0,0 +1,2 @@
+// rating.ts
+export * from "./src/utils/rating.js";

package/dist/simple.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Simple API for reading and writing audio metadata with minimal code.
+ *
+ * @module simple
+ *
+ * @example
+ * ```typescript
+ * import { readTags, applyTags } from "@charlesw/taglib-wasm/simple";
+ *
+ * // Read tags from a file
+ * const tags = await readTags(audioBuffer);
+ * console.log(tags.title, tags.artist);
+ *
+ * // Apply tags and get modified buffer
+ * const modified = await applyTags(audioBuffer, {
+ *   title: "New Title",
+ *   artist: "New Artist"
+ * });
+ * ```
+ */
+export * from "./src/simple/index.js";
+//# sourceMappingURL=simple.d.ts.map

package/dist/simple.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"simple.d.ts","sourceRoot":"","sources":["../simple.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,cAAc,uBAAuB,CAAC"}

package/dist/simple.js

@@ -0,0 +1,2 @@
+// simple.ts
+export * from "./src/simple/index.js";

package/dist/src/constants/basic-properties.d.ts

@@ -3,7 +3,7 @@
  * These are the core tags that most audio files should have.
  */
 export declare const BASIC_PROPERTIES: {
-    readonly TITLE: {
+    readonly title: {
         readonly key: "TITLE";
         readonly description: "The title of the track";
         readonly type: "string";
@@ -17,7 +17,7 @@ export declare const BASIC_PROPERTIES: {
             readonly wav: "INAM";
         };
     };
-    readonly ARTIST: {
+    readonly artist: {
         readonly key: "ARTIST";
         readonly description: "The primary performer(s) of the track";
         readonly type: "string";
@@ -31,7 +31,7 @@ export declare const BASIC_PROPERTIES: {
             readonly wav: "IART";
         };
     };
-    readonly ALBUM: {
+    readonly album: {
         readonly key: "ALBUM";
         readonly description: "The album/collection name";
         readonly type: "string";
@@ -45,7 +45,7 @@ export declare const BASIC_PROPERTIES: {
             readonly wav: "IPRD";
         };
     };
-    readonly DATE: {
+    readonly date: {
         readonly key: "DATE";
         readonly description: "The date of recording (typically year)";
         readonly type: "string";
@@ -59,7 +59,7 @@ export declare const BASIC_PROPERTIES: {
             readonly wav: "ICRD";
         };
     };
-    readonly TRACKNUMBER: {
+    readonly trackNumber: {
         readonly key: "TRACKNUMBER";
         readonly description: "The track number within the album";
         readonly type: "string";
@@ -73,7 +73,7 @@ export declare const BASIC_PROPERTIES: {
             readonly wav: "ITRK";
         };
     };
-    readonly GENRE: {
+    readonly genre: {
         readonly key: "GENRE";
         readonly description: "The musical genre";
         readonly type: "string";
@@ -87,7 +87,7 @@ export declare const BASIC_PROPERTIES: {
             readonly wav: "IGNR";
         };
     };
-    readonly COMMENT: {
+    readonly comment: {
         readonly key: "COMMENT";
         readonly description: "Comments or notes about the track";
         readonly type: "string";

package/dist/src/constants/basic-properties.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"basic-properties.d.ts","sourceRoot":"","sources":["../../../src/constants/basic-properties.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsFnB,CAAC"}
+{"version":3,"file":"basic-properties.d.ts","sourceRoot":"","sources":["../../../src/constants/basic-properties.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqFnB,CAAC"}