taglib-wasm 1.0.0-beta.2 → 1.0.0-beta.4

package/README.md

@@ -225,17 +225,17 @@ console.log(`Found ${duplicates.size} groups of duplicates`);
 ### Working with Cover Art
 
 ```typescript
-import { getCoverArt, setCoverArt } from "taglib-wasm/simple";
+import { applyCoverArt, readCoverArt } from "taglib-wasm/simple";
 
 // Extract cover art
-const coverData = await getCoverArt("song.mp3");
+const coverData = await readCoverArt("song.mp3");
 if (coverData) {
   await Deno.writeFile("cover.jpg", coverData);
 }
 
 // Set new cover art
 const imageData = await Deno.readFile("new-cover.jpg");
-const modifiedBuffer = await setCoverArt("song.mp3", imageData, "image/jpeg");
+const modifiedBuffer = await applyCoverArt("song.mp3", imageData, "image/jpeg");
 // Save modifiedBuffer to file if needed
 ```
 
@@ -313,10 +313,6 @@ Supported formats:
 - [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)
 
-### Development
-
-- [Testing Guide](https://charleswiltgen.github.io/taglib-wasm/development/testing.html)
-- [Future Improvements](https://charleswiltgen.github.io/taglib-wasm/development/improvements.html)
 - [Contributing](CONTRIBUTING.md)
 
 ## Supported Formats
@@ -357,7 +353,7 @@ file.setProperty(Tags.TrackGain, "-6.54 dB");
 file.setProperty(Tags.TrackPeak, "0.987654");
 ```
 
-[View all supported tag constants →](https://charleswiltgen.github.io/taglib-wasm/api/tag-name-constants.html)
+[View all supported tag constants →](https://charleswiltgen.github.io/taglib-wasm/api/tag-constants.html)
 
 ## Performance and Best Practices
 

package/dist/index.d.ts

@@ -62,14 +62,14 @@ export type { TagLibErrorCode } from "./src/errors.ts";
  * @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
+ * @see {@link readCoverArt} - Read primary cover art data
+ * @see {@link applyCoverArt} - Apply primary cover art
  * @see {@link readTagsBatch} - Read tags from multiple files efficiently
  * @see {@link readPropertiesBatch} - Read properties from multiple files efficiently
  * @see {@link readMetadataBatch} - Read complete metadata from multiple files efficiently
  * @see {@link setWorkerPoolMode} - Enable/disable worker pool for Simple API
  */
-export { addPicture, applyPictures, applyTags, type BatchOptions, type BatchResult, clearPictures, clearTags, findPictureByType, getCoverArt, getFormat, getPictureMetadata, isValidAudioFile, readMetadataBatch, readPictures, readProperties, readPropertiesBatch, readTags, readTagsBatch, replacePictureByType, setBufferMode, setCoverArt, setSidecarConfig, setWorkerPoolMode, updateTags, } from "./src/simple.ts";
+export { addPicture, applyCoverArt, applyPictures, applyTags, type BatchOptions, type BatchResult, clearPictures, clearTags, findPictureByType, isValidAudioFile, readCoverArt, readFormat, readMetadataBatch, readPictureMetadata, readPictures, readProperties, readPropertiesBatch, readTags, readTagsBatch, replacePictureByType, setBufferMode, setSidecarConfig, setWorkerPoolMode, updateTags, } from "./src/simple.ts";
 /**
  * Enhanced property constants and utilities with rich metadata.
  * @see {@link PROPERTIES} - Comprehensive property definitions with metadata

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH;;;;GAIG;AACH,OAAO,EAAE,aAAa,IAAI,SAAS,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACrE,YAAY,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD;;;;;;;;;;;;GAYG;AACH,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,aAAa,EACb,eAAe,EACf,cAAc,EACd,aAAa,EACb,wBAAwB,EACxB,aAAa,EACb,WAAW,EACX,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,WAAW,EACX,yBAAyB,EACzB,sBAAsB,EACtB,WAAW,GACZ,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvD;;;;;;;;;;;;;;GAcG;AACH,OAAO,EACL,UAAU,EACV,aAAa,EACb,SAAS,EACT,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,aAAa,EACb,SAAS,EACT,iBAAiB,EACjB,WAAW,EACX,SAAS,EACT,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACd,mBAAmB,EACnB,QAAQ,EACR,aAAa,EACb,oBAAoB,EACpB,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,UAAU,GACX,MAAM,iBAAiB,CAAC;AAEzB;;;;;;;;;;;GAWG;AACH,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;AAC1E;;;;;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;;;;;;GAMG;AACH,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,oBAAoB,EACpB,cAAc,EACd,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,UAAU,EACV,gBAAgB,GACjB,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;;;;;;;;;;GAUG;AACH,YAAY,EACV,cAAc,EACd,WAAW,EACX,eAAe,EACf,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,OAAO,EACP,WAAW,EACX,GAAG,EACH,OAAO,GACR,MAAM,gBAAgB,CAAC;AAExB,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAErE;;GAEG;AACH,YAAY,EACV,kBAAkB,EAClB,WAAW,EACX,WAAW,GACZ,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,0BAA0B,EAC1B,2BAA2B,EAC3B,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,gBAAgB,CAAC;AAExB;;;;;;;GAOG;AACH,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;AAE/C;;;;;;;;;GASG;AACH,OAAO,EACL,KAAK,IAAI,WAAW,EACpB,cAAc,EACd,WAAW,EACX,QAAQ,EACR,SAAS,EACT,OAAO,IAAI,aAAa,EACxB,WAAW,EACX,YAAY,EACZ,SAAS,EACT,MAAM,EACN,OAAO,GACR,MAAM,uBAAuB,CAAC;AAE/B;;;;;;GAMG;AACH,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,yBAAyB,GAC1B,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,cAAc,EACd,iBAAiB,EACjB,UAAU,GACX,MAAM,sBAAsB,CAAC;AAE9B;;;;GAIG;AACH,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAG9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD;;GAEG;AAEH,YAAY,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAEvE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,YAAY,CAAC,CAyBvB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH;;;;GAIG;AACH,OAAO,EAAE,aAAa,IAAI,SAAS,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACrE,YAAY,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD;;;;;;;;;;;;GAYG;AACH,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,aAAa,EACb,eAAe,EACf,cAAc,EACd,aAAa,EACb,wBAAwB,EACxB,aAAa,EACb,WAAW,EACX,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,WAAW,EACX,yBAAyB,EACzB,sBAAsB,EACtB,WAAW,GACZ,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvD;;;;;;;;;;;;;;GAcG;AACH,OAAO,EACL,UAAU,EACV,aAAa,EACb,aAAa,EACb,SAAS,EACT,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,aAAa,EACb,SAAS,EACT,iBAAiB,EACjB,gBAAgB,EAChB,YAAY,EACZ,UAAU,EACV,iBAAiB,EACjB,mBAAmB,EACnB,YAAY,EACZ,cAAc,EACd,mBAAmB,EACnB,QAAQ,EACR,aAAa,EACb,oBAAoB,EACpB,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,UAAU,GACX,MAAM,iBAAiB,CAAC;AAEzB;;;;;;;;;;;GAWG;AACH,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;AAC1E;;;;;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;;;;;;GAMG;AACH,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,oBAAoB,EACpB,cAAc,EACd,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,UAAU,EACV,gBAAgB,GACjB,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;;;;;;;;;;GAUG;AACH,YAAY,EACV,cAAc,EACd,WAAW,EACX,eAAe,EACf,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,OAAO,EACP,WAAW,EACX,GAAG,EACH,OAAO,GACR,MAAM,gBAAgB,CAAC;AAExB,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAErE;;GAEG;AACH,YAAY,EACV,kBAAkB,EAClB,WAAW,EACX,WAAW,GACZ,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,0BAA0B,EAC1B,2BAA2B,EAC3B,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,gBAAgB,CAAC;AAExB;;;;;;;GAOG;AACH,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;AAE/C;;;;;;;;;GASG;AACH,OAAO,EACL,KAAK,IAAI,WAAW,EACpB,cAAc,EACd,WAAW,EACX,QAAQ,EACR,SAAS,EACT,OAAO,IAAI,aAAa,EACxB,WAAW,EACX,YAAY,EACZ,SAAS,EACT,MAAM,EACN,OAAO,GACR,MAAM,uBAAuB,CAAC;AAE/B;;;;;;GAMG;AACH,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,yBAAyB,GAC1B,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,cAAc,EACd,iBAAiB,EACjB,UAAU,GACX,MAAM,sBAAsB,CAAC;AAE9B;;;;GAIG;AACH,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAG9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD;;GAEG;AAEH,YAAY,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAEvE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,YAAY,CAAC,CAyBvB"}

package/dist/index.js

@@ -24,16 +24,17 @@ import {
 } from "./src/errors.js";
 import {
   addPicture,
+  applyCoverArt,
   applyPictures,
   applyTags,
   clearPictures,
   clearTags,
   findPictureByType,
-  getCoverArt,
-  getFormat,
-  getPictureMetadata,
   isValidAudioFile,
+  readCoverArt,
+  readFormat,
   readMetadataBatch,
+  readPictureMetadata,
   readPictures,
   readProperties,
   readPropertiesBatch,
@@ -41,7 +42,6 @@ import {
   readTagsBatch,
   replacePictureByType,
   setBufferMode,
-  setCoverArt,
   setSidecarConfig,
   setWorkerPoolMode,
   updateTags
@@ -190,6 +190,7 @@ export {
   UnsupportedFormatError,
   WorkerError,
   addPicture,
+  applyCoverArt,
   applyPictures,
   applyTags,
   canvasToPicture,
@@ -216,10 +217,7 @@ export {
   getAllProperties,
   getAllPropertyKeys,
   getAllTagNames,
-  getCoverArt,
-  getFormat,
   getGlobalWorkerPool,
-  getPictureMetadata,
   getPropertiesByFormat,
   getPropertyMetadata,
   imageFileToPicture,
@@ -241,7 +239,10 @@ export {
   loadPictureFromFile,
   loadTagLibModule,
   pictureToDataURL,
+  readCoverArt,
+  readFormat,
   readMetadataBatch,
+  readPictureMetadata,
   readPictures,
   readProperties,
   readPropertiesBatch,
@@ -251,7 +252,6 @@ export {
   savePictureToFile,
   scanFolder,
   setBufferMode,
-  setCoverArt,
   setCoverArtFromCanvas,
   setSidecarConfig,
   setWorkerPoolMode,

package/dist/src/file-utils.js

@@ -1,15 +1,15 @@
 import { PICTURE_TYPE_VALUES } from "./types.js";
 import {
+  applyCoverArt,
   applyPictures,
-  getCoverArt,
+  readCoverArt,
   readPictures,
-  replacePictureByType,
-  setCoverArt
+  replacePictureByType
 } from "./simple.js";
 import { readFileData } from "./utils/file.js";
 import { writeFileData } from "./utils/write.js";
 async function exportCoverArt(audioPath, imagePath) {
-  const coverData = await getCoverArt(audioPath);
+  const coverData = await readCoverArt(audioPath);
   if (!coverData) {
     throw new Error(`No cover art found in: ${audioPath}`);
   }
@@ -77,7 +77,7 @@ async function importCoverArt(audioPath, imagePath, options = {}) {
     };
     mimeType = mimeTypes[ext ?? ""] ?? "image/jpeg";
   }
-  const modifiedBuffer = await setCoverArt(audioPath, imageData, mimeType);
+  const modifiedBuffer = await applyCoverArt(audioPath, imageData, mimeType);
   await writeFileData(audioPath, modifiedBuffer);
 }
 async function importPictureWithType(audioPath, imagePath, type, options = {}) {
@@ -138,7 +138,7 @@ async function copyCoverArt(sourcePath, targetPath, options = {}) {
     const modifiedBuffer = await applyPictures(targetPath, pictures);
     await writeFileData(targetPath, modifiedBuffer);
   } else {
-    const coverData = await getCoverArt(sourcePath);
+    const coverData = await readCoverArt(sourcePath);
     if (!coverData) {
       throw new Error(`No cover art found in: ${sourcePath}`);
     }
@@ -146,7 +146,7 @@ async function copyCoverArt(sourcePath, targetPath, options = {}) {
     const coverPicture = pictures.find(
       (p) => p.type === PICTURE_TYPE_VALUES.FrontCover
     ) ?? pictures[0];
-    const modifiedBuffer = await setCoverArt(
+    const modifiedBuffer = await applyCoverArt(
       targetPath,
       coverData,
       coverPicture.mimeType

package/dist/src/folder-api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"folder-api.d.ts","sourceRoot":"","sources":["../../src/folder-api.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"folder-api.d.ts","sourceRoot":"","sources":["../../src/folder-api.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,KAAK,GAAG,EAAc,MAAM,aAAa,CAAC;AACnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,OAAO,EAAuB,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AA4B9E;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,qDAAqD;IACrD,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,4CAA4C;IAC5C,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,kCAAkC;IAClC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,4CAA4C;IAC5C,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,sDAAsD;IACtD,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,yDAAyD;IACzD,IAAI,EAAE,GAAG,CAAC;IACV,8DAA8D;IAC9D,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,mDAAmD;IACnD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,uDAAuD;IACvD,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,qDAAqD;IACrD,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,iEAAiE;IACjE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,iEAAiE;IACjE,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4DAA4D;IAC5D,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7E,0DAA0D;IAC1D,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,oDAAoD;IACpD,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,2EAA2E;IAC3E,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,gEAAgE;IAChE,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,4EAA4E;IAC5E,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,mFAAmF;IACnF,QAAQ,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,iDAAiD;IACjD,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,mCAAmC;IACnC,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAE,CAAC,CAAC;IAC9C,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,mDAAmD;IACnD,cAAc,EAAE,MAAM,CAAC;IACvB,iCAAiC;IACjC,QAAQ,EAAE,MAAM,CAAC;CAClB;AA6WD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAsB,UAAU,CAC9B,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,gBAAgB,CAAC,CAyD3B;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,CAAA;CAAE,CAAC,EACpD,OAAO,GAAE;IAAE,eAAe,CAAC,EAAE,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAO,GAChE,OAAO,CAAC;IACT,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAE,CAAC,CAAC;IAC9C,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC,CA0CD;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,iBAAiB,EAAE,CAAC,CAAC,CA2B3C;AAED;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAkBf"}

package/dist/src/folder-api.js

@@ -1,6 +1,18 @@
 import { TagLib } from "./taglib.js";
 import { updateTags } from "./simple.js";
+import { writeFileData } from "./utils/write.js";
 import { getGlobalWorkerPool } from "./worker-pool.js";
+const EMPTY_TAG = Object.freeze(
+  {
+    title: "",
+    artist: "",
+    album: "",
+    comment: "",
+    genre: "",
+    year: 0,
+    track: 0
+  }
+);
 function join(...paths) {
   return paths.filter((p) => p).join("/").replace(/\/+/g, "/");
 }
@@ -119,9 +131,9 @@ async function processFileWithWorker(filePath, pool, includeProperties, onProgre
   ]);
   const hasCoverArt = pictures.length > 0;
   const dynamics = extractDynamicsData(tags);
-  if (processed && totalFound) {
-    processed.count++;
-    onProgress?.(processed.count, totalFound, filePath);
+  if (processed !== void 0 && totalFound !== void 0) {
+    const current = ++processed.count;
+    onProgress?.(current, totalFound, filePath);
   }
   return {
     path: filePath,
@@ -162,9 +174,9 @@ async function processFileWithTagLib(filePath, taglib, includeProperties, onProg
       appleSoundCheck = audioFile.getMP4Item("----:com.apple.iTunes:iTunNORM");
     }
     if (appleSoundCheck) dynamics.appleSoundCheck = appleSoundCheck;
-    if (processed && totalFound) {
-      processed.count++;
-      onProgress?.(processed.count, totalFound, filePath);
+    if (processed !== void 0 && totalFound !== void 0) {
+      const current = ++processed.count;
+      onProgress?.(current, totalFound, filePath);
     }
     return {
       path: filePath,
@@ -177,6 +189,83 @@ async function processFileWithTagLib(filePath, taglib, includeProperties, onProg
     audioFile.dispose();
   }
 }
+async function scanWithWorkerPool(pool, filePaths, opts) {
+  const { includeProperties, continueOnError, onProgress, totalFound } = opts;
+  const files = [];
+  const errors = [];
+  const progress = { count: 0 };
+  const batchSize = Math.min(50, filePaths.length);
+  for (let i = 0; i < filePaths.length; i += batchSize) {
+    const batch = filePaths.slice(
+      i,
+      Math.min(i + batchSize, filePaths.length)
+    );
+    const batchPromises = batch.map(async (filePath) => {
+      try {
+        return await processFileWithWorker(
+          filePath,
+          pool,
+          includeProperties,
+          onProgress,
+          progress,
+          totalFound
+        );
+      } catch (error) {
+        const err = error instanceof Error ? error : new Error(String(error));
+        if (continueOnError) {
+          errors.push({ path: filePath, error: err });
+          const current = ++progress.count;
+          onProgress?.(current, totalFound, filePath);
+          return { path: filePath, tags: EMPTY_TAG, error: err };
+        } else {
+          throw err;
+        }
+      }
+    });
+    const batchResults = await Promise.all(batchPromises);
+    files.push(...batchResults.filter((r) => !r.error));
+  }
+  return { files, errors, processed: progress.count };
+}
+async function scanWithTagLib(taglib, filePaths, opts) {
+  const { includeProperties, continueOnError, onProgress, totalFound } = opts;
+  const files = [];
+  const errors = [];
+  const progress = { count: 0 };
+  const processor = async (filePath) => {
+    try {
+      return await processFileWithTagLib(
+        filePath,
+        taglib,
+        includeProperties,
+        onProgress,
+        progress,
+        totalFound
+      );
+    } catch (error) {
+      const err = error instanceof Error ? error : new Error(String(error));
+      if (continueOnError) {
+        errors.push({ path: filePath, error: err });
+        const current = ++progress.count;
+        onProgress?.(current, totalFound, filePath);
+        return { path: filePath, tags: EMPTY_TAG, error: err };
+      } else {
+        throw err;
+      }
+    }
+  };
+  const concurrency = 4;
+  const batchSize = concurrency * 10;
+  for (let i = 0; i < filePaths.length; i += batchSize) {
+    const batch = filePaths.slice(
+      i,
+      Math.min(i + batchSize, filePaths.length)
+    );
+    const batchResults = await processBatch(batch, processor, concurrency);
+    files.push(...batchResults.filter((r) => !r.error));
+  }
+  return { files, errors, processed: progress.count };
+}
 async function scanFolder(folderPath, options = {}) {
   const startTime = Date.now();
   const {
@@ -188,8 +277,6 @@ async function scanFolder(folderPath, options = {}) {
     onProgress,
     forceBufferMode
   } = options;
-  const files = [];
-  const errors = [];
   const filePaths = [];
   let fileCount = 0;
   for await (const filePath of walkDirectory(folderPath, options)) {
@@ -198,112 +285,28 @@ async function scanFolder(folderPath, options = {}) {
     if (fileCount >= maxFiles) break;
   }
   const totalFound = filePaths.length;
-  let processed = 0;
   const shouldUseWorkerPool = useWorkerPool && (workerPool ?? typeof Worker !== "undefined");
   let pool = null;
   if (shouldUseWorkerPool) {
     pool = workerPool ?? getGlobalWorkerPool();
   }
-  const taglib = shouldUseWorkerPool ? null : await TagLib.initialize(
-    forceBufferMode ? { forceBufferMode: true } : void 0
-  );
-  try {
-    if (pool) {
-      const batchSize = Math.min(50, filePaths.length);
-      for (let i = 0; i < filePaths.length; i += batchSize) {
-        const batch = filePaths.slice(
-          i,
-          Math.min(i + batchSize, filePaths.length)
-        );
-        const batchPromises = batch.map(async (filePath) => {
-          try {
-            await Promise.all([
-              pool.readTags(filePath),
-              includeProperties ? pool.readProperties(filePath) : Promise.resolve(null),
-              pool.readPictures(filePath)
-            ]);
-            return await processFileWithWorker(
-              filePath,
-              pool,
-              includeProperties,
-              onProgress,
-              { count: processed },
-              totalFound
-            ).then((result) => {
-              processed++;
-              return result;
-            });
-          } catch (error) {
-            const err = error instanceof Error ? error : new Error(String(error));
-            if (continueOnError) {
-              errors.push({ path: filePath, error: err });
-              processed++;
-              onProgress?.(processed, totalFound, filePath);
-              return { path: filePath, tags: {}, error: err };
-            } else {
-              throw err;
-            }
-          }
-        });
-        const batchResults = await Promise.all(batchPromises);
-        files.push(...batchResults.filter((r) => !r.error));
-      }
-    } else {
-      const processor = async (filePath) => {
-        try {
-          const audioFile = await taglib.open(filePath);
-          try {
-            audioFile.tag();
-            if (includeProperties) {
-              audioFile.audioProperties();
-            }
-            audioFile.getPictures();
-            return await processFileWithTagLib(
-              filePath,
-              taglib,
-              includeProperties,
-              onProgress,
-              { count: processed },
-              totalFound
-            ).then((result) => {
-              processed++;
-              return result;
-            });
-          } finally {
-            audioFile.dispose();
-          }
-        } catch (error) {
-          const err = error instanceof Error ? error : new Error(String(error));
-          if (continueOnError) {
-            errors.push({ path: filePath, error: err });
-            processed++;
-            onProgress?.(processed, totalFound, filePath);
-            return { path: filePath, tags: {}, error: err };
-          } else {
-            throw err;
-          }
-        }
-      };
-      const concurrency = 4;
-      const batchSize = concurrency * 10;
-      for (let i = 0; i < filePaths.length; i += batchSize) {
-        const batch = filePaths.slice(
-          i,
-          Math.min(i + batchSize, filePaths.length)
-        );
-        const batchResults = await processBatch(batch, processor, concurrency);
-        files.push(...batchResults.filter((r) => !r.error));
-      }
-    }
-  } finally {
-    if (pool && !workerPool) {
-    }
+  let initOptions;
+  if (forceBufferMode) {
+    initOptions = { forceBufferMode: true };
   }
+  const taglib = shouldUseWorkerPool ? null : await TagLib.initialize(initOptions);
+  const processOpts = {
+    includeProperties,
+    continueOnError,
+    onProgress,
+    totalFound
+  };
+  const result = pool ? await scanWithWorkerPool(pool, filePaths, processOpts) : await scanWithTagLib(taglib, filePaths, processOpts);
   return {
-    files,
-    errors,
+    files: result.files,
+    errors: result.errors,
     totalFound,
-    totalProcessed: processed,
+    totalProcessed: result.processed,
     duration: Date.now() - startTime
   };
 }
@@ -333,7 +336,7 @@ async function updateFolderTags(updates, options = {}) {
       async (path) => {
         const update = batch.find((u) => u.path === path);
         await processor(update);
-        return { path, tags: {} };
+        return { path, tags: EMPTY_TAG };
       },
       concurrency
     );
@@ -377,12 +380,8 @@ async function exportFolderMetadata(folderPath, outputPath, options) {
     files: result.files,
     errors: result.errors
   };
-  if (typeof Deno !== "undefined") {
-    await Deno.writeTextFile(outputPath, JSON.stringify(data, null, 2));
-  } else if (typeof globalThis.process !== "undefined") {
-    const fs = await import("fs/promises");
-    await fs.writeFile(outputPath, JSON.stringify(data, null, 2));
-  }
+  const jsonBytes = new TextEncoder().encode(JSON.stringify(data, null, 2));
+  await writeFileData(outputPath, jsonBytes);
 }
 export {
   exportFolderMetadata,

package/dist/src/msgpack/decoder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"decoder.d.ts","sourceRoot":"","sources":["../../../src/msgpack/decoder.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAU,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,KAAK,EACV,eAAe,EACf,WAAW,EACX,OAAO,EACP,WAAW,EACZ,MAAM,aAAa,CAAC;AAkBrB;;GAEG;AACH,wBAAgB,aAAa,CAAC,aAAa,EAAE,UAAU,GAAG,WAAW,CAOpE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,aAAa,EAAE,UAAU,GACxB,eAAe,CAOjB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,UAAU,GAAG,WAAW,CAOxE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,aAAa,EAAE,UAAU,GAAG,OAAO,CAchE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,UAAU,GAAG,OAAO,EAAE,CAevE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,GAAG,OAAO,EAC3C,aAAa,EAAE,UAAU,EACzB,OAAO,GAAE,OAAO,CAAC,cAAc,CAAM,GACpC,CAAC,CAQH;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,aAAa,EAAE,UAAU,GACxB,WAAW,GAAG,eAAe,GAAG,OAAO,GAAG,WAAW,GAAG,OAAO,CAwCjE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAc9D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,UAAU,GAAG;IACtD,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,IAAI,EACA,OAAO,GACP,KAAK,GACL,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,MAAM,GACN,WAAW,GACX,SAAS,CAAC;CACf,CAyDA;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,aAAa,EAAE,UAAU,GACxB,IAAI,CAAC,WAAW,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC,CAqBpE"}
+{"version":3,"file":"decoder.d.ts","sourceRoot":"","sources":["../../../src/msgpack/decoder.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAU,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,KAAK,EACV,eAAe,EACf,WAAW,EACX,OAAO,EACP,WAAW,EACZ,MAAM,aAAa,CAAC;AAkBrB;;GAEG;AACH,wBAAgB,aAAa,CAAC,aAAa,EAAE,UAAU,GAAG,WAAW,CAOpE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,aAAa,EAAE,UAAU,GACxB,eAAe,CAOjB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,UAAU,GAAG,WAAW,CAOxE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,aAAa,EAAE,UAAU,GAAG,OAAO,CAchE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,UAAU,GAAG,OAAO,EAAE,CAevE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,GAAG,OAAO,EAC3C,aAAa,EAAE,UAAU,EACzB,OAAO,GAAE,OAAO,CAAC,cAAc,CAAM,GACpC,CAAC,CAQH;AAwBD;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,aAAa,EAAE,UAAU,GACxB,WAAW,GAAG,eAAe,GAAG,OAAO,GAAG,WAAW,GAAG,OAAO,CAqBjE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAc9D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,UAAU,GAAG;IACtD,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,IAAI,EACA,OAAO,GACP,KAAK,GACL,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,MAAM,GACN,WAAW,GACX,SAAS,CAAC;CACf,CAyDA;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,aAAa,EAAE,UAAU,GACxB,IAAI,CAAC,WAAW,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC,CAqBpE"}

package/dist/src/msgpack/decoder.js

@@ -76,25 +76,35 @@ function decodeMessagePack(msgpackBuffer, options = {}) {
     throw new Error(`Failed to decode MessagePack data: ${error}`);
   }
 }
+function isAudioProperties(obj) {
+  return "bitrate" in obj && "sampleRate" in obj && "length" in obj;
+}
+function isPicture(obj) {
+  return "mimeType" in obj && "data" in obj;
+}
+function coercePictureData(obj) {
+  if (obj.data && !(obj.data instanceof Uint8Array)) {
+    obj.data = new Uint8Array(obj.data);
+  }
+}
+function isTagLike(obj) {
+  return "title" in obj || "artist" in obj || "album" in obj;
+}
+function isPropertyMap(obj) {
+  return Object.values(obj).every((value) => Array.isArray(value));
+}
 function decodeMessagePackAuto(msgpackBuffer) {
   try {
     const decoded = decode(msgpackBuffer, MSGPACK_DECODE_OPTIONS);
     if (decoded && typeof decoded === "object") {
-      if ("bitrate" in decoded && "sampleRate" in decoded && "length" in decoded) {
-        return decoded;
-      }
-      if ("mimeType" in decoded && "data" in decoded) {
-        if (decoded.data && !(decoded.data instanceof Uint8Array)) {
-          decoded.data = new Uint8Array(decoded.data);
-        }
-        return decoded;
-      }
-      if ("title" in decoded || "artist" in decoded || "album" in decoded) {
-        return decoded;
-      }
-      if (Object.values(decoded).every((value) => Array.isArray(value))) {
-        return decoded;
+      const obj = decoded;
+      if (isAudioProperties(obj)) return obj;
+      if (isPicture(obj)) {
+        coercePictureData(obj);
+        return obj;
       }
+      if (isTagLike(obj)) return obj;
+      if (isPropertyMap(obj)) return obj;
     }
     return decoded;
   } catch (error) {

package/dist/src/runtime/detector.d.ts

@@ -7,14 +7,15 @@
  *
  * Priority order:
  * 1. Deno + WASI (optimal filesystem performance)
- * 2. Node.js + WASI (when available)
- * 3. Browser + Emscripten (required for web)
- * 4. Node.js + Emscripten (fallback compatibility)
+ * 2. Bun + WASI (via node:fs, check before Node)
+ * 3. Node.js + WASI (when available)
+ * 4. Browser + Emscripten (required for web)
+ * 5. Node.js + Emscripten (fallback compatibility)
  */
 /**
  * Supported runtime environments with their optimal WASM target
  */
-export type RuntimeEnvironment = "deno-wasi" | "node-wasi" | "browser" | "node-emscripten" | "worker" | "cloudflare";
+export type RuntimeEnvironment = "deno-wasi" | "node-wasi" | "bun-wasi" | "browser" | "node-emscripten" | "worker" | "cloudflare";
 /**
  * WASM binary types that can be loaded
  */

package/dist/src/runtime/detector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"detector.d.ts","sourceRoot":"","sources":["../../../src/runtime/detector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAC1B,WAAW,GACX,WAAW,GACX,SAAS,GACT,iBAAiB,GACjB,QAAQ,GACR,YAAY,CAAC;AAEjB;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,YAAY,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,mCAAmC;IACnC,WAAW,EAAE,kBAAkB,CAAC;IAChC,oDAAoD;IACpD,QAAQ,EAAE,cAAc,CAAC;IACzB,kDAAkD;IAClD,kBAAkB,EAAE,OAAO,CAAC;IAC5B,qDAAqD;IACrD,iBAAiB,EAAE,OAAO,CAAC;IAC3B,sDAAsD;IACtD,eAAe,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;CAC5B;AAoED;;GAEG;AACH,wBAAgB,aAAa,IAAI,sBAAsB,CA2EtD;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,kBAAkB,GAAG,MAAM,CAiBzE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAUjE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,sBAAsB,GAAG,IAAI,CAGlE;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,sBAAsB,CAG5D"}
+{"version":3,"file":"detector.d.ts","sourceRoot":"","sources":["../../../src/runtime/detector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAC1B,WAAW,GACX,WAAW,GACX,UAAU,GACV,SAAS,GACT,iBAAiB,GACjB,QAAQ,GACR,YAAY,CAAC;AAEjB;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,YAAY,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,mCAAmC;IACnC,WAAW,EAAE,kBAAkB,CAAC;IAChC,oDAAoD;IACpD,QAAQ,EAAE,cAAc,CAAC;IACzB,kDAAkD;IAClD,kBAAkB,EAAE,OAAO,CAAC;IAC5B,qDAAqD;IACrD,iBAAiB,EAAE,OAAO,CAAC;IAC3B,sDAAsD;IACtD,eAAe,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;CAC5B;AA2ED;;GAEG;AACH,wBAAgB,aAAa,IAAI,sBAAsB,CAsFtD;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,kBAAkB,GAAG,MAAM,CAmBzE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAWjE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,sBAAsB,GAAG,IAAI,CAGlE;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,sBAAsB,CAG5D"}

package/dist/src/runtime/detector.js

@@ -20,6 +20,9 @@ function isCloudflareWorker() {
   const globalAny = globalThis;
   return typeof caches !== "undefined" && typeof Request !== "undefined" && typeof addEventListener === "function" && typeof Deno === "undefined" && typeof globalAny.process === "undefined";
 }
+function isBun() {
+  return typeof globalThis.Bun !== "undefined";
+}
 function isNode() {
   const globalAny = globalThis;
   return typeof globalAny.process !== "undefined" && globalAny.process.versions?.node !== void 0;
@@ -37,6 +40,15 @@ function detectRuntime() {
       performanceTier: 1
     };
   }
+  if (isBun()) {
+    return {
+      environment: "bun-wasi",
+      wasmType: "wasi",
+      supportsFilesystem: true,
+      supportsStreaming: true,
+      performanceTier: 1
+    };
+  }
   if (isNode() && hasWASISupport()) {
     return {
       environment: "node-wasi",
@@ -98,6 +110,8 @@ function getEnvironmentDescription(env) {
       return "Deno with WASI (optimal filesystem performance)";
     case "node-wasi":
       return "Node.js with WASI (high performance)";
+    case "bun-wasi":
+      return "Bun with WASI (via node:fs)";
     case "browser":
       return "Browser with Emscripten (web compatibility)";
     case "worker":
@@ -113,7 +127,7 @@ function getEnvironmentDescription(env) {
 function canLoadWasmType(wasmType) {
   const result = detectRuntime();
   if (wasmType === "wasi") {
-    return result.environment === "deno-wasi" || result.environment === "node-wasi";
+    return result.environment === "deno-wasi" || result.environment === "node-wasi" || result.environment === "bun-wasi";
   }
   return true;
 }

package/dist/src/runtime/unified-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"unified-loader.d.ts","sourceRoot":"","sources":["../../../src/runtime/unified-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAiB,KAAK,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAO3E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG/C,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,IAAI,EAAG,sBAAsB,CAAU;gBACpC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAK7C;AAED,qBAAa,eAAgB,SAAQ,KAAK;aAItB,QAAQ,EAAE,MAAM,GAAG,YAAY;IAHjD,QAAQ,CAAC,IAAI,EAAG,mBAAmB,CAAU;gBAE3C,OAAO,EAAE,MAAM,EACC,QAAQ,EAAE,MAAM,GAAG,YAAY,EAC/C,KAAK,CAAC,EAAE,OAAO;CAMlB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,+BAA+B;IAC/B,aAAa,CAAC,EAAE,MAAM,GAAG,YAAY,CAAC;IACtC,0CAA0C;IAC1C,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,sCAAsC;IACtC,UAAU,CAAC,EAAE,WAAW,GAAG,UAAU,CAAC;IACtC,sBAAsB;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0BAA0B;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,mCAAmC;IACnC,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,YAAY;IACvD,+BAA+B;IAC/B,OAAO,EAAE,sBAAsB,CAAC;IAChC,wCAAwC;IACxC,MAAM,EAAE,OAAO,CAAC;IAChB,8CAA8C;IAC9C,YAAY,EAAE,OAAO,CAAC;IACtB,8BAA8B;IAC9B,qBAAqB,CAAC,EAAE,MAAM,kBAAkB,CAAC;CAClD;AAED,UAAU,kBAAkB;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,GAAG,YAAY,CAAC;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,mBAAmB,CAAC,CAsC9B;AAsMD;;GAEG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAGzC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,oBAAoB,CAqB3D"}
+{"version":3,"file":"unified-loader.d.ts","sourceRoot":"","sources":["../../../src/runtime/unified-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAiB,KAAK,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAE3E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG/C,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,IAAI,EAAG,sBAAsB,CAAU;gBACpC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAK7C;AAED,qBAAa,eAAgB,SAAQ,KAAK;aAItB,QAAQ,EAAE,MAAM,GAAG,YAAY;IAHjD,QAAQ,CAAC,IAAI,EAAG,mBAAmB,CAAU;gBAE3C,OAAO,EAAE,MAAM,EACC,QAAQ,EAAE,MAAM,GAAG,YAAY,EAC/C,KAAK,CAAC,EAAE,OAAO;CAMlB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,+BAA+B;IAC/B,aAAa,CAAC,EAAE,MAAM,GAAG,YAAY,CAAC;IACtC,0CAA0C;IAC1C,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,sCAAsC;IACtC,UAAU,CAAC,EAAE,WAAW,GAAG,UAAU,CAAC;IACtC,sBAAsB;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0BAA0B;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,mCAAmC;IACnC,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,YAAY;IACvD,+BAA+B;IAC/B,OAAO,EAAE,sBAAsB,CAAC;IAChC,wCAAwC;IACxC,MAAM,EAAE,OAAO,CAAC;IAChB,8CAA8C;IAC9C,YAAY,EAAE,OAAO,CAAC;IACtB,8BAA8B;IAC9B,qBAAqB,CAAC,EAAE,MAAM,kBAAkB,CAAC;CAClD;AAED,UAAU,kBAAkB;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,GAAG,YAAY,CAAC;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,mBAAmB,CAAC,CAsC9B;AAkND;;GAEG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAGzC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,oBAAoB,CAqB3D"}