taglib-wasm 2.2.3 → 2.3.1

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 (630) hide show
  1. package/LICENSE +1 -1
  2. package/README.md +206 -21
  3. package/dist/_virtual/_@oxc-project_runtime@0.152.0/helpers/esm/assertClassBrand.js +7 -0
  4. package/dist/_virtual/_@oxc-project_runtime@0.152.0/helpers/esm/checkPrivateRedeclaration.js +6 -0
  5. package/dist/_virtual/_@oxc-project_runtime@0.152.0/helpers/esm/classPrivateFieldGet2.js +7 -0
  6. package/dist/_virtual/_@oxc-project_runtime@0.152.0/helpers/esm/classPrivateFieldInitSpec.js +7 -0
  7. package/dist/_virtual/_@oxc-project_runtime@0.152.0/helpers/esm/classPrivateFieldSet2.js +7 -0
  8. package/dist/_virtual/_@oxc-project_runtime@0.152.0/helpers/esm/defineProperty.js +12 -0
  9. package/dist/_virtual/_@oxc-project_runtime@0.152.0/helpers/esm/toPrimitive.js +14 -0
  10. package/dist/_virtual/_@oxc-project_runtime@0.152.0/helpers/esm/toPropertyKey.js +9 -0
  11. package/dist/_virtual/_@oxc-project_runtime@0.152.0/helpers/esm/typeof.js +11 -0
  12. package/dist/_virtual/_@oxc-project_runtime@0.152.0/helpers/esm/usingCtx.js +57 -0
  13. package/dist/_virtual/_rolldown/runtime.js +13 -0
  14. package/dist/bwf/bext.d.ts.map +1 -0
  15. package/dist/bwf/bext.js +119 -0
  16. package/dist/{src/constants → constants}/additional-properties.d.ts.map +1 -1
  17. package/dist/constants/additional-properties.js +270 -0
  18. package/dist/constants/basic-properties.d.ts.map +1 -0
  19. package/dist/constants/basic-properties.js +128 -0
  20. package/dist/constants/complex-properties.d.ts.map +1 -0
  21. package/dist/constants/complex-properties.js +1 -0
  22. package/dist/constants/format-mappings.d.ts.map +1 -0
  23. package/dist/constants/format-mappings.js +58 -0
  24. package/dist/{src/constants → constants}/general-extended-properties.d.ts.map +1 -1
  25. package/dist/constants/general-extended-properties.js +272 -0
  26. package/dist/constants/index.d.ts.map +1 -0
  27. package/dist/constants/index.js +5 -0
  28. package/dist/{src/constants → constants}/properties.d.ts +1 -1
  29. package/dist/constants/properties.d.ts.map +1 -0
  30. package/dist/constants/properties.js +105 -0
  31. package/dist/constants/property-types.d.ts.map +1 -0
  32. package/dist/constants/property-types.js +1 -0
  33. package/dist/{src/constants → constants}/specialized-properties.d.ts.map +1 -1
  34. package/dist/constants/specialized-properties.js +335 -0
  35. package/dist/{src/constants → constants}/utilities.d.ts +1 -1
  36. package/dist/constants/utilities.d.ts.map +1 -0
  37. package/dist/constants/utilities.js +50 -0
  38. package/dist/constants.d.ts.map +1 -0
  39. package/dist/constants.js +5 -0
  40. package/dist/{src/deno-compile.d.ts → deno-compile.d.ts} +4 -2
  41. package/dist/deno-compile.d.ts.map +1 -0
  42. package/dist/deno-compile.js +109 -0
  43. package/dist/disc-folder.d.ts +4 -4
  44. package/dist/disc-folder.d.ts.map +1 -1
  45. package/dist/disc-folder.js +596 -544
  46. package/dist/errors/base.d.ts +38 -0
  47. package/dist/errors/base.d.ts.map +1 -0
  48. package/dist/errors/base.js +66 -0
  49. package/dist/errors/classes.d.ts.map +1 -0
  50. package/dist/errors/classes.js +164 -0
  51. package/dist/errors/guards.d.ts.map +1 -0
  52. package/dist/errors/guards.js +26 -0
  53. package/dist/errors/index.d.ts.map +1 -0
  54. package/dist/errors/index.js +4 -0
  55. package/dist/errors.d.ts.map +1 -0
  56. package/dist/errors.js +5 -0
  57. package/dist/file-utils/copy-and-find.d.ts.map +1 -0
  58. package/dist/file-utils/copy-and-find.js +107 -0
  59. package/dist/file-utils/export-operations.d.ts.map +1 -0
  60. package/dist/file-utils/export-operations.js +84 -0
  61. package/dist/file-utils/import-operations.d.ts.map +1 -0
  62. package/dist/file-utils/import-operations.js +109 -0
  63. package/dist/file-utils/index.d.ts.map +1 -0
  64. package/dist/file-utils/index.js +5 -0
  65. package/dist/file-utils/mime-detection.d.ts.map +1 -0
  66. package/dist/file-utils/mime-detection.js +44 -0
  67. package/dist/folder-api/album-corroborate.d.ts.map +1 -0
  68. package/dist/folder-api/album-corroborate.js +35 -0
  69. package/dist/folder-api/album-discs.d.ts.map +1 -0
  70. package/dist/folder-api/album-discs.js +119 -0
  71. package/dist/folder-api/album-grouping.d.ts.map +1 -0
  72. package/dist/folder-api/album-grouping.js +161 -0
  73. package/dist/folder-api/album-identity.d.ts.map +1 -0
  74. package/dist/folder-api/album-identity.js +165 -0
  75. package/dist/folder-api/album-types.d.ts.map +1 -0
  76. package/dist/folder-api/album-types.js +1 -0
  77. package/dist/folder-api/directory-walker.d.ts.map +1 -0
  78. package/dist/folder-api/directory-walker.js +27 -0
  79. package/dist/folder-api/file-processors.d.ts.map +1 -0
  80. package/dist/folder-api/file-processors.js +52 -0
  81. package/dist/folder-api/folder-disc.d.ts.map +1 -0
  82. package/dist/folder-api/folder-disc.js +166 -0
  83. package/dist/folder-api/folder-operations.d.ts.map +1 -0
  84. package/dist/folder-api/folder-operations.js +69 -0
  85. package/dist/folder-api/index.d.ts.map +1 -0
  86. package/dist/{src/folder-api → folder-api}/index.js +1 -8
  87. package/dist/folder-api/scan-for-albums.d.ts.map +1 -0
  88. package/dist/folder-api/scan-for-albums.js +25 -0
  89. package/dist/folder-api/scan-operations.d.ts.map +1 -0
  90. package/dist/folder-api/scan-operations.js +79 -0
  91. package/dist/folder-api/types.d.ts.map +1 -0
  92. package/dist/folder-api/types.js +21 -0
  93. package/dist/folder.d.ts +1 -1
  94. package/dist/folder.d.ts.map +1 -1
  95. package/dist/folder.js +7 -2
  96. package/dist/global.d.js +1 -0
  97. package/dist/index.browser.d.ts +40 -21
  98. package/dist/index.browser.d.ts.map +1 -1
  99. package/dist/index.browser.js +4194 -3656
  100. package/dist/index.d.ts +26 -25
  101. package/dist/index.d.ts.map +1 -1
  102. package/dist/index.js +40 -183
  103. package/dist/msgpack/decoder.d.ts.map +1 -0
  104. package/dist/msgpack/decoder.js +177 -0
  105. package/dist/msgpack/encoder.d.ts.map +1 -0
  106. package/dist/msgpack/encoder.js +211 -0
  107. package/dist/msgpack/index.d.ts.map +1 -0
  108. package/dist/msgpack/index.js +5 -0
  109. package/dist/{src/msgpack → msgpack}/types.d.ts +1 -1
  110. package/dist/msgpack/types.d.ts.map +1 -0
  111. package/dist/msgpack/types.js +13 -0
  112. package/dist/msgpack/utils.d.ts.map +1 -0
  113. package/dist/msgpack/utils.js +116 -0
  114. package/dist/rating.d.ts +1 -1
  115. package/dist/rating.d.ts.map +1 -1
  116. package/dist/rating.js +2 -2
  117. package/dist/runtime/deno-detect.d.ts.map +1 -0
  118. package/dist/runtime/deno-detect.js +12 -0
  119. package/dist/{src/runtime → runtime}/detector.d.ts +2 -0
  120. package/dist/runtime/detector.d.ts.map +1 -0
  121. package/dist/runtime/detector.js +173 -0
  122. package/dist/runtime/loader-types.d.ts.map +1 -0
  123. package/dist/runtime/loader-types.js +23 -0
  124. package/dist/runtime/module-loader-browser.d.ts.map +1 -0
  125. package/dist/runtime/module-loader-browser.js +33 -0
  126. package/dist/runtime/module-loader.d.ts.map +1 -0
  127. package/dist/runtime/module-loader.js +119 -0
  128. package/dist/runtime/platform-io.d.ts.map +1 -0
  129. package/dist/runtime/platform-io.js +153 -0
  130. package/dist/runtime/unified-loader/index.d.ts.map +1 -0
  131. package/dist/{src/runtime → runtime}/unified-loader/index.js +1 -7
  132. package/dist/runtime/unified-loader/loader.d.ts.map +1 -0
  133. package/dist/runtime/unified-loader/loader.js +64 -0
  134. package/dist/runtime/unified-loader/module-loading.d.ts.map +1 -0
  135. package/dist/runtime/unified-loader/module-loading.js +90 -0
  136. package/dist/runtime/unified-loader/module-selection.d.ts.map +1 -0
  137. package/dist/runtime/unified-loader/module-selection.js +25 -0
  138. package/dist/runtime/unified-loader/types.d.ts.map +1 -0
  139. package/dist/runtime/unified-loader/types.js +24 -0
  140. package/dist/{src/runtime → runtime}/wasi-adapter/adapter.d.ts +13 -1
  141. package/dist/runtime/wasi-adapter/adapter.d.ts.map +1 -0
  142. package/dist/runtime/wasi-adapter/adapter.js +114 -0
  143. package/dist/{src/runtime → runtime}/wasi-adapter/audio-properties.d.ts +4 -1
  144. package/dist/runtime/wasi-adapter/audio-properties.d.ts.map +1 -0
  145. package/dist/runtime/wasi-adapter/audio-properties.js +120 -0
  146. package/dist/runtime/wasi-adapter/file-handle.d.ts.map +1 -0
  147. package/dist/runtime/wasi-adapter/file-handle.js +181 -0
  148. package/dist/runtime/wasi-adapter/handle-state.d.ts.map +1 -0
  149. package/dist/runtime/wasi-adapter/handle-state.js +48 -0
  150. package/dist/runtime/wasi-adapter/index.d.ts.map +1 -0
  151. package/dist/{src/runtime → runtime}/wasi-adapter/index.js +1 -3
  152. package/dist/runtime/wasi-adapter/mp4-items.d.ts.map +1 -0
  153. package/dist/runtime/wasi-adapter/mp4-items.js +97 -0
  154. package/dist/runtime/wasi-adapter/path-open.d.ts +68 -0
  155. package/dist/runtime/wasi-adapter/path-open.d.ts.map +1 -0
  156. package/dist/runtime/wasi-adapter/path-open.js +101 -0
  157. package/dist/runtime/wasi-adapter/property-surface.d.ts.map +1 -0
  158. package/dist/runtime/wasi-adapter/property-surface.js +96 -0
  159. package/dist/runtime/wasi-adapter/structured-fields.d.ts.map +1 -0
  160. package/dist/runtime/wasi-adapter/structured-fields.js +144 -0
  161. package/dist/runtime/wasi-adapter/tag-keys.d.ts.map +1 -0
  162. package/dist/runtime/wasi-adapter/tag-keys.js +65 -0
  163. package/dist/runtime/wasi-adapter/wasm-io.d.ts.map +1 -0
  164. package/dist/runtime/wasi-adapter/wasm-io.js +154 -0
  165. package/dist/runtime/wasi-fs-deno.d.ts.map +1 -0
  166. package/dist/runtime/wasi-fs-deno.js +25 -0
  167. package/dist/runtime/wasi-fs-node.d.ts.map +1 -0
  168. package/dist/runtime/wasi-fs-node.js +58 -0
  169. package/dist/runtime/wasi-fs-provider.d.ts.map +1 -0
  170. package/dist/runtime/wasi-fs-provider.js +1 -0
  171. package/dist/runtime/wasi-host-loader.d.ts.map +1 -0
  172. package/dist/runtime/wasi-host-loader.js +101 -0
  173. package/dist/runtime/wasi-host.d.ts.map +1 -0
  174. package/dist/runtime/wasi-host.js +199 -0
  175. package/dist/runtime/wasi-memory.d.ts.map +1 -0
  176. package/dist/runtime/wasi-memory.js +179 -0
  177. package/dist/{src/runtime → runtime}/wasmer-sdk-loader/types.d.ts +13 -0
  178. package/dist/runtime/wasmer-sdk-loader/types.d.ts.map +1 -0
  179. package/dist/runtime/wasmer-sdk-loader/types.js +15 -0
  180. package/dist/simple/batch-operations.d.ts.map +1 -0
  181. package/dist/simple/batch-operations.js +245 -0
  182. package/dist/simple/checksum-operations.d.ts +25 -0
  183. package/dist/simple/checksum-operations.d.ts.map +1 -0
  184. package/dist/simple/checksum-operations.js +28 -0
  185. package/dist/simple/config.d.ts.map +1 -0
  186. package/dist/simple/config.js +17 -0
  187. package/dist/{src/simple → simple}/index.d.ts +2 -0
  188. package/dist/simple/index.d.ts.map +1 -0
  189. package/dist/simple/index.js +8 -0
  190. package/dist/simple/picture-operations.d.ts.map +1 -0
  191. package/dist/simple/picture-operations.js +132 -0
  192. package/dist/simple/tag-operations.d.ts.map +1 -0
  193. package/dist/simple/tag-operations.js +125 -0
  194. package/dist/simple/with-audio-file.d.ts.map +1 -0
  195. package/dist/simple/with-audio-file.js +28 -0
  196. package/dist/simple.browser.d.ts +2 -2
  197. package/dist/simple.browser.d.ts.map +1 -1
  198. package/dist/simple.browser.js +3462 -3425
  199. package/dist/simple.d.ts +1 -1
  200. package/dist/simple.d.ts.map +1 -1
  201. package/dist/simple.js +8 -2
  202. package/dist/taglib/audio-file-base.d.ts.map +1 -0
  203. package/dist/taglib/audio-file-base.js +166 -0
  204. package/dist/taglib/audio-file-bwf.d.ts.map +1 -0
  205. package/dist/taglib/audio-file-bwf.js +33 -0
  206. package/dist/taglib/audio-file-checksum.d.ts +47 -0
  207. package/dist/taglib/audio-file-checksum.d.ts.map +1 -0
  208. package/dist/taglib/audio-file-checksum.js +90 -0
  209. package/dist/{src/taglib → taglib}/audio-file-impl.d.ts +4 -0
  210. package/dist/taglib/audio-file-impl.d.ts.map +1 -0
  211. package/dist/taglib/audio-file-impl.js +234 -0
  212. package/dist/{src/taglib → taglib}/audio-file-interface.d.ts +17 -0
  213. package/dist/taglib/audio-file-interface.d.ts.map +1 -0
  214. package/dist/taglib/audio-file-interface.js +1 -0
  215. package/dist/taglib/auto-dispose.d.ts.map +1 -0
  216. package/dist/taglib/auto-dispose.js +34 -0
  217. package/dist/taglib/embind-adapter.d.ts.map +1 -0
  218. package/dist/taglib/embind-adapter.js +137 -0
  219. package/dist/taglib/extra-state-registry.d.ts.map +1 -0
  220. package/dist/taglib/extra-state-registry.js +72 -0
  221. package/dist/{src/taglib → taglib}/id3v2-frames.d.ts +0 -1
  222. package/dist/taglib/id3v2-frames.d.ts.map +1 -0
  223. package/dist/taglib/id3v2-frames.js +25 -0
  224. package/dist/taglib/index.d.ts.map +1 -0
  225. package/dist/taglib/index.js +7 -0
  226. package/dist/taglib/load-audio-data.d.ts.map +1 -0
  227. package/dist/taglib/load-audio-data.js +54 -0
  228. package/dist/taglib/media-ranges.d.ts +85 -0
  229. package/dist/taglib/media-ranges.d.ts.map +1 -0
  230. package/dist/taglib/media-ranges.js +309 -0
  231. package/dist/taglib/metadata-extent.d.ts +96 -0
  232. package/dist/taglib/metadata-extent.d.ts.map +1 -0
  233. package/dist/taglib/metadata-extent.js +394 -0
  234. package/dist/taglib/mp4-item-names.d.ts.map +1 -0
  235. package/dist/taglib/mp4-item-names.js +14 -0
  236. package/dist/taglib/mutable-tag-impl.d.ts.map +1 -0
  237. package/dist/taglib/mutable-tag-impl.js +81 -0
  238. package/dist/taglib/mutable-tag.d.ts.map +1 -0
  239. package/dist/taglib/mutable-tag.js +1 -0
  240. package/dist/taglib/save-reconstruct.d.ts.map +1 -0
  241. package/dist/taglib/save-reconstruct.js +53 -0
  242. package/dist/taglib/taglib-class.d.ts.map +1 -0
  243. package/dist/taglib/taglib-class.js +146 -0
  244. package/dist/taglib-wasi.wasm +0 -0
  245. package/dist/taglib-web.wasm +0 -0
  246. package/dist/taglib-wrapper.js +1 -1
  247. package/dist/taglib.d.ts.map +1 -0
  248. package/dist/taglib.js +7 -0
  249. package/dist/types/audio-formats.d.ts.map +1 -0
  250. package/dist/types/audio-formats.js +6 -0
  251. package/dist/types/bwf.d.ts.map +1 -0
  252. package/dist/types/bwf.js +1 -0
  253. package/dist/types/chapters.d.ts.map +1 -0
  254. package/dist/types/chapters.js +1 -0
  255. package/dist/types/config.d.ts.map +1 -0
  256. package/dist/types/config.js +1 -0
  257. package/dist/types/format-property-keys.d.ts.map +1 -0
  258. package/dist/types/format-property-keys.js +1 -0
  259. package/dist/types/index.d.ts.map +1 -0
  260. package/dist/types/index.js +9 -0
  261. package/dist/types/metadata-mappings.d.ts.map +1 -0
  262. package/dist/types/metadata-mappings.js +323 -0
  263. package/dist/types/pictures.d.ts.map +1 -0
  264. package/dist/types/pictures.js +79 -0
  265. package/dist/types/tags.d.ts.map +1 -0
  266. package/dist/types/tags.js +1 -0
  267. package/dist/types.d.ts.map +1 -0
  268. package/dist/types.js +5 -0
  269. package/dist/utils/file.d.ts.map +1 -0
  270. package/dist/utils/file.js +43 -0
  271. package/dist/utils/mirror-fields.d.ts.map +1 -0
  272. package/dist/utils/mirror-fields.js +107 -0
  273. package/dist/utils/node-fs.d.ts.map +1 -0
  274. package/dist/utils/node-fs.js +36 -0
  275. package/dist/utils/path.d.ts +26 -0
  276. package/dist/utils/path.d.ts.map +1 -0
  277. package/dist/utils/path.js +52 -0
  278. package/dist/utils/rating.d.ts.map +1 -0
  279. package/dist/utils/rating.js +150 -0
  280. package/dist/utils/tag-mapping.d.ts.map +1 -0
  281. package/dist/utils/tag-mapping.js +207 -0
  282. package/dist/utils/write.d.ts.map +1 -0
  283. package/dist/utils/write.js +18 -0
  284. package/dist/version.d.ts +2 -0
  285. package/dist/version.d.ts.map +1 -0
  286. package/dist/version.js +4 -0
  287. package/dist/{src/wasm.d.ts → wasm.d.ts} +9 -0
  288. package/dist/wasm.d.ts.map +1 -0
  289. package/dist/wasm.js +1 -0
  290. package/dist/web-utils/canvas.d.ts.map +1 -0
  291. package/dist/web-utils/canvas.js +97 -0
  292. package/dist/web-utils/data-url.d.ts.map +1 -0
  293. package/dist/web-utils/data-url.js +54 -0
  294. package/dist/web-utils/dom-integration.d.ts.map +1 -0
  295. package/dist/web-utils/dom-integration.js +105 -0
  296. package/dist/web-utils/index.d.ts.map +1 -0
  297. package/dist/web-utils/index.js +4 -0
  298. package/dist/web.browser.d.ts +13 -0
  299. package/dist/web.browser.d.ts.map +1 -0
  300. package/dist/web.browser.js +3387 -0
  301. package/dist/web.d.ts +1 -1
  302. package/dist/web.d.ts.map +1 -1
  303. package/dist/web.js +5 -2
  304. package/package.json +140 -97
  305. package/dist/src/bwf/bext.d.ts.map +0 -1
  306. package/dist/src/bwf/bext.js +0 -126
  307. package/dist/src/constants/additional-properties.js +0 -204
  308. package/dist/src/constants/basic-properties.d.ts.map +0 -1
  309. package/dist/src/constants/basic-properties.js +0 -89
  310. package/dist/src/constants/complex-properties.d.ts.map +0 -1
  311. package/dist/src/constants/complex-properties.js +0 -0
  312. package/dist/src/constants/format-mappings.d.ts.map +0 -1
  313. package/dist/src/constants/format-mappings.js +0 -54
  314. package/dist/src/constants/general-extended-properties.js +0 -254
  315. package/dist/src/constants/index.d.ts.map +0 -1
  316. package/dist/src/constants/index.js +0 -4
  317. package/dist/src/constants/properties.d.ts.map +0 -1
  318. package/dist/src/constants/properties.js +0 -95
  319. package/dist/src/constants/property-types.d.ts.map +0 -1
  320. package/dist/src/constants/property-types.js +0 -0
  321. package/dist/src/constants/specialized-properties.js +0 -223
  322. package/dist/src/constants/utilities.d.ts.map +0 -1
  323. package/dist/src/constants/utilities.js +0 -33
  324. package/dist/src/constants.d.ts.map +0 -1
  325. package/dist/src/constants.js +0 -1
  326. package/dist/src/deno-compile.d.ts.map +0 -1
  327. package/dist/src/deno-compile.js +0 -75
  328. package/dist/src/errors/base.d.ts +0 -23
  329. package/dist/src/errors/base.d.ts.map +0 -1
  330. package/dist/src/errors/base.js +0 -31
  331. package/dist/src/errors/classes.d.ts.map +0 -1
  332. package/dist/src/errors/classes.js +0 -170
  333. package/dist/src/errors/guards.d.ts.map +0 -1
  334. package/dist/src/errors/guards.js +0 -39
  335. package/dist/src/errors/index.d.ts.map +0 -1
  336. package/dist/src/errors/index.js +0 -39
  337. package/dist/src/errors.d.ts.map +0 -1
  338. package/dist/src/errors.js +0 -1
  339. package/dist/src/file-utils/copy-and-find.d.ts.map +0 -1
  340. package/dist/src/file-utils/copy-and-find.js +0 -89
  341. package/dist/src/file-utils/export-operations.d.ts.map +0 -1
  342. package/dist/src/file-utils/export-operations.js +0 -40
  343. package/dist/src/file-utils/import-operations.d.ts.map +0 -1
  344. package/dist/src/file-utils/import-operations.js +0 -42
  345. package/dist/src/file-utils/index.d.ts.map +0 -1
  346. package/dist/src/file-utils/index.js +0 -26
  347. package/dist/src/file-utils/mime-detection.d.ts.map +0 -1
  348. package/dist/src/file-utils/mime-detection.js +0 -45
  349. package/dist/src/folder-api/album-corroborate.d.ts.map +0 -1
  350. package/dist/src/folder-api/album-corroborate.js +0 -36
  351. package/dist/src/folder-api/album-discs.d.ts.map +0 -1
  352. package/dist/src/folder-api/album-discs.js +0 -122
  353. package/dist/src/folder-api/album-grouping.d.ts.map +0 -1
  354. package/dist/src/folder-api/album-grouping.js +0 -118
  355. package/dist/src/folder-api/album-identity.d.ts.map +0 -1
  356. package/dist/src/folder-api/album-identity.js +0 -151
  357. package/dist/src/folder-api/album-types.d.ts.map +0 -1
  358. package/dist/src/folder-api/album-types.js +0 -0
  359. package/dist/src/folder-api/directory-walker.d.ts.map +0 -1
  360. package/dist/src/folder-api/directory-walker.js +0 -35
  361. package/dist/src/folder-api/file-processors.d.ts.map +0 -1
  362. package/dist/src/folder-api/file-processors.js +0 -63
  363. package/dist/src/folder-api/folder-disc.d.ts.map +0 -1
  364. package/dist/src/folder-api/folder-disc.js +0 -169
  365. package/dist/src/folder-api/folder-operations.d.ts.map +0 -1
  366. package/dist/src/folder-api/folder-operations.js +0 -54
  367. package/dist/src/folder-api/index.d.ts.map +0 -1
  368. package/dist/src/folder-api/scan-for-albums.d.ts.map +0 -1
  369. package/dist/src/folder-api/scan-for-albums.js +0 -20
  370. package/dist/src/folder-api/scan-operations.d.ts.map +0 -1
  371. package/dist/src/folder-api/scan-operations.js +0 -77
  372. package/dist/src/folder-api/types.d.ts.map +0 -1
  373. package/dist/src/folder-api/types.js +0 -21
  374. package/dist/src/msgpack/decoder.d.ts.map +0 -1
  375. package/dist/src/msgpack/decoder.js +0 -215
  376. package/dist/src/msgpack/encoder.d.ts.map +0 -1
  377. package/dist/src/msgpack/encoder.js +0 -249
  378. package/dist/src/msgpack/index.d.ts.map +0 -1
  379. package/dist/src/msgpack/index.js +0 -56
  380. package/dist/src/msgpack/types.d.ts.map +0 -1
  381. package/dist/src/msgpack/types.js +0 -12
  382. package/dist/src/msgpack/utils.d.ts.map +0 -1
  383. package/dist/src/msgpack/utils.js +0 -134
  384. package/dist/src/runtime/deno-detect.d.ts.map +0 -1
  385. package/dist/src/runtime/deno-detect.js +0 -6
  386. package/dist/src/runtime/detector.d.ts.map +0 -1
  387. package/dist/src/runtime/detector.js +0 -181
  388. package/dist/src/runtime/loader-types.d.ts.map +0 -1
  389. package/dist/src/runtime/loader-types.js +0 -10
  390. package/dist/src/runtime/module-loader-browser.d.ts.map +0 -1
  391. package/dist/src/runtime/module-loader-browser.js +0 -37
  392. package/dist/src/runtime/module-loader.d.ts.map +0 -1
  393. package/dist/src/runtime/module-loader.js +0 -119
  394. package/dist/src/runtime/platform-io.d.ts.map +0 -1
  395. package/dist/src/runtime/platform-io.js +0 -188
  396. package/dist/src/runtime/unified-loader/index.d.ts.map +0 -1
  397. package/dist/src/runtime/unified-loader/loader.d.ts.map +0 -1
  398. package/dist/src/runtime/unified-loader/loader.js +0 -84
  399. package/dist/src/runtime/unified-loader/module-loading.d.ts.map +0 -1
  400. package/dist/src/runtime/unified-loader/module-loading.js +0 -122
  401. package/dist/src/runtime/unified-loader/module-selection.d.ts.map +0 -1
  402. package/dist/src/runtime/unified-loader/module-selection.js +0 -41
  403. package/dist/src/runtime/unified-loader/types.d.ts.map +0 -1
  404. package/dist/src/runtime/unified-loader/types.js +0 -25
  405. package/dist/src/runtime/wasi-adapter/adapter.d.ts.map +0 -1
  406. package/dist/src/runtime/wasi-adapter/adapter.js +0 -113
  407. package/dist/src/runtime/wasi-adapter/audio-properties.d.ts.map +0 -1
  408. package/dist/src/runtime/wasi-adapter/audio-properties.js +0 -85
  409. package/dist/src/runtime/wasi-adapter/file-handle.d.ts.map +0 -1
  410. package/dist/src/runtime/wasi-adapter/file-handle.js +0 -197
  411. package/dist/src/runtime/wasi-adapter/handle-state.d.ts.map +0 -1
  412. package/dist/src/runtime/wasi-adapter/handle-state.js +0 -58
  413. package/dist/src/runtime/wasi-adapter/index.d.ts.map +0 -1
  414. package/dist/src/runtime/wasi-adapter/mp4-items.d.ts.map +0 -1
  415. package/dist/src/runtime/wasi-adapter/mp4-items.js +0 -80
  416. package/dist/src/runtime/wasi-adapter/property-surface.d.ts.map +0 -1
  417. package/dist/src/runtime/wasi-adapter/property-surface.js +0 -104
  418. package/dist/src/runtime/wasi-adapter/structured-fields.d.ts.map +0 -1
  419. package/dist/src/runtime/wasi-adapter/structured-fields.js +0 -139
  420. package/dist/src/runtime/wasi-adapter/tag-keys.d.ts.map +0 -1
  421. package/dist/src/runtime/wasi-adapter/tag-keys.js +0 -46
  422. package/dist/src/runtime/wasi-adapter/wasm-io.d.ts.map +0 -1
  423. package/dist/src/runtime/wasi-adapter/wasm-io.js +0 -249
  424. package/dist/src/runtime/wasi-fs-deno.d.ts.map +0 -1
  425. package/dist/src/runtime/wasi-fs-deno.js +0 -26
  426. package/dist/src/runtime/wasi-fs-node.d.ts.map +0 -1
  427. package/dist/src/runtime/wasi-fs-node.js +0 -66
  428. package/dist/src/runtime/wasi-fs-provider.d.ts.map +0 -1
  429. package/dist/src/runtime/wasi-fs-provider.js +0 -0
  430. package/dist/src/runtime/wasi-host-loader.d.ts.map +0 -1
  431. package/dist/src/runtime/wasi-host-loader.js +0 -109
  432. package/dist/src/runtime/wasi-host.d.ts.map +0 -1
  433. package/dist/src/runtime/wasi-host.js +0 -202
  434. package/dist/src/runtime/wasi-memory.d.ts.map +0 -1
  435. package/dist/src/runtime/wasi-memory.js +0 -197
  436. package/dist/src/runtime/wasmer-sdk-loader/types.d.ts.map +0 -1
  437. package/dist/src/runtime/wasmer-sdk-loader/types.js +0 -12
  438. package/dist/src/simple/batch-operations.d.ts.map +0 -1
  439. package/dist/src/simple/batch-operations.js +0 -186
  440. package/dist/src/simple/config.d.ts.map +0 -1
  441. package/dist/src/simple/config.js +0 -18
  442. package/dist/src/simple/index.d.ts.map +0 -1
  443. package/dist/src/simple/index.js +0 -58
  444. package/dist/src/simple/picture-operations.d.ts.map +0 -1
  445. package/dist/src/simple/picture-operations.js +0 -68
  446. package/dist/src/simple/tag-operations.d.ts.map +0 -1
  447. package/dist/src/simple/tag-operations.js +0 -90
  448. package/dist/src/simple/with-audio-file.d.ts.map +0 -1
  449. package/dist/src/simple/with-audio-file.js +0 -39
  450. package/dist/src/taglib/audio-file-base.d.ts.map +0 -1
  451. package/dist/src/taglib/audio-file-base.js +0 -187
  452. package/dist/src/taglib/audio-file-bwf.d.ts.map +0 -1
  453. package/dist/src/taglib/audio-file-bwf.js +0 -41
  454. package/dist/src/taglib/audio-file-impl.d.ts.map +0 -1
  455. package/dist/src/taglib/audio-file-impl.js +0 -285
  456. package/dist/src/taglib/audio-file-interface.d.ts.map +0 -1
  457. package/dist/src/taglib/audio-file-interface.js +0 -0
  458. package/dist/src/taglib/auto-dispose.d.ts.map +0 -1
  459. package/dist/src/taglib/auto-dispose.js +0 -13
  460. package/dist/src/taglib/embind-adapter.d.ts.map +0 -1
  461. package/dist/src/taglib/embind-adapter.js +0 -141
  462. package/dist/src/taglib/extra-state-registry.d.ts.map +0 -1
  463. package/dist/src/taglib/extra-state-registry.js +0 -78
  464. package/dist/src/taglib/id3v2-frames.d.ts.map +0 -1
  465. package/dist/src/taglib/id3v2-frames.js +0 -42
  466. package/dist/src/taglib/index.d.ts.map +0 -1
  467. package/dist/src/taglib/index.js +0 -41
  468. package/dist/src/taglib/load-audio-data.d.ts.map +0 -1
  469. package/dist/src/taglib/load-audio-data.js +0 -51
  470. package/dist/src/taglib/metadata-extent.d.ts +0 -41
  471. package/dist/src/taglib/metadata-extent.d.ts.map +0 -1
  472. package/dist/src/taglib/metadata-extent.js +0 -171
  473. package/dist/src/taglib/mp4-item-names.d.ts.map +0 -1
  474. package/dist/src/taglib/mp4-item-names.js +0 -4
  475. package/dist/src/taglib/mutable-tag-impl.d.ts.map +0 -1
  476. package/dist/src/taglib/mutable-tag-impl.js +0 -88
  477. package/dist/src/taglib/mutable-tag.d.ts.map +0 -1
  478. package/dist/src/taglib/mutable-tag.js +0 -0
  479. package/dist/src/taglib/save-reconstruct.d.ts.map +0 -1
  480. package/dist/src/taglib/save-reconstruct.js +0 -43
  481. package/dist/src/taglib/taglib-class.d.ts.map +0 -1
  482. package/dist/src/taglib/taglib-class.js +0 -206
  483. package/dist/src/taglib.d.ts.map +0 -1
  484. package/dist/src/taglib.js +0 -1
  485. package/dist/src/types/audio-formats.d.ts.map +0 -1
  486. package/dist/src/types/audio-formats.js +0 -6
  487. package/dist/src/types/bwf.d.ts.map +0 -1
  488. package/dist/src/types/bwf.js +0 -0
  489. package/dist/src/types/chapters.d.ts.map +0 -1
  490. package/dist/src/types/chapters.js +0 -0
  491. package/dist/src/types/config.d.ts.map +0 -1
  492. package/dist/src/types/config.js +0 -0
  493. package/dist/src/types/format-property-keys.d.ts.map +0 -1
  494. package/dist/src/types/format-property-keys.js +0 -0
  495. package/dist/src/types/index.d.ts.map +0 -1
  496. package/dist/src/types/index.js +0 -8
  497. package/dist/src/types/metadata-mappings.d.ts.map +0 -1
  498. package/dist/src/types/metadata-mappings.js +0 -252
  499. package/dist/src/types/pictures.d.ts.map +0 -1
  500. package/dist/src/types/pictures.js +0 -64
  501. package/dist/src/types/tags.d.ts.map +0 -1
  502. package/dist/src/types/tags.js +0 -0
  503. package/dist/src/types.d.ts.map +0 -1
  504. package/dist/src/types.js +0 -1
  505. package/dist/src/utils/file.d.ts.map +0 -1
  506. package/dist/src/utils/file.js +0 -52
  507. package/dist/src/utils/mirror-fields.d.ts.map +0 -1
  508. package/dist/src/utils/mirror-fields.js +0 -75
  509. package/dist/src/utils/node-fs.d.ts.map +0 -1
  510. package/dist/src/utils/node-fs.js +0 -22
  511. package/dist/src/utils/path.d.ts +0 -14
  512. package/dist/src/utils/path.d.ts.map +0 -1
  513. package/dist/src/utils/path.js +0 -17
  514. package/dist/src/utils/rating.d.ts.map +0 -1
  515. package/dist/src/utils/rating.js +0 -73
  516. package/dist/src/utils/tag-mapping.d.ts.map +0 -1
  517. package/dist/src/utils/tag-mapping.js +0 -214
  518. package/dist/src/utils/write.d.ts.map +0 -1
  519. package/dist/src/utils/write.js +0 -17
  520. package/dist/src/version.d.ts +0 -2
  521. package/dist/src/version.d.ts.map +0 -1
  522. package/dist/src/version.js +0 -4
  523. package/dist/src/wasm.d.ts.map +0 -1
  524. package/dist/src/wasm.js +0 -0
  525. package/dist/src/web-utils/canvas.d.ts.map +0 -1
  526. package/dist/src/web-utils/canvas.js +0 -60
  527. package/dist/src/web-utils/data-url.d.ts.map +0 -1
  528. package/dist/src/web-utils/data-url.js +0 -34
  529. package/dist/src/web-utils/dom-integration.d.ts.map +0 -1
  530. package/dist/src/web-utils/dom-integration.js +0 -53
  531. package/dist/src/web-utils/index.d.ts.map +0 -1
  532. package/dist/src/web-utils/index.js +0 -21
  533. /package/dist/{src/bwf → bwf}/bext.d.ts +0 -0
  534. /package/dist/{src/constants → constants}/additional-properties.d.ts +0 -0
  535. /package/dist/{src/constants → constants}/basic-properties.d.ts +0 -0
  536. /package/dist/{src/constants → constants}/complex-properties.d.ts +0 -0
  537. /package/dist/{src/constants → constants}/format-mappings.d.ts +0 -0
  538. /package/dist/{src/constants → constants}/general-extended-properties.d.ts +0 -0
  539. /package/dist/{src/constants → constants}/index.d.ts +0 -0
  540. /package/dist/{src/constants → constants}/property-types.d.ts +0 -0
  541. /package/dist/{src/constants → constants}/specialized-properties.d.ts +0 -0
  542. /package/dist/{src/constants.d.ts → constants.d.ts} +0 -0
  543. /package/dist/{src/errors → errors}/classes.d.ts +0 -0
  544. /package/dist/{src/errors → errors}/guards.d.ts +0 -0
  545. /package/dist/{src/errors → errors}/index.d.ts +0 -0
  546. /package/dist/{src/errors.d.ts → errors.d.ts} +0 -0
  547. /package/dist/{src/file-utils → file-utils}/copy-and-find.d.ts +0 -0
  548. /package/dist/{src/file-utils → file-utils}/export-operations.d.ts +0 -0
  549. /package/dist/{src/file-utils → file-utils}/import-operations.d.ts +0 -0
  550. /package/dist/{src/file-utils → file-utils}/index.d.ts +0 -0
  551. /package/dist/{src/file-utils → file-utils}/mime-detection.d.ts +0 -0
  552. /package/dist/{src/folder-api → folder-api}/album-corroborate.d.ts +0 -0
  553. /package/dist/{src/folder-api → folder-api}/album-discs.d.ts +0 -0
  554. /package/dist/{src/folder-api → folder-api}/album-grouping.d.ts +0 -0
  555. /package/dist/{src/folder-api → folder-api}/album-identity.d.ts +0 -0
  556. /package/dist/{src/folder-api → folder-api}/album-types.d.ts +0 -0
  557. /package/dist/{src/folder-api → folder-api}/directory-walker.d.ts +0 -0
  558. /package/dist/{src/folder-api → folder-api}/file-processors.d.ts +0 -0
  559. /package/dist/{src/folder-api → folder-api}/folder-disc.d.ts +0 -0
  560. /package/dist/{src/folder-api → folder-api}/folder-operations.d.ts +0 -0
  561. /package/dist/{src/folder-api → folder-api}/index.d.ts +0 -0
  562. /package/dist/{src/folder-api → folder-api}/scan-for-albums.d.ts +0 -0
  563. /package/dist/{src/folder-api → folder-api}/scan-operations.d.ts +0 -0
  564. /package/dist/{src/folder-api → folder-api}/types.d.ts +0 -0
  565. /package/dist/{src/msgpack → msgpack}/decoder.d.ts +0 -0
  566. /package/dist/{src/msgpack → msgpack}/encoder.d.ts +0 -0
  567. /package/dist/{src/msgpack → msgpack}/index.d.ts +0 -0
  568. /package/dist/{src/msgpack → msgpack}/utils.d.ts +0 -0
  569. /package/dist/{src/runtime → runtime}/deno-detect.d.ts +0 -0
  570. /package/dist/{src/runtime → runtime}/loader-types.d.ts +0 -0
  571. /package/dist/{src/runtime → runtime}/module-loader-browser.d.ts +0 -0
  572. /package/dist/{src/runtime → runtime}/module-loader.d.ts +0 -0
  573. /package/dist/{src/runtime → runtime}/platform-io.d.ts +0 -0
  574. /package/dist/{src/runtime → runtime}/unified-loader/index.d.ts +0 -0
  575. /package/dist/{src/runtime → runtime}/unified-loader/loader.d.ts +0 -0
  576. /package/dist/{src/runtime → runtime}/unified-loader/module-loading.d.ts +0 -0
  577. /package/dist/{src/runtime → runtime}/unified-loader/module-selection.d.ts +0 -0
  578. /package/dist/{src/runtime → runtime}/unified-loader/types.d.ts +0 -0
  579. /package/dist/{src/runtime → runtime}/wasi-adapter/file-handle.d.ts +0 -0
  580. /package/dist/{src/runtime → runtime}/wasi-adapter/handle-state.d.ts +0 -0
  581. /package/dist/{src/runtime → runtime}/wasi-adapter/index.d.ts +0 -0
  582. /package/dist/{src/runtime → runtime}/wasi-adapter/mp4-items.d.ts +0 -0
  583. /package/dist/{src/runtime → runtime}/wasi-adapter/property-surface.d.ts +0 -0
  584. /package/dist/{src/runtime → runtime}/wasi-adapter/structured-fields.d.ts +0 -0
  585. /package/dist/{src/runtime → runtime}/wasi-adapter/tag-keys.d.ts +0 -0
  586. /package/dist/{src/runtime → runtime}/wasi-adapter/wasm-io.d.ts +0 -0
  587. /package/dist/{src/runtime → runtime}/wasi-fs-deno.d.ts +0 -0
  588. /package/dist/{src/runtime → runtime}/wasi-fs-node.d.ts +0 -0
  589. /package/dist/{src/runtime → runtime}/wasi-fs-provider.d.ts +0 -0
  590. /package/dist/{src/runtime → runtime}/wasi-host-loader.d.ts +0 -0
  591. /package/dist/{src/runtime → runtime}/wasi-host.d.ts +0 -0
  592. /package/dist/{src/runtime → runtime}/wasi-memory.d.ts +0 -0
  593. /package/dist/{src/simple → simple}/batch-operations.d.ts +0 -0
  594. /package/dist/{src/simple → simple}/config.d.ts +0 -0
  595. /package/dist/{src/simple → simple}/picture-operations.d.ts +0 -0
  596. /package/dist/{src/simple → simple}/tag-operations.d.ts +0 -0
  597. /package/dist/{src/simple → simple}/with-audio-file.d.ts +0 -0
  598. /package/dist/{src/taglib → taglib}/audio-file-base.d.ts +0 -0
  599. /package/dist/{src/taglib → taglib}/audio-file-bwf.d.ts +0 -0
  600. /package/dist/{src/taglib → taglib}/auto-dispose.d.ts +0 -0
  601. /package/dist/{src/taglib → taglib}/embind-adapter.d.ts +0 -0
  602. /package/dist/{src/taglib → taglib}/extra-state-registry.d.ts +0 -0
  603. /package/dist/{src/taglib → taglib}/index.d.ts +0 -0
  604. /package/dist/{src/taglib → taglib}/load-audio-data.d.ts +0 -0
  605. /package/dist/{src/taglib → taglib}/mp4-item-names.d.ts +0 -0
  606. /package/dist/{src/taglib → taglib}/mutable-tag-impl.d.ts +0 -0
  607. /package/dist/{src/taglib → taglib}/mutable-tag.d.ts +0 -0
  608. /package/dist/{src/taglib → taglib}/save-reconstruct.d.ts +0 -0
  609. /package/dist/{src/taglib → taglib}/taglib-class.d.ts +0 -0
  610. /package/dist/{src/taglib.d.ts → taglib.d.ts} +0 -0
  611. /package/dist/{src/types → types}/audio-formats.d.ts +0 -0
  612. /package/dist/{src/types → types}/bwf.d.ts +0 -0
  613. /package/dist/{src/types → types}/chapters.d.ts +0 -0
  614. /package/dist/{src/types → types}/config.d.ts +0 -0
  615. /package/dist/{src/types → types}/format-property-keys.d.ts +0 -0
  616. /package/dist/{src/types → types}/index.d.ts +0 -0
  617. /package/dist/{src/types → types}/metadata-mappings.d.ts +0 -0
  618. /package/dist/{src/types → types}/pictures.d.ts +0 -0
  619. /package/dist/{src/types → types}/tags.d.ts +0 -0
  620. /package/dist/{src/types.d.ts → types.d.ts} +0 -0
  621. /package/dist/{src/utils → utils}/file.d.ts +0 -0
  622. /package/dist/{src/utils → utils}/mirror-fields.d.ts +0 -0
  623. /package/dist/{src/utils → utils}/node-fs.d.ts +0 -0
  624. /package/dist/{src/utils → utils}/rating.d.ts +0 -0
  625. /package/dist/{src/utils → utils}/tag-mapping.d.ts +0 -0
  626. /package/dist/{src/utils → utils}/write.d.ts +0 -0
  627. /package/dist/{src/web-utils → web-utils}/canvas.d.ts +0 -0
  628. /package/dist/{src/web-utils → web-utils}/data-url.d.ts +0 -0
  629. /package/dist/{src/web-utils → web-utils}/dom-integration.d.ts +0 -0
  630. /package/dist/{src/web-utils → web-utils}/index.d.ts +0 -0
@@ -2,6 +2,7 @@ import type { AudioProperties, FileType, Picture, PropertyMap } from "../types.j
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";
5
+ import type { MediaChecksum, MediaChecksumOptions } from "./audio-file-checksum.js";
5
6
  import type { FormatPropertyKey } from "../types/format-property-keys.js";
6
7
  import type { NormalizedRating } from "../utils/rating.js";
7
8
  /**
@@ -66,6 +67,22 @@ export interface AudioFile {
66
67
  * and cannot be read back — never returns an empty buffer on failure.
67
68
  */
68
69
  getFileBuffer(): Uint8Array;
70
+ /**
71
+ * SHA-256 of the file's encoded media payload — the bytes that are the audio,
72
+ * not the tags around them — so the digest survives a tag edit, with one
73
+ * boundary: an ID3v2 tag appended after a FLAC's audio is inside the payload,
74
+ * so editing it does move the hash. Formats whose payload cannot be delimited
75
+ * answer the whole file instead and say so (`source: "file"`), where a tag
76
+ * edit does move the hash.
77
+ *
78
+ * Pass `{ basis: "pcm" }` for FLAC's STREAMINFO MD5 — the digest of the
79
+ * *uncompressed* stream, read straight from the file's first metadata block.
80
+ * Other formats throw {@link UnsupportedFormatError}.
81
+ *
82
+ * @throws {MetadataError} If the handle holds no file bytes and has no
83
+ * readable source (a partial handle that has already been saved).
84
+ */
85
+ mediaChecksum(options?: MediaChecksumOptions): Promise<MediaChecksum>;
69
86
  /**
70
87
  * Save all changes to a file on disk.
71
88
  * @param path - Optional file path. If not provided, saves to the original path.
@@ -0,0 +1 @@
1
+ {"version":3,"file":"audio-file-interface.d.ts","sourceRoot":"","sources":["../../src/taglib/audio-file-interface.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1 @@
1
+ {"version":3,"file":"auto-dispose.d.ts","sourceRoot":"","sources":["../../src/taglib/auto-dispose.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AA0B7C,6EAA6E;AAC7E,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,CAE5E;AAED,+EAA+E;AAC/E,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAE1D"}
@@ -0,0 +1,34 @@
1
+ //#region src/taglib/auto-dispose.ts
2
+ /**
3
+ * Best-effort safety net for forgetful callers (taglib-t4sn).
4
+ *
5
+ * The Full API requires an explicit dispose() — via `using` or a finally
6
+ * block — but nothing enforces it, and a forgotten wrapper leaks the native
7
+ * FileHandle for the life of the process (the Wasm C++ object on Emscripten,
8
+ * file buffers on WASI). tuneup's engine worker hit exactly this in its write
9
+ * path.
10
+ *
11
+ * The registry releases the FileHandle when the wrapper becomes unreachable
12
+ * WITHOUT an explicit dispose(). Explicit dispose() remains the preferred and
13
+ * deterministic path: it unregisters first, so the finalizer never runs after
14
+ * an explicit release.
15
+ *
16
+ * Safety: the finalizer only ever fires when the wrapper is garbage, so a live
17
+ * wrapper can never observe a destroyed handle. destroy() is idempotent on
18
+ * both backends (WasiFileHandle nulls fields and sets `destroyed`; the Embind
19
+ * binding resets unique_ptrs), so even a double-destroy via the open()-failure
20
+ * path plus a later finalizer run is harmless.
21
+ */
22
+ const registry = new FinalizationRegistry((handle) => {
23
+ handle.destroy();
24
+ });
25
+ /** @internal Register `handle` for release when `target` becomes garbage. */
26
+ function registerAutoDispose(target, handle) {
27
+ registry.register(target, handle, target);
28
+ }
29
+ /** @internal Drop the pending registration for `target` (explicit dispose). */
30
+ function unregisterAutoDispose(target) {
31
+ registry.unregister(target);
32
+ }
33
+ //#endregion
34
+ export { registerAutoDispose, unregisterAutoDispose };
@@ -0,0 +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,CAgLtE"}
@@ -0,0 +1,137 @@
1
+ //#region src/taglib/embind-adapter.ts
2
+ /** @internal Type guard for `BitrateMode` strings emitted by the Embind layer. */
3
+ function isValidBitrateMode(value) {
4
+ return value === "CBR" || value === "VBR" || value === "ABR";
5
+ }
6
+ /** @internal Wrap an Embind FileHandle with a Proxy for the data-oriented interface. */
7
+ function wrapEmbindHandle(raw) {
8
+ const stagedId3v2Frames = {};
9
+ let destroyed = false;
10
+ const overrides = {
11
+ getTagData() {
12
+ const tw = raw.getTag();
13
+ return {
14
+ title: tw.title(),
15
+ artist: tw.artist(),
16
+ album: tw.album(),
17
+ comment: tw.comment(),
18
+ genre: tw.genre(),
19
+ year: tw.year(),
20
+ track: tw.track()
21
+ };
22
+ },
23
+ setTagData(data) {
24
+ const tw = raw.getTag();
25
+ if (data.title !== void 0) tw.setTitle(data.title);
26
+ if (data.artist !== void 0) tw.setArtist(data.artist);
27
+ if (data.album !== void 0) tw.setAlbum(data.album);
28
+ if (data.comment !== void 0) tw.setComment(data.comment);
29
+ if (data.genre !== void 0) tw.setGenre(data.genre);
30
+ if (data.year !== void 0) tw.setYear(data.year);
31
+ if (data.track !== void 0) tw.setTrack(data.track);
32
+ },
33
+ getBextData() {
34
+ const v = raw.getBextData();
35
+ if (v === void 0 || v === null) return void 0;
36
+ const u8 = v instanceof Uint8Array ? v : new Uint8Array(v);
37
+ return u8.length > 0 ? u8 : void 0;
38
+ },
39
+ setBextData(data) {
40
+ raw.setBextData(data ?? null);
41
+ },
42
+ getIxml() {
43
+ const v = raw.getIxml();
44
+ return typeof v === "string" && v.length > 0 ? v : void 0;
45
+ },
46
+ setIxml(data) {
47
+ raw.setIxml(data ?? null);
48
+ },
49
+ getLyrics() {
50
+ return (raw.getProperties()["LYRICS"] ?? []).map((text) => ({
51
+ text,
52
+ description: "",
53
+ language: ""
54
+ }));
55
+ },
56
+ setLyrics(lyrics) {
57
+ const handle = raw;
58
+ const props = handle.getProperties();
59
+ if (lyrics.length > 0) props["LYRICS"] = lyrics.map((l) => l.text);
60
+ else delete props["LYRICS"];
61
+ handle.setProperties(props);
62
+ },
63
+ setId3v2Frames(id, data) {
64
+ stagedId3v2Frames[id] = data.map((d) => new Uint8Array(d));
65
+ raw.setId3v2Frames(id, data);
66
+ },
67
+ removeId3v2Frames(id) {
68
+ stagedId3v2Frames[id] = [];
69
+ raw.removeId3v2Frames(id);
70
+ },
71
+ getStagedId3v2Frames() {
72
+ return Object.keys(stagedId3v2Frames).length > 0 ? { ...stagedId3v2Frames } : void 0;
73
+ },
74
+ hasId3Tags() {
75
+ const v = raw.hasId3Tags();
76
+ if (!v || typeof v !== "object") return {
77
+ v1: false,
78
+ v2: false
79
+ };
80
+ const o = v;
81
+ return {
82
+ v1: o.v1 === true,
83
+ v2: o.v2 === true
84
+ };
85
+ },
86
+ stripId3Tags(opts) {
87
+ raw.stripId3Tags(opts);
88
+ },
89
+ destroy() {
90
+ if (destroyed) return;
91
+ destroyed = true;
92
+ raw.destroy();
93
+ },
94
+ get destroyed() {
95
+ return destroyed;
96
+ },
97
+ setMp4ItemRemovals(removals) {
98
+ const handle = raw;
99
+ for (const name of removals) handle.removeMP4Item(name);
100
+ },
101
+ getAudioProperties() {
102
+ const pw = raw.getAudioProperties();
103
+ if (!pw) return null;
104
+ const containerFormat = pw.containerFormat() || "unknown";
105
+ const codec = pw.codec() || "unknown";
106
+ const mpegVersion = pw.mpegVersion();
107
+ const formatVersion = pw.formatVersion();
108
+ const bitrateMode = pw.bitrateMode();
109
+ return {
110
+ duration: pw.lengthInSeconds(),
111
+ durationMs: pw.lengthInMilliseconds(),
112
+ bitrate: pw.bitrate(),
113
+ sampleRate: pw.sampleRate(),
114
+ channels: pw.channels(),
115
+ bitsPerSample: pw.bitsPerSample(),
116
+ codec,
117
+ containerFormat,
118
+ isLossless: pw.isLossless(),
119
+ ...mpegVersion > 0 ? {
120
+ mpegVersion,
121
+ mpegLayer: pw.mpegLayer()
122
+ } : {},
123
+ ...containerFormat === "MP4" || containerFormat === "ASF" ? { isEncrypted: pw.isEncrypted() } : {},
124
+ ...formatVersion > 0 ? { formatVersion } : {},
125
+ ...isValidBitrateMode(bitrateMode) ? { bitrateMode } : {},
126
+ ...containerFormat === "OGG" && codec === "Opus" ? { outputGainDb: pw.outputGainDb() } : {}
127
+ };
128
+ }
129
+ };
130
+ return new Proxy(raw, { get(target, prop, receiver) {
131
+ if (prop in overrides) return overrides[prop];
132
+ const value = Reflect.get(target, prop, receiver);
133
+ return typeof value === "function" ? value.bind(target) : value;
134
+ } });
135
+ }
136
+ //#endregion
137
+ export { wrapEmbindHandle };
@@ -0,0 +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"}
@@ -0,0 +1,72 @@
1
+ //#region src/taglib/extra-state-registry.ts
2
+ function chapterStyle(chapters) {
3
+ const s = chapters[0]?.source;
4
+ return s === "nero" || s === "both" ? s : "quicktime";
5
+ }
6
+ const EXTRA_FIELDS = [
7
+ {
8
+ name: "pictures",
9
+ copy(target, source, complete) {
10
+ const v = source.getPictures();
11
+ if (complete || v.length > 0) target.setPictures(v);
12
+ }
13
+ },
14
+ {
15
+ name: "ratings",
16
+ copy(target, source, complete) {
17
+ const v = source.getRatings();
18
+ if (complete || v.length > 0) target.setRatings(v);
19
+ }
20
+ },
21
+ {
22
+ name: "lyrics",
23
+ copy(target, source, complete) {
24
+ const v = source.getLyrics();
25
+ if (complete || v.length > 0) target.setLyrics(v);
26
+ }
27
+ },
28
+ {
29
+ name: "chapters",
30
+ copy(target, source, complete) {
31
+ const v = source.getChapters();
32
+ if (complete || v.length > 0) target.setChapters(v, chapterStyle(v));
33
+ }
34
+ },
35
+ {
36
+ name: "bextData",
37
+ copy(target, source, complete) {
38
+ const v = source.getBextData();
39
+ if (v !== void 0) target.setBextData(v);
40
+ else if (complete) target.setBextData(null);
41
+ }
42
+ },
43
+ {
44
+ name: "ixml",
45
+ copy(target, source, complete) {
46
+ const v = source.getIxml();
47
+ if (v !== void 0) target.setIxml(v);
48
+ else if (complete) target.setIxml(null);
49
+ }
50
+ },
51
+ {
52
+ name: "_mp4ItemRemovals",
53
+ copy(target, source, complete) {
54
+ const v = source.getMp4ItemRemovals?.();
55
+ if (complete || v !== void 0 && v.length > 0) target.setMp4ItemRemovals?.(v ?? []);
56
+ }
57
+ },
58
+ {
59
+ name: "id3v2Frames",
60
+ copy(target, source) {
61
+ const staged = source.getStagedId3v2Frames?.();
62
+ if (!staged) return;
63
+ for (const [id, bodies] of Object.entries(staged)) target.setId3v2Frames(id, bodies);
64
+ }
65
+ }
66
+ ];
67
+ /** Copy every registered extra-state field from `source` onto `target`. */
68
+ function copyExtraState(target, source, sourceComplete) {
69
+ for (const field of EXTRA_FIELDS) field.copy(target, source, sourceComplete);
70
+ }
71
+ //#endregion
72
+ export { EXTRA_FIELDS, copyExtraState };
@@ -1,6 +1,5 @@
1
1
  /**
2
2
  * Validation and mapping helpers for the raw ID3v2 frame API (taglib-b67).
3
- * See docs/superpowers/specs/2026-07-09-raw-id3v2-frames-design.md.
4
3
  */
5
4
  import type { RawId3v2Frame } from "../wasm.js";
6
5
  import type { Id3v2Frame } from "../constants/complex-properties.js";
@@ -0,0 +1 @@
1
+ {"version":3,"file":"id3v2-frames.d.ts","sourceRoot":"","sources":["../../src/taglib/id3v2-frames.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAIrE,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAQ9C;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAQ3E;AAED,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,IAAI,CAUtE;AAED,+EAA+E;AAC/E,wBAAgB,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,UAAU,CAM9D"}
@@ -0,0 +1,25 @@
1
+ import { MetadataError, UnsupportedFormatError } from "../errors/classes.js";
2
+ //#region src/taglib/id3v2-frames.ts
3
+ /**
4
+ * Validation and mapping helpers for the raw ID3v2 frame API (taglib-b67).
5
+ */
6
+ const FRAME_ID_PATTERN = /^[A-Z0-9]{4}$/;
7
+ function assertMp3(format) {
8
+ if (format !== "MP3" && format !== "AAC") throw new UnsupportedFormatError(format, ["MP3", "AAC"], { operation: "id3v2Frames" });
9
+ }
10
+ function assertFrameId(id, operation) {
11
+ if (!FRAME_ID_PATTERN.test(id)) throw new MetadataError(operation, `Invalid ID3v2 frame ID: "${id}". Frame IDs must match [A-Z0-9]{4}`, id);
12
+ }
13
+ function assertFrameBodies(id, data) {
14
+ for (const body of data) if (body.length === 0) throw new MetadataError("write", "Frame data must not be empty: zero-size ID3v2 frames are invalid", id);
15
+ }
16
+ /** Normalize a handle-level frame for the public API (zero flags → absent). */
17
+ function toPublicFrame(frame) {
18
+ return {
19
+ id: frame.id,
20
+ data: frame.data,
21
+ ...frame.flags ? { flags: frame.flags } : {}
22
+ };
23
+ }
24
+ //#endregion
25
+ export { assertFrameBodies, assertFrameId, assertMp3, toPublicFrame };
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/taglib/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,YAAY,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEzD;;GAEG;AACH,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,aAAa,EACb,eAAe,EACf,aAAa,EACb,wBAAwB,EACxB,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,WAAW,EACX,yBAAyB,EACzB,sBAAsB,GACvB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}
@@ -0,0 +1,7 @@
1
+ import { SUPPORTED_FORMATS, TagLibError } from "../errors/base.js";
2
+ import { EnvironmentError, FileOperationError, InvalidFormatError, MemoryError, MetadataError, TagLibInitializationError, UnsupportedFormatError } from "../errors/classes.js";
3
+ import { isEnvironmentError, isFileOperationError, isInvalidFormatError, isMemoryError, isMetadataError, isTagLibError, isUnsupportedFormatError } from "../errors/guards.js";
4
+ import "../errors.js";
5
+ import { AudioFileImpl } from "./audio-file-impl.js";
6
+ import { TagLib, createTagLib } from "./taglib-class.js";
7
+ export { AudioFileImpl, EnvironmentError, FileOperationError, InvalidFormatError, MemoryError, MetadataError, SUPPORTED_FORMATS, TagLib, TagLibError, TagLibInitializationError, UnsupportedFormatError, createTagLib, isEnvironmentError, isFileOperationError, isInvalidFormatError, isMemoryError, isMetadataError, isTagLibError, isUnsupportedFormatError };
@@ -0,0 +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"}
@@ -0,0 +1,54 @@
1
+ import { metadataFitsInHeader, trailerFitsInFooter } from "./metadata-extent.js";
2
+ import { getFileSize, readFileData, readPartialFileData } from "../utils/file.js";
3
+ //#region src/taglib/load-audio-data.ts
4
+ /**
5
+ * Load audio data from various sources, with optional partial loading.
6
+ * @internal Used by TagLib.open()
7
+ */
8
+ 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
+ };
52
+ }
53
+ //#endregion
54
+ export { loadAudioData };
@@ -0,0 +1,85 @@
1
+ export interface ByteRange {
2
+ offset: number;
3
+ length: number;
4
+ }
5
+ export interface RangeWalk {
6
+ kind: "ranges" | "fallback";
7
+ ranges: ByteRange[];
8
+ detail: string;
9
+ }
10
+ /**
11
+ * Start offset of a trailing tag run (ID3v1 and/or APEv2), scanning inward.
12
+ * TagLib ends a FLAC stream at its ID3v1 location for the same reason.
13
+ */
14
+ export declare function trailingTagStart(bytes: Uint8Array, end?: number): number;
15
+ export declare function walkMpeg(bytes: Uint8Array): RangeWalk;
16
+ /** STREAMINFO is a FLAC file's first metadata block: the `fLaC` marker, a
17
+ * 4-byte block header, then its 34-byte payload, whose last 16 bytes are the
18
+ * MD5 of the *uncompressed* stream — the digest `basis: "pcm"` reports. */
19
+ export declare function flacStreamInfoMd5(bytes: Uint8Array): string | undefined;
20
+ /**
21
+ * FLAC's encoded payload: the audio frames between the end of the metadata
22
+ * block chain and an appended ID3v1/APEv2 tag. An appended ID3v2 is *inside*
23
+ * the payload: TagLib ends a FLAC stream at its ID3v1 location
24
+ * (`flacfile.cpp:595-599`), and a tag not at that location is stream by the
25
+ * same rule — TagLib is this feature's ground truth, so the boundary is pinned
26
+ * by `tests/media-ranges.test.ts`, not "fixed" here. Nothing inside a FLAC
27
+ * stream delimits the frames — the block chain's end is the start, and the
28
+ * stream runs to EOF — so the whole rule is the block walk plus the
29
+ * trailing-tag trim.
30
+ *
31
+ * `flacAudioStart` may legitimately answer past `bytes.length`, because a
32
+ * block's declared length can reach beyond the bytes in hand: that is the
33
+ * extent the chain *implies*, and hashing it would read nothing while claiming
34
+ * a payload. The `end <= start` guard is what refuses it.
35
+ *
36
+ * The walk deliberately does **not** carry the STREAMINFO digest: a range result
37
+ * is not a digest carrier, and the PCM basis reads the digest with
38
+ * `flacStreamInfoMd5` directly. A second, unread path to the same value rots.
39
+ */
40
+ export declare function walkFlac(bytes: Uint8Array): RangeWalk;
41
+ /**
42
+ * MP4's payload: the contents of every non-empty top-level `mdat`, in file
43
+ * order — a fragmented file spreads its audio over several, and a rewritten one
44
+ * may carry an empty `mdat`, which is legal and contributes nothing. The header
45
+ * is excluded, and it is 16 bytes rather than 8 when the size took the 64-bit
46
+ * form.
47
+ *
48
+ * Deliberately not `metadata-extent.ts`'s atom walk: that one looks for `moov`
49
+ * to size the partial-load gate, so it bails on any size below 8 and has no
50
+ * 64-bit path. The checksum's rules differ — `size === 0` runs to EOF, a 64-bit
51
+ * size is legal, and anything the walk cannot fully account for is a fallback —
52
+ * so the two contracts stay apart rather than share an abstraction.
53
+ *
54
+ * Those fallbacks are the point. A range that runs past the buffer would hash
55
+ * zero padding while `bytesHashed` counts it as payload, and bytes no atom
56
+ * accounts for are not something this walk may call audio.
57
+ */
58
+ export declare function walkMp4(bytes: Uint8Array): RangeWalk;
59
+ /**
60
+ * WAV's payload: every non-empty `data` chunk's contents, payload only.
61
+ *
62
+ * The chunk list is the whole rule: a chunk is a 4-byte id, a 4-byte
63
+ * little-endian size that counts the payload but not the header, and that
64
+ * payload padded to an even length. Tag chunks (`LIST`, `id3 `, `bext`, `iXML`)
65
+ * are therefore skipped by construction rather than by name, and chunks that
66
+ * follow `data` cannot move or clip the range — which is the property the
67
+ * repo's `wav/kiss-snippet.wav` pins, `data` first and `LIST` + `id3 ` behind it.
68
+ *
69
+ * A chunk whose declared size reaches past the buffer is a fallback, not a
70
+ * clamp: hashing the bytes that survive would report a payload the file does not
71
+ * claim. That is also the truncated-file case.
72
+ */
73
+ export declare function walkWav(bytes: Uint8Array): RangeWalk;
74
+ /**
75
+ * The per-format dispatch: the one entry point a consumer calls, and the one
76
+ * place a format-level fallback becomes a whole-file range.
77
+ *
78
+ * Consumers MUST dispatch on `kind`, never on `ranges.length`. The walks
79
+ * themselves answer a fallback with `ranges: []`, which this function replaces
80
+ * with the whole file — so after normalization there is no empty-ranges answer
81
+ * to detect, and a caller testing `ranges.length === 0` would read a fallback as
82
+ * a genuine payload and hash the whole file while claiming a range.
83
+ */
84
+ export declare function mediaRanges(format: string, bytes: Uint8Array): RangeWalk;
85
+ //# sourceMappingURL=media-ranges.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"media-ranges.d.ts","sourceRoot":"","sources":["../../src/taglib/media-ranges.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,QAAQ,GAAG,UAAU,CAAC;IAC5B,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB;AAkCD;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,UAAU,EACjB,GAAG,SAAe,GACjB,MAAM,CAoBR;AA8DD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS,CAWrD;AAED;;2EAE2E;AAC3E,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,CAmBvE;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS,CAUrD;AAqBD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS,CAyBpD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS,CAsBpD;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,SAAS,CAgCxE"}