taglib-wasm 1.8.3 → 2.0.0

package/dist/simple.browser.js

@@ -1648,6 +1648,23 @@ var init_mutable_tag_impl = __esm({
   }
 });
 
+// src/taglib/auto-dispose.ts
+function registerAutoDispose(target, handle) {
+  registry.register(target, handle, target);
+}
+function unregisterAutoDispose(target) {
+  registry.unregister(target);
+}
+var registry;
+var init_auto_dispose = __esm({
+  "src/taglib/auto-dispose.ts"() {
+    "use strict";
+    registry = new FinalizationRegistry((handle) => {
+      handle.destroy();
+    });
+  }
+});
+
 // src/taglib/audio-file-base.ts
 var LYRICS_PROPERTY_KEY, LYRICS_WIRE_KEY, EMPTY_KEY_SET, BaseAudioFileImpl;
 var init_audio_file_base = __esm({
@@ -1657,6 +1674,7 @@ var init_audio_file_base = __esm({
     init_errors2();
     init_mp4_item_names();
     init_mutable_tag_impl();
+    init_auto_dispose();
     LYRICS_PROPERTY_KEY = "lyrics";
     LYRICS_WIRE_KEY = toTagLibKey(LYRICS_PROPERTY_KEY);
     EMPTY_KEY_SET = /* @__PURE__ */ new Set();
@@ -1677,6 +1695,7 @@ var init_audio_file_base = __esm({
         this.isPartiallyLoaded = isPartiallyLoaded;
         this.partialLoadOptions = partialLoadOptions;
         this.partialKeysAtLoad = isPartiallyLoaded ? new Set(Object.keys(fileHandle.getProperties())) : void 0;
+        registerAutoDispose(this, fileHandle);
       }
       /**
        * Wire-key text properties present in the partial header at load but now
@@ -1736,16 +1755,36 @@ var init_audio_file_base = __esm({
         this.handle.setProperties(translated);
       }
       getProperty(key) {
-        const value = this.handle.getProperty(toTagLibKey(fromTagLibKey(key)));
-        if (value !== "") return value;
+        const wireKey = toTagLibKey(fromTagLibKey(key));
+        const values = this.handle.getProperties()[wireKey]?.filter(
+          (v) => v !== ""
+        );
+        if (values !== void 0 && values.length > 0) return values;
         if (!this.isMP4()) return void 0;
-        const remapped = this.properties()[key]?.[0];
-        return remapped === "" ? void 0 : remapped;
+        const remapped = this.properties()[key]?.filter((v) => v !== "");
+        return remapped !== void 0 && remapped.length > 0 ? remapped : void 0;
       }
       setProperty(key, value) {
         const wireKey = toTagLibKey(fromTagLibKey(key));
         const atomNames = mp4FreeformAtomNames([wireKey]);
         if (atomNames.length > 0 && this.isMP4()) {
+          if (value === "") {
+            const prior = this.handle.getMp4ItemRemovals?.() ?? [];
+            this.handle.setMp4ItemRemovals?.([
+              .../* @__PURE__ */ new Set([...prior, ...atomNames])
+            ]);
+            if (this.module.isWasi) {
+              this.handle.setProperties({
+                ...this.handle.getProperties(),
+                [wireKey]: []
+              });
+            } else {
+              const rest = { ...this.handle.getProperties() };
+              delete rest[wireKey];
+              this.handle.setProperties(rest);
+            }
+            return;
+          }
           this.handle.setProperties({
             ...this.handle.getProperties(),
             [wireKey]: [value],
@@ -1755,6 +1794,14 @@ var init_audio_file_base = __esm({
         }
         this.handle.setProperty(wireKey, value);
       }
+      /**
+       * The empty-string clearing contract, named (taglib-qyw2): both backends
+       * remove the property when the written value is empty, and setProperty's
+       * wire-key normalization + MP4 freeform atom-name handling apply unchanged.
+       */
+      removeProperty(key) {
+        this.setProperty(key, "");
+      }
       isMP4() {
         return this.handle.isMP4();
       }
@@ -1787,6 +1834,7 @@ var init_audio_file_base = __esm({
         return this.handle.isValid();
       }
       dispose() {
+        unregisterAutoDispose(this);
         if (this.fileHandle) {
           this.fileHandle.destroy();
           this.fileHandle = null;
@@ -1860,6 +1908,7 @@ function isValidBitrateMode(value) {
 }
 function wrapEmbindHandle(raw) {
   const stagedId3v2Frames = {};
+  let destroyed = false;
   const overrides = {
     getTagData() {
       const tw = raw.getTag();
@@ -1939,6 +1988,22 @@ function wrapEmbindHandle(raw) {
     stripId3Tags(opts) {
       raw.stripId3Tags(opts);
     },
+    destroy() {
+      if (destroyed) return;
+      destroyed = true;
+      raw.destroy();
+    },
+    get destroyed() {
+      return destroyed;
+    },
+    // taglib-qyw2: the PropertyMap erase pass computes freeform item names
+    // from the property table (upper-cased) and misses the restored exact-case
+    // atom (taglib-bnhl), so clears queue the exact name here; the imperative
+    // Embind model applies removeItem immediately, before setProperties.
+    setMp4ItemRemovals(removals) {
+      const handle = raw;
+      for (const name of removals) handle.removeMP4Item(name);
+    },
     getAudioProperties() {
       const pw = raw.getAudioProperties();
       if (!pw) return null;
@@ -2038,6 +2103,15 @@ var init_extra_state_registry = __esm({
           else if (complete) target.setIxml(null);
         }
       },
+      {
+        name: "_mp4ItemRemovals",
+        copy(target, source, complete) {
+          const v = source.getMp4ItemRemovals?.();
+          if (complete || v !== void 0 && v.length > 0) {
+            target.setMp4ItemRemovals?.(v ?? []);
+          }
+        }
+      },
       {
         name: "id3v2Frames",
         copy(target, source) {
@@ -2226,7 +2300,7 @@ var init_audio_file_impl = __esm({
           mimeType: pic.mimeType,
           data: pic.data,
           type: PICTURE_TYPE_NAMES[pic.type] ?? "Other",
-          description: pic.description
+          ...pic.description !== void 0 ? { description: pic.description } : {}
         }));
       }
       setPictures(pictures) {
@@ -2251,13 +2325,20 @@ var init_audio_file_impl = __esm({
       getChapters() {
         const sorted = sortChapters(this.handle.getChapters());
         const trackEndMs = this.audioProperties()?.durationMs;
-        return sorted.map((c, i) => ({
-          startTimeMs: c.startTimeMs,
-          endTimeMs: inferEndTimeMs(sorted, i, trackEndMs),
-          title: c.title || void 0,
-          id: c.id || void 0,
-          source: c.source
-        }));
+        return sorted.map((c, i) => {
+          const endTimeMs = inferEndTimeMs(sorted, i, trackEndMs);
+          return {
+            startTimeMs: c.startTimeMs,
+            ...endTimeMs !== void 0 ? { endTimeMs } : {},
+            // Truthiness, not !== undefined: an empty CHAP title/id must read back
+            // as ABSENT (the old `c.title || undefined` contract; the Embind
+            // reader emits "" unconditionally, WASI omits — coalescing keeps the
+            // backends agreeing).
+            ...c.title ? { title: c.title } : {},
+            ...c.id ? { id: c.id } : {},
+            ...c.source !== void 0 ? { source: c.source } : {}
+          };
+        });
       }
       setChapters(chapters, options) {
         const fmt = this.getFormat();
@@ -2271,10 +2352,10 @@ var init_audio_file_impl = __esm({
         const style = options?.mp4ChapterStyle ?? "quicktime";
         const source = fmt === "MP4" ? style : "id3";
         const raw = sorted.map((c, i) => ({
-          id: c.id,
+          ...c.id !== void 0 ? { id: c.id } : {},
           startTimeMs: c.startTimeMs,
           endTimeMs: inferEndTimeMs(sorted, i, trackEndMs) ?? c.startTimeMs,
-          title: c.title,
+          ...c.title !== void 0 ? { title: c.title } : {},
           source
         }));
         this.handle.setChapters(raw, style);
@@ -2301,8 +2382,9 @@ var init_audio_file_impl = __esm({
         return this.handle.getRatings().map(
           (r) => ({
             rating: r.rating,
-            email: r.email || void 0,
-            counter: r.counter || void 0
+            ...r.email !== void 0 && r.email !== "" ? { email: r.email } : {},
+            // 0 must read back as ABSENT (old `r.counter || undefined` contract).
+            ...r.counter !== 0 ? { counter: r.counter } : {}
           })
         );
       }
@@ -2333,7 +2415,11 @@ var init_audio_file_impl = __esm({
         return ratings.length > 0 ? normalized(ratings[0].rating) : void 0;
       }
       setRating(rating, email) {
-        this.setRatings([{ rating, email, counter: 0 }]);
+        this.setRatings([{
+          rating,
+          ...email !== void 0 ? { email } : {},
+          counter: 0
+        }]);
       }
       getId3v2Frames(id) {
         assertMp3(this.getFormat());
@@ -2446,7 +2532,24 @@ function isMpegFrameSync(bytes, at = 0) {
   if (version === 1 || layer === 0) return false;
   const bitrateIndex = bytes[at + 2] >> 4 & 15;
   const sampleRateIndex = bytes[at + 2] >> 2 & 3;
-  return bitrateIndex !== 0 && bitrateIndex !== 15 && sampleRateIndex !== 3;
+  if (bitrateIndex === 0 || bitrateIndex === 15 || sampleRateIndex === 3) {
+    return false;
+  }
+  const mpeg1 = version === 3;
+  const layerIndex = layer ^ 3;
+  const bitrate = MPEG_BITRATES[mpeg1 ? 0 : 1][layerIndex][bitrateIndex];
+  const sampleRateTable = mpeg1 ? 0 : version === 2 ? 1 : 2;
+  const sampleRate = MPEG_SAMPLE_RATES[sampleRateTable][sampleRateIndex];
+  const samplesPerFrame = layerIndex === 2 ? mpeg1 ? 1152 : 576 : layerIndex === 1 ? 1152 : 384;
+  let frameLength = Math.floor(samplesPerFrame * bitrate * 125 / sampleRate);
+  if ((bytes[at + 2] & 2) !== 0) frameLength += layerIndex === 0 ? 4 : 1;
+  if (frameLength === 0) return false;
+  const next = at + frameLength;
+  if (bytes.length < next + 4) return false;
+  const mask = 4294839296;
+  const header = ((bytes[at] << 24 | bytes[at + 1] << 16 | bytes[at + 2] << 8 | bytes[at + 3]) >>> 0 & mask) >>> 0;
+  const nextHeader = ((bytes[next] << 24 | bytes[next + 1] << 16 | bytes[next + 2] << 8 | bytes[next + 3]) >>> 0 & mask) >>> 0;
+  return header === nextHeader;
 }
 function containerEnd(bytes, at, limit) {
   if (at >= bytes.length) return bytes.length < limit ? null : void 0;
@@ -2489,9 +2592,36 @@ function trailerFitsInFooter(tail, footerSize) {
   }
   return true;
 }
+var MPEG_BITRATES, MPEG_SAMPLE_RATES;
 var init_metadata_extent = __esm({
   "src/taglib/metadata-extent.ts"() {
     "use strict";
+    MPEG_BITRATES = [
+      [
+        [0, 32, 64, 96, 128, 160, 192, 224, 256, 288, 320, 352, 384, 416, 448, 0],
+        // Layer I
+        [0, 32, 48, 56, 64, 80, 96, 112, 128, 160, 192, 224, 256, 320, 384, 0],
+        // Layer II
+        [0, 32, 40, 48, 56, 64, 80, 96, 112, 128, 160, 192, 224, 256, 320, 0]
+        // Layer III
+      ],
+      [
+        [0, 32, 48, 56, 64, 80, 96, 112, 128, 144, 160, 176, 192, 224, 256, 0],
+        // Layer I
+        [0, 8, 16, 24, 32, 40, 48, 56, 64, 80, 96, 112, 128, 144, 160, 0],
+        // Layer II
+        [0, 8, 16, 24, 32, 40, 48, 56, 64, 80, 96, 112, 128, 144, 160, 0]
+        // Layer III
+      ]
+    ];
+    MPEG_SAMPLE_RATES = [
+      [44100, 48e3, 32e3],
+      // MPEG-1
+      [22050, 24e3, 16e3],
+      // MPEG-2
+      [11025, 12e3, 8e3]
+      // MPEG-2.5
+    ];
   }
 });
 
@@ -2763,7 +2893,7 @@ var VERSION;
 var init_version = __esm({
   "src/version.ts"() {
     "use strict";
-    VERSION = "1.8.3";
+    VERSION = "2.0.0";
   }
 });
 
@@ -3236,7 +3366,7 @@ async function readPictureMetadata(file) {
   return pictures.map((pic) => ({
     type: pic.type,
     mimeType: pic.mimeType,
-    description: pic.description,
+    ...pic.description !== void 0 ? { description: pic.description } : {},
     size: pic.data.length
   }));
 }
@@ -3310,10 +3440,10 @@ function extractDynamics(audioFile) {
     "replayGainAlbumPeak"
   ];
   for (const field of fields) {
-    const val = audioFile.getProperty(field);
-    if (val) dynamics[field] = val;
+    const val = audioFile.getProperty(field)?.[0];
+    if (val !== void 0) dynamics[field] = val;
   }
-  let appleSoundCheck = audioFile.getProperty("appleSoundCheck");
+  let appleSoundCheck = audioFile.getProperty("appleSoundCheck")?.[0];
   if (!appleSoundCheck && audioFile.isMP4()) {
     appleSoundCheck = audioFile.getMP4Item("----:com.apple.iTunes:iTunNORM");
   }
@@ -3339,23 +3469,27 @@ async function readMetadata(file) {
         `File may be corrupted or in an unsupported format. File: ${name}`
       );
     }
+    const dynamics = extractDynamics(audioFile);
     return {
       tags: readExtendedTag(audioFile),
       properties: audioFile.audioProperties(),
       hasCoverArt: audioFile.getPictures().length > 0,
-      dynamics: extractDynamics(audioFile)
+      ...dynamics !== void 0 ? { dynamics } : {}
     };
   } finally {
     audioFile.dispose();
   }
 }
 async function readMetadataBatch(files, options = {}) {
-  return executeBatch(files, options, (audioFile) => ({
-    tags: readExtendedTag(audioFile),
-    properties: audioFile.audioProperties(),
-    hasCoverArt: audioFile.getPictures().length > 0,
-    dynamics: extractDynamics(audioFile)
-  }));
+  return executeBatch(files, options, (audioFile) => {
+    const dynamics = extractDynamics(audioFile);
+    return {
+      tags: readExtendedTag(audioFile),
+      properties: audioFile.audioProperties(),
+      hasCoverArt: audioFile.getPictures().length > 0,
+      ...dynamics !== void 0 ? { dynamics } : {}
+    };
+  });
 }
 
 // src/simple/index.ts

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

@@ -21,8 +21,6 @@
  * file.setRatings([{ rating: 0.8, email: "user@example.com" }]);
  * ```
  */
-import type { Picture } from "../types.js";
-import type { Chapter } from "../types/chapters.js";
 /**
  * Rating metadata representing track popularity/rating.
  * Uses normalized 0.0-1.0 scale for cross-format compatibility.
@@ -76,116 +74,4 @@ export interface UnsyncedLyrics {
  * Used as escape hatch when type is not known at compile time.
  */
 export type VariantMap = Record<string, unknown>;
-/**
- * Type map linking complex property keys to their value types.
- *
- * This is a descriptive type map, not the accessor surface — each complex
- * property is reached through its own typed method:
- *
- * @example
- * ```typescript
- * const ratings = file.getRatings(); // Rating[]
- * const pictures = file.getPictures(); // Picture[]
- * const chapters = file.getChapters(); // Chapter[]
- * ```
- *
- * Consumers can extend via module augmentation:
- * ```typescript
- * declare module "taglib-wasm" {
- *   interface ComplexPropertyValueMap {
- *     MY_CUSTOM: { foo: string };
- *   }
- * }
- * ```
- */
-export interface ComplexPropertyValueMap {
-    /** Cover art and embedded images */
-    PICTURE: Picture;
-    /** Track/album rating (normalized 0.0-1.0) */
-    RATING: Rating;
-    /** Unsynchronized lyrics text */
-    LYRICS: UnsyncedLyrics;
-    /** Chapter markers (ID3v2 CHAP frames) */
-    CHAPTER: Chapter;
-}
-/**
- * Union type of all valid complex property keys.
- */
-export type ComplexPropertyKey = keyof ComplexPropertyValueMap;
-/**
- * Rich metadata object for complex properties.
- * Contains descriptions, format support info, and underlying format mappings.
- *
- * Use this for introspection, documentation, or format-aware operations.
- */
-export declare const COMPLEX_PROPERTIES: {
-    readonly PICTURE: {
-        readonly key: "PICTURE";
-        readonly description: "Embedded album art or images";
-        readonly type: "binary";
-        readonly supportedFormats: readonly ["ID3v2", "MP4", "Vorbis", "FLAC"];
-        readonly mappings: {
-            readonly id3v2: {
-                readonly frame: "APIC";
-            };
-            readonly mp4: "covr";
-            readonly vorbis: "METADATA_BLOCK_PICTURE";
-            readonly flac: "PICTURE";
-        };
-    };
-    readonly RATING: {
-        readonly key: "RATING";
-        readonly description: "Track rating (normalized 0.0-1.0)";
-        readonly type: "object";
-        readonly supportedFormats: readonly ["ID3v2", "Vorbis", "MP4"];
-        readonly mappings: {
-            readonly id3v2: {
-                readonly frame: "POPM";
-            };
-            readonly vorbis: "RATING";
-            readonly mp4: "----:com.apple.iTunes:RATING";
-        };
-    };
-    readonly LYRICS: {
-        readonly key: "LYRICS";
-        readonly description: "Unsynchronized lyrics text";
-        readonly type: "object";
-        readonly supportedFormats: readonly ["ID3v2", "Vorbis", "MP4"];
-        readonly mappings: {
-            readonly id3v2: {
-                readonly frame: "USLT";
-            };
-            readonly vorbis: "LYRICS";
-            readonly mp4: "©lyr";
-        };
-    };
-    readonly CHAPTER: {
-        readonly key: "CHAPTER";
-        readonly description: "Chapter markers with time ranges";
-        readonly type: "object";
-        readonly supportedFormats: readonly ["ID3v2"];
-        readonly mappings: {
-            readonly id3v2: {
-                readonly frame: "CHAP";
-            };
-        };
-    };
-};
-/**
- * Type for the simple key map.
- */
-export type ComplexPropertyKeyMap = {
-    readonly [K in ComplexPropertyKey]: K;
-};
-/**
- * Simple string map for daily use.
- * Avoids the `.key` ceremony when you just need the key string.
- *
- * @example
- * ```typescript
- * // Instead of: COMPLEX_PROPERTIES.RATING.key
- * COMPLEX_PROPERTY_KEY.RATING; // "RATING"
- * ```
- */
-export declare const COMPLEX_PROPERTY_KEY: ComplexPropertyKeyMap;
 //# sourceMappingURL=complex-properties.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"complex-properties.d.ts","sourceRoot":"","sources":["../../../src/constants/complex-properties.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAEpD;;;;;;;;GAQG;AACH,MAAM,WAAW,MAAM;IACrB,6DAA6D;IAC7D,MAAM,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,UAAU;IACzB,qEAAqE;IACrE,EAAE,EAAE,MAAM,CAAC;IACX,0DAA0D;IAC1D,IAAI,EAAE,UAAU,CAAC;IACjB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEjD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,WAAW,uBAAuB;IACtC,oCAAoC;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,MAAM,EAAE,cAAc,CAAC;IACvB,0CAA0C;IAC1C,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,uBAAuB,CAAC;AAE/D;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4CrB,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,EAAE,CAAC,IAAI,kBAAkB,GAAG,CAAC;CACtC,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,oBAAoB,EAAE,qBAKzB,CAAC"}
+{"version":3,"file":"complex-properties.d.ts","sourceRoot":"","sources":["../../../src/constants/complex-properties.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAIH;;;;;;;;GAQG;AACH,MAAM,WAAW,MAAM;IACrB,6DAA6D;IAC7D,MAAM,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,UAAU;IACzB,qEAAqE;IACrE,EAAE,EAAE,MAAM,CAAC;IACX,0DAA0D;IAC1D,IAAI,EAAE,UAAU,CAAC;IACjB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC"}

package/dist/src/constants/complex-properties.js

@@ -1,55 +0,0 @@
-const COMPLEX_PROPERTIES = {
-  PICTURE: {
-    key: "PICTURE",
-    description: "Embedded album art or images",
-    type: "binary",
-    supportedFormats: ["ID3v2", "MP4", "Vorbis", "FLAC"],
-    mappings: {
-      id3v2: { frame: "APIC" },
-      mp4: "covr",
-      vorbis: "METADATA_BLOCK_PICTURE",
-      flac: "PICTURE"
-    }
-  },
-  RATING: {
-    key: "RATING",
-    description: "Track rating (normalized 0.0-1.0)",
-    type: "object",
-    supportedFormats: ["ID3v2", "Vorbis", "MP4"],
-    mappings: {
-      id3v2: { frame: "POPM" },
-      vorbis: "RATING",
-      mp4: "----:com.apple.iTunes:RATING"
-    }
-  },
-  LYRICS: {
-    key: "LYRICS",
-    description: "Unsynchronized lyrics text",
-    type: "object",
-    supportedFormats: ["ID3v2", "Vorbis", "MP4"],
-    mappings: {
-      id3v2: { frame: "USLT" },
-      vorbis: "LYRICS",
-      mp4: "\xA9lyr"
-    }
-  },
-  CHAPTER: {
-    key: "CHAPTER",
-    description: "Chapter markers with time ranges",
-    type: "object",
-    supportedFormats: ["ID3v2"],
-    mappings: {
-      id3v2: { frame: "CHAP" }
-    }
-  }
-};
-const COMPLEX_PROPERTY_KEY = {
-  PICTURE: "PICTURE",
-  RATING: "RATING",
-  LYRICS: "LYRICS",
-  CHAPTER: "CHAPTER"
-};
-export {
-  COMPLEX_PROPERTIES,
-  COMPLEX_PROPERTY_KEY
-};

package/dist/src/constants/index.d.ts

@@ -3,7 +3,6 @@
  * Maintains backward compatibility by re-exporting all constants and utilities
  */
 export * from "./properties.js";
-export * from "./tags.js";
 export * from "./format-mappings.js";
 export * from "./utilities.js";
 export * from "./complex-properties.js";

package/dist/src/constants/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/constants/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,cAAc,iBAAiB,CAAC;AAGhC,cAAc,WAAW,CAAC;AAG1B,cAAc,sBAAsB,CAAC;AAGrC,cAAc,gBAAgB,CAAC;AAG/B,cAAc,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/constants/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,cAAc,iBAAiB,CAAC;AAGhC,cAAc,sBAAsB,CAAC;AAGrC,cAAc,gBAAgB,CAAC;AAG/B,cAAc,yBAAyB,CAAC"}

package/dist/src/constants/index.js

@@ -1,5 +1,4 @@
 export * from "./properties.js";
-export * from "./tags.js";
 export * from "./format-mappings.js";
 export * from "./utilities.js";
 export * from "./complex-properties.js";

package/dist/src/file-utils/import-operations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"import-operations.d.ts","sourceRoot":"","sources":["../../../src/file-utils/import-operations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAOxD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,cAAc,CAClC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;IACP,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACjB,GACL,OAAO,CAAC,IAAI,CAAC,CAMf;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,qBAAqB,CACzC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,WAAW,EACjB,OAAO,GAAE;IACP,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACjB,GACL,OAAO,CAAC,IAAI,CAAC,CAaf;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,mBAAmB,CACvC,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE,WAA0B,EAChC,OAAO,GAAE;IACP,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACjB,GACL,OAAO,CAAC,OAAO,CAAC,CAUlB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAEf"}
+{"version":3,"file":"import-operations.d.ts","sourceRoot":"","sources":["../../../src/file-utils/import-operations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAOxD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,cAAc,CAClC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;IACP,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACjB,GACL,OAAO,CAAC,IAAI,CAAC,CAMf;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,qBAAqB,CACzC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,WAAW,EACjB,OAAO,GAAE;IACP,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACjB,GACL,OAAO,CAAC,IAAI,CAAC,CAef;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,mBAAmB,CACvC,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE,WAA0B,EAChC,OAAO,GAAE;IACP,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACjB,GACL,OAAO,CAAC,OAAO,CAAC,CAUlB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAEf"}

package/dist/src/file-utils/import-operations.js

@@ -16,7 +16,7 @@ async function importPictureWithType(audioPath, imagePath, type, options = {}) {
     mimeType,
     data: imageData,
     type,
-    description: options.description
+    ...options.description !== void 0 ? { description: options.description } : {}
   };
   const modifiedBuffer = await replacePictureByType(audioPath, picture);
   await writeFileData(audioPath, modifiedBuffer);

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

@@ -1 +1 @@
-{"version":3,"file":"file-processors.d.ts","sourceRoot":"","sources":["../../../src/folder-api/file-processors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAEV,iBAAiB,EAElB,MAAM,YAAY,CAAC;AAGpB,wBAAsB,YAAY,CAAC,CAAC,EAClC,KAAK,EAAE,MAAM,EAAE,EACf,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,EACvC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,CAAC,EAAE,CAAC,CAYd;AAED,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,iBAAiB,EAAE,OAAO,EAC1B,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,KAAK,IAAI,EAC5E,SAAS,CAAC,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,EAC7B,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,iBAAiB,CAAC,CAoD5B"}
+{"version":3,"file":"file-processors.d.ts","sourceRoot":"","sources":["../../../src/folder-api/file-processors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAEV,iBAAiB,EAElB,MAAM,YAAY,CAAC;AAGpB,wBAAsB,YAAY,CAAC,CAAC,EAClC,KAAK,EAAE,MAAM,EAAE,EACf,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,EACvC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,CAAC,EAAE,CAAC,CAYd;AAED,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,iBAAiB,EAAE,OAAO,EAC1B,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,KAAK,IAAI,EAC5E,SAAS,CAAC,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,EAC7B,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,iBAAiB,CAAC,CAuD5B"}

package/dist/src/folder-api/file-processors.js

@@ -31,12 +31,12 @@ async function processFileWithTagLib(filePath, taglib, includeProperties, onProg
       "replayGainAlbumPeak"
     ];
     for (const field of fieldNames) {
-      const value = audioFile.getProperty(field);
-      if (value) {
+      const value = audioFile.getProperty(field)?.[0];
+      if (value !== void 0) {
         dynamics[field] = value;
       }
     }
-    let appleSoundCheck = audioFile.getProperty("appleSoundCheck");
+    let appleSoundCheck = audioFile.getProperty("appleSoundCheck")?.[0];
     if (!appleSoundCheck && audioFile.isMP4()) {
       appleSoundCheck = audioFile.getMP4Item("----:com.apple.iTunes:iTunNORM");
     }
@@ -45,12 +45,13 @@ async function processFileWithTagLib(filePath, taglib, includeProperties, onProg
       const current = ++processed.count;
       onProgress?.(current, totalFound, filePath);
     }
+    const withDynamics = Object.keys(dynamics).length > 0 ? dynamics : void 0;
     return {
       path: filePath,
       tags,
-      properties,
+      ...properties !== void 0 ? { properties } : {},
       hasCoverArt,
-      dynamics: Object.keys(dynamics).length > 0 ? dynamics : void 0
+      ...withDynamics !== void 0 ? { dynamics: withDynamics } : {}
     };
   } finally {
     audioFile.dispose();

package/dist/src/folder-api/scan-for-albums.js

@@ -11,9 +11,9 @@ async function scanForAlbums(folderPath, options = {}) {
   } = options;
   const scan = await scanFolder(folderPath, scanOptions);
   return groupAlbums(scan, {
-    minFolderConfidence,
-    flatDiscPrefixes,
-    folderFallback,
+    ...minFolderConfidence !== void 0 ? { minFolderConfidence } : {},
+    ...flatDiscPrefixes !== void 0 ? { flatDiscPrefixes } : {},
+    ...folderFallback !== void 0 ? { folderFallback } : {},
     scanRoot: folderPath
   });
 }

package/dist/src/folder-api/scan-operations.js

@@ -62,9 +62,9 @@ async function scanFolder(folderPath, options = {}) {
   const processOpts = {
     includeProperties,
     continueOnError,
-    onProgress,
+    ...onProgress !== void 0 ? { onProgress } : {},
     totalFound,
-    signal
+    ...signal !== void 0 ? { signal } : {}
   };
   const items = await scanWithTagLib(taglib, filePaths, processOpts);
   return {

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,sFAAsF;AAEtF,OAAO,EAAU,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAE/D,OAAO,KAAK,EACV,eAAe,EACf,WAAW,EACX,OAAO,EACP,WAAW,EACZ,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAatD,wBAAgB,aAAa,CAAC,aAAa,EAAE,UAAU,GAAG,WAAW,CAapE;AAED,wBAAgB,qBAAqB,CACnC,aAAa,EAAE,UAAU,GACxB,eAAe,CAiBjB;AAED,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,UAAU,GAAG,WAAW,CASxE;AAED,wBAAgB,aAAa,CAAC,aAAa,EAAE,UAAU,GAAG,OAAO,CAWhE;AAED,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,UAAU,GAAG,OAAO,EAAE,CAavE;AAED,wBAAgB,iBAAiB,CAAC,CAAC,GAAG,OAAO,EAC3C,aAAa,EAAE,UAAU,EACzB,OAAO,GAAE,OAAO,CAAC,cAAc,CAAM,GACpC,CAAC,CAUH;AA2BD,wBAAgB,qBAAqB,CACnC,aAAa,EAAE,UAAU,GACxB,WAAW,GAAG,eAAe,GAAG,OAAO,GAAG,WAAW,CAiCvD;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAc9D;AAaD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,UAAU,GAAG;IACtD,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,mBAAmB,CAAC;CAC3B,CAuBA;AAED,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,sFAAsF;AAEtF,OAAO,EAAU,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAE/D,OAAO,KAAK,EACV,eAAe,EACf,WAAW,EACX,OAAO,EACP,WAAW,EACZ,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAYtD,wBAAgB,aAAa,CAAC,aAAa,EAAE,UAAU,GAAG,WAAW,CAapE;AAED,wBAAgB,qBAAqB,CACnC,aAAa,EAAE,UAAU,GACxB,eAAe,CAiBjB;AAED,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,UAAU,GAAG,WAAW,CASxE;AAED,wBAAgB,aAAa,CAAC,aAAa,EAAE,UAAU,GAAG,OAAO,CAWhE;AAED,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,UAAU,GAAG,OAAO,EAAE,CAavE;AAED,wBAAgB,iBAAiB,CAAC,CAAC,GAAG,OAAO,EAC3C,aAAa,EAAE,UAAU,EACzB,OAAO,GAAE,OAAO,CAAC,cAAc,CAAM,GACpC,CAAC,CAUH;AA2BD,wBAAgB,qBAAqB,CACnC,aAAa,EAAE,UAAU,GACxB,WAAW,GAAG,eAAe,GAAG,OAAO,GAAG,WAAW,CAiCvD;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAc9D;AAaD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,UAAU,GAAG;IACtD,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,mBAAmB,CAAC;CAC3B,CAuBA;AAED,wBAAgB,iBAAiB,CAC/B,aAAa,EAAE,UAAU,GACxB,IAAI,CAAC,WAAW,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC,CAqBpE"}