@dimaan/ui 0.0.12 → 0.0.13

package/dist/index.d.cts

@@ -2,6 +2,7 @@ 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 { 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";
@@ -848,7 +995,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 +1005,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 +1024,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 +1058,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 +1070,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 +1088,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,11 +1105,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;
+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. */
@@ -1273,4 +1453,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, 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 };

package/dist/index.d.ts

@@ -2,6 +2,7 @@ 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 { 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";
@@ -848,7 +995,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 +1005,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 +1024,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 +1058,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 +1070,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 +1088,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,11 +1105,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;
+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. */
@@ -1273,4 +1453,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, 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 };