taglib-wasm 2.2.1 → 2.2.3

package/LICENSE

@@ -42,7 +42,7 @@ The WebAssembly binaries are subject to LGPL requirements. This means:
 To rebuild the WebAssembly binaries with a modified TagLib:
 1. Modify the TagLib source in lib/taglib/
 2. Run: npm run build:wasm  (builds both backends; requires the
-   Emscripten SDK and WASI SDK 33 — see CONTRIBUTING.md)
+   Emscripten SDK and WASI SDK 34 — see CONTRIBUTING.md)
 3. The new binaries will be in build/taglib-web.wasm and
    build/taglib-wasi.wasm
 

package/README.md

@@ -386,7 +386,7 @@ import { readProperties } from "taglib-wasm/simple";
 const props = await readProperties("song.m4a");
 
 console.log(props.containerFormat); // "MP4" (container format)
-console.log(props.codec); // "AAC" or "ALAC" (compressed media format)
+console.log(props.codec); // "AAC", "ALAC", "AC-3", … (compressed media format)
 console.log(props.isLossless); // false for AAC, true for ALAC
 console.log(props.bitsPerSample); // 16 for most formats
 console.log(props.bitrate); // 256 (kbps)
@@ -407,7 +407,7 @@ Container format vs Codec:
 
 Supported formats:
 
-- **MP4 container** (.mp4, .m4a) – Can contain AAC (lossy) or ALAC (lossless)
+- **MP4 container** (.mp4, .m4a) – Can contain AAC, ALAC, AC-3, E-AC-3, DTS, FLAC, or Opus
 - **OGG container** (.ogg) – Can contain Vorbis, Opus, FLAC, or Speex
 - **MP3** – Both container and codec (lossy)
 - **FLAC** – Both container and codec (lossless)
@@ -444,9 +444,11 @@ Supported formats:
 `taglib-wasm` is designed to support all formats supported by TagLib:
 
 - **.mp3** – ID3v2 and ID3v1 tags
+- **.aac** – ADTS / raw AAC streams (ID3v2 metadata, read through the MPEG reader)
 - **.m4a/.mp4** – MPEG-4/AAC metadata for AAC and Apple Lossless audio
 - **.flac** – Vorbis comments and audio properties (plus BWF `bext`/iXML)
-- **.ogg** – Ogg Vorbis format with full metadata support
+- **.ogg** – Ogg container: Vorbis with full metadata support, plus FLAC-in-Ogg
+  and Speex
 - **.wav** – INFO chunk metadata, plus BWF `bext` and iXML
 - **Additional formats** – Opus, APE, MPC, WavPack, TrueAudio, AIFF, WMA, and
   more

package/dist/disc-folder.d.ts

@@ -14,6 +14,8 @@
  * discFolderInfo("CD1"); // { kind: "exact", number: 1, ... }
  * ```
  */
-export * from "./src/folder-api/group-albums.js";
+export { discFolderInfo } from "./src/folder-api/folder-disc.js";
+export { groupAlbums } from "./src/folder-api/album-grouping.js";
+export type { AlbumDisc, AlbumGroup, AlbumGroupingResult, AlbumGroupItem, AlbumGroupKey, DiscConfidence, DiscFolderInfo, GroupAlbumsOptions, } from "./src/folder-api/album-types.js";
 export type { FolderScanResult } from "./src/folder-api/types.js";
 //# sourceMappingURL=disc-folder.d.ts.map

package/dist/disc-folder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"disc-folder.d.ts","sourceRoot":"","sources":["../disc-folder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,cAAc,kCAAkC,CAAC;AACjD,YAAY,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"disc-folder.d.ts","sourceRoot":"","sources":["../disc-folder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AACjE,YAAY,EACV,SAAS,EACT,UAAU,EACV,mBAAmB,EACnB,cAAc,EACd,aAAa,EACb,cAAc,EACd,cAAc,EACd,kBAAkB,GACnB,MAAM,iCAAiC,CAAC;AACzC,YAAY,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/disc-folder.js

@@ -1,23 +1,4 @@
-// src/utils/path.ts
-function basename(path) {
-  const i = Math.max(path.lastIndexOf("/"), path.lastIndexOf("\\"));
-  return i === -1 ? path : path.slice(i + 1);
-}
-
-// src/folder-api/group-albums.ts
-function discFolderInfo(name) {
-  const parse = parseDiscName(name);
-  if (!parse) return void 0;
-  return {
-    kind: parse.kind,
-    gated: parse.gated,
-    number: parse.number,
-    total: parse.total,
-    title: parse.title,
-    discTitle: parse.discTitle,
-    confidence: parse.gated ? "low" : baseConfidence(parse)
-  };
-}
+// src/folder-api/folder-disc.ts
 function dirname(path) {
   const i = Math.max(path.lastIndexOf("/"), path.lastIndexOf("\\"));
   return i === -1 ? path : path.slice(0, i);
@@ -168,6 +149,32 @@ function baseConfidence(parse) {
       return "low";
   }
 }
+function discFolderInfo(name) {
+  const parse = parseDiscName(name);
+  if (!parse) return void 0;
+  return {
+    kind: parse.kind,
+    gated: parse.gated,
+    number: parse.number,
+    total: parse.total,
+    title: parse.title,
+    discTitle: parse.discTitle,
+    confidence: parse.gated ? "low" : baseConfidence(parse)
+  };
+}
+
+// src/utils/path.ts
+function basename(path) {
+  const i = Math.max(path.lastIndexOf("/"), path.lastIndexOf("\\"));
+  return i === -1 ? path : path.slice(i + 1);
+}
+
+// src/folder-api/album-corroborate.ts
+var CONFIDENCE_RANK = {
+  low: 0,
+  medium: 1,
+  high: 2
+};
 function corroborated(parse, siblings) {
   if (!parse.gated && parse.kind === "exact") return true;
   if (siblings.length === 0) return false;
@@ -193,13 +200,8 @@ function corroborated(parse, siblings) {
   }
   return false;
 }
-function flatPrefix(filename) {
-  const separated = filename.match(/^(\d{1,2})[\s._-](\d{1,2})/);
-  if (separated) return { disc: parseInt(separated[1], 10), form: "separated" };
-  const compact = filename.match(/^(\d)(\d{2})(?:\D|$)/);
-  if (compact) return { disc: parseInt(compact[1], 10), form: "compact" };
-  return void 0;
-}
+
+// src/folder-api/album-identity.ts
 function normalizeKey(s) {
   return s.trim().toLowerCase().replace(/\s+/g, " ");
 }
@@ -208,134 +210,63 @@ function isGenericAlbumArtist(albumArtist) {
   const n = normalizeKey(albumArtist);
   return n === "various artists" || n === "va";
 }
-var CONFIDENCE_RANK = {
-  low: 0,
-  medium: 1,
-  high: 2
-};
-function groupAlbums(result, options = {}) {
-  const minRank = CONFIDENCE_RANK[options.minFolderConfidence ?? "low"];
-  const useFlatPrefixes = options.flatDiscPrefixes ?? true;
-  const useFolderFallback = options.folderFallback ?? true;
-  const okItems = [];
-  const errors = [];
-  for (const item of result.items) {
-    if (item.status === "ok") {
-      okItems.push({ path: item.path, tags: item.tags, metadata: item });
-    } else {
-      errors.push({ path: item.path, error: item.error });
-    }
-  }
-  if (okItems.length === 0) {
-    return { albums: [], singles: [], unmatched: [], errors };
+function evidenceFor(item, confirmedDiscs, flatSubdivisions2) {
+  const dir = dirname(item.path);
+  const own = confirmedDiscs.get(dir);
+  if (own) {
+    return {
+      folderDiscNumber: own.parse.number,
+      total: own.parse.total,
+      folderDiscTitle: own.parse.discTitle,
+      confidence: own.confidence,
+      albumDir: dirname(dir)
+    };
   }
-  const scanRoot = options.scanRoot;
-  const tree = /* @__PURE__ */ new Map();
-  for (const item of okItems) {
-    const dir = dirname(item.path);
-    let node = tree.get(dir);
-    if (!node) {
-      node = { files: [], parent: dirname(dir) };
-      tree.set(dir, node);
+  let cursor = dirname(dir);
+  while (cursor !== void 0) {
+    const entry = confirmedDiscs.get(cursor);
+    if (entry) {
+      return {
+        folderDiscNumber: entry.parse.number,
+        total: entry.parse.total,
+        folderDiscTitle: entry.parse.discTitle,
+        confidence: entry.confidence,
+        albumDir: dirname(cursor)
+      };
     }
-    node.files.push(item);
+    const parent = dirname(cursor);
+    if (parent === cursor) break;
+    cursor = parent;
   }
-  const confirmedDiscs = /* @__PURE__ */ new Map();
-  for (const [dir, node] of tree) {
-    if (node.files.length === 0) continue;
-    const parse = parseDiscName(basename(dir));
-    if (!parse) continue;
-    const siblings = [...tree.keys()].filter(
-      (d) => d !== dir && dirname(d) === dirname(dir)
-    );
-    const corroboratedBySiblings = corroborated(parse, siblings);
-    let confidence = parse.gated ? "low" : baseConfidence(parse);
-    if (parse.gated) {
-      if (!corroboratedBySiblings) continue;
-    } else if (parse.kind === "bonus" || parse.kind === "bare") {
-      if (!corroboratedBySiblings) continue;
-    } else if (corroboratedBySiblings) {
-      confidence = "high";
-    }
-    if (CONFIDENCE_RANK[confidence] < minRank) continue;
-    confirmedDiscs.set(dir, { parse, confidence });
+  const flat = flatSubdivisions2.get(dir)?.get(item.path);
+  if (flat !== void 0) {
+    return {
+      folderDiscNumber: flat,
+      total: void 0,
+      folderDiscTitle: void 0,
+      confidence: "medium",
+      albumDir: dir
+    };
   }
-  const flatSubdivisions = /* @__PURE__ */ new Map();
-  if (useFlatPrefixes) {
-    for (const [dir, node] of tree) {
-      if (node.files.length === 0 || confirmedDiscs.has(dir)) continue;
-      const byFile = /* @__PURE__ */ new Map();
-      const forms = /* @__PURE__ */ new Set();
-      for (const item of node.files) {
-        const prefix = flatPrefix(basename(item.path));
-        if (prefix) {
-          byFile.set(item.path, prefix.disc);
-          forms.add(prefix.form);
-        }
-      }
-      if (byFile.size < 2) continue;
-      const distinct = [...new Set(byFile.values())].sort((a, b) => a - b);
-      const allCompact = forms.size === 1 && forms.has("compact");
-      const plausible = allCompact ? distinct.every((d) => d >= 1 && d <= distinct.length) : true;
-      if (plausible) flatSubdivisions.set(dir, byFile);
-    }
+  return void 0;
+}
+function folderIdentity(dir, confirmedDiscs, scanRoot) {
+  const own = confirmedDiscs.get(dir);
+  if (!own) {
+    const title2 = basename(dir);
+    return title2 ? { title: title2, titleSource: dir } : void 0;
+  }
+  if (own.parse.title !== void 0) {
+    return { title: own.parse.title, titleSource: dirname(dir) };
   }
+  const source = dirname(dir);
+  if (source === scanRoot || source === dir) return void 0;
+  const title = basename(source);
+  return title ? { title, titleSource: source } : void 0;
+}
+function buildAlbumIdentity(okItems, confirmedDiscs, flatSubdivisions2, options) {
   const albums = /* @__PURE__ */ new Map();
   const unmatched = [];
-  const evidenceFor = (item) => {
-    const dir = dirname(item.path);
-    const own = confirmedDiscs.get(dir);
-    if (own) {
-      return {
-        folderDiscNumber: own.parse.number,
-        total: own.parse.total,
-        folderDiscTitle: own.parse.discTitle,
-        confidence: own.confidence,
-        albumDir: dirname(dir)
-      };
-    }
-    let cursor = dirname(dir);
-    while (cursor !== void 0) {
-      const entry = confirmedDiscs.get(cursor);
-      if (entry) {
-        return {
-          folderDiscNumber: entry.parse.number,
-          total: entry.parse.total,
-          folderDiscTitle: entry.parse.discTitle,
-          confidence: entry.confidence,
-          albumDir: dirname(cursor)
-        };
-      }
-      const parent = dirname(cursor);
-      if (parent === cursor) break;
-      cursor = parent;
-    }
-    const flat = flatSubdivisions.get(dir)?.get(item.path);
-    if (flat !== void 0) {
-      return {
-        folderDiscNumber: flat,
-        total: void 0,
-        folderDiscTitle: void 0,
-        confidence: "medium",
-        albumDir: dir
-      };
-    }
-    return void 0;
-  };
-  const folderIdentity = (dir) => {
-    const own = confirmedDiscs.get(dir);
-    if (!own) {
-      const title2 = basename(dir);
-      return title2 ? { title: title2, titleSource: dir } : void 0;
-    }
-    if (own.parse.title !== void 0) {
-      return { title: own.parse.title, titleSource: dirname(dir) };
-    }
-    const source = dirname(dir);
-    if (source === scanRoot || source === dir) return void 0;
-    const title = basename(source);
-    return title ? { title, titleSource: source } : void 0;
-  };
   for (const item of okItems) {
     const dir = dirname(item.path);
     const albumTag = item.tags.album?.[0]?.trim();
@@ -356,7 +287,7 @@ function groupAlbums(result, options = {}) {
         };
         albums.set(key2, acc2);
       }
-      const evidence2 = evidenceFor(item);
+      const evidence2 = evidenceFor(item, confirmedDiscs, flatSubdivisions2);
       acc2.evidence.set(item.path, evidence2);
       acc2.items.push({
         ...item.metadata,
@@ -365,11 +296,11 @@ function groupAlbums(result, options = {}) {
       });
       continue;
     }
-    if (!useFolderFallback) {
+    if (!options.useFolderFallback) {
       unmatched.push(item.metadata);
       continue;
     }
-    const identity = folderIdentity(dir);
+    const identity = folderIdentity(dir, confirmedDiscs, options.scanRoot);
     if (!identity) {
       unmatched.push(item.metadata);
       continue;
@@ -388,7 +319,7 @@ function groupAlbums(result, options = {}) {
       };
       albums.set(key, acc);
     }
-    const evidence = evidenceFor(item);
+    const evidence = evidenceFor(item, confirmedDiscs, flatSubdivisions2);
     acc.evidence.set(item.path, evidence);
     acc.items.push({
       ...item.metadata,
@@ -415,6 +346,11 @@ function groupAlbums(result, options = {}) {
       break;
     }
   }
+  return { albums, unmatched };
+}
+
+// src/folder-api/album-discs.ts
+function assembleDiscs(albums) {
   const groups = [];
   for (const acc of albums.values()) {
     const dirTagCommon = /* @__PURE__ */ new Map();
@@ -530,6 +466,105 @@ function groupAlbums(result, options = {}) {
       items: sortedDiscs.flatMap((d) => d.items)
     });
   }
+  return groups;
+}
+
+// src/folder-api/album-grouping.ts
+function flatPrefix(filename) {
+  const separated = filename.match(/^(\d{1,2})[\s._-](\d{1,2})/);
+  if (separated) return { disc: parseInt(separated[1], 10), form: "separated" };
+  const compact = filename.match(/^(\d)(\d{2})(?:\D|$)/);
+  if (compact) return { disc: parseInt(compact[1], 10), form: "compact" };
+  return void 0;
+}
+function normalizeOk(result) {
+  const okItems = [];
+  const errors = [];
+  for (const item of result.items) {
+    if (item.status === "ok") {
+      okItems.push({ path: item.path, tags: item.tags, metadata: item });
+    } else {
+      errors.push({ path: item.path, error: item.error });
+    }
+  }
+  return { okItems, errors };
+}
+function buildTree(okItems) {
+  const tree = /* @__PURE__ */ new Map();
+  for (const item of okItems) {
+    const dir = dirname(item.path);
+    let node = tree.get(dir);
+    if (!node) {
+      node = { files: [], parent: dirname(dir) };
+      tree.set(dir, node);
+    }
+    node.files.push(item);
+  }
+  return tree;
+}
+function confirmDiscs(tree, minRank) {
+  const confirmedDiscs = /* @__PURE__ */ new Map();
+  for (const [dir, node] of tree) {
+    if (node.files.length === 0) continue;
+    const parse = parseDiscName(basename(dir));
+    if (!parse) continue;
+    const siblings = [...tree.keys()].filter(
+      (d) => d !== dir && dirname(d) === dirname(dir)
+    );
+    const corroboratedBySiblings = corroborated(parse, siblings);
+    let confidence = parse.gated ? "low" : baseConfidence(parse);
+    if (parse.gated) {
+      if (!corroboratedBySiblings) continue;
+    } else if (parse.kind === "bonus" || parse.kind === "bare") {
+      if (!corroboratedBySiblings) continue;
+    } else if (corroboratedBySiblings) {
+      confidence = "high";
+    }
+    if (CONFIDENCE_RANK[confidence] < minRank) continue;
+    confirmedDiscs.set(dir, { parse, confidence });
+  }
+  return confirmedDiscs;
+}
+function flatSubdivisions(tree, confirmedDiscs, useFlatPrefixes) {
+  const flat = /* @__PURE__ */ new Map();
+  if (!useFlatPrefixes) return flat;
+  for (const [dir, node] of tree) {
+    if (node.files.length === 0 || confirmedDiscs.has(dir)) continue;
+    const byFile = /* @__PURE__ */ new Map();
+    const forms = /* @__PURE__ */ new Set();
+    for (const item of node.files) {
+      const prefix = flatPrefix(basename(item.path));
+      if (prefix) {
+        byFile.set(item.path, prefix.disc);
+        forms.add(prefix.form);
+      }
+    }
+    if (byFile.size < 2) continue;
+    const distinct = [...new Set(byFile.values())].sort((a, b) => a - b);
+    const allCompact = forms.size === 1 && forms.has("compact");
+    const plausible = allCompact ? distinct.every((d) => d >= 1 && d <= distinct.length) : true;
+    if (plausible) flat.set(dir, byFile);
+  }
+  return flat;
+}
+function groupAlbums(result, options = {}) {
+  const minRank = CONFIDENCE_RANK[options.minFolderConfidence ?? "low"];
+  const useFlatPrefixes = options.flatDiscPrefixes ?? true;
+  const useFolderFallback = options.folderFallback ?? true;
+  const { okItems, errors } = normalizeOk(result);
+  if (okItems.length === 0) {
+    return { albums: [], singles: [], unmatched: [], errors };
+  }
+  const tree = buildTree(okItems);
+  const confirmedDiscs = confirmDiscs(tree, minRank);
+  const flat = flatSubdivisions(tree, confirmedDiscs, useFlatPrefixes);
+  const { albums, unmatched } = buildAlbumIdentity(
+    okItems,
+    confirmedDiscs,
+    flat,
+    { scanRoot: options.scanRoot, useFolderFallback }
+  );
+  const groups = assembleDiscs(albums);
   const albumsOut = [];
   const singles = [];
   for (const group of groups) {

package/dist/index.browser.js

@@ -574,8 +574,8 @@ var init_audio_file_bwf = __esm({
 
 // src/taglib/id3v2-frames.ts
 function assertMp3(format) {
-  if (format !== "MP3") {
-    throw new UnsupportedFormatError(format, ["MP3"], {
+  if (format !== "MP3" && format !== "AAC") {
+    throw new UnsupportedFormatError(format, ["MP3", "AAC"], {
       operation: "id3v2Frames"
     });
   }
@@ -1371,7 +1371,7 @@ var init_specialized_properties = __esm({
       },
       releaseType: {
         key: "RELEASETYPE",
-        description: "Release type (album, single, EP, compilation, ...). Multi-value (e.g. 'album' + 'EP'). TagLib 2.3.1 translates the RELEASETYPE key per format: ID3v2 TXXX 'MUSICBRAINZ ALBUM TYPE' (TagLib's description casing), MP4 freeform atom, APEv2 MUSICBRAINZ_ALBUMTYPE, ASF 'MusicBrainz/Album Type', Vorbis/Matroska raw RELEASETYPE",
+        description: "Release type (album, single, EP, compilation, ...). Multi-value (e.g. 'album' + 'EP'). TagLib 2.3.2 translates the RELEASETYPE key per format: ID3v2 TXXX 'MUSICBRAINZ ALBUM TYPE' (TagLib's description casing), MP4 freeform atom, APEv2 MUSICBRAINZ_ALBUMTYPE, ASF 'MusicBrainz/Album Type', Vorbis/Matroska raw RELEASETYPE",
         type: "string",
         supportedFormats: [
           "ID3v2",
@@ -1389,7 +1389,7 @@ var init_specialized_properties = __esm({
       },
       releaseCountry: {
         key: "RELEASECOUNTRY",
-        description: "Release country (ISO 3166-1 code, e.g. 'US'). TagLib 2.3.1 translates the RELEASECOUNTRY key per format: ID3v2 TXXX 'MUSICBRAINZ ALBUM RELEASE COUNTRY' (TagLib's description casing; an uppercase TXXX:RELEASECOUNTRY description also reads back), MP4 freeform atom 'MusicBrainz Album Release Country', APEv2 raw RELEASECOUNTRY, ASF 'MusicBrainz/Album Release Country', WAV ICNT, Vorbis/Matroska raw RELEASECOUNTRY",
+        description: "Release country (ISO 3166-1 code, e.g. 'US'). TagLib 2.3.2 translates the RELEASECOUNTRY key per format: ID3v2 TXXX 'MUSICBRAINZ ALBUM RELEASE COUNTRY' (TagLib's description casing; an uppercase TXXX:RELEASECOUNTRY description also reads back), MP4 freeform atom 'MusicBrainz Album Release Country', APEv2 raw RELEASECOUNTRY, ASF 'MusicBrainz/Album Release Country', WAV ICNT, Vorbis/Matroska raw RELEASECOUNTRY",
         type: "string",
         supportedFormats: [
           "ID3v2",
@@ -2121,7 +2121,10 @@ function wrapEmbindHandle(raw) {
         ...containerFormat === "MP4" || containerFormat === "ASF" ? { isEncrypted: pw.isEncrypted() } : {},
         ...formatVersion > 0 ? { formatVersion } : {},
         ...isValidBitrateMode(bitrateMode) ? { bitrateMode } : {},
-        ...codec === "Opus" ? { outputGainDb: pw.outputGainDb() } : {}
+        // OpusHead gain exists only in an Ogg Opus stream. Gating on codec
+        // alone fabricated outputGainDb: 0 for MP4 tracks once the MP4 codec
+        // enum was mapped (the WASI side never emitted it there) — taglib-kswf.
+        ...containerFormat === "OGG" && codec === "Opus" ? { outputGainDb: pw.outputGainDb() } : {}
       };
     }
   };
@@ -2437,8 +2440,8 @@ var init_audio_file_impl = __esm({
       }
       setChapters(chapters, options) {
         const fmt = this.getFormat();
-        if (fmt !== "MP3" && fmt !== "MP4") {
-          throw new UnsupportedFormatError(fmt, ["MP3", "MP4"], {
+        if (fmt !== "MP3" && fmt !== "AAC" && fmt !== "MP4") {
+          throw new UnsupportedFormatError(fmt, ["MP3", "AAC", "MP4"], {
             operation: "setChapters"
           });
         }
@@ -2944,6 +2947,8 @@ function normalizeTagInput(input) {
       if (val === "explicit") props.itunesAdvisory = ["1"];
       else if (val === "clean") props.itunesAdvisory = ["2"];
       else if (val === "unspecified") props.itunesAdvisory = [];
+    } else if (field === "bpm") {
+      props[field] = [String(Math.trunc(val))];
     } else if (NUMERIC_FIELDS.has(field)) {
       props[field] = [String(val)];
     } else if (field === "r128TrackGain" || field === "r128AlbumGain") {
@@ -3004,7 +3009,7 @@ var VERSION;
 var init_version = __esm({
   "src/version.ts"() {
     "use strict";
-    VERSION = "2.2.1";
+    VERSION = "2.2.3";
   }
 });
 
@@ -3701,9 +3706,11 @@ function propertyValue(props, key) {
 // src/web-utils/data-url.ts
 init_classes();
 function pictureToDataURL(picture) {
+  const data = picture.data;
+  const CHUNK = 32768;
   let binary = "";
-  for (const byte of picture.data) {
-    binary += String.fromCodePoint(byte);
+  for (let i = 0; i < data.length; i += CHUNK) {
+    binary += String.fromCharCode(...data.subarray(i, i + CHUNK));
   }
   const base64 = btoa(binary);
   return `data:${picture.mimeType};base64,${base64}`;

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 /**
  * @fileoverview Main module exports for TagLib-Wasm
  *
- * TagLib v2.3.1 compiled to WebAssembly with TypeScript bindings
+ * TagLib v2.3.2 compiled to WebAssembly with TypeScript bindings
  * for universal audio metadata handling across all JavaScript runtimes.
  *
  * @module TagLib-Wasm

package/dist/simple.browser.js

@@ -562,8 +562,8 @@ var init_audio_file_bwf = __esm({
 
 // src/taglib/id3v2-frames.ts
 function assertMp3(format) {
-  if (format !== "MP3") {
-    throw new UnsupportedFormatError(format, ["MP3"], {
+  if (format !== "MP3" && format !== "AAC") {
+    throw new UnsupportedFormatError(format, ["MP3", "AAC"], {
       operation: "id3v2Frames"
     });
   }
@@ -1303,7 +1303,7 @@ var init_specialized_properties = __esm({
       },
       releaseType: {
         key: "RELEASETYPE",
-        description: "Release type (album, single, EP, compilation, ...). Multi-value (e.g. 'album' + 'EP'). TagLib 2.3.1 translates the RELEASETYPE key per format: ID3v2 TXXX 'MUSICBRAINZ ALBUM TYPE' (TagLib's description casing), MP4 freeform atom, APEv2 MUSICBRAINZ_ALBUMTYPE, ASF 'MusicBrainz/Album Type', Vorbis/Matroska raw RELEASETYPE",
+        description: "Release type (album, single, EP, compilation, ...). Multi-value (e.g. 'album' + 'EP'). TagLib 2.3.2 translates the RELEASETYPE key per format: ID3v2 TXXX 'MUSICBRAINZ ALBUM TYPE' (TagLib's description casing), MP4 freeform atom, APEv2 MUSICBRAINZ_ALBUMTYPE, ASF 'MusicBrainz/Album Type', Vorbis/Matroska raw RELEASETYPE",
         type: "string",
         supportedFormats: [
           "ID3v2",
@@ -1321,7 +1321,7 @@ var init_specialized_properties = __esm({
       },
       releaseCountry: {
         key: "RELEASECOUNTRY",
-        description: "Release country (ISO 3166-1 code, e.g. 'US'). TagLib 2.3.1 translates the RELEASECOUNTRY key per format: ID3v2 TXXX 'MUSICBRAINZ ALBUM RELEASE COUNTRY' (TagLib's description casing; an uppercase TXXX:RELEASECOUNTRY description also reads back), MP4 freeform atom 'MusicBrainz Album Release Country', APEv2 raw RELEASECOUNTRY, ASF 'MusicBrainz/Album Release Country', WAV ICNT, Vorbis/Matroska raw RELEASECOUNTRY",
+        description: "Release country (ISO 3166-1 code, e.g. 'US'). TagLib 2.3.2 translates the RELEASECOUNTRY key per format: ID3v2 TXXX 'MUSICBRAINZ ALBUM RELEASE COUNTRY' (TagLib's description casing; an uppercase TXXX:RELEASECOUNTRY description also reads back), MP4 freeform atom 'MusicBrainz Album Release Country', APEv2 raw RELEASECOUNTRY, ASF 'MusicBrainz/Album Release Country', WAV ICNT, Vorbis/Matroska raw RELEASECOUNTRY",
         type: "string",
         supportedFormats: [
           "ID3v2",
@@ -2053,7 +2053,10 @@ function wrapEmbindHandle(raw) {
         ...containerFormat === "MP4" || containerFormat === "ASF" ? { isEncrypted: pw.isEncrypted() } : {},
         ...formatVersion > 0 ? { formatVersion } : {},
         ...isValidBitrateMode(bitrateMode) ? { bitrateMode } : {},
-        ...codec === "Opus" ? { outputGainDb: pw.outputGainDb() } : {}
+        // OpusHead gain exists only in an Ogg Opus stream. Gating on codec
+        // alone fabricated outputGainDb: 0 for MP4 tracks once the MP4 codec
+        // enum was mapped (the WASI side never emitted it there) — taglib-kswf.
+        ...containerFormat === "OGG" && codec === "Opus" ? { outputGainDb: pw.outputGainDb() } : {}
       };
     }
   };
@@ -2369,8 +2372,8 @@ var init_audio_file_impl = __esm({
       }
       setChapters(chapters, options) {
         const fmt = this.getFormat();
-        if (fmt !== "MP3" && fmt !== "MP4") {
-          throw new UnsupportedFormatError(fmt, ["MP3", "MP4"], {
+        if (fmt !== "MP3" && fmt !== "AAC" && fmt !== "MP4") {
+          throw new UnsupportedFormatError(fmt, ["MP3", "AAC", "MP4"], {
             operation: "setChapters"
           });
         }
@@ -2876,6 +2879,8 @@ function normalizeTagInput(input) {
       if (val === "explicit") props.itunesAdvisory = ["1"];
       else if (val === "clean") props.itunesAdvisory = ["2"];
       else if (val === "unspecified") props.itunesAdvisory = [];
+    } else if (field === "bpm") {
+      props[field] = [String(Math.trunc(val))];
     } else if (NUMERIC_FIELDS.has(field)) {
       props[field] = [String(val)];
     } else if (field === "r128TrackGain" || field === "r128AlbumGain") {
@@ -2936,7 +2941,7 @@ var VERSION;
 var init_version = __esm({
   "src/version.ts"() {
     "use strict";
-    VERSION = "2.2.1";
+    VERSION = "2.2.3";
   }
 });
 

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

@@ -299,7 +299,7 @@ export declare const PROPERTIES: {
     };
     readonly releaseType: {
         readonly key: "RELEASETYPE";
-        readonly description: "Release type (album, single, EP, compilation, ...). Multi-value (e.g. 'album' + 'EP'). TagLib 2.3.1 translates the RELEASETYPE key per format: ID3v2 TXXX 'MUSICBRAINZ ALBUM TYPE' (TagLib's description casing), MP4 freeform atom, APEv2 MUSICBRAINZ_ALBUMTYPE, ASF 'MusicBrainz/Album Type', Vorbis/Matroska raw RELEASETYPE";
+        readonly description: "Release type (album, single, EP, compilation, ...). Multi-value (e.g. 'album' + 'EP'). TagLib 2.3.2 translates the RELEASETYPE key per format: ID3v2 TXXX 'MUSICBRAINZ ALBUM TYPE' (TagLib's description casing), MP4 freeform atom, APEv2 MUSICBRAINZ_ALBUMTYPE, ASF 'MusicBrainz/Album Type', Vorbis/Matroska raw RELEASETYPE";
         readonly type: "string";
         readonly supportedFormats: readonly ["ID3v2", "MP4", "Vorbis", "APE", "ASF", "Matroska"];
         readonly mappings: {
@@ -313,7 +313,7 @@ export declare const PROPERTIES: {
     };
     readonly releaseCountry: {
         readonly key: "RELEASECOUNTRY";
-        readonly description: "Release country (ISO 3166-1 code, e.g. 'US'). TagLib 2.3.1 translates the RELEASECOUNTRY key per format: ID3v2 TXXX 'MUSICBRAINZ ALBUM RELEASE COUNTRY' (TagLib's description casing; an uppercase TXXX:RELEASECOUNTRY description also reads back), MP4 freeform atom 'MusicBrainz Album Release Country', APEv2 raw RELEASECOUNTRY, ASF 'MusicBrainz/Album Release Country', WAV ICNT, Vorbis/Matroska raw RELEASECOUNTRY";
+        readonly description: "Release country (ISO 3166-1 code, e.g. 'US'). TagLib 2.3.2 translates the RELEASECOUNTRY key per format: ID3v2 TXXX 'MUSICBRAINZ ALBUM RELEASE COUNTRY' (TagLib's description casing; an uppercase TXXX:RELEASECOUNTRY description also reads back), MP4 freeform atom 'MusicBrainz Album Release Country', APEv2 raw RELEASECOUNTRY, ASF 'MusicBrainz/Album Release Country', WAV ICNT, Vorbis/Matroska raw RELEASECOUNTRY";
         readonly type: "string";
         readonly supportedFormats: readonly ["ID3v2", "MP4", "Vorbis", "APE", "ASF", "Matroska", "WAV"];
         readonly mappings: {