@ssa-ui-kit/core 3.23.0 → 3.24.0

package/dist/ai/source-map.md

@@ -4,7 +4,7 @@ Generated from the TypeScript program at build time — do not edit by hand.
 
 **Everything below is imported from the package root:** `import { X } from '@ssa-ui-kit/core'`
 
-185 components · 20 contexts · 22 hooks · 17 functions · 16 constants · 287 exported types
+190 components · 20 contexts · 23 hooks · 17 functions · 16 constants · 314 exported types
 
 ## Reading this file
 
@@ -20,7 +20,7 @@ Generated from the TypeScript program at build time — do not edit by hand.
 
 **Form Structure** — Filters, FiltersMultiSelect, FiltersMultiSelectEmpty, FiltersMultiSelectOption, FiltersMultiSelectOptions, Form, FormAction, FormCheckbox, FormGroup, FormHelperText, FormRadioGroup
 
-**Data Display** — Avatar, Badge, BarGaugeChart, BarGaugeChartComponent, BarLineComplexChart, BigNumberChart, BigNumberChartComponent, CandlestickChart, CandlestickChartComponent, Card, CardBase, CardContent, CardHeader, CardList, Carousel, ChartBackground, Chip, ColumnResizeHandle, Counter, FunnelChart, GaugeChart, ImageItem, Indicator, Label, NestedTable, NestedTableCell, NestedTableCellSubHeader, NestedTableRow, PieChart, PieChartComponent, PieChartLegend, Progress, ProgressBar, ProgressCircle, ProgressInfo, ProgressInfoTotals, ProgressLegend, ProgressLegendItem, ProgressVertical, ResponsiveImage, SegmentedPieChart, SegmentedPieChartComponent, Table, TableBody, TableCell, TableCellHeader, TableFilterCheckbox, TableFilters, TableFiltersAccordion, TableFiltersAccordionContent, TableFiltersButtons, TableFiltersCancelButton, TableFiltersClearButton, TableFilterTrigger, TableFilterTriggerWithNotification, TableHead, TableRow, Tag, TreeMapChart, TreeMapChartComponent, TreeMapTooltipBase, Typography, WithNestedTableRow
+**Data Display** — Avatar, Badge, BarGaugeChart, BarGaugeChartComponent, BarLineComplexChart, BigNumberChart, BigNumberChartComponent, Calendar, CalendarEventDetails, CandlestickChart, CandlestickChartComponent, Card, CardBase, CardContent, CardHeader, CardList, Carousel, ChartBackground, Chip, ColumnFreezeMenu, ColumnResizeHandle, Counter, FunnelChart, GaugeChart, ImageItem, Indicator, Label, NestedTable, NestedTableCell, NestedTableCellHeader, NestedTableCellSubHeader, NestedTableRow, PieChart, PieChartComponent, PieChartLegend, Progress, ProgressBar, ProgressCircle, ProgressInfo, ProgressInfoTotals, ProgressLegend, ProgressLegendItem, ProgressVertical, ResponsiveImage, SegmentedPieChart, SegmentedPieChartComponent, Table, TableBody, TableCell, TableCellHeader, TableContainer, TableFilterCheckbox, TableFilters, TableFiltersAccordion, TableFiltersAccordionContent, TableFiltersButtons, TableFiltersCancelButton, TableFiltersClearButton, TableFilterTrigger, TableFilterTriggerWithNotification, TableHead, TableRow, Tag, TreeMapChart, TreeMapChartComponent, TreeMapTooltipBase, Typography, WithNestedTableRow
 
 **Navigation & Layout** — CollapsibleNavBar, CollapsibleNavBarCustomIconSVG, History, LargeTab, Link, LinksTabBar, NavBar, Pagination, Step, StepConnector, StepLabel, Stepper, Tab, TabBar, TreeView, WithLink, WithPagination, WithVisibleLG, WithVisibleMD, WithVisibleSM, WithVisibleUpToLG, Wrapper
 
@@ -916,6 +916,62 @@ Circular component for displaying user identity.
   - `features?: BigNumberChartFeatures[]`
   - `valueFormat?: (value: Datum) => React.ReactNode`
 
+#### Calendar<TData>
+Shows entries on a month grid or on a single day's hour timeline.
+
+  - `events?: CalendarEvent<TData>[]` — Entries to show. They don't have to be limited to the visible range.
+  - `view?: CalendarView` — Month grid or single-day timeline. Passing it makes the view controlled: change it from `onViewChange`.
+  - `defaultView?: CalendarView` `= the first of `views`` — View to start in when `view` isn't controlled.
+  - `onViewChange?: (view: CalendarView) => void` — Called when the calendar switches view: a day number opens the `day` view; the day view's back button (shown…
+  - `views?: CalendarView[]` `= ['month', 'day']` — Views the user can switch between. With a single view there is no switching: day numbers don't open the day…
+  - `date?: CalendarDateInput` — Date on show: any day of the month in the `month` view, the day itself in the `day` view. Passing it makes…
+  - `defaultDate?: CalendarDateInput` `= today` — Date to start on when `date` isn't controlled.
+  - `onDateChange?: (date: Date) => void` — Called when the calendar moves to another date: the toolbar's arrows and "Today" button, or a day number…
+  - `onRangeChange?: (range: CalendarRange) => void` — Called with the days on show whenever they change, and once on mount — the range to fetch events for.
+  - `toolbar?: boolean` `= false` — Shows a bar above the grid with previous/next and "Today" buttons, the date on show and, with more than one…
+  - `toolbarEnd?: ReactNode` — Content at the end of the toolbar, e.g. a "Create" button.
+  - `loading?: boolean` `= false` — Marks the calendar busy while events load: a progress bar runs along the top and the region gets `aria-busy`.…
+  - `variant?: CalendarVariant` `= 'events'` — Adds the weekly total column to the month grid. See {@link CalendarVariant}.
+  - `weekdays?: 5 | 7` `= 7` — Columns of the month grid: Monday–Friday or Monday–Sunday.
+  - `maxEventsPerDay?: number` `= 3` — Entries listed in a month cell before the rest collapse behind a "+N more" button.
+  - `renderWeekTotal?: (week: CalendarWeek<TData>) => ReactNode` — Content of the weekly total cell in the `timeTracker` variant.
+  - `totalLabel?: ReactNode` `= 'Total'` — Header text of the total column.
+  - `footer?: ReactNode` — Bar under the month grid, e.g. "Monthly norm" and "Reported" figures. Laid out as a row with space between…
+  - `getDayProps?: (date: Date) => CalendarDayProps | undefined` — Per-day options: whole-day highlights and disabling the add button.
+  - `onAddEvent?: (date: Date) => void` — Shows an add button on each day (on hover in the month grid) and in the day view header. Receives the day…
+  - `minAddDate?: CalendarDateInput` — First day the add button shows on, e.g. today to stop adding to the past. Inclusive; only the date part…
+  - `maxAddDate?: CalendarDateInput` — Last day the add button shows on, e.g. today to stop adding to the future. Inclusive; only the date part…
+  - `onEventClick?: (event: CalendarEvent<TData>, info: CalendarEventClickInfo) => void` — Makes entries clickable. `info.anchor` is the clicked element, to anchor your own popover to.
+  - `renderEventDetails?: (event: CalendarEvent<TData>, controls: CalendarEventDetailsControls) =…` — Content of the card a clicked entry opens — typically a `CalendarEventDetails`. The calendar positions, opens…
+  - `eventDetailsDisplay?: 'popover' | 'modal'` `= 'popover'` — How `renderEventDetails` opens: next to the clicked entry, or centred over the page.
+  - `onTaskToggle?: (event: CalendarEvent<TData>, completed: boolean) => void` — Called when a task's checkbox is toggled.
+  - `onDayClick?: (date: Date) => void` — Called when a day number of the month grid is clicked. Day numbers also open the `day` view unless switching…
+  - `renderEvent?: (event: CalendarEvent<TData>, context: CalendarEventRenderContext) => R…` — Replaces how an entry is drawn. Return `undefined` to fall back to the default for that entry, or…
+  - `renderEventActions?: (event: CalendarEvent<TData>, context: CalendarEventSlotContext) => Rea…` — Buttons at the end of an entry, outside its click target — e.g. a remove button. Shown after `trailing`.
+  - `getEventProps?: (event: CalendarEvent<TData>) => CalendarEventProps | undefined` — Class name and style for an entry's default rendering, to restyle it per event.
+  - `timeFormat?: '24h' | '12h'` `= '24h'` — Clock used for event times and the hour labels of the day view.
+  - `dayHeader?: 'weekday' | 'monthYear'` `= 'monthYear'` — Header of the day view: the weekday name, or the month and year.
+  - `locale?: string` — Locale for weekday and month names, e.g. `'uk'`. Defaults to the browser's.
+  - `scrollToHour?: number` — Hour the day view scrolls to when it opens. Defaults to an hour before the current time on today, and to 8:00…
+  - `aria-label?: string` — Accessible name of the calendar region.
+  - `style?: CSSProperties`
+
+#### CalendarEventDetails
+The card a calendar entry opens: a heading with edit, delete and close buttons, and the entry's details as label/value pairs.
+
+  - `title: ReactNode` — Heading, e.g. `'Time Log Detail'` or the event's title.
+  - `subtitle?: ReactNode` — Text next to the heading, e.g. `'Friday 2'`.
+  - `fields?: CalendarEventDetailsField[]` — Label/value pairs, laid out in two columns (one on narrow screens).
+  - `children?: ReactNode` — Anything under the fields.
+  - `onEdit?: () => void` — Shows an edit button in the header.
+  - `onDelete?: () => void` — Shows a delete button in the header.
+  - `onClose?: () => void` — Shows a close button in the header.
+  - `actions?: ReactNode` — More buttons in the header, before edit and delete.
+  - `editLabel?: string` `= 'Edit'`
+  - `deleteLabel?: string` `= 'Delete'`
+  - `closeLabel?: string` `= 'Close'`
+  - `style?: CSSProperties`
+
 #### CandlestickChart
 
   - `data: CandlestickChartData`
@@ -973,7 +1029,7 @@ UI Component that renders a list of items with a custom render function
 #### Carousel
 Shows a set of images one at a time, with optional thumbnails, dot indicators, previous/next buttons and autoplay.
 
-  - `items: CarouselItem[]` — Slides to show, in order.
+  - `items: CarouselItem[]` — Slides to show, in order. When empty, a single picture placeholder is shown in place of the slide.
   - `thumbnails?: CarouselThumbnailsPosition` `= false` — Position of the thumbnail strip. `left`/`right` render a vertical strip as tall as the slide; `bottom`…
   - `showDots?: boolean` `= true` — Show the dot indicators (see `controlsPosition`).
   - `showArrows?: boolean` `= true` — Show the previous/next buttons (see `controlsPosition`).
@@ -1013,6 +1069,11 @@ Compact component for tags, labels, and removable items.
   - `onClick?: MouseEventHandler<HTMLDivElement>` — Click handler for the chip Makes the chip clickable/interactive
   - `clickable?: boolean` — Explicitly mark chip as clickable Used to enable pointer cursor and keyboard interaction Automatically true…
 
+#### ColumnFreezeMenu
+The freeze/unfreeze menu in a table header cell
+
+  - `columnId?: ColumnId` — The column the menu freezes. Defaults to the `data-column-id` of the header cell it sits in, or that cell's…
+
 #### ColumnResizeHandle
 The grab area on a column's right edge
 
@@ -1091,6 +1152,18 @@ Stage diagram drawn as a funnel or a triangle
 #### NestedTable
 Table whose rows collapse into expandable groups.
 
+  - `resizableColumns?: boolean` `= false` — Lets columns be resized by dragging the right edge of each header cell.
+  - `columnWidths?: number[]` — Column widths in pixels, one per column. Passing this prop puts the table into controlled mode for the life…
+  - `defaultColumnWidths?: number[]` — Starting column widths in pixels, for the uncontrolled case. Omit it and the table measures its own columns…
+  - `onColumnWidthsChange?: (columnWidths: number[]) => void` — Called on every width change, including each frame of a drag. Persisting widths is the caller's job — write…
+  - `minColumnWidth?: number` `= 64` — Narrowest a column can be dragged, in pixels.
+  - `maxColumnWidth?: number` — Widest a column can be dragged, in pixels. Unbounded when omitted.
+  - `columnResizeMode?: ColumnResizeMode` `= 'fit'` — Whether a resize is paid for by the next column or by the table's own width. Defaults to `fit`, which keeps…
+  - `frozenColumns?: FrozenColumns` — Columns frozen to each edge. Passing this prop puts freezing into controlled mode — hold the value in state…
+  - `defaultFrozenColumns?: FrozenColumns` — Columns frozen to each edge to begin with, for the uncontrolled case.
+  - `onFrozenColumnsChange?: (frozenColumns: Required<FrozenColumns>) => void` — Called whenever the user freezes or unfreezes columns from the header controls. Always receives both lists.
+  - `freezeControls?: boolean` `= false` — Gives every `TableCellHeader` a menu to freeze its column to either edge, or unfreeze it. Independent of…
+  - `stickyHeader?: boolean` `= false` — Keeps the header row in view while the table scrolls vertically. Needs a scroll container with a height…
   - `collapsedIconName?: 'reset' | 'archive' | 'arrow-down' | 'arrow-up' | …(223 more — full list under "Icon.name")` `= 'carrot-up'` — Toggle icon shown while a group is collapsed.
   - `expandedIconName?: 'reset' | 'archive' | 'arrow-down' | 'arrow-up' | …(223 more — full list under "Icon.name")` `= 'carrot-down'` — Toggle icon shown while a group is expanded.
   - `defaultCollapsed?: boolean` `= false` — Whether groups start collapsed. Applies to every group in the table; a single `WithNestedTableRow` can…
@@ -1099,7 +1172,16 @@ Table whose rows collapse into expandable groups.
 #### NestedTableCell
 Cell for a `NestedTableRow`.
 
-  _No library-specific props._
+  - `align?: 'center' | 'left' | 'right' | 'justify'` `= 'left'` — Text alignment for the cell content
+  - _plus native element attributes_
+
+#### NestedTableCellHeader
+Column header cell for a `NestedTable`.
+
+  - `resizable?: boolean` `= true` — Whether this column can be resized inside a `Table` with `resizableColumns`. Set it to `false` to pin a…
+  - `freezable?: boolean` `= true` — Whether this header cell offers the freeze menu inside a `Table` with `freezeControls`. Set it to `false` for…
+  - `columnId?: ColumnId` — Stable id for this column, used by `frozenColumns` on the `Table`. Give every header one when the app can…
+  - `align?: 'center' | 'left' | 'right' | 'justify'` `= 'left'` — Text alignment for the cell content
   - _plus native element attributes_
 
 #### NestedTableCellSubHeader
@@ -1267,6 +1349,11 @@ Base table component for displaying tabular data
   - `minColumnWidth?: number` `= 64` — Narrowest a column can be dragged, in pixels.
   - `maxColumnWidth?: number` — Widest a column can be dragged, in pixels. Unbounded when omitted.
   - `columnResizeMode?: ColumnResizeMode` `= 'fit'` — Whether a resize is paid for by the next column or by the table's own width. Defaults to `fit`, which keeps…
+  - `frozenColumns?: FrozenColumns` — Columns frozen to each edge. Passing this prop puts freezing into controlled mode — hold the value in state…
+  - `defaultFrozenColumns?: FrozenColumns` — Columns frozen to each edge to begin with, for the uncontrolled case.
+  - `onFrozenColumnsChange?: (frozenColumns: Required<FrozenColumns>) => void` — Called whenever the user freezes or unfreezes columns from the header controls. Always receives both lists.
+  - `freezeControls?: boolean` `= false` — Gives every `TableCellHeader` a menu to freeze its column to either edge, or unfreeze it. Independent of…
+  - `stickyHeader?: boolean` `= false` — Keeps the header row in view while the table scrolls vertically. Needs a scroll container with a height…
   - _plus native element attributes_
 
 #### TableBody
@@ -1285,9 +1372,17 @@ Table data cell component
 Table header cell component
 
   - `resizable?: boolean` `= true` — Whether this column can be resized inside a `Table` with `resizableColumns`. Set it to `false` to pin a…
+  - `freezable?: boolean` `= true` — Whether this header cell offers the freeze menu inside a `Table` with `freezeControls`. Set it to `false` for…
+  - `columnId?: ColumnId` — Stable id for this column, used by `frozenColumns` on the `Table`. Give every header one when the app can…
   - `align?: 'center' | 'left' | 'right' | 'justify'` `= 'left'` — Text alignment for the cell content
   - _plus native element attributes_
 
+#### TableContainer
+The scroll area around a table
+
+  - `maxHeight?: Property.MaxHeight<string | number>` — Tallest the container gets before the table scrolls vertically. Any CSS value: a number of pixels, `'60vh'`,…
+  - _plus native element attributes_
+
 #### TableFilterCheckbox
 
   - `text?: ReactNode` — Label text or custom React node to display next to the checkbox Can be a string, number, or any React node
@@ -2174,6 +2269,7 @@ A sticky action bar across the bottom of the panel.
 - `useButtonGroupContext` — Access the enclosing `ButtonGroup`'s selection state.
 - `useCollapsibleNavBarContext`
 - `useCollapsibleNavBarItemContext`
+- `useColumnFreezeContext` — The enclosing table's column-freezing state, or `null` when it has none.
 - `useColumnResize` — Column resizing for a `Table`, without any of the rendering.
 - `useColumnResizeContext` — The enclosing table's resize API, or `null` when there isn't one.
 - `useDrawer`
@@ -2253,58 +2349,65 @@ _Names only — read the `.d.ts` for their shape._
 `BigNumberChartProps` · `BreadcrumbItem` · `BreadcrumbMatchContext` · `BreadcrumbRouteHandle`
 `BreadcrumbSibling` · `BreadcrumbsProps` · `ButtonGroupButtonProps` · `ButtonGroupContextValue`
 `ButtonGroupItemInput` · `ButtonGroupItem` · `ButtonGroupProps` · `ButtonGroupValue` · `ButtonProps`
-`ButtonTextProps` · `ButtonVariants` · `CalendarType` · `CandlestickChartFeatures`
-`CandlestickChartProps` · `CardListProps` · `CardProps` · `CarouselControlsPosition` · `CarouselFit`
-`CarouselItem` · `CarouselProps` · `CarouselThumbnailsPosition` · `CheckboxProps`
-`ChildrenDataProps` · `ChipColor` · `ChipProps` · `ChipSize` · `ChipVariant`
-`CollapsibleNavBarExtendedProps` · `CollapsibleNavBarGroup` · `CollapsibleNavBarHeader`
-`CollapsibleNavBarItem` · `ColoredButtonTextProps` · `ColorsKeys` · `ColumnResizeApi`
-`ColumnResizeHandleProps` · `ColumnResizeMode` · `ColumnResizeOptions` · `CommonProps`
-`ContextType` · `ControlledButtonProps` · `CounterProps` · `CounterSizes` · `CounterVariants`
-`CustomIconProps` · `CustomTagStyles` · `DatePickerContextProps` · `DatePickerFormat`
-`DatePickerProps` · `DateRangePickerContextProps` · `DateRangePickerFormBridgeProps`
-`DateRangePickerFormBridgeValue` · `DateRangePickerOnChangeDates` · `DateRangePickerProps`
-`DateRangePresetValue` · `DateRangePreset` · `DateTimeTuple` · `DeprecatedOpenStateProps`
-`DropdownContextType` · `DropdownOptionProps` · `DropdownPositions` · `DropdownProps`
-`DropdownToggleProps` · `DynamicAlertParams` · `DynamicNotificationParams` · `DynamicToastParams`
-`FieldContextValue` · `FieldControlProps` · `FieldDescriptionProps` · `FieldErrorProps`
-`FieldLabelProps` · `FieldProps` · `FieldSuccessProps` · `FileAttachmentFile`
+`ButtonTextProps` · `ButtonVariants` · `CalendarColor` · `CalendarDateInput`
+`CalendarDayHighlight` · `CalendarDayProps` · `CalendarEventClickInfo`
+`CalendarEventDetailsControls` · `CalendarEventDetailsField` · `CalendarEventDetailsProps`
+`CalendarEventProps` · `CalendarEventRenderContext` · `CalendarEventSlotContext` · `CalendarEvent`
+`CalendarHighlightColor` · `CalendarProps` · `CalendarRange` · `CalendarType` · `CalendarVariant`
+`CalendarView` · `CalendarWeek` · `CandlestickChartFeatures` · `CandlestickChartProps`
+`CardListProps` · `CardProps` · `CarouselControlsPosition` · `CarouselFit` · `CarouselItem`
+`CarouselProps` · `CarouselThumbnailsPosition` · `CheckboxProps` · `ChildrenDataProps` · `ChipColor`
+`ChipProps` · `ChipSize` · `ChipVariant` · `CollapsibleNavBarExtendedProps`
+`CollapsibleNavBarGroup` · `CollapsibleNavBarHeader` · `CollapsibleNavBarItem`
+`ColoredButtonTextProps` · `ColorsKeys` · `ColumnFreezeApi` · `ColumnFreezeMenuProps`
+`ColumnFreezeOptions` · `ColumnId` · `ColumnResizeApi` · `ColumnResizeHandleProps`
+`ColumnResizeMode` · `ColumnResizeOptions` · `CommonProps` · `ContextType` · `ControlledButtonProps`
+`CounterProps` · `CounterSizes` · `CounterVariants` · `CustomIconProps` · `CustomTagStyles`
+`DatePickerContextProps` · `DatePickerFormat` · `DatePickerProps` · `DateRangePickerContextProps`
+`DateRangePickerFormBridgeProps` · `DateRangePickerFormBridgeValue` · `DateRangePickerOnChangeDates`
+`DateRangePickerProps` · `DateRangePresetValue` · `DateRangePreset` · `DateTimeTuple`
+`DeprecatedOpenStateProps` · `DropdownContextType` · `DropdownOptionProps` · `DropdownPositions`
+`DropdownProps` · `DropdownToggleProps` · `DynamicAlertParams` · `DynamicNotificationParams`
+`DynamicToastParams` · `FieldContextValue` · `FieldControlProps` · `FieldDescriptionProps`
+`FieldErrorProps` · `FieldLabelProps` · `FieldProps` · `FieldSuccessProps` · `FileAttachmentFile`
 `FileAttachmentProps` · `FileRejectionReason` · `FileUploadProgressEntry` · `FileUploadProgress`
 `FileUploadProps` · `Filter` · `FiltersMultiSelectEmptyProps` · `FiltersMultiSelectOptionProps`
 `FiltersMultiSelectProps` · `FloatingSurfaceColor` · `FloatingSurfaceSize` · `Format`
-`FullscreenModeContextType` · `FunnelChartItem` · `FunnelChartProps` · `FunnelChartRender`
-`FunnelChartType` · `GaugeBarProps` · `GaugeBarThreshold` · `GaugeBarValueFormatter`
-`GaugeChartFeature` · `GaugeChartProps` · `HistoryItemType` · `HistoryProps` · `IFormCheckboxProps`
-`IconButtonProps` · `IconProps` · `ImageItemProps` · `IndicatorProps` · `InputColors` · `InputProps`
-`InputStatusColors` · `InteractionsEnabled` · `Item` · `LabelProps` · `LargeTabProps`
-`LastFocusedElement` · `LinkProps` · `LinksTabBarProps` · `MainColors` · `MainSizes`
-`MapIconsType` · `ModalContextProps` · `ModalDialogProps` · `ModalProps` · `ModalRootProps`
-`MountMode` · `MultipleStylesProps` · `NavBarExtendedGroup` · `NavBarExtendedItem`
-`NavBarExtendedProps` · `NavBarExtendedSubItem` · `NavBarProps` · `NestedTableContextType`
-`NestedTableRowContextType` · `NotificationCardProps` · `NotificationDynamicProps`
-`NotificationGlobalSharedProps` · `NotificationMenuProps` · `NotificationPositions`
-`NotificationProps` · `NotificationSharedProps` · `NotificationSizes` · `NotificationStyleOverrides`
-`NotificationType` · `NotificationVariants` · `NumberFieldProps` · `OpenStateProps`
-`OpenedAccordion` · `PageButtonProps` · `PaginationButtonsProps` · `PaginationContextProps`
-`PaginationContextProviderProps` · `PaginationProps` · `PaletteColor` · `Palette` · `PeriodOption`
-`Period` · `PersonInfoAvatarProps` · `PersonInfoCounterProps` · `PersonInfoCounterTooltipUser`
-`PersonInfoCounterTooltip` · `PersonInfoLinkAttributes` · `PersonInfoProps` · `PersonInfoStyles`
-`PersonInfoValueProps` · `PickerType` · `PieChartFeatures` · `PieChartLegendItem`
-`PieChartLegendProps` · `PieChartProps` · `PieChartTooltipProps` · `PieChartTooltipViewProps`
-`PopoverArrowProps` · `PopoverContentProps` · `PopoverOptions` · `PopoverTriggerProps`
-`ProgressBarProps` · `ProgressChartTooltipProps` · `ProgressCircleProps` · `ProgressInfoItemProps`
-`ProgressInfoProps` · `ProgressInfoResp` · `ProgressInfoTotalsProps` · `ProgressProps` · `RGBString`
-`RadioGroupProps` · `RadioProps` · `RangePickerType` · `RenderContentProps` · `ResizeHandleProps`
-`ResolveDeprecatedPropOptions` · `ResolvedOpenState` · `ResponsiveImageProps` · `SVGProps`
-`SearchBoxProps` · `SelectedFilter` · `SetIDs` · `SimpleChartTooltipProps` · `SizeStyles`
-`SliderMark` · `SliderProps` · `SliderSize` · `SmallTabProps` · `StepperContextType`
-`StepperProps` · `SwitchContext` · `SwitchProps` · `TabBarContextProps` · `TabBarLink`
-`TabBarProps` · `TabBaseProps` · `TabProps` · `TableProps` · `TagsProps` · `TextFieldProps`
-`TextareaProps` · `Theme` · `ToastProps` · `ToastVariants` · `TooltipArrowProps` · `TooltipColor`
-`TooltipContentProps` · `TooltipContentSizes` · `TooltipContextType` · `TooltipProps`
-`TooltipSize` · `TooltipTriggerProps` · `TranslationContextContent` · `TreeItemBase`
-`TreeItemLevel2` · `TreeItemLevel3` · `TreeItemRenderProps` · `TreeItem` · `TreeLevel`
-`TreeMapChartFeature` · `TreeMapChartProps` · `TreeNode` · `TreeViewProps` · `TypeaheadItemProps`
+`FrozenColumns` · `FullscreenModeContextType` · `FunnelChartItem` · `FunnelChartProps`
+`FunnelChartRender` · `FunnelChartType` · `GaugeBarProps` · `GaugeBarThreshold`
+`GaugeBarValueFormatter` · `GaugeChartFeature` · `GaugeChartProps` · `HistoryItemType`
+`HistoryProps` · `IFormCheckboxProps` · `IconButtonProps` · `IconProps` · `ImageItemProps`
+`IndicatorProps` · `InputColors` · `InputProps` · `InputStatusColors` · `InteractionsEnabled`
+`Item` · `LabelProps` · `LargeTabProps` · `LastFocusedElement` · `LinkProps` · `LinksTabBarProps`
+`MainColors` · `MainSizes` · `MapIconsType` · `ModalContextProps` · `ModalDialogProps`
+`ModalProps` · `ModalRootProps` · `MountMode` · `MultipleStylesProps` · `NavBarExtendedGroup`
+`NavBarExtendedItem` · `NavBarExtendedProps` · `NavBarExtendedSubItem` · `NavBarProps`
+`NestedTableCellHeaderProps` · `NestedTableContextType` · `NestedTableContextValue`
+`NestedTableProps` · `NestedTableRowContextType` · `NotificationCardProps`
+`NotificationDynamicProps` · `NotificationGlobalSharedProps` · `NotificationMenuProps`
+`NotificationPositions` · `NotificationProps` · `NotificationSharedProps` · `NotificationSizes`
+`NotificationStyleOverrides` · `NotificationType` · `NotificationVariants` · `NumberFieldProps`
+`OpenStateProps` · `OpenedAccordion` · `PageButtonProps` · `PaginationButtonsProps`
+`PaginationContextProps` · `PaginationContextProviderProps` · `PaginationProps` · `PaletteColor`
+`Palette` · `PeriodOption` · `Period` · `PersonInfoAvatarProps` · `PersonInfoCounterProps`
+`PersonInfoCounterTooltipUser` · `PersonInfoCounterTooltip` · `PersonInfoLinkAttributes`
+`PersonInfoProps` · `PersonInfoStyles` · `PersonInfoValueProps` · `PickerType` · `PieChartFeatures`
+`PieChartLegendItem` · `PieChartLegendProps` · `PieChartProps` · `PieChartTooltipProps`
+`PieChartTooltipViewProps` · `PopoverArrowProps` · `PopoverContentProps` · `PopoverOptions`
+`PopoverTriggerProps` · `ProgressBarProps` · `ProgressChartTooltipProps` · `ProgressCircleProps`
+`ProgressInfoItemProps` · `ProgressInfoProps` · `ProgressInfoResp` · `ProgressInfoTotalsProps`
+`ProgressProps` · `RGBString` · `RadioGroupProps` · `RadioProps` · `RangePickerType`
+`RenderContentProps` · `ResizeHandleProps` · `ResolveDeprecatedPropOptions` · `ResolvedOpenState`
+`ResponsiveImageProps` · `SVGProps` · `SearchBoxProps` · `SelectedFilter` · `SetIDs`
+`SimpleChartTooltipProps` · `SizeStyles` · `SliderMark` · `SliderProps` · `SliderSize`
+`SmallTabProps` · `StepperContextType` · `StepperProps` · `SwitchContext` · `SwitchProps`
+`TabBarContextProps` · `TabBarLink` · `TabBarProps` · `TabBaseProps` · `TabProps`
+`TableContainerProps` · `TableProps` · `TagsProps` · `TextFieldProps` · `TextareaProps` · `Theme`
+`ToastProps` · `ToastVariants` · `TooltipArrowProps` · `TooltipColor` · `TooltipContentProps`
+`TooltipContentSizes` · `TooltipContextType` · `TooltipProps` · `TooltipSize`
+`TooltipTriggerProps` · `TranslationContextContent` · `TreeItemBase` · `TreeItemLevel2`
+`TreeItemLevel3` · `TreeItemRenderProps` · `TreeItem` · `TreeLevel` · `TreeMapChartFeature`
+`TreeMapChartProps` · `TreeNode` · `TreeViewProps` · `TypeaheadItemProps`
 `TypeaheadItemsListProps` · `TypeaheadOptionProps` · `TypeaheadProps` · `TypeaheadValue`
 `TypographyProps` · `UseBreadcrumbsOptions` · `UseChartInfo` · `UseColumnResizeOptions`
 `UseDrawerOptions` · `UseFiltersMultiSelectOptions` · `UseFiltersMultiSelectStore` · `UsePopover`

package/dist/components/Calendar/Calendar.d.ts

@@ -0,0 +1,130 @@
+import { ReactElement, Ref } from 'react';
+import { CalendarProps } from './types';
+/**
+ * Calendar - Shows entries on a month grid or on a single day's hour
+ * timeline.
+ *
+ * ### Entries
+ * An entry (`CalendarEvent`) has a `start` and, when timed, an `end`.
+ * Entries with `allDay` have no time of day: holidays, reminders, or time
+ * logs that record how long but not when. Each entry has a colour stripe from
+ * the nine-colour palette, an optional `trailing` node (a duration, a badge,
+ * avatars) and can be a `task` with a completion checkbox.
+ *
+ * ### Month view
+ * Monday-first weeks, 5 or 7 columns. A cell lists `maxEventsPerDay` entries
+ * and collapses the rest behind "+N more", which opens them in a popover.
+ * `getDayProps` can turn a day into a whole-day highlight (tinted, outlined,
+ * with a badge — days off, holidays) or hide its add button.
+ *
+ * The `timeTracker` variant adds a total column per week with content from
+ * `renderWeekTotal`; `footer` adds a bar under the grid. The calendar never
+ * adds anything up itself — totals are whatever the consumer renders.
+ *
+ * ### Day view
+ * Untimed entries are listed above 00:00; timed ones are placed on the hour
+ * timeline, side by side where they overlap. A timed entry that runs past
+ * midnight continues on the next day's timeline. Today shows a line at the
+ * current time.
+ *
+ * ### Multi-day entries
+ * An untimed entry with an `end`, or a timed one lasting 24 hours or more,
+ * is repeated on every day it covers, with chevrons where it continues. On
+ * the days it fills, it's listed with the untimed entries.
+ *
+ * ### Navigation
+ * Left alone, the calendar navigates itself: a day number opens that day,
+ * the day view's back button returns to the month, and `toolbar` adds
+ * previous / today / next buttons and a Month/Day toggle. Pass `view` and
+ * `date` to control them instead — with `onViewChange` and `onDateChange`,
+ * or without them to pin them. `views` limits the views on offer.
+ * `onRangeChange` reports the days on show, to fetch events for.
+ *
+ * ### Entries: clicks, details and custom looks
+ * `onEventClick` and `renderEventDetails` make entries clickable. The
+ * latter's content (typically a `CalendarEventDetails`) opens next to the
+ * entry, or centred with `eventDetailsDisplay="modal"`.
+ * `renderEventActions` adds buttons (e.g. remove) outside the click target;
+ * `getEventProps` restyles an entry; `renderEvent` replaces or wraps it.
+ *
+ * ### Sizing
+ * The calendar fills its container's width. The month grid is as tall as its
+ * rows. The day view shows twelve hours and scrolls; give the calendar a
+ * height (e.g. `style={{ height: '100%' }}` or `flex: 1`) and it fills that
+ * instead.
+ *
+ * @category Components
+ * @subcategory Data Display
+ *
+ * @example
+ * ```tsx
+ * <Calendar
+ *   date={new Date()}
+ *   events={[
+ *     { id: 1, title: 'Planning', start: '2026-10-12T10:00', end: '2026-10-12T11:00', color: 'purple' },
+ *     { id: 2, title: 'Release day', start: '2026-10-14', allDay: true, color: 'green' },
+ *   ]}
+ *   onAddEvent={(date) => openCreateModal(date)}
+ *   onEventClick={(event) => openDetails(event)}
+ * />
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Time tracker: untimed logs with durations, weekly totals, a footer
+ * <Calendar
+ *   variant="timeTracker"
+ *   weekdays={5}
+ *   events={logs.map((log) => ({
+ *     id: log.id,
+ *     title: log.activity,
+ *     start: log.date,
+ *     allDay: true,
+ *     trailing: formatHours(log.hours),
+ *   }))}
+ *   renderWeekTotal={(week) => `${sumHours(week.events)} hr(s)`}
+ *   footer={<><span>Monthly norm: 174:00</span><span>Reported 80:00</span></>}
+ *   getDayProps={(date) =>
+ *     isVacation(date)
+ *       ? { highlight: { color: 'yellow', icon: 'vacation', label: 'Vacation' } }
+ *       : undefined
+ *   }
+ * />
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Self-navigating, with a toolbar, details on click and loading state
+ * <Calendar
+ *   toolbar
+ *   events={events}
+ *   loading={isFetching}
+ *   onRangeChange={({ start, end }) => fetchEvents(start, end)}
+ *   renderEventDetails={(event, { close }) => (
+ *     <CalendarEventDetails
+ *       title={event.title}
+ *       fields={[{ label: 'Location', value: event.data.location }]}
+ *       onDelete={() => remove(event.id)}
+ *       onClose={close}
+ *     />
+ *   )}
+ * />
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // A single day, 12-hour clock
+ * <Calendar view="day" date={day} events={events} timeFormat="12h" />
+ * ```
+ *
+ * @accessibility
+ * - Root is a labelled `region`; each month cell is a `group` named by its full date
+ * - Today's date carries `aria-current="date"`
+ * - Add buttons show on hover but stay in the tab order, and are always visible on touch screens
+ * - Clickable entries, day numbers and "+N more" are real buttons
+ * - Entry details open as a labelled `dialog`; Escape closes it and focus returns to the entry
+ * - `aria-busy` is set while `loading`
+ */
+export declare const Calendar: <TData = unknown>(props: CalendarProps<TData> & {
+    ref?: Ref<HTMLDivElement>;
+}) => ReactElement;

package/dist/components/Calendar/CalendarContext.d.ts

@@ -0,0 +1,25 @@
+import { DateTime } from 'luxon';
+import { CalendarEvent, CalendarProps } from './types';
+/**
+ * Props every part of the calendar reads, shared through context so the
+ * views don't have to pass them down level by level.
+ */
+export type CalendarContextValue = Pick<CalendarProps, 'getDayProps' | 'onAddEvent' | 'onTaskToggle' | 'onDayClick' | 'renderEvent' | 'renderEventActions' | 'getEventProps' | 'locale'> & {
+    timeFormat: '24h' | '12h';
+    /**
+     * Whether a day gets an add button, going by `onAddEvent` and
+     * `minAddDate` / `maxAddDate` (not `getDayProps`, which the views apply).
+     */
+    canAddOn: (date: DateTime) => boolean;
+    /**
+     * Fires `onEventClick` and opens the details card. `undefined` when
+     * entries aren't clickable.
+     */
+    activateEvent?: (event: CalendarEvent, anchor: HTMLElement) => void;
+    /** Opens a day in the `day` view, when the calendar may switch to it. */
+    openDay?: (date: Date) => void;
+    /** Back from the `day` view to the month, when the calendar may. */
+    backToMonth?: () => void;
+};
+export declare const CalendarContext: import("react").Context<CalendarContextValue | null>;
+export declare const useCalendarContext: () => CalendarContextValue;

package/dist/components/Calendar/CalendarEventDetails.d.ts

@@ -0,0 +1,80 @@
+import { CSSProperties, ReactNode } from 'react';
+/**
+ * A label/value pair of {@link CalendarEventDetails}.
+ */
+export type CalendarEventDetailsField = {
+    label: ReactNode;
+    value: ReactNode;
+    /**
+     * Spans both columns — for prose such as a description.
+     * @default false
+     */
+    fullWidth?: boolean;
+};
+/**
+ * Props of {@link CalendarEventDetails}.
+ */
+export type CalendarEventDetailsProps = {
+    /** Heading, e.g. `'Time Log Detail'` or the event's title. */
+    title: ReactNode;
+    /** Text next to the heading, e.g. `'Friday 2'`. */
+    subtitle?: ReactNode;
+    /** Label/value pairs, laid out in two columns (one on narrow screens). */
+    fields?: CalendarEventDetailsField[];
+    /** Anything under the fields. */
+    children?: ReactNode;
+    /** Shows an edit button in the header. */
+    onEdit?: () => void;
+    /** Shows a delete button in the header. */
+    onDelete?: () => void;
+    /** Shows a close button in the header. */
+    onClose?: () => void;
+    /** More buttons in the header, before edit and delete. */
+    actions?: ReactNode;
+    /** @default 'Edit' */
+    editLabel?: string;
+    /** @default 'Delete' */
+    deleteLabel?: string;
+    /** @default 'Close' */
+    closeLabel?: string;
+    className?: string;
+    style?: CSSProperties;
+};
+/**
+ * CalendarEventDetails - The card a calendar entry opens: a heading with
+ * edit, delete and close buttons, and the entry's details as label/value
+ * pairs.
+ *
+ * Made for `Calendar`'s `renderEventDetails`, which positions and opens it;
+ * it holds no data of its own, so it works for any kind of entry.
+ *
+ * @category Components
+ * @subcategory Data Display
+ *
+ * @example
+ * ```tsx
+ * <Calendar
+ *   events={logs}
+ *   renderEventDetails={(event, { close }) => (
+ *     <CalendarEventDetails
+ *       title="Time Log Detail"
+ *       subtitle="Friday 2"
+ *       fields={[
+ *         { label: 'Date', value: '02.10.2026' },
+ *         { label: 'Project', value: event.data.project },
+ *         { label: 'Notes', value: event.data.notes, fullWidth: true },
+ *       ]}
+ *       onEdit={() => openEditModal(event)}
+ *       onDelete={() => { remove(event.id); close(); }}
+ *       onClose={close}
+ *     />
+ *   )}
+ * />
+ * ```
+ *
+ * @accessibility
+ * - The heading is an `h2`; inside the calendar the card is a labelled `dialog`
+ * - Edit, delete and close are icon buttons named by `editLabel`, `deleteLabel` and `closeLabel`
+ * - Fields are a description list (`dl`)
+ */
+export declare const CalendarEventDetails: ({ title, subtitle, fields, children, onEdit, onDelete, onClose, actions, editLabel, deleteLabel, closeLabel, className, style, }: CalendarEventDetailsProps) => import("@emotion/react/jsx-runtime").JSX.Element;

package/dist/components/Calendar/components/CalendarToolbar.d.ts

@@ -0,0 +1,20 @@
+import { ReactNode } from 'react';
+import { DateTime } from 'luxon';
+import { CalendarView } from '../types';
+type CalendarToolbarProps = {
+    view: CalendarView;
+    date: DateTime;
+    locale?: string;
+    /** Moves to a date; `undefined` when the date can't move. */
+    onNavigate?: (date: DateTime) => void;
+    /** Views to toggle between; the toggle shows with two or more. */
+    views: CalendarView[];
+    onViewChange?: (view: CalendarView) => void;
+    end?: ReactNode;
+};
+/**
+ * The bar above the grid: previous / today / next, the date on show, the
+ * consumer's content and the view toggle.
+ */
+export declare const CalendarToolbar: ({ view, date, locale, onNavigate, views, onViewChange, end, }: CalendarToolbarProps) => import("@emotion/react/jsx-runtime").JSX.Element;
+export {};

package/dist/components/Calendar/components/DayView.d.ts

@@ -0,0 +1,14 @@
+import { DateTime } from 'luxon';
+import { NormalizedEvent } from '../utils';
+type DayViewProps = {
+    date: DateTime;
+    items: NormalizedEvent[];
+    header: 'weekday' | 'monthYear';
+    scrollToHour?: number;
+};
+/**
+ * A single day: header, untimed entries above 00:00, and an hour timeline
+ * with the timed entries placed by time. Overlapping entries share the width.
+ */
+export declare const DayView: ({ date, items, header, scrollToHour, }: DayViewProps) => import("@emotion/react/jsx-runtime").JSX.Element;
+export {};

package/dist/components/Calendar/components/EventDetailsLayer.d.ts

@@ -0,0 +1,17 @@
+import { ReactNode } from 'react';
+type EventDetailsLayerProps = {
+    /** The clicked entry. Only used to place the `popover`. */
+    anchor: HTMLElement;
+    display: 'popover' | 'modal';
+    /** Accessible name of the dialog. */
+    label: string;
+    onClose: () => void;
+    children: ReactNode;
+};
+/**
+ * Holds `renderEventDetails` content: a dialog next to the clicked entry, or
+ * centred over a dimmed page. Escape and a click outside close it; focus
+ * moves in and returns to the entry.
+ */
+export declare const EventDetailsLayer: ({ anchor, display, label, onClose, children, }: EventDetailsLayerProps) => import("@emotion/react/jsx-runtime").JSX.Element;
+export {};

package/dist/components/Calendar/components/EventSlot.d.ts

@@ -0,0 +1,17 @@
+import { CalendarView } from '../types';
+import { NormalizedEvent } from '../utils';
+type EventSlotProps = {
+    item: NormalizedEvent;
+    view: CalendarView;
+    inPopover?: boolean;
+    /** Called after the entry is activated, e.g. to close the popover. */
+    onClicked?: () => void;
+    /** Element to anchor the details to instead of the entry itself. */
+    getAnchor?: () => HTMLElement | null;
+};
+/**
+ * A 34px entry row, as listed in month cells, the "+N more" popover and the
+ * day view's untimed entries.
+ */
+export declare const EventSlot: ({ item, view, inPopover, onClicked, getAnchor, }: EventSlotProps) => import("@emotion/react/jsx-runtime").JSX.Element;
+export {};

package/dist/components/Calendar/components/HighlightBadge.d.ts

@@ -0,0 +1,5 @@
+import { CalendarDayHighlight } from '../types';
+/** The round gradient badge of a whole-day highlight. */
+export declare const HighlightBadge: ({ highlight, }: {
+    highlight: CalendarDayHighlight;
+}) => import("@emotion/react/jsx-runtime").JSX.Element | null;