taglib-wasm 2.3.0 → 2.4.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 (635) hide show
  1. package/LICENSE +2 -2
  2. package/README.md +72 -64
  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/constants/properties.d.ts +43 -0
  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} +8 -2
  41. package/dist/deno-compile.d.ts.map +1 -0
  42. package/dist/deno-compile.js +113 -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.map +1 -0
  47. package/dist/errors/base.js +66 -0
  48. package/dist/errors/classes.d.ts.map +1 -0
  49. package/dist/errors/classes.js +164 -0
  50. package/dist/errors/guards.d.ts.map +1 -0
  51. package/dist/errors/guards.js +26 -0
  52. package/dist/errors/index.d.ts.map +1 -0
  53. package/dist/errors/index.js +4 -0
  54. package/dist/errors.d.ts.map +1 -0
  55. package/dist/errors.js +5 -0
  56. package/dist/file-utils/copy-and-find.d.ts.map +1 -0
  57. package/dist/file-utils/copy-and-find.js +107 -0
  58. package/dist/file-utils/export-operations.d.ts.map +1 -0
  59. package/dist/file-utils/export-operations.js +84 -0
  60. package/dist/file-utils/import-operations.d.ts.map +1 -0
  61. package/dist/file-utils/import-operations.js +109 -0
  62. package/dist/file-utils/index.d.ts.map +1 -0
  63. package/dist/file-utils/index.js +5 -0
  64. package/dist/file-utils/mime-detection.d.ts.map +1 -0
  65. package/dist/file-utils/mime-detection.js +44 -0
  66. package/dist/folder-api/album-corroborate.d.ts.map +1 -0
  67. package/dist/folder-api/album-corroborate.js +35 -0
  68. package/dist/folder-api/album-discs.d.ts.map +1 -0
  69. package/dist/folder-api/album-discs.js +119 -0
  70. package/dist/folder-api/album-grouping.d.ts.map +1 -0
  71. package/dist/folder-api/album-grouping.js +161 -0
  72. package/dist/folder-api/album-identity.d.ts.map +1 -0
  73. package/dist/folder-api/album-identity.js +165 -0
  74. package/dist/folder-api/album-types.d.ts.map +1 -0
  75. package/dist/folder-api/album-types.js +1 -0
  76. package/dist/folder-api/directory-walker.d.ts.map +1 -0
  77. package/dist/folder-api/directory-walker.js +27 -0
  78. package/dist/folder-api/file-processors.d.ts.map +1 -0
  79. package/dist/folder-api/file-processors.js +52 -0
  80. package/dist/folder-api/folder-disc.d.ts.map +1 -0
  81. package/dist/folder-api/folder-disc.js +166 -0
  82. package/dist/folder-api/folder-operations.d.ts.map +1 -0
  83. package/dist/folder-api/folder-operations.js +69 -0
  84. package/dist/folder-api/index.d.ts.map +1 -0
  85. package/dist/{src/folder-api → folder-api}/index.js +1 -8
  86. package/dist/folder-api/scan-for-albums.d.ts.map +1 -0
  87. package/dist/folder-api/scan-for-albums.js +25 -0
  88. package/dist/folder-api/scan-operations.d.ts.map +1 -0
  89. package/dist/folder-api/scan-operations.js +79 -0
  90. package/dist/folder-api/types.d.ts.map +1 -0
  91. package/dist/folder-api/types.js +21 -0
  92. package/dist/folder.d.ts +1 -1
  93. package/dist/folder.d.ts.map +1 -1
  94. package/dist/folder.js +7 -2
  95. package/dist/global.d.js +1 -0
  96. package/dist/index.browser.d.ts +29 -30
  97. package/dist/index.browser.d.ts.map +1 -1
  98. package/dist/index.browser.js +4106 -4479
  99. package/dist/index.d.ts +26 -26
  100. package/dist/index.d.ts.map +1 -1
  101. package/dist/index.js +40 -185
  102. package/dist/msgpack/decoder.d.ts.map +1 -0
  103. package/dist/msgpack/decoder.js +177 -0
  104. package/dist/msgpack/encoder.d.ts.map +1 -0
  105. package/dist/msgpack/encoder.js +211 -0
  106. package/dist/msgpack/index.d.ts.map +1 -0
  107. package/dist/msgpack/index.js +5 -0
  108. package/dist/{src/msgpack → msgpack}/types.d.ts +1 -1
  109. package/dist/msgpack/types.d.ts.map +1 -0
  110. package/dist/msgpack/types.js +13 -0
  111. package/dist/msgpack/utils.d.ts.map +1 -0
  112. package/dist/msgpack/utils.js +116 -0
  113. package/dist/rating.d.ts +1 -1
  114. package/dist/rating.d.ts.map +1 -1
  115. package/dist/rating.js +2 -2
  116. package/dist/runtime/deno-detect.d.ts +19 -0
  117. package/dist/runtime/deno-detect.d.ts.map +1 -0
  118. package/dist/runtime/deno-detect.js +26 -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 +168 -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/runtime/wasi-adapter/adapter.d.ts.map +1 -0
  141. package/dist/runtime/wasi-adapter/adapter.js +114 -0
  142. package/dist/runtime/wasi-adapter/audio-properties.d.ts.map +1 -0
  143. package/dist/runtime/wasi-adapter/audio-properties.js +120 -0
  144. package/dist/runtime/wasi-adapter/file-handle.d.ts.map +1 -0
  145. package/dist/runtime/wasi-adapter/file-handle.js +181 -0
  146. package/dist/runtime/wasi-adapter/handle-state.d.ts.map +1 -0
  147. package/dist/runtime/wasi-adapter/handle-state.js +48 -0
  148. package/dist/runtime/wasi-adapter/index.d.ts.map +1 -0
  149. package/dist/{src/runtime → runtime}/wasi-adapter/index.js +1 -3
  150. package/dist/runtime/wasi-adapter/mp4-items.d.ts.map +1 -0
  151. package/dist/runtime/wasi-adapter/mp4-items.js +97 -0
  152. package/dist/runtime/wasi-adapter/path-open.d.ts.map +1 -0
  153. package/dist/runtime/wasi-adapter/path-open.js +101 -0
  154. package/dist/runtime/wasi-adapter/property-surface.d.ts.map +1 -0
  155. package/dist/runtime/wasi-adapter/property-surface.js +96 -0
  156. package/dist/runtime/wasi-adapter/structured-fields.d.ts.map +1 -0
  157. package/dist/runtime/wasi-adapter/structured-fields.js +144 -0
  158. package/dist/runtime/wasi-adapter/tag-keys.d.ts.map +1 -0
  159. package/dist/runtime/wasi-adapter/tag-keys.js +65 -0
  160. package/dist/runtime/wasi-adapter/wasm-io.d.ts.map +1 -0
  161. package/dist/runtime/wasi-adapter/wasm-io.js +154 -0
  162. package/dist/runtime/wasi-fs-deno.d.ts.map +1 -0
  163. package/dist/runtime/wasi-fs-deno.js +25 -0
  164. package/dist/runtime/wasi-fs-node.d.ts.map +1 -0
  165. package/dist/runtime/wasi-fs-node.js +58 -0
  166. package/dist/runtime/wasi-fs-provider.d.ts.map +1 -0
  167. package/dist/runtime/wasi-fs-provider.js +1 -0
  168. package/dist/runtime/wasi-host-loader.d.ts.map +1 -0
  169. package/dist/runtime/wasi-host-loader.js +101 -0
  170. package/dist/runtime/wasi-host.d.ts.map +1 -0
  171. package/dist/runtime/wasi-host.js +199 -0
  172. package/dist/runtime/wasi-memory.d.ts.map +1 -0
  173. package/dist/runtime/wasi-memory.js +179 -0
  174. package/dist/runtime/wasmer-sdk-loader/types.d.ts.map +1 -0
  175. package/dist/runtime/wasmer-sdk-loader/types.js +15 -0
  176. package/dist/simple/batch-operations.d.ts.map +1 -0
  177. package/dist/simple/batch-operations.js +245 -0
  178. package/dist/simple/checksum-operations.d.ts.map +1 -0
  179. package/dist/simple/checksum-operations.js +28 -0
  180. package/dist/simple/config.d.ts.map +1 -0
  181. package/dist/simple/config.js +17 -0
  182. package/dist/simple/index.d.ts.map +1 -0
  183. package/dist/simple/index.js +8 -0
  184. package/dist/simple/picture-operations.d.ts.map +1 -0
  185. package/dist/simple/picture-operations.js +132 -0
  186. package/dist/simple/tag-operations.d.ts.map +1 -0
  187. package/dist/simple/tag-operations.js +125 -0
  188. package/dist/simple/with-audio-file.d.ts.map +1 -0
  189. package/dist/simple/with-audio-file.js +28 -0
  190. package/dist/simple.browser.d.ts +2 -2
  191. package/dist/simple.browser.d.ts.map +1 -1
  192. package/dist/simple.browser.js +3405 -3692
  193. package/dist/simple.d.ts +1 -1
  194. package/dist/simple.d.ts.map +1 -1
  195. package/dist/simple.js +8 -2
  196. package/dist/taglib/audio-file-base.d.ts.map +1 -0
  197. package/dist/taglib/audio-file-base.js +166 -0
  198. package/dist/taglib/audio-file-bwf.d.ts.map +1 -0
  199. package/dist/taglib/audio-file-bwf.js +33 -0
  200. package/dist/taglib/audio-file-checksum.d.ts.map +1 -0
  201. package/dist/taglib/audio-file-checksum.js +90 -0
  202. package/dist/taglib/audio-file-impl.d.ts.map +1 -0
  203. package/dist/taglib/audio-file-impl.js +234 -0
  204. package/dist/taglib/audio-file-interface.d.ts.map +1 -0
  205. package/dist/taglib/audio-file-interface.js +1 -0
  206. package/dist/taglib/auto-dispose.d.ts.map +1 -0
  207. package/dist/taglib/auto-dispose.js +34 -0
  208. package/dist/taglib/embind-adapter.d.ts.map +1 -0
  209. package/dist/taglib/embind-adapter.js +138 -0
  210. package/dist/taglib/extra-state-registry.d.ts.map +1 -0
  211. package/dist/taglib/extra-state-registry.js +72 -0
  212. package/dist/{src/taglib → taglib}/id3v2-frames.d.ts +0 -1
  213. package/dist/taglib/id3v2-frames.d.ts.map +1 -0
  214. package/dist/taglib/id3v2-frames.js +25 -0
  215. package/dist/taglib/index.d.ts.map +1 -0
  216. package/dist/taglib/index.js +7 -0
  217. package/dist/taglib/load-audio-data.d.ts.map +1 -0
  218. package/dist/taglib/load-audio-data.js +54 -0
  219. package/dist/taglib/media-ranges.d.ts.map +1 -0
  220. package/dist/taglib/media-ranges.js +309 -0
  221. package/dist/taglib/metadata-extent.d.ts.map +1 -0
  222. package/dist/taglib/metadata-extent.js +394 -0
  223. package/dist/taglib/mp4-item-names.d.ts.map +1 -0
  224. package/dist/taglib/mp4-item-names.js +14 -0
  225. package/dist/taglib/mutable-tag-impl.d.ts.map +1 -0
  226. package/dist/taglib/mutable-tag-impl.js +81 -0
  227. package/dist/taglib/mutable-tag.d.ts.map +1 -0
  228. package/dist/taglib/mutable-tag.js +1 -0
  229. package/dist/taglib/save-reconstruct.d.ts.map +1 -0
  230. package/dist/taglib/save-reconstruct.js +53 -0
  231. package/dist/taglib/taglib-class.d.ts.map +1 -0
  232. package/dist/taglib/taglib-class.js +146 -0
  233. package/dist/taglib-wasi.wasm +0 -0
  234. package/dist/taglib.d.ts.map +1 -0
  235. package/dist/taglib.js +7 -0
  236. package/dist/{src/types → types}/audio-formats.d.ts +5 -1
  237. package/dist/types/audio-formats.d.ts.map +1 -0
  238. package/dist/types/audio-formats.js +6 -0
  239. package/dist/types/bwf.d.ts.map +1 -0
  240. package/dist/types/bwf.js +1 -0
  241. package/dist/types/chapters.d.ts.map +1 -0
  242. package/dist/types/chapters.js +1 -0
  243. package/dist/types/config.d.ts.map +1 -0
  244. package/dist/types/config.js +1 -0
  245. package/dist/types/format-property-keys.d.ts.map +1 -0
  246. package/dist/types/format-property-keys.js +1 -0
  247. package/dist/types/index.d.ts.map +1 -0
  248. package/dist/types/index.js +9 -0
  249. package/dist/types/metadata-mappings.d.ts.map +1 -0
  250. package/dist/types/metadata-mappings.js +323 -0
  251. package/dist/types/pictures.d.ts.map +1 -0
  252. package/dist/types/pictures.js +79 -0
  253. package/dist/types/tags.d.ts.map +1 -0
  254. package/dist/types/tags.js +1 -0
  255. package/dist/types.d.ts.map +1 -0
  256. package/dist/types.js +5 -0
  257. package/dist/utils/file.d.ts.map +1 -0
  258. package/dist/utils/file.js +43 -0
  259. package/dist/utils/mirror-fields.d.ts.map +1 -0
  260. package/dist/utils/mirror-fields.js +107 -0
  261. package/dist/utils/node-fs.d.ts.map +1 -0
  262. package/dist/utils/node-fs.js +36 -0
  263. package/dist/utils/path.d.ts.map +1 -0
  264. package/dist/utils/path.js +52 -0
  265. package/dist/utils/rating.d.ts.map +1 -0
  266. package/dist/utils/rating.js +150 -0
  267. package/dist/utils/tag-mapping.d.ts.map +1 -0
  268. package/dist/utils/tag-mapping.js +207 -0
  269. package/dist/utils/write.d.ts.map +1 -0
  270. package/dist/utils/write.js +18 -0
  271. package/dist/version.d.ts +2 -0
  272. package/dist/version.d.ts.map +1 -0
  273. package/dist/version.js +4 -0
  274. package/dist/wasm.d.ts.map +1 -0
  275. package/dist/wasm.js +1 -0
  276. package/dist/web-utils/canvas.d.ts.map +1 -0
  277. package/dist/web-utils/canvas.js +97 -0
  278. package/dist/web-utils/data-url.d.ts.map +1 -0
  279. package/dist/web-utils/data-url.js +54 -0
  280. package/dist/web-utils/dom-integration.d.ts.map +1 -0
  281. package/dist/web-utils/dom-integration.js +105 -0
  282. package/dist/web-utils/index.d.ts.map +1 -0
  283. package/dist/web-utils/index.js +4 -0
  284. package/dist/web.browser.d.ts +5 -5
  285. package/dist/web.browser.d.ts.map +1 -1
  286. package/dist/web.browser.js +3169 -3411
  287. package/dist/web.d.ts +1 -1
  288. package/dist/web.d.ts.map +1 -1
  289. package/dist/web.js +5 -2
  290. package/package.json +136 -100
  291. package/dist/src/bwf/bext.d.ts.map +0 -1
  292. package/dist/src/bwf/bext.js +0 -126
  293. package/dist/src/constants/additional-properties.js +0 -204
  294. package/dist/src/constants/basic-properties.d.ts.map +0 -1
  295. package/dist/src/constants/basic-properties.js +0 -89
  296. package/dist/src/constants/complex-properties.d.ts.map +0 -1
  297. package/dist/src/constants/complex-properties.js +0 -0
  298. package/dist/src/constants/format-mappings.d.ts.map +0 -1
  299. package/dist/src/constants/format-mappings.js +0 -54
  300. package/dist/src/constants/general-extended-properties.js +0 -254
  301. package/dist/src/constants/index.d.ts.map +0 -1
  302. package/dist/src/constants/index.js +0 -4
  303. package/dist/src/constants/properties.d.ts +0 -877
  304. package/dist/src/constants/properties.d.ts.map +0 -1
  305. package/dist/src/constants/properties.js +0 -95
  306. package/dist/src/constants/property-types.d.ts.map +0 -1
  307. package/dist/src/constants/property-types.js +0 -0
  308. package/dist/src/constants/specialized-properties.js +0 -223
  309. package/dist/src/constants/utilities.d.ts.map +0 -1
  310. package/dist/src/constants/utilities.js +0 -33
  311. package/dist/src/constants.d.ts.map +0 -1
  312. package/dist/src/constants.js +0 -1
  313. package/dist/src/deno-compile.d.ts.map +0 -1
  314. package/dist/src/deno-compile.js +0 -75
  315. package/dist/src/errors/base.d.ts.map +0 -1
  316. package/dist/src/errors/base.js +0 -49
  317. package/dist/src/errors/classes.d.ts.map +0 -1
  318. package/dist/src/errors/classes.js +0 -170
  319. package/dist/src/errors/guards.d.ts.map +0 -1
  320. package/dist/src/errors/guards.js +0 -39
  321. package/dist/src/errors/index.d.ts.map +0 -1
  322. package/dist/src/errors/index.js +0 -39
  323. package/dist/src/errors.d.ts.map +0 -1
  324. package/dist/src/errors.js +0 -1
  325. package/dist/src/file-utils/copy-and-find.d.ts.map +0 -1
  326. package/dist/src/file-utils/copy-and-find.js +0 -89
  327. package/dist/src/file-utils/export-operations.d.ts.map +0 -1
  328. package/dist/src/file-utils/export-operations.js +0 -40
  329. package/dist/src/file-utils/import-operations.d.ts.map +0 -1
  330. package/dist/src/file-utils/import-operations.js +0 -42
  331. package/dist/src/file-utils/index.d.ts.map +0 -1
  332. package/dist/src/file-utils/index.js +0 -26
  333. package/dist/src/file-utils/mime-detection.d.ts.map +0 -1
  334. package/dist/src/file-utils/mime-detection.js +0 -45
  335. package/dist/src/folder-api/album-corroborate.d.ts.map +0 -1
  336. package/dist/src/folder-api/album-corroborate.js +0 -36
  337. package/dist/src/folder-api/album-discs.d.ts.map +0 -1
  338. package/dist/src/folder-api/album-discs.js +0 -122
  339. package/dist/src/folder-api/album-grouping.d.ts.map +0 -1
  340. package/dist/src/folder-api/album-grouping.js +0 -118
  341. package/dist/src/folder-api/album-identity.d.ts.map +0 -1
  342. package/dist/src/folder-api/album-identity.js +0 -151
  343. package/dist/src/folder-api/album-types.d.ts.map +0 -1
  344. package/dist/src/folder-api/album-types.js +0 -0
  345. package/dist/src/folder-api/directory-walker.d.ts.map +0 -1
  346. package/dist/src/folder-api/directory-walker.js +0 -35
  347. package/dist/src/folder-api/file-processors.d.ts.map +0 -1
  348. package/dist/src/folder-api/file-processors.js +0 -63
  349. package/dist/src/folder-api/folder-disc.d.ts.map +0 -1
  350. package/dist/src/folder-api/folder-disc.js +0 -169
  351. package/dist/src/folder-api/folder-operations.d.ts.map +0 -1
  352. package/dist/src/folder-api/folder-operations.js +0 -54
  353. package/dist/src/folder-api/index.d.ts.map +0 -1
  354. package/dist/src/folder-api/scan-for-albums.d.ts.map +0 -1
  355. package/dist/src/folder-api/scan-for-albums.js +0 -20
  356. package/dist/src/folder-api/scan-operations.d.ts.map +0 -1
  357. package/dist/src/folder-api/scan-operations.js +0 -77
  358. package/dist/src/folder-api/types.d.ts.map +0 -1
  359. package/dist/src/folder-api/types.js +0 -21
  360. package/dist/src/msgpack/decoder.d.ts.map +0 -1
  361. package/dist/src/msgpack/decoder.js +0 -215
  362. package/dist/src/msgpack/encoder.d.ts.map +0 -1
  363. package/dist/src/msgpack/encoder.js +0 -249
  364. package/dist/src/msgpack/index.d.ts.map +0 -1
  365. package/dist/src/msgpack/index.js +0 -56
  366. package/dist/src/msgpack/types.d.ts.map +0 -1
  367. package/dist/src/msgpack/types.js +0 -12
  368. package/dist/src/msgpack/utils.d.ts.map +0 -1
  369. package/dist/src/msgpack/utils.js +0 -134
  370. package/dist/src/runtime/deno-detect.d.ts +0 -8
  371. package/dist/src/runtime/deno-detect.d.ts.map +0 -1
  372. package/dist/src/runtime/deno-detect.js +0 -6
  373. package/dist/src/runtime/detector.d.ts.map +0 -1
  374. package/dist/src/runtime/detector.js +0 -181
  375. package/dist/src/runtime/loader-types.d.ts.map +0 -1
  376. package/dist/src/runtime/loader-types.js +0 -10
  377. package/dist/src/runtime/module-loader-browser.d.ts.map +0 -1
  378. package/dist/src/runtime/module-loader-browser.js +0 -37
  379. package/dist/src/runtime/module-loader.d.ts.map +0 -1
  380. package/dist/src/runtime/module-loader.js +0 -119
  381. package/dist/src/runtime/platform-io.d.ts.map +0 -1
  382. package/dist/src/runtime/platform-io.js +0 -188
  383. package/dist/src/runtime/unified-loader/index.d.ts.map +0 -1
  384. package/dist/src/runtime/unified-loader/loader.d.ts.map +0 -1
  385. package/dist/src/runtime/unified-loader/loader.js +0 -84
  386. package/dist/src/runtime/unified-loader/module-loading.d.ts.map +0 -1
  387. package/dist/src/runtime/unified-loader/module-loading.js +0 -122
  388. package/dist/src/runtime/unified-loader/module-selection.d.ts.map +0 -1
  389. package/dist/src/runtime/unified-loader/module-selection.js +0 -41
  390. package/dist/src/runtime/unified-loader/types.d.ts.map +0 -1
  391. package/dist/src/runtime/unified-loader/types.js +0 -25
  392. package/dist/src/runtime/wasi-adapter/adapter.d.ts.map +0 -1
  393. package/dist/src/runtime/wasi-adapter/adapter.js +0 -130
  394. package/dist/src/runtime/wasi-adapter/audio-properties.d.ts.map +0 -1
  395. package/dist/src/runtime/wasi-adapter/audio-properties.js +0 -102
  396. package/dist/src/runtime/wasi-adapter/file-handle.d.ts.map +0 -1
  397. package/dist/src/runtime/wasi-adapter/file-handle.js +0 -197
  398. package/dist/src/runtime/wasi-adapter/handle-state.d.ts.map +0 -1
  399. package/dist/src/runtime/wasi-adapter/handle-state.js +0 -58
  400. package/dist/src/runtime/wasi-adapter/index.d.ts.map +0 -1
  401. package/dist/src/runtime/wasi-adapter/mp4-items.d.ts.map +0 -1
  402. package/dist/src/runtime/wasi-adapter/mp4-items.js +0 -80
  403. package/dist/src/runtime/wasi-adapter/path-open.d.ts.map +0 -1
  404. package/dist/src/runtime/wasi-adapter/path-open.js +0 -76
  405. package/dist/src/runtime/wasi-adapter/property-surface.d.ts.map +0 -1
  406. package/dist/src/runtime/wasi-adapter/property-surface.js +0 -104
  407. package/dist/src/runtime/wasi-adapter/structured-fields.d.ts.map +0 -1
  408. package/dist/src/runtime/wasi-adapter/structured-fields.js +0 -139
  409. package/dist/src/runtime/wasi-adapter/tag-keys.d.ts.map +0 -1
  410. package/dist/src/runtime/wasi-adapter/tag-keys.js +0 -46
  411. package/dist/src/runtime/wasi-adapter/wasm-io.d.ts.map +0 -1
  412. package/dist/src/runtime/wasi-adapter/wasm-io.js +0 -257
  413. package/dist/src/runtime/wasi-fs-deno.d.ts.map +0 -1
  414. package/dist/src/runtime/wasi-fs-deno.js +0 -26
  415. package/dist/src/runtime/wasi-fs-node.d.ts.map +0 -1
  416. package/dist/src/runtime/wasi-fs-node.js +0 -66
  417. package/dist/src/runtime/wasi-fs-provider.d.ts.map +0 -1
  418. package/dist/src/runtime/wasi-fs-provider.js +0 -0
  419. package/dist/src/runtime/wasi-host-loader.d.ts.map +0 -1
  420. package/dist/src/runtime/wasi-host-loader.js +0 -114
  421. package/dist/src/runtime/wasi-host.d.ts.map +0 -1
  422. package/dist/src/runtime/wasi-host.js +0 -202
  423. package/dist/src/runtime/wasi-memory.d.ts.map +0 -1
  424. package/dist/src/runtime/wasi-memory.js +0 -197
  425. package/dist/src/runtime/wasmer-sdk-loader/types.d.ts.map +0 -1
  426. package/dist/src/runtime/wasmer-sdk-loader/types.js +0 -12
  427. package/dist/src/simple/batch-operations.d.ts.map +0 -1
  428. package/dist/src/simple/batch-operations.js +0 -186
  429. package/dist/src/simple/checksum-operations.d.ts.map +0 -1
  430. package/dist/src/simple/checksum-operations.js +0 -7
  431. package/dist/src/simple/config.d.ts.map +0 -1
  432. package/dist/src/simple/config.js +0 -18
  433. package/dist/src/simple/index.d.ts.map +0 -1
  434. package/dist/src/simple/index.js +0 -60
  435. package/dist/src/simple/picture-operations.d.ts.map +0 -1
  436. package/dist/src/simple/picture-operations.js +0 -68
  437. package/dist/src/simple/tag-operations.d.ts.map +0 -1
  438. package/dist/src/simple/tag-operations.js +0 -90
  439. package/dist/src/simple/with-audio-file.d.ts.map +0 -1
  440. package/dist/src/simple/with-audio-file.js +0 -39
  441. package/dist/src/taglib/audio-file-base.d.ts.map +0 -1
  442. package/dist/src/taglib/audio-file-base.js +0 -187
  443. package/dist/src/taglib/audio-file-bwf.d.ts.map +0 -1
  444. package/dist/src/taglib/audio-file-bwf.js +0 -41
  445. package/dist/src/taglib/audio-file-checksum.d.ts.map +0 -1
  446. package/dist/src/taglib/audio-file-checksum.js +0 -77
  447. package/dist/src/taglib/audio-file-impl.d.ts.map +0 -1
  448. package/dist/src/taglib/audio-file-impl.js +0 -317
  449. package/dist/src/taglib/audio-file-interface.d.ts.map +0 -1
  450. package/dist/src/taglib/audio-file-interface.js +0 -0
  451. package/dist/src/taglib/auto-dispose.d.ts.map +0 -1
  452. package/dist/src/taglib/auto-dispose.js +0 -13
  453. package/dist/src/taglib/embind-adapter.d.ts.map +0 -1
  454. package/dist/src/taglib/embind-adapter.js +0 -141
  455. package/dist/src/taglib/extra-state-registry.d.ts.map +0 -1
  456. package/dist/src/taglib/extra-state-registry.js +0 -78
  457. package/dist/src/taglib/id3v2-frames.d.ts.map +0 -1
  458. package/dist/src/taglib/id3v2-frames.js +0 -42
  459. package/dist/src/taglib/index.d.ts.map +0 -1
  460. package/dist/src/taglib/index.js +0 -41
  461. package/dist/src/taglib/load-audio-data.d.ts.map +0 -1
  462. package/dist/src/taglib/load-audio-data.js +0 -51
  463. package/dist/src/taglib/media-ranges.d.ts.map +0 -1
  464. package/dist/src/taglib/media-ranges.js +0 -192
  465. package/dist/src/taglib/metadata-extent.d.ts.map +0 -1
  466. package/dist/src/taglib/metadata-extent.js +0 -189
  467. package/dist/src/taglib/mp4-item-names.d.ts.map +0 -1
  468. package/dist/src/taglib/mp4-item-names.js +0 -4
  469. package/dist/src/taglib/mutable-tag-impl.d.ts.map +0 -1
  470. package/dist/src/taglib/mutable-tag-impl.js +0 -88
  471. package/dist/src/taglib/mutable-tag.d.ts.map +0 -1
  472. package/dist/src/taglib/mutable-tag.js +0 -0
  473. package/dist/src/taglib/save-reconstruct.d.ts.map +0 -1
  474. package/dist/src/taglib/save-reconstruct.js +0 -43
  475. package/dist/src/taglib/taglib-class.d.ts.map +0 -1
  476. package/dist/src/taglib/taglib-class.js +0 -195
  477. package/dist/src/taglib.d.ts.map +0 -1
  478. package/dist/src/taglib.js +0 -1
  479. package/dist/src/types/audio-formats.d.ts.map +0 -1
  480. package/dist/src/types/audio-formats.js +0 -6
  481. package/dist/src/types/bwf.d.ts.map +0 -1
  482. package/dist/src/types/bwf.js +0 -0
  483. package/dist/src/types/chapters.d.ts.map +0 -1
  484. package/dist/src/types/chapters.js +0 -0
  485. package/dist/src/types/config.d.ts.map +0 -1
  486. package/dist/src/types/config.js +0 -0
  487. package/dist/src/types/format-property-keys.d.ts.map +0 -1
  488. package/dist/src/types/format-property-keys.js +0 -0
  489. package/dist/src/types/index.d.ts.map +0 -1
  490. package/dist/src/types/index.js +0 -8
  491. package/dist/src/types/metadata-mappings.d.ts.map +0 -1
  492. package/dist/src/types/metadata-mappings.js +0 -252
  493. package/dist/src/types/pictures.d.ts.map +0 -1
  494. package/dist/src/types/pictures.js +0 -64
  495. package/dist/src/types/tags.d.ts.map +0 -1
  496. package/dist/src/types/tags.js +0 -0
  497. package/dist/src/types.d.ts.map +0 -1
  498. package/dist/src/types.js +0 -1
  499. package/dist/src/utils/file.d.ts.map +0 -1
  500. package/dist/src/utils/file.js +0 -52
  501. package/dist/src/utils/mirror-fields.d.ts.map +0 -1
  502. package/dist/src/utils/mirror-fields.js +0 -75
  503. package/dist/src/utils/node-fs.d.ts.map +0 -1
  504. package/dist/src/utils/node-fs.js +0 -22
  505. package/dist/src/utils/path.d.ts.map +0 -1
  506. package/dist/src/utils/path.js +0 -36
  507. package/dist/src/utils/rating.d.ts.map +0 -1
  508. package/dist/src/utils/rating.js +0 -73
  509. package/dist/src/utils/tag-mapping.d.ts.map +0 -1
  510. package/dist/src/utils/tag-mapping.js +0 -214
  511. package/dist/src/utils/write.d.ts.map +0 -1
  512. package/dist/src/utils/write.js +0 -17
  513. package/dist/src/version.d.ts +0 -2
  514. package/dist/src/version.d.ts.map +0 -1
  515. package/dist/src/version.js +0 -4
  516. package/dist/src/wasm.d.ts.map +0 -1
  517. package/dist/src/wasm.js +0 -0
  518. package/dist/src/web-utils/canvas.d.ts.map +0 -1
  519. package/dist/src/web-utils/canvas.js +0 -60
  520. package/dist/src/web-utils/data-url.d.ts.map +0 -1
  521. package/dist/src/web-utils/data-url.js +0 -34
  522. package/dist/src/web-utils/dom-integration.d.ts.map +0 -1
  523. package/dist/src/web-utils/dom-integration.js +0 -53
  524. package/dist/src/web-utils/index.d.ts.map +0 -1
  525. package/dist/src/web-utils/index.js +0 -21
  526. /package/dist/{src/bwf → bwf}/bext.d.ts +0 -0
  527. /package/dist/{src/constants → constants}/additional-properties.d.ts +0 -0
  528. /package/dist/{src/constants → constants}/basic-properties.d.ts +0 -0
  529. /package/dist/{src/constants → constants}/complex-properties.d.ts +0 -0
  530. /package/dist/{src/constants → constants}/format-mappings.d.ts +0 -0
  531. /package/dist/{src/constants → constants}/general-extended-properties.d.ts +0 -0
  532. /package/dist/{src/constants → constants}/index.d.ts +0 -0
  533. /package/dist/{src/constants → constants}/property-types.d.ts +0 -0
  534. /package/dist/{src/constants → constants}/specialized-properties.d.ts +0 -0
  535. /package/dist/{src/constants.d.ts → constants.d.ts} +0 -0
  536. /package/dist/{src/errors → errors}/base.d.ts +0 -0
  537. /package/dist/{src/errors → errors}/classes.d.ts +0 -0
  538. /package/dist/{src/errors → errors}/guards.d.ts +0 -0
  539. /package/dist/{src/errors → errors}/index.d.ts +0 -0
  540. /package/dist/{src/errors.d.ts → errors.d.ts} +0 -0
  541. /package/dist/{src/file-utils → file-utils}/copy-and-find.d.ts +0 -0
  542. /package/dist/{src/file-utils → file-utils}/export-operations.d.ts +0 -0
  543. /package/dist/{src/file-utils → file-utils}/import-operations.d.ts +0 -0
  544. /package/dist/{src/file-utils → file-utils}/index.d.ts +0 -0
  545. /package/dist/{src/file-utils → file-utils}/mime-detection.d.ts +0 -0
  546. /package/dist/{src/folder-api → folder-api}/album-corroborate.d.ts +0 -0
  547. /package/dist/{src/folder-api → folder-api}/album-discs.d.ts +0 -0
  548. /package/dist/{src/folder-api → folder-api}/album-grouping.d.ts +0 -0
  549. /package/dist/{src/folder-api → folder-api}/album-identity.d.ts +0 -0
  550. /package/dist/{src/folder-api → folder-api}/album-types.d.ts +0 -0
  551. /package/dist/{src/folder-api → folder-api}/directory-walker.d.ts +0 -0
  552. /package/dist/{src/folder-api → folder-api}/file-processors.d.ts +0 -0
  553. /package/dist/{src/folder-api → folder-api}/folder-disc.d.ts +0 -0
  554. /package/dist/{src/folder-api → folder-api}/folder-operations.d.ts +0 -0
  555. /package/dist/{src/folder-api → folder-api}/index.d.ts +0 -0
  556. /package/dist/{src/folder-api → folder-api}/scan-for-albums.d.ts +0 -0
  557. /package/dist/{src/folder-api → folder-api}/scan-operations.d.ts +0 -0
  558. /package/dist/{src/folder-api → folder-api}/types.d.ts +0 -0
  559. /package/dist/{src/msgpack → msgpack}/decoder.d.ts +0 -0
  560. /package/dist/{src/msgpack → msgpack}/encoder.d.ts +0 -0
  561. /package/dist/{src/msgpack → msgpack}/index.d.ts +0 -0
  562. /package/dist/{src/msgpack → msgpack}/utils.d.ts +0 -0
  563. /package/dist/{src/runtime → runtime}/loader-types.d.ts +0 -0
  564. /package/dist/{src/runtime → runtime}/module-loader-browser.d.ts +0 -0
  565. /package/dist/{src/runtime → runtime}/module-loader.d.ts +0 -0
  566. /package/dist/{src/runtime → runtime}/platform-io.d.ts +0 -0
  567. /package/dist/{src/runtime → runtime}/unified-loader/index.d.ts +0 -0
  568. /package/dist/{src/runtime → runtime}/unified-loader/loader.d.ts +0 -0
  569. /package/dist/{src/runtime → runtime}/unified-loader/module-loading.d.ts +0 -0
  570. /package/dist/{src/runtime → runtime}/unified-loader/module-selection.d.ts +0 -0
  571. /package/dist/{src/runtime → runtime}/unified-loader/types.d.ts +0 -0
  572. /package/dist/{src/runtime → runtime}/wasi-adapter/adapter.d.ts +0 -0
  573. /package/dist/{src/runtime → runtime}/wasi-adapter/audio-properties.d.ts +0 -0
  574. /package/dist/{src/runtime → runtime}/wasi-adapter/file-handle.d.ts +0 -0
  575. /package/dist/{src/runtime → runtime}/wasi-adapter/handle-state.d.ts +0 -0
  576. /package/dist/{src/runtime → runtime}/wasi-adapter/index.d.ts +0 -0
  577. /package/dist/{src/runtime → runtime}/wasi-adapter/mp4-items.d.ts +0 -0
  578. /package/dist/{src/runtime → runtime}/wasi-adapter/path-open.d.ts +0 -0
  579. /package/dist/{src/runtime → runtime}/wasi-adapter/property-surface.d.ts +0 -0
  580. /package/dist/{src/runtime → runtime}/wasi-adapter/structured-fields.d.ts +0 -0
  581. /package/dist/{src/runtime → runtime}/wasi-adapter/tag-keys.d.ts +0 -0
  582. /package/dist/{src/runtime → runtime}/wasi-adapter/wasm-io.d.ts +0 -0
  583. /package/dist/{src/runtime → runtime}/wasi-fs-deno.d.ts +0 -0
  584. /package/dist/{src/runtime → runtime}/wasi-fs-node.d.ts +0 -0
  585. /package/dist/{src/runtime → runtime}/wasi-fs-provider.d.ts +0 -0
  586. /package/dist/{src/runtime → runtime}/wasi-host-loader.d.ts +0 -0
  587. /package/dist/{src/runtime → runtime}/wasi-host.d.ts +0 -0
  588. /package/dist/{src/runtime → runtime}/wasi-memory.d.ts +0 -0
  589. /package/dist/{src/runtime → runtime}/wasmer-sdk-loader/types.d.ts +0 -0
  590. /package/dist/{src/simple → simple}/batch-operations.d.ts +0 -0
  591. /package/dist/{src/simple → simple}/checksum-operations.d.ts +0 -0
  592. /package/dist/{src/simple → simple}/config.d.ts +0 -0
  593. /package/dist/{src/simple → simple}/index.d.ts +0 -0
  594. /package/dist/{src/simple → simple}/picture-operations.d.ts +0 -0
  595. /package/dist/{src/simple → simple}/tag-operations.d.ts +0 -0
  596. /package/dist/{src/simple → simple}/with-audio-file.d.ts +0 -0
  597. /package/dist/{src/taglib → taglib}/audio-file-base.d.ts +0 -0
  598. /package/dist/{src/taglib → taglib}/audio-file-bwf.d.ts +0 -0
  599. /package/dist/{src/taglib → taglib}/audio-file-checksum.d.ts +0 -0
  600. /package/dist/{src/taglib → taglib}/audio-file-impl.d.ts +0 -0
  601. /package/dist/{src/taglib → taglib}/audio-file-interface.d.ts +0 -0
  602. /package/dist/{src/taglib → taglib}/auto-dispose.d.ts +0 -0
  603. /package/dist/{src/taglib → taglib}/embind-adapter.d.ts +0 -0
  604. /package/dist/{src/taglib → taglib}/extra-state-registry.d.ts +0 -0
  605. /package/dist/{src/taglib → taglib}/index.d.ts +0 -0
  606. /package/dist/{src/taglib → taglib}/load-audio-data.d.ts +0 -0
  607. /package/dist/{src/taglib → taglib}/media-ranges.d.ts +0 -0
  608. /package/dist/{src/taglib → taglib}/metadata-extent.d.ts +0 -0
  609. /package/dist/{src/taglib → taglib}/mp4-item-names.d.ts +0 -0
  610. /package/dist/{src/taglib → taglib}/mutable-tag-impl.d.ts +0 -0
  611. /package/dist/{src/taglib → taglib}/mutable-tag.d.ts +0 -0
  612. /package/dist/{src/taglib → taglib}/save-reconstruct.d.ts +0 -0
  613. /package/dist/{src/taglib → taglib}/taglib-class.d.ts +0 -0
  614. /package/dist/{src/taglib.d.ts → taglib.d.ts} +0 -0
  615. /package/dist/{src/types → types}/bwf.d.ts +0 -0
  616. /package/dist/{src/types → types}/chapters.d.ts +0 -0
  617. /package/dist/{src/types → types}/config.d.ts +0 -0
  618. /package/dist/{src/types → types}/format-property-keys.d.ts +0 -0
  619. /package/dist/{src/types → types}/index.d.ts +0 -0
  620. /package/dist/{src/types → types}/metadata-mappings.d.ts +0 -0
  621. /package/dist/{src/types → types}/pictures.d.ts +0 -0
  622. /package/dist/{src/types → types}/tags.d.ts +0 -0
  623. /package/dist/{src/types.d.ts → types.d.ts} +0 -0
  624. /package/dist/{src/utils → utils}/file.d.ts +0 -0
  625. /package/dist/{src/utils → utils}/mirror-fields.d.ts +0 -0
  626. /package/dist/{src/utils → utils}/node-fs.d.ts +0 -0
  627. /package/dist/{src/utils → utils}/path.d.ts +0 -0
  628. /package/dist/{src/utils → utils}/rating.d.ts +0 -0
  629. /package/dist/{src/utils → utils}/tag-mapping.d.ts +0 -0
  630. /package/dist/{src/utils → utils}/write.d.ts +0 -0
  631. /package/dist/{src/wasm.d.ts → wasm.d.ts} +0 -0
  632. /package/dist/{src/web-utils → web-utils}/canvas.d.ts +0 -0
  633. /package/dist/{src/web-utils → web-utils}/data-url.d.ts +0 -0
  634. /package/dist/{src/web-utils → web-utils}/dom-integration.d.ts +0 -0
  635. /package/dist/{src/web-utils → web-utils}/index.d.ts +0 -0
@@ -0,0 +1,211 @@
1
+ import { toTagLibKey } from "../constants/properties.js";
2
+ import { MetadataError, errorMessage } from "../errors/classes.js";
3
+ import { isShadowedNumericMirror } from "../utils/mirror-fields.js";
4
+ import { encode } from "@msgpack/msgpack";
5
+ //#region src/msgpack/encoder.ts
6
+ /** MessagePack encoder — converts JS objects to binary MessagePack for the C API. */
7
+ /**
8
+ * Structured (non-text-property) keys carried verbatim through the msgpack
9
+ * boundary. The reconstruct registry (`extra-state-registry.ts`) must cover the
10
+ * data fields here; `extra-state-registry.test.ts` enforces that cross-check.
11
+ */
12
+ const PASSTHROUGH_KEYS = /* @__PURE__ */ new Set([
13
+ "pictures",
14
+ "ratings",
15
+ "id3v2Frames",
16
+ "lyrics",
17
+ "chapters",
18
+ "_mp4ChapterStyle",
19
+ "bextData",
20
+ "ixml",
21
+ "id3Tags",
22
+ "_stripId3",
23
+ "_mp4ItemNames",
24
+ "_mp4ItemRemovals"
25
+ ]);
26
+ const MSGPACK_ENCODE_OPTIONS = {
27
+ sortKeys: false,
28
+ forceFloat32: false,
29
+ ignoreUndefined: true,
30
+ initialBufferSize: 2048,
31
+ maxDepth: 32
32
+ };
33
+ /**
34
+ * Flatten the in-memory lyrics value to the plain text strings the "LYRICS"
35
+ * PropertyMap key accepts. Tolerates the three shapes `tagData.lyrics` can hold:
36
+ * a `RawLyrics[]` (from `setLyrics`), a `string[]` (from `setProperties`), or a
37
+ * bare `string` (from a fresh read of the "LYRICS" property).
38
+ */
39
+ function lyricsTexts(value) {
40
+ return (Array.isArray(value) ? value : [value]).map((entry) => {
41
+ if (typeof entry === "string") return entry;
42
+ const text = entry?.text;
43
+ return typeof text === "string" ? text : "";
44
+ }).filter((text) => text !== "");
45
+ }
46
+ function encodeTagData(tagData) {
47
+ try {
48
+ const data = tagData;
49
+ const remapped = {};
50
+ for (const [key, value] of Object.entries(tagData)) {
51
+ if (isShadowedNumericMirror(data, key)) continue;
52
+ if (key === "lyrics") {
53
+ const texts = lyricsTexts(value);
54
+ if (texts.length > 0) remapped["LYRICS"] = texts;
55
+ continue;
56
+ }
57
+ if (PASSTHROUGH_KEYS.has(key)) remapped[key] = value;
58
+ else remapped[toTagLibKey(key)] = value;
59
+ }
60
+ return encode(cleanObject(remapped), MSGPACK_ENCODE_OPTIONS);
61
+ } catch (error) {
62
+ throw new MetadataError("write", `Failed to encode tag data: ${errorMessage(error)}`);
63
+ }
64
+ }
65
+ function encodeAudioProperties(audioProps) {
66
+ try {
67
+ return encode(cleanObject(audioProps), MSGPACK_ENCODE_OPTIONS);
68
+ } catch (error) {
69
+ throw new MetadataError("write", `Failed to encode audio properties: ${errorMessage(error)}`);
70
+ }
71
+ }
72
+ function encodePropertyMap(propertyMap) {
73
+ try {
74
+ return encode(propertyMap, MSGPACK_ENCODE_OPTIONS);
75
+ } catch (error) {
76
+ throw new MetadataError("write", `Failed to encode property map: ${errorMessage(error)}`);
77
+ }
78
+ }
79
+ function encodePicture(picture) {
80
+ try {
81
+ const cleanedPicture = {
82
+ ...picture,
83
+ data: picture.data instanceof Uint8Array ? picture.data : new Uint8Array(picture.data)
84
+ };
85
+ return encode(cleanedPicture, MSGPACK_ENCODE_OPTIONS);
86
+ } catch (error) {
87
+ throw new MetadataError("write", `Failed to encode picture: ${errorMessage(error)}`);
88
+ }
89
+ }
90
+ function encodePictureArray(pictures) {
91
+ try {
92
+ const cleanedPictures = pictures.map((picture) => ({
93
+ ...picture,
94
+ data: picture.data instanceof Uint8Array ? picture.data : new Uint8Array(picture.data)
95
+ }));
96
+ return encode(cleanedPictures, MSGPACK_ENCODE_OPTIONS);
97
+ } catch (error) {
98
+ throw new MetadataError("write", `Failed to encode picture array: ${errorMessage(error)}`);
99
+ }
100
+ }
101
+ function encodeMessagePack(data, options = {}) {
102
+ try {
103
+ const mergedOptions = {
104
+ ...MSGPACK_ENCODE_OPTIONS,
105
+ ...options
106
+ };
107
+ return encode(cleanObject(data), mergedOptions);
108
+ } catch (error) {
109
+ throw new MetadataError("write", `Failed to encode data: ${errorMessage(error)}`);
110
+ }
111
+ }
112
+ function encodeMessagePackCompact(data) {
113
+ try {
114
+ const compactOptions = {
115
+ ...MSGPACK_ENCODE_OPTIONS,
116
+ sortKeys: true,
117
+ initialBufferSize: 512,
118
+ forceFloat32: true
119
+ };
120
+ return encode(cleanObject(data), compactOptions);
121
+ } catch (error) {
122
+ throw new MetadataError("write", `Failed to encode compact data: ${errorMessage(error)}`);
123
+ }
124
+ }
125
+ function cleanObject(obj) {
126
+ if (obj === null || obj === void 0) return null;
127
+ if (typeof obj !== "object") return obj;
128
+ if (obj instanceof Uint8Array || Array.isArray(obj)) return obj;
129
+ if (obj instanceof Date) return obj;
130
+ const cleaned = {};
131
+ for (const [key, value] of Object.entries(obj)) {
132
+ if (value === void 0) continue;
133
+ if (value === null) {
134
+ cleaned[key] = null;
135
+ continue;
136
+ }
137
+ if (typeof value === "string" && value === "") continue;
138
+ cleaned[key] = typeof value === "object" ? cleanObject(value) : value;
139
+ }
140
+ return cleaned;
141
+ }
142
+ function encodeBatchTagData(tagDataArray) {
143
+ try {
144
+ const cleanedArray = tagDataArray.map((tagData) => cleanObject(tagData));
145
+ return encode(cleanedArray, {
146
+ ...MSGPACK_ENCODE_OPTIONS,
147
+ initialBufferSize: 8192,
148
+ maxDepth: 16
149
+ });
150
+ } catch (error) {
151
+ throw new MetadataError("write", `Failed to encode batch tag data: ${errorMessage(error)}`);
152
+ }
153
+ }
154
+ function* encodeMessagePackStream(dataIterator) {
155
+ try {
156
+ for (const item of dataIterator) yield encode(cleanObject(item), {
157
+ ...MSGPACK_ENCODE_OPTIONS,
158
+ initialBufferSize: 1024
159
+ });
160
+ } catch (error) {
161
+ throw new MetadataError("write", `Failed to encode streaming data: ${errorMessage(error)}`);
162
+ }
163
+ }
164
+ function estimateMessagePackSize(data) {
165
+ try {
166
+ return encode(cleanObject(data), {
167
+ ...MSGPACK_ENCODE_OPTIONS,
168
+ initialBufferSize: 512
169
+ }).length;
170
+ } catch {
171
+ return Math.floor(JSON.stringify(data).length * .75);
172
+ }
173
+ }
174
+ function encodeFastTagData(tagData) {
175
+ try {
176
+ return encode(cleanObject(tagData), {
177
+ sortKeys: false,
178
+ ignoreUndefined: true,
179
+ initialBufferSize: 256,
180
+ maxDepth: 8
181
+ });
182
+ } catch (error) {
183
+ throw new MetadataError("write", `Failed to encode fast tag data: ${errorMessage(error)}`);
184
+ }
185
+ }
186
+ function canEncodeToMessagePack(data) {
187
+ try {
188
+ encode(cleanObject(data), {
189
+ ...MSGPACK_ENCODE_OPTIONS,
190
+ maxDepth: 16,
191
+ initialBufferSize: 256
192
+ });
193
+ return true;
194
+ } catch {
195
+ return false;
196
+ }
197
+ }
198
+ function compareEncodingEfficiency(data) {
199
+ const jsonString = JSON.stringify(data);
200
+ const jsonSize = new TextEncoder().encode(jsonString).length;
201
+ const messagePackSize = encode(cleanObject(data), MSGPACK_ENCODE_OPTIONS).length;
202
+ const sizeReduction = (jsonSize - messagePackSize) / jsonSize * 100;
203
+ return {
204
+ messagePackSize,
205
+ jsonSize,
206
+ sizeReduction: Math.max(0, sizeReduction),
207
+ speedImprovement: 10
208
+ };
209
+ }
210
+ //#endregion
211
+ export { PASSTHROUGH_KEYS, canEncodeToMessagePack, compareEncodingEfficiency, encodeAudioProperties, encodeBatchTagData, encodeFastTagData, encodeMessagePack, encodeMessagePackCompact, encodeMessagePackStream, encodePicture, encodePictureArray, encodePropertyMap, encodeTagData, estimateMessagePackSize };
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/msgpack/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,EACrB,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EACjB,aAAa,EACb,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,sBAAsB,EACtB,yBAAyB,EACzB,qBAAqB,EACrB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,wBAAwB,EACxB,uBAAuB,EACvB,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EACjB,aAAa,EACb,uBAAuB,GACxB,MAAM,cAAc,CAAC;AAGtB,YAAY,EACV,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,qBAAqB,EACrB,eAAe,EACf,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,EAChB,UAAU,EACV,eAAe,EACf,qBAAqB,EACrB,uBAAuB,EACvB,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAGpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC"}
@@ -0,0 +1,5 @@
1
+ import { decodeAudioProperties, decodeFastTagData, decodeMessagePack, decodeMessagePackAuto, decodePicture, decodePictureArray, decodePropertyMap, decodeTagData, getMessagePackInfo, isValidMessagePack } from "./decoder.js";
2
+ import { canEncodeToMessagePack, compareEncodingEfficiency, encodeAudioProperties, encodeBatchTagData, encodeFastTagData, encodeMessagePack, encodeMessagePackCompact, encodeMessagePackStream, encodePicture, encodePictureArray, encodePropertyMap, encodeTagData, estimateMessagePackSize } from "./encoder.js";
3
+ import { TAGLIB_MSGPACK_MARKERS } from "./types.js";
4
+ import { MessagePackUtils } from "./utils.js";
5
+ export { MessagePackUtils, TAGLIB_MSGPACK_MARKERS, canEncodeToMessagePack, compareEncodingEfficiency, decodeAudioProperties, decodeFastTagData, decodeMessagePack, decodeMessagePackAuto, decodePicture, decodePictureArray, decodePropertyMap, decodeTagData, encodeAudioProperties, encodeBatchTagData, encodeFastTagData, encodeMessagePack, encodeMessagePackCompact, encodeMessagePackStream, encodePicture, encodePictureArray, encodePropertyMap, encodeTagData, estimateMessagePackSize, getMessagePackInfo, isValidMessagePack };
@@ -62,7 +62,7 @@ export declare const TAGLIB_MSGPACK_MARKERS: {
62
62
  readonly STREAM_CHUNK: 6;
63
63
  readonly ERROR_RESPONSE: 255;
64
64
  };
65
- export type TagLibMessagePackMarker = typeof TAGLIB_MSGPACK_MARKERS[keyof typeof TAGLIB_MSGPACK_MARKERS];
65
+ export type TagLibMessagePackMarker = (typeof TAGLIB_MSGPACK_MARKERS)[keyof typeof TAGLIB_MSGPACK_MARKERS];
66
66
  export interface FormatVersion {
67
67
  major: number;
68
68
  minor: number;
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/msgpack/types.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,13 @@
1
+ //#region src/msgpack/types.ts
2
+ /** TagLib-specific MessagePack format markers */
3
+ const TAGLIB_MSGPACK_MARKERS = {
4
+ TAG_DATA: 1,
5
+ AUDIO_PROPERTIES: 2,
6
+ PICTURE_DATA: 3,
7
+ PROPERTY_MAP: 4,
8
+ BATCH_DATA: 5,
9
+ STREAM_CHUNK: 6,
10
+ ERROR_RESPONSE: 255
11
+ };
12
+ //#endregion
13
+ export { TAGLIB_MSGPACK_MARKERS };
@@ -0,0 +1 @@
1
+ {"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/msgpack/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EACV,eAAe,EACf,WAAW,EACX,OAAO,EACP,WAAW,EACZ,MAAM,aAAa,CAAC;AAYrB;;GAEG;AACH,qBAAa,gBAAgB;IAC3B;;OAEG;IACH,MAAM,CAAC,MAAM,CACX,MAAM,EAAE,UAAU,GACjB,WAAW,GAAG,eAAe,GAAG,OAAO,GAAG,WAAW;IAIxD;;OAEG;IACH,MAAM,CAAC,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,GAAG,IAAI;IAW/D;;OAEG;IACH,MAAM,CAAC,yBAAyB,CAAC,MAAM,EAAE,UAAU,GAAG,eAAe,GAAG,IAAI;IAW5E;;OAEG;IACH,MAAM,CAAC,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,GAAG,IAAI;IAW5D;;OAEG;IACH,MAAM,CAAC,wBAAwB,CAAC,IAAI,EAAE,WAAW,GAAG;QAClD,eAAe,EAAE,MAAM,CAAC;QACxB,QAAQ,EAAE,MAAM,CAAC;QACjB,aAAa,EAAE,MAAM,CAAC;QACtB,yBAAyB,EAAE,MAAM,CAAC;KACnC;IAUD;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM;IAYzC;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU;IAY/C;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,KAAK,CAAC;QAC/C,OAAO,EAAE,OAAO,CAAC;QACjB,IAAI,CAAC,EAAE,WAAW,GAAG,eAAe,GAAG,OAAO,GAAG,WAAW,CAAC;QAC7D,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IAcF;;OAEG;IACH,MAAM,CAAC,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO;CAqBlD"}
@@ -0,0 +1,116 @@
1
+ import { MetadataError, errorMessage } from "../errors/classes.js";
2
+ import { decodeAudioProperties, decodeMessagePackAuto, decodePicture, decodeTagData, isValidMessagePack } from "./decoder.js";
3
+ import { compareEncodingEfficiency, encodeTagData } from "./encoder.js";
4
+ //#region src/msgpack/utils.ts
5
+ /**
6
+ * @fileoverview High-level MessagePack utilities for common TagLib-Wasm operations
7
+ */
8
+ /**
9
+ * High-level MessagePack utilities for common TagLib-Wasm operations
10
+ */
11
+ var MessagePackUtils = class {
12
+ /**
13
+ * Smart decode that automatically detects the data type
14
+ */
15
+ static decode(buffer) {
16
+ return decodeMessagePackAuto(buffer);
17
+ }
18
+ /**
19
+ * Validate and decode tag data with error handling
20
+ */
21
+ static safeDecodeTagData(buffer) {
22
+ try {
23
+ if (!isValidMessagePack(buffer)) return null;
24
+ return decodeTagData(buffer);
25
+ } catch {
26
+ return null;
27
+ }
28
+ }
29
+ /**
30
+ * Validate and decode audio properties with error handling
31
+ */
32
+ static safeDecodeAudioProperties(buffer) {
33
+ try {
34
+ if (!isValidMessagePack(buffer)) return null;
35
+ return decodeAudioProperties(buffer);
36
+ } catch {
37
+ return null;
38
+ }
39
+ }
40
+ /**
41
+ * Validate and decode picture data with error handling
42
+ */
43
+ static safeDecodePicture(buffer) {
44
+ try {
45
+ if (!isValidMessagePack(buffer)) return null;
46
+ return decodePicture(buffer);
47
+ } catch {
48
+ return null;
49
+ }
50
+ }
51
+ /**
52
+ * Get performance metrics for MessagePack vs JSON
53
+ */
54
+ static getPerformanceComparison(data) {
55
+ const comparison = compareEncodingEfficiency(data);
56
+ return {
57
+ messagePackSize: comparison.messagePackSize,
58
+ jsonSize: comparison.jsonSize,
59
+ sizeReduction: comparison.sizeReduction,
60
+ estimatedSpeedImprovement: comparison.speedImprovement
61
+ };
62
+ }
63
+ /**
64
+ * Convert between MessagePack and JSON for debugging/comparison
65
+ */
66
+ static toJson(buffer) {
67
+ try {
68
+ const decoded = decodeMessagePackAuto(buffer);
69
+ return JSON.stringify(decoded, null, 2);
70
+ } catch (error) {
71
+ throw new MetadataError("read", `Failed to convert to JSON: ${errorMessage(error)}`);
72
+ }
73
+ }
74
+ /**
75
+ * Convert JSON back to MessagePack (for testing/migration)
76
+ */
77
+ static fromJson(jsonString) {
78
+ try {
79
+ const data = JSON.parse(jsonString);
80
+ return encodeTagData(data);
81
+ } catch (error) {
82
+ throw new MetadataError("write", `Failed to convert from JSON: ${errorMessage(error)}`);
83
+ }
84
+ }
85
+ /**
86
+ * Batch process multiple MessagePack buffers
87
+ */
88
+ static batchDecode(buffers) {
89
+ return buffers.map((buffer) => {
90
+ try {
91
+ return {
92
+ success: true,
93
+ data: decodeMessagePackAuto(buffer)
94
+ };
95
+ } catch (error) {
96
+ return {
97
+ success: false,
98
+ error: error instanceof Error ? error.message : "Unknown error"
99
+ };
100
+ }
101
+ });
102
+ }
103
+ /**
104
+ * Check if data is compatible with TagLib MessagePack format
105
+ */
106
+ static isTagLibCompatible(data) {
107
+ if (typeof data !== "object" || data === null) return false;
108
+ const obj = data;
109
+ if ("title" in obj || "artist" in obj || "album" in obj) return true;
110
+ if ("bitrate" in obj && "sampleRate" in obj) return true;
111
+ if ("mimeType" in obj && "data" in obj) return true;
112
+ return false;
113
+ }
114
+ };
115
+ //#endregion
116
+ export { MessagePackUtils };
package/dist/rating.d.ts CHANGED
@@ -11,5 +11,5 @@
11
11
  * const popm = toPopm(0.8); // 196
12
12
  * ```
13
13
  */
14
- export * from "./src/utils/rating.js";
14
+ export * from "./utils/rating.js";
15
15
  //# sourceMappingURL=rating.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"rating.d.ts","sourceRoot":"","sources":["../rating.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,cAAc,uBAAuB,CAAC"}
1
+ {"version":3,"file":"rating.d.ts","sourceRoot":"","sources":["../src/rating.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,cAAc,mBAAmB,CAAC"}
package/dist/rating.js CHANGED
@@ -1,2 +1,2 @@
1
- // rating.ts
2
- export * from "./src/utils/rating.js";
1
+ import { RatingUtils, clamp, fromNormalized, fromPercent, fromPopm, fromStars, isValid, normalized, popm, toNormalized, toPercent, toPopm, toStars } from "./utils/rating.js";
2
+ export { RatingUtils, clamp, fromNormalized, fromPercent, fromPopm, fromStars, isValid, normalized, popm, toNormalized, toPercent, toPopm, toStars };
@@ -0,0 +1,19 @@
1
+ /**
2
+ * @fileoverview Detect if running inside a Deno compiled binary
3
+ *
4
+ * Shared by module-loader.ts and deno-compile.ts to avoid duplication.
5
+ * Intentionally zero-dependency to prevent circular imports.
6
+ */
7
+ /**
8
+ * Whether the process is a Deno compiled binary.
9
+ *
10
+ * `Deno.build.standalone` is the runtime's own statement — true inside a
11
+ * compiled binary, false under `deno run` (measured on 2.9.6) — so it wins
12
+ * whenever it is exposed. A path that merely contains a `deno-compile-`
13
+ * directory must not count; the main-module forms below are only the fallback
14
+ * for runtimes (or test doubles) without the flag: Deno through 2.8 marks a
15
+ * compiled binary with the `deno-compile://` scheme, and Deno 2.9+ reports a
16
+ * `file://` URL under a `deno-compile-<name>` temporary directory.
17
+ */
18
+ export declare function isDenoCompiled(): boolean;
19
+ //# sourceMappingURL=deno-detect.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"deno-detect.d.ts","sourceRoot":"","sources":["../../src/runtime/deno-detect.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAWxC"}
@@ -0,0 +1,26 @@
1
+ //#region src/runtime/deno-detect.ts
2
+ /**
3
+ * @fileoverview Detect if running inside a Deno compiled binary
4
+ *
5
+ * Shared by module-loader.ts and deno-compile.ts to avoid duplication.
6
+ * Intentionally zero-dependency to prevent circular imports.
7
+ */
8
+ /**
9
+ * Whether the process is a Deno compiled binary.
10
+ *
11
+ * `Deno.build.standalone` is the runtime's own statement — true inside a
12
+ * compiled binary, false under `deno run` (measured on 2.9.6) — so it wins
13
+ * whenever it is exposed. A path that merely contains a `deno-compile-`
14
+ * directory must not count; the main-module forms below are only the fallback
15
+ * for runtimes (or test doubles) without the flag: Deno through 2.8 marks a
16
+ * compiled binary with the `deno-compile://` scheme, and Deno 2.9+ reports a
17
+ * `file://` URL under a `deno-compile-<name>` temporary directory.
18
+ */
19
+ function isDenoCompiled() {
20
+ if (typeof Deno === "undefined") return false;
21
+ const build = Deno.build;
22
+ if (typeof build?.standalone === "boolean") return build.standalone;
23
+ return typeof Deno.mainModule === "string" && (Deno.mainModule.includes("deno-compile://") || Deno.mainModule.includes("/deno-compile-"));
24
+ }
25
+ //#endregion
26
+ export { isDenoCompiled };
@@ -36,6 +36,8 @@ export declare function detectRuntime(): RuntimeDetectionResult;
36
36
  * Uses `WebAssembly.validate()` with a minimal probe module — synchronous and zero-cost.
37
37
  */
38
38
  export declare function supportsExnref(): boolean;
39
+ /** @internal Exported for unit tests (tests/runtime-detector-unit.test.ts). */
39
40
  export declare function getEnvironmentDescription(env: RuntimeEnvironment): string;
41
+ /** @internal Exported for unit tests (tests/runtime-detector-unit.test.ts). */
40
42
  export declare function canLoadWasmType(wasmType: WasmBinaryType, env?: RuntimeEnvironment): boolean;
41
43
  //# sourceMappingURL=detector.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"detector.d.ts","sourceRoot":"","sources":["../../src/runtime/detector.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAC1B,WAAW,GACX,WAAW,GACX,UAAU,GACV,SAAS,GACT,iBAAiB,GACjB,QAAQ,GACR,YAAY,CAAC;AAEjB,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,YAAY,CAAC;AAEnD,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,kBAAkB,CAAC;IAChC,QAAQ,EAAE,cAAc,CAAC;IACzB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,eAAe,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;CAC5B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,cAAc,CAAC;IACzB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,eAAe,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;CAC5B;AA+CD,qEAAqE;AACrE,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,kBAAkB,GACtB,kBAAkB,CAEpB;AAOD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,GAAG,SAAS,GAC9B,MAAM,GAAG,SAAS,CAepB;AA4CD,qFAAqF;AACrF,wBAAgB,MAAM,IAAI,OAAO,CAEhC;AAED,wBAAgB,aAAa,IAAI,sBAAsB,CAuCtD;AAqBD;;;GAGG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAMxC;AAED,+EAA+E;AAC/E,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,kBAAkB,GAAG,MAAM,CAmBzE;AAED,+EAA+E;AAC/E,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,cAAc,EACxB,GAAG,GAAE,kBAAgD,GACpD,OAAO,CAKT"}
@@ -0,0 +1,173 @@
1
+ //#region src/runtime/detector.ts
2
+ const ENVIRONMENT_PROFILES = {
3
+ "deno-wasi": {
4
+ wasmType: "wasi",
5
+ supportsFilesystem: true,
6
+ supportsStreaming: true,
7
+ performanceTier: 1
8
+ },
9
+ "node-wasi": {
10
+ wasmType: "wasi",
11
+ supportsFilesystem: true,
12
+ supportsStreaming: true,
13
+ performanceTier: 1
14
+ },
15
+ "bun-wasi": {
16
+ wasmType: "wasi",
17
+ supportsFilesystem: true,
18
+ supportsStreaming: true,
19
+ performanceTier: 1
20
+ },
21
+ browser: {
22
+ wasmType: "emscripten",
23
+ supportsFilesystem: false,
24
+ supportsStreaming: true,
25
+ performanceTier: 2
26
+ },
27
+ worker: {
28
+ wasmType: "emscripten",
29
+ supportsFilesystem: false,
30
+ supportsStreaming: true,
31
+ performanceTier: 2
32
+ },
33
+ cloudflare: {
34
+ wasmType: "emscripten",
35
+ supportsFilesystem: false,
36
+ supportsStreaming: false,
37
+ performanceTier: 3
38
+ },
39
+ "node-emscripten": {
40
+ wasmType: "emscripten",
41
+ supportsFilesystem: true,
42
+ supportsStreaming: true,
43
+ performanceTier: 3
44
+ }
45
+ };
46
+ /** Pure environment -> backend configuration lookup (taglib-2b4). */
47
+ function environmentProfile(env) {
48
+ return ENVIRONMENT_PROFILES[env];
49
+ }
50
+ const g = globalThis;
51
+ const MIN_NODE_MAJOR = 22;
52
+ const MIN_NODE_MINOR = 6;
53
+ /**
54
+ * Check if a Node.js version meets the minimum requirement (v22.6.0+).
55
+ * Returns an error message string if the version is too old, or undefined if OK.
56
+ * Pass undefined for non-Node environments (always returns undefined).
57
+ */
58
+ function checkNodeVersion(nodeVersion) {
59
+ if (!nodeVersion) return void 0;
60
+ const [major, minor] = nodeVersion.split(".").map(Number);
61
+ if (major < MIN_NODE_MAJOR || major === MIN_NODE_MAJOR && minor < MIN_NODE_MINOR) return `Node.js v${MIN_NODE_MAJOR}.${MIN_NODE_MINOR}.0 or higher is required. Current version: v${nodeVersion}. Older versions lack WASI and Wasm exception handling support.`;
62
+ }
63
+ function hasWASISupport() {
64
+ if (g.Deno !== void 0) return true;
65
+ if (g.process !== void 0 && g.process.versions?.node) {
66
+ const [major] = g.process.versions.node.split(".").map(Number);
67
+ return major >= 16;
68
+ }
69
+ return false;
70
+ }
71
+ function isBrowser() {
72
+ return g.window !== void 0 && g.document !== void 0;
73
+ }
74
+ function isWebWorker() {
75
+ return g.WorkerGlobalScope !== void 0 && g.self !== void 0 && g.self instanceof g.WorkerGlobalScope;
76
+ }
77
+ function isCloudflareWorker() {
78
+ return g.caches !== void 0 && g.Request !== void 0 && typeof g.addEventListener === "function" && g.Deno === void 0 && g.process === void 0;
79
+ }
80
+ function isBun() {
81
+ return g.Bun !== void 0;
82
+ }
83
+ function isNode() {
84
+ return g.process !== void 0 && g.process.versions?.node !== void 0;
85
+ }
86
+ /** Shared Deno-runtime check — do not hand-roll `typeof Deno` tests (taglib-rfr). */
87
+ function isDeno() {
88
+ return g.Deno !== void 0;
89
+ }
90
+ function detectRuntime() {
91
+ if (isDeno() && hasWASISupport()) return {
92
+ environment: "deno-wasi",
93
+ ...environmentProfile("deno-wasi")
94
+ };
95
+ if (isBun()) return {
96
+ environment: "bun-wasi",
97
+ ...environmentProfile("bun-wasi")
98
+ };
99
+ if (isNode() && hasWASISupport()) return {
100
+ environment: "node-wasi",
101
+ ...environmentProfile("node-wasi")
102
+ };
103
+ if (isBrowser()) return {
104
+ environment: "browser",
105
+ ...environmentProfile("browser")
106
+ };
107
+ if (isWebWorker()) return {
108
+ environment: "worker",
109
+ ...environmentProfile("worker")
110
+ };
111
+ if (isCloudflareWorker()) return {
112
+ environment: "cloudflare",
113
+ ...environmentProfile("cloudflare")
114
+ };
115
+ if (isNode()) return {
116
+ environment: "node-emscripten",
117
+ ...environmentProfile("node-emscripten")
118
+ };
119
+ return {
120
+ environment: "browser",
121
+ ...environmentProfile("browser"),
122
+ performanceTier: 3
123
+ };
124
+ }
125
+ const EXNREF_PROBE = new Uint8Array([
126
+ 0,
127
+ 97,
128
+ 115,
129
+ 109,
130
+ 1,
131
+ 0,
132
+ 0,
133
+ 0,
134
+ 6,
135
+ 6,
136
+ 1,
137
+ 105,
138
+ 0,
139
+ 208,
140
+ 105,
141
+ 11
142
+ ]);
143
+ /**
144
+ * Detect whether the runtime supports the Wasm `exnref` type.
145
+ * Uses `WebAssembly.validate()` with a minimal probe module — synchronous and zero-cost.
146
+ */
147
+ function supportsExnref() {
148
+ try {
149
+ return WebAssembly.validate(EXNREF_PROBE);
150
+ } catch {
151
+ return false;
152
+ }
153
+ }
154
+ /** @internal Exported for unit tests (tests/runtime-detector-unit.test.ts). */
155
+ function getEnvironmentDescription(env) {
156
+ switch (env) {
157
+ case "deno-wasi": return "Deno with WASI (optimal filesystem performance)";
158
+ case "node-wasi": return "Node.js with WASI (high performance)";
159
+ case "bun-wasi": return "Bun with WASI (Bun-native file I/O)";
160
+ case "browser": return "Browser with Emscripten (web compatibility)";
161
+ case "worker": return "Web Worker with Emscripten";
162
+ case "cloudflare": return "Cloudflare Workers (limited streaming)";
163
+ case "node-emscripten": return "Node.js with Emscripten (fallback mode)";
164
+ default: return "Unknown environment";
165
+ }
166
+ }
167
+ /** @internal Exported for unit tests (tests/runtime-detector-unit.test.ts). */
168
+ function canLoadWasmType(wasmType, env = detectRuntime().environment) {
169
+ if (wasmType === "wasi") return environmentProfile(env).wasmType === "wasi";
170
+ return true;
171
+ }
172
+ //#endregion
173
+ export { canLoadWasmType, checkNodeVersion, detectRuntime, environmentProfile, getEnvironmentDescription, isDeno, supportsExnref };
@@ -0,0 +1 @@
1
+ {"version":3,"file":"loader-types.d.ts","sourceRoot":"","sources":["../../src/runtime/loader-types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,WAAW,GAAG,UAAU,CAAC;IAEtC;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,YAAY,CAAC;IAEtC;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,WAAW,GAAG,UAAU,GAC/B,MAAM,GAAG,IAAI,CAWf"}
@@ -0,0 +1,23 @@
1
+ //#region src/runtime/loader-types.ts
2
+ /**
3
+ * Describe why `wasmBinary` is not a WebAssembly module, or `null` if it is.
4
+ *
5
+ * Both loader entry points validate this before handing the buffer to
6
+ * Emscripten. Left to the glue, a bad buffer surfaces as an asynchronous
7
+ * `Aborted(CompileError: ...)` written straight to the console AFTER the
8
+ * returned promise settles — so a caller can neither attach it to their own
9
+ * failure nor suppress it. The two entry points raise different error types,
10
+ * hence a shared predicate rather than a shared throw.
11
+ */
12
+ function describeNonWasmBinary(binary) {
13
+ const bytes = binary instanceof Uint8Array ? binary : new Uint8Array(binary);
14
+ if (bytes.length >= 4 && [
15
+ 0,
16
+ 97,
17
+ 115,
18
+ 109
19
+ ].every((b, i) => bytes[i] === b)) return null;
20
+ return `wasmBinary is not a WebAssembly module: expected magic bytes 00 61 73 6d, found ${Array.from(bytes.slice(0, 4)).map((b) => b.toString(16).padStart(2, "0")).join(" ") || "(empty)"}. Size: ${bytes.length} bytes`;
21
+ }
22
+ //#endregion
23
+ export { describeNonWasmBinary };
@@ -0,0 +1 @@
1
+ {"version":3,"file":"module-loader-browser.d.ts","sourceRoot":"","sources":["../../src/runtime/module-loader-browser.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG/C;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,YAAY,CAAC,CAsDvB"}