voltkit 0.1.0

package/dist/globalShortcut.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"globalShortcut.d.ts","sourceRoot":"","sources":["../src/globalShortcut.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,KAAK,gBAAgB,GAAG,MAAM,IAAI,CAAC;AAwDnC;;;;;;;;;GASG;AACH,iBAAS,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAW1E;AAED,6CAA6C;AAC7C,iBAAS,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAI7C;AAED,gDAAgD;AAChD,iBAAS,aAAa,IAAI,IAAI,CAG7B;AAED,yCAAyC;AACzC,iBAAS,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAGlD;AAED,0FAA0F;AAC1F,eAAO,MAAM,cAAc;;;;;CAK1B,CAAC"}

package/dist/globalShortcut.js

@@ -0,0 +1,103 @@
+/**
+ * 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.
+ */
+import { VoltGlobalShortcut } from '@voltkit/volt-native';
+let nativeManager = null;
+const callbackMap = new Map();
+function getNativeManager() {
+    if (!nativeManager) {
+        nativeManager = new VoltGlobalShortcut();
+    }
+    return nativeManager;
+}
+const VALID_MODIFIER_TOKENS = new Set([
+    'cmdorctrl',
+    'cmd',
+    'command',
+    'meta',
+    'super',
+    'ctrl',
+    'control',
+    'alt',
+    'option',
+    'shift',
+]);
+function isValidKeyToken(token) {
+    const upper = token.toUpperCase();
+    if (/^[A-Z]$/.test(upper))
+        return true;
+    if (/^[0-9]$/.test(upper))
+        return true;
+    if (/^F([1-9]|1[0-9]|2[0-4])$/.test(upper))
+        return true;
+    return ['SPACE', 'ENTER', 'RETURN', 'ESC', 'ESCAPE', 'TAB', 'UP', 'DOWN', 'LEFT', 'RIGHT'].includes(upper);
+}
+function assertValidAccelerator(accelerator) {
+    const parts = accelerator.split('+').map((part) => part.trim()).filter(Boolean);
+    if (parts.length < 2) {
+        throw new Error(`Invalid accelerator "${accelerator}". Expected at least one modifier and one key.`);
+    }
+    let keyCount = 0;
+    for (const part of parts) {
+        const lowered = part.toLowerCase();
+        if (VALID_MODIFIER_TOKENS.has(lowered)) {
+            continue;
+        }
+        if (!isValidKeyToken(part)) {
+            throw new Error(`Invalid accelerator key token "${part}" in "${accelerator}".`);
+        }
+        keyCount += 1;
+    }
+    if (keyCount !== 1) {
+        throw new Error(`Invalid accelerator "${accelerator}". Exactly one non-modifier key token is required.`);
+    }
+}
+/**
+ * Register a global keyboard shortcut.
+ *
+ * @example
+ * ```ts
+ * globalShortcut.register('CmdOrCtrl+Shift+P', () => {
+ *   console.log('Shortcut triggered!');
+ * });
+ * ```
+ */
+function register(accelerator, callback) {
+    assertValidAccelerator(accelerator);
+    if (callbackMap.has(accelerator)) {
+        return false;
+    }
+    getNativeManager().register(accelerator, () => {
+        const cb = callbackMap.get(accelerator);
+        if (cb)
+            cb();
+    });
+    callbackMap.set(accelerator, callback);
+    return true;
+}
+/** Unregister a global keyboard shortcut. */
+function unregister(accelerator) {
+    assertValidAccelerator(accelerator);
+    getNativeManager().unregister(accelerator);
+    callbackMap.delete(accelerator);
+}
+/** Unregister all global keyboard shortcuts. */
+function unregisterAll() {
+    getNativeManager().unregisterAll();
+    callbackMap.clear();
+}
+/** Check if a shortcut is registered. */
+function isRegistered(accelerator) {
+    assertValidAccelerator(accelerator);
+    return getNativeManager().isRegistered(accelerator);
+}
+/** Global shortcut APIs. Requires `permissions: ['globalShortcut']` in volt.config.ts. */
+export const globalShortcut = {
+    register,
+    unregister,
+    unregisterAll,
+    isRegistered,
+};
+//# sourceMappingURL=globalShortcut.js.map

package/dist/globalShortcut.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,26 @@
+import './runtime-modules.js';
+export { VoltApp, createApp, getApp } from './app.js';
+export { BrowserWindow } from './window.js';
+export { ipcMain, invoke, on, off } from './ipc.js';
+export type { IpcErrorCode, IpcProcessOptions, IpcProcessResponse } from './ipc.js';
+export { createContractInvoker, createLegacyInvokeAdapter, createSchema, defineCommands, isIpcContractValidationError, registerContractHandlers, resolveContractChannel, IpcContractValidationError, IpcSchema, } from './ipc-contract.js';
+export type { ContractHandlers, InferCommandRequest, InferCommandResponse, InferSchemaValue, IpcCommandDefinition, IpcCommandMap, IpcInvokeFn, IpcRegistrar, IpcSchema as IpcSchemaType, TypedIpcInvoker, } from './ipc-contract.js';
+export { Tray } from './tray.js';
+export { Menu, MenuItem } from './menu.js';
+export { dialog } from './dialog.js';
+export { clipboard } from './clipboard.js';
+export { Notification } from './notification.js';
+export { fs } from './fs.js';
+export { shell } from './shell.js';
+export { globalShortcut } from './globalShortcut.js';
+export { autoUpdater } from './updater.js';
+export { defineConfig } from './types.js';
+export type { VoltConfig, WindowOptions, Permission, BuildConfig, PackageConfig, SigningConfig, MacOSSigningConfig, WindowsSigningConfig, AzureTrustedSigningConfig, DigiCertKeyLockerConfig, UpdaterConfig, UpdaterTelemetryConfig, RuntimeConfig, } from './types.js';
+export type { TrayOptions, TrayMenuItem } from './tray.js';
+export type { MenuItemOptions, MenuItemRole } from './menu.js';
+export type { OpenDialogOptions, OpenDialogResult, SaveDialogOptions, SaveDialogResult, MessageBoxOptions, MessageBoxResult, FileFilter, } from './dialog.js';
+export type { ClipboardImage } from './clipboard.js';
+export type { NotificationOptions } from './notification.js';
+export type { FileInfo } from './fs.js';
+export type { UpdateInfo } from './updater.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,sBAAsB,CAAC;AAE9B,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AACpD,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AACpF,OAAO,EACL,qBAAqB,EACrB,yBAAyB,EACzB,YAAY,EACZ,cAAc,EACd,4BAA4B,EAC5B,wBAAwB,EACxB,sBAAsB,EACtB,0BAA0B,EAC1B,SAAS,GACV,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,EAChB,oBAAoB,EACpB,aAAa,EACb,WAAW,EACX,YAAY,EACZ,SAAS,IAAI,aAAa,EAC1B,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAC7B,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,YAAY,EACV,UAAU,EACV,aAAa,EACb,UAAU,EACV,WAAW,EACX,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,oBAAoB,EACpB,yBAAyB,EACzB,uBAAuB,EACvB,aAAa,EACb,sBAAsB,EACtB,aAAa,GACd,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC3D,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC/D,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,UAAU,GACX,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,YAAY,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACxC,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,16 @@
+import './runtime-modules.js';
+export { VoltApp, createApp, getApp } from './app.js';
+export { BrowserWindow } from './window.js';
+export { ipcMain, invoke, on, off } from './ipc.js';
+export { createContractInvoker, createLegacyInvokeAdapter, createSchema, defineCommands, isIpcContractValidationError, registerContractHandlers, resolveContractChannel, IpcContractValidationError, IpcSchema, } from './ipc-contract.js';
+export { Tray } from './tray.js';
+export { Menu, MenuItem } from './menu.js';
+export { dialog } from './dialog.js';
+export { clipboard } from './clipboard.js';
+export { Notification } from './notification.js';
+export { fs } from './fs.js';
+export { shell } from './shell.js';
+export { globalShortcut } from './globalShortcut.js';
+export { autoUpdater } from './updater.js';
+export { defineConfig } from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,sBAAsB,CAAC;AAE9B,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAEpD,OAAO,EACL,qBAAqB,EACrB,yBAAyB,EACzB,YAAY,EACZ,cAAc,EACd,4BAA4B,EAC5B,wBAAwB,EACxB,sBAAsB,EACtB,0BAA0B,EAC1B,SAAS,GACV,MAAM,mBAAmB,CAAC;AAa3B,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAC7B,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/internal.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Internal-only framework entrypoints used by Volt tooling.
+ * Not part of the stable public API surface.
+ */
+export { __internalDispatchMenuEvent } from './menu.js';
+//# sourceMappingURL=internal.d.ts.map

package/dist/internal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,2BAA2B,EAAE,MAAM,WAAW,CAAC"}

package/dist/internal.js

@@ -0,0 +1,6 @@
+/**
+ * Internal-only framework entrypoints used by Volt tooling.
+ * Not part of the stable public API surface.
+ */
+export { __internalDispatchMenuEvent } from './menu.js';
+//# sourceMappingURL=internal.js.map

package/dist/internal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.js","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,2BAA2B,EAAE,MAAM,WAAW,CAAC"}

package/dist/ipc-contract/aliases.d.ts

@@ -0,0 +1,4 @@
+import type { IpcCommandMap } from './types.js';
+export declare function buildAliasLookup<TCommands extends IpcCommandMap>(commands: TCommands): Map<string, string>;
+export declare function resolveContractChannel<TCommands extends IpcCommandMap>(commands: TCommands, channel: string): string;
+//# sourceMappingURL=aliases.d.ts.map

package/dist/ipc-contract/aliases.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aliases.d.ts","sourceRoot":"","sources":["../../src/ipc-contract/aliases.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAkBhD,wBAAgB,gBAAgB,CAAC,SAAS,SAAS,aAAa,EAC9D,QAAQ,EAAE,SAAS,GAClB,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAyBrB;AAED,wBAAgB,sBAAsB,CAAC,SAAS,SAAS,aAAa,EACpE,QAAQ,EAAE,SAAS,EACnB,OAAO,EAAE,MAAM,GACd,MAAM,CAGR"}

package/dist/ipc-contract/aliases.js

@@ -0,0 +1,38 @@
+function normalizeAliases(aliases) {
+    if (!aliases || aliases.length === 0) {
+        return [];
+    }
+    const unique = new Set();
+    for (const alias of aliases) {
+        const normalized = alias.trim();
+        if (!normalized) {
+            continue;
+        }
+        unique.add(normalized);
+    }
+    return [...unique];
+}
+export function buildAliasLookup(commands) {
+    const lookup = new Map();
+    const commandKeys = Object.keys(commands);
+    for (const commandKey of commandKeys) {
+        const existing = lookup.get(commandKey);
+        if (existing && existing !== commandKey) {
+            throw new Error(`IPC contract alias conflict: channel "${commandKey}" already mapped to "${existing}"`);
+        }
+        lookup.set(commandKey, commandKey);
+        for (const alias of normalizeAliases(commands[commandKey].aliases)) {
+            const aliasOwner = lookup.get(alias);
+            if (aliasOwner && aliasOwner !== commandKey) {
+                throw new Error(`IPC contract alias conflict: alias "${alias}" is mapped to both "${aliasOwner}" and "${commandKey}"`);
+            }
+            lookup.set(alias, commandKey);
+        }
+    }
+    return lookup;
+}
+export function resolveContractChannel(commands, channel) {
+    const aliasLookup = buildAliasLookup(commands);
+    return aliasLookup.get(channel) ?? channel;
+}
+//# sourceMappingURL=aliases.js.map

package/dist/ipc-contract/aliases.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aliases.js","sourceRoot":"","sources":["../../src/ipc-contract/aliases.ts"],"names":[],"mappings":"AAEA,SAAS,gBAAgB,CAAC,OAAsC;IAC9D,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;IACjC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;QAChC,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,SAAS;QACX,CAAC;QACD,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACzB,CAAC;IACD,OAAO,CAAC,GAAG,MAAM,CAAC,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,QAAmB;IAEnB,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACzC,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAoC,CAAC;IAE7E,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACrC,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACxC,IAAI,QAAQ,IAAI,QAAQ,KAAK,UAAU,EAAE,CAAC;YACxC,MAAM,IAAI,KAAK,CACb,yCAAyC,UAAU,wBAAwB,QAAQ,GAAG,CACvF,CAAC;QACJ,CAAC;QACD,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;QAEnC,KAAK,MAAM,KAAK,IAAI,gBAAgB,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;YACnE,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YACrC,IAAI,UAAU,IAAI,UAAU,KAAK,UAAU,EAAE,CAAC;gBAC5C,MAAM,IAAI,KAAK,CACb,uCAAuC,KAAK,wBAAwB,UAAU,UAAU,UAAU,GAAG,CACtG,CAAC;YACJ,CAAC;YACD,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,QAAmB,EACnB,OAAe;IAEf,MAAM,WAAW,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAC/C,OAAO,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC;AAC7C,CAAC"}

package/dist/ipc-contract/define.d.ts

@@ -0,0 +1,3 @@
+import type { IpcCommandMap } from './types.js';
+export declare function defineCommands<const TCommands extends IpcCommandMap>(commands: TCommands): TCommands;
+//# sourceMappingURL=define.d.ts.map

package/dist/ipc-contract/define.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.d.ts","sourceRoot":"","sources":["../../src/ipc-contract/define.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,wBAAgB,cAAc,CAAC,KAAK,CAAC,SAAS,SAAS,aAAa,EAClE,QAAQ,EAAE,SAAS,GAClB,SAAS,CAIX"}

package/dist/ipc-contract/define.js

@@ -0,0 +1,7 @@
+import { buildAliasLookup } from './aliases.js';
+export function defineCommands(commands) {
+    // Precompute alias resolution early so conflicts fail at definition time.
+    buildAliasLookup(commands);
+    return commands;
+}
+//# sourceMappingURL=define.js.map

package/dist/ipc-contract/define.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.js","sourceRoot":"","sources":["../../src/ipc-contract/define.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGhD,MAAM,UAAU,cAAc,CAC5B,QAAmB;IAEnB,0EAA0E;IAC1E,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAC3B,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/ipc-contract/handlers.d.ts

@@ -0,0 +1,3 @@
+import type { ContractHandlers, IpcCommandMap, IpcRegistrar } from './types.js';
+export declare function registerContractHandlers<TCommands extends IpcCommandMap>(ipc: IpcRegistrar, commands: TCommands, handlers: ContractHandlers<TCommands>): void;
+//# sourceMappingURL=handlers.d.ts.map

package/dist/ipc-contract/handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../src/ipc-contract/handlers.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,gBAAgB,EAEhB,aAAa,EACb,YAAY,EACb,MAAM,YAAY,CAAC;AAEpB,wBAAgB,wBAAwB,CAAC,SAAS,SAAS,aAAa,EACtE,GAAG,EAAE,YAAY,EACjB,QAAQ,EAAE,SAAS,EACnB,QAAQ,EAAE,gBAAgB,CAAC,SAAS,CAAC,GACpC,IAAI,CA0BN"}

package/dist/ipc-contract/handlers.js

@@ -0,0 +1,26 @@
+import { buildAliasLookup } from './aliases.js';
+import { parseWithSchema, registerChannel } from './validation.js';
+export function registerContractHandlers(ipc, commands, handlers) {
+    const aliasLookup = buildAliasLookup(commands);
+    const commandKeys = Object.keys(commands);
+    for (const commandKey of commandKeys) {
+        const command = commands[commandKey];
+        const handler = handlers[commandKey];
+        if (typeof handler !== 'function') {
+            throw new Error(`Missing handler for IPC command: ${commandKey}`);
+        }
+        const wrapped = async (rawArgs) => {
+            const args = parseWithSchema(command.request, rawArgs, commandKey, 'request');
+            const result = await handler(args);
+            return parseWithSchema(command.response, result, commandKey, 'response');
+        };
+        registerChannel(ipc, commandKey, wrapped);
+        for (const [alias, canonical] of aliasLookup.entries()) {
+            if (canonical !== commandKey || alias === commandKey) {
+                continue;
+            }
+            registerChannel(ipc, alias, wrapped);
+        }
+    }
+}
+//# sourceMappingURL=handlers.js.map

package/dist/ipc-contract/handlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.js","sourceRoot":"","sources":["../../src/ipc-contract/handlers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAQnE,MAAM,UAAU,wBAAwB,CACtC,GAAiB,EACjB,QAAmB,EACnB,QAAqC;IAErC,MAAM,WAAW,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAC/C,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAoC,CAAC;IAE7E,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACrC,MAAM,OAAO,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC;QACrC,MAAM,OAAO,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC;QACrC,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,oCAAoC,UAAU,EAAE,CAAC,CAAC;QACpE,CAAC;QAED,MAAM,OAAO,GAAG,KAAK,EAAE,OAAgB,EAAoB,EAAE;YAC3D,MAAM,IAAI,GAAG,eAAe,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;YAC9E,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAA2C,CAAC,CAAC;YAC1E,OAAO,eAAe,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;QAC3E,CAAC,CAAC;QAEF,eAAe,CAAC,GAAG,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;QAE1C,KAAK,MAAM,CAAC,KAAK,EAAE,SAAS,CAAC,IAAI,WAAW,CAAC,OAAO,EAAE,EAAE,CAAC;YACvD,IAAI,SAAS,KAAK,UAAU,IAAI,KAAK,KAAK,UAAU,EAAE,CAAC;gBACrD,SAAS;YACX,CAAC;YACD,eAAe,CAAC,GAAG,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/ipc-contract/invoker.d.ts

@@ -0,0 +1,4 @@
+import type { IpcCommandMap, IpcInvokeFn, TypedIpcInvoker } from './types.js';
+export declare function createLegacyInvokeAdapter<TCommands extends IpcCommandMap>(commands: TCommands, invokeFn: IpcInvokeFn): (channel: string, args: unknown) => Promise<unknown>;
+export declare function createContractInvoker<TCommands extends IpcCommandMap>(commands: TCommands, invokeFn: IpcInvokeFn): TypedIpcInvoker<TCommands>;
+//# sourceMappingURL=invoker.d.ts.map

package/dist/ipc-contract/invoker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoker.d.ts","sourceRoot":"","sources":["../../src/ipc-contract/invoker.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAGV,aAAa,EACb,WAAW,EACX,eAAe,EAChB,MAAM,YAAY,CAAC;AAEpB,wBAAgB,yBAAyB,CAAC,SAAS,SAAS,aAAa,EACvE,QAAQ,EAAE,SAAS,EACnB,QAAQ,EAAE,WAAW,GACpB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAMtD;AAED,wBAAgB,qBAAqB,CAAC,SAAS,SAAS,aAAa,EACnE,QAAQ,EAAE,SAAS,EACnB,QAAQ,EAAE,WAAW,GACpB,eAAe,CAAC,SAAS,CAAC,CAiC5B"}

package/dist/ipc-contract/invoker.js

@@ -0,0 +1,32 @@
+import { buildAliasLookup } from './aliases.js';
+import { parseWithSchema } from './validation.js';
+export function createLegacyInvokeAdapter(commands, invokeFn) {
+    const aliasLookup = buildAliasLookup(commands);
+    return async (channel, args) => {
+        const resolvedChannel = aliasLookup.get(channel) ?? channel;
+        return invokeFn(resolvedChannel, args);
+    };
+}
+export function createContractInvoker(commands, invokeFn) {
+    const aliasLookup = buildAliasLookup(commands);
+    const resolveChannel = (channel) => aliasLookup.get(channel) ?? channel;
+    const invokeLegacy = async (channel, args) => {
+        const resolvedChannel = resolveChannel(channel);
+        return invokeFn(resolvedChannel, args);
+    };
+    return {
+        resolveChannel,
+        invokeLegacy,
+        async invoke(channel, args) {
+            const resolvedChannel = resolveChannel(channel);
+            if (!Object.prototype.hasOwnProperty.call(commands, resolvedChannel)) {
+                throw new Error(`Unknown IPC contract channel: ${String(channel)}`);
+            }
+            const command = commands[resolvedChannel];
+            const parsedArgs = parseWithSchema(command.request, args, resolvedChannel, 'request');
+            const rawResult = await invokeFn(resolvedChannel, parsedArgs);
+            return parseWithSchema(command.response, rawResult, resolvedChannel, 'response');
+        },
+    };
+}
+//# sourceMappingURL=invoker.js.map

package/dist/ipc-contract/invoker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoker.js","sourceRoot":"","sources":["../../src/ipc-contract/invoker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AASlD,MAAM,UAAU,yBAAyB,CACvC,QAAmB,EACnB,QAAqB;IAErB,MAAM,WAAW,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAC/C,OAAO,KAAK,EAAE,OAAe,EAAE,IAAa,EAAoB,EAAE;QAChE,MAAM,eAAe,GAAG,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC;QAC5D,OAAO,QAAQ,CAAC,eAAe,EAAE,IAAI,CAAC,CAAC;IACzC,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,QAAmB,EACnB,QAAqB;IAErB,MAAM,WAAW,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAE/C,MAAM,cAAc,GAAG,CAAC,OAAe,EAAU,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC;IAExF,MAAM,YAAY,GAAG,KAAK,EAAE,OAAe,EAAE,IAAa,EAAoB,EAAE;QAC9E,MAAM,eAAe,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;QAChD,OAAO,QAAQ,CAAC,eAAe,EAAE,IAAI,CAAC,CAAC;IACzC,CAAC,CAAC;IAEF,OAAO;QACL,cAAc;QACd,YAAY;QACZ,KAAK,CAAC,MAAM,CACV,OAAa,EACb,IAA0C;YAE1C,MAAM,eAAe,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;YAChD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,QAAQ,EAAE,eAAe,CAAC,EAAE,CAAC;gBACrE,MAAM,IAAI,KAAK,CAAC,iCAAiC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YACtE,CAAC;YAED,MAAM,OAAO,GAAG,QAAQ,CAAC,eAAkC,CAAC,CAAC;YAC7D,MAAM,UAAU,GAAG,eAAe,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,SAAS,CAAC,CAAC;YACtF,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,eAAe,EAAE,UAAU,CAAC,CAAC;YAC9D,OAAO,eAAe,CACpB,OAAO,CAAC,QAAQ,EAChB,SAAS,EACT,eAAe,EACf,UAAU,CAC8B,CAAC;QAC7C,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/ipc-contract/schema.d.ts

@@ -0,0 +1,17 @@
+import type { InferSchemaValue, IpcSchema as IpcSchemaType } from './types.js';
+type IpcObjectShape = Record<string, IpcSchemaType<unknown>>;
+export declare function createSchema<T>(name: string, guard: (value: unknown) => value is T): IpcSchemaType<T>;
+export declare const IpcSchema: {
+    readonly custom: <T>(name: string, guard: (value: unknown) => value is T) => IpcSchemaType<T>;
+    readonly unknown: (name?: string) => IpcSchemaType<unknown>;
+    readonly null: (name?: string) => IpcSchemaType<null>;
+    readonly string: (name?: string) => IpcSchemaType<string>;
+    readonly number: (name?: string) => IpcSchemaType<number>;
+    readonly boolean: (name?: string) => IpcSchemaType<boolean>;
+    readonly literal: <TLiteral extends string | number | boolean | null>(expected: TLiteral, name?: string) => IpcSchemaType<TLiteral>;
+    readonly optional: <T>(schema: IpcSchemaType<T>, name?: string) => IpcSchemaType<T | undefined>;
+    readonly array: <TItem>(itemSchema: IpcSchemaType<TItem>, name?: string) => IpcSchemaType<TItem[]>;
+    readonly object: <TShape extends IpcObjectShape>(shape: TShape, name?: string) => IpcSchemaType<{ [TKey in keyof TShape]: InferSchemaValue<TShape[TKey]>; }>;
+};
+export {};
+//# sourceMappingURL=schema.d.ts.map

package/dist/ipc-contract/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/ipc-contract/schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,SAAS,IAAI,aAAa,EAAE,MAAM,YAAY,CAAC;AAE/E,KAAK,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC;AAE7D,wBAAgB,YAAY,CAAC,CAAC,EAC5B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,IAAI,CAAC,GACpC,aAAa,CAAC,CAAC,CAAC,CAUlB;AAED,eAAO,MAAM,SAAS;sBACb,CAAC,QAAQ,MAAM,SAAS,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,IAAI,CAAC,KAAG,aAAa,CAAC,CAAC,CAAC;yCAIrD,aAAa,CAAC,OAAO,CAAC;sCAS5B,aAAa,CAAC,IAAI,CAAC;wCAIf,aAAa,CAAC,MAAM,CAAC;wCAIrB,aAAa,CAAC,MAAM,CAAC;yCAInB,aAAa,CAAC,OAAO,CAAC;uBAIzC,QAAQ,SAAS,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,YAC7C,QAAQ,oBAEjB,aAAa,CAAC,QAAQ,CAAC;wBAIjB,CAAC,UACA,aAAa,CAAC,CAAC,CAAC,oBAEvB,aAAa,CAAC,CAAC,GAAG,SAAS,CAAC;qBAYzB,KAAK,cACG,aAAa,CAAC,KAAK,CAAC,oBAE/B,aAAa,CAAC,KAAK,EAAE,CAAC;sBAYlB,MAAM,SAAS,cAAc,SAC3B,MAAM,oBAEZ,aAAa,CAAC,GAAG,IAAI,IAAI,MAAM,MAAM,GAAG,gBAAgB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAE,CAAC;CAiBpE,CAAC"}

package/dist/ipc-contract/schema.js

@@ -0,0 +1,78 @@
+export function createSchema(name, guard) {
+    return {
+        name,
+        parse(value) {
+            if (guard(value)) {
+                return value;
+            }
+            throw new Error(`expected ${name}`);
+        },
+    };
+}
+export const IpcSchema = {
+    custom(name, guard) {
+        return createSchema(name, guard);
+    },
+    unknown(name = 'unknown') {
+        return {
+            name,
+            parse(value) {
+                return value;
+            },
+        };
+    },
+    null(name = 'null') {
+        return createSchema(name, (value) => value === null);
+    },
+    string(name = 'string') {
+        return createSchema(name, (value) => typeof value === 'string');
+    },
+    number(name = 'number') {
+        return createSchema(name, (value) => typeof value === 'number');
+    },
+    boolean(name = 'boolean') {
+        return createSchema(name, (value) => typeof value === 'boolean');
+    },
+    literal(expected, name = `literal(${String(expected)})`) {
+        return createSchema(name, (value) => value === expected);
+    },
+    optional(schema, name = `optional(${schema.name ?? 'value'})`) {
+        return {
+            name,
+            parse(value) {
+                if (value === undefined) {
+                    return undefined;
+                }
+                return schema.parse(value);
+            },
+        };
+    },
+    array(itemSchema, name = `array(${itemSchema.name ?? 'item'})`) {
+        return {
+            name,
+            parse(value) {
+                if (!Array.isArray(value)) {
+                    throw new Error(`expected ${name}`);
+                }
+                return value.map((item) => itemSchema.parse(item));
+            },
+        };
+    },
+    object(shape, name = 'object') {
+        return {
+            name,
+            parse(value) {
+                if (!value || typeof value !== 'object' || Array.isArray(value)) {
+                    throw new Error(`expected ${name}`);
+                }
+                const record = value;
+                const parsed = {};
+                for (const key of Object.keys(shape)) {
+                    parsed[key] = shape[key].parse(record[key]);
+                }
+                return parsed;
+            },
+        };
+    },
+};
+//# sourceMappingURL=schema.js.map

package/dist/ipc-contract/schema.js.map

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

package/dist/ipc-contract/types.d.ts

@@ -0,0 +1,45 @@
+export interface IpcSchema<T> {
+    /** Human-readable schema name used in validation errors. */
+    readonly name?: string;
+    /** Parse and validate a value. Throw when validation fails. */
+    parse(value: unknown): T;
+}
+export type InferSchemaValue<TSchema> = TSchema extends IpcSchema<infer TValue> ? TValue : never;
+export interface IpcCommandDefinition<TRequest = unknown, TResponse = unknown> {
+    /** Request payload schema (renderer -> backend). */
+    request?: IpcSchema<TRequest>;
+    /** Response payload schema (backend -> renderer). */
+    response?: IpcSchema<TResponse>;
+    /** Legacy channel names that should map to this command key. */
+    aliases?: readonly string[];
+}
+export type IpcCommandMap = Record<string, IpcCommandDefinition<unknown, unknown>>;
+export type InferCommandRequest<TCommand> = TCommand extends IpcCommandDefinition<infer TRequest, unknown> ? TRequest : never;
+export type InferCommandResponse<TCommand> = TCommand extends IpcCommandDefinition<unknown, infer TResponse> ? TResponse : never;
+export type ContractHandlers<TCommands extends IpcCommandMap> = {
+    [TKey in keyof TCommands]: (args: InferCommandRequest<TCommands[TKey]>) => Promise<InferCommandResponse<TCommands[TKey]>> | InferCommandResponse<TCommands[TKey]>;
+};
+export interface IpcRegistrar {
+    handle(channel: string, handler: (args: unknown) => Promise<unknown> | unknown): void;
+    hasHandler?(channel: string): boolean;
+}
+export type IpcInvokeFn = (channel: string, args: unknown) => Promise<unknown>;
+export interface TypedIpcInvoker<TCommands extends IpcCommandMap> {
+    invoke<TKey extends keyof TCommands & string>(channel: TKey, args: InferCommandRequest<TCommands[TKey]>): Promise<InferCommandResponse<TCommands[TKey]>>;
+    /**
+     * Compatibility path for untyped, legacy callers.
+     * Legacy aliases are resolved to canonical command keys before dispatch.
+     */
+    invokeLegacy(channel: string, args: unknown): Promise<unknown>;
+    /** Resolve a legacy alias to its canonical command key. */
+    resolveChannel(channel: string): string;
+}
+export declare class IpcContractValidationError extends Error {
+    readonly channel: string;
+    readonly phase: 'request' | 'response';
+    readonly details?: unknown | undefined;
+    readonly code: "IPC_CONTRACT_VALIDATION_ERROR";
+    constructor(channel: string, phase: 'request' | 'response', message: string, details?: unknown | undefined);
+}
+export declare function isIpcContractValidationError(error: unknown): error is IpcContractValidationError;
+//# sourceMappingURL=types.d.ts.map

package/dist/ipc-contract/types.d.ts.map

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

package/dist/ipc-contract/types.js

@@ -0,0 +1,17 @@
+export class IpcContractValidationError extends Error {
+    channel;
+    phase;
+    details;
+    code = 'IPC_CONTRACT_VALIDATION_ERROR';
+    constructor(channel, phase, message, details) {
+        super(message);
+        this.channel = channel;
+        this.phase = phase;
+        this.details = details;
+        this.name = 'IpcContractValidationError';
+    }
+}
+export function isIpcContractValidationError(error) {
+    return error instanceof IpcContractValidationError;
+}
+//# sourceMappingURL=types.js.map

package/dist/ipc-contract/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/ipc-contract/types.ts"],"names":[],"mappings":"AAyDA,MAAM,OAAO,0BAA2B,SAAQ,KAAK;IAIxC;IACA;IAEA;IANF,IAAI,GAAG,+BAAwC,CAAC;IAEzD,YACW,OAAe,EACf,KAA6B,EACtC,OAAe,EACN,OAAiB;QAE1B,KAAK,CAAC,OAAO,CAAC,CAAC;QALN,YAAO,GAAP,OAAO,CAAQ;QACf,UAAK,GAAL,KAAK,CAAwB;QAE7B,YAAO,GAAP,OAAO,CAAU;QAG1B,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;IAC3C,CAAC;CACF;AAED,MAAM,UAAU,4BAA4B,CAAC,KAAc;IACzD,OAAO,KAAK,YAAY,0BAA0B,CAAC;AACrD,CAAC"}

package/dist/ipc-contract/validation.d.ts

@@ -0,0 +1,4 @@
+import { type IpcRegistrar, type IpcSchema } from './types.js';
+export declare function registerChannel(ipc: IpcRegistrar, channel: string, handler: (args: unknown) => Promise<unknown> | unknown): void;
+export declare function parseWithSchema<T>(schema: IpcSchema<T> | undefined, value: unknown, channel: string, phase: 'request' | 'response'): T;
+//# sourceMappingURL=validation.d.ts.map

package/dist/ipc-contract/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/ipc-contract/validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,YAAY,EACjB,KAAK,SAAS,EACf,MAAM,YAAY,CAAC;AAEpB,wBAAgB,eAAe,CAC7B,GAAG,EAAE,YAAY,EACjB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,GACrD,IAAI,CAKN;AAED,wBAAgB,eAAe,CAAC,CAAC,EAC/B,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS,EAChC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,SAAS,GAAG,UAAU,GAC5B,CAAC,CAoBH"}

package/dist/ipc-contract/validation.js

@@ -0,0 +1,24 @@
+import { IpcContractValidationError, isIpcContractValidationError, } from './types.js';
+export function registerChannel(ipc, channel, handler) {
+    if (typeof ipc.hasHandler === 'function' && ipc.hasHandler(channel)) {
+        throw new Error(`IPC handler already registered for channel: ${channel}`);
+    }
+    ipc.handle(channel, handler);
+}
+export function parseWithSchema(schema, value, channel, phase) {
+    if (!schema) {
+        return value;
+    }
+    try {
+        return schema.parse(value);
+    }
+    catch (error) {
+        if (isIpcContractValidationError(error)) {
+            throw error;
+        }
+        const message = error instanceof Error ? error.message : String(error);
+        const schemaName = schema.name ? ` (${schema.name})` : '';
+        throw new IpcContractValidationError(channel, phase, `IPC contract ${phase} validation failed for "${channel}"${schemaName}: ${message}`, error);
+    }
+}
+//# sourceMappingURL=validation.js.map

package/dist/ipc-contract/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/ipc-contract/validation.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,EAC1B,4BAA4B,GAG7B,MAAM,YAAY,CAAC;AAEpB,MAAM,UAAU,eAAe,CAC7B,GAAiB,EACjB,OAAe,EACf,OAAsD;IAEtD,IAAI,OAAO,GAAG,CAAC,UAAU,KAAK,UAAU,IAAI,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACpE,MAAM,IAAI,KAAK,CAAC,+CAA+C,OAAO,EAAE,CAAC,CAAC;IAC5E,CAAC;IACD,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,MAAgC,EAChC,KAAc,EACd,OAAe,EACf,KAA6B;IAE7B,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,KAAU,CAAC;IACpB,CAAC;IAED,IAAI,CAAC;QACH,OAAO,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,4BAA4B,CAAC,KAAK,CAAC,EAAE,CAAC;YACxC,MAAM,KAAK,CAAC;QACd,CAAC;QACD,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1D,MAAM,IAAI,0BAA0B,CAClC,OAAO,EACP,KAAK,EACL,gBAAgB,KAAK,2BAA2B,OAAO,IAAI,UAAU,KAAK,OAAO,EAAE,EACnF,KAAK,CACN,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/ipc-contract.d.ts

@@ -0,0 +1,25 @@
+export type { ContractHandlers, InferCommandRequest, InferCommandResponse, InferSchemaValue, IpcCommandDefinition, IpcCommandMap, IpcInvokeFn, IpcRegistrar, TypedIpcInvoker, } from './ipc-contract/types.js';
+import { createSchema } from './ipc-contract/schema.js';
+import type { IpcSchema as IpcSchemaType } from './ipc-contract/types.js';
+export { IpcContractValidationError, isIpcContractValidationError, } from './ipc-contract/types.js';
+export type IpcSchema<T> = IpcSchemaType<T>;
+export declare const IpcSchema: {
+    readonly custom: <T>(name: string, guard: (value: unknown) => value is T) => IpcSchemaType<T>;
+    readonly unknown: (name?: string) => IpcSchemaType<unknown>;
+    readonly null: (name?: string) => IpcSchemaType<null>;
+    readonly string: (name?: string) => IpcSchemaType<string>;
+    readonly number: (name?: string) => IpcSchemaType<number>;
+    readonly boolean: (name?: string) => IpcSchemaType<boolean>;
+    readonly literal: <TLiteral extends string | number | boolean | null>(expected: TLiteral, name?: string) => IpcSchemaType<TLiteral>;
+    readonly optional: <T>(schema: IpcSchemaType<T>, name?: string) => IpcSchemaType<T | undefined>;
+    readonly array: <TItem>(itemSchema: IpcSchemaType<TItem>, name?: string) => IpcSchemaType<TItem[]>;
+    readonly object: <TShape extends {
+        [x: string]: IpcSchemaType<unknown>;
+    }>(shape: TShape, name?: string) => IpcSchemaType<{ [TKey in keyof TShape]: import("./ipc-contract.js").InferSchemaValue<TShape[TKey]>; }>;
+};
+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.d.ts.map

package/dist/ipc-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ipc-contract.d.ts","sourceRoot":"","sources":["../src/ipc-contract.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,EAChB,oBAAoB,EACpB,aAAa,EACb,WAAW,EACX,YAAY,EACZ,eAAe,GAChB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAA+B,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACrF,OAAO,KAAK,EAAE,SAAS,IAAI,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE1E,OAAO,EACL,0BAA0B,EAC1B,4BAA4B,GAC7B,MAAM,yBAAyB,CAAC;AAEjC,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,aAAa,CAAC,CAAC,CAAC,CAAC;AAC5C,eAAO,MAAM,SAAS;;;;;;;;;;;;;CAAiB,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"}