@stacksjs/desktop 0.2.5 → 0.2.8

package/dist/alerts.d.ts

@@ -27,19 +27,19 @@ export declare function showToast(options: ToastOptions): Promise<void>;
 /**
  * Show an info toast
  */
-export declare function showInfoToast(message: string, duration?: any): Promise<void>;
+export declare function showInfoToast(message: string, duration?: number): Promise<void>;
 /**
  * Show a success toast
  */
-export declare function showSuccessToast(message: string, duration?: any): Promise<void>;
+export declare function showSuccessToast(message: string, duration?: number): Promise<void>;
 /**
  * Show a warning toast
  */
-export declare function showWarningToast(message: string, duration?: any): Promise<void>;
+export declare function showWarningToast(message: string, duration?: number): Promise<void>;
 /**
  * Show an error toast
  */
-export declare function showErrorToast(message: string, duration?: any): Promise<void>;
+export declare function showErrorToast(message: string, duration?: number): Promise<void>;
 /**
  * Show a notification with title
  */
@@ -161,4 +161,4 @@ export declare const TOAST_STYLES: `
 .stx-toast.success { border-left: 4px solid #27ae60; }
 .stx-toast.warning { border-left: 4px solid #f39c12; }
 .stx-toast.error { border-left: 4px solid #e74c3c; }
-`;
+`;

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/components.d.ts

@@ -500,19 +500,6 @@ export declare const COMPONENT_STYLES: `
   .stx-chip--error { background: #3a1a1a; }
 }
 `;
-/**
- * Native Components for Desktop Applications
- *
- * This module provides TypeScript wrappers for native UI components.
- * Components work in both browser (web-based) and desktop (native) environments.
- *
- * Categories:
- * - Input: Button, TextInput, Checkbox, RadioButton, Slider, ColorPicker, DatePicker, TimePicker, Autocomplete
- * - Display: Label, ImageView, ProgressBar, Avatar, Badge, Chip, Card, Tooltip, Toast
- * - Layout: ScrollView, SplitView, Accordion, Stepper, Modal, Tabs, Dropdown
- * - Data: ListView, Table, TreeView, DataGrid, Chart
- * - Advanced: Rating, CodeEditor, MediaPlayer, FileExplorer, WebView
- */
 /**
  * Button component properties
  */
@@ -939,4 +926,4 @@ export declare interface WebViewProps extends ComponentProps {
   onLoad?: () => void
   onError?: (error: Error) => void
 }
-export type ComponentName = typeof AVAILABLE_COMPONENTS[number]
+export type ComponentName = typeof AVAILABLE_COMPONENTS[number];

package/dist/dialogs.d.ts

@@ -123,16 +123,6 @@ export declare function showWarningDialog(message: string, title?: string): Prom
  * This provides convenient wrappers around the Craft dialog bridge.
  */
 export declare function getDialogBridgeScript(): string;
-/**
- * Native Dialog Integration
- *
- * Provides native file dialogs, message boxes, and other system dialogs
- * using Craft's Dialog Bridge APIs.
- *
- * When running inside a Craft native window, these dialogs use the native
- * OS dialogs (NSOpenPanel on macOS, etc.). When running in a browser,
- * they fall back to web alternatives where possible.
- */
 /**
  * Options for opening a file dialog
  */
@@ -210,4 +200,4 @@ export declare interface ColorPickerOptions {
 export declare interface ColorPickerResult {
   canceled: boolean
   color?: string
-}
+}

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

@@ -55,6 +55,9 @@ export type {
   SaveDialogOptions,
   SaveDialogResult,
 } from './dialogs';
+// =============================================================================
+// Core Types
+// =============================================================================
 export type {
   AlertOptions,
   ComponentProps,
@@ -70,6 +73,46 @@ 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
+ *
+ * Native desktop application framework for stx
+ *
+ * This package provides a TypeScript API for creating native desktop applications
+ * with the stx framework. Powered by Craft (~/Code/craft).
+ *
+ * ## Features
+ * - Window Management: Create and control native windows
+ * - System Tray: Build menubar applications
+ * - Modals & Alerts: Native dialogs and notifications
+ * - 35 UI Components: Complete component library
+ * - Hot Reload: Development mode support
+ */
+// =============================================================================
+// Alerts / Toast Notifications
+// =============================================================================
 export {
   dismissAlertById,
   dismissAllAlerts,
@@ -84,6 +127,9 @@ export {
   showWarningToast,
   TOAST_STYLES,
 } from './alerts';
+// =============================================================================
+// Components (35 total)
+// =============================================================================
 export {
   // Component list and styles
   AVAILABLE_COMPONENTS,
@@ -133,6 +179,9 @@ export {
   createTreeView,
   createWebView,
 } from './components';
+// =============================================================================
+// Modal Dialogs
+// =============================================================================
 export {
   alert,
   closeAllModals,
@@ -147,6 +196,9 @@ export {
   showSuccessModal,
   showWarningModal,
 } from './modals';
+// =============================================================================
+// System Tray / Menubar
+// =============================================================================
 export {
   createMenubar,
   createSystemTray,
@@ -157,6 +209,9 @@ export {
   TRAY_MENU_STYLES,
   triggerTrayAction,
 } from './system-tray';
+// =============================================================================
+// Native Dialogs
+// =============================================================================
 export {
   getDialogBridgeScript,
   showAlertDialog,
@@ -168,6 +223,9 @@ export {
   showSaveDialog,
   showWarningDialog,
 } from './dialogs';
+// =============================================================================
+// Window Management
+// =============================================================================
 export {
   closeAllWindows,
   createWindow,
@@ -180,4 +238,49 @@ export {
   openDevWindow,
   resetDesktopConfig,
   setDesktopConfig,
-} from './window';
+} 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';