@code-yeongyu/senpi-tui 2026.9.12-3 → 2026.9.12

package/native/win32/README.md

@@ -1,16 +1,16 @@
 # 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:
+Build both Windows architectures from the repository root:
 
 ```sh
 bun run --cwd packages/tui build:native:win32
 ```
 
-For cross-builds or custom toolchains, provide MinGW-compatible compilers:
+On Windows, the build uses the Microsoft C++ Build Tools from Visual Studio. `build.mjs` locates `VsDevCmd.bat`, initializes a developer environment for `amd64` and `arm64`, and builds the addon with `cl.exe`/`link.exe`.
+
+Install the "Desktop development with C++" workload, or at minimum the MSVC toolset and Windows SDK components. No Node headers are required; the addon resolves N-API symbols from the host process.
+
+For non-Windows cross-builds, or for custom Windows toolchains, set `PI_TUI_WIN32_TOOLCHAIN=mingw` and provide MinGW-compatible compilers:
 
 ```sh
 PI_TUI_WIN32_TOOLCHAIN=mingw \
@@ -19,15 +19,4 @@ CC_ARM64=/path/to/aarch64-w64-mingw32-gcc \
 bun run --cwd packages/tui 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.**
-
-The opt-in clipboard test only runs on a real Windows desktop session. Cross-builds from macOS or Linux hosts produce the addon but cannot exercise it, and the `windows-latest` runners in `.github/workflows/native-prebuilds.yml` build the prebuilds without running this clipboard test. Treat Windows clipboard behavior as verified only when someone has run the test above on Windows.
+The addon intentionally avoids the C runtime and links only against `kernel32`.

package/native/win32/build.mjs

@@ -5,7 +5,7 @@ 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 sourceFile = path.join(scriptDir, "src", "win32-console-mode.c");
 const temporaryDir = mkdtempSync(path.join(tmpdir(), "pi-tui-win32-"));
 
 const targets = [
@@ -121,7 +121,7 @@ function resolveMingwCompiler(target) {
 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");
+	const output = path.join(outputDir, "win32-console-mode.node");
 	copyFileSync(temporaryOutput, output);
 	chmodSync(output, 0o755);
 	console.log(`Built ${path.relative(process.cwd(), output)}`);
@@ -129,7 +129,7 @@ function installOutput(temporaryOutput, target) {
 
 function buildWithMsvc(target, vsDevCmd) {
 	const buildDir = path.join(temporaryDir, `msvc-${target.arch}`);
-	const temporaryOutput = path.join(buildDir, "win32-platform.node");
+	const temporaryOutput = path.join(buildDir, "win32-console-mode.node");
 	mkdirSync(buildDir, { recursive: true });
 
 	const batchFile = path.join(buildDir, "build.cmd");
@@ -154,7 +154,6 @@ function buildWithMsvc(target, vsDevCmd) {
 				"/NOENTRY",
 				"/NODEFAULTLIB",
 				"kernel32.lib",
-				"user32.lib",
 				"/OPT:REF",
 				"/OPT:ICF",
 			].join(" "),
@@ -175,7 +174,7 @@ function buildWithMingw(target) {
 	}
 
 	const buildDir = path.join(temporaryDir, `mingw-${target.arch}`);
-	const temporaryOutput = path.join(buildDir, "win32-platform.node");
+	const temporaryOutput = path.join(buildDir, "win32-console-mode.node");
 	mkdirSync(buildDir, { recursive: true });
 
 	const args = [
@@ -184,14 +183,12 @@ function buildWithMingw(target) {
 		"-Wall",
 		"-Wextra",
 		"-Oz",
-		"-fno-builtin",
 		"-shared",
 		"-nostdlib",
 		"-Wl,--no-entry",
 		"-Wl,--strip-all",
 		sourceFile,
 		"-lkernel32",
-		"-luser32",
 		"-o",
 		temporaryOutput,
 	];

package/native/win32/src/win32-console-mode.c

@@ -0,0 +1,119 @@
+#include <windows.h>
+
+#ifndef ENABLE_VIRTUAL_TERMINAL_INPUT
+#define ENABLE_VIRTUAL_TERMINAL_INPUT 0x0200
+#endif
+
+#define NAPI_AUTO_LENGTH ((unsigned long long)-1)
+#define KEY_PRESSED_MASK 0x8000
+
+typedef void* napi_env;
+typedef void* napi_value;
+typedef void* napi_callback_info;
+typedef napi_value (__cdecl *napi_callback)(napi_env, napi_callback_info);
+typedef int (__cdecl *napi_create_function_fn)(napi_env, const char*, unsigned long long, napi_callback, void*, napi_value*);
+typedef int (__cdecl *napi_set_named_property_fn)(napi_env, napi_value, const char*, napi_value);
+typedef int (__cdecl *napi_get_boolean_fn)(napi_env, int, napi_value*);
+typedef int (__cdecl *napi_get_cb_info_fn)(napi_env, napi_callback_info, unsigned long long*, napi_value*, napi_value*, void**);
+typedef int (__cdecl *napi_get_value_string_utf8_fn)(napi_env, napi_value, char*, unsigned long long, unsigned long long*);
+typedef SHORT (WINAPI *get_async_key_state_fn)(int);
+
+static void* node_symbol(const char* name) {
+    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;
+}
+
+static int string_equals(const char* left, const char* right) {
+    while (*left && *right && *left == *right) {
+        left++;
+        right++;
+    }
+    return *left == 0 && *right == 0;
+}
+
+static get_async_key_state_fn get_async_key_state_symbol(void) {
+    static int loaded = 0;
+    static get_async_key_state_fn get_async_key_state = 0;
+
+    if (!loaded) {
+        HMODULE module = GetModuleHandleA("user32.dll");
+        if (!module) module = LoadLibraryA("user32.dll");
+        get_async_key_state = module ? (get_async_key_state_fn)GetProcAddress(module, "GetAsyncKeyState") : 0;
+        loaded = 1;
+    }
+
+    return get_async_key_state;
+}
+
+static int is_key_pressed(int virtual_key) {
+    get_async_key_state_fn get_async_key_state = get_async_key_state_symbol();
+    return get_async_key_state && (((unsigned short)get_async_key_state(virtual_key)) & KEY_PRESSED_MASK) != 0;
+}
+
+static int is_modifier_name_pressed(const char* name) {
+    if (string_equals(name, "shift")) return is_key_pressed(VK_SHIFT) || is_key_pressed(VK_LSHIFT) || is_key_pressed(VK_RSHIFT);
+    if (string_equals(name, "control")) return is_key_pressed(VK_CONTROL) || is_key_pressed(VK_LCONTROL) || is_key_pressed(VK_RCONTROL);
+    if (string_equals(name, "option") || string_equals(name, "alt")) return is_key_pressed(VK_MENU) || is_key_pressed(VK_LMENU) || is_key_pressed(VK_RMENU);
+    if (string_equals(name, "command") || string_equals(name, "super") || string_equals(name, "win")) return is_key_pressed(VK_LWIN) || is_key_pressed(VK_RWIN);
+    return 0;
+}
+
+static napi_value __cdecl enable_virtual_terminal_input(napi_env env, napi_callback_info info) {
+    (void)info;
+
+    HANDLE handle = GetStdHandle(STD_INPUT_HANDLE);
+    DWORD mode = 0;
+    int enabled = handle != INVALID_HANDLE_VALUE &&
+        GetConsoleMode(handle, &mode) &&
+        SetConsoleMode(handle, mode | ENABLE_VIRTUAL_TERMINAL_INPUT);
+
+    napi_get_boolean_fn napi_get_boolean = (napi_get_boolean_fn)node_symbol("napi_get_boolean");
+    napi_value result = 0;
+    if (napi_get_boolean) napi_get_boolean(env, enabled, &result);
+    return result;
+}
+
+static napi_value __cdecl is_modifier_pressed(napi_env env, napi_callback_info info) {
+    napi_get_cb_info_fn napi_get_cb_info = (napi_get_cb_info_fn)node_symbol("napi_get_cb_info");
+    napi_get_value_string_utf8_fn napi_get_value_string_utf8 = (napi_get_value_string_utf8_fn)node_symbol("napi_get_value_string_utf8");
+    napi_get_boolean_fn napi_get_boolean = (napi_get_boolean_fn)node_symbol("napi_get_boolean");
+
+    int pressed = 0;
+    if (napi_get_cb_info && napi_get_value_string_utf8) {
+        unsigned long long argc = 1;
+        napi_value args[1] = {0};
+        if (napi_get_cb_info(env, info, &argc, args, 0, 0) == 0 && argc >= 1 && args[0]) {
+            char name[16] = {0};
+            unsigned long long copied = 0;
+            if (napi_get_value_string_utf8(env, args[0], name, sizeof(name), &copied) == 0) {
+                pressed = is_modifier_name_pressed(name);
+            }
+        }
+    }
+
+    napi_value result = 0;
+    if (napi_get_boolean) napi_get_boolean(env, pressed, &result);
+    return result;
+}
+
+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);
+    }
+}
+
+__declspec(dllexport) napi_value __cdecl napi_register_module_v1(napi_env env, napi_value exports) {
+    set_function_export(env, exports, "enableVirtualTerminalInput", enable_virtual_terminal_input);
+    set_function_export(env, exports, "isModifierPressed", is_modifier_pressed);
+    return exports;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@code-yeongyu/senpi-tui",
-	"version": "2026.9.12-3",
+	"version": "2026.9.12",
 	"description": "Terminal User Interface library with differential rendering for efficient text-based applications",
 	"type": "module",
 	"main": "dist/index.js",
@@ -8,7 +8,6 @@
 		"clean": "shx rm -rf dist",
 		"build": "tsgo -p tsconfig.build.json",
 		"build:native:darwin": "native/darwin/build.sh",
-		"build:native:linux": "native/linux/build.sh",
 		"build:native:win32": "node native/win32/build.mjs",
 		"test": "node --test --import tsx --import ./test/setup-multiplexer-env.mjs --test-reporter=dot --test-reporter-destination=stdout test/*.test.ts",
 		"prepublishOnly": "npm run clean && npm run build",
@@ -16,20 +15,14 @@
 	},
 	"files": [
 		"dist/**/*",
-		"native/napi.h",
-		"native/clipboard.h",
 		"native/win32/prebuilds/**/*.node",
 		"native/win32/src/**/*.c",
 		"native/win32/build.mjs",
 		"native/win32/README.md",
 		"native/darwin/prebuilds/**/*.node",
-		"native/darwin/src/**/*.m",
+		"native/darwin/src/**/*.c",
 		"native/darwin/build.sh",
 		"native/darwin/README.md",
-		"native/linux/prebuilds/**/*.node",
-		"native/linux/src/**/*.{c,h}",
-		"native/linux/build.sh",
-		"native/linux/README.md",
 		"README.md"
 	],
 	"keywords": [
@@ -54,7 +47,7 @@
 	"types": "./dist/index.d.ts",
 	"dependencies": {
 		"get-east-asian-width": "1.6.0",
-		"marked": "18.0.11"
+		"marked": "18.0.10"
 	},
 	"devDependencies": {
 		"@xterm/headless": "6.0.0",

package/dist/components/mouse-region.d.ts

@@ -1,12 +0,0 @@
-import { type Component, type TuiMouseDispatchResult, type TuiMouseEvent, type TuiMouseEventResult } from "../tui.ts";
-export type MouseRegionHandler = (event: TuiMouseEvent) => TuiMouseEventResult | undefined;
-/** Adds mouse handling to an existing component without changing its rendering. */
-export declare class MouseRegion implements Component {
-    private readonly child;
-    private readonly onMouse;
-    constructor(child: Component, onMouse: MouseRegionHandler);
-    render(width: number): string[];
-    handleMouse(event: TuiMouseEvent): TuiMouseDispatchResult | TuiMouseEventResult | undefined;
-    invalidate(): void;
-}
-//# sourceMappingURL=mouse-region.d.ts.map

package/dist/components/mouse-region.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"mouse-region.d.ts","sourceRoot":"","sources":["../../src/components/mouse-region.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,SAAS,EAEd,KAAK,sBAAsB,EAC3B,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,MAAM,WAAW,CAAC;AAEnB,MAAM,MAAM,kBAAkB,GAAG,CAAC,KAAK,EAAE,aAAa,KAAK,mBAAmB,GAAG,SAAS,CAAC;AAE3F,mFAAmF;AACnF,qBAAa,WAAY,YAAW,SAAS;IAC5C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAY;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAE7C,YAAY,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,kBAAkB,EAGxD;IAED,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAE9B;IAED,WAAW,CAAC,KAAK,EAAE,aAAa,GAAG,sBAAsB,GAAG,mBAAmB,GAAG,SAAS,CAG1F;IAED,UAAU,IAAI,IAAI,CAEjB;CACD"}

package/dist/components/mouse-region.js

@@ -1,19 +0,0 @@
-import { dispatchMouseEvent, } from "../tui.js";
-/** Adds mouse handling to an existing component without changing its rendering. */
-export class MouseRegion {
-    constructor(child, onMouse) {
-        this.child = child;
-        this.onMouse = onMouse;
-    }
-    render(width) {
-        return this.child.render(width);
-    }
-    handleMouse(event) {
-        const childResult = dispatchMouseEvent(this.child, event);
-        return childResult ?? this.onMouse(event);
-    }
-    invalidate() {
-        this.child.invalidate();
-    }
-}
-//# sourceMappingURL=mouse-region.js.map

package/dist/components/mouse-region.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"mouse-region.js","sourceRoot":"","sources":["../../src/components/mouse-region.ts"],"names":[],"mappings":"AAAA,OAAO,EAEN,kBAAkB,GAIlB,MAAM,WAAW,CAAC;AAInB,mFAAmF;AACnF,MAAM,OAAO,WAAW;IAIvB,YAAY,KAAgB,EAAE,OAA2B;QACxD,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACxB,CAAC;IAED,MAAM,CAAC,KAAa;QACnB,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC;IAED,WAAW,CAAC,KAAoB;QAC/B,MAAM,WAAW,GAAG,kBAAkB,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAC1D,OAAO,WAAW,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC3C,CAAC;IAED,UAAU;QACT,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;IACzB,CAAC;CACD","sourcesContent":["import {\n\ttype Component,\n\tdispatchMouseEvent,\n\ttype TuiMouseDispatchResult,\n\ttype TuiMouseEvent,\n\ttype TuiMouseEventResult,\n} from \"../tui.ts\";\n\nexport type MouseRegionHandler = (event: TuiMouseEvent) => TuiMouseEventResult | undefined;\n\n/** Adds mouse handling to an existing component without changing its rendering. */\nexport class MouseRegion implements Component {\n\tprivate readonly child: Component;\n\tprivate readonly onMouse: MouseRegionHandler;\n\n\tconstructor(child: Component, onMouse: MouseRegionHandler) {\n\t\tthis.child = child;\n\t\tthis.onMouse = onMouse;\n\t}\n\n\trender(width: number): string[] {\n\t\treturn this.child.render(width);\n\t}\n\n\thandleMouse(event: TuiMouseEvent): TuiMouseDispatchResult | TuiMouseEventResult | undefined {\n\t\tconst childResult = dispatchMouseEvent(this.child, event);\n\t\treturn childResult ?? this.onMouse(event);\n\t}\n\n\tinvalidate(): void {\n\t\tthis.child.invalidate();\n\t}\n}\n"]}

package/dist/native-platform.d.ts

@@ -1,18 +0,0 @@
-export type ModifierKey = "shift" | "command" | "control" | "option";
-export interface NativeClipboard {
-    /** Undefined means unavailable, null means no text; transfer failures reject. */
-    getText(): Promise<string | null | undefined>;
-    /** Undefined means unavailable, null means no image; transfer failures reject. */
-    getImage(): Promise<Uint8Array | null | undefined>;
-    /** Linux uses command-line tools to retain clipboard ownership instead. */
-    setText?(text: string): Promise<void>;
-}
-type NativePlatformHelper = NativeClipboard & {
-    enableVirtualTerminalInput?: () => boolean;
-    isModifierPressed?: (name: ModifierKey) => boolean;
-};
-export declare function getNativePlatformHelper(): NativePlatformHelper | undefined;
-/** Load a clipboard helper without opening the display until a read is requested. */
-export declare function getNativeClipboard(): NativeClipboard | undefined;
-export {};
-//# sourceMappingURL=native-platform.d.ts.map

package/dist/native-platform.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"native-platform.d.ts","sourceRoot":"","sources":["../src/native-platform.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;AAErE,MAAM,WAAW,eAAe;IAC/B,iFAAiF;IACjF,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;IAC9C,kFAAkF;IAClF,QAAQ,IAAI,OAAO,CAAC,UAAU,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;IACnD,2EAA2E;IAC3E,OAAO,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtC;AAED,KAAK,oBAAoB,GAAG,eAAe,GAAG;IAC7C,0BAA0B,CAAC,EAAE,MAAM,OAAO,CAAC;IAC3C,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,OAAO,CAAC;CACnD,CAAC;AAgCF,wBAAgB,uBAAuB,IAAI,oBAAoB,GAAG,SAAS,CAG1E;AAED,qFAAqF;AACrF,wBAAgB,kBAAkB,IAAI,eAAe,GAAG,SAAS,CAIhE"}

package/dist/native-platform.js

@@ -1,42 +0,0 @@
-import { createRequire } from "node:module";
-import * as path from "node:path";
-import { getNativeModuleCandidates } from "./native-module-path.js";
-const cjsRequire = createRequire(import.meta.url);
-// Cache module loading, not display availability: a disconnected display can recover.
-const helpers = new Map();
-function loadNativePlatformHelper(platform, suffix = "") {
-    const arch = process.arch;
-    if (arch !== "x64" && arch !== "arm64")
-        return undefined;
-    const nativePath = path.join("native", platform, "prebuilds", `${platform}-${arch}`, `${platform}-platform${suffix}.node`);
-    if (helpers.has(nativePath))
-        return helpers.get(nativePath);
-    for (const modulePath of getNativeModuleCandidates(nativePath)) {
-        try {
-            const helper = cjsRequire(modulePath);
-            if (typeof helper?.getText === "function" && typeof helper.getImage === "function") {
-                helpers.set(nativePath, helper);
-                return helper;
-            }
-        }
-        catch {
-            // Try the next possible packaging location.
-        }
-    }
-    helpers.set(nativePath, undefined);
-    return undefined;
-}
-export function getNativePlatformHelper() {
-    if (process.platform !== "darwin" && process.platform !== "win32")
-        return undefined;
-    return loadNativePlatformHelper(process.platform);
-}
-/** Load a clipboard helper without opening the display until a read is requested. */
-export function getNativeClipboard() {
-    if (process.platform !== "linux")
-        return getNativePlatformHelper();
-    if (!process.env.DISPLAY)
-        return undefined;
-    return loadNativePlatformHelper("linux", "-x11");
-}
-//# sourceMappingURL=native-platform.js.map

package/dist/native-platform.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"native-platform.js","sourceRoot":"","sources":["../src/native-platform.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AAEpE,MAAM,UAAU,GAAG,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;AAkBlD,sFAAsF;AACtF,MAAM,OAAO,GAAG,IAAI,GAAG,EAA4C,CAAC;AAEpE,SAAS,wBAAwB,CAAC,QAAgB,EAAE,MAAM,GAAG,EAAE;IAC9D,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAC1B,IAAI,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,OAAO;QAAE,OAAO,SAAS,CAAC;IACzD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAC3B,QAAQ,EACR,QAAQ,EACR,WAAW,EACX,GAAG,QAAQ,IAAI,IAAI,EAAE,EACrB,GAAG,QAAQ,YAAY,MAAM,OAAO,CACpC,CAAC;IACF,IAAI,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC;QAAE,OAAO,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAE5D,KAAK,MAAM,UAAU,IAAI,yBAAyB,CAAC,UAAU,CAAC,EAAE,CAAC;QAChE,IAAI,CAAC;YACJ,MAAM,MAAM,GAAG,UAAU,CAAC,UAAU,CAAyC,CAAC;YAC9E,IAAI,OAAO,MAAM,EAAE,OAAO,KAAK,UAAU,IAAI,OAAO,MAAM,CAAC,QAAQ,KAAK,UAAU,EAAE,CAAC;gBACpF,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,MAA8B,CAAC,CAAC;gBACxD,OAAO,MAA8B,CAAC;YACvC,CAAC;QACF,CAAC;QAAC,MAAM,CAAC;YACR,4CAA4C;QAC7C,CAAC;IACF,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;IACnC,OAAO,SAAS,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,uBAAuB;IACtC,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO;QAAE,OAAO,SAAS,CAAC;IACpF,OAAO,wBAAwB,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;AACnD,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,kBAAkB;IACjC,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO;QAAE,OAAO,uBAAuB,EAAE,CAAC;IACnE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAC3C,OAAO,wBAAwB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AAClD,CAAC","sourcesContent":["import { createRequire } from \"node:module\";\nimport * as path from \"node:path\";\nimport { getNativeModuleCandidates } from \"./native-module-path.ts\";\n\nconst cjsRequire = createRequire(import.meta.url);\n\nexport type ModifierKey = \"shift\" | \"command\" | \"control\" | \"option\";\n\nexport interface NativeClipboard {\n\t/** Undefined means unavailable, null means no text; transfer failures reject. */\n\tgetText(): Promise<string | null | undefined>;\n\t/** Undefined means unavailable, null means no image; transfer failures reject. */\n\tgetImage(): Promise<Uint8Array | null | undefined>;\n\t/** Linux uses command-line tools to retain clipboard ownership instead. */\n\tsetText?(text: string): Promise<void>;\n}\n\ntype NativePlatformHelper = NativeClipboard & {\n\tenableVirtualTerminalInput?: () => boolean;\n\tisModifierPressed?: (name: ModifierKey) => boolean;\n};\n\n// Cache module loading, not display availability: a disconnected display can recover.\nconst helpers = new Map<string, NativePlatformHelper | undefined>();\n\nfunction loadNativePlatformHelper(platform: string, suffix = \"\"): NativePlatformHelper | undefined {\n\tconst arch = process.arch;\n\tif (arch !== \"x64\" && arch !== \"arm64\") return undefined;\n\tconst nativePath = path.join(\n\t\t\"native\",\n\t\tplatform,\n\t\t\"prebuilds\",\n\t\t`${platform}-${arch}`,\n\t\t`${platform}-platform${suffix}.node`,\n\t);\n\tif (helpers.has(nativePath)) return helpers.get(nativePath);\n\n\tfor (const modulePath of getNativeModuleCandidates(nativePath)) {\n\t\ttry {\n\t\t\tconst helper = cjsRequire(modulePath) as Partial<NativePlatformHelper> | null;\n\t\t\tif (typeof helper?.getText === \"function\" && typeof helper.getImage === \"function\") {\n\t\t\t\thelpers.set(nativePath, helper as NativePlatformHelper);\n\t\t\t\treturn helper as NativePlatformHelper;\n\t\t\t}\n\t\t} catch {\n\t\t\t// Try the next possible packaging location.\n\t\t}\n\t}\n\thelpers.set(nativePath, undefined);\n\treturn undefined;\n}\n\nexport function getNativePlatformHelper(): NativePlatformHelper | undefined {\n\tif (process.platform !== \"darwin\" && process.platform !== \"win32\") return undefined;\n\treturn loadNativePlatformHelper(process.platform);\n}\n\n/** Load a clipboard helper without opening the display until a read is requested. */\nexport function getNativeClipboard(): NativeClipboard | undefined {\n\tif (process.platform !== \"linux\") return getNativePlatformHelper();\n\tif (!process.env.DISPLAY) return undefined;\n\treturn loadNativePlatformHelper(\"linux\", \"-x11\");\n}\n"]}

package/native/clipboard.h

@@ -1,170 +0,0 @@
-#ifndef PI_CLIPBOARD_H
-#define PI_CLIPBOARD_H
-
-#include "napi.h"
-#ifndef _WIN32
-#include <stdlib.h>
-#include <string.h>
-#endif
-
-typedef enum { CLIPBOARD_TEXT, CLIPBOARD_IMAGE, CLIPBOARD_WRITE } clipboard_operation;
-typedef enum { CLIPBOARD_UNAVAILABLE, CLIPBOARD_EMPTY, CLIPBOARD_UTF8, CLIPBOARD_LATIN1, CLIPBOARD_UTF16, CLIPBOARD_BUFFER } clipboard_format;
-
-typedef struct {
-    napi_async_work work;
-    napi_deferred deferred;
-    clipboard_operation operation;
-    clipboard_format format;
-    void* data;
-    size_t length;
-    const char* error;
-} clipboard_job;
-
-// Only this function runs on the worker thread. It must not call N-API.
-static void clipboard_execute(clipboard_job* job);
-
-static void* clipboard_alloc(size_t size) {
-#ifdef _WIN32
-    return GlobalAlloc(GPTR, size);
-#else
-    return calloc(1, size);
-#endif
-}
-
-static void clipboard_free(void* data) {
-#ifdef _WIN32
-    if (data) GlobalFree(data);
-#else
-    free(data);
-#endif
-}
-
-#ifdef PI_CLIPBOARD_WRITE
-static void clipboard_copy(clipboard_job* job, const void* data, size_t length, clipboard_format format) {
-    job->data = clipboard_alloc(length ? length : 1);
-    if (!job->data) {
-        job->error = "Out of memory";
-        return;
-    }
-#ifdef _WIN32
-    volatile uint8_t* target = job->data;
-    const volatile uint8_t* source = data;
-    for (size_t index = 0; index < length; index++) target[index] = source[index];
-#else
-    memcpy(job->data, data, length);
-#endif
-    job->length = format == CLIPBOARD_UTF16 ? length / sizeof(uint16_t) : length;
-    job->format = format;
-}
-#endif
-
-static void PI_NAPI_CALL execute_clipboard_work(napi_env env, void* data) {
-    (void)env;
-    clipboard_execute(data);
-}
-
-static void PI_NAPI_CALL complete_clipboard_work(napi_env env, int status, void* data) {
-    clipboard_job* job = data;
-    napi_create_string_utf8_fn create_string = (napi_create_string_utf8_fn)node_symbol("napi_create_string_utf8");
-    napi_value result = undefined_value(env);
-    if (status != 0) job->error = "Clipboard operation cancelled";
-    if (!job->error && job->operation != CLIPBOARD_WRITE) {
-        if (job->format == CLIPBOARD_EMPTY) {
-            result = null_value(env);
-        } else if (job->format == CLIPBOARD_BUFFER) {
-            napi_create_buffer_copy_fn create_buffer = (napi_create_buffer_copy_fn)node_symbol("napi_create_buffer_copy");
-            status = create_buffer(env, job->length, job->data, 0, &result);
-        } else if (job->format == CLIPBOARD_UTF16) {
-            napi_create_string_utf16_fn create_utf16 = (napi_create_string_utf16_fn)node_symbol("napi_create_string_utf16");
-            status = create_utf16(env, job->data, job->length, &result);
-        } else if (job->format == CLIPBOARD_UTF8 || job->format == CLIPBOARD_LATIN1) {
-            napi_create_string_utf8_fn create_text = job->format == CLIPBOARD_LATIN1
-                ? (napi_create_string_utf8_fn)node_symbol("napi_create_string_latin1") : create_string;
-            status = create_text(env, job->data, job->length, &result);
-        }
-        if (status != 0) job->error = "Could not create clipboard value";
-    }
-    if (job->error) {
-        napi_create_error_fn create_error = (napi_create_error_fn)node_symbol("napi_create_error");
-        napi_value message;
-        create_string(env, job->error, NAPI_AUTO_LENGTH, &message);
-        create_error(env, 0, message, &result);
-    }
-    napi_settle_deferred_fn settle = (napi_settle_deferred_fn)node_symbol(
-        job->error ? "napi_reject_deferred" : "napi_resolve_deferred"
-    );
-    settle(env, job->deferred, result);
-    napi_async_work_fn delete_work = (napi_async_work_fn)node_symbol("napi_delete_async_work");
-    delete_work(env, job->work);
-    clipboard_free(job->data);
-    clipboard_free(job);
-}
-
-static napi_value queue_clipboard(napi_env env, napi_callback_info info, clipboard_operation operation) {
-    napi_create_async_work_fn create_work = (napi_create_async_work_fn)node_symbol("napi_create_async_work");
-    napi_async_work_fn queue_work = (napi_async_work_fn)node_symbol("napi_queue_async_work");
-    napi_async_work_fn delete_work = (napi_async_work_fn)node_symbol("napi_delete_async_work");
-    napi_create_promise_fn create_promise = (napi_create_promise_fn)node_symbol("napi_create_promise");
-    napi_create_string_utf8_fn create_string = (napi_create_string_utf8_fn)node_symbol("napi_create_string_utf8");
-    if (!create_work || !queue_work || !delete_work || !create_promise || !create_string) {
-        return fail(env, "Async clipboard API unavailable");
-    }
-    clipboard_job* job = clipboard_alloc(sizeof(*job));
-    if (!job) return fail(env, "Out of memory");
-    job->operation = operation;
-#ifdef PI_CLIPBOARD_WRITE
-    if (operation == CLIPBOARD_WRITE) {
-        napi_get_cb_info_fn get_info = (napi_get_cb_info_fn)node_symbol("napi_get_cb_info");
-#ifdef _WIN32
-        napi_get_value_string_utf16_fn get_string = (napi_get_value_string_utf16_fn)node_symbol("napi_get_value_string_utf16");
-        size_t unit_size = sizeof(uint16_t);
-#else
-        napi_get_value_string_utf8_fn get_string = (napi_get_value_string_utf8_fn)node_symbol("napi_get_value_string_utf8");
-        size_t unit_size = 1;
-#endif
-        size_t argc = 1;
-        napi_value argument = 0;
-        if (!get_info || !get_string || get_info(env, info, &argc, &argument, 0, 0) != 0 || argc == 0 ||
-            get_string(env, argument, 0, 0, &job->length) != 0) {
-            clipboard_free(job);
-            return fail(env, "setText requires a string");
-        }
-        job->data = job->length < SIZE_MAX / unit_size
-            ? clipboard_alloc((job->length + 1) * unit_size) : 0;
-        if (!job->data || get_string(env, argument, job->data, job->length + 1, &job->length) != 0) {
-            clipboard_free(job->data);
-            clipboard_free(job);
-            return fail(env, "Could not read clipboard text");
-        }
-    }
-#else
-    (void)info;
-#endif
-    napi_value name = 0;
-    napi_value promise = 0;
-    if (create_string(env, "pi.clipboard", NAPI_AUTO_LENGTH, &name) != 0 ||
-        create_work(env, 0, name, execute_clipboard_work, complete_clipboard_work, job, &job->work) != 0 ||
-        create_promise(env, &job->deferred, &promise) != 0 || queue_work(env, job->work) != 0) {
-        if (job->work) delete_work(env, job->work);
-        clipboard_free(job->data);
-        clipboard_free(job);
-        return fail(env, "Could not queue clipboard operation");
-    }
-    return promise;
-}
-
-static napi_value PI_NAPI_CALL get_clipboard_text(napi_env env, napi_callback_info info) {
-    return queue_clipboard(env, info, CLIPBOARD_TEXT);
-}
-
-static napi_value PI_NAPI_CALL get_clipboard_image(napi_env env, napi_callback_info info) {
-    return queue_clipboard(env, info, CLIPBOARD_IMAGE);
-}
-
-#ifdef PI_CLIPBOARD_WRITE
-static napi_value PI_NAPI_CALL set_clipboard_text(napi_env env, napi_callback_info info) {
-    return queue_clipboard(env, info, CLIPBOARD_WRITE);
-}
-#endif
-
-#endif

package/native/darwin/src/darwin-platform.m

@@ -1,93 +0,0 @@
-#import <AppKit/AppKit.h>
-#import <CoreGraphics/CoreGraphics.h>
-#import <Foundation/Foundation.h>
-#include <stdlib.h>
-#include <string.h>
-#define PI_CLIPBOARD_WRITE
-#include "../../clipboard.h"
-
-static CGEventFlags modifier_mask_for_name(const char* name) {
-    if (strcmp(name, "shift") == 0) return kCGEventFlagMaskShift;
-    if (strcmp(name, "command") == 0) return kCGEventFlagMaskCommand;
-    if (strcmp(name, "control") == 0) return kCGEventFlagMaskControl;
-    if (strcmp(name, "option") == 0) return kCGEventFlagMaskAlternate;
-    return 0;
-}
-
-static napi_value is_modifier_pressed(napi_env env, napi_callback_info info) {
-    napi_get_cb_info_fn napi_get_cb_info = (napi_get_cb_info_fn)node_symbol("napi_get_cb_info");
-    napi_get_value_string_utf8_fn napi_get_value_string_utf8 =
-        (napi_get_value_string_utf8_fn)node_symbol("napi_get_value_string_utf8");
-    napi_get_boolean_fn napi_get_boolean = (napi_get_boolean_fn)node_symbol("napi_get_boolean");
-
-    bool pressed = false;
-    if (napi_get_cb_info && napi_get_value_string_utf8) {
-        size_t argc = 1;
-        napi_value args[1] = {0};
-        if (napi_get_cb_info(env, info, &argc, args, 0, 0) == 0 && argc >= 1 && args[0]) {
-            char name[16] = {0};
-            size_t copied = 0;
-            if (napi_get_value_string_utf8(env, args[0], name, sizeof(name), &copied) == 0) {
-                CGEventFlags mask = modifier_mask_for_name(name);
-                if (mask != 0) {
-                    CGEventFlags flags = CGEventSourceFlagsState(kCGEventSourceStateCombinedSessionState);
-                    pressed = (flags & mask) != 0;
-                }
-            }
-        }
-    }
-
-    napi_value result = 0;
-    if (!napi_get_boolean || napi_get_boolean(env, pressed, &result) != 0) {
-        return fail(env, "Could not inspect modifier state");
-    }
-    return result;
-}
-
-static void clipboard_execute(clipboard_job* job) {
-    @autoreleasepool {
-        NSPasteboard* pasteboard = [NSPasteboard generalPasteboard];
-        if (!pasteboard) {
-            job->error = "Could not open clipboard";
-        } else if (job->operation == CLIPBOARD_WRITE) {
-            NSString* text = [[NSString alloc] initWithBytes:job->data length:job->length encoding:NSUTF8StringEncoding];
-            if (!text) {
-                job->error = "Clipboard text is not valid UTF-8";
-                return;
-            }
-            [pasteboard clearContents];
-            if (![pasteboard setString:text forType:NSPasteboardTypeString]) job->error = "Could not set clipboard text";
-        } else if (job->operation == CLIPBOARD_TEXT) {
-            NSString* text = [pasteboard stringForType:NSPasteboardTypeString];
-            if (!text) {
-                job->format = CLIPBOARD_EMPTY;
-            } else if (!text.UTF8String) {
-                job->error = "Could not encode clipboard text";
-            } else {
-                clipboard_copy(job, text.UTF8String, [text lengthOfBytesUsingEncoding:NSUTF8StringEncoding], CLIPBOARD_UTF8);
-            }
-        } else {
-            if (![pasteboard availableTypeFromArray:@[ NSPasteboardTypePNG, NSPasteboardTypeTIFF ]]) {
-                job->format = CLIPBOARD_EMPTY;
-                return;
-            }
-            NSData* png = [pasteboard dataForType:NSPasteboardTypePNG];
-            if (!png) {
-                NSImage* image = [[NSImage alloc] initWithPasteboard:pasteboard];
-                NSData* tiff = image.TIFFRepresentation;
-                NSBitmapImageRep* bitmap = tiff ? [NSBitmapImageRep imageRepWithData:tiff] : nil;
-                png = bitmap ? [bitmap representationUsingType:NSBitmapImageFileTypePNG properties:@{}] : nil;
-            }
-            if (png) clipboard_copy(job, png.bytes, png.length, CLIPBOARD_BUFFER);
-            else job->error = "Clipboard does not contain an image";
-        }
-    }
-}
-
-PI_NAPI_EXPORT napi_value napi_register_module_v1(napi_env env, napi_value exports) {
-    set_function_export(env, exports, "isModifierPressed", is_modifier_pressed);
-    set_function_export(env, exports, "getText", get_clipboard_text);
-    set_function_export(env, exports, "setText", set_clipboard_text);
-    set_function_export(env, exports, "getImage", get_clipboard_image);
-    return exports;
-}