taglib-wasm 2.4.0 → 2.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (123) hide show
  1. package/LICENSE +0 -29
  2. package/NOTICE +35 -0
  3. package/README.md +42 -36
  4. package/dist/_virtual/{_@oxc-project_runtime@0.152.0 → _@oxc-project_runtime@0.154.0}/helpers/esm/assertClassBrand.js +1 -1
  5. package/dist/_virtual/{_@oxc-project_runtime@0.152.0 → _@oxc-project_runtime@0.154.0}/helpers/esm/checkPrivateRedeclaration.js +1 -1
  6. package/dist/_virtual/{_@oxc-project_runtime@0.152.0 → _@oxc-project_runtime@0.154.0}/helpers/esm/classPrivateFieldGet2.js +1 -1
  7. package/dist/_virtual/{_@oxc-project_runtime@0.152.0 → _@oxc-project_runtime@0.154.0}/helpers/esm/classPrivateFieldInitSpec.js +1 -1
  8. package/dist/_virtual/{_@oxc-project_runtime@0.152.0 → _@oxc-project_runtime@0.154.0}/helpers/esm/classPrivateFieldSet2.js +1 -1
  9. package/dist/_virtual/{_@oxc-project_runtime@0.152.0 → _@oxc-project_runtime@0.154.0}/helpers/esm/defineProperty.js +1 -1
  10. package/dist/_virtual/{_@oxc-project_runtime@0.152.0 → _@oxc-project_runtime@0.154.0}/helpers/esm/toPrimitive.js +1 -1
  11. package/dist/_virtual/{_@oxc-project_runtime@0.152.0 → _@oxc-project_runtime@0.154.0}/helpers/esm/toPropertyKey.js +1 -1
  12. package/dist/_virtual/{_@oxc-project_runtime@0.152.0 → _@oxc-project_runtime@0.154.0}/helpers/esm/typeof.js +1 -1
  13. package/dist/_virtual/{_@oxc-project_runtime@0.152.0 → _@oxc-project_runtime@0.154.0}/helpers/esm/usingCtx.js +1 -1
  14. package/dist/bwf/bext.d.ts.map +1 -1
  15. package/dist/bwf/bext.js +25 -16
  16. package/dist/constants/complex-properties.d.ts.map +1 -1
  17. package/dist/constants/general-extended-properties.d.ts +2 -1
  18. package/dist/constants/general-extended-properties.d.ts.map +1 -1
  19. package/dist/constants/general-extended-properties.js +5 -2
  20. package/dist/constants/properties.js +4 -2
  21. package/dist/constants/specialized-properties.d.ts +14 -0
  22. package/dist/constants/specialized-properties.d.ts.map +1 -1
  23. package/dist/constants/specialized-properties.js +21 -0
  24. package/dist/disc-folder.js +79 -45
  25. package/dist/folder-api/album-corroborate.d.ts.map +1 -1
  26. package/dist/folder-api/album-corroborate.js +25 -11
  27. package/dist/folder-api/album-discs.d.ts.map +1 -1
  28. package/dist/folder-api/album-discs.js +2 -5
  29. package/dist/folder-api/album-grouping.d.ts.map +1 -1
  30. package/dist/folder-api/album-grouping.js +27 -15
  31. package/dist/folder-api/album-identity.js +1 -1
  32. package/dist/folder-api/folder-disc.d.ts.map +1 -1
  33. package/dist/folder-api/folder-disc.js +24 -13
  34. package/dist/index.browser.d.ts +1 -1
  35. package/dist/index.browser.d.ts.map +1 -1
  36. package/dist/index.browser.js +2 -4453
  37. package/dist/index.d.ts +1 -1
  38. package/dist/index.d.ts.map +1 -1
  39. package/dist/msgpack/encoder.d.ts.map +1 -1
  40. package/dist/msgpack/encoder.js +3 -1
  41. package/dist/rating.js +1 -2
  42. package/dist/runtime/module-loader.d.ts.map +1 -1
  43. package/dist/runtime/module-loader.js +43 -33
  44. package/dist/runtime/platform-io.d.ts.map +1 -1
  45. package/dist/runtime/platform-io.js +4 -2
  46. package/dist/runtime/unified-loader/module-loading.d.ts.map +1 -1
  47. package/dist/runtime/unified-loader/module-loading.js +3 -2
  48. package/dist/runtime/wasi-adapter/adapter.js +1 -1
  49. package/dist/runtime/wasi-adapter/audio-properties.d.ts.map +1 -1
  50. package/dist/runtime/wasi-adapter/audio-properties.js +8 -2
  51. package/dist/runtime/wasi-adapter/file-handle.d.ts +3 -1
  52. package/dist/runtime/wasi-adapter/file-handle.d.ts.map +1 -1
  53. package/dist/runtime/wasi-adapter/file-handle.js +17 -5
  54. package/dist/runtime/wasi-adapter/handle-state.d.ts.map +1 -1
  55. package/dist/runtime/wasi-adapter/handle-state.js +7 -1
  56. package/dist/runtime/wasi-adapter/index.js +1 -2
  57. package/dist/runtime/wasi-adapter/mp4-items.d.ts +24 -0
  58. package/dist/runtime/wasi-adapter/mp4-items.d.ts.map +1 -1
  59. package/dist/runtime/wasi-adapter/mp4-items.js +119 -2
  60. package/dist/runtime/wasi-adapter/property-surface.d.ts.map +1 -1
  61. package/dist/runtime/wasi-adapter/property-surface.js +15 -6
  62. package/dist/runtime/wasi-adapter/structured-fields.js +1 -1
  63. package/dist/runtime/wasi-adapter/tag-keys.d.ts.map +1 -1
  64. package/dist/runtime/wasi-adapter/tag-keys.js +3 -1
  65. package/dist/runtime/wasi-adapter/wasm-io.d.ts.map +1 -1
  66. package/dist/runtime/wasi-adapter/wasm-io.js +1 -1
  67. package/dist/runtime/wasi-memory.js +3 -3
  68. package/dist/simple/batch-operations.d.ts.map +1 -1
  69. package/dist/simple/batch-operations.js +5 -1
  70. package/dist/simple/picture-operations.d.ts +6 -0
  71. package/dist/simple/picture-operations.d.ts.map +1 -1
  72. package/dist/simple/picture-operations.js +6 -0
  73. package/dist/simple/tag-operations.d.ts +7 -0
  74. package/dist/simple/tag-operations.d.ts.map +1 -1
  75. package/dist/simple/tag-operations.js +7 -0
  76. package/dist/simple/with-audio-file.d.ts.map +1 -1
  77. package/dist/simple/with-audio-file.js +2 -1
  78. package/dist/simple.browser.js +2 -3670
  79. package/dist/taglib/audio-file-base.d.ts +35 -1
  80. package/dist/taglib/audio-file-base.d.ts.map +1 -1
  81. package/dist/taglib/audio-file-base.js +91 -21
  82. package/dist/taglib/audio-file-checksum.d.ts.map +1 -1
  83. package/dist/taglib/audio-file-checksum.js +17 -13
  84. package/dist/taglib/audio-file-impl.d.ts.map +1 -1
  85. package/dist/taglib/audio-file-impl.js +1 -1
  86. package/dist/taglib/audio-file-interface.d.ts +18 -1
  87. package/dist/taglib/audio-file-interface.d.ts.map +1 -1
  88. package/dist/taglib/embind-adapter.d.ts +3 -0
  89. package/dist/taglib/embind-adapter.d.ts.map +1 -1
  90. package/dist/taglib/embind-adapter.js +6 -0
  91. package/dist/taglib/extra-state-registry.d.ts.map +1 -1
  92. package/dist/taglib/extra-state-registry.js +15 -0
  93. package/dist/taglib/load-audio-data.d.ts +11 -8
  94. package/dist/taglib/load-audio-data.d.ts.map +1 -1
  95. package/dist/taglib/load-audio-data.js +39 -43
  96. package/dist/taglib/metadata-extent.d.ts.map +1 -1
  97. package/dist/taglib/metadata-extent.js +59 -32
  98. package/dist/taglib/mutable-tag-impl.d.ts.map +1 -1
  99. package/dist/taglib/mutable-tag-impl.js +72 -69
  100. package/dist/taglib/taglib-class.d.ts.map +1 -1
  101. package/dist/taglib/taglib-class.js +16 -6
  102. package/dist/taglib-wasi.wasm +0 -0
  103. package/dist/taglib-web.wasm +0 -0
  104. package/dist/taglib-wrapper.js +1 -1
  105. package/dist/types/metadata-mappings.d.ts.map +1 -1
  106. package/dist/types/metadata-mappings.js +8 -0
  107. package/dist/types/tags.d.ts +48 -0
  108. package/dist/types/tags.d.ts.map +1 -1
  109. package/dist/utils/mp4-freeform.d.ts +20 -0
  110. package/dist/utils/mp4-freeform.d.ts.map +1 -0
  111. package/dist/utils/mp4-freeform.js +111 -0
  112. package/dist/utils/path.d.ts.map +1 -1
  113. package/dist/utils/path.js +3 -1
  114. package/dist/utils/tag-mapping.d.ts.map +1 -1
  115. package/dist/utils/tag-mapping.js +30 -18
  116. package/dist/version.d.ts +1 -1
  117. package/dist/version.js +1 -1
  118. package/dist/wasm.d.ts +3 -0
  119. package/dist/wasm.d.ts.map +1 -1
  120. package/dist/web-utils/data-url.js +1 -1
  121. package/dist/web.browser.js +2 -3388
  122. package/legal/COPYING.LGPL +502 -0
  123. package/package.json +17 -10
@@ -1,5 +1,5 @@
1
1
  import type { TagLibModule, WasmFileHandle } from "../wasm.js";
2
- import type { AudioProperties, FileType, OpenOptions, PropertyMap } from "../types.js";
2
+ import type { AudioProperties, FileType, MP4FreeformItem, OpenOptions, PropertyMap } from "../types.js";
3
3
  import type { MutableTag } from "./mutable-tag.js";
4
4
  import type { TypedAudioFile } from "./audio-file-interface.js";
5
5
  /**
@@ -36,6 +36,38 @@ export declare abstract class BaseAudioFileImpl {
36
36
  setProperties(properties: PropertyMap): void;
37
37
  getProperty(key: string): string[] | undefined;
38
38
  setProperty(key: string, value: string): void;
39
+ /**
40
+ * An empty total is a clear, not an "n/" value. Route it through the map so
41
+ * the int-pair fold never sees a one-element [""] list (Emscripten appended
42
+ * the empty string and produced "3/"; WASI dropped it).
43
+ */
44
+ private clearTotal;
45
+ /**
46
+ * A bare number write on an int-pair field keeps an existing total, matching
47
+ * tag().setTrack() and applyTags({track}) (taglib-eq3). A raw "n/total" and
48
+ * an empty clear still win. Emscripten folds the total eagerly, so without
49
+ * this, setting the total before the number lost it where WASI's save-time
50
+ * fold kept it.
51
+ */
52
+ private preserveIntPairTotal;
53
+ /**
54
+ * Write a property backed by an exact-case MP4 freeform atom.
55
+ *
56
+ * Clearing contract (taglib-qyw2): an empty value must REMOVE the item. The
57
+ * PropertyMap erase pass computes freeform item names from the property table
58
+ * (upper-cased "ITUNNORM") and misses the restored exact-case atom on disk
59
+ * (taglib-bnhl), so the exact name is queued through the deletion directive
60
+ * (taglib-65nm) — consumed by the WASI shim before apply_propmap, applied
61
+ * immediately by the Embind proxy. What the propmap itself carries then
62
+ * differs per backend:
63
+ * - WASI (merge model): [wireKey]: [] — the merge DELETES the key from
64
+ * tagData (absent keys are untouched), so the wire no longer carries the
65
+ * value that would re-create the atom.
66
+ * - Embind (replace model): the key must be ABSENT from the map — an
67
+ * empty-list entry would re-create the item in setProperties' write pass
68
+ * after the directive removed it.
69
+ */
70
+ private writeMp4FreeformProperty;
39
71
  /**
40
72
  * The empty-string clearing contract, named (taglib-qyw2): both backends
41
73
  * remove the property when the written value is empty, and setProperty's
@@ -46,6 +78,8 @@ export declare abstract class BaseAudioFileImpl {
46
78
  getMP4Item(key: string): string | undefined;
47
79
  setMP4Item(key: string, value: string): void;
48
80
  removeMP4Item(key: string): void;
81
+ getMP4FreeformItems(): MP4FreeformItem[];
82
+ setMP4FreeformItems(items: readonly MP4FreeformItem[]): void;
49
83
  isValid(): boolean;
50
84
  dispose(): void;
51
85
  [Symbol.dispose](): void;
@@ -1 +1 @@
1
- {"version":3,"file":"audio-file-base.d.ts","sourceRoot":"","sources":["../../src/taglib/audio-file-base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC/D,OAAO,KAAK,EACV,eAAe,EACf,QAAQ,EACR,WAAW,EACX,WAAW,EACZ,MAAM,aAAa,CAAC;AASrB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAiBhE;;;;;GAKG;AACH,8BAAsB,iBAAiB;IAgBnC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,YAAY;IAfzC,SAAS,CAAC,UAAU,EAAE,cAAc,GAAG,IAAI,CAAC;IAC5C,SAAS,CAAC,qBAAqB,EAAE,eAAe,GAAG,IAAI,CAAQ;IAC/D,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAClD,SAAS,CAAC,cAAc,EACpB,MAAM,GACN,UAAU,GACV,WAAW,GACX,IAAI,GACJ,SAAS,CAAC;IACd,SAAS,CAAC,iBAAiB,EAAE,OAAO,CAAS;IAC7C,SAAS,CAAC,QAAQ,CAAC,kBAAkB,EAAE,WAAW,GAAG,SAAS,CAAC;IAC/D,gFAAgF;IAChF,SAAS,CAAC,QAAQ,CAAC,iBAAiB,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;gBAGjD,MAAM,EAAE,YAAY,EACvC,UAAU,EAAE,cAAc,EAC1B,UAAU,CAAC,EAAE,MAAM,EACnB,cAAc,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,WAAW,GAAG,IAAI,EACzD,iBAAiB,GAAE,OAAe,EAClC,kBAAkB,CAAC,EAAE,WAAW;IAgBlC;;;;;;OAMG;IACH,SAAS,CAAC,0BAA0B,IAAI,WAAW,CAAC,MAAM,CAAC;IAU3D,SAAS,KAAK,MAAM,IAAI,cAAc,CAKrC;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;IAIjB,eAAe,IAAI,eAAe,GAAG,SAAS;IAO9C,UAAU,IAAI,WAAW;IAMzB,aAAa,CAAC,UAAU,EAAE,WAAW,GAAG,IAAI;IA4B5C,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS;IA6B9C,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAkD7C;;;;OAIG;IACH,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIjC,KAAK,IAAI,OAAO;IAIhB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAgB3C,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAoB5C,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAOhC,OAAO,IAAI,OAAO;IAIlB,OAAO,IAAI,IAAI;IASf,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI;CAGzB"}
1
+ {"version":3,"file":"audio-file-base.d.ts","sourceRoot":"","sources":["../../src/taglib/audio-file-base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC/D,OAAO,KAAK,EACV,eAAe,EACf,QAAQ,EACR,eAAe,EACf,WAAW,EACX,WAAW,EACZ,MAAM,aAAa,CAAC;AAcrB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAiBhE;;;;;GAKG;AACH,8BAAsB,iBAAiB;IAgBnC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,YAAY;IAfzC,SAAS,CAAC,UAAU,EAAE,cAAc,GAAG,IAAI,CAAC;IAC5C,SAAS,CAAC,qBAAqB,EAAE,eAAe,GAAG,IAAI,CAAQ;IAC/D,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAClD,SAAS,CAAC,cAAc,EACpB,MAAM,GACN,UAAU,GACV,WAAW,GACX,IAAI,GACJ,SAAS,CAAC;IACd,SAAS,CAAC,iBAAiB,EAAE,OAAO,CAAS;IAC7C,SAAS,CAAC,QAAQ,CAAC,kBAAkB,EAAE,WAAW,GAAG,SAAS,CAAC;IAC/D,gFAAgF;IAChF,SAAS,CAAC,QAAQ,CAAC,iBAAiB,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;gBAGjD,MAAM,EAAE,YAAY,EACvC,UAAU,EAAE,cAAc,EAC1B,UAAU,CAAC,EAAE,MAAM,EACnB,cAAc,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,WAAW,GAAG,IAAI,EACzD,iBAAiB,GAAE,OAAe,EAClC,kBAAkB,CAAC,EAAE,WAAW;IAgBlC;;;;;;OAMG;IACH,SAAS,CAAC,0BAA0B,IAAI,WAAW,CAAC,MAAM,CAAC;IAU3D,SAAS,KAAK,MAAM,IAAI,cAAc,CAKrC;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;IAIjB,eAAe,IAAI,eAAe,GAAG,SAAS;IAK9C,UAAU,IAAI,WAAW;IAMzB,aAAa,CAAC,UAAU,EAAE,WAAW,GAAG,IAAI;IAuC5C,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS;IA6B9C,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAqB7C;;;;OAIG;IACH,OAAO,CAAC,UAAU;IAOlB;;;;;;OAMG;IACH,OAAO,CAAC,oBAAoB;IAa5B;;;;;;;;;;;;;;;;OAgBG;IACH,OAAO,CAAC,wBAAwB;IA2BhC;;;;OAIG;IACH,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIjC,KAAK,IAAI,OAAO;IAIhB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAgB3C,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IA4B5C,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAOhC,mBAAmB,IAAI,eAAe,EAAE;IAaxC,mBAAmB,CAAC,KAAK,EAAE,SAAS,eAAe,EAAE,GAAG,IAAI;IAc5D,OAAO,IAAI,OAAO;IAIlB,OAAO,IAAI,IAAI;IASf,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI;CAGzB"}
@@ -1,10 +1,11 @@
1
1
  import { fromTagLibKey, mp4AtomWireKey, mp4FreeformAtomNames, remapKeysFromTagLib, toTagLibKey } from "../constants/properties.js";
2
2
  import { MetadataError, UnsupportedFormatError } from "../errors/classes.js";
3
3
  import "../errors.js";
4
+ import { fromRawFreeformItem, toRawFreeformItem, validateFreeformItems } from "../utils/mp4-freeform.js";
4
5
  import { MP4_ITEM_NAMES_KEY } from "./mp4-item-names.js";
5
6
  import { buildMutableTag } from "./mutable-tag-impl.js";
6
7
  import { registerAutoDispose, unregisterAutoDispose } from "./auto-dispose.js";
7
- import _defineProperty from "../_virtual/_@oxc-project_runtime@0.152.0/helpers/esm/defineProperty.js";
8
+ import _defineProperty from "../_virtual/_@oxc-project_runtime@0.154.0/helpers/esm/defineProperty.js";
8
9
  //#region src/taglib/audio-file-base.ts
9
10
  let _Symbol$dispose;
10
11
  const LYRICS_PROPERTY_KEY = "lyrics";
@@ -63,7 +64,7 @@ var BaseAudioFileImpl = class {
63
64
  return buildMutableTag(this.handle);
64
65
  }
65
66
  audioProperties() {
66
- if (!this.cachedAudioProperties) this.cachedAudioProperties = this.handle.getAudioProperties() ?? null;
67
+ this.cachedAudioProperties ?? (this.cachedAudioProperties = this.handle.getAudioProperties() ?? null);
67
68
  return this.cachedAudioProperties ?? void 0;
68
69
  }
69
70
  properties() {
@@ -73,7 +74,12 @@ var BaseAudioFileImpl = class {
73
74
  }
74
75
  setProperties(properties) {
75
76
  const translated = {};
76
- for (const [key, values] of Object.entries(properties)) if (values !== void 0) translated[toTagLibKey(fromTagLibKey(key))] = values;
77
+ for (const [key, values] of Object.entries(properties)) if (values !== void 0) {
78
+ const wireKey = toTagLibKey(fromTagLibKey(key));
79
+ const emptyTotal = (wireKey === "TRACKTOTAL" || wireKey === "DISCTOTAL") && values.every((v) => v === "");
80
+ if (emptyTotal && !this.module.isWasi) continue;
81
+ translated[wireKey] = emptyTotal ? [] : values;
82
+ }
77
83
  if (!(LYRICS_WIRE_KEY in translated)) {
78
84
  const existing = this.handle.getProperties()[LYRICS_WIRE_KEY];
79
85
  if (existing !== void 0) translated[LYRICS_WIRE_KEY] = existing;
@@ -92,30 +98,79 @@ var BaseAudioFileImpl = class {
92
98
  }
93
99
  setProperty(key, value) {
94
100
  const wireKey = toTagLibKey(fromTagLibKey(key));
101
+ if ((wireKey === "TRACKTOTAL" || wireKey === "DISCTOTAL") && value === "") {
102
+ this.clearTotal(wireKey);
103
+ return;
104
+ }
105
+ const nextValue = this.preserveIntPairTotal(wireKey, value);
95
106
  const atomNames = mp4FreeformAtomNames([wireKey]);
96
107
  if (atomNames.length > 0 && this.isMP4()) {
97
- if (value === "") {
98
- const prior = this.handle.getMp4ItemRemovals?.() ?? [];
99
- this.handle.setMp4ItemRemovals?.([.../* @__PURE__ */ new Set([...prior, ...atomNames])]);
100
- if (this.module.isWasi) this.handle.setProperties({
101
- ...this.handle.getProperties(),
102
- [wireKey]: []
103
- });
104
- else {
105
- const rest = { ...this.handle.getProperties() };
106
- delete rest[wireKey];
107
- this.handle.setProperties(rest);
108
- }
109
- return;
110
- }
111
- this.handle.setProperties({
108
+ this.writeMp4FreeformProperty(wireKey, value, atomNames);
109
+ return;
110
+ }
111
+ this.handle.setProperty(wireKey, nextValue);
112
+ }
113
+ /**
114
+ * An empty total is a clear, not an "n/" value. Route it through the map so
115
+ * the int-pair fold never sees a one-element [""] list (Emscripten appended
116
+ * the empty string and produced "3/"; WASI dropped it).
117
+ */
118
+ clearTotal(wireKey) {
119
+ const rest = { ...this.handle.getProperties() };
120
+ if (this.module.isWasi) rest[wireKey] = [];
121
+ else delete rest[wireKey];
122
+ this.handle.setProperties(rest);
123
+ }
124
+ /**
125
+ * A bare number write on an int-pair field keeps an existing total, matching
126
+ * tag().setTrack() and applyTags({track}) (taglib-eq3). A raw "n/total" and
127
+ * an empty clear still win. Emscripten folds the total eagerly, so without
128
+ * this, setting the total before the number lost it where WASI's save-time
129
+ * fold kept it.
130
+ */
131
+ preserveIntPairTotal(wireKey, value) {
132
+ if (wireKey !== "TRACKNUMBER" && wireKey !== "DISCNUMBER" || value === "" || value.includes("/")) return value;
133
+ const existing = this.handle.getProperty(wireKey);
134
+ const slash = existing.indexOf("/");
135
+ return slash === -1 ? value : `${value}${existing.slice(slash)}`;
136
+ }
137
+ /**
138
+ * Write a property backed by an exact-case MP4 freeform atom.
139
+ *
140
+ * Clearing contract (taglib-qyw2): an empty value must REMOVE the item. The
141
+ * PropertyMap erase pass computes freeform item names from the property table
142
+ * (upper-cased "ITUNNORM") and misses the restored exact-case atom on disk
143
+ * (taglib-bnhl), so the exact name is queued through the deletion directive
144
+ * (taglib-65nm) — consumed by the WASI shim before apply_propmap, applied
145
+ * immediately by the Embind proxy. What the propmap itself carries then
146
+ * differs per backend:
147
+ * - WASI (merge model): [wireKey]: [] — the merge DELETES the key from
148
+ * tagData (absent keys are untouched), so the wire no longer carries the
149
+ * value that would re-create the atom.
150
+ * - Embind (replace model): the key must be ABSENT from the map — an
151
+ * empty-list entry would re-create the item in setProperties' write pass
152
+ * after the directive removed it.
153
+ */
154
+ writeMp4FreeformProperty(wireKey, value, atomNames) {
155
+ if (value === "") {
156
+ const prior = this.handle.getMp4ItemRemovals?.() ?? [];
157
+ this.handle.setMp4ItemRemovals?.([.../* @__PURE__ */ new Set([...prior, ...atomNames])]);
158
+ if (this.module.isWasi) this.handle.setProperties({
112
159
  ...this.handle.getProperties(),
113
- [wireKey]: [value],
114
- [MP4_ITEM_NAMES_KEY]: atomNames
160
+ [wireKey]: []
115
161
  });
162
+ else {
163
+ const rest = { ...this.handle.getProperties() };
164
+ delete rest[wireKey];
165
+ this.handle.setProperties(rest);
166
+ }
116
167
  return;
117
168
  }
118
- this.handle.setProperty(wireKey, value);
169
+ this.handle.setProperties({
170
+ ...this.handle.getProperties(),
171
+ [wireKey]: [value],
172
+ [MP4_ITEM_NAMES_KEY]: [...atomNames]
173
+ });
119
174
  }
120
175
  /**
121
176
  * The empty-string clearing contract, named (taglib-qyw2): both backends
@@ -141,12 +196,27 @@ var BaseAudioFileImpl = class {
141
196
  this.handle.setProperty(wireKey, value);
142
197
  return;
143
198
  }
199
+ if (value === "") {
200
+ this.handle.removeMP4Item(key);
201
+ return;
202
+ }
144
203
  this.handle.setMP4Item(key, value);
145
204
  }
146
205
  removeMP4Item(key) {
147
206
  if (!this.isMP4()) throw new UnsupportedFormatError(this.getFormat(), ["MP4", "M4A"]);
148
207
  this.handle.removeMP4Item(key);
149
208
  }
209
+ getMP4FreeformItems() {
210
+ if (!this.isMP4()) throw new UnsupportedFormatError(this.getFormat(), ["MP4", "M4A"]);
211
+ if (!this.handle.getMP4FreeformItems) throw new MetadataError("read", "MP4 freeform items are unavailable on this backend");
212
+ return this.handle.getMP4FreeformItems().map(fromRawFreeformItem);
213
+ }
214
+ setMP4FreeformItems(items) {
215
+ if (!this.isMP4()) throw new UnsupportedFormatError(this.getFormat(), ["MP4", "M4A"]);
216
+ if (!this.handle.setMP4FreeformItems) throw new MetadataError("write", "MP4 freeform items are unavailable on this backend");
217
+ validateFreeformItems(items);
218
+ this.handle.setMP4FreeformItems(items.map(toRawFreeformItem));
219
+ }
150
220
  isValid() {
151
221
  return this.handle.isValid();
152
222
  }
@@ -1 +1 @@
1
- {"version":3,"file":"audio-file-checksum.d.ts","sourceRoot":"","sources":["../../src/taglib/audio-file-checksum.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAG5D,MAAM,MAAM,aAAa,GACrB;IACE,MAAM,EAAE,eAAe,GAAG,MAAM,CAAC;IACjC,SAAS,EAAE,QAAQ,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;CACrB,GACD;IACE,MAAM,EAAE,qBAAqB,CAAC;IAC9B,SAAS,EAAE,KAAK,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,EAAE,CAAC;CACjB,CAAC;AAEN,MAAM,WAAW,oBAAoB;IACnC,KAAK,CAAC,EAAE,SAAS,GAAG,KAAK,CAAC;CAC3B;AAED;mCACmC;AACnC,MAAM,MAAM,cAAc,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;AAErD,4EAA4E;AAC5E,MAAM,MAAM,iBAAiB,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;AAE3D;;;;GAIG;AACH,UAAU,oBAAoB;IAC5B;sEACkE;IAClE,KAAK,EAAE,UAAU,CAAC;IAClB,qDAAqD;IACrD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ;;2DAEuD;IACvD,eAAe,EAAE,OAAO,CAAC;CAC1B;AA6FD,wBAAsB,aAAa,CACjC,MAAM,EAAE,oBAAoB,EAC5B,MAAM,EAAE,MAAM,EACd,EAAE,EAAE,UAAU,EACd,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,aAAa,CAAC,CAgExB"}
1
+ {"version":3,"file":"audio-file-checksum.d.ts","sourceRoot":"","sources":["../../src/taglib/audio-file-checksum.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAG5D,MAAM,MAAM,aAAa,GACrB;IACE,MAAM,EAAE,eAAe,GAAG,MAAM,CAAC;IACjC,SAAS,EAAE,QAAQ,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;CACrB,GACD;IACE,MAAM,EAAE,qBAAqB,CAAC;IAC9B,SAAS,EAAE,KAAK,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,EAAE,CAAC;CACjB,CAAC;AAEN,MAAM,WAAW,oBAAoB;IACnC,KAAK,CAAC,EAAE,SAAS,GAAG,KAAK,CAAC;CAC3B;AAED;mCACmC;AACnC,MAAM,MAAM,cAAc,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;AAErD,4EAA4E;AAC5E,MAAM,MAAM,iBAAiB,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;AAE3D;;;;GAIG;AACH,UAAU,oBAAoB;IAC5B;sEACkE;IAClE,KAAK,EAAE,UAAU,CAAC;IAClB,qDAAqD;IACrD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ;;2DAEuD;IACvD,eAAe,EAAE,OAAO,CAAC;CAC1B;AAmJD,wBAAsB,aAAa,CACjC,MAAM,EAAE,oBAAoB,EAC5B,MAAM,EAAE,MAAM,EACd,EAAE,EAAE,UAAU,EACd,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,aAAa,CAAC,CAiBxB"}
@@ -59,20 +59,24 @@ function joinRanges(bytes, ranges) {
59
59
  }
60
60
  return out;
61
61
  }
62
+ /** FLAC STREAMINFO MD5 (`basis: "pcm"`), the only format that supports it. */
63
+ async function pcmChecksum(source, format, io) {
64
+ if (format.toUpperCase() !== "FLAC") throw new UnsupportedFormatError(format, ["FLAC"], { operation: "media checksum (basis: pcm)" });
65
+ let windowed;
66
+ if (source.bytes.length > 0) windowed = source.bytes;
67
+ else if (source.path && io.readPartial) windowed = await io.readPartial(source.path, STREAMINFO_WINDOW, 0);
68
+ let md5 = windowed === void 0 ? void 0 : flacStreamInfoMd5(windowed);
69
+ if (md5 === void 0 && windowed !== source.bytes) md5 = flacStreamInfoMd5(await fileBytes(source, io));
70
+ if (md5 === void 0) throw new MetadataError("read", "STREAMINFO digest unavailable");
71
+ return {
72
+ source: "flac-streaminfo-md5",
73
+ algorithm: "md5",
74
+ hex: md5,
75
+ bytesHashed: 16
76
+ };
77
+ }
62
78
  async function mediaChecksum(source, format, io, options = {}) {
63
- if (options.basis === "pcm") {
64
- if (format.toUpperCase() !== "FLAC") throw new UnsupportedFormatError(format, ["FLAC"], { operation: "media checksum (basis: pcm)" });
65
- const windowed = source.bytes.length > 0 ? source.bytes : source.path && io.readPartial ? await io.readPartial(source.path, STREAMINFO_WINDOW, 0) : void 0;
66
- let md5 = windowed === void 0 ? void 0 : flacStreamInfoMd5(windowed);
67
- if (md5 === void 0 && windowed !== source.bytes) md5 = flacStreamInfoMd5(await fileBytes(source, io));
68
- if (md5 === void 0) throw new MetadataError("read", "STREAMINFO digest unavailable");
69
- return {
70
- source: "flac-streaminfo-md5",
71
- algorithm: "md5",
72
- hex: md5,
73
- bytesHashed: 16
74
- };
75
- }
79
+ if (options.basis === "pcm") return pcmChecksum(source, format, io);
76
80
  const bytes = await fileBytes(source, io);
77
81
  const walk = mediaRanges(format, bytes);
78
82
  const payload = joinRanges(bytes, walk.ranges);
@@ -1 +1 @@
1
- {"version":3,"file":"audio-file-impl.d.ts","sourceRoot":"","sources":["../../src/taglib/audio-file-impl.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"audio-file-impl.d.ts","sourceRoot":"","sources":["../../src/taglib/audio-file-impl.ts"],"names":[],"mappings":"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"}
@@ -9,7 +9,7 @@ import { getPlatformIO } from "../runtime/platform-io.js";
9
9
  import { writeFileData } from "../utils/write.js";
10
10
  import { getNodeFsSync } from "../utils/node-fs.js";
11
11
  import { normalized } from "../utils/rating.js";
12
- import _defineProperty from "../_virtual/_@oxc-project_runtime@0.152.0/helpers/esm/defineProperty.js";
12
+ import _defineProperty from "../_virtual/_@oxc-project_runtime@0.154.0/helpers/esm/defineProperty.js";
13
13
  import { BaseAudioFileImpl } from "./audio-file-base.js";
14
14
  import { mediaChecksum } from "./audio-file-checksum.js";
15
15
  import { saveViaFreshHandle } from "./save-reconstruct.js";
@@ -1,4 +1,4 @@
1
- import type { AudioProperties, FileType, Picture, PropertyMap } from "../types.js";
1
+ import type { AudioProperties, FileType, MP4FreeformItem, Picture, PropertyMap } from "../types.js";
2
2
  import type { TypedAudioProperties } from "../types/audio-formats.js";
3
3
  import type { Id3v2Frame, Rating, UnsyncedLyrics } from "../constants/complex-properties.js";
4
4
  import type { MutableTag } from "./mutable-tag.js";
@@ -59,6 +59,23 @@ export interface AudioFile {
59
59
  setMP4Item(key: string, value: string): void;
60
60
  /** Remove an MP4-specific metadata item. */
61
61
  removeMP4Item(key: string): void;
62
+ /**
63
+ * Read MP4 freeform (`----:mean:name`) items with their AtomDataType and raw
64
+ * value. One item per data value; a multi-value atom repeats mean/name.
65
+ * Returns an empty array when the file has no freeform items.
66
+ *
67
+ * @throws {UnsupportedFormatError} When the file is not MP4/M4A
68
+ */
69
+ getMP4FreeformItems(): MP4FreeformItem[];
70
+ /**
71
+ * Replace every MP4 freeform item. Equal mean/name/type entries are grouped
72
+ * into one atom; an empty array clears them all. Standard MP4 atoms are
73
+ * unaffected.
74
+ *
75
+ * @throws {UnsupportedFormatError} When the file is not MP4/M4A
76
+ * @throws {MetadataError} When an item is malformed
77
+ */
78
+ setMP4FreeformItems(items: readonly MP4FreeformItem[]): void;
62
79
  /** Save all changes to the in-memory buffer. */
63
80
  save(): boolean;
64
81
  /**
@@ -1 +1 @@
1
- {"version":3,"file":"audio-file-interface.d.ts","sourceRoot":"","sources":["../../src/taglib/audio-file-interface.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"audio-file-interface.d.ts","sourceRoot":"","sources":["../../src/taglib/audio-file-interface.ts"],"names":[],"mappings":"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"}
@@ -6,6 +6,7 @@
6
6
  * overriding only getTagData, setTagData, and getAudioProperties.
7
7
  */
8
8
  import type { WasmFileHandle } from "../wasm.js";
9
+ import type { RawMP4FreeformItem } from "../types/tags.js";
9
10
  /** @internal Embind-generated TagWrapper — methods on C++ prototype. */
10
11
  interface EmbindTagWrapper {
11
12
  title(): string;
@@ -45,6 +46,8 @@ interface EmbindAudioPropertiesWrapper {
45
46
  export interface EmbindFileHandle {
46
47
  getTag(): EmbindTagWrapper;
47
48
  getAudioProperties(): EmbindAudioPropertiesWrapper | null;
49
+ getMP4FreeformItems(): RawMP4FreeformItem[];
50
+ setMP4FreeformItems(items: readonly RawMP4FreeformItem[]): void;
48
51
  [key: string]: unknown;
49
52
  }
50
53
  /** @internal Wrap an Embind FileHandle with a Proxy for the data-oriented interface. */
@@ -1 +1 @@
1
- {"version":3,"file":"embind-adapter.d.ts","sourceRoot":"","sources":["../../src/taglib/embind-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAyB,cAAc,EAAE,MAAM,YAAY,CAAC;AAcxE,wEAAwE;AACxE,UAAU,gBAAgB;IACxB,KAAK,IAAI,MAAM,CAAC;IAChB,MAAM,IAAI,MAAM,CAAC;IACjB,KAAK,IAAI,MAAM,CAAC;IAChB,OAAO,IAAI,MAAM,CAAC;IAClB,KAAK,IAAI,MAAM,CAAC;IAChB,IAAI,IAAI,MAAM,CAAC;IACf,KAAK,IAAI,MAAM,CAAC;IAChB,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,oFAAoF;AACpF,UAAU,4BAA4B;IACpC,eAAe,IAAI,MAAM,CAAC;IAC1B,oBAAoB,IAAI,MAAM,CAAC;IAC/B,OAAO,IAAI,MAAM,CAAC;IAClB,UAAU,IAAI,MAAM,CAAC;IACrB,QAAQ,IAAI,MAAM,CAAC;IACnB,aAAa,IAAI,MAAM,CAAC;IACxB,KAAK,IAAI,MAAM,CAAC;IAChB,eAAe,IAAI,MAAM,CAAC;IAC1B,UAAU,IAAI,OAAO,CAAC;IACtB,WAAW,IAAI,MAAM,CAAC;IACtB,SAAS,IAAI,MAAM,CAAC;IACpB,WAAW,IAAI,OAAO,CAAC;IACvB,aAAa,IAAI,MAAM,CAAC;IACxB,WAAW,IAAI,MAAM,CAAC;IACtB,YAAY,IAAI,MAAM,CAAC;CACxB;AAED,6DAA6D;AAC7D,MAAM,WAAW,gBAAgB;IAC/B,MAAM,IAAI,gBAAgB,CAAC;IAC3B,kBAAkB,IAAI,4BAA4B,GAAG,IAAI,CAAC;IAC1D,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,wFAAwF;AACxF,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,gBAAgB,GAAG,cAAc,CAuLtE"}
1
+ {"version":3,"file":"embind-adapter.d.ts","sourceRoot":"","sources":["../../src/taglib/embind-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAyB,cAAc,EAAE,MAAM,YAAY,CAAC;AACxE,OAAO,KAAK,EAAgB,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAazE,wEAAwE;AACxE,UAAU,gBAAgB;IACxB,KAAK,IAAI,MAAM,CAAC;IAChB,MAAM,IAAI,MAAM,CAAC;IACjB,KAAK,IAAI,MAAM,CAAC;IAChB,OAAO,IAAI,MAAM,CAAC;IAClB,KAAK,IAAI,MAAM,CAAC;IAChB,IAAI,IAAI,MAAM,CAAC;IACf,KAAK,IAAI,MAAM,CAAC;IAChB,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,oFAAoF;AACpF,UAAU,4BAA4B;IACpC,eAAe,IAAI,MAAM,CAAC;IAC1B,oBAAoB,IAAI,MAAM,CAAC;IAC/B,OAAO,IAAI,MAAM,CAAC;IAClB,UAAU,IAAI,MAAM,CAAC;IACrB,QAAQ,IAAI,MAAM,CAAC;IACnB,aAAa,IAAI,MAAM,CAAC;IACxB,KAAK,IAAI,MAAM,CAAC;IAChB,eAAe,IAAI,MAAM,CAAC;IAC1B,UAAU,IAAI,OAAO,CAAC;IACtB,WAAW,IAAI,MAAM,CAAC;IACtB,SAAS,IAAI,MAAM,CAAC;IACpB,WAAW,IAAI,OAAO,CAAC;IACvB,aAAa,IAAI,MAAM,CAAC;IACxB,WAAW,IAAI,MAAM,CAAC;IACtB,YAAY,IAAI,MAAM,CAAC;CACxB;AAED,6DAA6D;AAC7D,MAAM,WAAW,gBAAgB;IAC/B,MAAM,IAAI,gBAAgB,CAAC;IAC3B,kBAAkB,IAAI,4BAA4B,GAAG,IAAI,CAAC;IAC1D,mBAAmB,IAAI,kBAAkB,EAAE,CAAC;IAC5C,mBAAmB,CAAC,KAAK,EAAE,SAAS,kBAAkB,EAAE,GAAG,IAAI,CAAC;IAChE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,wFAAwF;AACxF,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,gBAAgB,GAAG,cAAc,CA6LtE"}
@@ -98,6 +98,12 @@ function wrapEmbindHandle(raw) {
98
98
  const handle = raw;
99
99
  for (const name of removals) handle.removeMP4Item(name);
100
100
  },
101
+ getMP4FreeformItems() {
102
+ return raw.getMP4FreeformItems();
103
+ },
104
+ setMP4FreeformItems(items) {
105
+ raw.setMP4FreeformItems(items);
106
+ },
101
107
  getAudioProperties() {
102
108
  const pw = raw.getAudioProperties();
103
109
  if (!pw) return null;
@@ -1 +1 @@
1
- {"version":3,"file":"extra-state-registry.d.ts","sourceRoot":"","sources":["../../src/taglib/extra-state-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,UAAU,EAAc,MAAM,YAAY,CAAC;AAEzD,KAAK,UAAU,GAAG;IAChB,wDAAwD;IACxD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;;;;OAMG;IACH,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,cAAc,EAAE,OAAO,GAAG,IAAI,CAAC;CAC7E,CAAC;AAWF,eAAO,MAAM,YAAY,EAAE,SAAS,UAAU,EAqE7C,CAAC;AAEF,2EAA2E;AAC3E,wBAAgB,cAAc,CAC5B,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,UAAU,EAClB,cAAc,EAAE,OAAO,GACtB,IAAI,CAIN"}
1
+ {"version":3,"file":"extra-state-registry.d.ts","sourceRoot":"","sources":["../../src/taglib/extra-state-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,UAAU,EAAc,MAAM,YAAY,CAAC;AAGzD,KAAK,UAAU,GAAG;IAChB,wDAAwD;IACxD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;;;;OAMG;IACH,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,cAAc,EAAE,OAAO,GAAG,IAAI,CAAC;CAC7E,CAAC;AAuBF,eAAO,MAAM,YAAY,EAAE,SAAS,UAAU,EAuF7C,CAAC;AAEF,2EAA2E;AAC3E,wBAAgB,cAAc,CAC5B,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,UAAU,EAClB,cAAc,EAAE,OAAO,GACtB,IAAI,CAIN"}
@@ -3,6 +3,10 @@ function chapterStyle(chapters) {
3
3
  const s = chapters[0]?.source;
4
4
  return s === "nero" || s === "both" ? s : "quicktime";
5
5
  }
6
+ /** Order-independent signature of a raw freeform list (byte-exact). */
7
+ function freeformSignature(items) {
8
+ return items.map((item) => `${item.mean}\u0000${item.name}\u0000${item.type}\u0000` + Array.from(item.value).join(",")).sort((a, b) => a.localeCompare(b)).join("\n");
9
+ }
6
10
  const EXTRA_FIELDS = [
7
11
  {
8
12
  name: "pictures",
@@ -48,6 +52,17 @@ const EXTRA_FIELDS = [
48
52
  else if (complete) target.setIxml(null);
49
53
  }
50
54
  },
55
+ {
56
+ name: "_mp4Freeform",
57
+ copy(target, source, complete) {
58
+ const items = source.getMP4FreeformItems?.();
59
+ if (items === void 0) return;
60
+ if (!complete && items.length === 0) return;
61
+ const targetItems = target.getMP4FreeformItems?.() ?? [];
62
+ if (freeformSignature(items) === freeformSignature(targetItems)) return;
63
+ target.setMP4FreeformItems?.(items);
64
+ }
65
+ },
51
66
  {
52
67
  name: "_mp4ItemRemovals",
53
68
  copy(target, source, complete) {
@@ -1,13 +1,16 @@
1
+ type LoadResult = {
2
+ data: Uint8Array;
3
+ isPartiallyLoaded: boolean;
4
+ };
5
+ type LoadOptions = {
6
+ partial: boolean;
7
+ maxHeaderSize: number;
8
+ maxFooterSize: number;
9
+ };
1
10
  /**
2
11
  * Load audio data from various sources, with optional partial loading.
3
12
  * @internal Used by TagLib.open()
4
13
  */
5
- export declare function loadAudioData(input: string | ArrayBuffer | Uint8Array | File, opts: {
6
- partial: boolean;
7
- maxHeaderSize: number;
8
- maxFooterSize: number;
9
- }): Promise<{
10
- data: Uint8Array;
11
- isPartiallyLoaded: boolean;
12
- }>;
14
+ export declare function loadAudioData(input: string | ArrayBuffer | Uint8Array | File, opts: LoadOptions): Promise<LoadResult>;
15
+ export {};
13
16
  //# sourceMappingURL=load-audio-data.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"load-audio-data.d.ts","sourceRoot":"","sources":["../../src/taglib/load-audio-data.ts"],"names":[],"mappings":"AAUA;;;GAGG;AACH,wBAAsB,aAAa,CACjC,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,UAAU,GAAG,IAAI,EAC/C,IAAI,EAAE;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,GACvE,OAAO,CAAC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,iBAAiB,EAAE,OAAO,CAAA;CAAE,CAAC,CAuD3D"}
1
+ {"version":3,"file":"load-audio-data.d.ts","sourceRoot":"","sources":["../../src/taglib/load-audio-data.ts"],"names":[],"mappings":"AAUA,KAAK,UAAU,GAAG;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,iBAAiB,EAAE,OAAO,CAAA;CAAE,CAAC;AACnE,KAAK,WAAW,GAAG;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AA+DF;;;GAGG;AACH,wBAAsB,aAAa,CACjC,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,UAAU,GAAG,IAAI,EAC/C,IAAI,EAAE,WAAW,GAChB,OAAO,CAAC,UAAU,CAAC,CAOrB"}
@@ -1,54 +1,50 @@
1
1
  import { metadataFitsInHeader, trailerFitsInFooter } from "./metadata-extent.js";
2
2
  import { getFileSize, readFileData, readPartialFileData } from "../utils/file.js";
3
3
  //#region src/taglib/load-audio-data.ts
4
+ async function loadFull(input) {
5
+ return {
6
+ data: await readFileData(input),
7
+ isPartiallyLoaded: false
8
+ };
9
+ }
10
+ /** Partial load for a browser-style File: header + footer windows. */
11
+ async function loadPartialFile(input, opts) {
12
+ const headerSize = Math.min(opts.maxHeaderSize, input.size);
13
+ const footerSize = Math.min(opts.maxFooterSize, input.size);
14
+ if (input.size <= headerSize + footerSize) return loadFull(input);
15
+ const header = new Uint8Array(await input.slice(0, headerSize).arrayBuffer());
16
+ if (!metadataFitsInHeader(header, headerSize)) return loadFull(input);
17
+ const footerStart = Math.max(0, input.size - footerSize);
18
+ const footer = new Uint8Array(await input.slice(footerStart).arrayBuffer());
19
+ if (!trailerFitsInFooter(footer, footerSize)) return loadFull(input);
20
+ const combined = new Uint8Array(header.byteLength + footer.byteLength);
21
+ combined.set(header, 0);
22
+ combined.set(footer, header.byteLength);
23
+ return {
24
+ data: combined,
25
+ isPartiallyLoaded: true
26
+ };
27
+ }
28
+ /** Partial load for a path: one ranged read covering both windows. */
29
+ async function loadPartialPath(input, opts) {
30
+ if (await getFileSize(input) > opts.maxHeaderSize + opts.maxFooterSize) {
31
+ const data = await readPartialFileData(input, opts.maxHeaderSize, opts.maxFooterSize);
32
+ if (metadataFitsInHeader(data, opts.maxHeaderSize) && trailerFitsInFooter(data, opts.maxFooterSize)) return {
33
+ data,
34
+ isPartiallyLoaded: true
35
+ };
36
+ }
37
+ return loadFull(input);
38
+ }
4
39
  /**
5
40
  * Load audio data from various sources, with optional partial loading.
6
41
  * @internal Used by TagLib.open()
7
42
  */
8
43
  async function loadAudioData(input, opts) {
9
- if (opts.partial && typeof File !== "undefined" && input instanceof File) {
10
- const headerSize = Math.min(opts.maxHeaderSize, input.size);
11
- const footerSize = Math.min(opts.maxFooterSize, input.size);
12
- if (input.size <= headerSize + footerSize) return {
13
- data: await readFileData(input),
14
- isPartiallyLoaded: false
15
- };
16
- const header = new Uint8Array(await input.slice(0, headerSize).arrayBuffer());
17
- if (!metadataFitsInHeader(header, headerSize)) return {
18
- data: await readFileData(input),
19
- isPartiallyLoaded: false
20
- };
21
- const footerStart = Math.max(0, input.size - footerSize);
22
- const footer = new Uint8Array(await input.slice(footerStart).arrayBuffer());
23
- if (!trailerFitsInFooter(footer, footerSize)) return {
24
- data: await readFileData(input),
25
- isPartiallyLoaded: false
26
- };
27
- const combined = new Uint8Array(header.byteLength + footer.byteLength);
28
- combined.set(header, 0);
29
- combined.set(footer, header.byteLength);
30
- return {
31
- data: combined,
32
- isPartiallyLoaded: true
33
- };
34
- }
35
- if (opts.partial && typeof input === "string") {
36
- if (await getFileSize(input) > opts.maxHeaderSize + opts.maxFooterSize) {
37
- const data = await readPartialFileData(input, opts.maxHeaderSize, opts.maxFooterSize);
38
- if (metadataFitsInHeader(data, opts.maxHeaderSize) && trailerFitsInFooter(data, opts.maxFooterSize)) return {
39
- data,
40
- isPartiallyLoaded: true
41
- };
42
- }
43
- return {
44
- data: await readFileData(input),
45
- isPartiallyLoaded: false
46
- };
47
- }
48
- return {
49
- data: await readFileData(input),
50
- isPartiallyLoaded: false
51
- };
44
+ if (!opts.partial) return loadFull(input);
45
+ if (typeof File !== "undefined" && input instanceof File) return loadPartialFile(input, opts);
46
+ if (typeof input === "string") return loadPartialPath(input, opts);
47
+ return loadFull(input);
52
48
  }
53
49
  //#endregion
54
50
  export { loadAudioData };
@@ -1 +1 @@
1
- {"version":3,"file":"metadata-extent.d.ts","sourceRoot":"","sources":["../../src/taglib/metadata-extent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAqBH;;;;;;;;;;;;GAYG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,CAK9D;AA2BD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,CAItE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,CAIpE;AAwGD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CA4BrE;AAsED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,MAAM,GACZ,OAAO,CAiCT;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,UAAU,EAChB,UAAU,EAAE,MAAM,GACjB,OAAO,CAuBT"}
1
+ {"version":3,"file":"metadata-extent.d.ts","sourceRoot":"","sources":["../../src/taglib/metadata-extent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAqBH;;;;;;;;;;;;GAYG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,CAK9D;AA2BD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,CAItE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,CAIpE;AA+ID;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAgBrE;AAoGD;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,MAAM,GACZ,OAAO,CAQT;AAgBD;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,UAAU,EAChB,UAAU,EAAE,MAAM,GACjB,OAAO,CAeT"}