@pure-ds/core 0.4.24 → 0.4.26

package/src/js/pds.d.ts

@@ -154,6 +154,68 @@ export class PDS extends EventTarget {
   static validateDesign: (designConfig: any, options?: { minContrast?: number }) => { ok: boolean; issues: Array<{ path: string; message: string; ratio: number; min: number; context?: string }> };
   static validateDesigns: (designs: Array<any> | Record<string, any>, options?: { minContrast?: number }) => { ok: boolean; results: Array<{ name?: string; ok: boolean; issues: Array<{ path: string; message: string; ratio: number; min: number; context?: string }> }> };
   
+  /**
+   * Display a toast notification.
+   * 
+   * Automatically ensures the pds-toaster component exists and is loaded before displaying.
+   * 
+   * @param message - The message to display
+   * @param options - Toast configuration
+   * @param options.type - Toast type/severity ("information" | "success" | "warning" | "error")
+   * @param options.duration - Duration in milliseconds (auto-calculated if not provided)
+   * @param options.closable - Whether toast can be manually closed (default: true)
+   * @param options.persistent - If true, toast won't auto-dismiss (default: false)
+   * @returns Toast ID (can be used to dismiss programmatically)
+   * 
+   * @example
+   * await PDS.toast('Changes saved!', { type: 'success' });
+   * 
+   * @example
+   * await PDS.toast('Error occurred', { type: 'error', persistent: true });
+   */
+  static toast(
+    message: string,
+    options?: {
+      type?: 'information' | 'success' | 'warning' | 'error';
+      duration?: number;
+      closable?: boolean;
+      persistent?: boolean;
+    }
+  ): Promise<string>;
+  
+  /**
+   * Display a success toast (convenience method).
+   * 
+   * @param message - The success message
+   * @param options - Additional toast options (type is preset to 'success')
+   * @returns Toast ID
+   * 
+   * @example
+   * await PDS.toast.success('Profile updated!');
+   */
+  static toast: {
+    (message: string, options?: { type?: 'information' | 'success' | 'warning' | 'error'; duration?: number; closable?: boolean; persistent?: boolean }): Promise<string>;
+    success(message: string, options?: { duration?: number; closable?: boolean; persistent?: boolean }): Promise<string>;
+    error(message: string, options?: { duration?: number; closable?: boolean; persistent?: boolean }): Promise<string>;
+    warning(message: string, options?: { duration?: number; closable?: boolean; persistent?: boolean }): Promise<string>;
+    info(message: string, options?: { duration?: number; closable?: boolean; persistent?: boolean }): Promise<string>;
+  };
+  
+  /**
+   * Display a modal dialog for user input or confirmation.
+   * 
+   * @param message - The message or prompt to display
+   * @param options - Dialog configuration
+   * @returns User's response (string for prompt, boolean for confirm, true for alert)
+   * 
+   * @example
+   * const confirmed = await PDS.ask('Delete this item?', { type: 'confirm' });
+   * 
+   * @example
+   * const name = await PDS.ask('Enter your name:', { type: 'prompt' });
+   */
+  static ask(message: string, options?: any): Promise<any>;
+  
   /** 
    * Current configuration after PDS.start() completes - read-only, frozen after initialization.
    * Contains the complete configuration used to initialize PDS, including mode, design, preset, and theme.

package/src/js/pds.js

@@ -56,6 +56,7 @@ import { findComponentForElement } from "./pds-core/pds-ontology.js";
 import { presets, defaultLog } from "./pds-core/pds-config.js";
 import { enums } from "./pds-core/pds-enums.js";
 import { ask } from "./common/ask.js";
+import { toast } from "./common/toast.js";
 import { PDSQuery } from "./pds-core/pds-query.js";
 import * as common from "./common/common.js";
 import { defaultPDSEnhancers } from "./pds-core/pds-enhancers.js";
@@ -87,6 +88,7 @@ PDS.isLiveMode = () => registry.isLive;
 PDS.enums = enums;
 
 PDS.ask = ask;
+PDS.toast = toast;
 
 // Expose common utilities (deepMerge, isObject, etc.)
 PDS.common = common;