plusui-native-core 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,205 @@
+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;
+export declare const win: {
+    minimize: (id?: WindowId) => Promise<unknown>;
+    maximize: (id?: WindowId) => Promise<unknown>;
+    restore: (id?: WindowId) => Promise<unknown>;
+    close: (id?: WindowId) => Promise<unknown>;
+    show: (id?: WindowId) => Promise<unknown>;
+    hide: (id?: WindowId) => Promise<unknown>;
+    center: (id?: WindowId) => Promise<unknown>;
+    setSize: (w: number, h: number, id?: WindowId) => Promise<unknown>;
+    setPosition: (x: number, y: number, id?: WindowId) => Promise<unknown>;
+    getSize: (id?: WindowId) => Promise<WindowSize>;
+    getPosition: (id?: WindowId) => Promise<WindowPosition>;
+    setTitle: (title: string, id?: WindowId) => Promise<unknown>;
+    setFullscreen: (enabled: boolean, id?: WindowId) => Promise<unknown>;
+    setAlwaysOnTop: (enabled: boolean, id?: WindowId) => Promise<unknown>;
+    setResizable: (enabled: boolean, id?: WindowId) => Promise<unknown>;
+    setDecorations: (enabled: boolean, id?: WindowId) => Promise<unknown>;
+    setTransparency: (alpha: number, id?: WindowId) => Promise<unknown>;
+    isMaximized: (id?: WindowId) => Promise<boolean>;
+    isMinimized: (id?: WindowId) => Promise<boolean>;
+    isVisible: (id?: WindowId) => Promise<boolean>;
+};
+export declare const tray: {
+    setIcon: (iconPath: string) => Promise<unknown>;
+    setTooltip: (tooltip: string) => Promise<unknown>;
+    setVisible: (visible: boolean) => Promise<unknown>;
+};
+export declare const app: {
+    quit: () => Promise<unknown>;
+    invoke: (method: string, args?: unknown[]) => Promise<unknown>;
+};
+export interface Display {
+    id: number;
+    name: string;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    scale: number;
+    isPrimary: boolean;
+}
+export declare const display: {
+    getAll: () => Promise<Display[]>;
+    getPrimary: () => Promise<Display>;
+    getCurrent: () => Promise<Display>;
+};
+export declare const clipboard: {
+    writeText: (text: string) => Promise<unknown>;
+    readText: () => Promise<string>;
+    writeImage: (base64: string) => Promise<unknown>;
+    readImage: () => Promise<string>;
+    clear: () => Promise<unknown>;
+};
+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 declare const webgpu: {
+    requestAdapter: (options?: GPURequestAdapterOptions) => Promise<GPUAdapter | null>;
+    getPreferredCanvasFormat: () => string;
+};
+export interface BrowserState {
+    url: string;
+    title: string;
+    canGoBack: boolean;
+    canGoForward: boolean;
+    isLoading: boolean;
+}
+type NavigateCallback = (url: string) => void;
+type StateCallback = (state: BrowserState) => void;
+export declare const browser: {
+    navigate: (url: string) => Promise<unknown>;
+    goBack: () => Promise<unknown>;
+    goForward: () => Promise<unknown>;
+    reload: () => Promise<unknown>;
+    stop: () => Promise<unknown>;
+    getUrl: () => Promise<string>;
+    getTitle: () => Promise<string>;
+    getState: () => BrowserState;
+    canGoBack: () => Promise<boolean>;
+    canGoForward: () => Promise<boolean>;
+    onNavigate: (callback: NavigateCallback) => () => void;
+    onStateChange: (callback: StateCallback) => () => void;
+};
+export declare const router: {
+    setRoutes: (routes: Record<string, string>) => void;
+    setInitialRoute: (route: string) => Promise<void>;
+    push: (route: string) => Promise<void>;
+    replace: (route: string) => Promise<void>;
+    getCurrentRoute: () => string;
+    getRoutes: () => {
+        [x: string]: string;
+    };
+};
+declare const _default: {
+    win: {
+        minimize: (id?: WindowId) => Promise<unknown>;
+        maximize: (id?: WindowId) => Promise<unknown>;
+        restore: (id?: WindowId) => Promise<unknown>;
+        close: (id?: WindowId) => Promise<unknown>;
+        show: (id?: WindowId) => Promise<unknown>;
+        hide: (id?: WindowId) => Promise<unknown>;
+        center: (id?: WindowId) => Promise<unknown>;
+        setSize: (w: number, h: number, id?: WindowId) => Promise<unknown>;
+        setPosition: (x: number, y: number, id?: WindowId) => Promise<unknown>;
+        getSize: (id?: WindowId) => Promise<WindowSize>;
+        getPosition: (id?: WindowId) => Promise<WindowPosition>;
+        setTitle: (title: string, id?: WindowId) => Promise<unknown>;
+        setFullscreen: (enabled: boolean, id?: WindowId) => Promise<unknown>;
+        setAlwaysOnTop: (enabled: boolean, id?: WindowId) => Promise<unknown>;
+        setResizable: (enabled: boolean, id?: WindowId) => Promise<unknown>;
+        setDecorations: (enabled: boolean, id?: WindowId) => Promise<unknown>;
+        setTransparency: (alpha: number, id?: WindowId) => Promise<unknown>;
+        isMaximized: (id?: WindowId) => Promise<boolean>;
+        isMinimized: (id?: WindowId) => Promise<boolean>;
+        isVisible: (id?: WindowId) => Promise<boolean>;
+    };
+    tray: {
+        setIcon: (iconPath: string) => Promise<unknown>;
+        setTooltip: (tooltip: string) => Promise<unknown>;
+        setVisible: (visible: boolean) => Promise<unknown>;
+    };
+    app: {
+        quit: () => Promise<unknown>;
+        invoke: (method: string, args?: unknown[]) => Promise<unknown>;
+    };
+    display: {
+        getAll: () => Promise<Display[]>;
+        getPrimary: () => Promise<Display>;
+        getCurrent: () => Promise<Display>;
+    };
+    clipboard: {
+        writeText: (text: string) => Promise<unknown>;
+        readText: () => Promise<string>;
+        writeImage: (base64: string) => Promise<unknown>;
+        readImage: () => Promise<string>;
+        clear: () => Promise<unknown>;
+    };
+    webgpu: {
+        requestAdapter: (options?: GPURequestAdapterOptions) => Promise<GPUAdapter | null>;
+        getPreferredCanvasFormat: () => string;
+    };
+    browser: {
+        navigate: (url: string) => Promise<unknown>;
+        goBack: () => Promise<unknown>;
+        goForward: () => Promise<unknown>;
+        reload: () => Promise<unknown>;
+        stop: () => Promise<unknown>;
+        getUrl: () => Promise<string>;
+        getTitle: () => Promise<string>;
+        getState: () => BrowserState;
+        canGoBack: () => Promise<boolean>;
+        canGoForward: () => Promise<boolean>;
+        onNavigate: (callback: NavigateCallback) => () => void;
+        onStateChange: (callback: StateCallback) => () => void;
+    };
+    router: {
+        setRoutes: (routes: Record<string, string>) => void;
+        setInitialRoute: (route: string) => Promise<void>;
+        push: (route: string) => Promise<void>;
+        replace: (route: string) => Promise<void>;
+        getCurrentRoute: () => string;
+        getRoutes: () => {
+            [x: string]: string;
+        };
+    };
+};
+export default _default;

package/dist/index.js

@@ -0,0 +1,198 @@
+// PlusUI Core SDK
+// Matches Core/Features structure - each feature has backend (C++) and frontend (TS)
+let _invoke = null;
+let _pending = {};
+function initBridge() {
+    if (typeof window === 'undefined')
+        return;
+    const w = window;
+    if (w.__invoke__) {
+        _invoke = w.__invoke__;
+        return;
+    }
+    _pending = {};
+    w.__pending__ = _pending;
+    w.__invoke__ = (method, args) => {
+        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, result) => {
+        const pending = _pending[id];
+        if (pending) {
+            pending.resolve(result);
+            delete _pending[id];
+        }
+    };
+    _invoke = w.__invoke__;
+}
+initBridge();
+async function invoke(method, args) {
+    if (!_invoke) {
+        initBridge();
+        if (!_invoke) {
+            throw new Error('Bridge not initialized');
+        }
+    }
+    return _invoke(method, args);
+}
+// ============================================================================
+// Window API - Core/Features/Window
+// ============================================================================
+export const win = {
+    minimize: async (id) => await invoke('window.minimize', id ? [id] : []),
+    maximize: async (id) => await invoke('window.maximize', id ? [id] : []),
+    restore: async (id) => await invoke('window.restore', id ? [id] : []),
+    close: async (id) => await invoke('window.close', id ? [id] : []),
+    show: async (id) => await invoke('window.show', id ? [id] : []),
+    hide: async (id) => await invoke('window.hide', id ? [id] : []),
+    center: async (id) => await invoke('window.center', id ? [id] : []),
+    setSize: async (w, h, id) => await invoke('window.setSize', id ? [w, h, id] : [w, h]),
+    setPosition: async (x, y, id) => await invoke('window.setPosition', id ? [x, y, id] : [x, y]),
+    getSize: async (id) => await invoke('window.getSize', id ? [id] : []),
+    getPosition: async (id) => await invoke('window.getPosition', id ? [id] : []),
+    setTitle: async (title, id) => await invoke('window.setTitle', id ? [title, id] : [title]),
+    setFullscreen: async (enabled, id) => await invoke('window.setFullscreen', id ? [enabled, id] : [enabled]),
+    setAlwaysOnTop: async (enabled, id) => await invoke('window.setAlwaysOnTop', id ? [enabled, id] : [enabled]),
+    setResizable: async (enabled, id) => await invoke('window.setResizable', id ? [enabled, id] : [enabled]),
+    setDecorations: async (enabled, id) => await invoke('window.setDecorations', id ? [enabled, id] : [enabled]),
+    setTransparency: async (alpha, id) => await invoke('window.setTransparency', id ? [alpha, id] : [alpha]),
+    isMaximized: async (id) => await invoke('window.isMaximized', id ? [id] : []),
+    isMinimized: async (id) => await invoke('window.isMinimized', id ? [id] : []),
+    isVisible: async (id) => await invoke('window.isVisible', id ? [id] : []),
+};
+// ============================================================================
+// Tray API - Core/Features/Tray
+// ============================================================================
+export const tray = {
+    setIcon: async (iconPath) => await invoke('tray.setIcon', [iconPath]),
+    setTooltip: async (tooltip) => await invoke('tray.setTooltip', [tooltip]),
+    setVisible: async (visible) => await invoke('tray.setVisible', [visible]),
+};
+// ============================================================================
+// App API - Core/Features/App
+// ============================================================================
+export const app = {
+    quit: async () => await invoke('app.quit', []),
+    invoke: async (method, args) => await invoke(method, args),
+};
+export const display = {
+    getAll: async () => await invoke('display.getAll', []),
+    getPrimary: async () => await invoke('display.getPrimary', []),
+    getCurrent: async () => await invoke('display.getCurrent', []),
+};
+// ============================================================================
+// Clipboard API - Core/Features/Clipboard
+// ============================================================================
+export const clipboard = {
+    writeText: async (text) => await invoke('clipboard.writeText', [text]),
+    readText: async () => await invoke('clipboard.readText', []),
+    writeImage: async (base64) => await invoke('clipboard.writeImage', [base64]),
+    readImage: async () => await invoke('clipboard.readImage', []),
+    clear: async () => await invoke('clipboard.clear', []),
+};
+export const webgpu = {
+    requestAdapter: async (options) => {
+        const result = await invoke('webgpu.requestAdapter', [options || {}]);
+        return result;
+    },
+    getPreferredCanvasFormat: () => 'bgra8unorm',
+};
+// Initialize navigator.gpu polyfill if not already present
+if (typeof window !== 'undefined' && typeof window.navigator !== 'undefined') {
+    const nav = window.navigator;
+    if (!nav.gpu) {
+        nav.gpu = {
+            requestAdapter: webgpu.requestAdapter,
+            getPreferredCanvasFormat: webgpu.getPreferredCanvasFormat,
+        };
+    }
+}
+const _navigateCallbacks = [];
+const _stateCallbacks = [];
+let _currentState = { url: '', title: '', canGoBack: false, canGoForward: false, isLoading: false };
+// Listen for navigation events from backend
+if (typeof window !== 'undefined') {
+    window.__onNavigate__ = (url) => {
+        _currentState.url = url;
+        _navigateCallbacks.forEach(cb => cb(url));
+    };
+    window.__onBrowserState__ = (state) => {
+        _currentState = state;
+        _stateCallbacks.forEach(cb => cb(state));
+    };
+}
+export const browser = {
+    navigate: async (url) => 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 () => await invoke('browser.getUrl', []),
+    getTitle: async () => await invoke('browser.getTitle', []),
+    getState: () => _currentState,
+    canGoBack: async () => await invoke('browser.canGoBack', []),
+    canGoForward: async () => await invoke('browser.canGoForward', []),
+    onNavigate: (callback) => {
+        _navigateCallbacks.push(callback);
+        return () => {
+            const idx = _navigateCallbacks.indexOf(callback);
+            if (idx > -1)
+                _navigateCallbacks.splice(idx, 1);
+        };
+    },
+    onStateChange: (callback) => {
+        _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 = {};
+let _currentRoute = '/';
+export const router = {
+    setRoutes: (routes) => {
+        _routes = routes;
+    },
+    setInitialRoute: async (route) => {
+        _currentRoute = route;
+        const url = _routes[route] || route;
+        await browser.navigate(url);
+    },
+    push: async (route) => {
+        _currentRoute = route;
+        const url = _routes[route] || route;
+        await browser.navigate(url);
+    },
+    replace: async (route) => {
+        _currentRoute = route;
+        const url = _routes[route] || route;
+        await browser.navigate(url);
+    },
+    getCurrentRoute: () => _currentRoute,
+    getRoutes: () => ({ ..._routes }),
+};
+export default { win, tray, app, display, clipboard, webgpu, browser, router };

package/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "plusui-native-core",
+  "version": "0.1.0",
+  "description": "PlusUI TypeScript SDK for C++ desktop apps",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "files": [
+    "Core",
+    "dist",
+    "src"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "watch": "tsc --watch"
+  },
+  "keywords": ["desktop", "cpp", "webview", "gui"],
+  "license": "MIT"
+}