@dimaan/ui 0.0.14 → 0.0.17

package/dist/index.d.ts

@@ -1,13 +1,164 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as react from 'react';
-import { HTMLAttributes, ReactNode, ButtonHTMLAttributes, ReactElement, InputHTMLAttributes, ChangeEvent, ComponentPropsWithoutRef, FormEventHandler, FieldsetHTMLAttributes, Ref, TextareaHTMLAttributes } from 'react';
+import { ComponentPropsWithoutRef, HTMLAttributes, ReactNode, ButtonHTMLAttributes, ReactElement, InputHTMLAttributes, ChangeEvent, FormEventHandler, FieldsetHTMLAttributes, Ref, TextareaHTMLAttributes } from 'react';
+import * as RadixAlertDialog from '@radix-ui/react-alert-dialog';
 import { LinkProps } from 'react-router-dom';
 import { Locale } from 'react-day-picker';
+import * as RadixDialog from '@radix-ui/react-dialog';
 import * as RadixDropdown from '@radix-ui/react-dropdown-menu';
 import { FieldValues, FieldPath, Control } from 'react-hook-form';
 import * as RadixRadioGroup from '@radix-ui/react-radio-group';
+import { ToasterProps as ToasterProps$1 } from 'sonner';
+export { ExternalToast as ToastOptions, ToastT, toast } from 'sonner';
+import * as RadixTooltip from '@radix-ui/react-tooltip';
 import { ClassValue } from 'clsx';
 
+/**
+ * Destructive-confirm dialog built on `@radix-ui/react-alert-dialog`. Same
+ * visual surface as `Dialog`, but with stricter dismissal UX:
+ *
+ * - **Click-outside does NOT close** — users must press Cancel or Action.
+ *   This is the canonical "are you sure?" pattern.
+ * - **No default × close button** — both exits are explicit through the
+ *   footer buttons.
+ * - **Description is required** for accessibility — Radix throws a console
+ *   warning if `AlertDialogDescription` is missing.
+ *
+ * Use for destructive confirmations (delete, archive, revoke). For neutral
+ * forms / modals use `Dialog` instead.
+ *
+ * @example Delete confirmation
+ * ```tsx
+ * <AlertDialog>
+ *   <AlertDialogTrigger asChild>
+ *     <Button variant="destructive">
+ *       <Trash2 />
+ *       Delete user
+ *     </Button>
+ *   </AlertDialogTrigger>
+ *   <AlertDialogContent>
+ *     <AlertDialogHeader>
+ *       <AlertDialogTitle>Delete this user?</AlertDialogTitle>
+ *       <AlertDialogDescription>
+ *         This will permanently remove the account. This action cannot be undone.
+ *       </AlertDialogDescription>
+ *     </AlertDialogHeader>
+ *     <AlertDialogFooter>
+ *       <AlertDialogCancel asChild>
+ *         <Button variant="outline">Cancel</Button>
+ *       </AlertDialogCancel>
+ *       <AlertDialogAction asChild>
+ *         <Button variant="destructive" onClick={handleDelete}>Delete</Button>
+ *       </AlertDialogAction>
+ *     </AlertDialogFooter>
+ *   </AlertDialogContent>
+ * </AlertDialog>
+ * ```
+ */
+declare const AlertDialog: react.FC<RadixAlertDialog.AlertDialogProps>;
+declare const AlertDialogTrigger: react.ForwardRefExoticComponent<RadixAlertDialog.AlertDialogTriggerProps & react.RefAttributes<HTMLButtonElement>>;
+declare const AlertDialogPortal: react.FC<RadixAlertDialog.AlertDialogPortalProps>;
+/**
+ * Confirm button. Wraps any element via `asChild` — pair with our `<Button>` for
+ * full styling. Closes the dialog when clicked.
+ */
+declare const AlertDialogAction: react.ForwardRefExoticComponent<RadixAlertDialog.AlertDialogActionProps & react.RefAttributes<HTMLButtonElement>>;
+/**
+ * Cancel button. Wraps any element via `asChild` — pair with our `<Button>` for
+ * full styling. Closes the dialog when clicked. Also the default focus target
+ * when the dialog opens.
+ */
+declare const AlertDialogCancel: react.ForwardRefExoticComponent<RadixAlertDialog.AlertDialogCancelProps & react.RefAttributes<HTMLButtonElement>>;
+interface AlertDialogOverlayProps extends ComponentPropsWithoutRef<typeof RadixAlertDialog.Overlay> {
+}
+declare const AlertDialogOverlay: react.ForwardRefExoticComponent<AlertDialogOverlayProps & react.RefAttributes<HTMLDivElement>>;
+interface AlertDialogContentProps extends ComponentPropsWithoutRef<typeof RadixAlertDialog.Content> {
+}
+declare const AlertDialogContent: react.ForwardRefExoticComponent<AlertDialogContentProps & react.RefAttributes<HTMLDivElement>>;
+interface AlertDialogHeaderProps extends HTMLAttributes<HTMLDivElement> {
+    children: ReactNode;
+}
+declare function AlertDialogHeader({ className, ...props }: AlertDialogHeaderProps): react_jsx_runtime.JSX.Element;
+interface AlertDialogFooterProps extends HTMLAttributes<HTMLDivElement> {
+    children: ReactNode;
+}
+declare function AlertDialogFooter({ className, ...props }: AlertDialogFooterProps): react_jsx_runtime.JSX.Element;
+interface AlertDialogTitleProps extends ComponentPropsWithoutRef<typeof RadixAlertDialog.Title> {
+}
+declare const AlertDialogTitle: react.ForwardRefExoticComponent<AlertDialogTitleProps & react.RefAttributes<HTMLHeadingElement>>;
+type AlertDialogDescriptionProps = ComponentPropsWithoutRef<typeof RadixAlertDialog.Description>;
+declare const AlertDialogDescription: react.ForwardRefExoticComponent<Omit<RadixAlertDialog.AlertDialogDescriptionProps & react.RefAttributes<HTMLParagraphElement>, "ref"> & react.RefAttributes<HTMLParagraphElement>>;
+
+interface ConfirmOptions {
+    /** Question / strong statement at the top of the dialog. */
+    title: ReactNode;
+    /** Optional secondary line — explain consequences. Strongly recommended. */
+    description?: ReactNode;
+    /** Confirm button label. Falls back to provider's `labels.confirm` then `'Confirm'`. */
+    confirmLabel?: ReactNode;
+    /** Cancel button label. Falls back to provider's `labels.cancel` then `'Cancel'`. */
+    cancelLabel?: ReactNode;
+    /** Render the confirm button with the destructive variant. Use for delete/revoke. */
+    destructive?: boolean;
+}
+interface ConfirmDialogLabels {
+    confirm?: ReactNode;
+    cancel?: ReactNode;
+}
+interface ConfirmDialogProviderProps {
+    /**
+     * Global default labels — typically wired to the consumer's i18n strings so
+     * every `confirm(...)` call doesn't have to pass `cancelLabel` / `confirmLabel`.
+     */
+    labels?: ConfirmDialogLabels;
+    children: ReactNode;
+}
+type ConfirmFn = (options: ConfirmOptions) => Promise<boolean>;
+/**
+ * App-level provider for the imperative confirm dialog. Mount **once** at the
+ * app root (next to `<Toaster />`); every descendant can then call
+ * `useConfirm()` and trigger a destructive-confirm dialog in a single line.
+ *
+ * @example Mount at the app root
+ * ```tsx
+ * <AppShell brand={…} nav={…}>
+ *   <ConfirmDialogProvider labels={{ confirm: t.confirm, cancel: t.cancel }}>
+ *     <Routes>…</Routes>
+ *   </ConfirmDialogProvider>
+ *   <Toaster />
+ * </AppShell>
+ * ```
+ *
+ * @example One-line confirm from anywhere
+ * ```tsx
+ * function UserRow({ user }: { user: User }) {
+ *   const confirm = useConfirm();
+ *
+ *   async function handleDelete() {
+ *     const ok = await confirm({
+ *       title: 'Delete this user?',
+ *       description: 'This action cannot be undone.',
+ *       confirmLabel: 'Delete',
+ *       destructive: true,
+ *     });
+ *     if (!ok) return;
+ *     deleteUser(user.id);
+ *     toast.success('User deleted');
+ *   }
+ *
+ *   return <Button variant="destructive" onClick={handleDelete}>Delete</Button>;
+ * }
+ * ```
+ */
+declare function ConfirmDialogProvider({ labels, children }: ConfirmDialogProviderProps): react_jsx_runtime.JSX.Element;
+/**
+ * Hook returning a `confirm(options)` function. Resolves `true` when the user
+ * presses the confirm button, `false` for cancel / Escape / overlay dismiss.
+ *
+ * Must be called from inside a `<ConfirmDialogProvider>`.
+ */
+declare function useConfirm(): ConfirmFn;
+
 interface DashboardLayoutContextValue {
     collapsed: boolean;
     setCollapsed: (next: boolean) => void;
@@ -443,6 +594,307 @@ interface DatePickerProps {
  */
 declare const DatePicker: react.ForwardRefExoticComponent<DatePickerProps & react.RefAttributes<HTMLButtonElement>>;
 
+type PageHeaderHeadingLevel = 'h1' | 'h2' | 'h3' | 'h4';
+/** Props passed to the routing-library `render` slot of the back button. */
+interface PageHeaderBackRenderProps {
+    to?: LinkProps['to'];
+    className?: string;
+    children: ReactNode;
+    onClick?: () => void;
+}
+interface PageHeaderBackProps {
+    /** Visible label next to the arrow. Defaults to `"Back"`. */
+    label?: ReactNode;
+    /** Target to — renders a React Router `<Link>`. */
+    to?: LinkProps['to'];
+    /** Click handler — renders a `<button>` (or wraps the `render` element). */
+    onClick?: () => void;
+    /** Routing-library render prop (e.g. wrap a different link component). Wins over `to`. */
+    render?: (props: PageHeaderBackRenderProps) => ReactElement;
+}
+interface PageHeaderProps extends Omit<HTMLAttributes<HTMLElement>, 'title'> {
+    /** Page title (required). */
+    title: ReactNode;
+    /** Optional secondary text under the title. */
+    description?: ReactNode;
+    /** Slot above the title for breadcrumbs (e.g. `<Breadcrumbs items={…} />` or your own JSX). */
+    breadcrumbs?: ReactNode;
+    /** Optional back button rendered above the title row. */
+    back?: PageHeaderBackProps;
+    /** Slot on the trailing side of the title row — buttons, dropdowns, etc. */
+    actions?: ReactNode;
+    /** Heading level for the title element. Defaults to `'h1'`. */
+    as?: PageHeaderHeadingLevel;
+    /** Add a bottom border separator. Default: `false`. */
+    bordered?: boolean;
+}
+/**
+ * Top-of-page header — title, optional description, breadcrumbs, back button,
+ * and actions slot. The first thing a user sees on any list / detail / form
+ * page in a dashboard.
+ *
+ * Designed to drop directly into `<DashboardContent>` (or any padded page
+ * container). Has no outer padding of its own — the surrounding layout owns
+ * spacing.
+ *
+ * @example List page header with primary action
+ * ```tsx
+ * <PageHeader
+ *   title="Users"
+ *   description="Manage your team members and their roles."
+ *   actions={<Button onClick={openCreate}>Add user</Button>}
+ *   bordered
+ * />
+ * ```
+ *
+ * @example Detail page header with back button
+ * ```tsx
+ * <PageHeader
+ *   title={user.name}
+ *   description={user.email}
+ *   back={{
+ *     label: 'Users',
+ *     to: '/users',
+ *   }}
+ *   actions={
+ *     <>
+ *       <Button variant="outline">Edit</Button>
+ *       <Button variant="destructive">Delete</Button>
+ *     </>
+ *   }
+ * />
+ * ```
+ *
+ * @example With breadcrumbs slot
+ * ```tsx
+ * <PageHeader
+ *   breadcrumbs={
+ *     <nav aria-label="Breadcrumb">
+ *       <ol className="flex items-center gap-1">
+ *         <li><Link to="/">Home</Link></li>
+ *         <li>/</li>
+ *         <li>Users</li>
+ *       </ol>
+ *     </nav>
+ *   }
+ *   title="Users"
+ * />
+ * ```
+ */
+declare const PageHeader: react.ForwardRefExoticComponent<PageHeaderProps & react.RefAttributes<HTMLElement>>;
+
+declare const pageHeaderBaseClass = "flex w-full flex-col gap-3";
+/** Adds a bottom border separator below the header. */
+declare const pageHeaderBorderedClass = "border-b border-border pb-4";
+declare const pageHeaderTitleRowClass = "flex flex-wrap items-start justify-between gap-3 sm:gap-4";
+declare const pageHeaderTitleBlockClass = "min-w-0 flex-1 space-y-1";
+declare const pageHeaderTitleClass = "text-2xl font-semibold tracking-tight text-foreground";
+declare const pageHeaderDescriptionClass = "text-sm text-muted-foreground";
+declare const pageHeaderActionsClass = "flex shrink-0 flex-wrap items-center gap-2";
+declare const pageHeaderBackClass = "inline-flex items-center gap-1.5 self-start text-sm text-muted-foreground transition-colors hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring/40 focus-visible:ring-offset-2 focus-visible:ring-offset-background rounded-md";
+declare const pageHeaderBackIconClass = "size-4 shrink-0 rtl:rotate-180";
+declare const pageHeaderBreadcrumbsClass = "text-xs text-muted-foreground";
+
+interface DetailPageNotFoundState {
+    icon?: ReactNode;
+    title?: ReactNode;
+    description?: ReactNode;
+    /** Override the action slot. Pass `null` to hide it (no default action). */
+    action?: ReactNode | null;
+}
+interface DetailPageLabels {
+    notFoundTitle?: string;
+    notFoundDescription?: string;
+}
+interface DetailPageProps {
+    /** Page title (required). Typically the resource name (e.g. "User · Layla Hassan"). */
+    title: ReactNode;
+    /** Optional secondary text under the title (e.g. status pill, joined date). */
+    description?: ReactNode;
+    /** Optional back-button config — forwarded straight to `PageHeader.back`. */
+    back?: PageHeaderBackProps;
+    /** Header action slot — Edit / Archive / Delete buttons. */
+    actions?: ReactNode;
+    /** Page-header bottom border separator. Defaults to `true` for detail pages. */
+    bordered?: boolean;
+    /**
+     * Show skeleton placeholders in the body while the record is being fetched.
+     * Wins over `notFound` so users don't see a flicker of "not found" before
+     * the data resolves.
+     */
+    isLoading?: boolean;
+    /** Number of skeleton rows shown while loading. Defaults to `6`. */
+    loadingRowCount?: number;
+    /**
+     * Render the "not found" empty state instead of `children`. Use when the
+     * query resolved successfully but the requested record does not exist
+     * (404-style). Ignored while `isLoading` is true.
+     */
+    notFound?: boolean;
+    /** Customize the not-found surface. Defaults to a `FileQuestion` icon + label-driven copy. */
+    notFoundState?: DetailPageNotFoundState;
+    /** Localized copy for the default not-found prompt. */
+    labels?: DetailPageLabels;
+    /** Body content — typically a stack of `<section>` cards / DescriptionList rows. */
+    children: ReactNode;
+    /** Class applied to the outer wrapper. */
+    className?: string;
+    /** Class applied to the body container. */
+    bodyClassName?: string;
+}
+/**
+ * Declarative detail-page template — composes `PageHeader` + a body that
+ * renders one of three branches:
+ *
+ * 1. **`isLoading`** → skeleton rows (wins over everything else).
+ * 2. **`notFound`** → `<EmptyState>` with a `FileQuestion` icon.
+ * 3. otherwise → `children` (consumer composes their own sections / cards).
+ *
+ * Pairs with `<ListPage>` (read flow) and `<FormPage>` (write flow) as the
+ * third Phase-4 template. RHF-agnostic — no form integration.
+ *
+ * @example View user
+ * ```tsx
+ * const { data: user, isLoading } = useUser(id);
+ *
+ * return (
+ *   <DetailPage
+ *     title={user ? `${user.name}` : 'Loading…'}
+ *     description={user?.role}
+ *     back={{ to: '/users' }}
+ *     actions={
+ *       <>
+ *         <Button variant="outline" onClick={onArchive}>Archive</Button>
+ *         <Button onClick={onEdit}>Edit</Button>
+ *       </>
+ *     }
+ *     isLoading={isLoading}
+ *     notFound={!isLoading && !user}
+ *   >
+ *     {user && (
+ *       <section className="grid gap-4 md:grid-cols-2">…</section>
+ *     )}
+ *   </DetailPage>
+ * );
+ * ```
+ *
+ * @example Custom not-found
+ * ```tsx
+ * <DetailPage
+ *   title="Order"
+ *   notFound={!order}
+ *   notFoundState={{
+ *     title: 'Order does not exist',
+ *     description: 'It may have been cancelled.',
+ *     action: <Button onClick={() => navigate('/orders')}>Back to orders</Button>,
+ *   }}
+ * >
+ *   …
+ * </DetailPage>
+ * ```
+ */
+declare function DetailPage({ title, description, back, actions, bordered, isLoading, loadingRowCount, notFound, notFoundState, labels: labelsProp, children, className, bodyClassName, }: DetailPageProps): react_jsx_runtime.JSX.Element;
+
+/** Outermost wrapper of `DetailPage` — vertical flex column with consistent spacing. */
+declare const detailPageBaseClass = "flex w-full flex-col gap-6";
+/** Body region that wraps either children, the skeleton, or the not-found state. */
+declare const detailPageBodyClass = "flex flex-col gap-6";
+/**
+ * Single skeleton row rendered while `isLoading` is true. Tuned to a
+ * description-list cell — short width range, comfortable height.
+ */
+declare const detailPageSkeletonRowClass = "h-5 w-full animate-pulse rounded-md bg-muted";
+/** Container around the not-found `<EmptyState>` — matches the ListPage empty surface. */
+declare const detailPageEmptyClass = "rounded-md border border-border bg-card";
+
+/**
+ * Modal dialog built on `@radix-ui/react-dialog`. Compound API — same shape as
+ * `DropdownMenu`. Use for edit/create in-modal flows, confirmations, and any
+ * blocking interaction. For destructive confirms specifically, the
+ * `AlertDialog` (Phase 2) layer will sit on top of this primitive later.
+ *
+ * @example Edit-in-modal
+ * ```tsx
+ * <Dialog>
+ *   <DialogTrigger asChild>
+ *     <Button variant="outline">Edit user</Button>
+ *   </DialogTrigger>
+ *   <DialogContent>
+ *     <DialogHeader>
+ *       <DialogTitle>Edit user</DialogTitle>
+ *       <DialogDescription>Update the user's profile.</DialogDescription>
+ *     </DialogHeader>
+ *     <form onSubmit={handleSubmit}>
+ *       <Field name="name" label="Name"><Input /></Field>
+ *     </form>
+ *     <DialogFooter>
+ *       <DialogClose asChild>
+ *         <Button variant="outline">Cancel</Button>
+ *       </DialogClose>
+ *       <Button type="submit">Save</Button>
+ *     </DialogFooter>
+ *   </DialogContent>
+ * </Dialog>
+ * ```
+ *
+ * @example Controlled state
+ * ```tsx
+ * const [open, setOpen] = useState(false);
+ *
+ * <Dialog open={open} onOpenChange={setOpen}>
+ *   <DialogContent>…</DialogContent>
+ * </Dialog>
+ * ```
+ */
+declare const Dialog: react.FC<RadixDialog.DialogProps>;
+declare const DialogTrigger: react.ForwardRefExoticComponent<RadixDialog.DialogTriggerProps & react.RefAttributes<HTMLButtonElement>>;
+declare const DialogPortal: react.FC<RadixDialog.DialogPortalProps>;
+/** Use inside `DialogFooter` to wire a custom Cancel/Close button. */
+declare const DialogClose: react.ForwardRefExoticComponent<RadixDialog.DialogCloseProps & react.RefAttributes<HTMLButtonElement>>;
+interface DialogOverlayProps extends ComponentPropsWithoutRef<typeof RadixDialog.Overlay> {
+}
+declare const DialogOverlay: react.ForwardRefExoticComponent<DialogOverlayProps & react.RefAttributes<HTMLDivElement>>;
+interface DialogContentProps extends ComponentPropsWithoutRef<typeof RadixDialog.Content> {
+    /** Render the default × close button at the top-end of the panel. Default `true`. */
+    showCloseButton?: boolean;
+    /** Accessible label for the default close button. Default `'Close'`. */
+    closeLabel?: string;
+}
+declare const DialogContent: react.ForwardRefExoticComponent<DialogContentProps & react.RefAttributes<HTMLDivElement>>;
+interface DialogHeaderProps extends HTMLAttributes<HTMLDivElement> {
+    children: ReactNode;
+}
+declare function DialogHeader({ className, ...props }: DialogHeaderProps): react_jsx_runtime.JSX.Element;
+interface DialogFooterProps extends HTMLAttributes<HTMLDivElement> {
+    children: ReactNode;
+}
+declare function DialogFooter({ className, ...props }: DialogFooterProps): react_jsx_runtime.JSX.Element;
+interface DialogTitleProps extends ComponentPropsWithoutRef<typeof RadixDialog.Title> {
+}
+declare const DialogTitle: react.ForwardRefExoticComponent<DialogTitleProps & react.RefAttributes<HTMLHeadingElement>>;
+interface DialogDescriptionProps extends ComponentPropsWithoutRef<typeof RadixDialog.Description> {
+}
+declare const DialogDescription: react.ForwardRefExoticComponent<DialogDescriptionProps & react.RefAttributes<HTMLParagraphElement>>;
+
+/** Backdrop overlay rendered behind the dialog content. Fades in/out. */
+declare const dialogOverlayClass = "fixed inset-0 z-50 bg-foreground/40 backdrop-blur-sm data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0";
+/**
+ * Centered content panel. Caps width at `lg` by default — consumers wanting a
+ * wider/narrower dialog override via `className`. Zoom + fade animation matches
+ * the rest of the kit's overlays (Select, DropdownMenu).
+ */
+declare const dialogContentClass = "fixed start-1/2 top-1/2 z-50 grid w-full max-w-lg -translate-x-1/2 -translate-y-1/2 gap-4 rounded-lg border border-border bg-background p-6 text-foreground shadow-lg outline-none rtl:translate-x-1/2 data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95";
+/** Title + description grouping above the body. */
+declare const dialogHeaderClass = "flex flex-col gap-1.5 text-start";
+/** Dialog title — rendered as the heading and used for aria-labelledby. */
+declare const dialogTitleClass = "text-lg font-semibold text-foreground";
+/** Secondary text linked to the dialog via aria-describedby. */
+declare const dialogDescriptionClass = "text-sm text-muted-foreground";
+/** Action row at the bottom. Reverses on small screens so primary stays on top. */
+declare const dialogFooterClass = "flex flex-col-reverse gap-2 sm:flex-row sm:items-center sm:justify-end";
+/** Small × button rendered at the top-end of the content panel. */
+declare const dialogCloseButtonClass = "absolute end-4 top-4 inline-flex size-7 items-center justify-center rounded-sm text-muted-foreground transition-colors hover:bg-accent hover:text-accent-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring/40 disabled:pointer-events-none";
+
 type DropdownMenuItemVariant = 'default' | 'destructive';
 declare const dropdownMenuContentClass = "z-50 min-w-32 overflow-hidden rounded-md border border-border bg-popover p-1 text-popover-foreground shadow-md data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95";
 declare const dropdownMenuItemBaseClass = "relative flex w-full cursor-pointer select-none items-center gap-2 rounded-sm px-2 py-1.5 text-sm outline-none transition-colors data-[disabled]:pointer-events-none data-[disabled]:opacity-50 [&_svg]:size-4 [&_svg]:shrink-0";
@@ -675,107 +1127,6 @@ type FieldProps<TValues extends FieldValues = FieldValues, TName extends FieldPa
  */
 declare function Field<TValues extends FieldValues = FieldValues, TName extends FieldPath<TValues> = FieldPath<TValues>>(props: FieldProps<TValues, TName>): ReactElement;
 
-type PageHeaderHeadingLevel = 'h1' | 'h2' | 'h3' | 'h4';
-/** Props passed to the routing-library `render` slot of the back button. */
-interface PageHeaderBackRenderProps {
-    to?: LinkProps['to'];
-    className?: string;
-    children: ReactNode;
-    onClick?: () => void;
-}
-interface PageHeaderBackProps {
-    /** Visible label next to the arrow. Defaults to `"Back"`. */
-    label?: ReactNode;
-    /** Target to — renders a React Router `<Link>`. */
-    to?: LinkProps['to'];
-    /** Click handler — renders a `<button>` (or wraps the `render` element). */
-    onClick?: () => void;
-    /** Routing-library render prop (e.g. wrap a different link component). Wins over `to`. */
-    render?: (props: PageHeaderBackRenderProps) => ReactElement;
-}
-interface PageHeaderProps extends Omit<HTMLAttributes<HTMLElement>, 'title'> {
-    /** Page title (required). */
-    title: ReactNode;
-    /** Optional secondary text under the title. */
-    description?: ReactNode;
-    /** Slot above the title for breadcrumbs (e.g. `<Breadcrumbs items={…} />` or your own JSX). */
-    breadcrumbs?: ReactNode;
-    /** Optional back button rendered above the title row. */
-    back?: PageHeaderBackProps;
-    /** Slot on the trailing side of the title row — buttons, dropdowns, etc. */
-    actions?: ReactNode;
-    /** Heading level for the title element. Defaults to `'h1'`. */
-    as?: PageHeaderHeadingLevel;
-    /** Add a bottom border separator. Default: `false`. */
-    bordered?: boolean;
-}
-/**
- * Top-of-page header — title, optional description, breadcrumbs, back button,
- * and actions slot. The first thing a user sees on any list / detail / form
- * page in a dashboard.
- *
- * Designed to drop directly into `<DashboardContent>` (or any padded page
- * container). Has no outer padding of its own — the surrounding layout owns
- * spacing.
- *
- * @example List page header with primary action
- * ```tsx
- * <PageHeader
- *   title="Users"
- *   description="Manage your team members and their roles."
- *   actions={<Button onClick={openCreate}>Add user</Button>}
- *   bordered
- * />
- * ```
- *
- * @example Detail page header with back button
- * ```tsx
- * <PageHeader
- *   title={user.name}
- *   description={user.email}
- *   back={{
- *     label: 'Users',
- *     to: '/users',
- *   }}
- *   actions={
- *     <>
- *       <Button variant="outline">Edit</Button>
- *       <Button variant="destructive">Delete</Button>
- *     </>
- *   }
- * />
- * ```
- *
- * @example With breadcrumbs slot
- * ```tsx
- * <PageHeader
- *   breadcrumbs={
- *     <nav aria-label="Breadcrumb">
- *       <ol className="flex items-center gap-1">
- *         <li><Link to="/">Home</Link></li>
- *         <li>/</li>
- *         <li>Users</li>
- *       </ol>
- *     </nav>
- *   }
- *   title="Users"
- * />
- * ```
- */
-declare const PageHeader: react.ForwardRefExoticComponent<PageHeaderProps & react.RefAttributes<HTMLElement>>;
-
-declare const pageHeaderBaseClass = "flex w-full flex-col gap-3";
-/** Adds a bottom border separator below the header. */
-declare const pageHeaderBorderedClass = "border-b border-border pb-4";
-declare const pageHeaderTitleRowClass = "flex flex-wrap items-start justify-between gap-3 sm:gap-4";
-declare const pageHeaderTitleBlockClass = "min-w-0 flex-1 space-y-1";
-declare const pageHeaderTitleClass = "text-2xl font-semibold tracking-tight text-foreground";
-declare const pageHeaderDescriptionClass = "text-sm text-muted-foreground";
-declare const pageHeaderActionsClass = "flex shrink-0 flex-wrap items-center gap-2";
-declare const pageHeaderBackClass = "inline-flex items-center gap-1.5 self-start text-sm text-muted-foreground transition-colors hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring/40 focus-visible:ring-offset-2 focus-visible:ring-offset-background rounded-md";
-declare const pageHeaderBackIconClass = "size-4 shrink-0 rtl:rotate-180";
-declare const pageHeaderBreadcrumbsClass = "text-xs text-muted-foreground";
-
 interface FormPageProps {
     /** Page title (required). Rendered as an `<h1>` by `PageHeader`. */
     title: ReactNode;
@@ -1549,9 +1900,161 @@ interface TextareaProps extends Omit<TextareaHTMLAttributes<HTMLTextAreaElement>
  */
 declare const Textarea: react.ForwardRefExoticComponent<TextareaProps & react.RefAttributes<HTMLTextAreaElement>>;
 
+interface ToasterProps extends ToasterProps$1 {
+}
+/**
+ * Toast host. Render **once** at the app root (typically inside or next to
+ * `<AppShell>`) — every subsequent call to `toast(...)` from anywhere in the
+ * tree pops a notification through this single host. Built on
+ * [`sonner`](https://sonner.emilkowal.ski).
+ *
+ * Defaults tuned for dashboards:
+ * - `position` flips with `<html dir>`: bottom-right in LTR, bottom-left in RTL.
+ * - `richColors` enabled so success / error / warning / info pick up the kit's
+ *   feedback tokens automatically.
+ * - `closeButton` enabled so users can dismiss without waiting for the timer.
+ * - `duration` 4 s (sonner default). Override per-call via `toast(msg, { duration })`.
+ *
+ * Override any of the above via props — the wrapper is a thin pass-through.
+ *
+ * @example Mount at the app root
+ * ```tsx
+ * import { AppShell, Toaster, toast } from '@dimaan/ui';
+ *
+ * function App() {
+ *   return (
+ *     <AppShell brand={…} nav={…}>
+ *       <Routes>…</Routes>
+ *       <Toaster />
+ *     </AppShell>
+ *   );
+ * }
+ * ```
+ *
+ * @example Fire toasts from anywhere
+ * ```tsx
+ * import { toast } from '@dimaan/ui';
+ *
+ * toast.success('Saved');
+ * toast.error('Failed to save', { description: 'Try again.' });
+ * toast.promise(saveUser(), {
+ *   loading: 'Saving…',
+ *   success: 'Saved',
+ *   error: 'Failed to save',
+ * });
+ * ```
+ */
+declare function Toaster(props: ToasterProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Tailwind class names mapped onto sonner's `toastOptions.classNames` slots.
+ * Every entry uses our design tokens so toasts pick up the kit's theme
+ * automatically.
+ */
+declare const toastClassNames: {
+    toast: string;
+    title: string;
+    description: string;
+    actionButton: string;
+    cancelButton: string;
+    closeButton: string;
+    icon: string;
+    content: string;
+    success: string;
+    error: string;
+    warning: string;
+    info: string;
+};
+
+interface TooltipProviderProps extends ComponentPropsWithoutRef<typeof RadixTooltip.Provider> {
+}
+/**
+ * App-level provider that coordinates show / hide delays across every
+ * `<Tooltip>` in the tree. Mount **once** at the app root — typically next to
+ * `<Toaster />` and `<ConfirmDialogProvider>`. Without it, individual
+ * `<Tooltip>` calls fall back to Radix's per-instance defaults.
+ *
+ * Defaults tuned for dashboards:
+ * - `delayDuration` 200 ms — fast enough to feel snappy on icon buttons but
+ *   slow enough to avoid the "rapid-cursor flash" effect when sweeping past.
+ * - `skipDelayDuration` 300 ms — once one tooltip has shown, neighbouring
+ *   tooltips open instantly until the user pauses for ≥300 ms.
+ *
+ * @example Mount once
+ * ```tsx
+ * <AppShell brand={…} nav={…}>
+ *   <TooltipProvider>
+ *     <Routes>…</Routes>
+ *   </TooltipProvider>
+ *   <Toaster />
+ * </AppShell>
+ * ```
+ */
+declare function TooltipProvider({ delayDuration, skipDelayDuration, ...props }: TooltipProviderProps): react_jsx_runtime.JSX.Element;
+interface TooltipProps {
+    /** Tooltip text or rich content. When falsy the tooltip is skipped entirely. */
+    content: ReactNode;
+    /** The trigger element (button / icon button / link). Rendered via `asChild`. */
+    children: ReactElement;
+    /** Side relative to the trigger. RTL flips automatically via the global DirectionProvider. */
+    side?: 'top' | 'bottom' | 'left' | 'right';
+    /** Alignment along the side axis. */
+    align?: 'start' | 'center' | 'end';
+    /** Override the provider-level show delay (ms). */
+    delayDuration?: number;
+    /** Opt-out — render the children but never show a tooltip. */
+    disabled?: boolean;
+    /** Controlled open state. */
+    open?: boolean;
+    /** Uncontrolled initial open state. */
+    defaultOpen?: boolean;
+    /** Fired when the open state changes. */
+    onOpenChange?: (open: boolean) => void;
+    /** Class applied to the content panel. */
+    className?: string;
+    /** Offset in pixels between the trigger and the panel. Defaults to `6`. */
+    sideOffset?: number;
+}
+/**
+ * Single-line wrapper that adds a hover / focus tooltip to its child. For the
+ * 80% case (icon buttons, truncated labels, "what does this mean?" affordances)
+ * — drop in a `<Tooltip>` and forget it.
+ *
+ * Hover, focus, long-press (touch), and keyboard navigation all open it; mouse
+ * leave, blur, Escape, and the matching trigger event close it. The child must
+ * be a single React element that forwards refs / props (any of our kit's
+ * components do).
+ *
+ * @example Icon button
+ * ```tsx
+ * <Tooltip content="Edit user">
+ *   <Button variant="ghost" size="icon" aria-label="Edit user">
+ *     <Pencil />
+ *   </Button>
+ * </Tooltip>
+ * ```
+ *
+ * @example Skip the tooltip dynamically
+ * ```tsx
+ * <Tooltip content="Cannot delete a system user" disabled={!user.isSystem}>
+ *   <Button onClick={onDelete}>Delete</Button>
+ * </Tooltip>
+ * ```
+ */
+declare function Tooltip({ content, children, side, align, delayDuration, disabled, open, defaultOpen, onOpenChange, className, sideOffset, }: TooltipProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Tooltip content panel. Small dark-ish surface with a subtle shadow and
+ * the same zoom/fade animation as the rest of the kit's overlays
+ * (Select, DropdownMenu, Dialog).
+ */
+declare const tooltipContentClass = "z-50 max-w-xs rounded-md bg-foreground px-2.5 py-1.5 text-xs font-medium text-background shadow-md data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95";
+/** Optional arrow that matches the panel surface. */
+declare const tooltipArrowClass = "fill-foreground";
+
 type Direction = 'ltr' | 'rtl';
 declare function useDirection(): Direction;
 
 declare function cn(...inputs: ClassValue[]): string;
 
-export { AppShell, type AppShellBrand, type AppShellNavGroup, type AppShellNavItem, type AppShellProps, Avatar, type AvatarProps, Badge, type BadgeProps, type BadgeSize, type BadgeVariant, Button, type ButtonProps, type ButtonSize, type ButtonVariant, Checkbox, type CheckboxProps, type CheckboxSize, type Column, type ColumnAlign, DashboardContent, type DashboardContentProps, DashboardHeader, type DashboardHeaderProps, DashboardLayout, type DashboardLayoutContextValue, type DashboardLayoutProps, DashboardMain, type DashboardMainProps, DatePicker, type DatePickerProps, type DatePickerSize, type DatePickerVariant, type Direction, DropdownMenu, DropdownMenuContent, type DropdownMenuContentProps, DropdownMenuGroup, DropdownMenuItem, type DropdownMenuItemProps, type DropdownMenuItemVariant, DropdownMenuLabel, type DropdownMenuLabelProps, DropdownMenuPortal, DropdownMenuSeparator, type DropdownMenuSeparatorProps, DropdownMenuShortcut, type DropdownMenuShortcutProps, DropdownMenuTrigger, EmptyState, type EmptyStateProps, type EmptyStateSize, Field, type FieldOrientation, type FieldProps, type FieldRHFProps, FormPage, type FormPageProps, HeaderActions, type HeaderActionsProps, HeaderCollapseTrigger, type HeaderCollapseTriggerProps, HeaderMobileTrigger, type HeaderMobileTriggerProps, HeaderSearch, type HeaderSearchProps, HeaderTitle, type HeaderTitleProps, Input, type InputProps, type InputSize, type InputVariant, type LanguageOption, LanguageSwitcher, type LanguageSwitcherProps, ListPage, type ListPageEmptyState, type ListPageFilter, type ListPageLabels, type ListPageProps, PageHeader, type PageHeaderBackProps, type PageHeaderBackRenderProps, type PageHeaderHeadingLevel, type PageHeaderProps, type PaginationState, RadioGroup, RadioGroupItem, type RadioGroupOption, type RadioGroupOrientation, type RadioGroupProps, type RadioGroupSize, type RowSelectionState, Select, type SelectOption, type SelectProps, type SelectSize, type SelectVariant, Sidebar, SidebarFooter, type SidebarFooterProps, SidebarGroup, type SidebarGroupProps, SidebarHeader, type SidebarHeaderProps, SidebarNav, SidebarNavGroup, type SidebarNavGroupProps, SidebarNavItem, type SidebarNavItemProps, type SidebarNavItemRenderProps, type SidebarNavProps, type SidebarProps, type SortDirection, type SortState, type SortableValue, Switch, type SwitchProps, type SwitchSize, Table, type TableProps, type TableSize, type TableSizeClasses, Textarea, type TextareaProps, type TextareaResize, type TextareaSize, type TextareaVariant, badgeBaseClass, badgeDotSizeClass, badgeSizeClass, badgeVariantClass, buttonBaseClass, buttonSizeClass, buttonVariantClass, cn, datePickerCalendarClass, datePickerCaptionClass, datePickerContentClass, datePickerDayBaseClass, datePickerDayWrapperClass, datePickerDisabledClass, datePickerMonthClass, datePickerMonthGridClass, datePickerMonthsClass, datePickerNavButtonClass, datePickerNavClass, datePickerOutsideClass, datePickerPlaceholderClass, datePickerSelectedClass, datePickerTodayClass, datePickerTriggerBaseClass, datePickerTriggerSizeClass, datePickerTriggerVariantClass, datePickerValueClass, datePickerWeekClass, datePickerWeekdayClass, datePickerWeekdaysClass, dropdownMenuContentClass, dropdownMenuItemBaseClass, dropdownMenuItemInsetClass, dropdownMenuItemVariantClass, dropdownMenuLabelClass, dropdownMenuSeparatorClass, dropdownMenuShortcutClass, emptyStateActionsSpacingClass, emptyStateBaseClass, emptyStateContainerSizeClass, emptyStateDescriptionSizeClass, emptyStateIconWrapperBaseClass, emptyStateIconWrapperSizeClass, emptyStateTitleSizeClass, formPageActionsBarClass, formPageBaseClass, formPageBodyClass, formPageSkeletonRowClass, inputBaseClass, inputSizeClass, inputVariantClass, pageHeaderActionsClass, pageHeaderBackClass, pageHeaderBackIconClass, pageHeaderBaseClass, pageHeaderBorderedClass, pageHeaderBreadcrumbsClass, pageHeaderDescriptionClass, pageHeaderTitleBlockClass, pageHeaderTitleClass, pageHeaderTitleRowClass, radioGroupBaseClass, radioGroupOrientationClass, radioIndicatorBaseClass, radioIndicatorDotClass, radioIndicatorSizeClass, radioItemBaseClass, radioItemSizeClass, radioLabelSizeClass, radioOptionRowClass, selectBaseClass, selectSizeClass, selectVariantClass, switchThumbBaseClass, switchThumbClass, switchTrackBaseClass, switchTrackClass, alignClass as tableAlignClass, tableBaseClass, selectedRowClass as tableSelectedRowClass, tableSizeClass, sortIconClass as tableSortIconClass, textareaBaseClass, textareaResizeClass, textareaSizeClass, textareaVariantClass, useDashboardLayout, useDirection };
+export { AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, type AlertDialogContentProps, AlertDialogDescription, type AlertDialogDescriptionProps, AlertDialogFooter, type AlertDialogFooterProps, AlertDialogHeader, type AlertDialogHeaderProps, AlertDialogOverlay, type AlertDialogOverlayProps, AlertDialogPortal, AlertDialogTitle, type AlertDialogTitleProps, AlertDialogTrigger, AppShell, type AppShellBrand, type AppShellNavGroup, type AppShellNavItem, type AppShellProps, Avatar, type AvatarProps, Badge, type BadgeProps, type BadgeSize, type BadgeVariant, Button, type ButtonProps, type ButtonSize, type ButtonVariant, Checkbox, type CheckboxProps, type CheckboxSize, type Column, type ColumnAlign, type ConfirmDialogLabels, ConfirmDialogProvider, type ConfirmDialogProviderProps, type ConfirmOptions, DashboardContent, type DashboardContentProps, DashboardHeader, type DashboardHeaderProps, DashboardLayout, type DashboardLayoutContextValue, type DashboardLayoutProps, DashboardMain, type DashboardMainProps, DatePicker, type DatePickerProps, type DatePickerSize, type DatePickerVariant, DetailPage, type DetailPageLabels, type DetailPageNotFoundState, type DetailPageProps, Dialog, DialogClose, DialogContent, type DialogContentProps, DialogDescription, type DialogDescriptionProps, DialogFooter, type DialogFooterProps, DialogHeader, type DialogHeaderProps, DialogOverlay, type DialogOverlayProps, DialogPortal, DialogTitle, type DialogTitleProps, DialogTrigger, type Direction, DropdownMenu, DropdownMenuContent, type DropdownMenuContentProps, DropdownMenuGroup, DropdownMenuItem, type DropdownMenuItemProps, type DropdownMenuItemVariant, DropdownMenuLabel, type DropdownMenuLabelProps, DropdownMenuPortal, DropdownMenuSeparator, type DropdownMenuSeparatorProps, DropdownMenuShortcut, type DropdownMenuShortcutProps, DropdownMenuTrigger, EmptyState, type EmptyStateProps, type EmptyStateSize, Field, type FieldOrientation, type FieldProps, type FieldRHFProps, FormPage, type FormPageProps, HeaderActions, type HeaderActionsProps, HeaderCollapseTrigger, type HeaderCollapseTriggerProps, HeaderMobileTrigger, type HeaderMobileTriggerProps, HeaderSearch, type HeaderSearchProps, HeaderTitle, type HeaderTitleProps, Input, type InputProps, type InputSize, type InputVariant, type LanguageOption, LanguageSwitcher, type LanguageSwitcherProps, ListPage, type ListPageEmptyState, type ListPageFilter, type ListPageLabels, type ListPageProps, PageHeader, type PageHeaderBackProps, type PageHeaderBackRenderProps, type PageHeaderHeadingLevel, type PageHeaderProps, type PaginationState, RadioGroup, RadioGroupItem, type RadioGroupOption, type RadioGroupOrientation, type RadioGroupProps, type RadioGroupSize, type RowSelectionState, Select, type SelectOption, type SelectProps, type SelectSize, type SelectVariant, Sidebar, SidebarFooter, type SidebarFooterProps, SidebarGroup, type SidebarGroupProps, SidebarHeader, type SidebarHeaderProps, SidebarNav, SidebarNavGroup, type SidebarNavGroupProps, SidebarNavItem, type SidebarNavItemProps, type SidebarNavItemRenderProps, type SidebarNavProps, type SidebarProps, type SortDirection, type SortState, type SortableValue, Switch, type SwitchProps, type SwitchSize, Table, type TableProps, type TableSize, type TableSizeClasses, Textarea, type TextareaProps, type TextareaResize, type TextareaSize, type TextareaVariant, Toaster, type ToasterProps, Tooltip, type TooltipProps, TooltipProvider, type TooltipProviderProps, badgeBaseClass, badgeDotSizeClass, badgeSizeClass, badgeVariantClass, buttonBaseClass, buttonSizeClass, buttonVariantClass, cn, datePickerCalendarClass, datePickerCaptionClass, datePickerContentClass, datePickerDayBaseClass, datePickerDayWrapperClass, datePickerDisabledClass, datePickerMonthClass, datePickerMonthGridClass, datePickerMonthsClass, datePickerNavButtonClass, datePickerNavClass, datePickerOutsideClass, datePickerPlaceholderClass, datePickerSelectedClass, datePickerTodayClass, datePickerTriggerBaseClass, datePickerTriggerSizeClass, datePickerTriggerVariantClass, datePickerValueClass, datePickerWeekClass, datePickerWeekdayClass, datePickerWeekdaysClass, detailPageBaseClass, detailPageBodyClass, detailPageEmptyClass, detailPageSkeletonRowClass, dialogCloseButtonClass, dialogContentClass, dialogDescriptionClass, dialogFooterClass, dialogHeaderClass, dialogOverlayClass, dialogTitleClass, dropdownMenuContentClass, dropdownMenuItemBaseClass, dropdownMenuItemInsetClass, dropdownMenuItemVariantClass, dropdownMenuLabelClass, dropdownMenuSeparatorClass, dropdownMenuShortcutClass, emptyStateActionsSpacingClass, emptyStateBaseClass, emptyStateContainerSizeClass, emptyStateDescriptionSizeClass, emptyStateIconWrapperBaseClass, emptyStateIconWrapperSizeClass, emptyStateTitleSizeClass, formPageActionsBarClass, formPageBaseClass, formPageBodyClass, formPageSkeletonRowClass, inputBaseClass, inputSizeClass, inputVariantClass, pageHeaderActionsClass, pageHeaderBackClass, pageHeaderBackIconClass, pageHeaderBaseClass, pageHeaderBorderedClass, pageHeaderBreadcrumbsClass, pageHeaderDescriptionClass, pageHeaderTitleBlockClass, pageHeaderTitleClass, pageHeaderTitleRowClass, radioGroupBaseClass, radioGroupOrientationClass, radioIndicatorBaseClass, radioIndicatorDotClass, radioIndicatorSizeClass, radioItemBaseClass, radioItemSizeClass, radioLabelSizeClass, radioOptionRowClass, selectBaseClass, selectSizeClass, selectVariantClass, switchThumbBaseClass, switchThumbClass, switchTrackBaseClass, switchTrackClass, alignClass as tableAlignClass, tableBaseClass, selectedRowClass as tableSelectedRowClass, tableSizeClass, sortIconClass as tableSortIconClass, textareaBaseClass, textareaResizeClass, textareaSizeClass, textareaVariantClass, toastClassNames, tooltipArrowClass, tooltipContentClass, useConfirm, useDashboardLayout, useDirection };