@homebound/beam 3.20.1 → 3.21.1

package/dist/index.d.cts

@@ -6369,14 +6369,18 @@ declare function newMethodMissingProxy<T extends object, Y>(object: T, methodMis
  * Each filter is typically created by a factory function, i.e. `singleFilter`,
  * `multiFilter`, etc.
  */
+/** A set filter field value — null and undefined excluded (matches the `V` in `Filter<V>` for that field). */
+type DefinedFilterValue<F, K extends keyof F> = Exclude<F[K], null | undefined>;
 type FilterDefs<F> = {
-    [K in keyof F]: (key: string) => Filter<Exclude<F[K], null | undefined>>;
+    [K in keyof F]: (key: string) => Filter<DefinedFilterValue<F, K>>;
 };
 type FilterImpls<F> = {
-    [K in keyof F]: Filter<Exclude<F[K], null | undefined>>;
+    [K in keyof F]: Filter<DefinedFilterValue<F, K>>;
 };
+/** Value shape passed when resolving a display label for one active selection (array filters: a single element). */
+type SelectedFilterLabelValue<V> = V extends readonly (infer E)[] ? E : V;
 /** A filter instance that knows how to render itself within the `Filters` component. */
-interface Filter<V> {
+type Filter<V> = {
     label: string;
     hideLabelInModal?: boolean;
     /** The default value to use in `usePersistedFilter` for creating the initial filter. */
@@ -6395,9 +6399,11 @@ interface Filter<V> {
      * backwards-compatible serialized formats when needed.
      */
     dehydrate?(value: V | undefined): unknown;
+    /** Returns the human-readable label for an active filter value, or undefined when the value should not produce a chip. */
+    formatSelectedFilterLabel(value: SelectedFilterLabelValue<V>): string | undefined;
     /** Renders the filter into either the page or the modal. */
     render(value: V | undefined, setValue: (value: V | undefined) => void, tid: TestIds, inModal: boolean, vertical: boolean): JSX.Element;
-}
+};
 
 type TextFieldBaseProps<X> = {
     labelProps?: LabelHTMLAttributes<HTMLLabelElement>;
@@ -7160,11 +7166,11 @@ declare class BaseFilter<V, P extends {
 }
 
 type BooleanOption = [boolean | undefined, string];
-interface BooleanFilterProps {
+type BooleanFilterProps = {
     options?: BooleanOption[];
     label?: string;
     defaultValue?: undefined | boolean;
-}
+};
 declare function booleanFilter(props: BooleanFilterProps): (key: string) => Filter<boolean>;
 
 type CheckboxFilterProps<V> = {
@@ -7187,9 +7193,9 @@ type CheckboxFilterProps<V> = {
 declare function checkboxFilter<V = boolean>(props: CheckboxFilterProps<V>): (key: string) => Filter<V>;
 
 /** Props for the search box integrated into FilterDropdownMenu. */
-interface SearchBoxProps {
+type SearchBoxProps = {
     onSearch: (filter: string) => void;
-}
+};
 /**
  * FilterDropdownMenu is a newer filter UI pattern that shows a "Filter" button
  * which expands to reveal filter controls in a row below, with chips displayed
@@ -7203,7 +7209,7 @@ interface SearchBoxProps {
  * Note: We expect the existing `Filters` component to eventually become
  * `FilterDropdownMenu`, but it hasn't been rolled out everywhere yet.
  */
-interface FilterDropdownMenuProps<F extends Record<string, unknown>, G extends Value = string> {
+type FilterDropdownMenuProps<F extends Record<string, unknown>, G extends Value = string> = {
     /** List of filters. When omitted, no filter UI is rendered. */
     filterDefs?: FilterDefs<F>;
     /** The current filter value. */
@@ -7223,7 +7229,7 @@ interface FilterDropdownMenuProps<F extends Record<string, unknown>, G extends V
     };
     /** When provided, renders a search box before the filter controls. */
     searchProps?: SearchBoxProps;
-}
+};
 declare function FilterDropdownMenu<F extends Record<string, unknown>, G extends Value = string>(props: FilterDropdownMenuProps<F, G>): JSX.Element;
 declare const _FilterDropdownMenu: typeof FilterDropdownMenu;
 
@@ -8942,4 +8948,4 @@ declare const zIndices: {
 };
 type ZIndex = (typeof zIndices)[keyof typeof zIndices];
 
-export { ASC, Accordion, AccordionList, type AccordionProps, type AccordionSize, type ActionButtonProps, type AppNavGroup, type AppNavItem, type AppNavLink, type AppNavSection, type AppNavSectionItem, AutoSaveIndicator, AutoSaveStatus, AutoSaveStatusContext, AutoSaveStatusProvider, Autocomplete, type AutocompleteProps, Avatar, AvatarButton, type AvatarButtonProps, AvatarGroup, type AvatarGroupProps, type AvatarProps, type AvatarSize, Banner, type BannerProps, type BannerTypes, BaseFilter, type BaseQueryTableProps, type BaseTableProps, type BeamButtonProps, type BeamColor, type BeamFocusableProps, BeamProvider, type BeamTextFieldProps, BoundCheckboxField, type BoundCheckboxFieldProps, BoundCheckboxGroupField, type BoundCheckboxGroupFieldProps, BoundChipSelectField, BoundDateField, type BoundDateFieldProps, BoundDateRangeField, type BoundDateRangeFieldProps, BoundForm, type BoundFormInputConfig, type BoundFormProps, type BoundFormRowInputs, BoundIconCardField, type BoundIconCardFieldProps, BoundIconCardGroupField, type BoundIconCardGroupFieldProps, BoundMultiLineSelectField, type BoundMultiLineSelectFieldProps, BoundMultiSelectField, type BoundMultiSelectFieldProps, BoundNumberField, type BoundNumberFieldProps, BoundRadioGroupField, type BoundRadioGroupFieldProps, BoundRichTextField, type BoundRichTextFieldProps, BoundSelectAndTextField, BoundSelectField, type BoundSelectFieldProps, BoundSwitchField, type BoundSwitchFieldProps, BoundTextAreaField, type BoundTextAreaFieldProps, BoundTextField, type BoundTextFieldProps, BoundToggleChipGroupField, type BoundToggleChipGroupFieldProps, BoundTreeSelectField, type BoundTreeSelectFieldProps, type Breakpoint, Breakpoints, type BuildtimeStyles, Button, ButtonDatePicker, ButtonGroup, type ButtonGroupButton, type ButtonGroupProps, ButtonMenu, type ButtonMenuProps, ButtonModal, type ButtonModalProps, type ButtonProps, type ButtonSize, type ButtonVariant, Card, type CardProps, type CardTag, type CardType, type CheckFn, Checkbox, CheckboxGroup, type CheckboxGroupItemOption, type CheckboxGroupProps, type CheckboxProps, Chip, type ChipProps, ChipSelectField, type ChipSelectFieldProps, type ChipType, ChipTypes, type ChipValue, Chips, type ChipsProps, CollapseToggle, CollapsedContext, type ColumnLayoutResult, ConfirmCloseModal, type ContentStack, ContrastScope, Copy, CountBadge, type CountBadgeProps, Css, CssReset, type CssSetVarKeys, type CssSetVarScalar, type CssSetVarValue, DESC, DateField, type DateFieldFormat, type DateFieldMode, type DateFieldProps, type DateFilterValue, type DateMatcher, type DateRange, DateRangeField, type DateRangeFieldProps, type DateRangeFilterValue, type Direction, type DiscriminateUnion, type DividerMenuItemType, DnDGrid, DnDGridItemHandle, type DnDGridItemHandleProps, type DnDGridItemProps, type DnDGridProps, type DragData, EXPANDABLE_HEADER, EditColumnsButton, ErrorMessage, FieldGroup, type Filter, type FilterDefs, _FilterDropdownMenu as FilterDropdownMenu, type FilterImpls, FilterModal, _Filters as Filters, type Font, FormDivider, FormHeading, type FormHeadingProps, FormLines, type FormLinesProps, FormPageLayout, FormRow, type FormSectionConfig, type FormWidth, FullBleed, type GridCellAlignment, type GridCellContent, type GridColumn, type GridColumnBorder, type GridColumnWithId, type GridDataRow, type GridRowKind, type GridRowLookup, type GridSortConfig, type GridStyle, GridTable, type GridTableApi, type GridTableCollapseToggleProps, type GridTableDefaults, GridTableLayout, type GridTableLayoutProps, type GridTableProps, type GridTablePropsWithRows, type GridTableScrollOptions, type GridTableXss, type GroupByHook, HB_QUIPS_FLAVOR, HB_QUIPS_MISSION, HEADER, type HasIdAndName, HbLoadingSpinner, HbSpinnerProvider, HelperText, HomeboundLogo, Icon, IconButton, type IconButtonProps, type IconButtonVariant, IconCard, type IconCardProps, type IconKey, type IconMenuItemType, type IconProps, Icons, type IfAny, type ImageFitType, type ImageMenuItemType, type InfiniteScroll, type InlineStyle, type InputStylePalette, KEPT_GROUP, type Kinded, Loader, LoadingSkeleton, type LoadingSkeletonProps, type Margin, type Marker, MaxLines, type MaxLinesProps, type MaybeFn, type MenuItem, type MenuSection, ModalBody, ModalFilterItem, ModalFooter, ModalHeader, type ModalProps, type ModalSize, MultiLineSelectField, type MultiLineSelectFieldProps, MultiSelectField, type MultiSelectFieldProps, NavLink, type NavLinkProps, type NavLinkVariant, Navbar, NavbarLayout, type NavbarLayoutProps, type NavbarProps, type NavbarUser, type NestedOption, type NestedOptionsOrLoad, NumberField, type NumberFieldProps, type NumberFieldType, type OffsetAndLimit, type OnRowDragEvent, type OnRowSelect, type Only, type OpenDetailOpts, type OpenInDrawerOpts, OpenModal, type OpenRightPaneOpts, type Optional, type Padding, PageHeader, PageHeaderLayout, type PageHeaderLayoutProps, type PageHeaderProps, type PageNumberAndSize, type PageSettings, Pagination, type PaginationConfig, Palette, type Pin, type Placement, type PlainDate, type PresentationFieldProps, PresentationProvider, PreventBrowserScroll, type Properties, RIGHT_SIDEBAR_MIN_WIDTH, type RadioFieldOption, RadioGroupField, type RadioGroupFieldProps, type RenderAs, type RenderCellFn, ResponsiveGrid, type ResponsiveGridConfig, ResponsiveGridContext, ResponsiveGridItem, type ResponsiveGridItemProps, type ResponsiveGridProps, RichTextField, RichTextFieldImpl, type RichTextFieldProps, RightPaneContext, RightPaneLayout, type RightPaneLayoutContextProps, RightPaneProvider, RightSidebar, type RightSidebarProps, type RouteTab, type RouteTabWithContent, Row, type RowStyle, type RowStyles, RuntimeCss, type RuntimeStyles, SIDE_NAV_LAYOUT_STATE_STORAGE_KEY, ScrollShadows, ScrollableContent, ScrollableFooter, ScrollableParent, SelectField, type SelectFieldProps, SelectToggle, type SelectedState, SideNav, SideNavLayout, type SideNavLayoutContextProps, type SideNavLayoutProps, SideNavLayoutProvider, type SideNavLayoutState, type SideNavProps, type SidePanelProps, type SidebarContentProps, type SimpleHeaderAndData, SortHeader, type SortOn, type SortState, StaticField, type Step, Stepper, type StepperProps, type StyleKind, SubmitButton, type SubmitButtonProps, SuperDrawerContent, SuperDrawerHeader, SuperDrawerWidth, type SupportedDateFormat, Switch, type SwitchProps, TOTALS, type Tab, TabContent, type TabWithContent, TableReviewLayout, type TableReviewLayoutProps, TableState, TableStateContext, type TableView, Tabs, TabsWithContent, Tag, type TagType, type TestIds, TextAreaField, type TextAreaFieldProps, TextField, type TextFieldApi, type TextFieldInternalProps, type TextFieldProps, type TextFieldXss, Toast, ToggleButton, type ToggleButtonProps, ToggleChip, ToggleChipGroup, type ToggleChipGroupProps, type ToggleChipProps, ToggleChips, type ToggleChipsProps, Tokens, Tooltip, TreeSelectField, type TreeSelectFieldProps, type TriggerNoticeProps, type Typography, type UseModalHook, type UsePersistedFilterProps, type UseQueryState, type UseRightPaneHook, type UseSnackbarHook, type UseSuperDrawerHook, type UseToastProps, type Value, ViewToggleButton, type Xss, type ZIndex, actionColumn, applyRowFn, assignDefaultColumnIds, beamLayoutViewportHeightVar, beamLayoutViewportWidthVar, beamNavbarLayoutHeightVar, beamPageHeaderLayoutHeightVar, beamSideNavLayoutWidthVar, beamTableActionsHeightVar, booleanFilter, boundCheckboxField, boundCheckboxGroupField, boundDateField, boundDateRangeField, boundIconCardField, boundIconCardGroupField, boundMultiSelectField, boundMultilineSelectField, boundNumberField, boundRadioGroupField, boundRichTextField, boundSelectField, boundSwitchField, boundTextAreaField, boundTextField, boundToggleChipGroupField, boundTreeSelectField, calcColumnLayout, calcColumnSizes, cardStyle, checkboxFilter, chipBaseStyles, chipDisabledStyles, chipHoverOnlyStyles, chipHoverStyles, collapseColumn, column, condensedStyle, contrastDataTheme, createRowLookup, dateColumn, dateFilter, dateFormats, dateRangeFilter, defaultPage, defaultRenderFn, defaultStyle, defaultTestId, documentScrollChromeLeft, documentScrollChromeWidth, dragHandleColumn, emptyCell, ensureClientSideSortValueIsSortable, filterTestIdPrefix, formatDate, formatDateRange, formatPlainDate, formatValue, generateColumnId, getAlignment, getColumnBorderCss, getDateFormat, getFirstOrLastCellCss, getJustification, getNavLinkStyles, getTableRefWidthStyles, getTableStyles, headerRenderFn, hoverStyles, iconButtonCircleStylesHover, iconButtonContrastStylesHover, iconButtonStylesHover, iconCardStylesHover, increment, insertAtIndex, isCursorBelowMidpoint, isGridCellContent, isGridTableProps, isJSX, isListBoxSection, isPersistentItem, isPersistentKey, isValidDate, listFieldPrefix, loadArrayOrUndefined, marker, matchesFilter, maybeCssVar, maybeInc, maybeTooltip, multiFilter, navLink, newMethodMissingProxy, nonKindGridColumnKeys, numberRangeFilter, numericColumn, parseDate, parseDateRange, parseWidthToPx, persistentItemPrefix, pressedOverlayCss, px, recursivelyGetContainingRow, reservedRowKinds, resolveTableContentWidth, resolveTooltip, rowClickRenderFn, rowLinkRenderFn, selectColumn, selectedStyles, setDefaultStyle, setGridTableDefaults, setRunningInJest, shouldSkipScrollTo, simpleDataRows, simpleHeader, singleFilter, sortFn, sortRows, stickyNavAndHeaderOffset, stickyTableHeaderOffset, sumColumnSizesPx, switchFocusStyles, switchHoverStyles, switchSelectedHoverStyles, toContent, toLimitAndOffset, toPageNumberSize, toggleFilter, toggleFocusStyles, toggleHoverStyles, togglePressStyles, treeFilter, updateFilter, useAutoSaveStatus, useBreakpoint, useComputed, useContentOverflow, useContrastScope, useDnDGridItem, type useDnDGridItemProps, useFilter, useGridTableApi, useGridTableLayoutState, useGroupBy, useHasSideNavLayoutProvider, useHover, useModal, usePersistedFilter, useQueryState, useResponsiveGrid, useResponsiveGridItem, type useResponsiveGridProps, useRightPane, useRightPaneContext, useRuntimeStyle, useScrollableParent, useSessionStorage, useSetupColumnSizes, useSideNavLayoutContext, useSnackbar, useSuperDrawer, useTestIds, useToast, useTreeSelectFieldProvider, useVirtualizedScrollParent, visit, zIndices };
+export { ASC, Accordion, AccordionList, type AccordionProps, type AccordionSize, type ActionButtonProps, type AppNavGroup, type AppNavItem, type AppNavLink, type AppNavSection, type AppNavSectionItem, AutoSaveIndicator, AutoSaveStatus, AutoSaveStatusContext, AutoSaveStatusProvider, Autocomplete, type AutocompleteProps, Avatar, AvatarButton, type AvatarButtonProps, AvatarGroup, type AvatarGroupProps, type AvatarProps, type AvatarSize, Banner, type BannerProps, type BannerTypes, BaseFilter, type BaseQueryTableProps, type BaseTableProps, type BeamButtonProps, type BeamColor, type BeamFocusableProps, BeamProvider, type BeamTextFieldProps, BoundCheckboxField, type BoundCheckboxFieldProps, BoundCheckboxGroupField, type BoundCheckboxGroupFieldProps, BoundChipSelectField, BoundDateField, type BoundDateFieldProps, BoundDateRangeField, type BoundDateRangeFieldProps, BoundForm, type BoundFormInputConfig, type BoundFormProps, type BoundFormRowInputs, BoundIconCardField, type BoundIconCardFieldProps, BoundIconCardGroupField, type BoundIconCardGroupFieldProps, BoundMultiLineSelectField, type BoundMultiLineSelectFieldProps, BoundMultiSelectField, type BoundMultiSelectFieldProps, BoundNumberField, type BoundNumberFieldProps, BoundRadioGroupField, type BoundRadioGroupFieldProps, BoundRichTextField, type BoundRichTextFieldProps, BoundSelectAndTextField, BoundSelectField, type BoundSelectFieldProps, BoundSwitchField, type BoundSwitchFieldProps, BoundTextAreaField, type BoundTextAreaFieldProps, BoundTextField, type BoundTextFieldProps, BoundToggleChipGroupField, type BoundToggleChipGroupFieldProps, BoundTreeSelectField, type BoundTreeSelectFieldProps, type Breakpoint, Breakpoints, type BuildtimeStyles, Button, ButtonDatePicker, ButtonGroup, type ButtonGroupButton, type ButtonGroupProps, ButtonMenu, type ButtonMenuProps, ButtonModal, type ButtonModalProps, type ButtonProps, type ButtonSize, type ButtonVariant, Card, type CardProps, type CardTag, type CardType, type CheckFn, Checkbox, CheckboxGroup, type CheckboxGroupItemOption, type CheckboxGroupProps, type CheckboxProps, Chip, type ChipProps, ChipSelectField, type ChipSelectFieldProps, type ChipType, ChipTypes, type ChipValue, Chips, type ChipsProps, CollapseToggle, CollapsedContext, type ColumnLayoutResult, ConfirmCloseModal, type ContentStack, ContrastScope, Copy, CountBadge, type CountBadgeProps, Css, CssReset, type CssSetVarKeys, type CssSetVarScalar, type CssSetVarValue, DESC, DateField, type DateFieldFormat, type DateFieldMode, type DateFieldProps, type DateFilterValue, type DateMatcher, type DateRange, DateRangeField, type DateRangeFieldProps, type DateRangeFilterValue, type DefinedFilterValue, type Direction, type DiscriminateUnion, type DividerMenuItemType, DnDGrid, DnDGridItemHandle, type DnDGridItemHandleProps, type DnDGridItemProps, type DnDGridProps, type DragData, EXPANDABLE_HEADER, EditColumnsButton, ErrorMessage, FieldGroup, type Filter, type FilterDefs, _FilterDropdownMenu as FilterDropdownMenu, type FilterImpls, FilterModal, _Filters as Filters, type Font, FormDivider, FormHeading, type FormHeadingProps, FormLines, type FormLinesProps, FormPageLayout, FormRow, type FormSectionConfig, type FormWidth, FullBleed, type GridCellAlignment, type GridCellContent, type GridColumn, type GridColumnBorder, type GridColumnWithId, type GridDataRow, type GridRowKind, type GridRowLookup, type GridSortConfig, type GridStyle, GridTable, type GridTableApi, type GridTableCollapseToggleProps, type GridTableDefaults, GridTableLayout, type GridTableLayoutProps, type GridTableProps, type GridTablePropsWithRows, type GridTableScrollOptions, type GridTableXss, type GroupByHook, HB_QUIPS_FLAVOR, HB_QUIPS_MISSION, HEADER, type HasIdAndName, HbLoadingSpinner, HbSpinnerProvider, HelperText, HomeboundLogo, Icon, IconButton, type IconButtonProps, type IconButtonVariant, IconCard, type IconCardProps, type IconKey, type IconMenuItemType, type IconProps, Icons, type IfAny, type ImageFitType, type ImageMenuItemType, type InfiniteScroll, type InlineStyle, type InputStylePalette, KEPT_GROUP, type Kinded, Loader, LoadingSkeleton, type LoadingSkeletonProps, type Margin, type Marker, MaxLines, type MaxLinesProps, type MaybeFn, type MenuItem, type MenuSection, ModalBody, ModalFilterItem, ModalFooter, ModalHeader, type ModalProps, type ModalSize, MultiLineSelectField, type MultiLineSelectFieldProps, MultiSelectField, type MultiSelectFieldProps, NavLink, type NavLinkProps, type NavLinkVariant, Navbar, NavbarLayout, type NavbarLayoutProps, type NavbarProps, type NavbarUser, type NestedOption, type NestedOptionsOrLoad, NumberField, type NumberFieldProps, type NumberFieldType, type OffsetAndLimit, type OnRowDragEvent, type OnRowSelect, type Only, type OpenDetailOpts, type OpenInDrawerOpts, OpenModal, type OpenRightPaneOpts, type Optional, type Padding, PageHeader, PageHeaderLayout, type PageHeaderLayoutProps, type PageHeaderProps, type PageNumberAndSize, type PageSettings, Pagination, type PaginationConfig, Palette, type Pin, type Placement, type PlainDate, type PresentationFieldProps, PresentationProvider, PreventBrowserScroll, type Properties, RIGHT_SIDEBAR_MIN_WIDTH, type RadioFieldOption, RadioGroupField, type RadioGroupFieldProps, type RenderAs, type RenderCellFn, ResponsiveGrid, type ResponsiveGridConfig, ResponsiveGridContext, ResponsiveGridItem, type ResponsiveGridItemProps, type ResponsiveGridProps, RichTextField, RichTextFieldImpl, type RichTextFieldProps, RightPaneContext, RightPaneLayout, type RightPaneLayoutContextProps, RightPaneProvider, RightSidebar, type RightSidebarProps, type RouteTab, type RouteTabWithContent, Row, type RowStyle, type RowStyles, RuntimeCss, type RuntimeStyles, SIDE_NAV_LAYOUT_STATE_STORAGE_KEY, ScrollShadows, ScrollableContent, ScrollableFooter, ScrollableParent, SelectField, type SelectFieldProps, SelectToggle, type SelectedFilterLabelValue, type SelectedState, SideNav, SideNavLayout, type SideNavLayoutContextProps, type SideNavLayoutProps, SideNavLayoutProvider, type SideNavLayoutState, type SideNavProps, type SidePanelProps, type SidebarContentProps, type SimpleHeaderAndData, SortHeader, type SortOn, type SortState, StaticField, type Step, Stepper, type StepperProps, type StyleKind, SubmitButton, type SubmitButtonProps, SuperDrawerContent, SuperDrawerHeader, SuperDrawerWidth, type SupportedDateFormat, Switch, type SwitchProps, TOTALS, type Tab, TabContent, type TabWithContent, TableReviewLayout, type TableReviewLayoutProps, TableState, TableStateContext, type TableView, Tabs, TabsWithContent, Tag, type TagType, type TestIds, TextAreaField, type TextAreaFieldProps, TextField, type TextFieldApi, type TextFieldInternalProps, type TextFieldProps, type TextFieldXss, Toast, ToggleButton, type ToggleButtonProps, ToggleChip, ToggleChipGroup, type ToggleChipGroupProps, type ToggleChipProps, ToggleChips, type ToggleChipsProps, Tokens, Tooltip, TreeSelectField, type TreeSelectFieldProps, type TriggerNoticeProps, type Typography, type UseModalHook, type UsePersistedFilterProps, type UseQueryState, type UseRightPaneHook, type UseSnackbarHook, type UseSuperDrawerHook, type UseToastProps, type Value, ViewToggleButton, type Xss, type ZIndex, actionColumn, applyRowFn, assignDefaultColumnIds, beamLayoutViewportHeightVar, beamLayoutViewportWidthVar, beamNavbarLayoutHeightVar, beamPageHeaderLayoutHeightVar, beamSideNavLayoutWidthVar, beamTableActionsHeightVar, booleanFilter, boundCheckboxField, boundCheckboxGroupField, boundDateField, boundDateRangeField, boundIconCardField, boundIconCardGroupField, boundMultiSelectField, boundMultilineSelectField, boundNumberField, boundRadioGroupField, boundRichTextField, boundSelectField, boundSwitchField, boundTextAreaField, boundTextField, boundToggleChipGroupField, boundTreeSelectField, calcColumnLayout, calcColumnSizes, cardStyle, checkboxFilter, chipBaseStyles, chipDisabledStyles, chipHoverOnlyStyles, chipHoverStyles, collapseColumn, column, condensedStyle, contrastDataTheme, createRowLookup, dateColumn, dateFilter, dateFormats, dateRangeFilter, defaultPage, defaultRenderFn, defaultStyle, defaultTestId, documentScrollChromeLeft, documentScrollChromeWidth, dragHandleColumn, emptyCell, ensureClientSideSortValueIsSortable, filterTestIdPrefix, formatDate, formatDateRange, formatPlainDate, formatValue, generateColumnId, getAlignment, getColumnBorderCss, getDateFormat, getFirstOrLastCellCss, getJustification, getNavLinkStyles, getTableRefWidthStyles, getTableStyles, headerRenderFn, hoverStyles, iconButtonCircleStylesHover, iconButtonContrastStylesHover, iconButtonStylesHover, iconCardStylesHover, increment, insertAtIndex, isCursorBelowMidpoint, isGridCellContent, isGridTableProps, isJSX, isListBoxSection, isPersistentItem, isPersistentKey, isValidDate, listFieldPrefix, loadArrayOrUndefined, marker, matchesFilter, maybeCssVar, maybeInc, maybeTooltip, multiFilter, navLink, newMethodMissingProxy, nonKindGridColumnKeys, numberRangeFilter, numericColumn, parseDate, parseDateRange, parseWidthToPx, persistentItemPrefix, pressedOverlayCss, px, recursivelyGetContainingRow, reservedRowKinds, resolveTableContentWidth, resolveTooltip, rowClickRenderFn, rowLinkRenderFn, selectColumn, selectedStyles, setDefaultStyle, setGridTableDefaults, setRunningInJest, shouldSkipScrollTo, simpleDataRows, simpleHeader, singleFilter, sortFn, sortRows, stickyNavAndHeaderOffset, stickyTableHeaderOffset, sumColumnSizesPx, switchFocusStyles, switchHoverStyles, switchSelectedHoverStyles, toContent, toLimitAndOffset, toPageNumberSize, toggleFilter, toggleFocusStyles, toggleHoverStyles, togglePressStyles, treeFilter, updateFilter, useAutoSaveStatus, useBreakpoint, useComputed, useContentOverflow, useContrastScope, useDnDGridItem, type useDnDGridItemProps, useFilter, useGridTableApi, useGridTableLayoutState, useGroupBy, useHasSideNavLayoutProvider, useHover, useModal, usePersistedFilter, useQueryState, useResponsiveGrid, useResponsiveGridItem, type useResponsiveGridProps, useRightPane, useRightPaneContext, useRuntimeStyle, useScrollableParent, useSessionStorage, useSetupColumnSizes, useSideNavLayoutContext, useSnackbar, useSuperDrawer, useTestIds, useToast, useTreeSelectFieldProvider, useVirtualizedScrollParent, visit, zIndices };

package/dist/index.d.ts

@@ -6369,14 +6369,18 @@ declare function newMethodMissingProxy<T extends object, Y>(object: T, methodMis
  * Each filter is typically created by a factory function, i.e. `singleFilter`,
  * `multiFilter`, etc.
  */
+/** A set filter field value — null and undefined excluded (matches the `V` in `Filter<V>` for that field). */
+type DefinedFilterValue<F, K extends keyof F> = Exclude<F[K], null | undefined>;
 type FilterDefs<F> = {
-    [K in keyof F]: (key: string) => Filter<Exclude<F[K], null | undefined>>;
+    [K in keyof F]: (key: string) => Filter<DefinedFilterValue<F, K>>;
 };
 type FilterImpls<F> = {
-    [K in keyof F]: Filter<Exclude<F[K], null | undefined>>;
+    [K in keyof F]: Filter<DefinedFilterValue<F, K>>;
 };
+/** Value shape passed when resolving a display label for one active selection (array filters: a single element). */
+type SelectedFilterLabelValue<V> = V extends readonly (infer E)[] ? E : V;
 /** A filter instance that knows how to render itself within the `Filters` component. */
-interface Filter<V> {
+type Filter<V> = {
     label: string;
     hideLabelInModal?: boolean;
     /** The default value to use in `usePersistedFilter` for creating the initial filter. */
@@ -6395,9 +6399,11 @@ interface Filter<V> {
      * backwards-compatible serialized formats when needed.
      */
     dehydrate?(value: V | undefined): unknown;
+    /** Returns the human-readable label for an active filter value, or undefined when the value should not produce a chip. */
+    formatSelectedFilterLabel(value: SelectedFilterLabelValue<V>): string | undefined;
     /** Renders the filter into either the page or the modal. */
     render(value: V | undefined, setValue: (value: V | undefined) => void, tid: TestIds, inModal: boolean, vertical: boolean): JSX.Element;
-}
+};
 
 type TextFieldBaseProps<X> = {
     labelProps?: LabelHTMLAttributes<HTMLLabelElement>;
@@ -7160,11 +7166,11 @@ declare class BaseFilter<V, P extends {
 }
 
 type BooleanOption = [boolean | undefined, string];
-interface BooleanFilterProps {
+type BooleanFilterProps = {
     options?: BooleanOption[];
     label?: string;
     defaultValue?: undefined | boolean;
-}
+};
 declare function booleanFilter(props: BooleanFilterProps): (key: string) => Filter<boolean>;
 
 type CheckboxFilterProps<V> = {
@@ -7187,9 +7193,9 @@ type CheckboxFilterProps<V> = {
 declare function checkboxFilter<V = boolean>(props: CheckboxFilterProps<V>): (key: string) => Filter<V>;
 
 /** Props for the search box integrated into FilterDropdownMenu. */
-interface SearchBoxProps {
+type SearchBoxProps = {
     onSearch: (filter: string) => void;
-}
+};
 /**
  * FilterDropdownMenu is a newer filter UI pattern that shows a "Filter" button
  * which expands to reveal filter controls in a row below, with chips displayed
@@ -7203,7 +7209,7 @@ interface SearchBoxProps {
  * Note: We expect the existing `Filters` component to eventually become
  * `FilterDropdownMenu`, but it hasn't been rolled out everywhere yet.
  */
-interface FilterDropdownMenuProps<F extends Record<string, unknown>, G extends Value = string> {
+type FilterDropdownMenuProps<F extends Record<string, unknown>, G extends Value = string> = {
     /** List of filters. When omitted, no filter UI is rendered. */
     filterDefs?: FilterDefs<F>;
     /** The current filter value. */
@@ -7223,7 +7229,7 @@ interface FilterDropdownMenuProps<F extends Record<string, unknown>, G extends V
     };
     /** When provided, renders a search box before the filter controls. */
     searchProps?: SearchBoxProps;
-}
+};
 declare function FilterDropdownMenu<F extends Record<string, unknown>, G extends Value = string>(props: FilterDropdownMenuProps<F, G>): JSX.Element;
 declare const _FilterDropdownMenu: typeof FilterDropdownMenu;
 
@@ -8942,4 +8948,4 @@ declare const zIndices: {
 };
 type ZIndex = (typeof zIndices)[keyof typeof zIndices];
 
-export { ASC, Accordion, AccordionList, type AccordionProps, type AccordionSize, type ActionButtonProps, type AppNavGroup, type AppNavItem, type AppNavLink, type AppNavSection, type AppNavSectionItem, AutoSaveIndicator, AutoSaveStatus, AutoSaveStatusContext, AutoSaveStatusProvider, Autocomplete, type AutocompleteProps, Avatar, AvatarButton, type AvatarButtonProps, AvatarGroup, type AvatarGroupProps, type AvatarProps, type AvatarSize, Banner, type BannerProps, type BannerTypes, BaseFilter, type BaseQueryTableProps, type BaseTableProps, type BeamButtonProps, type BeamColor, type BeamFocusableProps, BeamProvider, type BeamTextFieldProps, BoundCheckboxField, type BoundCheckboxFieldProps, BoundCheckboxGroupField, type BoundCheckboxGroupFieldProps, BoundChipSelectField, BoundDateField, type BoundDateFieldProps, BoundDateRangeField, type BoundDateRangeFieldProps, BoundForm, type BoundFormInputConfig, type BoundFormProps, type BoundFormRowInputs, BoundIconCardField, type BoundIconCardFieldProps, BoundIconCardGroupField, type BoundIconCardGroupFieldProps, BoundMultiLineSelectField, type BoundMultiLineSelectFieldProps, BoundMultiSelectField, type BoundMultiSelectFieldProps, BoundNumberField, type BoundNumberFieldProps, BoundRadioGroupField, type BoundRadioGroupFieldProps, BoundRichTextField, type BoundRichTextFieldProps, BoundSelectAndTextField, BoundSelectField, type BoundSelectFieldProps, BoundSwitchField, type BoundSwitchFieldProps, BoundTextAreaField, type BoundTextAreaFieldProps, BoundTextField, type BoundTextFieldProps, BoundToggleChipGroupField, type BoundToggleChipGroupFieldProps, BoundTreeSelectField, type BoundTreeSelectFieldProps, type Breakpoint, Breakpoints, type BuildtimeStyles, Button, ButtonDatePicker, ButtonGroup, type ButtonGroupButton, type ButtonGroupProps, ButtonMenu, type ButtonMenuProps, ButtonModal, type ButtonModalProps, type ButtonProps, type ButtonSize, type ButtonVariant, Card, type CardProps, type CardTag, type CardType, type CheckFn, Checkbox, CheckboxGroup, type CheckboxGroupItemOption, type CheckboxGroupProps, type CheckboxProps, Chip, type ChipProps, ChipSelectField, type ChipSelectFieldProps, type ChipType, ChipTypes, type ChipValue, Chips, type ChipsProps, CollapseToggle, CollapsedContext, type ColumnLayoutResult, ConfirmCloseModal, type ContentStack, ContrastScope, Copy, CountBadge, type CountBadgeProps, Css, CssReset, type CssSetVarKeys, type CssSetVarScalar, type CssSetVarValue, DESC, DateField, type DateFieldFormat, type DateFieldMode, type DateFieldProps, type DateFilterValue, type DateMatcher, type DateRange, DateRangeField, type DateRangeFieldProps, type DateRangeFilterValue, type Direction, type DiscriminateUnion, type DividerMenuItemType, DnDGrid, DnDGridItemHandle, type DnDGridItemHandleProps, type DnDGridItemProps, type DnDGridProps, type DragData, EXPANDABLE_HEADER, EditColumnsButton, ErrorMessage, FieldGroup, type Filter, type FilterDefs, _FilterDropdownMenu as FilterDropdownMenu, type FilterImpls, FilterModal, _Filters as Filters, type Font, FormDivider, FormHeading, type FormHeadingProps, FormLines, type FormLinesProps, FormPageLayout, FormRow, type FormSectionConfig, type FormWidth, FullBleed, type GridCellAlignment, type GridCellContent, type GridColumn, type GridColumnBorder, type GridColumnWithId, type GridDataRow, type GridRowKind, type GridRowLookup, type GridSortConfig, type GridStyle, GridTable, type GridTableApi, type GridTableCollapseToggleProps, type GridTableDefaults, GridTableLayout, type GridTableLayoutProps, type GridTableProps, type GridTablePropsWithRows, type GridTableScrollOptions, type GridTableXss, type GroupByHook, HB_QUIPS_FLAVOR, HB_QUIPS_MISSION, HEADER, type HasIdAndName, HbLoadingSpinner, HbSpinnerProvider, HelperText, HomeboundLogo, Icon, IconButton, type IconButtonProps, type IconButtonVariant, IconCard, type IconCardProps, type IconKey, type IconMenuItemType, type IconProps, Icons, type IfAny, type ImageFitType, type ImageMenuItemType, type InfiniteScroll, type InlineStyle, type InputStylePalette, KEPT_GROUP, type Kinded, Loader, LoadingSkeleton, type LoadingSkeletonProps, type Margin, type Marker, MaxLines, type MaxLinesProps, type MaybeFn, type MenuItem, type MenuSection, ModalBody, ModalFilterItem, ModalFooter, ModalHeader, type ModalProps, type ModalSize, MultiLineSelectField, type MultiLineSelectFieldProps, MultiSelectField, type MultiSelectFieldProps, NavLink, type NavLinkProps, type NavLinkVariant, Navbar, NavbarLayout, type NavbarLayoutProps, type NavbarProps, type NavbarUser, type NestedOption, type NestedOptionsOrLoad, NumberField, type NumberFieldProps, type NumberFieldType, type OffsetAndLimit, type OnRowDragEvent, type OnRowSelect, type Only, type OpenDetailOpts, type OpenInDrawerOpts, OpenModal, type OpenRightPaneOpts, type Optional, type Padding, PageHeader, PageHeaderLayout, type PageHeaderLayoutProps, type PageHeaderProps, type PageNumberAndSize, type PageSettings, Pagination, type PaginationConfig, Palette, type Pin, type Placement, type PlainDate, type PresentationFieldProps, PresentationProvider, PreventBrowserScroll, type Properties, RIGHT_SIDEBAR_MIN_WIDTH, type RadioFieldOption, RadioGroupField, type RadioGroupFieldProps, type RenderAs, type RenderCellFn, ResponsiveGrid, type ResponsiveGridConfig, ResponsiveGridContext, ResponsiveGridItem, type ResponsiveGridItemProps, type ResponsiveGridProps, RichTextField, RichTextFieldImpl, type RichTextFieldProps, RightPaneContext, RightPaneLayout, type RightPaneLayoutContextProps, RightPaneProvider, RightSidebar, type RightSidebarProps, type RouteTab, type RouteTabWithContent, Row, type RowStyle, type RowStyles, RuntimeCss, type RuntimeStyles, SIDE_NAV_LAYOUT_STATE_STORAGE_KEY, ScrollShadows, ScrollableContent, ScrollableFooter, ScrollableParent, SelectField, type SelectFieldProps, SelectToggle, type SelectedState, SideNav, SideNavLayout, type SideNavLayoutContextProps, type SideNavLayoutProps, SideNavLayoutProvider, type SideNavLayoutState, type SideNavProps, type SidePanelProps, type SidebarContentProps, type SimpleHeaderAndData, SortHeader, type SortOn, type SortState, StaticField, type Step, Stepper, type StepperProps, type StyleKind, SubmitButton, type SubmitButtonProps, SuperDrawerContent, SuperDrawerHeader, SuperDrawerWidth, type SupportedDateFormat, Switch, type SwitchProps, TOTALS, type Tab, TabContent, type TabWithContent, TableReviewLayout, type TableReviewLayoutProps, TableState, TableStateContext, type TableView, Tabs, TabsWithContent, Tag, type TagType, type TestIds, TextAreaField, type TextAreaFieldProps, TextField, type TextFieldApi, type TextFieldInternalProps, type TextFieldProps, type TextFieldXss, Toast, ToggleButton, type ToggleButtonProps, ToggleChip, ToggleChipGroup, type ToggleChipGroupProps, type ToggleChipProps, ToggleChips, type ToggleChipsProps, Tokens, Tooltip, TreeSelectField, type TreeSelectFieldProps, type TriggerNoticeProps, type Typography, type UseModalHook, type UsePersistedFilterProps, type UseQueryState, type UseRightPaneHook, type UseSnackbarHook, type UseSuperDrawerHook, type UseToastProps, type Value, ViewToggleButton, type Xss, type ZIndex, actionColumn, applyRowFn, assignDefaultColumnIds, beamLayoutViewportHeightVar, beamLayoutViewportWidthVar, beamNavbarLayoutHeightVar, beamPageHeaderLayoutHeightVar, beamSideNavLayoutWidthVar, beamTableActionsHeightVar, booleanFilter, boundCheckboxField, boundCheckboxGroupField, boundDateField, boundDateRangeField, boundIconCardField, boundIconCardGroupField, boundMultiSelectField, boundMultilineSelectField, boundNumberField, boundRadioGroupField, boundRichTextField, boundSelectField, boundSwitchField, boundTextAreaField, boundTextField, boundToggleChipGroupField, boundTreeSelectField, calcColumnLayout, calcColumnSizes, cardStyle, checkboxFilter, chipBaseStyles, chipDisabledStyles, chipHoverOnlyStyles, chipHoverStyles, collapseColumn, column, condensedStyle, contrastDataTheme, createRowLookup, dateColumn, dateFilter, dateFormats, dateRangeFilter, defaultPage, defaultRenderFn, defaultStyle, defaultTestId, documentScrollChromeLeft, documentScrollChromeWidth, dragHandleColumn, emptyCell, ensureClientSideSortValueIsSortable, filterTestIdPrefix, formatDate, formatDateRange, formatPlainDate, formatValue, generateColumnId, getAlignment, getColumnBorderCss, getDateFormat, getFirstOrLastCellCss, getJustification, getNavLinkStyles, getTableRefWidthStyles, getTableStyles, headerRenderFn, hoverStyles, iconButtonCircleStylesHover, iconButtonContrastStylesHover, iconButtonStylesHover, iconCardStylesHover, increment, insertAtIndex, isCursorBelowMidpoint, isGridCellContent, isGridTableProps, isJSX, isListBoxSection, isPersistentItem, isPersistentKey, isValidDate, listFieldPrefix, loadArrayOrUndefined, marker, matchesFilter, maybeCssVar, maybeInc, maybeTooltip, multiFilter, navLink, newMethodMissingProxy, nonKindGridColumnKeys, numberRangeFilter, numericColumn, parseDate, parseDateRange, parseWidthToPx, persistentItemPrefix, pressedOverlayCss, px, recursivelyGetContainingRow, reservedRowKinds, resolveTableContentWidth, resolveTooltip, rowClickRenderFn, rowLinkRenderFn, selectColumn, selectedStyles, setDefaultStyle, setGridTableDefaults, setRunningInJest, shouldSkipScrollTo, simpleDataRows, simpleHeader, singleFilter, sortFn, sortRows, stickyNavAndHeaderOffset, stickyTableHeaderOffset, sumColumnSizesPx, switchFocusStyles, switchHoverStyles, switchSelectedHoverStyles, toContent, toLimitAndOffset, toPageNumberSize, toggleFilter, toggleFocusStyles, toggleHoverStyles, togglePressStyles, treeFilter, updateFilter, useAutoSaveStatus, useBreakpoint, useComputed, useContentOverflow, useContrastScope, useDnDGridItem, type useDnDGridItemProps, useFilter, useGridTableApi, useGridTableLayoutState, useGroupBy, useHasSideNavLayoutProvider, useHover, useModal, usePersistedFilter, useQueryState, useResponsiveGrid, useResponsiveGridItem, type useResponsiveGridProps, useRightPane, useRightPaneContext, useRuntimeStyle, useScrollableParent, useSessionStorage, useSetupColumnSizes, useSideNavLayoutContext, useSnackbar, useSuperDrawer, useTestIds, useToast, useTreeSelectFieldProvider, useVirtualizedScrollParent, visit, zIndices };
+export { ASC, Accordion, AccordionList, type AccordionProps, type AccordionSize, type ActionButtonProps, type AppNavGroup, type AppNavItem, type AppNavLink, type AppNavSection, type AppNavSectionItem, AutoSaveIndicator, AutoSaveStatus, AutoSaveStatusContext, AutoSaveStatusProvider, Autocomplete, type AutocompleteProps, Avatar, AvatarButton, type AvatarButtonProps, AvatarGroup, type AvatarGroupProps, type AvatarProps, type AvatarSize, Banner, type BannerProps, type BannerTypes, BaseFilter, type BaseQueryTableProps, type BaseTableProps, type BeamButtonProps, type BeamColor, type BeamFocusableProps, BeamProvider, type BeamTextFieldProps, BoundCheckboxField, type BoundCheckboxFieldProps, BoundCheckboxGroupField, type BoundCheckboxGroupFieldProps, BoundChipSelectField, BoundDateField, type BoundDateFieldProps, BoundDateRangeField, type BoundDateRangeFieldProps, BoundForm, type BoundFormInputConfig, type BoundFormProps, type BoundFormRowInputs, BoundIconCardField, type BoundIconCardFieldProps, BoundIconCardGroupField, type BoundIconCardGroupFieldProps, BoundMultiLineSelectField, type BoundMultiLineSelectFieldProps, BoundMultiSelectField, type BoundMultiSelectFieldProps, BoundNumberField, type BoundNumberFieldProps, BoundRadioGroupField, type BoundRadioGroupFieldProps, BoundRichTextField, type BoundRichTextFieldProps, BoundSelectAndTextField, BoundSelectField, type BoundSelectFieldProps, BoundSwitchField, type BoundSwitchFieldProps, BoundTextAreaField, type BoundTextAreaFieldProps, BoundTextField, type BoundTextFieldProps, BoundToggleChipGroupField, type BoundToggleChipGroupFieldProps, BoundTreeSelectField, type BoundTreeSelectFieldProps, type Breakpoint, Breakpoints, type BuildtimeStyles, Button, ButtonDatePicker, ButtonGroup, type ButtonGroupButton, type ButtonGroupProps, ButtonMenu, type ButtonMenuProps, ButtonModal, type ButtonModalProps, type ButtonProps, type ButtonSize, type ButtonVariant, Card, type CardProps, type CardTag, type CardType, type CheckFn, Checkbox, CheckboxGroup, type CheckboxGroupItemOption, type CheckboxGroupProps, type CheckboxProps, Chip, type ChipProps, ChipSelectField, type ChipSelectFieldProps, type ChipType, ChipTypes, type ChipValue, Chips, type ChipsProps, CollapseToggle, CollapsedContext, type ColumnLayoutResult, ConfirmCloseModal, type ContentStack, ContrastScope, Copy, CountBadge, type CountBadgeProps, Css, CssReset, type CssSetVarKeys, type CssSetVarScalar, type CssSetVarValue, DESC, DateField, type DateFieldFormat, type DateFieldMode, type DateFieldProps, type DateFilterValue, type DateMatcher, type DateRange, DateRangeField, type DateRangeFieldProps, type DateRangeFilterValue, type DefinedFilterValue, type Direction, type DiscriminateUnion, type DividerMenuItemType, DnDGrid, DnDGridItemHandle, type DnDGridItemHandleProps, type DnDGridItemProps, type DnDGridProps, type DragData, EXPANDABLE_HEADER, EditColumnsButton, ErrorMessage, FieldGroup, type Filter, type FilterDefs, _FilterDropdownMenu as FilterDropdownMenu, type FilterImpls, FilterModal, _Filters as Filters, type Font, FormDivider, FormHeading, type FormHeadingProps, FormLines, type FormLinesProps, FormPageLayout, FormRow, type FormSectionConfig, type FormWidth, FullBleed, type GridCellAlignment, type GridCellContent, type GridColumn, type GridColumnBorder, type GridColumnWithId, type GridDataRow, type GridRowKind, type GridRowLookup, type GridSortConfig, type GridStyle, GridTable, type GridTableApi, type GridTableCollapseToggleProps, type GridTableDefaults, GridTableLayout, type GridTableLayoutProps, type GridTableProps, type GridTablePropsWithRows, type GridTableScrollOptions, type GridTableXss, type GroupByHook, HB_QUIPS_FLAVOR, HB_QUIPS_MISSION, HEADER, type HasIdAndName, HbLoadingSpinner, HbSpinnerProvider, HelperText, HomeboundLogo, Icon, IconButton, type IconButtonProps, type IconButtonVariant, IconCard, type IconCardProps, type IconKey, type IconMenuItemType, type IconProps, Icons, type IfAny, type ImageFitType, type ImageMenuItemType, type InfiniteScroll, type InlineStyle, type InputStylePalette, KEPT_GROUP, type Kinded, Loader, LoadingSkeleton, type LoadingSkeletonProps, type Margin, type Marker, MaxLines, type MaxLinesProps, type MaybeFn, type MenuItem, type MenuSection, ModalBody, ModalFilterItem, ModalFooter, ModalHeader, type ModalProps, type ModalSize, MultiLineSelectField, type MultiLineSelectFieldProps, MultiSelectField, type MultiSelectFieldProps, NavLink, type NavLinkProps, type NavLinkVariant, Navbar, NavbarLayout, type NavbarLayoutProps, type NavbarProps, type NavbarUser, type NestedOption, type NestedOptionsOrLoad, NumberField, type NumberFieldProps, type NumberFieldType, type OffsetAndLimit, type OnRowDragEvent, type OnRowSelect, type Only, type OpenDetailOpts, type OpenInDrawerOpts, OpenModal, type OpenRightPaneOpts, type Optional, type Padding, PageHeader, PageHeaderLayout, type PageHeaderLayoutProps, type PageHeaderProps, type PageNumberAndSize, type PageSettings, Pagination, type PaginationConfig, Palette, type Pin, type Placement, type PlainDate, type PresentationFieldProps, PresentationProvider, PreventBrowserScroll, type Properties, RIGHT_SIDEBAR_MIN_WIDTH, type RadioFieldOption, RadioGroupField, type RadioGroupFieldProps, type RenderAs, type RenderCellFn, ResponsiveGrid, type ResponsiveGridConfig, ResponsiveGridContext, ResponsiveGridItem, type ResponsiveGridItemProps, type ResponsiveGridProps, RichTextField, RichTextFieldImpl, type RichTextFieldProps, RightPaneContext, RightPaneLayout, type RightPaneLayoutContextProps, RightPaneProvider, RightSidebar, type RightSidebarProps, type RouteTab, type RouteTabWithContent, Row, type RowStyle, type RowStyles, RuntimeCss, type RuntimeStyles, SIDE_NAV_LAYOUT_STATE_STORAGE_KEY, ScrollShadows, ScrollableContent, ScrollableFooter, ScrollableParent, SelectField, type SelectFieldProps, SelectToggle, type SelectedFilterLabelValue, type SelectedState, SideNav, SideNavLayout, type SideNavLayoutContextProps, type SideNavLayoutProps, SideNavLayoutProvider, type SideNavLayoutState, type SideNavProps, type SidePanelProps, type SidebarContentProps, type SimpleHeaderAndData, SortHeader, type SortOn, type SortState, StaticField, type Step, Stepper, type StepperProps, type StyleKind, SubmitButton, type SubmitButtonProps, SuperDrawerContent, SuperDrawerHeader, SuperDrawerWidth, type SupportedDateFormat, Switch, type SwitchProps, TOTALS, type Tab, TabContent, type TabWithContent, TableReviewLayout, type TableReviewLayoutProps, TableState, TableStateContext, type TableView, Tabs, TabsWithContent, Tag, type TagType, type TestIds, TextAreaField, type TextAreaFieldProps, TextField, type TextFieldApi, type TextFieldInternalProps, type TextFieldProps, type TextFieldXss, Toast, ToggleButton, type ToggleButtonProps, ToggleChip, ToggleChipGroup, type ToggleChipGroupProps, type ToggleChipProps, ToggleChips, type ToggleChipsProps, Tokens, Tooltip, TreeSelectField, type TreeSelectFieldProps, type TriggerNoticeProps, type Typography, type UseModalHook, type UsePersistedFilterProps, type UseQueryState, type UseRightPaneHook, type UseSnackbarHook, type UseSuperDrawerHook, type UseToastProps, type Value, ViewToggleButton, type Xss, type ZIndex, actionColumn, applyRowFn, assignDefaultColumnIds, beamLayoutViewportHeightVar, beamLayoutViewportWidthVar, beamNavbarLayoutHeightVar, beamPageHeaderLayoutHeightVar, beamSideNavLayoutWidthVar, beamTableActionsHeightVar, booleanFilter, boundCheckboxField, boundCheckboxGroupField, boundDateField, boundDateRangeField, boundIconCardField, boundIconCardGroupField, boundMultiSelectField, boundMultilineSelectField, boundNumberField, boundRadioGroupField, boundRichTextField, boundSelectField, boundSwitchField, boundTextAreaField, boundTextField, boundToggleChipGroupField, boundTreeSelectField, calcColumnLayout, calcColumnSizes, cardStyle, checkboxFilter, chipBaseStyles, chipDisabledStyles, chipHoverOnlyStyles, chipHoverStyles, collapseColumn, column, condensedStyle, contrastDataTheme, createRowLookup, dateColumn, dateFilter, dateFormats, dateRangeFilter, defaultPage, defaultRenderFn, defaultStyle, defaultTestId, documentScrollChromeLeft, documentScrollChromeWidth, dragHandleColumn, emptyCell, ensureClientSideSortValueIsSortable, filterTestIdPrefix, formatDate, formatDateRange, formatPlainDate, formatValue, generateColumnId, getAlignment, getColumnBorderCss, getDateFormat, getFirstOrLastCellCss, getJustification, getNavLinkStyles, getTableRefWidthStyles, getTableStyles, headerRenderFn, hoverStyles, iconButtonCircleStylesHover, iconButtonContrastStylesHover, iconButtonStylesHover, iconCardStylesHover, increment, insertAtIndex, isCursorBelowMidpoint, isGridCellContent, isGridTableProps, isJSX, isListBoxSection, isPersistentItem, isPersistentKey, isValidDate, listFieldPrefix, loadArrayOrUndefined, marker, matchesFilter, maybeCssVar, maybeInc, maybeTooltip, multiFilter, navLink, newMethodMissingProxy, nonKindGridColumnKeys, numberRangeFilter, numericColumn, parseDate, parseDateRange, parseWidthToPx, persistentItemPrefix, pressedOverlayCss, px, recursivelyGetContainingRow, reservedRowKinds, resolveTableContentWidth, resolveTooltip, rowClickRenderFn, rowLinkRenderFn, selectColumn, selectedStyles, setDefaultStyle, setGridTableDefaults, setRunningInJest, shouldSkipScrollTo, simpleDataRows, simpleHeader, singleFilter, sortFn, sortRows, stickyNavAndHeaderOffset, stickyTableHeaderOffset, sumColumnSizesPx, switchFocusStyles, switchHoverStyles, switchSelectedHoverStyles, toContent, toLimitAndOffset, toPageNumberSize, toggleFilter, toggleFocusStyles, toggleHoverStyles, togglePressStyles, treeFilter, updateFilter, useAutoSaveStatus, useBreakpoint, useComputed, useContentOverflow, useContrastScope, useDnDGridItem, type useDnDGridItemProps, useFilter, useGridTableApi, useGridTableLayoutState, useGroupBy, useHasSideNavLayoutProvider, useHover, useModal, usePersistedFilter, useQueryState, useResponsiveGrid, useResponsiveGridItem, type useResponsiveGridProps, useRightPane, useRightPaneContext, useRuntimeStyle, useScrollableParent, useSessionStorage, useSetupColumnSizes, useSideNavLayoutContext, useSnackbar, useSuperDrawer, useTestIds, useToast, useTreeSelectFieldProvider, useVirtualizedScrollParent, visit, zIndices };

package/dist/index.js

@@ -5447,7 +5447,12 @@ var iconButtonOutline = {
   borderRadius: "br8",
   width: "w_48px",
   height: "h_40px",
-  borderColor: "bcGray300",
+  backgroundColor: ["bgColor_var", {
+    "--backgroundColor": "var(--b-surface)"
+  }],
+  borderColor: ["bc_var", {
+    "--borderColor": "var(--b-surface-separator)"
+  }],
   borderStyle: "bss",
   borderWidth: "bw1",
   display: "df",
@@ -19003,6 +19008,12 @@ var DateFilter = class extends BaseFilter {
   dehydrate(value) {
     return value ? { op: value.op, value: dehydratePlainDate(value.value) } : void 0;
   }
+  formatSelectedFilterLabel(value) {
+    const { operations, getOperationValue, getOperationLabel } = this.props;
+    const operation = operations.find((o) => getOperationValue(o) === value.op);
+    const opLabel = operation ? getOperationLabel(operation) : String(value.op);
+    return `${opLabel} ${formatDate(value.value, "date")}`;
+  }
   render(value, setValue, tid, inModal, vertical) {
     const { label, operations, getOperationValue, getOperationLabel, defaultValue } = this.props;
     return /* @__PURE__ */ jsxs65(Fragment29, { children: [
@@ -19070,6 +19081,10 @@ var DateRangeFilter = class extends BaseFilter {
       value: value.value ? { from: dehydratePlainDate(value.value.from), to: dehydratePlainDate(value.value.to) } : void 0
     } : void 0;
   }
+  formatSelectedFilterLabel(value) {
+    const formatted = formatDateRange(value.value, "date");
+    return formatted ? formatted : void 0;
+  }
   render(value, setValue, tid, inModal, vertical) {
     const { label, placeholderText, disabledDays, testFieldLabel, defaultValue } = this.props;
     return /* @__PURE__ */ jsxs66(Fragment30, { children: [
@@ -19111,12 +19126,34 @@ function hydrateDateRange(value) {
   return { from: hydratedFrom, to: hydratedTo };
 }
 
+// src/components/Filters/selectedFilterLabelUtils.ts
+function resolveOptionSelectedFilterLabel(optionsOrLoad, getOptionValue, getOptionLabel, value) {
+  const options = initializeOptions(optionsOrLoad, getOptionValue, getOptionLabel, void 0, false, false);
+  const match = options.find((o) => getOptionValue(o) === value);
+  return match ? getOptionLabel(match) : String(value);
+}
+function resolveTreeSelectedFilterLabel(optionsOrLoad, getOptionValue, getOptionLabel, value) {
+  const options = resolveNestedOptions(optionsOrLoad);
+  const match = options.flatMap(flattenOptions).find((o) => getOptionValue(o) === value);
+  return match ? getOptionLabel(match) : String(value);
+}
+function resolveNestedOptions(optionsOrLoad) {
+  if (Array.isArray(optionsOrLoad)) {
+    return optionsOrLoad;
+  }
+  return optionsOrLoad.current ?? [];
+}
+
 // src/components/Filters/MultiFilter.tsx
 import { jsx as jsx131 } from "react/jsx-runtime";
 function multiFilter(props) {
   return (key) => new MultiFilter(key, props);
 }
 var MultiFilter = class extends BaseFilter {
+  formatSelectedFilterLabel(value) {
+    const { options, getOptionValue, getOptionLabel } = this.props;
+    return resolveOptionSelectedFilterLabel(options, getOptionValue, getOptionLabel, value);
+  }
   render(value, setValue, tid, inModal, vertical) {
     if (inModal && Array.isArray(this.props.options) && this.props.options.length > 0 && this.props.options.length <= 8) {
       const { disabledOptions } = this.props;
@@ -19170,6 +19207,10 @@ function numberRangeFilter(props) {
   return (key) => new NumberRangeFilter(key, props);
 }
 var NumberRangeFilter = class extends BaseFilter {
+  formatSelectedFilterLabel(value) {
+    const parts = [value.min, value.max].filter((n) => n !== void 0);
+    return parts.length > 0 ? parts.join(" \u2013 ") : void 0;
+  }
   render(value, setValue, tid, inModal, vertical) {
     const {
       label,
@@ -19244,6 +19285,10 @@ function singleFilter(props) {
 }
 var allOption = {};
 var SingleFilter = class extends BaseFilter {
+  formatSelectedFilterLabel(value) {
+    const { options, getOptionValue, getOptionLabel } = this.props;
+    return resolveOptionSelectedFilterLabel(options, getOptionValue, getOptionLabel, value);
+  }
   render(value, setValue, tid, inModal, vertical) {
     const {
       label,
@@ -19280,6 +19325,10 @@ function treeFilter(props) {
   return (key) => new TreeFilter(key, props);
 }
 var TreeFilter = class extends BaseFilter {
+  formatSelectedFilterLabel(value) {
+    const { options, getOptionValue, getOptionLabel } = this.props;
+    return resolveTreeSelectedFilterLabel(options, getOptionValue, getOptionLabel, value);
+  }
   render(value, setValue, tid, inModal, vertical) {
     const { defaultValue, nothingSelectedText, filterBy = "root", ...props } = this.props;
     return /* @__PURE__ */ jsx134(
@@ -19307,6 +19356,11 @@ function booleanFilter(props) {
   return (key) => new BooleanFilter(key, props);
 }
 var BooleanFilter = class extends BaseFilter {
+  formatSelectedFilterLabel(value) {
+    const { options = defaultBooleanOptions } = this.props;
+    const match = options.find(([optionValue]) => optionValue === value);
+    return match ? match[1] : String(value);
+  }
   render(value, setValue, tid, inModal, vertical) {
     const { options = defaultBooleanOptions, label, defaultValue, ...props } = this.props;
     return /* @__PURE__ */ jsx135(
@@ -19345,6 +19399,10 @@ function checkboxFilter(props) {
   });
 }
 var CheckboxFilter = class extends BaseFilter {
+  formatSelectedFilterLabel(value) {
+    const { onValue = true } = this.props;
+    return value === onValue ? this.label : void 0;
+  }
   render(value, setValue, tid, inModal, vertical) {
     const { defaultValue, onValue = true, offValue = void 0, ...props } = this.props;
     return /* @__PURE__ */ jsx136(
@@ -19499,6 +19557,10 @@ function toggleFilter(props) {
   });
 }
 var ToggleFilter = class extends BaseFilter {
+  formatSelectedFilterLabel(value) {
+    const { onValue = true } = this.props;
+    return value === onValue ? this.label : void 0;
+  }
   render(value, setValue, tid, inModal, vertical) {
     const { defaultValue, onValue = true, offValue = void 0, ...props } = this.props;
     return /* @__PURE__ */ jsx140(
@@ -19593,24 +19655,11 @@ function FilterDropdownMenu(props) {
         opacity: "o0"
       } : {}
     }), children: searchTextField }),
-    sm && hasSearch && /* @__PURE__ */ jsx141(Button, { label: "", "aria-label": "Search", icon: "search", onClick: () => setSearchIsOpen(!searchIsOpen), active: searchIsOpen, variant: "secondaryBlack", ...testId.searchButton }),
-    hasFilters && /* @__PURE__ */ jsx141(Button, { label: sm ? "" : "Filter", "aria-label": "Filter", icon: "filter", size: "md", endAdornment: /* @__PURE__ */ jsxs70("div", { className: "df aic gap1", children: [
+    sm && hasSearch && /* @__PURE__ */ jsx141(IconButton, { variant: "outline", icon: "search", label: "Search", onClick: () => setSearchIsOpen(!searchIsOpen), active: searchIsOpen, ...testId.searchButton }),
+    sm && hasFilters && /* @__PURE__ */ jsx141(IconButton, { variant: "outline", icon: "filter", label: "Filter", active: isOpen, onClick: () => setIsOpen(!isOpen), ...testId.button }),
+    !sm && hasFilters && /* @__PURE__ */ jsx141(Button, { label: "Filter", icon: "filter", size: "md", endAdornment: /* @__PURE__ */ jsxs70("div", { className: "df aic gap1", children: [
       activeFilterCount > 0 && /* @__PURE__ */ jsx141(CountBadge, { count: activeFilterCount }),
-      /* @__PURE__ */ jsx141(Icon, { xss: {
-        ...sm ? {
-          position: "absolute",
-          overflow: "oh",
-          clip: "cli_inset_50",
-          clipPath: "clp_none",
-          border: "bd_0",
-          height: "h_1px",
-          margin: "m_neg1px",
-          width: "w_1px",
-          padding: "p_0",
-          whiteSpace: "wsnw",
-          opacity: "o0"
-        } : {}
-      }, icon: isOpen ? "chevronUp" : "chevronDown" })
+      /* @__PURE__ */ jsx141(Icon, { icon: isOpen ? "chevronUp" : "chevronDown" })
     ] }), variant: "secondaryBlack", onClick: () => setIsOpen(!isOpen), active: isOpen, ...testId.button }),
     searchIsOpen && /* @__PURE__ */ jsx141("div", { ...trussProps69({
       width: "w100",
@@ -19643,30 +19692,32 @@ function FilterChips({
   onClear,
   testId
 }) {
-  const chips = safeEntries(filterImpls).flatMap(([key]) => {
-    const value = filter[key];
-    if (!isDefined(value)) return [];
-    if (Array.isArray(value)) {
-      return value.map((item) => {
-        const chipKey = `${String(key)}_${item}`;
-        const newArray = value.filter((v) => v !== item);
-        return /* @__PURE__ */ jsx141(ToggleChip, { text: titleCase(String(item)), onClick: () => onChange(updateFilter(filter, key, newArray.length > 0 ? newArray : void 0)), ...testId[`chip_${chipKey}`] }, chipKey);
-      });
-    }
-    return /* @__PURE__ */ jsx141(ToggleChip, { text: titleCase(String(value)), onClick: () => onChange(updateFilter(filter, key, void 0)), ...testId[`chip_${String(key)}`] }, String(key));
-  });
+  const chips = safeEntries(filterImpls).flatMap(([key, f]) => chipsForFilterKey(key, f, filter, onChange, testId));
   if (chips.length === 0) return null;
   return /* @__PURE__ */ jsxs70("div", { className: "df gap1 fww aic order_1", children: [
     chips,
     /* @__PURE__ */ jsx141(Button, { label: "Clear", variant: "tertiary", onClick: onClear, ...testId.clearBtn })
   ] });
 }
+function chipsForFilterKey(key, f, filter, onChange, testId) {
+  const value = filter[key];
+  if (!isDefined(value)) return [];
+  if (Array.isArray(value)) {
+    return value.flatMap((item) => {
+      const label2 = f.formatSelectedFilterLabel(item);
+      if (!isDefined(label2)) return [];
+      const chipKey = `${String(key)}_${item}`;
+      const newArray = value.filter((v) => v !== item);
+      return /* @__PURE__ */ jsx141(ToggleChip, { text: label2, onClick: () => onChange(updateFilter(filter, key, newArray.length > 0 ? newArray : void 0)), ...testId[`chip_${chipKey}`] }, chipKey);
+    });
+  }
+  const label = f.formatSelectedFilterLabel(value);
+  if (!isDefined(label)) return [];
+  return /* @__PURE__ */ jsx141(ToggleChip, { text: label, onClick: () => onChange(updateFilter(filter, key, void 0)), ...testId[`chip_${String(key)}`] }, String(key));
+}
 function buildFilterImpls(filterDefs) {
   return Object.fromEntries(safeEntries(filterDefs).map(([key, fn]) => [key, fn(key)]));
 }
-function titleCase(str) {
-  return str.split(" ").map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join(" ");
-}
 function getActiveFilterCount(filter) {
   return safeKeys(filter).filter((key) => filter[key] !== void 0).length;
 }