@tenerife.music/ui 1.0.3 → 1.0.6

package/dist/components/notifications/NotificationCenter.GroupHeader.d.ts

@@ -0,0 +1,23 @@
+import * as React from "react";
+export interface NotificationCenterGroupHeaderProps extends React.HTMLAttributes<HTMLDivElement> {
+    /**
+     * Group label text
+     */
+    label: string;
+    /**
+     * Whether the group is collapsed
+     */
+    collapsed?: boolean;
+    /**
+     * Callback when collapse/expand is toggled
+     */
+    onToggleCollapse?: () => void;
+    /**
+     * Show collapse/expand button
+     */
+    collapsible?: boolean;
+}
+/**
+ * NotificationCenter.GroupHeader component - group section header
+ */
+export declare const NotificationCenterGroupHeader: React.ForwardRefExoticComponent<NotificationCenterGroupHeaderProps & React.RefAttributes<HTMLDivElement>>;

package/dist/components/notifications/NotificationCenter.Item.d.ts

@@ -0,0 +1,24 @@
+import { NotificationData } from './NotificationCenter.types';
+import * as React from "react";
+export interface NotificationCenterItemProps extends Omit<React.HTMLAttributes<HTMLLIElement>, "onClick"> {
+    /**
+     * Notification data
+     */
+    notification: NotificationData;
+    /**
+     * Callback when notification is dismissed
+     */
+    onDismiss?: (id: string) => void;
+    /**
+     * Callback when notification is clicked
+     */
+    onClick?: (id: string) => void;
+    /**
+     * Show expandable details
+     */
+    expandable?: boolean;
+}
+/**
+ * NotificationCenter.Item component - individual notification item
+ */
+export declare const NotificationCenterItem: React.ForwardRefExoticComponent<NotificationCenterItemProps & React.RefAttributes<HTMLLIElement>>;

package/dist/components/notifications/NotificationCenter.List.d.ts

@@ -0,0 +1,22 @@
+/**
+ * NotificationCenter.List Component
+ *
+ * Vertical list container for notifications.
+ * Uses Stack component with token-based spacing.
+ * Provides proper ARIA roles for accessibility.
+ */
+import * as React from "react";
+export interface NotificationCenterListProps extends React.HTMLAttributes<HTMLUListElement> {
+    /**
+     * Children to render (notification items)
+     */
+    children: React.ReactNode;
+    /**
+     * ARIA label for the list
+     */
+    "aria-label"?: string;
+}
+/**
+ * NotificationCenter.List component - vertical list container
+ */
+export declare const NotificationCenterList: React.ForwardRefExoticComponent<NotificationCenterListProps & React.RefAttributes<HTMLUListElement>>;

package/dist/components/notifications/NotificationCenter.Panel.d.ts

@@ -0,0 +1,32 @@
+import { GroupByFunction } from './NotificationCenter.types';
+import * as React from "react";
+export interface NotificationCenterPanelProps {
+    /**
+     * Whether panel is open
+     */
+    isOpen: boolean;
+    /**
+     * Callback when panel should close
+     */
+    onClose: () => void;
+    /**
+     * Function to group notifications (by date, type, or custom)
+     */
+    groupBy?: GroupByFunction;
+    /**
+     * Panel width variant
+     */
+    width?: "sm" | "md" | "lg";
+    /**
+     * Auto-collapse older notifications
+     */
+    autoCollapse?: boolean;
+    /**
+     * Element to return focus to when panel closes
+     */
+    returnFocusRef?: React.RefObject<HTMLElement>;
+}
+/**
+ * NotificationCenter.Panel component - side drawer notification panel
+ */
+export declare const NotificationCenterPanel: React.ForwardRefExoticComponent<NotificationCenterPanelProps & React.RefAttributes<HTMLDivElement>>;

package/dist/components/notifications/NotificationCenter.Provider.d.ts

@@ -0,0 +1,31 @@
+import { NotificationContextType } from './NotificationCenter.types';
+/**
+ * NotificationCenter.Provider Component
+ *
+ * Global notification state management provider.
+ * Manages persistent history, multi-channel support, and notification lifecycle.
+ * SSR-safe: no window/document access in render.
+ */
+import * as React from "react";
+export interface NotificationCenterProviderProps {
+    /**
+     * Children to render
+     */
+    children: React.ReactNode;
+    /**
+     * Maximum number of notifications to keep in history
+     */
+    maxHistory?: number;
+    /**
+     * Enable persistent history (in-memory, can be extended to localStorage)
+     */
+    persistent?: boolean;
+}
+/**
+ * NotificationCenter.Provider component - global notification state management
+ */
+export declare function NotificationCenterProvider({ children, maxHistory, persistent, }: NotificationCenterProviderProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Hook to use notification center context
+ */
+export declare function useNotificationCenterContext(): NotificationContextType;

package/dist/components/notifications/NotificationCenter.Trigger.d.ts

@@ -0,0 +1,15 @@
+import * as React from "react";
+export interface NotificationCenterTriggerProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
+    /**
+     * Callback when trigger is clicked
+     */
+    onClick?: () => void;
+    /**
+     * Show unread badge
+     */
+    showBadge?: boolean;
+}
+/**
+ * NotificationCenter.Trigger component - open panel button
+ */
+export declare const NotificationCenterTrigger: React.ForwardRefExoticComponent<NotificationCenterTriggerProps & React.RefAttributes<HTMLButtonElement>>;

package/dist/components/notifications/NotificationCenter.d.ts

@@ -0,0 +1,27 @@
+import { NotificationCenterProvider } from './NotificationCenter.Provider';
+/**
+ * NotificationCenter Compound Component
+ *
+ * Compound component structure for Notification Center.
+ * Provides all subcomponents through a single export.
+ */
+export { NotificationCenterDismissAll } from './NotificationCenter.DismissAll';
+export { NotificationCenterGroupHeader } from './NotificationCenter.GroupHeader';
+export { NotificationCenterItem } from './NotificationCenter.Item';
+export { NotificationCenterList } from './NotificationCenter.List';
+export { NotificationCenterPanel } from './NotificationCenter.Panel';
+export { NotificationCenterProvider, useNotificationCenterContext, } from './NotificationCenter.Provider';
+export { NotificationCenterTrigger } from './NotificationCenter.Trigger';
+export { useNotificationCenter } from './useNotificationCenter';
+/**
+ * NotificationCenter compound component
+ */
+export declare const NotificationCenter: {
+    Provider: typeof NotificationCenterProvider;
+    Panel: import('react').ForwardRefExoticComponent<import('./NotificationCenter.Panel').NotificationCenterPanelProps & import('react').RefAttributes<HTMLDivElement>>;
+    Trigger: import('react').ForwardRefExoticComponent<import('./NotificationCenter.Trigger').NotificationCenterTriggerProps & import('react').RefAttributes<HTMLButtonElement>>;
+    List: import('react').ForwardRefExoticComponent<import('./NotificationCenter.List').NotificationCenterListProps & import('react').RefAttributes<HTMLUListElement>>;
+    Item: import('react').ForwardRefExoticComponent<import('./NotificationCenter.Item').NotificationCenterItemProps & import('react').RefAttributes<HTMLLIElement>>;
+    GroupHeader: import('react').ForwardRefExoticComponent<import('./NotificationCenter.GroupHeader').NotificationCenterGroupHeaderProps & import('react').RefAttributes<HTMLDivElement>>;
+    DismissAll: import('react').ForwardRefExoticComponent<import('./NotificationCenter.DismissAll').NotificationCenterDismissAllProps & import('react').RefAttributes<HTMLButtonElement>>;
+};

package/dist/components/notifications/NotificationCenter.types.d.ts

@@ -0,0 +1,89 @@
+import { ToastAction } from '../overlays/Toast';
+/**
+ * Notification channel types
+ */
+export type NotificationChannel = "success" | "error" | "info" | "warning" | "system" | "log";
+/**
+ * Notification variant (extends toast variants)
+ */
+export type NotificationVariant = "default" | "success" | "info" | "warning" | "danger" | "system" | "log";
+/**
+ * Notification data structure
+ */
+export interface NotificationData {
+    id: string;
+    title?: string;
+    description?: string;
+    variant?: NotificationVariant;
+    channel?: NotificationChannel;
+    action?: ToastAction;
+    duration?: number;
+    persistent?: boolean;
+    timestamp: number;
+    read?: boolean;
+}
+/**
+ * Notification options for creating notifications
+ */
+export interface NotificationOptions {
+    title?: string;
+    description?: string;
+    variant?: NotificationVariant;
+    channel?: NotificationChannel;
+    action?: ToastAction;
+    duration?: number;
+    persistent?: boolean;
+}
+/**
+ * Group by function type
+ */
+export type GroupByFunction = (notification: NotificationData) => string;
+/**
+ * Notification context type
+ */
+export interface NotificationContextType {
+    /**
+     * Push a new notification
+     */
+    push: (notification: NotificationOptions) => string;
+    /**
+     * Remove a specific notification by ID
+     */
+    remove: (id: string) => void;
+    /**
+     * Clear all notifications
+     */
+    clearAll: () => void;
+    /**
+     * Clear notifications by channel
+     */
+    clearChannel: (channel: NotificationChannel) => void;
+    /**
+     * Group notifications by function
+     */
+    groupBy: (fn: GroupByFunction) => Record<string, NotificationData[]>;
+    /**
+     * Get persistent history
+     */
+    getHistory: () => NotificationData[];
+    /**
+     * Get notifications by channel
+     */
+    getByChannel: (channel: NotificationChannel) => NotificationData[];
+    /**
+     * Get all notifications
+     */
+    getAll: () => NotificationData[];
+    /**
+     * Mark notification as read
+     */
+    markAsRead: (id: string) => void;
+    /**
+     * Mark all as read
+     */
+    markAllAsRead: () => void;
+    /**
+     * Get unread count
+     */
+    getUnreadCount: () => number;
+}

package/dist/components/notifications/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Notification Center Components
+ *
+ * Barrel exports for all notification center components.
+ */
+export { NotificationCenter } from './NotificationCenter';
+export { NotificationCenterDismissAll } from './NotificationCenter.DismissAll';
+export { NotificationCenterGroupHeader } from './NotificationCenter.GroupHeader';
+export { NotificationCenterItem } from './NotificationCenter.Item';
+export { NotificationCenterList } from './NotificationCenter.List';
+export { NotificationCenterPanel } from './NotificationCenter.Panel';
+export { NotificationCenterProvider } from './NotificationCenter.Provider';
+export { NotificationCenterTrigger } from './NotificationCenter.Trigger';
+export { useNotificationCenterContext } from './NotificationCenter.Provider';
+export { useNotificationCenter } from './useNotificationCenter';
+export type { GroupByFunction, NotificationChannel, NotificationContextType, NotificationData, NotificationOptions, NotificationVariant, } from './NotificationCenter.types';
+export type { NotificationCenterDismissAllProps } from './NotificationCenter.DismissAll';
+export type { NotificationCenterGroupHeaderProps } from './NotificationCenter.GroupHeader';
+export type { NotificationCenterItemProps } from './NotificationCenter.Item';
+export type { NotificationCenterListProps } from './NotificationCenter.List';
+export type { NotificationCenterPanelProps } from './NotificationCenter.Panel';
+export type { NotificationCenterProviderProps } from './NotificationCenter.Provider';
+export type { NotificationCenterTriggerProps } from './NotificationCenter.Trigger';

package/dist/components/notifications/useNotificationCenter.d.ts

@@ -0,0 +1,47 @@
+import { NotificationOptions } from './NotificationCenter.types';
+export interface NotificationAPI {
+    /**
+     * Show success notification
+     */
+    success: (message: string, options?: Omit<NotificationOptions, "variant" | "channel">) => string;
+    /**
+     * Show error notification
+     */
+    error: (message: string, options?: Omit<NotificationOptions, "variant" | "channel">) => string;
+    /**
+     * Show info notification
+     */
+    info: (message: string, options?: Omit<NotificationOptions, "variant" | "channel">) => string;
+    /**
+     * Show warning notification
+     */
+    warning: (message: string, options?: Omit<NotificationOptions, "variant" | "channel">) => string;
+    /**
+     * Show system notification
+     */
+    system: (message: string, options?: Omit<NotificationOptions, "variant" | "channel">) => string;
+    /**
+     * Show log notification
+     */
+    log: (message: string, options?: Omit<NotificationOptions, "variant" | "channel">) => string;
+    /**
+     * Push custom notification
+     */
+    push: (options: NotificationOptions) => string;
+    /**
+     * Remove notification by ID
+     */
+    remove: (id: string) => void;
+    /**
+     * Clear all notifications
+     */
+    clearAll: () => void;
+    /**
+     * Clear notifications by channel
+     */
+    clearChannel: (channel: "success" | "error" | "info" | "warning" | "system" | "log") => void;
+}
+/**
+ * useNotificationCenter hook - multi-channel notification API
+ */
+export declare function useNotificationCenter(): NotificationAPI;

package/dist/components/overlays/Backdrop.d.ts

@@ -0,0 +1,24 @@
+import { VariantProps } from 'class-variance-authority';
+import * as React from "react";
+declare const backdropVariants: (props?: ({
+    variant?: "default" | "transparent" | "blurred" | null | undefined;
+} & import('class-variance-authority/types').ClassProp) | undefined) => string;
+export interface BackdropProps extends React.HTMLAttributes<HTMLDivElement>, VariantProps<typeof backdropVariants> {
+    /**
+     * Backdrop variant
+     */
+    variant?: "default" | "blurred" | "transparent";
+    /**
+     * Whether backdrop is visible (for animation)
+     */
+    isVisible?: boolean;
+    /**
+     * Click handler for backdrop dismiss
+     */
+    onClick?: (event: React.MouseEvent<HTMLDivElement>) => void;
+}
+/**
+ * Backdrop component - overlay background
+ */
+export declare const Backdrop: React.ForwardRefExoticComponent<BackdropProps & React.RefAttributes<HTMLDivElement>>;
+export {};

package/dist/components/overlays/Dialog.d.ts

@@ -0,0 +1,66 @@
+import { ModalProps } from './Modal';
+/**
+ * Dialog Component
+ *
+ * Semantic modal wrapper built on Modal component.
+ * Provides Dialog.Header, Dialog.Title, Dialog.Description, Dialog.Body, Dialog.Footer subcomponents.
+ * Full A11y compliance with aria-labelledby and aria-describedby.
+ */
+import * as React from "react";
+export interface DialogProps extends Omit<ModalProps, "role" | "aria-modal"> {
+    /**
+     * ID for the dialog title (for aria-labelledby)
+     */
+    titleId?: string;
+    /**
+     * ID for the dialog description (for aria-describedby)
+     */
+    descriptionId?: string;
+}
+/**
+ * Dialog Root - Main dialog wrapper
+ */
+declare const DialogRoot: React.ForwardRefExoticComponent<DialogProps & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Dialog Header - Header section with spacing
+ */
+export interface DialogHeaderProps extends React.HTMLAttributes<HTMLDivElement> {
+    titleId?: string;
+    descriptionId?: string;
+}
+declare const DialogHeader: React.ForwardRefExoticComponent<DialogHeaderProps & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Dialog Title - h2 with aria-labelledby
+ */
+export interface DialogTitleProps extends React.HTMLAttributes<HTMLHeadingElement> {
+    titleId?: string;
+}
+declare const DialogTitle: React.ForwardRefExoticComponent<DialogTitleProps & React.RefAttributes<HTMLHeadingElement>>;
+/**
+ * Dialog Description - p with aria-describedby
+ */
+export interface DialogDescriptionProps extends React.HTMLAttributes<HTMLParagraphElement> {
+    descriptionId?: string;
+}
+declare const DialogDescription: React.ForwardRefExoticComponent<DialogDescriptionProps & React.RefAttributes<HTMLParagraphElement>>;
+/**
+ * Dialog Body - Main content area
+ */
+export interface DialogBodyProps extends React.HTMLAttributes<HTMLDivElement> {
+}
+declare const DialogBody: React.ForwardRefExoticComponent<DialogBodyProps & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Dialog Footer - Footer section with Row layout
+ */
+export interface DialogFooterProps extends React.HTMLAttributes<HTMLDivElement> {
+}
+declare const DialogFooter: React.ForwardRefExoticComponent<DialogFooterProps & React.RefAttributes<HTMLDivElement>>;
+declare const Dialog: React.ForwardRefExoticComponent<DialogProps & React.RefAttributes<HTMLDivElement>> & {
+    Root: React.ForwardRefExoticComponent<DialogProps & React.RefAttributes<HTMLDivElement>>;
+    Header: React.ForwardRefExoticComponent<DialogHeaderProps & React.RefAttributes<HTMLDivElement>>;
+    Title: React.ForwardRefExoticComponent<DialogTitleProps & React.RefAttributes<HTMLHeadingElement>>;
+    Description: React.ForwardRefExoticComponent<DialogDescriptionProps & React.RefAttributes<HTMLParagraphElement>>;
+    Body: React.ForwardRefExoticComponent<DialogBodyProps & React.RefAttributes<HTMLDivElement>>;
+    Footer: React.ForwardRefExoticComponent<DialogFooterProps & React.RefAttributes<HTMLDivElement>>;
+};
+export { Dialog, DialogBody, DialogDescription, DialogFooter, DialogHeader, DialogRoot, DialogTitle, };

package/dist/components/overlays/Modal.d.ts

@@ -0,0 +1,60 @@
+import { VariantProps } from 'class-variance-authority';
+import * as React from "react";
+declare const modalVariants: (props?: ({
+    size?: "sm" | "md" | "lg" | "fullscreen" | null | undefined;
+} & import('class-variance-authority/types').ClassProp) | undefined) => string;
+export interface ModalProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "onClick" | "role" | "aria-modal" | "aria-labelledby" | "aria-describedby">, VariantProps<typeof modalVariants> {
+    /**
+     * Whether modal is open
+     */
+    open: boolean;
+    /**
+     * Callback when modal should close
+     */
+    onClose: () => void;
+    /**
+     * Modal size variant
+     */
+    size?: "sm" | "md" | "lg" | "fullscreen";
+    /**
+     * Backdrop variant
+     */
+    backdropVariant?: "default" | "blurred" | "transparent";
+    /**
+     * Whether to close on backdrop click
+     */
+    closeOnBackdropClick?: boolean;
+    /**
+     * Whether to close on escape key
+     */
+    closeOnEscape?: boolean;
+    /**
+     * Element to return focus to when modal closes
+     */
+    returnFocusRef?: React.RefObject<HTMLElement>;
+}
+/**
+ * Modal Header - Header section with spacing
+ */
+export interface ModalHeaderProps extends React.HTMLAttributes<HTMLDivElement> {
+}
+declare const ModalHeader: React.ForwardRefExoticComponent<ModalHeaderProps & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Modal Body - Main content area
+ */
+export interface ModalBodyProps extends React.HTMLAttributes<HTMLDivElement> {
+}
+declare const ModalBody: React.ForwardRefExoticComponent<ModalBodyProps & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Modal Footer - Footer section with layout
+ */
+export interface ModalFooterProps extends React.HTMLAttributes<HTMLDivElement> {
+}
+declare const ModalFooter: React.ForwardRefExoticComponent<ModalFooterProps & React.RefAttributes<HTMLDivElement>>;
+declare const Modal: React.ForwardRefExoticComponent<ModalProps & React.RefAttributes<HTMLDivElement>> & {
+    Content: React.ForwardRefExoticComponent<ModalProps & React.RefAttributes<HTMLDivElement>>;
+    Header: React.ForwardRefExoticComponent<ModalHeaderProps & React.RefAttributes<HTMLDivElement>>;
+    Body: React.ForwardRefExoticComponent<ModalBodyProps & React.RefAttributes<HTMLDivElement>>;
+    Footer: React.ForwardRefExoticComponent<ModalFooterProps & React.RefAttributes<HTMLDivElement>>;
+};
+export { Modal, ModalBody, ModalFooter, ModalHeader, modalVariants };

package/dist/components/overlays/OverlayPortal.d.ts

@@ -20,4 +20,3 @@ interface OverlayContainerProps {
 }
 export declare function OverlayContainer({ children, className, style, position, }: OverlayContainerProps): import("react/jsx-runtime").JSX.Element;
 export {};
-//# sourceMappingURL=OverlayPortal.d.ts.map

package/dist/components/overlays/Popover.d.ts

@@ -5,11 +5,11 @@ declare const Popover: React.FC<PopoverPrimitive.PopoverProps>;
 declare const PopoverTrigger: React.ForwardRefExoticComponent<PopoverPrimitive.PopoverTriggerProps & React.RefAttributes<HTMLButtonElement>>;
 declare const PopoverAnchor: React.ForwardRefExoticComponent<PopoverPrimitive.PopoverAnchorProps & React.RefAttributes<HTMLDivElement>>;
 declare const popoverContentVariants: (props?: ({
-    variant?: "primary" | "secondary" | "accent" | "destructive" | "link" | "outline" | "ghost" | null | undefined;
+    variant?: "primary" | "secondary" | "accent" | "destructive" | "outline" | "ghost" | "link" | null | undefined;
     size?: "sm" | "md" | "lg" | "xl" | "xs" | null | undefined;
 } & import('class-variance-authority/types').ClassProp) | undefined) => string;
 declare const PopoverContent: React.ForwardRefExoticComponent<Omit<PopoverPrimitive.PopoverContentProps & React.RefAttributes<HTMLDivElement>, "ref"> & VariantProps<(props?: ({
-    variant?: "primary" | "secondary" | "accent" | "destructive" | "link" | "outline" | "ghost" | null | undefined;
+    variant?: "primary" | "secondary" | "accent" | "destructive" | "outline" | "ghost" | "link" | null | undefined;
     size?: "sm" | "md" | "lg" | "xl" | "xs" | null | undefined;
 } & import('class-variance-authority/types').ClassProp) | undefined) => string> & React.RefAttributes<HTMLDivElement>>;
 export interface PopoverProps {
@@ -28,4 +28,3 @@ export interface PopoverProps {
 }
 export declare function PopoverWrapper({ children, content, variant, size, side, align, sideOffset, alignOffset, open, onOpenChange, modal, closeOnInteractOutside, }: PopoverProps): import("react/jsx-runtime").JSX.Element;
 export { Popover, PopoverAnchor, PopoverContent, popoverContentVariants, PopoverTrigger };
-//# sourceMappingURL=Popover.d.ts.map

package/dist/components/overlays/Portal.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Portal Component
+ *
+ * SSR-safe portal component for rendering children outside the DOM hierarchy.
+ * Mounts to document.body by default, with optional custom container support.
+ */
+import * as React from "react";
+export interface PortalProps {
+    /**
+     * Children to portal
+     */
+    children: React.ReactNode;
+    /**
+     * Container element to portal into (defaults to document.body)
+     */
+    container?: Element | null;
+    /**
+     * Additional CSS classes
+     */
+    className?: string;
+    /**
+     * Additional inline styles
+     */
+    style?: React.CSSProperties;
+}
+/**
+ * Portal component - SSR-safe portal rendering
+ */
+export declare const Portal: React.ForwardRefExoticComponent<PortalProps & React.RefAttributes<HTMLDivElement>>;

package/dist/components/overlays/Toast.d.ts

@@ -0,0 +1,36 @@
+import { VariantProps } from 'class-variance-authority';
+import * as React from "react";
+declare const toastVariants: (props?: ({
+    variant?: "default" | "success" | "warning" | "danger" | "info" | null | undefined;
+} & import('class-variance-authority/types').ClassProp) | undefined) => string;
+export interface ToastAction {
+    label: string;
+    onClick: () => void;
+}
+export interface ToastData {
+    id: string;
+    title?: string;
+    description?: string;
+    variant?: "default" | "success" | "info" | "warning" | "danger";
+    action?: ToastAction;
+    duration?: number;
+}
+export interface ToastProps extends React.HTMLAttributes<HTMLDivElement>, VariantProps<typeof toastVariants> {
+    /**
+     * Toast data
+     */
+    toast: ToastData;
+    /**
+     * Callback when toast is dismissed
+     */
+    onDismiss: (id: string) => void;
+    /**
+     * Whether toast is visible (for animation)
+     */
+    isVisible?: boolean;
+}
+/**
+ * Toast component - notification toast
+ */
+export declare const Toast: React.ForwardRefExoticComponent<ToastProps & React.RefAttributes<HTMLDivElement>>;
+export {};

package/dist/components/overlays/ToastProvider.d.ts

@@ -0,0 +1,58 @@
+import { ToastAction, ToastData } from './Toast';
+import { ToastPosition } from './ToastViewport';
+/**
+ * ToastProvider Component
+ *
+ * Context provider for toast notifications.
+ * Manages toast state and provides toast() function.
+ * Supports position configuration and max toasts limit.
+ */
+import * as React from "react";
+export interface ToastOptions {
+    title?: string;
+    description?: string;
+    variant?: "default" | "success" | "info" | "warning" | "danger";
+    action?: ToastAction;
+    duration?: number;
+}
+interface ToastContextType {
+    toast: (options: ToastOptions) => string;
+    dismiss: (id: string) => void;
+    dismissAll: () => void;
+    updateToast: (id: string, updates: Partial<ToastData>) => void;
+    getQueue: () => ToastData[];
+    getGrouped: () => Record<string, ToastData[]>;
+}
+export type GroupByFunction = (toast: ToastData) => string;
+export interface ToastProviderProps {
+    /**
+     * Children to render
+     */
+    children: React.ReactNode;
+    /**
+     * Position of toast viewport
+     */
+    position?: ToastPosition;
+    /**
+     * Maximum number of toasts to show (default: 5)
+     */
+    maxToasts?: number;
+    /**
+     * Maximum number of visible toasts (default: 3)
+     * Overflow notifications are queued
+     */
+    maxVisible?: number;
+    /**
+     * Function to group toasts (by date, type, or custom)
+     */
+    groupBy?: GroupByFunction;
+}
+/**
+ * ToastProvider component - context provider for toast notifications
+ */
+export declare function ToastProvider({ children, position, maxVisible, groupBy, }: ToastProviderProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Hook to use toast context
+ */
+export declare function useToast(): ToastContextType;
+export {};