@trayjs/trayjs 0.0.1

package/README.md

@@ -0,0 +1,77 @@
+# @trayjs/trayjs
+
+Cross-platform system tray for Node.js. Works on Linux, macOS and Windows.
+
+## Install
+
+```
+npm install @trayjs/trayjs
+```
+
+The correct native binary for your platform is installed automatically.
+
+## Usage
+
+```js
+import { readFileSync } from 'node:fs';
+import { Tray } from '@trayjs/trayjs';
+
+const tray = new Tray({
+  tooltip: 'My App',
+  icon: readFileSync('icon.png'),
+  onMenuRequested: () => [
+    { id: 'open', title: 'Open' },
+    { separator: true },
+    { id: 'quit', title: 'Quit' },
+  ],
+  onClicked: (id) => {
+    if (id === 'quit') tray.quit();
+  },
+});
+
+tray.on('close', () => process.exit(0));
+```
+
+## API
+
+### `new Tray(options)`
+
+| Option | Type | Description |
+|--------|------|-------------|
+| `icon` | `Buffer` | PNG icon buffer |
+| `tooltip` | `string` | Tray tooltip text |
+| `onMenuRequested` | `() => MenuItem[] \| Promise<MenuItem[]>` | Called every time the tray menu is opened |
+| `onClicked` | `(id: string) => void` | Called when a menu item is clicked |
+
+### `MenuItem`
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` | `string` | Unique identifier |
+| `title` | `string` | Display text |
+| `tooltip` | `string` | Hover tooltip |
+| `enabled` | `boolean` | Clickable (default `true`) |
+| `checked` | `boolean` | Show check mark |
+| `separator` | `boolean` | Render as separator line |
+
+### Methods
+
+- `tray.setIcon(pngBuffer)` — update the icon at runtime
+- `tray.setTooltip(text)` — update the tooltip at runtime
+- `tray.quit()` — close the tray
+
+### Events
+
+- `'ready'` — tray is visible and accepting commands
+- `'close'` — tray process exited
+
+## Supported platforms
+
+| Platform | Package |
+|----------|---------|
+| Linux x64 | @trayjs/linux-x64 |
+| Linux arm64 | @trayjs/linux-arm64 |
+| macOS x64 | @trayjs/darwin-x64 |
+| macOS arm64 | @trayjs/darwin-arm64 |
+| Windows x64 | @trayjs/win32-x64 |
+| Windows arm64 | @trayjs/win32-arm64 |

package/index.mjs

@@ -0,0 +1,127 @@
+import { spawn } from 'node:child_process';
+import { createInterface } from 'node:readline';
+import { createRequire } from 'node:module';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { EventEmitter } from 'node:events';
+
+const require = createRequire(import.meta.url);
+const __dirname = dirname(fileURLToPath(import.meta.url));
+
+const PLATFORMS = {
+  'linux-x64':     '@trayjs/linux-x64',
+  'linux-arm64':   '@trayjs/linux-arm64',
+  'darwin-x64':    '@trayjs/darwin-x64',
+  'darwin-arm64':  '@trayjs/darwin-arm64',
+  'win32-x64':     '@trayjs/win32-x64',
+  'win32-arm64':   '@trayjs/win32-arm64',
+};
+
+const BIN_NAME = process.platform === 'win32' ? 'tray.exe' : 'tray';
+
+function getBinaryPath() {
+  const key = `${process.platform}-${process.arch}`;
+  const pkg = PLATFORMS[key];
+  if (!pkg)
+    throw new Error(`@trayjs/trayjs: unsupported platform ${key}`);
+  try {
+    // Published: resolve from installed optional dependency.
+    const pkgJson = require.resolve(`${pkg}/package.json`);
+    return join(dirname(pkgJson), 'bin', BIN_NAME);
+  } catch {
+    // Monorepo dev: binary is in sibling platform package.
+    return join(__dirname, '..', key, 'bin', BIN_NAME);
+  }
+}
+
+/**
+ * @typedef {object} MenuItem
+ * @property {string} id
+ * @property {string} [title]
+ * @property {string} [tooltip]
+ * @property {boolean} [enabled]
+ * @property {boolean} [checked]
+ * @property {boolean} [separator]
+ */
+
+/**
+ * @typedef {object} TrayOptions
+ * @property {Buffer} [icon] - PNG buffer for the tray icon
+ * @property {string} [tooltip]
+ * @property {() => MenuItem[] | Promise<MenuItem[]>} [onMenuRequested]
+ * @property {(id: string) => void} [onClicked]
+ */
+
+export class Tray extends EventEmitter {
+  #proc;
+  #rl;
+  #menuRequestedCb;
+  #clickedCb;
+  #pendingIcon;
+
+  /** @param {TrayOptions} opts */
+  constructor({ icon, tooltip, onMenuRequested, onClicked } = {}) {
+    super();
+    this.#menuRequestedCb = onMenuRequested;
+    this.#clickedCb = onClicked;
+    this.#pendingIcon = icon;
+
+    const bin = getBinaryPath();
+    const args = [];
+    if (tooltip) args.push('--tooltip', tooltip);
+
+    this.#proc = spawn(bin, args, {
+      stdio: ['pipe', 'pipe', 'inherit'],
+    });
+
+    this.#rl = createInterface({ input: this.#proc.stdout });
+    this.#rl.on('line', (line) => this.#handle(JSON.parse(line)));
+    this.#proc.on('close', (code) => this.emit('close', code));
+  }
+
+  #send(msg) {
+    this.#proc.stdin.write(JSON.stringify(msg) + '\n');
+  }
+
+  async #handle(msg) {
+    switch (msg.method) {
+      case 'ready':
+        if (this.#pendingIcon) {
+          this.setIcon(this.#pendingIcon);
+          this.#pendingIcon = null;
+        }
+        await this.#refreshMenu();
+        this.emit('ready');
+        break;
+      case 'menuRequested':
+        await this.#refreshMenu();
+        break;
+      case 'clicked':
+        this.#clickedCb?.(msg.params.id);
+        break;
+    }
+  }
+
+  async #refreshMenu() {
+    if (!this.#menuRequestedCb) return;
+    const items = await this.#menuRequestedCb();
+    this.#send({ method: 'setMenu', params: { items } });
+  }
+
+  /** @param {Buffer} pngBuffer */
+  setIcon(pngBuffer) {
+    this.#send({
+      method: 'setIcon',
+      params: { base64: pngBuffer.toString('base64') },
+    });
+  }
+
+  /** @param {string} text */
+  setTooltip(text) {
+    this.#send({ method: 'setTooltip', params: { text } });
+  }
+
+  quit() {
+    this.#send({ method: 'quit' });
+  }
+}

package/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "@trayjs/trayjs",
+  "version": "0.0.1",
+  "license": "Apache-2.0",
+  "type": "module",
+  "exports": "./index.mjs",
+  "files": [
+    "index.mjs"
+  ],
+  "optionalDependencies": {
+    "@trayjs/linux-x64": "0.0.1",
+    "@trayjs/linux-arm64": "0.0.1",
+    "@trayjs/darwin-x64": "0.0.1",
+    "@trayjs/darwin-arm64": "0.0.1",
+    "@trayjs/win32-x64": "0.0.1",
+    "@trayjs/win32-arm64": "0.0.1"
+  }
+}