@startdownnotez404/ui 1.3.5 → 1.3.6

package/dist/alert.d.ts

@@ -1,19 +1,11 @@
-import * as React$1 from 'react';
-import React__default from 'react';
+import * as react from 'react';
+import react__default, { ReactNode } from 'react';
 import * as notistack from 'notistack';
 import { SnackbarKey, CustomContentProps } from 'notistack';
 import * as _mui_material_styles from '@mui/material/styles';
 import { Theme, SxProps } from '@mui/material/styles';
 import * as _mui_material_Alert from '@mui/material/Alert';
-
-/**
- * AlertProvider - Context provider for the alert system
- * Sets up notistack with all custom alert variant components
- * Should wrap the entire application or specific sections that need alerts
- */
-declare const AlertProvider: React__default.NamedExoticComponent<{
-    children: React__default.ReactNode;
-}>;
+import * as _mui_system from '@mui/system';
 
 declare const ALERT_VARIANTs: {
     readonly info: "myInfo";
@@ -24,8 +16,14 @@ declare const ALERT_VARIANTs: {
     readonly insight: "myInsight";
     readonly collapsable: "myCollapsable";
 };
+declare const ALERT_STYLE_VARIANTs: {
+    readonly soft: "soft";
+    readonly classic: "classic";
+};
 declare const DEFAULTs: {
     readonly AUTO_HIDE_DURATION: 3000;
+    /** Quiet glass toast look is the default snackbar chrome. */
+    readonly STYLE_VARIANT: "soft";
     readonly ANCHOR_ORIGIN: {
         readonly horizontal: "right";
         readonly vertical: "top";
@@ -47,6 +45,12 @@ declare const ERRORs: {
 type ValueOf<T> = T[keyof T];
 
 type AlertVariant = ValueOf<typeof ALERT_VARIANTs>;
+/** Visual style for snackbar alerts. Soft = quiet glass (Toast look); classic = filled MUI Alert. */
+type AlertStyleVariant = 'soft' | 'classic';
+type AlertAction = {
+    label: string;
+    onClick: () => void;
+};
 interface AlertOptions {
     message: string | React.ReactNode;
     variant: AlertVariant;
@@ -57,6 +61,13 @@ interface AlertOptions {
         vertical: "top" | "bottom";
     };
     icon?: React.ReactNode | null;
+    /**
+     * Soft = quiet glass + accent bar (default, former Toast look).
+     * Classic = severity fill + colored border (legacy MUI Alert / notistack).
+     */
+    styleVariant?: AlertStyleVariant;
+    /** Optional action button (primarily for soft style; also rendered on classic). */
+    action?: AlertAction;
 }
 /**
  * Props forwarded to the `Renderer` component inside a collapsable alert.
@@ -75,6 +86,11 @@ interface CollapsableAlertOptions {
         horizontal: "left" | "center" | "right";
         vertical: "top" | "bottom";
     };
+    /**
+     * Soft = quiet glass collapsable (default). Classic = denser Card chrome.
+     * Falls back to AlertProvider `defaultStyleVariant`.
+     */
+    styleVariant?: AlertStyleVariant;
     componentProps?: CollapsableAlertComponentProps;
     componentWrapperProps?: {
         Renderer?: React.FC<CollapsableAlertComponentProps>;
@@ -102,8 +118,8 @@ declare function useAlert(): {
     enqueueInsight: (message: string | React.ReactNode, options?: Omit<AlertOptions, "message" | "variant">) => AlertOperationResult<string>;
     closeSnackbar: (key?: notistack.SnackbarKey) => void;
 };
-declare function enqueueAlert({ message, variant, id, autoHideDuration, anchorOrigin, icon, ...rest }: AlertOptions): AlertOperationResult<string>;
-declare function enqueueCollapsable({ id, autoHideDuration, anchorOrigin, componentProps, componentWrapperProps, ...rest }: CollapsableAlertOptions): AlertOperationResult<string>;
+declare function enqueueAlert({ message, variant, id, autoHideDuration, anchorOrigin, icon, styleVariant, action, ...rest }: AlertOptions): AlertOperationResult<string>;
+declare function enqueueCollapsable({ id, autoHideDuration, anchorOrigin, styleVariant, componentProps, componentWrapperProps, ...rest }: CollapsableAlertOptions): AlertOperationResult<string>;
 declare function enqueueError(message: string | React.ReactNode, options?: Omit<AlertOptions, 'message' | 'variant'>): AlertOperationResult<string>;
 declare function enqueueSuccess(message: string | React.ReactNode, options?: Omit<AlertOptions, 'message' | 'variant'>): AlertOperationResult<string>;
 declare function enqueueWarning(message: string | React.ReactNode, options?: Omit<AlertOptions, 'message' | 'variant'>): AlertOperationResult<string>;
@@ -111,13 +127,127 @@ declare function enqueueInfo(message: string | React.ReactNode, options?: Omit<A
 declare function enqueueSystem(message: string | React.ReactNode, options?: Omit<AlertOptions, 'message' | 'variant'>): AlertOperationResult<string>;
 declare function enqueueInsight(message: string | React.ReactNode, options?: Omit<AlertOptions, 'message' | 'variant'>): AlertOperationResult<string>;
 
-declare const CollapsableAlert: React$1.ForwardRefExoticComponent<CustomContentProps & CollapsableAlertOptions & React$1.RefAttributes<HTMLDivElement>>;
+type AlertProviderProps = {
+    children: react__default.ReactNode;
+    /**
+     * Default chrome for enqueued alerts when `styleVariant` is omitted.
+     * Soft = quiet glass (default); classic = filled MUI Alert.
+     * Per-call `styleVariant` always wins.
+     */
+    defaultStyleVariant?: AlertStyleVariant;
+};
+/**
+ * AlertProvider - Context provider for the alert system
+ * Sets up notistack with all custom alert variant components
+ * Should wrap the entire application or specific sections that need alerts
+ */
+declare const AlertProvider: react__default.NamedExoticComponent<AlertProviderProps>;
+
+declare const AlertStyleVariantContext: react__default.Context<AlertStyleVariant>;
+declare function useAlertStyleVariantDefault(): AlertStyleVariant;
+
+declare const CollapsableAlert: react.ForwardRefExoticComponent<CustomContentProps & CollapsableAlertOptions & react.RefAttributes<HTMLDivElement>>;
+
+type SoftAlertContentProps = CustomContentProps & Pick<AlertOptions, 'icon'> & {
+    /** Wired from AlertOptions.action via enqueue (lertAction avoids notistack SharedProps.action clash). */
+    alertAction?: AlertAction;
+};
+/**
+ * Soft/quiet glass snackbar content — former Toast look, owned by Alert/notistack.
+ */
+declare const SoftAlertContent: react.ForwardRefExoticComponent<CustomContentProps & Pick<AlertOptions, "icon"> & {
+    /** Wired from AlertOptions.action via enqueue (lertAction avoids notistack SharedProps.action clash). */
+    alertAction?: AlertAction;
+} & react.RefAttributes<HTMLDivElement>>;
+
+/** @deprecated Prefer AlertVariant / enqueue* with styleVariant soft. */
+type ToastVariant = 'success' | 'error' | 'info' | 'warning';
+/** @deprecated Prefer AlertAction. */
+type ToastAction = AlertAction;
+/** @deprecated Prefer AlertOptions (styleVariant soft). */
+type ToastOptions = {
+    id?: string;
+    /** Auto-dismiss ms. `null` keeps until closed. Default 4000. */
+    duration?: number | null;
+    action?: ToastAction;
+    onClose?: () => void;
+};
+type ToastShowOptions = ToastOptions & {
+    variant?: ToastVariant;
+};
+declare function show(message: ReactNode, options?: ToastShowOptions): string;
+declare function success(message: ReactNode, options?: ToastOptions): string;
+declare function error(message: ReactNode, options?: ToastOptions): string;
+declare function info(message: ReactNode, options?: ToastOptions): string;
+declare function warning(message: ReactNode, options?: ToastOptions): string;
+declare function dismiss(id?: string): void;
+declare function dismissAll(): void;
+/**
+ * Convenience alias that enqueues soft Alert (`styleVariant: 'soft'`).
+ * Requires AlertProvider (ThemeProvider mounts it). Prefer `useAlert` /
+ * `enqueueSuccess` for new code — there is no separate Toast compound.
+ *
+ * @example
+ * toast.success('Saved')
+ * toast.error('Failed', { action: { label: 'Undo', onClick: restore } })
+ */
+declare const toast: typeof show & {
+    success: typeof success;
+    error: typeof error;
+    info: typeof info;
+    warning: typeof warning;
+    dismiss: typeof dismiss;
+    dismissAll: typeof dismissAll;
+    show: typeof show;
+};
+
+/**
+ * Hook mirror of the imperative `toast` soft-Alert alias.
+ * @deprecated Prefer `useAlert` with default soft styleVariant.
+ */
+declare function useToast(): {
+    show: (message: ReactNode, options?: ToastShowOptions) => string;
+    success: (message: ReactNode, options?: ToastOptions) => string;
+    error: (message: ReactNode, options?: ToastOptions) => string;
+    info: (message: ReactNode, options?: ToastOptions) => string;
+    warning: (message: ReactNode, options?: ToastOptions) => string;
+    dismiss: (id?: string) => void;
+    dismissAll: () => void;
+};
 
 /**
- * Root-level CSS variable aliases for the CollapsableAlert compound element.
- * Declare here once — all child elements consume via `var(--*)`.
+ * Classic denser collapsable — solid paper sibling to soft glass.
+ * Quiet border-1, subtle elevation, no harsh gray icon squares.
+ */
+declare const collapsableAlertClassicRootSx: SxProps<Theme>;
+/** @deprecated Use collapsableAlertClassicRootSx / collapsableAlertSoftRootSx. */
+declare const collapsableAlertRootSx: _mui_system.CSSSelectorObjectOrCssVariables<Theme>;
+/**
+ * Soft/quiet glass collapsable — matches SoftAlertContent language:
+ * border-1, glass blur, soft night shadow, 12px radius. No harsh Paper squares.
+ */
+declare const collapsableAlertSoftRootSx: SxProps<Theme>;
+declare const collapsableSoftHeaderSx: SxProps<Theme>;
+/** Classic denser header — solid, slightly taller hit area than soft. */
+declare const collapsableClassicHeaderSx: SxProps<Theme>;
+/** Ghost icon buttons — no gray square hit targets. */
+declare const collapsableSoftIconButtonSx: SxProps<Theme>;
+/**
+ * Classic denser ghost icons — still no harsh gray squares;
+ * slightly stronger hover wash than soft.
+ */
+declare const collapsableClassicIconButtonSx: SxProps<Theme>;
+declare const collapsableSoftPanelSx: SxProps<Theme>;
+/** Classic expand panel — quiet divider, denser tinted content area. */
+declare const collapsableClassicPanelSx: SxProps<Theme>;
+/**
+ * Soft/quiet glass alert — matches former Toast chrome:
+ * quiet border-1, glass blur, accent bar, soft night shadow. No thick severity outlines.
  */
-declare const collapsableAlertRootSx: SxProps<Theme>;
+declare const softAlertItemRootSx: SxProps<Theme>;
+declare const softAlertAccentBarSx: SxProps<Theme>;
+declare const softAlertIconSx: SxProps<Theme>;
+/** Classic MUI Alert severity fill + colored border (legacy notistack look). */
 declare const alertTheme: {
     readonly styleOverrides: {
         readonly root: ({ theme }: _mui_material_Alert.AlertProps & Record<string, unknown> & {
@@ -199,4 +329,4 @@ declare const alertTheme: {
     };
 };
 
-export { ALERT_VARIANTs, type AlertOperationResult, type AlertOptions, AlertProvider, type AlertVariant, CollapsableAlert, type CollapsableAlertComponentProps, type CollapsableAlertOptions, DEFAULTs, ERRORs, alertTheme, collapsableAlertRootSx, enqueueAlert, enqueueCollapsable, enqueueError, enqueueInfo, enqueueInsight, enqueueSuccess, enqueueSystem, enqueueWarning, useAlert };
+export { ALERT_STYLE_VARIANTs, ALERT_VARIANTs, type AlertAction, type AlertOperationResult, type AlertOptions, AlertProvider, type AlertProviderProps, type AlertStyleVariant, AlertStyleVariantContext, type AlertVariant, CollapsableAlert, type CollapsableAlertComponentProps, type CollapsableAlertOptions, DEFAULTs, ERRORs, SoftAlertContent, type SoftAlertContentProps, type ToastAction, type ToastOptions, type ToastShowOptions, type ToastVariant, alertTheme, collapsableAlertClassicRootSx, collapsableAlertRootSx, collapsableAlertSoftRootSx, collapsableClassicHeaderSx, collapsableClassicIconButtonSx, collapsableClassicPanelSx, collapsableSoftHeaderSx, collapsableSoftIconButtonSx, collapsableSoftPanelSx, enqueueAlert, enqueueCollapsable, enqueueError, enqueueInfo, enqueueInsight, enqueueSuccess, enqueueSystem, enqueueWarning, softAlertAccentBarSx, softAlertIconSx, softAlertItemRootSx, toast, useAlert, useAlertStyleVariantDefault, useToast };