gpui-bridge 0.4.2 → 0.6.0

package/dist/app.d.ts

@@ -1,4 +1,4 @@
-import { type ClientMessage, type ErrorCode, type HostMessage, type MenuItem, type NodeEvents, type NodeId, type NodeProps, type NodeType, type ThemeSet, type WindowEventName, type WindowId, type WindowTheme } from "./protocol.js";
+import { type AppIdentity, type ClientMessage, type ErrorCode, type HostMessage, type MenuItem, type NodeEvents, type NodeId, type NodeProps, type NodeType, type ThemeSet, type WindowEventName, type WindowId, type WindowTheme } from "./protocol.js";
 import { Tree } from "./tree.js";
 export interface HostExit {
     code: number | null;
@@ -373,6 +373,11 @@ export declare class App {
     private request;
     /** App-wide keyboard shortcuts (`ctrl-s`, `f5`…), applied on the next commit; replaces the list. */
     shortcuts(keys: string[]): this;
+    /**
+     * Registers SVG icons (name → SVG text) on the next commit, for `Icon` and every `icon` prop
+     * (PROTOCOL.md section 29). Register a name before the nodes that use it; again to replace it.
+     */
+    icons(icons: Record<string, string>): this;
     /** Shows or updates the system tray icon on the next commit. */
     tray(options: TrayOptions): this;
     /** Removes the tray icon on the next commit; with no window open, the host then exits. */
@@ -395,5 +400,5 @@ export declare class App {
  * Starts the host through `start` and completes the handshake. Rejects with a
  * clear message if the host cannot start.
  */
-export declare function connect(hostPath: string, start: (events: HostEvents) => HostTransport): Promise<App>;
+export declare function connect(hostPath: string, start: (events: HostEvents) => HostTransport, identity?: AppIdentity): Promise<App>;
 export {};

package/dist/app.js

@@ -544,6 +544,14 @@ export class App {
         this.wire.queue({ op: "shortcuts", keys });
         return this;
     }
+    /**
+     * Registers SVG icons (name → SVG text) on the next commit, for `Icon` and every `icon` prop
+     * (PROTOCOL.md section 29). Register a name before the nodes that use it; again to replace it.
+     */
+    icons(icons) {
+        this.wire.queue({ op: "icons", icons });
+        return this;
+    }
     /** Shows or updates the system tray icon on the next commit. */
     tray(options) {
         this.wire.queue({ op: "tray", ...options });
@@ -689,7 +697,7 @@ export class App {
  * Starts the host through `start` and completes the handshake. Rejects with a
  * clear message if the host cannot start.
  */
-export function connect(hostPath, start) {
+export function connect(hostPath, start, identity) {
     return new Promise((resolve, reject) => {
         let app;
         let ready = false;
@@ -722,6 +730,7 @@ export function connect(hostPath, start) {
             },
         });
         app = new App(host, hostPath);
-        host.send({ op: "hello", protocol: PROTOCOL_VERSION });
+        // JSON leaves out an undefined `app`, so the default hello stays `{"op":"hello","protocol":1}`.
+        host.send({ op: "hello", protocol: PROTOCOL_VERSION, app: identity });
     });
 }

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 import { type App } from "./app.js";
+import type { AppIdentity } from "./protocol.js";
 export * from "./app.js";
 export * from "./protocol.js";
 export interface AppOptions {
@@ -8,6 +9,8 @@ export interface AppOptions {
     debug?: boolean;
     /** Run the host without a window (`--no-window`), e.g. for tests. */
     headless?: boolean;
+    /** Names the app for the system (`hello`): Windows shows it on system notifications. Default: `gpui-bridge`. */
+    app?: AppIdentity;
 }
 /** The host to run: `$GPUI_BRIDGE_HOST`, then the packaged one, then a build in this repository. */
 export declare function defaultHostPath(): string;

package/dist/index.js

@@ -54,5 +54,5 @@ export function defaultHostPath() {
 export function createApp(options = {}) {
     const path = options.hostPath ?? defaultHostPath();
     const args = options.headless ? ["--no-window"] : [];
-    return connect(path, (events) => new HostProcess({ path, args, debug: options.debug ?? false, ...events }));
+    return connect(path, (events) => new HostProcess({ path, args, debug: options.debug ?? false, ...events }), options.app);
 }

package/dist/protocol.d.ts

@@ -25,10 +25,19 @@ export interface ThemeConfig {
 }
 /** Node props on the wire. In `setProps`, a `null` value removes the prop. */
 export type Props = Record<string, unknown>;
+/** The app's own name for the system (`hello`): Windows shows `name` and `icon` on system notifications. */
+export interface AppIdentity {
+    /** Windows AppUserModelID: up to 128 characters, no spaces or `\`, e.g. `"Acme.Notes"`. */
+    id: string;
+    name: string;
+    /** Image file shown on the app's system notifications (PNG, ICO…). */
+    icon?: string;
+}
 /** Messages from the client (host stdin). */
 export type ClientMessage = {
     op: "hello";
     protocol: number;
+    app?: AppIdentity;
 } | {
     op: "window";
     id?: WindowId;
@@ -87,6 +96,9 @@ export type ClientMessage = {
     menu?: MenuItem[];
 } | {
     op: "removeTray";
+} | {
+    op: "icons";
+    icons: Record<string, string>;
 } | {
     op: "shortcuts";
     keys: string[];
@@ -273,6 +285,8 @@ export interface TextProps {
 }
 export interface ButtonProps {
     label?: string;
+    /** An icon before the label; without a label, give a `tooltip` (it also names the button). */
+    icon?: string;
     variant?: "primary" | "secondary" | "ghost" | "danger";
     disabled?: boolean;
     tooltip?: string;

package/dist/txiki.d.ts

@@ -1,4 +1,5 @@
 import { type App } from "./app.js";
+import type { AppIdentity } from "./protocol.js";
 export * from "./app.js";
 export * from "./protocol.js";
 export interface TxikiAppOptions {
@@ -6,5 +7,7 @@ export interface TxikiAppOptions {
     hostPath?: string;
     debug?: boolean;
     headless?: boolean;
+    /** Names the app for the system (`hello`): Windows shows it on system notifications. Default: `gpui-bridge`. */
+    app?: AppIdentity;
 }
 export declare function createTxikiApp(options?: TxikiAppOptions): Promise<App>;

package/dist/txiki.js

@@ -86,5 +86,5 @@ function defaultHostPath() {
 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));
+    return connect(path, (events) => new TxikiHost(path, args, options.debug ?? false, events), options.app);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gpui-bridge",
-  "version": "0.4.2",
+  "version": "0.6.0",
   "description": "Node.js client for the gpui-bridge native UI host",
   "license": "MIT",
   "author": "gpui-bridge contributors",
@@ -29,9 +29,9 @@
     "node": ">=22.6"
   },
   "optionalDependencies": {
-    "@indios/gpui-bridge-darwin-arm64": "0.4.2",
-    "@indios/gpui-bridge-linux-x64": "0.4.2",
-    "@indios/gpui-bridge-win32-x64": "0.4.2"
+    "@indios/gpui-bridge-darwin-arm64": "0.6.0",
+    "@indios/gpui-bridge-linux-x64": "0.6.0",
+    "@indios/gpui-bridge-win32-x64": "0.6.0"
   },
   "devDependencies": {
     "@types/node": "^26.6.5",