xbintsc 0.3.15 → 0.3.16

package/src/extensions/catalog.ts

@@ -12,8 +12,9 @@
 
 import type { Extension } from "./registry.js";
 import { nodeExtension } from "./node/index.js";
+import { guiExtension } from "./gui/index.js";
 
 /** Every extension bundled with xbintsc, in registration order. */
 export function bundledExtensions(): readonly Extension[] {
-  return [nodeExtension];
+  return [nodeExtension, guiExtension];
 }

package/src/extensions/gui/index.ts

@@ -0,0 +1,107 @@
+/**
+ * GUI extension: a self-contained, GPU-accelerated HTML/CSS renderer.
+ *
+ * Unlike the system-WebView approach, this extension ships its *own* rendering
+ * engine (HTML parser, CSS cascade, layout, GPU compositor) written in C/C++.
+ * It is therefore delivered as a per-platform prebuilt archive — the same way
+ * the core runtime ships `runtime/lib/<os>-<arch>/core.a` — and linked through
+ * `nativeObjects`. The core compiler stays platform-agnostic and never learns
+ * that "gui" exists beyond the module bindings below.
+ *
+ * Design and roadmap live in `doc/gui.md`. The C++/GPU sources are not built
+ * yet: `nativeObjects()` fails with an actionable message until
+ * `runtime/lib/<os>-<arch>/gui.a` exists.
+ *
+ * TypeScript sees one importable module:
+ *
+ *     import { createWindow, run } from "gui";
+ *
+ * Window instances are runtime objects whose methods are dispatched in C
+ * (through the existing `xt_call_method` object model); the registry only
+ * needs to bind the top-level functions.
+ */
+
+import { join } from "node:path";
+import type { Extension, ExtensionModule } from "../registry.js";
+import { findRuntimeDir, platformSlug } from "../../driver/paths.js";
+import { findRuntimeLibrary } from "../../driver/runtime-lib.js";
+
+/** Top-level `gui` module bindings. */
+const guiModule: ExtensionModule = {
+  namespace: "gui",
+  exports: {
+    createWindow: { symbol: "xt_gui_create_window" },
+    run: { symbol: "xt_gui_run" },
+    quit: { symbol: "xt_gui_quit" },
+    /** Window handles are opaque runtime objects created by `createWindow`. */
+  },
+};
+
+/** Absolute path to the per-platform prebuilt GUI archive (`gui.a`, or
+ * `gui.lib` with the MSVC ABI on Windows). */
+function guiArchive(): string {
+  return join(findRuntimeDir(), "lib", platformSlug(), "gui.a");
+}
+
+export const guiExtension: Extension = {
+  name: "gui",
+  description: "GPU-accelerated HTML/CSS GUI (self-hosted renderer, no webview)",
+  nativeObjects: () => {
+    const archive = findRuntimeLibrary("gui");
+    if (archive === undefined) {
+      throw new Error(
+        `GUI native library not found at ${guiArchive()} (or gui.lib).\n` +
+          `Build it for ${platformSlug()} first (see doc/gui.md).`,
+      );
+    }
+    return [archive];
+  },
+  /**
+   * 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).
+   */
+  linkerFlags: () => {
+    if (process.platform === "darwin") {
+      return [
+        "-framework", "CoreMedia",
+        "-framework", "CoreVideo",
+        "-framework", "Cocoa",
+        "-weak_framework", "UniformTypeIdentifiers",
+        "-framework", "IOKit",
+        "-framework", "ForceFeedback",
+        "-framework", "Carbon",
+        "-framework", "CoreAudio",
+        "-framework", "AudioToolbox",
+        "-framework", "AVFoundation",
+        "-framework", "Foundation",
+        "-framework", "GameController",
+        "-framework", "Metal",
+        "-framework", "QuartzCore",
+        /* HarfBuzz's CoreText shaper (macOS system fonts). */
+        "-framework", "CoreText",
+        "-framework", "CoreGraphics",
+        "-framework", "CoreFoundation",
+        "-weak_framework", "CoreHaptics",
+        "-lpthread",
+        "-lm",
+        "-lc++",
+      ];
+    }
+    if (process.platform === "win32") {
+      return [
+        /* SDL_GPU D3D12 backend. */
+        "-ld3d12", "-ldxgi", "-ldxguid",
+        /* Win32 / COM / multimedia services SDL3 uses. */
+        "-luser32", "-lgdi32", "-lshell32",
+        "-lole32", "-loleaut32", "-luuid", "-ladvapi32",
+        "-lwinmm", "-limm32", "-lversion", "-lsetupapi",
+        /* The engine is C++; link the MSVC C++ runtime. */
+        "-lmsvcprt",
+      ];
+    }
+    return ["-lX11", "-lwayland-client", "-lEGL", "-lGL", "-ldl", "-lpthread", "-lstdc++"];
+  },
+  modules: () => ({ gui: guiModule }),
+};

package/dist/tests/e2e/compile.test.d.ts

@@ -1,8 +0,0 @@
-/**
- * End-to-end tests: compile TypeScript all the way to a native binary and run
- * it. Each program is compiled and executed through the shared
- * {@link describeE2E} harness, so the suite is skipped when no
- * clang-compatible compiler is available. Node extension coverage lives in
- * `compile-node.test.ts`.
- */
-export {};