plusui-native-core 0.1.66 → 0.1.68

package/Core/API/Connect_API.ts

@@ -0,0 +1,160 @@
+/**
+ * PlusUI Connect API - Custom User Channels
+ * 
+ * This is for user-defined channels generated by `plusui connect` tool.
+ * Built-in features (window, clipboard, etc.) use direct methods only.
+ * 
+ * Usage:
+ *   import { createChannel, connect } from '@plusui/api';
+ *   
+ *   // Create a custom channel
+ *   const search = createChannel('search');
+ *   search.emit({ query: 'test' });
+ *   search.on((result) => { ... });
+ *   
+ *   // Or use connect directly
+ *   connect.emit('myEvent', { data: 123 });
+ *   connect.on('myEvent', (data) => { ... });
+ * 
+ * The `plusui connect` CLI tool scans your codebase for:
+ *   - TypeScript: name.on() and name.emit()
+ *   - C++: name.on() and name.emit()
+ * And generates typed channel objects for both frontend and backend.
+ */
+
+import { _client } from '../Features/Connection/connect';
+
+/**
+ * Channel object returned by createChannel()
+ * Mirrors the C++ Connect::Channel API
+ */
+export interface Channel<T = unknown> {
+  /**
+   * Listen for messages on this channel
+   * @param callback - Function called when message is received
+   * @returns Unsubscribe function
+   */
+  on(callback: (data: T) => void): () => void;
+
+  /**
+   * Send a message on this channel
+   * @param data - Data to send
+   */
+  emit(data: T): void;
+
+  /**
+   * Channel name
+   */
+  readonly name: string;
+}
+
+/**
+ * Create a named channel object
+ * 
+ * @param name - Channel name (must match backend)
+ * @returns Channel object with .on() and .emit()
+ * 
+ * @example
+ *   const download = createChannel<DownloadProgress>('download');
+ *   download.emit({ url: 'https://example.com/file.zip' });
+ *   download.on((progress) => console.log(progress.percent));
+ */
+export function createChannel<T = unknown>(name: string): Channel<T> {
+  return {
+    name,
+    on: (callback: (data: T) => void): (() => void) => {
+      return _client.on<T>(name, callback);
+    },
+    emit: (data: T): void => {
+      _client.fire(name, data);
+    }
+  };
+}
+
+/**
+ * Direct connect API for custom channels
+ * 
+ * Use this for quick one-off events, or use createChannel() 
+ * for typed, reusable channel objects.
+ */
+export const connect = {
+  /**
+   * Send a message on a channel
+   * @param name - Channel name
+   * @param data - Data to send
+   */
+  emit: <T = unknown>(name: string, data: T): void => {
+    _client.fire(name, data);
+  },
+
+  /**
+   * Listen for messages on a channel
+   * @param name - Channel name
+   * @param callback - Function called when message is received
+   * @returns Unsubscribe function
+   */
+  on: <T = unknown>(name: string, callback: (data: T) => void): (() => void) => {
+    return _client.on<T>(name, callback);
+  },
+
+  /**
+   * Make a call and wait for response
+   * @param name - Channel name
+   * @param data - Request data
+   * @returns Promise with response
+   */
+  call: <TResponse = unknown, TRequest = unknown>(name: string, data: TRequest): Promise<TResponse> => {
+    return _client.call<TResponse, TRequest>(name, data);
+  },
+
+  /**
+   * Create a typed channel object
+   * @param name - Channel name
+   * @returns Channel object with .on() and .emit()
+   */
+  channel: <T = unknown>(name: string): Channel<T> => {
+    return createChannel<T>(name);
+  }
+};
+
+/**
+ * Feature-scoped connect
+ * 
+ * Creates a connect API that automatically prefixes all channel names
+ * with a scope. Useful for organizing channels by feature.
+ * 
+ * @param scope - Feature scope (e.g., 'auth', 'data', 'ui')
+ * @returns Scoped connect API
+ * 
+ * @example
+ *   const authConnect = createFeatureConnect('auth');
+ *   authConnect.emit('login', { user: 'john' });  // sends to 'auth.login'
+ *   authConnect.on('logout', () => {});           // listens to 'auth.logout'
+ */
+export function createFeatureConnect(scope: string) {
+  const scopedName = (name: string): string => {
+    const prefix = `${scope}.`;
+    if (name.startsWith(prefix)) return name;
+    return prefix + name;
+  };
+
+  return {
+    emit: <T = unknown>(name: string, data: T): void => {
+      _client.fire(scopedName(name), data);
+    },
+
+    on: <T = unknown>(name: string, callback: (data: T) => void): (() => void) => {
+      return _client.on<T>(scopedName(name), callback);
+    },
+
+    call: <TResponse = unknown, TRequest = unknown>(name: string, data: TRequest): Promise<TResponse> => {
+      return _client.call<TResponse, TRequest>(scopedName(name), data);
+    },
+
+    channel: <T = unknown>(name: string): Channel<T> => {
+      return createChannel<T>(scopedName(name));
+    }
+  };
+}
+
+export default connect;

package/Core/API/index.ts

@@ -0,0 +1,127 @@
+/**
+ * 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.
+ */
+
+// ============================================================
+// BUILT-IN FEATURES - Direct methods only (NO .on/.emit)
+// ============================================================
+
+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';
+
+// ============================================================
+// CUSTOM CHANNELS - For user-defined events (uses .on/.emit)
+// ============================================================
+
+export { 
+  connect, 
+  createChannel, 
+  createFeatureConnect,
+  type Channel 
+} from './Connect_API';
+
+// ============================================================
+// TYPES - Re-exported for convenience
+// ============================================================
+
+export type { 
+  WindowSize, 
+  WindowPosition, 
+  WindowRect, 
+  WindowState,
+  WindowId
+} from '../Features/Window/window';
+
+export type { 
+  ClipboardAPI 
+} from '../Features/Clipboard/clipboard';
+
+export type { 
+  KeyEvent, 
+  Shortcut,
+  KeyEventCallback,
+  ShortcutCallback,
+  KeyCode,
+  KeyMod
+} from '../Features/Keyboard/keyboard';
+
+export type { 
+  TrayMenuItem, 
+  TrayIconData 
+} from '../Features/Tray/tray';
+
+export type { 
+  Display, 
+  DisplayMode, 
+  DisplayBounds, 
+  DisplayResolution 
+} from '../Features/Display/display';
+
+export type { 
+  FileInfo, 
+  DragEvent,
+  FileDropAPI 
+} from '../Features/FileDrop/filedrop';
+
+export type { 
+  MenuItem, 
+  MenuItemType,
+  MenuBarData, 
+  ContextMenuOptions, 
+  ContextInfo 
+} from '../Features/Menu/menu';
+
+export type { 
+  AppConfig 
+} from '../Features/App/app';
+
+export type {
+  GPUAdapter,
+  GPUDevice,
+  GPUBuffer,
+  GPUTexture,
+  GPUShaderModule,
+  GPURenderPipeline,
+  GPUComputePipeline,
+  GPUQueue,
+  GPUCommandEncoder
+} from '../Features/WebGPU/webgpu';
+
+// ============================================================
+// HELPER FUNCTIONS
+// ============================================================
+
+export {
+  readFileAsText,
+  readFileAsDataUrl,
+  filterFilesByExtension,
+  filterFilesByMimeType,
+  isImageFile,
+  isVideoFile,
+  isAudioFile,
+  isTextFile,
+  formatFileSize
+} from '../Features/FileDrop/filedrop';

package/Core/Features/App/app.ts

@@ -1,131 +1,192 @@
-import { connect } from '../Connection/connect';
-
-export interface AppConfig {
-  title?: string;
-  width?: number;
-  height?: number;
-  resizable?: boolean;
-  devtools?: boolean;
-  trayIcon?: string;
-  trayTooltip?: string;
-  alwaysOnTop?: boolean;
-  centered?: boolean;
-  transparent?: boolean;
-  decorations?: boolean;
-  skipTaskbar?: boolean;
-  scrollbars?: boolean;
-  enableFileDrop?: boolean;
-}
-
-export interface InvokeOptions {
-  timeout?: number;
-}
-
-export class App {
-  public readonly connect = connect.feature('app');
-  private initialized = false;
-
-  constructor(
-    private config: AppConfig = {},
-    private invokeFn?: (name: string, args?: unknown[]) => Promise<unknown>
-  ) {
-    if (typeof window !== 'undefined') {
-      this.init();
-    }
-  }
-
-  private init(): void {
-    if (this.initialized) return;
-    this.initialized = true;
-
-    if (typeof window !== 'undefined') {
-      const win = window as Window & {
-        __plusui_listeners__?: Map<string, Set<(...args: unknown[]) => void>>;
-      };
-
-      win.__plusui_listeners__ = new Map();
-
-      window.addEventListener('message', (event: MessageEvent) => {
-        if (event.data?.type === '__plusui_event__') {
-          const { event: eventName, payload } = event.data;
-          const listeners = win.__plusui_listeners__?.get(eventName);
-          if (listeners) {
-            listeners.forEach(cb => cb(payload));
-          }
-        }
-      });
-    }
-  }
-
-  async invoke<T = unknown>(name: string, args?: unknown[], options: InvokeOptions = {}): Promise<T> {
-    const { timeout = 30000 } = options;
-
-    if (this.invokeFn) {
-      return this.invokeFn(name, args) as Promise<T>;
-    }
-
-    if (typeof window !== 'undefined') {
-      const win = window as Window & {
-        __plusui_invoke__?: (name: string, args?: unknown[]) => Promise<unknown>;
-        __invoke__?: (name: string, args?: unknown[]) => Promise<unknown>;
-        __native_invoke__?: (request: string) => void;
-      };
-      // Check for SDK bridge first (__invoke__ from plusui-native-core)
-      if (win.__invoke__) {
-        return win.__invoke__(name, args) as Promise<T>;
-      }
-      // Check for legacy __plusui_invoke__
-      if (win.__plusui_invoke__) {
-        return win.__plusui_invoke__(name, args) as Promise<T>;
-      }
-    }
-
-    return new Promise((_, reject) => {
-      setTimeout(() => reject(new Error(`Invocation ${name} timed out`)), timeout);
-    });
-  }
-
-  on(event: string, callback: (...args: unknown[]) => void): () => void {
-    if (typeof window === 'undefined') {
-      return () => { };
-    }
-
-    const win = window as Window & {
-      __plusui_listeners__?: Map<string, Set<(...args: unknown[]) => void>>;
-    };
-
-    if (!win.__plusui_listeners__) {
-      win.__plusui_listeners__ = new Map();
-    }
-
-    if (!win.__plusui_listeners__.has(event)) {
-      win.__plusui_listeners__.set(event, new Set());
-    }
-
-    win.__plusui_listeners__.get(event)!.add(callback);
-
-    return () => {
-      win.__plusui_listeners__.get(event)?.delete(callback);
-    };
-  }
-
-  once(event: string, callback: (...args: unknown[]) => void): void {
-    const unsubscribe = this.on(event, (...args) => {
-      unsubscribe();
-      callback(...args);
-    });
-  }
-
-  emit(event: string, payload?: unknown): void {
-    if (typeof window !== 'undefined') {
-      const customEvent = new CustomEvent(event, { detail: payload });
-      window.dispatchEvent(customEvent);
-    }
-  }
-}
-
-export function createApp(config?: AppConfig): App {
-  return new App(config);
-}
-
-export default App;
+/**
+ * App API - Application lifecycle
+ * 
+ * Direct method calls - no .on/.emit
+ * 
+ * Usage:
+ *   import { app } from '@plusui/api';
+ *   
+ *   app.quit();
+ *   app.onReady(() => { ... });
+ *   app.onQuit(() => { ... });
+ */
+
+export interface AppConfig {
+  title?: string;
+  width?: number;
+  height?: number;
+  resizable?: boolean;
+  devtools?: boolean;
+  trayIcon?: string;
+  trayTooltip?: string;
+  alwaysOnTop?: boolean;
+  centered?: boolean;
+  transparent?: boolean;
+  decorations?: boolean;
+  skipTaskbar?: boolean;
+  scrollbars?: boolean;
+  enableFileDrop?: boolean;
+}
+
+export interface InvokeOptions {
+  timeout?: number;
+}
+
+let _invoke: ((name: string, args?: unknown[]) => Promise<unknown>) | null = null;
+let _event: ((event: string, callback: (...args: unknown[]) => void) => () => void) | null = null;
+let _initialized = false;
+
+export function setInvokeFn(fn: (name: string, args?: unknown[]) => Promise<unknown>) {
+  _invoke = fn;
+}
+
+export function setEventFn(fn: (event: string, callback: (...args: unknown[]) => void) => () => void) {
+  _event = fn;
+}
+
+function init(): void {
+  if (_initialized) return;
+  _initialized = true;
+
+  if (typeof window !== 'undefined') {
+    const win = window as Window & {
+      __plusui_listeners__?: Map<string, Set<(...args: unknown[]) => void>>;
+    };
+
+    win.__plusui_listeners__ = new Map();
+
+    window.addEventListener('message', (event: MessageEvent) => {
+      if (event.data?.type === '__plusui_event__') {
+        const { event: eventName, payload } = event.data;
+        const listeners = win.__plusui_listeners__?.get(eventName);
+        if (listeners) {
+          listeners.forEach(cb => cb(payload));
+        }
+      }
+    });
+  }
+}
+
+async function invoke<T = unknown>(name: string, args?: unknown[], options: InvokeOptions = {}): Promise<T> {
+  const { timeout = 30000 } = options;
+
+  if (_invoke) {
+    return _invoke(name, args) as Promise<T>;
+  }
+
+  if (typeof window !== 'undefined') {
+    const win = window as Window & {
+      __invoke__?: (name: string, args?: unknown[]) => Promise<unknown>;
+      __native_invoke__?: (request: string) => void;
+    };
+    if (win.__invoke__) {
+      return win.__invoke__(name, args) as Promise<T>;
+    }
+  }
+
+  return new Promise((_, reject) => {
+    setTimeout(() => reject(new Error(`Invocation ${name} timed out`)), timeout);
+  });
+}
+
+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__;
+    } else {
+      const win = window as Window & {
+        __plusui_listeners__?: Map<string, Set<(...args: unknown[]) => void>>;
+      };
+
+      if (!win.__plusui_listeners__) {
+        win.__plusui_listeners__ = new Map();
+      }
+
+      const listeners = win.__plusui_listeners__!;
+
+      if (!listeners.has(event)) {
+        listeners.set(event, new Set());
+      }
+
+      listeners.get(event)!.add(callback);
+
+      return () => {
+        listeners.get(event)?.delete(callback);
+      };
+    }
+  }
+  return _event!(event, callback);
+}
+
+export const app = {
+  async invoke<T = unknown>(name: string, args?: unknown[], options: InvokeOptions = {}): Promise<T> {
+    return invoke<T>(name, args, options);
+  },
+
+  async quit(): Promise<void> {
+    await invoke('app.quit');
+  },
+
+  async getVersion(): Promise<string> {
+    return invoke<string>('app.getVersion');
+  },
+
+  async getName(): Promise<string> {
+    return invoke<string>('app.getName');
+  },
+
+  async getPath(name: 'home' | 'appData' | 'userData' | 'temp' | 'desktop' | 'documents' | 'downloads'): Promise<string> {
+    return invoke<string>('app.getPath', [name]);
+  },
+
+  async setBadge(count: number): Promise<void> {
+    await invoke('app.setBadge', [count]);
+  },
+
+  async getBadge(): Promise<number> {
+    return invoke<number>('app.getBadge');
+  },
+
+  onReady(callback: () => void): () => void {
+    return eventHandler('app:ready', callback);
+  },
+
+  onQuit(callback: (reason?: string) => void): () => void {
+    return eventHandler('app:quit', callback as (...args: unknown[]) => void);
+  },
+
+  onActivate(callback: () => void): () => void {
+    return eventHandler('app:activate', callback);
+  },
+
+  onWindowAllClosed(callback: () => void): () => void {
+    return eventHandler('app:windowAllClosed', callback);
+  },
+
+  onSecondInstance(callback: (args: string[], cwd: string) => void): () => void {
+    return eventHandler('app:secondInstance', callback as (...args: unknown[]) => void);
+  },
+
+  on(event: string, callback: (...args: unknown[]) => void): () => void {
+    return eventHandler(event, callback);
+  },
+
+  once(event: string, callback: (...args: unknown[]) => void): () => void {
+    const unsubscribe = this.on(event, (...args) => {
+      unsubscribe();
+      callback(...args);
+    });
+    return unsubscribe;
+  },
+
+  emit(event: string, payload?: unknown): void {
+    if (typeof window !== 'undefined') {
+      const customEvent = new CustomEvent(event, { detail: payload });
+      window.dispatchEvent(customEvent);
+    }
+  },
+};
+
+export default app;