voltkit 0.1.0

package/dist/app.d.ts

@@ -0,0 +1,61 @@
+import { EventEmitter } from 'node:events';
+import type { VoltConfig } from './types.js';
+/** Events emitted by the VoltApp. */
+export interface AppEvents {
+    ready: [];
+    'window-all-closed': [];
+    'before-quit': [];
+    quit: [];
+}
+/**
+ * Main application class managing the lifecycle of a Volt desktop app.
+ * Follows Electron's `app` event pattern for familiar DX.
+ */
+export declare class VoltApp extends EventEmitter {
+    private config;
+    private isReady;
+    private nativeApp;
+    constructor(config: VoltConfig);
+    /** Get the application name. */
+    getName(): string;
+    /** Get the application version. */
+    getVersion(): string;
+    /** Check if the app has finished initializing. */
+    get ready(): boolean;
+    /** Get the full application config. */
+    getConfig(): VoltConfig;
+    /**
+     * Get the native app instance. Used internally by BrowserWindow and other APIs.
+     * @internal
+     */
+    getNativeApp(): unknown;
+    /**
+     * Set the native app instance. Called by the CLI when initializing the native layer.
+     * @internal
+     */
+    setNativeApp(native: unknown): void;
+    /**
+     * Mark the app as ready and emit the 'ready' event.
+     * Called internally after native initialization completes.
+     * @internal
+     */
+    markReady(): void;
+    /**
+     * Request the application to quit.
+     */
+    quit(): void;
+    /**
+     * Convenience method: returns a promise that resolves when the app is ready.
+     */
+    whenReady(): Promise<void>;
+}
+/** Get or create the global VoltApp instance. */
+export declare function getApp(): VoltApp;
+/** Create and return the global VoltApp instance. */
+export declare function createApp(config: VoltConfig): VoltApp;
+/**
+ * Reset the app instance (used for testing).
+ * @internal
+ */
+export declare function resetApp(): void;
+//# sourceMappingURL=app.d.ts.map

package/dist/app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,qCAAqC;AACrC,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,EAAE,CAAC;IACV,mBAAmB,EAAE,EAAE,CAAC;IACxB,aAAa,EAAE,EAAE,CAAC;IAClB,IAAI,EAAE,EAAE,CAAC;CACV;AAED;;;GAGG;AACH,qBAAa,OAAQ,SAAQ,YAAY;IACvC,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,SAAS,CAAiB;gBAEtB,MAAM,EAAE,UAAU;IAK9B,gCAAgC;IAChC,OAAO,IAAI,MAAM;IAIjB,mCAAmC;IACnC,UAAU,IAAI,MAAM;IAIpB,kDAAkD;IAClD,IAAI,KAAK,IAAI,OAAO,CAEnB;IAED,uCAAuC;IACvC,SAAS,IAAI,UAAU;IAIvB;;;OAGG;IACH,YAAY,IAAI,OAAO;IAIvB;;;OAGG;IACH,YAAY,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;IAInC;;;;OAIG;IACH,SAAS,IAAI,IAAI;IAOjB;;OAEG;IACH,IAAI,IAAI,IAAI;IAKZ;;OAEG;IACH,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;CAQ3B;AAKD,iDAAiD;AACjD,wBAAgB,MAAM,IAAI,OAAO,CAOhC;AAED,qDAAqD;AACrD,wBAAgB,SAAS,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAMrD;AAED;;;GAGG;AACH,wBAAgB,QAAQ,IAAI,IAAI,CAE/B"}

package/dist/app.js

@@ -0,0 +1,98 @@
+import { EventEmitter } from 'node:events';
+/**
+ * Main application class managing the lifecycle of a Volt desktop app.
+ * Follows Electron's `app` event pattern for familiar DX.
+ */
+export class VoltApp extends EventEmitter {
+    config;
+    isReady = false;
+    nativeApp = null;
+    constructor(config) {
+        super();
+        this.config = config;
+    }
+    /** Get the application name. */
+    getName() {
+        return this.config.name;
+    }
+    /** Get the application version. */
+    getVersion() {
+        return this.config.version ?? '0.0.0';
+    }
+    /** Check if the app has finished initializing. */
+    get ready() {
+        return this.isReady;
+    }
+    /** Get the full application config. */
+    getConfig() {
+        return structuredClone(this.config);
+    }
+    /**
+     * Get the native app instance. Used internally by BrowserWindow and other APIs.
+     * @internal
+     */
+    getNativeApp() {
+        return this.nativeApp;
+    }
+    /**
+     * Set the native app instance. Called by the CLI when initializing the native layer.
+     * @internal
+     */
+    setNativeApp(native) {
+        this.nativeApp = native;
+    }
+    /**
+     * Mark the app as ready and emit the 'ready' event.
+     * Called internally after native initialization completes.
+     * @internal
+     */
+    markReady() {
+        if (!this.isReady) {
+            this.isReady = true;
+            this.emit('ready');
+        }
+    }
+    /**
+     * Request the application to quit.
+     */
+    quit() {
+        this.emit('before-quit');
+        this.emit('quit');
+    }
+    /**
+     * Convenience method: returns a promise that resolves when the app is ready.
+     */
+    whenReady() {
+        if (this.isReady) {
+            return Promise.resolve();
+        }
+        return new Promise((resolve) => {
+            this.once('ready', resolve);
+        });
+    }
+}
+/** Singleton application instance. */
+let appInstance = null;
+/** Get or create the global VoltApp instance. */
+export function getApp() {
+    if (!appInstance) {
+        throw new Error('VoltApp not initialized. Call createApp(config) first.');
+    }
+    return appInstance;
+}
+/** Create and return the global VoltApp instance. */
+export function createApp(config) {
+    if (appInstance) {
+        throw new Error('VoltApp already initialized. Only one app instance is allowed.');
+    }
+    appInstance = new VoltApp(config);
+    return appInstance;
+}
+/**
+ * Reset the app instance (used for testing).
+ * @internal
+ */
+export function resetApp() {
+    appInstance = null;
+}
+//# sourceMappingURL=app.js.map

package/dist/app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.js","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAW3C;;;GAGG;AACH,MAAM,OAAO,OAAQ,SAAQ,YAAY;IAC/B,MAAM,CAAa;IACnB,OAAO,GAAG,KAAK,CAAC;IAChB,SAAS,GAAY,IAAI,CAAC;IAElC,YAAY,MAAkB;QAC5B,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,gCAAgC;IAChC,OAAO;QACL,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;IAC1B,CAAC;IAED,mCAAmC;IACnC,UAAU;QACR,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,OAAO,CAAC;IACxC,CAAC;IAED,kDAAkD;IAClD,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,uCAAuC;IACvC,SAAS;QACP,OAAO,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACtC,CAAC;IAED;;;OAGG;IACH,YAAY;QACV,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED;;;OAGG;IACH,YAAY,CAAC,MAAe;QAC1B,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC;IAC1B,CAAC;IAED;;;;OAIG;IACH,SAAS;QACP,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;YACpB,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IAED;;OAEG;IACH,IAAI;QACF,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACzB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACpB,CAAC;IAED;;OAEG;IACH,SAAS;QACP,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;QAC3B,CAAC;QACD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YAC7B,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC9B,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AAED,sCAAsC;AACtC,IAAI,WAAW,GAAmB,IAAI,CAAC;AAEvC,iDAAiD;AACjD,MAAM,UAAU,MAAM;IACpB,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CACb,wDAAwD,CACzD,CAAC;IACJ,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,SAAS,CAAC,MAAkB;IAC1C,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAC;IACpF,CAAC;IACD,WAAW,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAClC,OAAO,WAAW,CAAC;AACrB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,QAAQ;IACtB,WAAW,GAAG,IAAI,CAAC;AACrB,CAAC"}

package/dist/clipboard.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Clipboard module.
+ * Provides read/write access to the system clipboard.
+ * Requires `permissions: ['clipboard']` in volt.config.ts.
+ */
+/** Image data from the clipboard. */
+export interface ClipboardImage {
+    /** RGBA pixel bytes. */
+    rgba: Uint8Array;
+    /** Image width in pixels. */
+    width: number;
+    /** Image height in pixels. */
+    height: number;
+}
+/**
+ * Read text from the system clipboard.
+ *
+ * @example
+ * ```ts
+ * const text = clipboard.readText();
+ * ```
+ */
+declare function readText(): string;
+/** Write text to the system clipboard. */
+declare function writeText(text: string): void;
+/** Read an image from the system clipboard. Returns null if no image. */
+declare function readImage(): ClipboardImage | null;
+/** Write an image to the system clipboard. */
+declare function writeImage(image: ClipboardImage): void;
+/** Clipboard APIs. Requires `permissions: ['clipboard']` in volt.config.ts. */
+export declare const clipboard: {
+    readText: typeof readText;
+    writeText: typeof writeText;
+    readImage: typeof readImage;
+    writeImage: typeof writeImage;
+};
+export {};
+//# sourceMappingURL=clipboard.d.ts.map

package/dist/clipboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clipboard.d.ts","sourceRoot":"","sources":["../src/clipboard.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,qCAAqC;AACrC,MAAM,WAAW,cAAc;IAC7B,wBAAwB;IACxB,IAAI,EAAE,UAAU,CAAC;IACjB,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,8BAA8B;IAC9B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;GAOG;AACH,iBAAS,QAAQ,IAAI,MAAM,CAE1B;AAED,0CAA0C;AAC1C,iBAAS,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAErC;AAED,yEAAyE;AACzE,iBAAS,SAAS,IAAI,cAAc,GAAG,IAAI,CAc1C;AAED,8CAA8C;AAC9C,iBAAS,UAAU,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAM/C;AAaD,+EAA+E;AAC/E,eAAO,MAAM,SAAS;;;;;CAKrB,CAAC"}

package/dist/clipboard.js

@@ -0,0 +1,64 @@
+/**
+ * Clipboard module.
+ * Provides read/write access to the system clipboard.
+ * Requires `permissions: ['clipboard']` in volt.config.ts.
+ */
+import { clipboardReadText, clipboardWriteText, clipboardReadImage, clipboardWriteImage, } from '@voltkit/volt-native';
+/**
+ * Read text from the system clipboard.
+ *
+ * @example
+ * ```ts
+ * const text = clipboard.readText();
+ * ```
+ */
+function readText() {
+    return clipboardReadText();
+}
+/** Write text to the system clipboard. */
+function writeText(text) {
+    clipboardWriteText(text);
+}
+/** Read an image from the system clipboard. Returns null if no image. */
+function readImage() {
+    try {
+        const img = clipboardReadImage();
+        return {
+            rgba: new Uint8Array(img.rgba),
+            width: img.width,
+            height: img.height,
+        };
+    }
+    catch (err) {
+        if (isNoImageError(err)) {
+            return null;
+        }
+        throw err;
+    }
+}
+/** Write an image to the system clipboard. */
+function writeImage(image) {
+    clipboardWriteImage({
+        rgba: Buffer.from(image.rgba),
+        width: image.width,
+        height: image.height,
+    });
+}
+function isNoImageError(err) {
+    if (!(err instanceof Error)) {
+        return false;
+    }
+    const message = err.message.toLowerCase();
+    return message.includes('no image')
+        || message.includes('content not available')
+        || message.includes('contentnotavailable')
+        || message.includes('clipboard is empty');
+}
+/** Clipboard APIs. Requires `permissions: ['clipboard']` in volt.config.ts. */
+export const clipboard = {
+    readText,
+    writeText,
+    readImage,
+    writeImage,
+};
+//# sourceMappingURL=clipboard.js.map

package/dist/clipboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clipboard.js","sourceRoot":"","sources":["../src/clipboard.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAY9B;;;;;;;GAOG;AACH,SAAS,QAAQ;IACf,OAAO,iBAAiB,EAAE,CAAC;AAC7B,CAAC;AAED,0CAA0C;AAC1C,SAAS,SAAS,CAAC,IAAY;IAC7B,kBAAkB,CAAC,IAAI,CAAC,CAAC;AAC3B,CAAC;AAED,yEAAyE;AACzE,SAAS,SAAS;IAChB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,kBAAkB,EAAE,CAAC;QACjC,OAAO;YACL,IAAI,EAAE,IAAI,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC;YAC9B,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,MAAM,EAAE,GAAG,CAAC,MAAM;SACnB,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED,8CAA8C;AAC9C,SAAS,UAAU,CAAC,KAAqB;IACvC,mBAAmB,CAAC;QAClB,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;QAC7B,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,MAAM,EAAE,KAAK,CAAC,MAAM;KACrB,CAAC,CAAC;AACL,CAAC;AAED,SAAS,cAAc,CAAC,GAAY;IAClC,IAAI,CAAC,CAAC,GAAG,YAAY,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;IAC1C,OAAO,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC;WAC9B,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAC;WACzC,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAC;WACvC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CAAC;AAC9C,CAAC;AAED,+EAA+E;AAC/E,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,QAAQ;IACR,SAAS;IACT,SAAS;IACT,UAAU;CACX,CAAC"}

package/dist/dialog.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Native dialog module.
+ * Provides file open/save dialogs and message boxes.
+ * API methods return Promises for compatibility, but underlying native calls are synchronous
+ * and block until the OS dialog closes.
+ * Requires `permissions: ['dialog']` in volt.config.ts.
+ */
+/** File type filter for open/save dialogs. */
+export interface FileFilter {
+    /** Display name for this filter (e.g., 'Images'). */
+    name: string;
+    /** File extensions without dots (e.g., ['png', 'jpg']). */
+    extensions: string[];
+}
+/** Options for the open file dialog. */
+export interface OpenDialogOptions {
+    /** Dialog window title. */
+    title?: string;
+    /** Default starting directory. */
+    defaultPath?: string;
+    /** File type filters. */
+    filters?: FileFilter[];
+    /** Allow selecting multiple files. Default: false. */
+    multiSelections?: boolean;
+    /** Allow selecting directories instead of files. Default: false. */
+    directory?: boolean;
+}
+/** Result from showOpenDialog. */
+export interface OpenDialogResult {
+    /** Whether the dialog was cancelled. */
+    canceled: boolean;
+    /** Selected file paths (empty if cancelled). */
+    filePaths: string[];
+}
+/** Options for the save file dialog. */
+export interface SaveDialogOptions {
+    /** Dialog window title. */
+    title?: string;
+    /** Default file path/name. */
+    defaultPath?: string;
+    /** File type filters. */
+    filters?: FileFilter[];
+}
+/** Result from showSaveDialog. */
+export interface SaveDialogResult {
+    /** Whether the dialog was cancelled. */
+    canceled: boolean;
+    /** Selected file path (empty string if cancelled). */
+    filePath: string;
+}
+/** Options for message box dialogs. */
+export interface MessageBoxOptions {
+    /** Message box type. Default: 'info'. */
+    type?: 'info' | 'warning' | 'error';
+    /** Dialog title. */
+    title?: string;
+    /** Dialog message. */
+    message: string;
+    /** Button labels. */
+    buttons?: string[];
+}
+/** Result from showMessageBox. */
+export interface MessageBoxResult {
+    /** Whether the user confirmed (clicked OK/Yes). */
+    confirmed: boolean;
+}
+/**
+ * Show a native open file dialog.
+ * Electron-compatible API.
+ * Note: this call blocks the current thread in native code.
+ *
+ * @example
+ * ```ts
+ * const result = await dialog.showOpenDialog({
+ *   title: 'Select Image',
+ *   filters: [{ name: 'Images', extensions: ['png', 'jpg'] }],
+ * });
+ * if (!result.canceled) {
+ *   console.log(result.filePaths);
+ * }
+ * ```
+ */
+declare function showOpenDialog(options?: OpenDialogOptions): Promise<OpenDialogResult>;
+/** Show a native save file dialog. Note: this call blocks the current thread in native code. */
+declare function showSaveDialog(options?: SaveDialogOptions): Promise<SaveDialogResult>;
+/** Show a native message box dialog. Note: this call blocks the current thread in native code. */
+declare function showMessageBox(options: MessageBoxOptions): Promise<MessageBoxResult>;
+/** Native dialog APIs. Requires `permissions: ['dialog']` in volt.config.ts. */
+export declare const dialog: {
+    showOpenDialog: typeof showOpenDialog;
+    showSaveDialog: typeof showSaveDialog;
+    showMessageBox: typeof showMessageBox;
+};
+export {};
+//# sourceMappingURL=dialog.d.ts.map

package/dist/dialog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialog.d.ts","sourceRoot":"","sources":["../src/dialog.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAWH,8CAA8C;AAC9C,MAAM,WAAW,UAAU;IACzB,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,wCAAwC;AACxC,MAAM,WAAW,iBAAiB;IAChC,2BAA2B;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yBAAyB;IACzB,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC;IACvB,sDAAsD;IACtD,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,oEAAoE;IACpE,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,kCAAkC;AAClC,MAAM,WAAW,gBAAgB;IAC/B,wCAAwC;IACxC,QAAQ,EAAE,OAAO,CAAC;IAClB,gDAAgD;IAChD,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,wCAAwC;AACxC,MAAM,WAAW,iBAAiB;IAChC,2BAA2B;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8BAA8B;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yBAAyB;IACzB,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC;CACxB;AAED,kCAAkC;AAClC,MAAM,WAAW,gBAAgB;IAC/B,wCAAwC;IACxC,QAAQ,EAAE,OAAO,CAAC;IAClB,sDAAsD;IACtD,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,uCAAuC;AACvC,MAAM,WAAW,iBAAiB;IAChC,yCAAyC;IACzC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IACpC,oBAAoB;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sBAAsB;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,qBAAqB;IACrB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,kCAAkC;AAClC,MAAM,WAAW,gBAAgB;IAC/B,mDAAmD;IACnD,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;;;;;;;;GAeG;AACH,iBAAe,cAAc,CAC3B,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,gBAAgB,CAAC,CAe3B;AAED,gGAAgG;AAChG,iBAAe,cAAc,CAC3B,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,gBAAgB,CAAC,CAY3B;AAED,kGAAkG;AAClG,iBAAe,cAAc,CAC3B,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,gBAAgB,CAAC,CAU3B;AAED,gFAAgF;AAChF,eAAO,MAAM,MAAM;;;;CAIlB,CAAC"}

package/dist/dialog.js

@@ -0,0 +1,70 @@
+/**
+ * Native dialog module.
+ * Provides file open/save dialogs and message boxes.
+ * API methods return Promises for compatibility, but underlying native calls are synchronous
+ * and block until the OS dialog closes.
+ * Requires `permissions: ['dialog']` in volt.config.ts.
+ */
+import { dialogShowOpen, dialogShowSave, dialogShowMessage, } from '@voltkit/volt-native';
+/**
+ * Show a native open file dialog.
+ * Electron-compatible API.
+ * Note: this call blocks the current thread in native code.
+ *
+ * @example
+ * ```ts
+ * const result = await dialog.showOpenDialog({
+ *   title: 'Select Image',
+ *   filters: [{ name: 'Images', extensions: ['png', 'jpg'] }],
+ * });
+ * if (!result.canceled) {
+ *   console.log(result.filePaths);
+ * }
+ * ```
+ */
+async function showOpenDialog(options = {}) {
+    // Map camelCase TS options to snake_case for Rust serde
+    const nativeOpts = {
+        title: options.title,
+        default_path: options.defaultPath,
+        filters: options.filters,
+        multiple: options.multiSelections ?? false,
+        directory: options.directory ?? false,
+    };
+    const filePaths = dialogShowOpen(nativeOpts);
+    return {
+        canceled: filePaths.length === 0,
+        filePaths,
+    };
+}
+/** Show a native save file dialog. Note: this call blocks the current thread in native code. */
+async function showSaveDialog(options = {}) {
+    const nativeOpts = {
+        title: options.title,
+        default_path: options.defaultPath,
+        filters: options.filters,
+    };
+    const filePath = dialogShowSave(nativeOpts);
+    return {
+        canceled: filePath === null,
+        filePath: filePath ?? '',
+    };
+}
+/** Show a native message box dialog. Note: this call blocks the current thread in native code. */
+async function showMessageBox(options) {
+    const nativeOpts = {
+        dialog_type: options.type ?? 'info',
+        title: options.title ?? '',
+        message: options.message,
+        buttons: options.buttons ?? [],
+    };
+    const confirmed = dialogShowMessage(nativeOpts);
+    return { confirmed };
+}
+/** Native dialog APIs. Requires `permissions: ['dialog']` in volt.config.ts. */
+export const dialog = {
+    showOpenDialog,
+    showSaveDialog,
+    showMessageBox,
+};
+//# sourceMappingURL=dialog.js.map

package/dist/dialog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialog.js","sourceRoot":"","sources":["../src/dialog.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAIL,cAAc,EACd,cAAc,EACd,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAoE9B;;;;;;;;;;;;;;;GAeG;AACH,KAAK,UAAU,cAAc,CAC3B,UAA6B,EAAE;IAE/B,wDAAwD;IACxD,MAAM,UAAU,GAA4B;QAC1C,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,YAAY,EAAE,OAAO,CAAC,WAAW;QACjC,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,QAAQ,EAAE,OAAO,CAAC,eAAe,IAAI,KAAK;QAC1C,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,KAAK;KACtC,CAAC;IAEF,MAAM,SAAS,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;IAC7C,OAAO;QACL,QAAQ,EAAE,SAAS,CAAC,MAAM,KAAK,CAAC;QAChC,SAAS;KACV,CAAC;AACJ,CAAC;AAED,gGAAgG;AAChG,KAAK,UAAU,cAAc,CAC3B,UAA6B,EAAE;IAE/B,MAAM,UAAU,GAA4B;QAC1C,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,YAAY,EAAE,OAAO,CAAC,WAAW;QACjC,OAAO,EAAE,OAAO,CAAC,OAAO;KACzB,CAAC;IAEF,MAAM,QAAQ,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;IAC5C,OAAO;QACL,QAAQ,EAAE,QAAQ,KAAK,IAAI;QAC3B,QAAQ,EAAE,QAAQ,IAAI,EAAE;KACzB,CAAC;AACJ,CAAC;AAED,kGAAkG;AAClG,KAAK,UAAU,cAAc,CAC3B,OAA0B;IAE1B,MAAM,UAAU,GAA+B;QAC7C,WAAW,EAAE,OAAO,CAAC,IAAI,IAAI,MAAM;QACnC,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,EAAE;QAC1B,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE;KAC/B,CAAC;IAEF,MAAM,SAAS,GAAG,iBAAiB,CAAC,UAAU,CAAC,CAAC;IAChD,OAAO,EAAE,SAAS,EAAE,CAAC;AACvB,CAAC;AAED,gFAAgF;AAChF,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,cAAc;IACd,cAAc;IACd,cAAc;CACf,CAAC"}

package/dist/fs.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Sandboxed file system module.
+ * All paths are relative to the application's allowed scope.
+ * No absolute paths are accepted from the frontend.
+ * API methods return Promises for compatibility, but native fs operations are synchronous
+ * and execute on the calling thread.
+ * Requires `permissions: ['fs']` in volt.config.ts.
+ */
+/** File metadata returned by stat(). */
+export interface FileInfo {
+    /** File size in bytes. */
+    size: number;
+    /** Whether the path is a file. */
+    isFile: boolean;
+    /** Whether the path is a directory. */
+    isDir: boolean;
+    /** Whether the file is read-only. */
+    readonly: boolean;
+}
+/**
+ * Set the base directory for all sandboxed file operations.
+ * Called internally during app initialization based on volt.config.ts scope.
+ * @internal
+ */
+export declare function setBaseDir(dir: string): void;
+/**
+ * Read a file as a UTF-8 string.
+ * Path must be relative to the app scope.
+ *
+ * @example
+ * ```ts
+ * const content = await fs.readFile('data/config.json');
+ * ```
+ */
+declare function readFile(path: string): Promise<string>;
+/** Read a file as raw bytes. */
+declare function readFileBinary(path: string): Promise<Uint8Array>;
+/** Write a string to a file, creating it if it doesn't exist. */
+declare function writeFile(path: string, data: string): Promise<void>;
+/** Write raw bytes to a file. */
+declare function writeFileBinary(path: string, data: Uint8Array): Promise<void>;
+/** List entries in a directory. Returns an array of file/directory names. */
+declare function readDir(path: string): Promise<string[]>;
+/** Get metadata for a file or directory. */
+declare function stat(path: string): Promise<FileInfo>;
+/** Create a directory (and parent directories if needed). */
+declare function mkdir(path: string): Promise<void>;
+/** Remove a file or directory (directories are removed recursively by native layer). */
+declare function remove(path: string): Promise<void>;
+/** Sandboxed file system APIs. Requires `permissions: ['fs']` in volt.config.ts. */
+export declare const fs: {
+    readFile: typeof readFile;
+    readFileBinary: typeof readFileBinary;
+    writeFile: typeof writeFile;
+    writeFileBinary: typeof writeFileBinary;
+    readDir: typeof readDir;
+    stat: typeof stat;
+    mkdir: typeof mkdir;
+    remove: typeof remove;
+};
+export {};
+//# sourceMappingURL=fs.d.ts.map

package/dist/fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../src/fs.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAYH,wCAAwC;AACxC,MAAM,WAAW,QAAQ;IACvB,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,MAAM,EAAE,OAAO,CAAC;IAChB,uCAAuC;IACvC,KAAK,EAAE,OAAO,CAAC;IACf,qCAAqC;IACrC,QAAQ,EAAE,OAAO,CAAC;CACnB;AAQD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAE5C;AAED;;;;;;;;GAQG;AACH,iBAAe,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAGrD;AAED,gCAAgC;AAChC,iBAAe,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAI/D;AAED,iEAAiE;AACjE,iBAAe,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGlE;AAED,iCAAiC;AACjC,iBAAe,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAG5E;AAED,6EAA6E;AAC7E,iBAAe,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAGtD;AAED,4CAA4C;AAC5C,iBAAe,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CASnD;AAED,6DAA6D;AAC7D,iBAAe,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGhD;AAED,wFAAwF;AACxF,iBAAe,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGjD;AA6BD,oFAAoF;AACpF,eAAO,MAAM,EAAE;;;;;;;;;CASd,CAAC"}

package/dist/fs.js

@@ -0,0 +1,110 @@
+/**
+ * Sandboxed file system module.
+ * All paths are relative to the application's allowed scope.
+ * No absolute paths are accepted from the frontend.
+ * API methods return Promises for compatibility, but native fs operations are synchronous
+ * and execute on the calling thread.
+ * Requires `permissions: ['fs']` in volt.config.ts.
+ */
+import { fsReadFile, fsReadFileText, fsWriteFile, fsReadDir, fsStat, fsMkdir, fsRemove, } from '@voltkit/volt-native';
+/**
+ * The base directory for sandboxed file operations.
+ * Defaults to process.cwd(). Set via {@link setBaseDir} during app initialization.
+ */
+let baseDir = process.cwd();
+/**
+ * Set the base directory for all sandboxed file operations.
+ * Called internally during app initialization based on volt.config.ts scope.
+ * @internal
+ */
+export function setBaseDir(dir) {
+    baseDir = dir;
+}
+/**
+ * Read a file as a UTF-8 string.
+ * Path must be relative to the app scope.
+ *
+ * @example
+ * ```ts
+ * const content = await fs.readFile('data/config.json');
+ * ```
+ */
+async function readFile(path) {
+    validatePath(path);
+    return fsReadFileText(baseDir, path);
+}
+/** Read a file as raw bytes. */
+async function readFileBinary(path) {
+    validatePath(path);
+    const buf = fsReadFile(baseDir, path);
+    return new Uint8Array(buf);
+}
+/** Write a string to a file, creating it if it doesn't exist. */
+async function writeFile(path, data) {
+    validatePath(path);
+    fsWriteFile(baseDir, path, Buffer.from(data, 'utf-8'));
+}
+/** Write raw bytes to a file. */
+async function writeFileBinary(path, data) {
+    validatePath(path);
+    fsWriteFile(baseDir, path, Buffer.from(data));
+}
+/** List entries in a directory. Returns an array of file/directory names. */
+async function readDir(path) {
+    validatePath(path);
+    return fsReadDir(baseDir, path);
+}
+/** Get metadata for a file or directory. */
+async function stat(path) {
+    validatePath(path);
+    const info = fsStat(baseDir, path);
+    return {
+        size: info.size,
+        isFile: info.isFile,
+        isDir: info.isDir,
+        readonly: info.readonly,
+    };
+}
+/** Create a directory (and parent directories if needed). */
+async function mkdir(path) {
+    validatePath(path);
+    fsMkdir(baseDir, path);
+}
+/** Remove a file or directory (directories are removed recursively by native layer). */
+async function remove(path) {
+    validatePath(path);
+    fsRemove(baseDir, path);
+}
+/**
+ * Validate that a path is safe (no absolute paths, no traversal).
+ * This is a TypeScript-side guard; the Rust side also validates.
+ */
+function validatePath(path) {
+    if (path === '') {
+        throw new Error('Path cannot be empty.');
+    }
+    if (path.includes('\0')) {
+        throw new Error(`Null bytes are not allowed in paths: "${path}".`);
+    }
+    // Reject absolute paths
+    if (path.startsWith('/') || path.startsWith('\\') || /^[a-zA-Z]:/.test(path)) {
+        throw new Error(`Absolute paths are not allowed: "${path}". Use paths relative to the app scope.`);
+    }
+    // Reject path traversal by segments only.
+    const segments = path.split(/[\\/]+/).filter(Boolean);
+    if (segments.includes('..')) {
+        throw new Error(`Path traversal is not allowed: "${path}".`);
+    }
+}
+/** Sandboxed file system APIs. Requires `permissions: ['fs']` in volt.config.ts. */
+export const fs = {
+    readFile,
+    readFileBinary,
+    writeFile,
+    writeFileBinary,
+    readDir,
+    stat,
+    mkdir,
+    remove,
+};
+//# sourceMappingURL=fs.js.map

package/dist/fs.js.map

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

package/dist/globalShortcut.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Global keyboard shortcut module.
+ * Provides registration of global hotkeys that work even when the app is not focused.
+ * Requires `permissions: ['globalShortcut']` in volt.config.ts.
+ */
+type ShortcutCallback = () => void;
+/**
+ * Register a global keyboard shortcut.
+ *
+ * @example
+ * ```ts
+ * globalShortcut.register('CmdOrCtrl+Shift+P', () => {
+ *   console.log('Shortcut triggered!');
+ * });
+ * ```
+ */
+declare function register(accelerator: string, callback: ShortcutCallback): boolean;
+/** Unregister a global keyboard shortcut. */
+declare function unregister(accelerator: string): void;
+/** Unregister all global keyboard shortcuts. */
+declare function unregisterAll(): void;
+/** Check if a shortcut is registered. */
+declare function isRegistered(accelerator: string): boolean;
+/** Global shortcut APIs. Requires `permissions: ['globalShortcut']` in volt.config.ts. */
+export declare const globalShortcut: {
+    register: typeof register;
+    unregister: typeof unregister;
+    unregisterAll: typeof unregisterAll;
+    isRegistered: typeof isRegistered;
+};
+export {};
+//# sourceMappingURL=globalShortcut.d.ts.map