@stacksjs/desktop 0.2.3

package/dist/dialogs.d.ts

@@ -0,0 +1,213 @@
+/**
+ * Show a native file open dialog
+ *
+ * When running in Craft, uses the native OS file picker.
+ * In browser, falls back to HTML file input.
+ *
+ * @param options - Dialog options
+ * @returns Promise resolving to selected files or cancellation
+ *
+ * @example
+ * ```typescript
+ * const result = await showOpenDialog({
+ *   title: 'Select an image',
+ *   filters: [{ name: 'Images', extensions: ['png', 'jpg', 'gif'] }],
+ *   multiSelections: true,
+ * })
+ *
+ * if (!result.canceled) {
+ *   console.log('Selected:', result.filePaths)
+ * }
+ * ```
+ */
+export declare function showOpenDialog(options?: OpenDialogOptions): Promise<OpenDialogResult>;
+/**
+ * Show a native file save dialog
+ *
+ * When running in Craft, uses the native OS save dialog.
+ * In browser, this is limited to triggering downloads.
+ *
+ * @param options - Dialog options
+ * @returns Promise resolving to selected path or cancellation
+ *
+ * @example
+ * ```typescript
+ * const result = await showSaveDialog({
+ *   title: 'Save document',
+ *   defaultPath: 'document.txt',
+ *   filters: [{ name: 'Text Files', extensions: ['txt'] }],
+ * })
+ *
+ * if (!result.canceled && result.filePath) {
+ *   console.log('Save to:', result.filePath)
+ * }
+ * ```
+ */
+export declare function showSaveDialog(options?: SaveDialogOptions): Promise<SaveDialogResult>;
+/**
+ * Show a native message box dialog
+ *
+ * When running in Craft, uses the native OS message box.
+ * In browser, falls back to confirm/alert dialogs.
+ *
+ * @param options - Message box options
+ * @returns Promise resolving to button index clicked
+ *
+ * @example
+ * ```typescript
+ * const result = await showMessageBox({
+ *   type: 'question',
+ *   title: 'Confirm',
+ *   message: 'Are you sure you want to delete this file?',
+ *   buttons: ['Cancel', 'Delete'],
+ *   defaultButton: 0,
+ *   cancelButton: 0,
+ * })
+ *
+ * if (result.response === 1) {
+ *   // User clicked "Delete"
+ * }
+ * ```
+ */
+export declare function showMessageBox(options: MessageBoxOptions): Promise<MessageBoxResult>;
+/**
+ * Show a native color picker dialog
+ *
+ * @param options - Color picker options
+ * @returns Promise resolving to selected color or cancellation
+ *
+ * @example
+ * ```typescript
+ * const result = await showColorPicker({
+ *   color: '#ff0000',
+ *   showAlpha: true,
+ * })
+ *
+ * if (!result.canceled && result.color) {
+ *   document.body.style.backgroundColor = result.color
+ * }
+ * ```
+ */
+export declare function showColorPicker(options?: ColorPickerOptions): Promise<ColorPickerResult>;
+/**
+ * Show a simple alert message dialog (native)
+ *
+ * @param message - Message to display
+ * @param title - Optional dialog title
+ */
+export declare function showAlertDialog(message: string, title?: string): Promise<void>;
+/**
+ * Show a confirmation dialog (native)
+ *
+ * @param message - Message to display
+ * @param title - Optional dialog title
+ * @returns True if confirmed, false if cancelled
+ */
+export declare function showConfirmDialog(message: string, title?: string): Promise<boolean>;
+/**
+ * Show an error dialog (native)
+ *
+ * @param message - Error message
+ * @param title - Optional dialog title
+ */
+export declare function showErrorDialog(message: string, title?: string): Promise<void>;
+/**
+ * Show a warning dialog (native)
+ *
+ * @param message - Warning message
+ * @param title - Optional dialog title
+ */
+export declare function showWarningDialog(message: string, title?: string): Promise<void>;
+/**
+ * Generate a JavaScript snippet for dialog control from inside a webview.
+ * 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
+ */
+export declare interface OpenDialogOptions {
+  title?: string
+  defaultPath?: string
+  buttonLabel?: string
+  filters?: FileFilter[]
+  multiSelections?: boolean
+  showHiddenFiles?: boolean
+  canChooseDirectories?: boolean
+  canChooseFiles?: boolean
+  canCreateDirectories?: boolean
+}
+/**
+ * Options for saving a file dialog
+ */
+export declare interface SaveDialogOptions {
+  title?: string
+  defaultPath?: string
+  buttonLabel?: string
+  filters?: FileFilter[]
+  showHiddenFiles?: boolean
+  canCreateDirectories?: boolean
+}
+/**
+ * File type filter
+ */
+export declare interface FileFilter {
+  name: string
+  extensions: string[]
+}
+/**
+ * Result from open dialog
+ */
+export declare interface OpenDialogResult {
+  canceled: boolean
+  filePaths: string[]
+}
+/**
+ * Result from save dialog
+ */
+export declare interface SaveDialogResult {
+  canceled: boolean
+  filePath?: string
+}
+/**
+ * Options for message box dialog
+ */
+export declare interface MessageBoxOptions {
+  type?: 'none' | 'info' | 'warning' | 'error' | 'question'
+  title?: string
+  message: string
+  detail?: string
+  buttons?: string[]
+  defaultButton?: number
+  cancelButton?: number
+}
+/**
+ * Result from message box
+ */
+export declare interface MessageBoxResult {
+  response: number
+}
+/**
+ * Options for color picker dialog
+ */
+export declare interface ColorPickerOptions {
+  color?: string
+  showAlpha?: boolean
+}
+/**
+ * Result from color picker
+ */
+export declare interface ColorPickerResult {
+  canceled: boolean
+  color?: string
+}

package/dist/index.d.ts

@@ -0,0 +1,183 @@
+export type {
+  AccordionProps,
+  AutocompleteProps,
+  AvatarProps,
+  BadgeProps,
+  // Input Props
+  ButtonProps,
+  CardProps,
+  ChartData,
+  ChartOptions,
+  ChartProps,
+  CheckboxProps,
+  ChipProps,
+  CodeEditorProps,
+  ColorPickerProps,
+  ComponentName,
+  DataGridProps,
+  DatePickerProps,
+  DropdownProps,
+  FileExplorerProps,
+  FileNode,
+  ImageViewProps,
+  // Display Props
+  LabelProps,
+  // Data Props
+  ListViewProps,
+  MediaPlayerProps,
+  ModalComponentProps,
+  ProgressBarProps,
+  RadioButtonProps,
+  // Advanced Props
+  RatingProps,
+  // Layout Props
+  ScrollViewProps,
+  SliderProps,
+  SplitViewProps,
+  StepperProps,
+  TableProps,
+  TabsProps,
+  TextInputProps,
+  TimePickerProps,
+  TooltipProps,
+  TreeNode,
+  TreeViewProps,
+  WebViewProps,
+} from './components';
+export type {
+  ColorPickerOptions,
+  ColorPickerResult,
+  FileFilter,
+  MessageBoxOptions,
+  MessageBoxResult,
+  OpenDialogOptions,
+  OpenDialogResult,
+  SaveDialogOptions,
+  SaveDialogResult,
+} from './dialogs';
+export type {
+  AlertOptions,
+  ComponentProps,
+  ModalButton,
+  ModalOptions,
+  ModalResult,
+  SidebarConfig,
+  SystemTrayInstance,
+  SystemTrayMenuItem,
+  SystemTrayOptions,
+  ToastOptions,
+  WindowInstance,
+  WindowOptions,
+} from './types';
+export type { DesktopConfig } from './window';
+export {
+  dismissAlertById,
+  dismissAllAlerts,
+  getActiveAlertCount,
+  notify,
+  requestNotificationPermission,
+  showAlert,
+  showErrorToast,
+  showInfoToast,
+  showSuccessToast,
+  showToast,
+  showWarningToast,
+  TOAST_STYLES,
+} from './alerts';
+export {
+  // Component list and styles
+  AVAILABLE_COMPONENTS,
+  COMPONENT_STYLES,
+  createAccordion,
+  createAutocomplete,
+  createAvatar,
+  createBadge,
+  // Input Components
+  createButton,
+  createCard,
+  createChart,
+
+  createCheckbox,
+  createChip,
+  createCodeEditor,
+  createColorPicker,
+  createDataGrid,
+  createDatePicker,
+  createDropdown,
+  createFileExplorer,
+
+  createImageView,
+  // Display Components
+  createLabel,
+  // Data Components
+  createListView,
+  createMediaPlayer,
+  createModalComponent,
+  createProgressBar,
+  createRadioButton,
+
+  // Advanced Components
+  createRating,
+  // Layout Components
+  createScrollView,
+  createSlider,
+  createSplitView,
+  createStepper,
+
+  createTable,
+  createTabs,
+  createTextInput,
+  createTimePicker,
+  createTooltip,
+
+  createTreeView,
+  createWebView,
+} from './components';
+export {
+  alert,
+  closeAllModals,
+  confirm,
+  getActiveModalCount,
+  MODAL_STYLES,
+  prompt,
+  showErrorModal,
+  showInfoModal,
+  showModal,
+  showQuestionModal,
+  showSuccessModal,
+  showWarningModal,
+} from './modals';
+export {
+  createMenubar,
+  createSystemTray,
+  getActiveTrayInstances,
+  getSimulatedTrayHTML,
+  getTrayBridgeScript,
+  getTrayInstance,
+  TRAY_MENU_STYLES,
+  triggerTrayAction,
+} from './system-tray';
+export {
+  getDialogBridgeScript,
+  showAlertDialog,
+  showColorPicker,
+  showConfirmDialog,
+  showErrorDialog,
+  showMessageBox,
+  showOpenDialog,
+  showSaveDialog,
+  showWarningDialog,
+} from './dialogs';
+export {
+  closeAllWindows,
+  createWindow,
+  createWindowWithHTML,
+  getActiveWindowIds,
+  getDesktopConfig,
+  getWindow,
+  getWindowBridgeScript,
+  isWebviewAvailable,
+  openDevWindow,
+  resetDesktopConfig,
+  setDesktopConfig,
+} from './window';