plusui-native-core 0.1.0

package/src/index.ts

@@ -0,0 +1,574 @@
+// PlusUI Core SDK
+// Matches Core/Features structure - each feature has backend (C++) and frontend (TS)
+
+type InvokeFn = (method: string, args?: unknown[]) => Promise<unknown>;
+type PendingMap = Record<string, { resolve: (value: unknown) => void; reject: (reason?: unknown) => void }>;
+
+let _invoke: InvokeFn | null = null;
+let _pending: PendingMap = {};
+
+function initBridge() {
+  if (typeof window === 'undefined') return;
+  
+  const w = window as any;
+  if (w.__invoke__) {
+    _invoke = w.__invoke__;
+    return;
+  }
+
+  _pending = {};
+  w.__pending__ = _pending;
+
+  w.__invoke__ = (method: string, args?: unknown[]): Promise<unknown> => {
+    return new Promise((resolve, reject) => {
+      const id = Math.random().toString(36).substr(2, 9);
+      const request = JSON.stringify({ id, method, params: args || [] });
+
+      _pending[id] = { resolve, reject };
+
+      if (typeof w.__native_invoke__ === 'function') {
+        w.__native_invoke__(request);
+      } else {
+        console.warn(`[PlusUI] Native binding not available for: ${method}`);
+        setTimeout(() => {
+          delete _pending[id];
+          resolve(null);
+        }, 0);
+      }
+
+      setTimeout(() => {
+        if (_pending[id]) {
+          delete _pending[id];
+          reject(new Error(`${method} timed out`));
+        }
+      }, 30000);
+    });
+  };
+
+  w.__response__ = (id: string, result: unknown) => {
+    const pending = _pending[id];
+    if (pending) {
+      pending.resolve(result);
+      delete _pending[id];
+    }
+  };
+
+  _invoke = w.__invoke__;
+}
+
+initBridge();
+
+async function invoke(method: string, args?: unknown[]): Promise<unknown> {
+  if (!_invoke) {
+    initBridge();
+    if (!_invoke) {
+      throw new Error('Bridge not initialized');
+    }
+  }
+  return _invoke(method, args);
+}
+
+// ============================================================================
+// Types - Match Core/Features/*/include/*.hpp
+// ============================================================================
+
+export interface WindowSize { width: number; height: number; }
+export interface WindowPosition { x: number; y: number; }
+export interface WindowRect { x: number; y: number; width: number; height: number; }
+export type WindowId = string;
+
+// ============================================================================
+// Window API - Core/Features/Window
+// ============================================================================
+
+export const win = {
+  minimize: async (id?: WindowId) => await invoke('window.minimize', id ? [id] : []),
+  maximize: async (id?: WindowId) => await invoke('window.maximize', id ? [id] : []),
+  restore: async (id?: WindowId) => await invoke('window.restore', id ? [id] : []),
+  close: async (id?: WindowId) => await invoke('window.close', id ? [id] : []),
+  show: async (id?: WindowId) => await invoke('window.show', id ? [id] : []),
+  hide: async (id?: WindowId) => await invoke('window.hide', id ? [id] : []),
+  center: async (id?: WindowId) => await invoke('window.center', id ? [id] : []),
+
+  setSize: async (w: number, h: number, id?: WindowId) => await invoke('window.setSize', id ? [w, h, id] : [w, h]),
+  setPosition: async (x: number, y: number, id?: WindowId) => await invoke('window.setPosition', id ? [x, y, id] : [x, y]),
+  getSize: async (id?: WindowId): Promise<WindowSize> => await invoke('window.getSize', id ? [id] : []) as Promise<WindowSize>,
+  getPosition: async (id?: WindowId): Promise<WindowPosition> => await invoke('window.getPosition', id ? [id] : []) as Promise<WindowPosition>,
+
+  setTitle: async (title: string, id?: WindowId) => await invoke('window.setTitle', id ? [title, id] : [title]),
+  setFullscreen: async (enabled: boolean, id?: WindowId) => await invoke('window.setFullscreen', id ? [enabled, id] : [enabled]),
+  setAlwaysOnTop: async (enabled: boolean, id?: WindowId) => await invoke('window.setAlwaysOnTop', id ? [enabled, id] : [enabled]),
+  setResizable: async (enabled: boolean, id?: WindowId) => await invoke('window.setResizable', id ? [enabled, id] : [enabled]),
+  setDecorations: async (enabled: boolean, id?: WindowId) => await invoke('window.setDecorations', id ? [enabled, id] : [enabled]),
+  setTransparency: async (alpha: number, id?: WindowId) => await invoke('window.setTransparency', id ? [alpha, id] : [alpha]),
+
+  isMaximized: async (id?: WindowId): Promise<boolean> => await invoke('window.isMaximized', id ? [id] : []) as Promise<boolean>,
+  isMinimized: async (id?: WindowId): Promise<boolean> => await invoke('window.isMinimized', id ? [id] : []) as Promise<boolean>,
+  isVisible: async (id?: WindowId): Promise<boolean> => await invoke('window.isVisible', id ? [id] : []) as Promise<boolean>,
+};
+
+// ============================================================================
+// Tray API - Core/Features/Tray
+// ============================================================================
+
+export const tray = {
+  setIcon: async (iconPath: string) => await invoke('tray.setIcon', [iconPath]),
+  setTooltip: async (tooltip: string) => await invoke('tray.setTooltip', [tooltip]),
+  setVisible: async (visible: boolean) => await invoke('tray.setVisible', [visible]),
+};
+
+// ============================================================================
+// App API - Core/Features/App
+// ============================================================================
+
+export const app = {
+  quit: async () => await invoke('app.quit', []),
+  invoke: async (method: string, args?: unknown[]) => await invoke(method, args),
+};
+
+// ============================================================================
+// Display API - Core/Features/Display
+// ============================================================================
+
+export interface Display {
+  id: number;
+  name: string;
+  x: number;
+  y: number;
+  width: number;
+  height: number;
+  resolution: {
+    width: number;
+    height: number;
+  };
+  scale: number;
+  isPrimary: boolean;
+}
+
+export const display = {
+  getAll: async (): Promise<Display[]> => await invoke('display.getAll', []) as Promise<Display[]>,
+  getPrimary: async (): Promise<Display> => await invoke('display.getPrimary', []) as Promise<Display>,
+  getCurrent: async (): Promise<Display> => await invoke('display.getCurrent', []) as Promise<Display>,
+};
+
+// ============================================================================
+// Clipboard API - Core/Features/Clipboard
+// ============================================================================
+
+export const clipboard = {
+  writeText: async (text: string) => await invoke('clipboard.writeText', [text]),
+  readText: async (): Promise<string> => await invoke('clipboard.readText', []) as Promise<string>,
+  writeImage: async (base64: string) => await invoke('clipboard.writeImage', [base64]),
+  readImage: async (): Promise<string> => await invoke('clipboard.readImage', []) as Promise<string>,
+  clear: async () => await invoke('clipboard.clear', []),
+};
+
+// ============================================================================
+// WebGPU API - Core/Features/WebGPU (Optional - requires PLUSUI_ENABLE_WEBGPU)
+// ============================================================================
+
+export interface GPUAdapter {
+  requestDevice(descriptor?: any): Promise<GPUDevice>;
+  features: Set<string>;
+  limits: Record<string, number>;
+  info?: {
+    vendor?: string;
+    architecture?: string;
+    device?: string;
+  };
+}
+
+export interface GPUDevice {
+  createBuffer(descriptor: any): any;
+  createTexture(descriptor: any): any;
+  createShaderModule(descriptor: any): any;
+  createRenderPipeline(descriptor: any): any;
+  createCommandEncoder(): any;
+  queue: {
+    submit(commandBuffers: any[]): void;
+    writeBuffer(buffer: any, offset: number, data: ArrayBuffer): void;
+  };
+  destroy(): void;
+}
+
+export interface GPURequestAdapterOptions {
+  powerPreference?: 'low-power' | 'high-performance';
+  forceFallbackAdapter?: boolean;
+}
+
+export const webgpu = {
+  requestAdapter: async (options?: GPURequestAdapterOptions): Promise<GPUAdapter | null> => {
+    const result = await invoke('webgpu.requestAdapter', [options || {}]);
+    return result as GPUAdapter | null;
+  },
+
+  getPreferredCanvasFormat: (): string => 'bgra8unorm',
+};
+
+// Initialize navigator.gpu polyfill if not already present
+if (typeof window !== 'undefined' && typeof (window as any).navigator !== 'undefined') {
+  const nav = (window as any).navigator;
+  if (!nav.gpu) {
+    nav.gpu = {
+      requestAdapter: webgpu.requestAdapter,
+      getPreferredCanvasFormat: webgpu.getPreferredCanvasFormat,
+    };
+  }
+}
+
+// ============================================================================
+// Keyboard API - Core/Features/Keyboard
+// ============================================================================
+
+export enum KeyCode {
+  Unknown = 0,
+  Space = 32,
+  Escape = 256,
+  Enter = 257,
+  Tab = 258,
+  Backspace = 259,
+  Delete = 261,
+  Right = 262,
+  Left = 263,
+  Down = 264,
+  Up = 265,
+  F1 = 290, F2 = 291, F3 = 292, F4 = 293, F5 = 294, F6 = 295,
+  F7 = 296, F8 = 297, F9 = 298, F10 = 299, F11 = 300, F12 = 301,
+  LeftShift = 340,
+  LeftControl = 341,
+  LeftAlt = 342,
+}
+
+export enum KeyMod {
+  None = 0,
+  Shift = 1,
+  Control = 2,
+  Alt = 4,
+  Super = 8,
+}
+
+export interface KeyEvent {
+  key: KeyCode;
+  scancode: number;
+  mods: KeyMod;
+  pressed: boolean;
+  repeat: boolean;
+  keyName: string;
+}
+
+export interface Shortcut {
+  key: KeyCode;
+  mods: KeyMod;
+}
+
+type KeyEventCallback = (event: KeyEvent) => void;
+type ShortcutCallback = () => void;
+
+const _keyDownCallbacks: KeyEventCallback[] = [];
+const _keyUpCallbacks: KeyEventCallback[] = [];
+const _shortcutHandlers: Map<string, ShortcutCallback> = new Map();
+
+// Listen for keyboard events from backend
+if (typeof window !== 'undefined') {
+  (window as any).__onKeyDown__ = (event: KeyEvent) => {
+    _keyDownCallbacks.forEach(cb => cb(event));
+  };
+  (window as any).__onKeyUp__ = (event: KeyEvent) => {
+    _keyUpCallbacks.forEach(cb => cb(event));
+  };
+  (window as any).__onShortcut__ = (id: string) => {
+    const handler = _shortcutHandlers.get(id);
+    if (handler) handler();
+  };
+}
+
+export const keyboard = {
+  isKeyPressed: async (key: KeyCode): Promise<boolean> =>
+    await invoke('keyboard.isKeyPressed', [key]) as Promise<boolean>,
+
+  setAutoRepeat: async (enabled: boolean) =>
+    await invoke('keyboard.setAutoRepeat', [enabled]),
+
+  getAutoRepeat: async (): Promise<boolean> =>
+    await invoke('keyboard.getAutoRepeat', []) as Promise<boolean>,
+
+  onKeyDown: (callback: KeyEventCallback) => {
+    _keyDownCallbacks.push(callback);
+    return () => {
+      const idx = _keyDownCallbacks.indexOf(callback);
+      if (idx > -1) _keyDownCallbacks.splice(idx, 1);
+    };
+  },
+
+  onKeyUp: (callback: KeyEventCallback) => {
+    _keyUpCallbacks.push(callback);
+    return () => {
+      const idx = _keyUpCallbacks.indexOf(callback);
+      if (idx > -1) _keyUpCallbacks.splice(idx, 1);
+    };
+  },
+
+  registerShortcut: async (id: string, shortcut: Shortcut | string, callback: ShortcutCallback): Promise<boolean> => {
+    _shortcutHandlers.set(id, callback);
+    const sc = typeof shortcut === 'string' ? keyboard.parseShortcut(shortcut) : shortcut;
+    return await invoke('keyboard.registerShortcut', [id, sc]) as Promise<boolean>;
+  },
+
+  unregisterShortcut: async (id: string): Promise<boolean> => {
+    _shortcutHandlers.delete(id);
+    return await invoke('keyboard.unregisterShortcut', [id]) as Promise<boolean>;
+  },
+
+  clearShortcuts: async () => {
+    _shortcutHandlers.clear();
+    await invoke('keyboard.clearShortcuts', []);
+  },
+
+  parseShortcut: (str: string): Shortcut => {
+    const parts = str.toLowerCase().split('+');
+    let mods = KeyMod.None;
+    let key = KeyCode.Unknown;
+    const keyMap: Record<string, KeyCode> = {
+      'space': KeyCode.Space, 'escape': KeyCode.Escape, 'enter': KeyCode.Enter,
+      'tab': KeyCode.Tab, 'backspace': KeyCode.Backspace, 'delete': KeyCode.Delete,
+      'right': KeyCode.Right, 'left': KeyCode.Left, 'down': KeyCode.Down, 'up': KeyCode.Up,
+      'f1': KeyCode.F1, 'f2': KeyCode.F2, 'f3': KeyCode.F3, 'f4': KeyCode.F4,
+      'f5': KeyCode.F5, 'f6': KeyCode.F6, 'f7': KeyCode.F7, 'f8': KeyCode.F8,
+      'f9': KeyCode.F9, 'f10': KeyCode.F10, 'f11': KeyCode.F11, 'f12': KeyCode.F12,
+    };
+    for (const part of parts) {
+      const t = part.trim();
+      if (t === 'ctrl' || t === 'control') mods |= KeyMod.Control;
+      else if (t === 'alt') mods |= KeyMod.Alt;
+      else if (t === 'shift') mods |= KeyMod.Shift;
+      else if (t === 'super' || t === 'win' || t === 'cmd') mods |= KeyMod.Super;
+      else key = keyMap[t] || KeyCode.Unknown;
+    }
+    return { key, mods };
+  },
+};
+
+// ============================================================================
+// Menu API - Core/Features/Menu
+// ============================================================================
+
+export type MenuItemType = 'normal' | 'separator' | 'submenu' | 'checkbox' | 'radio';
+
+export interface MenuItem {
+  id: string;
+  label: string;
+  accelerator?: string;
+  icon?: string;
+  type?: MenuItemType;
+  enabled?: boolean;
+  checked?: boolean;
+  submenu?: MenuItem[];
+  click?: (menuItem: MenuItem) => void;
+  data?: Record<string, unknown>;
+}
+
+const _menuClickHandlers: Map<string, (item: MenuItem) => void> = new Map();
+
+// Listen for menu click events from backend
+if (typeof window !== 'undefined') {
+  (window as any).__onMenuItemClick__ = (id: string) => {
+    const handler = _menuClickHandlers.get(id);
+    if (handler) handler({ id, label: '' });
+  };
+}
+
+function registerMenuClickHandlers(items: MenuItem[]): void {
+  for (const item of items) {
+    if (item.click) _menuClickHandlers.set(item.id, item.click);
+    if (item.submenu) registerMenuClickHandlers(item.submenu);
+  }
+}
+
+function stripMenuFunctions(items: MenuItem[]): unknown[] {
+  return items.map(item => {
+    const { click, submenu, ...rest } = item;
+    const clean: Record<string, unknown> = { ...rest };
+    if (submenu) clean.submenu = stripMenuFunctions(submenu);
+    return clean;
+  });
+}
+
+export const menu = {
+  create: async (items: MenuItem[]): Promise<string> => {
+    registerMenuClickHandlers(items);
+    return await invoke('menu.create', [stripMenuFunctions(items)]) as Promise<string>;
+  },
+
+  popup: async (menuId: string, x?: number, y?: number) =>
+    await invoke('menu.popup', [menuId, x ?? 0, y ?? 0]),
+
+  popupAtCursor: async (menuId: string) =>
+    await invoke('menu.popupAtCursor', [menuId]),
+
+  close: async (menuId: string) =>
+    await invoke('menu.close', [menuId]),
+
+  destroy: async (menuId: string) =>
+    await invoke('menu.destroy', [menuId]),
+
+  setApplicationMenu: async (items: MenuItem[]) => {
+    registerMenuClickHandlers(items);
+    await invoke('menu.setApplicationMenu', [stripMenuFunctions(items)]);
+  },
+
+  getApplicationMenu: async (): Promise<MenuItem[]> =>
+    await invoke('menu.getApplicationMenu', []) as Promise<MenuItem[]>,
+
+  showContextMenu: async (items: MenuItem[], x?: number, y?: number) => {
+    registerMenuClickHandlers(items);
+    const menuId = await invoke('menu.create', [stripMenuFunctions(items)]) as string;
+    await invoke('menu.popup', [menuId, x ?? 0, y ?? 0]);
+  },
+
+  onMenuItemClick: (callback: (id: string) => void) => {
+    if (typeof window !== 'undefined') {
+      const handler = (window as any).__onMenuItemClick__;
+      (window as any).__onMenuItemClick__ = (id: string) => {
+        handler?.(id);
+        callback(id);
+      };
+    }
+  },
+
+  // Predefined menu templates
+  templates: {
+    editMenu: (handlers?: Partial<{ undo: () => void; redo: () => void; cut: () => void; copy: () => void; paste: () => void; selectAll: () => void }>): MenuItem => ({
+      id: 'edit', label: '&Edit', submenu: [
+        { id: 'undo', label: 'Undo', accelerator: 'Ctrl+Z', click: handlers?.undo },
+        { id: 'redo', label: 'Redo', accelerator: 'Ctrl+Y', click: handlers?.redo },
+        { id: 'sep1', label: '', type: 'separator' },
+        { id: 'cut', label: 'Cut', accelerator: 'Ctrl+X', click: handlers?.cut },
+        { id: 'copy', label: 'Copy', accelerator: 'Ctrl+C', click: handlers?.copy },
+        { id: 'paste', label: 'Paste', accelerator: 'Ctrl+V', click: handlers?.paste },
+        { id: 'sep2', label: '', type: 'separator' },
+        { id: 'selectAll', label: 'Select All', accelerator: 'Ctrl+A', click: handlers?.selectAll },
+      ]
+    }),
+    fileMenu: (handlers?: Partial<{ new: () => void; open: () => void; save: () => void; saveAs: () => void; exit: () => void }>): MenuItem => ({
+      id: 'file', label: '&File', submenu: [
+        { id: 'new', label: 'New', accelerator: 'Ctrl+N', click: handlers?.new },
+        { id: 'open', label: 'Open...', accelerator: 'Ctrl+O', click: handlers?.open },
+        { id: 'sep1', label: '', type: 'separator' },
+        { id: 'save', label: 'Save', accelerator: 'Ctrl+S', click: handlers?.save },
+        { id: 'saveAs', label: 'Save As...', accelerator: 'Ctrl+Shift+S', click: handlers?.saveAs },
+        { id: 'sep2', label: '', type: 'separator' },
+        { id: 'exit', label: 'Exit', accelerator: 'Alt+F4', click: handlers?.exit },
+      ]
+    }),
+    viewMenu: (handlers?: Partial<{ zoomIn: () => void; zoomOut: () => void; resetZoom: () => void; fullscreen: () => void; devtools: () => void }>): MenuItem => ({
+      id: 'view', label: '&View', submenu: [
+        { id: 'zoomIn', label: 'Zoom In', accelerator: 'Ctrl++', click: handlers?.zoomIn },
+        { id: 'zoomOut', label: 'Zoom Out', accelerator: 'Ctrl+-', click: handlers?.zoomOut },
+        { id: 'resetZoom', label: 'Reset Zoom', accelerator: 'Ctrl+0', click: handlers?.resetZoom },
+        { id: 'sep1', label: '', type: 'separator' },
+        { id: 'fullscreen', label: 'Toggle Fullscreen', accelerator: 'F11', click: handlers?.fullscreen },
+        { id: 'sep2', label: '', type: 'separator' },
+        { id: 'devtools', label: 'Developer Tools', accelerator: 'F12', click: handlers?.devtools },
+      ]
+    }),
+  },
+};
+
+// ============================================================================
+// Browser API - Navigation & Routing
+// ============================================================================
+
+export interface BrowserState {
+  url: string;
+  title: string;
+  canGoBack: boolean;
+  canGoForward: boolean;
+  isLoading: boolean;
+}
+
+type NavigateCallback = (url: string) => void;
+type StateCallback = (state: BrowserState) => void;
+
+const _navigateCallbacks: NavigateCallback[] = [];
+const _stateCallbacks: StateCallback[] = [];
+let _currentState: BrowserState = { url: '', title: '', canGoBack: false, canGoForward: false, isLoading: false };
+
+// Listen for navigation events from backend
+if (typeof window !== 'undefined') {
+  (window as any).__onNavigate__ = (url: string) => {
+    _currentState.url = url;
+    _navigateCallbacks.forEach(cb => cb(url));
+  };
+  (window as any).__onBrowserState__ = (state: BrowserState) => {
+    _currentState = state;
+    _stateCallbacks.forEach(cb => cb(state));
+  };
+}
+
+export const browser = {
+  navigate: async (url: string) => await invoke('browser.navigate', [url]),
+  goBack: async () => await invoke('browser.goBack', []),
+  goForward: async () => await invoke('browser.goForward', []),
+  reload: async () => await invoke('browser.reload', []),
+  stop: async () => await invoke('browser.stop', []),
+  
+  getUrl: async (): Promise<string> => await invoke('browser.getUrl', []) as Promise<string>,
+  getTitle: async (): Promise<string> => await invoke('browser.getTitle', []) as Promise<string>,
+  getState: (): BrowserState => _currentState,
+  
+  canGoBack: async (): Promise<boolean> => await invoke('browser.canGoBack', []) as Promise<boolean>,
+  canGoForward: async (): Promise<boolean> => await invoke('browser.canGoForward', []) as Promise<boolean>,
+  
+  onNavigate: (callback: NavigateCallback) => {
+    _navigateCallbacks.push(callback);
+    return () => {
+      const idx = _navigateCallbacks.indexOf(callback);
+      if (idx > -1) _navigateCallbacks.splice(idx, 1);
+    };
+  },
+  
+  onStateChange: (callback: StateCallback) => {
+    _stateCallbacks.push(callback);
+    return () => {
+      const idx = _stateCallbacks.indexOf(callback);
+      if (idx > -1) _stateCallbacks.splice(idx, 1);
+    };
+  },
+};
+
+// ============================================================================
+// Router API - Simple window routing for SPAs
+// ============================================================================
+
+let _routes: Record<string, string> = {};
+let _currentRoute: string = '/';
+
+export const router = {
+  setRoutes: (routes: Record<string, string>) => {
+    _routes = routes;
+  },
+  
+  setInitialRoute: async (route: string) => {
+    _currentRoute = route;
+    const url = _routes[route] || route;
+    await browser.navigate(url);
+  },
+  
+  push: async (route: string) => {
+    _currentRoute = route;
+    const url = _routes[route] || route;
+    await browser.navigate(url);
+  },
+  
+  replace: async (route: string) => {
+    _currentRoute = route;
+    const url = _routes[route] || route;
+    await browser.navigate(url);
+  },
+  
+  getCurrentRoute: () => _currentRoute,
+  
+  getRoutes: () => ({ ..._routes }),
+};
+
+export default { win, tray, app, display, clipboard, keyboard, menu, webgpu, browser, router };