taglib-wasm 2.2.0 → 2.2.2

package/dist/src/runtime/wasi-adapter/mp4-items.d.ts

@@ -0,0 +1,34 @@
+/**
+ * MP4 item operations over the WASI tag-data snapshot.
+ *
+ * Pure functions over tagData: the WasiFileHandle wrappers add destruction
+ * guards. Extracted from file-handle.ts in the taglib-1dfc split.
+ */
+/**
+ * Normalize an MP4 item key for the PropertyMap path. TagLib's MP4 PropertyMap
+ * keys a freeform `----:mean:NAME` atom by its bare NAME, uppercased (the usual
+ * key remap then maps known atoms like iTunNORM -> appleSoundCheck). WASI MP4
+ * items ride the PropertyMap, so the full iTunes atom key that Emscripten's
+ * dedicated Item API uses must be normalized or the value is silently dropped on
+ * save (taglib-1qn). Non-freeform keys pass through unchanged.
+ */
+export declare function mp4ItemPropertyKey(key: string): string;
+/** Read an MP4 item; foreign-mean atoms ride their full `----:` slot. */
+export declare function getMP4Item(tagData: Record<string, unknown> | null, key: string): string;
+/** Write an MP4 item; returns the next snapshot record. */
+export declare function setMP4Item(tagData: Record<string, unknown> | null, key: string, value: string): Record<string, unknown>;
+/** Record an exact atom name to be repaired after the PropertyMap write. */
+export declare function registerMp4ItemName(tagData: Record<string, unknown> | null, name: string): Record<string, unknown>;
+/**
+ * Record a foreign-mean freeform atom for deletion at save (taglib-65nm).
+ * The PropertyMap erase pass cannot express foreign atoms, so the C++ shim
+ * consumes this list and calls removeItem on each exact atom name.
+ */
+export declare function registerMp4ItemRemoval(tagData: Record<string, unknown> | null, name: string): Record<string, unknown>;
+/** The accumulated foreign-atom removals pending the next save. */
+export declare function getMp4ItemRemovals(tagData: Record<string, unknown> | null): string[] | undefined;
+/** Replace the pending foreign-atom removal list. */
+export declare function setMp4ItemRemovals(tagData: Record<string, unknown> | null, removals: string[]): Record<string, unknown>;
+/** Remove an MP4 item; returns the next snapshot record (null on no-op). */
+export declare function removeMP4Item(tagData: Record<string, unknown> | null, key: string): Record<string, unknown> | null;
+//# sourceMappingURL=mp4-items.d.ts.map

package/dist/src/runtime/wasi-adapter/mp4-items.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mp4-items.d.ts","sourceRoot":"","sources":["../../../../src/runtime/wasi-adapter/mp4-items.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAStD;AAED,yEAAyE;AACzE,wBAAgB,UAAU,CACxB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,EACvC,GAAG,EAAE,MAAM,GACV,MAAM,CAiBR;AAED,2DAA2D;AAC3D,wBAAgB,UAAU,CACxB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,EACvC,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,GACZ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAgBzB;AAED,4EAA4E;AAC5E,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,EACvC,IAAI,EAAE,MAAM,GACX,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAOzB;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,EACvC,IAAI,EAAE,MAAM,GACX,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAOzB;AAED,mEAAmE;AACnE,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GACtC,MAAM,EAAE,GAAG,SAAS,CAEtB;AAED,qDAAqD;AACrD,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,EACvC,QAAQ,EAAE,MAAM,EAAE,GACjB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAKzB;AAED,4EAA4E;AAC5E,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,EACvC,GAAG,EAAE,MAAM,GACV,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAmBhC"}

package/dist/src/runtime/wasi-adapter/mp4-items.js

@@ -0,0 +1,80 @@
+import { fromTagLibKey, mp4AtomWireKey } from "../../constants/properties.js";
+import { mirrorForRawKey, stringifyScalar } from "../../utils/mirror-fields.js";
+import { getProperty, setProperty } from "./property-surface.js";
+function mp4ItemPropertyKey(key) {
+  if (key.startsWith("----:")) {
+    return key.slice(key.lastIndexOf(":") + 1).toUpperCase();
+  }
+  return mp4AtomWireKey(key) ?? key;
+}
+function getMP4Item(tagData, key) {
+  if (key.startsWith("----:")) {
+    const foreign = tagData?.[key];
+    if (foreign !== void 0) {
+      if (Array.isArray(foreign)) {
+        const first = foreign[0];
+        return stringifyScalar(first);
+      }
+      return stringifyScalar(foreign);
+    }
+  }
+  return getProperty(tagData, mp4ItemPropertyKey(key));
+}
+function setMP4Item(tagData, key, value) {
+  let next = setProperty(tagData, mp4ItemPropertyKey(key), value);
+  if (key.startsWith("----:")) {
+    next = registerMp4ItemName(next, key);
+    if (next?.[key] !== void 0) {
+      next = { ...next, [key]: value };
+    }
+  }
+  return next;
+}
+function registerMp4ItemName(tagData, name) {
+  const existing = tagData?._mp4ItemNames ?? [];
+  if (existing.includes(name)) return tagData ?? {};
+  return {
+    ...tagData,
+    _mp4ItemNames: [...existing, name]
+  };
+}
+function registerMp4ItemRemoval(tagData, name) {
+  const existing = tagData?._mp4ItemRemovals ?? [];
+  if (existing.includes(name)) return tagData ?? {};
+  return {
+    ...tagData,
+    _mp4ItemRemovals: [...existing, name]
+  };
+}
+function getMp4ItemRemovals(tagData) {
+  return tagData?._mp4ItemRemovals;
+}
+function setMp4ItemRemovals(tagData, removals) {
+  return {
+    ...tagData,
+    _mp4ItemRemovals: [...new Set(removals)]
+  };
+}
+function removeMP4Item(tagData, key) {
+  if (!tagData) return null;
+  let next = tagData;
+  if (key.startsWith("----:")) {
+    delete next[key];
+    next = registerMp4ItemRemoval(next, key);
+  }
+  const mappedKey = fromTagLibKey(mp4ItemPropertyKey(key));
+  delete next[mappedKey];
+  const mirror = mirrorForRawKey(mappedKey);
+  if (mirror !== void 0) delete next[mirror.numeric];
+  return next;
+}
+export {
+  getMP4Item,
+  getMp4ItemRemovals,
+  mp4ItemPropertyKey,
+  registerMp4ItemName,
+  registerMp4ItemRemoval,
+  removeMP4Item,
+  setMP4Item,
+  setMp4ItemRemovals
+};

package/dist/src/runtime/wasi-adapter/property-surface.d.ts

@@ -0,0 +1,25 @@
+/**
+ * The property surface over the WASI tag-data snapshot.
+ *
+ * Pure functions over tagData: the WasiFileHandle wrappers add destruction
+ * guards. Extracted from file-handle.ts in the taglib-1dfc split.
+ */
+import type { BasicTagData } from "../../types/tags.js";
+/** The readable basic-tag surface (first-value idiom, numeric mirrors). */
+export declare function getBasicTagData(tagData: Record<string, unknown> | null): BasicTagData;
+/**
+ * Merge a basic-tag write into the snapshot. setYear()/setTrack() are
+ * authoritative for their wire key: the raw mirror is replaced so a stale
+ * "1975-10-31" or "3/12" cannot shadow the new number, and a non-positive
+ * value clears the field outright (taglib-bk7, taglib-qpl).
+ */
+export declare function setBasicTagData(tagData: Record<string, unknown> | null, data: Partial<BasicTagData>): Record<string, unknown>;
+/** The property map over the snapshot, excluding audio/internal keys. */
+export declare function getProperties(tagData: Record<string, unknown> | null): Record<string, string[]>;
+/** Replace-style property write; returns the next snapshot record. */
+export declare function setProperties(tagData: Record<string, unknown> | null, props: Record<string, string[]>): Record<string, unknown>;
+/** Single-property read (first value of arrays). */
+export declare function getProperty(tagData: Record<string, unknown> | null, key: string): string;
+/** Single-property write; returns the next snapshot record. */
+export declare function setProperty(tagData: Record<string, unknown> | null, key: string, value: string): Record<string, unknown>;
+//# sourceMappingURL=property-surface.d.ts.map

package/dist/src/runtime/wasi-adapter/property-surface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"property-surface.d.ts","sourceRoot":"","sources":["../../../../src/runtime/wasi-adapter/property-surface.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAexD,2EAA2E;AAC3E,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GACtC,YAAY,CAWd;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,EACvC,IAAI,EAAE,OAAO,CAAC,YAAY,CAAC,GAC1B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CASzB;AAED,yEAAyE;AACzE,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GACtC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAsC1B;AAED,sEAAsE;AACtE,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,EACvC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAC9B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAgCzB;AAED,oDAAoD;AACpD,wBAAgB,WAAW,CACzB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,EACvC,GAAG,EAAE,MAAM,GACV,MAAM,CAQR;AAED,+DAA+D;AAC/D,wBAAgB,WAAW,CACzB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,EACvC,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,GACZ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAazB"}

package/dist/src/runtime/wasi-adapter/property-surface.js

@@ -0,0 +1,104 @@
+import { fromTagLibKey, toTagLibKey } from "../../constants/properties.js";
+import {
+  DATE_MIRROR,
+  firstValueString,
+  isShadowedNumericMirror,
+  mirrorForRawKey,
+  readNumericMirror,
+  stageNumericWrite,
+  stageRawWrite,
+  stringifyScalar,
+  TRACK_MIRROR
+} from "../../utils/mirror-fields.js";
+import { AUDIO_KEYS, INTERNAL_KEYS } from "./tag-keys.js";
+function getBasicTagData(tagData) {
+  const d = tagData ?? {};
+  return {
+    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)
+  };
+}
+function setBasicTagData(tagData, data) {
+  const merged = { ...tagData, ...data };
+  if (data.year !== void 0) {
+    stageNumericWrite(merged, DATE_MIRROR, data.year);
+  }
+  if (data.track !== void 0) {
+    stageNumericWrite(merged, TRACK_MIRROR, data.track);
+  }
+  return merged;
+}
+function getProperties(tagData) {
+  const result = {};
+  const data = tagData ?? {};
+  for (const [key, value] of Object.entries(data)) {
+    if (AUDIO_KEYS.has(key) || INTERNAL_KEYS.has(key)) continue;
+    if (key.startsWith("----:")) continue;
+    if (isShadowedNumericMirror(data, key)) continue;
+    if (value === void 0 || value === null) continue;
+    if (value === 0 || value === "") continue;
+    const propKey = toTagLibKey(key);
+    if (Array.isArray(value)) {
+      if (value.length === 0) continue;
+      result[propKey] = value.map(String);
+    } else if (typeof value === "object") {
+      continue;
+    } else if (typeof value === "string" || typeof value === "number" || typeof value === "boolean" || typeof value === "bigint" || typeof value === "symbol") {
+      result[propKey] = [String(value)];
+    }
+  }
+  return result;
+}
+function setProperties(tagData, props) {
+  const next = { ...tagData };
+  for (const [key, values] of Object.entries(props)) {
+    const camelKey = fromTagLibKey(key);
+    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) {
+      if (camelKey === "itunesAdvisory") next[camelKey] = [];
+      else delete next[camelKey];
+    } else {
+      next[camelKey] = values;
+    }
+  }
+  return next;
+}
+function getProperty(tagData, key) {
+  const mappedKey = fromTagLibKey(key);
+  const stored = tagData?.[mappedKey];
+  if (Array.isArray(stored)) {
+    const first = stored[0];
+    return stringifyScalar(first);
+  }
+  return stringifyScalar(stored);
+}
+function setProperty(tagData, key, value) {
+  const mappedKey = fromTagLibKey(key);
+  const mirror = mirrorForRawKey(mappedKey);
+  if (mirror !== void 0) {
+    const next = { ...tagData };
+    stageRawWrite(next, mirror, value === "" ? [] : [value]);
+    return next;
+  }
+  return { ...tagData, [mappedKey]: value };
+}
+export {
+  getBasicTagData,
+  getProperties,
+  getProperty,
+  setBasicTagData,
+  setProperties,
+  setProperty
+};

package/dist/src/runtime/wasi-adapter/structured-fields.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Structured-field accessors over the WASI tag-data snapshot.
+ *
+ * Pure functions over the tag-data snapshot: the WasiFileHandle wrappers add
+ * destruction guards. Extracted from file-handle.ts in the taglib-1dfc split.
+ */
+import type { RawChapter, RawId3v2Frame, RawLyrics, RawPicture } from "../../wasm.js";
+import type { HandleState } from "./handle-state.js";
+export declare function getPictures(tagData: Record<string, unknown> | null): RawPicture[];
+export declare function setPictures(tagData: Record<string, unknown> | null, pictures: RawPicture[]): Record<string, unknown>;
+export declare function addPicture(tagData: Record<string, unknown> | null, picture: RawPicture): Record<string, unknown>;
+export declare function removePictures(tagData: Record<string, unknown> | null): Record<string, unknown>;
+export declare function getChapters(tagData: Record<string, unknown> | null): RawChapter[];
+export declare function setChapters(tagData: Record<string, unknown> | null, chapters: RawChapter[], mp4ChapterStyle: string): Record<string, unknown>;
+export declare function getBextData(tagData: Record<string, unknown> | null): Uint8Array | undefined;
+export declare function setBextData(tagData: Record<string, unknown> | null, data: Uint8Array | null): Record<string, unknown>;
+export declare function getIxml(tagData: Record<string, unknown> | null): string | undefined;
+export declare function setIxml(tagData: Record<string, unknown> | null, data: string | null): Record<string, unknown>;
+export declare function hasId3Tags(tagData: Record<string, unknown> | null): {
+    v1: boolean;
+    v2: boolean;
+};
+export declare function stripId3Tags(tagData: Record<string, unknown> | null, opts: {
+    v1: boolean;
+    v2: boolean;
+}): Record<string, unknown> | null;
+export declare function getRatings(tagData: Record<string, unknown> | null): {
+    rating: number;
+    email: string;
+    counter: number;
+}[];
+export declare function setRatings(tagData: Record<string, unknown> | null, ratings: {
+    rating: number;
+    email?: string;
+    counter?: number;
+}[]): Record<string, unknown>;
+export declare function getLyrics(tagData: Record<string, unknown> | null): RawLyrics[];
+export declare function setLyrics(tagData: Record<string, unknown> | null, lyrics: RawLyrics[]): Record<string, unknown>;
+export declare function getStagedId3v2Frames(tagData: Record<string, unknown> | null): Record<string, Uint8Array[]> | undefined;
+export declare function setId3v2Frames(tagData: Record<string, unknown> | null, id: string, data: Uint8Array[]): Record<string, unknown>;
+export declare function removeId3v2Frames(tagData: Record<string, unknown> | null, id: string): Record<string, unknown>;
+/** Raw ID3v2 frames: file state filtered by staged per-ID replacements. */
+export declare function getId3v2Frames(state: HandleState, id: string): RawId3v2Frame[];
+//# sourceMappingURL=structured-fields.d.ts.map

package/dist/src/runtime/wasi-adapter/structured-fields.d.ts.map

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

package/dist/src/runtime/wasi-adapter/structured-fields.js

@@ -0,0 +1,139 @@
+import { readId3v2FramesFromWasm } from "./wasm-io.js";
+function getPictures(tagData) {
+  return tagData?.pictures ?? [];
+}
+function setPictures(tagData, pictures) {
+  return { ...tagData, pictures };
+}
+function addPicture(tagData, picture) {
+  const pictures = getPictures(tagData);
+  pictures.push(picture);
+  return setPictures(tagData, pictures);
+}
+function removePictures(tagData) {
+  return { ...tagData, pictures: [] };
+}
+function getChapters(tagData) {
+  return tagData?.chapters ?? [];
+}
+function setChapters(tagData, chapters, mp4ChapterStyle) {
+  return {
+    ...tagData,
+    _mp4ChapterStyle: mp4ChapterStyle,
+    chapters
+  };
+}
+function getBextData(tagData) {
+  return tagData?.bextData ?? void 0;
+}
+function setBextData(tagData, data) {
+  return { ...tagData, bextData: data };
+}
+function getIxml(tagData) {
+  const v = tagData?.ixml;
+  return typeof v === "string" && v.length > 0 ? v : void 0;
+}
+function setIxml(tagData, data) {
+  return { ...tagData, ixml: data };
+}
+function hasId3Tags(tagData) {
+  const t = tagData?.id3Tags;
+  return { v1: t?.v1 ?? false, v2: t?.v2 ?? false };
+}
+function stripId3Tags(tagData, opts) {
+  const current = tagData?.id3Tags;
+  if (!current) return tagData;
+  const prior = tagData?._stripId3;
+  const stripV1 = (prior?.v1 ?? false) || opts.v1;
+  const stripV2 = (prior?.v2 ?? false) || opts.v2;
+  return {
+    ...tagData,
+    _stripId3: { v1: stripV1, v2: stripV2 },
+    id3Tags: {
+      v1: (current.v1 ?? false) && !stripV1,
+      v2: (current.v2 ?? false) && !stripV2
+    }
+  };
+}
+function getRatings(tagData) {
+  return tagData?.ratings ?? [];
+}
+function setRatings(tagData, ratings) {
+  const normalizedRatings = ratings.map((r) => ({
+    rating: r.rating,
+    email: r.email ?? "",
+    counter: r.counter ?? 0
+  }));
+  return {
+    ...tagData,
+    ratings: normalizedRatings
+  };
+}
+function getLyrics(tagData) {
+  const value = tagData?.lyrics;
+  if (value === void 0 || value === null) return [];
+  const entries = Array.isArray(value) ? value : [value];
+  return entries.map(
+    (entry) => typeof entry === "string" ? { text: entry, description: "", language: "" } : {
+      text: entry?.text ?? "",
+      description: entry?.description ?? "",
+      language: entry?.language ?? ""
+    }
+  );
+}
+function setLyrics(tagData, lyrics) {
+  return { ...tagData, lyrics };
+}
+function getStagedId3v2Frames(tagData) {
+  return tagData?.id3v2Frames;
+}
+function setId3v2Frames(tagData, id, data) {
+  const staged = { ...getStagedId3v2Frames(tagData) ?? {} };
+  staged[id] = data.map((d) => new Uint8Array(d));
+  return {
+    ...tagData,
+    id3v2Frames: staged
+  };
+}
+function removeId3v2Frames(tagData, id) {
+  return setId3v2Frames(tagData, id, []);
+}
+function getId3v2Frames(state, id) {
+  const filter = id === "" ? void 0 : id;
+  const source = state.filePath ?? state.fileData;
+  let frames = [];
+  if (source) {
+    frames = readId3v2FramesFromWasm(state.wasi, source, filter);
+  }
+  const staged = getStagedId3v2Frames(state.tagData);
+  if (!staged) return frames;
+  const stagedIds = new Set(Object.keys(staged));
+  frames = frames.filter((f) => !stagedIds.has(f.id));
+  for (const [sid, bodies] of Object.entries(staged)) {
+    if (filter && sid !== filter) continue;
+    for (const data of bodies) frames.push({ id: sid, data: data.slice() });
+  }
+  return frames;
+}
+export {
+  addPicture,
+  getBextData,
+  getChapters,
+  getId3v2Frames,
+  getIxml,
+  getLyrics,
+  getPictures,
+  getRatings,
+  getStagedId3v2Frames,
+  hasId3Tags,
+  removeId3v2Frames,
+  removePictures,
+  setBextData,
+  setChapters,
+  setId3v2Frames,
+  setIxml,
+  setLyrics,
+  setPictures,
+  setRatings,
+  stripId3Tags
+};

package/dist/src/runtime/wasi-adapter/tag-keys.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Internal key classification for the WASI tag-data snapshot.
+ *
+ * AUDIO_KEYS and INTERNAL_KEYS are excluded from the property surface
+ * (getProperties); preserveEmptyValues keeps empty-string fields alive for
+ * the save round-trip (taglib-yc1x). Extracted from file-handle.ts in the
+ * taglib-1dfc split.
+ */
+/** Audio metrics emitted by the C++ read path, not tag properties. */
+export declare const AUDIO_KEYS: Set<string>;
+/** Structured fields and write-time directives, never properties. */
+export declare const INTERNAL_KEYS: Set<string>;
+/**
+ * A frame that exists holding an empty string is not the same state as no frame
+ * at all, and the read snapshot must say so — otherwise the save cannot carry
+ * the value back, `setProperties()` sees the field as absent, and TagLib deletes
+ * a frame the caller never touched (taglib-yc1x).
+ *
+ * The C++ encoder emits a single value as a bare string, and both `cleanObject`
+ * and `getProperties` drop a bare `""`. An ARRAY containing `""` already
+ * survives every one of those layers, so promoting the bare form to `[""]` here
+ * carries the value end to end without touching the encoder or the decoder.
+ *
+ * This only concerns readable tag properties: audio metrics and the internal
+ * write-time channels keep their own shapes.
+ */
+export declare function preserveEmptyValues(data: Record<string, unknown>): Record<string, unknown>;
+//# sourceMappingURL=tag-keys.d.ts.map

package/dist/src/runtime/wasi-adapter/tag-keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tag-keys.d.ts","sourceRoot":"","sources":["../../../../src/runtime/wasi-adapter/tag-keys.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,sEAAsE;AACtE,eAAO,MAAM,UAAU,aAiBrB,CAAC;AAEH,qEAAqE;AACrE,eAAO,MAAM,aAAa,aAaxB,CAAC;AAEH;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQzB"}

package/dist/src/runtime/wasi-adapter/tag-keys.js

@@ -0,0 +1,46 @@
+const AUDIO_KEYS = /* @__PURE__ */ new Set([
+  "bitrate",
+  "bitrateMode",
+  "bitsPerSample",
+  "channels",
+  "codec",
+  "containerFormat",
+  "formatVersion",
+  "isEncrypted",
+  "isLossless",
+  "duration",
+  "length",
+  "lengthMs",
+  "mpegLayer",
+  "mpegVersion",
+  "outputGainDb",
+  "sampleRate"
+]);
+const INTERNAL_KEYS = /* @__PURE__ */ new Set([
+  "pictures",
+  "ratings",
+  "lyrics",
+  "chapters",
+  "_mp4ChapterStyle",
+  "bextData",
+  "ixml",
+  // Exact MP4 atom names for the write path, not a readable property.
+  "_mp4ItemNames",
+  // Foreign-mean MP4 atom names to delete at save (taglib-65nm): a write-time
+  // directive, never a property.
+  "_mp4ItemRemovals"
+]);
+function preserveEmptyValues(data) {
+  for (const [key, value] of Object.entries(data)) {
+    if (value !== "") continue;
+    if (AUDIO_KEYS.has(key) || INTERNAL_KEYS.has(key)) continue;
+    if (key.startsWith("----:")) continue;
+    data[key] = [""];
+  }
+  return data;
+}
+export {
+  AUDIO_KEYS,
+  INTERNAL_KEYS,
+  preserveEmptyValues
+};

package/dist/src/simple/batch-operations.d.ts

@@ -82,19 +82,33 @@ export interface WriteTagUpdate {
     /** File path on disk; the file is updated in place. */
     path: string;
     /**
-     * Partial tag fields to merge with the file's existing metadata. An empty
-     * object performs a save with no tag changes (a no-op rewrite).
+     * Partial typed tag fields to merge with the file's existing metadata. An
+     * empty object performs a save with no tag changes (a no-op rewrite).
      */
-    tags: Partial<TagInput>;
+    tags?: Partial<TagInput>;
+    /**
+     * Raw WIRE-key map, merged verbatim — the same shape and rule as the Full
+     * API's `setProperties` (taglib-pmhp review): keys outside the typed
+     * TagInput surface (barcode, unmodeled TXXX fields) ride here, and an
+     * EMPTY ARRAY removes the key (the qyw2/nc5 clearing contract; no
+     * empty-string carrier). Applied in the same single save as `tags`;
+     * entries here take precedence over `tags` for the same normalized key.
+     * Writes are verbatim: unlike the typed `tags` channel (which clears the
+     * legacy YEAR field when DATE is set), a raw `properties` write does not
+     * reconcile related keys — exactly like the Full API's `setProperties`.
+     */
+    properties?: Record<string, string[]>;
 }
 /**
  * Apply tag updates to multiple files with configurable concurrency.
  *
  * The batch write counterpart to {@link readTagsBatch}: same
  * {@link BatchOptions} contract (concurrency, continueOnError, onProgress,
- * signal). Each file is updated via the same path as
- * {@link applyTagsToFile} — merge semantics, atomic temp-file save, so a
- * failed file is left in its pre-write state.
+ * signal). Each file is updated in ONE save via a single `setProperties`
+ * fold: the typed `tags` merge ({@link mergeTagUpdatesInto} — the same
+ * semantics as {@link applyTagsToFile}) plus the raw wire-key `properties`
+ * entries. Atomic temp-file save, so a failed file is left in its pre-write
+ * state.
  *
  * @param updates - Per-file tag updates; a path may appear more than once
  *   (the last update for a path wins).
@@ -108,16 +122,19 @@ export declare function writeTagsBatch(updates: WriteTagUpdate[], options?: Batc
  * Open, mutate, and save multiple files with configurable concurrency.
  *
  * Mutator-callback variant of {@link writeTagsBatch}: the callback receives
- * the open {@link AudioFile} (Full-API style) and its changes are saved per
- * file. Same {@link BatchOptions} contract and atomicity guarantees.
+ * the open {@link AudioFile} (Full-API style) plus the `path` it was opened
+ * from — the pair is a per-invocation contract, so precomputed per-path
+ * plans can be looked up without relying on invocation order (taglib-pmhp
+ * review). A one-argument mutator keeps working. Changes are saved per file;
+ * same {@link BatchOptions} contract and atomicity guarantees.
  *
  * @param files - File paths on disk, updated in place.
- * @param mutator - Called once per file with the open audio file; changes are
- *   saved automatically.
+ * @param mutator - Called once per file with the open audio file and its
+ *   path; changes are saved automatically.
  * @param options - Batch processing options (concurrency, error handling,
  *   progress, abort).
  * @returns A `BatchItem` per file in input order plus total duration in ms.
  * @throws If `continueOnError` is `false` and any file fails to process.
  */
-export declare function editTagsBatch(files: string[], mutator: (audioFile: AudioFile) => void, options?: BatchOptions): Promise<BatchResult<void>>;
+export declare function editTagsBatch(files: string[], mutator: (audioFile: AudioFile, path: string) => void, options?: BatchOptions): Promise<BatchResult<void>>;
 //# sourceMappingURL=batch-operations.d.ts.map

package/dist/src/simple/batch-operations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"batch-operations.d.ts","sourceRoot":"","sources":["../../../src/simple/batch-operations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EACf,WAAW,EACX,QAAQ,EACT,MAAM,aAAa,CAAC;AAQrB,qDAAqD;AACrD,MAAM,WAAW,YAAY;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7E,gEAAgE;IAChE,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC9B;AAED,yEAAyE;AACzE,MAAM,MAAM,SAAS,CAAC,CAAC,IACnB;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GACvC;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,CAAC;AAEpD,mEAAmE;AACnE,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAyDD;;;;;;;GAOG;AACH,wBAAsB,aAAa,CACjC,KAAK,EAAE,cAAc,EAAE,EACvB,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC,CAMnC;AAED;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,cAAc,EAAE,EACvB,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,WAAW,CAAC,eAAe,GAAG,SAAS,CAAC,CAAC,CAMnD;AAED,oHAAoH;AACpH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,WAAW,CAAC;IAClB,UAAU,EAAE,eAAe,GAAG,SAAS,CAAC;IACxC,WAAW,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,aAAa,CAAC;CAC1B;AAsBD;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,cAAc,EACpB,OAAO,GAAE;IAAE,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAA;CAAO,GAC7C,OAAO,CAAC,YAAY,CAAC,CA6BvB;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,cAAc,EAAE,EACvB,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC,CAUpC;AAED,2DAA2D;AAC3D,MAAM,WAAW,cAAc;IAC7B,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;CACzB;AAsDD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,cAAc,EAAE,EACzB,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAM5B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,aAAa,CACjC,KAAK,EAAE,MAAM,EAAE,EACf,OAAO,EAAE,CAAC,SAAS,EAAE,SAAS,KAAK,IAAI,EACvC,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAM5B"}
+{"version":3,"file":"batch-operations.d.ts","sourceRoot":"","sources":["../../../src/simple/batch-operations.ts"],"names":[],"mappings":"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"}

package/dist/src/simple/batch-operations.js

@@ -1,7 +1,7 @@
 import { isNamedAudioInput } from "../types/audio-formats.js";
 import { InvalidFormatError } from "../errors.js";
-import { readExtendedTag } from "../utils/tag-mapping.js";
-import { applyTagsToFile } from "./tag-operations.js";
+import { fromTagLibKey } from "../constants/properties.js";
+import { mergeTagUpdatesInto, readExtendedTag } from "../utils/tag-mapping.js";
 import { withAudioFileSaveToFile } from "./with-audio-file.js";
 import { getTagLib } from "./config.js";
 async function executeBatch(files, options, processor) {
@@ -154,16 +154,26 @@ async function executeWriteBatch(entries, options, writer) {
 }
 async function writeTagsBatch(updates, options = {}) {
   const byPath = new Map(updates.map((u) => [u.path, u]));
-  return executeWriteBatch(updates, options, (path) => {
-    const update = byPath.get(path);
-    return applyTagsToFile(path, update.tags);
-  });
+  return executeWriteBatch(
+    updates,
+    options,
+    (path) => withAudioFileSaveToFile(path, (audioFile) => {
+      const update = byPath.get(path);
+      const merged = update.tags !== void 0 ? mergeTagUpdatesInto(audioFile.properties(), update.tags) : audioFile.properties();
+      if (update.properties !== void 0) {
+        for (const [key, values] of Object.entries(update.properties)) {
+          merged[fromTagLibKey(key)] = values;
+        }
+      }
+      audioFile.setProperties(merged);
+    })
+  );
 }
 async function editTagsBatch(files, mutator, options = {}) {
   return executeWriteBatch(
     files,
     options,
-    (path) => withAudioFileSaveToFile(path, mutator)
+    (path) => withAudioFileSaveToFile(path, (audioFile) => mutator(audioFile, path))
   );
 }
 export {