@dimaan/ui 0.0.13 → 0.0.15

package/dist/index.d.ts

@@ -1,8 +1,9 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as react from 'react';
-import { HTMLAttributes, ReactNode, ButtonHTMLAttributes, ReactElement, InputHTMLAttributes, ChangeEvent, ComponentPropsWithoutRef, FieldsetHTMLAttributes, Ref, TextareaHTMLAttributes } from 'react';
+import { HTMLAttributes, ReactNode, ButtonHTMLAttributes, ReactElement, InputHTMLAttributes, ChangeEvent, ComponentPropsWithoutRef, FormEventHandler, FieldsetHTMLAttributes, Ref, TextareaHTMLAttributes } from 'react';
 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';
@@ -443,6 +444,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,6 +977,107 @@ 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;
 
+interface FormPageProps {
+    /** Page title (required). Rendered as an `<h1>` by `PageHeader`. */
+    title: ReactNode;
+    /** Optional secondary text under the title. */
+    description?: ReactNode;
+    /** Optional back-button config — forwarded straight to `PageHeader.back`. */
+    back?: PageHeaderBackProps;
+    /** Page-header bottom border separator. Defaults to `true` for form pages. */
+    bordered?: boolean;
+    /** Form-submit handler. Wire RHF via `form.handleSubmit(onSave)`. */
+    onSubmit: FormEventHandler<HTMLFormElement>;
+    /**
+     * Show skeleton placeholders in the body while the initial record is being
+     * fetched (typical for the edit page). The action bar still renders so the
+     * consumer can offer a "Cancel" exit; the consumer is responsible for
+     * disabling submit buttons while loading.
+     */
+    isLoading?: boolean;
+    /** Number of skeleton rows shown while loading. Defaults to `6`. */
+    loadingRowCount?: number;
+    /**
+     * Action slot rendered inside a sticky bar at the bottom of the form
+     * (Cancel / Save / Save & continue, …). Pass `null` to hide the bar
+     * entirely (rare — usually you want at least a save button).
+     */
+    actions: ReactNode;
+    /** Form body. Compose `<Field>` + your chosen controls, grouped however you like. */
+    children: ReactNode;
+    /** Class applied to the outer wrapper. */
+    className?: string;
+    /** Class applied to the `<form>` element. */
+    formClassName?: string;
+    /** Class applied to the body container that wraps `children`. */
+    bodyClassName?: string;
+    /** Class applied to the sticky action bar. */
+    actionsClassName?: string;
+}
+/**
+ * Declarative form-page template — composes `PageHeader` + a scrollable form
+ * body + a sticky action bar into a single component. **RHF-agnostic**:
+ * `onSubmit` is a plain event handler, so consumers wire react-hook-form (or
+ * any other library) by passing `form.handleSubmit(onSave)`.
+ *
+ * The component expects its parent to provide the scroll context — in the
+ * default `<AppShell>` setup, that's `<DashboardContent>`. The sticky bar
+ * relies on `position: sticky` against that scroll container.
+ *
+ * @example Inside a `<FormProvider>` (RHF + Zod)
+ * ```tsx
+ * const form = useForm<UserDraft>({ resolver: zodResolver(schema), defaultValues });
+ *
+ * return (
+ *   <FormProvider {...form}>
+ *     <FormPage
+ *       title="New user"
+ *       description="Invite a teammate to your workspace."
+ *       back={{ to: '/users' }}
+ *       onSubmit={form.handleSubmit(onSave)}
+ *       actions={
+ *         <>
+ *           <Button type="button" variant="outline" onClick={() => navigate(-1)}>
+ *             Cancel
+ *           </Button>
+ *           <Button type="submit" disabled={form.formState.isSubmitting}>
+ *             Save
+ *           </Button>
+ *         </>
+ *       }
+ *     >
+ *       <div className="grid gap-4 md:grid-cols-2">
+ *         <Field name="name" label="Full name" required><Input /></Field>
+ *         <Field name="email" label="Email" required><Input type="email" /></Field>
+ *       </div>
+ *     </FormPage>
+ *   </FormProvider>
+ * );
+ * ```
+ *
+ * @example Edit mode with `isLoading`
+ * ```tsx
+ * <FormPage title="Edit user" isLoading={query.isLoading} onSubmit={…} actions={…}>
+ *   {…fields…}
+ * </FormPage>
+ * ```
+ */
+declare function FormPage({ title, description, back, bordered, onSubmit, isLoading, loadingRowCount, actions, children, className, formClassName, bodyClassName, actionsClassName, }: FormPageProps): react_jsx_runtime.JSX.Element;
+
+/** Outermost wrapper of `FormPage` — vertical flex column that fills its parent. */
+declare const formPageBaseClass = "flex w-full flex-col gap-6";
+/** Scrollable body region between the header and the sticky action bar. */
+declare const formPageBodyClass = "flex-1";
+/**
+ * Sticky action bar at the bottom of the form. Sits on a `bg-background`
+ * surface with a top border so it visually separates from the form body when
+ * the consumer scrolls. The parent (typically `<DashboardContent>`) is
+ * expected to be the scroll container.
+ */
+declare const formPageActionsBarClass = "sticky bottom-0 -mx-6 -mb-6 mt-6 flex items-center justify-end gap-2 border-t border-border bg-background/95 px-6 py-3 backdrop-blur supports-[backdrop-filter]:bg-background/80";
+/** One skeleton row rendered while `isLoading` is true. */
+declare const formPageSkeletonRowClass = "h-10 w-full animate-pulse rounded-md bg-muted";
+
 type DashboardHeaderProps = HTMLAttributes<HTMLElement>;
 declare function DashboardHeader({ className, children, ...props }: DashboardHeaderProps): react_jsx_runtime.JSX.Element;
 
@@ -1113,107 +1516,6 @@ interface ListPageProps<T> {
  */
 declare function ListPage<T>({ title, description, bordered, actions, data, columns, getRowId, isLoading, loadingRowCount, searchKeys, filters, enableRowSelection, bulkActions, emptyState, noDataState, labels: labelsProp, className, }: ListPageProps<T>): react_jsx_runtime.JSX.Element;
 
-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";
-
 type RadioGroupSize = 'sm' | 'md' | 'lg';
 /** Outer circle (radio button itself) — sized + bordered. */
 declare const radioItemSizeClass: Record<RadioGroupSize, string>;
@@ -1453,4 +1755,4 @@ 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, 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, 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 { 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, 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, 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, useDashboardLayout, useDirection };