plusui-native-core 0.1.86 → 0.1.89

package/Core/CMakeLists.txt

@@ -36,6 +36,7 @@ add_library(plusui STATIC
     Features/Menu/menu.cpp
     Features/Keyboard/keyboard.cpp
     Features/Connection/connect.cpp
+    Features/Router/router.cpp
     Features/WebGPU/webgpu.cpp
 )
 

package/Core/{API → Features/API}/Connect_API.ts

@@ -22,7 +22,7 @@
  * And generates typed channel objects for both frontend and backend.
  */
 
-import { _client } from '../Features/Connection/connect';
+import { _client } from '../Connection/connect';
 
 /**
  * Channel object returned by createChannel()

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

@@ -0,0 +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';

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

@@ -0,0 +1,40 @@
+/**
+ * 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
+ *   browser.emit(name, payload)   - Send a message on a browser feature channel
+ *   browser.on(name, cb)          - Listen on a browser feature channel
+ *
+ * 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

@@ -0,0 +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';

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

@@ -0,0 +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';

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

@@ -0,0 +1,43 @@
+/**
+ * FileDrop API
+ *
+ * Handle files dragged and dropped onto the application window.
+ * Also supports initiating drag operations from the app.
+ *
+ * Actions:
+ *   fileDrop.setEnabled(enabled)       - Enable or disable file drop
+ *   fileDrop.isEnabled()               - Check if file drop is enabled
+ *   fileDrop.startDrag(filePaths)      - Start a drag operation with the given files
+ *   fileDrop.clearCallbacks()          - Remove all registered drop callbacks
+ *
+ * Events:
+ *   fileDrop.onFilesDropped(cb)        - Fires when files are dropped onto the window
+ *   fileDrop.onDragEnter(cb)           - Fires when a drag enters the window
+ *   fileDrop.onDragLeave(cb)           - Fires when a drag leaves the window
+ *
+ * Helpers (pure functions):
+ *   readFileAsText(path)               - Read a file path as a text string
+ *   readFileAsDataUrl(path)            - Read a file path as a base64 data URL
+ *   filterFilesByExtension(files, ext) - Filter FileInfo[] by extension(s)
+ *   filterFilesByMimeType(files, mime) - Filter FileInfo[] by MIME type(s)
+ *   isImageFile(file)                  - Check if FileInfo is an image
+ *   isVideoFile(file)                  - Check if FileInfo is a video
+ *   isAudioFile(file)                  - Check if FileInfo is audio
+ *   isTextFile(file)                   - Check if FileInfo is a text file
+ *   formatFileSize(bytes)              - Format byte count as a human-readable string
+ */
+
+export type { FileInfo, DragEvent, FileDropAPI } from '../FileDrop/filedrop';
+
+export {
+  fileDrop,
+  readFileAsText,
+  readFileAsDataUrl,
+  filterFilesByExtension,
+  filterFilesByMimeType,
+  isImageFile,
+  isVideoFile,
+  isAudioFile,
+  isTextFile,
+  formatFileSize,
+} from '../FileDrop/filedrop';

package/Core/{API → Features/API}/index.ts

@@ -1,19 +1,19 @@
 /**
  * PlusUI API - Unified Entry Point
- * 
+ *
  * TWO DISTINCT PATTERNS:
- * 
+ *
  * 1. BUILT-IN FEATURES - Direct methods only (NO .on/.emit)
  *    window.setTitle('My App');
  *    window.minimize();
  *    clipboard.setText('hello');
  *    window.onResize((size) => { ... });
- * 
+ *
  * 2. CUSTOM CHANNELS - Use .on() and .emit()
  *    const search = createChannel('search');
  *    search.emit({ query: 'test' });
  *    search.on((result) => { ... });
- * 
+ *
  * The `plusui connect` CLI scans your codebase for name.on() and name.emit()
  * and generates typed channel objects for both frontend and backend.
  */
@@ -67,19 +67,20 @@ if (typeof window !== 'undefined') {
 
 // ============================================================
 // BUILT-IN FEATURES - Direct methods only (NO .on/.emit)
+// Each feature has its own dedicated API file in this directory.
 // ============================================================
 
-export { window } from '../Features/Window/window';
-export { clipboard } from '../Features/Clipboard/clipboard';
-export { keyboard } from '../Features/Keyboard/keyboard';
-export { tray } from '../Features/Tray/tray';
-export { display } from '../Features/Display/display';
-export { fileDrop } from '../Features/FileDrop/filedrop';
-export { menu } from '../Features/Menu/menu';
-export { app } from '../Features/App/app';
-export { gpu } from '../Features/WebGPU/webgpu';
-export { browser } from '../Features/Browser/browser';
-export { router } from '../Features/Router/router';
+export { window } from './window-api';
+export { clipboard } from './clipboard-api';
+export { keyboard, KeyCode, KeyMod } from './keyboard-api';
+export { tray } from './tray-api';
+export { display } from './display-api';
+export { fileDrop } from './filedrop-api';
+export { menu } from './menu-api';
+export { app } from './app-api';
+export { gpu, GPUBufferUsage, GPUTextureUsage, GPUMapMode, GPUShaderStage, GPUColorWrite } from './webgpu-api';
+export { browser } from './browser-api';
+export { router } from './router-api';
 
 // ============================================================
 // CUSTOM CHANNELS - For user-defined events (uses .on/.emit)
@@ -93,7 +94,7 @@ export {
 } from './Connect_API';
 
 // Internal export for connection generator
-export { _client } from '../Features/Connection/connect';
+export { _client } from '../Connection/connect';
 
 // ============================================================
 // TYPES - Re-exported for convenience
@@ -105,38 +106,27 @@ export type {
   WindowRect,
   WindowState,
   WindowId
-} from '../Features/Window/window';
+} from './window-api';
 
-export type {
-  ClipboardAPI
-} from '../Features/Clipboard/clipboard';
+export type { ClipboardAPI } from './clipboard-api';
 
 export type {
   KeyEvent,
   Shortcut,
   KeyEventCallback,
   ShortcutCallback,
-  KeyCode,
-  KeyMod
-} from '../Features/Keyboard/keyboard';
+} from './keyboard-api';
 
-export type {
-  TrayMenuItem,
-  TrayIconData
-} from '../Features/Tray/tray';
+export type { TrayMenuItem, TrayIconData } from './tray-api';
 
 export type {
   Display,
   DisplayMode,
   DisplayBounds,
   DisplayResolution
-} from '../Features/Display/display';
+} from './display-api';
 
-export type {
-  FileInfo,
-  DragEvent,
-  FileDropAPI
-} from '../Features/FileDrop/filedrop';
+export type { FileInfo, DragEvent, FileDropAPI } from './filedrop-api';
 
 export type {
   MenuItem,
@@ -144,11 +134,9 @@ export type {
   MenuBarData,
   ContextMenuOptions,
   ContextInfo
-} from '../Features/Menu/menu';
+} from './menu-api';
 
-export type {
-  AppConfig
-} from '../Features/App/app';
+export type { AppConfig } from './app-api';
 
 export type {
   GPUAdapter,
@@ -160,7 +148,17 @@ export type {
   GPUComputePipeline,
   GPUQueue,
   GPUCommandEncoder
-} from '../Features/WebGPU/webgpu';
+} from './webgpu-api';
+
+export type {
+  BrowserState,
+  NavigateCallback,
+  StateCallback,
+  LoadCallback,
+  ErrorCallback,
+} from './browser-api';
+
+export type { RouteMap, RouteChangeCallback, RouteConfig } from './router-api';
 
 // ============================================================
 // HELPER FUNCTIONS
@@ -176,28 +174,28 @@ export {
   isAudioFile,
   isTextFile,
   formatFileSize
-} from '../Features/FileDrop/filedrop';
+} from './filedrop-api';
 
 // ============================================================
 // DEFAULT EXPORT - For `import plusui from 'plusui'` convenience
 // ============================================================
 
-import { window } from '../Features/Window/window';
-import { clipboard } from '../Features/Clipboard/clipboard';
-import { keyboard } from '../Features/Keyboard/keyboard';
-import { tray } from '../Features/Tray/tray';
-import { display } from '../Features/Display/display';
-import { fileDrop, formatFileSize } from '../Features/FileDrop/filedrop';
-import { menu } from '../Features/Menu/menu';
-import { app } from '../Features/App/app';
-import { gpu } from '../Features/WebGPU/webgpu';
-import { browser } from '../Features/Browser/browser';
-import { router } from '../Features/Router/router';
+import { window } from './window-api';
+import { clipboard } from './clipboard-api';
+import { keyboard } from './keyboard-api';
+import { tray } from './tray-api';
+import { display } from './display-api';
+import { fileDrop, formatFileSize } from './filedrop-api';
+import { menu } from './menu-api';
+import { app } from './app-api';
+import { gpu } from './webgpu-api';
+import { browser } from './browser-api';
+import { router } from './router-api';
 import { connect, createChannel, createFeatureConnect } from './Connect_API';
 
 const plusui = {
   window,
-  win: window, // Alias for backward compatibility 
+  win: window, // Alias for backward compatibility
   clipboard,
   keyboard,
   tray,
@@ -205,6 +203,7 @@ const plusui = {
   fileDrop,
   menu,
   app,
+  api: app,
   gpu,
   browser,
   router,

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

@@ -0,0 +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';

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

@@ -0,0 +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';

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

@@ -0,0 +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';

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

@@ -0,0 +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';

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

@@ -0,0 +1,55 @@
+/**
+ * WebGPU API
+ *
+ * GPU-accelerated rendering and compute via the WebGPU standard.
+ *
+ * Actions:
+ *   gpu.requestAdapter(options?)       - Request a GPU adapter (entry point for WebGPU)
+ *   gpu.getPreferredCanvasFormat()     - Get the preferred swap-chain texture format
+ *
+ * Events:
+ *   gpu.onAdapterLost(cb)              - Fires when the GPU adapter is lost
+ *   gpu.onDeviceLost(cb)               - Fires when the GPU device is lost
+ *   gpu.onError(cb)                    - Fires on GPU errors
+ *
+ * Core types (mirrors the WebGPU spec):
+ *   GPUAdapter, GPUDevice, GPUBuffer, GPUTexture, GPUTextureView
+ *   GPUSampler, GPUShaderModule, GPURenderPipeline, GPUComputePipeline
+ *   GPUBindGroup, GPUBindGroupLayout, GPUCommandEncoder
+ *   GPURenderPassEncoder, GPUComputePassEncoder, GPUQueue, GPUCommandBuffer
+ *
+ * Usage flags / constants:
+ *   GPUBufferUsage, GPUTextureUsage, GPUMapMode, GPUShaderStage, GPUColorWrite
+ */
+
+export type {
+  GPUAdapter,
+  GPUAdapterInfo,
+  GPUDevice,
+  GPUDeviceLostInfo,
+  GPUBuffer,
+  GPUTexture,
+  GPUTextureView,
+  GPUSampler,
+  GPUShaderModule,
+  GPURenderPipeline,
+  GPUComputePipeline,
+  GPUBindGroupLayout,
+  GPUBindGroup,
+  GPUCommandEncoder,
+  GPURenderPassEncoder,
+  GPUComputePassEncoder,
+  GPUQueue,
+  GPUCommandBuffer,
+  GPURequestAdapterOptions,
+  GPUDeviceDescriptor,
+} from '../WebGPU/webgpu';
+
+export {
+  gpu,
+  GPUBufferUsage,
+  GPUTextureUsage,
+  GPUMapMode,
+  GPUShaderStage,
+  GPUColorWrite,
+} from '../WebGPU/webgpu';

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

@@ -0,0 +1,52 @@
+/**
+ * Window API
+ *
+ * Controls native window behavior: visibility, size, position, decorations, and events.
+ *
+ * Actions:
+ *   window.show()           - Make the window visible
+ *   window.hide()           - Hide the window
+ *   window.minimize()       - Minimize to taskbar
+ *   window.maximize()       - Maximize to screen
+ *   window.restore()        - Restore from minimized/maximized
+ *   window.close()          - Close the window
+ *   window.center()         - Center on screen
+ *   window.focus()          - Bring to front and focus
+ *   window.setTitle(title)  - Set the title bar text
+ *   window.setSize(w, h)    - Resize the window
+ *   window.setPosition(x,y) - Move the window
+ *   window.setFullscreen(b) - Enter/exit fullscreen
+ *   window.setAlwaysOnTop(b)- Pin above other windows
+ *   window.setResizable(b)  - Allow/disallow resizing
+ *   window.setDecorations(b)- Show/hide title bar and borders
+ *   window.setTransparency(a)- Set window opacity (0–1)
+ *   window.setIcon(path)    - Set the window icon
+ *   window.getSize()        - Get current size
+ *   window.getPosition()    - Get current position
+ *   window.getRect()        - Get position + size together
+ *   window.getState()       - Get full window state
+ *   window.isMaximized()    - Check if maximized
+ *   window.isMinimized()    - Check if minimized
+ *   window.isVisible()      - Check if visible
+ *
+ * Events:
+ *   window.onResize(cb)     - Fires when window is resized
+ *   window.onMove(cb)       - Fires when window is moved
+ *   window.onClose(cb)      - Fires when window is closed
+ *   window.onFocus(cb)      - Fires when focus changes
+ *   window.onStateChange(cb)- Fires on any state change
+ *   window.onMinimize(cb)   - Fires when minimized
+ *   window.onMaximize(cb)   - Fires when maximized
+ *   window.onRestore(cb)    - Fires when restored
+ *   window.onFileDrop(cb)   - Fires when files are dropped onto window
+ */
+
+export type {
+  WindowSize,
+  WindowPosition,
+  WindowRect,
+  WindowState,
+  WindowId,
+} from '../Window/window';
+
+export { window } from '../Window/window';

package/Core/Features/App/app.cpp

@@ -3,9 +3,7 @@
 #include <windows.h>
 #endif
 
-#include <plusui/app.hpp>
-#include <plusui/tray.hpp>
-#include <plusui/window.hpp>
+#include <plusui/plusui.hpp>
 
 namespace plusui {
 

package/Core/Features/App/app.ts

@@ -1,15 +1,4 @@
-/**
- * App API - Application lifecycle
- * 
- * Direct method calls - no .on/.emit
- * 
- * Usage:
- *   import { app } from '@plusui/api';
- *   
- *   app.quit();
- *   app.onReady(() => { ... });
- *   app.onQuit(() => { ... });
- */
+import { plusui } from "@plusui";
 
 export interface AppConfig {
   title?: string;
@@ -91,7 +80,7 @@ async function invoke<T = unknown>(name: string, args?: unknown[], options: Invo
 
 function eventHandler(event: string, callback: (...args: unknown[]) => void): () => void {
   init();
-  
+
   if (!_event) {
     if (typeof window !== 'undefined' && (window as any).__on__) {
       _event = (window as any).__on__;

package/Core/Features/Browser/browser.ts

@@ -1,4 +1,4 @@
-import { connect } from '../Connection/connect';
+import { plusui } from "@plusui";
 
 export interface BrowserState {
   url: string;
@@ -24,7 +24,8 @@ async function invoke(method: string, args?: unknown[]): Promise<unknown> {
     if (typeof window !== 'undefined' && (window as any).__invoke__) {
       _invoke = (window as any).__invoke__;
     } else {
-      throw new Error('Browser API not initialized');
+      console.warn(`[PlusUI] Browser API not initialized: __invoke__ missing. Running in mock mode for '${method}'.`);
+      return Promise.resolve(null);
     }
   }
   return _invoke!(method, args);

package/Core/Features/Router/router.cpp

@@ -0,0 +1,62 @@
+#include <plusui/router.hpp>
+
+namespace plusui {
+
+struct Router::Impl {
+    std::map<std::string, std::string> routes;
+    std::string initialRoute = "/";
+    std::map<std::string, std::string> currentRoutes;
+    std::vector<RouteChangeCallback> callbacks;
+};
+
+Router::Router() : pImpl(std::make_unique<Impl>()) {}
+Router::~Router() = default;
+
+Router& Router::instance() {
+    static Router router;
+    return router;
+}
+
+void Router::setRoutes(const std::map<std::string, std::string>& routes) {
+    pImpl->routes = routes;
+}
+
+std::map<std::string, std::string> Router::getRoutes() const {
+    return pImpl->routes;
+}
+
+void Router::push(const std::string& route, const std::string& windowId) {
+    std::string wid = windowId.empty() ? "__main__" : windowId;
+    pImpl->currentRoutes[wid] = route;
+    for (auto& cb : pImpl->callbacks) {
+        cb(route, wid);
+    }
+}
+
+void Router::replace(const std::string& route, const std::string& windowId) {
+    std::string wid = windowId.empty() ? "__main__" : windowId;
+    pImpl->currentRoutes[wid] = route;
+    for (auto& cb : pImpl->callbacks) {
+        cb(route, wid);
+    }
+}
+
+std::string Router::getCurrentRoute(const std::string& windowId) const {
+    std::string wid = windowId.empty() ? "__main__" : windowId;
+    auto it = pImpl->currentRoutes.find(wid);
+    if (it != pImpl->currentRoutes.end()) {
+        return it->second;
+    }
+    return pImpl->initialRoute;
+}
+
+void Router::setInitialRoute(const std::string& route) {
+    pImpl->initialRoute = route;
+    pImpl->currentRoutes["__main__"] = route;
+}
+
+void Router::onRouteChange(RouteChangeCallback callback) {
+    pImpl->callbacks.push_back(std::move(callback));
+}
+
+} // namespace plusui

package/Core/Features/Router/router.ts

@@ -33,7 +33,8 @@ async function invoke(method: string, args?: unknown[]): Promise<unknown> {
         if (typeof window !== 'undefined' && (window as any).__invoke__) {
             _invoke = (window as any).__invoke__;
         } else {
-            throw new Error('Router API not initialized');
+            console.warn(`[PlusUI] Router API not initialized: __invoke__ missing. Running in mock mode for '${method}'.`);
+            return Promise.resolve(null);
         }
     }
     return _invoke!(method, args);

package/Core/include/plusui/api.hpp

@@ -0,0 +1,237 @@
+#pragma once
+
+/**
+ * PlusUI C++ API
+ *
+ * Mirrors: Core/Features/API/index.ts
+ *
+ * ONE INCLUDE. ALL FEATURES.
+ *
+ *   #include <plusui/plusui>   // get everything
+ *   using namespace plusui;
+ *
+ * ─────────────────────────────────────────────────────────────────────────────
+ * FEATURE MAP  (C++ class ↔ TypeScript object)
+ * ─────────────────────────────────────────────────────────────────────────────
+ *
+ *  TypeScript          C++ class / accessor       Header
+ *  ─────────────────── ────────────────────────── ──────────────────
+ *  window              Window                     window.hpp
+ *  app / createApp()   App, App::Builder          app.hpp
+ *  browser             Browser                    browser.hpp
+ *  clipboard           Clipboard                  clipboard.hpp
+ *  keyboard            Keyboard                   keyboard.hpp
+ *  tray                TrayManager                tray.hpp
+ *  display             DisplayManager             display.hpp
+ *  menu                MenuManager                menu.hpp
+ *  router              Router                     router.hpp
+ *  fileDrop            FileDrop                   filedrop.hpp
+ *  gpu                 WebGPU                     webgpu.hpp
+ *  connect             Connect                    connect.hpp
+ *
+ * ─────────────────────────────────────────────────────────────────────────────
+ * FRONTEND ↔ BACKEND MIRROR
+ * ─────────────────────────────────────────────────────────────────────────────
+ *
+ * IMPORT / INCLUDE
+ *   TS:   import plusui from 'plusui'
+ *   C++:  #include <plusui/plusui>
+ *         using namespace plusui;
+ *
+ * ── WINDOW ───────────────────────────────────────────────────────────────────
+ * Actions
+ *   TS:   window.show()                   C++:  win.show()
+ *   TS:   window.hide()                   C++:  win.hide()
+ *   TS:   window.minimize()               C++:  win.minimize()
+ *   TS:   window.maximize()               C++:  win.maximize()
+ *   TS:   window.restore()                C++:  win.restore()
+ *   TS:   window.close()                  C++:  win.close()
+ *   TS:   window.center()                 C++:  win.center()
+ *   TS:   window.focus()                  C++:  win.focus()
+ *   TS:   window.setTitle("My App")       C++:  win.setTitle("My App")
+ *   TS:   window.setSize(800, 600)        C++:  win.setSize(800, 600)
+ *   TS:   window.setPosition(100, 100)    C++:  win.setPosition(100, 100)
+ *   TS:   window.setFullscreen(true)      C++:  win.setFullscreen(true)
+ *   TS:   window.setAlwaysOnTop(true)     C++:  win.setAlwaysOnTop(true)
+ *   TS:   window.setResizable(false)      C++:  win.setResizable(false)
+ *   TS:   window.setDecorations(false)    C++:  win.setDecorations(false)
+ *   TS:   window.setTransparency(0.5)     C++:  win.setOpacity(0.5)
+ *   TS:   window.setIcon(path)            C++:  win.setIconFromMemory(data, size)
+ *   TS:   window.isMaximized()            C++:  win.isMaximized()
+ *   TS:   window.isMinimized()            C++:  win.isMinimized()
+ *   TS:   window.isVisible()              C++:  win.isVisible()
+ * Events
+ *   TS:   window.onResize(cb)             C++:  win.onResize(cb)
+ *   TS:   window.onMove(cb)               C++:  win.onMove(cb)
+ *   TS:   window.onClose(cb)              C++:  win.onClose(cb)
+ *   TS:   window.onFocus(cb)              C++:  win.onFocus(cb)
+ *   TS:   window.onStateChange(cb)        C++:  win.onStateChange(cb)
+ *   TS:   window.onFileDrop(cb)           C++:  win.onFileDrop(cb)
+ *
+ * ── APP ──────────────────────────────────────────────────────────────────────
+ *   TS:   createApp()                     C++:  createApp()
+ *     .title("My App")                          .title("My App")
+ *     .width(1200)                              .width(1200)
+ *     .height(800)                              .height(800)
+ *     .devtools(true)                           .devtools(true)
+ *     .enableFileDrop(true);                    .enableFileDrop(true)
+ *                                               .build()   ← returns Window
+ *   TS:   app.quit()                      C++:  app.quit()
+ *   TS:   app.onReady(cb)                 C++:  (start after build())
+ *   TS:   app.onQuit(cb)                  C++:  app.run()  ← blocks until quit
+ *
+ * ── ROUTER ───────────────────────────────────────────────────────────────────
+ *   TS:   router.setRoutes({'/': url})    C++:  Router::instance().setRoutes({...})
+ *   TS:   router.push("/settings")        C++:  Router::instance().push("/settings")
+ *   TS:   router.replace("/settings")     C++:  Router::instance().replace("/settings")
+ *   TS:   router.getCurrentRoute()        C++:  Router::instance().getCurrentRoute()
+ *   TS:   router.setInitialRoute("/")     C++:  Router::instance().setInitialRoute("/")
+ *   TS:   router.onRouteChange(cb)        C++:  Router::instance().onRouteChange(cb)
+ *
+ * ── BROWSER (WebView navigation) ─────────────────────────────────────────────
+ *   TS:   browser.navigate(url)           C++:  browser.navigate(url)
+ *   TS:   browser.open(url)               C++:  browser.navigate(url)
+ *   TS:   browser.openExternal(url)       C++:  browser.openExternal(url)
+ *   TS:   browser.openNewWindow(url)      C++:  browser.openNewWindow(url)
+ *   TS:   browser.goBack()                C++:  browser.goBack()
+ *   TS:   browser.goForward()             C++:  browser.goForward()
+ *   TS:   browser.reload()                C++:  browser.reload()
+ *   TS:   browser.stop()                  C++:  browser.stop()
+ *   TS:   browser.getUrl()                C++:  browser.getURL()
+ *   TS:   browser.getTitle()              C++:  browser.getTitle()
+ *   TS:   browser.getState()              C++:  browser.getState()
+ *   TS:   browser.canGoBack()             C++:  browser.canGoBack()
+ *   TS:   browser.canGoForward()          C++:  browser.canGoForward()
+ *   TS:   browser.isLoading()             C++:  browser.isLoading()
+ * Events
+ *   TS:   browser.onNavigate(cb)          C++:  browser.onNavigate(cb)
+ *   TS:   browser.onStateChange(cb)       C++:  browser.onStateChange(cb)
+ *   TS:   browser.onLoadStart(cb)         C++:  browser.onLoadStart(cb)
+ *   TS:   browser.onLoadEnd(cb)           C++:  browser.onLoadEnd(cb)
+ *   TS:   browser.onLoadError(cb)         C++:  browser.onLoadError(cb)
+ *
+ * ── CLIPBOARD ────────────────────────────────────────────────────────────────
+ *   TS:   clipboard.getText()             C++:  Clipboard::getText()
+ *   TS:   clipboard.setText("hello")      C++:  Clipboard::setText("hello")
+ *   TS:   clipboard.hasText()             C++:  Clipboard::hasText()
+ *   TS:   clipboard.getImage()            C++:  Clipboard::getImage()
+ *   TS:   clipboard.setImage(b64)         C++:  Clipboard::setImage(b64)
+ *   TS:   clipboard.hasImage()            C++:  Clipboard::hasImage()
+ *   TS:   clipboard.clear()               C++:  Clipboard::clear()
+ *   TS:   clipboard.onChange(cb)          C++:  Clipboard::instance().onChange(cb)
+ *
+ * ── KEYBOARD ─────────────────────────────────────────────────────────────────
+ *   TS:   keyboard.isKeyPressed(key)      C++:  Keyboard::instance().isKeyPressed(key)
+ *   TS:   keyboard.registerShortcut(...)  C++:  Keyboard::instance().registerShortcut(...)
+ *   TS:   keyboard.unregisterShortcut(id) C++:  Keyboard::instance().unregisterShortcut(id)
+ *   TS:   keyboard.clearShortcuts()       C++:  Keyboard::instance().clearShortcuts()
+ *   TS:   keyboard.onKeyDown(cb)          C++:  Keyboard::instance().onKeyDown(cb)
+ *   TS:   keyboard.onKeyUp(cb)            C++:  Keyboard::instance().onKeyUp(cb)
+ *   TS:   keyboard.onShortcut(cb)         C++:  Keyboard::instance().onShortcut(cb)
+ *
+ * ── TRAY ─────────────────────────────────────────────────────────────────────
+ *   TS:   tray.setIcon(path)              C++:  win.tray().setIcon(path)
+ *   TS:   tray.setTooltip(text)           C++:  win.tray().setTooltip(text)
+ *   TS:   tray.setVisible(true)           C++:  win.tray().setVisible(true)
+ *   TS:   tray.setMenu(items)             C++:  win.tray().setMenu(items)
+ *   TS:   tray.setContextMenu(items)      C++:  win.tray().setContextMenu(items)
+ *   TS:   tray.onClick(cb)                C++:  win.tray().onClick(cb)
+ *   TS:   tray.onDoubleClick(cb)          C++:  win.tray().onDoubleClick(cb)
+ *   TS:   tray.onRightClick(cb)           C++:  win.tray().onRightClick(cb)
+ *   TS:   tray.onMenuItemClick(cb)        C++:  win.tray().onMenuItemClick(cb)
+ *
+ * ── DISPLAY ──────────────────────────────────────────────────────────────────
+ *   TS:   display.getAllDisplays()         C++:  DisplayManager::instance().getAllDisplays()
+ *   TS:   display.getPrimaryDisplay()      C++:  DisplayManager::instance().getPrimary()
+ *   TS:   display.getDisplayAt(x, y)       C++:  DisplayManager::instance().getAt(x, y)
+ *   TS:   display.getScreenWidth()         C++:  DisplayManager::instance().getScreenWidth()
+ *   TS:   display.getScreenHeight()        C++:  DisplayManager::instance().getScreenHeight()
+ *   TS:   display.onConnected(cb)          C++:  DisplayManager::instance().onConnected(cb)
+ *   TS:   display.onDisconnected(cb)       C++:  DisplayManager::instance().onDisconnected(cb)
+ *   TS:   display.onChanged(cb)            C++:  DisplayManager::instance().onChanged(cb)
+ *
+ * ── MENU ─────────────────────────────────────────────────────────────────────
+ *   TS:   menu.create(items)              C++:  MenuManager::instance().create(items)
+ *   TS:   menu.popup(id, x, y)            C++:  MenuManager::instance().popup(id, x, y)
+ *   TS:   menu.setApplicationMenu(items)  C++:  MenuManager::instance().setApplicationMenu(items)
+ *   TS:   menu.showContextMenu(items)     C++:  MenuManager::instance().showContextMenu(items)
+ *   TS:   menu.onItemClick(cb)            C++:  MenuManager::instance().onItemClick(cb)
+ *   TS:   menu.onContextOpen(cb)          C++:  MenuManager::instance().onContextOpen(cb)
+ *
+ * ── FILEDROP ─────────────────────────────────────────────────────────────────
+ *   TS:   fileDrop.setEnabled(true)       C++:  FileDrop::instance().setEnabled(true)
+ *   TS:   fileDrop.startDrag(paths)       C++:  FileDrop::instance().startDrag(paths)
+ *   TS:   fileDrop.onFilesDropped(cb)     C++:  FileDrop::instance().onFilesDropped(cb)
+ *   TS:   fileDrop.onDragEnter(cb)        C++:  FileDrop::instance().onDragEnter(cb)
+ *   TS:   fileDrop.onDragLeave(cb)        C++:  FileDrop::instance().onDragLeave(cb)
+ *
+ * ── GPU (WebGPU) ──────────────────────────────────────────────────────────────
+ *   TS:   gpu.requestAdapter()            C++:  WebGPU::instance().requestAdapter()
+ *   TS:   gpu.getPreferredCanvasFormat()  C++:  WebGPU::instance().getPreferredCanvasFormat()
+ *   TS:   gpu.onAdapterLost(cb)           C++:  WebGPU::instance().onAdapterLost(cb)
+ *   TS:   gpu.onDeviceLost(cb)            C++:  WebGPU::instance().onDeviceLost(cb)
+ *   TS:   gpu.onError(cb)                 C++:  WebGPU::instance().onError(cb)
+ *
+ * ── CONNECT (custom bidirectional channels) ───────────────────────────────────
+ *   TS:   connect.emit("name", data)      C++:  connect.emit("name", {{"key", val}})
+ *   TS:   connect.on("name", cb)          C++:  connect.on("name", cb)
+ *   TS:   connect.on("name", cb)          C++:  connect.on("name", [](const json& d){ ... })
+ *   TS:   createChannel("name")           C++:  connect.channel("name")
+ *   TS:   createFeatureConnect("scope")   C++:  connect.feature("scope")
+ *   TS:   handleMessage override          C++:  override handleMessage(name, data)
+ *
+ * ─────────────────────────────────────────────────────────────────────────────
+ * USAGE EXAMPLE
+ * ─────────────────────────────────────────────────────────────────────────────
+ *
+ *   #include <plusui/plusui>
+ *   using namespace plusui;
+ *
+ *   class MyApp : public Connect {
+ *   protected:
+ *     void handleMessage(const std::string& name, const nlohmann::json& data) override {
+ *       if (name == "greet") {
+ *         emit("greeting", {{"message", "Hello " + data["name"].get<std::string>()}});
+ *       }
+ *     }
+ *   };
+ *
+ *   int main() {
+ *     auto win = createApp()
+ *       .title("My App")
+ *       .width(1200)
+ *       .height(800)
+ *       .enableFileDrop(true)
+ *       .build();
+ *
+ *     MyApp connect;
+ *     bindConnect(win, connect);
+ *
+ *     win.loadURL("http://localhost:5173");
+ *
+ *     win.onClose([]{ app.quit(); });
+ *     win.tray().setIcon("icon.png");
+ *     win.tray().onClick([&](int, int){ win.show(); });
+ *
+ *     Router::instance().setRoutes({{"/", "http://localhost:5173"}});
+ *     Router::instance().push("/");
+ *
+ *     app.run();
+ *   }
+ */
+
+// ─── Feature Headers ──────────────────────────────────────────────────────────
+
+#include <plusui/app.hpp>
+#include <plusui/browser.hpp>
+#include <plusui/clipboard.hpp>
+#include <plusui/connect.hpp>
+#include <plusui/connection.hpp>
+#include <plusui/display.hpp>
+#include <plusui/filedrop.hpp>
+#include <plusui/keyboard.hpp>
+#include <plusui/menu.hpp>
+#include <plusui/router.hpp>
+#include <plusui/tray.hpp>
+#include <plusui/webgpu.hpp>
+#include <plusui/window.hpp>

package/Core/include/plusui/plusui.hpp

@@ -22,6 +22,7 @@
  * the specific headers you need instead of this convenience header.
  */
 
+#include <plusui/api.hpp>
 #include <plusui/app.hpp>
 #include <plusui/browser.hpp>
 #include <plusui/clipboard.hpp>
@@ -31,6 +32,7 @@
 #include <plusui/filedrop.hpp>
 #include <plusui/keyboard.hpp>
 #include <plusui/menu.hpp>
+#include <plusui/router.hpp>
 #include <plusui/tray.hpp>
 #include <plusui/webgpu.hpp>
 #include <plusui/window.hpp>

package/Core/include/plusui/router.hpp

@@ -0,0 +1,42 @@
+#ifndef PLUSUI_ROUTER_H
+#define PLUSUI_ROUTER_H
+
+#include <string>
+#include <map>
+#include <functional>
+#include <memory>
+#include <vector>
+
+namespace plusui {
+
+class Router {
+public:
+    Router();
+    ~Router();
+
+    static Router& instance();
+
+    void setRoutes(const std::map<std::string, std::string>& routes);
+    std::map<std::string, std::string> getRoutes() const;
+
+    void push(const std::string& route, const std::string& windowId = "");
+    void replace(const std::string& route, const std::string& windowId = "");
+    
+    std::string getCurrentRoute(const std::string& windowId = "") const;
+    void setInitialRoute(const std::string& route);
+
+    using RouteChangeCallback = std::function<void(const std::string& route, const std::string& windowId)>;
+    void onRouteChange(RouteChangeCallback callback);
+
+private:
+    struct Impl;
+    std::unique_ptr<Impl> pImpl;
+
+    // Prevent copying
+    Router(const Router&) = delete;
+    Router& operator=(const Router&) = delete;
+};
+
+} // namespace plusui
+
+#endif // PLUSUI_ROUTER_H

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "plusui-native-core",
-  "version": "0.1.86",
+  "version": "0.1.89",
   "description": "PlusUI Core framework (frontend + backend implementations)",
   "type": "module",
   "exports": {