xbintsc 0.5.45 → 0.5.51

package/doc/gui.md

@@ -21,13 +21,15 @@ what `examples/gui/pelican-bike` — a playable 2D game — is built on. **M12**
 DOM node lifetime explicit (what a mutation releases, what it keeps) and gives the
 engine bounded memory: see [Node lifetime](./gui/dom.md#node-lifetime) and
 [Memory & GC](./gui/runtime.md#memory--gc). **M13** plays real
-`<video>`/`<audio>` — the optional `media` extension decodes them on the main
-thread with a vendored minimal FFmpeg, video frames go through the image texture
-path and audio to an SDL stream, with the DOM media API exposing
-`play`/`pause`/`currentTime`/… and media events. Enabling `gui` alone does not
+`<video>`/`<audio>` — the optional **`media` link feature** decodes them on the
+main thread with a vendored minimal FFmpeg, video frames go through the image
+texture path and audio to an SDL stream, with the DOM media API exposing
+`play`/`pause`/`currentTime`/… and media events. The compiler selects the
+feature from the program (a `<video>`/`<audio>` element, `new Audio()`,
+`decodeAudioData`, or markup built at run time), so a DOM/CSS program does not
 link FFmpeg. The browser globals also get a real `AudioContext`: a 48 kHz mixer
 in `runtime/ext_gui/audio_mixer.cpp` plus `decodeAudioData` (WAV in-engine,
-compressed formats through `media`) — see
+compressed formats through the `media` feature) — see
 [GUI API](./gui/api.md#web-audio).
 **M14** adds `<canvas>` with a self-written 2D software rasteriser (anti-aliased
 fills, paths, text and `drawImage`) uploaded through the image texture path —
@@ -38,7 +40,7 @@ them) can be translated, scaled and rotated without reflowing anything — and
 `transition: transform`, so those poses animate. See
 [Layout](./gui/layout.md#transforms-m15) and
 [Animation](./gui/animation.md#css-transforms-m15).
-**M17** adds real **WebGL 1.0**, and **M18** adds **WebGL 2.0**: `<canvas>.getContext("webgl2")` accepts `#version 300 es` shaders, vertex-array objects, instanced draws and sampler objects, all compiled to SPIR-V by the bundled glslang (and to MSL by the bundled SPIRV-Cross on Metal) and rendered through SDL_GPU. Geometry, lighting, texture sampling and blending run on the GPU and the page composites the colour texture without a readback — see [WebGL](./gui/webgl.md).
+**M17** adds real **WebGL 1.0**, and **M18** adds **WebGL 2.0**: `<canvas>.getContext("webgl2")` accepts `#version 300 es` shaders, vertex-array objects, instanced draws and sampler objects, all compiled to SPIR-V by the bundled glslang (and to MSL by the bundled SPIRV-Cross on Metal) and rendered through SDL_GPU. Geometry, lighting, texture sampling and blending run on the GPU and the page composites the colour texture without a readback — see [WebGL](./gui/webgl.md). glslang is an optional **`gpu` link feature** shared with `mix-blend-mode`; the WebGL context/DOM bindings are the separate **`webgl` feature**, which requires `gpu`. A DOM/2D-canvas page links neither.
 **M19** fills in the decorative CSS layer: `@media` queries, generated content
 (`::before`/`::after`), multi-layer linear/radial/repeating backgrounds,
 `text-shadow`, `clip-path`, `mix-blend-mode` (through an offscreen compositor)
@@ -100,7 +102,8 @@ pages above.
 | 4 | The engine is **not self-hosted** (it is C/C++, not TS), but must not affect the compiler's platform-agnostic design. Delivered as a per-platform prebuilt archive linked via `nativeObjects`. |
 | 5 | The **event loop is generic**: the runtime exposes a generic main-loop hook and a poll primitive; nothing GUI-specific enters `runtime/`. |
 | 6 | **Multiple windows** are supported by the core object model. |
-| 7 | Third-party low-level libs are **statically linked into the extension archives** so releases stay self-contained; only OS frameworks are added at link time. `gui.a` carries SDL3/FreeType/HarfBuzz, and the optional `media.a` carries FFmpeg and is linked only with `--ext media`. |
+| 7 | Third-party low-level libs are **statically linked into the extension archives** so releases stay self-contained; only OS frameworks are added at link time. `gui.a` carries SDL3, FreeType/HarfBuzz for the optional `shaping` feature, glslang and (on macOS only) SPIRV-Cross; the default text path uses the bundled stb_truetype. glslang and SPIRV-Cross are only *extracted* when the compiler selects the **`gpu` link feature**; Metal is the only SDL_GPU backend that consumes MSL, so merging SPIRV-Cross elsewhere would add ~2.5 MiB no driver can ask for. The WebGL context/DOM code is the **`webgl` feature** (requires `gpu`), and stb_image/NanoSVG are the **`images` feature**. The optional `media.a` carries FFmpeg and is linked only when the **`media` link feature** is selected. All features are chosen from the program's static usage; `--feature`/`--no-feature` override the scan. |
+| 8 | **Heavy optional halves are link features, not extensions.** FFmpeg and glslang are selected by what the bundled HTML/CSS/TS may use, and a small C bridge (linked only when active) installs the feature's dispatch table and forces the linker to extract the implementation. This keeps one user-facing `gui` extension while a DOM-only program pays for neither stack. |
 
 ## Architecture
 
@@ -120,7 +123,7 @@ pages above.
                 │
                 ▼
         windowing + input (SDL3) ── multiple windows
-        text (HarfBuzz + FreeType) ── glyph atlas / SDF
+        text (stb_truetype) ── glyph atlas
         images (stb_image; SVG via NanoSVG)
         media DOM + audio sink ── optional media.a (FFmpeg) installs the decoder
 ```
@@ -134,14 +137,19 @@ with `nativeObjects()`, `linkerFlags()` and `modules()`.
 | --- | --- | --- |
 | Window + input + multi-window | **SDL3** | cross-platform windows, HiDPI, IME, clipboard, DnD, close/hide events |
 | GPU | **SDL_GPU** (SDL3) | one render path over Metal / Vulkan / D3D12; avoids three backends |
-| Text shaping | **HarfBuzz** | correct complex-script shaping |
-| Glyph raster | **FreeType** | glyph outlines → GPU atlas / SDF |
+| Text shaping | **stb_truetype** simple shaper; optional **`shaping`** feature links HarfBuzz + FreeType | default keeps the DOM-only binary near 3 MiB; `shaping` restores ligatures and complex-script shaping |
+| Glyph raster | **stb_truetype**; FreeType only under `shaping` | TrueType outlines → grayscale atlas by default |
 | Images | **stb_image** (vendored header) for bitmaps, **NanoSVG** (vendored headers) for SVG | single headers to start; SVG files rasterise on demand |
-| Video + audio | **FFmpeg** (statically vendored, minimal build, optional `media` extension) | decodes the common container/codec set; no WebView or platform media framework |
+| Video + audio | **FFmpeg** (statically vendored, minimal build, optional `media` link feature) | decodes the common container/codec set; no WebView or platform media framework |
 
-Pinned versions: SDL3 `release-3.2.10`, FreeType `2.13.3`, HarfBuzz `10.1.0`,
-FFmpeg `7.1` for the optional `media` archive (overridable with `SDL3_TAG` /
-`FREETYPE_VERSION` / `HARFBUZZ_VERSION` / `FFMPEG_VERSION`).
+Pinned versions: SDL3 `release-3.2.10`, FreeType `2.13.3`, HarfBuzz `10.1.0`
+(for the optional `shaping` feature), glslang `16.6.0`, SPIRV-Cross
+`vulkan-sdk-1.4.313.0`, FFmpeg `7.1` for the optional `media` archive
+(overridable with `SDL3_TAG` / `FREETYPE_VERSION` / `HARFBUZZ_VERSION` /
+`GLSLANG_VERSION` / `SPIRV_CROSS_VERSION` / `FFMPEG_VERSION`). The default text
+backend is the bundled `stb_truetype.h`; it accepts TrueType outlines (not
+CFF/OTF or variable fonts). The `shaping` feature swaps in HarfBuzz + FreeType
+for full OpenType shaping.
 
 Alternative if SDL3 is rejected: **GLFW + OpenGL 3.3** (simpler, but OpenGL is
 deprecated on macOS and gives no modern GPU abstraction). **wgpu-native** if the
@@ -169,10 +177,11 @@ engine were Rust.
 4. **M4 — paint + text + display list**
    - **M4a — display list + GPU shapes** ✅ background/border display list,
      rounded-rect SDL_GPU pipeline (`paint.*`, `renderer.*`).
-   - **M4b-1 — text stack + metrics** ✅ HarfBuzz + FreeType linked into
-     `gui.a`, font resolution/caching, shaping-based text metrics used by
-     layout (`text.*`, `measureText`/`fontMetrics`).
-   - **M4b-2 — glyph rendering** ✅ FreeType rasterisation, a shared shelf-packed
+   - **M4b-1 — text stack + metrics** ✅ the text module (`text.*`) with font
+     resolution/caching and shaping-based metrics used by layout
+     (`measureText`/`fontMetrics`); originally HarfBuzz + FreeType, now the
+     bundled stb_truetype.
+   - **M4b-2 — glyph rendering** ✅ stb_truetype rasterisation, a shared shelf-packed
      glyph atlas, textured text quads in the display list and HiDPI-aware raster
      scaling. Gradients remain.
 5. **M5 — input + events** ✅
@@ -199,16 +208,17 @@ engine were Rust.
      (`package-release` copies all of `runtime/`) and inside the optional
      `@xbintsc/<os>-<arch>` npm package. Windows x64 is included; Windows arm64
      still skips them.
-   - `vendor/` (SDL3/FreeType/HarfBuzz for the GUI archive, FFmpeg for `media`)
+   - `vendor/` (SDL3/FreeType/HarfBuzz/glslang for the GUI archive, FFmpeg for `media`)
      is cached per OS/arch, keyed by `scripts/build-gui.ts` /
      `scripts/build-media.ts`. Windows x64 gets its own source cache plus the
      installed `vendor/ffmpeg-build-msvc/dist` prefix.
-   - Windows x64 builds both archives in CI and links a `gui,media` program,
-     using the same Visual Studio `vcvarsall` + bundled LLVM toolchain as a
-     local build (`.github/actions/vs-toolchain`); the host has no GPU/Vulkan
-     driver, so *running* the GUI/media examples there remains provisional (a
-     failure is logged without annotating the run). The Windows arm64 job still
-     skips both archives (see
+   - Windows x64 builds both archives in CI and links a `gui` program that
+     exercises the `media` link feature (plus an explicit `--feature media`
+     build), using the same Visual Studio `vcvarsall` + bundled LLVM toolchain
+     as a local build (`.github/actions/vs-toolchain`); the host has no
+     GPU/Vulkan driver, so *running* the GUI/media examples there remains
+     provisional (a failure is logged without annotating the run). The Windows
+     arm64 job still skips both archives (see
      [Open questions](./gui/known-issues.md#open-questions)).
 8. **M8 — interactive DOM** ✅
    - Element/document handles with stable identity, read/write properties via
@@ -260,15 +270,17 @@ engine were Rust.
       `tests/e2e/gui-retention.test.ts` (see [Memory & GC](./gui/runtime.md#memory--gc)).
 13. **M13 — video & audio** ✅
     - `<video>` / `<audio>` decode through a statically vendored minimal FFmpeg
-      in the optional `media` extension (`runtime/ext_media/media.cpp`), frames
+      in the optional `media` link feature (`runtime/ext_media/media.cpp`); the
+      compiler selects it from the program and only then compiles the bridge and
+      links `media.a`. Frames
       upload to GPU textures through the existing image pipeline, audio is
       pushed to an SDL stream on the main thread by the GUI's audio sink, and
       the DOM media API plus `loadedmetadata`/`play`/`pause`/`ended`/
       `timeupdate`/`error` events are exposed on element handles
       (`dom_api_media.cpp`, `dom_api_proto.cpp`). Controlled from TS + CSS;
       there are no built-in controls. Example in `examples/gui/media.*`, e2e in
-      `tests/e2e/gui-media.test.ts` (with the `media` extension) and
-      `tests/e2e/gui-media-disabled.test.ts` (without it).
+      `tests/e2e/gui-media.test.ts` (auto-selected) and
+      `tests/e2e/gui-media-disabled.test.ts` (`--no-feature media`).
 14. **M14 — `<canvas>` 2D** ✅
     - `<canvas>` is a replaced element (`xtgui::Canvas2D`, `layout.*`), the
       `getContext("2d")` handle and drawing API live in `dom_api_canvas.cpp`,
@@ -373,9 +385,10 @@ engine were Rust.
   coverage.
 - **M4a** ✅ display list (`paint.*`) and the SDL_GPU 2D renderer with an MSL
   rounded-rect pipeline (`renderer.*`), `paintList`/`paintCount`, e2e coverage.
-- **M4b-1** ✅ FreeType + HarfBuzz fetched/built/merged into `gui.a`, the text
-  module (`text.*`) with font resolution, HarfBuzz shaping and FreeType metrics,
-  real text metrics in layout, `measureText`/`fontMetrics`, e2e coverage.
+- **M4b-1** ✅ the text module (`text.*`) with font resolution, shaping and
+  metrics, real text metrics in layout, `measureText`/`fontMetrics`, e2e
+  coverage. Originally HarfBuzz + FreeType; now stb_truetype (see the stack
+  table and the size trade-off in [build](./gui/build.md#binary-size)).
 - **M4b-2** ✅ glyph atlas + textured text pipeline in `renderer.*`, shaped text
   runs in `paint.*`, `xt_text_shape_run`/`xt_text_rasterize` in `text.*`, HiDPI
   raster scaling, e2e coverage.
@@ -430,17 +443,19 @@ engine were Rust.
   ratcheting upwards. `win.stats()` exposes the engine counters and
   `tests/e2e/gui-retention.test.ts` pins them; a game loop rewriting its sprite
   every frame now runs in constant memory (see [Memory & GC](./gui/runtime.md#memory--gc)).
-- **M13** ✅ `<video>` / `<audio>` support. The optional `media` extension
+- **M13** ✅ `<video>` / `<audio>` support. The optional `media` **link feature**
   vendors and builds a minimal static FFmpeg (`scripts/build-media.ts`) and
   merges it into `media.a` (or `media.lib` from clang-cl/MSVC objects on
-  Windows); `runtime/ext_media/media.cpp` decodes video to RGBA
+  Windows). The compiler selects the feature from the program and only then
+  compiles `media_bridge.c` and links `media.a`; a DOM/CSS program never links
+  FFmpeg. `runtime/ext_media/media.cpp` decodes video to RGBA
   frames and audio to 48 kHz stereo PCM on the main thread,
   `runtime/ext_gui/gui_media.cpp` owns the players, implements the SDL audio
   sink and pumps the media clock and events each frame,
   `renderer_image.cpp` uploads each new video frame through the image texture
   path, and `dom_api_media.cpp` exposes `play`/`pause`/`load` plus the media
-  properties on element handles. `gui.a` stays FFmpeg-free; enabling `media`
-  without `gui` is rejected by the registry. `examples/gui/media.*` demonstrates
+  properties on element handles. `gui.a` stays FFmpeg-free.
+  `examples/gui/media.*` demonstrates
   the TS-plus-CSS-controls pattern and `tests/e2e/gui-media.test.ts` pins it.
 - **M14** ✅ `<canvas>` support. A new replaced element (`layout.*`) carries an
   intrinsic size from its `width`/`height` attributes (default `300x150`),

package/doc/implemented/cli.md

@@ -29,6 +29,8 @@ default; `--no-check` skips it (and is part of the cache key). See
     --emit <kind>     exe | obj | ir (default: exe)
 -O0..-O3              Optimization level (default: -O2)
     --ext <names>     Comma separated extensions (e.g. node)
+    --feature <names> Force optional link features on (media,gpu,images,shaping,webgl,all)
+    --no-feature <n>  Keep optional link features out even when detected
     --ext-native <m>  Register a C++/Rust extension from a JSON manifest
     --config <path>   Use a project config (default: xbintsc.config.json)
     --no-config       Do not read any project config

package/doc/implemented/extensions.md

@@ -2,10 +2,16 @@
 
 > Part of [Implemented syntax and features](../implemented.md) · [简体中文](../zh-CN/implemented/extensions.md)
 
-Location: `src/extensions/registry.ts`, `src/extensions/node/`
+Location: `src/extensions/registry.ts`, `src/extensions/node/`, `src/extensions/link-feature.ts`, `src/driver/usage.ts`, `src/driver/link-features.ts`
 
-- An extension is a plain object: `runtimeSources()` (extra C sources), `linkerFlags()` (extra link flags), `builtins()` (global identifier → runtime symbol, uniform `(argc, argv)` ABI) and `modules()` (import specifier → named exports / namespace).
-- `ExtensionRegistry`: register / unregister / lookup / aggregate builtins, modules, runtime sources and link flags.
+- An extension is a plain object: `runtimeSources()` (extra C sources), `linkerFlags()` (extra link flags), `builtins()` (global identifier → runtime symbol, uniform `(argc, argv)` ABI), `modules()` (import specifier → named exports / namespace) and `linkFeatures()` (optional heavy capabilities).
+- `ExtensionRegistry`: register / unregister / lookup / aggregate builtins, modules, runtime sources, link flags and link features.
+- **Optional link features** (`media`, `gpu`, `images`, `shaping`, `webgl`):
+  - A feature declares `runtimeSources()` (a C bridge compiled only when active), `nativeObjects()` (archives linked only when active), `linkerFlags()`, optional `requires` (another feature it depends on) and `used(usage)`.
+  - The driver builds `ProgramUsage` from the bundled AST (`collectUsage` in `src/driver/usage.ts`): string literals (including imported HTML and inlined CSS), identifiers/property names, `getContext(...)` kinds, and whether markup can be built at run time. Simple `const` aliases are resolved; unresolved markup makes the program conservative.
+  - `resolveLinkFeatures` applies `--feature` / `--no-feature` (and `all`), expands `requires`, reports an unavailable auto-detected feature as a warning and a forced one as an error, and returns the bridges/archives/flags to link.
+  - The bridge is the strong reference: its constructor installs the feature's dispatch table and its references force the linker to extract the implementation. With no bridge, the table stays null and the implementation members are never linked.
+  - Current clients: `media` (FFmpeg, `runtime/ext_media/media_bridge.c` + `media.a`), `gpu` (glslang/SPIRV-Cross, `runtime/ext_gui/gpu_bridge.c` + `gpu_feature.cpp` inside `gui.a`), `images` (stb_image/NanoSVG, `runtime/ext_gui/image_bridge.c` + `image_feature.cpp`), `shaping` (HarfBuzz/FreeType, `runtime/ext_gui/text_bridge.c` + `text_hb.cpp`), and `webgl` (context/DOM bindings, `runtime/ext_gui/webgl_bridge.c` + `webgl_feature.cpp`, requiring `gpu`).
 - The built-in core extension `core`: exposes `print` (mapped to `xt_println`), always registered.
 - The Node extension `node`:
   - Modular organisation: `src/extensions/node/fs/` + `runtime/ext_node/fs/read_file.c`

package/doc/npm-package.md

@@ -69,8 +69,8 @@ The package does **not** contain:
 If npm skips the optional package (`--omit=optional`, a package manager that
 does not install optional dependencies, or a host the release does not build
 for), the driver falls back to compiling the C runtime from the shipped sources
-and caches the objects; that build works but is slower, and `--ext gui` /
-`--ext media` need the archive to be present.
+and caches the objects; that build works but is slower, and `--ext gui` (plus
+the auto-selected `media`/`gpu`/`images`/`shaping`/`webgl` link features) needs the archive to be present.
 
 ## Requirements
 
@@ -398,7 +398,7 @@ jobs:
 | --- | --- | --- |
 | Needs Node.js | Yes, 22+ | No |
 | First build | Links the prebuilt runtime from the optional platform package | Links the prebuilt runtime |
-| GUI / media extensions | Included on Linux/macOS and Windows x64 (the hosts the release builds them for) | Included in Linux/macOS and Windows x64 archives |
+| GUI engine + media archive | Included on Linux/macOS and Windows x64 (the hosts the release builds them for) | Included in Linux/macOS and Windows x64 archives |
 | Installation | `npm install` + lockfile / provenance | Download, verify `.sha256`, unpack |
 | Programmatic API | Yes | No (CLI only) |
 | Cross-compiles | No — host only | No — host only |
@@ -439,7 +439,7 @@ the same file under `node_modules/xbintsc/doc/ai/`.
 | The first build takes a long time | The optional `@xbintsc/<os>-<arch>` package was skipped (or this host has no prebuilt package), so the runtime C sources are compiled and cached. Check `npm ls @xbintsc/<os>-<arch>` and reinstall without `--omit=optional`; `--time` confirms. |
 | Permission errors writing `.xbintsc/` | Set `xbintsc_CACHE_DIR` to a writable directory, or run from a writable working directory. |
 | `module 'fs' is provided by the 'node' extension` | Add `--ext node`, or `"extensions": ["node"]` in the config. |
-| `GUI native library not found` / `media native library not found` | The optional platform package that ships `gui.a`/`gui.lib` or `media.a`/`media.lib` was skipped, or this host has no prebuilt GUI/media archive (Windows arm64). Reinstall without `--omit=optional`, use a Linux/macOS/Windows x64 release archive, or build the archive from a source checkout. |
+| `GUI native library not found` / `media native library not found` | The optional platform package that ships `gui.a`/`gui.lib` or `media.a`/`media.lib` was skipped, or this host has no prebuilt GUI/media archive (Windows arm64). Reinstall without `--omit=optional`, use a Linux/macOS/Windows x64 release archive, or build the archive from a source checkout. An auto-detected `media` feature with a missing archive only warns; `--feature media` makes it an error. |
 | `require("xbintsc")` fails | The package is ESM-only; use `import` (or dynamic `import()`). |
 | Windows link errors about missing MSVC libraries | Run from a Native Tools prompt, install the VS C++ build tools, and check `npx xbintsc doctor`. |
 | `npm ci --omit=dev` then the build cannot find `xbintsc` | Install devDependencies for the build stage, or move `xbintsc` to `dependencies`. |

package/doc/xbintsc.config.schema.json

@@ -48,6 +48,16 @@
       "items": { "type": "string" },
       "description": "Paths to native C++/Rust extension manifests."
     },
+    "features": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Optional link features to force on, e.g. [\"media\", \"gpu\", \"images\", \"shaping\", \"webgl\"] or [\"all\"]."
+    },
+    "noFeatures": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Optional link features to keep out even when auto-detection finds a use."
+    },
     "force": {
       "type": "boolean",
       "description": "Ignore the incremental cache."

package/doc/zh-CN/gui/api.md

@@ -128,7 +128,8 @@ requestAnimationFrame(frame);
 `getChannelData(i)` 是真正的 `Float32Array`，可以用代码逐样本填充。
 `decodeAudioData(bytes)` 返回解码后的 AudioBuffer Promise：WAV（PCM 8/16/24/32 位、
 IEEE float 32/64、A-law 与 µ-law）由引擎自身解码；MP3、AAC/M4A、Vorbis、Opus 与 FLAC
-需要可选的 `media` 扩展（`--ext gui,media`），以其中的 FFmpeg 解码器作为回退。
+需要可选的 `media` 链接特性（程序调用 `decodeAudioData` 时自动选中），以其中的
+FFmpeg 解码器作为回退。
 `bytes` 可以是 ArrayBuffer、类型化数组、Node `Buffer`，或 `fs.readFileSync`
 返回的原始字节字符串（本运行时没有专门的二进制类型，而该字符串的存储正是文件字节）。
 解码结果会重采样到上下文的 48 kHz，因此 `buffer.sampleRate` 与

package/doc/zh-CN/gui/build.md

@@ -7,13 +7,29 @@
 - 源码位于 `runtime/ext_gui/`（C/C++），外加 `vendor/` 下的 vendored 库
   （被 gitignore；按需获取）。媒体解码位于 `runtime/ext_media/`，单独构建。
 - `npm run gui`（`scripts/build-gui.ts`）获取固定版本的 SDL3（`SDL3_TAG`，
-  默认 `release-3.2.10`），构建静态 SDL3，获取并构建静态 FreeType
-  （`FREETYPE_VERSION`）与 HarfBuzz（`HARFBUZZ_VERSION`），并获取、构建静态
+  默认 `release-3.2.10`），构建静态 SDL3，获取并构建静态 **FreeType**
+  （`FREETYPE_VERSION`，默认 `2.13.3`）与 **HarfBuzz**（`HARFBUZZ_VERSION`，
+  默认 `10.1.0`）供可选的 `shaping` 特性使用，并获取、构建静态
   **glslang**（`GLSLANG_VERSION`，默认 `16.6.0`）、固定版本的 SPIR-V 头文件
-  （`SPIRV_HEADERS_VERSION`）以及 **SPIRV-Cross**（`SPIRV_CROSS_VERSION`，默认
-  `vulkan-sdk-1.4.313.0`）。glslang 是 WebGL 背后的运行时 GLSL ES 编译器，
-  SPIRV-Cross 把它的 SPIR-V 转成 Metal 后端使用的 MSL（见
-  [WebGL](./webgl.md)），两者都与其他库一样合并进归档。随后编译引擎，并把
+  （`SPIRV_HEADERS_VERSION`）以及——**仅 macOS**——**SPIRV-Cross**
+  （`SPIRV_CROSS_VERSION`，默认 `vulkan-sdk-1.4.313.0`）。glslang 是 WebGL
+  背后的运行时 GLSL ES 编译器，SPIRV-Cross 把它的 SPIR-V 转成 Metal 后端使用的
+  MSL（见 [WebGL](./webgl.md)），两者都与其他库一样合并进归档。Metal 是唯一消费
+  MSL 的 SDL_GPU 后端，因此 Windows/Linux 上脚本既不获取也不合并 SPIRV-Cross：
+  那里的 `webgl_msl.cpp` 编译为空，合并进来只会多出约 2.5 MiB 不可达代码。
+  默认文本路径使用内置的 **stb_truetype**（`runtime/ext_gui/stb_truetype.h`）；
+  HarfBuzz/FreeType 只在 `shaping` 特性启用时被取出。
+  每个库（SDL3、FreeType、HarfBuzz、glslang、SPIRV-Cross 与引擎）都用
+  `-ffunction-sections -fdata-sections` 编译；SDL 关闭引擎从不调用的子系统
+  （`SDL_JOYSTICK`、`SDL_HAPTIC`、`SDL_SENSOR`、`SDL_CAMERA`、`SDL_RENDER`、
+  `SDL_OPENGL`/`SDL_OPENGLES`、`SDL_OFFSCREEN`、`SDL_HIDAPI`）；HarfBuzz 关闭
+  整形后端从不使用的 API（`HB_NO_DRAW`/`PAINT`/`COLOR`/`NAME`/`STYLE`/`METRICS`/…，
+  但保留 `CFF`/`OPEN`/`VAR` 以支持 OTF 与可变字体），并以
+  `HB_NO_PRAGMA_GCC_DIAGNOSTIC_ERROR` 编译：`src/hb.hh` 会把自身警告集提升为
+  错误，而两个精简宏（`HB_NO_MMAP` 与 `HB_NO_OT_FONT_GLYPH_NAMES`）会让
+  macOS/CoreText 的辅助函数变成未引用。链接器随后丢弃
+  不可达函数（`--gc-sections`、`-dead_strip` 或 link.exe 默认的 `/OPT:REF`）。
+  随后编译引擎，并把
   所有内容合并到 `runtime/lib/<os>-<arch>/gui.a`（Windows 上 MSVC ABI 则为
   `gui.lib`），与 `core.a` 采用相同约定，静态打包这些库。合并使用 macOS 上的
   `libtool` 与其他平台上的 `ar -M`（GNU/LLVM）；CMake 归档会在构建根目录或
@@ -23,12 +39,15 @@
   demuxer/parser/decoder 的最小静态构建，用它编译
   `runtime/ext_media/media.cpp`，并把所有内容合并到
   `runtime/lib/<os>-<arch>/media.a`（Windows 上 MSVC ABI 则为 `media.lib`）。
-  `gui.a` **不会**链接 FFmpeg：程序通过 `--ext media` 显式启用播放能力。
+  `gui.a` **不会**链接 FFmpeg：编译器为可能播放媒体的程序选中 `media` 链接特性后
+  才链接 `media.a`（见[链接特性](#链接特性)）。
 - `src/extensions/gui/index.ts` 通过 `nativeObjects()` 暴露引擎归档（经由
   `findRuntimeLibrary`，因此 `.a`/`.lib` 都可用），并通过 `linkerFlags()`
-  暴露操作系统框架。`src/extensions/media/index.ts` 对 `media.a`/`media.lib`
-  做同样的暴露，并把注册桥（`runtime/ext_media/media_bridge.c`）作为普通
-  runtime 源编译。
+  暴露操作系统框架。它的 `linkFeatures()`（位于
+  `src/extensions/gui/features.ts`）声明 `media`、`gpu`、`images`、`shaping` 与 `webgl`；driver 只在该特性
+  启用时编译对应的 bridge。
+- glslang（以及 macOS 上的 SPIRV-Cross）与 SDL3 一样合并进 `gui.a`，但引擎只
+  通过 `gpu` 特性的分发表访问它；从不编译 GLSL 的程序不会取出这些归档成员。
 - `scripts/build-gui.ts` 使用与驱动**相同**的 clang
   （`src/driver/toolchain-provider.ts`）；Windows 上就是 Visual Studio 自带的、
   面向 MSVC 的 LLVM，并配套使用其同目录下的 `clang++`/`llvm-ar` 来配置 CMake、
@@ -53,9 +72,10 @@
 - CI 在组装发布归档之前构建 `gui.a`/`gui.lib` 与 `media.a`/`media.lib`，因此它们
   会随 `runtime/lib/<slug>/` 一起发布（发布 tarball 会复制整个 `runtime/` 树）。
   同一批目录还会打进可选的 `@xbintsc/<slug>` npm 包，因此发布覆盖的宿主平台从
-  npm 安装后也能使用 `--ext gui`/`--ext media`。归档在 Linux（Xvfb 下，使用
+  npm 安装后也能使用 `--ext gui`（`media`/`gpu`/`images`/`shaping`/`webgl` 自动选择）。归档在 Linux（Xvfb 下，使用
   lavapipe 软件 Vulkan 驱动）与 macOS 上构建并运行
-  示例；Windows x64 也会构建两个归档并链接一个 `gui,media` 程序，因此 MSVC
+  示例；Windows x64 也会构建两个归档并链接一个会触发 `media` 特性的 `gui` 程序
+  （另有一条显式 `--feature media` 的构建），因此 MSVC
   构建在 CI 中得到验证，只是*运行*示例仍为试验性（托管 runner 没有 GPU/Vulkan
   驱动）。macOS 的运行同样是试验性的：Intel runner 的虚拟 GPU 缺少
   `MTLGPUFamilyMac2`，引擎会以 **77**（“此机器无法运行 GUI”）退出，任务记录为跳过，
@@ -69,8 +89,9 @@
   configure/make 构建树本身不缓存（其中记录了另一台机器的绝对路径与编译选项）。
 - 现有的缓存指纹已经会对 `nativeObjects()` 的内容与 `runtimeSources()` 的内容
   做哈希，因此重建任一归档都会自动使缓存二进制失效。
-- CMake 构建树位于其源码**旁边**（`vendor/sdl-build`、`vendor/freetype-build`、
-  `vendor/harfbuzz-build`），绝不放在源码内部：`CMakeCache.txt` 记录的是配置它
+- CMake 构建树位于其源码**旁边**（`vendor/sdl-build-lean`、
+  `vendor/freetype-build-lean`、`vendor/harfbuzz-build-lean`、
+  `vendor/glslang-build-lean`、`vendor/spirv-cross-build-lean`），绝不放在源码内部：`CMakeCache.txt` 记录的是配置它
   的那台机器，而 SDL 的视频后端是 `option()`，因此先运行的那次配置会一直生效。
   所以一个同时携带 `build/` 的 `vendor/SDL` 缓存树，会把某台机器的
   `SDL_X11`/`SDL_WAYLAND` 选择带进另一台机器的配置——即使头文件已安装，SDL 也会
@@ -79,6 +100,78 @@
   检查 X11/Wayland 头文件，并按名称报告缺失的开发包（当头文件位于该检查未知的
   前缀下时，可设置 `xbintsc_SKIP_HEADER_CHECK=1`）。
 
+## 链接特性
+
+用户只启用一个 `gui` 扩展，但其中的重型部分是可选的**链接特性**，按程序选择：
+
+| 特性 | 链接什么 | 程序可能用到时 |
+| --- | --- | --- |
+| `media` | `media_bridge.c` + `media.a`（FFmpeg） | HTML 里有 `<video>`/`<audio>`、`createElement("video"/"audio")`、`new Audio()`、`decodeAudioData`，或运行时拼出的 HTML |
+| `gpu` | `gpu_bridge.c`（实现本身已在 `gui.a`） | `getContext("webgl"/"webgl2"/"experimental-webgl")`（或运行时决定的 kind）、任意 `webgl` 字符串、`mix-blend-mode`/`mixBlendMode`，或运行时拼出的 HTML |
+| `images` | `image_bridge.c`（实现本身已在 `gui.a`） | `<img>`、内联 `<svg>`、`background-image`/`url(...)`、`.svg` 路径、`drawImage`/`createImageBitmap`/`Image`，或运行时拼出的 HTML |
+| `shaping` | `text_bridge.c`（实现本身已在 `gui.a`） | 非 ASCII 文本（CJK/西里尔/希腊文等）、转义或实体码点，或运行时拼出的 HTML |
+| `webgl` | `webgl_bridge.c`（实现本身已在 `gui.a`，依赖 `gpu`） | WebGL 的 `getContext(...)`、`webgl` 字符串，或运行时拼出的 HTML |
+
+driver 会扫描打包后的 AST（`src/driver/usage.ts`）：所有字符串字面量（包括导入的
+`.html` 与内联进来的 CSS）、标识符与属性名、每个 `getContext(...)` 的 kind，以及
+HTML/CSS 是否可能来自编译器看不见的数据。简单的 `const` 别名会被解析；无法解析的
+markup 会让程序按“动态 markup”保守处理，启用可选特性。
+
+特性启用时，driver 只为本构建编译它的 C **bridge**，并链接在 `gui.a` 之前：
+
+- `media` → `runtime/ext_media/media_bridge.c`；构造函数安装解码表并引用
+  `xt_media_backend_*`，从而把 FFmpeg 成员从 `media.a` 里取出。
+- `gpu` → `runtime/ext_gui/gpu_bridge.c`；构造函数调用 `gpu_feature.cpp` 里的
+  `xt_gpu_feature_register`，安装 `XtGpuShaderApi` 表并引用 `compile_glsl` /
+  `cross_compile_msl` / 反射函数，从而取出 glslang（macOS 上还有 SPIRV-Cross）。
+- `images` → `runtime/ext_gui/image_bridge.c`；构造函数通过 `image_feature.cpp`
+  安装 `XtImageApi`，其引用取出 stb_image 与 NanoSVG。layout、paint、canvas
+  `drawImage` 与应用图标都走这张表，因此纯文本页面不链接这两个解码器。
+- `shaping` → `runtime/ext_gui/text_bridge.c`；构造函数通过 `text_hb.cpp` 安装
+  `TextApi`，其引用取出 HarfBuzz 与 FreeType。没有它时引擎使用内置 stb_truetype，
+  纯拉丁页面两个库都不链接。
+- `webgl` → `runtime/ext_gui/webgl_bridge.c`；构造函数通过 `webgl_feature.cpp` 安装
+  `XtWebglApi`，其引用取出 WebGL context 与 DOM 绑定。core 的 `getContext`、
+  canvas 宽高 setter、`createImageBitmap`、host type 与 renderer 都走这张表，因此
+  不用 WebGL 的页面不链接任何 `webgl_*`/`dom_api_webgl*`。
+
+bridge 就是让链接器搜索归档的“强引用”；没有 bridge 时引擎的表保持 null，
+实现成员永不被取出。因此大库可以留在现有归档里，不需要新的包布局。
+
+覆盖方式：`--feature media,gpu,images,shaping,webgl`（或 `all`）强制开启；
+`--no-feature media` 即使检测到也不链接。`webgl` 依赖 `gpu`，resolver 会一起
+激活；配置应用图标会强制 `images`，因为图标走同一条解码管线。`--ext media` 是
+`--ext gui --feature media` 的弃用别名。
+自动检测到的特性归档缺失时构建打印 warning 并继续（元素/上下文按文档降级）；
+显式强制的特性则报错。
+
+> 检测是静态的。用 `fetch`、`readFileSync` 等运行时数据拼 HTML/CSS 的页面应传
+> `--feature all`（或具体特性）。`--verbose` 会打印选中的集合，例如
+> `xbintsc: link features: none`。
+
+### 二进制体积
+
+DOM-only 程序的小体积来自上述 lean 构建。Windows x64 上，一个 `hello` 规模的程序
+从约 6.4 MiB 降到约 3.1 MiB：SDL 按上面的选项配置，function/data sections 让
+`/OPT:REF` 丢弃页面触达不到的函数，WebGL/图片链接特性保持关闭，文本改用内置
+stb_truetype 而不是 HarfBuzz + FreeType。剩余重量主要是静态 CRT、lean SDL
+（约 1 MiB）、stb_truetype（约 0.1 MiB）以及 DOM/CSS/layout/paint 引擎本身
+（约 1.2 MiB）。Linux 与 macOS 使用各自的链接器 section（`--gc-sections`/
+`-dead_strip`），数字会有差异，但相对排序相同。
+
+WebGL 与图片/SVG 是链接特性（约 0.4 MiB 的 WebGL context/DOM 代码与 0.23 MiB 的
+stb_image/NanoSVG，DOM-only 页面不链接）。Canvas2D、Web Audio 与
+`mix-blend-mode` 合成器尚未按需化；不使用它们的程序仍要付出其 API 面积（每项大约
+0.1–0.2 MiB）。
+
+文本替换是有意的取舍。默认后端是 stb_truetype：只接受 TrueType 轮廓，整形是逐码点
+映射加字体的 `kern` 表，因此 CFF/OTF 与可变字体、OpenType 连字以及复杂文种
+（阿拉伯/印度/泰文）整形不可用；fallback 链仍会在主字体缺字时切换到其他字体。
+选中可选的 **`shaping`** 特性（非 ASCII 文本会自动选中，也可用
+`--feature shaping`）会重新链接 HarfBuzz + FreeType（约 1.2 MiB），恢复完整的
+OpenType 整形与 CFF/OTF/可变字体支持。纯拉丁 DOM 页面因此保持约 3.1 MiB；
+中文/复杂文种页面更接近 4.3 MiB。
+
 ## 运行示例
 
 ```sh
@@ -117,9 +210,10 @@ Chocolatey/独立 LLVM，CI、本地构建与预编译归档共用同一条编
 
 `examples/gui/media.ts`（配合 `media.html`）演示 `<video>`/`<audio>`：它在
 `<video>` 上叠一个 CSS 进度条，并用 `play()`/`pause()`/`currentTime`/
-`volume` 驱动播放。它需要单独的可选 `media` 扩展，因此要构建并同时启用两者。
+`volume` 驱动播放。编译器从 `media.html` 里看到这些元素后会自动选中 `media`
+特性；先用 `npm run media` 构建一次 `media.a`。
 媒体 `src` 相对于进程工作目录解析，因此从仓库根目录运行：
-`xbintsc run examples/gui/media.ts --ext gui,media`。几何报告见该目录的 README。
+`xbintsc run examples/gui/media.ts --ext gui`。几何报告见该目录的 README。
 
 这些测试套件在 Windows 上默认跳过（归档可以在本机通过 Vulkan 运行，但 CI
 runner 没有可用的 GPU 驱动）。如果本机有 `gui.lib` 与可用的 GPU，可用

package/doc/zh-CN/gui/canvas.md

@@ -156,7 +156,7 @@ canvas 由脚本重绘而不是引擎重绘，因此开销按绘制调用计。
 （奇数长度列表会复制一遍，负数/非有限值会被忽略，全零列表表示实线）。
 
 文本：`measureText(text)`（返回 `{ width }`）、`fillText(text, x, y, maxWidth?)` 与
-`strokeText(text, x, y, maxWidth?)`。文本经 HarfBuzz 排版、FreeType 光栅化（与 HTML
+`strokeText(text, x, y, maxWidth?)`。文本经 stb_truetype 整形与光栅化（与 HTML
 文本相同的技术栈），按变换的近似缩放绘制。正的 `maxWidth` 会按比例压缩步进与字形位图，
 使文本宽度不超过该值（与 canvas API 一致），而不是忽略该参数。**仅支持平移与均匀
 缩放**——旋转或斜切变换仍会把每个字形放到其变换后的基线点，但不会旋转字形位图。

package/doc/zh-CN/gui/known-issues.md

@@ -20,6 +20,15 @@
   `WebGLRenderer` 直接运行在真实后端上，不再有 Canvas2D 回退。阴影贴图
   （比较型 `sampler2DShadow` 采样深度纹理）、立方体贴图/环境贴图与 HDR 渲染目标
   均已支持。
+- **部分 Intel Mac 上比较型采样器会被错误编译。** 在 Intel GPU（在 Intel Iris
+  Plus Graphics + macOS 26 上观察到）上，Metal 着色器编译器会丢弃调用
+  `sample_compare` 的片元函数：绘制不产生任何像素，于是
+  `texture(sampler2DShadow, …)` 读到黑色，阴影贴图消失。MSL 本身是正确的
+  （`depth2d<float>` + `sample_compare`），采样器也带比较操作，而同一个程序在
+  打开 Metal GPU 着色器校验后渲染正常——在这类机器上以
+  `MTL_SHADER_VALIDATION=1` 运行即可让
+  `tests/e2e/gui-webgl2-shadow-sampler.test.ts` 通过。这指向驱动的着色器编译器
+  而非引擎，因此以环境变量作为绕过办法；其他 Apple GPU 未必存在该问题。
 
 
 - **自动关闭时的偶发崩溃。** 设置 `XT_GUI_AUTOCLOSE_MS` 结束运行时，约五次中有两次会以原生
@@ -79,6 +88,17 @@
   `win.stats()` 的 `textCacheBytes`/`textShapeHits` 能看出它是否成为瓶颈。
   元素自带的 `style="…"` 内联属性在该元素每次重算样式时都会重新解析。
 
+- **文本整形是简单整形器。** stb_truetype 覆盖拉丁/CJK/西里尔/希腊文、基础
+  `kern` 与逐码点回退，但不执行 OpenType 连字或复杂文种（阿拉伯/印度/泰文）整形，
+  且只接受 TrueType 轮廓（不支持 CFF/OTF 或可变字体）；彩色 emoji 也不会以彩色
+  渲染。这是 DOM-only 二进制约 3 MiB 的代价；可选的 `shaping` 特性会重新链接
+  HarfBuzz + FreeType，恢复完整整形。
+- **链接特性检测是静态的。** `media`/`gpu`/`images`/`shaping`/`webgl` 从打包后的 HTML/CSS/TS（包括导入的
+  `.html` 与其内联 CSS）里选择。用运行时数据（`fetch`、`readFileSync`、函数返回值）
+  拼 HTML/CSS 的页面无法被看到；扫描器在能证明 sink 是动态时会保守地启用可选特性，
+  但对于它无法分类的不透明值，需要显式 `--feature media`/`gpu`/`images`/`shaping`/`webgl`（或 `all`）。
+  `--verbose` 会打印选中的集合。见[链接特性](./build.md#链接特性)。
+
 ## 待决问题
 
 - Linux 首发是只发布 X11、Wayland，还是两者都发布。（决定：先 X11，
@@ -97,7 +117,8 @@
 - Windows：`scripts/build-gui.ts` 会生成 MSVC 兼容的 `gui.lib`
   （COFF 对象 + `ar -M`/`llvm-ar`）。Windows x64 的 CI job 使用 Visual Studio
   工具链（`.github/actions/vs-toolchain` 导入 `vcvarsall` 并采用 VS 自带的
-  LLVM）构建它、链接一个 `gui,media` 程序，并随 x64 发布归档一起发布。示例在
+  LLVM）构建它、链接一个会触发 `media` 链接特性的 `gui` 程序，并随 x64 发布归档
+  一起发布。示例在
   托管 runner 上的*运行*仍为试验性，因为那里没有 GPU/Vulkan 驱动（SDL_GPU 在
   Windows 上选择 **Vulkan** 后端，因此不需要 DXIL/`dxc` 工具链）。Windows
   arm64 仍跳过两个归档。在开发者机器上构建并运行
@@ -105,12 +126,12 @@
 - **Windows：x64 在 CI 中构建，arm64 与运行时验证仍为试验性。**
   `scripts/build-media.ts` 用 FFmpeg 的 MSVC 工具链
   （`--toolchain=msvc --cc=clang-cl`）生成 `media.lib`，其 COFF 对象与静态 CRT
-  和 `gui.lib` 一致，`--ext media` 在 Windows 上可以正常链接并播放。构建它需要
+  和 `gui.lib` 一致，自动选中的 `media` 特性在 Windows 上可以正常链接并播放。构建它需要
   POSIX shell 运行 FFmpeg 的 `configure` 以及 GNU make；shell 来自 Git for
   Windows（克隆 SDL3 本来就需要 Git），make 是原生 GNU make（Chocolatey 的
   `make`，或 `xbintsc_MAKE`）。CI 会显式安装 make，在
   Windows x64 上使用与本地构建相同的 Visual Studio `vcvarsall` + 自带 LLVM
-  构建 `gui.lib` 与 `media.lib`，链接 `gui,media` 程序，并把两个归档放进
+  构建 `gui.lib` 与 `media.lib`，链接一个会触发该特性的 `gui` 程序，并把两个归档放进
   Windows x64 发布包；示例的*运行*仍因托管 runner 没有 GPU/Vulkan 驱动而保持
   试验性。Windows arm64 仍跳过两个归档；`<video controls>` 同样推迟——预期模式
   是 TS + CSS 叠层，如 `examples/gui/media.ts`。

package/doc/zh-CN/gui/layout.md

@@ -18,7 +18,7 @@
   基于单词的断行、`text-align` 与 `line-height`。行内元素获得其后代几何信息
   的并集；`display: inline-block` 以 shrink-to-fit 宽度原子化布局。每一行会收缩到
   与之重叠的浮动（`float: left|right`）所留出的空白带，因此后续行会绕开它们。
-  每个文本片段会记住它覆盖的 run，以便绘制时对它整形。文本使用 HarfBuzz/FreeType
+  每个文本片段会记住它覆盖的 run，以便绘制时对它整形。文本使用 stb_truetype
   技术栈测量（见[文本技术栈](./rendering.md)）。
 - **Flexbox** —— `row`/`column`（以及 `-reverse` 变体），支持 `gap`、
   `flex-basis`/`flex-grow`/`flex-shrink`、`justify-content` 与 `align-items`

package/doc/zh-CN/gui/media.md

@@ -62,7 +62,8 @@ opacity、`display`——与任何其他元素一样。盒子内部的艺术内
 
 ## 视频与音频（M13）
 
-媒体播放横跨两个扩展，因此只做界面的 GUI 程序不必为用不到的解码器付出体积：
+媒体播放拆在 `gui` 扩展内部，因此只做界面的 GUI 程序不必为用不到的解码器付出
+体积。解码是可选的 **`media` 链接特性**，不是独立扩展：
 
 - **`gui`**（`gui.a`/`gui.lib`）负责 `<video>`/`<audio>` 元素、DOM API、渲染器
   集成与 SDL 音频 sink，但**不含 FFmpeg**。`runtime/ext_gui/media.{h,cpp}`
@@ -71,12 +72,16 @@ opacity、`display`——与任何其他元素一样。盒子内部的艺术内
 - **`media`**（`media.a`，Windows 上 MSVC ABI 则为 `media.lib`；
   `runtime/ext_media/`）是可选的解码后端：`runtime/ext_media/media.cpp`
   封装静态 vendored 的 **FFmpeg** 构建，`runtime/ext_media/media_bridge.c`
-  把它注册进引擎。用 `--ext media`（或 `--ext gui,media`）启用。`media`
-  依赖 `gui`；注册表会拒绝错误的组合。
+  把它注册进引擎。编译器在程序可能用到媒体时（导入 HTML 里的
+  `<video>`/`<audio>`、`createElement("video"/"audio")`、`new Audio()`、
+  `decodeAudioData`，或运行时拼出的 HTML）自动选中该特性，只在那时才编译
+  bridge 并链接 `media.a`。`--feature media` 强制开启，`--no-feature media`
+  保持关闭；见[链接特性](./build.md#链接特性)。
 
-没有 `media` 扩展时，元素仍然存在、DOM API 仍可调用，但打开源会失败并触发
-`error`。任何没有构建该归档的宿主（先运行 `npm run media`）都是如此；
-Windows 已不再特殊：`media.lib` 是用 clang-cl 为 MSVC ABI 编译的 FFmpeg，
+没有 `media` 特性时，元素仍然存在、DOM API 仍可调用，但打开源会失败并触发
+`error`。任何没有构建该归档的宿主（先运行 `npm run media`）都是如此——自动
+检测到但归档缺失时构建给出 warning 并按此降级，显式 `--feature media` 则直接
+报错。Windows 已不再特殊：`media.lib` 是用 clang-cl 为 MSVC ABI 编译的 FFmpeg，
 因此可以和 `gui.lib` 一起链接并正常播放。两条路径都没有 WebView，也没有平台
 媒体框架。