xbintsc 0.5.45 → 0.5.51

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 (206) hide show
  1. package/AGENTS.md +1 -1
  2. package/README.md +5 -4
  3. package/README.zh-CN.md +4 -3
  4. package/dist/src/cli/extensions.d.ts +24 -0
  5. package/dist/src/cli/extensions.js +62 -0
  6. package/dist/src/cli/extensions.js.map +1 -0
  7. package/dist/src/cli/help.d.ts +1 -1
  8. package/dist/src/cli/help.js +3 -1
  9. package/dist/src/cli/help.js.map +1 -1
  10. package/dist/src/cli/hints.js +8 -3
  11. package/dist/src/cli/hints.js.map +1 -1
  12. package/dist/src/cli/main.js +21 -28
  13. package/dist/src/cli/main.js.map +1 -1
  14. package/dist/src/diagnostics/diagnostic.d.ts +3 -1
  15. package/dist/src/diagnostics/diagnostic.js +2 -0
  16. package/dist/src/diagnostics/diagnostic.js.map +1 -1
  17. package/dist/src/driver/build-key.d.ts +2 -0
  18. package/dist/src/driver/build-key.js +1 -0
  19. package/dist/src/driver/build-key.js.map +1 -1
  20. package/dist/src/driver/compiler.js +61 -8
  21. package/dist/src/driver/compiler.js.map +1 -1
  22. package/dist/src/driver/config.d.ts +4 -0
  23. package/dist/src/driver/config.js +2 -0
  24. package/dist/src/driver/config.js.map +1 -1
  25. package/dist/src/driver/link-features.d.ts +37 -0
  26. package/dist/src/driver/link-features.js +123 -0
  27. package/dist/src/driver/link-features.js.map +1 -0
  28. package/dist/src/driver/options.d.ts +10 -0
  29. package/dist/src/driver/runtime-objects.d.ts +5 -0
  30. package/dist/src/driver/runtime-objects.js +20 -1
  31. package/dist/src/driver/runtime-objects.js.map +1 -1
  32. package/dist/src/driver/usage.d.ts +23 -0
  33. package/dist/src/driver/usage.js +353 -0
  34. package/dist/src/driver/usage.js.map +1 -0
  35. package/dist/src/driver/version.d.ts +1 -1
  36. package/dist/src/driver/version.js +1 -1
  37. package/dist/src/extensions/catalog.js +1 -2
  38. package/dist/src/extensions/catalog.js.map +1 -1
  39. package/dist/src/extensions/gui/features.d.ts +31 -0
  40. package/dist/src/extensions/gui/features.js +160 -0
  41. package/dist/src/extensions/gui/features.js.map +1 -0
  42. package/dist/src/extensions/gui/index.js +10 -4
  43. package/dist/src/extensions/gui/index.js.map +1 -1
  44. package/dist/src/extensions/link-feature.d.ts +70 -0
  45. package/dist/src/extensions/link-feature.js +18 -0
  46. package/dist/src/extensions/link-feature.js.map +1 -0
  47. package/dist/src/extensions/registry.d.ts +24 -4
  48. package/dist/src/extensions/registry.js +26 -3
  49. package/dist/src/extensions/registry.js.map +1 -1
  50. package/dist/src/index.d.ts +3 -2
  51. package/dist/src/index.js +0 -1
  52. package/dist/src/index.js.map +1 -1
  53. package/dist/tests/cli/hints.test.js +5 -7
  54. package/dist/tests/cli/hints.test.js.map +1 -1
  55. package/dist/tests/driver/link-features.test.js +105 -0
  56. package/dist/tests/driver/link-features.test.js.map +1 -0
  57. package/dist/tests/driver/usage.test.d.ts +1 -0
  58. package/dist/tests/driver/usage.test.js +88 -0
  59. package/dist/tests/driver/usage.test.js.map +1 -0
  60. package/dist/tests/e2e/gui-audio.test.js +4 -4
  61. package/dist/tests/e2e/gui-audio.test.js.map +1 -1
  62. package/dist/tests/e2e/gui-feature-linking.test.d.ts +9 -0
  63. package/dist/tests/e2e/gui-feature-linking.test.js +68 -0
  64. package/dist/tests/e2e/gui-feature-linking.test.js.map +1 -0
  65. package/dist/tests/e2e/gui-helpers.d.ts +5 -1
  66. package/dist/tests/e2e/gui-helpers.js +2 -0
  67. package/dist/tests/e2e/gui-helpers.js.map +1 -1
  68. package/dist/tests/e2e/gui-layout.test.js +4 -1
  69. package/dist/tests/e2e/gui-layout.test.js.map +1 -1
  70. package/dist/tests/e2e/gui-media-disabled.test.d.ts +5 -4
  71. package/dist/tests/e2e/gui-media-disabled.test.js +7 -6
  72. package/dist/tests/e2e/gui-media-disabled.test.js.map +1 -1
  73. package/dist/tests/e2e/gui-media.test.d.ts +5 -4
  74. package/dist/tests/e2e/gui-media.test.js +9 -9
  75. package/dist/tests/e2e/gui-media.test.js.map +1 -1
  76. package/dist/tests/e2e/gui-paint.test.js +5 -2
  77. package/dist/tests/e2e/gui-paint.test.js.map +1 -1
  78. package/dist/tests/e2e/gui-shaping.test.d.ts +5 -0
  79. package/dist/tests/e2e/gui-shaping.test.js +47 -0
  80. package/dist/tests/e2e/gui-shaping.test.js.map +1 -0
  81. package/dist/tests/e2e/gui-webgl-pipeline-cache.test.d.ts +18 -0
  82. package/dist/tests/e2e/gui-webgl-pipeline-cache.test.js +120 -0
  83. package/dist/tests/e2e/gui-webgl-pipeline-cache.test.js.map +1 -0
  84. package/dist/tests/extensions/gui-features.test.d.ts +1 -0
  85. package/dist/tests/extensions/gui-features.test.js +168 -0
  86. package/dist/tests/extensions/gui-features.test.js.map +1 -0
  87. package/doc/ai/cli.md +5 -1
  88. package/doc/ai/extensions.md +48 -23
  89. package/doc/ai/troubleshooting.md +10 -7
  90. package/doc/ai/zh-CN/cli.md +5 -1
  91. package/doc/ai/zh-CN/extensions.md +41 -20
  92. package/doc/ai/zh-CN/troubleshooting.md +6 -5
  93. package/doc/gui/api.md +2 -1
  94. package/doc/gui/build.md +136 -19
  95. package/doc/gui/canvas.md +1 -1
  96. package/doc/gui/known-issues.md +32 -3
  97. package/doc/gui/layout.md +1 -1
  98. package/doc/gui/media.md +13 -7
  99. package/doc/gui/rendering.md +32 -15
  100. package/doc/gui/runtime.md +5 -0
  101. package/doc/gui/webgl.md +24 -6
  102. package/doc/gui.md +50 -35
  103. package/doc/implemented/cli.md +2 -0
  104. package/doc/implemented/extensions.md +9 -3
  105. package/doc/npm-package.md +4 -4
  106. package/doc/xbintsc.config.schema.json +10 -0
  107. package/doc/zh-CN/gui/api.md +2 -1
  108. package/doc/zh-CN/gui/build.md +110 -16
  109. package/doc/zh-CN/gui/canvas.md +1 -1
  110. package/doc/zh-CN/gui/known-issues.md +24 -3
  111. package/doc/zh-CN/gui/layout.md +1 -1
  112. package/doc/zh-CN/gui/media.md +11 -6
  113. package/doc/zh-CN/gui/rendering.md +26 -9
  114. package/doc/zh-CN/gui/runtime.md +3 -0
  115. package/doc/zh-CN/gui/webgl.md +3 -3
  116. package/doc/zh-CN/gui.md +42 -29
  117. package/doc/zh-CN/implemented/cli.md +2 -0
  118. package/doc/zh-CN/implemented/extensions.md +9 -3
  119. package/doc/zh-CN/npm-package.md +4 -3
  120. package/package.json +7 -7
  121. package/runtime/ext_gui/browser.cpp +22 -15
  122. package/runtime/ext_gui/browser_loop.cpp +13 -1
  123. package/runtime/ext_gui/canvas.h +1 -1
  124. package/runtime/ext_gui/canvas_raster.cpp +1 -1
  125. package/runtime/ext_gui/canvas_text.cpp +1 -1
  126. package/runtime/ext_gui/dom_api_canvas.cpp +15 -8
  127. package/runtime/ext_gui/dom_api_canvas_extra.cpp +44 -20
  128. package/runtime/ext_gui/dom_api_canvas_image.cpp +3 -1
  129. package/runtime/ext_gui/dom_api_node_read.cpp +10 -0
  130. package/runtime/ext_gui/dom_api_offscreen.cpp +3 -1
  131. package/runtime/ext_gui/dom_api_style.cpp +7 -0
  132. package/runtime/ext_gui/dom_api_webgl_internal.h +4 -0
  133. package/runtime/ext_gui/dom_api_webgl_source.cpp +5 -2
  134. package/runtime/ext_gui/gpu_bridge.c +28 -0
  135. package/runtime/ext_gui/gpu_feature.cpp +30 -0
  136. package/runtime/ext_gui/gpu_shader.cpp +22 -0
  137. package/runtime/ext_gui/gpu_shader_api.h +50 -0
  138. package/runtime/ext_gui/gui.cpp +6 -37
  139. package/runtime/ext_gui/gui_canvas.cpp +14 -6
  140. package/runtime/ext_gui/gui_engine.h +1 -18
  141. package/runtime/ext_gui/gui_events.cpp +3 -2
  142. package/runtime/ext_gui/gui_webgl.cpp +25 -10
  143. package/runtime/ext_gui/image_api.cpp +18 -0
  144. package/runtime/ext_gui/image_api.h +41 -0
  145. package/runtime/ext_gui/image_bitmap_browser.cpp +20 -11
  146. package/runtime/ext_gui/image_bridge.c +22 -0
  147. package/runtime/ext_gui/image_feature.cpp +105 -0
  148. package/runtime/ext_gui/layout.cpp +13 -8
  149. package/runtime/ext_gui/layout.h +2 -2
  150. package/runtime/ext_gui/media.cpp +4 -2
  151. package/runtime/ext_gui/media.h +3 -3
  152. package/runtime/ext_gui/media_api.h +7 -6
  153. package/runtime/ext_gui/renderer.h +1 -1
  154. package/runtime/ext_gui/renderer_image.cpp +13 -6
  155. package/runtime/ext_gui/renderer_layer.cpp +10 -5
  156. package/runtime/ext_gui/stb_truetype.h +5077 -0
  157. package/runtime/ext_gui/text.cpp +24 -498
  158. package/runtime/ext_gui/text.h +7 -5
  159. package/runtime/ext_gui/text_api.h +45 -0
  160. package/runtime/ext_gui/text_bridge.c +23 -0
  161. package/runtime/ext_gui/text_cache.cpp +1 -1
  162. package/runtime/ext_gui/text_glyph_cache.cpp +2 -2
  163. package/runtime/ext_gui/text_hb.cpp +554 -0
  164. package/runtime/ext_gui/text_stb.cpp +513 -0
  165. package/runtime/ext_gui/webgl_api.cpp +19 -0
  166. package/runtime/ext_gui/webgl_api.h +53 -0
  167. package/runtime/ext_gui/webgl_bridge.c +25 -0
  168. package/runtime/ext_gui/webgl_draw_setup.cpp +42 -1
  169. package/runtime/ext_gui/webgl_feature.cpp +82 -0
  170. package/runtime/ext_gui/webgl_feature.h +28 -0
  171. package/runtime/ext_gui/webgl_msl.cpp +41 -0
  172. package/runtime/ext_gui/webgl_msl.h +6 -0
  173. package/runtime/ext_gui/webgl_shader.cpp +40 -32
  174. package/runtime/ext_gui/window.cpp +7 -7
  175. package/runtime/ext_media/decode_audio.cpp +1 -1
  176. package/runtime/ext_media/media.cpp +1 -1
  177. package/runtime/ext_media/media_bridge.c +7 -7
  178. package/scripts/build-gui.ts +97 -98
  179. package/scripts/check-file-length.ts +1 -0
  180. package/scripts/gui-build-options.ts +122 -0
  181. package/src/cli/extensions.ts +72 -0
  182. package/src/cli/help.ts +3 -1
  183. package/src/cli/hints.ts +9 -3
  184. package/src/cli/main.ts +21 -27
  185. package/src/diagnostics/diagnostic.ts +2 -0
  186. package/src/driver/build-key.ts +3 -0
  187. package/src/driver/compiler.ts +63 -8
  188. package/src/driver/config.ts +6 -0
  189. package/src/driver/link-features.ts +163 -0
  190. package/src/driver/options.ts +10 -0
  191. package/src/driver/runtime-objects.ts +26 -1
  192. package/src/driver/usage.ts +376 -0
  193. package/src/driver/version.ts +1 -1
  194. package/src/extensions/catalog.ts +1 -2
  195. package/src/extensions/gui/features.ts +162 -0
  196. package/src/extensions/gui/index.ts +10 -4
  197. package/src/extensions/link-feature.ts +72 -0
  198. package/src/extensions/registry.ts +45 -4
  199. package/src/index.ts +3 -2
  200. package/dist/src/extensions/media/index.d.ts +0 -28
  201. package/dist/src/extensions/media/index.js +0 -59
  202. package/dist/src/extensions/media/index.js.map +0 -1
  203. package/dist/tests/extensions/media.test.js +0 -63
  204. package/dist/tests/extensions/media.test.js.map +0 -1
  205. package/src/extensions/media/index.ts +0 -65
  206. /package/dist/tests/{extensions/media.test.d.ts → driver/link-features.test.d.ts} +0 -0
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,168 @@
1
+ import { join } from "node:path";
2
+ import { afterEach, describe, expect, it, vi } from "vitest";
3
+ const mocks = vi.hoisted(() => ({ findRuntimeLibrary: vi.fn() }));
4
+ /* Keep the archive lookup deterministic so both the success and the
5
+ * "not built yet" branches of `nativeObjects` can be exercised. */
6
+ vi.mock("../../src/driver/runtime-lib.js", () => ({
7
+ findRuntimeLibrary: mocks.findRuntimeLibrary,
8
+ runtimeLibDir: () => "/tmp/runtime/lib/darwin-x64",
9
+ }));
10
+ vi.mock("../../src/driver/paths.js", () => ({
11
+ findRuntimeDir: () => "/tmp/runtime",
12
+ platformSlug: () => "darwin-x64",
13
+ }));
14
+ import { guiExtension } from "../../src/extensions/gui/index.js";
15
+ import { guiLinkFeatures, hasGpuUsage, hasImageUsage, hasMediaUsage, hasShapingUsage, hasWebglUsage, } from "../../src/extensions/gui/features.js";
16
+ afterEach(() => {
17
+ vi.restoreAllMocks();
18
+ mocks.findRuntimeLibrary.mockReset();
19
+ });
20
+ /** Build a usage record with the fields a matcher reads. */
21
+ function usage(overrides = {}) {
22
+ return {
23
+ strings: [],
24
+ identifiers: new Set(),
25
+ getContext: [],
26
+ dynamicMarkup: false,
27
+ ...overrides,
28
+ };
29
+ }
30
+ /** The features in declaration order. */
31
+ const media = guiLinkFeatures.find((feature) => feature.name === "media");
32
+ const gpu = guiLinkFeatures.find((feature) => feature.name === "gpu");
33
+ const images = guiLinkFeatures.find((feature) => feature.name === "images");
34
+ const shaping = guiLinkFeatures.find((feature) => feature.name === "shaping");
35
+ const webgl = guiLinkFeatures.find((feature) => feature.name === "webgl");
36
+ describe("gui link features", () => {
37
+ it("declares media, gpu, images, shaping and webgl as optional halves of gui", () => {
38
+ expect(guiExtension.linkFeatures?.()).toBe(guiLinkFeatures);
39
+ expect(guiLinkFeatures.map((feature) => feature.name)).toEqual([
40
+ "media",
41
+ "gpu",
42
+ "images",
43
+ "shaping",
44
+ "webgl",
45
+ ]);
46
+ expect(media.description).toMatch(/FFmpeg/);
47
+ expect(gpu.description).toMatch(/glslang|GLSL/);
48
+ expect(images.description).toMatch(/stb_image|NanoSVG/);
49
+ expect(shaping.description).toMatch(/HarfBuzz|FreeType/);
50
+ expect(webgl.requires).toEqual(["gpu"]);
51
+ });
52
+ it("links the media bridge and the prebuilt archive", () => {
53
+ mocks.findRuntimeLibrary.mockReturnValue("/tmp/media.a");
54
+ expect(media.runtimeSources?.()).toEqual([join("/tmp/runtime", "ext_media", "media_bridge.c")]);
55
+ expect(media.nativeObjects?.()).toEqual(["/tmp/media.a"]);
56
+ expect(mocks.findRuntimeLibrary).toHaveBeenCalledWith("media");
57
+ });
58
+ it("links the gpu bridge without an archive (the code is in gui.a)", () => {
59
+ expect(gpu.runtimeSources?.()).toEqual([join("/tmp/runtime", "ext_gui", "gpu_bridge.c")]);
60
+ expect(gpu.nativeObjects?.()).toBeUndefined();
61
+ });
62
+ it("links the images bridge without an archive", () => {
63
+ expect(images.runtimeSources?.()).toEqual([join("/tmp/runtime", "ext_gui", "image_bridge.c")]);
64
+ expect(images.nativeObjects?.()).toBeUndefined();
65
+ });
66
+ it("links the shaping bridge without an archive", () => {
67
+ expect(shaping.runtimeSources?.()).toEqual([join("/tmp/runtime", "ext_gui", "text_bridge.c")]);
68
+ expect(shaping.nativeObjects?.()).toBeUndefined();
69
+ });
70
+ it("links the webgl bridge without an archive", () => {
71
+ expect(webgl.runtimeSources?.()).toEqual([join("/tmp/runtime", "ext_gui", "webgl_bridge.c")]);
72
+ expect(webgl.nativeObjects?.()).toBeUndefined();
73
+ });
74
+ it("fails with an actionable message when the media archive is missing", () => {
75
+ mocks.findRuntimeLibrary.mockReturnValue(undefined);
76
+ expect(() => media.nativeObjects?.()).toThrow(/media native library not found/);
77
+ expect(() => media.nativeObjects?.()).toThrow(/npm run media/);
78
+ expect(() => media.nativeObjects?.()).toThrow(/darwin-x64/);
79
+ });
80
+ it("adds FFmpeg's Win32 libraries on Windows only", () => {
81
+ vi.spyOn(process, "platform", "get").mockReturnValue("win32");
82
+ expect(media.linkerFlags?.()).toEqual(["-lbcrypt", "-lole32", "-luser32"]);
83
+ vi.restoreAllMocks();
84
+ vi.spyOn(process, "platform", "get").mockReturnValue("darwin");
85
+ expect(media.linkerFlags?.()).toEqual(["-lm"]);
86
+ });
87
+ });
88
+ describe("media usage detection", () => {
89
+ it("recognises <video>/<audio> tags in HTML strings", () => {
90
+ expect(hasMediaUsage(usage({ strings: ['<html><video src="x.mp4"></video>'] }))).toBe(true);
91
+ expect(hasMediaUsage(usage({ strings: ["<audio controls></audio>"] }))).toBe(true);
92
+ });
93
+ it("recognises createElement tag names and the Audio constructor", () => {
94
+ expect(hasMediaUsage(usage({ strings: ["video"] }))).toBe(true);
95
+ expect(hasMediaUsage(usage({ identifiers: new Set(["Audio"]) }))).toBe(true);
96
+ expect(hasMediaUsage(usage({ identifiers: new Set(["HTMLVideoElement"]) }))).toBe(true);
97
+ expect(hasMediaUsage(usage({ identifiers: new Set(["decodeAudioData"]) }))).toBe(true);
98
+ });
99
+ it("stays off for a DOM-only page and turns on for dynamic markup", () => {
100
+ expect(hasMediaUsage(usage({ strings: ["<div>hi</div>"], identifiers: new Set(["document"]) }))).toBe(false);
101
+ expect(hasMediaUsage(usage({ dynamicMarkup: true }))).toBe(true);
102
+ });
103
+ });
104
+ describe("gpu usage detection", () => {
105
+ it("turns on for a WebGL context", () => {
106
+ expect(hasGpuUsage(usage({ getContext: ["webgl2"] }))).toBe(true);
107
+ expect(hasGpuUsage(usage({ getContext: ["experimental-webgl"] }))).toBe(true);
108
+ });
109
+ it("turns on for a context kind decided at run time", () => {
110
+ expect(hasGpuUsage(usage({ getContext: [undefined] }))).toBe(true);
111
+ });
112
+ it("turns on for mix-blend-mode in HTML/CSS or the style property", () => {
113
+ expect(hasGpuUsage(usage({ strings: ["style=\"mix-blend-mode: multiply\""] }))).toBe(true);
114
+ expect(hasGpuUsage(usage({ identifiers: new Set(["mixBlendMode"]) }))).toBe(true);
115
+ });
116
+ it("stays off for a 2D canvas and plain DOM", () => {
117
+ expect(hasGpuUsage(usage({ getContext: ["2d"] }))).toBe(false);
118
+ expect(hasGpuUsage(usage({ strings: ["<canvas id=c></canvas>"] }))).toBe(false);
119
+ });
120
+ it("turns on for dynamic markup", () => {
121
+ expect(hasGpuUsage(usage({ dynamicMarkup: true }))).toBe(true);
122
+ });
123
+ });
124
+ describe("webgl usage detection", () => {
125
+ it("turns on only for a WebGL context or a webgl string", () => {
126
+ expect(hasWebglUsage(usage({ getContext: ["webgl2"] }))).toBe(true);
127
+ expect(hasWebglUsage(usage({ strings: ["webgl2"] }))).toBe(true);
128
+ expect(hasWebglUsage(usage({ getContext: [undefined] }))).toBe(true);
129
+ });
130
+ it("stays off for a 2D canvas, blend-only CSS and plain DOM", () => {
131
+ expect(hasWebglUsage(usage({ getContext: ["2d"] }))).toBe(false);
132
+ expect(hasWebglUsage(usage({ strings: ["mix-blend-mode: multiply"] }))).toBe(false);
133
+ expect(hasWebglUsage(usage({ strings: ["<canvas id=c></canvas>"] }))).toBe(false);
134
+ });
135
+ it("turns on for dynamic markup", () => {
136
+ expect(hasWebglUsage(usage({ dynamicMarkup: true }))).toBe(true);
137
+ });
138
+ });
139
+ describe("image usage detection", () => {
140
+ it("turns on for <img>, CSS backgrounds, SVG and drawImage", () => {
141
+ expect(hasImageUsage(usage({ strings: ["<img src=a.png>"] }))).toBe(true);
142
+ expect(hasImageUsage(usage({ strings: ["background-image: url(a.png)"] }))).toBe(true);
143
+ expect(hasImageUsage(usage({ strings: ["<svg viewBox='0 0 10 10'></svg>"] }))).toBe(true);
144
+ expect(hasImageUsage(usage({ identifiers: new Set(["drawImage"]) }))).toBe(true);
145
+ });
146
+ it("stays off for text-only DOM", () => {
147
+ expect(hasImageUsage(usage({ strings: ["<div>Hello</div>"] }))).toBe(false);
148
+ expect(hasImageUsage(usage({ getContext: ["2d"] }))).toBe(false);
149
+ });
150
+ it("turns on for dynamic markup", () => {
151
+ expect(hasImageUsage(usage({ dynamicMarkup: true }))).toBe(true);
152
+ });
153
+ });
154
+ describe("shaping usage detection", () => {
155
+ it("turns on for non-ASCII text and escaped/encoded codepoints", () => {
156
+ expect(hasShapingUsage(usage({ strings: ["<p>中文测试</p>"] }))).toBe(true);
157
+ expect(hasShapingUsage(usage({ strings: ["café"] }))).toBe(true);
158
+ expect(hasShapingUsage(usage({ strings: ["\\u4e2d\\u6587"] }))).toBe(true);
159
+ expect(hasShapingUsage(usage({ strings: ["&#20013;&#25991;"] }))).toBe(true);
160
+ });
161
+ it("stays off for ASCII-only text", () => {
162
+ expect(hasShapingUsage(usage({ strings: ["<div>Hello</div>"] }))).toBe(false);
163
+ });
164
+ it("turns on for dynamic markup", () => {
165
+ expect(hasShapingUsage(usage({ dynamicMarkup: true }))).toBe(true);
166
+ });
167
+ });
168
+ //# sourceMappingURL=gui-features.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"gui-features.test.js","sourceRoot":"","sources":["../../../tests/extensions/gui-features.test.ts"],"names":[],"mappings":"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"}
package/doc/ai/cli.md CHANGED
@@ -47,7 +47,9 @@ so restart it after installing a dependency.
47
47
  --out <dir> Output directory (default: build/)
48
48
  --emit <kind> exe | obj | ir (default: exe)
49
49
  -O0 .. -O3 Optimization level passed to clang (default: -O2)
50
- --ext <names> Enable bundled extensions, comma separated (e.g. node,gui,media)
50
+ --ext <names> Enable bundled extensions, comma separated (e.g. node,gui)
51
+ --feature <names> Force optional link features on (media,gpu,images,shaping,webgl,all)
52
+ --no-feature <n> Keep optional link features out even when detected
51
53
  --ext-native <m> Register a C++/Rust extension from a JSON manifest
52
54
  (comma separated for several)
53
55
  --config <path> Use this project config instead of discovering one
@@ -121,6 +123,8 @@ matching field. `--no-config` skips discovery entirely.
121
123
  | `pgoDir` | string | Profile directory (default `<outDir>/pgo`) |
122
124
  | `extensions` | string[] | Bundled extensions to enable, e.g. `["node"]` |
123
125
  | `extNative` | string[] | Native extension manifest paths |
126
+ | `features` | string[] | Optional link features to force on, e.g. `["media"]` / `["all"]` |
127
+ | `noFeatures` | string[] | Optional link features to keep out even when detected |
124
128
  | `force` | boolean | Ignore the incremental cache |
125
129
  | `app.name` / `app.icon` / `app.bundle` / `app.bundleId` | | Application metadata ([icon.md](../icon.md)) |
126
130
 
@@ -1,8 +1,10 @@
1
- # Extensions: Node modules, GUI, media, C++/Rust libraries
1
+ # Extensions: Node modules, GUI, link features, C++/Rust libraries
2
2
 
3
3
  The compiler core is platform-agnostic. Anything platform-specific — Node's
4
4
  `fs`, an HTML/CSS renderer, your own C++ library — arrives as an **extension**
5
5
  that contributes module bindings plus the C/C++ sources or objects to link.
6
+ Heavy optional halves of an extension (FFmpeg, glslang) are **link features**
7
+ selected from the program instead of separate extension flags.
6
8
 
7
9
  ## The rule that trips people up
8
10
 
@@ -74,8 +76,9 @@ blocks, because the runtime parser only reads inline `<style>`; and it rewrites
74
76
  a bundled three.js module's `WebGLRenderer` to use the real WebGL 2 backend:
75
77
  only its shader unroller is patched, and no Canvas2D fallback is bundled. It
76
78
  ships as a per-platform prebuilt `gui.a`/`gui.lib` because it is C++. `<img>` decodes through the engine
77
- itself; `<video>`/`<audio>` do **not** work with `gui` alone — they need the
78
- separate [`media`](#media--videoaudio-decoding) extension. `<canvas>` is
79
+ itself; `<video>`/`<audio>` decoding (FFmpeg) and GLSL translation (glslang) are
80
+ **optional link features** selected from the program — see
81
+ [Optional link features](#optional-link-features-media-gpu-images-shaping-webgl). `<canvas>` is
79
82
  supported too: `getContext("2d")` returns a context whose fills, paths,
80
83
  gradients, text and `drawImage` are rasterised by a self-written CPU rasteriser
81
84
  (plus line caps/joins, dashed strokes, `ellipse` and `roundRect`), and element
@@ -101,7 +104,7 @@ Pages written for the browser also get the browser globals they reach for —
101
104
  (`AudioContext` with gain, oscillator, buffer-source, biquad, compressor,
102
105
  stereo-panner, constant-source and delay nodes, a real 48 kHz mixer, per-sample
103
106
  AudioParam automation, and `decodeAudioData` for WAV in-engine plus compressed
104
- formats through `media`) — plus a frame pump that
107
+ formats through the `media` feature) — plus a frame pump that
105
108
  starts at `loadHTML` and re-arms only while animation-frame callbacks remain, so
106
109
  a page that never calls `run()` still paints and then exits. **WebGL 1.0 and 2.0 are implemented**: `canvas.getContext("webgl")` /
107
110
  `"webgl2"` return a GPU context whose GLSL ES shaders are compiled to SPIR-V by
@@ -109,19 +112,46 @@ a bundled glslang — consumed by Vulkan, or cross-compiled to MSL by bundled
109
112
  SPIRV-Cross on Metal — and drawn through SDL_GPU; the page composites the colour
110
113
  texture without a CPU readback, and WebGL 2 adds VAOs, instancing, integer
111
114
  attributes, sampler objects, `texStorage2D` and buffer copies (see
112
- [../gui/webgl.md](../gui/webgl.md)). WebXR, `<video>`/`<audio>` without
113
- `media`, and streaming are **not** implemented:
114
- `typeof` answers `"undefined"` so a page takes its own fallback branch. `fetch`
115
+ [../gui/webgl.md](../gui/webgl.md)). WebXR and streaming are **not**
116
+ implemented: `typeof` answers `"undefined"` so a page takes its own fallback
117
+ branch. `fetch`
115
118
  is **not** a GUI extension feature: the core runtime provides it (`http://`,
116
119
  plus local `file://` and relative paths; no HTTPS or streaming), so GUI
117
120
  programs can use it too. See [../implemented/fetch.md](../implemented/fetch.md).
118
121
 
119
- ### `media` — video/audio decoding
120
-
121
- Enable with `--ext media` **together with** `gui` (`--ext gui,media`; the
122
- registry rejects `media` on its own). It links a separate FFmpeg-backed
123
- `media.a`/`media.lib`, so adding `<video>`/`<audio>` playback does not make a
124
- GUI-only binary any larger.
122
+ ### Optional link features (`media`, `gpu`, `images`, `shaping`, `webgl`)
123
+
124
+ `gui` is one extension, but its heavy halves are optional **link features**. The
125
+ compiler scans the bundled HTML/CSS/TS (imported `.html` assets and their inlined
126
+ CSS are part of the bundle) and selects them per program; you do not pass an
127
+ extension flag:
128
+
129
+ - **`media`** — FFmpeg decoding for `<video>`/`<audio>` and compressed
130
+ `decodeAudioData`. Selected by a `<video>`/`<audio>` element,
131
+ `createElement("video"/"audio")`, `new Audio()`, `decodeAudioData`, or markup
132
+ built at run time. Links the FFmpeg-backed `media.a`/`media.lib`.
133
+ - **`gpu`** — the glslang/SPIRV-Cross GLSL translator shared by WebGL and
134
+ `mix-blend-mode`. Selected by `getContext("webgl"/"webgl2"/…)` (or a context
135
+ kind decided at run time), any `webgl` string, or `mix-blend-mode`.
136
+ - **`images`** — stb_image/NanoSVG decoding for `<img>`, inline `<svg>`, CSS
137
+ `background-image`/`url(...)`, `drawImage`/`createImageBitmap`/`Image`, and an
138
+ app icon. A text-only page links neither decoder.
139
+ - **`shaping`** — HarfBuzz + FreeType for full OpenType shaping (ligatures,
140
+ complex scripts) and CFF/OTF/variable fonts. Selected automatically for
141
+ non-ASCII text (or an escaped/entity codepoint); a Latin-only page keeps the
142
+ stb_truetype backend and links neither library.
143
+ - **`webgl`** — the WebGL context and DOM bindings. Selected by a WebGL
144
+ `getContext(...)` or a `webgl` string; it requires `gpu`, so both activate
145
+ together. A page that never asks for WebGL links neither.
146
+
147
+ Override the scan with `--feature media,gpu,images,shaping,webgl` (or `all`) and keep a
148
+ feature out with `--no-feature media`. `--verbose` prints the selected set. A
149
+ program that only renders HTML/CSS/2D canvas links no FFmpeg, glslang, image
150
+ decoder, HarfBuzz/FreeType or WebGL context; a page that
151
+ builds HTML/CSS from runtime data should pass `--feature all` because the scan
152
+ cannot see it. If an auto-detected feature's archive is missing, the build warns
153
+ and the capability degrades at run time (media elements fire `error`); a forced
154
+ feature makes it an error.
125
155
 
126
156
  The DOM API is the same as for any HTML media element: `play()` / `pause()` /
127
157
  `load()`, the `paused` / `ended` / `duration` / `currentTime` / `volume` /
@@ -129,16 +159,11 @@ The DOM API is the same as for any HTML media element: `play()` / `pause()` /
129
159
  `src` properties, and `loadedmetadata`/`play`/`pause`/`ended`/`timeupdate`/
130
160
  `error` events. There are no built-in controls — draw your own chrome with
131
161
  elements and CSS (see `examples/gui/media.ts`). Video frames and audio PCM are
132
- decoded on the main thread; video goes through the image texture path. Without
133
- the extension, opening a media source fails and fires `error` (the element and
134
- its API still exist). The archive is built for every host: POSIX produces
135
- `media.a`, while Windows produces `media.lib` from FFmpeg compiled with the
136
- MSVC-targeting `clang-cl`, so it links with `gui.lib`. Building it on Windows
137
- needs a POSIX shell (Git for Windows' bundled bash) and a native GNU make
138
- (Chocolatey `make`, or `xbintsc_MAKE`). See
139
- [../gui/build.md](../gui/build.md). Without the archive, or on a host where
140
- `npm run media` has not run, media elements report `error`; see
141
- [../gui/known-issues.md](../gui/known-issues.md).
162
+ decoded on the main thread; video goes through the image texture path. Building
163
+ the archive on Windows needs a POSIX shell (Git for Windows' bundled bash) and a
164
+ native GNU make (Chocolatey `make`, or `xbintsc_MAKE`). See
165
+ [../gui/build.md](../gui/build.md) and
166
+ [../gui/media.md](../gui/media.md).
142
167
 
143
168
  ## Third-party npm packages
144
169
 
@@ -123,15 +123,18 @@ optional `@xbintsc/<os>-<arch>` npm package ships it (reinstall without
123
123
 
124
124
  ### `media native library not found at …`
125
125
 
126
- `<video>`/`<audio>` playback needs the optional `media` archive (`media.a`, or
127
- `media.lib` on Windows). The `@xbintsc/<os>-<arch>` npm package ships it where
128
- the release builds it; otherwise build it separately with `npm run media`. Build
129
- it, or drop `--ext media`; a GUI-only build still links and media elements simply fire
130
- `error`. The `media` extension also requires `gui`, and `--ext media` alone is
131
- rejected with the flags to pass. On Windows the FFmpeg build additionally needs
126
+ `<video>`/`<audio>` decoding needs the optional `media` link feature and its
127
+ archive (`media.a`, or `media.lib` on Windows). The `@xbintsc/<os>-<arch>` npm
128
+ package ships it where the release builds it; otherwise build it with
129
+ `npm run media`. When the feature is selected automatically and the archive is
130
+ missing, the build prints a **warning** and continues; media elements then simply
131
+ fire `error`. An explicit `--feature media` (or the deprecated `--ext media`)
132
+ makes it a hard error instead. Use `--no-feature media` to opt out on purpose.
133
+ On Windows the FFmpeg build additionally needs
132
134
  a POSIX shell (Git for Windows' bash) and a native GNU make (Chocolatey `make`,
133
135
  or `xbintsc_MAKE`). The script names whichever is missing. See
134
- [../gui/build.md](../gui/build.md).
136
+ [../gui/build.md](../gui/build.md) and
137
+ [../gui/build.md#link-features](../gui/build.md#link-features).
135
138
 
136
139
  ### `Icon file not found` / icon tools missing
137
140
 
@@ -40,7 +40,9 @@
40
40
  --out <dir> 输出目录(默认 build/)
41
41
  --emit <kind> exe | obj | ir(默认 exe)
42
42
  -O0 .. -O3 传给 clang 的优化级别(默认 -O2)
43
- --ext <names> 开启内置扩展,逗号分隔(如 node,gui,media)
43
+ --ext <names> 开启内置扩展,逗号分隔(如 node,gui)
44
+ --feature <names> 强制开启可选链接特性(media,gpu,images,shaping,webgl,all)
45
+ --no-feature <n> 即使检测到也不链接该可选特性
44
46
  --ext-native <m> 通过 JSON 清单注册 C++/Rust 扩展(多个用逗号分隔)
45
47
  --config <path> 使用指定项目配置,不做自动发现
46
48
  --no-config 完全不读取项目配置
@@ -102,6 +104,8 @@ profile 数据可能独立于源码变化。
102
104
  | `pgoDir` | string | Profile 目录(默认 `<outDir>/pgo`) |
103
105
  | `extensions` | string[] | 开启的内置扩展,如 `["node"]` |
104
106
  | `extNative` | string[] | 原生扩展清单路径 |
107
+ | `features` | string[] | 强制开启的可选链接特性,如 `["media"]` / `["all"]` |
108
+ | `noFeatures` | string[] | 即使检测到也保持关闭的可选链接特性 |
105
109
  | `force` | boolean | 忽略增量缓存 |
106
110
  | `app.name` / `app.icon` / `app.bundle` / `app.bundleId` | | 应用元信息([icon.md](../../zh-CN/icon.md)) |
107
111
 
@@ -1,8 +1,9 @@
1
- # 扩展:Node 模块、GUI、媒体、C++/Rust 库
1
+ # 扩展:Node 模块、GUI、链接特性、C++/Rust 库
2
2
 
3
3
  编译器核心与平台无关。任何与平台相关的东西——Node 的 `fs`、一个 HTML/CSS 渲染器、
4
4
  你自己的 C++ 库——都以**扩展**的形式接入:它既贡献模块绑定,也贡献要一起编译/链接的
5
- C/C++ 源码或目标文件。
5
+ C/C++ 源码或目标文件。扩展里的重型可选部分(FFmpeg、glslang)做成**链接特性**,
6
+ 由程序用法选择,而不是单独的扩展开关。
6
7
 
7
8
  ## 最容易踩的规则
8
9
 
@@ -70,8 +71,9 @@ import { createWindow, run } from "gui";
70
71
  `<style>` 块(运行时解析器只读取内联 `<style>`);并让随包引入的 Three.js 的
71
72
  `WebGLRenderer` 先探测 WebGL 上下文:引擎有上下文时使用 Three.js 自己的渲染器,
72
73
  直接使用真实的 WebGL 2 后端(只修补其着色器循环展开,不再打包 Canvas2D 回退)。
73
- `<img>` 由引擎自身解码;而 `<video>`/`<audio>` 在只启用 `gui` 时**不可用**
74
- ——它们需要单独的 [`media`](#media--视频音频解码) 扩展。也支持 `<canvas>`:
74
+ `<img>` 由引擎自身解码;`<video>`/`<audio>` 解码(FFmpeg)与 GLSL 翻译(glslang)
75
+ 是**可选的链接特性**,由程序自动选择——见
76
+ [可选链接特性](#可选链接特性media-gpu-images-shaping-webgl)。也支持 `<canvas>`:
75
77
  `getContext("2d")` 返回的上下文,其填充、路径、
76
78
  渐变、文本与 `drawImage` 由自研 CPU 光栅器处理(另有线段端点/连接、虚线描边、
77
79
  `ellipse` 与 `roundRect`),元素句柄还暴露 `width`/`height`。CSS
@@ -91,38 +93,57 @@ import { createWindow, run } from "gui";
91
93
  `getComputedStyle`、`alert`/`prompt`、`escape`、`Event` 家族,以及可用的 Web Audio
92
94
  实现(`AudioContext` 提供 gain、oscillator、buffer-source、biquad、compressor、
93
95
  stereo-panner、constant-source 与 delay 节点、真实的 48 kHz 混音器、逐采样的
94
- AudioParam 自动化,`decodeAudioData` 引擎内解码 WAV,压缩格式则通过 `media`)—— 另外还有帧泵:
96
+ AudioParam 自动化,`decodeAudioData` 引擎内解码 WAV,压缩格式则通过 `media` 特性)—— 另外还有帧泵:
95
97
  它在 `loadHTML` 时启动,仅在仍有动画帧回调时重新排程,因此从不调用 `run()` 的页面
96
98
  也能绘制并最终退出。**WebGL 1.0 与 2.0 已实现**:`canvas.getContext("webgl")` /
97
99
  `"webgl2"` 返回 GPU 上下文,其 GLSL ES 着色器由内置 glslang 编译为 SPIR-V
98
100
  (Vulkan 直接消费,Metal 上由内置 SPIRV-Cross 转成 MSL),
99
101
  并通过 SDL_GPU 绘制;页面直接合成颜色纹理而无须 CPU 读回,WebGL 2 还增加
100
102
  VAO、实例化、整数属性、采样器对象、`texStorage2D` 与缓冲拷贝(见
101
- [../../zh-CN/gui/webgl.md](../../zh-CN/gui/webgl.md))。WebXR、未启用
102
- `media` 时的 `<video>`/`<audio>` 与流式接口**尚未实现**:`typeof` 会回答
103
+ [../../zh-CN/gui/webgl.md](../../zh-CN/gui/webgl.md))。WebXR 与流式接口**尚未实现**:
104
+ `typeof` 会回答
103
105
  `"undefined"`,让页面走自己的降级分支。`fetch` 不是 GUI 扩展的功能——它由核心
104
106
  运行时提供(`http://`,以及本地 `file://` 与相对路径;不支持 HTTPS 与流式),
105
107
  因此 GUI 程序同样可用。见 [../../implemented/fetch.md](../../implemented/fetch.md)。
106
108
 
107
- ### `media` —— 视频/音频解码
108
-
109
- 用 `--ext media` **与 `gui` 一起**开启(`--ext gui,media`;注册表会拒绝单独启用
110
- `media`)。它链接单独的 FFmpeg 后端 `media.a`/`media.lib`,因此加入
111
- `<video>`/`<audio>` 播放不会让只做界面的二进制变大。
109
+ ### 可选链接特性(media、gpu、images、shaping、webgl)
110
+
111
+ `gui` 仍然只有一个扩展,但其中的重型部分是可选的**链接特性**。编译器扫描打包后的
112
+ HTML/CSS/TS(导入的 `.html` 与内联 CSS 都属于 bundle),按程序自动选择;不需要额外
113
+ 扩展参数:
114
+
115
+ - **`media`** —— `<video>`/`<audio>` 与压缩格式 `decodeAudioData` 的 FFmpeg 解码。
116
+ 由 `<video>`/`<audio>` 元素、`createElement("video"/"audio")`、`new Audio()`、
117
+ `decodeAudioData` 或运行时拼出的 markup 触发,链接 FFmpeg 后端
118
+ `media.a`/`media.lib`。
119
+ - **`gpu`** —— WebGL 与 `mix-blend-mode` 共用的 glslang/SPIRV-Cross GLSL 翻译器。
120
+ 由 `getContext("webgl"/"webgl2"/…)`(或运行时决定的 kind)、任意 `webgl` 字符串、
121
+ `mix-blend-mode` 触发。
122
+ - **`images`** —— `<img>`、内联 `<svg>`、CSS `background-image`/`url(...)`、
123
+ `drawImage`/`createImageBitmap`/`Image` 与应用图标所需的 stb_image/NanoSVG 解码。
124
+ 纯文本页面两个解码器都不链接。
125
+ - **`shaping`** —— HarfBuzz + FreeType 提供的完整 OpenType 整形(连字、复杂文种)
126
+ 与 CFF/OTF/可变字体支持。非 ASCII 文本(或转义/实体码点)会自动选中;纯拉丁页面
127
+ 保持 stb_truetype 后端,两个库都不链接。
128
+ - **`webgl`** —— WebGL context 与 DOM 绑定。由 WebGL 的 `getContext(...)` 或
129
+ `webgl` 字符串触发;它依赖 `gpu`,两者一起激活。不用 WebGL 的页面两者都不链接。
130
+
131
+ 用 `--feature media,gpu,images,shaping,webgl`(或 `all`)覆盖扫描,用 `--no-feature media`
132
+ 强制不链接。`--verbose` 会打印选中的集合。只渲染 HTML/CSS/2D canvas 的程序既不链接
133
+ FFmpeg、glslang,也不链接图片解码器、HarfBuzz/FreeType 或 WebGL context;用运行时数据拼 HTML/CSS 的
134
+ 页面应传 `--feature all`,因为扫描看不到它。
135
+ 自动检测到的特性归档缺失时构建打印 warning,能力在运行时降级(媒体元素触发
136
+ `error`);显式强制的特性则报错。
112
137
 
113
138
  DOM API 与普通 HTML 媒体元素一致:`play()` / `pause()` / `load()`,以及
114
139
  `paused` / `ended` / `duration` / `currentTime` / `volume` / `muted` / `loop` /
115
140
  `autoplay` / `videoWidth` / `videoHeight` / `readyState` / `src` 属性,还有
116
141
  `loadedmetadata`/`play`/`pause`/`ended`/`timeupdate`/`error` 事件。没有内置
117
142
  控件——用元素和 CSS 自绘控件(见 `examples/gui/media.ts`)。视频帧与音频 PCM
118
- 都在主线程解码;视频走图像纹理路径。没有该扩展时,打开媒体源会失败并触发
119
- `error`(元素与 API 仍然存在)。归档会为每个宿主平台构建:POSIX 产出
120
- `media.a`,Windows 则用面向 MSVC 的 `clang-cl` 编译 FFmpeg 并产出 `media.lib`,
121
- 因此可与 `gui.lib` 链接。Windows 上构建它需要 POSIX shell(Git for Windows
122
- 自带的 bash)与原生 GNU make(Chocolatey `make`,或 `xbintsc_MAKE`)。见
123
- [../../zh-CN/gui/build.md](../../zh-CN/gui/build.md)。
124
- 没有归档、或宿主上还没运行 `npm run media` 时,媒体元素会触发 `error`;见
125
- [../../zh-CN/gui/known-issues.md](../../zh-CN/gui/known-issues.md)。
143
+ 都在主线程解码;视频走图像纹理路径。Windows 上构建归档需要 POSIX shell(Git for
144
+ Windows 自带的 bash)与原生 GNU make(Chocolatey `make`,或 `xbintsc_MAKE`)。见
145
+ [../../zh-CN/gui/build.md](../../zh-CN/gui/build.md) 与
146
+ [../../zh-CN/gui/media.md](../../zh-CN/gui/media.md)。
126
147
 
127
148
  ## 第三方 npm 包
128
149
 
@@ -113,14 +113,15 @@ npm 包会提供它(去掉 `--omit=optional` 重新安装),但普通源码
113
113
 
114
114
  ### `media native library not found at …`
115
115
 
116
- `<video>`/`<audio>` 播放需要可选的 `media` 归档(`media.a`,Windows 上是
116
+ `<video>`/`<audio>` 解码需要可选的 `media` 链接特性及其归档(`media.a`,Windows 上是
117
117
  `media.lib`)。发布为其构建时,`@xbintsc/<os>-<arch>` npm 包会提供它;否则用
118
- `npm run media` 单独构建。构建它,或去掉 `--ext media`;
119
- 仅启用 `gui` 的构建仍可链接,媒体元素只会触发 `error`。`media` 扩展还依赖
120
- `gui`,单独 `--ext media` 会被拒绝并提示应传的 flag。Windows 上 FFmpeg 的
118
+ `npm run media` 构建。自动选中该特性而归档缺失时,构建打印 **warning** 后继续,
119
+ 媒体元素只会触发 `error`;显式 `--feature media`(或弃用的 `--ext media`)则直接
120
+ 报错。可以用 `--no-feature media` 主动关闭。Windows 上 FFmpeg 的
121
121
  构建还需要 POSIX shell(Git for Windows 的 bash)与原生 GNU make
122
122
  (Chocolatey `make`,或 `xbintsc_MAKE`)。脚本会指出缺失的是哪一个。见
123
- [../../zh-CN/gui/build.md](../../zh-CN/gui/build.md)。
123
+ [../../zh-CN/gui/build.md](../../zh-CN/gui/build.md) 与
124
+ [../../zh-CN/gui/build.md#链接特性](../../zh-CN/gui/build.md#链接特性)。
124
125
 
125
126
  ### `Icon file not found` / 图标工具缺失
126
127
 
package/doc/gui/api.md CHANGED
@@ -137,7 +137,8 @@ evaluated per sample, so a ramp keeps moving while the page is idle.
137
137
  procedurally. `decodeAudioData(bytes)` returns a promise for a decoded
138
138
  AudioBuffer: WAV (PCM 8/16/24/32-bit, IEEE float 32/64, A-law and µ-law) is
139
139
  decoded by the engine itself; MP3, AAC/M4A, Vorbis, Opus and FLAC need the
140
- optional `media` extension (`--ext gui,media`), whose FFmpeg decoder is used as
140
+ optional `media` link feature (auto-selected when the program calls
141
+ `decodeAudioData`), whose FFmpeg decoder is used as
141
142
  the fallback. `bytes` may be an ArrayBuffer, a typed array, a Node `Buffer`, or
142
143
  the raw byte string `fs.readFileSync` returns (this runtime has no dedicated
143
144
  binary type, and that string's storage is exactly the file bytes). The result