taglib-wasm 1.7.0 → 1.7.1

package/dist/index.browser.js

@@ -2730,7 +2730,7 @@ var VERSION;
 var init_version = __esm({
   "src/version.ts"() {
     "use strict";
-    VERSION = "1.7.0";
+    VERSION = "1.7.1";
   }
 });
 

package/dist/simple.browser.js

@@ -2662,7 +2662,7 @@ var VERSION;
 var init_version = __esm({
   "src/version.ts"() {
     "use strict";
-    VERSION = "1.7.0";
+    VERSION = "1.7.1";
   }
 });
 

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

@@ -92,5 +92,31 @@ export interface GroupAlbumsOptions {
      * scanned root). scanForAlbums always passes the folder path it scanned. */
     scanRoot?: string;
 }
+/** The standalone disc-folder recognizer result. */
+export interface DiscFolderInfo {
+    /** Which grammar form matched. */
+    kind: "exact" | "embedded" | "volume" | "bonus" | "bare";
+    /** True when corroboration is required (title-word markers like "Tape 4",
+     * side letters like "CD D", bonus, bare). */
+    gated: boolean;
+    /** Disc number; undefined for side letters, bonus, and bare letters. */
+    number: number | undefined;
+    /** "of N" total from "CD 1 of 2". */
+    total: number | undefined;
+    /** Title text before an embedded marker ("Album (Disc 1)" -> "Album"). */
+    title: string | undefined;
+    /** Trailing text after the number ("Bonus Tracks" from "Disc 2 (Bonus Tracks)"). */
+    discTitle: string | undefined;
+    /** Base confidence tier; sibling corroboration may upgrade embedded to
+     * "high" inside groupAlbums. Gated names stay "low" even corroborated. */
+    confidence: DiscConfidence;
+}
+/**
+ * Recognize a directory name as a disc folder. Standalone — it only
+ * classifies the name; it does not resolve the folder to its parent (use
+ * the album result's per-file `albumDir` for that). Returns undefined for
+ * non-disc names. Plain "Bonus" and "Extras" are never discs by name.
+ */
+export declare function discFolderInfo(name: string): DiscFolderInfo | undefined;
 export declare function groupAlbums(result: FolderScanResult, options?: GroupAlbumsOptions): AlbumGroupingResult;
 //# sourceMappingURL=group-albums.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"group-albums.d.ts","sourceRoot":"","sources":["../../../src/folder-api/group-albums.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAOtE,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG;IAAE,OAAO,EAAE,eAAe,CAAA;CAAE,CAAC;AAElE,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAEvD,2DAA2D;AAC3D,MAAM,WAAW,cAAe,SAAQ,iBAAiB;IACvD;kEAC8D;IAC9D,QAAQ,EAAE,MAAM,CAAC;IACjB;qDACiD;IACjD,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;CAChC;AAED,MAAM,WAAW,SAAS;IACxB,6EAA6E;IAC7E,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,4FAA4F;IAC5F,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,+EAA+E;IAC/E,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,mFAAmF;IACnF,eAAe,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,4FAA4F;IAC5F,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,4EAA4E;IAC5E,UAAU,EAAE,cAAc,CAAC;IAC3B,2EAA2E;IAC3E,KAAK,EAAE,cAAc,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,UAAU;IACzB,8EAA8E;IAC9E,GAAG,EAAE,aAAa,CAAC;IACnB,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,0CAA0C;IAC1C,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC1B;;sEAEkE;IAClE,WAAW,EAAE,OAAO,GAAG,SAAS,CAAC;IACjC;sEACkE;IAClE,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,6EAA6E;IAC7E,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,uEAAuE;IACvE,KAAK,EAAE,cAAc,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB;yDACqD;IACrD,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,mFAAmF;IACnF,SAAS,EAAE,iBAAiB,EAAE,CAAC;IAC/B,wEAAwE;IACxE,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAE,CAAC,CAAC;CAC/C;AAED,MAAM,WAAW,kBAAkB;IACjC,6EAA6E;IAC7E,mBAAmB,CAAC,EAAE,cAAc,CAAC;IACrC,oEAAoE;IACpE,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,gEAAgE;IAChE,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;;gFAI4E;IAC5E,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AA4SD,wBAAgB,WAAW,CACzB,MAAM,EAAE,gBAAgB,EACxB,OAAO,GAAE,kBAAuB,GAC/B,mBAAmB,CAwcrB"}
+{"version":3,"file":"group-albums.d.ts","sourceRoot":"","sources":["../../../src/folder-api/group-albums.ts"],"names":[],"mappings":"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"}

package/dist/src/folder-api/group-albums.js

@@ -1,9 +1,22 @@
 import { basename } from "../utils/path.js";
+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)
+  };
+}
 function dirname(path) {
   const i = Math.max(path.lastIndexOf("/"), path.lastIndexOf("\\"));
   return i === -1 ? path : path.slice(0, i);
 }
-const MARKERS = [
+const UNCONDITIONAL_MARKERS = [
   "cd",
   "disc",
   "disk",
@@ -11,13 +24,11 @@ const MARKERS = [
   "sacd",
   "blu-ray",
   "bd",
-  "vinyl",
-  "lp",
-  "record",
-  "cassette",
-  "tape",
   "digital media"
 ];
+const GATED_MARKERS = ["tape", "vinyl", "cassette", "lp", "record"];
+const MARKERS = [...UNCONDITIONAL_MARKERS, ...GATED_MARKERS];
+const GATED_MARKER_SET = new Set(GATED_MARKERS);
 const WORD_NUMBERS = {
   one: 1,
   two: 2,
@@ -60,7 +71,7 @@ function parseNumberToken(token) {
   return Number.isFinite(roman) ? roman : void 0;
 }
 const SEP = String.raw`[\s._#-]*`;
-const NUM = String.raw`(?:\d+|[ivxlcdm]+|one|two|three|four|five|six|seven|eight|nine|ten|eleven|twelve)`;
+const NUM = String.raw`(?:\d+|[ivxlcdm]+|one|two|three|four|five|six|seven|eight|nine|ten|eleven|twelve|[a-z])`;
 function parseDiscName(name) {
   const trimmed = name.trim();
   if (/^(?:extras?|bonus)$/i.test(trimmed)) return void 0;
@@ -70,8 +81,10 @@ function parseDiscName(name) {
     const re = new RegExp(left + String.raw`(${esc})${SEP}(${NUM})`, "i");
     const m = trimmed.match(re);
     if (!m) continue;
-    const number = parseNumberToken(m[2]);
-    if (number === void 0) continue;
+    const sideLetter = /^[a-z]$/i.test(m[2]);
+    const number = sideLetter ? void 0 : parseNumberToken(m[2]);
+    if (number === void 0 && !sideLetter) continue;
+    const isGated = GATED_MARKER_SET.has(marker.toLowerCase()) || sideLetter;
     const markerStart = m.index + m[1].length - marker.length;
     const rawPrefix = trimmed.slice(0, markerStart).trim();
     const title = rawPrefix.replace(/[()[\]]/g, "").replace(/[\s._#-]+$/, "") || void 0;
@@ -82,10 +95,13 @@ function parseDiscName(name) {
     const total = ofMatch ? parseInt(ofMatch[1], 10) : void 0;
     return {
       kind: isExact ? "exact" : "embedded",
-      number,
+      number: sideLetter ? void 0 : number,
       total,
       title,
-      discTitle
+      discTitle,
+      gated: isGated,
+      sideLetter,
+      digit: /^\d+$/.test(m[2])
     };
   }
   const volume = trimmed.match(
@@ -97,7 +113,10 @@ function parseDiscName(name) {
       number: parseInt(volume[1], 10),
       total: volume[2] ? parseInt(volume[2], 10) : void 0,
       title: void 0,
-      discTitle: void 0
+      discTitle: void 0,
+      gated: false,
+      sideLetter: false,
+      digit: true
     };
   }
   if (/^bonus\s+disc$/i.test(trimmed)) {
@@ -106,7 +125,10 @@ function parseDiscName(name) {
       number: void 0,
       total: void 0,
       title: void 0,
-      discTitle: void 0
+      discTitle: void 0,
+      gated: true,
+      sideLetter: false,
+      digit: false
     };
   }
   if (/^(?:\d+|v\d+|p\d+|[ab])$/i.test(trimmed)) {
@@ -115,7 +137,10 @@ function parseDiscName(name) {
       number: /^\d+$/i.test(trimmed) ? parseInt(trimmed, 10) : void 0,
       total: void 0,
       title: void 0,
-      discTitle: void 0
+      discTitle: void 0,
+      gated: true,
+      sideLetter: false,
+      digit: false
     };
   }
   return void 0;
@@ -123,7 +148,7 @@ function parseDiscName(name) {
 function baseConfidence(parse) {
   switch (parse.kind) {
     case "exact":
-      return typeof parse.number === "number" && /^\d+$/.test(String(parse.number)) ? "high" : "low";
+      return parse.digit ? "high" : "low";
     case "embedded":
       return "medium";
     case "volume":
@@ -134,16 +159,23 @@ function baseConfidence(parse) {
   }
 }
 function corroborated(parse, siblings) {
-  if (parse.kind === "exact") return true;
+  if (!parse.gated && parse.kind === "exact") return true;
   if (siblings.length === 0) return false;
   const siblingParses = siblings.map((s) => parseDiscName(basename(s))).filter((p) => p !== void 0);
-  const hasExactSibling = siblingParses.some((p) => p.kind === "exact");
+  const hasExactSibling = siblingParses.some(
+    (p) => !p.gated && p.kind === "exact"
+  );
   const hasNumberedSibling = siblingParses.some(
     (p) => p.number !== void 0
   );
   if (parse.number !== void 0 && hasNumberedSibling) return true;
-  if (parse.kind === "embedded" && hasExactSibling) return true;
-  if (parse.kind === "volume" && hasNumberedSibling) return true;
+  if (!parse.gated && parse.kind === "embedded" && hasExactSibling) return true;
+  if (!parse.gated && parse.kind === "volume" && hasNumberedSibling) {
+    return true;
+  }
+  if (parse.sideLetter) {
+    return siblingParses.some((p) => p.sideLetter);
+  }
   if (parse.kind === "bonus" || parse.kind === "bare") {
     const numberedCount = siblingParses.filter((p) => p.number !== void 0).length;
     if (numberedCount >= 2) return true;
@@ -207,8 +239,10 @@ function groupAlbums(result, options = {}) {
       (d) => d !== dir && dirname(d) === dirname(dir)
     );
     const corroboratedBySiblings = corroborated(parse, siblings);
-    let confidence = baseConfidence(parse);
-    if (parse.kind === "bonus" || parse.kind === "bare") {
+    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";
@@ -501,5 +535,6 @@ function groupAlbums(result, options = {}) {
   return { albums: albumsOut, singles, unmatched, errors };
 }
 export {
+  discFolderInfo,
   groupAlbums
 };

package/dist/src/folder-api/index.d.ts

@@ -5,6 +5,6 @@
 export type { AudioDynamics, AudioFileMetadata, DuplicateGroup, FolderScanItem, FolderScanOptions, FolderScanResult, FolderUpdateItem, FolderUpdateResult, } from "./types.js";
 export { scanFolder } from "./scan-operations.js";
 export { exportFolderMetadata, findDuplicates, updateFolderTags, } from "./folder-operations.js";
-export { type AlbumDisc, type AlbumGroup, type AlbumGroupingResult, type AlbumGroupItem, type AlbumGroupKey, type DiscConfidence, groupAlbums, type GroupAlbumsOptions, } from "./group-albums.js";
+export { type AlbumDisc, type AlbumGroup, type AlbumGroupingResult, type AlbumGroupItem, type AlbumGroupKey, type DiscConfidence, type DiscFolderInfo, discFolderInfo, groupAlbums, type GroupAlbumsOptions, } from "./group-albums.js";
 export { scanForAlbums, type ScanForAlbumsOptions } from "./scan-for-albums.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/src/folder-api/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/folder-api/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,YAAY,EACV,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElD,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,gBAAgB,GACjB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,WAAW,EACX,KAAK,kBAAkB,GACxB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/folder-api/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,YAAY,EACV,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElD,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,gBAAgB,GACjB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,cAAc,EACd,WAAW,EACX,KAAK,kBAAkB,GACxB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/src/folder-api/index.js

@@ -5,10 +5,12 @@ import {
   updateFolderTags
 } from "./folder-operations.js";
 import {
+  discFolderInfo,
   groupAlbums
 } from "./group-albums.js";
 import { scanForAlbums } from "./scan-for-albums.js";
 export {
+  discFolderInfo,
   exportFolderMetadata,
   findDuplicates,
   groupAlbums,

package/dist/src/version.d.ts

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

package/dist/src/version.js

@@ -1,4 +1,4 @@
-const VERSION = "1.7.0";
+const VERSION = "1.7.1";
 export {
   VERSION
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "taglib-wasm",
-  "version": "1.7.0",
+  "version": "1.7.1",
   "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",