taglib-wasm 1.3.0 → 1.4.0

package/dist/index.browser.js

@@ -1333,12 +1333,15 @@ var init_properties = __esm({
 });
 
 // src/taglib/audio-file-base.ts
-var BaseAudioFileImpl;
+var LYRICS_PROPERTY_KEY, LYRICS_WIRE_KEY, EMPTY_KEY_SET, BaseAudioFileImpl;
 var init_audio_file_base = __esm({
   "src/taglib/audio-file-base.ts"() {
     "use strict";
     init_properties();
     init_errors2();
+    LYRICS_PROPERTY_KEY = "lyrics";
+    LYRICS_WIRE_KEY = toTagLibKey(LYRICS_PROPERTY_KEY);
+    EMPTY_KEY_SET = /* @__PURE__ */ new Set();
     BaseAudioFileImpl = class {
       constructor(module, fileHandle, sourcePath, originalSource, isPartiallyLoaded = false, partialLoadOptions) {
         __publicField(this, "module", module);
@@ -1348,11 +1351,30 @@ var init_audio_file_base = __esm({
         __publicField(this, "originalSource");
         __publicField(this, "isPartiallyLoaded", false);
         __publicField(this, "partialLoadOptions");
+        /** Text-property wire keys in the partial header at load; undefined if full. */
+        __publicField(this, "partialKeysAtLoad");
         this.fileHandle = fileHandle;
         this.sourcePath = sourcePath;
         this.originalSource = originalSource;
         this.isPartiallyLoaded = isPartiallyLoaded;
         this.partialLoadOptions = partialLoadOptions;
+        this.partialKeysAtLoad = isPartiallyLoaded ? new Set(Object.keys(fileHandle.getProperties())) : void 0;
+      }
+      /**
+       * Wire-key text properties present in the partial header at load but now
+       * absent — the user deleted them. The partial-load reconstruct subtracts these
+       * from its preserve-the-original merge so a deletion persists without wiping
+       * frames beyond the loaded header (taglib-d14). Lyrics are excluded (they ride
+       * their own reconstruct path); empty for a full load.
+       */
+      partialDeletedPropertyKeys() {
+        if (!this.partialKeysAtLoad) return EMPTY_KEY_SET;
+        const current = new Set(Object.keys(this.handle.getProperties()));
+        const deleted = /* @__PURE__ */ new Set();
+        for (const key of this.partialKeysAtLoad) {
+          if (key !== LYRICS_WIRE_KEY && !current.has(key)) deleted.add(key);
+        }
+        return deleted;
       }
       get handle() {
         if (!this.fileHandle) {
@@ -1448,13 +1470,19 @@ var init_audio_file_base = __esm({
         return this.cachedAudioProperties ?? void 0;
       }
       properties() {
-        return remapKeysFromTagLib(this.handle.getProperties());
+        const remapped = remapKeysFromTagLib(this.handle.getProperties());
+        delete remapped[LYRICS_PROPERTY_KEY];
+        return remapped;
       }
       setProperties(properties) {
         const translated = {};
         for (const [key, values] of Object.entries(properties)) {
           if (values !== void 0) translated[toTagLibKey(key)] = values;
         }
+        if (!(LYRICS_WIRE_KEY in translated)) {
+          const existing = this.handle.getProperties()[LYRICS_WIRE_KEY];
+          if (existing !== void 0) translated[LYRICS_WIRE_KEY] = existing;
+        }
         this.handle.setProperties(translated);
       }
       getProperty(key) {
@@ -1734,14 +1762,14 @@ var init_extra_state_registry = __esm({
 });
 
 // src/taglib/save-reconstruct.ts
-function copyEditedState(target, source, sourceComplete) {
+function copyEditedState(target, source, sourceComplete, deletedKeys) {
   target.setTagData(source.getTagData());
-  target.setProperties(
-    sourceComplete ? source.getProperties() : { ...target.getProperties(), ...source.getProperties() }
-  );
+  const merged = sourceComplete ? source.getProperties() : { ...target.getProperties(), ...source.getProperties() };
+  for (const key of deletedKeys) delete merged[key];
+  target.setProperties(merged);
   copyExtraState(target, source, sourceComplete);
 }
-async function saveViaFreshHandle(module, editing, source, targetPath, sourceComplete) {
+async function saveViaFreshHandle(module, editing, source, targetPath, sourceComplete, deletedKeys = /* @__PURE__ */ new Set()) {
   const rawFullHandle = module.createFileHandle();
   const fullFileHandle = module.isWasi ? rawFullHandle : wrapEmbindHandle(rawFullHandle);
   try {
@@ -1753,7 +1781,7 @@ async function saveViaFreshHandle(module, editing, source, targetPath, sourceCom
         );
       }
     }
-    copyEditedState(fullFileHandle, editing, sourceComplete);
+    copyEditedState(fullFileHandle, editing, sourceComplete, deletedKeys);
     if (!fullFileHandle.save()) {
       throw new FileOperationError(
         "save",
@@ -1858,7 +1886,8 @@ var init_audio_file_impl = __esm({
             this.handle,
             this.originalSource,
             targetPath,
-            false
+            false,
+            this.partialDeletedPropertyKeys()
           );
           this.isPartiallyLoaded = false;
           this.originalSource = void 0;
@@ -1976,6 +2005,21 @@ var init_audio_file_impl = __esm({
           counter: r.counter ?? 0
         })));
       }
+      getLyrics() {
+        return this.handle.getLyrics().map((l) => {
+          const out = { text: l.text };
+          if (l.description) out.description = l.description;
+          if (l.language) out.language = l.language;
+          return out;
+        });
+      }
+      setLyrics(lyrics) {
+        this.handle.setLyrics(lyrics.map((l) => ({
+          text: l.text,
+          description: l.description ?? "",
+          language: l.language ?? ""
+        })));
+      }
       getRating() {
         const ratings = this.getRatings();
         return ratings.length > 0 ? ratings[0].rating : void 0;
@@ -2038,6 +2082,24 @@ function parseNumeric(value) {
   const parsed = Number.parseInt(value, 10);
   return Number.isNaN(parsed) ? void 0 : parsed;
 }
+function readExtendedTag(audioFile) {
+  const tag = mapPropertiesToExtendedTag(audioFile.properties());
+  const pictures = audioFile.getPictures();
+  if (pictures.length > 0) tag.pictures = pictures;
+  const ratings = audioFile.getRatings();
+  if (ratings.length > 0) tag.ratings = ratings;
+  const lyrics = audioFile.getLyrics();
+  if (lyrics.length > 0) tag.lyrics = lyrics;
+  const chapters = audioFile.getChapters();
+  if (chapters.length > 0) tag.chapters = chapters;
+  const bext = audioFile.getBext();
+  if (bext !== void 0) tag.bext = bext;
+  const bextData = audioFile.getBextData();
+  if (bextData !== void 0) tag.bextData = bextData;
+  const ixml = audioFile.getIxml();
+  if (ixml !== void 0) tag.ixml = ixml;
+  return tag;
+}
 function mapPropertiesToExtendedTag(props) {
   const tag = {};
   for (const [propKey, tagField] of Object.entries(BASIC_PROPERTY_KEYS)) {
@@ -2149,7 +2211,7 @@ var VERSION;
 var init_version = __esm({
   "src/version.ts"() {
     "use strict";
-    VERSION = "1.3.0";
+    VERSION = "1.4.0";
   }
 });
 
@@ -2504,10 +2566,7 @@ async function withAudioFileSaveToFile(file, fn) {
 
 // src/simple/tag-operations.ts
 async function readTags(file) {
-  return withAudioFile(
-    file,
-    (audioFile) => mapPropertiesToExtendedTag(audioFile.properties())
-  );
+  return withAudioFile(file, (audioFile) => readExtendedTag(audioFile));
 }
 async function applyTags(file, tags) {
   return withAudioFileSave(file, (audioFile) => {
@@ -2565,8 +2624,15 @@ async function readFormat(file) {
 }
 async function clearTags(file) {
   return withAudioFileSave(file, (audioFile) => {
-    audioFile.setProperties({});
+    const cleared = {};
+    for (const key of Object.keys(audioFile.properties())) cleared[key] = [];
+    audioFile.setProperties(cleared);
     audioFile.removePictures();
+    audioFile.setLyrics([]);
+    audioFile.setRatings([]);
+    if (audioFile.getChapters().length > 0) audioFile.setChapters([]);
+    if (audioFile.getBextData() !== void 0) audioFile.setBextData(null);
+    if (audioFile.getIxml() !== void 0) audioFile.setIxml(null);
   });
 }
 
@@ -2678,7 +2744,7 @@ async function readTagsBatch(files, options = {}) {
   return executeBatch(
     files,
     options,
-    (audioFile) => mapPropertiesToExtendedTag(audioFile.properties())
+    (audioFile) => readExtendedTag(audioFile)
   );
 }
 async function readPropertiesBatch(files, options = {}) {
@@ -2727,7 +2793,7 @@ async function readMetadata(file) {
       );
     }
     return {
-      tags: mapPropertiesToExtendedTag(audioFile.properties()),
+      tags: readExtendedTag(audioFile),
       properties: audioFile.audioProperties(),
       hasCoverArt: audioFile.getPictures().length > 0,
       dynamics: extractDynamics(audioFile)
@@ -2738,7 +2804,7 @@ async function readMetadata(file) {
 }
 async function readMetadataBatch(files, options = {}) {
   return executeBatch(files, options, (audioFile) => ({
-    tags: mapPropertiesToExtendedTag(audioFile.properties()),
+    tags: readExtendedTag(audioFile),
     properties: audioFile.audioProperties(),
     hasCoverArt: audioFile.getPictures().length > 0,
     dynamics: extractDynamics(audioFile)

package/dist/simple.browser.js

@@ -1321,12 +1321,15 @@ var init_properties = __esm({
 });
 
 // src/taglib/audio-file-base.ts
-var BaseAudioFileImpl;
+var LYRICS_PROPERTY_KEY, LYRICS_WIRE_KEY, EMPTY_KEY_SET, BaseAudioFileImpl;
 var init_audio_file_base = __esm({
   "src/taglib/audio-file-base.ts"() {
     "use strict";
     init_properties();
     init_errors2();
+    LYRICS_PROPERTY_KEY = "lyrics";
+    LYRICS_WIRE_KEY = toTagLibKey(LYRICS_PROPERTY_KEY);
+    EMPTY_KEY_SET = /* @__PURE__ */ new Set();
     BaseAudioFileImpl = class {
       constructor(module, fileHandle, sourcePath, originalSource, isPartiallyLoaded = false, partialLoadOptions) {
         __publicField(this, "module", module);
@@ -1336,11 +1339,30 @@ var init_audio_file_base = __esm({
         __publicField(this, "originalSource");
         __publicField(this, "isPartiallyLoaded", false);
         __publicField(this, "partialLoadOptions");
+        /** Text-property wire keys in the partial header at load; undefined if full. */
+        __publicField(this, "partialKeysAtLoad");
         this.fileHandle = fileHandle;
         this.sourcePath = sourcePath;
         this.originalSource = originalSource;
         this.isPartiallyLoaded = isPartiallyLoaded;
         this.partialLoadOptions = partialLoadOptions;
+        this.partialKeysAtLoad = isPartiallyLoaded ? new Set(Object.keys(fileHandle.getProperties())) : void 0;
+      }
+      /**
+       * Wire-key text properties present in the partial header at load but now
+       * absent — the user deleted them. The partial-load reconstruct subtracts these
+       * from its preserve-the-original merge so a deletion persists without wiping
+       * frames beyond the loaded header (taglib-d14). Lyrics are excluded (they ride
+       * their own reconstruct path); empty for a full load.
+       */
+      partialDeletedPropertyKeys() {
+        if (!this.partialKeysAtLoad) return EMPTY_KEY_SET;
+        const current = new Set(Object.keys(this.handle.getProperties()));
+        const deleted = /* @__PURE__ */ new Set();
+        for (const key of this.partialKeysAtLoad) {
+          if (key !== LYRICS_WIRE_KEY && !current.has(key)) deleted.add(key);
+        }
+        return deleted;
       }
       get handle() {
         if (!this.fileHandle) {
@@ -1436,13 +1458,19 @@ var init_audio_file_base = __esm({
         return this.cachedAudioProperties ?? void 0;
       }
       properties() {
-        return remapKeysFromTagLib(this.handle.getProperties());
+        const remapped = remapKeysFromTagLib(this.handle.getProperties());
+        delete remapped[LYRICS_PROPERTY_KEY];
+        return remapped;
       }
       setProperties(properties) {
         const translated = {};
         for (const [key, values] of Object.entries(properties)) {
           if (values !== void 0) translated[toTagLibKey(key)] = values;
         }
+        if (!(LYRICS_WIRE_KEY in translated)) {
+          const existing = this.handle.getProperties()[LYRICS_WIRE_KEY];
+          if (existing !== void 0) translated[LYRICS_WIRE_KEY] = existing;
+        }
         this.handle.setProperties(translated);
       }
       getProperty(key) {
@@ -1722,14 +1750,14 @@ var init_extra_state_registry = __esm({
 });
 
 // src/taglib/save-reconstruct.ts
-function copyEditedState(target, source, sourceComplete) {
+function copyEditedState(target, source, sourceComplete, deletedKeys) {
   target.setTagData(source.getTagData());
-  target.setProperties(
-    sourceComplete ? source.getProperties() : { ...target.getProperties(), ...source.getProperties() }
-  );
+  const merged = sourceComplete ? source.getProperties() : { ...target.getProperties(), ...source.getProperties() };
+  for (const key of deletedKeys) delete merged[key];
+  target.setProperties(merged);
   copyExtraState(target, source, sourceComplete);
 }
-async function saveViaFreshHandle(module, editing, source, targetPath, sourceComplete) {
+async function saveViaFreshHandle(module, editing, source, targetPath, sourceComplete, deletedKeys = /* @__PURE__ */ new Set()) {
   const rawFullHandle = module.createFileHandle();
   const fullFileHandle = module.isWasi ? rawFullHandle : wrapEmbindHandle(rawFullHandle);
   try {
@@ -1741,7 +1769,7 @@ async function saveViaFreshHandle(module, editing, source, targetPath, sourceCom
         );
       }
     }
-    copyEditedState(fullFileHandle, editing, sourceComplete);
+    copyEditedState(fullFileHandle, editing, sourceComplete, deletedKeys);
     if (!fullFileHandle.save()) {
       throw new FileOperationError(
         "save",
@@ -1846,7 +1874,8 @@ var init_audio_file_impl = __esm({
             this.handle,
             this.originalSource,
             targetPath,
-            false
+            false,
+            this.partialDeletedPropertyKeys()
           );
           this.isPartiallyLoaded = false;
           this.originalSource = void 0;
@@ -1964,6 +1993,21 @@ var init_audio_file_impl = __esm({
           counter: r.counter ?? 0
         })));
       }
+      getLyrics() {
+        return this.handle.getLyrics().map((l) => {
+          const out = { text: l.text };
+          if (l.description) out.description = l.description;
+          if (l.language) out.language = l.language;
+          return out;
+        });
+      }
+      setLyrics(lyrics) {
+        this.handle.setLyrics(lyrics.map((l) => ({
+          text: l.text,
+          description: l.description ?? "",
+          language: l.language ?? ""
+        })));
+      }
       getRating() {
         const ratings = this.getRatings();
         return ratings.length > 0 ? ratings[0].rating : void 0;
@@ -2026,6 +2070,24 @@ function parseNumeric(value) {
   const parsed = Number.parseInt(value, 10);
   return Number.isNaN(parsed) ? void 0 : parsed;
 }
+function readExtendedTag(audioFile) {
+  const tag = mapPropertiesToExtendedTag(audioFile.properties());
+  const pictures = audioFile.getPictures();
+  if (pictures.length > 0) tag.pictures = pictures;
+  const ratings = audioFile.getRatings();
+  if (ratings.length > 0) tag.ratings = ratings;
+  const lyrics = audioFile.getLyrics();
+  if (lyrics.length > 0) tag.lyrics = lyrics;
+  const chapters = audioFile.getChapters();
+  if (chapters.length > 0) tag.chapters = chapters;
+  const bext = audioFile.getBext();
+  if (bext !== void 0) tag.bext = bext;
+  const bextData = audioFile.getBextData();
+  if (bextData !== void 0) tag.bextData = bextData;
+  const ixml = audioFile.getIxml();
+  if (ixml !== void 0) tag.ixml = ixml;
+  return tag;
+}
 function mapPropertiesToExtendedTag(props) {
   const tag = {};
   for (const [propKey, tagField] of Object.entries(BASIC_PROPERTY_KEYS)) {
@@ -2137,7 +2199,7 @@ var VERSION;
 var init_version = __esm({
   "src/version.ts"() {
     "use strict";
-    VERSION = "1.3.0";
+    VERSION = "1.4.0";
   }
 });
 
@@ -2486,10 +2548,7 @@ async function withAudioFileSaveToFile(file, fn) {
 
 // src/simple/tag-operations.ts
 async function readTags(file) {
-  return withAudioFile(
-    file,
-    (audioFile) => mapPropertiesToExtendedTag(audioFile.properties())
-  );
+  return withAudioFile(file, (audioFile) => readExtendedTag(audioFile));
 }
 async function applyTags(file, tags) {
   return withAudioFileSave(file, (audioFile) => {
@@ -2547,8 +2606,15 @@ async function readFormat(file) {
 }
 async function clearTags(file) {
   return withAudioFileSave(file, (audioFile) => {
-    audioFile.setProperties({});
+    const cleared = {};
+    for (const key of Object.keys(audioFile.properties())) cleared[key] = [];
+    audioFile.setProperties(cleared);
     audioFile.removePictures();
+    audioFile.setLyrics([]);
+    audioFile.setRatings([]);
+    if (audioFile.getChapters().length > 0) audioFile.setChapters([]);
+    if (audioFile.getBextData() !== void 0) audioFile.setBextData(null);
+    if (audioFile.getIxml() !== void 0) audioFile.setIxml(null);
   });
 }
 
@@ -2660,7 +2726,7 @@ async function readTagsBatch(files, options = {}) {
   return executeBatch(
     files,
     options,
-    (audioFile) => mapPropertiesToExtendedTag(audioFile.properties())
+    (audioFile) => readExtendedTag(audioFile)
   );
 }
 async function readPropertiesBatch(files, options = {}) {
@@ -2709,7 +2775,7 @@ async function readMetadata(file) {
       );
     }
     return {
-      tags: mapPropertiesToExtendedTag(audioFile.properties()),
+      tags: readExtendedTag(audioFile),
       properties: audioFile.audioProperties(),
       hasCoverArt: audioFile.getPictures().length > 0,
       dynamics: extractDynamics(audioFile)
@@ -2720,7 +2786,7 @@ async function readMetadata(file) {
 }
 async function readMetadataBatch(files, options = {}) {
   return executeBatch(files, options, (audioFile) => ({
-    tags: mapPropertiesToExtendedTag(audioFile.properties()),
+    tags: readExtendedTag(audioFile),
     properties: audioFile.audioProperties(),
     hasCoverArt: audioFile.getPictures().length > 0,
     dynamics: extractDynamics(audioFile)

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

@@ -12,6 +12,7 @@ import {
 } from "./wasm-io.js";
 const AUDIO_KEYS = /* @__PURE__ */ new Set([
   "bitrate",
+  "bitrateMode",
   "bitsPerSample",
   "channels",
   "codec",
@@ -59,6 +60,12 @@ 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;
+}
 class WasiFileHandle {
   constructor(wasiModule) {
     __publicField(this, "wasi");
@@ -219,22 +226,25 @@ class WasiFileHandle {
   }
   setProperties(props) {
     this.checkNotDestroyed();
-    const mapped = {};
+    const next = { ...this.tagData };
     for (const [key, values] of Object.entries(props)) {
       const camelKey = fromTagLibKey(key);
       const storeKey = NUMERIC_FIELD_ALIASES[camelKey] ?? camelKey;
-      if (storeKey === "track") {
+      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)) mapped[storeKey] = parsed;
+        if (!Number.isNaN(parsed)) next[storeKey] = parsed;
       } else if (camelKey === "date") {
-        mapped.date = values;
+        next.date = values;
         const year = Number.parseInt(values[0] ?? "", 10);
-        if (!Number.isNaN(year)) mapped.year = year;
+        if (!Number.isNaN(year)) next.year = year;
       } else {
-        mapped[camelKey] = values;
+        next[camelKey] = values;
       }
     }
-    this.tagData = { ...this.tagData, ...mapped };
+    this.tagData = next;
   }
   getProperty(key) {
     this.checkNotDestroyed();
@@ -273,16 +283,16 @@ class WasiFileHandle {
   }
   getMP4Item(key) {
     this.checkNotDestroyed();
-    return this.getProperty(key);
+    return this.getProperty(mp4ItemPropertyKey(key));
   }
   setMP4Item(key, value) {
     this.checkNotDestroyed();
-    this.setProperty(key, value);
+    this.setProperty(mp4ItemPropertyKey(key), value);
   }
   removeMP4Item(key) {
     this.checkNotDestroyed();
     if (this.tagData) {
-      const mappedKey = fromTagLibKey(key);
+      const mappedKey = fromTagLibKey(mp4ItemPropertyKey(key));
       const storeKey = NUMERIC_FIELD_ALIASES[mappedKey] ?? mappedKey;
       delete this.tagData[storeKey];
     }

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

@@ -1,6 +1,6 @@
 import { isNamedAudioInput } from "../types/audio-formats.js";
 import { InvalidFormatError } from "../errors.js";
-import { mapPropertiesToExtendedTag } from "../utils/tag-mapping.js";
+import { readExtendedTag } from "../utils/tag-mapping.js";
 import { getTagLib } from "./config.js";
 async function executeBatch(files, options, processor) {
   if (files.length === 0) return { items: [], duration: 0 };
@@ -48,7 +48,7 @@ async function readTagsBatch(files, options = {}) {
   return executeBatch(
     files,
     options,
-    (audioFile) => mapPropertiesToExtendedTag(audioFile.properties())
+    (audioFile) => readExtendedTag(audioFile)
   );
 }
 async function readPropertiesBatch(files, options = {}) {
@@ -97,7 +97,7 @@ async function readMetadata(file) {
       );
     }
     return {
-      tags: mapPropertiesToExtendedTag(audioFile.properties()),
+      tags: readExtendedTag(audioFile),
       properties: audioFile.audioProperties(),
       hasCoverArt: audioFile.getPictures().length > 0,
       dynamics: extractDynamics(audioFile)
@@ -108,7 +108,7 @@ async function readMetadata(file) {
 }
 async function readMetadataBatch(files, options = {}) {
   return executeBatch(files, options, (audioFile) => ({
-    tags: mapPropertiesToExtendedTag(audioFile.properties()),
+    tags: readExtendedTag(audioFile),
     properties: audioFile.audioProperties(),
     hasCoverArt: audioFile.getPictures().length > 0,
     dynamics: extractDynamics(audioFile)

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

@@ -1 +1 @@
-{"version":3,"file":"tag-operations.d.ts","sourceRoot":"","sources":["../../../src/simple/tag-operations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EACf,WAAW,EACX,QAAQ,EACR,QAAQ,EACT,MAAM,aAAa,CAAC;AAcrB;;;;;;;GAOG;AACH,wBAAsB,QAAQ,CAC5B,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,WAAW,CAAC,CAKtB;AAED;;;;;;;;;GASG;AACH,wBAAsB,SAAS,CAC7B,IAAI,EAAE,cAAc,EACpB,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC,GACtB,OAAO,CAAC,UAAU,CAAC,CAIrB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC,GACtB,OAAO,CAAC,IAAI,CAAC,CAWf;AAED;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,eAAe,CAAC,CAY1B;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,OAAO,CAAC,CAYlB;AAED;;;;;;GAMG;AACH,wBAAsB,UAAU,CAC9B,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC,CAW/B;AAED;;;;;;;;GAQG;AACH,wBAAsB,SAAS,CAC7B,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,UAAU,CAAC,CAKrB"}
+{"version":3,"file":"tag-operations.d.ts","sourceRoot":"","sources":["../../../src/simple/tag-operations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EACf,WAAW,EACX,QAAQ,EAER,QAAQ,EACT,MAAM,aAAa,CAAC;AAWrB;;;;;;;GAOG;AACH,wBAAsB,QAAQ,CAC5B,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,WAAW,CAAC,CAEtB;AAED;;;;;;;;;GASG;AACH,wBAAsB,SAAS,CAC7B,IAAI,EAAE,cAAc,EACpB,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC,GACtB,OAAO,CAAC,UAAU,CAAC,CAIrB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC,GACtB,OAAO,CAAC,IAAI,CAAC,CAWf;AAED;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,eAAe,CAAC,CAY1B;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,OAAO,CAAC,CAYlB;AAED;;;;;;GAMG;AACH,wBAAsB,UAAU,CAC9B,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC,CAW/B;AAED;;;;;;;;GAQG;AACH,wBAAsB,SAAS,CAC7B,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,UAAU,CAAC,CAsBrB"}

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

@@ -1,8 +1,5 @@
 import { FileOperationError, MetadataError } from "../errors.js";
-import {
-  mapPropertiesToExtendedTag,
-  mergeTagUpdates
-} from "../utils/tag-mapping.js";
+import { mergeTagUpdates, readExtendedTag } from "../utils/tag-mapping.js";
 import { getTagLib } from "./config.js";
 import {
   withAudioFile,
@@ -10,10 +7,7 @@ import {
   withAudioFileSaveToFile
 } from "./with-audio-file.js";
 async function readTags(file) {
-  return withAudioFile(
-    file,
-    (audioFile) => mapPropertiesToExtendedTag(audioFile.properties())
-  );
+  return withAudioFile(file, (audioFile) => readExtendedTag(audioFile));
 }
 async function applyTags(file, tags) {
   return withAudioFileSave(file, (audioFile) => {
@@ -71,8 +65,15 @@ async function readFormat(file) {
 }
 async function clearTags(file) {
   return withAudioFileSave(file, (audioFile) => {
-    audioFile.setProperties({});
+    const cleared = {};
+    for (const key of Object.keys(audioFile.properties())) cleared[key] = [];
+    audioFile.setProperties(cleared);
     audioFile.removePictures();
+    audioFile.setLyrics([]);
+    audioFile.setRatings([]);
+    if (audioFile.getChapters().length > 0) audioFile.setChapters([]);
+    if (audioFile.getBextData() !== void 0) audioFile.setBextData(null);
+    if (audioFile.getIxml() !== void 0) audioFile.setIxml(null);
   });
 }
 export {

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

@@ -16,7 +16,17 @@ export declare abstract class BaseAudioFileImpl {
     protected originalSource?: string | Uint8Array | ArrayBuffer | File;
     protected isPartiallyLoaded: boolean;
     protected readonly partialLoadOptions?: OpenOptions;
+    /** Text-property wire keys in the partial header at load; undefined if full. */
+    protected readonly partialKeysAtLoad?: ReadonlySet<string>;
     constructor(module: TagLibModule, fileHandle: FileHandle, sourcePath?: string, originalSource?: string | Uint8Array | ArrayBuffer | File, isPartiallyLoaded?: boolean, partialLoadOptions?: OpenOptions);
+    /**
+     * Wire-key text properties present in the partial header at load but now
+     * absent — the user deleted them. The partial-load reconstruct subtracts these
+     * from its preserve-the-original merge so a deletion persists without wiping
+     * frames beyond the loaded header (taglib-d14). Lyrics are excluded (they ride
+     * their own reconstruct path); empty for a full load.
+     */
+    protected partialDeletedPropertyKeys(): ReadonlySet<string>;
     protected get handle(): FileHandle;
     getFormat(): FileType;
     isFormat<F extends FileType>(format: F): this is TypedAudioFile<F>;

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;AAEhE;;;;;GAKG;AACH,8BAAsB,iBAAiB;IASnC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,YAAY;IARzC,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;gBAG/B,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;IASlC,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;IAIzB,aAAa,CAAC,UAAU,EAAE,WAAW,GAAG,IAAI;IAQ5C,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;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"}