taglib-wasm 1.2.1 → 1.3.0

package/dist/simple.browser.js

@@ -292,8 +292,8 @@ var init_base = __esm({
        */
       constructor(code, message, details) {
         super(message);
-        this.code = code;
-        this.details = details;
+        __publicField(this, "code", code);
+        __publicField(this, "details", details);
         this.name = "TagLibError";
         Object.setPrototypeOf(this, _TagLibError.prototype);
       }
@@ -353,7 +353,7 @@ var init_classes = __esm({
           errorDetails.join(". "),
           { ...details, bufferSize }
         );
-        this.bufferSize = bufferSize;
+        __publicField(this, "bufferSize", bufferSize);
         this.name = "InvalidFormatError";
         Object.setPrototypeOf(this, _InvalidFormatError.prototype);
       }
@@ -371,8 +371,8 @@ var init_classes = __esm({
           `Unsupported audio format: ${format}. Supported formats: ${supportedFormats.join(", ")}`,
           { ...details, format, supportedFormats }
         );
-        this.format = format;
-        this.supportedFormats = supportedFormats;
+        __publicField(this, "format", format);
+        __publicField(this, "supportedFormats", supportedFormats);
         this.name = "UnsupportedFormatError";
         Object.setPrototypeOf(this, _UnsupportedFormatError.prototype);
       }
@@ -396,8 +396,8 @@ var init_classes = __esm({
           errorDetails.join(". "),
           { ...details, operation, path }
         );
-        this.operation = operation;
-        this.path = path;
+        __publicField(this, "operation", operation);
+        __publicField(this, "path", path);
         this.name = "FileOperationError";
         Object.setPrototypeOf(this, _FileOperationError.prototype);
       }
@@ -421,8 +421,8 @@ var init_classes = __esm({
           errorDetails.join(". "),
           { ...details, operation, field }
         );
-        this.operation = operation;
-        this.field = field;
+        __publicField(this, "operation", operation);
+        __publicField(this, "field", field);
         this.name = "MetadataError";
         Object.setPrototypeOf(this, _MetadataError.prototype);
       }
@@ -453,9 +453,9 @@ var init_classes = __esm({
       constructor(environment, reason, requiredFeature) {
         const message = requiredFeature ? `Environment '${environment}' ${reason}. Required feature: ${requiredFeature}.` : `Environment '${environment}' ${reason}.`;
         super("ENVIRONMENT", message);
-        this.environment = environment;
-        this.reason = reason;
-        this.requiredFeature = requiredFeature;
+        __publicField(this, "environment", environment);
+        __publicField(this, "reason", reason);
+        __publicField(this, "requiredFeature", requiredFeature);
         this.name = "EnvironmentError";
         Object.setPrototypeOf(this, _EnvironmentError.prototype);
       }
@@ -561,60 +561,6 @@ var init_platform_io_browser_stub = __esm({
   }
 });
 
-// src/utils/file.ts
-async function readFileData(file) {
-  if (file instanceof Uint8Array) return file;
-  if (file instanceof ArrayBuffer) return new Uint8Array(file);
-  if (typeof File !== "undefined" && file instanceof File) {
-    return new Uint8Array(await file.arrayBuffer());
-  }
-  if (typeof file === "string") {
-    try {
-      return await getPlatformIO().readFile(file);
-    } catch (error) {
-      if (error instanceof EnvironmentError) throw error;
-      throw new FileOperationError("read", error.message, file);
-    }
-  }
-  const inputType = Object.prototype.toString.call(file);
-  throw new FileOperationError(
-    "read",
-    `Invalid file input type: ${inputType}. Expected string path, Uint8Array, ArrayBuffer, or File object.`
-  );
-}
-async function getFileSize(path) {
-  try {
-    const s = await getPlatformIO().stat(path);
-    return s.size;
-  } catch (error) {
-    if (error instanceof EnvironmentError) throw error;
-    throw new FileOperationError("stat", error.message, path);
-  }
-}
-async function readPartialFileData(path, headerSize, footerSize) {
-  const io = getPlatformIO();
-  if (!io.readPartial) {
-    throw new EnvironmentError(
-      "current runtime",
-      "does not support partial file reading",
-      "filesystem access with seek support"
-    );
-  }
-  try {
-    return await io.readPartial(path, headerSize, footerSize);
-  } catch (error) {
-    if (error instanceof EnvironmentError) throw error;
-    throw new FileOperationError("read", error.message, path);
-  }
-}
-var init_file = __esm({
-  "src/utils/file.ts"() {
-    "use strict";
-    init_errors2();
-    init_platform_io_browser_stub();
-  }
-});
-
 // src/utils/write.ts
 async function writeFileData(path, data) {
   try {
@@ -1383,7 +1329,7 @@ var init_audio_file_base = __esm({
     init_errors2();
     BaseAudioFileImpl = class {
       constructor(module, fileHandle, sourcePath, originalSource, isPartiallyLoaded = false, partialLoadOptions) {
-        this.module = module;
+        __publicField(this, "module", module);
         __publicField(this, "fileHandle");
         __publicField(this, "cachedAudioProperties", null);
         __publicField(this, "sourcePath");
@@ -1433,6 +1379,9 @@ var init_audio_file_base = __esm({
           get track() {
             return data.track;
           },
+          get date() {
+            return handle.getProperty("DATE") || void 0;
+          },
           setTitle: (value) => {
             handle.setTagData({ title: value });
             data = handle.getTagData();
@@ -1467,6 +1416,15 @@ var init_audio_file_base = __esm({
             handle.setTagData({ track: value });
             data = handle.getTagData();
             return tag;
+          },
+          setDate: (value) => {
+            if (value === "") {
+              handle.setTagData({ year: 0 });
+            } else {
+              handle.setProperty("DATE", value);
+            }
+            data = handle.getTagData();
+            return tag;
           }
         };
         return tag;
@@ -1533,6 +1491,60 @@ var init_audio_file_base = __esm({
   }
 });
 
+// src/utils/file.ts
+async function readFileData(file) {
+  if (file instanceof Uint8Array) return file;
+  if (file instanceof ArrayBuffer) return new Uint8Array(file);
+  if (typeof File !== "undefined" && file instanceof File) {
+    return new Uint8Array(await file.arrayBuffer());
+  }
+  if (typeof file === "string") {
+    try {
+      return await getPlatformIO().readFile(file);
+    } catch (error) {
+      if (error instanceof EnvironmentError) throw error;
+      throw new FileOperationError("read", error.message, file);
+    }
+  }
+  const inputType = Object.prototype.toString.call(file);
+  throw new FileOperationError(
+    "read",
+    `Invalid file input type: ${inputType}. Expected string path, Uint8Array, ArrayBuffer, or File object.`
+  );
+}
+async function getFileSize(path) {
+  try {
+    const s = await getPlatformIO().stat(path);
+    return s.size;
+  } catch (error) {
+    if (error instanceof EnvironmentError) throw error;
+    throw new FileOperationError("stat", error.message, path);
+  }
+}
+async function readPartialFileData(path, headerSize, footerSize) {
+  const io = getPlatformIO();
+  if (!io.readPartial) {
+    throw new EnvironmentError(
+      "current runtime",
+      "does not support partial file reading",
+      "filesystem access with seek support"
+    );
+  }
+  try {
+    return await io.readPartial(path, headerSize, footerSize);
+  } catch (error) {
+    if (error instanceof EnvironmentError) throw error;
+    throw new FileOperationError("read", error.message, path);
+  }
+}
+var init_file = __esm({
+  "src/utils/file.ts"() {
+    "use strict";
+    init_errors2();
+    init_platform_io_browser_stub();
+  }
+});
+
 // src/taglib/embind-adapter.ts
 function isValidBitrateMode(value) {
   return value === "CBR" || value === "VBR" || value === "ABR";
@@ -1579,6 +1591,24 @@ function wrapEmbindHandle(raw) {
         data ?? null
       );
     },
+    // Emscripten exposes USLT only through the PropertyMap "LYRICS" key (no
+    // dedicated Embind binding), so bridge get/setLyrics to get/setProperties.
+    // Text only — language/description are not surfaced by the PropertyMap.
+    getLyrics() {
+      const props = raw.getProperties();
+      return (props["LYRICS"] ?? []).map((text) => ({
+        text,
+        description: "",
+        language: ""
+      }));
+    },
+    setLyrics(lyrics) {
+      const handle = raw;
+      const props = handle.getProperties();
+      if (lyrics.length > 0) props["LYRICS"] = lyrics.map((l) => l.text);
+      else delete props["LYRICS"];
+      handle.setProperties(props);
+    },
     hasId3Tags() {
       const v = raw.hasId3Tags();
       if (!v || typeof v !== "object") return { v1: false, v2: false };
@@ -1628,6 +1658,112 @@ var init_embind_adapter = __esm({
   }
 });
 
+// src/taglib/extra-state-registry.ts
+function chapterStyle(chapters) {
+  const s = chapters[0]?.source;
+  return s === "nero" || s === "both" ? s : "quicktime";
+}
+function copyExtraState(target, source, sourceComplete) {
+  for (const field of EXTRA_FIELDS) {
+    field.copy(target, source, sourceComplete);
+  }
+}
+var EXTRA_FIELDS;
+var init_extra_state_registry = __esm({
+  "src/taglib/extra-state-registry.ts"() {
+    "use strict";
+    EXTRA_FIELDS = [
+      {
+        name: "pictures",
+        copy(target, source, complete) {
+          const v = source.getPictures();
+          if (complete || v.length > 0) target.setPictures(v);
+        }
+      },
+      {
+        name: "ratings",
+        copy(target, source, complete) {
+          const v = source.getRatings();
+          if (complete || v.length > 0) target.setRatings(v);
+        }
+      },
+      {
+        name: "lyrics",
+        copy(target, source, complete) {
+          const v = source.getLyrics();
+          if (complete || v.length > 0) target.setLyrics(v);
+        }
+      },
+      {
+        name: "chapters",
+        copy(target, source, complete) {
+          const v = source.getChapters();
+          if (complete || v.length > 0) target.setChapters(v, chapterStyle(v));
+        }
+      },
+      {
+        name: "bextData",
+        copy(target, source, complete) {
+          const v = source.getBextData();
+          if (v !== void 0) target.setBextData(v);
+          else if (complete) target.setBextData(null);
+        }
+      },
+      {
+        name: "ixml",
+        copy(target, source, complete) {
+          const v = source.getIxml();
+          if (v !== void 0) target.setIxml(v);
+          else if (complete) target.setIxml(null);
+        }
+      }
+    ];
+  }
+});
+
+// src/taglib/save-reconstruct.ts
+function copyEditedState(target, source, sourceComplete) {
+  target.setTagData(source.getTagData());
+  target.setProperties(
+    sourceComplete ? source.getProperties() : { ...target.getProperties(), ...source.getProperties() }
+  );
+  copyExtraState(target, source, sourceComplete);
+}
+async function saveViaFreshHandle(module, editing, source, targetPath, sourceComplete) {
+  const rawFullHandle = module.createFileHandle();
+  const fullFileHandle = module.isWasi ? rawFullHandle : wrapEmbindHandle(rawFullHandle);
+  try {
+    {
+      const data = await readFileData(source);
+      if (!fullFileHandle.loadFromBuffer(data)) {
+        throw new InvalidFormatError(
+          "Failed to load full audio file for saving"
+        );
+      }
+    }
+    copyEditedState(fullFileHandle, editing, sourceComplete);
+    if (!fullFileHandle.save()) {
+      throw new FileOperationError(
+        "save",
+        "Failed to save changes to full file"
+      );
+    }
+    await writeFileData(targetPath, fullFileHandle.getBuffer());
+  } finally {
+    fullFileHandle.destroy();
+  }
+}
+var init_save_reconstruct = __esm({
+  "src/taglib/save-reconstruct.ts"() {
+    "use strict";
+    init_errors2();
+    init_file();
+    init_write();
+    init_embind_adapter();
+    init_extra_state_registry();
+  }
+});
+
 // src/taglib/audio-file-impl.ts
 function sortChapters(list) {
   return [...list].sort((a, b) => a.startTimeMs - b.startTimeMs);
@@ -1657,10 +1793,9 @@ var init_audio_file_impl = __esm({
     init_types2();
     init_audio_file_bwf();
     init_errors2();
-    init_file();
     init_write();
     init_audio_file_base();
-    init_embind_adapter();
+    init_save_reconstruct();
     AudioFileImpl = class extends BaseAudioFileImpl {
       constructor(module, fileHandle, sourcePath, originalSource, isPartiallyLoaded = false, partialLoadOptions) {
         super(
@@ -1706,38 +1841,23 @@ var init_audio_file_impl = __esm({
           );
         }
         if (this.isPartiallyLoaded && this.originalSource) {
-          const rawFullHandle = this.module.createFileHandle();
-          const fullFileHandle = this.module.isWasi ? rawFullHandle : wrapEmbindHandle(rawFullHandle);
-          try {
-            const success = await (async () => {
-              const data = await readFileData(this.originalSource);
-              return fullFileHandle.loadFromBuffer(data);
-            })();
-            if (!success) {
-              throw new InvalidFormatError(
-                "Failed to load full audio file for saving"
-              );
-            }
-            fullFileHandle.setTagData(this.handle.getTagData());
-            fullFileHandle.setProperties(this.handle.getProperties());
-            fullFileHandle.setPictures(this.handle.getPictures());
-            const bextBytes = this.handle.getBextData();
-            if (bextBytes !== void 0) fullFileHandle.setBextData(bextBytes);
-            const ixmlStr = this.handle.getIxml();
-            if (ixmlStr !== void 0) fullFileHandle.setIxml(ixmlStr);
-            if (!fullFileHandle.save()) {
-              throw new FileOperationError(
-                "save",
-                "Failed to save changes to full file"
-              );
-            }
-            const buffer = fullFileHandle.getBuffer();
-            await writeFileData(targetPath, buffer);
-          } finally {
-            fullFileHandle.destroy();
-          }
+          await saveViaFreshHandle(
+            this.module,
+            this.handle,
+            this.originalSource,
+            targetPath,
+            false
+          );
           this.isPartiallyLoaded = false;
           this.originalSource = void 0;
+        } else if (this.module.isWasi && this.sourcePath && targetPath !== this.sourcePath) {
+          await saveViaFreshHandle(
+            this.module,
+            this.handle,
+            this.sourcePath,
+            targetPath,
+            true
+          );
         } else {
           if (!this.save()) {
             throw new FileOperationError(
@@ -1799,13 +1919,16 @@ var init_audio_file_impl = __esm({
         }
         const sorted = sortChapters(chapters);
         const trackEndMs = this.audioProperties()?.durationMs;
+        const style = options?.mp4ChapterStyle ?? "quicktime";
+        const source = fmt === "MP4" ? style : "id3";
         const raw = sorted.map((c, i) => ({
           id: c.id,
           startTimeMs: c.startTimeMs,
           endTimeMs: inferEndTimeMs(sorted, i, trackEndMs) ?? c.startTimeMs,
-          title: c.title
+          title: c.title,
+          source
         }));
-        this.handle.setChapters(raw, options?.mp4ChapterStyle ?? "quicktime");
+        this.handle.setChapters(raw, style);
       }
       getBext() {
         return getBext(this.handle);
@@ -1911,6 +2034,9 @@ function mapPropertiesToExtendedTag(props) {
     if (tagField === "year" || tagField === "track") {
       const num = parseNumeric(values[0]);
       if (num !== void 0) tag[tagField] = num;
+      if (propKey === "date") {
+        tag.date = values.length === 1 ? values[0] : values;
+      }
     } else {
       tag[tagField] = values;
     }
@@ -1951,6 +2077,9 @@ function normalizeTagInput(input) {
   if (input.year !== void 0) {
     props.date = [String(input.year)];
   }
+  if (input.date !== void 0) {
+    props.date = Array.isArray(input.date) ? input.date : [input.date];
+  }
   if (input.track !== void 0) {
     props.trackNumber = [String(input.track)];
   }
@@ -1989,6 +2118,7 @@ var init_tag_mapping = __esm({
       "comment",
       "genre",
       "year",
+      "date",
       "track"
     ]);
     NUMERIC_FIELDS = /* @__PURE__ */ new Set([
@@ -2007,7 +2137,7 @@ var VERSION;
 var init_version = __esm({
   "src/version.ts"() {
     "use strict";
-    VERSION = "1.2.1";
+    VERSION = "1.3.0";
   }
 });
 

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

@@ -87,20 +87,6 @@ export interface ComplexPropertyValueMap {
  * Union type of all valid complex property keys.
  */
 export type ComplexPropertyKey = keyof ComplexPropertyValueMap;
-/**
- * Complex property metadata interface.
- */
-export interface ComplexPropertyMetadata {
-    key: string;
-    description: string;
-    type: "binary" | "object";
-    supportedFormats: readonly string[];
-    mappings: Record<string, string | {
-        frame?: string;
-        atom?: string;
-        description?: string;
-    }>;
-}
 /**
  * Rich metadata object for complex properties.
  * Contains descriptions, format support info, and underlying format mappings.

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;;;;;;;;;;;;;;;;;;GAkBG;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;;;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;;;;;;;;;;;;;;;;;;;GAmBG;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;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC1B,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,EAAE,MAAM,CACd,MAAM,EACN,MAAM,GAAG;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CACjE,CAAC;CACH;AAED;;;;;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;;;;;;;;;;;;;;;;;;GAkBG;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;;;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;;;;;;;;;;;;;;;;;;;GAmBG;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"}

package/dist/src/errors/base.js

@@ -1,3 +1,6 @@
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
 const SUPPORTED_FORMATS = [
   "MP3",
   "MP4",
@@ -16,8 +19,8 @@ class TagLibError extends Error {
    */
   constructor(code, message, details) {
     super(message);
-    this.code = code;
-    this.details = details;
+    __publicField(this, "code", code);
+    __publicField(this, "details", details);
     this.name = "TagLibError";
     Object.setPrototypeOf(this, TagLibError.prototype);
   }

package/dist/src/errors/classes.js

@@ -1,3 +1,6 @@
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
 import { SUPPORTED_FORMATS, TagLibError } from "./base.js";
 function errorMessage(error) {
   return error instanceof Error ? error.message : String(error);
@@ -48,7 +51,7 @@ class InvalidFormatError extends TagLibError {
       errorDetails.join(". "),
       { ...details, bufferSize }
     );
-    this.bufferSize = bufferSize;
+    __publicField(this, "bufferSize", bufferSize);
     this.name = "InvalidFormatError";
     Object.setPrototypeOf(this, InvalidFormatError.prototype);
   }
@@ -66,8 +69,8 @@ class UnsupportedFormatError extends TagLibError {
       `Unsupported audio format: ${format}. Supported formats: ${supportedFormats.join(", ")}`,
       { ...details, format, supportedFormats }
     );
-    this.format = format;
-    this.supportedFormats = supportedFormats;
+    __publicField(this, "format", format);
+    __publicField(this, "supportedFormats", supportedFormats);
     this.name = "UnsupportedFormatError";
     Object.setPrototypeOf(this, UnsupportedFormatError.prototype);
   }
@@ -91,8 +94,8 @@ class FileOperationError extends TagLibError {
       errorDetails.join(". "),
       { ...details, operation, path }
     );
-    this.operation = operation;
-    this.path = path;
+    __publicField(this, "operation", operation);
+    __publicField(this, "path", path);
     this.name = "FileOperationError";
     Object.setPrototypeOf(this, FileOperationError.prototype);
   }
@@ -116,8 +119,8 @@ class MetadataError extends TagLibError {
       errorDetails.join(". "),
       { ...details, operation, field }
     );
-    this.operation = operation;
-    this.field = field;
+    __publicField(this, "operation", operation);
+    __publicField(this, "field", field);
     this.name = "MetadataError";
     Object.setPrototypeOf(this, MetadataError.prototype);
   }
@@ -148,9 +151,9 @@ class EnvironmentError extends TagLibError {
   constructor(environment, reason, requiredFeature) {
     const message = requiredFeature ? `Environment '${environment}' ${reason}. Required feature: ${requiredFeature}.` : `Environment '${environment}' ${reason}.`;
     super("ENVIRONMENT", message);
-    this.environment = environment;
-    this.reason = reason;
-    this.requiredFeature = requiredFeature;
+    __publicField(this, "environment", environment);
+    __publicField(this, "reason", reason);
+    __publicField(this, "requiredFeature", requiredFeature);
     this.name = "EnvironmentError";
     Object.setPrototypeOf(this, EnvironmentError.prototype);
   }

package/dist/src/msgpack/encoder.d.ts

@@ -1,6 +1,12 @@
 /** MessagePack encoder — converts JS objects to binary MessagePack for the C API. */
 import { type EncoderOptions } from "@msgpack/msgpack";
 import type { AudioProperties, ExtendedTag, Picture, PropertyMap } from "../types.js";
+/**
+ * Structured (non-text-property) keys carried verbatim through the msgpack
+ * boundary. The reconstruct registry (`extra-state-registry.ts`) must cover the
+ * data fields here; `extra-state-registry.test.ts` enforces that cross-check.
+ */
+export declare const PASSTHROUGH_KEYS: Set<string>;
 export declare function encodeTagData(tagData: ExtendedTag): Uint8Array;
 export declare function encodeAudioProperties(audioProps: AudioProperties): Uint8Array;
 export declare function encodePropertyMap(propertyMap: PropertyMap): Uint8Array;

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

@@ -1 +1 @@
-{"version":3,"file":"encoder.d.ts","sourceRoot":"","sources":["../../../src/msgpack/encoder.ts"],"names":[],"mappings":"AAAA,qFAAqF;AAErF,OAAO,EAAU,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAE/D,OAAO,KAAK,EACV,eAAe,EACf,WAAW,EACX,OAAO,EACP,WAAW,EACZ,MAAM,aAAa,CAAC;AAwBrB,wBAAgB,aAAa,CAAC,OAAO,EAAE,WAAW,GAAG,UAAU,CAiB9D;AAED,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,eAAe,GAAG,UAAU,CAS7E;AAED,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,WAAW,GAAG,UAAU,CAStE;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,UAAU,CAe1D;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,UAAU,CAelE;AAED,wBAAgB,iBAAiB,CAAC,CAAC,EACjC,IAAI,EAAE,CAAC,EACP,OAAO,GAAE,OAAO,CAAC,cAAc,CAAM,GACpC,UAAU,CAUZ;AAED,wBAAgB,wBAAwB,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,UAAU,CAe/D;AAqBD,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,WAAW,EAAE,GAAG,UAAU,CAc1E;AAED,wBAAiB,uBAAuB,CAAC,CAAC,EACxC,YAAY,EAAE,QAAQ,CAAC,CAAC,CAAC,GACxB,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,OAAO,CAAC,CActC;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAS7D;AAED,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC,GAC1E,UAAU,CAeZ;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAW7D;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,OAAO,GAAG;IACxD,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;CAC1B,CAaA"}
+{"version":3,"file":"encoder.d.ts","sourceRoot":"","sources":["../../../src/msgpack/encoder.ts"],"names":[],"mappings":"AAAA,qFAAqF;AAErF,OAAO,EAAU,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAE/D,OAAO,KAAK,EACV,eAAe,EACf,WAAW,EACX,OAAO,EACP,WAAW,EACZ,MAAM,aAAa,CAAC;AAGrB;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,aAU3B,CAAC;AA4BH,wBAAgB,aAAa,CAAC,OAAO,EAAE,WAAW,GAAG,UAAU,CAsC9D;AAED,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,eAAe,GAAG,UAAU,CAS7E;AAED,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,WAAW,GAAG,UAAU,CAStE;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,UAAU,CAe1D;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,UAAU,CAelE;AAED,wBAAgB,iBAAiB,CAAC,CAAC,EACjC,IAAI,EAAE,CAAC,EACP,OAAO,GAAE,OAAO,CAAC,cAAc,CAAM,GACpC,UAAU,CAUZ;AAED,wBAAgB,wBAAwB,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,UAAU,CAe/D;AAqBD,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,WAAW,EAAE,GAAG,UAAU,CAc1E;AAED,wBAAiB,uBAAuB,CAAC,CAAC,EACxC,YAAY,EAAE,QAAQ,CAAC,CAAC,CAAC,GACxB,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,OAAO,CAAC,CActC;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAS7D;AAED,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC,GAC1E,UAAU,CAeZ;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAW7D;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,OAAO,GAAG;IACxD,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;CAC1B,CAaA"}

package/dist/src/msgpack/encoder.js

@@ -20,10 +20,24 @@ const MSGPACK_ENCODE_OPTIONS = {
   maxDepth: 32,
   extensionCodec: void 0
 };
+function lyricsTexts(value) {
+  const entries = Array.isArray(value) ? value : [value];
+  return entries.map(
+    (entry) => typeof entry === "string" ? entry : String(entry?.text ?? "")
+  ).filter((text) => text !== "");
+}
 function encodeTagData(tagData) {
   try {
+    const dateVal = tagData.date;
+    const hasDate = Array.isArray(dateVal) ? dateVal.length > 0 : dateVal !== void 0 && dateVal !== null && dateVal !== "";
     const remapped = {};
     for (const [key, value] of Object.entries(tagData)) {
+      if (key === "year" && hasDate) continue;
+      if (key === "lyrics") {
+        const texts = lyricsTexts(value);
+        if (texts.length > 0) remapped["LYRICS"] = texts;
+        continue;
+      }
       if (PASSTHROUGH_KEYS.has(key)) {
         remapped[key] = value;
       } else {
@@ -212,6 +226,7 @@ function compareEncodingEfficiency(data) {
   };
 }
 export {
+  PASSTHROUGH_KEYS,
   canEncodeToMessagePack,
   compareEncodingEfficiency,
   encodeAudioProperties,

package/dist/src/runtime/unified-loader/types.js

@@ -1,3 +1,6 @@
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
 import { TagLibError } from "../../errors/base.js";
 class UnifiedLoaderError extends TagLibError {
   constructor(message, cause) {
@@ -10,7 +13,7 @@ class UnifiedLoaderError extends TagLibError {
 class ModuleLoadError extends TagLibError {
   constructor(message, wasmType, cause) {
     super("MODULE_LOAD", message, cause ? { cause, wasmType } : { wasmType });
-    this.wasmType = wasmType;
+    __publicField(this, "wasmType", wasmType);
     this.name = "ModuleLoadError";
     if (cause) this.cause = cause;
     Object.setPrototypeOf(this, ModuleLoadError.prototype);

package/dist/src/runtime/wasi-adapter/file-handle.d.ts

@@ -1,7 +1,7 @@
 /**
  * @fileoverview WASI-based FileHandle implementation
  */
-import type { FileHandle, RawChapter, RawPicture } from "../../wasm.js";
+import type { FileHandle, RawChapter, RawLyrics, RawPicture } from "../../wasm.js";
 import type { BasicTagData } from "../../types/tags.js";
 import type { AudioProperties } from "../../types.js";
 import type { WasiModule } from "../wasmer-sdk-loader/types.js";
@@ -59,6 +59,8 @@ export declare class WasiFileHandle implements FileHandle {
         email?: string;
         counter?: number;
     }[]): void;
+    getLyrics(): RawLyrics[];
+    setLyrics(lyrics: RawLyrics[]): void;
     destroy(): void;
 }
 //# sourceMappingURL=file-handle.d.ts.map