taglib-wasm 1.5.2 → 1.6.0

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

@@ -123,6 +123,26 @@ const SPECIALIZED_PROPERTIES = {
       vorbis: "ITUNNORM",
       mp4: "----:com.apple.iTunes:iTunNORM"
     }
+  },
+  /**
+   * Apple gapless-playback data (encoder delay, padding, original sample count).
+   *
+   * Exists so the two Apple freeform atoms are presented consistently: without
+   * it, `properties()` answered `appleSoundCheck` for iTunNORM but the raw
+   * uppercased `ITUNSMPB` for its sibling, because only one had an alias. The
+   * name mirrors `appleSoundCheck` — vendor-prefixed, feature-named rather than
+   * atom-named (tuneup-ibo).
+   */
+  appleGaplessInfo: {
+    key: "ITUNSMPB",
+    description: "Apple gapless playback data (encoder delay and padding)",
+    type: "string",
+    supportedFormats: ["ID3v2", "MP4", "Vorbis"],
+    mappings: {
+      id3v2: { frame: "TXXX", description: "iTunSMPB" },
+      vorbis: "ITUNSMPB",
+      mp4: "----:com.apple.iTunes:iTunSMPB"
+    }
   }
 };
 export {

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

@@ -1 +1 @@
-{"version":3,"file":"tags.d.ts","sourceRoot":"","sources":["../../../src/constants/tags.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmFP,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG,OAAO,IAAI,CAAC,MAAM,OAAO,IAAI,CAAC,CAAC;AAErD;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,OAAO,CAE5D;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,SAAS,OAAO,EAAE,CAEnD"}
+{"version":3,"file":"tags.d.ts","sourceRoot":"","sources":["../../../src/constants/tags.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmFP,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG,OAAO,IAAI,CAAC,MAAM,OAAO,IAAI,CAAC,CAAC;AAYrD;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,OAAO,CAE5D;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,SAAS,OAAO,EAAE,CAEnD"}

package/dist/src/constants/tags.js

@@ -72,8 +72,9 @@ const Tags = {
   InvolvedPeople: "involvedPeople",
   Encoding: "encoding"
 };
+const VALID_TAG_NAMES = new Set(Object.values(Tags));
 function isValidTagName(name) {
-  return Object.values(Tags).includes(name);
+  return VALID_TAG_NAMES.has(name);
 }
 function getAllTagNames() {
   return Object.values(Tags);

package/dist/src/deno-compile.d.ts

@@ -8,6 +8,18 @@
  */
 import { TagLib } from "./taglib.js";
 export { isDenoCompiled } from "./runtime/deno-detect.js";
+/**
+ * Where {@link prepareWasmForEmbedding} looks for the Emscripten binary, in
+ * order, resolved relative to this module.
+ *
+ * `build/` comes first deliberately: it holds the committed, authoritative
+ * artifact, while `dist/` is gitignored scratch that only the npm chain
+ * (`build:copy-wasm`/`postbuild`) refreshes. A stale `dist/` in a working
+ * checkout would otherwise silently shadow a freshly built binary. Published
+ * packages ship no `build/` (it is absent from package.json's `files`), so
+ * resolution there falls through to `dist/` exactly as before.
+ */
+export declare const WASM_EMBED_SEARCH_PATHS: readonly string[];
 /**
  * Initialize TagLib with automatic handling for Deno compiled binaries.
  *

package/dist/src/deno-compile.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deno-compile.d.ts","sourceRoot":"","sources":["../../src/deno-compile.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAIrC,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,wBAAwB,CAC5C,gBAAgB,SAAsB,GACrC,OAAO,CAAC,MAAM,CAAC,CA8BjB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,uBAAuB,CAC3C,UAAU,SAAsB,GAC/B,OAAO,CAAC,IAAI,CAAC,CA6Cf"}
+{"version":3,"file":"deno-compile.d.ts","sourceRoot":"","sources":["../../src/deno-compile.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAIrC,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D;;;;;;;;;;GAUG;AACH,eAAO,MAAM,uBAAuB,EAAE,SAAS,MAAM,EAIpD,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,wBAAwB,CAC5C,gBAAgB,SAAsB,GACrC,OAAO,CAAC,MAAM,CAAC,CA8BjB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,uBAAuB,CAC3C,UAAU,SAAsB,GAC/B,OAAO,CAAC,IAAI,CAAC,CAuCf"}

package/dist/src/deno-compile.js

@@ -3,6 +3,11 @@ import { FileOperationError } from "./errors/classes.js";
 import { isDenoCompiled } from "./runtime/deno-detect.js";
 import { fileUrlToPath } from "./utils/path.js";
 import { isDenoCompiled as isDenoCompiled2 } from "./runtime/deno-detect.js";
+const WASM_EMBED_SEARCH_PATHS = [
+  "../build/taglib-web.wasm",
+  "../dist/taglib-web.wasm",
+  "./node_modules/taglib-wasm/dist/taglib-web.wasm"
+];
 async function initializeForDenoCompile(embeddedWasmPath = "./taglib-web.wasm") {
   if (isDenoCompiled()) {
     const strategies = [
@@ -30,14 +35,9 @@ async function initializeForDenoCompile(embeddedWasmPath = "./taglib-web.wasm")
 }
 async function prepareWasmForEmbedding(outputPath = "./taglib-web.wasm") {
   try {
-    const possiblePaths = [
-      new URL("../dist/taglib-web.wasm", import.meta.url),
-      new URL("../taglib-web.wasm", import.meta.url),
-      new URL(
-        "./node_modules/taglib-wasm/dist/taglib-web.wasm",
-        import.meta.url
-      )
-    ];
+    const possiblePaths = WASM_EMBED_SEARCH_PATHS.map(
+      (p) => new URL(p, import.meta.url)
+    );
     let wasmData = null;
     let sourcePath = null;
     for (const path of possiblePaths) {
@@ -68,6 +68,7 @@ async function prepareWasmForEmbedding(outputPath = "./taglib-web.wasm") {
   }
 }
 export {
+  WASM_EMBED_SEARCH_PATHS,
   initializeForDenoCompile,
   isDenoCompiled2 as isDenoCompiled,
   prepareWasmForEmbedding

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;AAGrB;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,aAW3B,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"}
+{"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;AAIrB;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,aAa3B,CAAC;AA4BH,wBAAgB,aAAa,CAAC,OAAO,EAAE,WAAW,GAAG,UAAU,CAoC9D;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

@@ -1,6 +1,7 @@
 import { encode } from "@msgpack/msgpack";
 import { errorMessage, MetadataError } from "../errors/classes.js";
 import { toTagLibKey } from "../constants/properties.js";
+import { isShadowedNumericMirror } from "../utils/mirror-fields.js";
 const PASSTHROUGH_KEYS = /* @__PURE__ */ new Set([
   "pictures",
   "ratings",
@@ -11,7 +12,9 @@ const PASSTHROUGH_KEYS = /* @__PURE__ */ new Set([
   "bextData",
   "ixml",
   "id3Tags",
-  "_stripId3"
+  "_stripId3",
+  // Exact MP4 atom names — must reach C++ verbatim, not via toTagLibKey.
+  "_mp4ItemNames"
 ]);
 const MSGPACK_ENCODE_OPTIONS = {
   sortKeys: false,
@@ -29,11 +32,10 @@ function lyricsTexts(value) {
 }
 function encodeTagData(tagData) {
   try {
-    const dateVal = tagData.date;
-    const hasDate = Array.isArray(dateVal) ? dateVal.length > 0 : dateVal !== void 0 && dateVal !== null && dateVal !== "";
+    const data = tagData;
     const remapped = {};
     for (const [key, value] of Object.entries(tagData)) {
-      if (key === "year" && hasDate) continue;
+      if (isShadowedNumericMirror(data, key)) continue;
       if (key === "lyrics") {
         const texts = lyricsTexts(value);
         if (texts.length > 0) remapped["LYRICS"] = texts;

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

@@ -23,10 +23,4 @@ export declare function detectRuntime(): RuntimeDetectionResult;
 export declare function supportsExnref(): boolean;
 export declare function getEnvironmentDescription(env: RuntimeEnvironment): string;
 export declare function canLoadWasmType(wasmType: WasmBinaryType): boolean;
-/** @internal */
-export declare function _forceRuntime(result: RuntimeDetectionResult): void;
-/** @internal */
-export declare function _clearRuntimeOverride(): void;
-/** @internal */
-export declare function _getDetectionResult(): RuntimeDetectionResult;
 //# sourceMappingURL=detector.d.ts.map

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,MAAM,MAAM,kBAAkB,GAC1B,WAAW,GACX,WAAW,GACX,UAAU,GACV,SAAS,GACT,iBAAiB,GACjB,QAAQ,GACR,YAAY,CAAC;AAEjB,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,YAAY,CAAC;AAEnD,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,kBAAkB,CAAC;IAChC,QAAQ,EAAE,cAAc,CAAC;IACzB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,eAAe,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;CAC5B;AAOD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,GAAG,SAAS,GAC9B,MAAM,GAAG,SAAS,CAepB;AAuCD,qFAAqF;AACrF,wBAAgB,MAAM,IAAI,OAAO,CAEhC;AAED,wBAAgB,aAAa,IAAI,sBAAsB,CA8EtD;AAWD;;;GAGG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAMxC;AAED,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,kBAAkB,GAAG,MAAM,CAmBzE;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAQjE;AAED,gBAAgB;AAChB,wBAAgB,aAAa,CAAC,MAAM,EAAE,sBAAsB,GAAG,IAAI,CAElE;AAED,gBAAgB;AAChB,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C;AAED,gBAAgB;AAChB,wBAAgB,mBAAmB,IAAI,sBAAsB,CAG5D"}
+{"version":3,"file":"detector.d.ts","sourceRoot":"","sources":["../../../src/runtime/detector.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAC1B,WAAW,GACX,WAAW,GACX,UAAU,GACV,SAAS,GACT,iBAAiB,GACjB,QAAQ,GACR,YAAY,CAAC;AAEjB,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,YAAY,CAAC;AAEnD,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,kBAAkB,CAAC;IAChC,QAAQ,EAAE,cAAc,CAAC;IACzB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,eAAe,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;CAC5B;AAOD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,GAAG,SAAS,GAC9B,MAAM,GAAG,SAAS,CAepB;AAuCD,qFAAqF;AACrF,wBAAgB,MAAM,IAAI,OAAO,CAEhC;AAED,wBAAgB,aAAa,IAAI,sBAAsB,CA8EtD;AAWD;;;GAGG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAMxC;AAED,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,kBAAkB,GAAG,MAAM,CAmBzE;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAQjE"}

package/dist/src/runtime/detector.js

@@ -145,7 +145,7 @@ function getEnvironmentDescription(env) {
     case "node-wasi":
       return "Node.js with WASI (high performance)";
     case "bun-wasi":
-      return "Bun with WASI (via node:fs)";
+      return "Bun with WASI (Bun-native file I/O)";
     case "browser":
       return "Browser with Emscripten (web compatibility)";
     case "worker":
@@ -165,20 +165,7 @@ function canLoadWasmType(wasmType) {
   }
   return true;
 }
-function _forceRuntime(result) {
-  globalThis.__taglib_wasm_runtime_override = result;
-}
-function _clearRuntimeOverride() {
-  delete globalThis.__taglib_wasm_runtime_override;
-}
-function _getDetectionResult() {
-  const override = globalThis.__taglib_wasm_runtime_override;
-  return override || detectRuntime();
-}
 export {
-  _clearRuntimeOverride,
-  _forceRuntime,
-  _getDetectionResult,
   canLoadWasmType,
   checkNodeVersion,
   detectRuntime,

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

@@ -30,6 +30,8 @@ export declare class WasiFileHandle implements FileHandle {
     isMP4(): boolean;
     getMP4Item(key: string): string;
     setMP4Item(key: string, value: string): void;
+    /** Record an exact atom name to be repaired after the PropertyMap write. */
+    private registerMp4ItemName;
     removeMP4Item(key: string): void;
     getPictures(): RawPicture[];
     setPictures(pictures: RawPicture[]): void;

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

@@ -1 +1 @@
-{"version":3,"file":"file-handle.d.ts","sourceRoot":"","sources":["../../../../src/runtime/wasi-adapter/file-handle.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"file-handle.d.ts","sourceRoot":"","sources":["../../../../src/runtime/wasi-adapter/file-handle.ts"],"names":[],"mappings":"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"}

package/dist/src/runtime/wasi-adapter/file-handle.js

@@ -3,7 +3,21 @@ var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { en
 var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
 import { WasmerExecutionError } from "../wasmer-sdk-loader/types.js";
 import { decodeTagData } from "../../msgpack/decoder.js";
-import { fromTagLibKey, toTagLibKey } from "../../constants/properties.js";
+import {
+  fromTagLibKey,
+  mp4AtomWireKey,
+  toTagLibKey
+} from "../../constants/properties.js";
+import {
+  DATE_MIRROR,
+  firstValueString,
+  isShadowedNumericMirror,
+  mirrorForRawKey,
+  readNumericMirror,
+  stageNumericWrite,
+  stageRawWrite,
+  TRACK_MIRROR
+} from "../../utils/mirror-fields.js";
 import {
   readId3v2FramesFromWasm,
   readTagsFromWasm,
@@ -36,7 +50,9 @@ const INTERNAL_KEYS = /* @__PURE__ */ new Set([
   "chapters",
   "_mp4ChapterStyle",
   "bextData",
-  "ixml"
+  "ixml",
+  // Exact MP4 atom names for the write path, not a readable property.
+  "_mp4ItemNames"
 ]);
 const CONTAINER_TO_FORMAT = {
   MP3: "MP3",
@@ -50,22 +66,11 @@ const CONTAINER_TO_FORMAT = {
   ASF: "ASF",
   Matroska: "MATROSKA"
 };
-const NUMERIC_FIELD_ALIASES = {
-  trackNumber: "track"
-};
-function hasValue(v) {
-  if (Array.isArray(v)) return v.length > 0;
-  return v !== void 0 && v !== null && v !== "";
-}
-function firstString(v) {
-  if (Array.isArray(v)) return v[0] ?? "";
-  return v || "";
-}
 function mp4ItemPropertyKey(key) {
   if (key.startsWith("----:")) {
     return key.slice(key.lastIndexOf(":") + 1).toUpperCase();
   }
-  return key;
+  return mp4AtomWireKey(key) ?? key;
 }
 class WasiFileHandle {
   constructor(wasiModule) {
@@ -123,21 +128,23 @@ class WasiFileHandle {
     this.checkNotDestroyed();
     const d = this.tagData ?? {};
     return {
-      title: firstString(d.title),
-      artist: firstString(d.artist),
-      album: firstString(d.album),
-      comment: firstString(d.comment),
-      genre: firstString(d.genre),
-      year: d.year || 0,
-      track: d.track || 0
+      title: firstValueString(d.title),
+      artist: firstValueString(d.artist),
+      album: firstValueString(d.album),
+      comment: firstValueString(d.comment),
+      genre: firstValueString(d.genre),
+      year: readNumericMirror(d, DATE_MIRROR),
+      track: readNumericMirror(d, TRACK_MIRROR)
     };
   }
   setTagData(data) {
     this.checkNotDestroyed();
     const merged = { ...this.tagData, ...data };
     if (data.year !== void 0) {
-      if (data.year > 0) merged.date = String(data.year);
-      else delete merged.date;
+      stageNumericWrite(merged, DATE_MIRROR, data.year);
+    }
+    if (data.track !== void 0) {
+      stageNumericWrite(merged, TRACK_MIRROR, data.track);
     }
     this.tagData = merged;
   }
@@ -211,7 +218,7 @@ class WasiFileHandle {
     const data = this.tagData ?? {};
     for (const [key, value] of Object.entries(data)) {
       if (AUDIO_KEYS.has(key) || INTERNAL_KEYS.has(key)) continue;
-      if (key === "year" && hasValue(data.date)) continue;
+      if (isShadowedNumericMirror(data, key)) continue;
       if (value === void 0 || value === null) continue;
       if (value === 0 || value === "") continue;
       const propKey = toTagLibKey(key);
@@ -230,17 +237,16 @@ class WasiFileHandle {
     const next = { ...this.tagData };
     for (const [key, values] of Object.entries(props)) {
       const camelKey = fromTagLibKey(key);
-      const storeKey = NUMERIC_FIELD_ALIASES[camelKey] ?? camelKey;
-      if (values.length === 0) {
-        delete next[storeKey];
-        if (camelKey === "date") delete next.year;
-      } else if (storeKey === "track") {
-        const parsed = Number.parseInt(values[0] ?? "", 10);
-        if (!Number.isNaN(parsed)) next[storeKey] = parsed;
-      } else if (camelKey === "date") {
-        next.date = values;
-        const year = Number.parseInt(values[0] ?? "", 10);
-        if (!Number.isNaN(year)) next.year = year;
+      if (camelKey === "_mp4ItemNames") {
+        const existing = next._mp4ItemNames ?? [];
+        next._mp4ItemNames = [.../* @__PURE__ */ new Set([...existing, ...values])];
+        continue;
+      }
+      const mirror = mirrorForRawKey(camelKey);
+      if (mirror !== void 0) {
+        stageRawWrite(next, mirror, values);
+      } else if (values.length === 0) {
+        delete next[camelKey];
       } else {
         next[camelKey] = values;
       }
@@ -250,25 +256,17 @@ class WasiFileHandle {
   getProperty(key) {
     this.checkNotDestroyed();
     const mappedKey = fromTagLibKey(key);
-    const storeKey = NUMERIC_FIELD_ALIASES[mappedKey] ?? mappedKey;
-    return this.tagData?.[storeKey]?.toString() ?? "";
+    const stored = this.tagData?.[mappedKey];
+    return Array.isArray(stored) ? stored[0]?.toString() ?? "" : stored?.toString() ?? "";
   }
   setProperty(key, value) {
     this.checkNotDestroyed();
     const mappedKey = fromTagLibKey(key);
-    const storeKey = NUMERIC_FIELD_ALIASES[mappedKey] ?? mappedKey;
-    if (storeKey === "track") {
-      const parsed = Number.parseInt(value, 10);
-      if (!Number.isNaN(parsed)) {
-        this.tagData = { ...this.tagData, [storeKey]: parsed };
-      }
-    } else if (mappedKey === "date") {
-      const year = Number.parseInt(value, 10);
-      this.tagData = {
-        ...this.tagData,
-        date: value,
-        ...Number.isNaN(year) ? {} : { year }
-      };
+    const mirror = mirrorForRawKey(mappedKey);
+    if (mirror !== void 0) {
+      const next = { ...this.tagData };
+      stageRawWrite(next, mirror, value === "" ? [] : [value]);
+      this.tagData = next;
     } else {
       this.tagData = { ...this.tagData, [mappedKey]: value };
     }
@@ -289,13 +287,24 @@ class WasiFileHandle {
   setMP4Item(key, value) {
     this.checkNotDestroyed();
     this.setProperty(mp4ItemPropertyKey(key), value);
+    if (key.startsWith("----:")) this.registerMp4ItemName(key);
+  }
+  /** Record an exact atom name to be repaired after the PropertyMap write. */
+  registerMp4ItemName(name) {
+    const existing = this.tagData?._mp4ItemNames ?? [];
+    if (existing.includes(name)) return;
+    this.tagData = {
+      ...this.tagData,
+      _mp4ItemNames: [...existing, name]
+    };
   }
   removeMP4Item(key) {
     this.checkNotDestroyed();
     if (this.tagData) {
       const mappedKey = fromTagLibKey(mp4ItemPropertyKey(key));
-      const storeKey = NUMERIC_FIELD_ALIASES[mappedKey] ?? mappedKey;
-      delete this.tagData[storeKey];
+      delete this.tagData[mappedKey];
+      const mirror = mirrorForRawKey(mappedKey);
+      if (mirror !== void 0) delete this.tagData[mirror.numeric];
     }
   }
   getPictures() {

package/dist/src/taglib/audio-file-base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"audio-file-base.d.ts","sourceRoot":"","sources":["../../../src/taglib/audio-file-base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,KAAK,EACV,eAAe,EACf,QAAQ,EACR,WAAW,EACX,WAAW,EACZ,MAAM,aAAa,CAAC;AAGrB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAchE;;;;;GAKG;AACH,8BAAsB,iBAAiB;IAWnC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,YAAY;IAVzC,SAAS,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;IACxC,SAAS,CAAC,qBAAqB,EAAE,eAAe,GAAG,IAAI,CAAQ;IAC/D,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IACvC,SAAS,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,WAAW,GAAG,IAAI,CAAC;IACpE,SAAS,CAAC,iBAAiB,EAAE,OAAO,CAAS;IAC7C,SAAS,CAAC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,WAAW,CAAC;IACpD,gFAAgF;IAChF,SAAS,CAAC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;gBAGtC,MAAM,EAAE,YAAY,EACvC,UAAU,EAAE,UAAU,EACtB,UAAU,CAAC,EAAE,MAAM,EACnB,cAAc,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,WAAW,GAAG,IAAI,EACzD,iBAAiB,GAAE,OAAe,EAClC,kBAAkB,CAAC,EAAE,WAAW;IAYlC;;;;;;OAMG;IACH,SAAS,CAAC,0BAA0B,IAAI,WAAW,CAAC,MAAM,CAAC;IAU3D,SAAS,KAAK,MAAM,IAAI,UAAU,CAKjC;IAED,SAAS,IAAI,QAAQ;IAIrB,QAAQ,CAAC,CAAC,SAAS,QAAQ,EAAE,MAAM,EAAE,CAAC,GAAG,IAAI,IAAI,cAAc,CAAC,CAAC,CAAC;IAIlE,GAAG,IAAI,UAAU;IA4EjB,eAAe,IAAI,eAAe,GAAG,SAAS;IAO9C,UAAU,IAAI,WAAW;IAMzB,aAAa,CAAC,UAAU,EAAE,WAAW,GAAG,IAAI;IAiB5C,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAK5C,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAI7C,KAAK,IAAI,OAAO;IAIhB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAQ3C,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAO5C,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAOhC,OAAO,IAAI,OAAO;IAIlB,OAAO,IAAI,IAAI;IAQf,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI;CAGzB"}
+{"version":3,"file":"audio-file-base.d.ts","sourceRoot":"","sources":["../../../src/taglib/audio-file-base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,KAAK,EACV,eAAe,EACf,QAAQ,EACR,WAAW,EACX,WAAW,EACZ,MAAM,aAAa,CAAC;AAQrB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAgBhE;;;;;GAKG;AACH,8BAAsB,iBAAiB;IAWnC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,YAAY;IAVzC,SAAS,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;IACxC,SAAS,CAAC,qBAAqB,EAAE,eAAe,GAAG,IAAI,CAAQ;IAC/D,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IACvC,SAAS,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,WAAW,GAAG,IAAI,CAAC;IACpE,SAAS,CAAC,iBAAiB,EAAE,OAAO,CAAS;IAC7C,SAAS,CAAC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,WAAW,CAAC;IACpD,gFAAgF;IAChF,SAAS,CAAC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;gBAGtC,MAAM,EAAE,YAAY,EACvC,UAAU,EAAE,UAAU,EACtB,UAAU,CAAC,EAAE,MAAM,EACnB,cAAc,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,WAAW,GAAG,IAAI,EACzD,iBAAiB,GAAE,OAAe,EAClC,kBAAkB,CAAC,EAAE,WAAW;IAYlC;;;;;;OAMG;IACH,SAAS,CAAC,0BAA0B,IAAI,WAAW,CAAC,MAAM,CAAC;IAU3D,SAAS,KAAK,MAAM,IAAI,UAAU,CAKjC;IAED,SAAS,IAAI,QAAQ;IAIrB,QAAQ,CAAC,CAAC,SAAS,QAAQ,EAAE,MAAM,EAAE,CAAC,GAAG,IAAI,IAAI,cAAc,CAAC,CAAC,CAAC;IAIlE,GAAG,IAAI,UAAU;IAIjB,eAAe,IAAI,eAAe,GAAG,SAAS;IAO9C,UAAU,IAAI,WAAW;IAMzB,aAAa,CAAC,UAAU,EAAE,WAAW,GAAG,IAAI;IAsB5C,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAkB5C,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAkB7C,KAAK,IAAI,OAAO;IAIhB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAe3C,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAoB5C,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAOhC,OAAO,IAAI,OAAO;IAIlB,OAAO,IAAI,IAAI;IAQf,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI;CAGzB"}

package/dist/src/taglib/audio-file-base.js

@@ -1,8 +1,15 @@
 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 { remapKeysFromTagLib, toTagLibKey } from "../constants/properties.js";
+import {
+  mp4AtomWireKey,
+  mp4FreeformAtomNames,
+  remapKeysFromTagLib,
+  toTagLibKey
+} from "../constants/properties.js";
 import { MetadataError, UnsupportedFormatError } from "../errors.js";
+import { MP4_ITEM_NAMES_KEY } from "./mp4-item-names.js";
+import { buildMutableTag } from "./mutable-tag-impl.js";
 const LYRICS_PROPERTY_KEY = "lyrics";
 const LYRICS_WIRE_KEY = toTagLibKey(LYRICS_PROPERTY_KEY);
 const EMPTY_KEY_SET = /* @__PURE__ */ new Set();
@@ -53,79 +60,7 @@ class BaseAudioFileImpl {
     return this.getFormat() === format;
   }
   tag() {
-    const handle = this.handle;
-    let data = handle.getTagData();
-    const tag = {
-      get title() {
-        return data.title;
-      },
-      get artist() {
-        return data.artist;
-      },
-      get album() {
-        return data.album;
-      },
-      get comment() {
-        return data.comment;
-      },
-      get genre() {
-        return data.genre;
-      },
-      get year() {
-        return data.year;
-      },
-      get track() {
-        return data.track;
-      },
-      get date() {
-        return handle.getProperty("DATE") || void 0;
-      },
-      setTitle: (value) => {
-        handle.setTagData({ title: value });
-        data = handle.getTagData();
-        return tag;
-      },
-      setArtist: (value) => {
-        handle.setTagData({ artist: value });
-        data = handle.getTagData();
-        return tag;
-      },
-      setAlbum: (value) => {
-        handle.setTagData({ album: value });
-        data = handle.getTagData();
-        return tag;
-      },
-      setComment: (value) => {
-        handle.setTagData({ comment: value });
-        data = handle.getTagData();
-        return tag;
-      },
-      setGenre: (value) => {
-        handle.setTagData({ genre: value });
-        data = handle.getTagData();
-        return tag;
-      },
-      setYear: (value) => {
-        handle.setTagData({ year: value });
-        data = handle.getTagData();
-        return tag;
-      },
-      setTrack: (value) => {
-        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;
+    return buildMutableTag(this.handle);
   }
   audioProperties() {
     if (!this.cachedAudioProperties) {
@@ -147,14 +82,29 @@ class BaseAudioFileImpl {
       const existing = this.handle.getProperties()[LYRICS_WIRE_KEY];
       if (existing !== void 0) translated[LYRICS_WIRE_KEY] = existing;
     }
+    const atomNames = mp4FreeformAtomNames(Object.keys(translated));
+    if (atomNames.length > 0) translated[MP4_ITEM_NAMES_KEY] = atomNames;
     this.handle.setProperties(translated);
   }
   getProperty(key) {
     const value = this.handle.getProperty(toTagLibKey(key));
-    return value === "" ? void 0 : value;
+    if (value !== "") return value;
+    if (!this.isMP4()) return void 0;
+    const remapped = this.properties()[key]?.[0];
+    return remapped === "" ? void 0 : remapped;
   }
   setProperty(key, value) {
-    this.handle.setProperty(toTagLibKey(key), value);
+    const wireKey = toTagLibKey(key);
+    const atomNames = mp4FreeformAtomNames([wireKey]);
+    if (atomNames.length > 0 && this.isMP4()) {
+      this.handle.setProperties({
+        ...this.handle.getProperties(),
+        [wireKey]: [value],
+        [MP4_ITEM_NAMES_KEY]: atomNames
+      });
+      return;
+    }
+    this.handle.setProperty(wireKey, value);
   }
   isMP4() {
     return this.handle.isMP4();
@@ -163,13 +113,19 @@ class BaseAudioFileImpl {
     if (!this.isMP4()) {
       throw new UnsupportedFormatError(this.getFormat(), ["MP4", "M4A"]);
     }
-    const value = this.handle.getMP4Item(key);
+    const wireKey = mp4AtomWireKey(key);
+    const value = wireKey !== void 0 ? this.handle.getProperty(wireKey) : this.handle.getMP4Item(key);
     return value === "" ? void 0 : value;
   }
   setMP4Item(key, value) {
     if (!this.isMP4()) {
       throw new UnsupportedFormatError(this.getFormat(), ["MP4", "M4A"]);
     }
+    const wireKey = mp4AtomWireKey(key);
+    if (wireKey !== void 0) {
+      this.handle.setProperty(wireKey, value);
+      return;
+    }
     this.handle.setMP4Item(key, value);
   }
   removeMP4Item(key) {

package/dist/src/taglib/mp4-item-names.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Reserved property-map key carrying exact MP4 atom names to the C++ write path.
+ *
+ * NOT a property and NOT handle state: it is a write-time directive recomputed at
+ * each write site from the PROPERTIES table, so it needs no entry in the
+ * extra-state reconstruct registry — but every write site that builds a property
+ * map must add it, or MP4 freeform atoms get TagLib's upper-cased name
+ * (taglib-bnhl). Sites: `BaseAudioFileImpl.setProperties`/`setProperty` and the
+ * `saveToFile` reconstruct in `save-reconstruct.ts`.
+ */
+export declare const MP4_ITEM_NAMES_KEY = "_mp4ItemNames";
+//# sourceMappingURL=mp4-item-names.d.ts.map

package/dist/src/taglib/mp4-item-names.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mp4-item-names.d.ts","sourceRoot":"","sources":["../../../src/taglib/mp4-item-names.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB,kBAAkB,CAAC"}

package/dist/src/taglib/mp4-item-names.js

@@ -0,0 +1,4 @@
+const MP4_ITEM_NAMES_KEY = "_mp4ItemNames";
+export {
+  MP4_ITEM_NAMES_KEY
+};

package/dist/src/taglib/mutable-tag-impl.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @fileoverview The mutable `tag()` facade over a FileHandle.
+ *
+ * Extracted from audio-file-base.ts, which the additions for taglib-qpl/bnhl/eq3
+ * pushed past CLAUDE.md's 250-line limit. This is the whole of the basic-tag
+ * surface: five plain string fields plus the two that are backed by a raw
+ * string with a numeric mirror (`date`/`year`, `trackNumber`/`track`), whose
+ * write rules are the interesting part.
+ */
+import type { FileHandle } from "../wasm.js";
+import type { MutableTag } from "./mutable-tag.js";
+/** Build the mutable tag facade. Reads re-snapshot after every write. */
+export declare function buildMutableTag(handle: FileHandle): MutableTag;
+//# sourceMappingURL=mutable-tag-impl.d.ts.map

package/dist/src/taglib/mutable-tag-impl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutable-tag-impl.d.ts","sourceRoot":"","sources":["../../../src/taglib/mutable-tag-impl.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAMnD,yEAAyE;AACzE,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,CA2F9D"}