voltkit 0.1.0

package/dist/ipc-contract.js

@@ -0,0 +1,9 @@
+import { IpcSchema as IpcSchemaValue, createSchema } from './ipc-contract/schema.js';
+export { IpcContractValidationError, isIpcContractValidationError, } from './ipc-contract/types.js';
+export const IpcSchema = IpcSchemaValue;
+export { createSchema };
+export { defineCommands } from './ipc-contract/define.js';
+export { resolveContractChannel } from './ipc-contract/aliases.js';
+export { registerContractHandlers } from './ipc-contract/handlers.js';
+export { createContractInvoker, createLegacyInvokeAdapter, } from './ipc-contract/invoker.js';
+//# sourceMappingURL=ipc-contract.js.map

package/dist/ipc-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ipc-contract.js","sourceRoot":"","sources":["../src/ipc-contract.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,SAAS,IAAI,cAAc,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGrF,OAAO,EACL,0BAA0B,EAC1B,4BAA4B,GAC7B,MAAM,yBAAyB,CAAC;AAGjC,MAAM,CAAC,MAAM,SAAS,GAAG,cAAc,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,EACL,qBAAqB,EACrB,yBAAyB,GAC1B,MAAM,2BAA2B,CAAC"}

package/dist/ipc.d.ts

@@ -0,0 +1,85 @@
+/**
+ * IPC (Inter-Process Communication) module.
+ * Provides the `ipcMain` API for the backend (Node.js) side.
+ */
+type IpcHandler = (args: unknown) => Promise<unknown> | unknown;
+export type IpcErrorCode = 'IPC_HANDLER_NOT_FOUND' | 'IPC_HANDLER_ERROR' | 'IPC_HANDLER_TIMEOUT' | 'IPC_PAYLOAD_TOO_LARGE' | 'IPC_IN_FLIGHT_LIMIT';
+export interface IpcProcessResponse {
+    id: string;
+    result?: unknown;
+    error?: string;
+    errorCode?: IpcErrorCode;
+    errorDetails?: unknown;
+}
+export interface IpcProcessOptions {
+    timeoutMs?: number;
+}
+/**
+ * Backend IPC API (Electron-compatible pattern).
+ * Used in the main process to register handlers that the renderer can invoke.
+ */
+export declare const ipcMain: {
+    /**
+     * Register a handler for an IPC channel.
+     * The handler receives arguments from the renderer and returns a result.
+     *
+     * @example
+     * ```ts
+     * ipcMain.handle('get-user', async (args) => {
+     *   return { name: 'Alice', id: args.id };
+     * });
+     * ```
+     */
+    handle(channel: string, handler: IpcHandler): void;
+    /**
+     * Remove a previously registered handler.
+     */
+    removeHandler(channel: string): void;
+    /**
+     * Remove all registered handlers.
+     * @internal
+     */
+    clearHandlers(): void;
+    /**
+     * Get a registered handler (internal use).
+     * @internal
+     */
+    getHandler(channel: string): IpcHandler | undefined;
+    /**
+     * Check if a handler is registered for a channel.
+     */
+    hasHandler(channel: string): boolean;
+    /**
+     * Process an IPC request from the renderer.
+     * @internal
+     */
+    processRequest(id: string, method: string, args: unknown, options?: IpcProcessOptions): Promise<IpcProcessResponse>;
+};
+/**
+ * Renderer-side IPC API.
+ * These functions are available in the WebView context via `window.__volt__`.
+ * This module provides TypeScript types for the renderer API.
+ */
+/**
+ * Invoke an IPC handler registered in the main process.
+ * This is the renderer-side API - it calls through to the Rust IPC bridge.
+ *
+ * @example
+ * ```ts
+ * // In the renderer (browser context)
+ * const user = await invoke<User>('get-user', { id: 1 });
+ * ```
+ */
+export declare function invoke<T = unknown>(channel: string, ...args: unknown[]): Promise<T>;
+/**
+ * Listen for events emitted from the main process.
+ * This is the renderer-side API.
+ */
+export declare function on(event: string, callback: (...args: unknown[]) => void): void;
+/**
+ * Remove an event listener.
+ * This is the renderer-side API.
+ */
+export declare function off(event: string, callback: (...args: unknown[]) => void): void;
+export {};
+//# sourceMappingURL=ipc.d.ts.map

package/dist/ipc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ipc.d.ts","sourceRoot":"","sources":["../src/ipc.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,KAAK,UAAU,GAAG,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;AAIhE,MAAM,MAAM,YAAY,GACpB,uBAAuB,GACvB,mBAAmB,GACnB,qBAAqB,GACrB,uBAAuB,GACvB,qBAAqB,CAAC;AAE1B,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,YAAY,CAAC;IACzB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAID;;;GAGG;AACH,eAAO,MAAM,OAAO;IAClB;;;;;;;;;;OAUG;oBACa,MAAM,WAAW,UAAU,GAAG,IAAI;IAOlD;;OAEG;2BACoB,MAAM,GAAG,IAAI;IAIpC;;;OAGG;qBACc,IAAI;IAIrB;;;OAGG;wBACiB,MAAM,GAAG,UAAU,GAAG,SAAS;IAInD;;OAEG;wBACiB,MAAM,GAAG,OAAO;IAIpC;;;OAGG;uBAEG,MAAM,UACF,MAAM,QACR,OAAO,YACJ,iBAAiB,GACzB,OAAO,CAAC,kBAAkB,CAAC;CAoC/B,CAAC;AAEF;;;;GAIG;AAEH;;;;;;;;;GASG;AACH,wBAAgB,MAAM,CAAC,CAAC,GAAG,OAAO,EAChC,OAAO,EAAE,MAAM,EACf,GAAG,IAAI,EAAE,OAAO,EAAE,GACjB,OAAO,CAAC,CAAC,CAAC,CAgBZ;AAED;;;GAGG;AACH,wBAAgB,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,IAAI,CAS9E;AAED;;;GAGG;AACH,wBAAgB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,IAAI,CAS/E"}

package/dist/ipc.js

@@ -0,0 +1,196 @@
+/**
+ * IPC (Inter-Process Communication) module.
+ * Provides the `ipcMain` API for the backend (Node.js) side.
+ */
+const handlers = new Map();
+const DEFAULT_HANDLER_TIMEOUT_MS = 5000;
+/**
+ * Backend IPC API (Electron-compatible pattern).
+ * Used in the main process to register handlers that the renderer can invoke.
+ */
+export const ipcMain = {
+    /**
+     * Register a handler for an IPC channel.
+     * The handler receives arguments from the renderer and returns a result.
+     *
+     * @example
+     * ```ts
+     * ipcMain.handle('get-user', async (args) => {
+     *   return { name: 'Alice', id: args.id };
+     * });
+     * ```
+     */
+    handle(channel, handler) {
+        if (handlers.has(channel)) {
+            throw new Error(`IPC handler already registered for channel: ${channel}`);
+        }
+        handlers.set(channel, handler);
+    },
+    /**
+     * Remove a previously registered handler.
+     */
+    removeHandler(channel) {
+        handlers.delete(channel);
+    },
+    /**
+     * Remove all registered handlers.
+     * @internal
+     */
+    clearHandlers() {
+        handlers.clear();
+    },
+    /**
+     * Get a registered handler (internal use).
+     * @internal
+     */
+    getHandler(channel) {
+        return handlers.get(channel);
+    },
+    /**
+     * Check if a handler is registered for a channel.
+     */
+    hasHandler(channel) {
+        return handlers.has(channel);
+    },
+    /**
+     * Process an IPC request from the renderer.
+     * @internal
+     */
+    async processRequest(id, method, args, options = {}) {
+        const handler = handlers.get(method);
+        if (!handler) {
+            return {
+                id,
+                error: `Handler not found: ${method}`,
+                errorCode: 'IPC_HANDLER_NOT_FOUND',
+            };
+        }
+        const timeoutMs = normalizeTimeout(options.timeoutMs);
+        try {
+            const result = await withTimeout(Promise.resolve(handler(args)), timeoutMs, `IPC handler timed out after ${timeoutMs}ms: ${method}`);
+            return { id, result: result ?? null };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            if (isTimeoutError(err)) {
+                return {
+                    id,
+                    error: message,
+                    errorCode: 'IPC_HANDLER_TIMEOUT',
+                    errorDetails: { timeoutMs, method },
+                };
+            }
+            return {
+                id,
+                error: message,
+                errorCode: 'IPC_HANDLER_ERROR',
+            };
+        }
+    },
+};
+/**
+ * Renderer-side IPC API.
+ * These functions are available in the WebView context via `window.__volt__`.
+ * This module provides TypeScript types for the renderer API.
+ */
+/**
+ * Invoke an IPC handler registered in the main process.
+ * This is the renderer-side API - it calls through to the Rust IPC bridge.
+ *
+ * @example
+ * ```ts
+ * // In the renderer (browser context)
+ * const user = await invoke<User>('get-user', { id: 1 });
+ * ```
+ */
+export function invoke(channel, ...args) {
+    // This function is meant to be used in the renderer context
+    // where window.__volt__ is available. In Node.js context, throw.
+    const volt = getVoltBridge();
+    if (volt) {
+        let payload = null;
+        if (args.length === 1) {
+            payload = args[0];
+        }
+        else if (args.length > 1) {
+            payload = args;
+        }
+        return volt.invoke(channel, payload);
+    }
+    throw new Error('invoke() can only be called from the renderer (WebView) context.');
+}
+/**
+ * Listen for events emitted from the main process.
+ * This is the renderer-side API.
+ */
+export function on(event, callback) {
+    const volt = getVoltBridge();
+    if (volt) {
+        volt.on(event, callback);
+        return;
+    }
+    throw new Error('on() can only be called from the renderer (WebView) context.');
+}
+/**
+ * Remove an event listener.
+ * This is the renderer-side API.
+ */
+export function off(event, callback) {
+    const volt = getVoltBridge();
+    if (volt) {
+        volt.off(event, callback);
+        return;
+    }
+    throw new Error('off() can only be called from the renderer (WebView) context.');
+}
+function normalizeTimeout(timeoutMs) {
+    if (typeof timeoutMs !== 'number' || !Number.isFinite(timeoutMs)) {
+        return DEFAULT_HANDLER_TIMEOUT_MS;
+    }
+    if (timeoutMs <= 0) {
+        return DEFAULT_HANDLER_TIMEOUT_MS;
+    }
+    return timeoutMs;
+}
+function isTimeoutError(err) {
+    if (!(err instanceof Error)) {
+        return false;
+    }
+    return err.name === 'TimeoutError';
+}
+function timeoutError(message) {
+    const err = new Error(message);
+    err.name = 'TimeoutError';
+    return err;
+}
+function withTimeout(promise, timeoutMs, message) {
+    return new Promise((resolve, reject) => {
+        const timer = setTimeout(() => {
+            reject(timeoutError(message));
+        }, timeoutMs);
+        if (typeof timer.unref === 'function') {
+            timer.unref();
+        }
+        promise.then((value) => {
+            clearTimeout(timer);
+            resolve(value);
+        }, (err) => {
+            clearTimeout(timer);
+            reject(err);
+        });
+    });
+}
+/** Get the Volt IPC bridge from the window global, or null in Node.js. */
+function getVoltBridge() {
+    // Use globalThis to access window in a way that works in both Node.js and browser.
+    // In Node.js, globalThis.window is undefined. In browser, it's the Window object.
+    const g = globalThis;
+    if (typeof g['window'] !== 'undefined') {
+        const w = g['window'];
+        if (w['__volt__']) {
+            return w['__volt__'];
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=ipc.js.map

package/dist/ipc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ipc.js","sourceRoot":"","sources":["../src/ipc.ts"],"names":[],"mappings":"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"}

package/dist/menu.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Native menu module.
+ * Provides Menu and MenuItem classes for building application and context menus.
+ * Electron-compatible API surface.
+ */
+/** Menu item role for predefined system actions. */
+export type MenuItemRole = 'quit' | 'copy' | 'cut' | 'paste' | 'selectAll' | 'undo' | 'redo' | 'minimize' | 'separator';
+/** Options for creating a menu item. */
+export interface MenuItemOptions {
+    /** Internal menu item ID used for native event dispatch. */
+    id?: string;
+    /** Display label. */
+    label?: string;
+    /** Keyboard accelerator (e.g., 'CmdOrCtrl+C'). */
+    accelerator?: string;
+    /** Whether the item is enabled. Default: true. */
+    enabled?: boolean;
+    /** Item type: 'normal', 'separator', or 'submenu'. */
+    type?: 'normal' | 'separator' | 'submenu';
+    /** Predefined role. When set, label and accelerator are auto-configured. */
+    role?: MenuItemRole;
+    /** Click handler. */
+    click?: () => void;
+    /** Submenu items (only for type 'submenu'). */
+    submenu?: MenuItemOptions[];
+}
+/** A single menu item. */
+export declare class MenuItem {
+    readonly id: string | undefined;
+    readonly label: string;
+    readonly accelerator: string | undefined;
+    readonly enabled: boolean;
+    readonly type: string;
+    readonly role: MenuItemRole | undefined;
+    readonly click: (() => void) | undefined;
+    readonly submenu: MenuItem[] | undefined;
+    constructor(options: MenuItemOptions);
+}
+/**
+ * Native application menu.
+ * Electron-compatible API for building menus.
+ *
+ * @example
+ * ```ts
+ * const menu = Menu.buildFromTemplate([
+ *   { label: 'File', submenu: [
+ *     { label: 'Quit', role: 'quit' },
+ *   ]},
+ * ]);
+ * Menu.setApplicationMenu(menu);
+ * ```
+ */
+export declare class Menu {
+    private items;
+    private _nativeMenu;
+    private static _applicationMenu;
+    /** Build a menu from a template array of options. */
+    static buildFromTemplate(template: MenuItemOptions[]): Menu;
+    /** Set the application menu bar. */
+    static setApplicationMenu(menu: Menu | null): void;
+    /** Get the current application menu. */
+    static getApplicationMenu(): Menu | null;
+    /** Append a menu item. */
+    append(item: MenuItem): void;
+    /** Get all items in this menu. */
+    getItems(): MenuItem[];
+    /** Convert menu to a serializable template for passing to native code. */
+    toJSON(): MenuItemOptions[];
+}
+/** @internal Dispatches a native menu event into the registered JS click callback. */
+export declare function __internalDispatchMenuEvent(menuId: string): void;
+//# sourceMappingURL=menu.d.ts.map

package/dist/menu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu.d.ts","sourceRoot":"","sources":["../src/menu.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,oDAAoD;AACpD,MAAM,MAAM,YAAY,GACpB,MAAM,GACN,MAAM,GACN,KAAK,GACL,OAAO,GACP,WAAW,GACX,MAAM,GACN,MAAM,GACN,UAAU,GACV,WAAW,CAAC;AAEhB,wCAAwC;AACxC,MAAM,WAAW,eAAe;IAC9B,4DAA4D;IAC5D,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,qBAAqB;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kDAAkD;IAClD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,sDAAsD;IACtD,IAAI,CAAC,EAAE,QAAQ,GAAG,WAAW,GAAG,SAAS,CAAC;IAC1C,4EAA4E;IAC5E,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,qBAAqB;IACrB,KAAK,CAAC,EAAE,MAAM,IAAI,CAAC;IACnB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,eAAe,EAAE,CAAC;CAC7B;AAED,0BAA0B;AAC1B,qBAAa,QAAQ;IACnB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,OAAO,EAAE,QAAQ,EAAE,GAAG,SAAS,CAAC;gBAE7B,OAAO,EAAE,eAAe;CAcrC;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,IAAI;IACf,OAAO,CAAC,KAAK,CAAkB;IAC/B,OAAO,CAAC,WAAW,CAAyB;IAE5C,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAAqB;IAEpD,qDAAqD;IACrD,MAAM,CAAC,iBAAiB,CAAC,QAAQ,EAAE,eAAe,EAAE,GAAG,IAAI;IAa3D,oCAAoC;IACpC,MAAM,CAAC,kBAAkB,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI;IA6BlD,wCAAwC;IACxC,MAAM,CAAC,kBAAkB,IAAI,IAAI,GAAG,IAAI;IAIxC,0BAA0B;IAC1B,MAAM,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI;IAU5B,kCAAkC;IAClC,QAAQ,IAAI,QAAQ,EAAE;IAItB,0EAA0E;IAC1E,MAAM,IAAI,eAAe,EAAE;CAG5B;AA6DD,sFAAsF;AACtF,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAUhE"}

package/dist/menu.js

@@ -0,0 +1,179 @@
+/**
+ * Native menu module.
+ * Provides Menu and MenuItem classes for building application and context menus.
+ * Electron-compatible API surface.
+ */
+import { VoltMenu } from '@voltkit/volt-native';
+import { getApp } from './app.js';
+/** A single menu item. */
+export class MenuItem {
+    id;
+    label;
+    accelerator;
+    enabled;
+    type;
+    role;
+    click;
+    submenu;
+    constructor(options) {
+        const isSeparator = (options.type ?? 'normal') === 'separator';
+        const shouldGenerateId = !isSeparator && (!options.role || !!options.click);
+        this.id = options.id ?? (shouldGenerateId ? `menu-item-${nextMenuItemId++}` : undefined);
+        this.label = options.label ?? '';
+        this.accelerator = options.accelerator;
+        this.enabled = options.enabled ?? true;
+        this.type = options.type ?? 'normal';
+        this.role = options.role;
+        this.click = options.click;
+        if (options.submenu) {
+            this.submenu = options.submenu.map((item) => new MenuItem(item));
+        }
+    }
+}
+/**
+ * Native application menu.
+ * Electron-compatible API for building menus.
+ *
+ * @example
+ * ```ts
+ * const menu = Menu.buildFromTemplate([
+ *   { label: 'File', submenu: [
+ *     { label: 'Quit', role: 'quit' },
+ *   ]},
+ * ]);
+ * Menu.setApplicationMenu(menu);
+ * ```
+ */
+export class Menu {
+    items = [];
+    _nativeMenu = null;
+    static _applicationMenu = null;
+    /** Build a menu from a template array of options. */
+    static buildFromTemplate(template) {
+        ensureMenuPermission('Menu.buildFromTemplate()');
+        const menu = new Menu();
+        menu.items = template.map((item) => new MenuItem(item));
+        syncMenuClickHandlers(menu);
+        // Build the native menu from the serializable template
+        const nativeTemplate = menu.toJSON();
+        menu._nativeMenu = new VoltMenu(nativeTemplate);
+        return menu;
+    }
+    /** Set the application menu bar. */
+    static setApplicationMenu(menu) {
+        ensureMenuPermission('Menu.setApplicationMenu()');
+        const previousMenu = Menu._applicationMenu;
+        if (menu) {
+            const nextNativeMenu = menu._nativeMenu ?? new VoltMenu(menu.toJSON());
+            syncMenuClickHandlers(menu);
+            try {
+                nextNativeMenu.setAsAppMenu();
+            }
+            catch (err) {
+                if (previousMenu !== menu) {
+                    clearMenuClickHandlers(menu);
+                }
+                throw err;
+            }
+            if (previousMenu && previousMenu !== menu) {
+                clearMenuClickHandlers(previousMenu);
+            }
+            menu._nativeMenu = nextNativeMenu;
+            Menu._applicationMenu = menu;
+            return;
+        }
+        // Explicitly clear native app menu when caller passes null.
+        new VoltMenu([]).setAsAppMenu();
+        if (previousMenu) {
+            clearMenuClickHandlers(previousMenu);
+        }
+        Menu._applicationMenu = null;
+    }
+    /** Get the current application menu. */
+    static getApplicationMenu() {
+        return Menu._applicationMenu;
+    }
+    /** Append a menu item. */
+    append(item) {
+        ensureMenuPermission('Menu.append()');
+        this.items.push(item);
+        this._nativeMenu = new VoltMenu(this.toJSON());
+        syncMenuClickHandlers(this);
+        if (Menu._applicationMenu === this) {
+            this._nativeMenu.setAsAppMenu();
+        }
+    }
+    /** Get all items in this menu. */
+    getItems() {
+        return [...this.items];
+    }
+    /** Convert menu to a serializable template for passing to native code. */
+    toJSON() {
+        return this.items.map((item) => serializeMenuItem(item));
+    }
+}
+/** Recursively serialize a MenuItem to a plain object for native. */
+function serializeMenuItem(item) {
+    const result = {
+        id: item.id,
+        label: item.label,
+        accelerator: item.accelerator,
+        enabled: item.enabled,
+        type: item.type,
+        role: item.role,
+    };
+    if (item.submenu) {
+        result.submenu = item.submenu.map((sub) => serializeMenuItem(sub));
+    }
+    return result;
+}
+const menuClickHandlers = new Map();
+const menuHandlerIds = new WeakMap();
+let nextMenuItemId = 1;
+function ensureMenuPermission(apiName) {
+    const granted = new Set(getApp().getConfig().permissions ?? []);
+    if (!granted.has('menu')) {
+        throw new Error(`Permission denied: ${apiName} requires 'menu' in volt.config.ts permissions.`);
+    }
+}
+function syncMenuClickHandlers(menu) {
+    clearMenuClickHandlers(menu);
+    const ids = new Set();
+    collectMenuClickHandlers(menu.getItems(), ids);
+    menuHandlerIds.set(menu, ids);
+}
+function clearMenuClickHandlers(menu) {
+    const ids = menuHandlerIds.get(menu);
+    if (!ids) {
+        return;
+    }
+    for (const id of ids) {
+        menuClickHandlers.delete(id);
+    }
+    menuHandlerIds.delete(menu);
+}
+function collectMenuClickHandlers(items, ids) {
+    for (const item of items) {
+        if (item.id && item.click) {
+            menuClickHandlers.set(item.id, item.click);
+            ids.add(item.id);
+        }
+        if (item.submenu) {
+            collectMenuClickHandlers(item.submenu, ids);
+        }
+    }
+}
+/** @internal Dispatches a native menu event into the registered JS click callback. */
+export function __internalDispatchMenuEvent(menuId) {
+    const clickHandler = menuClickHandlers.get(menuId);
+    if (!clickHandler) {
+        return;
+    }
+    try {
+        clickHandler();
+    }
+    catch (err) {
+        console.error('[volt] Menu click handler failed:', err);
+    }
+}
+//# sourceMappingURL=menu.js.map

package/dist/menu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu.js","sourceRoot":"","sources":["../src/menu.ts"],"names":[],"mappings":"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"}

package/dist/notification.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Native notification module.
+ * Provides OS-level notifications.
+ * Requires `permissions: ['notification']` in volt.config.ts.
+ */
+/** Options for creating a notification. */
+export interface NotificationOptions {
+    /** Notification title. */
+    title: string;
+    /** Notification body text. */
+    body?: string;
+    /** Path to an icon file. */
+    icon?: string;
+}
+/**
+ * Native OS notification.
+ * Web Notification API compatible.
+ *
+ * @example
+ * ```ts
+ * new Notification({ title: 'New message', body: 'Hello!' }).show();
+ * ```
+ */
+export declare class Notification {
+    readonly title: string;
+    readonly body: string | undefined;
+    readonly icon: string | undefined;
+    constructor(options: NotificationOptions);
+    /** Display the notification. */
+    show(): void;
+    /** Check if the OS supports notifications. */
+    static isSupported(): boolean;
+}
+//# sourceMappingURL=notification.d.ts.map

package/dist/notification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification.d.ts","sourceRoot":"","sources":["../src/notification.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,2CAA2C;AAC3C,MAAM,WAAW,mBAAmB;IAClC,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,8BAA8B;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4BAA4B;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;GAQG;AACH,qBAAa,YAAY;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;gBAEtB,OAAO,EAAE,mBAAmB;IAUxC,gCAAgC;IAChC,IAAI,IAAI,IAAI;IAQZ,8CAA8C;IAC9C,MAAM,CAAC,WAAW,IAAI,OAAO;CAG9B"}

package/dist/notification.js

@@ -0,0 +1,42 @@
+/**
+ * Native notification module.
+ * Provides OS-level notifications.
+ * Requires `permissions: ['notification']` in volt.config.ts.
+ */
+import { notificationShow } from '@voltkit/volt-native';
+/**
+ * Native OS notification.
+ * Web Notification API compatible.
+ *
+ * @example
+ * ```ts
+ * new Notification({ title: 'New message', body: 'Hello!' }).show();
+ * ```
+ */
+export class Notification {
+    title;
+    body;
+    icon;
+    constructor(options) {
+        const title = options.title.trim();
+        if (!title) {
+            throw new Error('Notification title must be a non-empty string.');
+        }
+        this.title = title;
+        this.body = options.body;
+        this.icon = options.icon;
+    }
+    /** Display the notification. */
+    show() {
+        notificationShow({
+            title: this.title,
+            body: this.body,
+            icon: this.icon,
+        });
+    }
+    /** Check if the OS supports notifications. */
+    static isSupported() {
+        return true;
+    }
+}
+//# sourceMappingURL=notification.js.map

package/dist/notification.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification.js","sourceRoot":"","sources":["../src/notification.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAYxD;;;;;;;;GAQG;AACH,MAAM,OAAO,YAAY;IACd,KAAK,CAAS;IACd,IAAI,CAAqB;IACzB,IAAI,CAAqB;IAElC,YAAY,OAA4B;QACtC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QACnC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;QACpE,CAAC;QACD,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAC3B,CAAC;IAED,gCAAgC;IAChC,IAAI;QACF,gBAAgB,CAAC;YACf,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;SAChB,CAAC,CAAC;IACL,CAAC;IAED,8CAA8C;IAC9C,MAAM,CAAC,WAAW;QAChB,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/renderer.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Renderer-safe entrypoint.
+ * Exposes only APIs that are valid in the WebView/browser context.
+ */
+export { invoke, on, off } from './ipc.js';
+export type { IpcErrorCode } from './ipc.js';
+export { createContractInvoker, createLegacyInvokeAdapter, createSchema, defineCommands, IpcSchema, isIpcContractValidationError, resolveContractChannel, IpcContractValidationError, } from './ipc-contract.js';
+export type { InferCommandRequest, InferCommandResponse, InferSchemaValue, IpcCommandDefinition, IpcCommandMap, IpcInvokeFn, IpcSchema as IpcSchemaType, TypedIpcInvoker, } from './ipc-contract.js';
+//# sourceMappingURL=renderer.d.ts.map