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
package/LICENSE CHANGED
@@ -19,32 +19,3 @@ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
19
  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
20
  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
21
  SOFTWARE.
22
-
23
- ---
24
-
25
- ADDITIONAL LICENSING INFORMATION:
26
-
27
- This product includes software developed by Scott Wheeler and the TagLib
28
- contributors (https://taglib.org/).
29
-
30
- The WebAssembly binaries (build/taglib-web.wasm for the Emscripten backend
31
- and build/taglib-wasi.wasm for the WASI backend, shipped as dist/*.wasm)
32
- contain compiled TagLib code which is licensed under LGPL-2.1-or-later.
33
- The original TagLib source code is located in lib/taglib/. See
34
- lib/taglib/COPYING.LGPL for the full LGPL license terms.
35
-
36
- LGPL COMPLIANCE:
37
- The WebAssembly binaries are subject to LGPL requirements. This means:
38
- - You may use them in commercial applications
39
- - Modifications to TagLib must be shared under LGPL
40
- - You must enable users to relink with modified TagLib versions
41
-
42
- To rebuild the WebAssembly binaries with a modified TagLib:
43
- 1. Modify the TagLib source in lib/taglib/
44
- 2. Run: pnpm run build:wasm (builds both backends; requires the
45
- Emscripten SDK and WASI SDK 34 — see .github/CONTRIBUTING.md)
46
- 3. The new binaries will be in build/taglib-web.wasm and
47
- build/taglib-wasi.wasm
48
-
49
- For more information about LGPL compliance and dual licensing, see:
50
- https://github.com/CharlesWiltgen/TagLib-Wasm#licensing
package/NOTICE ADDED
@@ -0,0 +1,35 @@
1
+ NOTICE
2
+ ======
3
+
4
+ Third-party and binary licensing for taglib-wasm. The project's own
5
+ TypeScript/JavaScript code is MIT — see LICENSE.
6
+
7
+ This product includes software developed by Scott Wheeler and the TagLib
8
+ contributors (https://taglib.org/).
9
+
10
+ The WebAssembly binaries (build/taglib-web.wasm for the Emscripten backend and
11
+ build/taglib-wasi.wasm for the WASI backend, shipped as dist/*.wasm) contain
12
+ compiled TagLib code, which is licensed under LGPL-2.1-or-later (TagLib is
13
+ dual-licensed LGPL-2.1-or-later / MPL-1.1). The full LGPL-2.1 text ships with
14
+ this package as legal/COPYING.LGPL — a verbatim copy of the same file in the
15
+ vendored TagLib source at lib/taglib/ (git submodule).
16
+
17
+ LGPL compliance
18
+ ---------------
19
+
20
+ The WebAssembly binaries are subject to LGPL requirements. This means:
21
+
22
+ - You may use them in commercial applications
23
+ - Modifications to TagLib must be shared under LGPL
24
+ - You must enable users to relink with modified TagLib versions
25
+
26
+ To rebuild the WebAssembly binaries with a modified TagLib:
27
+
28
+ 1. Modify the TagLib source in lib/taglib/
29
+ 2. Run: pnpm run build:wasm (builds both backends; requires the
30
+ Emscripten SDK and WASI SDK 34 — see .github/CONTRIBUTING.md)
31
+ 3. The new binaries will be in build/taglib-web.wasm and
32
+ build/taglib-wasi.wasm
33
+
34
+ Rendered licensing notes:
35
+ https://github.com/CharlesWiltgen/TagLib-Wasm/blob/main/README.md#license
package/README.md CHANGED
@@ -4,7 +4,7 @@
4
4
  [![npm version](https://img.shields.io/npm/v/taglib-wasm.svg)](https://www.npmjs.com/package/taglib-wasm)
5
5
  [![npm downloads](https://img.shields.io/npm/dm/taglib-wasm.svg)](https://www.npmjs.com/package/taglib-wasm)
6
6
  [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://github.com/CharlesWiltgen/TagLib-Wasm/blob/main/LICENSE)
7
- <br>[![Built with](https://img.shields.io/badge/TypeScript-5-3178c6.svg?logo=typescript&logoColor=f5f5f5)](https://www.typescriptlang.org/)
7
+ <br>[![Built with](https://img.shields.io/badge/TypeScript-6-3178c6.svg?logo=typescript&logoColor=f5f5f5)](https://www.typescriptlang.org/)
8
8
  [![Built with Emscripten](https://img.shields.io/badge/Built%20with-Emscripten-4B9BFF.svg)](https://emscripten.org/)
9
9
  [![Built with WebAssembly](https://img.shields.io/badge/Built%20with-WebAssembly-654ff0.svg?logo=webassembly&logoColor=white)](https://webassembly.org/)
10
10
  [![Built with TagLib](https://img.shields.io/badge/Built%20with-TagLib-brightgreen.svg)](https://taglib.org/)
@@ -36,7 +36,8 @@ TagLib-Wasm is the **universal tagging library for TypeScript/JavaScript**
36
36
  - **Value fidelity** – Tag values round-trip verbatim: a `"3/12"` track or a
37
37
  zero-padded `"03"` is preserved, and MP4 freeform atoms keep their exact
38
38
  casing and vendor `mean`, so other tools still recognise them
39
- - **Zero dependencies** – Self-contained Wasm bundle
39
+ - **Self-contained Wasm** – TagLib ships compiled in the package; no native
40
+ modules, system libraries, or post-install download
40
41
  - **Tested** – Cross-backend parity coverage across the supported formats
41
42
  - **Two API styles** – Use the "Simple" API for one-shot reads and writes, batch
42
43
  helpers, cover art, and checksums, or the full "Core" API for more advanced
@@ -196,10 +197,8 @@ const taglib = await TagLib.initialize();
196
197
  // Load audio file (automatically cleaned up when scope exits)
197
198
  using file = await taglib.open("song.mp3");
198
199
 
199
- // Read and update metadata
200
- const tag = file.tag();
201
- tag.setTitle("New Title");
202
- tag.setArtist("New Artist");
200
+ // Update metadata (setters chain)
201
+ file.tag().setTitle("New Title").setArtist("New Artist");
203
202
 
204
203
  // Save changes
205
204
  file.save();
@@ -289,6 +288,9 @@ const modifiedBuffer = await applyCoverArt("song.mp3", imageData, "image/jpeg");
289
288
  // Save modifiedBuffer to file if needed
290
289
  ```
291
290
 
291
+ `coverData` and `imageData` are `Uint8Array`s; this snippet uses Deno's file API
292
+ — substitute your runtime's.
293
+
292
294
  ### Working with Ratings
293
295
 
294
296
  ```typescript
@@ -581,28 +583,30 @@ Where a build splits its output into several files, the figure is the total of
581
583
  every JavaScript chunk it emits. Exact invocations, so the table can be
582
584
  reproduced:
583
585
 
584
- - **esbuild 0.28.2** — `esbuild <app> --bundle --minify --format=esm
585
- --target=es2022 --platform=browser --external:node:module` for the browser
586
+ - **esbuild 0.28.2** – `esbuild <app> --bundle --minify --format=esm
587
+ --target=es2022 --platform=browser --external:module` for the browser
586
588
  column; the same with `--platform=node` and no `--external` for the Node
587
- column. The `--external` matches the dynamic `import("node:module")` in
589
+ column. The `--external` matches the dynamic `import("module")` in
588
590
  `dist/taglib-wrapper.js`. (`--external` takes a colon, not `=`.)
589
- - **rollup 4.63.3** — `input: <app>`, plugins `@rollup/plugin-node-resolve`
591
+ - **rollup 4.63.3** – `input: <app>`, plugins `@rollup/plugin-node-resolve`
590
592
  (`{ browser: true, exportConditions: ["browser", "default"] }` for the browser
591
593
  column, default options for the Node column) and `@rollup/plugin-terser`,
592
594
  output `{ format: "esm", inlineDynamicImports: true }`.
593
- - **vite 8.3.0** — a real app build: `index.html` plus a
595
+ - **vite 8.3.0** – A real app build: `index.html` plus a
594
596
  `<script type="module">` pointing at the entry, `build.minify: "esbuild"`,
595
597
  `target: "es2022"`. Vite builds for the browser; the figures below that name
596
598
  the `node` condition instead add `resolve.conditions: ["node"]`.
597
- - **webpack 5.111.1** — `mode: "production"`, `target: "web"`,
598
- `externals: { module: "module" }`. `target: "web"` alone fails on the
599
- `import("node:module")` inside `dist/taglib-wrapper.js`.
599
+ - **webpack 5.111.1** – The app package declares `"type": "module"`;
600
+ `mode: "production"`, `target: "web"`, `externals: { module: "module" }`,
601
+ `experiments: { topLevelAwait: true }` (the app calls the API at top level).
602
+ `target: "web"` alone fails on the `import("module")` inside
603
+ `dist/taglib-wrapper.js`.
600
604
 
601
605
  | Consumer app | esbuild (browser)¹ | rollup (browser)¹ | vite (app) | webpack (web)² | esbuild (Node)³ | rollup (Node)³ |
602
606
  | ------------------------------------- | ------------------ | ----------------- | ---------- | -------------- | --------------- | -------------- |
603
- | `taglib-wasm` — `TagLib.initialize()` | 79,826 | 77,058 | 82,778 | 80,736 | 143,600 | 133,060 |
604
- | `taglib-wasm/simple` — `getTagLib()` | 79,548 | 77,316 | 82,512 | 81,554 | 144,602 | 133,431 |
605
- | `taglib-wasm/folder` — `scanFolder`⁴ | — | 136,822⁴ | 145,895⁴ | — | 147,942 | 136,822 |
607
+ | `taglib-wasm` — `TagLib.initialize()` | 84,983 | 82,248 | 87,962 | 85,889 | 152,363 | 141,705 |
608
+ | `taglib-wasm/simple` — `getTagLib()` | 84,705 | 82,511 | 87,696 | 86,713 | 153,370 | 142,088 |
609
+ | `taglib-wasm/folder` — `scanFolder`⁴ | — | 145,454⁴ | 154,848⁴ | — | 156,868 | 145,454 |
606
610
 
607
611
  ¹ the `browser` `exports` condition. ² `target: "web"`. ³ the Node `exports`
608
612
  condition. ⁴ Node-only entry — see below.
@@ -623,15 +627,15 @@ browser, scan on a server and post the result; the pure
623
627
 
624
628
  **`./web` builds for the browser.** It declares a `browser` condition, so a
625
629
  browser-targeted build resolves an Emscripten-only build of that entry and pulls
626
- **`taglib-web.wasm` alone** — measured with the vite invocation above on
627
- `pictureToDataURL` from `taglib-wasm/web`: one 703,477-byte Wasm asset, where
630
+ **`taglib-web.wasm` alone** – Measured with the vite invocation above on
631
+ `pictureToDataURL` from `taglib-wasm/web`: one 691,052-byte Wasm asset, where
628
632
  the vite build on the `node` condition instead emits both `taglib-web.wasm` and
629
- `taglib-wasi.wasm` (1,458,150 bytes of assets for a call that needs neither
633
+ `taglib-wasi.wasm` (1,462,928 bytes of assets for a call that needs neither
630
634
  engine). The browser build is a pre-bundled file like `index.browser.js`, so it
631
- barely tree-shakes: that call is 81,006 bytes in the vite app build and 78,528
635
+ barely tree-shakes: that call is 86,179 bytes in the vite app build and 83,663
632
636
  under the esbuild browser column, against 205 bytes under esbuild's Node column —
633
- and importing any pure helper from the barrel costs ~80 KB there too. Rollup is
634
- the exception: it shakes the pre-bundled file down to 745 bytes, though still
637
+ and importing any pure helper from the barrel costs ~85 KB there too. Rollup is
638
+ the exception: it shakes the pre-bundled file down to 784 bytes, though still
635
639
  not to the 210-byte leaf its Node column reaches. That granularity is a property
636
640
  of the pre-bundled browser entries, not of this subpath.
637
641
 
@@ -657,8 +661,8 @@ instead of a bundler error — and importing `bwf`, `groupAlbums`,
657
661
  mismatch is what produced the original silent failure.
658
662
 
659
663
  **Bundler interop.** `dist/taglib-wrapper.js` — the Emscripten glue — contains a
660
- dynamic `import("node:module")`, and browser targets have no such builtin, so the
661
- two targets need one line each: esbuild `--external:node:module`, webpack
664
+ dynamic `import("module")`, and browser targets have no such builtin, so the
665
+ two targets need one line each: esbuild `--external:module`, webpack
662
666
  `externals: { module: "module" }` (webpack `target: "web"` alone fails on it).
663
667
  Rollup needs nothing extra; vite externalizes it for the browser with a warning.
664
668
  The `browser` condition itself is resolved by default by esbuild
@@ -667,7 +671,7 @@ The `browser` condition itself is resolved by default by esbuild
667
671
 
668
672
  **The barrel is not a tax.** Adding an API to an import that already loads the
669
673
  engine costs only that API. Against the `taglib-wasm` row above (esbuild, Node
670
- column): adding `scanFolder` costs **4,376 bytes** and adding
674
+ column): adding `scanFolder` costs **4,386 bytes** and adding
671
675
  `pictureToDataURL` costs **187 bytes**, because neither drags in the rest of the
672
676
  Folder or Web module tree.
673
677
 
@@ -676,16 +680,16 @@ pre-bundled file, so a consumer of the barrel downloads the whole file whatever
676
680
  it imports; adding the pure `bwf` / `groupAlbums` / `discFolderInfo` exports to
677
681
  that file's export list therefore costs nothing measurable. Bundling
678
682
  `import { TagLib }` against the entry with and without those three export names
679
- gives identical bytes under esbuild (79,826) and rollup (77,058) and 12 bytes
680
- more under vite (82,764 → 82,776). Nothing else moved: the Folder and Web APIs
681
- are still reached only when imported, and the Node entries are unchanged.
683
+ gives identical bytes under esbuild and rollup and only a few bytes more under
684
+ vite. Nothing else moved: the Folder and Web APIs are still reached only when
685
+ imported, and the Node entries are unchanged.
682
686
 
683
687
  **Entry-point choice is not a size lever.** `taglib-wasm` and
684
688
  `taglib-wasm/simple` differ by about a kilobyte either way — in a browser bundle
685
- `simple` is 278 bytes _smaller_, on Node 1,002 bytes _larger_, because
689
+ `simple` is 278 bytes _smaller_, on Node 1,007 bytes _larger_, because
686
690
  `getTagLib()` reaches the full `TagLib` class through a dynamic import. Pick by
687
691
  API surface. The lever that does matter is the `browser` export condition: a
688
- browser-targeted bundle is ~80 KB where a Node-targeted one is ~144 KB.
692
+ browser-targeted bundle is ~85 KB where a Node-targeted one is ~152 KB.
689
693
 
690
694
  **`"sideEffects": false`** is set in `package.json`, so a bundler may drop any
691
695
  module whose exports go unused. Before that field, importers of the sub-entries
@@ -737,7 +741,7 @@ This project uses dual licensing:
737
741
 
738
742
  - **TypeScript/JavaScript code** – MIT License (see [LICENSE](LICENSE))
739
743
  - **WebAssembly binaries (taglib-web.wasm, taglib-wasi.wasm)** – LGPL-2.1-or-later
740
- (inherited from TagLib)
744
+ (inherited from TagLib; the compliance and relinking notes ship in [NOTICE](NOTICE))
741
745
 
742
746
  The TagLib library is dual-licensed under LGPL/MPL. When compiled to
743
747
  WebAssembly, the resulting binary must comply with LGPL requirements. This
@@ -747,10 +751,12 @@ means:
747
751
  - If you modify the TagLib C++ code, you must share those changes
748
752
  - You must provide a way for users to relink with a modified TagLib
749
753
 
750
- For details, see [TagLib's COPYING.LGPL](https://github.com/taglib/taglib/blob/master/COPYING.LGPL)
751
- — this repository vendors TagLib as a git submodule at `lib/taglib`, so that
752
- path belongs to the submodule and is not part of this tree (the npm package
753
- ships `LICENSE` only).
754
+ For details, see [NOTICE](NOTICE) and the LGPL text it ships with
755
+ ([legal/COPYING.LGPL](legal/COPYING.LGPL)) — both travel with the published
756
+ package — and
757
+ [TagLib's COPYING.LGPL](https://github.com/taglib/taglib/blob/master/COPYING.LGPL);
758
+ this repository vendors TagLib as a git submodule at `lib/taglib`, so that path
759
+ belongs to the submodule rather than to this tree.
754
760
 
755
761
  ## Acknowledgments
756
762
 
@@ -1,4 +1,4 @@
1
- //#region \0@oxc-project+runtime@0.152.0/helpers/esm/assertClassBrand.js
1
+ //#region \0@oxc-project+runtime@0.154.0/helpers/esm/assertClassBrand.js
2
2
  function _assertClassBrand(e, t, n) {
3
3
  if ("function" == typeof e ? e === t : e.has(t)) return arguments.length < 3 ? t : n;
4
4
  throw new TypeError("Private element is not present on this object");
@@ -1,4 +1,4 @@
1
- //#region \0@oxc-project+runtime@0.152.0/helpers/esm/checkPrivateRedeclaration.js
1
+ //#region \0@oxc-project+runtime@0.154.0/helpers/esm/checkPrivateRedeclaration.js
2
2
  function _checkPrivateRedeclaration(e, t) {
3
3
  if (t.has(e)) throw new TypeError("Cannot initialize the same private elements twice on an object");
4
4
  }
@@ -1,5 +1,5 @@
1
1
  import _assertClassBrand from "./assertClassBrand.js";
2
- //#region \0@oxc-project+runtime@0.152.0/helpers/esm/classPrivateFieldGet2.js
2
+ //#region \0@oxc-project+runtime@0.154.0/helpers/esm/classPrivateFieldGet2.js
3
3
  function _classPrivateFieldGet2(s, a) {
4
4
  return s.get(_assertClassBrand(s, a));
5
5
  }
@@ -1,5 +1,5 @@
1
1
  import _checkPrivateRedeclaration from "./checkPrivateRedeclaration.js";
2
- //#region \0@oxc-project+runtime@0.152.0/helpers/esm/classPrivateFieldInitSpec.js
2
+ //#region \0@oxc-project+runtime@0.154.0/helpers/esm/classPrivateFieldInitSpec.js
3
3
  function _classPrivateFieldInitSpec(e, t, a) {
4
4
  _checkPrivateRedeclaration(e, t), t.set(e, a);
5
5
  }
@@ -1,5 +1,5 @@
1
1
  import _assertClassBrand from "./assertClassBrand.js";
2
- //#region \0@oxc-project+runtime@0.152.0/helpers/esm/classPrivateFieldSet2.js
2
+ //#region \0@oxc-project+runtime@0.154.0/helpers/esm/classPrivateFieldSet2.js
3
3
  function _classPrivateFieldSet2(s, a, r) {
4
4
  return s.set(_assertClassBrand(s, a), r), r;
5
5
  }
@@ -1,5 +1,5 @@
1
1
  import toPropertyKey from "./toPropertyKey.js";
2
- //#region \0@oxc-project+runtime@0.152.0/helpers/esm/defineProperty.js
2
+ //#region \0@oxc-project+runtime@0.154.0/helpers/esm/defineProperty.js
3
3
  function _defineProperty(e, r, t) {
4
4
  return (r = toPropertyKey(r)) in e ? Object.defineProperty(e, r, {
5
5
  value: t,
@@ -1,5 +1,5 @@
1
1
  import _typeof from "./typeof.js";
2
- //#region \0@oxc-project+runtime@0.152.0/helpers/esm/toPrimitive.js
2
+ //#region \0@oxc-project+runtime@0.154.0/helpers/esm/toPrimitive.js
3
3
  function toPrimitive(t, r) {
4
4
  if ("object" != _typeof(t) || !t) return t;
5
5
  var e = t[Symbol.toPrimitive];
@@ -1,6 +1,6 @@
1
1
  import _typeof from "./typeof.js";
2
2
  import toPrimitive from "./toPrimitive.js";
3
- //#region \0@oxc-project+runtime@0.152.0/helpers/esm/toPropertyKey.js
3
+ //#region \0@oxc-project+runtime@0.154.0/helpers/esm/toPropertyKey.js
4
4
  function toPropertyKey(t) {
5
5
  var i = toPrimitive(t, "string");
6
6
  return "symbol" == _typeof(i) ? i : i + "";
@@ -1,4 +1,4 @@
1
- //#region \0@oxc-project+runtime@0.152.0/helpers/esm/typeof.js
1
+ //#region \0@oxc-project+runtime@0.154.0/helpers/esm/typeof.js
2
2
  function _typeof(o) {
3
3
  "@babel/helpers - typeof";
4
4
  return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function(o) {
@@ -1,4 +1,4 @@
1
- //#region \0@oxc-project+runtime@0.152.0/helpers/esm/usingCtx.js
1
+ //#region \0@oxc-project+runtime@0.154.0/helpers/esm/usingCtx.js
2
2
  function _usingCtx() {
3
3
  var r = "function" == typeof SuppressedError ? SuppressedError : function(r, e) {
4
4
  var n = Error();
@@ -1 +1 @@
1
- {"version":3,"file":"bext.d.ts","sourceRoot":"","sources":["../../src/bwf/bext.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AA6D/D;;;;;GAKG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,UAAU,GAChB,uBAAuB,GAAG,SAAS,CAyCrC;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,uBAAuB,GAAG,UAAU,CAmDjE"}
1
+ {"version":3,"file":"bext.d.ts","sourceRoot":"","sources":["../../src/bwf/bext.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAuF/D;;;;;GAKG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,UAAU,GAChB,uBAAuB,GAAG,SAAS,CAgCrC;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,uBAAuB,GAAG,UAAU,CAsDjE"}
package/dist/bwf/bext.js CHANGED
@@ -15,11 +15,11 @@ function readFixedString(bytes, offset, len) {
15
15
  const max = Math.min(offset + len, bytes.length);
16
16
  while (end < max && bytes[end] !== 0) end++;
17
17
  let s = "";
18
- for (let i = offset; i < end; i++) s += String.fromCharCode(bytes[i]);
18
+ for (let i = offset; i < end; i++) s += String.fromCodePoint(bytes[i]);
19
19
  return s;
20
20
  }
21
21
  function writeFixedString(bytes, offset, len, value) {
22
- for (let i = 0; i < len; i++) bytes[offset + i] = i < value.length ? value.charCodeAt(i) & 255 : 0;
22
+ for (let i = 0; i < len; i++) bytes[offset + i] = i < value.length ? (value.codePointAt(i) ?? 0) & 255 : 0;
23
23
  }
24
24
  function clampInt16(n) {
25
25
  return Math.max(-32768, Math.min(32767, Math.round(n)));
@@ -40,10 +40,26 @@ function hexToBytes(hex, outLen) {
40
40
  const out = new Uint8Array(outLen);
41
41
  for (let i = 0; i + 1 < clean.length + 1 && i / 2 < outLen; i += 2) {
42
42
  const pair = clean.slice(i, i + 2);
43
- if (pair.length === 2) out[i / 2] = parseInt(pair, 16);
43
+ if (pair.length === 2) out[i / 2] = Number.parseInt(pair, 16);
44
44
  }
45
45
  return out;
46
46
  }
47
+ const LOUDNESS_FIELDS = [
48
+ ["loudnessValueDb", 0],
49
+ ["loudnessRangeDb", 2],
50
+ ["maxTruePeakLevelDbtp", 4],
51
+ ["maxMomentaryLoudnessDb", 6],
52
+ ["maxShortTermLoudnessDb", 8]
53
+ ];
54
+ /** Decode the v2 loudness block; absent Int16 sentinels stay absent. */
55
+ function decodeLoudnessFields(dv) {
56
+ const result = {};
57
+ for (const [field, offset] of LOUDNESS_FIELDS) {
58
+ const value = loudnessFromRaw(dv.getInt16(LOUDNESS_OFFSET + offset, true));
59
+ if (value !== void 0) result[field] = value;
60
+ }
61
+ return result;
62
+ }
47
63
  /**
48
64
  * Parse a raw `bext` chunk. Returns `undefined` only if `bytes` is shorter than
49
65
  * 348 (cannot even read the `Version` field). Optional fields are populated per
@@ -67,18 +83,7 @@ function decodeBext(bytes) {
67
83
  codingHistory: bytes.length > FIXED_PREFIX_LEN ? readFixedString(bytes, FIXED_PREFIX_LEN, bytes.length - FIXED_PREFIX_LEN) : ""
68
84
  };
69
85
  if (version >= 1 && bytes.length >= 412) result.umid = bytesToHex(bytes.subarray(UMID_OFFSET, 412));
70
- if (version >= 2 && bytes.length >= 422) {
71
- const lv = loudnessFromRaw(dv.getInt16(LOUDNESS_OFFSET, true));
72
- const lr = loudnessFromRaw(dv.getInt16(414, true));
73
- const mtp = loudnessFromRaw(dv.getInt16(416, true));
74
- const mml = loudnessFromRaw(dv.getInt16(418, true));
75
- const msl = loudnessFromRaw(dv.getInt16(420, true));
76
- if (lv !== void 0) result.loudnessValueDb = lv;
77
- if (lr !== void 0) result.loudnessRangeDb = lr;
78
- if (mtp !== void 0) result.maxTruePeakLevelDbtp = mtp;
79
- if (mml !== void 0) result.maxMomentaryLoudnessDb = mml;
80
- if (msl !== void 0) result.maxShortTermLoudnessDb = msl;
81
- }
86
+ if (version >= 2 && bytes.length >= 422) Object.assign(result, decodeLoudnessFields(dv));
82
87
  return result;
83
88
  }
84
89
  /**
@@ -94,7 +99,11 @@ function encodeBext(b) {
94
99
  const bytes = new Uint8Array(FIXED_PREFIX_LEN + codingHistory.length);
95
100
  const dv = new DataView(bytes.buffer);
96
101
  const hasLoudness = b.loudnessValueDb !== void 0 || b.loudnessRangeDb !== void 0 || b.maxTruePeakLevelDbtp !== void 0 || b.maxMomentaryLoudnessDb !== void 0 || b.maxShortTermLoudnessDb !== void 0;
97
- const version = Number.isInteger(b.version) ? b.version : hasLoudness ? 2 : b.umid ? 1 : 0;
102
+ let version;
103
+ if (Number.isInteger(b.version)) version = b.version;
104
+ else if (hasLoudness) version = 2;
105
+ else if (b.umid) version = 1;
106
+ else version = 0;
98
107
  writeFixedString(bytes, 0, 256, b.description ?? "");
99
108
  writeFixedString(bytes, 256, 32, b.originator ?? "");
100
109
  writeFixedString(bytes, 288, 32, b.originatorReference ?? "");
@@ -1 +1 @@
1
- {"version":3,"file":"complex-properties.d.ts","sourceRoot":"","sources":["../../src/constants/complex-properties.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAIH;;;;;;;;GAQG;AACH,MAAM,WAAW,MAAM;IACrB,6DAA6D;IAC7D,MAAM,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,UAAU;IACzB,qEAAqE;IACrE,EAAE,EAAE,MAAM,CAAC;IACX,0DAA0D;IAC1D,IAAI,EAAE,UAAU,CAAC;IACjB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC"}
1
+ {"version":3,"file":"complex-properties.d.ts","sourceRoot":"","sources":["../../src/constants/complex-properties.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH;;;;;;;;GAQG;AACH,MAAM,WAAW,MAAM;IACrB,6DAA6D;IAC7D,MAAM,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,UAAU;IACzB,qEAAqE;IACrE,EAAE,EAAE,MAAM,CAAC;IACX,0DAA0D;IAC1D,IAAI,EAAE,UAAU,CAAC;IACjB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC"}
@@ -222,9 +222,10 @@ export declare const GENERAL_EXTENDED_PROPERTIES: {
222
222
  readonly key: "GROUPING";
223
223
  readonly description: "Content group/work";
224
224
  readonly type: "string";
225
- readonly supportedFormats: readonly ["Vorbis"];
225
+ readonly supportedFormats: readonly ["MP4", "Vorbis"];
226
226
  readonly mappings: {
227
227
  readonly vorbis: "GROUPING";
228
+ readonly mp4: "©grp";
228
229
  };
229
230
  };
230
231
  readonly work: {
@@ -1 +1 @@
1
- {"version":3,"file":"general-extended-properties.d.ts","sourceRoot":"","sources":["../../src/constants/general-extended-properties.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4P9B,CAAC"}
1
+ {"version":3,"file":"general-extended-properties.d.ts","sourceRoot":"","sources":["../../src/constants/general-extended-properties.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6P9B,CAAC"}
@@ -229,8 +229,11 @@ const GENERAL_EXTENDED_PROPERTIES = {
229
229
  key: "GROUPING",
230
230
  description: "Content group/work",
231
231
  type: "string",
232
- supportedFormats: ["Vorbis"],
233
- mappings: { vorbis: "GROUPING" }
232
+ supportedFormats: ["MP4", "Vorbis"],
233
+ mappings: {
234
+ vorbis: "GROUPING",
235
+ mp4: "©grp"
236
+ }
234
237
  },
235
238
  work: {
236
239
  key: "WORK",
@@ -41,10 +41,12 @@ const READ_ALIASES = {
41
41
  TOTALDISCS: "DISCTOTAL",
42
42
  MUSICBRAINZ_ALBUMTYPE: "RELEASETYPE",
43
43
  "MusicBrainz Album Type": "RELEASETYPE",
44
+ MUSICBRAINZ_ALBUMSTATUS: "RELEASESTATUS",
45
+ "MusicBrainz Album Status": "RELEASESTATUS",
44
46
  CONTENTADVISORY: "ITUNESADVISORY",
45
47
  EXPLICIT: "ITUNESADVISORY"
46
48
  };
47
- for (const [alias, canonical] of Object.entries(READ_ALIASES)) if (_fromTagLib[alias] === void 0) _fromTagLib[alias] = _fromTagLib[canonical];
49
+ for (const [alias, canonical] of Object.entries(READ_ALIASES)) _fromTagLib[alias] ?? (_fromTagLib[alias] = _fromTagLib[canonical]);
48
50
  /** Translate a camelCase property key to TagLib's ALL_CAPS wire key. Unknown keys pass through. */
49
51
  function toTagLibKey(key) {
50
52
  return _toTagLib[key] ?? key;
@@ -66,7 +68,7 @@ for (const meta of Object.values(PROPERTIES)) {
66
68
  const { key, mappings } = meta;
67
69
  const atom = mappings?.mp4;
68
70
  if (typeof atom !== "string" || atom.startsWith("----:")) continue;
69
- if (_mp4AtomToWireKey[atom] === void 0) _mp4AtomToWireKey[atom] = key;
71
+ _mp4AtomToWireKey[atom] ?? (_mp4AtomToWireKey[atom] = key);
70
72
  }
71
73
  /**
72
74
  * TagLib wire key for a standard MP4 atom name, or `undefined` for a freeform
@@ -87,6 +87,20 @@ export declare const SPECIALIZED_PROPERTIES: {
87
87
  readonly mp4: "----:com.apple.iTunes:MusicBrainz Album Release Country";
88
88
  };
89
89
  };
90
+ readonly releaseStatus: {
91
+ readonly key: "RELEASESTATUS";
92
+ readonly description: "Release status (official, promotion, bootleg, ...). TagLib 2.3.2 translates the RELEASESTATUS key per format: ID3v2 TXXX 'MUSICBRAINZ ALBUM STATUS' (TagLib's description casing), MP4 freeform atom 'MusicBrainz Album Status', APEv2 MUSICBRAINZ_ALBUMSTATUS, ASF 'MusicBrainz/Album Status', Vorbis/Matroska raw RELEASESTATUS";
93
+ readonly type: "string";
94
+ readonly supportedFormats: readonly ["ID3v2", "MP4", "Vorbis", "APE", "ASF", "Matroska"];
95
+ readonly mappings: {
96
+ readonly id3v2: {
97
+ readonly frame: "TXXX";
98
+ readonly description: "MusicBrainz Album Status";
99
+ };
100
+ readonly vorbis: "RELEASESTATUS";
101
+ readonly mp4: "----:com.apple.iTunes:MusicBrainz Album Status";
102
+ };
103
+ };
90
104
  readonly itunesAdvisory: {
91
105
  readonly key: "ITUNESADVISORY";
92
106
  readonly description: "Content advisory in the ITUNESADVISORY convention ('1' = explicit, '2' = clean, '0' = unspecified). On MP4 the value is stored in the native rtng atom and surfaced here. The typed tri-state lives on ExtendedTag.advisory; aliases CONTENTADVISORY and EXPLICIT resolve here";
@@ -1 +1 @@
1
- {"version":3,"file":"specialized-properties.d.ts","sourceRoot":"","sources":["../../src/constants/specialized-properties.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA+MjC;;;;;;;;OAQG;;;;;;;;;;;;;;;CAYK,CAAC"}
1
+ {"version":3,"file":"specialized-properties.d.ts","sourceRoot":"","sources":["../../src/constants/specialized-properties.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAkOjC;;;;;;;;OAQG;;;;;;;;;;;;;;;CAYK,CAAC"}
@@ -119,6 +119,27 @@ const SPECIALIZED_PROPERTIES = {
119
119
  mp4: "----:com.apple.iTunes:MusicBrainz Album Release Country"
120
120
  }
121
121
  },
122
+ releaseStatus: {
123
+ key: "RELEASESTATUS",
124
+ description: "Release status (official, promotion, bootleg, ...). TagLib 2.3.2 translates the RELEASESTATUS key per format: ID3v2 TXXX 'MUSICBRAINZ ALBUM STATUS' (TagLib's description casing), MP4 freeform atom 'MusicBrainz Album Status', APEv2 MUSICBRAINZ_ALBUMSTATUS, ASF 'MusicBrainz/Album Status', Vorbis/Matroska raw RELEASESTATUS",
125
+ type: "string",
126
+ supportedFormats: [
127
+ "ID3v2",
128
+ "MP4",
129
+ "Vorbis",
130
+ "APE",
131
+ "ASF",
132
+ "Matroska"
133
+ ],
134
+ mappings: {
135
+ id3v2: {
136
+ frame: "TXXX",
137
+ description: "MusicBrainz Album Status"
138
+ },
139
+ vorbis: "RELEASESTATUS",
140
+ mp4: "----:com.apple.iTunes:MusicBrainz Album Status"
141
+ }
142
+ },
122
143
  itunesAdvisory: {
123
144
  key: "ITUNESADVISORY",
124
145
  description: "Content advisory in the ITUNESADVISORY convention ('1' = explicit, '2' = clean, '0' = unspecified). On MP4 the value is stored in the native rtng atom and surfaced here. The typed tri-state lives on ExtendedTag.advisory; aliases CONTENTADVISORY and EXPLICIT resolve here",