@dimaan/ui 0.0.12 → 0.0.14

package/dist/index.d.ts

@@ -1,7 +1,8 @@
 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 RadixDropdown from '@radix-ui/react-dropdown-menu';
 import { FieldValues, FieldPath, Control } from 'react-hook-form';
 import * as RadixRadioGroup from '@radix-ui/react-radio-group';
@@ -296,6 +297,152 @@ interface CheckboxProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'typ
 }
 declare const Checkbox: react.ForwardRefExoticComponent<CheckboxProps & react.RefAttributes<HTMLInputElement>>;
 
+type DatePickerVariant = 'default' | 'filled' | 'ghost';
+type DatePickerSize = 'sm' | 'md' | 'lg';
+declare const datePickerTriggerVariantClass: Record<DatePickerVariant, string>;
+/**
+ * Wider end-padding leaves room for the calendar icon and optional clear button.
+ * Logical properties keep RTL working free.
+ */
+declare const datePickerTriggerSizeClass: Record<DatePickerSize, string>;
+declare const datePickerTriggerBaseClass = "group/datepicker relative inline-flex w-full items-center text-foreground outline-none transition-[background-color,border-color,box-shadow] focus-visible:ring-2 focus-visible:ring-ring/40 focus-visible:ring-offset-1 focus-visible:ring-offset-background aria-[invalid=true]:border-destructive aria-[invalid=true]:focus-visible:ring-destructive/40 disabled:pointer-events-none disabled:opacity-50 cursor-pointer";
+/** Empty-state trigger text (placeholder color). */
+declare const datePickerPlaceholderClass = "truncate text-muted-foreground";
+/** Filled-state trigger text. */
+declare const datePickerValueClass = "truncate text-foreground";
+/** Popover content (the open calendar panel). */
+declare const datePickerContentClass = "z-50 overflow-hidden rounded-md border border-border bg-popover p-3 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";
+/** Wrapper applied to the `<DayPicker>` root via its `className` prop. */
+declare const datePickerCalendarClass = "text-sm";
+/** Month/year caption row. */
+declare const datePickerCaptionClass = "flex items-center justify-between gap-2 pb-2 text-sm font-semibold";
+/** Prev/Next nav buttons. */
+declare const datePickerNavButtonClass = "inline-flex h-7 w-7 items-center justify-center rounded-md border border-input bg-background text-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 disabled:opacity-50";
+/** Day cell wrapper (`td`). */
+declare const datePickerDayWrapperClass = "p-0 text-center";
+/**
+ * Day button — base style for every clickable day. Modifier states (selected,
+ * today, outside-month, disabled) are applied to the wrapping day **cell** by
+ * react-day-picker and target the button via descendant selectors below.
+ */
+declare const datePickerDayBaseClass = "inline-flex h-8 w-8 items-center justify-center rounded-md text-sm text-foreground font-normal transition-colors hover:bg-accent hover:text-accent-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring/40";
+/** Day cell modifier — applied to the currently selected day. Targets the inner button. */
+declare const datePickerSelectedClass = "[&_button]:bg-primary [&_button]:text-primary-foreground [&_button]:hover:bg-primary [&_button]:hover:text-primary-foreground";
+/** Day cell modifier — applied to today. */
+declare const datePickerTodayClass = "[&_button]:font-semibold [&_button]:ring-1 [&_button]:ring-inset [&_button]:ring-ring/40";
+/** Day cell modifier — applied to days from the previous / next month. */
+declare const datePickerOutsideClass = "[&_button]:text-muted-foreground [&_button]:opacity-60";
+/** Day cell modifier — applied to days outside min/max bounds (or custom matcher). */
+declare const datePickerDisabledClass = "[&_button]:pointer-events-none [&_button]:opacity-40";
+/** Weekday header cells. */
+declare const datePickerWeekdayClass = "h-8 w-8 text-center text-xs font-medium text-muted-foreground";
+/** Week row. */
+declare const datePickerWeekClass = "flex w-full";
+/** Weekdays row. */
+declare const datePickerWeekdaysClass = "flex w-full";
+/** Month grid (`table`). */
+declare const datePickerMonthGridClass = "w-full border-collapse";
+/** Months container. */
+declare const datePickerMonthsClass = "flex flex-col gap-3";
+/** Single month wrapper. */
+declare const datePickerMonthClass = "flex flex-col gap-2";
+/** Nav row (wraps prev/next buttons). */
+declare const datePickerNavClass = "flex items-center gap-1";
+
+interface DatePickerProps {
+    variant?: DatePickerVariant;
+    /** Visual size. Named `inputSize` to mirror `Input`'s `inputSize`. */
+    inputSize?: DatePickerSize;
+    /** Controlled ISO `YYYY-MM-DD` value. Pass `''` to clear. */
+    value?: string;
+    /** Uncontrolled initial ISO value. */
+    defaultValue?: string;
+    /** Fires with the new ISO string (or `''` when cleared). */
+    onValueChange?: (value: string) => void;
+    /**
+     * Synthetic-event handler for `react-hook-form`'s `field.onChange`. Both this
+     * and `onValueChange` fire on selection / clearing.
+     */
+    onChange?: (event: ChangeEvent<HTMLInputElement>) => void;
+    /** Called when focus leaves the trigger. */
+    onBlur?: () => void;
+    /** Native form name — rendered as a hidden input so submissions include the value. */
+    name?: string;
+    /** Override id (otherwise auto-generated). */
+    id?: string;
+    /** Disables the trigger and prevents the popover from opening. */
+    disabled?: boolean;
+    /** Marks the underlying value as required (for form validation). */
+    required?: boolean;
+    /** Disable dates strictly before this ISO date. */
+    min?: string;
+    /** Disable dates strictly after this ISO date. */
+    max?: string;
+    /** Placeholder shown when no date is selected. */
+    placeholder?: string;
+    /** Show an × button to clear the selection. Defaults to `true`. */
+    clearable?: boolean;
+    /** Accessible label for the clear button. Defaults to `'Clear date'`. */
+    clearLabel?: string;
+    /**
+     * Locale for calendar month / weekday names. Import from
+     * `react-day-picker/locale` (e.g. `import { arSA } from 'react-day-picker/locale'`).
+     * Defaults to English when omitted.
+     */
+    locale?: Locale;
+    /**
+     * `Intl.DateTimeFormat` options for the trigger display. Defaults to
+     * `{ dateStyle: 'medium' }`.
+     */
+    formatOptions?: Intl.DateTimeFormatOptions;
+    /** Popover side. */
+    side?: 'top' | 'bottom' | 'left' | 'right';
+    /** Popover alignment. */
+    align?: 'start' | 'center' | 'end';
+    'aria-invalid'?: boolean | 'true' | 'false';
+    'aria-describedby'?: string;
+    'aria-label'?: string;
+    /** Class applied to the trigger button. */
+    className?: string;
+    /** Class applied to the popover content (calendar panel). */
+    contentClassName?: string;
+}
+/**
+ * Modern date picker built on `@radix-ui/react-popover` + `react-day-picker`.
+ * Renders a `Select`-shaped trigger button + a calendar popup. **No
+ * label/helperText/error props by design** (ADR-007: Field owns all form
+ * layout). Wrap in `<Field label="…">` for label + helper + error wiring.
+ *
+ * Values are ISO `YYYY-MM-DD` strings — directly compatible with `zod.string().date()`
+ * and native form submission via the optional hidden `<input>` (when `name` is set).
+ *
+ * @example Inside a Field (RHF + Zod)
+ * ```tsx
+ * <Field name="dob" label="Date of birth" required>
+ *   <DatePicker max={todayIso} />
+ * </Field>
+ * ```
+ *
+ * @example Bare with Arabic month names
+ * ```tsx
+ * import { arSA } from 'react-day-picker/locale';
+ *
+ * <DatePicker
+ *   value={from}
+ *   onValueChange={setFrom}
+ *   locale={arSA}
+ *   placeholder="اختر تاريخ"
+ *   aria-label="من تاريخ"
+ * />
+ * ```
+ *
+ * @example Bounded range
+ * ```tsx
+ * <DatePicker min="2026-01-01" max="2026-12-31" />
+ * ```
+ */
+declare const DatePicker: react.ForwardRefExoticComponent<DatePickerProps & react.RefAttributes<HTMLButtonElement>>;
+
 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";
@@ -528,6 +675,208 @@ 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;
+    /** 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;
 
@@ -848,7 +1197,7 @@ interface ListPageEmptyState {
     icon?: ReactNode;
     title?: ReactNode;
     description?: ReactNode;
-    /** Override the default "Reset filters" action button. Pass `null` to hide entirely. */
+    /** Override the default action button. Pass `null` to hide entirely. */
     action?: ReactNode | null;
 }
 interface ListPageLabels {
@@ -858,10 +1207,14 @@ interface ListPageLabels {
     searchAriaLabel?: string;
     /** Default "Reset filters" button label. */
     reset?: string;
-    /** Default empty-state title (when filters return zero). */
+    /** Default "no results matching filters" title. */
     emptyTitle?: string;
-    /** Default empty-state description. */
+    /** Default "no results matching filters" description. */
     emptyDescription?: string;
+    /** Default "no data at all" title (shown when `data` is empty + no filters active). */
+    noDataTitle?: string;
+    /** Default "no data at all" description. */
+    noDataDescription?: string;
 }
 interface ListPageProps<T> {
     title: ReactNode;
@@ -873,12 +1226,28 @@ interface ListPageProps<T> {
     data: T[];
     columns: Column<T>[];
     getRowId: (row: T) => string;
+    /** Show skeleton rows in the table area while data is fetching. */
+    isLoading?: boolean;
+    /** Number of skeleton rows rendered while loading. Defaults to the table page size. */
+    loadingRowCount?: number;
     /** Keys on `T` to search. Search input only renders when this is provided. */
     searchKeys?: Array<keyof T>;
     filters?: ListPageFilter<T>[];
     enableRowSelection?: boolean;
     bulkActions?: (selected: T[]) => ReactNode;
+    /**
+     * Shown when filters/search are active but match zero rows. Falls back to a
+     * "No results — try clearing the search or adjusting the filters" prompt
+     * with a reset button.
+     */
     emptyState?: ListPageEmptyState;
+    /**
+     * Shown when `data` is empty AND no filters/search are active (first-run
+     * state). Falls back to a friendly "No data yet" message with an Inbox
+     * icon. When `actions` is set, you typically want to encourage creation
+     * via this slot's `action`.
+     */
+    noDataState?: ListPageEmptyState;
     labels?: ListPageLabels;
     className?: string;
 }
@@ -891,6 +1260,11 @@ interface ListPageProps<T> {
  * sync, drop down to the underlying primitives directly (see the
  * `RecipeListPage` playground page for the manual composition pattern).
  *
+ * **Three rendering branches in the table area:**
+ * - `isLoading` → Table with skeleton rows (filter bar stays interactive).
+ * - `data` empty AND no filters active → `noDataState` (first-run prompt).
+ * - filters return zero rows → `emptyState` (with a reset action by default).
+ *
  * @example Basic — Users list
  * ```tsx
  * <ListPage
@@ -898,6 +1272,7 @@ interface ListPageProps<T> {
  *   description="Manage your team members."
  *   actions={<Button onClick={openCreate}>Add user</Button>}
  *   data={users}
+ *   isLoading={query.isLoading}
  *   columns={USER_COLUMNS}
  *   getRowId={(u) => u.id}
  *   searchKeys={['name', 'email']}
@@ -915,6 +1290,11 @@ interface ListPageProps<T> {
  *   ]}
  *   enableRowSelection
  *   bulkActions={(rows) => <Button variant="destructive">Delete ({rows.length})</Button>}
+ *   noDataState={{
+ *     title: 'No users yet',
+ *     description: 'Invite your first team member to get started.',
+ *     action: <Button onClick={openCreate}>Add user</Button>,
+ *   }}
  * />
  * ```
  *
@@ -927,112 +1307,13 @@ interface ListPageProps<T> {
  *     reset: 'إعادة الفلاتر',
  *     emptyTitle: 'لا توجد نتائج',
  *     emptyDescription: 'حاول مسح البحث أو تغيير الفلاتر.',
+ *     noDataTitle: 'لا توجد بيانات بعد',
+ *     noDataDescription: 'لم يتم إضافة أي شيء هنا حتى الآن.',
  *   }}
  * />
  * ```
  */
-declare function ListPage<T>({ title, description, bordered, actions, data, columns, getRowId, searchKeys, filters, enableRowSelection, bulkActions, emptyState, 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";
+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 RadioGroupSize = 'sm' | 'md' | 'lg';
 /** Outer circle (radio button itself) — sized + bordered. */
@@ -1273,4 +1554,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, 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, 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, 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 };