taglib-wasm 2.2.1 → 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/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "2.2.1";
+export declare const VERSION = "2.2.2";
 //# sourceMappingURL=version.d.ts.map

package/dist/src/version.js

@@ -1,4 +1,4 @@
-const VERSION = "2.2.1";
+const VERSION = "2.2.2";
 export {
   VERSION
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "taglib-wasm",
-  "version": "2.2.1",
+  "version": "2.2.2",
   "description": "TagLib-Wasm is the universal tagging library for TypeScript/JavaScript platforms: Browsers, Node.js, Deno, Bun, Cloudflare Workers, and Electron apps",
   "type": "module",
   "main": "dist/index.js",
@@ -164,6 +164,7 @@
     "esbuild": "^0.28.2",
     "eslint": "^10.8.1",
     "fast-check": "^4.9.0",
+    "knip": "^6.32.2",
     "tsx": "^4.23.12",
     "typescript": "^6.0.3",
     "typescript-eslint": "^8.67.0"

package/dist/src/folder-api/group-albums.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"group-albums.d.ts","sourceRoot":"","sources":["../../../src/folder-api/group-albums.ts"],"names":[],"mappings":"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"}