taglib-wasm 1.8.3 → 2.1.0

package/dist/index.js

@@ -51,13 +51,12 @@ import {
   FormatMappings,
   getAllProperties,
   getAllPropertyKeys,
-  getAllTagNames,
   getPropertiesByFormat,
   getPropertyMetadata,
   isValidProperty,
-  isValidTagName,
   PROPERTIES,
-  Tags
+  propertyValue,
+  propertyValues
 } from "./src/constants.js";
 import {
   copyCoverArt,
@@ -95,10 +94,6 @@ import {
   PICTURE_TYPE_NAMES,
   PICTURE_TYPE_VALUES
 } from "./src/types.js";
-import {
-  COMPLEX_PROPERTIES,
-  COMPLEX_PROPERTY_KEY
-} from "./src/constants/complex-properties.js";
 import { RatingUtils } from "./src/utils/rating.js";
 import * as bwf from "./src/bwf/bext.js";
 import { loadTagLibModule } from "./src/runtime/module-loader.js";
@@ -106,8 +101,6 @@ export {
   AudioFileImpl,
   BITRATE_CONTROL_MODE_NAMES,
   BITRATE_CONTROL_MODE_VALUES,
-  COMPLEX_PROPERTIES,
-  COMPLEX_PROPERTY_KEY,
   EnvironmentError,
   FileOperationError,
   FormatMappings,
@@ -122,7 +115,6 @@ export {
   TagLib,
   TagLibError,
   TagLibInitializationError,
-  Tags,
   UnsupportedFormatError,
   addPicture,
   applyCoverArt,
@@ -149,7 +141,6 @@ export {
   findPictureByType,
   getAllProperties,
   getAllPropertyKeys,
-  getAllTagNames,
   getPropertiesByFormat,
   getPropertyMetadata,
   groupAlbums,
@@ -168,11 +159,12 @@ export {
   isUnsupportedFormatError,
   isValidAudioFile,
   isValidProperty,
-  isValidTagName,
   loadPictureFromFile,
   loadTagLibModule,
   pictureToDataURL,
   prepareWasmForEmbedding,
+  propertyValue,
+  propertyValues,
   readCoverArt,
   readFormat,
   readMetadata,

package/dist/simple.browser.js

@@ -1,8 +1,13 @@
 var __defProp = Object.defineProperty;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __esm = (fn, res) => function __init() {
-  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+var __esm = (fn, res, err) => function __init() {
+  if (err) throw err[0];
+  try {
+    return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+  } catch (e) {
+    throw err = [e], e;
+  }
 };
 var __export = (target, all) => {
   for (var name in all)
@@ -1648,6 +1653,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 +1679,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 +1700,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 +1760,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 +1799,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 +1839,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 +1913,7 @@ function isValidBitrateMode(value) {
 }
 function wrapEmbindHandle(raw) {
   const stagedId3v2Frames = {};
+  let destroyed = false;
   const overrides = {
     getTagData() {
       const tw = raw.getTag();
@@ -1939,6 +1993,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 +2108,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 +2305,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 +2330,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 +2357,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 +2387,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 +2420,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 +2537,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 +2597,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
+    ];
   }
 });
 
@@ -2626,7 +2761,7 @@ function mapPropertiesToExtendedTag(props) {
       const num = parseLeadingInt(values[0]);
       if (num !== void 0) tag[camelKey] = num;
     } else if (camelKey === "compilation") {
-      tag[camelKey] = values[0] === "1";
+      tag[camelKey] = values[0] === "1" || values[0] === "true";
     } else if (camelKey === "itunesAdvisory") {
       tag[camelKey] = values;
       if (values[0] === "1") tag.advisory = "explicit";
@@ -2763,7 +2898,7 @@ var VERSION;
 var init_version = __esm({
   "src/version.ts"() {
     "use strict";
-    VERSION = "1.8.3";
+    VERSION = "2.1.0";
   }
 });
 
@@ -3236,7 +3371,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 +3445,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 +3474,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/constants/utilities.d.ts

@@ -1,4 +1,5 @@
 import { PROPERTIES, type PropertyKey } from "./properties.js";
+import type { PropertyMap } from "../types/tags.js";
 import type { PropertyMetadata } from "./property-types.js";
 /**
  * Type guard to check if a string is a valid property key
@@ -23,4 +24,16 @@ export declare function getAllProperties(): readonly [
  * Filter properties by supported format
  */
 export declare function getPropertiesByFormat(format: string): PropertyKey[];
+/**
+ * All values for a property key in a PropertyMap; `[]` when absent
+ * (taglib-lk8u). Removes the narrowing filter at the call site: the map's
+ * index signature must admit undefined, so a bare read is
+ * `string[] | undefined` even for known keys.
+ */
+export declare function propertyValues(props: PropertyMap, key: string): string[];
+/**
+ * First value for a property key in a PropertyMap; `undefined` when absent.
+ * The common single-value read, without the `?.[0]` at every call site.
+ */
+export declare function propertyValue(props: PropertyMap, key: string): string | undefined;
 //# sourceMappingURL=utilities.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"utilities.d.ts","sourceRoot":"","sources":["../../../src/constants/utilities.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,IAAI,WAAW,CAE/D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,WAAW,EACvD,GAAG,EAAE,CAAC,GACL,gBAAgB,GAAG,SAAS,CAE9B;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,SAAS,WAAW,EAAE,CAE3D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,SAAS;IAC3C,WAAW;IACX,OAAO,UAAU,CAAC,WAAW,CAAC;CAC/B,EAAE,CAKF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,EAAE,CAInE"}
+{"version":3,"file":"utilities.d.ts","sourceRoot":"","sources":["../../../src/constants/utilities.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,IAAI,WAAW,CAE/D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,WAAW,EACvD,GAAG,EAAE,CAAC,GACL,gBAAgB,GAAG,SAAS,CAE9B;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,SAAS,WAAW,EAAE,CAE3D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,SAAS;IAC3C,WAAW;IACX,OAAO,UAAU,CAAC,WAAW,CAAC;CAC/B,EAAE,CAKF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,EAAE,CAInE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAExE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,WAAW,EAClB,GAAG,EAAE,MAAM,GACV,MAAM,GAAG,SAAS,CAEpB"}