@visual-z/xeno 0.1.3 → 0.2.0

package/src/vendor/pi-tui/native/linux/src/linux-platform-x11.c

@@ -0,0 +1,274 @@
+#include <xcb/xcb.h>
+#include <string.h>
+#include <xcb/xcbext.h>
+#include <errno.h>
+#include <poll.h>
+#include <time.h>
+#include "clipboard-worker.h"
+
+#define MAX_CLIPBOARD_BYTES (50u * 1024u * 1024u)
+#define CLIPBOARD_TIMEOUT_MS 2000
+
+static const char* const text_types[] = {
+    "text/plain;charset=utf-8", "text/plain;charset=UTF-8", "UTF8_STRING", "text/plain", "STRING",
+};
+static const char* const image_types[] = {
+    "image/png", "image/jpeg", "image/webp", "image/gif", "image/bmp", "image/tiff",
+};
+
+static int64_t monotonic_ms(void) {
+    struct timespec now;
+    clock_gettime(CLOCK_MONOTONIC, &now);
+    return (int64_t)now.tv_sec * 1000 + now.tv_nsec / 1000000;
+}
+
+typedef struct {
+    unsigned char* data;
+    size_t length;
+    uint32_t items;
+    uint8_t format;
+    xcb_atom_t type;
+} property_data;
+
+typedef struct {
+    xcb_connection_t* connection;
+    xcb_window_t window;
+    xcb_atom_t clipboard;
+    xcb_atom_t property;
+    xcb_atom_t targets;
+    xcb_atom_t incr;
+    int64_t deadline;
+} x11_clipboard;
+
+static bool append_bytes(property_data* result, const unsigned char* bytes, size_t length) {
+    if (length > MAX_CLIPBOARD_BYTES - result->length) return false;
+    unsigned char* data = realloc(result->data, result->length + length + 1);
+    if (!data) return false;
+    memcpy(data + result->length, bytes, length);
+    result->length += length;
+    data[result->length] = 0;
+    result->data = data;
+    return true;
+}
+
+// Share one deadline across discovery, replies, and incremental chunks.
+// Connection setup and flushing are libxcb calls on the private thread.
+static bool wait_for_input(x11_clipboard* clipboard) {
+    for (;;) {
+        int64_t remaining = clipboard->deadline - monotonic_ms();
+        if (remaining <= 0 || xcb_connection_has_error(clipboard->connection)) return false;
+        struct pollfd descriptor = {xcb_get_file_descriptor(clipboard->connection), POLLIN, 0};
+        int ready = poll(&descriptor, 1, (int)remaining);
+        if (ready >= 0) return ready && (descriptor.revents & POLLIN);
+        if (errno != EINTR) return false;
+    }
+}
+
+static void* wait_for_reply(x11_clipboard* clipboard, unsigned sequence) {
+    if (xcb_flush(clipboard->connection) <= 0) return 0;
+    while (monotonic_ms() < clipboard->deadline) {
+        void* reply = 0;
+        xcb_generic_error_t* error = 0;
+        if (xcb_poll_for_reply(clipboard->connection, sequence, &reply, &error)) {
+            free(error);
+            return reply;
+        }
+        if (!wait_for_input(clipboard)) break;
+    }
+    xcb_discard_reply(clipboard->connection, sequence);
+    return 0;
+}
+
+static xcb_generic_event_t* wait_for_event(x11_clipboard* clipboard, uint8_t type) {
+    if (xcb_flush(clipboard->connection) <= 0) return 0;
+    while (monotonic_ms() < clipboard->deadline) {
+        xcb_generic_event_t* event = xcb_poll_for_event(clipboard->connection);
+        if (event) {
+            if ((event->response_type & 0x7f) == type) return event;
+            free(event);
+        } else if (!wait_for_input(clipboard)) {
+            break;
+        }
+    }
+    return 0;
+}
+
+static bool read_property(x11_clipboard* clipboard, bool remove, property_data* result) {
+    xcb_get_property_cookie_t cookie = xcb_get_property(
+        clipboard->connection, remove, clipboard->window, clipboard->property,
+        XCB_GET_PROPERTY_TYPE_ANY, 0, MAX_CLIPBOARD_BYTES / 4
+    );
+    xcb_get_property_reply_t* reply = wait_for_reply(clipboard, cookie.sequence);
+    if (!reply) return false;
+    bool copied = false;
+    bool valid_format = reply->format == 8 || reply->format == 16 || reply->format == 32;
+    uint64_t length = (uint64_t)reply->value_len * (reply->format / 8);
+    if (reply->bytes_after == 0 && reply->type != XCB_NONE && valid_format &&
+        length <= MAX_CLIPBOARD_BYTES && length <= (uint64_t)reply->length * 4) {
+        result->type = reply->type;
+        result->format = reply->format;
+        result->items = reply->value_len;
+        copied = append_bytes(result, xcb_get_property_value(reply), (size_t)length);
+    }
+    free(reply);
+    return copied;
+}
+
+static bool append_property(property_data* result, const property_data* chunk) {
+    if ((chunk->format != 8 && chunk->format != 16 && chunk->format != 32) ||
+        chunk->type == XCB_NONE ||
+        (uint64_t)chunk->items * (chunk->format / 8) != chunk->length ||
+        (result->type != XCB_NONE && (result->type != chunk->type || result->format != chunk->format)) ||
+        chunk->items > UINT32_MAX - result->items) return false;
+    if (!append_bytes(result, chunk->data, chunk->length)) return false;
+    result->type = chunk->type;
+    result->format = chunk->format;
+    result->items += chunk->items;
+    return true;
+}
+
+static bool request_selection(x11_clipboard* clipboard, xcb_atom_t target, property_data* result) {
+    memset(result, 0, sizeof(*result));
+    xcb_delete_property(clipboard->connection, clipboard->window, clipboard->property);
+    xcb_convert_selection(
+        clipboard->connection, clipboard->window, clipboard->clipboard,
+        target, clipboard->property, XCB_CURRENT_TIME
+    );
+
+    while (true) {
+        xcb_selection_notify_event_t* event = (xcb_selection_notify_event_t*)wait_for_event(clipboard, XCB_SELECTION_NOTIFY);
+        if (!event) return false;
+        bool matches = event->selection == clipboard->clipboard && event->target == target;
+        bool received = event->property != XCB_NONE;
+        free(event);
+        if (!matches) continue;
+        if (!received) return true; // No owner, or the owner does not offer this target.
+        if (!read_property(clipboard, false, result)) return false;
+        break;
+    }
+    if (result->type != clipboard->incr) return true;
+
+    free(result->data);
+    memset(result, 0, sizeof(*result));
+    xcb_delete_property(clipboard->connection, clipboard->window, clipboard->property);
+
+    while (true) {
+        xcb_property_notify_event_t* event = (xcb_property_notify_event_t*)wait_for_event(clipboard, XCB_PROPERTY_NOTIFY);
+        if (!event) return false;
+        bool matches = event->atom == clipboard->property && event->state == XCB_PROPERTY_NEW_VALUE;
+        free(event);
+        if (!matches) continue;
+
+        property_data chunk = {0};
+        if (!read_property(clipboard, true, &chunk)) return false;
+        bool appended = append_property(result, &chunk);
+        bool finished = chunk.items == 0;
+        free(chunk.data);
+        if (!appended) return false;
+        if (finished) return true;
+    }
+}
+
+static xcb_atom_t intern_atom(x11_clipboard* clipboard, const char* name) {
+    xcb_intern_atom_cookie_t cookie = xcb_intern_atom(clipboard->connection, false, strlen(name), name);
+    xcb_intern_atom_reply_t* reply = wait_for_reply(clipboard, cookie.sequence);
+    if (!reply) return XCB_NONE;
+    xcb_atom_t atom = reply->atom;
+    free(reply);
+    return atom;
+}
+
+static bool open_clipboard(x11_clipboard* clipboard) {
+    memset(clipboard, 0, sizeof(*clipboard));
+    clipboard->deadline = monotonic_ms() + CLIPBOARD_TIMEOUT_MS;
+    int screen_number = 0;
+    clipboard->connection = xcb_connect(0, &screen_number);
+    if (xcb_connection_has_error(clipboard->connection)) return false;
+    xcb_screen_iterator_t screens = xcb_setup_roots_iterator(xcb_get_setup(clipboard->connection));
+    while (screen_number-- > 0 && screens.rem) xcb_screen_next(&screens);
+    if (!screens.rem) return false;
+
+    clipboard->window = xcb_generate_id(clipboard->connection);
+    uint32_t mask = XCB_EVENT_MASK_PROPERTY_CHANGE;
+    xcb_create_window(
+        clipboard->connection, XCB_COPY_FROM_PARENT, clipboard->window,
+        screens.data->root, 0, 0, 1, 1, 0, XCB_WINDOW_CLASS_INPUT_OUTPUT,
+        XCB_COPY_FROM_PARENT, XCB_CW_EVENT_MASK, &mask
+    );
+    clipboard->clipboard = intern_atom(clipboard, "CLIPBOARD");
+    clipboard->property = intern_atom(clipboard, "PI_CLIPBOARD");
+    clipboard->targets = intern_atom(clipboard, "TARGETS");
+    clipboard->incr = intern_atom(clipboard, "INCR");
+    return clipboard->clipboard && clipboard->property && clipboard->targets && clipboard->incr;
+}
+
+static void close_clipboard(x11_clipboard* clipboard) {
+    if (clipboard->connection) xcb_disconnect(clipboard->connection);
+}
+
+static bool preferred_target(x11_clipboard* clipboard, bool image, xcb_atom_t* target) {
+    const char* const* types = image ? image_types : text_types;
+    size_t type_count = image ? 6 : 5;
+    xcb_atom_t wanted[6];
+    for (size_t index = 0; index < type_count; index++) {
+        wanted[index] = intern_atom(clipboard, types[index]);
+        if (wanted[index] == XCB_NONE) return false;
+    }
+
+    property_data targets = {0};
+    bool received = request_selection(clipboard, clipboard->targets, &targets);
+    bool valid = targets.type == XCB_ATOM_ATOM && targets.format == 32 &&
+        targets.items == targets.length / sizeof(xcb_atom_t) && targets.length % sizeof(xcb_atom_t) == 0;
+    if (received && valid) {
+        xcb_atom_t* offered = (xcb_atom_t*)targets.data;
+        for (size_t wanted_index = 0; wanted_index < type_count; wanted_index++) {
+            for (uint32_t offered_index = 0; offered_index < targets.items; offered_index++) {
+                if (offered[offered_index] == wanted[wanted_index]) {
+                    free(targets.data);
+                    *target = wanted[wanted_index];
+                    return true;
+                }
+            }
+        }
+    }
+    free(targets.data);
+    // Some owners refuse TARGETS but still serve text directly.
+    if (received && !image && targets.type == XCB_NONE) {
+        *target = intern_atom(clipboard, "UTF8_STRING");
+        return *target != XCB_NONE;
+    }
+    return received && (valid || targets.type == XCB_NONE);
+}
+
+static bool read_selection(x11_clipboard* clipboard, bool image, property_data* result) {
+    xcb_atom_t target = XCB_NONE;
+    bool received = preferred_target(clipboard, image, &target) &&
+        (target == XCB_NONE || request_selection(clipboard, target, result));
+    if (!received) {
+        free(result->data);
+        memset(result, 0, sizeof(*result));
+    }
+    return received;
+}
+
+static void read_clipboard(clipboard_job* job) {
+    x11_clipboard clipboard;
+    if (open_clipboard(&clipboard)) {
+        property_data contents = {0};
+        if (!read_selection(&clipboard, job->operation == CLIPBOARD_IMAGE, &contents)) {
+            job->error = "Could not read X11 clipboard";
+        } else {
+            job->data = contents.data;
+            job->length = contents.length;
+            job->format = !contents.data ? CLIPBOARD_EMPTY : job->operation == CLIPBOARD_IMAGE
+                ? CLIPBOARD_BUFFER : contents.type == XCB_ATOM_STRING ? CLIPBOARD_LATIN1 : CLIPBOARD_UTF8;
+        }
+    }
+    close_clipboard(&clipboard);
+}
+
+PI_NAPI_EXPORT napi_value napi_register_module_v1(napi_env env, napi_value exports) {
+    set_function_export(env, exports, "getText", get_clipboard_text);
+    set_function_export(env, exports, "getImage", get_clipboard_image);
+    return exports;
+}

package/src/vendor/pi-tui/native/napi.h

@@ -0,0 +1,91 @@
+#ifndef PI_NAPI_H
+#define PI_NAPI_H
+
+// Resolve the small N-API surface we use from Node or Bun, without Node headers
+// or a link-time dependency on a particular runtime.
+#include <stdbool.h>
+#include <stddef.h>
+#include <stdint.h>
+#ifdef _WIN32
+#include <windows.h>
+#define PI_NAPI_CALL __cdecl
+#define PI_NAPI_EXPORT __declspec(dllexport)
+#else
+#include <dlfcn.h>
+#define PI_NAPI_CALL
+#define PI_NAPI_EXPORT __attribute__((visibility("default")))
+#endif
+
+#define NAPI_AUTO_LENGTH ((size_t)-1)
+
+typedef void* napi_env;
+typedef void* napi_value;
+typedef void* napi_callback_info;
+typedef void* napi_async_work;
+typedef void* napi_deferred;
+typedef void (PI_NAPI_CALL *napi_async_execute_callback)(napi_env, void*);
+typedef void (PI_NAPI_CALL *napi_async_complete_callback)(napi_env, int, void*);
+typedef int (PI_NAPI_CALL *napi_create_async_work_fn)(napi_env, napi_value, napi_value, napi_async_execute_callback, napi_async_complete_callback, void*, napi_async_work*);
+typedef int (PI_NAPI_CALL *napi_create_array_fn)(napi_env, napi_value*);
+typedef int (PI_NAPI_CALL *napi_async_work_fn)(napi_env, napi_async_work);
+typedef int (PI_NAPI_CALL *napi_create_promise_fn)(napi_env, napi_deferred*, napi_value*);
+typedef int (PI_NAPI_CALL *napi_settle_deferred_fn)(napi_env, napi_deferred, napi_value);
+typedef int (PI_NAPI_CALL *napi_create_error_fn)(napi_env, napi_value, napi_value, napi_value*);
+typedef napi_value (PI_NAPI_CALL *napi_callback)(napi_env, napi_callback_info);
+typedef int (PI_NAPI_CALL *napi_create_buffer_copy_fn)(napi_env, size_t, const void*, void**, napi_value*);
+typedef int (PI_NAPI_CALL *napi_create_function_fn)(napi_env, const char*, size_t, napi_callback, void*, napi_value*);
+typedef int (PI_NAPI_CALL *napi_create_string_utf8_fn)(napi_env, const char*, size_t, napi_value*);
+typedef int (PI_NAPI_CALL *napi_create_string_utf16_fn)(napi_env, const uint16_t*, size_t, napi_value*);
+typedef int (PI_NAPI_CALL *napi_get_boolean_fn)(napi_env, bool, napi_value*);
+typedef int (PI_NAPI_CALL *napi_get_cb_info_fn)(napi_env, napi_callback_info, size_t*, napi_value*, napi_value*, void**);
+typedef int (PI_NAPI_CALL *napi_get_value_fn)(napi_env, napi_value*);
+typedef int (PI_NAPI_CALL *napi_get_value_string_utf8_fn)(napi_env, napi_value, char*, size_t, size_t*);
+typedef int (PI_NAPI_CALL *napi_get_value_string_utf16_fn)(napi_env, napi_value, uint16_t*, size_t, size_t*);
+typedef int (PI_NAPI_CALL *napi_set_named_property_fn)(napi_env, napi_value, const char*, napi_value);
+typedef int (PI_NAPI_CALL *napi_set_element_fn)(napi_env, napi_value, uint32_t, napi_value);
+typedef int (PI_NAPI_CALL *napi_throw_error_fn)(napi_env, const char*, const char*);
+
+static void* node_symbol(const char* name) {
+#ifdef _WIN32
+    HMODULE module = GetModuleHandleA(0);
+    void* proc = module ? (void*)GetProcAddress(module, name) : 0;
+    if (proc) return proc;
+    module = GetModuleHandleA("node.dll");
+    return module ? (void*)GetProcAddress(module, name) : 0;
+#else
+    return dlsym(RTLD_DEFAULT, name);
+#endif
+}
+
+static napi_value undefined_value(napi_env env) {
+    napi_get_value_fn get_value = (napi_get_value_fn)node_symbol("napi_get_undefined");
+    napi_value result = 0;
+    if (get_value) get_value(env, &result);
+    return result;
+}
+
+static napi_value null_value(napi_env env) {
+    napi_get_value_fn get_value = (napi_get_value_fn)node_symbol("napi_get_null");
+    napi_value result = 0;
+    if (get_value) get_value(env, &result);
+    return result;
+}
+
+static napi_value fail(napi_env env, const char* message) {
+    napi_throw_error_fn napi_throw_error = (napi_throw_error_fn)node_symbol("napi_throw_error");
+    if (napi_throw_error) napi_throw_error(env, 0, message);
+    return undefined_value(env);
+}
+
+static void set_function_export(napi_env env, napi_value exports, const char* name, napi_callback callback) {
+    napi_create_function_fn napi_create_function = (napi_create_function_fn)node_symbol("napi_create_function");
+    napi_set_named_property_fn napi_set_named_property =
+        (napi_set_named_property_fn)node_symbol("napi_set_named_property");
+    napi_value fn = 0;
+    if (napi_create_function && napi_set_named_property &&
+        napi_create_function(env, name, NAPI_AUTO_LENGTH, callback, 0, &fn) == 0) {
+        napi_set_named_property(env, exports, name, fn);
+    }
+}
+
+#endif

package/src/vendor/pi-tui/native/win32/README.md

@@ -0,0 +1,31 @@
+# Windows native prebuilds
+
+Provides console input setup, modifier-key state, and asynchronous text/image clipboard access. Links to `kernel32` and `user32`; no Node headers are required.
+
+## Building
+
+On Windows, install Visual Studio's "Desktop development with C++" workload, then run from the repository root to build x64 and arm64:
+
+```sh
+npm --prefix packages/tui run build:native:win32
+```
+
+For cross-builds or custom toolchains, provide MinGW-compatible compilers:
+
+```sh
+PI_TUI_WIN32_TOOLCHAIN=mingw \
+CC_X64=/path/to/x86_64-w64-mingw32-gcc \
+CC_ARM64=/path/to/aarch64-w64-mingw32-gcc \
+npm --prefix packages/tui run build:native:win32
+```
+
+## Testing clipboard writes
+
+On a Windows test desktop, run from `packages/tui` in PowerShell:
+
+```powershell
+$env:PI_TEST_NATIVE_CLIPBOARD = "1"
+node --test test/native-platform.test.ts
+```
+
+This opt-in test checks native text writes and reads. **It replaces the system clipboard contents.**

package/src/vendor/pi-tui/native/win32/build.mjs

@@ -0,0 +1,232 @@
+import { spawnSync } from "node:child_process";
+import { chmodSync, copyFileSync, existsSync, mkdirSync, mkdtempSync, rmSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import * as path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const scriptDir = path.dirname(fileURLToPath(import.meta.url));
+const sourceFile = path.join(scriptDir, "src", "win32-platform.c");
+const temporaryDir = mkdtempSync(path.join(tmpdir(), "pi-tui-win32-"));
+
+const targets = [
+	{
+		arch: "x64",
+		msvcArch: "x64",
+		mingwTarget: "x86_64-w64-windows-gnu",
+		prefixedCompilers: ["x86_64-w64-mingw32-gcc", "x86_64-w64-mingw32-clang"],
+		envCompiler: "CC_X64",
+	},
+	{
+		arch: "arm64",
+		msvcArch: "arm64",
+		mingwTarget: "aarch64-w64-windows-gnu",
+		prefixedCompilers: ["aarch64-w64-mingw32-gcc", "aarch64-w64-mingw32-clang"],
+		envCompiler: "CC_ARM64",
+	},
+];
+
+function removeTemporaryDir() {
+	rmSync(temporaryDir, { recursive: true, force: true, maxRetries: 5, retryDelay: 100 });
+}
+
+process.on("exit", removeTemporaryDir);
+process.on("SIGINT", () => {
+	removeTemporaryDir();
+	process.exit(130);
+});
+
+function commandExists(command) {
+	const result = spawnSync(command, ["--version"], { stdio: "ignore" });
+	return !result.error || result.error.code !== "ENOENT";
+}
+
+function run(command, args, options = {}) {
+	const result = spawnSync(command, args, { stdio: "inherit", ...options });
+	if (result.error) throw result.error;
+	if (result.status !== 0) throw new Error(`${command} failed with exit code ${result.status ?? 1}`);
+}
+
+function quoteBatch(value) {
+	return `"${value.replaceAll('"', '""')}"`;
+}
+
+function msvcHostArch() {
+	return process.arch === "arm64" ? "arm64" : "x64";
+}
+
+function findVisualStudioDevCmd() {
+	const candidates = [];
+	const programFilesX86 = process.env["ProgramFiles(x86)"];
+	if (programFilesX86) {
+		const vswhere = path.join(programFilesX86, "Microsoft Visual Studio", "Installer", "vswhere.exe");
+		if (existsSync(vswhere)) {
+			const result = spawnSync(
+				vswhere,
+				[
+					"-latest",
+					"-products",
+					"*",
+					"-requires",
+					"Microsoft.VisualStudio.Component.VC.Tools.x86.x64",
+					"-property",
+					"installationPath",
+				],
+				{ encoding: "utf8" },
+			);
+			for (const line of result.stdout.split(/\r?\n/)) {
+				const installationPath = line.trim();
+				if (installationPath) candidates.push(path.join(installationPath, "Common7", "Tools", "VsDevCmd.bat"));
+			}
+		}
+	}
+
+	for (const base of [process.env.ProgramFiles, programFilesX86]) {
+		if (!base) continue;
+		for (const edition of ["BuildTools", "Community", "Professional", "Enterprise"]) {
+			candidates.push(path.join(base, "Microsoft Visual Studio", "2022", edition, "Common7", "Tools", "VsDevCmd.bat"));
+		}
+	}
+
+	return candidates.find((candidate) => existsSync(candidate));
+}
+
+function canUseMsvc(vsDevCmd) {
+	const probeDir = path.join(temporaryDir, "msvc-probe");
+	mkdirSync(probeDir, { recursive: true });
+	const batchFile = path.join(probeDir, "probe.cmd");
+	writeFileSync(
+		batchFile,
+		[
+			"@echo off",
+			`call ${quoteBatch(vsDevCmd)} -no_logo -arch=x64 -host_arch=${msvcHostArch()} >nul`,
+			"if errorlevel 1 exit /b %errorlevel%",
+			"where cl.exe >nul 2>nul",
+		].join("\r\n"),
+	);
+	const result = spawnSync("cmd.exe", ["/d", "/s", "/c", batchFile], { cwd: probeDir, stdio: "ignore" });
+	return !result.error && result.status === 0;
+}
+
+function resolveMingwCompiler(target) {
+	const envCompiler = process.env[target.envCompiler];
+	if (envCompiler) return { command: envCompiler, useTargetFlag: false };
+	if (process.env.CC) return { command: process.env.CC, useTargetFlag: true };
+	for (const command of target.prefixedCompilers) {
+		if (commandExists(command)) return { command, useTargetFlag: false };
+	}
+	if (commandExists("clang")) return { command: "clang", useTargetFlag: true };
+	return undefined;
+}
+
+function installOutput(temporaryOutput, target) {
+	const outputDir = path.join(scriptDir, "prebuilds", `win32-${target.arch}`);
+	mkdirSync(outputDir, { recursive: true });
+	const output = path.join(outputDir, "win32-platform.node");
+	copyFileSync(temporaryOutput, output);
+	chmodSync(output, 0o755);
+	console.log(`Built ${path.relative(process.cwd(), output)}`);
+}
+
+function buildWithMsvc(target, vsDevCmd) {
+	const buildDir = path.join(temporaryDir, `msvc-${target.arch}`);
+	const temporaryOutput = path.join(buildDir, "win32-platform.node");
+	mkdirSync(buildDir, { recursive: true });
+
+	const batchFile = path.join(buildDir, "build.cmd");
+	writeFileSync(
+		batchFile,
+		[
+			"@echo off",
+			`call ${quoteBatch(vsDevCmd)} -no_logo -arch=${target.msvcArch} -host_arch=${msvcHostArch()}`,
+			"if errorlevel 1 exit /b %errorlevel%",
+			[
+				"cl",
+				"/nologo",
+				"/TC",
+				"/std:c11",
+				"/W4",
+				"/O1",
+				"/GS-",
+				"/LD",
+				`/Fe:${quoteBatch(temporaryOutput)}`,
+				quoteBatch(sourceFile),
+				"/link",
+				"/NOENTRY",
+				"/NODEFAULTLIB",
+				"kernel32.lib",
+				"user32.lib",
+				"/OPT:REF",
+				"/OPT:ICF",
+			].join(" "),
+			"if errorlevel 1 exit /b %errorlevel%",
+		].join("\r\n"),
+	);
+
+	run("cmd.exe", ["/d", "/s", "/c", batchFile], { cwd: buildDir });
+	installOutput(temporaryOutput, target);
+}
+
+function buildWithMingw(target) {
+	const compiler = resolveMingwCompiler(target);
+	if (!compiler) {
+		throw new Error(
+			`No Windows cross-compiler found for ${target.arch}. Install Microsoft C++ Build Tools on Windows, or set ${target.envCompiler} to a MinGW-compatible compiler.`,
+		);
+	}
+
+	const buildDir = path.join(temporaryDir, `mingw-${target.arch}`);
+	const temporaryOutput = path.join(buildDir, "win32-platform.node");
+	mkdirSync(buildDir, { recursive: true });
+
+	const args = [
+		...(compiler.useTargetFlag ? [`--target=${target.mingwTarget}`] : []),
+		"-std=c11",
+		"-Wall",
+		"-Wextra",
+		"-Oz",
+		"-fno-builtin",
+		"-shared",
+		"-nostdlib",
+		"-Wl,--no-entry",
+		"-Wl,--strip-all",
+		sourceFile,
+		"-lkernel32",
+		"-luser32",
+		"-o",
+		temporaryOutput,
+	];
+
+	run(compiler.command, args, { cwd: buildDir });
+	installOutput(temporaryOutput, target);
+}
+
+if (process.argv.includes("--help") || process.argv.includes("-h")) {
+	console.log(`Usage: npm --prefix packages/tui run build:native:win32
+
+Builds win32-x64 and win32-arm64 native prebuilds.
+
+Environment:
+  PI_TUI_WIN32_TOOLCHAIN=msvc|mingw
+  CC_X64=/path/to/x86_64-w64-mingw32-gcc
+  CC_ARM64=/path/to/aarch64-w64-mingw32-gcc
+  CC=/path/to/clang`);
+	process.exit(0);
+}
+
+const requestedToolchain = process.env.PI_TUI_WIN32_TOOLCHAIN;
+if (requestedToolchain && requestedToolchain !== "msvc" && requestedToolchain !== "mingw") {
+	throw new Error("PI_TUI_WIN32_TOOLCHAIN must be either 'msvc' or 'mingw'");
+}
+
+const vsDevCmd = findVisualStudioDevCmd();
+const hasMsvc = vsDevCmd ? canUseMsvc(vsDevCmd) : false;
+const toolchain = requestedToolchain ?? (process.platform === "win32" && vsDevCmd ? "msvc" : "mingw");
+
+if (toolchain === "msvc") {
+	if (!vsDevCmd || !hasMsvc) {
+		throw new Error("Microsoft C++ Build Tools not found. Install the Visual Studio C++ workload or set PI_TUI_WIN32_TOOLCHAIN=mingw.");
+	}
+	for (const target of targets) buildWithMsvc(target, vsDevCmd);
+} else {
+	for (const target of targets) buildWithMingw(target);
+}