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.
- package/AGENTS.md +1 -1
- package/README.md +5 -4
- package/README.zh-CN.md +4 -3
- package/dist/src/cli/extensions.d.ts +24 -0
- package/dist/src/cli/extensions.js +62 -0
- package/dist/src/cli/extensions.js.map +1 -0
- package/dist/src/cli/help.d.ts +1 -1
- package/dist/src/cli/help.js +3 -1
- package/dist/src/cli/help.js.map +1 -1
- package/dist/src/cli/hints.js +8 -3
- package/dist/src/cli/hints.js.map +1 -1
- package/dist/src/cli/main.js +21 -28
- package/dist/src/cli/main.js.map +1 -1
- package/dist/src/diagnostics/diagnostic.d.ts +3 -1
- package/dist/src/diagnostics/diagnostic.js +2 -0
- package/dist/src/diagnostics/diagnostic.js.map +1 -1
- package/dist/src/driver/build-key.d.ts +2 -0
- package/dist/src/driver/build-key.js +1 -0
- package/dist/src/driver/build-key.js.map +1 -1
- package/dist/src/driver/compiler.js +61 -8
- package/dist/src/driver/compiler.js.map +1 -1
- package/dist/src/driver/config.d.ts +4 -0
- package/dist/src/driver/config.js +2 -0
- package/dist/src/driver/config.js.map +1 -1
- package/dist/src/driver/link-features.d.ts +37 -0
- package/dist/src/driver/link-features.js +123 -0
- package/dist/src/driver/link-features.js.map +1 -0
- package/dist/src/driver/options.d.ts +10 -0
- package/dist/src/driver/runtime-objects.d.ts +5 -0
- package/dist/src/driver/runtime-objects.js +20 -1
- package/dist/src/driver/runtime-objects.js.map +1 -1
- package/dist/src/driver/usage.d.ts +23 -0
- package/dist/src/driver/usage.js +353 -0
- package/dist/src/driver/usage.js.map +1 -0
- package/dist/src/driver/version.d.ts +1 -1
- package/dist/src/driver/version.js +1 -1
- package/dist/src/extensions/catalog.js +1 -2
- package/dist/src/extensions/catalog.js.map +1 -1
- package/dist/src/extensions/gui/features.d.ts +31 -0
- package/dist/src/extensions/gui/features.js +160 -0
- package/dist/src/extensions/gui/features.js.map +1 -0
- package/dist/src/extensions/gui/index.js +10 -4
- package/dist/src/extensions/gui/index.js.map +1 -1
- package/dist/src/extensions/link-feature.d.ts +70 -0
- package/dist/src/extensions/link-feature.js +18 -0
- package/dist/src/extensions/link-feature.js.map +1 -0
- package/dist/src/extensions/registry.d.ts +24 -4
- package/dist/src/extensions/registry.js +26 -3
- package/dist/src/extensions/registry.js.map +1 -1
- package/dist/src/index.d.ts +3 -2
- package/dist/src/index.js +0 -1
- package/dist/src/index.js.map +1 -1
- package/dist/tests/cli/hints.test.js +5 -7
- package/dist/tests/cli/hints.test.js.map +1 -1
- package/dist/tests/driver/link-features.test.js +105 -0
- package/dist/tests/driver/link-features.test.js.map +1 -0
- package/dist/tests/driver/usage.test.d.ts +1 -0
- package/dist/tests/driver/usage.test.js +88 -0
- package/dist/tests/driver/usage.test.js.map +1 -0
- package/dist/tests/e2e/gui-audio.test.js +4 -4
- package/dist/tests/e2e/gui-audio.test.js.map +1 -1
- package/dist/tests/e2e/gui-feature-linking.test.d.ts +9 -0
- package/dist/tests/e2e/gui-feature-linking.test.js +68 -0
- package/dist/tests/e2e/gui-feature-linking.test.js.map +1 -0
- package/dist/tests/e2e/gui-helpers.d.ts +5 -1
- package/dist/tests/e2e/gui-helpers.js +2 -0
- package/dist/tests/e2e/gui-helpers.js.map +1 -1
- package/dist/tests/e2e/gui-layout.test.js +4 -1
- package/dist/tests/e2e/gui-layout.test.js.map +1 -1
- package/dist/tests/e2e/gui-media-disabled.test.d.ts +5 -4
- package/dist/tests/e2e/gui-media-disabled.test.js +7 -6
- package/dist/tests/e2e/gui-media-disabled.test.js.map +1 -1
- package/dist/tests/e2e/gui-media.test.d.ts +5 -4
- package/dist/tests/e2e/gui-media.test.js +9 -9
- package/dist/tests/e2e/gui-media.test.js.map +1 -1
- package/dist/tests/e2e/gui-paint.test.js +5 -2
- package/dist/tests/e2e/gui-paint.test.js.map +1 -1
- package/dist/tests/e2e/gui-shaping.test.d.ts +5 -0
- package/dist/tests/e2e/gui-shaping.test.js +47 -0
- package/dist/tests/e2e/gui-shaping.test.js.map +1 -0
- package/dist/tests/e2e/gui-webgl-pipeline-cache.test.d.ts +18 -0
- package/dist/tests/e2e/gui-webgl-pipeline-cache.test.js +120 -0
- package/dist/tests/e2e/gui-webgl-pipeline-cache.test.js.map +1 -0
- package/dist/tests/extensions/gui-features.test.d.ts +1 -0
- package/dist/tests/extensions/gui-features.test.js +168 -0
- package/dist/tests/extensions/gui-features.test.js.map +1 -0
- package/doc/ai/cli.md +5 -1
- package/doc/ai/extensions.md +48 -23
- package/doc/ai/troubleshooting.md +10 -7
- package/doc/ai/zh-CN/cli.md +5 -1
- package/doc/ai/zh-CN/extensions.md +41 -20
- package/doc/ai/zh-CN/troubleshooting.md +6 -5
- package/doc/gui/api.md +2 -1
- package/doc/gui/build.md +136 -19
- package/doc/gui/canvas.md +1 -1
- package/doc/gui/known-issues.md +32 -3
- package/doc/gui/layout.md +1 -1
- package/doc/gui/media.md +13 -7
- package/doc/gui/rendering.md +32 -15
- package/doc/gui/runtime.md +5 -0
- package/doc/gui/webgl.md +24 -6
- package/doc/gui.md +50 -35
- package/doc/implemented/cli.md +2 -0
- package/doc/implemented/extensions.md +9 -3
- package/doc/npm-package.md +4 -4
- package/doc/xbintsc.config.schema.json +10 -0
- package/doc/zh-CN/gui/api.md +2 -1
- package/doc/zh-CN/gui/build.md +110 -16
- package/doc/zh-CN/gui/canvas.md +1 -1
- package/doc/zh-CN/gui/known-issues.md +24 -3
- package/doc/zh-CN/gui/layout.md +1 -1
- package/doc/zh-CN/gui/media.md +11 -6
- package/doc/zh-CN/gui/rendering.md +26 -9
- package/doc/zh-CN/gui/runtime.md +3 -0
- package/doc/zh-CN/gui/webgl.md +3 -3
- package/doc/zh-CN/gui.md +42 -29
- package/doc/zh-CN/implemented/cli.md +2 -0
- package/doc/zh-CN/implemented/extensions.md +9 -3
- package/doc/zh-CN/npm-package.md +4 -3
- package/package.json +7 -7
- package/runtime/ext_gui/browser.cpp +22 -15
- package/runtime/ext_gui/browser_loop.cpp +13 -1
- package/runtime/ext_gui/canvas.h +1 -1
- package/runtime/ext_gui/canvas_raster.cpp +1 -1
- package/runtime/ext_gui/canvas_text.cpp +1 -1
- package/runtime/ext_gui/dom_api_canvas.cpp +15 -8
- package/runtime/ext_gui/dom_api_canvas_extra.cpp +44 -20
- package/runtime/ext_gui/dom_api_canvas_image.cpp +3 -1
- package/runtime/ext_gui/dom_api_node_read.cpp +10 -0
- package/runtime/ext_gui/dom_api_offscreen.cpp +3 -1
- package/runtime/ext_gui/dom_api_style.cpp +7 -0
- package/runtime/ext_gui/dom_api_webgl_internal.h +4 -0
- package/runtime/ext_gui/dom_api_webgl_source.cpp +5 -2
- package/runtime/ext_gui/gpu_bridge.c +28 -0
- package/runtime/ext_gui/gpu_feature.cpp +30 -0
- package/runtime/ext_gui/gpu_shader.cpp +22 -0
- package/runtime/ext_gui/gpu_shader_api.h +50 -0
- package/runtime/ext_gui/gui.cpp +6 -37
- package/runtime/ext_gui/gui_canvas.cpp +14 -6
- package/runtime/ext_gui/gui_engine.h +1 -18
- package/runtime/ext_gui/gui_events.cpp +3 -2
- package/runtime/ext_gui/gui_webgl.cpp +25 -10
- package/runtime/ext_gui/image_api.cpp +18 -0
- package/runtime/ext_gui/image_api.h +41 -0
- package/runtime/ext_gui/image_bitmap_browser.cpp +20 -11
- package/runtime/ext_gui/image_bridge.c +22 -0
- package/runtime/ext_gui/image_feature.cpp +105 -0
- package/runtime/ext_gui/layout.cpp +13 -8
- package/runtime/ext_gui/layout.h +2 -2
- package/runtime/ext_gui/media.cpp +4 -2
- package/runtime/ext_gui/media.h +3 -3
- package/runtime/ext_gui/media_api.h +7 -6
- package/runtime/ext_gui/renderer.h +1 -1
- package/runtime/ext_gui/renderer_image.cpp +13 -6
- package/runtime/ext_gui/renderer_layer.cpp +10 -5
- package/runtime/ext_gui/stb_truetype.h +5077 -0
- package/runtime/ext_gui/text.cpp +24 -498
- package/runtime/ext_gui/text.h +7 -5
- package/runtime/ext_gui/text_api.h +45 -0
- package/runtime/ext_gui/text_bridge.c +23 -0
- package/runtime/ext_gui/text_cache.cpp +1 -1
- package/runtime/ext_gui/text_glyph_cache.cpp +2 -2
- package/runtime/ext_gui/text_hb.cpp +554 -0
- package/runtime/ext_gui/text_stb.cpp +513 -0
- package/runtime/ext_gui/webgl_api.cpp +19 -0
- package/runtime/ext_gui/webgl_api.h +53 -0
- package/runtime/ext_gui/webgl_bridge.c +25 -0
- package/runtime/ext_gui/webgl_draw_setup.cpp +42 -1
- package/runtime/ext_gui/webgl_feature.cpp +82 -0
- package/runtime/ext_gui/webgl_feature.h +28 -0
- package/runtime/ext_gui/webgl_msl.cpp +41 -0
- package/runtime/ext_gui/webgl_msl.h +6 -0
- package/runtime/ext_gui/webgl_shader.cpp +40 -32
- package/runtime/ext_gui/window.cpp +7 -7
- package/runtime/ext_media/decode_audio.cpp +1 -1
- package/runtime/ext_media/media.cpp +1 -1
- package/runtime/ext_media/media_bridge.c +7 -7
- package/scripts/build-gui.ts +97 -98
- package/scripts/check-file-length.ts +1 -0
- package/scripts/gui-build-options.ts +122 -0
- package/src/cli/extensions.ts +72 -0
- package/src/cli/help.ts +3 -1
- package/src/cli/hints.ts +9 -3
- package/src/cli/main.ts +21 -27
- package/src/diagnostics/diagnostic.ts +2 -0
- package/src/driver/build-key.ts +3 -0
- package/src/driver/compiler.ts +63 -8
- package/src/driver/config.ts +6 -0
- package/src/driver/link-features.ts +163 -0
- package/src/driver/options.ts +10 -0
- package/src/driver/runtime-objects.ts +26 -1
- package/src/driver/usage.ts +376 -0
- package/src/driver/version.ts +1 -1
- package/src/extensions/catalog.ts +1 -2
- package/src/extensions/gui/features.ts +162 -0
- package/src/extensions/gui/index.ts +10 -4
- package/src/extensions/link-feature.ts +72 -0
- package/src/extensions/registry.ts +45 -4
- package/src/index.ts +3 -2
- package/dist/src/extensions/media/index.d.ts +0 -28
- package/dist/src/extensions/media/index.js +0 -59
- package/dist/src/extensions/media/index.js.map +0 -1
- package/dist/tests/extensions/media.test.js +0 -63
- package/dist/tests/extensions/media.test.js.map +0 -1
- package/src/extensions/media/index.ts +0 -65
- /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: ["中文"] }))).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
|
|
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
|
|
package/doc/ai/extensions.md
CHANGED
|
@@ -1,8 +1,10 @@
|
|
|
1
|
-
# Extensions: Node modules, GUI,
|
|
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>`
|
|
78
|
-
|
|
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
|
|
113
|
-
`
|
|
114
|
-
|
|
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`
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
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.
|
|
133
|
-
the
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
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>`
|
|
127
|
-
`media.lib` on Windows). The `@xbintsc/<os>-<arch>` npm
|
|
128
|
-
the release builds it; otherwise build it
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
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
|
|
package/doc/ai/zh-CN/cli.md
CHANGED
|
@@ -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
|
|
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
|
|
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>`
|
|
74
|
-
|
|
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
|
-
`
|
|
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
|
-
###
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
`
|
|
111
|
-
|
|
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
|
-
|
|
120
|
-
|
|
121
|
-
|
|
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>`
|
|
116
|
+
`<video>`/`<audio>` 解码需要可选的 `media` 链接特性及其归档(`media.a`,Windows 上是
|
|
117
117
|
`media.lib`)。发布为其构建时,`@xbintsc/<os>-<arch>` npm 包会提供它;否则用
|
|
118
|
-
`npm run media`
|
|
119
|
-
|
|
120
|
-
|
|
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`
|
|
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
|