voltkit 0.1.0

package/dist/renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../src/renderer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC3C,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,EACL,qBAAqB,EACrB,yBAAyB,EACzB,YAAY,EACZ,cAAc,EACd,SAAS,EACT,4BAA4B,EAC5B,sBAAsB,EACtB,0BAA0B,GAC3B,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,EAChB,oBAAoB,EACpB,aAAa,EACb,WAAW,EACX,SAAS,IAAI,aAAa,EAC1B,eAAe,GAChB,MAAM,mBAAmB,CAAC"}

package/dist/renderer.js

@@ -0,0 +1,7 @@
+/**
+ * Renderer-safe entrypoint.
+ * Exposes only APIs that are valid in the WebView/browser context.
+ */
+export { invoke, on, off } from './ipc.js';
+export { createContractInvoker, createLegacyInvokeAdapter, createSchema, defineCommands, IpcSchema, isIpcContractValidationError, resolveContractChannel, IpcContractValidationError, } from './ipc-contract.js';
+//# sourceMappingURL=renderer.js.map

package/dist/renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.js","sourceRoot":"","sources":["../src/renderer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAE3C,OAAO,EACL,qBAAqB,EACrB,yBAAyB,EACzB,YAAY,EACZ,cAAc,EACd,SAAS,EACT,4BAA4B,EAC5B,sBAAsB,EACtB,0BAA0B,GAC3B,MAAM,mBAAmB,CAAC"}

package/dist/runtime-modules.d.ts

@@ -0,0 +1,161 @@
+declare module 'volt:ipc' {
+    interface IpcMain {
+        handle(channel: string, handler: (args: unknown) => unknown | Promise<unknown>): void;
+        removeHandler(channel: string): void;
+        clearHandlers(): void;
+        hasHandler(channel: string): boolean;
+        emit(eventName: string, data?: unknown): void;
+        emitTo(windowId: string, eventName: string, data?: unknown): void;
+    }
+    const ipcMain: IpcMain;
+}
+declare module 'volt:events' {
+    function emit(eventName: string, data?: unknown): void;
+    function emitTo(windowId: string, eventName: string, data?: unknown): void;
+}
+declare module 'volt:window' {
+    function close(windowId?: string): void;
+    function show(windowId?: string): void;
+    function focus(windowId?: string): void;
+    function maximize(windowId?: string): void;
+    function minimize(windowId?: string): void;
+    function restore(windowId?: string): void;
+    function getWindowCount(): Promise<number>;
+    function quit(): void;
+}
+declare module 'volt:menu' {
+    function setAppMenu(template: unknown): Promise<void>;
+    function on(eventName: 'click', handler: (payload: unknown) => void): void;
+    function off(eventName: 'click', handler: (payload: unknown) => void): void;
+}
+declare module 'volt:globalShortcut' {
+    function register(accelerator: string): Promise<number>;
+    function unregister(accelerator: string): Promise<void>;
+    function unregisterAll(): Promise<void>;
+    function on(eventName: 'triggered', handler: (payload: unknown) => void): void;
+    function off(eventName: 'triggered', handler: (payload: unknown) => void): void;
+}
+declare module 'volt:tray' {
+    interface TrayCreateOptions {
+        tooltip?: string;
+        icon?: string;
+    }
+    function create(options?: TrayCreateOptions): Promise<void>;
+    function setTooltip(tooltip: string): void;
+    function setVisible(visible: boolean): void;
+    function destroy(): void;
+    function on(eventName: 'click', handler: (payload: unknown) => void): void;
+    function off(eventName: 'click', handler: (payload: unknown) => void): void;
+}
+declare module 'volt:db' {
+    interface DbExecuteResult {
+        rowsAffected: number;
+    }
+    function open(path: string): Promise<void>;
+    function close(): Promise<void>;
+    function execute(sql: string, params?: unknown[]): Promise<DbExecuteResult>;
+    function query(sql: string, params?: unknown[]): Promise<unknown[]>;
+    function queryOne(sql: string, params?: unknown[]): Promise<unknown | null>;
+    function transaction<T>(callback: () => Promise<T> | T): Promise<T>;
+}
+declare module 'volt:secureStorage' {
+    export function set(key: string, value: string): Promise<void>;
+    export function get(key: string): Promise<string | null>;
+    function remove(key: string): Promise<void>;
+    export { remove as delete };
+    export function has(key: string): Promise<boolean>;
+}
+declare module 'volt:clipboard' {
+    function readText(): string;
+    function writeText(text: string): void;
+}
+declare module 'volt:crypto' {
+    function sha256(data: string): string;
+    function base64Encode(data: string): string;
+    function base64Decode(data: string): string;
+}
+declare module 'volt:os' {
+    function platform(): string;
+    function arch(): string;
+    function homeDir(): string;
+    function tempDir(): string;
+}
+declare module 'volt:shell' {
+    function openExternal(url: string): Promise<void>;
+    function showItemInFolder(path: string): void;
+}
+declare module 'volt:notification' {
+    interface NotificationOptions {
+        title: string;
+        body?: string;
+        icon?: string;
+    }
+    function show(options: NotificationOptions): void;
+}
+declare module 'volt:dialog' {
+    interface FileFilter {
+        name: string;
+        extensions: string[];
+    }
+    interface OpenDialogOptions {
+        title?: string;
+        defaultPath?: string;
+        filters?: FileFilter[];
+        multiple?: boolean;
+        directory?: boolean;
+    }
+    interface SaveDialogOptions {
+        title?: string;
+        defaultPath?: string;
+        filters?: FileFilter[];
+    }
+    interface MessageDialogOptions {
+        dialogType?: 'info' | 'warning' | 'error';
+        title?: string;
+        message: string;
+        buttons?: string[];
+    }
+    function showOpen(options?: OpenDialogOptions): Promise<string | null>;
+    function showSave(options?: SaveDialogOptions): Promise<string | null>;
+    function showMessage(options: MessageDialogOptions): Promise<0 | 1>;
+}
+declare module 'volt:fs' {
+    function readFile(path: string): Promise<string>;
+    function writeFile(path: string, data: string): Promise<void>;
+    function readDir(path: string): Promise<string[]>;
+    function exists(path: string): Promise<boolean>;
+    function mkdir(path: string): Promise<void>;
+    function remove(path: string): Promise<void>;
+}
+declare module 'volt:http' {
+    interface HttpFetchRequest {
+        url: string;
+        method?: string;
+        headers?: Record<string, string>;
+        body?: unknown;
+        timeoutMs?: number;
+    }
+    interface HttpFetchResponse {
+        status: number;
+        headers: Record<string, string[]>;
+        text(): Promise<string>;
+        json(): Promise<unknown>;
+    }
+    function fetch(request: HttpFetchRequest): Promise<HttpFetchResponse>;
+}
+declare module 'volt:updater' {
+    interface UpdateCheckOptions {
+        url: string;
+        currentVersion: string;
+    }
+    interface UpdateInfo {
+        version: string;
+        url: string;
+        signature: string;
+        sha256: string;
+    }
+    function checkForUpdate(options: UpdateCheckOptions): Promise<UpdateInfo | null>;
+    function downloadAndInstall(updateInfo: UpdateInfo): Promise<void>;
+    function cancelDownloadAndInstall(): void;
+}
+//# sourceMappingURL=runtime-modules.d.ts.map

package/dist/runtime-modules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-modules.d.ts","sourceRoot":"","sources":["../src/runtime-modules.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,UAAU,CAAC;IACxB,UAAiB,OAAO;QACtB,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;QACtF,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QACrC,aAAa,IAAI,IAAI,CAAC;QACtB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;QACrC,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;QAC9C,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;KACnE;IAEM,MAAM,OAAO,EAAE,OAAO,CAAC;CAC/B;AAED,OAAO,QAAQ,aAAa,CAAC;IAC3B,SAAgB,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC9D,SAAgB,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CACnF;AAED,OAAO,QAAQ,aAAa,CAAC;IAC3B,SAAgB,KAAK,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/C,SAAgB,IAAI,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9C,SAAgB,KAAK,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/C,SAAgB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClD,SAAgB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClD,SAAgB,OAAO,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjD,SAAgB,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAClD,SAAgB,IAAI,IAAI,IAAI,CAAC;CAC9B;AAED,OAAO,QAAQ,WAAW,CAAC;IACzB,SAAgB,UAAU,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7D,SAAgB,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAAC;IAClF,SAAgB,GAAG,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAAC;CACpF;AAED,OAAO,QAAQ,qBAAqB,CAAC;IACnC,SAAgB,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/D,SAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/D,SAAgB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,SAAgB,EAAE,CAAC,SAAS,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAAC;IACtF,SAAgB,GAAG,CAAC,SAAS,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAAC;CACxF;AAED,OAAO,QAAQ,WAAW,CAAC;IACzB,UAAiB,iBAAiB;QAChC,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf;IAED,SAAgB,MAAM,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnE,SAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAClD,SAAgB,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IACnD,SAAgB,OAAO,IAAI,IAAI,CAAC;IAChC,SAAgB,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAAC;IAClF,SAAgB,GAAG,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAAC;CACpF;AAED,OAAO,QAAQ,SAAS,CAAC;IACvB,UAAiB,eAAe;QAC9B,YAAY,EAAE,MAAM,CAAC;KACtB;IAED,SAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,SAAgB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,SAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IACnF,SAAgB,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAC3E,SAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IACnF,SAAgB,WAAW,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CAC5E;AAED,OAAO,QAAQ,oBAAoB,CAAC;IAClC,MAAM,UAAU,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/D,MAAM,UAAU,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACzD,SAAS,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,OAAO,EAAE,MAAM,IAAI,MAAM,EAAE,CAAC;IAC5B,MAAM,UAAU,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACpD;AAED,OAAO,QAAQ,gBAAgB,CAAC;IAC9B,SAAgB,QAAQ,IAAI,MAAM,CAAC;IACnC,SAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/C;AAED,OAAO,QAAQ,aAAa,CAAC;IAC3B,SAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7C,SAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACnD,SAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;CACpD;AAED,OAAO,QAAQ,SAAS,CAAC;IACvB,SAAgB,QAAQ,IAAI,MAAM,CAAC;IACnC,SAAgB,IAAI,IAAI,MAAM,CAAC;IAC/B,SAAgB,OAAO,IAAI,MAAM,CAAC;IAClC,SAAgB,OAAO,IAAI,MAAM,CAAC;CACnC;AAED,OAAO,QAAQ,YAAY,CAAC;IAC1B,SAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzD,SAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACtD;AAED,OAAO,QAAQ,mBAAmB,CAAC;IACjC,UAAiB,mBAAmB;QAClC,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;KACf;IAED,SAAgB,IAAI,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAAC;CAC1D;AAED,OAAO,QAAQ,aAAa,CAAC;IAC3B,UAAiB,UAAU;QACzB,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,MAAM,EAAE,CAAC;KACtB;IAED,UAAiB,iBAAiB;QAChC,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC;QACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,SAAS,CAAC,EAAE,OAAO,CAAC;KACrB;IAED,UAAiB,iBAAiB;QAChC,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC;KACxB;IAED,UAAiB,oBAAoB;QACnC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;QAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;KACpB;IAED,SAAgB,QAAQ,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC9E,SAAgB,QAAQ,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC9E,SAAgB,WAAW,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;CAC5E;AAED,OAAO,QAAQ,SAAS,CAAC;IACvB,SAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACxD,SAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrE,SAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACzD,SAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACvD,SAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,SAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrD;AAED,OAAO,QAAQ,WAAW,CAAC;IACzB,UAAiB,gBAAgB;QAC/B,GAAG,EAAE,MAAM,CAAC;QACZ,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACjC,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB;IAED,UAAiB,iBAAiB;QAChC,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAClC,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;QACxB,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;KAC1B;IAED,SAAgB,KAAK,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAC9E;AAED,OAAO,QAAQ,cAAc,CAAC;IAC5B,UAAiB,kBAAkB;QACjC,GAAG,EAAE,MAAM,CAAC;QACZ,cAAc,EAAE,MAAM,CAAC;KACxB;IAED,UAAiB,UAAU;QACzB,OAAO,EAAE,MAAM,CAAC;QAChB,GAAG,EAAE,MAAM,CAAC;QACZ,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;KAChB;IAED,SAAgB,cAAc,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IACxF,SAAgB,kBAAkB,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1E,SAAgB,wBAAwB,IAAI,IAAI,CAAC;CAClD"}

package/dist/runtime-modules.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=runtime-modules.js.map

package/dist/runtime-modules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-modules.js","sourceRoot":"","sources":["../src/runtime-modules.ts"],"names":[],"mappings":""}

package/dist/shell.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Shell module.
+ * Provides secure URL opening with protocol validation.
+ * Requires `permissions: ['shell']` in volt.config.ts.
+ */
+/**
+ * Open a URL in the default system application.
+ * SECURITY: Only allows http, https, and mailto protocols.
+ * All other protocols (file://, javascript:, data:, etc.) are rejected.
+ *
+ * @example
+ * ```ts
+ * await shell.openExternal('https://example.com');
+ * ```
+ */
+declare function openExternal(url: string): Promise<void>;
+/** Shell APIs. Requires `permissions: ['shell']` in volt.config.ts. */
+export declare const shell: {
+    openExternal: typeof openExternal;
+};
+export {};
+//# sourceMappingURL=shell.d.ts.map

package/dist/shell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell.d.ts","sourceRoot":"","sources":["../src/shell.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;;;;;;;GASG;AACH,iBAAe,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBtD;AAED,uEAAuE;AACvE,eAAO,MAAM,KAAK;;CAEjB,CAAC"}

package/dist/shell.js

@@ -0,0 +1,36 @@
+/**
+ * Shell module.
+ * Provides secure URL opening with protocol validation.
+ * Requires `permissions: ['shell']` in volt.config.ts.
+ */
+import { shellOpenExternal } from '@voltkit/volt-native';
+/**
+ * Open a URL in the default system application.
+ * SECURITY: Only allows http, https, and mailto protocols.
+ * All other protocols (file://, javascript:, data:, etc.) are rejected.
+ *
+ * @example
+ * ```ts
+ * await shell.openExternal('https://example.com');
+ * ```
+ */
+async function openExternal(url) {
+    // Validate URL scheme on the TypeScript side as well (defense-in-depth)
+    const ALLOWED_SCHEMES = ['http:', 'https:', 'mailto:'];
+    let parsed;
+    try {
+        parsed = new URL(url);
+    }
+    catch {
+        throw new Error(`Invalid URL: ${url}`);
+    }
+    if (!ALLOWED_SCHEMES.includes(parsed.protocol)) {
+        throw new Error(`Protocol not allowed: '${parsed.protocol}'. Only http, https, and mailto are permitted.`);
+    }
+    shellOpenExternal(url);
+}
+/** Shell APIs. Requires `permissions: ['shell']` in volt.config.ts. */
+export const shell = {
+    openExternal,
+};
+//# sourceMappingURL=shell.js.map

package/dist/shell.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell.js","sourceRoot":"","sources":["../src/shell.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEzD;;;;;;;;;GASG;AACH,KAAK,UAAU,YAAY,CAAC,GAAW;IACrC,wEAAwE;IACxE,MAAM,eAAe,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;IACvD,IAAI,MAAW,CAAC;IAChB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,gBAAgB,GAAG,EAAE,CAAC,CAAC;IACzC,CAAC;IAED,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC/C,MAAM,IAAI,KAAK,CACb,0BAA0B,MAAM,CAAC,QAAQ,gDAAgD,CAC1F,CAAC;IACJ,CAAC;IAED,iBAAiB,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC;AAED,uEAAuE;AACvE,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,YAAY;CACb,CAAC"}

package/dist/tray.d.ts

@@ -0,0 +1,59 @@
+/**
+ * System tray module.
+ * Provides the `Tray` class for creating and managing system tray icons.
+ * Requires `permissions: ['tray']` in volt.config.ts.
+ */
+import { EventEmitter } from 'node:events';
+/** Options for creating a system tray icon. */
+export interface TrayOptions {
+    /** Tooltip text shown on hover. */
+    tooltip?: string;
+    /** Path to the tray icon image (PNG). */
+    icon?: string;
+    /** Menu items to show in the tray context menu (currently unsupported). */
+    menu?: TrayMenuItem[];
+}
+/** A tray context menu item. */
+export interface TrayMenuItem {
+    /** Display label. */
+    label: string;
+    /** Whether the item is enabled. Default: true. */
+    enabled?: boolean;
+    /** Item type: 'normal' or 'separator'. */
+    type?: 'normal' | 'separator';
+    /** Click handler. */
+    click?: () => void;
+}
+/**
+ * System tray icon.
+ * Electron-compatible API for creating and managing system tray icons.
+ *
+ * @example
+ * ```ts
+ * const tray = new Tray({ tooltip: 'My App', icon: './icon.png' });
+ * tray.on('click', () => { mainWindow.show(); });
+ * ```
+ */
+export declare class Tray extends EventEmitter {
+    private _tooltip;
+    private _icon;
+    private _visible;
+    private _destroyed;
+    private _native;
+    constructor(options?: TrayOptions);
+    /** Set the tray tooltip text. */
+    setToolTip(tooltip: string): void;
+    /** Get the current tooltip text. */
+    getToolTip(): string;
+    /** Set the tray icon from a file path. */
+    setImage(iconPath: string): void;
+    /** Show or hide the tray icon. */
+    setVisible(visible: boolean): void;
+    /** Check if the tray icon is visible. */
+    isVisible(): boolean;
+    /** Destroy the tray icon and clean up resources. */
+    destroy(): void;
+    /** Check if the tray has been destroyed. */
+    isDestroyed(): boolean;
+}
+//# sourceMappingURL=tray.d.ts.map

package/dist/tray.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tray.d.ts","sourceRoot":"","sources":["../src/tray.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAK3C,+CAA+C;AAC/C,MAAM,WAAW,WAAW;IAC1B,mCAAmC;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2EAA2E;IAC3E,IAAI,CAAC,EAAE,YAAY,EAAE,CAAC;CACvB;AAED,gCAAgC;AAChC,MAAM,WAAW,YAAY;IAC3B,qBAAqB;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,0CAA0C;IAC1C,IAAI,CAAC,EAAE,QAAQ,GAAG,WAAW,CAAC;IAC9B,qBAAqB;IACrB,KAAK,CAAC,EAAE,MAAM,IAAI,CAAC;CACpB;AAED;;;;;;;;;GASG;AACH,qBAAa,IAAK,SAAQ,YAAY;IACpC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,KAAK,CAAqB;IAClC,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,UAAU,CAAkB;IACpC,OAAO,CAAC,OAAO,CAAW;gBAEd,OAAO,GAAE,WAAgB;IAwCrC,iCAAiC;IACjC,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAQjC,oCAAoC;IACpC,UAAU,IAAI,MAAM;IAIpB,0CAA0C;IAC1C,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAQhC,kCAAkC;IAClC,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAQlC,yCAAyC;IACzC,SAAS,IAAI,OAAO;IAIpB,oDAAoD;IACpD,OAAO,IAAI,IAAI;IASf,4CAA4C;IAC5C,WAAW,IAAI,OAAO;CAGvB"}

package/dist/tray.js

@@ -0,0 +1,114 @@
+/**
+ * System tray module.
+ * Provides the `Tray` class for creating and managing system tray icons.
+ * Requires `permissions: ['tray']` in volt.config.ts.
+ */
+import { EventEmitter } from 'node:events';
+import { VoltTray } from '@voltkit/volt-native';
+import { getApp } from './app.js';
+/**
+ * System tray icon.
+ * Electron-compatible API for creating and managing system tray icons.
+ *
+ * @example
+ * ```ts
+ * const tray = new Tray({ tooltip: 'My App', icon: './icon.png' });
+ * tray.on('click', () => { mainWindow.show(); });
+ * ```
+ */
+export class Tray extends EventEmitter {
+    _tooltip;
+    _icon;
+    _visible = true;
+    _destroyed = false;
+    _native;
+    constructor(options = {}) {
+        super();
+        requireTrayPermissions(options.icon ? ['tray', 'fs'] : ['tray'], 'new Tray()');
+        if (options.menu && options.menu.length > 0) {
+            console.warn('[volt] Tray menu is not supported yet and will be ignored.');
+        }
+        this._tooltip = options.tooltip ?? '';
+        this._icon = options.icon;
+        // Create the native tray via napi binding
+        this._native = new VoltTray({
+            tooltip: this._tooltip,
+            icon: this._icon,
+        });
+        // Wire native click events to the EventEmitter
+        this._native.onClick((err, eventJson) => {
+            if (err || typeof eventJson !== 'string') {
+                this.emit('click');
+                return;
+            }
+            let event;
+            try {
+                event = JSON.parse(eventJson);
+            }
+            catch {
+                event = undefined;
+            }
+            if (event !== undefined) {
+                this.emit('click', event);
+            }
+            else {
+                this.emit('click');
+            }
+        });
+    }
+    /** Set the tray tooltip text. */
+    setToolTip(tooltip) {
+        requireTrayPermissions(['tray'], 'Tray.setToolTip()');
+        this._tooltip = tooltip;
+        if (!this._destroyed) {
+            this._native.setTooltip(tooltip);
+        }
+    }
+    /** Get the current tooltip text. */
+    getToolTip() {
+        return this._tooltip;
+    }
+    /** Set the tray icon from a file path. */
+    setImage(iconPath) {
+        requireTrayPermissions(['tray', 'fs'], 'Tray.setImage()');
+        this._icon = iconPath;
+        if (!this._destroyed) {
+            this._native.setIcon(iconPath);
+        }
+    }
+    /** Show or hide the tray icon. */
+    setVisible(visible) {
+        requireTrayPermissions(['tray'], 'Tray.setVisible()');
+        this._visible = visible;
+        if (!this._destroyed) {
+            this._native.setVisible(visible);
+        }
+    }
+    /** Check if the tray icon is visible. */
+    isVisible() {
+        return this._visible;
+    }
+    /** Destroy the tray icon and clean up resources. */
+    destroy() {
+        requireTrayPermissions(['tray'], 'Tray.destroy()');
+        if (this._destroyed)
+            return;
+        this._destroyed = true;
+        this._visible = false;
+        this._native.destroy();
+        this.removeAllListeners();
+    }
+    /** Check if the tray has been destroyed. */
+    isDestroyed() {
+        return this._destroyed;
+    }
+}
+function requireTrayPermissions(required, apiName) {
+    const granted = new Set(getApp().getConfig().permissions ?? []);
+    for (const permission of required) {
+        if (!granted.has(permission)) {
+            throw new Error(`Permission denied: ${apiName} requires '${permission}' in volt.config.ts permissions.`);
+        }
+    }
+}
+//# sourceMappingURL=tray.js.map

package/dist/tray.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,200 @@
+/** Configuration for the Volt application, typically defined in volt.config.ts. */
+export interface VoltConfig {
+    /** Display name of the application. */
+    name: string;
+    /** Application version (semver). */
+    version?: string;
+    /** Window configuration. */
+    window?: WindowOptions;
+    /** Declared permissions for native API access. */
+    permissions?: Permission[];
+    /** Build configuration. */
+    build?: BuildConfig;
+    /** Backend entrypoint bundled into the standalone runtime (e.g. './src/backend.ts'). */
+    backend?: string;
+    /** Packaging configuration for platform installers. */
+    package?: PackageConfig;
+    /** Auto-updater configuration. */
+    updater?: UpdaterConfig;
+    /** Boa runtime pool configuration for production builds. */
+    runtime?: RuntimeConfig;
+    /** Legacy alias for runtime.poolSize. Prefer using runtime.poolSize. */
+    runtimePoolSize?: number;
+    /** Whether to enable devtools. Defaults to true in dev, false in production. */
+    devtools?: boolean;
+}
+/** Window creation options, compatible with Electron's BrowserWindow subset. */
+export interface WindowOptions {
+    /** Window width in pixels. Default: 800. */
+    width?: number;
+    /** Window height in pixels. Default: 600. */
+    height?: number;
+    /** Minimum window width. */
+    minWidth?: number;
+    /** Minimum window height. */
+    minHeight?: number;
+    /** Maximum window width. */
+    maxWidth?: number;
+    /** Maximum window height. */
+    maxHeight?: number;
+    /** Window title. */
+    title?: string;
+    /** Whether the window is resizable. Default: true. */
+    resizable?: boolean;
+    /** Whether to show window decorations. Default: true. */
+    decorations?: boolean;
+    /** Whether window is transparent. Default: false. */
+    transparent?: boolean;
+    /** Whether window is always on top. Default: false. */
+    alwaysOnTop?: boolean;
+    /** Whether window starts maximized. Default: false. */
+    maximized?: boolean;
+    /** Whether WebView devtools should be enabled for this window. */
+    devtools?: boolean;
+    /** Initial X position. */
+    x?: number;
+    /** Initial Y position. */
+    y?: number;
+}
+/** Capability-based permissions that must be declared in volt.config.ts. */
+export type Permission = 'clipboard' | 'notification' | 'dialog' | 'fs' | 'db' | 'menu' | 'shell' | 'http' | 'globalShortcut' | 'tray' | 'secureStorage';
+/** Build output configuration. */
+export interface BuildConfig {
+    /** Output directory for built assets. Default: 'dist'. */
+    outDir?: string;
+}
+/** Runtime execution configuration. */
+export interface RuntimeConfig {
+    /** Number of Boa runtimes in the IPC pool. Clamped to [2, 4] by the runner. */
+    poolSize?: number;
+}
+/** Packaging configuration for platform-specific installers. */
+export interface PackageConfig {
+    /** Application identifier (e.g., 'com.example.myapp'). */
+    identifier: string;
+    /** Path to the application icon. */
+    icon?: string;
+    /** Application categories (for Linux .desktop files). */
+    categories?: string[];
+    /** Windows-specific packaging settings (NSIS/MSIX/install mode). */
+    windows?: PackageWindowsConfig;
+    /** Enterprise packaging outputs (ADMX/docs bundle generation). */
+    enterprise?: PackageEnterpriseConfig;
+    /** Code signing configuration. Opt-in - omit to skip signing. */
+    signing?: SigningConfig;
+}
+/** Default Windows installation scope for generated installers. */
+export type WindowsInstallMode = 'perMachine' | 'perUser';
+/** MSIX metadata overrides for Windows package identity and display fields. */
+export interface PackageWindowsMsixConfig {
+    /** Package identity name (must remain stable for updates). */
+    identityName?: string;
+    /** Publisher subject, usually a CN value (for example "CN=Contoso"). */
+    publisher?: string;
+    /** Publisher display name shown in Windows package metadata. */
+    publisherDisplayName?: string;
+    /** Display name shown by Windows for the installed package. */
+    displayName?: string;
+    /** Description shown in Windows package metadata. */
+    description?: string;
+}
+/** Windows packaging settings for NSIS and MSIX outputs. */
+export interface PackageWindowsConfig {
+    /** Default install scope for NSIS packaging and enterprise policy output. */
+    installMode?: WindowsInstallMode;
+    /** Force /ALLUSERS=1 when installer runs silently (per-machine mode only). */
+    silentAllUsers?: boolean;
+    /** Optional MSIX identity and metadata overrides. */
+    msix?: PackageWindowsMsixConfig;
+}
+/** Enterprise packaging controls for policy/docs deployment outputs. */
+export interface PackageEnterpriseConfig {
+    /** Emit ADMX/ADML policy templates and policy-values JSON. Default: true. */
+    generateAdmx?: boolean;
+    /** Emit deployment docs and PowerShell install scripts. Default: true. */
+    includeDocsBundle?: boolean;
+}
+/** Code signing configuration for macOS and Windows. */
+export interface SigningConfig {
+    /** macOS code signing and notarization. */
+    macOS?: MacOSSigningConfig;
+    /** Windows code signing (Authenticode). */
+    windows?: WindowsSigningConfig;
+}
+/** macOS code signing configuration.
+ *  Sensitive values (certificates, passwords) should be set via environment
+ *  variables, not in this config. See docs/api/signing.md. */
+export interface MacOSSigningConfig {
+    /** Signing identity (e.g., "Developer ID Application: Name (TEAMID)").
+     *  Overridden by VOLT_MACOS_SIGNING_IDENTITY env var. */
+    identity?: string;
+    /** Path to entitlements .plist file. */
+    entitlements?: string;
+    /** Whether to notarize after signing. Default: true when identity is set. */
+    notarize?: boolean;
+    /** Apple Developer Team ID for notarization.
+     *  Overridden by VOLT_APPLE_TEAM_ID env var. */
+    teamId?: string;
+}
+/** Windows code signing configuration.
+ *  Certificate password should be set via VOLT_WIN_CERTIFICATE_PASSWORD env var. */
+export interface WindowsSigningConfig {
+    /** Signing backend provider. Default: "local". */
+    provider?: 'local' | 'azureTrustedSigning' | 'digicertKeyLocker';
+    /** Path to certificate file (.pfx/.p12).
+     *  Overridden by VOLT_WIN_CERTIFICATE env var. */
+    certificate?: string;
+    /** Digest algorithm. Default: "sha256". */
+    digestAlgorithm?: string;
+    /** RFC 3161 timestamp server URL. Default: "http://timestamp.digicert.com". */
+    timestampUrl?: string;
+    /** Azure Trusted Signing provider settings (when provider = "azureTrustedSigning"). */
+    azureTrustedSigning?: AzureTrustedSigningConfig;
+    /** DigiCert KeyLocker provider settings (when provider = "digicertKeyLocker"). */
+    digicertKeyLocker?: DigiCertKeyLockerConfig;
+}
+/** Azure Trusted Signing provider configuration for Windows Authenticode. */
+export interface AzureTrustedSigningConfig {
+    /** Path to Azure.CodeSigning.Dlib.dll. Overridden by VOLT_AZURE_TRUSTED_SIGNING_DLIB_PATH. */
+    dlibPath?: string;
+    /** Path to Azure Trusted Signing metadata JSON. Overridden by VOLT_AZURE_TRUSTED_SIGNING_METADATA_PATH. */
+    metadataPath?: string;
+    /** Optional account endpoint. Overridden by VOLT_AZURE_TRUSTED_SIGNING_ENDPOINT. */
+    endpoint?: string;
+    /** Optional account name. Overridden by VOLT_AZURE_TRUSTED_SIGNING_ACCOUNT_NAME. */
+    accountName?: string;
+    /** Optional certificate profile name. Overridden by VOLT_AZURE_TRUSTED_SIGNING_CERT_PROFILE. */
+    certificateProfileName?: string;
+    /** Optional correlation ID for provider-side traceability. Overridden by VOLT_AZURE_TRUSTED_SIGNING_CORRELATION_ID. */
+    correlationId?: string;
+}
+/** DigiCert KeyLocker provider configuration for Windows Authenticode. */
+export interface DigiCertKeyLockerConfig {
+    /** Key pair alias in DigiCert KeyLocker. Overridden by VOLT_DIGICERT_KEYLOCKER_KEYPAIR_ALIAS. */
+    keypairAlias?: string;
+    /** Optional cert fingerprint. Overridden by VOLT_DIGICERT_KEYLOCKER_CERT_FINGERPRINT. */
+    certificateFingerprint?: string;
+    /** Optional path to smctl executable. Overridden by VOLT_DIGICERT_KEYLOCKER_SMCTL_PATH. */
+    smctlPath?: string;
+    /** Optional RFC 3161 timestamp URL. Overridden by VOLT_DIGICERT_KEYLOCKER_TIMESTAMP_URL. */
+    timestampUrl?: string;
+}
+/** Auto-updater configuration. */
+export interface UpdaterConfig {
+    /** URL endpoint to check for updates. */
+    endpoint: string;
+    /** Ed25519 public key for signature verification (base64). */
+    publicKey: string;
+    /** Optional telemetry controls for updater lifecycle instrumentation. */
+    telemetry?: UpdaterTelemetryConfig;
+}
+/** Updater telemetry controls (disabled by default). */
+export interface UpdaterTelemetryConfig {
+    /** Enables updater telemetry events and sink emission. Default: false. */
+    enabled?: boolean;
+    /** Sink adapter identifier. `none` keeps telemetry in no-op mode. */
+    sink?: 'none' | 'stdout';
+}
+/** Define a Volt configuration with full type checking. */
+export declare function defineConfig(config: VoltConfig): VoltConfig;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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