plusui-native-core 0.1.104 → 0.1.106

package/Core/.claude/settings.local.json

@@ -0,0 +1,7 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(cmake:*)"
+    ]
+  }
+}

package/Core/CMakeLists.txt

@@ -231,7 +231,7 @@ else()
     pkg_check_modules(GTK3 REQUIRED gtk+-3.0)
     pkg_check_modules(WEBKIT2 REQUIRED webkit2gtk-4.0)
     target_include_directories(plusui PRIVATE ${GTK3_INCLUDE_DIRS} ${WEBKIT2_INCLUDE_DIRS})
-    target_link_libraries(plusui PRIVATE ${GTK3_LIBRARIES} ${WEBKIT2_LIBRARIES})
+    target_link_libraries(plusui PRIVATE ${GTK3_LIBRARIES} ${WEBKIT2_LIBRARIES} X11)
 endif()
 
 install(TARGETS plusui ARCHIVE DESTINATION lib)

package/Core/Features/API/Connect_API.ts

@@ -1,76 +1,44 @@
 /**
- * PlusUI Connect API — Semantic Frontend ↔ Backend Communication
+ * PlusUI Connect API — Custom Frontend ↔ Backend Communication
  *
- * ZERO CONFIG. SEMANTIC SYNTAX. ALL 5 PATTERNS.
- *
- * IMPORTANT: `connect` is for CUSTOM user-defined communication only!
- * Built-in features (window, clipboard, app, etc.) use direct imports:
- *   import plusui from 'plusui';
- *   plusui.window.minimize();
- *   plusui.clipboard.setText('hello');
- *
- * For custom communication, use `connect.namespace.method()`:
+ * Use `connect` for YOUR custom communication channels only!
  *
  *   import { connect } from 'plusui';
  *
- *   // Request/Response — await a call to the backend
+ *   // Request/Response
  *   const user = await connect.user.fetch(123);
  *
- *   // Fire & Forget — one-way notification
+ *   // Fire & Forget (one-way)
  *   connect.files.upload({ file: myFile });
  *
- *   // Event Listener — listen for backend events
+ *   // Subscribe to events
  *   connect.app.onNotify((msg) => console.log(msg));
  *
- *   // Register a handler — backend can call frontend
+ *   // Register handler (backend calls frontend)
  *   connect.ui.handlePrompt = async (data) => {
  *     return await Dialog.confirm(data.msg);
  *   };
  *
- * Then run `plusui connect` to generate typed bindings.
+ * Run `plusui connect` to generate typed bindings.
  *
- * Pattern detection is automatic:
- *   - `await connect.x.y()` → CALL (Request/Response)
- *   - `connect.x.onY(cb)` → EVENT (Subscribe)
- *   - `connect.x.handleY = fn` → HANDLER (Backend calls frontend)
- *   - `connect.x.y()` → FIRE (Simplex, one-way)
+ * BUILT-IN FEATURES use direct imports:
+ *   import plusui from 'plusui';
+ *   plusui.window.minimize();
+ *   plusui.clipboard.setText('hello');
  */
 
 import { connect, _client, createFeatureConnect } from '../Connection/connect';
 import type { FeatureConnect, ConnectionKind, ConnectionEnvelope } from '../Connection/connect';
 
-/**
- * connect — Semantic channel proxy
- *
- * Usage:
- *   connect.namespace.method(...args)
- *
- * The proxy routes to the correct wire format automatically:
- *   connect.user.fetch(123)         → _client.call('user.fetch', 123)
- *   connect.app.onNotify(cb)        → _client.on('app.onNotify', cb)
- *   connect.ui.handlePrompt = fn    → _client.handle('ui.handlePrompt', fn)
- *   connect.system.minimize()       → _client.fire('system.minimize', {})
- *
- * Works dynamically even before running `plusui connect`.
- * After running `plusui connect`, you get IDE autocomplete.
- */
-export { connect };
-
-/**
- * _client — Low-level connection client
- *
- * Direct access to the underlying client for advanced use cases.
- * Prefer using `connect.namespace.method()` for normal communication.
- */
-export { _client };
+export { connect, _client, createFeatureConnect };
+export type { FeatureConnect, ConnectionKind, ConnectionEnvelope };
 
 /**
- * createFeatureConnect — Scoped connect for framework internals
- *
- * Creates a connect API scoped to a feature namespace.
- * Used internally by PlusUI features like window, clipboard, etc.
+ * Low-level client methods (use `connect` instead when possible)
  */
-export { createFeatureConnect };
-
-export type { FeatureConnect, ConnectionKind, ConnectionEnvelope };
-export default connect;
+export type ClientAPI = {
+  call: <TOut = unknown, TIn = Record<string, unknown>>(name: string, payload: TIn) => Promise<TOut>;
+  fire: <TIn = Record<string, unknown>>(name: string, payload: TIn) => void;
+  on: <TData = unknown>(name: string, callback: (payload: TData) => void) => () => void;
+  handle: (name: string, handler: (...args: any[]) => any) => () => void;
+};

package/Core/Features/API/app-api.ts

@@ -1,28 +1,28 @@
-/**
- * App API
- *
- * Application lifecycle management: version, paths, badge, and lifecycle events.
- *
- * Actions:
- *   app.invoke(name, args)         - Call a named native method directly
- *   app.quit()                     - Quit the application
- *   app.getVersion()               - Get the application version string
- *   app.getName()                  - Get the application name
- *   app.getPath(name)              - Get a well-known path (home, appData, temp, etc.)
- *   app.setBadge(count)            - Set the taskbar/dock badge count
- *   app.getBadge()                 - Get the current badge count
- *   app.emit(event, payload)       - Dispatch a custom application event
- *
- * Events:
- *   app.onReady(cb)                - Fires when the app is fully initialized
- *   app.onQuit(cb)                 - Fires when the app is about to quit
- *   app.onActivate(cb)             - Fires when the app is re-activated (macOS dock click)
- *   app.onWindowAllClosed(cb)      - Fires when all windows are closed
- *   app.onSecondInstance(cb)       - Fires when a second instance is launched
- *   app.on(event, cb)              - Listen for any custom app event
- *   app.once(event, cb)            - Listen for a custom app event only once
- */
-
-export type { AppConfig } from '../App/app';
-
-export { app } from '../App/app';
+/**
+ * App API
+ *
+ * Application lifecycle management: version, paths, badge, and lifecycle events.
+ *
+ * Actions:
+ *   app.invoke(name, args)         - Call a named native method directly
+ *   app.quit()                     - Quit the application
+ *   app.getVersion()               - Get the application version string
+ *   app.getName()                  - Get the application name
+ *   app.getPath(name)              - Get a well-known path (home, appData, temp, etc.)
+ *   app.setBadge(count)            - Set the taskbar/dock badge count
+ *   app.getBadge()                 - Get the current badge count
+ *   app.emit(event, payload)       - Dispatch a custom application event
+ *
+ * Events:
+ *   app.onReady(cb)                - Fires when the app is fully initialized
+ *   app.onQuit(cb)                 - Fires when the app is about to quit
+ *   app.onActivate(cb)             - Fires when the app is re-activated (macOS dock click)
+ *   app.onWindowAllClosed(cb)      - Fires when all windows are closed
+ *   app.onSecondInstance(cb)       - Fires when a second instance is launched
+ *   app.on(event, cb)              - Listen for any custom app event
+ *   app.once(event, cb)            - Listen for a custom app event only once
+ */
+
+export type { AppConfig } from '../App/app';
+
+export { app } from '../App/app';

package/Core/Features/API/browser-api.ts

@@ -1,38 +1,38 @@
-/**
- * Browser API
- *
- * Control in-app browser navigation and receive page lifecycle events.
- *
- * Actions:
- *   browser.navigate(url)         - Navigate to a URL
- *   browser.open(url)             - Alias for navigate()
- *   browser.openExternal(url)     - Open a URL in the system default browser
- *   browser.openNewWindow(url)    - Open a URL in a new application window
- *   browser.goBack()              - Go back in navigation history
- *   browser.goForward()           - Go forward in navigation history
- *   browser.reload()              - Reload the current page
- *   browser.stop()                - Stop the current page load
- *   browser.getUrl()              - Get the current URL
- *   browser.getTitle()            - Get the current page title
- *   browser.getState()            - Get the full current browser state snapshot
- *   browser.canGoBack()           - Check if back navigation is possible
- *   browser.canGoForward()        - Check if forward navigation is possible
- *   browser.isLoading()           - Check if a page is currently loading
- *
- * Events:
- *   browser.onNavigate(cb)        - Fires when navigation occurs (URL change)
- *   browser.onStateChange(cb)     - Fires when any browser state changes
- *   browser.onLoadStart(cb)       - Fires when a page begins loading
- *   browser.onLoadEnd(cb)         - Fires when a page finishes loading
- *   browser.onLoadError(cb)       - Fires when a page load fails
- */
-
-export type {
-  BrowserState,
-  NavigateCallback,
-  StateCallback,
-  LoadCallback,
-  ErrorCallback,
-} from '../Browser/browser';
-
-export { browser } from '../Browser/browser';
+/**
+ * Browser API
+ *
+ * Control in-app browser navigation and receive page lifecycle events.
+ *
+ * Actions:
+ *   browser.navigate(url)         - Navigate to a URL
+ *   browser.open(url)             - Alias for navigate()
+ *   browser.openExternal(url)     - Open a URL in the system default browser
+ *   browser.openNewWindow(url)    - Open a URL in a new application window
+ *   browser.goBack()              - Go back in navigation history
+ *   browser.goForward()           - Go forward in navigation history
+ *   browser.reload()              - Reload the current page
+ *   browser.stop()                - Stop the current page load
+ *   browser.getUrl()              - Get the current URL
+ *   browser.getTitle()            - Get the current page title
+ *   browser.getState()            - Get the full current browser state snapshot
+ *   browser.canGoBack()           - Check if back navigation is possible
+ *   browser.canGoForward()        - Check if forward navigation is possible
+ *   browser.isLoading()           - Check if a page is currently loading
+ *
+ * Events:
+ *   browser.onNavigate(cb)        - Fires when navigation occurs (URL change)
+ *   browser.onStateChange(cb)     - Fires when any browser state changes
+ *   browser.onLoadStart(cb)       - Fires when a page begins loading
+ *   browser.onLoadEnd(cb)         - Fires when a page finishes loading
+ *   browser.onLoadError(cb)       - Fires when a page load fails
+ */
+
+export type {
+  BrowserState,
+  NavigateCallback,
+  StateCallback,
+  LoadCallback,
+  ErrorCallback,
+} from '../Browser/browser';
+
+export { browser } from '../Browser/browser';

package/Core/Features/API/clipboard-api.ts

@@ -1,21 +1,21 @@
-/**
- * Clipboard API
- *
- * Read from and write to the system clipboard. Supports text and images.
- *
- * Actions:
- *   clipboard.getText()        - Read text from clipboard
- *   clipboard.setText(text)    - Write text to clipboard
- *   clipboard.hasText()        - Check if clipboard has text
- *   clipboard.getImage()       - Read image as base64 data URL
- *   clipboard.setImage(b64)    - Write image from base64 data URL
- *   clipboard.hasImage()       - Check if clipboard has an image
- *   clipboard.clear()          - Clear the clipboard
- *
- * Events:
- *   clipboard.onChange(cb)     - Fires when clipboard content changes
- */
-
-export type { ClipboardAPI } from '../Clipboard/clipboard';
-
-export { clipboard } from '../Clipboard/clipboard';
+/**
+ * Clipboard API
+ *
+ * Read from and write to the system clipboard. Supports text and images.
+ *
+ * Actions:
+ *   clipboard.getText()        - Read text from clipboard
+ *   clipboard.setText(text)    - Write text to clipboard
+ *   clipboard.hasText()        - Check if clipboard has text
+ *   clipboard.getImage()       - Read image as base64 data URL
+ *   clipboard.setImage(b64)    - Write image from base64 data URL
+ *   clipboard.hasImage()       - Check if clipboard has an image
+ *   clipboard.clear()          - Clear the clipboard
+ *
+ * Events:
+ *   clipboard.onChange(cb)     - Fires when clipboard content changes
+ */
+
+export type { ClipboardAPI } from '../Clipboard/clipboard';
+
+export { clipboard } from '../Clipboard/clipboard';

package/Core/Features/API/display-api.ts

@@ -1,33 +1,33 @@
-/**
- * Display API
- *
- * Query and control connected monitors/screens.
- *
- * Actions:
- *   display.getAllDisplays()            - Get all connected displays
- *   display.getPrimaryDisplay()         - Get the primary display
- *   display.getDisplayAt(x, y)          - Get the display at a screen coordinate
- *   display.getDisplayAtCursor()        - Get the display under the cursor
- *   display.getDisplayById(id)          - Get a display by its ID
- *   display.setDisplayMode(id, mode)    - Change resolution/refresh rate
- *   display.setPosition(id, x, y)       - Reposition a display
- *   display.turnOff(id)                 - Turn off a display
- *   display.getScreenWidth()            - Get primary screen width in pixels
- *   display.getScreenHeight()           - Get primary screen height in pixels
- *   display.getScaleFactor()            - Get DPI scale factor
- *   display.getRefreshRate()            - Get refresh rate in Hz
- *
- * Events:
- *   display.onConnected(cb)             - Fires when a display is connected
- *   display.onDisconnected(cb)          - Fires when a display is disconnected
- *   display.onChanged(cb)               - Fires when a display configuration changes
- */
-
-export type {
-  Display,
-  DisplayMode,
-  DisplayBounds,
-  DisplayResolution,
-} from '../Display/display';
-
-export { display } from '../Display/display';
+/**
+ * Display API
+ *
+ * Query and control connected monitors/screens.
+ *
+ * Actions:
+ *   display.getAllDisplays()            - Get all connected displays
+ *   display.getPrimaryDisplay()         - Get the primary display
+ *   display.getDisplayAt(x, y)          - Get the display at a screen coordinate
+ *   display.getDisplayAtCursor()        - Get the display under the cursor
+ *   display.getDisplayById(id)          - Get a display by its ID
+ *   display.setDisplayMode(id, mode)    - Change resolution/refresh rate
+ *   display.setPosition(id, x, y)       - Reposition a display
+ *   display.turnOff(id)                 - Turn off a display
+ *   display.getScreenWidth()            - Get primary screen width in pixels
+ *   display.getScreenHeight()           - Get primary screen height in pixels
+ *   display.getScaleFactor()            - Get DPI scale factor
+ *   display.getRefreshRate()            - Get refresh rate in Hz
+ *
+ * Events:
+ *   display.onConnected(cb)             - Fires when a display is connected
+ *   display.onDisconnected(cb)          - Fires when a display is disconnected
+ *   display.onChanged(cb)               - Fires when a display configuration changes
+ */
+
+export type {
+  Display,
+  DisplayMode,
+  DisplayBounds,
+  DisplayResolution,
+} from '../Display/display';
+
+export { display } from '../Display/display';

package/Core/Features/API/keyboard-api.ts

@@ -1,33 +1,33 @@
-/**
- * Keyboard API
- *
- * Listen for key events and register global shortcuts.
- *
- * Actions:
- *   keyboard.isKeyPressed(key)                       - Check if a key is currently held down
- *   keyboard.setAutoRepeat(enabled)                  - Enable/disable key auto-repeat
- *   keyboard.getAutoRepeat()                         - Get auto-repeat state
- *   keyboard.registerShortcut(id, shortcut, cb)      - Register a global keyboard shortcut
- *   keyboard.unregisterShortcut(id)                  - Remove a registered shortcut
- *   keyboard.clearShortcuts()                        - Remove all registered shortcuts
- *   keyboard.parseShortcut('Ctrl+S')                 - Parse a shortcut string into a Shortcut object
- *   keyboard.keyNameToCode('enter')                  - Convert a key name string to a KeyCode
- *
- * Events:
- *   keyboard.onKeyDown(cb)   - Fires when any key is pressed
- *   keyboard.onKeyUp(cb)     - Fires when any key is released
- *   keyboard.onShortcut(cb)  - Fires when a registered shortcut is triggered
- *
- * Enums:
- *   KeyCode  - Key codes (e.g. KeyCode.Enter, KeyCode.F5)
- *   KeyMod   - Modifier flags (e.g. KeyMod.Control, KeyMod.Shift)
- */
-
-export type {
-  KeyEvent,
-  Shortcut,
-  KeyEventCallback,
-  ShortcutCallback,
-} from '../Keyboard/keyboard';
-
-export { KeyCode, KeyMod, keyboard } from '../Keyboard/keyboard';
+/**
+ * Keyboard API
+ *
+ * Listen for key events and register global shortcuts.
+ *
+ * Actions:
+ *   keyboard.isKeyPressed(key)                       - Check if a key is currently held down
+ *   keyboard.setAutoRepeat(enabled)                  - Enable/disable key auto-repeat
+ *   keyboard.getAutoRepeat()                         - Get auto-repeat state
+ *   keyboard.registerShortcut(id, shortcut, cb)      - Register a global keyboard shortcut
+ *   keyboard.unregisterShortcut(id)                  - Remove a registered shortcut
+ *   keyboard.clearShortcuts()                        - Remove all registered shortcuts
+ *   keyboard.parseShortcut('Ctrl+S')                 - Parse a shortcut string into a Shortcut object
+ *   keyboard.keyNameToCode('enter')                  - Convert a key name string to a KeyCode
+ *
+ * Events:
+ *   keyboard.onKeyDown(cb)   - Fires when any key is pressed
+ *   keyboard.onKeyUp(cb)     - Fires when any key is released
+ *   keyboard.onShortcut(cb)  - Fires when a registered shortcut is triggered
+ *
+ * Enums:
+ *   KeyCode  - Key codes (e.g. KeyCode.Enter, KeyCode.F5)
+ *   KeyMod   - Modifier flags (e.g. KeyMod.Control, KeyMod.Shift)
+ */
+
+export type {
+  KeyEvent,
+  Shortcut,
+  KeyEventCallback,
+  ShortcutCallback,
+} from '../Keyboard/keyboard';
+
+export { KeyCode, KeyMod, keyboard } from '../Keyboard/keyboard';

package/Core/Features/API/menu-api.ts

@@ -1,39 +1,39 @@
-/**
- * Menu API
- *
- * Build and control native context menus and application menu bars.
- *
- * Actions:
- *   menu.create(items)                    - Create a menu and return its ID
- *   menu.popup(id, x, y)                  - Show a menu at a screen position
- *   menu.popupAtCursor(id)                - Show a menu at the current cursor position
- *   menu.close(id)                        - Close an open menu
- *   menu.destroy(id)                      - Destroy a menu and free resources
- *   menu.setApplicationMenu(items)        - Set the application-level menu bar
- *   menu.getApplicationMenu()             - Get the current application menu items
- *   menu.appendToMenuBar(item)            - Append an item to the menu bar
- *   menu.showContextMenu(items, options)  - Create and show a context menu in one call
- *   menu.dispose()                        - Clear all internal click handlers
- *
- * Builder helpers (return pre-built MenuItem trees):
- *   menu.createFileMenu(handlers)         - Standard File menu (New, Open, Save, Exit)
- *   menu.createEditMenu(handlers)         - Standard Edit menu (Undo, Cut, Copy, Paste)
- *   menu.createViewMenu(handlers)         - Standard View menu (Zoom, Fullscreen, DevTools)
- *   menu.createTextContextMenu()          - Right-click menu for text fields
- *   menu.createImageContextMenu()         - Right-click menu for images
- *   menu.createLinkContextMenu()          - Right-click menu for links
- *
- * Events:
- *   menu.onItemClick(cb)                  - Fires when any menu item is clicked
- *   menu.onContextOpen(cb)                - Fires when a context menu is about to open
- */
-
-export type {
-  MenuItem,
-  MenuItemType,
-  MenuBarData,
-  ContextMenuOptions,
-  ContextInfo,
-} from '../Menu/menu';
-
-export { menu } from '../Menu/menu';
+/**
+ * Menu API
+ *
+ * Build and control native context menus and application menu bars.
+ *
+ * Actions:
+ *   menu.create(items)                    - Create a menu and return its ID
+ *   menu.popup(id, x, y)                  - Show a menu at a screen position
+ *   menu.popupAtCursor(id)                - Show a menu at the current cursor position
+ *   menu.close(id)                        - Close an open menu
+ *   menu.destroy(id)                      - Destroy a menu and free resources
+ *   menu.setApplicationMenu(items)        - Set the application-level menu bar
+ *   menu.getApplicationMenu()             - Get the current application menu items
+ *   menu.appendToMenuBar(item)            - Append an item to the menu bar
+ *   menu.showContextMenu(items, options)  - Create and show a context menu in one call
+ *   menu.dispose()                        - Clear all internal click handlers
+ *
+ * Builder helpers (return pre-built MenuItem trees):
+ *   menu.createFileMenu(handlers)         - Standard File menu (New, Open, Save, Exit)
+ *   menu.createEditMenu(handlers)         - Standard Edit menu (Undo, Cut, Copy, Paste)
+ *   menu.createViewMenu(handlers)         - Standard View menu (Zoom, Fullscreen, DevTools)
+ *   menu.createTextContextMenu()          - Right-click menu for text fields
+ *   menu.createImageContextMenu()         - Right-click menu for images
+ *   menu.createLinkContextMenu()          - Right-click menu for links
+ *
+ * Events:
+ *   menu.onItemClick(cb)                  - Fires when any menu item is clicked
+ *   menu.onContextOpen(cb)                - Fires when a context menu is about to open
+ */
+
+export type {
+  MenuItem,
+  MenuItemType,
+  MenuBarData,
+  ContextMenuOptions,
+  ContextInfo,
+} from '../Menu/menu';
+
+export { menu } from '../Menu/menu';

package/Core/Features/API/router-api.ts

@@ -1,23 +1,23 @@
-/**
- * Router API
- *
- * Map route paths to frontend URLs and navigate between them across windows.
- * Works with any frontend router (React Router, TanStack Router, Solid Router, etc.).
- *
- * Actions:
- *   router.setRoutes(routes)           - Define the route map ({ '/settings': 'http://...' })
- *   router.getRoutes()                 - Get the current route map
- *   router.push(route, windowId?)      - Navigate to a route (adds to history)
- *   router.replace(route, windowId?)   - Navigate to a route (replaces history entry)
- *   router.getCurrentRoute(windowId?)  - Get the current route for a window
- *   router.setInitialRoute(route)      - Set the route loaded on app startup
- *   router.emit(name, payload)         - Send a message on a router feature channel
- *   router.on(name, cb)                - Listen on a router feature channel
- *
- * Events:
- *   router.onRouteChange(cb)           - Fires when the route changes (from backend or other windows)
- */
-
-export type { RouteMap, RouteChangeCallback, RouteConfig } from '../Router/router';
-
-export { router } from '../Router/router';
+/**
+ * Router API
+ *
+ * Map route paths to frontend URLs and navigate between them across windows.
+ * Works with any frontend router (React Router, TanStack Router, Solid Router, etc.).
+ *
+ * Actions:
+ *   router.setRoutes(routes)           - Define the route map ({ '/settings': 'http://...' })
+ *   router.getRoutes()                 - Get the current route map
+ *   router.push(route, windowId?)      - Navigate to a route (adds to history)
+ *   router.replace(route, windowId?)   - Navigate to a route (replaces history entry)
+ *   router.getCurrentRoute(windowId?)  - Get the current route for a window
+ *   router.setInitialRoute(route)      - Set the route loaded on app startup
+ *   router.emit(name, payload)         - Send a message on a router feature channel
+ *   router.on(name, cb)                - Listen on a router feature channel
+ *
+ * Events:
+ *   router.onRouteChange(cb)           - Fires when the route changes (from backend or other windows)
+ */
+
+export type { RouteMap, RouteChangeCallback, RouteConfig } from '../Router/router';
+
+export { router } from '../Router/router';

package/Core/Features/API/tray-api.ts

@@ -1,22 +1,22 @@
-/**
- * Tray API
- *
- * Manage the system tray icon: icon, tooltip, visibility, and context menu.
- *
- * Actions:
- *   tray.setIcon(path)          - Set the tray icon image
- *   tray.setTooltip(text)       - Set the hover tooltip text
- *   tray.setVisible(visible)    - Show or hide the tray icon
- *   tray.setMenu(items)         - Set the full tray menu
- *   tray.setContextMenu(items)  - Set the right-click context menu
- *
- * Events:
- *   tray.onClick(cb)            - Fires on left click
- *   tray.onDoubleClick(cb)      - Fires on double click
- *   tray.onRightClick(cb)       - Fires on right click
- *   tray.onMenuItemClick(cb)    - Fires when a menu item is selected
- */
-
-export type { TrayMenuItem, TrayIconData } from '../Tray/tray';
-
-export { tray } from '../Tray/tray';
+/**
+ * Tray API
+ *
+ * Manage the system tray icon: icon, tooltip, visibility, and context menu.
+ *
+ * Actions:
+ *   tray.setIcon(path)          - Set the tray icon image
+ *   tray.setTooltip(text)       - Set the hover tooltip text
+ *   tray.setVisible(visible)    - Show or hide the tray icon
+ *   tray.setMenu(items)         - Set the full tray menu
+ *   tray.setContextMenu(items)  - Set the right-click context menu
+ *
+ * Events:
+ *   tray.onClick(cb)            - Fires on left click
+ *   tray.onDoubleClick(cb)      - Fires on double click
+ *   tray.onRightClick(cb)       - Fires on right click
+ *   tray.onMenuItemClick(cb)    - Fires when a menu item is selected
+ */
+
+export type { TrayMenuItem, TrayIconData } from '../Tray/tray';
+
+export { tray } from '../Tray/tray';