/**
 * Display a toast notification
 *
 * This method automatically ensures the pds-toaster component exists and is loaded
 * before displaying the notification. The toaster element is appended to document.body
 * if not already present.
 *
 * @param {string} message - The message to display
 * @param {Object} [options={}] - Toast configuration
 * @param {"information"|"success"|"warning"|"error"} [options.type="information"] - Toast type/severity
 * @param {number} [options.duration] - Duration in milliseconds (auto-calculated if not provided based on message length)
 * @param {boolean} [options.closable=true] - Whether the toast can be manually closed
 * @param {boolean} [options.persistent=false] - If true, toast won't auto-dismiss (requires manual close)
 * @param {boolean} [options.html=false] - Render `message` as HTML (trusted content only)
 * @param {{label: string, onClick?: Function, dismissOnClick?: boolean}} [options.action] - Optional action button config
 * @returns {Promise<string>} Toast ID (can be used to dismiss programmatically)
 *
 * @example
 * // Simple success toast
 * await PDS.toast('Changes saved successfully!', { type: 'success' });
 *
 * @example
 * // Error with custom duration
 * await PDS.toast('Failed to save changes', {
 *   type: 'error',
 *   duration: 8000
 * });
 *
 * @example
 * // Persistent warning (must be manually closed)
 * await PDS.toast('This action cannot be undone', {
 *   type: 'warning',
 *   persistent: true
 * });
 *
 * @example
 * // Get toast ID to dismiss later
 * const toastId = await PDS.toast('Processing...', { persistent: true });
 * // ... later
 * const toaster = document.querySelector('pds-toaster');
 * toaster.dismissToast(toastId);
 */
export function toast(message: string, options?: {
    type?: "information" | "success" | "warning" | "error";
    duration?: number;
    closable?: boolean;
    persistent?: boolean;
    html?: boolean;
    action?: {
        label: string;
        onClick?: Function;
        dismissOnClick?: boolean;
    };
}): Promise<string>;
export namespace toast {
    /**
     * Display a success toast (convenience method)
     *
     * @param {string} message - The success message
     * @param {Object} [options={}] - Additional toast options (type is preset to 'success')
     * @returns {Promise<string>} Toast ID
     *
     * @example
     * await PDS.toast.success('Profile updated!');
     */
    function success(message: string, options?: any): Promise<string>;
    /**
     * Display an error toast (convenience method)
     *
     * @param {string} message - The error message
     * @param {Object} [options={}] - Additional toast options (type is preset to 'error')
     * @returns {Promise<string>} Toast ID
     *
     * @example
     * await PDS.toast.error('Failed to connect to server');
     */
    function error(message: string, options?: any): Promise<string>;
    /**
     * Display a warning toast (convenience method)
     *
     * @param {string} message - The warning message
     * @param {Object} [options={}] - Additional toast options (type is preset to 'warning')
     * @returns {Promise<string>} Toast ID
     *
     * @example
     * await PDS.toast.warning('Session will expire in 5 minutes');
     */
    function warning(message: string, options?: any): Promise<string>;
    /**
     * Display an information toast (convenience method)
     *
     * @param {string} message - The information message
     * @param {Object} [options={}] - Additional toast options (type is preset to 'information')
     * @returns {Promise<string>} Toast ID
     *
     * @example
     * await PDS.toast.info('New features available!');
     */
    function info(message: string, options?: any): Promise<string>;
}
//# sourceMappingURL=toast.d.ts.map