@ssa-ui-kit/core 3.24.0 → 3.25.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'`
 
-190 components · 20 contexts · 23 hooks · 17 functions · 16 constants · 314 exported types
+192 components · 20 contexts · 23 hooks · 17 functions · 16 constants · 325 exported types
 
 ## Reading this file
 
@@ -16,13 +16,13 @@ Generated from the TypeScript program at build time — do not edit by hand.
 
 ## Component roster
 
-**Action & Form Controls** — BreadcrumbMenu, Breadcrumbs, Button, ButtonGroup, ButtonGroupButton, Checkbox, ColorPicker, DatePicker, DateRangePicker, DateRangePickerFormBridge, Dropdown, DropdownArrow, DropdownBase, DropdownOption, DropdownOptions, DropdownToggle, FileAttachment, FileUpload, IconButton, Input, MultipleDropdown, MultipleDropdownNotification, MultipleDropdownOptions, NumberField, Radio, RadioGroup, SearchBox, SearchBoxCrossIcon, SearchBoxInput, SearchBoxWrapper, Slider, SliderInputsRow, SliderLabel, SliderMarkItem, SliderMarkLabel, SliderMarksRow, SliderMarkTick, SliderNumberInput, SliderRangeInput, SliderRoot, SliderTrackBg, SliderTrackFill, SliderTrackRow, SliderTrackWrapper, SliderValueLabel, SliderValueLabelsContainer, Switch, Textarea, TextField, Typeahead, TypeaheadItemIcon, TypeaheadItemImage, TypeaheadOption, TypeaheadOptions
+**Action & Form Controls** — BreadcrumbMenu, Breadcrumbs, Button, ButtonGroup, ButtonGroupButton, Checkbox, ColorPicker, DatePicker, DateRangePicker, DateRangePickerFormBridge, Dropdown, DropdownArrow, DropdownBase, DropdownOption, DropdownOptions, DropdownToggle, FileAttachment, FileUpload, FloatingActionButton, IconButton, Input, MultipleDropdown, MultipleDropdownNotification, MultipleDropdownOptions, NumberField, Radio, RadioGroup, SearchBox, SearchBoxCrossIcon, SearchBoxInput, SearchBoxWrapper, Slider, SliderInputsRow, SliderLabel, SliderMarkItem, SliderMarkLabel, SliderMarksRow, SliderMarkTick, SliderNumberInput, SliderRangeInput, SliderRoot, SliderTrackBg, SliderTrackFill, SliderTrackRow, SliderTrackWrapper, SliderValueLabel, SliderValueLabelsContainer, Switch, Textarea, TextField, Typeahead, TypeaheadItemIcon, TypeaheadItemImage, TypeaheadOption, TypeaheadOptions
 
 **Form Structure** — Filters, FiltersMultiSelect, FiltersMultiSelectEmpty, FiltersMultiSelectOption, FiltersMultiSelectOptions, Form, FormAction, FormCheckbox, FormGroup, FormHelperText, FormRadioGroup
 
 **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
+**Navigation & Layout** — CollapsibleNavBar, CollapsibleNavBarCustomIconSVG, Header, History, LargeTab, Link, LinksTabBar, NavBar, Pagination, Step, StepConnector, StepLabel, Stepper, Tab, TabBar, TreeView, WithLink, WithPagination, WithVisibleLG, WithVisibleMD, WithVisibleSM, WithVisibleUpToLG, Wrapper
 
 **Overlay & Feedback** — Modal, ModalContent, ModalDialog, ModalDismissButton, ModalOpenButton, NotificationCard, NotificationMenu, Popover, PopoverClose, PopoverContent, PopoverDescription, PopoverHeading, PopoverTrigger, ProgressChartTooltip, SimpleChartTooltip, Tooltip, TooltipContent, TooltipContentBase, TooltipTrigger
 
@@ -326,6 +326,26 @@ File input component with optional drag-and-drop support
   - `onChange?: (files: File[]) => void`
   - `onFileRejected?: (file: File, reason: FileRejectionReason) => void`
 
+#### FloatingActionButton
+A button fixed to a corner of the viewport for the page's primary action, optionally opening a speed-dial menu of related actions.
+
+  - `icon?: FloatingActionButtonIcon` `= 'plus'` — Icon of the button (of the menu trigger while the menu is closed).
+  - `label?: string` — Text shown next to the icon (the "extended" FAB). Without it the FAB is icon-only and needs an `aria-label`.
+  - `color?: FloatingActionButtonColor` `= 'primary'` — Background color. Pre-defined `primary` / `secondary`, a theme color key or any CSS color; custom colors get…
+  - `shadow?: boolean` `= true` — Draws the elevation shadow under the button.
+  - `shape?: 'square' | 'round'` `= 'square'` — Corner shape: `square` keeps the 8px radius, `round` is fully rounded (a circle when icon-only, a pill when…
+  - `size?: FloatingActionButtonSize` `= 'medium'` — Size of the button and of its menu items.
+  - `disabled?: boolean` `= false` — Disables the button (and, in menu mode, opening the menu).
+  - `onClick?: MouseEventHandler<HTMLButtonElement>` — Click handler. In menu mode it also runs, before the menu toggles.
+  - `actions?: FloatingActionButtonAction[]` — Items of the speed-dial menu. When given, the button toggles a stack of secondary FABs above it (below it for…
+  - `showActionLabels?: boolean` `= true` — Shows each action's `label` next to its icon. When `false` the items are icon-only and the label stays as…
+  - `open?: boolean` — Controlled open state of the menu.
+  - `defaultOpen?: boolean` `= false` — Initial open state of the menu when uncontrolled.
+  - `onOpenChange?: (open: boolean) => void` — Called when the menu opens or closes.
+  - `openIcon?: FloatingActionButtonIcon` `= 'cross'` — Icon of the trigger while the menu is open.
+  - `position?: FloatingActionButtonPosition` `= 'bottom-right'` — Viewport corner the FAB is fixed to.
+  - `offset?: number | { x: number; y: number; }` `= 24` — Distance from the corner in px — one value for both axes, or `{ x, y }`.
+
 #### IconButton
 Square icon-only button for icon actions
 
@@ -1034,10 +1054,11 @@ Shows a set of images one at a time, with optional thumbnails, dot indicators, p
   - `showDots?: boolean` `= true` — Show the dot indicators (see `controlsPosition`).
   - `showArrows?: boolean` `= true` — Show the previous/next buttons (see `controlsPosition`).
   - `controlsPosition?: CarouselControlsPosition` `= 'overlay'` — Where the dots and arrows sit. `overlay` draws them over the bottom of the slide; `below` puts them in a 32px…
-  - `allowOpenFull?: boolean` `= false` — Show a button that opens the current image (`fullSrc ?? src`) in a new tab. It appears when the slide is…
+  - `allowOpenFull?: boolean` `= false` — Show a button that opens the current image (`fullSrc ?? src`), in a new tab or a modal (see `openFullMode`).…
+  - `openFullMode?: CarouselOpenFullMode` `= 'newTab'` — Where the `allowOpenFull` button opens the image. `modal` shows it over a dimmed page at its natural size,…
   - `aspectRatio?: number` `= 1` — Width-to-height ratio of the slide. The slide always fills the container's width; this sets its height.…
   - `height?: Property.Height<string | number>` — Fixed slide height (number = px). Overrides `aspectRatio`.
-  - `fit?: CarouselFit` `= 'contain'` — How images fill the slide frame.
+  - `fit?: CarouselFit` `= 'cover'` — How images fill the slide frame.
   - `index?: number` — Index of the current slide (controlled).
   - `defaultIndex?: number` `= 0` — Index of the slide shown first (uncontrolled).
   - `onIndexChange?: (index: number) => void` — Called whenever the current slide changes.
@@ -1092,8 +1113,9 @@ Compact numeric indicator for displaying counts or notification badges.
 #### FunnelChart
 Stage diagram drawn as a funnel or a triangle
 
-  - `data: FunnelChartItem[]` — Levels from top to bottom. Every level has the same height.
+  - `data: FunnelChartItem[]` — Levels from top to bottom. Every level has the same height unless `proportional` is set.
   - `type?: FunnelChartType` `= 'funnel'` — Shape of the chart
+  - `proportional?: boolean` `= false` — Size each level's height in proportion to its value, so bigger values get bigger levels. Zero and tiny values…
   - `withPointer?: boolean` `= false` — Render a leader line and a label beside each level
   - `withTooltip?: boolean` `= true` — Show a tooltip when a level is hovered
   - `withLabels?: boolean` `= true` — Show the labels inside the levels. Pointer labels are controlled by `withPointer`.
@@ -1541,6 +1563,17 @@ The app sidebar: a logo, a menu, and three layouts.
   _No library-specific props._
   - _plus native element attributes_
 
+#### Header
+The application's top bar: logo, main navigation and a free slot on the right for the user profile, notifications or log out.
+
+  - `logo?: ReactNode` — Project logo, placed in a box of fixed height. Leave it out and the box stays empty, so the layout does not…
+  - `items?: HeaderNavItem[]` — Navigation items. Rendered centred; scrolls sideways when it overflows.
+  - `rightSide?: ReactNode` — Right-hand content — user profile, notifications, log out, whatever the app needs. Rendered as-is on every…
+  - `size?: HeaderSize` `= 'small'` — Bar height and logo size
+  - `navLabel?: string` `= 'Main'` — Accessible name of the navigation landmark
+  - `menuButtonLabel?: string` `= 'Open menu'` — Accessible name of the burger button shown below 900px
+  - _plus native element attributes_
+
 #### History
 Vertical timeline component for chronological events.
 
@@ -2356,61 +2389,65 @@ _Names only — read the `.d.ts` for their shape._
 `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`
+`CarouselOpenFullMode` · `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`
+`FiltersMultiSelectProps` · `FloatingActionButtonAction` · `FloatingActionButtonColor`
+`FloatingActionButtonIcon` · `FloatingActionButtonPosition` · `FloatingActionButtonProps`
+`FloatingActionButtonSize` · `FloatingSurfaceColor` · `FloatingSurfaceSize` · `Format`
 `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`
-`UseTooltipArgs` · `UseTooltipContext` · `UseTooltip` · `UseTypeaheadProps` · `UserProfileProps`
-`ValueLabelDisplay` · `VariantStyle` · `WidgetCardProps` · `WithNestedTableRowProps`
-`WithWidgetCardProps` · `WrapperAlignItems` · `WrapperDirection` · `WrapperJustifyContent`
+`GaugeBarValueFormatter` · `GaugeChartFeature` · `GaugeChartProps` · `HeaderNavItem` · `HeaderProps`
+`HeaderSize` · `HeaderTheme` · `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` · `UseTooltipArgs` · `UseTooltipContext` · `UseTooltip`
+`UseTypeaheadProps` · `UserProfileProps` · `ValueLabelDisplay` · `VariantStyle` · `WidgetCardProps`
+`WithNestedTableRowProps` · `WithWidgetCardProps` · `WrapperAlignItems` · `WrapperDirection`
+`WrapperJustifyContent`

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

@@ -25,6 +25,8 @@ export declare const HOUR_GUTTER_WIDTH = 64;
 export declare const DAY_EVENT_GAP = 5;
 /** Shortest an event is drawn, however brief. */
 export declare const DAY_EVENT_MIN_HEIGHT = 15;
+/** Set on the details layer to its `eventDetailsDisplay`, for styling. */
+export declare const DETAILS_DISPLAY_ATTRIBUTE = "data-calendar-details";
 /** Stripe colour per palette entry. */
 export declare const getEventColor: (theme: Theme, color: CalendarColor) => `rgb${string}` | undefined;
 /** Outline, 8% tint and badge gradient of a whole-day highlight. */

package/dist/components/Carousel/Carousel.d.ts

@@ -7,8 +7,8 @@ import { CarouselProps } from './types';
  * The carousel always fills its container's width. The slide's height comes
  * from `aspectRatio` (square by default, as in the design) or from a fixed
  * `height`, never from the images — so the layout does not jump between
- * slides or while images load. Images are letterboxed inside the frame
- * (`fit="contain"`) or cropped to fill it (`fit="cover"`).
+ * slides or while images load. Images are cropped to fill the frame
+ * (`fit="cover"`, the default) or letterboxed inside it (`fit="contain"`).
  *
  * Thumbnails are a fixed 52px. A `left`/`right` strip is exactly as tall as
  * the slide and a `bottom` strip exactly as wide; extra thumbnails scroll and
@@ -49,6 +49,12 @@ import { CarouselProps } from './types';
  *
  * @example
  * ```tsx
+ * // Open full size in a modal on the same page
+ * <Carousel items={items} allowOpenFull openFullMode="modal" />
+ * ```
+ *
+ * @example
+ * ```tsx
  * // Autoplay: 3s per slide, 600ms slide animation
  * <Carousel items={items} autoPlay autoPlayInterval={3000} transitionDuration={600} />
  * ```

package/dist/components/Carousel/FullImageModal.d.ts

@@ -0,0 +1,12 @@
+type FullImageModalProps = {
+    src: string;
+    alt?: string;
+    onClose: () => void;
+};
+/**
+ * The full-size image over a dimmed page, at its natural size but never more
+ * than 80% of the viewport. Escape, a click outside and the close button
+ * close it; focus moves in and returns to the open button.
+ */
+export declare const FullImageModal: ({ src, alt, onClose }: FullImageModalProps) => import("@emotion/react/jsx-runtime").JSX.Element;
+export {};

package/dist/components/Carousel/styles.d.ts

@@ -17,6 +17,11 @@ export declare const dots: import("@emotion/react").SerializedStyles;
 export declare const dot: (theme: Theme, active: boolean) => import("@emotion/react").SerializedStyles;
 export declare const arrows: import("@emotion/react").SerializedStyles;
 export declare const squareButton: (theme: Theme) => import("@emotion/react").SerializedStyles;
+export declare const fullOverlay: (theme: Theme) => import("@emotion/react").SerializedStyles;
+/** Shrinks to the image, which stops at 80% of the viewport either way. */
+export declare const fullDialog: import("@emotion/react").SerializedStyles;
+export declare const fullImage: import("@emotion/react").SerializedStyles;
+export declare const fullClose: import("@emotion/react").SerializedStyles;
 export declare const openFull: import("@emotion/react").SerializedStyles;
 /**
  * The vertical strip is taken out of flow so that it never stretches the

package/dist/components/Carousel/types.d.ts

@@ -18,7 +18,7 @@ export type CarouselItem = {
      */
     thumbnailSrc?: string;
     /**
-     * Full-size image opened in a new tab when `allowOpenFull` is set.
+     * Full-size image opened by the `allowOpenFull` button.
      * Falls back to `src`.
      */
     fullSrc?: string;
@@ -32,6 +32,11 @@ export type CarouselThumbnailsPosition = 'left' | 'right' | 'bottom' | false;
  * own row under it.
  */
 export type CarouselControlsPosition = 'overlay' | 'below';
+/**
+ * Where the `allowOpenFull` button opens the image: a new browser tab, or a
+ * modal over the current page.
+ */
+export type CarouselOpenFullMode = 'newTab' | 'modal';
 /**
  * How an image fills the slide frame. Mirrors CSS `object-fit`.
  */
@@ -71,11 +76,19 @@ export type CarouselProps = {
      */
     controlsPosition?: CarouselControlsPosition;
     /**
-     * Show a button that opens the current image (`fullSrc ?? src`) in a new
-     * tab. It appears when the slide is hovered or focused.
+     * Show a button that opens the current image (`fullSrc ?? src`), in a new
+     * tab or a modal (see `openFullMode`). It appears when the slide is hovered
+     * or focused.
      * @default false
      */
     allowOpenFull?: boolean;
+    /**
+     * Where the `allowOpenFull` button opens the image. `modal` shows it over a
+     * dimmed page at its natural size, capped at 80% of the viewport's width
+     * and height; autoplay pauses while it is open.
+     * @default 'newTab'
+     */
+    openFullMode?: CarouselOpenFullMode;
     /**
      * Width-to-height ratio of the slide. The slide always fills the
      * container's width; this sets its height. Ignored when `height` is set.
@@ -88,7 +101,7 @@ export type CarouselProps = {
     height?: CSSProperties['height'];
     /**
      * How images fill the slide frame.
-     * @default 'contain'
+     * @default 'cover'
      */
     fit?: CarouselFit;
     /**

package/dist/components/Charts/FunnelChart/FunnelChart.d.ts

@@ -2,8 +2,9 @@ import { FunnelChartProps } from './types';
 /**
  * FunnelChart - Stage diagram drawn as a funnel or a triangle
  *
- * Every level has the same height regardless of its value, so zero or
- * non-decreasing values never collapse or distort the shape. The chart scales
+ * By default every level has the same height regardless of its value, so zero
+ * or non-decreasing values never collapse or distort the shape. Set
+ * `proportional` to size levels by value instead. The chart scales
  * to fit its container — give the container a height, or it falls back to the
  * shape's own aspect ratio.
  *
@@ -21,4 +22,4 @@ import { FunnelChartProps } from './types';
  * />
  * ```
  */
-export declare const FunnelChart: ({ data, type, withPointer, withTooltip, withLabels, renderLabel, renderPointerLabel, renderTooltip, tooltipProps, className, "aria-label": ariaLabel, }: FunnelChartProps) => import("@emotion/react/jsx-runtime").JSX.Element;
+export declare const FunnelChart: ({ data, type, proportional, withPointer, withTooltip, withLabels, renderLabel, renderPointerLabel, renderTooltip, tooltipProps, className, "aria-label": ariaLabel, }: FunnelChartProps) => import("@emotion/react/jsx-runtime").JSX.Element;

package/dist/components/Charts/FunnelChart/types.d.ts

@@ -16,13 +16,23 @@ export interface FunnelChartItem {
 export type FunnelChartRender = (item: FunnelChartItem, index: number) => ReactNode;
 /** Props for the FunnelChart component */
 export interface FunnelChartProps {
-    /** Levels from top to bottom. Every level has the same height. */
+    /**
+     * Levels from top to bottom. Every level has the same height unless
+     * `proportional` is set.
+     */
     data: FunnelChartItem[];
     /**
      * Shape of the chart
      * @default 'funnel'
      */
     type?: FunnelChartType;
+    /**
+     * Size each level's height in proportion to its value, so bigger values
+     * get bigger levels. Zero and tiny values keep a minimum height (40% of
+     * an equal level) so their labels still fit; non-numeric values count as 0.
+     * @default false
+     */
+    proportional?: boolean;
     /**
      * Render a leader line and a label beside each level
      * @default false

package/dist/components/Charts/FunnelChart/utils.d.ts

@@ -8,6 +8,13 @@ type Point = {
     radius: number;
 };
 export declare const roundedPolygonPath: (points: Point[]) => string;
+/**
+ * Splits `total` between levels in proportion to `values`. Levels that would
+ * fall below the minimum get the minimum, and the rest share what is left in
+ * proportion to their values. Non-numeric and negative values count as 0;
+ * when nothing is positive every level gets the same height.
+ */
+export declare const getProportionalHeights: (values: (number | string)[], total: number) => number[];
 export interface FunnelBand {
     top: number;
     bottom: number;
@@ -21,5 +28,9 @@ export interface FunnelGeometry {
     /** Half-width of the shape at a given distance from the top */
     halfWidthAt: (y: number) => number;
 }
-export declare const getGeometry: (type: FunnelChartType, levels: number) => FunnelGeometry;
+/**
+ * Shape and level bands. Pass `heights` (summing to `DESIGN_HEIGHT`) to size
+ * the levels; otherwise they are equal.
+ */
+export declare const getGeometry: (type: FunnelChartType, levels: number, heights?: number[]) => FunnelGeometry;
 export {};

package/dist/components/FloatingActionButton/FloatingActionButton.d.ts

@@ -0,0 +1,79 @@
+import { FloatingActionButtonIcon, FloatingActionButtonSize } from './types';
+/**
+ * FloatingActionButton - A button fixed to a corner of the viewport for the
+ * page's primary action, optionally opening a speed-dial menu of related
+ * actions.
+ *
+ * ### Look
+ * Icon-only by default; pass `label` for the extended (icon + text) FAB.
+ * `color` takes the design's `primary` / `secondary`, a theme color key or
+ * any CSS color — for custom colors the icon and label color is chosen for
+ * contrast. `shadow` and `shape` are independent of the color.
+ *
+ * ### Menu
+ * Pass `actions` to turn the button into a menu trigger. The items stack
+ * away from the corner as secondary FABs of the same size; the trigger
+ * switches to `openIcon` while open. Choosing an item, Escape, a click
+ * outside or tabbing away closes the menu. Control it with `open` +
+ * `onOpenChange`, or leave it uncontrolled (`defaultOpen`).
+ *
+ * ### Icons
+ * A kit icon name is sized for the FAB and painted with its foreground color.
+ * Any other node is rendered as-is.
+ *
+ * @category Components
+ * @subcategory Buttons
+ *
+ * @example
+ * ```tsx
+ * <FloatingActionButton aria-label="Add member" onClick={addMember} />
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Extended, secondary, bottom-left
+ * <FloatingActionButton label="New report" color="secondary" position="bottom-left" />
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Speed-dial menu
+ * <FloatingActionButton
+ *   aria-label="Create"
+ *   actions={[
+ *     { id: 'task', icon: 'plus', label: 'Task', onClick: createTask },
+ *     { id: 'note', icon: 'edit', label: 'Note', onClick: createNote },
+ *   ]}
+ * />
+ * ```
+ *
+ * @accessibility
+ * - Icon-only FABs need an `aria-label` (a dev warning fires without one)
+ * - In menu mode the trigger has `aria-haspopup="menu"` and `aria-expanded`;
+ *   the items are `menuitem`s
+ * - Opening the menu from the keyboard focuses its first item; ↑/↓, Home and
+ *   End move between items (and from the trigger into the menu while it is
+ *   open); Escape closes it and returns focus to the trigger
+ */
+export declare const FloatingActionButton: import("react").ForwardRefExoticComponent<Pick<import("react").AriaAttributes, "aria-label" | "aria-describedby"> & {
+    icon?: FloatingActionButtonIcon;
+    label?: string;
+    color?: import("./types").FloatingActionButtonColor;
+    shadow?: boolean;
+    shape?: "square" | "round";
+    size?: FloatingActionButtonSize;
+    disabled?: boolean;
+    onClick?: import("react").MouseEventHandler<HTMLButtonElement>;
+    actions?: import("./types").FloatingActionButtonAction[];
+    showActionLabels?: boolean;
+    open?: boolean;
+    defaultOpen?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    openIcon?: FloatingActionButtonIcon;
+    position?: import("./types").FloatingActionButtonPosition;
+    offset?: number | {
+        x: number;
+        y: number;
+    };
+    className?: string;
+} & import("react").RefAttributes<HTMLButtonElement>>;

package/dist/components/FloatingActionButton/index.d.ts

@@ -0,0 +1 @@
+export * from './FloatingActionButton';

package/dist/components/FloatingActionButton/styles.d.ts

@@ -0,0 +1,42 @@
+import { Theme } from '@emotion/react';
+import { FloatingActionButtonColor, FloatingActionButtonPosition, FloatingActionButtonSize } from './types';
+type SizeTokens = {
+    /** Height, and width when icon-only. */
+    box: number;
+    /** Glyph size when icon-only. */
+    iconOnly: number;
+    /** Glyph size next to a label. */
+    iconLabelled: number;
+    paddingLeft: number;
+    paddingRight: number;
+    gap: number;
+    fontSize: number;
+    lineHeight: number;
+};
+/**
+ * Figma draws labelled FABs 4px taller than icon-only ones of the same size;
+ * that is a design bug, so both use the icon-only height here.
+ */
+export declare const SIZES: Record<FloatingActionButtonSize, SizeTokens>;
+export type ColorTokens = {
+    background: string;
+    hover: string;
+    active: string;
+    foreground: string;
+};
+/**
+ * Resolves `color` to the four colors a FAB paints with. The two named
+ * colors follow the design tokens; anything else is a theme key or CSS
+ * color whose foreground is picked for contrast.
+ */
+export declare const resolveColors: (theme: Theme, color: FloatingActionButtonColor) => ColorTokens;
+export declare const container: (position: FloatingActionButtonPosition, x: number, y: number) => import("@emotion/react").SerializedStyles;
+export declare const menu: (position: FloatingActionButtonPosition) => import("@emotion/react").SerializedStyles;
+export declare const button: (theme: Theme, { size, colors, shadow, round, labelled, }: {
+    size: FloatingActionButtonSize;
+    colors: ColorTokens;
+    shadow: boolean;
+    round: boolean;
+    labelled: boolean;
+}) => import("@emotion/react").SerializedStyles;
+export {};