@kazee-ds/react 0.4.0 → 0.5.1

package/dist/types/Toast.d.ts

@@ -0,0 +1,32 @@
+import { type ReactNode } from 'react';
+import { type ToastEntry, type ToastManager, type ToastPlacement } from './toast-model.js';
+export interface ToastProviderProps {
+    children?: ReactNode;
+    manager?: ToastManager;
+    placement?: ToastPlacement;
+    label?: string;
+    closeLabel?: string;
+    /** Modifier names followed by a key. An empty array disables the shortcut. */
+    hotkey?: readonly string[];
+    dir?: 'ltr' | 'rtl';
+    showProgress?: boolean;
+    /** Show the dismiss button. Hidden by default; timers and keyboard dismissal still work. */
+    showCloseButton?: boolean;
+    swipeThreshold?: number;
+    /** Customize presentation with the exported Toast component, retaining region behavior. */
+    renderToast?: (entry: ToastEntry) => ReactNode;
+}
+export declare function ToastProvider({ children, manager: suppliedManager, placement, label, closeLabel, hotkey, dir, showProgress, showCloseButton, swipeThreshold, renderToast, }: ToastProviderProps): import("react").JSX.Element;
+export declare function useToast(): ToastManager;
+export interface ToastProps {
+    entry: ToastEntry;
+    /** Override the provider's close button visibility for this toast. */
+    showCloseButton?: boolean;
+    /** Override the provider's progress visibility for this toast. */
+    showProgress?: boolean;
+    indicator?: ReactNode;
+    children?: ReactNode;
+    /** Additional class appended to the shared toast class. */
+    className?: string;
+}
+export declare function Toast({ entry, indicator, children, className, showCloseButton: closeOverride, showProgress: progressOverride, }: ToastProps): import("react").JSX.Element;

package/dist/types/index.d.ts

@@ -81,3 +81,7 @@ export type { DateRangePickerProps } from './DateRangePicker.js';
 export { createDateRangePresets } from './date-range-model.js';
 export { rangeText as formatDateRange } from './date-range-model.js';
 export type { DateRange, DateRangePreset, DateRangeLabels, DateRangeSize, DateRangeVariant, } from './date-range-model.js';
+export { ToastProvider, Toast, useToast } from './Toast.js';
+export type { ToastProviderProps, ToastProps } from './Toast.js';
+export { createToastManager } from './toast-model.js';
+export type { ToastTone, ToastPlacement, ToastCloseReason, ToastAction, ToastOptions, ToastEntry, ToastManagerOptions, ToastPromiseMessages, ToastManager, } from './toast-model.js';

package/dist/types/toast-model.d.ts

@@ -0,0 +1,64 @@
+export type ToastTone = 'neutral' | 'info' | 'success' | 'warning' | 'danger';
+export type ToastPlacement = 'top-start' | 'top-center' | 'top-end' | 'bottom-start' | 'bottom-center' | 'bottom-end';
+export type ToastCloseReason = 'timeout' | 'dismiss' | 'action' | 'cancel' | 'swipe' | 'clear' | 'unmount';
+export interface ToastAction {
+    label: string;
+    altText: string;
+    onAction: () => void;
+    dismiss?: boolean;
+}
+export interface ToastOptions {
+    id?: string;
+    title: string;
+    description?: string;
+    tone?: ToastTone;
+    duration?: number;
+    isLoading?: boolean;
+    action?: ToastAction;
+    cancel?: ToastAction;
+    onClose?: (reason: ToastCloseReason) => void;
+}
+export interface ToastEntry extends Readonly<ToastOptions> {
+    readonly id: string;
+    readonly tone: ToastTone;
+    readonly duration: number;
+    readonly isLoading: boolean;
+    readonly generation: number;
+    readonly state: 'open' | 'closing';
+    readonly createdAt: number;
+    readonly visibleAt: number | null;
+    readonly remaining: number;
+    readonly paused: boolean;
+}
+export interface ToastManagerOptions {
+    maxVisible?: number;
+    maxPending?: number;
+    duration?: number;
+    exitDuration?: number;
+}
+type ToastMessage = string | ToastOptions;
+export interface ToastPromiseMessages<T> {
+    loading: ToastMessage;
+    success: ToastMessage | ((value: T) => ToastMessage);
+    error: ToastMessage | ((error: unknown) => ToastMessage);
+}
+export interface ToastManager {
+    add(options: ToastOptions): string | null;
+    update(id: string, options: Partial<ToastOptions>): boolean;
+    dismiss(id: string, reason?: ToastCloseReason): void;
+    clear(reason?: ToastCloseReason): void;
+    pause(reason: string): void;
+    resume(reason: string): void;
+    attach(): () => void;
+    dispose(): void;
+    subscribe(listener: () => void): () => void;
+    getSnapshot(): readonly ToastEntry[];
+    getServerSnapshot(): readonly ToastEntry[];
+    promise<T>(promise: Promise<T>, messages: ToastPromiseMessages<T>, options?: Partial<ToastOptions>): {
+        id: string | null;
+        promise: Promise<T>;
+    };
+}
+/** Create per application/provider; no browser globals or timers are used until attached. */
+export declare function createToastManager(options?: ToastManagerOptions): ToastManager;
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kazee-ds/react",
-  "version": "0.4.0",
+  "version": "0.5.1",
   "type": "module",
   "exports": {
     ".": {