xbintsc 0.5.45 → 0.5.52

package/src/extensions/registry.ts

@@ -11,6 +11,8 @@
  * extensions they need before invoking the driver.
  */
 
+import type { LinkFeature } from "./link-feature.js";
+
 export interface BuiltinFunction {
   /** Exported C symbol, called as `xt_value symbol(int32_t argc, xt_value *argv)`. */
   readonly symbol: string;
@@ -109,7 +111,7 @@ export interface Extension {
   /**
    * Other extensions this one needs. The registry rejects a build that enables
    * it without them, so a dependent extension fails with an actionable message
-   * instead of an unresolved symbol at link time (e.g. `media` needs `gui`).
+   * instead of an unresolved symbol at link time.
    */
   readonly requires?: readonly string[];
   /** C/asm sources compiled and linked alongside the generated module. */
@@ -144,6 +146,19 @@ export interface Extension {
    * learns about any particular asset format.
    */
   assetLoaders?(): Readonly<Record<string, AssetLoader>>;
+  /**
+   * Optional heavy capabilities this extension can contribute only when a
+   * program may use them (`media`, `gpu`, `images`, `shaping`, `webgl`, …). The driver selects among them
+   * from the bundled source and links their registration source and archives
+   * only when active; see {@link LinkFeature}.
+   */
+  linkFeatures?(): readonly LinkFeature[];
+}
+
+/** A link feature together with the extension that declared it. */
+export interface LinkFeatureDeclaration {
+  readonly feature: LinkFeature;
+  readonly extension: string;
 }
 
 export class ExtensionRegistry {
@@ -190,11 +205,13 @@ export class ExtensionRegistry {
   }
 
   /**
-   * Throw when a registered extension requires one that is not registered.
-   * Called before a build so `--ext media` without `--ext gui` reports which
-   * flags to pass instead of failing later with an unresolved symbol.
+   * Throw when a registered extension requires one that is not registered, or
+   * when two extensions declare the same link feature.
+   * Called before a build so a missing dependency reports which flags to pass
+   * instead of failing later with an unresolved symbol.
    */
   validate(): this {
+    const features = new Map<string, string>();
     for (const extension of this.extensions.values()) {
       for (const dependency of extension.requires ?? []) {
         if (this.extensions.has(dependency)) continue;
@@ -203,6 +220,15 @@ export class ExtensionRegistry {
             `pass --ext ${dependency},${extension.name}`,
         );
       }
+      for (const feature of extension.linkFeatures?.() ?? []) {
+        const owner = features.get(feature.name);
+        if (owner !== undefined && owner !== extension.name) {
+          throw new Error(
+            `link feature '${feature.name}' is declared by both '${owner}' and '${extension.name}'`,
+          );
+        }
+        features.set(feature.name, extension.name);
+      }
     }
     return this;
   }
@@ -270,6 +296,21 @@ export class ExtensionRegistry {
     return merged;
   }
 
+  /**
+   * Every optional link feature declared by the registered extensions, paired
+   * with its provider. Features of extensions that are not enabled are absent,
+   * so a program cannot accidentally link `media` through `node`.
+   */
+  linkFeatures(): readonly LinkFeatureDeclaration[] {
+    const declarations: LinkFeatureDeclaration[] = [];
+    for (const extension of this.extensions.values()) {
+      for (const feature of extension.linkFeatures?.() ?? []) {
+        declarations.push({ feature, extension: extension.name });
+      }
+    }
+    return declarations;
+  }
+
   runtimeSources(): readonly string[] {
     const sources: string[] = [];
     for (const extension of this.extensions.values()) {

package/src/index.ts

@@ -30,10 +30,11 @@ export {
   numberLiteral,
   booleanLiteral,
 } from "./codegen/values.js";
-export { ExtensionRegistry, createDefaultRegistry, coreExtension, type Extension, type ExtensionModule, type ModuleExport, type ModuleExports, type AssetLoader, type AssetLoadResult } from "./extensions/registry.js";
+export { ExtensionRegistry, createDefaultRegistry, coreExtension, type Extension, type ExtensionModule, type ModuleExport, type ModuleExports, type AssetLoader, type AssetLoadResult, type LinkFeatureDeclaration } from "./extensions/registry.js";
+export type { LinkFeature, ProgramUsage } from "./extensions/link-feature.js";
+export type { LinkFeatureRequest, ResolvedLinkFeature } from "./driver/link-features.js";
 export { bundledExtensions } from "./extensions/catalog.js";
 export { nodeExtension } from "./extensions/node/index.js";
-export { mediaExtension } from "./extensions/media/index.js";
 export type { NodeModule } from "./extensions/node/module.js";
 export {
   NativeExtensionError,

package/dist/src/extensions/media/index.d.ts

@@ -1,28 +0,0 @@
-/**
- * Media extension: `<video>` / `<audio>` decoding for the GUI engine.
- *
- * The GUI extension is deliberately decoder-free: it models media elements,
- * renders their frames and routes the DOM API, but keeps FFmpeg out of `gui.a`
- * so a program that only needs windows and HTML/CSS does not pay for a media
- * stack it never uses. This extension supplies the decoding half:
- *
- *   - `media.a` (`media.lib` with the MSVC ABI on Windows, built by
- *     `npm run media`) contains the FFmpeg-linked player from
- *     `runtime/ext_media/media.cpp` and the static FFmpeg libraries;
- *   - `runtime/ext_media/media_bridge.c` is compiled and linked directly. Its
- *     constructor installs the player table into the GUI engine and references
- *     the backend entry points, which makes the linker extract the archive
- *     member — a static archive whose only entry point is a constructor would
- *     otherwise never be pulled in.
- *
- * There is no importable TypeScript module: the feature is the DOM media
- * surface that the `gui` module already exposes. Enable both extensions:
- *
- *     xbintsc run app.ts --ext gui,media
- *
- * The archive is built for every host platform. On Windows FFmpeg is compiled
- * with the MSVC-targeting clang-cl so its COFF objects and static CRT match
- * `gui.lib`; see `doc/gui/build.md`.
- */
-import type { Extension } from "../registry.js";
-export declare const mediaExtension: Extension;

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

@@ -1,59 +0,0 @@
-/**
- * Media extension: `<video>` / `<audio>` decoding for the GUI engine.
- *
- * The GUI extension is deliberately decoder-free: it models media elements,
- * renders their frames and routes the DOM API, but keeps FFmpeg out of `gui.a`
- * so a program that only needs windows and HTML/CSS does not pay for a media
- * stack it never uses. This extension supplies the decoding half:
- *
- *   - `media.a` (`media.lib` with the MSVC ABI on Windows, built by
- *     `npm run media`) contains the FFmpeg-linked player from
- *     `runtime/ext_media/media.cpp` and the static FFmpeg libraries;
- *   - `runtime/ext_media/media_bridge.c` is compiled and linked directly. Its
- *     constructor installs the player table into the GUI engine and references
- *     the backend entry points, which makes the linker extract the archive
- *     member — a static archive whose only entry point is a constructor would
- *     otherwise never be pulled in.
- *
- * There is no importable TypeScript module: the feature is the DOM media
- * surface that the `gui` module already exposes. Enable both extensions:
- *
- *     xbintsc run app.ts --ext gui,media
- *
- * The archive is built for every host platform. On Windows FFmpeg is compiled
- * with the MSVC-targeting clang-cl so its COFF objects and static CRT match
- * `gui.lib`; see `doc/gui/build.md`.
- */
-import { join } from "node:path";
-import { findRuntimeDir, platformSlug } from "../../driver/paths.js";
-import { findRuntimeLibrary, runtimeLibDir } from "../../driver/runtime-lib.js";
-/** Absolute path to the per-platform prebuilt media archive. */
-function mediaArchive() {
-    return join(runtimeLibDir(), process.platform === "win32" ? "media.lib" : "media.a");
-}
-export const mediaExtension = {
-    name: "media",
-    description: "Video/audio decoding for <video>/<audio> (requires gui, links FFmpeg)",
-    requires: ["gui"],
-    /**
-     * The registration bridge is a tiny C file linked as a normal object, so its
-     * constructor always runs. Keeping it out of `media.a` is what guarantees the
-     * archive is searched (see the header comment).
-     */
-    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"],
-};
-//# sourceMappingURL=index.js.map

package/dist/src/extensions/media/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/extensions/media/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAEhF,gEAAgE;AAChE,SAAS,YAAY;IACnB,OAAO,IAAI,CAAC,aAAa,EAAE,EAAE,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;AACvF,CAAC;AAED,MAAM,CAAC,MAAM,cAAc,GAAc;IACvC,IAAI,EAAE,OAAO;IACb,WAAW,EAAE,uEAAuE;IACpF,QAAQ,EAAE,CAAC,KAAK,CAAC;IACjB;;;;OAIG;IACH,cAAc,EAAE,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,WAAW,EAAE,gBAAgB,CAAC,CAAC;IAC7E,aAAa,EAAE,GAAG,EAAE;QAClB,MAAM,OAAO,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;QAC5C,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CACb,qCAAqC,YAAY,EAAE,4BAA4B;gBAC7E,yBAAyB,YAAY,EAAE,uCAAuC;gBAC9E,qFAAqF,CACxF,CAAC;QACJ,CAAC;QACD,OAAO,CAAC,OAAO,CAAC,CAAC;IACnB,CAAC;IACD;;;mBAGe;IACf,WAAW,EAAE,GAAG,EAAE,CAChB,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;CAC/E,CAAC"}

package/dist/tests/extensions/media.test.js

@@ -1,63 +0,0 @@
-import { afterEach, describe, expect, it, vi } from "vitest";
-const mocks = vi.hoisted(() => ({ findRuntimeLibrary: vi.fn() }));
-/* Keep the archive lookup deterministic so both the success and the
- * "not built yet" branches of `nativeObjects` can be exercised. */
-vi.mock("../../src/driver/runtime-lib.js", () => ({
-    findRuntimeLibrary: mocks.findRuntimeLibrary,
-    runtimeLibDir: () => "/tmp/runtime/lib/darwin-x64",
-}));
-import { bundledExtensions } from "../../src/extensions/catalog.js";
-import { createDefaultRegistry } from "../../src/extensions/registry.js";
-import { guiExtension } from "../../src/extensions/gui/index.js";
-import { mediaExtension } from "../../src/extensions/media/index.js";
-afterEach(() => {
-    vi.restoreAllMocks();
-    mocks.findRuntimeLibrary.mockReset();
-});
-/** Pretend to be a POSIX host, so the archive name in messages is `media.a`. */
-function posixHost() {
-    vi.spyOn(process, "platform", "get").mockReturnValue("darwin");
-}
-describe("media extension object", () => {
-    it("is a separate extension that depends on gui", () => {
-        expect(mediaExtension.name).toBe("media");
-        expect(mediaExtension.description).toMatch(/FFmpeg/);
-        expect(mediaExtension.requires).toEqual(["gui"]);
-        // Media is advertised as a bundled extension, but is not enabled by
-        // enabling `gui`: that separation is the point of the split.
-        expect(bundledExtensions().map((extension) => extension.name)).toContain("media");
-    });
-    it("links the bridge object and the prebuilt archive", () => {
-        posixHost();
-        mocks.findRuntimeLibrary.mockReturnValue("/tmp/media.a");
-        const sources = mediaExtension.runtimeSources?.() ?? [];
-        expect(sources).toHaveLength(1);
-        expect(sources[0]).toMatch(/runtime[\\/]ext_media[\\/]media_bridge\.c$/);
-        expect(mediaExtension.nativeObjects?.()).toEqual(["/tmp/media.a"]);
-        expect(mocks.findRuntimeLibrary).toHaveBeenCalledWith("media");
-    });
-    it("fails with an actionable message when the archive is missing", () => {
-        posixHost();
-        mocks.findRuntimeLibrary.mockReturnValue(undefined);
-        expect(() => mediaExtension.nativeObjects?.()).toThrow(/media native library not found/);
-        expect(() => mediaExtension.nativeObjects?.()).toThrow(/npm run media/);
-    });
-    it("links media.lib and the Win32 system libraries on Windows", () => {
-        vi.spyOn(process, "platform", "get").mockReturnValue("win32");
-        mocks.findRuntimeLibrary.mockReturnValue("C:/repo/runtime/lib/win32-x64/media.lib");
-        expect(mediaExtension.nativeObjects?.()).toEqual(["C:/repo/runtime/lib/win32-x64/media.lib"]);
-        /* FFmpeg's avutil/avcodec reference bcrypt, ole32 and user32; the GUI
-         * extension already contributes the rest. */
-        expect(mediaExtension.linkerFlags?.()).toEqual(["-lbcrypt", "-lole32", "-luser32"]);
-    });
-    it("rejects a build that enables media without gui", () => {
-        const registry = createDefaultRegistry().register(mediaExtension);
-        expect(() => registry.validate()).toThrow(/requires the 'gui' extension/);
-        expect(() => registry.validate()).toThrow(/--ext gui,media/);
-    });
-    it("accepts gui + media together", () => {
-        const registry = createDefaultRegistry().register(guiExtension).register(mediaExtension);
-        expect(() => registry.validate()).not.toThrow();
-    });
-});
-//# sourceMappingURL=media.test.js.map

package/dist/tests/extensions/media.test.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"media.test.js","sourceRoot":"","sources":["../../../tests/extensions/media.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE7D,MAAM,KAAK,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,kBAAkB,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;AAElE;mEACmE;AACnE,EAAE,CAAC,IAAI,CAAC,iCAAiC,EAAE,GAAG,EAAE,CAAC,CAAC;IAChD,kBAAkB,EAAE,KAAK,CAAC,kBAAkB;IAC5C,aAAa,EAAE,GAAG,EAAE,CAAC,6BAA6B;CACnD,CAAC,CAAC,CAAC;AAEJ,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AAErE,SAAS,CAAC,GAAG,EAAE;IACb,EAAE,CAAC,eAAe,EAAE,CAAC;IACrB,KAAK,CAAC,kBAAkB,CAAC,SAAS,EAAE,CAAC;AACvC,CAAC,CAAC,CAAC;AAEH,gFAAgF;AAChF,SAAS,SAAS;IAChB,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;AACjE,CAAC;AAED,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;IACtC,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC1C,MAAM,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACrD,MAAM,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;QACjD,oEAAoE;QACpE,6DAA6D;QAC7D,MAAM,CAAC,iBAAiB,EAAE,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACpF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,SAAS,EAAE,CAAC;QACZ,KAAK,CAAC,kBAAkB,CAAC,eAAe,CAAC,cAAc,CAAC,CAAC;QACzD,MAAM,OAAO,GAAG,cAAc,CAAC,cAAc,EAAE,EAAE,IAAI,EAAE,CAAC;QACxD,MAAM,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAChC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,4CAA4C,CAAC,CAAC;QACzE,MAAM,CAAC,cAAc,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC;QACnE,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC;IACjE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8DAA8D,EAAE,GAAG,EAAE;QACtE,SAAS,EAAE,CAAC;QACZ,KAAK,CAAC,kBAAkB,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;QACpD,MAAM,CAAC,GAAG,EAAE,CAAC,cAAc,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,gCAAgC,CAAC,CAAC;QACzF,MAAM,CAAC,GAAG,EAAE,CAAC,cAAc,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2DAA2D,EAAE,GAAG,EAAE;QACnE,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;QAC9D,KAAK,CAAC,kBAAkB,CAAC,eAAe,CAAC,yCAAyC,CAAC,CAAC;QACpF,MAAM,CAAC,cAAc,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,yCAAyC,CAAC,CAAC,CAAC;QAC9F;qDAC6C;QAC7C,MAAM,CAAC,cAAc,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC;IACtF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACxD,MAAM,QAAQ,GAAG,qBAAqB,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;QAClE,MAAM,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC,OAAO,CAAC,8BAA8B,CAAC,CAAC;QAC1E,MAAM,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,QAAQ,GAAG,qBAAqB,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;QACzF,MAAM,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IAClD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/src/extensions/media/index.ts

@@ -1,65 +0,0 @@
-/**
- * Media extension: `<video>` / `<audio>` decoding for the GUI engine.
- *
- * The GUI extension is deliberately decoder-free: it models media elements,
- * renders their frames and routes the DOM API, but keeps FFmpeg out of `gui.a`
- * so a program that only needs windows and HTML/CSS does not pay for a media
- * stack it never uses. This extension supplies the decoding half:
- *
- *   - `media.a` (`media.lib` with the MSVC ABI on Windows, built by
- *     `npm run media`) contains the FFmpeg-linked player from
- *     `runtime/ext_media/media.cpp` and the static FFmpeg libraries;
- *   - `runtime/ext_media/media_bridge.c` is compiled and linked directly. Its
- *     constructor installs the player table into the GUI engine and references
- *     the backend entry points, which makes the linker extract the archive
- *     member — a static archive whose only entry point is a constructor would
- *     otherwise never be pulled in.
- *
- * There is no importable TypeScript module: the feature is the DOM media
- * surface that the `gui` module already exposes. Enable both extensions:
- *
- *     xbintsc run app.ts --ext gui,media
- *
- * The archive is built for every host platform. On Windows FFmpeg is compiled
- * with the MSVC-targeting clang-cl so its COFF objects and static CRT match
- * `gui.lib`; see `doc/gui/build.md`.
- */
-
-import { join } from "node:path";
-import type { Extension } from "../registry.js";
-import { findRuntimeDir, platformSlug } from "../../driver/paths.js";
-import { findRuntimeLibrary, runtimeLibDir } from "../../driver/runtime-lib.js";
-
-/** Absolute path to the per-platform prebuilt media archive. */
-function mediaArchive(): string {
-  return join(runtimeLibDir(), process.platform === "win32" ? "media.lib" : "media.a");
-}
-
-export const mediaExtension: Extension = {
-  name: "media",
-  description: "Video/audio decoding for <video>/<audio> (requires gui, links FFmpeg)",
-  requires: ["gui"],
-  /**
-   * The registration bridge is a tiny C file linked as a normal object, so its
-   * constructor always runs. Keeping it out of `media.a` is what guarantees the
-   * archive is searched (see the header comment).
-   */
-  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"],
-};