@stacksjs/desktop 0.2.6 → 0.2.8

package/dist/autolaunch.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Enable or disable auto-launch on system login.
+ *
+ * On macOS, creates/removes a LaunchAgent plist.
+ * On Linux, creates/removes an XDG autostart .desktop file.
+ */
+export declare function setAutoLaunch(enabled: boolean, options?: AutoLaunchOptions): Promise<void>;
+/**
+ * Check if auto-launch is enabled for the given app.
+ */
+export declare function isAutoLaunchEnabled(appName?: string): Promise<boolean>;
+// ============================================================================
+// Types
+// ============================================================================
+export declare interface AutoLaunchOptions {
+  appName?: string
+  appPath?: string
+  args?: string[]
+  isHidden?: boolean
+}

package/dist/hotkeys.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Parse a shortcut string into its component parts.
+ *
+ * Supports formats like:
+ * - 'Cmd+Shift+C'
+ * - 'Ctrl+Alt+Delete'
+ * - 'Meta+K'
+ * - 'CmdOrCtrl+S' (Cmd on macOS, Ctrl on others)
+ */
+export declare function parseShortcut(shortcut: string): ParsedShortcut;
+/**
+ * Format a parsed shortcut back into a display string.
+ */
+export declare function formatShortcut(parsed: ParsedShortcut): string;
+/**
+ * Register a global keyboard shortcut.
+ *
+ * When running in a Craft native window, this registers a system-wide hotkey
+ * that works even when the app is not focused. In web mode, it falls back to
+ * a document-level keydown listener.
+ *
+ * @param shortcut - The keyboard shortcut (e.g., 'Cmd+Shift+C', 'CmdOrCtrl+K')
+ * @param handler - Function to call when the shortcut is triggered
+ * @returns A registration object with an `unregister()` method
+ */
+export declare function registerHotkey(shortcut: string, handler: () => void): HotkeyRegistration;
+/**
+ * Unregister a specific hotkey.
+ */
+export declare function unregisterHotkey(registration: HotkeyRegistration): void;
+/**
+ * Unregister all registered hotkeys.
+ */
+export declare function unregisterAllHotkeys(): void;
+/**
+ * Get all currently registered hotkeys.
+ */
+export declare function getRegisteredHotkeys(): HotkeyRegistration[];
+/**
+ * Global Hotkey API
+ *
+ * Register global keyboard shortcuts that work even when the app is not focused.
+ * Communicates with Craft's native side to register system-wide hotkeys.
+ * Falls back to document-level listeners in web/non-native mode.
+ *
+ * @example
+ * ```typescript
+ * import { registerHotkey, unregisterAllHotkeys } from '@stacksjs/desktop'
+ *
+ * // Register a global shortcut
+ * const reg = registerHotkey('Cmd+Shift+C', () => {
+ *   console.log('Hotkey triggered!')
+ * })
+ *
+ * // Unregister a specific shortcut
+ * reg.unregister()
+ *
+ * // Unregister all shortcuts
+ * unregisterAllHotkeys()
+ * ```
+ */
+// ============================================================================
+// Types
+// ============================================================================
+export declare interface HotkeyRegistration {
+  shortcut: string
+  id: string
+  unregister(): void
+}
+export declare interface ParsedShortcut {
+  key: string
+  meta: boolean
+  ctrl: boolean
+  shift: boolean
+  alt: boolean
+}

package/dist/index.d.ts

@@ -73,6 +73,28 @@ export type {
   WindowOptions,
 } from './types';
 export type { DesktopConfig } from './window';
+export type {
+  CaffeinateInstance,
+  CaffeinateOptions,
+  CaffeinateStatus,
+} from './power';
+export type {
+  Preferences,
+  PreferencesOptions,
+} from './preferences';
+export type {
+  AutoLaunchOptions,
+} from './autolaunch';
+export type {
+  HotkeyRegistration,
+  ParsedShortcut,
+} from './hotkeys';
+export type {
+  Interval,
+  IntervalOptions,
+  Timer,
+  TimerOptions,
+} from './timer';
 /**
  * @stacksjs/desktop
  *
@@ -217,3 +239,48 @@ export {
   resetDesktopConfig,
   setDesktopConfig,
 } from './window';
+// =============================================================================
+// Power Management / Caffeinate
+// =============================================================================
+export {
+  caffeinate,
+  decaffeinate,
+  formatDuration,
+  formatRemainingTime,
+  getCaffeinateStatus,
+  isCaffeinated,
+} from './power';
+// =============================================================================
+// Preferences / Settings Storage
+// =============================================================================
+export {
+  createPreferences,
+} from './preferences';
+// =============================================================================
+// Auto-Launch / Login Items
+// =============================================================================
+export {
+  isAutoLaunchEnabled,
+  setAutoLaunch,
+} from './autolaunch';
+// =============================================================================
+// Global Hotkeys
+// =============================================================================
+export {
+  formatShortcut,
+  getRegisteredHotkeys,
+  parseShortcut,
+  registerHotkey,
+  unregisterAllHotkeys,
+  unregisterHotkey,
+} from './hotkeys';
+// =============================================================================
+// Timer / Scheduling
+// =============================================================================
+export {
+  createInterval,
+  createTimer,
+  delay,
+  formatCompact,
+  formatTime,
+} from './timer';