gpui-bridge 0.0.0-stage → 0.3.0

package/dist/protocol.js

@@ -0,0 +1,3 @@
+// Protocol message types. Source of truth together with `host/src/protocol.rs`
+// and PROTOCOL.md.
+export const PROTOCOL_VERSION = 1;

package/dist/tree.d.ts

@@ -0,0 +1,19 @@
+import type { ClientMessage, NodeId, NodeType } from "./protocol.js";
+export type EventHandler = (payload: any) => void;
+export declare class Tree {
+    private nextId;
+    private pending;
+    private readonly nodes;
+    /** Ids are positive, unique for the whole session and never reused. */
+    create(type: NodeType, props: Record<string, unknown>): NodeId;
+    type(id: NodeId): NodeType | undefined;
+    queue(op: ClientMessage): void;
+    /** Mirrors the host's move semantics so `remove` can drop descendant handlers. */
+    attach(parent: NodeId, child: NodeId): void;
+    remove(id: NodeId): void;
+    /** Sets or clears a handler; queues `setEvents` when the subscription set changes. */
+    setHandler(id: NodeId, event: string, handler: EventHandler | undefined): void;
+    handler(id: NodeId, event: string): EventHandler | undefined;
+    /** Sends every queued operation, then `commit`. */
+    commit(send: (message: ClientMessage) => void): void;
+}

package/dist/tree.js

@@ -0,0 +1,70 @@
+// Client-side bookkeeping: id allocation, batched operations and event handlers.
+export class Tree {
+    nextId = 1;
+    pending = [];
+    nodes = new Map();
+    /** Ids are positive, unique for the whole session and never reused. */
+    create(type, props) {
+        const id = this.nextId++;
+        this.nodes.set(id, { type, children: new Set(), handlers: new Map() });
+        this.pending.push({ op: "create", id, type, props });
+        return id;
+    }
+    type(id) {
+        return this.nodes.get(id)?.type;
+    }
+    queue(op) {
+        this.pending.push(op);
+    }
+    /** Mirrors the host's move semantics so `remove` can drop descendant handlers. */
+    attach(parent, child) {
+        const record = this.nodes.get(child);
+        if (!record)
+            return;
+        if (record.parent !== undefined)
+            this.nodes.get(record.parent)?.children.delete(child);
+        record.parent = parent;
+        this.nodes.get(parent)?.children.add(child);
+    }
+    remove(id) {
+        const record = this.nodes.get(id);
+        if (!record)
+            return;
+        if (record.parent !== undefined)
+            this.nodes.get(record.parent)?.children.delete(id);
+        const stack = [id];
+        while (stack.length) {
+            const current = stack.pop();
+            const node = this.nodes.get(current);
+            if (!node)
+                continue;
+            stack.push(...node.children);
+            this.nodes.delete(current);
+        }
+        this.pending.push({ op: "remove", id });
+    }
+    /** Sets or clears a handler; queues `setEvents` when the subscription set changes. */
+    setHandler(id, event, handler) {
+        const record = this.nodes.get(id);
+        if (!record)
+            return;
+        const had = record.handlers.has(event);
+        if (handler)
+            record.handlers.set(event, handler);
+        else
+            record.handlers.delete(event);
+        if (had !== record.handlers.has(event)) {
+            this.pending.push({ op: "setEvents", id, events: [...record.handlers.keys()] });
+        }
+    }
+    handler(id, event) {
+        return this.nodes.get(id)?.handlers.get(event);
+    }
+    /** Sends every queued operation, then `commit`. */
+    commit(send) {
+        for (const op of this.pending)
+            send(op);
+        this.pending = [];
+        send({ op: "commit" });
+    }
+}

package/dist/txiki.d.ts

@@ -0,0 +1,10 @@
+import { type App } from "./app.js";
+export * from "./app.js";
+export * from "./protocol.js";
+export interface TxikiAppOptions {
+    /** Host binary. Defaults to `$GPUI_BRIDGE_HOST`, then `gpui-bridge-host[.exe]` next to the running executable. */
+    hostPath?: string;
+    debug?: boolean;
+    headless?: boolean;
+}
+export declare function createTxikiApp(options?: TxikiAppOptions): Promise<App>;

package/dist/txiki.js

@@ -0,0 +1,90 @@
+// txiki.js entry: the same client API as index.ts, over a `tjs.spawn` transport.
+// Uses only txiki.js and Web APIs (no Node modules).
+import { connect } from "./app.js";
+export * from "./app.js";
+export * from "./protocol.js";
+const STDERR_TAIL_LINES = 20;
+async function readLines(stream, onLine) {
+    const reader = stream.getReader();
+    const decoder = new TextDecoder();
+    let buffer = "";
+    for (;;) {
+        const { value, done } = await reader.read();
+        if (done)
+            break;
+        buffer += decoder.decode(value, { stream: true });
+        let newline;
+        while ((newline = buffer.indexOf("\n")) >= 0) {
+            const line = buffer.slice(0, newline).replace(/\r$/, "");
+            buffer = buffer.slice(newline + 1);
+            if (line)
+                onLine(line);
+        }
+    }
+}
+class TxikiHost {
+    process;
+    writer;
+    encoder = new TextEncoder();
+    exited = false;
+    constructor(path, args, debug, events) {
+        const stderrTail = [];
+        const finish = (exit) => {
+            if (this.exited)
+                return;
+            this.exited = true;
+            events.onExit({ ...exit, stderrTail });
+        };
+        try {
+            this.process = tjs.spawn([path, ...args], { stdin: "pipe", stdout: "pipe", stderr: "pipe" });
+        }
+        catch (error) {
+            // Reported asynchronously, like a failed spawn in Node.
+            queueMicrotask(() => finish({ code: null, signal: null, spawnError: error }));
+            return;
+        }
+        this.writer = this.process.stdin.getWriter();
+        const stdout = readLines(this.process.stdout, (line) => {
+            try {
+                events.onMessage(JSON.parse(line));
+            }
+            catch {
+                events.onCorruptLine(line);
+            }
+        });
+        const stderr = readLines(this.process.stderr, (line) => {
+            stderrTail.push(line);
+            if (stderrTail.length > STDERR_TAIL_LINES)
+                stderrTail.shift();
+            if (debug)
+                console.error(`[host] ${line}`);
+        });
+        // Wait for both streams so every line is delivered before the exit.
+        Promise.all([this.process.wait(), stdout, stderr]).then(([status]) => finish({ code: status.exit_status, signal: status.term_signal }));
+    }
+    send(message) {
+        if (this.exited || !this.writer)
+            return;
+        // Writes racing a dying host fail; the exit report carries the real cause.
+        this.writer.write(this.encoder.encode(JSON.stringify(message) + "\n")).catch(() => { });
+    }
+    close() {
+        this.writer?.close().catch(() => { });
+    }
+    kill() {
+        this.process?.kill();
+    }
+}
+function defaultHostPath() {
+    if (tjs.env.GPUI_BRIDGE_HOST)
+        return tjs.env.GPUI_BRIDGE_HOST;
+    // A compiled app ships the host next to its own executable.
+    const exe = tjs.exePath;
+    const name = exe.toLowerCase().endsWith(".exe") ? "gpui-bridge-host.exe" : "gpui-bridge-host";
+    return exe.replace(/[\\/][^\\/]*$/, "") + (exe.includes("\\") ? "\\" : "/") + name;
+}
+export function createTxikiApp(options = {}) {
+    const path = options.hostPath ?? defaultHostPath();
+    const args = options.headless ? ["--no-window"] : [];
+    return connect(path, (events) => new TxikiHost(path, args, options.debug ?? false, events));
+}

package/package.json

@@ -1,6 +1,47 @@
 {
   "name": "gpui-bridge",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.3.0",
+  "description": "Node.js client for the gpui-bridge native UI host",
+  "license": "MIT",
+  "author": "gpui-bridge contributors",
+  "keywords": [
+    "gpui",
+    "gpui-component",
+    "native",
+    "desktop",
+    "ui",
+    "node",
+    "typescript"
+  ],
+  "homepage": "https://github.com/InDIOS/gpui-bridge#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/InDIOS/gpui-bridge.git",
+    "directory": "packages/client-node"
+  },
+  "bugs": {
+    "url": "https://github.com/InDIOS/gpui-bridge/issues"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "engines": {
+    "node": ">=22.6"
+  },
+  "optionalDependencies": {
+    "@indios/gpui-bridge-darwin-arm64": "0.3.0",
+    "@indios/gpui-bridge-linux-x64": "0.3.0",
+    "@indios/gpui-bridge-win32-x64": "0.3.0"
+  },
+  "devDependencies": {
+    "@types/node": "^26.6.5",
+    "typescript": "^7.0.2"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "tsc && node --test test/*.test.ts"
+  }
 }