@reset-framework/sdk 1.2.0 → 1.2.2

package/src/index.d.ts

@@ -1,574 +1,664 @@
-export type ResetInvokeSuccess<T = unknown> = {
-  ok: true;
-  result: T;
-};
-
-export type ResetInvokeError = {
-  ok: false;
-  error: string;
-  code?: string;
-  details?: unknown;
-};
-
-export type ResetInvokeResponse<T = unknown> =
-  | ResetInvokeSuccess<T>
-  | ResetInvokeError;
-
-export type ResetPlatform = "macos" | "windows" | "linux" | "unknown";
-
-export type ResetArchitecture = "arm64" | "x64" | "x86" | "unknown";
-
-export interface ResetRuntime {
-  invoke<T = unknown>(
-    command: string,
-    payload?: unknown
-  ): Promise<ResetInvokeResponse<T>>;
-}
-
-export interface ResetRuntimeWindow {
-  reset?: ResetRuntime;
-  __resetEventState?: {
-    listeners: Map<string, Set<(payload: unknown) => void>>;
-    dispatch(envelope: { event: string; payload: unknown }): void;
-  };
-  __resetDispatchEvent?: (envelope: { event: string; payload: unknown }) => void;
-}
-
-export interface ResetRuntimeSourceOptions {
-  target?: ResetRuntimeWindow;
-  runtime?: ResetRuntime;
-  resolveRuntime?: () => ResetRuntime | undefined;
-}
-
-export type ResetRuntimeSource =
-  | ResetRuntime
-  | ResetRuntimeWindow
-  | ResetRuntimeSourceOptions
-  | (() => ResetRuntime | undefined)
-  | undefined;
-
-export interface ResetTransport {
-  isAvailable(): boolean;
-  getRuntime(): ResetRuntime;
-  invokeRaw<T = unknown>(
-    command: string,
-    payload?: unknown
-  ): Promise<ResetInvokeResponse<T>>;
-  invoke<T = unknown>(command: string, payload?: unknown): Promise<T>;
-}
-
-export interface ResetCommandApi {
-  invoke<T = unknown>(command: string, payload?: unknown): Promise<T>;
-  invokeRaw<T = unknown>(
-    command: string,
-    payload?: unknown
-  ): Promise<ResetInvokeResponse<T>>;
-}
-
-export interface ResetAppInfo {
-  id: string;
-  name: string;
-  slug: string;
-  version: string;
-  windowTitle: string;
-}
-
-export interface ResetPoint {
-  x: number;
-  y: number;
-}
-
-export interface ResetSize {
-  width: number;
-  height: number;
-}
-
-export interface ResetRect extends ResetPoint, ResetSize {}
-
-export interface ResetWindowInfo {
-  id: string;
-  title: string;
-  frame: ResetRect;
-  position: ResetPoint;
-  size: ResetSize;
-  visible: boolean;
-  focused: boolean;
-  minimized: boolean;
-  maximized: boolean;
-  resizable: boolean;
-}
-
-export interface ResetDisplayInfo {
-  id: string;
-  frame: ResetRect;
-  visibleFrame: ResetRect;
-  scaleFactor: number;
-}
-
-export interface ResetRuntimeInfo {
-  platform: ResetPlatform;
-  arch: ResetArchitecture;
-  frameworkVersion: string;
-  bridgeVersion: string;
-  debug: boolean;
-}
-
-export interface ResetCommandDescriptor {
-  command: string;
-  permission: string;
-}
-
-export interface ResetCapabilitiesInfo {
-  commands: ReadonlyArray<ResetCommandDescriptor>;
-  permissions: ReadonlyArray<string>;
-}
-
-export interface ResetAppApi {
-  getId(): Promise<string>;
-  getName(): Promise<string>;
-  getSlug(): Promise<string>;
-  getVersion(): Promise<string>;
-  getInfo(): Promise<ResetAppInfo>;
-  show(): Promise<{ visible: boolean }>;
-  hide(): Promise<{ hidden: boolean }>;
-  quit(): Promise<{ quitting: boolean }>;
-  relaunch(): Promise<{ relaunching: boolean }>;
-}
-
-export interface ResetRuntimeApi {
-  getPlatform(): Promise<ResetPlatform>;
-  getArchitecture(): Promise<ResetArchitecture>;
-  getFrameworkVersion(): Promise<string>;
-  getBridgeVersion(): Promise<string>;
-  getInfo(): Promise<ResetRuntimeInfo>;
-  getCapabilities(): Promise<ResetCapabilitiesInfo>;
-}
-
-export interface ResetWindowApi {
-  getCurrent(): Promise<ResetWindowInfo>;
-  getInfo(): Promise<ResetWindowInfo>;
-  list(): Promise<{ windows: ResetWindowInfo[] }>;
-  show(): Promise<ResetWindowInfo>;
-  hide(): Promise<ResetWindowInfo>;
-  focus(): Promise<ResetWindowInfo>;
-  close(): Promise<{ closed: boolean }>;
-  minimize(): Promise<ResetWindowInfo>;
-  maximize(): Promise<ResetWindowInfo>;
-  center(): Promise<ResetWindowInfo>;
-  setTitle(title: string): Promise<ResetWindowInfo>;
-  setSize(width: number, height: number): Promise<ResetWindowInfo>;
-  setResizable(resizable: boolean): Promise<ResetWindowInfo>;
-}
-
-export interface ResetDialogOpenFileOptions {
-  title?: string;
-  multiple?: boolean;
-  directory?: boolean;
-}
-
-export interface ResetDialogSaveFileOptions {
-  title?: string;
-  defaultPath?: string;
-}
-
-export interface ResetDialogApi {
-  openFile(options?: ResetDialogOpenFileOptions): Promise<{
-    canceled: boolean;
-    paths: string[];
-  }>;
-  saveFile(options?: ResetDialogSaveFileOptions): Promise<{
-    canceled: boolean;
-    path?: string;
-  }>;
-  message(title: string, message: string): Promise<{ confirmed: boolean }>;
-  confirm(title: string, message: string): Promise<{ confirmed: boolean }>;
-}
-
-export interface ResetDirectoryEntry {
-  name: string;
-  path: string;
-  kind: "file" | "directory" | "symlink" | "other";
-}
-
-export interface ResetFsApi {
-  readTextFile(path: string): Promise<string>;
-  writeTextFile(
-    path: string,
-    text: string,
-    options?: { createDirectories?: boolean }
-  ): Promise<{ written: boolean }>;
-  exists(path: string): Promise<boolean>;
-  mkdir(
-    path: string,
-    options?: { recursive?: boolean }
-  ): Promise<{ created: boolean }>;
-  remove(
-    path: string,
-    options?: { recursive?: boolean }
-  ): Promise<{ removed: boolean; count: number }>;
-  rename(from: string, to: string): Promise<{ renamed: boolean }>;
-  readDir(path: string): Promise<ResetDirectoryEntry[]>;
-}
-
-export interface ResetPathInfo {
-  homeDir: string;
-  tempDir: string;
-  appDataDir: string;
-  appConfigDir: string;
-  cacheDir: string;
-}
-
-export interface ResetPathApi {
-  join(...segments: string[]): Promise<string>;
-  basename(path: string): Promise<string>;
-  dirname(path: string): Promise<string>;
-  resolve(path: string, base?: string): Promise<string>;
-  getHomeDir(): Promise<string>;
-  getTempDir(): Promise<string>;
-  getAppDataDir(): Promise<string>;
-  getAppConfigDir(): Promise<string>;
-  getCacheDir(): Promise<string>;
-  getInfo(): Promise<ResetPathInfo>;
-}
-
-export interface ResetShellApi {
-  openExternal(url: string): Promise<{ opened: boolean }>;
-  openPath(path: string): Promise<{ opened: boolean }>;
-  showItemInFolder(path: string): Promise<{ shown: boolean }>;
-}
-
-export interface ResetClipboardApi {
-  readText(): Promise<string>;
-  writeText(text: string): Promise<{ written: boolean }>;
-}
-
-export interface ResetNotificationApi {
-  isSupported(): Promise<boolean>;
-  requestPermission(): Promise<{
-    supported: boolean;
-    authorized: boolean;
-    status: string;
-  }>;
-  show(options: { title: string; body?: string }): Promise<{
-    shown: boolean;
-    authorized: boolean;
-    id?: string;
-  }>;
-}
-
-export interface ResetScreenApi {
-  getCursorPosition(): Promise<ResetPoint>;
-  getPrimaryDisplay(): Promise<ResetDisplayInfo | null>;
-  getDisplays(): Promise<ResetDisplayInfo[]>;
-}
-
-export interface ResetStorageApi {
-  get<T = unknown>(key: string): Promise<T | null>;
-  set(key: string, value: unknown): Promise<{ key: string; stored: boolean }>;
-  remove(key: string): Promise<{ key: string; removed: boolean }>;
-  clear(): Promise<{ cleared: boolean }>;
-  getAll(): Promise<Record<string, unknown>>;
-}
-
-export interface ResetWebViewInfo {
-  title: string;
-  url: string;
-  canGoBack: boolean;
-  canGoForward: boolean;
-  loading: boolean;
-  estimatedProgress: number;
-}
-
-export interface ResetWebViewApi {
-  getInfo(): Promise<ResetWebViewInfo>;
-  reload(): Promise<ResetWebViewInfo>;
-  goBack(): Promise<ResetWebViewInfo>;
-  goForward(): Promise<ResetWebViewInfo>;
-  navigate(options: { url?: string; path?: string }): Promise<ResetWebViewInfo>;
-  setZoomFactor(factor: number): Promise<ResetWebViewInfo>;
-}
-
-export interface ResetCryptoApi {
-  getInfo(): Promise<{
-    supported: boolean;
-    encodings: string[];
-    maxRandomBytes: number;
-  }>;
-  randomBytes(
-    size: number,
-    options?: { encoding?: "hex" | "base64url" }
-  ): Promise<{
-    size: number;
-    encoding: "hex" | "base64url";
-    value: string;
-  }>;
-  randomUuid(): Promise<string>;
-}
-
-export interface ResetProcessInfo {
-  pid: number;
-  cwd: string;
-  platform: ResetPlatform;
-  arch: ResetArchitecture;
-  debug: boolean;
-}
-
-export interface ResetProcessApi {
-  getPid(): Promise<number>;
-  getCwd(): Promise<string>;
-  getInfo(): Promise<ResetProcessInfo>;
-}
-
-export interface ResetPowerInfo {
-  supported: boolean;
-  lowPowerMode: boolean;
-  thermalState: string;
-}
-
-export interface ResetPowerApi {
-  getInfo(): Promise<ResetPowerInfo>;
-}
-
-export interface ResetSupportInfo {
-  supported: boolean;
-  module: string;
-  platform: ResetPlatform | string;
-}
-
-export interface ResetMenuInfo extends ResetSupportInfo {
-  installed: boolean;
-  topLevelCount: number;
-}
-
-export interface ResetTrayInfo extends ResetSupportInfo {
-  created: boolean;
-  title: string;
-  tooltip: string;
-  hasMenu: boolean;
-}
-
-export interface ResetMenuItem {
-  id?: string;
-  label?: string;
-  enabled?: boolean;
-  checked?: boolean;
-  separator?: boolean;
-  submenu?: ResetMenuItem[];
-}
-
-export interface ResetMenuApi {
-  getInfo(): Promise<ResetMenuInfo>;
-  setApplicationMenu(items: ResetMenuItem[]): Promise<ResetMenuInfo>;
-  clearApplicationMenu(): Promise<ResetMenuInfo>;
-}
-
-export interface ResetTrayApi {
-  getInfo(): Promise<ResetTrayInfo>;
-  create(options?: {
-    title?: string;
-    tooltip?: string;
-    items?: ResetMenuItem[];
-  }): Promise<ResetTrayInfo>;
-  setTitle(title: string): Promise<ResetTrayInfo>;
-  setTooltip(tooltip: string): Promise<ResetTrayInfo>;
-  setMenu(items: ResetMenuItem[]): Promise<ResetTrayInfo>;
-  destroy(): Promise<{ destroyed: boolean }>;
-}
-
-export interface ResetShortcutApi {
-  getInfo(): Promise<ResetSupportInfo>;
-  register(accelerator: string): Promise<unknown>;
-  unregister(accelerator: string): Promise<unknown>;
-  unregisterAll(): Promise<unknown>;
-}
-
-export interface ResetProtocolLaunch {
-  id: string;
-  url: string;
-  scheme: string;
-  host: string;
-  path: string;
-  query: string;
-  fragment: string;
-  source: string;
-  coldStart: boolean;
-}
-
-export interface ResetProtocolInfo extends ResetSupportInfo {
-  configuredSchemes: ReadonlyArray<string>;
-  bundledSchemes: ReadonlyArray<string>;
-  eventName: string;
-  pendingCount: number;
-  eventStreamActive: boolean;
-  runtimeRegistration: boolean;
-}
-
-export interface ResetProtocolApi {
-  getInfo(): Promise<ResetProtocolInfo>;
-  activate(): Promise<{ active: boolean }>;
-  getCurrentLaunch(): Promise<ResetProtocolLaunch | null>;
-  getPendingLaunches(): Promise<ReadonlyArray<ResetProtocolLaunch>>;
-  consumePendingLaunches(): Promise<ReadonlyArray<ResetProtocolLaunch>>;
-  listen(
-    handler: (launch: ResetProtocolLaunch) => void,
-    options?: { consumePending?: boolean }
-  ): Promise<() => void>;
-  register(options?: {
-    scheme?: string;
-  }): Promise<unknown>;
-  unregister(options?: {
-    scheme?: string;
-  }): Promise<unknown>;
-}
-
-export interface ResetUpdaterApi {
-  getInfo(): Promise<ResetSupportInfo>;
-  check(options?: Record<string, unknown>): Promise<unknown>;
-  download(options?: Record<string, unknown>): Promise<unknown>;
-  install(options?: Record<string, unknown>): Promise<unknown>;
-}
-
-export interface ResetNetResponse {
-  url: string;
-  status: number;
-  ok: boolean;
-  headers: Record<string, string>;
-  body: string;
-  bodyEncoding: "utf8" | "base64" | string;
-}
-
-export interface ResetNetApi {
-  request(options: {
-    url: string;
-    method?: string;
-    headers?: Record<string, string>;
-    body?: string;
-    timeoutMs?: number;
-  }): Promise<ResetNetResponse>;
-}
-
-export interface ResetClient {
-  isAvailable(): boolean;
-  getRuntime(): ResetRuntime;
-  commands: ResetCommandApi;
-  app: ResetAppApi;
-  runtime: ResetRuntimeApi;
-  events: ResetEventApi;
-  window: ResetWindowApi;
-  dialog: ResetDialogApi;
-  fs: ResetFsApi;
-  path: ResetPathApi;
-  shell: ResetShellApi;
-  clipboard: ResetClipboardApi;
-  notification: ResetNotificationApi;
-  screen: ResetScreenApi;
-  storage: ResetStorageApi;
-  webview: ResetWebViewApi;
-  crypto: ResetCryptoApi;
-  process: ResetProcessApi;
-  power: ResetPowerApi;
-  menu: ResetMenuApi;
-  tray: ResetTrayApi;
-  shortcut: ResetShortcutApi;
-  protocol: ResetProtocolApi;
-  updater: ResetUpdaterApi;
-  net: ResetNetApi;
-}
-
-export interface ResetEventApi {
-  listen<T = unknown>(
-    eventName: string,
-    handler: (payload: T) => void
-  ): () => void;
-  once<T = unknown>(
-    eventName: string,
-    handler: (payload: T) => void
-  ): () => void;
-  emitLocal<T = unknown>(eventName: string, payload: T): void;
-  emit<T = unknown>(eventName: string, payload?: T): Promise<{
-    delivered: boolean;
-    event: string;
-  }>;
-}
-
-declare global {
-  interface Window extends ResetRuntimeWindow {}
-}
-
-export class ResetRuntimeError extends Error {
-  cause?: unknown;
-  constructor(message?: string, options?: { cause?: unknown });
-}
-
-export class ResetRuntimeUnavailableError extends ResetRuntimeError {
-  constructor(message?: string);
-}
-
-export class ResetProtocolError extends ResetRuntimeError {
-  command?: string;
-  constructor(message?: string, options?: { command?: string; cause?: unknown });
-}
-
-export class ResetInvocationError extends ResetRuntimeError {
-  command: string;
-  response: ResetInvokeError;
-  code?: string;
-  details?: unknown;
-  constructor(
-    command: string,
-    message: string,
-    response: ResetInvokeError,
-    options?: { cause?: unknown }
-  );
-}
-
-export function isResetRuntimeAvailable(
-  source?: ResetRuntimeSource
-): boolean;
-
-export function getResetRuntime(
-  source?: ResetRuntimeSource
-): ResetRuntime;
-
-export function createResetTransport(
-  source?: ResetRuntimeSource
-): ResetTransport;
-
-export function invokeRaw<T = unknown>(
-  command: string,
-  payload?: unknown,
-  source?: ResetRuntimeSource
-): Promise<ResetInvokeResponse<T>>;
-
-export function invoke<T = unknown>(
-  command: string,
-  payload?: unknown,
-  source?: ResetRuntimeSource
-): Promise<T>;
-
-export function createResetClient(source?: ResetRuntimeSource): ResetClient;
-
-export const reset: ResetClient;
-export const commands: ResetCommandApi;
-export const app: ResetAppApi;
-export const runtime: ResetRuntimeApi;
-export const events: ResetEventApi;
-export const window: ResetWindowApi;
-export const dialog: ResetDialogApi;
-export const fs: ResetFsApi;
-export const path: ResetPathApi;
-export const shell: ResetShellApi;
-export const clipboard: ResetClipboardApi;
-export const notification: ResetNotificationApi;
-export const screen: ResetScreenApi;
-export const storage: ResetStorageApi;
-export const webview: ResetWebViewApi;
-export const crypto: ResetCryptoApi;
-export const process: ResetProcessApi;
-export const power: ResetPowerApi;
-export const menu: ResetMenuApi;
-export const tray: ResetTrayApi;
-export const shortcut: ResetShortcutApi;
-export const protocol: ResetProtocolApi;
-export const updater: ResetUpdaterApi;
-export const net: ResetNetApi;
+export type ResetInvokeSuccess<T = unknown> = {
+  ok: true;
+  result: T;
+};
+
+export type ResetInvokeError = {
+  ok: false;
+  error: string;
+  code?: string;
+  details?: unknown;
+};
+
+export type ResetInvokeResponse<T = unknown> =
+  | ResetInvokeSuccess<T>
+  | ResetInvokeError;
+
+export type ResetPlatform = "macos" | "windows" | "linux" | "unknown";
+
+export type ResetArchitecture = "arm64" | "x64" | "x86" | "unknown";
+
+export interface ResetRuntime {
+  invoke<T = unknown>(
+    command: string,
+    payload?: unknown
+  ): Promise<ResetInvokeResponse<T>>;
+}
+
+export interface ResetRuntimeWindow {
+  reset?: ResetRuntime;
+  __resetEventState?: {
+    listeners: Map<string, Set<(payload: unknown) => void>>;
+    dispatch(envelope: { event: string; payload: unknown }): void;
+  };
+  __resetDispatchEvent?: (envelope: { event: string; payload: unknown }) => void;
+}
+
+export interface ResetRuntimeSourceOptions {
+  target?: ResetRuntimeWindow;
+  runtime?: ResetRuntime;
+  resolveRuntime?: () => ResetRuntime | undefined;
+}
+
+export type ResetRuntimeSource =
+  | ResetRuntime
+  | ResetRuntimeWindow
+  | ResetRuntimeSourceOptions
+  | (() => ResetRuntime | undefined)
+  | undefined;
+
+export interface ResetTransport {
+  isAvailable(): boolean;
+  getRuntime(): ResetRuntime;
+  invokeRaw<T = unknown>(
+    command: string,
+    payload?: unknown
+  ): Promise<ResetInvokeResponse<T>>;
+  invoke<T = unknown>(command: string, payload?: unknown): Promise<T>;
+}
+
+export interface ResetCommandApi {
+  invoke<T = unknown>(command: string, payload?: unknown): Promise<T>;
+  invokeRaw<T = unknown>(
+    command: string,
+    payload?: unknown
+  ): Promise<ResetInvokeResponse<T>>;
+}
+
+export interface ResetAppInfo {
+  id: string;
+  name: string;
+  slug: string;
+  version: string;
+  windowTitle: string;
+}
+
+export interface ResetPoint {
+  x: number;
+  y: number;
+}
+
+export interface ResetSize {
+  width: number;
+  height: number;
+}
+
+export interface ResetRect extends ResetPoint, ResetSize {}
+
+export interface ResetWindowInfo {
+  id: string;
+  title: string;
+  frame: ResetRect;
+  position: ResetPoint;
+  size: ResetSize;
+  visible: boolean;
+  focused: boolean;
+  minimized: boolean;
+  maximized: boolean;
+  resizable: boolean;
+}
+
+export interface ResetDisplayInfo {
+  id: string;
+  frame: ResetRect;
+  visibleFrame: ResetRect;
+  scaleFactor: number;
+}
+
+export interface ResetRuntimeInfo {
+  platform: ResetPlatform;
+  arch: ResetArchitecture;
+  frameworkVersion: string;
+  bridgeVersion: string;
+  debug: boolean;
+}
+
+export interface ResetCommandDescriptor {
+  command: string;
+  permission: string;
+}
+
+export interface ResetCapabilitiesInfo {
+  commands: ReadonlyArray<ResetCommandDescriptor>;
+  permissions: ReadonlyArray<string>;
+}
+
+export interface ResetAppApi {
+  getId(): Promise<string>;
+  getName(): Promise<string>;
+  getSlug(): Promise<string>;
+  getVersion(): Promise<string>;
+  getInfo(): Promise<ResetAppInfo>;
+  show(): Promise<{ visible: boolean }>;
+  hide(): Promise<{ hidden: boolean }>;
+  quit(): Promise<{ quitting: boolean }>;
+  relaunch(): Promise<{ relaunching: boolean }>;
+}
+
+export interface ResetRuntimeApi {
+  getPlatform(): Promise<ResetPlatform>;
+  getArchitecture(): Promise<ResetArchitecture>;
+  getFrameworkVersion(): Promise<string>;
+  getBridgeVersion(): Promise<string>;
+  getInfo(): Promise<ResetRuntimeInfo>;
+  getCapabilities(): Promise<ResetCapabilitiesInfo>;
+}
+
+export interface ResetWindowApi {
+  getCurrent(): Promise<ResetWindowInfo>;
+  getInfo(): Promise<ResetWindowInfo>;
+  list(): Promise<{ windows: ResetWindowInfo[] }>;
+  show(): Promise<ResetWindowInfo>;
+  hide(): Promise<ResetWindowInfo>;
+  focus(): Promise<ResetWindowInfo>;
+  close(): Promise<{ closed: boolean }>;
+  minimize(): Promise<ResetWindowInfo>;
+  maximize(): Promise<ResetWindowInfo>;
+  center(): Promise<ResetWindowInfo>;
+  setTitle(title: string): Promise<ResetWindowInfo>;
+  setSize(width: number, height: number): Promise<ResetWindowInfo>;
+  setResizable(resizable: boolean): Promise<ResetWindowInfo>;
+}
+
+export interface ResetDialogOpenFileOptions {
+  title?: string;
+  multiple?: boolean;
+  directory?: boolean;
+}
+
+export interface ResetDialogSaveFileOptions {
+  title?: string;
+  defaultPath?: string;
+}
+
+export interface ResetDialogApi {
+  openFile(options?: ResetDialogOpenFileOptions): Promise<{
+    canceled: boolean;
+    paths: string[];
+  }>;
+  saveFile(options?: ResetDialogSaveFileOptions): Promise<{
+    canceled: boolean;
+    path?: string;
+  }>;
+  message(title: string, message: string): Promise<{ confirmed: boolean }>;
+  confirm(title: string, message: string): Promise<{ confirmed: boolean }>;
+}
+
+export interface ResetDirectoryEntry {
+  name: string;
+  path: string;
+  kind: "file" | "directory" | "symlink" | "other";
+}
+
+export interface ResetFsApi {
+  readTextFile(path: string): Promise<string>;
+  writeTextFile(
+    path: string,
+    text: string,
+    options?: { createDirectories?: boolean }
+  ): Promise<{ written: boolean }>;
+  exists(path: string): Promise<boolean>;
+  mkdir(
+    path: string,
+    options?: { recursive?: boolean }
+  ): Promise<{ created: boolean }>;
+  remove(
+    path: string,
+    options?: { recursive?: boolean }
+  ): Promise<{ removed: boolean; count: number }>;
+  rename(from: string, to: string): Promise<{ renamed: boolean }>;
+  readDir(path: string): Promise<ResetDirectoryEntry[]>;
+}
+
+export interface ResetPathInfo {
+  homeDir: string;
+  tempDir: string;
+  appDataDir: string;
+  appConfigDir: string;
+  cacheDir: string;
+}
+
+export interface ResetPathApi {
+  join(...segments: string[]): Promise<string>;
+  basename(path: string): Promise<string>;
+  dirname(path: string): Promise<string>;
+  resolve(path: string, base?: string): Promise<string>;
+  getHomeDir(): Promise<string>;
+  getTempDir(): Promise<string>;
+  getAppDataDir(): Promise<string>;
+  getAppConfigDir(): Promise<string>;
+  getCacheDir(): Promise<string>;
+  getInfo(): Promise<ResetPathInfo>;
+}
+
+export interface ResetShellApi {
+  openExternal(url: string): Promise<{ opened: boolean }>;
+  openPath(path: string): Promise<{ opened: boolean }>;
+  showItemInFolder(path: string): Promise<{ shown: boolean }>;
+}
+
+export interface ResetClipboardApi {
+  readText(): Promise<string>;
+  writeText(text: string): Promise<{ written: boolean }>;
+}
+
+export interface ResetNotificationApi {
+  isSupported(): Promise<boolean>;
+  requestPermission(): Promise<{
+    supported: boolean;
+    authorized: boolean;
+    status: string;
+  }>;
+  show(options: { title: string; body?: string }): Promise<{
+    shown: boolean;
+    authorized: boolean;
+    id?: string;
+  }>;
+}
+
+export interface ResetScreenApi {
+  getCursorPosition(): Promise<ResetPoint>;
+  getPrimaryDisplay(): Promise<ResetDisplayInfo | null>;
+  getDisplays(): Promise<ResetDisplayInfo[]>;
+}
+
+export interface ResetStorageApi {
+  get<T = unknown>(key: string): Promise<T | null>;
+  set(key: string, value: unknown): Promise<{ key: string; stored: boolean }>;
+  remove(key: string): Promise<{ key: string; removed: boolean }>;
+  clear(): Promise<{ cleared: boolean }>;
+  getAll(): Promise<Record<string, unknown>>;
+}
+
+export interface ResetWebViewInfo {
+  title: string;
+  url: string;
+  canGoBack: boolean;
+  canGoForward: boolean;
+  loading: boolean;
+  estimatedProgress: number;
+}
+
+export interface ResetWebViewApi {
+  getInfo(): Promise<ResetWebViewInfo>;
+  reload(): Promise<ResetWebViewInfo>;
+  goBack(): Promise<ResetWebViewInfo>;
+  goForward(): Promise<ResetWebViewInfo>;
+  navigate(options: { url?: string; path?: string }): Promise<ResetWebViewInfo>;
+  setZoomFactor(factor: number): Promise<ResetWebViewInfo>;
+}
+
+export interface ResetCryptoApi {
+  getInfo(): Promise<{
+    supported: boolean;
+    encodings: string[];
+    maxRandomBytes: number;
+  }>;
+  randomBytes(
+    size: number,
+    options?: { encoding?: "hex" | "base64url" }
+  ): Promise<{
+    size: number;
+    encoding: "hex" | "base64url";
+    value: string;
+  }>;
+  randomUuid(): Promise<string>;
+}
+
+export interface ResetProcessInfo {
+  pid: number;
+  cwd: string;
+  platform: ResetPlatform;
+  arch: ResetArchitecture;
+  debug: boolean;
+}
+
+export interface ResetProcessApi {
+  getPid(): Promise<number>;
+  getCwd(): Promise<string>;
+  getInfo(): Promise<ResetProcessInfo>;
+}
+
+export interface ResetBackendRuntimeInfo {
+  name: string;
+  version: string;
+  platform: string;
+  arch: string;
+}
+
+export interface ResetBackendInfo {
+  supported: boolean;
+  configured: boolean;
+  running: boolean;
+  available: boolean;
+  protocol: string;
+  pid: number | null;
+  entryPath: string;
+  runnerPath: string;
+  executablePath: string;
+  workingDirectory: string;
+  methods: ReadonlyArray<string>;
+  runtime: ResetBackendRuntimeInfo;
+  lastError: string;
+}
+
+export interface ResetBackendProcessInfo {
+  id: string;
+  pid: number;
+  command: string;
+  args: string[];
+  cwd: string;
+  running: boolean;
+  startedAt: string;
+}
+
+export interface ResetBackendProcessRunOptions {
+  command: string;
+  args?: string[];
+  cwd?: string;
+  env?: Record<string, string>;
+  shell?: boolean;
+  input?: string;
+  timeoutMs?: number;
+  maxBufferBytes?: number;
+}
+
+export interface ResetBackendProcessRunResult {
+  command: string;
+  args: string[];
+  cwd: string;
+  exitCode: number | null;
+  signal: string | null;
+  stdout: string;
+  stderr: string;
+  timedOut: boolean;
+  failed: boolean;
+}
+
+export interface ResetBackendProcessApi {
+  spawn(options: {
+    command: string;
+    args?: string[];
+    cwd?: string;
+    env?: Record<string, string>;
+    shell?: boolean;
+  }): Promise<ResetBackendProcessInfo>;
+  run(options: ResetBackendProcessRunOptions): Promise<ResetBackendProcessRunResult>;
+  write(processId: string, data: string): Promise<{ written: boolean }>;
+  kill(
+    processId: string,
+    options?: { signal?: string }
+  ): Promise<{ killed: boolean }>;
+  list(): Promise<{ processes: ResetBackendProcessInfo[] }>;
+}
+
+export interface ResetBackendApi {
+  getInfo(): Promise<ResetBackendInfo>;
+  isAvailable(): Promise<boolean>;
+  invoke<TResult = unknown>(method: string, params?: unknown): Promise<TResult>;
+  listen<T = unknown>(
+    eventName: string,
+    handler: (payload: T) => void
+  ): () => void;
+  once<T = unknown>(
+    eventName: string,
+    handler: (payload: T) => void
+  ): () => void;
+  process: ResetBackendProcessApi;
+}
+
+export interface ResetPowerInfo {
+  supported: boolean;
+  lowPowerMode: boolean;
+  thermalState: string;
+}
+
+export interface ResetPowerApi {
+  getInfo(): Promise<ResetPowerInfo>;
+}
+
+export interface ResetSupportInfo {
+  supported: boolean;
+  module: string;
+  platform: ResetPlatform | string;
+}
+
+export interface ResetMenuInfo extends ResetSupportInfo {
+  installed: boolean;
+  topLevelCount: number;
+}
+
+export interface ResetTrayInfo extends ResetSupportInfo {
+  created: boolean;
+  title: string;
+  tooltip: string;
+  hasMenu: boolean;
+}
+
+export interface ResetMenuItem {
+  id?: string;
+  label?: string;
+  enabled?: boolean;
+  checked?: boolean;
+  separator?: boolean;
+  submenu?: ResetMenuItem[];
+}
+
+export interface ResetMenuApi {
+  getInfo(): Promise<ResetMenuInfo>;
+  setApplicationMenu(items: ResetMenuItem[]): Promise<ResetMenuInfo>;
+  clearApplicationMenu(): Promise<ResetMenuInfo>;
+}
+
+export interface ResetTrayApi {
+  getInfo(): Promise<ResetTrayInfo>;
+  create(options?: {
+    title?: string;
+    tooltip?: string;
+    items?: ResetMenuItem[];
+  }): Promise<ResetTrayInfo>;
+  setTitle(title: string): Promise<ResetTrayInfo>;
+  setTooltip(tooltip: string): Promise<ResetTrayInfo>;
+  setMenu(items: ResetMenuItem[]): Promise<ResetTrayInfo>;
+  destroy(): Promise<{ destroyed: boolean }>;
+}
+
+export interface ResetShortcutApi {
+  getInfo(): Promise<ResetSupportInfo>;
+  register(accelerator: string): Promise<unknown>;
+  unregister(accelerator: string): Promise<unknown>;
+  unregisterAll(): Promise<unknown>;
+}
+
+export interface ResetProtocolLaunch {
+  id: string;
+  url: string;
+  scheme: string;
+  host: string;
+  path: string;
+  query: string;
+  fragment: string;
+  source: string;
+  coldStart: boolean;
+}
+
+export interface ResetProtocolInfo extends ResetSupportInfo {
+  configuredSchemes: ReadonlyArray<string>;
+  bundledSchemes: ReadonlyArray<string>;
+  eventName: string;
+  pendingCount: number;
+  eventStreamActive: boolean;
+  runtimeRegistration: boolean;
+}
+
+export interface ResetProtocolApi {
+  getInfo(): Promise<ResetProtocolInfo>;
+  activate(): Promise<{ active: boolean }>;
+  getCurrentLaunch(): Promise<ResetProtocolLaunch | null>;
+  getPendingLaunches(): Promise<ReadonlyArray<ResetProtocolLaunch>>;
+  consumePendingLaunches(): Promise<ReadonlyArray<ResetProtocolLaunch>>;
+  listen(
+    handler: (launch: ResetProtocolLaunch) => void,
+    options?: { consumePending?: boolean }
+  ): Promise<() => void>;
+  register(options?: {
+    scheme?: string;
+  }): Promise<unknown>;
+  unregister(options?: {
+    scheme?: string;
+  }): Promise<unknown>;
+}
+
+export interface ResetUpdaterApi {
+  getInfo(): Promise<ResetSupportInfo>;
+  check(options?: Record<string, unknown>): Promise<unknown>;
+  download(options?: Record<string, unknown>): Promise<unknown>;
+  install(options?: Record<string, unknown>): Promise<unknown>;
+}
+
+export interface ResetNetResponse {
+  url: string;
+  status: number;
+  ok: boolean;
+  headers: Record<string, string>;
+  body: string;
+  bodyEncoding: "utf8" | "base64" | string;
+}
+
+export interface ResetNetApi {
+  request(options: {
+    url: string;
+    method?: string;
+    headers?: Record<string, string>;
+    body?: string;
+    timeoutMs?: number;
+  }): Promise<ResetNetResponse>;
+}
+
+export interface ResetClient {
+  isAvailable(): boolean;
+  getRuntime(): ResetRuntime;
+  commands: ResetCommandApi;
+  app: ResetAppApi;
+  runtime: ResetRuntimeApi;
+  events: ResetEventApi;
+  window: ResetWindowApi;
+  dialog: ResetDialogApi;
+  fs: ResetFsApi;
+  path: ResetPathApi;
+  shell: ResetShellApi;
+  clipboard: ResetClipboardApi;
+  notification: ResetNotificationApi;
+  screen: ResetScreenApi;
+  storage: ResetStorageApi;
+  webview: ResetWebViewApi;
+  crypto: ResetCryptoApi;
+  process: ResetProcessApi;
+  power: ResetPowerApi;
+  menu: ResetMenuApi;
+  tray: ResetTrayApi;
+  shortcut: ResetShortcutApi;
+  protocol: ResetProtocolApi;
+  updater: ResetUpdaterApi;
+  net: ResetNetApi;
+  backend: ResetBackendApi;
+}
+
+export interface ResetEventApi {
+  listen<T = unknown>(
+    eventName: string,
+    handler: (payload: T) => void
+  ): () => void;
+  once<T = unknown>(
+    eventName: string,
+    handler: (payload: T) => void
+  ): () => void;
+  emitLocal<T = unknown>(eventName: string, payload: T): void;
+  emit<T = unknown>(eventName: string, payload?: T): Promise<{
+    delivered: boolean;
+    event: string;
+  }>;
+}
+
+declare global {
+  interface Window extends ResetRuntimeWindow {}
+}
+
+export class ResetRuntimeError extends Error {
+  cause?: unknown;
+  constructor(message?: string, options?: { cause?: unknown });
+}
+
+export class ResetRuntimeUnavailableError extends ResetRuntimeError {
+  constructor(message?: string);
+}
+
+export class ResetProtocolError extends ResetRuntimeError {
+  command?: string;
+  constructor(message?: string, options?: { command?: string; cause?: unknown });
+}
+
+export class ResetInvocationError extends ResetRuntimeError {
+  command: string;
+  response: ResetInvokeError;
+  code?: string;
+  details?: unknown;
+  constructor(
+    command: string,
+    message: string,
+    response: ResetInvokeError,
+    options?: { cause?: unknown }
+  );
+}
+
+export function isResetRuntimeAvailable(
+  source?: ResetRuntimeSource
+): boolean;
+
+export function getResetRuntime(
+  source?: ResetRuntimeSource
+): ResetRuntime;
+
+export function createResetTransport(
+  source?: ResetRuntimeSource
+): ResetTransport;
+
+export function invokeRaw<T = unknown>(
+  command: string,
+  payload?: unknown,
+  source?: ResetRuntimeSource
+): Promise<ResetInvokeResponse<T>>;
+
+export function invoke<T = unknown>(
+  command: string,
+  payload?: unknown,
+  source?: ResetRuntimeSource
+): Promise<T>;
+
+export function createResetClient(source?: ResetRuntimeSource): ResetClient;
+
+export const reset: ResetClient;
+export const commands: ResetCommandApi;
+export const app: ResetAppApi;
+export const runtime: ResetRuntimeApi;
+export const events: ResetEventApi;
+export const window: ResetWindowApi;
+export const dialog: ResetDialogApi;
+export const fs: ResetFsApi;
+export const path: ResetPathApi;
+export const shell: ResetShellApi;
+export const clipboard: ResetClipboardApi;
+export const notification: ResetNotificationApi;
+export const screen: ResetScreenApi;
+export const storage: ResetStorageApi;
+export const webview: ResetWebViewApi;
+export const crypto: ResetCryptoApi;
+export const process: ResetProcessApi;
+export const power: ResetPowerApi;
+export const menu: ResetMenuApi;
+export const tray: ResetTrayApi;
+export const shortcut: ResetShortcutApi;
+export const protocol: ResetProtocolApi;
+export const updater: ResetUpdaterApi;
+export const net: ResetNetApi;
+export const backend: ResetBackendApi;