taglib-wasm 2.2.1 → 2.2.3

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

@@ -0,0 +1,24 @@
+/**
+ * Disc-folder name recognition (pure grammar, taglib-ys7m split).
+ *
+ * Standalone recognizer: classifies a directory name as a disc folder and
+ * corroborates gated names against siblings. No Wasm, no I/O — this module
+ * is part of the disc-folder subpath's pure graph (taglib-cd7b).
+ */
+import type { DiscConfidence, DiscFolderInfo, DiscParse } from "./album-types.js";
+export declare function dirname(path: string): string;
+/**
+ * Parse a directory name as a disc folder. Returns undefined for non-disc
+ * names. Plain "Bonus" and "Extras" are NEVER discs by name (tuneup rule;
+ * the low-tier table's "Extras" row was the flagged divergence).
+ */
+export declare function parseDiscName(name: string): DiscParse | undefined;
+export declare function baseConfidence(parse: DiscParse): 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;
+//# sourceMappingURL=folder-disc.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"folder-disc.d.ts","sourceRoot":"","sources":["../../../src/folder-api/folder-disc.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,SAAS,EACV,MAAM,kBAAkB,CAAC;AAE1B,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG5C;AAyED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CA6GjE;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,GAAG,cAAc,CAa/D;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAYvE"}

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

@@ -0,0 +1,169 @@
+function dirname(path) {
+  const i = Math.max(path.lastIndexOf("/"), path.lastIndexOf("\\"));
+  return i === -1 ? path : path.slice(0, i);
+}
+const UNCONDITIONAL_MARKERS = [
+  "cd",
+  "disc",
+  "disk",
+  "dvd",
+  "sacd",
+  "blu-ray",
+  "bd",
+  "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,
+  three: 3,
+  four: 4,
+  five: 5,
+  six: 6,
+  seven: 7,
+  eight: 8,
+  nine: 9,
+  ten: 10,
+  eleven: 11,
+  twelve: 12
+};
+function romanToInt(s) {
+  const values = {
+    i: 1,
+    v: 5,
+    x: 10,
+    l: 50,
+    c: 100,
+    d: 500,
+    m: 1e3
+  };
+  let total = 0;
+  let prev = 0;
+  for (let i = s.length - 1; i >= 0; i--) {
+    const v = values[s[i]];
+    if (v === void 0) return NaN;
+    total += v < prev ? -v : v;
+    prev = v;
+  }
+  return total;
+}
+function parseNumberToken(token) {
+  if (/^\d+$/.test(token)) return parseInt(token, 10);
+  const word = WORD_NUMBERS[token.toLowerCase()];
+  if (word) return word;
+  const roman = romanToInt(token.toLowerCase());
+  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|[a-z])(?![a-z]))`;
+function parseDiscName(name) {
+  const trimmed = name.trim();
+  if (/^(?:extras?|bonus)$/i.test(trimmed)) return void 0;
+  for (const marker of MARKERS) {
+    const left = String.raw`(?:^|[^a-z0-9])`;
+    const esc = marker.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    const re = new RegExp(
+      left + String.raw`(${esc})(?![a-z])${SEP}(${NUM})`,
+      "i"
+    );
+    const m = trimmed.match(re);
+    if (!m) continue;
+    const sideLetter = /^[a-z]$/i.test(m[2]);
+    const number = sideLetter ? void 0 : parseNumberToken(m[2]);
+    if (number === void 0 && !sideLetter) continue;
+    if (!sideLetter && /^[ivxlcdm]{2,}$/i.test(m[2]) && (number ?? 0) > 100) 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;
+    const isExact = title === void 0;
+    const after = trimmed.slice(m.index + m[0].length).trim();
+    const discTitle = after.replace(/^[()[\],:;\-–—\s]+/, "").replace(/[)\]\[,:;\-–—\s]+$/, "").trim() || void 0;
+    const ofMatch = after.trim().match(/^of\s+(\d+)\b/i);
+    const total = ofMatch ? parseInt(ofMatch[1], 10) : void 0;
+    return {
+      kind: isExact ? "exact" : "embedded",
+      number: sideLetter ? void 0 : number,
+      total,
+      title,
+      discTitle,
+      gated: isGated,
+      sideLetter,
+      digit: /^\d+$/.test(m[2])
+    };
+  }
+  const volume = trimmed.match(
+    /^(?:volume|vol\.?|part|pt\.?)\s*(\d+)(?:\s*of\s*(\d+))?$/i
+  );
+  if (volume) {
+    return {
+      kind: "volume",
+      number: parseInt(volume[1], 10),
+      total: volume[2] ? parseInt(volume[2], 10) : void 0,
+      title: void 0,
+      discTitle: void 0,
+      gated: false,
+      sideLetter: false,
+      digit: true
+    };
+  }
+  if (/^bonus\s+disc$/i.test(trimmed)) {
+    return {
+      kind: "bonus",
+      number: void 0,
+      total: void 0,
+      title: void 0,
+      discTitle: void 0,
+      gated: true,
+      sideLetter: false,
+      digit: false
+    };
+  }
+  if (/^(?:\d+|v\d+|p\d+|[ab])$/i.test(trimmed)) {
+    return {
+      kind: "bare",
+      number: /^\d+$/i.test(trimmed) ? parseInt(trimmed, 10) : void 0,
+      total: void 0,
+      title: void 0,
+      discTitle: void 0,
+      gated: true,
+      sideLetter: false,
+      digit: false
+    };
+  }
+  return void 0;
+}
+function baseConfidence(parse) {
+  switch (parse.kind) {
+    case "exact":
+      return parse.digit ? "high" : "low";
+    case "embedded":
+      return "medium";
+    case "volume":
+      return "medium";
+    case "bonus":
+    case "bare":
+      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)
+  };
+}
+export {
+  baseConfidence,
+  dirname,
+  discFolderInfo,
+  parseDiscName
+};

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

@@ -5,6 +5,8 @@
 export type { AudioDynamics, AudioFileMetadata, DuplicateGroup, FolderScanItem, FolderScanOptions, FolderScanResult, } from "./types.js";
 export { scanFolder } from "./scan-operations.js";
 export { exportFolderMetadata, findDuplicates } from "./folder-operations.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 { type AlbumDisc, type AlbumGroup, type AlbumGroupingResult, type AlbumGroupItem, type AlbumGroupKey, type DiscConfidence, type DiscFolderInfo, type GroupAlbumsOptions, } from "./album-types.js";
+export { discFolderInfo } from "./folder-disc.js";
+export { groupAlbums } from "./album-grouping.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,GACjB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElD,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE9E,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"}
+{"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,GACjB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElD,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE9E,OAAO,EACL,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,kBAAkB,GACxB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElD,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,sBAAsB,CAAC"}

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

@@ -1,9 +1,7 @@
 import { scanFolder } from "./scan-operations.js";
 import { exportFolderMetadata, findDuplicates } from "./folder-operations.js";
-import {
-  discFolderInfo,
-  groupAlbums
-} from "./group-albums.js";
+import { discFolderInfo } from "./folder-disc.js";
+import { groupAlbums } from "./album-grouping.js";
 import { scanForAlbums } from "./scan-for-albums.js";
 export {
   discFolderInfo,

package/dist/src/folder-api/scan-for-albums.d.ts

@@ -4,7 +4,7 @@
  * and runtime-agnostic.
  */
 import type { FolderScanOptions } from "./types.js";
-import { type AlbumGroupingResult, type GroupAlbumsOptions } from "./group-albums.js";
+import type { AlbumGroupingResult, GroupAlbumsOptions } from "./album-types.js";
 export type ScanForAlbumsOptions = FolderScanOptions & GroupAlbumsOptions;
 /**
  * Scan a folder and group the result into albums with disc subdivisions.

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

@@ -1 +1 @@
-{"version":3,"file":"scan-for-albums.d.ts","sourceRoot":"","sources":["../../../src/folder-api/scan-for-albums.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,OAAO,EACL,KAAK,mBAAmB,EAExB,KAAK,kBAAkB,EACxB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,MAAM,oBAAoB,GAAG,iBAAiB,GAAG,kBAAkB,CAAC;AAE1E;;;;;;;;;GASG;AACH,wBAAsB,aAAa,CACjC,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,mBAAmB,CAAC,CAc9B"}
+{"version":3,"file":"scan-for-albums.d.ts","sourceRoot":"","sources":["../../../src/folder-api/scan-for-albums.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,OAAO,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAGhF,MAAM,MAAM,oBAAoB,GAAG,iBAAiB,GAAG,kBAAkB,CAAC;AAE1E;;;;;;;;;GASG;AACH,wBAAsB,aAAa,CACjC,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,mBAAmB,CAAC,CAc9B"}

package/dist/src/folder-api/scan-for-albums.js

@@ -1,7 +1,5 @@
 import { scanFolder } from "./scan-operations.js";
-import {
-  groupAlbums
-} from "./group-albums.js";
+import { groupAlbums } from "./album-grouping.js";
 async function scanForAlbums(folderPath, options = {}) {
   const {
     minFolderConfidence,

package/dist/src/runtime/detector.d.ts

@@ -7,6 +7,21 @@ export interface RuntimeDetectionResult {
     supportsStreaming: boolean;
     performanceTier: 1 | 2 | 3;
 }
+/**
+ * The pure per-environment backend configuration. `detectRuntime()` is the
+ * only sniffer in the codebase; every downstream decision (backend choice,
+ * PlatformIO creation, WASI availability) derives from this table so it can
+ * be exercised with synthetic environments instead of real runtimes
+ * (taglib-2b4).
+ */
+export interface EnvironmentProfile {
+    wasmType: WasmBinaryType;
+    supportsFilesystem: boolean;
+    supportsStreaming: boolean;
+    performanceTier: 1 | 2 | 3;
+}
+/** Pure environment -> backend configuration lookup (taglib-2b4). */
+export declare function environmentProfile(env: RuntimeEnvironment): EnvironmentProfile;
 /**
  * Check if a Node.js version meets the minimum requirement (v22.6.0+).
  * Returns an error message string if the version is too old, or undefined if OK.
@@ -22,5 +37,5 @@ export declare function detectRuntime(): RuntimeDetectionResult;
  */
 export declare function supportsExnref(): boolean;
 export declare function getEnvironmentDescription(env: RuntimeEnvironment): string;
-export declare function canLoadWasmType(wasmType: WasmBinaryType): boolean;
+export declare function canLoadWasmType(wasmType: WasmBinaryType, env?: RuntimeEnvironment): boolean;
 //# sourceMappingURL=detector.d.ts.map

package/dist/src/runtime/detector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"detector.d.ts","sourceRoot":"","sources":["../../../src/runtime/detector.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAC1B,WAAW,GACX,WAAW,GACX,UAAU,GACV,SAAS,GACT,iBAAiB,GACjB,QAAQ,GACR,YAAY,CAAC;AAEjB,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,YAAY,CAAC;AAEnD,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,kBAAkB,CAAC;IAChC,QAAQ,EAAE,cAAc,CAAC;IACzB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,eAAe,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;CAC5B;AAOD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,GAAG,SAAS,GAC9B,MAAM,GAAG,SAAS,CAepB;AAuCD,qFAAqF;AACrF,wBAAgB,MAAM,IAAI,OAAO,CAEhC;AAED,wBAAgB,aAAa,IAAI,sBAAsB,CA8EtD;AAWD;;;GAGG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAMxC;AAED,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,kBAAkB,GAAG,MAAM,CAmBzE;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAQjE"}
+{"version":3,"file":"detector.d.ts","sourceRoot":"","sources":["../../../src/runtime/detector.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAC1B,WAAW,GACX,WAAW,GACX,UAAU,GACV,SAAS,GACT,iBAAiB,GACjB,QAAQ,GACR,YAAY,CAAC;AAEjB,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,YAAY,CAAC;AAEnD,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,kBAAkB,CAAC;IAChC,QAAQ,EAAE,cAAc,CAAC;IACzB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,eAAe,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;CAC5B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,cAAc,CAAC;IACzB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,eAAe,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;CAC5B;AA+CD,qEAAqE;AACrE,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,kBAAkB,GACtB,kBAAkB,CAEpB;AAOD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,GAAG,SAAS,GAC9B,MAAM,GAAG,SAAS,CAepB;AAuCD,qFAAqF;AACrF,wBAAgB,MAAM,IAAI,OAAO,CAEhC;AAED,wBAAgB,aAAa,IAAI,sBAAsB,CAuCtD;AAWD;;;GAGG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAMxC;AAED,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,kBAAkB,GAAG,MAAM,CAmBzE;AAED,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,cAAc,EACxB,GAAG,GAAE,kBAAgD,GACpD,OAAO,CAKT"}

package/dist/src/runtime/detector.js

@@ -1,3 +1,50 @@
+const ENVIRONMENT_PROFILES = {
+  "deno-wasi": {
+    wasmType: "wasi",
+    supportsFilesystem: true,
+    supportsStreaming: true,
+    performanceTier: 1
+  },
+  "node-wasi": {
+    wasmType: "wasi",
+    supportsFilesystem: true,
+    supportsStreaming: true,
+    performanceTier: 1
+  },
+  "bun-wasi": {
+    wasmType: "wasi",
+    supportsFilesystem: true,
+    supportsStreaming: true,
+    performanceTier: 1
+  },
+  browser: {
+    wasmType: "emscripten",
+    supportsFilesystem: false,
+    supportsStreaming: true,
+    performanceTier: 2
+  },
+  worker: {
+    wasmType: "emscripten",
+    supportsFilesystem: false,
+    supportsStreaming: true,
+    performanceTier: 2
+  },
+  cloudflare: {
+    wasmType: "emscripten",
+    supportsFilesystem: false,
+    supportsStreaming: false,
+    performanceTier: 3
+  },
+  "node-emscripten": {
+    wasmType: "emscripten",
+    supportsFilesystem: true,
+    supportsStreaming: true,
+    performanceTier: 3
+  }
+};
+function environmentProfile(env) {
+  return ENVIRONMENT_PROFILES[env];
+}
 const g = globalThis;
 const MIN_NODE_MAJOR = 22;
 const MIN_NODE_MINOR = 6;
@@ -38,73 +85,32 @@ function isDeno() {
 }
 function detectRuntime() {
   if (isDeno() && hasWASISupport()) {
-    return {
-      environment: "deno-wasi",
-      wasmType: "wasi",
-      supportsFilesystem: true,
-      supportsStreaming: true,
-      performanceTier: 1
-    };
+    return { environment: "deno-wasi", ...environmentProfile("deno-wasi") };
   }
   if (isBun()) {
-    return {
-      environment: "bun-wasi",
-      wasmType: "wasi",
-      supportsFilesystem: true,
-      supportsStreaming: true,
-      performanceTier: 1
-    };
+    return { environment: "bun-wasi", ...environmentProfile("bun-wasi") };
   }
   if (isNode() && hasWASISupport()) {
-    return {
-      environment: "node-wasi",
-      wasmType: "wasi",
-      supportsFilesystem: true,
-      supportsStreaming: true,
-      performanceTier: 1
-    };
+    return { environment: "node-wasi", ...environmentProfile("node-wasi") };
   }
   if (isBrowser()) {
-    return {
-      environment: "browser",
-      wasmType: "emscripten",
-      supportsFilesystem: false,
-      supportsStreaming: true,
-      performanceTier: 2
-    };
+    return { environment: "browser", ...environmentProfile("browser") };
   }
   if (isWebWorker()) {
-    return {
-      environment: "worker",
-      wasmType: "emscripten",
-      supportsFilesystem: false,
-      supportsStreaming: true,
-      performanceTier: 2
-    };
+    return { environment: "worker", ...environmentProfile("worker") };
   }
   if (isCloudflareWorker()) {
-    return {
-      environment: "cloudflare",
-      wasmType: "emscripten",
-      supportsFilesystem: false,
-      supportsStreaming: false,
-      performanceTier: 3
-    };
+    return { environment: "cloudflare", ...environmentProfile("cloudflare") };
   }
   if (isNode()) {
     return {
       environment: "node-emscripten",
-      wasmType: "emscripten",
-      supportsFilesystem: true,
-      supportsStreaming: true,
-      performanceTier: 3
+      ...environmentProfile("node-emscripten")
     };
   }
   return {
     environment: "browser",
-    wasmType: "emscripten",
-    supportsFilesystem: false,
-    supportsStreaming: true,
+    ...environmentProfile("browser"),
     performanceTier: 3
   };
 }
@@ -158,10 +164,9 @@ function getEnvironmentDescription(env) {
       return "Unknown environment";
   }
 }
-function canLoadWasmType(wasmType) {
-  const result = detectRuntime();
+function canLoadWasmType(wasmType, env = detectRuntime().environment) {
   if (wasmType === "wasi") {
-    return result.environment === "deno-wasi" || result.environment === "node-wasi" || result.environment === "bun-wasi";
+    return environmentProfile(env).wasmType === "wasi";
   }
   return true;
 }
@@ -169,6 +174,7 @@ export {
   canLoadWasmType,
   checkNodeVersion,
   detectRuntime,
+  environmentProfile,
   getEnvironmentDescription,
   isDeno,
   supportsExnref

package/dist/src/runtime/platform-io.d.ts

@@ -1,3 +1,4 @@
+import { type RuntimeEnvironment } from "./detector.js";
 export type PlatformIO = {
     readFile(path: string): Promise<Uint8Array>;
     writeFile(path: string, data: Uint8Array): Promise<void>;
@@ -11,6 +12,13 @@ export type PlatformIO = {
     }>;
     readPartial?: (path: string, headerSize: number, footerSize: number) => Promise<Uint8Array>;
 };
+/**
+ * Pure environment -> PlatformIO selection (taglib-2b4): each environment's
+ * factory is chosen without sniffing, so the routing is testable with a
+ * synthetic environment. Factories are lazy — nothing touches the runtime
+ * until a method is called, so calling this under any runtime is safe.
+ */
+export declare function createPlatformIOFor(env: RuntimeEnvironment): PlatformIO;
 export declare function getPlatformIO(): PlatformIO;
 /** @internal */
 export declare function _setPlatformIOForTesting(io: PlatformIO): void;

package/dist/src/runtime/platform-io.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"platform-io.d.ts","sourceRoot":"","sources":["../../../src/runtime/platform-io.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,UAAU,GAAG;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAC5C,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzD,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC9C,OAAO,CACL,IAAI,EAAE,MAAM,GACX,cAAc,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAC3E,WAAW,CAAC,EAAE,CACZ,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,KACf,OAAO,CAAC,UAAU,CAAC,CAAC;CAC1B,CAAC;AA0LF,wBAAgB,aAAa,IAAI,UAAU,CAyB1C;AAED,gBAAgB;AAChB,wBAAgB,wBAAwB,CAAC,EAAE,EAAE,UAAU,GAAG,IAAI,CAE7D;AAED,gBAAgB;AAChB,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC"}
+{"version":3,"file":"platform-io.d.ts","sourceRoot":"","sources":["../../../src/runtime/platform-io.ts"],"names":[],"mappings":"AACA,OAAO,EAAiB,KAAK,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAEvE,MAAM,MAAM,UAAU,GAAG;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAC5C,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzD,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC9C,OAAO,CACL,IAAI,EAAE,MAAM,GACX,cAAc,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAC3E,WAAW,CAAC,EAAE,CACZ,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,KACf,OAAO,CAAC,UAAU,CAAC,CAAC;CAC1B,CAAC;AA0LF;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,kBAAkB,GAAG,UAAU,CAgBvE;AAED,wBAAgB,aAAa,IAAI,UAAU,CAM1C;AAED,gBAAgB;AAChB,wBAAgB,wBAAwB,CAAC,EAAE,EAAE,UAAU,GAAG,IAAI,CAE7D;AAED,gBAAgB;AAChB,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC"}

package/dist/src/runtime/platform-io.js

@@ -152,27 +152,26 @@ function createBunIO() {
     }
   };
 }
-function getPlatformIO() {
-  if (platformIO) return platformIO;
-  const runtime = detectRuntime();
-  switch (runtime.environment) {
+function createPlatformIOFor(env) {
+  switch (env) {
     case "deno-wasi":
-      platformIO = createDenoIO();
-      break;
+      return createDenoIO();
     case "bun-wasi":
-      platformIO = createBunIO();
-      break;
+      return createBunIO();
     case "node-wasi":
     case "node-emscripten":
-      platformIO = createNodeIO();
-      break;
+      return createNodeIO();
     default:
       throw new EnvironmentError(
-        runtime.environment,
+        env,
         "does not support filesystem operations",
         "filesystem access"
       );
   }
+}
+function getPlatformIO() {
+  if (platformIO) return platformIO;
+  platformIO = createPlatformIOFor(detectRuntime().environment);
   return platformIO;
 }
 function _setPlatformIOForTesting(io) {
@@ -184,5 +183,6 @@ function _resetPlatformIO() {
 export {
   _resetPlatformIO,
   _setPlatformIOForTesting,
+  createPlatformIOFor,
   getPlatformIO
 };

package/dist/src/runtime/unified-loader/module-selection.d.ts

@@ -1,6 +1,6 @@
 import { type RuntimeDetectionResult } from "../detector.js";
 import type { UnifiedLoaderOptions } from "./types.js";
 export declare function selectWasmType(runtime: RuntimeDetectionResult, options: UnifiedLoaderOptions): "wasi" | "emscripten";
-export declare function isWasiAvailable(): boolean;
-export declare function getRecommendedConfig(): UnifiedLoaderOptions;
+export declare function isWasiAvailable(runtime?: RuntimeDetectionResult): boolean;
+export declare function getRecommendedConfig(runtime?: RuntimeDetectionResult): UnifiedLoaderOptions;
 //# sourceMappingURL=module-selection.d.ts.map

package/dist/src/runtime/unified-loader/module-selection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"module-selection.d.ts","sourceRoot":"","sources":["../../../../src/runtime/unified-loader/module-selection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAC5E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD,wBAAgB,cAAc,CAC5B,OAAO,EAAE,sBAAsB,EAC/B,OAAO,EAAE,oBAAoB,GAC5B,MAAM,GAAG,YAAY,CAqBvB;AAED,wBAAgB,eAAe,IAAI,OAAO,CAGzC;AAED,wBAAgB,oBAAoB,IAAI,oBAAoB,CAoB3D"}
+{"version":3,"file":"module-selection.d.ts","sourceRoot":"","sources":["../../../../src/runtime/unified-loader/module-selection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAC5E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD,wBAAgB,cAAc,CAC5B,OAAO,EAAE,sBAAsB,EAC/B,OAAO,EAAE,oBAAoB,GAC5B,MAAM,GAAG,YAAY,CAqBvB;AAED,wBAAgB,eAAe,CAC7B,OAAO,GAAE,sBAAwC,GAChD,OAAO,CAET;AAED,wBAAgB,oBAAoB,CAClC,OAAO,GAAE,sBAAwC,GAChD,oBAAoB,CAqBtB"}

package/dist/src/runtime/unified-loader/module-selection.js

@@ -14,19 +14,17 @@ function selectWasmType(runtime, options) {
   }
   return "emscripten";
 }
-function isWasiAvailable() {
-  const runtime = detectRuntime();
+function isWasiAvailable(runtime = detectRuntime()) {
   return runtime.wasmType === "wasi" && runtime.supportsFilesystem;
 }
-function getRecommendedConfig() {
-  const runtime = detectRuntime();
+function getRecommendedConfig(runtime = detectRuntime()) {
   if (runtime.environment === "browser") {
     return {
       forceWasmType: "emscripten",
       disableOptimizations: false
     };
   }
-  if (runtime.supportsFilesystem) {
+  if (runtime.wasmType === "wasi" && runtime.supportsFilesystem) {
     return {
       forceWasmType: "wasi",
       disableOptimizations: false

package/dist/src/runtime/wasi-adapter/audio-properties.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Audio metrics and format detection over the WASI tag-data snapshot.
+ *
+ * Pure functions over (tagData, fileData): the WasiFileHandle wrappers add
+ * destruction guards and pass their fields. Extracted from file-handle.ts in
+ * the taglib-1dfc split.
+ */
+import type { AudioProperties } from "../../types.js";
+/** The audio-properties block of the C++ snapshot, null when absent. */
+export declare function getAudioProperties(tagData: Record<string, unknown> | null): AudioProperties | null;
+/** OGG codec sniffing: "OpusHead" in the first page payload, else OGG. */
+export declare function detectOggCodec(fileData: Uint8Array): string;
+/**
+ * Format detection: container-based first (works for path and buffer modes),
+ * magic-byte fallback for buffers.
+ */
+export declare function getFormat(tagData: Record<string, unknown> | null, fileData: Uint8Array | null): string;
+/** MP4 detection: containerFormat (path mode) or ftyp box (buffer mode). */
+export declare function isMP4(tagData: Record<string, unknown> | null, fileData: Uint8Array | null): boolean;
+//# sourceMappingURL=audio-properties.d.ts.map

package/dist/src/runtime/wasi-adapter/audio-properties.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-properties.d.ts","sourceRoot":"","sources":["../../../../src/runtime/wasi-adapter/audio-properties.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAEV,eAAe,EAEhB,MAAM,gBAAgB,CAAC;AAgBxB,wEAAwE;AACxE,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GACtC,eAAe,GAAG,IAAI,CA4BxB;AAED,0EAA0E;AAC1E,wBAAgB,cAAc,CAAC,QAAQ,EAAE,UAAU,GAAG,MAAM,CAe3D;AAED;;;GAGG;AACH,wBAAgB,SAAS,CACvB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,EACvC,QAAQ,EAAE,UAAU,GAAG,IAAI,GAC1B,MAAM,CAuDR;AAED,4EAA4E;AAC5E,wBAAgB,KAAK,CACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,EACvC,QAAQ,EAAE,UAAU,GAAG,IAAI,GAC1B,OAAO,CAYT"}