@takeoff-ui/react-spar 0.4.0 → 0.5.0

package/dist/index.d.cts

@@ -1,7 +1,8 @@
 import * as react from 'react';
-import { HTMLAttributes, ElementType, ComponentPropsWithoutRef, ReactNode, Ref, ImgHTMLAttributes } from 'react';
-import { PolymorphicProps, AccordionProps as AccordionProps$1, AccordionItemProps as AccordionItemProps$1, AccordionHeaderProps as AccordionHeaderProps$1, AccordionContentProps as AccordionContentProps$1, BreadcrumbProps as BreadcrumbProps$1, BreadcrumbItemRenderProps, BreadcrumbLinkProps as BreadcrumbLinkProps$1, NavigationHandler, PressEvent, ButtonProps as ButtonProps$1, CheckboxRenderProps as CheckboxRenderProps$1, CheckboxProps as CheckboxProps$1, DialogProps as DialogProps$1, DialogTriggerProps as DialogTriggerProps$1, DialogOverlayProps as DialogOverlayProps$1, DialogContentProps, DialogTitleProps as DialogTitleProps$1, DialogCloseProps as DialogCloseProps$1, DropdownMenuProps, DropdownMenuTriggerProps, DropdownMenuContentProps, DropdownMenuViewportProps, DropdownMenuItemProps, DropdownMenuGroupProps, DropdownMenuLabelProps, DropdownMenuSeparatorProps, DropdownMenuArrowProps, FieldProps as FieldProps$1, FieldLabelProps as FieldLabelProps$1, FieldDescriptionProps as FieldDescriptionProps$1, FieldErrorMessageProps as FieldErrorMessageProps$1, InputProps as InputProps$1, InputFieldProps as InputFieldProps$1, LabelProps as LabelProps$1, RadioProps as RadioProps$1, RadioItemRenderProps, RadioItemProps as RadioItemProps$1, PopoverProps as PopoverProps$1, PopoverTriggerProps as PopoverTriggerProps$1, PopoverContentProps as PopoverContentProps$1, PopoverCloseProps as PopoverCloseProps$1, SelectProps as SelectProps$1, SelectTriggerProps as SelectTriggerProps$1, SelectContentProps as SelectContentProps$1, SelectViewportProps as SelectViewportProps$1, SelectItemProps as SelectItemProps$1, SelectGroupProps as SelectGroupProps$1, SelectLabelProps as SelectLabelProps$1, SelectSeparatorProps as SelectSeparatorProps$1, SwitchRenderProps as SwitchRenderProps$1, SwitchProps as SwitchProps$1, TabsProps as TabsProps$1, TabsListProps as TabsListProps$1, TabsTriggerRenderProps as TabsTriggerRenderProps$1, TabsTriggerProps as TabsTriggerProps$1, TabsContentProps as TabsContentProps$1, TabsActivationMode as TabsActivationMode$1, TooltipTriggerProps as TooltipTriggerProps$1, TooltipContentProps as TooltipContentProps$1, TooltipProps as TooltipProps$1, TooltipProviderProps as TooltipProviderProps$1, ToasterController, ToastData as ToastData$1, ToasterProps as ToasterProps$1, ToastOptions as ToastOptions$1 } from '@turkish-technology/spar';
-export { BreadcrumbItemRenderProps, BreadcrumbPosition, CreateToasterOptions, ToastAnnouncement, ToastPlacement, ToastPromiseOptions, ToastStatus, ToastType, ToastUpdateOptions, ToasterController, createToaster } from '@turkish-technology/spar';
+import { HTMLAttributes, ElementType, ComponentPropsWithoutRef, ReactNode, Ref, ImgHTMLAttributes, KeyboardEvent } from 'react';
+import { PolymorphicProps, AccordionProps as AccordionProps$1, AccordionItemProps as AccordionItemProps$1, AccordionHeaderProps as AccordionHeaderProps$1, AccordionContentProps as AccordionContentProps$1, BreadcrumbProps as BreadcrumbProps$1, BreadcrumbItemRenderProps, BreadcrumbLinkProps as BreadcrumbLinkProps$1, NavigationHandler, PressEvent, ButtonProps as ButtonProps$1, CheckboxRenderProps as CheckboxRenderProps$1, CheckboxProps as CheckboxProps$1, DialogProps as DialogProps$1, DialogTriggerProps as DialogTriggerProps$1, DialogOverlayProps as DialogOverlayProps$1, DialogContentProps, DialogTitleProps as DialogTitleProps$1, DialogCloseProps as DialogCloseProps$1, DropdownMenuProps, DropdownMenuTriggerProps, DropdownMenuContentProps, DropdownMenuViewportProps, DropdownMenuItemProps, DropdownMenuGroupProps, DropdownMenuLabelProps, DropdownMenuSeparatorProps, DropdownMenuArrowProps, FieldProps as FieldProps$1, FieldLabelProps as FieldLabelProps$1, FieldDescriptionProps as FieldDescriptionProps$1, FieldErrorMessageProps as FieldErrorMessageProps$1, InputProps as InputProps$1, InputFieldProps as InputFieldProps$1, LabelProps as LabelProps$1, RadioProps as RadioProps$1, RadioItemRenderProps, RadioItemProps as RadioItemProps$1, PopoverProps as PopoverProps$1, PopoverTriggerProps as PopoverTriggerProps$1, PopoverContentProps as PopoverContentProps$1, PopoverCloseProps as PopoverCloseProps$1, SelectProps as SelectProps$1, SelectTriggerProps as SelectTriggerProps$1, SelectContentProps as SelectContentProps$1, SelectViewportProps as SelectViewportProps$1, SelectItemProps as SelectItemProps$1, SelectGroupProps as SelectGroupProps$1, SelectLabelProps as SelectLabelProps$1, SelectSeparatorProps as SelectSeparatorProps$1, SwitchRenderProps as SwitchRenderProps$1, SwitchProps as SwitchProps$1, TabsProps as TabsProps$1, TabsListProps as TabsListProps$1, TabsTriggerRenderProps as TabsTriggerRenderProps$1, TabsTriggerProps as TabsTriggerProps$1, TabsContentProps as TabsContentProps$1, TabsActivationMode as TabsActivationMode$1, TooltipTriggerProps as TooltipTriggerProps$1, TooltipContentProps as TooltipContentProps$1, TooltipProps as TooltipProps$1, TooltipProviderProps as TooltipProviderProps$1, ToasterController, ToastData as ToastData$1, ToasterProps as ToasterProps$1, ToastOptions as ToastOptions$1, MaskDateOptions } from '@turkish-technology/spar';
+export { BreadcrumbItemRenderProps, BreadcrumbPosition, CreateToasterOptions, Mask, MaskChangeMeta, MaskCommonOptions, MaskDateOptions, MaskDateToken, MaskNumberOptions, MaskPattern, MaskPreset, MaskRegexOptions, MaskResolver, MaskResolverContext, MaskResolverResult, MaskShapeOptions, MaskTimeOptions, MaskTimeToken, ToastAnnouncement, ToastPlacement, ToastPromiseOptions, ToastStatus, ToastType, ToastUpdateOptions, ToasterController, createDateMask, createNumberMask, createTimeMask, createToaster } from '@turkish-technology/spar';
+import { PropsBase, Modifiers, DateRange } from 'react-day-picker';
 import * as _tanstack_react_table from '@tanstack/react-table';
 import { HeaderContext, CellContext, Column, FilterFn, RowSelectionState, SortingState, ColumnFiltersState, ExpandedState, PaginationState, Table as Table$1 } from '@tanstack/react-table';
 
@@ -619,6 +620,225 @@ declare const Button: {
     displayName: string;
 };
 
+/**
+ * Calendar is the catalog's second **third-party-engine** component (Table is the
+ * first): its state core is `react-day-picker`, not a Spar primitive — Spar ships
+ * no date component. These public types are therefore **v2-owned** and carry no
+ * `Pick<SparCalendarProps, …>` boundary; there is no `SparCalendar` to pick from,
+ * so the `check-spar-pick.mjs` guard does not apply. Engine props are still
+ * inherited through `Pick<DayPickerBaseProps, …>` rather than re-declared, so a
+ * change upstream reaches this contract automatically. See
+ * `docs/component-authoring-contract.md` → Public type boundary.
+ */
+/** Selection mode. Takeoff Core defines `single` / `range`; `multiple` extends it. */
+type CalendarMode = 'single' | 'range' | 'multiple';
+/**
+ * Grid scale → root `data-size`.
+ *
+ * Two values, not three: the design system defines exactly two day-cell sizes
+ * for a picking grid (`datepicker-items-base-size` / `-small-size`). An input
+ * row has a `large`, a month grid does not, so a component that pairs a field
+ * with this grid should resolve its own `large` to `base` — the mapping Takeoff
+ * Core makes (`size === 'small' ? 'small' : 'base'`).
+ *
+ * @defaultValue 'base'
+ */
+type CalendarSize = 'small' | 'base';
+/**
+ * Caption-row treatment → root `data-header-type`. Takeoff Core's
+ * `tk-datepicker` header vocabulary, ported verbatim: `basic` keeps the row
+ * plain and divides it from the grid, the other four drop that divider and draw
+ * the month and its arrows inside a boxed surface.
+ *
+ * @defaultValue 'basic'
+ */
+type CalendarHeaderType = 'basic' | 'divided' | 'light' | 'primary' | 'dark';
+/**
+ * Which board the body shows → root `data-view`. Takeoff Core's `tk-datepicker`
+ * view switch, which `react-day-picker` has no equivalent for: the month and
+ * the year in the caption are buttons, and they swap the day grid for a
+ * twelve-month or twelve-year board.
+ *
+ * @defaultValue 'day'
+ */
+type CalendarView = 'day' | 'month' | 'year';
+/** A selected range. `to` is undefined while the range is half-picked. */
+type CalendarRange = DateRange;
+/** Render the content inside a day button without replacing its behavior. */
+type CalendarDayRenderer = (date: Date, modifiers: Modifiers) => ReactNode;
+/**
+ * Slot vocabulary for `classNames` / `slotProps`. Calendar has a single public
+ * component, so every anatomy node is reached through these keys rather than a
+ * compound part — the nodes are rendered by the engine and are not
+ * consumer-placeable (Table precedent,
+ * `docs/component-authoring-contract.md` → Compound component rule).
+ */
+type CalendarSlot = 'root' | 'months' | 'month' | 'nav' | 'previousMonthButton' | 'nextMonthButton' | 'previousYearButton' | 'nextYearButton' | 'chevron' | 'monthCaption' | 'captionLabel' | 'captionTrigger' | 'dropdowns' | 'dropdownRoot' | 'dropdown' | 'monthGrid' | 'monthYearGrid' | 'monthYearCell' | 'weekdays' | 'weekday' | 'weeks' | 'week' | 'weekNumber' | 'weekNumberHeader' | 'day' | 'dayButton' | 'footer';
+/**
+ * First day of the week, `0` = Sunday. Takeoff Core's `firstDayOfWeekIndex`
+ * vocabulary, mapped onto the engine's `weekStartsOn`.
+ */
+type CalendarWeekStart = 0 | 1 | 2 | 3 | 4 | 5 | 6;
+/**
+ * Props shared by every selection mode.
+ *
+ * The `Pick<DayPickerBaseProps, …>` below is the layout/navigation,
+ * localization and a11y-naming surface inherited from the engine. These pass
+ * through untranslated because the engine owns the behavior behind each one.
+ *
+ * Excluded on purpose: `selected` / `onSelect` (renamed to the `value` /
+ * `onValueChange` pair below, so there is one source of truth), `required`
+ * (collides with the form-`required` semantics Spar's Field chain owns),
+ * `disabled` / `hidden` raw matchers (the Core-vocabulary props above compile
+ * down to them; exposing both would make precedence ambiguous), `modifiers` /
+ * `modifiersClassNames` / `modifiersStyles` / `styles` / `components` /
+ * `dateLib` (engine extension points — `components` and the `classNames` keys
+ * are how this wrapper implements its own anatomy, so handing them to an
+ * instance would let it delete `data-slot` anchors), the per-day DOM events
+ * (`onDayClick` and friends — no Core counterpart, and `onValueChange` covers
+ * selection), `animate` (its classes need keyframes this package's recipe does
+ * not ship yet), and `className` / `style` (owned by the wrapper's own
+ * `className` and `slotProps.root`).
+ */
+interface CalendarOwnProps extends Pick<PropsBase, 'id' | 'month' | 'defaultMonth' | 'onMonthChange' | 'numberOfMonths' | 'pagedNavigation' | 'reverseMonths' | 'reverseYears' | 'hideNavigation' | 'disableNavigation' | 'captionLayout' | 'navLayout' | 'fixedWeeks' | 'hideWeekdays' | 'showOutsideDays' | 'showWeekNumber' | 'broadcastCalendar' | 'ISOWeek' | 'timeZone' | 'today' | 'autoFocus' | 'dir' | 'locale' | 'numerals' | 'formatters' | 'labels' | 'footer' | 'role' | 'aria-label' | 'aria-labelledby'> {
+    /**
+     * Size scale → root `data-size`.
+     * @defaultValue 'base'
+     */
+    size?: CalendarSize;
+    /**
+     * Caption-row treatment → root `data-header-type`.
+     * @defaultValue 'basic'
+     */
+    headerType?: CalendarHeaderType;
+    /**
+     * Board the body shows (controlled). Pair with `onViewChange`; the caption's
+     * month and year switch it, so a `view` passed without a handler locks the
+     * body to that board.
+     *
+     * Under a `dropdown*` caption the boards still work, but the caption keeps
+     * the engine's `<select>` pair instead of gaining switch buttons.
+     */
+    view?: CalendarView;
+    /**
+     * Board the body opens on, without taking control of it.
+     * @defaultValue 'day'
+     */
+    defaultView?: CalendarView;
+    /** Fires when the caption or a board selection moves the body to another board. */
+    onViewChange?: (view: CalendarView) => void;
+    /**
+     * Earliest selectable date, inclusive. Bounds both navigation (the engine's
+     * `startMonth`) and selection (a `{ before }` disabled matcher).
+     */
+    minDate?: Date;
+    /**
+     * Latest selectable date, inclusive. Bounds both navigation (the engine's
+     * `endMonth`) and selection (an `{ after }` disabled matcher).
+     */
+    maxDate?: Date;
+    /** Individual dates that cannot be selected. */
+    disabledDates?: Date[];
+    /**
+     * Whitelist: when set, every date **not** listed is disabled. Combines with
+     * `disabledDates` / `disabledWeekDays` / `minDate` / `maxDate` — a date must
+     * pass all of them to be selectable.
+     */
+    allowedDates?: Date[];
+    /** Weekday indices that cannot be selected, `0` = Sunday. */
+    disabledWeekDays?: number[];
+    /**
+     * First day of the week, `0` = Sunday. Defaults to the locale's own first day.
+     */
+    firstDayOfWeekIndex?: CalendarWeekStart;
+    /** Extra class on the root element. */
+    className?: string;
+    /** Per-slot class name overrides. */
+    classNames?: ClassNamesMap<CalendarSlot>;
+    /** Per-slot HTML attribute overrides. */
+    slotProps?: SlotPropsMap<CalendarSlot>;
+    /** Custom content rendered inside each day button. */
+    renderDay?: CalendarDayRenderer;
+    /** Ref to the root element. */
+    ref?: Ref<HTMLDivElement>;
+}
+/** Single-date selection (the default mode). */
+interface CalendarSingleProps extends CalendarOwnProps {
+    /**
+     * Selection mode.
+     * @defaultValue 'single'
+     */
+    mode?: 'single';
+    /** Selected date (controlled). */
+    value?: Date;
+    /** Initially selected date (uncontrolled). */
+    defaultValue?: Date;
+    /** Fires with the new selection, or `undefined` when it is cleared. */
+    onValueChange?: (value: Date | undefined) => void;
+}
+/** Multiple discrete dates. */
+interface CalendarMultipleProps extends CalendarOwnProps {
+    mode: 'multiple';
+    /** Selected dates (controlled). */
+    value?: Date[];
+    /** Initially selected dates (uncontrolled). */
+    defaultValue?: Date[];
+    /** Fires with the new selection, or `undefined` when it is cleared. */
+    onValueChange?: (value: Date[] | undefined) => void;
+    /** Fewest dates that may be selected. */
+    min?: number;
+    /** Most dates that may be selected. */
+    max?: number;
+}
+/** A continuous range. */
+interface CalendarRangeProps extends CalendarOwnProps {
+    mode: 'range';
+    /** Selected range (controlled). */
+    value?: CalendarRange;
+    /** Initially selected range (uncontrolled). */
+    defaultValue?: CalendarRange;
+    /** Fires with the new range, or `undefined` when it is cleared. */
+    onValueChange?: (value: CalendarRange | undefined) => void;
+    /** Fewest days the range may span. */
+    min?: number;
+    /** Most days the range may span. */
+    max?: number;
+    /** Forbid a range that would contain a disabled date. */
+    excludeDisabled?: boolean;
+}
+/**
+ * Public props for Calendar. The `mode` discriminant decides the shape of
+ * `value` / `defaultValue` / `onValueChange`, mirroring the engine's own
+ * discriminated union.
+ */
+type CalendarProps = CalendarSingleProps | CalendarMultipleProps | CalendarRangeProps;
+/** The union's value payload, for callers that need it non-narrowed. */
+type CalendarValue = Date | Date[] | CalendarRange | undefined;
+declare module '../../core/theme' {
+    interface ComponentThemeRegistry {
+        Calendar: ComponentThemeConfig<CalendarProps, CalendarSlot>;
+    }
+}
+
+/**
+ * Calendar — a month grid built on `react-day-picker`.
+ *
+ * Spar ships no date primitive, so the engine here is third-party (the Table /
+ * TanStack precedent). Every class name in the rendered tree is wrapper-owned
+ * and no engine stylesheet is imported; the engine keeps date arithmetic,
+ * selection, keyboard navigation and ARIA.
+ *
+ * @example
+ * ```tsx
+ * const [date, setDate] = useState<Date>();
+ * <Calendar value={date} onValueChange={setDate} minDate={new Date()} />
+ * ```
+ */
+declare const Calendar: {
+    (props: CalendarProps): react.JSX.Element;
+    displayName: string;
+};
+
 type CardHeaderType = 'basic' | 'divided' | 'light' | 'dark' | 'primary';
 type CardFooterType = 'basic' | 'divided' | 'light';
 type CardSlot = 'root';
@@ -912,7 +1132,7 @@ type DrawerCloseSlot = 'root';
  * `slotProps` (state-driven styling lives on the Panel/Overlay/Header
  * children, which read shared values from context).
  */
-interface DrawerProps extends Pick<DialogProps$1, 'id' | 'open' | 'defaultOpen' | 'onOpenChange' | 'disabled'> {
+interface DrawerProps extends Pick<DialogProps$1, 'id' | 'open' | 'defaultOpen' | 'onOpenChange' | 'disabled' | 'modal' | 'forceMount'> {
     /** Side the drawer slides in from. */
     placement?: DrawerPlacement;
     /** Whether the drawer can be dismissed by clicking outside or pressing Escape. @defaultValue true */
@@ -940,7 +1160,7 @@ interface DrawerPanelOwnProps {
     classNames?: ClassNamesMap<DrawerPanelSlot>;
     slotProps?: SlotPropsMap<DrawerPanelSlot>;
 }
-type DrawerPanelProps<T extends ElementType = 'div'> = PolymorphicProps<'div', T, DrawerPanelOwnProps & Pick<DialogContentProps, 'container' | 'trapFocus' | 'restoreFocus' | 'initialFocus' | 'finalFocus' | 'onOpenAutoFocus' | 'onCloseAutoFocus' | 'onEscapeKeyDown' | 'onPointerDownOutside' | 'onInteractOutside'>>;
+type DrawerPanelProps<T extends ElementType = 'div'> = PolymorphicProps<'div', T, DrawerPanelOwnProps & Pick<DialogContentProps, 'role' | 'container' | 'trapFocus' | 'restoreFocus' | 'initialFocus' | 'finalFocus' | 'onOpenAutoFocus' | 'onCloseAutoFocus' | 'onEscapeKeyDown' | 'onPointerDownOutside' | 'onInteractOutside'>>;
 type DrawerHeaderType = 'basic' | 'divided' | 'light' | 'dark' | 'primary';
 interface DrawerHeaderOwnProps {
     /** Type of the header. @defaultValue 'basic' */
@@ -1462,7 +1682,7 @@ interface InputFieldOwnProps {
     /** Per-slot HTML attribute overrides. */
     slotProps?: SlotPropsMap<InputFieldSlot>;
 }
-type InputFieldProps<T extends ElementType = 'input'> = PolymorphicProps<'input', T, InputFieldOwnProps & Pick<InputFieldProps$1, 'autoFocus'>>;
+type InputFieldProps<T extends ElementType = 'input'> = PolymorphicProps<'input', T, InputFieldOwnProps & Pick<InputFieldProps$1, 'autoFocus' | 'mask' | 'onValueChange'>>;
 interface InputPrefixOwnProps {
     /** Per-slot class name overrides. */
     classNames?: ClassNamesMap<InputPrefixSlot>;
@@ -4047,4 +4267,89 @@ declare const Upload: {
     };
 };
 
-export { Accordion, type AccordionContentProps, type AccordionCurrentValue, type AccordionHeaderProps, type AccordionHeadingLevel, type AccordionIndicatorProps, type AccordionIndicatorRenderState, type AccordionItemProps, type AccordionMode, type AccordionProps, type AccordionSize, type AccordionTriggerProps, type AccordionType, type AccordionValue, type AccordionValueChangeHandler, Alert, type AlertActionsProps, type AlertActionsSlot, type AlertAppearance, type AlertCloseProps, type AlertCloseSlot, type AlertContentProps, type AlertContentSlot, type AlertDescriptionProps, type AlertDescriptionSlot, type AlertProps, type AlertSlot, type AlertTitleProps, type AlertTitleSlot, type AlertVariant, Badge, type BadgeAppearance, type BadgeProps, type BadgeSize, type BadgeSlot, type BadgeVariant, Breadcrumb, type BreadcrumbItemProps, type BreadcrumbLinkProps, type BreadcrumbListProps, type BreadcrumbNavigationHandler, type BreadcrumbPageProps, type BreadcrumbPressEvent, type BreadcrumbProps, type BreadcrumbSeparatorProps, type BreadcrumbSize, type BreadcrumbType, Button, type ButtonAppearance, type ButtonProps, type ButtonSize, type ButtonSlot, type ButtonVariant, Card, type CardBodyProps, type CardBodySlot, type CardDescriptionProps, type CardDescriptionSlot, type CardFooterProps, type CardFooterSlot, type CardFooterType, type CardHeaderProps, type CardHeaderSlot, type CardHeaderType, type CardProps, type CardSlot, type CardTitleProps, type CardTitleSlot, Checkbox, type CheckboxIndicatorProps, type CheckboxIndicatorRenderProps, type CheckboxProps, type CheckboxRenderProps, type CheckboxSize, type CheckboxSlot, Chip, type ChipAppearance, type ChipProps, type ChipSize, type ChipSlot, type ChipVariant, type ClassNamesMap, type ColorMode, type ComponentName, type ComponentThemeConfig, type ComponentThemeRegistry, type ComponentsThemeMap, type ControlledState, type DataSlotName, Dialog, type DialogBodyProps, type DialogBodySlot, type DialogCloseProps, type DialogCloseSlot, type DialogDescriptionProps, type DialogDescriptionSlot, type DialogFooterProps, type DialogFooterSlot, type DialogFooterType, type DialogHeaderProps, type DialogHeaderSlot, type DialogHeaderType, type DialogOverlayIntensity, type DialogOverlayProps, type DialogOverlaySlot, type DialogPanelProps, type DialogPanelSlot, type DialogProps, type DialogTitleProps, type DialogTitleSlot, type DialogTriggerProps, type DialogTriggerSlot, Divider, type DividerAlign, type DividerAppearance, type DividerOrientation, type DividerProps, type DividerSlot, Drawer, type DrawerBodyProps, type DrawerCloseProps, type DrawerDescriptionProps, type DrawerFooterProps, type DrawerHeaderProps, type DrawerOverlayProps, type DrawerPanelProps, type DrawerPlacement, type DrawerProps, type DrawerTitleProps, type DrawerTriggerProps, Dropdown, type DropdownArrowProps, type DropdownContentProps, type DropdownContentWidth, type DropdownGroupProps, type DropdownItemProps, type DropdownLabelProps, type DropdownProps, type DropdownSeparatorProps, type DropdownSize, type DropdownTriggerProps, type DropdownViewportProps, Field, type FieldDescriptionProps, type FieldDescriptionSlot, type FieldErrorMessageProps, type FieldErrorMessageSlot, type FieldLabelProps, type FieldLabelSlot, type FieldProps, type FieldSlot, Input, type InputChipsProps, type InputChipsSlot, type InputClearButtonProps, type InputClearButtonSlot, type InputDecrementProps, type InputDecrementSlot, type InputFieldProps, type InputFieldSlot, type InputIncrementProps, type InputIncrementSlot, type InputLeadingIconProps, type InputLeadingIconSlot, type InputPrefixProps, type InputPrefixSlot, type InputProps, type InputRevealButtonProps, type InputRevealButtonSlot, type InputSize, type InputSlot, type InputSpinnerProps, type InputSpinnerSlot, type InputStepperProps, type InputStepperSlot, type InputStrengthProps, type InputStrengthSlot, type InputSuffixProps, type InputSuffixSlot, type InputTrailingIconProps, type InputTrailingIconSlot, Label, type LabelProps, type LabelSlot, Popover, type PopoverArrowProps, type PopoverArrowSlot, type PopoverCloseProps, type PopoverCloseSlot, type PopoverContentProps, type PopoverContentSlot, type PopoverDescriptionProps, type PopoverDescriptionSlot, type PopoverHeaderProps, type PopoverHeaderSlot, type PopoverProps, type PopoverTriggerProps, type PopoverTriggerSlot, type PopoverVariant, Progress, type ProgressAppearance, type ProgressIndicatorProps, type ProgressIndicatorSlot, type ProgressProps, type ProgressSize, type ProgressSlot, type ProgressTrackProps, type ProgressTrackSlot, type ProgressValueProps, type ProgressValueSlot, type ProgressVariant, Radio, type RadioIndicatorProps, type RadioItemProps, type RadioItemSlot, type RadioLabelProps, type RadioPosition, type RadioProps, type RadioRenderProps, type RadioSize, type RadioSlot, Select, type SelectArrowProps, type SelectContentProps, type SelectGroupProps, type SelectIndicatorProps, type SelectIndicatorRenderState, type SelectItemProps, type SelectLabelProps, type SelectProps, type SelectSeparatorProps, type SelectSize, type SelectTriggerProps, type SelectViewportProps, Skeleton, type SkeletonAnimation, type SkeletonProps, type SkeletonShape, type SkeletonSlot, Slider, type SliderOrientation, type SliderProps, type SliderRangeProps, type SliderRangeValueProps, type SliderSingleValueProps, type SliderSize, type SliderSlot, type SliderThumbProps, type SliderThumbRenderProps, type SliderTicksProps, type SliderTooltip, type SliderTrackMode, type SliderTrackProps, type SliderValue, type SliderValueProps, type SliderValueRenderProps, type SliderVariant, type SlotClassNames, type SlotPropsMap, Spinner, type SpinnerAppearance, type SpinnerProps, type SpinnerSize, type SpinnerSlot, type SpinnerVariant, type StateOnlyComponentThemeConfig$1 as StateOnlyComponentThemeConfig, Stepper, type StepperDescriptionProps, type StepperIndicatorState, type StepperItemProps, type StepperMode, type StepperOrientation, type StepperProps, type StepperSize, type StepperStepClickDetail, type StepperStepStatus, type StepperTitleProps, Switch, type SwitchIndicatorProps, type SwitchIndicatorRenderProps, type SwitchProps, type SwitchRenderProps, type SwitchSize, type SwitchSlot, type SwitchVariant, Table, type TableAlign, type TableColumnAccessor, type TableColumnDef, type TableColumnFilter, type TableColumnFilterContext, type TableColumnFilterOption, type TableColumnFilterType, type TableColumnMeta, type TableDataRequest, type TableExpansionConfig, type TableFilteringConfig, type TablePaginationConfig, type TableProps, type TableSelectionConfig, type TableSize, type TableSlot, type TableSortingConfig, type TableStickySide, Tabs, type TabsActivationMode, type TabsAppearance, type TabsContentProps, type TabsListProps, type TabsProps, type TabsSize, type TabsTriggerProps, type TabsTriggerRenderProps, type TabsVariant, TakeoffSparProvider, type TakeoffSparProviderProps, type TakeoffSparProviderValue, type ThemeValue, Toast, type ToastAppearance, type ToastData, type ToastOptions, type ToastProps, type ToastSlot, type ToastVariant, Toaster, type ToasterOwnProps, type ToasterProps, type ToasterSlot, Tooltip, type TooltipArrowProps, type TooltipArrowSlot, type TooltipContentProps, type TooltipContentSlot, type TooltipDescriptionProps, type TooltipDescriptionSlot, type TooltipHeaderProps, type TooltipHeaderSlot, type TooltipProps, type TooltipProviderProps, type TooltipTriggerProps, type TooltipTriggerSlot, type TooltipVariant, Upload, type UploadActionsProps, type UploadActionsSlot, type UploadDropzoneProps, type UploadDropzoneSlot, type UploadFile, type UploadFileStatus, type UploadItemActionProps, type UploadItemActionSlot, type UploadItemActionsProps, type UploadItemActionsSlot, type UploadItemContentProps, type UploadItemContentSlot, type UploadItemPreviewProps, type UploadItemPreviewSlot, type UploadItemPreviewSlotProps, type UploadItemProps, type UploadItemSlot, type UploadListProps, type UploadListSlot, type UploadProps, type UploadRejection, type UploadSlot, type UploadSubmitProps, type UploadSubmitSlot, type UploadTriggerProps, type UploadTriggerSlot, getExportRows, useComponentTheme, useTheme };
+/**
+ * The text/`Date` bridge a date picker needs, without a DatePicker component.
+ *
+ * A date picker is `Popover` + `Calendar` composed by the consumer (see
+ * `docs/datepicker-contract.md`). That decision stands: this hook owns no anatomy,
+ * renders nothing, and every element stays the consumer's to place. What it
+ * removes is the one part of the composition that was neither short nor
+ * situational — keeping a typed string and a `Date` in step, in both
+ * directions, plus the mask bounds that have to agree with the grid's.
+ *
+ * It qualifies under the no-adapter-hook rule on the same grounds as
+ * `useControllableState`: real React state, and no Spar behaviour hidden behind
+ * it. It maps nothing — `Input.Field` and `Calendar` keep their own contracts,
+ * and the props below are ordinary values a caller may spread, override, or
+ * ignore one at a time.
+ *
+ * The displayed month is deliberately absent: `Calendar` follows a value set
+ * from outside the grid on its own, so a third piece of state would be a second
+ * writer to a month the grid already moves.
+ */
+/** How a `Date` is rendered into the field. */
+type DateFormatter = (value: Date) => string;
+interface UseDatePickerOptions {
+    /** Earliest selectable date, inclusive. Bounds the grid *and* the mask. */
+    min?: Date;
+    /** Latest selectable date, inclusive. Bounds the grid *and* the mask. */
+    max?: Date;
+    /** Initial value, uncontrolled. */
+    defaultValue?: Date;
+    /**
+     * Separator between the day, month and year blocks. Also the one the mask
+     * inserts as you type.
+     * @defaultValue '/'
+     */
+    delimiter?: string;
+    /**
+     * Renders the picked date into the field. The default is
+     * `dd<delimiter>mm<delimiter>yyyy`, which is what the mask accepts back.
+     */
+    format?: DateFormatter;
+    /** Fires whenever the value changes, from either half. */
+    onValueChange?: (value: Date | undefined) => void;
+}
+interface UseDatePickerResult {
+    /** The picked date, or `undefined` while the field is empty or incomplete. */
+    value: Date | undefined;
+    /** The field's text, masked. */
+    text: string;
+    /** Whether the panel is open. Pair with {@link UseDatePickerResult.popoverProps}. */
+    open: boolean;
+    /** Set the value from anywhere — a preset button, a reset, a restored form. */
+    setValue: (value: Date | undefined) => void;
+    /** Open state, for `Popover`. */
+    popoverProps: {
+        open: boolean;
+        onOpenChange: (open: boolean) => void;
+    };
+    /**
+     * Mask, value and change handling for `Input.Field`. `onKeyDown` opens the
+     * panel on `ArrowDown`, which is what makes the grid reachable from the
+     * keyboard; drop it if the field is read-only.
+     */
+    inputProps: {
+        mask: MaskDateOptions;
+        value: string;
+        onValueChange: (next: string, meta: {
+            completed?: boolean;
+            iso?: string;
+        }) => void;
+        onKeyDown: (event: KeyboardEvent<HTMLInputElement>) => void;
+    };
+    /**
+     * Value and bounds for `Calendar`. Selecting a day writes the formatted date
+     * back into the field and closes the panel — spread `onValueChange` yourself
+     * if a mode needs to stay open (a range is not finished on the first click).
+     */
+    calendarProps: {
+        value: Date | undefined;
+        minDate: Date | undefined;
+        maxDate: Date | undefined;
+        onValueChange: (value: Date | undefined) => void;
+    };
+}
+declare function useDatePicker({ min, max, defaultValue, delimiter, format, onValueChange }?: UseDatePickerOptions): UseDatePickerResult;
+
+export { Accordion, type AccordionContentProps, type AccordionCurrentValue, type AccordionHeaderProps, type AccordionHeadingLevel, type AccordionIndicatorProps, type AccordionIndicatorRenderState, type AccordionItemProps, type AccordionMode, type AccordionProps, type AccordionSize, type AccordionTriggerProps, type AccordionType, type AccordionValue, type AccordionValueChangeHandler, Alert, type AlertActionsProps, type AlertActionsSlot, type AlertAppearance, type AlertCloseProps, type AlertCloseSlot, type AlertContentProps, type AlertContentSlot, type AlertDescriptionProps, type AlertDescriptionSlot, type AlertProps, type AlertSlot, type AlertTitleProps, type AlertTitleSlot, type AlertVariant, Badge, type BadgeAppearance, type BadgeProps, type BadgeSize, type BadgeSlot, type BadgeVariant, Breadcrumb, type BreadcrumbItemProps, type BreadcrumbLinkProps, type BreadcrumbListProps, type BreadcrumbNavigationHandler, type BreadcrumbPageProps, type BreadcrumbPressEvent, type BreadcrumbProps, type BreadcrumbSeparatorProps, type BreadcrumbSize, type BreadcrumbType, Button, type ButtonAppearance, type ButtonProps, type ButtonSize, type ButtonSlot, type ButtonVariant, Calendar, type CalendarDayRenderer, type CalendarHeaderType, type CalendarMode, type CalendarMultipleProps, type CalendarProps, type CalendarRange, type CalendarRangeProps, type CalendarSingleProps, type CalendarSize, type CalendarSlot, type CalendarValue, type CalendarView, type CalendarWeekStart, Card, type CardBodyProps, type CardBodySlot, type CardDescriptionProps, type CardDescriptionSlot, type CardFooterProps, type CardFooterSlot, type CardFooterType, type CardHeaderProps, type CardHeaderSlot, type CardHeaderType, type CardProps, type CardSlot, type CardTitleProps, type CardTitleSlot, Checkbox, type CheckboxIndicatorProps, type CheckboxIndicatorRenderProps, type CheckboxProps, type CheckboxRenderProps, type CheckboxSize, type CheckboxSlot, Chip, type ChipAppearance, type ChipProps, type ChipSize, type ChipSlot, type ChipVariant, type ClassNamesMap, type ColorMode, type ComponentName, type ComponentThemeConfig, type ComponentThemeRegistry, type ComponentsThemeMap, type ControlledState, type DataSlotName, type DateFormatter, Dialog, type DialogBodyProps, type DialogBodySlot, type DialogCloseProps, type DialogCloseSlot, type DialogDescriptionProps, type DialogDescriptionSlot, type DialogFooterProps, type DialogFooterSlot, type DialogFooterType, type DialogHeaderProps, type DialogHeaderSlot, type DialogHeaderType, type DialogOverlayIntensity, type DialogOverlayProps, type DialogOverlaySlot, type DialogPanelProps, type DialogPanelSlot, type DialogProps, type DialogTitleProps, type DialogTitleSlot, type DialogTriggerProps, type DialogTriggerSlot, Divider, type DividerAlign, type DividerAppearance, type DividerOrientation, type DividerProps, type DividerSlot, Drawer, type DrawerBodyProps, type DrawerCloseProps, type DrawerDescriptionProps, type DrawerFooterProps, type DrawerHeaderProps, type DrawerOverlayProps, type DrawerPanelProps, type DrawerPlacement, type DrawerProps, type DrawerTitleProps, type DrawerTriggerProps, Dropdown, type DropdownArrowProps, type DropdownContentProps, type DropdownContentWidth, type DropdownGroupProps, type DropdownItemProps, type DropdownLabelProps, type DropdownProps, type DropdownSeparatorProps, type DropdownSize, type DropdownTriggerProps, type DropdownViewportProps, Field, type FieldDescriptionProps, type FieldDescriptionSlot, type FieldErrorMessageProps, type FieldErrorMessageSlot, type FieldLabelProps, type FieldLabelSlot, type FieldProps, type FieldSlot, Input, type InputChipsProps, type InputChipsSlot, type InputClearButtonProps, type InputClearButtonSlot, type InputDecrementProps, type InputDecrementSlot, type InputFieldProps, type InputFieldSlot, type InputIncrementProps, type InputIncrementSlot, type InputLeadingIconProps, type InputLeadingIconSlot, type InputPrefixProps, type InputPrefixSlot, type InputProps, type InputRevealButtonProps, type InputRevealButtonSlot, type InputSize, type InputSlot, type InputSpinnerProps, type InputSpinnerSlot, type InputStepperProps, type InputStepperSlot, type InputStrengthProps, type InputStrengthSlot, type InputSuffixProps, type InputSuffixSlot, type InputTrailingIconProps, type InputTrailingIconSlot, Label, type LabelProps, type LabelSlot, Popover, type PopoverArrowProps, type PopoverArrowSlot, type PopoverCloseProps, type PopoverCloseSlot, type PopoverContentProps, type PopoverContentSlot, type PopoverDescriptionProps, type PopoverDescriptionSlot, type PopoverHeaderProps, type PopoverHeaderSlot, type PopoverProps, type PopoverTriggerProps, type PopoverTriggerSlot, type PopoverVariant, Progress, type ProgressAppearance, type ProgressIndicatorProps, type ProgressIndicatorSlot, type ProgressProps, type ProgressSize, type ProgressSlot, type ProgressTrackProps, type ProgressTrackSlot, type ProgressValueProps, type ProgressValueSlot, type ProgressVariant, Radio, type RadioIndicatorProps, type RadioItemProps, type RadioItemSlot, type RadioLabelProps, type RadioPosition, type RadioProps, type RadioRenderProps, type RadioSize, type RadioSlot, Select, type SelectArrowProps, type SelectContentProps, type SelectGroupProps, type SelectIndicatorProps, type SelectIndicatorRenderState, type SelectItemProps, type SelectLabelProps, type SelectProps, type SelectSeparatorProps, type SelectSize, type SelectTriggerProps, type SelectViewportProps, Skeleton, type SkeletonAnimation, type SkeletonProps, type SkeletonShape, type SkeletonSlot, Slider, type SliderOrientation, type SliderProps, type SliderRangeProps, type SliderRangeValueProps, type SliderSingleValueProps, type SliderSize, type SliderSlot, type SliderThumbProps, type SliderThumbRenderProps, type SliderTicksProps, type SliderTooltip, type SliderTrackMode, type SliderTrackProps, type SliderValue, type SliderValueProps, type SliderValueRenderProps, type SliderVariant, type SlotClassNames, type SlotPropsMap, Spinner, type SpinnerAppearance, type SpinnerProps, type SpinnerSize, type SpinnerSlot, type SpinnerVariant, type StateOnlyComponentThemeConfig$1 as StateOnlyComponentThemeConfig, Stepper, type StepperDescriptionProps, type StepperIndicatorState, type StepperItemProps, type StepperMode, type StepperOrientation, type StepperProps, type StepperSize, type StepperStepClickDetail, type StepperStepStatus, type StepperTitleProps, Switch, type SwitchIndicatorProps, type SwitchIndicatorRenderProps, type SwitchProps, type SwitchRenderProps, type SwitchSize, type SwitchSlot, type SwitchVariant, Table, type TableAlign, type TableColumnAccessor, type TableColumnDef, type TableColumnFilter, type TableColumnFilterContext, type TableColumnFilterOption, type TableColumnFilterType, type TableColumnMeta, type TableDataRequest, type TableExpansionConfig, type TableFilteringConfig, type TablePaginationConfig, type TableProps, type TableSelectionConfig, type TableSize, type TableSlot, type TableSortingConfig, type TableStickySide, Tabs, type TabsActivationMode, type TabsAppearance, type TabsContentProps, type TabsListProps, type TabsProps, type TabsSize, type TabsTriggerProps, type TabsTriggerRenderProps, type TabsVariant, TakeoffSparProvider, type TakeoffSparProviderProps, type TakeoffSparProviderValue, type ThemeValue, Toast, type ToastAppearance, type ToastData, type ToastOptions, type ToastProps, type ToastSlot, type ToastVariant, Toaster, type ToasterOwnProps, type ToasterProps, type ToasterSlot, Tooltip, type TooltipArrowProps, type TooltipArrowSlot, type TooltipContentProps, type TooltipContentSlot, type TooltipDescriptionProps, type TooltipDescriptionSlot, type TooltipHeaderProps, type TooltipHeaderSlot, type TooltipProps, type TooltipProviderProps, type TooltipTriggerProps, type TooltipTriggerSlot, type TooltipVariant, Upload, type UploadActionsProps, type UploadActionsSlot, type UploadDropzoneProps, type UploadDropzoneSlot, type UploadFile, type UploadFileStatus, type UploadItemActionProps, type UploadItemActionSlot, type UploadItemActionsProps, type UploadItemActionsSlot, type UploadItemContentProps, type UploadItemContentSlot, type UploadItemPreviewProps, type UploadItemPreviewSlot, type UploadItemPreviewSlotProps, type UploadItemProps, type UploadItemSlot, type UploadListProps, type UploadListSlot, type UploadProps, type UploadRejection, type UploadSlot, type UploadSubmitProps, type UploadSubmitSlot, type UploadTriggerProps, type UploadTriggerSlot, type UseDatePickerOptions, type UseDatePickerResult, getExportRows, useComponentTheme, useDatePicker, useTheme };