xbintsc 0.5.45 → 0.5.52

package/dist/src/driver/usage.js

@@ -0,0 +1,353 @@
+/**
+ * Static usage analysis for optional link features.
+ *
+ * The bundled AST is the last place where the compiler can see *all* of a
+ * program: imported modules and `.html` assets are already merged into one
+ * `SourceFile`, and asset loaders have inlined external stylesheets. This module
+ * extracts the facts a {@link LinkFeature} needs to decide whether it may be
+ * used, without pretending to be a full data-flow analysis:
+ *
+ *   - every string literal / template chunk (HTML tags, CSS property values),
+ *   - identifiers and property names (`Audio`, `decodeAudioData`, …),
+ *   - every `getContext(...)` kind that can be resolved statically,
+ *   - whether HTML/CSS can be built from data the compiler cannot see.
+ *
+ * Constants are resolved through a small, name-based table (`const` only,
+ * invalidated by shadowing or reassignment). Anything that cannot be resolved is
+ * treated as dynamic, which makes features conservative: a false positive costs
+ * size, a false negative could disable a capability at run time.
+ */
+import { SyntaxKind, } from "../ast/nodes.js";
+import { walk } from "../ast/visitor.js";
+/** Operators that make a `BinaryExpression`-shaped node an assignment. */
+const ASSIGNMENT_OPERATORS = new Set([
+    "=",
+    "+=",
+    "-=",
+    "*=",
+    "/=",
+    "%=",
+    "**=",
+    "<<=",
+    ">>=",
+    ">>>=",
+    "&=",
+    "|=",
+    "^=",
+    "&&=",
+    "||=",
+    "??=",
+]);
+/** Property names whose assigned value is parsed as markup or CSS. */
+const MARKUP_PROPERTIES = new Set(["innerHTML", "outerHTML", "cssText"]);
+/**
+ * The property/method name of `a.b` or `a["b"]`, or the identifier of a bare
+ * call (`loadHTML(...)`). Returns undefined for a computed access.
+ */
+function memberName(expression) {
+    if (expression.kind === SyntaxKind.PropertyAccessExpression) {
+        return expression.name.text;
+    }
+    if (expression.kind === SyntaxKind.ElementAccessExpression) {
+        const argument = expression.argumentExpression;
+        if (argument.kind === SyntaxKind.StringLiteral)
+            return argument.value;
+        return undefined;
+    }
+    if (expression.kind === SyntaxKind.Identifier)
+        return expression.text;
+    return undefined;
+}
+/** The assignment-shaped view of a `BinaryExpression`, when it is one. */
+function asAssignment(node) {
+    if (node.kind !== SyntaxKind.BinaryExpression)
+        return undefined;
+    const operator = node.operator;
+    return ASSIGNMENT_OPERATORS.has(String(operator)) ? node : undefined;
+}
+/** True for literals that stringify to text which can never contain markup. */
+function isPrimitiveLiteral(expression) {
+    switch (expression.kind) {
+        case SyntaxKind.NumericLiteral:
+        case SyntaxKind.BigIntLiteral:
+        case SyntaxKind.TrueKeyword:
+        case SyntaxKind.FalseKeyword:
+        case SyntaxKind.NullKeyword:
+        case SyntaxKind.UndefinedKeyword:
+            return true;
+        default:
+            return false;
+    }
+}
+/** Convert a primitive literal to the text it contributes to a template. */
+function primitiveText(expression) {
+    switch (expression.kind) {
+        case SyntaxKind.NumericLiteral:
+            return String(expression.value);
+        case SyntaxKind.BigIntLiteral:
+            return expression.value.toString();
+        case SyntaxKind.TrueKeyword:
+        case SyntaxKind.FalseKeyword:
+            return expression.value ? "true" : "false";
+        case SyntaxKind.NullKeyword:
+            return "null";
+        case SyntaxKind.UndefinedKeyword:
+            return "undefined";
+        default:
+            return undefined;
+    }
+}
+/** Collect the usage facts of one bundled program. */
+export function collectUsage(sourceFile) {
+    const strings = new Set();
+    const identifiers = new Set();
+    const constants = new Map();
+    const ambiguous = new Set();
+    const assigned = new Set();
+    const calls = [];
+    const assignments = [];
+    let createsStyleElement = false;
+    let unresolvedTextContent = false;
+    const forget = (name) => {
+        if (constants.delete(name))
+            ambiguous.add(name);
+    };
+    walk(sourceFile, (node) => {
+        switch (node.kind) {
+            case SyntaxKind.StringLiteral:
+                strings.add(node.value);
+                break;
+            case SyntaxKind.NoSubstitutionTemplateLiteral:
+                strings.add(node.value);
+                break;
+            case SyntaxKind.TemplateLiteral: {
+                const template = node;
+                strings.add(template.head);
+                for (const span of template.spans)
+                    strings.add(span.literal);
+                break;
+            }
+            case SyntaxKind.Identifier:
+                identifiers.add(node.text);
+                break;
+            case SyntaxKind.PrivateIdentifier:
+                identifiers.add(node.text);
+                break;
+            case SyntaxKind.VariableStatement: {
+                const statement = node;
+                if (statement.declarationList.declarationKind !== "const")
+                    break;
+                for (const declaration of statement.declarationList.declarations) {
+                    if (declaration.name.kind !== SyntaxKind.Identifier || declaration.initializer === undefined)
+                        continue;
+                    const name = declaration.name.text;
+                    /* A second declaration of the same name makes the initializer
+                     * ambiguous: shadowing is not tracked, so refuse to resolve it. */
+                    if (constants.has(name) || ambiguous.has(name)) {
+                        forget(name);
+                        continue;
+                    }
+                    constants.set(name, declaration.initializer);
+                }
+                break;
+            }
+            case SyntaxKind.Parameter: {
+                /* A parameter shadows any const of the same name; resolution only looks
+                 * at the name, so mark it ambiguous. */
+                const parameter = node;
+                if (parameter.name.kind === SyntaxKind.Identifier)
+                    ambiguous.add(parameter.name.text);
+                break;
+            }
+            case SyntaxKind.PrefixUnaryExpression: {
+                const unary = node;
+                if (unary.operator === "++" || unary.operator === "--") {
+                    if (unary.operand.kind === SyntaxKind.Identifier)
+                        assigned.add(unary.operand.text);
+                }
+                break;
+            }
+            case SyntaxKind.PostfixUnaryExpression: {
+                const unary = node;
+                if (unary.operand.kind === SyntaxKind.Identifier)
+                    assigned.add(unary.operand.text);
+                break;
+            }
+            case SyntaxKind.BinaryExpression: {
+                const assignment = asAssignment(node);
+                if (assignment === undefined)
+                    break;
+                if (assignment.left.kind === SyntaxKind.Identifier)
+                    assigned.add(assignment.left.text);
+                const name = memberName(assignment.left);
+                if (name !== undefined)
+                    assignments.push({ name, right: assignment.right });
+                break;
+            }
+            case SyntaxKind.CallExpression: {
+                const call = node;
+                const name = memberName(call.expression);
+                if (name !== undefined)
+                    calls.push({ name, arguments: call.arguments });
+                break;
+            }
+            default:
+                break;
+        }
+    });
+    const resolve = (expression, stack = new Set()) => {
+        const primitive = primitiveText(expression);
+        if (primitive !== undefined)
+            return primitive;
+        switch (expression.kind) {
+            case SyntaxKind.StringLiteral:
+                return expression.value;
+            case SyntaxKind.NoSubstitutionTemplateLiteral:
+                return expression.value;
+            case SyntaxKind.TemplateLiteral: {
+                const template = expression;
+                let text = template.head;
+                for (const span of template.spans) {
+                    const value = resolve(span.expression, stack);
+                    if (value === undefined) {
+                        if (!isPrimitiveLiteral(span.expression))
+                            return undefined;
+                    }
+                    else {
+                        text += value;
+                    }
+                    text += span.literal;
+                }
+                return text;
+            }
+            case SyntaxKind.Identifier: {
+                const name = expression.text;
+                if (assigned.has(name) || ambiguous.has(name))
+                    return undefined;
+                const initializer = constants.get(name);
+                if (initializer === undefined || stack.has(name))
+                    return undefined;
+                stack.add(name);
+                const value = resolve(initializer, stack);
+                stack.delete(name);
+                return value;
+            }
+            case SyntaxKind.ParenthesizedExpression:
+            case SyntaxKind.AsExpression:
+            case SyntaxKind.SatisfiesExpression:
+            case SyntaxKind.NonNullExpression: {
+                return resolve(expression.expression, stack);
+            }
+            case SyntaxKind.BinaryExpression: {
+                const binary = expression;
+                if (ASSIGNMENT_OPERATORS.has(String(binary.operator)) || binary.operator !== "+")
+                    return undefined;
+                const left = resolve(binary.left, stack);
+                const right = resolve(binary.right, stack);
+                return left === undefined || right === undefined ? undefined : left + right;
+            }
+            default:
+                return undefined;
+        }
+    };
+    let dynamicMarkup = false;
+    const getContextKinds = [];
+    const sink = (expression) => {
+        if (expression === undefined) {
+            dynamicMarkup = true;
+            return;
+        }
+        const text = resolve(expression);
+        if (text === undefined)
+            dynamicMarkup = true;
+        else
+            strings.add(text);
+    };
+    const sinkAll = (expressions) => {
+        for (const expression of expressions) {
+            const text = resolve(expression);
+            if (text === undefined)
+                dynamicMarkup = true;
+            else
+                strings.add(text);
+        }
+    };
+    for (const site of calls) {
+        switch (site.name) {
+            case "getContext": {
+                const kind = site.arguments[0] === undefined ? undefined : resolve(site.arguments[0]);
+                getContextKinds.push(kind === undefined ? undefined : kind.toLowerCase());
+                break;
+            }
+            case "createElement": {
+                const tag = site.arguments[0] === undefined ? undefined : resolve(site.arguments[0]);
+                if (tag === undefined)
+                    dynamicMarkup = true;
+                else if (tag.toLowerCase() === "style")
+                    createsStyleElement = true;
+                break;
+            }
+            case "createElementNS": {
+                const tag = site.arguments[1] === undefined ? undefined : resolve(site.arguments[1]);
+                if (tag === undefined)
+                    dynamicMarkup = true;
+                else if (tag.toLowerCase() === "style")
+                    createsStyleElement = true;
+                break;
+            }
+            case "loadHTML":
+            case "parseFromString":
+            case "write":
+            case "writeln":
+                sink(site.arguments[0]);
+                break;
+            case "insertAdjacentHTML":
+                sink(site.arguments[1]);
+                break;
+            case "setAttribute": {
+                const attribute = site.arguments[0] === undefined ? undefined : resolve(site.arguments[0]);
+                if (attribute === undefined)
+                    dynamicMarkup = true;
+                else if (attribute.toLowerCase() === "style")
+                    sink(site.arguments[1]);
+                break;
+            }
+            case "setProperty": {
+                /* The property *name* decides whether a CSS feature is used; the value
+                 * cannot introduce a new property. A computed name is therefore the
+                 * only reason to be conservative here. */
+                if (site.arguments[0] === undefined || resolve(site.arguments[0]) === undefined)
+                    dynamicMarkup = true;
+                break;
+            }
+            case "insertRule":
+            case "addRule":
+            case "replaceSync":
+                sinkAll(site.arguments);
+                break;
+            default:
+                break;
+        }
+    }
+    for (const assignment of assignments) {
+        if (MARKUP_PROPERTIES.has(assignment.name)) {
+            sink(assignment.right);
+        }
+        else if (assignment.name === "textContent" || assignment.name === "innerText") {
+            if (resolve(assignment.right) === undefined)
+                unresolvedTextContent = true;
+        }
+    }
+    /* A `<style>` element created at run time is usually filled through
+     * `textContent`; if that value is not a literal, CSS (and therefore
+     * `mix-blend-mode`) may come from data the compiler cannot see. */
+    if (createsStyleElement && unresolvedTextContent)
+        dynamicMarkup = true;
+    return {
+        strings: [...strings],
+        identifiers,
+        getContext: getContextKinds,
+        dynamicMarkup,
+    };
+}
+//# sourceMappingURL=usage.js.map

package/dist/src/driver/usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.js","sourceRoot":"","sources":["../../../src/driver/usage.ts"],"names":[],"mappings":"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"}

package/dist/src/driver/version.d.ts

@@ -9,4 +9,4 @@
  * `main`/`master` only (see `.githooks/pre-commit`), so feature branches never
  * change this line and merging two of them cannot conflict here.
  */
-export declare const COMPILER_VERSION = "0.5.45";
+export declare const COMPILER_VERSION = "0.5.52";

package/dist/src/driver/version.js

@@ -9,5 +9,5 @@
  * `main`/`master` only (see `.githooks/pre-commit`), so feature branches never
  * change this line and merging two of them cannot conflict here.
  */
-export const COMPILER_VERSION = "0.5.45";
+export const COMPILER_VERSION = "0.5.52";
 //# sourceMappingURL=version.js.map

package/dist/src/extensions/catalog.js

@@ -11,9 +11,8 @@
  */
 import { nodeExtension } from "./node/index.js";
 import { guiExtension } from "./gui/index.js";
-import { mediaExtension } from "./media/index.js";
 /** Every extension bundled with xbintsc, in registration order. */
 export function bundledExtensions() {
-    return [nodeExtension, guiExtension, mediaExtension];
+    return [nodeExtension, guiExtension];
 }
 //# sourceMappingURL=catalog.js.map

package/dist/src/extensions/catalog.js.map

@@ -1 +1 @@
-{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../../src/extensions/catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,mEAAmE;AACnE,MAAM,UAAU,iBAAiB;IAC/B,OAAO,CAAC,aAAa,EAAE,YAAY,EAAE,cAAc,CAAC,CAAC;AACvD,CAAC"}
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../../src/extensions/catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,mEAAmE;AACnE,MAAM,UAAU,iBAAiB;IAC/B,OAAO,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC;AACvC,CAAC"}

package/dist/src/extensions/gui/features.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Optional link features of the `gui` extension.
+ *
+ * The GUI engine itself is always linked with `--ext gui`; these are the two
+ * heavy halves a program may never touch:
+ *
+ *   - `media` — the FFmpeg decoder backend (`runtime/ext_media/`, `media.a`).
+ *     The DOM media surface lives in `gui.a`; only decoding is optional, and an
+ *     element without the backend still exists and fires `error`.
+ *   - `gpu` — glslang (+ SPIRV-Cross on macOS), the GLSL→SPIR-V translator used
+ *     by WebGL *and* by the `mix-blend-mode` / `backdrop-filter` offscreen
+ *     compositor. The engine's own shaders are precompiled, so a DOM page
+ *     never needs it.
+ *
+ * Detection is static: the compiler sees imported `.html`/`.css` assets and all
+ * bundled modules, so it can recognise `<video>`/`<audio>`, `getContext("webgl")`
+ * and `mix-blend-mode`/`backdrop-filter`. When markup can be built at run time
+ * the usage collector sets `dynamicMarkup`, which conservatively enables both
+ * features; users who know better can shrink the binary with `--no-feature`.
+ */
+import type { LinkFeature, ProgramUsage } from "../link-feature.js";
+/** True when the program may create or drive a media element. */
+export declare function hasMediaUsage(usage: ProgramUsage): boolean;
+/** True when the program may compile GLSL at run time (WebGL or blending). */
+export declare function hasGpuUsage(usage: ProgramUsage): boolean;
+/** True when the program may ask for a WebGL context (not just blending). */
+export declare function hasWebglUsage(usage: ProgramUsage): boolean;
+/** True when the program may draw a bitmap or SVG. */
+export declare function hasImageUsage(usage: ProgramUsage): boolean;
+/** True when the program may need full OpenType shaping. Non-Latin text needs it
+ * for shaping, and an author `@font-face` often points at a CFF/OTF font that
+ * the default stb_truetype backend cannot outline. */
+export declare function hasShapingUsage(usage: ProgramUsage): boolean;
+export declare const guiLinkFeatures: readonly LinkFeature[];

package/dist/src/extensions/gui/features.js

@@ -0,0 +1,165 @@
+/**
+ * Optional link features of the `gui` extension.
+ *
+ * The GUI engine itself is always linked with `--ext gui`; these are the two
+ * heavy halves a program may never touch:
+ *
+ *   - `media` — the FFmpeg decoder backend (`runtime/ext_media/`, `media.a`).
+ *     The DOM media surface lives in `gui.a`; only decoding is optional, and an
+ *     element without the backend still exists and fires `error`.
+ *   - `gpu` — glslang (+ SPIRV-Cross on macOS), the GLSL→SPIR-V translator used
+ *     by WebGL *and* by the `mix-blend-mode` / `backdrop-filter` offscreen
+ *     compositor. The engine's own shaders are precompiled, so a DOM page
+ *     never needs it.
+ *
+ * Detection is static: the compiler sees imported `.html`/`.css` assets and all
+ * bundled modules, so it can recognise `<video>`/`<audio>`, `getContext("webgl")`
+ * and `mix-blend-mode`/`backdrop-filter`. When markup can be built at run time
+ * the usage collector sets `dynamicMarkup`, which conservatively enables both
+ * features; users who know better can shrink the binary with `--no-feature`.
+ */
+import { join } from "node:path";
+import { findRuntimeDir, platformSlug } from "../../driver/paths.js";
+import { findRuntimeLibrary, runtimeLibDir } from "../../driver/runtime-lib.js";
+/** `<video …>` / `<audio …>` in an HTML string or asset. */
+const MEDIA_TAG = /<(?:video|audio)\b/i;
+/** A literal tag name handed to `createElement("video")`. */
+const MEDIA_TAG_NAME = /^(?:video|audio)$/i;
+/** Anything that needs the GLSL translator. */
+const GPU_TOKEN = /webgl|mix-blend-mode|mixBlendMode|backdrop-filter|backdropFilter/i;
+/** True when the program may create or drive a media element. */
+export function hasMediaUsage(usage) {
+    if (usage.dynamicMarkup)
+        return true;
+    for (const name of ["Audio", "HTMLMediaElement", "HTMLVideoElement", "HTMLAudioElement", "decodeAudioData"]) {
+        if (usage.identifiers.has(name))
+            return true;
+    }
+    return usage.strings.some((value) => MEDIA_TAG.test(value) || MEDIA_TAG_NAME.test(value));
+}
+/** True when the program may compile GLSL at run time (WebGL or blending). */
+export function hasGpuUsage(usage) {
+    if (usage.dynamicMarkup)
+        return true;
+    if (usage.identifiers.has("mixBlendMode") || usage.identifiers.has("backdropFilter"))
+        return true;
+    if (usage.getContext.some((kind) => kind === undefined || /webgl/i.test(kind)))
+        return true;
+    return usage.strings.some((value) => GPU_TOKEN.test(value));
+}
+/** True when the program may ask for a WebGL context (not just blending). */
+export function hasWebglUsage(usage) {
+    if (usage.dynamicMarkup)
+        return true;
+    if (usage.getContext.some((kind) => kind === undefined || /webgl/i.test(kind)))
+        return true;
+    return usage.strings.some((value) => /webgl/i.test(value));
+}
+/** True when the program may draw a bitmap or SVG. */
+export function hasImageUsage(usage) {
+    if (usage.dynamicMarkup)
+        return true;
+    for (const name of ["Image", "ImageBitmap", "createImageBitmap", "drawImage"]) {
+        if (usage.identifiers.has(name))
+            return true;
+    }
+    return usage.strings.some((value) => /<img\b|<svg\b|background-image|url\(|\.svg\b|drawImage|createImageBitmap/i.test(value));
+}
+/** True when the program may need full OpenType shaping. Non-Latin text needs it
+ * for shaping, and an author `@font-face` often points at a CFF/OTF font that
+ * the default stb_truetype backend cannot outline. */
+export function hasShapingUsage(usage) {
+    if (usage.dynamicMarkup)
+        return true;
+    return usage.strings.some((value) => {
+        if (/@font-face\b/i.test(value))
+            return true;
+        for (const character of value) {
+            if ((character.codePointAt(0) ?? 0) > 0x7f)
+                return true;
+        }
+        return /\\u\{[0-9a-fA-F]+\}|\\u[0-9a-fA-F]{4}|&#(?:x[0-9a-fA-F]+|\d+);/.test(value);
+    });
+}
+/** Absolute path to the per-platform prebuilt media archive. */
+function mediaArchive() {
+    return join(runtimeLibDir(), process.platform === "win32" ? "media.lib" : "media.a");
+}
+export const guiLinkFeatures = [
+    {
+        name: "media",
+        description: "FFmpeg decoding for <video>/<audio>",
+        /**
+         * The registration bridge is a tiny C file compiled and linked only when
+         * the feature is active. Its constructor installs the decoder table into
+         * the engine and references the backend entry points, which is what makes
+         * the linker extract `media.a` — an archive whose only entry point is a
+         * constructor would otherwise never be pulled in.
+         */
+        runtimeSources: () => [join(findRuntimeDir(), "ext_media", "media_bridge.c")],
+        nativeObjects: () => {
+            const archive = findRuntimeLibrary("media");
+            if (archive === undefined) {
+                throw new Error(`media native library not found at ${mediaArchive()} (media.a or media.lib).\n` +
+                    `The optional @xbintsc/${platformSlug()} package ships it: reinstall xbintsc ` +
+                    `without --omit=optional, or build it with \`npm run media\` (see doc/gui/build.md).`);
+            }
+            return [archive];
+        },
+        /** `media.a` is C++ and FFmpeg itself needs libm; the GUI extension already
+         * contributes the C++ runtime and the OS frameworks. On Windows the FFmpeg
+         * objects reference the Win32 crypto/COM services (`bcrypt`, `ole32`) and
+         * `user32`. */
+        linkerFlags: () => (process.platform === "win32" ? ["-lbcrypt", "-lole32", "-luser32"] : ["-lm"]),
+        used: hasMediaUsage,
+    },
+    {
+        name: "gpu",
+        description: "GLSL translation (WebGL, mix-blend-mode and backdrop-filter) via glslang",
+        /**
+         * `gpu_bridge.c` is linked only when the feature is active. It calls into
+         * `gpu_feature.cpp` inside `gui.a`, which installs the shader-translation
+         * table and references `compile_glsl`/`cross_compile_msl`; those references
+         * are what pull the glslang members out of `gui.a`. Without the bridge the
+         * engine's shader paths see a null table and fail gracefully (blend falls
+         * back, WebGL reports a compile log).
+         */
+        runtimeSources: () => [join(findRuntimeDir(), "ext_gui", "gpu_bridge.c")],
+        used: hasGpuUsage,
+    },
+    {
+        name: "images",
+        description: "stb_image/NanoSVG decoding for <img>, CSS backgrounds and inline <svg>",
+        /**
+         * `image_bridge.c` installs `XtImageApi` and references the decoders; a page
+         * with no `<img>`/SVG/`background-image`/`drawImage` links neither
+         * stb_image nor NanoSVG.
+         */
+        runtimeSources: () => [join(findRuntimeDir(), "ext_gui", "image_bridge.c")],
+        used: hasImageUsage,
+    },
+    {
+        name: "shaping",
+        description: "HarfBuzz/FreeType shaping for complex scripts and CFF/OTF fonts",
+        /**
+         * `text_bridge.c` installs `TextApi` and references `text_hb.cpp`, pulling
+         * HarfBuzz and FreeType out of `gui.a`. A Latin-only page keeps the faster
+         * stb_truetype path and links neither library.
+         */
+        runtimeSources: () => [join(findRuntimeDir(), "ext_gui", "text_bridge.c")],
+        used: hasShapingUsage,
+    },
+    {
+        name: "webgl",
+        description: "WebGL context and DOM API (requires gpu)",
+        requires: ["gpu"],
+        /**
+         * `webgl_bridge.c` installs `XtWebglApi` and references the WebGL context
+         * and DOM bindings, pulling them out of `gui.a`. A page that never asks for
+         * WebGL therefore links none of `webgl_*`/`dom_api_webgl*`.
+         */
+        runtimeSources: () => [join(findRuntimeDir(), "ext_gui", "webgl_bridge.c")],
+        used: hasWebglUsage,
+    },
+];
+//# sourceMappingURL=features.js.map

package/dist/src/extensions/gui/features.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"features.js","sourceRoot":"","sources":["../../../../src/extensions/gui/features.ts"],"names":[],"mappings":"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"}

package/dist/src/extensions/gui/index.js

@@ -25,6 +25,7 @@ import { platformSlug } from "../../driver/paths.js";
 import { findRuntimeLibrary, runtimeLibDir } from "../../driver/runtime-lib.js";
 import { loadHtmlAsset } from "./html.js";
 import { loadScriptAsset } from "./three.js";
+import { guiLinkFeatures } from "./features.js";
 /** Top-level `gui` module bindings. */
 const guiModule = {
     namespace: "gui",
@@ -132,9 +133,8 @@ export const guiExtension = {
     },
     /**
      * System libraries the archive itself depends on. The vendored third-party
-     * libraries (GPU backend, HarfBuzz, FreeType, ...) are linked *into* `gui.a`
-     * by its build script, so only OS frameworks remain here. TODO(gui): confirm
-     * the exact set once the GPU backend is chosen (see doc/gui.md).
+     * libraries (GPU backend, stb_truetype, stb_image/NanoSVG, ...) are linked
+     * *into* `gui.a` by its build script, so only OS frameworks remain here.
      */
     linkerFlags: () => {
         if (process.platform === "darwin") {
@@ -153,7 +153,7 @@ export const guiExtension = {
                 "-framework", "GameController",
                 "-framework", "Metal",
                 "-framework", "QuartzCore",
-                /* HarfBuzz's CoreText shaper (macOS system fonts). */
+                /* Cocoa/system text and graphics services used by SDL. */
                 "-framework", "CoreText",
                 "-framework", "CoreGraphics",
                 "-framework", "CoreFoundation",
@@ -207,5 +207,11 @@ export const guiExtension = {
     globalValues: () => browserGlobals,
     /** Rewrite imported `.html` assets and patch three.js's shader unroller. */
     assetLoaders: () => ({ ".html": loadHtmlAsset, ".js": loadScriptAsset, ".mjs": loadScriptAsset }),
+    /**
+     * FFmpeg and glslang are optional halves of the engine, selected from the
+     * program (see `features.ts`). A program that only renders HTML/CSS never
+     * links either.
+     */
+    linkFeatures: () => guiLinkFeatures,
 };
 //# sourceMappingURL=index.js.map