@invoiceonline/ui-react 0.0.0 → 0.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +99 -0
- package/CHANGELOG.md +131 -0
- package/LICENSE +9 -0
- package/README.md +77 -1
- package/dist/assets/label-brush-1.svg +6 -0
- package/dist/assets/pattern-dark.svg +113 -0
- package/dist/components/action-row/ActionRow.d.ts +178 -0
- package/dist/components/action-row/ActionRow.js +340 -0
- package/dist/components/action-row/index.d.ts +2 -0
- package/dist/components/action-row/index.js +1 -0
- package/dist/components/alert/Alert.d.ts +314 -0
- package/dist/components/alert/Alert.js +446 -0
- package/dist/components/alert/index.d.ts +2 -0
- package/dist/components/alert/index.js +1 -0
- package/dist/components/anchored-panel/AnchoredPanel.d.ts +41 -0
- package/dist/components/anchored-panel/AnchoredPanel.js +72 -0
- package/dist/components/anchored-panel/index.d.ts +3 -0
- package/dist/components/anchored-panel/index.js +3 -0
- package/dist/components/badge/Badge.d.ts +146 -0
- package/dist/components/badge/Badge.js +258 -0
- package/dist/components/badge/index.d.ts +2 -0
- package/dist/components/badge/index.js +1 -0
- package/dist/components/banner/Banner.d.ts +209 -0
- package/dist/components/banner/Banner.js +339 -0
- package/dist/components/banner/index.d.ts +2 -0
- package/dist/components/banner/index.js +1 -0
- package/dist/components/button/Button.d.ts +54 -0
- package/dist/components/button/Button.js +312 -0
- package/dist/components/button/index.d.ts +2 -0
- package/dist/components/button/index.js +1 -0
- package/dist/components/button-group/ButtonGroup.d.ts +187 -0
- package/dist/components/button-group/ButtonGroup.js +217 -0
- package/dist/components/button-group/index.d.ts +2 -0
- package/dist/components/button-group/index.js +1 -0
- package/dist/components/card-select/CardSelect.d.ts +274 -0
- package/dist/components/card-select/CardSelect.js +561 -0
- package/dist/components/card-select/CardSelectGroup.d.ts +92 -0
- package/dist/components/card-select/CardSelectGroup.js +72 -0
- package/dist/components/card-select/index.d.ts +3 -0
- package/dist/components/card-select/index.js +3 -0
- package/dist/components/checkbox/Checkbox.d.ts +104 -0
- package/dist/components/checkbox/Checkbox.js +194 -0
- package/dist/components/checkbox/index.d.ts +2 -0
- package/dist/components/checkbox/index.js +1 -0
- package/dist/components/chip/Chip.d.ts +250 -0
- package/dist/components/chip/Chip.js +441 -0
- package/dist/components/chip/index.d.ts +2 -0
- package/dist/components/chip/index.js +1 -0
- package/dist/components/column-header/ColumnHeader.d.ts +144 -0
- package/dist/components/column-header/ColumnHeader.js +209 -0
- package/dist/components/column-header/index.d.ts +2 -0
- package/dist/components/column-header/index.js +1 -0
- package/dist/components/combobox-field/Combobox.d.ts +104 -0
- package/dist/components/combobox-field/Combobox.js +355 -0
- package/dist/components/combobox-field/ComboboxField.d.ts +76 -0
- package/dist/components/combobox-field/ComboboxField.js +98 -0
- package/dist/components/combobox-field/index.d.ts +3 -0
- package/dist/components/combobox-field/index.js +3 -0
- package/dist/components/date-field/DateField.d.ts +52 -0
- package/dist/components/date-field/DateField.js +45 -0
- package/dist/components/date-field/index.d.ts +2 -0
- package/dist/components/date-field/index.js +1 -0
- package/dist/components/date-picker/DatePicker.d.ts +53 -0
- package/dist/components/date-picker/DatePicker.js +329 -0
- package/dist/components/date-picker/index.d.ts +2 -0
- package/dist/components/date-picker/index.js +1 -0
- package/dist/components/divider/Divider.d.ts +81 -0
- package/dist/components/divider/Divider.js +93 -0
- package/dist/components/divider/index.d.ts +2 -0
- package/dist/components/divider/index.js +1 -0
- package/dist/components/drawer/Drawer.d.ts +128 -0
- package/dist/components/drawer/Drawer.js +367 -0
- package/dist/components/drawer/index.d.ts +2 -0
- package/dist/components/drawer/index.js +1 -0
- package/dist/components/dropdown-button/DropdownButton.d.ts +72 -0
- package/dist/components/dropdown-button/DropdownButton.js +122 -0
- package/dist/components/dropdown-button/index.d.ts +2 -0
- package/dist/components/dropdown-button/index.js +1 -0
- package/dist/components/faq/FAQ.d.ts +135 -0
- package/dist/components/faq/FAQ.js +258 -0
- package/dist/components/faq/index.d.ts +2 -0
- package/dist/components/faq/index.js +1 -0
- package/dist/components/field/Field.d.ts +118 -0
- package/dist/components/field/Field.js +327 -0
- package/dist/components/field/index.d.ts +2 -0
- package/dist/components/field/index.js +1 -0
- package/dist/components/field-pair/FieldPair.d.ts +194 -0
- package/dist/components/field-pair/FieldPair.js +321 -0
- package/dist/components/field-pair/index.d.ts +2 -0
- package/dist/components/field-pair/index.js +1 -0
- package/dist/components/file-upload/FileUpload.d.ts +137 -0
- package/dist/components/file-upload/FileUpload.js +434 -0
- package/dist/components/file-upload/index.d.ts +2 -0
- package/dist/components/file-upload/index.js +1 -0
- package/dist/components/filter-chip/FilterChip.d.ts +373 -0
- package/dist/components/filter-chip/FilterChip.js +517 -0
- package/dist/components/filter-chip/index.d.ts +2 -0
- package/dist/components/filter-chip/index.js +1 -0
- package/dist/components/filter-facet/FilterFacet.d.ts +116 -0
- package/dist/components/filter-facet/FilterFacet.js +632 -0
- package/dist/components/filter-facet/index.d.ts +2 -0
- package/dist/components/filter-facet/index.js +1 -0
- package/dist/components/firm-avatar/FirmAvatar.d.ts +75 -0
- package/dist/components/firm-avatar/FirmAvatar.js +119 -0
- package/dist/components/firm-avatar/index.d.ts +2 -0
- package/dist/components/firm-avatar/index.js +1 -0
- package/dist/components/form-actions/FormActions.d.ts +123 -0
- package/dist/components/form-actions/FormActions.js +195 -0
- package/dist/components/form-actions/index.d.ts +2 -0
- package/dist/components/form-actions/index.js +1 -0
- package/dist/components/form-block/FormBlock.d.ts +252 -0
- package/dist/components/form-block/FormBlock.js +420 -0
- package/dist/components/form-block/index.d.ts +3 -0
- package/dist/components/form-block/index.js +3 -0
- package/dist/components/form-section/FormSection.d.ts +130 -0
- package/dist/components/form-section/FormSection.js +206 -0
- package/dist/components/form-section/index.d.ts +2 -0
- package/dist/components/form-section/index.js +1 -0
- package/dist/components/heading/Heading.d.ts +69 -0
- package/dist/components/heading/Heading.js +79 -0
- package/dist/components/heading/index.d.ts +2 -0
- package/dist/components/heading/index.js +1 -0
- package/dist/components/heading-group/HeadingGroup.d.ts +258 -0
- package/dist/components/heading-group/HeadingGroup.js +255 -0
- package/dist/components/heading-group/index.d.ts +2 -0
- package/dist/components/heading-group/index.js +1 -0
- package/dist/components/hero/Hero.d.ts +268 -0
- package/dist/components/hero/Hero.js +316 -0
- package/dist/components/hero/index.d.ts +2 -0
- package/dist/components/hero/index.js +1 -0
- package/dist/components/icon/Icon.d.ts +27 -0
- package/dist/components/icon/Icon.js +30 -0
- package/dist/components/icon/index.d.ts +3 -0
- package/dist/components/icon/index.js +3 -0
- package/dist/components/icon-button/IconButton.d.ts +75 -0
- package/dist/components/icon-button/IconButton.js +151 -0
- package/dist/components/icon-button/index.d.ts +2 -0
- package/dist/components/icon-button/index.js +1 -0
- package/dist/components/item-row/ItemRow.d.ts +253 -0
- package/dist/components/item-row/ItemRow.js +496 -0
- package/dist/components/item-row/index.d.ts +2 -0
- package/dist/components/item-row/index.js +1 -0
- package/dist/components/list-row/ListRow.d.ts +165 -0
- package/dist/components/list-row/ListRow.js +233 -0
- package/dist/components/list-row/index.d.ts +2 -0
- package/dist/components/list-row/index.js +1 -0
- package/dist/components/menu/Menu.d.ts +64 -0
- package/dist/components/menu/Menu.js +186 -0
- package/dist/components/menu/index.d.ts +2 -0
- package/dist/components/menu/index.js +1 -0
- package/dist/components/modal/Modal.d.ts +272 -0
- package/dist/components/modal/Modal.js +788 -0
- package/dist/components/modal/index.d.ts +2 -0
- package/dist/components/modal/index.js +1 -0
- package/dist/components/nav-link/NavLink.d.ts +123 -0
- package/dist/components/nav-link/NavLink.js +157 -0
- package/dist/components/nav-link/index.d.ts +2 -0
- package/dist/components/nav-link/index.js +1 -0
- package/dist/components/number-field/NumberField.d.ts +62 -0
- package/dist/components/number-field/NumberField.js +210 -0
- package/dist/components/number-field/index.d.ts +2 -0
- package/dist/components/number-field/index.js +1 -0
- package/dist/components/pagination/Pagination.d.ts +133 -0
- package/dist/components/pagination/Pagination.js +217 -0
- package/dist/components/pagination/index.d.ts +3 -0
- package/dist/components/pagination/index.js +3 -0
- package/dist/components/popover-surface/index.d.ts +2 -0
- package/dist/components/popover-surface/index.js +1 -0
- package/dist/components/progress-bar/ProgressBar.d.ts +260 -0
- package/dist/components/progress-bar/ProgressBar.js +470 -0
- package/dist/components/progress-bar/index.d.ts +2 -0
- package/dist/components/progress-bar/index.js +1 -0
- package/dist/components/promo-sticker/PromoSticker.d.ts +204 -0
- package/dist/components/promo-sticker/PromoSticker.js +177 -0
- package/dist/components/promo-sticker/index.d.ts +2 -0
- package/dist/components/promo-sticker/index.js +1 -0
- package/dist/components/promo-surface/PromoSurface.d.ts +94 -0
- package/dist/components/promo-surface/PromoSurface.js +119 -0
- package/dist/components/promo-surface/index.d.ts +2 -0
- package/dist/components/promo-surface/index.js +1 -0
- package/dist/components/radio/Radio.d.ts +92 -0
- package/dist/components/radio/Radio.js +171 -0
- package/dist/components/radio/index.d.ts +2 -0
- package/dist/components/radio/index.js +1 -0
- package/dist/components/radio-group/RadioGroup.d.ts +61 -0
- package/dist/components/radio-group/RadioGroup.js +51 -0
- package/dist/components/radio-group/index.d.ts +2 -0
- package/dist/components/radio-group/index.js +1 -0
- package/dist/components/select/Select.d.ts +65 -0
- package/dist/components/select/Select.js +176 -0
- package/dist/components/select/index.d.ts +2 -0
- package/dist/components/select/index.js +1 -0
- package/dist/components/select-field/SelectField.d.ts +16 -0
- package/dist/components/select-field/SelectField.js +55 -0
- package/dist/components/select-field/index.d.ts +2 -0
- package/dist/components/select-field/index.js +1 -0
- package/dist/components/skeleton/Skeleton.d.ts +64 -0
- package/dist/components/skeleton/Skeleton.js +65 -0
- package/dist/components/skeleton/index.d.ts +2 -0
- package/dist/components/skeleton/index.js +1 -0
- package/dist/components/split-button/SplitButton.d.ts +80 -0
- package/dist/components/split-button/SplitButton.js +182 -0
- package/dist/components/split-button/index.d.ts +2 -0
- package/dist/components/split-button/index.js +1 -0
- package/dist/components/status-summary-bar/StatusSummaryBar.d.ts +118 -0
- package/dist/components/status-summary-bar/StatusSummaryBar.js +278 -0
- package/dist/components/status-summary-bar/index.d.ts +2 -0
- package/dist/components/status-summary-bar/index.js +1 -0
- package/dist/components/subject-lookup-field/SubjectLookupField.d.ts +157 -0
- package/dist/components/subject-lookup-field/SubjectLookupField.js +663 -0
- package/dist/components/subject-lookup-field/index.d.ts +2 -0
- package/dist/components/subject-lookup-field/index.js +1 -0
- package/dist/components/switch/Switch.d.ts +152 -0
- package/dist/components/switch/Switch.js +307 -0
- package/dist/components/switch/index.d.ts +2 -0
- package/dist/components/switch/index.js +1 -0
- package/dist/components/table/Table.d.ts +5 -0
- package/dist/components/table/Table.js +601 -0
- package/dist/components/table/index.d.ts +6 -0
- package/dist/components/table/index.js +6 -0
- package/dist/components/text-field/TextField.d.ts +65 -0
- package/dist/components/text-field/TextField.js +173 -0
- package/dist/components/text-field/index.d.ts +2 -0
- package/dist/components/text-field/index.js +1 -0
- package/dist/components/text-link/TextLink.d.ts +260 -0
- package/dist/components/text-link/TextLink.js +303 -0
- package/dist/components/text-link/index.d.ts +2 -0
- package/dist/components/text-link/index.js +1 -0
- package/dist/components/textarea/Textarea.d.ts +93 -0
- package/dist/components/textarea/Textarea.js +256 -0
- package/dist/components/textarea/index.d.ts +2 -0
- package/dist/components/textarea/index.js +1 -0
- package/dist/components/tooltip/Tooltip.d.ts +129 -0
- package/dist/components/tooltip/Tooltip.js +457 -0
- package/dist/components/tooltip/index.d.ts +2 -0
- package/dist/components/tooltip/index.js +1 -0
- package/dist/components/unit-field/UnitField.d.ts +46 -0
- package/dist/components/unit-field/UnitField.js +133 -0
- package/dist/components/unit-field/index.d.ts +2 -0
- package/dist/components/unit-field/index.js +1 -0
- package/dist/icons/icon-registry.generated.js +500 -0
- package/dist/icons/icon-types.generated.d.ts +2 -0
- package/dist/icons/icon-types.generated.js +126 -0
- package/dist/index.d.ts +132 -0
- package/dist/index.js +75 -0
- package/dist/internal/BottomSheet.js +496 -0
- package/dist/internal/FodsProvider.d.ts +25 -0
- package/dist/internal/FodsProvider.js +32 -0
- package/dist/internal/MotionCaret.js +35 -0
- package/dist/internal/NumberFormatInput.d.ts +21 -0
- package/dist/internal/NumberFormatInput.js +126 -0
- package/dist/internal/SummaryDonut.d.ts +3 -0
- package/dist/internal/SummaryDonut.js +300 -0
- package/dist/internal/buttonSegment.d.ts +44 -0
- package/dist/internal/buttonSegment.js +126 -0
- package/dist/internal/collapseRoom.js +128 -0
- package/dist/internal/comboboxKeys.js +44 -0
- package/dist/internal/contentPresence.js +46 -0
- package/dist/internal/dayCell.js +95 -0
- package/dist/internal/dialogPortal.d.ts +2 -0
- package/dist/internal/dialogPortal.js +21 -0
- package/dist/internal/donutSweeps.js +65 -0
- package/dist/internal/enterOnViewGeometry.js +46 -0
- package/dist/internal/faqItem.js +80 -0
- package/dist/internal/floatingLabelMotion.js +68 -0
- package/dist/internal/formBlockContext.d.ts +22 -0
- package/dist/internal/formBlockContext.js +20 -0
- package/dist/internal/heightRoom.js +87 -0
- package/dist/internal/numberSeparators.js +62 -0
- package/dist/internal/overlayMotion.js +48 -0
- package/dist/internal/paginationItem.d.ts +8 -0
- package/dist/internal/paginationItem.js +22 -0
- package/dist/internal/popoverSurface.d.ts +8 -0
- package/dist/internal/popoverSurface.js +23 -0
- package/dist/internal/portalContainer.d.ts +1 -0
- package/dist/internal/portalContainer.js +6 -0
- package/dist/internal/progressBarItem.d.ts +207 -0
- package/dist/internal/progressBarItem.js +264 -0
- package/dist/internal/selectionControlText.js +12 -0
- package/dist/internal/statusSummaryParts.js +371 -0
- package/dist/internal/summaryMotion.js +75 -0
- package/dist/internal/table/ChildConnector.js +62 -0
- package/dist/internal/table/ChildRowPrefix.d.ts +9 -0
- package/dist/internal/table/ChildRowPrefix.js +27 -0
- package/dist/internal/table/ColumnSettings.js +135 -0
- package/dist/internal/table/ScrollRegion.js +114 -0
- package/dist/internal/table/TableEmpty.js +93 -0
- package/dist/internal/table/TableLayout.d.ts +17 -0
- package/dist/internal/table/TableLayout.js +29 -0
- package/dist/internal/table/TableLoadStatus.js +56 -0
- package/dist/internal/table/TableMobile.js +488 -0
- package/dist/internal/table/TruncatedCell.js +33 -0
- package/dist/internal/table/emptyValue.js +10 -0
- package/dist/internal/table/features.d.ts +41 -0
- package/dist/internal/table/features.js +31 -0
- package/dist/internal/table/recipes.js +227 -0
- package/dist/internal/table/rowClick.js +9 -0
- package/dist/internal/table/types.d.ts +325 -0
- package/dist/internal/table/types.js +13 -0
- package/dist/internal/tailwind-variants.d.ts +3 -0
- package/dist/internal/tailwind-variants.js +37 -0
- package/dist/internal/tooltipContext.js +5 -0
- package/dist/internal/tw-merge-config.generated.js +314 -0
- package/dist/internal/useAnchoredPanel.d.ts +87 -0
- package/dist/internal/useAnchoredPanel.js +108 -0
- package/dist/internal/useCountUp.js +53 -0
- package/dist/internal/useDateFieldTrigger.js +183 -0
- package/dist/internal/useEChart.js +59 -0
- package/dist/internal/useEnterOnView.js +42 -0
- package/dist/internal/useFloatingBar.js +100 -0
- package/dist/internal/useFormReset.js +37 -0
- package/dist/internal/useIsMobile.js +44 -0
- package/dist/internal/useOneRowOverflow.js +88 -0
- package/dist/internal/usePrefersReducedMotion.js +25 -0
- package/dist/internal/useReturnFocus.js +26 -0
- package/dist/internal/utils.d.ts +7 -0
- package/dist/internal/utils.js +58 -0
- package/dist/node_modules/@tanstack/store/dist/store.d.ts +29 -0
- package/dist/node_modules/@tanstack/store/dist/types.d.ts +38 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/cells/coreCellsFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/cells/coreCellsFeature.types.d.ts +53 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/columns/coreColumnsFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/columns/coreColumnsFeature.types.d.ts +90 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/coreFeatures.d.ts +17 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/headers/coreHeadersFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/headers/coreHeadersFeature.types.d.ts +114 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/reactivity/coreReactivityFeature.types.d.ts +51 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/row-models/coreRowModelsFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/row-models/coreRowModelsFeature.types.d.ts +29 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/rows/coreRowsFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/rows/coreRowsFeature.types.d.ts +129 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/table/coreTablesFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/table/coreTablesFeature.types.d.ts +203 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/cell-selection/cellSelectionFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/cell-selection/cellSelectionFeature.types.d.ts +294 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/cell-spanning/cellSpanningFeature.d.ts +11 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/cell-spanning/cellSpanningFeature.types.d.ts +148 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-faceting/columnFacetingFeature.d.ts +12 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-faceting/columnFacetingFeature.types.d.ts +63 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/columnFilteringFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/columnFilteringFeature.types.d.ts +209 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/filterFns.d.ts +35 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-grouping/columnGroupingFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-grouping/columnGroupingFeature.types.d.ts +128 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-ordering/columnOrderingFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-ordering/columnOrderingFeature.types.d.ts +82 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-pinning/columnPinningFeature.d.ts +11 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-pinning/columnPinningFeature.types.d.ts +195 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-resizing/columnResizingFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-resizing/columnResizingFeature.types.d.ts +73 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-sizing/columnSizingFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-sizing/columnSizingFeature.types.d.ts +134 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-visibility/columnVisibilityFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-visibility/columnVisibilityFeature.types.d.ts +92 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/global-filtering/globalFilteringFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/global-filtering/globalFilteringFeature.types.d.ts +67 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/aggregationFns.d.ts +23 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.types.d.ts +183 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.utils.d.ts +18 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-expanding/rowExpandingFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-expanding/rowExpandingFeature.types.d.ts +125 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-pagination/rowPaginationFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-pagination/rowPaginationFeature.types.d.ts +135 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-pinning/rowPinningFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-pinning/rowPinningFeature.types.d.ts +76 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-selection/rowSelectionFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-selection/rowSelectionFeature.types.d.ts +187 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/rowSortingFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/rowSortingFeature.types.d.ts +236 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/sortFns.d.ts +23 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/stockFeatures.d.ts +37 -0
- package/dist/node_modules/@tanstack/table-core/dist/helpers/columnHelper.d.ts +47 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/Cell.d.ts +16 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/Column.d.ts +30 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/ColumnDef.d.ts +123 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/Header.d.ts +12 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/HeaderGroup.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/Row.d.ts +24 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/RowModel.d.ts +19 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/RowModelFns.d.ts +11 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/Table.d.ts +53 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/TableFeatures.d.ts +416 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/TableOptions.d.ts +78 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/TableState.d.ts +46 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/type-utils.d.ts +25 -0
- package/dist/shared.css +179 -0
- package/dist/styles.css +5467 -0
- package/dist/theme.css +314 -0
- package/dist/theme.map.json +278 -0
- package/dist/tokens/index.d.ts +2 -0
- package/dist/tokens/index.js +1 -0
- package/dist/tokens/tokens.generated.d.ts +2040 -0
- package/dist/tokens/tokens.generated.js +2053 -0
- package/dist/tokens.css +484 -0
- package/dist/tokens.flat.json +429 -0
- package/docs/Consuming.mdx +379 -0
- package/docs/Contributing.mdx +78 -0
- package/docs/ForAgents.mdx +53 -0
- package/docs/Introduction.mdx +54 -0
- package/llms.txt +556 -0
- package/package.json +351 -3
- package/src/components/action-row/ActionRow.mdx +686 -0
- package/src/components/action-row/ActionRow.stories.tsx +669 -0
- package/src/components/action-row/ActionRow.tsx +632 -0
- package/src/components/action-row/index.ts +9 -0
- package/src/components/alert/Alert.mdx +377 -0
- package/src/components/alert/Alert.stories.tsx +674 -0
- package/src/components/alert/Alert.tsx +579 -0
- package/src/components/alert/index.ts +13 -0
- package/src/components/anchored-panel/AnchoredPanel.mdx +381 -0
- package/src/components/anchored-panel/AnchoredPanel.stories.tsx +593 -0
- package/src/components/anchored-panel/AnchoredPanel.tsx +176 -0
- package/src/components/anchored-panel/index.ts +15 -0
- package/src/components/badge/Badge.mdx +487 -0
- package/src/components/badge/Badge.stories.tsx +375 -0
- package/src/components/badge/Badge.tsx +360 -0
- package/src/components/badge/index.ts +10 -0
- package/src/components/banner/Banner.mdx +704 -0
- package/src/components/banner/Banner.stories.tsx +448 -0
- package/src/components/banner/Banner.tsx +602 -0
- package/src/components/banner/index.ts +14 -0
- package/src/components/button/Button.mdx +286 -0
- package/src/components/button/Button.stories.tsx +381 -0
- package/src/components/button/Button.tsx +384 -0
- package/src/components/button/index.ts +1 -0
- package/src/components/button-group/ButtonGroup.mdx +512 -0
- package/src/components/button-group/ButtonGroup.stories.tsx +714 -0
- package/src/components/button-group/ButtonGroup.tsx +491 -0
- package/src/components/button-group/index.ts +10 -0
- package/src/components/card-select/CardSelect.mdx +662 -0
- package/src/components/card-select/CardSelect.stories.tsx +784 -0
- package/src/components/card-select/CardSelect.tsx +783 -0
- package/src/components/card-select/CardSelectGroup.tsx +169 -0
- package/src/components/card-select/index.ts +18 -0
- package/src/components/checkbox/Checkbox.mdx +269 -0
- package/src/components/checkbox/Checkbox.stories.tsx +306 -0
- package/src/components/checkbox/Checkbox.tsx +343 -0
- package/src/components/checkbox/index.ts +1 -0
- package/src/components/chip/Chip.mdx +683 -0
- package/src/components/chip/Chip.stories.tsx +734 -0
- package/src/components/chip/Chip.tsx +732 -0
- package/src/components/chip/index.ts +9 -0
- package/src/components/column-header/ColumnHeader.mdx +301 -0
- package/src/components/column-header/ColumnHeader.stories.tsx +319 -0
- package/src/components/column-header/ColumnHeader.tsx +287 -0
- package/src/components/column-header/index.ts +7 -0
- package/src/components/combobox-field/Combobox.tsx +693 -0
- package/src/components/combobox-field/ComboboxField.mdx +525 -0
- package/src/components/combobox-field/ComboboxField.stories.tsx +502 -0
- package/src/components/combobox-field/ComboboxField.tsx +259 -0
- package/src/components/combobox-field/index.ts +12 -0
- package/src/components/date-field/DateField.mdx +340 -0
- package/src/components/date-field/DateField.stories.tsx +221 -0
- package/src/components/date-field/DateField.tsx +176 -0
- package/src/components/date-field/index.ts +1 -0
- package/src/components/date-picker/DatePicker.mdx +436 -0
- package/src/components/date-picker/DatePicker.stories.tsx +458 -0
- package/src/components/date-picker/DatePicker.tsx +688 -0
- package/src/components/date-picker/index.ts +9 -0
- package/src/components/divider/Divider.mdx +256 -0
- package/src/components/divider/Divider.stories.tsx +177 -0
- package/src/components/divider/Divider.tsx +193 -0
- package/src/components/divider/index.ts +1 -0
- package/src/components/drawer/Drawer.mdx +518 -0
- package/src/components/drawer/Drawer.stories.tsx +392 -0
- package/src/components/drawer/Drawer.tsx +683 -0
- package/src/components/drawer/index.ts +1 -0
- package/src/components/dropdown-button/DropdownButton.mdx +285 -0
- package/src/components/dropdown-button/DropdownButton.stories.tsx +398 -0
- package/src/components/dropdown-button/DropdownButton.tsx +198 -0
- package/src/components/dropdown-button/index.ts +7 -0
- package/src/components/faq/FAQ.mdx +364 -0
- package/src/components/faq/FAQ.stories.tsx +343 -0
- package/src/components/faq/FAQ.tsx +337 -0
- package/src/components/faq/index.ts +1 -0
- package/src/components/field/Field.mdx +129 -0
- package/src/components/field/Field.stories.tsx +461 -0
- package/src/components/field/Field.tsx +765 -0
- package/src/components/field/index.ts +20 -0
- package/src/components/field-pair/FieldPair.mdx +308 -0
- package/src/components/field-pair/FieldPair.stories.tsx +530 -0
- package/src/components/field-pair/FieldPair.tsx +796 -0
- package/src/components/field-pair/index.ts +9 -0
- package/src/components/file-upload/FileUpload.mdx +345 -0
- package/src/components/file-upload/FileUpload.stories.tsx +698 -0
- package/src/components/file-upload/FileUpload.tsx +802 -0
- package/src/components/file-upload/index.ts +6 -0
- package/src/components/filter-chip/FilterChip.mdx +778 -0
- package/src/components/filter-chip/FilterChip.stories.tsx +827 -0
- package/src/components/filter-chip/FilterChip.tsx +881 -0
- package/src/components/filter-chip/index.ts +11 -0
- package/src/components/filter-facet/FilterFacet.mdx +536 -0
- package/src/components/filter-facet/FilterFacet.stories.tsx +506 -0
- package/src/components/filter-facet/FilterFacet.tsx +1160 -0
- package/src/components/filter-facet/index.ts +7 -0
- package/src/components/firm-avatar/FirmAvatar.mdx +280 -0
- package/src/components/firm-avatar/FirmAvatar.stories.tsx +147 -0
- package/src/components/firm-avatar/FirmAvatar.tsx +172 -0
- package/src/components/firm-avatar/index.ts +7 -0
- package/src/components/form-actions/FormActions.mdx +518 -0
- package/src/components/form-actions/FormActions.stories.tsx +621 -0
- package/src/components/form-actions/FormActions.tsx +273 -0
- package/src/components/form-actions/index.ts +6 -0
- package/src/components/form-block/FormBlock.mdx +728 -0
- package/src/components/form-block/FormBlock.stories.tsx +813 -0
- package/src/components/form-block/FormBlock.tsx +679 -0
- package/src/components/form-block/index.ts +13 -0
- package/src/components/form-section/FormSection.mdx +436 -0
- package/src/components/form-section/FormSection.stories.tsx +407 -0
- package/src/components/form-section/FormSection.tsx +290 -0
- package/src/components/form-section/index.ts +17 -0
- package/src/components/heading/Heading.mdx +206 -0
- package/src/components/heading/Heading.stories.tsx +169 -0
- package/src/components/heading/Heading.tsx +124 -0
- package/src/components/heading/index.ts +8 -0
- package/src/components/heading-group/HeadingGroup.mdx +521 -0
- package/src/components/heading-group/HeadingGroup.stories.tsx +353 -0
- package/src/components/heading-group/HeadingGroup.tsx +396 -0
- package/src/components/heading-group/index.ts +7 -0
- package/src/components/hero/Hero.mdx +742 -0
- package/src/components/hero/Hero.stories.tsx +527 -0
- package/src/components/hero/Hero.tsx +807 -0
- package/src/components/hero/index.ts +1 -0
- package/src/components/icon/Icon.mdx +329 -0
- package/src/components/icon/Icon.stories.tsx +398 -0
- package/src/components/icon/Icon.tsx +97 -0
- package/src/components/icon/index.ts +2 -0
- package/src/components/icon-button/IconButton.mdx +206 -0
- package/src/components/icon-button/IconButton.stories.tsx +341 -0
- package/src/components/icon-button/IconButton.tsx +273 -0
- package/src/components/icon-button/index.ts +1 -0
- package/src/components/item-row/ItemRow.mdx +533 -0
- package/src/components/item-row/ItemRow.stories.tsx +434 -0
- package/src/components/item-row/ItemRow.tsx +676 -0
- package/src/components/item-row/index.ts +9 -0
- package/src/components/list-row/ListRow.mdx +404 -0
- package/src/components/list-row/ListRow.stories.tsx +404 -0
- package/src/components/list-row/ListRow.tsx +424 -0
- package/src/components/list-row/index.ts +1 -0
- package/src/components/menu/Menu.mdx +268 -0
- package/src/components/menu/Menu.stories.tsx +455 -0
- package/src/components/menu/Menu.tsx +452 -0
- package/src/components/menu/index.ts +1 -0
- package/src/components/modal/Modal.mdx +854 -0
- package/src/components/modal/Modal.stories.tsx +881 -0
- package/src/components/modal/Modal.tsx +1434 -0
- package/src/components/modal/index.ts +1 -0
- package/src/components/nav-link/NavLink.mdx +196 -0
- package/src/components/nav-link/NavLink.stories.tsx +243 -0
- package/src/components/nav-link/NavLink.tsx +222 -0
- package/src/components/nav-link/index.ts +1 -0
- package/src/components/number-field/NumberField.mdx +223 -0
- package/src/components/number-field/NumberField.stories.tsx +291 -0
- package/src/components/number-field/NumberField.tsx +388 -0
- package/src/components/number-field/index.ts +6 -0
- package/src/components/pagination/Pagination.mdx +305 -0
- package/src/components/pagination/Pagination.stories.tsx +333 -0
- package/src/components/pagination/Pagination.tsx +343 -0
- package/src/components/pagination/index.ts +8 -0
- package/src/components/popover-surface/PopoverSurface.mdx +158 -0
- package/src/components/popover-surface/PopoverSurface.stories.tsx +421 -0
- package/src/components/popover-surface/index.ts +1 -0
- package/src/components/progress-bar/ProgressBar.mdx +802 -0
- package/src/components/progress-bar/ProgressBar.stories.tsx +533 -0
- package/src/components/progress-bar/ProgressBar.tsx +654 -0
- package/src/components/progress-bar/index.ts +9 -0
- package/src/components/promo-sticker/PromoSticker.mdx +436 -0
- package/src/components/promo-sticker/PromoSticker.stories.tsx +363 -0
- package/src/components/promo-sticker/PromoSticker.tsx +313 -0
- package/src/components/promo-sticker/index.ts +7 -0
- package/src/components/promo-surface/PromoSurface.mdx +399 -0
- package/src/components/promo-surface/PromoSurface.stories.tsx +270 -0
- package/src/components/promo-surface/PromoSurface.tsx +305 -0
- package/src/components/promo-surface/index.ts +7 -0
- package/src/components/radio/Radio.mdx +243 -0
- package/src/components/radio/Radio.stories.tsx +307 -0
- package/src/components/radio/Radio.tsx +288 -0
- package/src/components/radio/index.ts +1 -0
- package/src/components/radio-group/RadioGroup.mdx +119 -0
- package/src/components/radio-group/RadioGroup.stories.tsx +225 -0
- package/src/components/radio-group/RadioGroup.tsx +139 -0
- package/src/components/radio-group/index.ts +1 -0
- package/src/components/select/Select.mdx +241 -0
- package/src/components/select/Select.stories.tsx +404 -0
- package/src/components/select/Select.tsx +381 -0
- package/src/components/select/index.ts +1 -0
- package/src/components/select-field/SelectField.mdx +324 -0
- package/src/components/select-field/SelectField.stories.tsx +460 -0
- package/src/components/select-field/SelectField.tsx +138 -0
- package/src/components/select-field/index.ts +1 -0
- package/src/components/skeleton/Skeleton.mdx +194 -0
- package/src/components/skeleton/Skeleton.stories.tsx +260 -0
- package/src/components/skeleton/Skeleton.tsx +107 -0
- package/src/components/skeleton/index.ts +1 -0
- package/src/components/split-button/SplitButton.mdx +445 -0
- package/src/components/split-button/SplitButton.stories.tsx +465 -0
- package/src/components/split-button/SplitButton.tsx +361 -0
- package/src/components/split-button/index.ts +7 -0
- package/src/components/status-summary-bar/StatusSummaryBar.mdx +338 -0
- package/src/components/status-summary-bar/StatusSummaryBar.stories.tsx +408 -0
- package/src/components/status-summary-bar/StatusSummaryBar.tsx +428 -0
- package/src/components/status-summary-bar/index.ts +8 -0
- package/src/components/subject-lookup-field/SubjectLookupField.mdx +378 -0
- package/src/components/subject-lookup-field/SubjectLookupField.stories.tsx +393 -0
- package/src/components/subject-lookup-field/SubjectLookupField.tsx +1079 -0
- package/src/components/subject-lookup-field/index.ts +11 -0
- package/src/components/switch/Switch.mdx +376 -0
- package/src/components/switch/Switch.stories.tsx +296 -0
- package/src/components/switch/Switch.tsx +483 -0
- package/src/components/switch/index.ts +1 -0
- package/src/components/table/Table.mdx +575 -0
- package/src/components/table/Table.stories.tsx +1049 -0
- package/src/components/table/Table.tsx +745 -0
- package/src/components/table/TableConsumers.stories.tsx +195 -0
- package/src/components/table/_tableFixtures.ts +1189 -0
- package/src/components/table/index.ts +22 -0
- package/src/components/text-field/TextField.mdx +479 -0
- package/src/components/text-field/TextField.stories.tsx +366 -0
- package/src/components/text-field/TextField.tsx +391 -0
- package/src/components/text-field/index.ts +8 -0
- package/src/components/text-link/TextLink.mdx +353 -0
- package/src/components/text-link/TextLink.stories.tsx +458 -0
- package/src/components/text-link/TextLink.tsx +504 -0
- package/src/components/text-link/index.ts +10 -0
- package/src/components/textarea/Textarea.mdx +244 -0
- package/src/components/textarea/Textarea.stories.tsx +371 -0
- package/src/components/textarea/Textarea.tsx +489 -0
- package/src/components/textarea/index.ts +9 -0
- package/src/components/tooltip/Tooltip.mdx +462 -0
- package/src/components/tooltip/Tooltip.stories.tsx +500 -0
- package/src/components/tooltip/Tooltip.tsx +756 -0
- package/src/components/tooltip/index.ts +13 -0
- package/src/components/unit-field/UnitField.mdx +215 -0
- package/src/components/unit-field/UnitField.stories.tsx +291 -0
- package/src/components/unit-field/UnitField.tsx +255 -0
- package/src/components/unit-field/index.ts +7 -0
- package/src/icons/icon-registry.generated.ts +510 -0
- package/src/icons/icon-types.generated.ts +256 -0
- package/src/index.ts +71 -0
- package/src/internal/BottomSheet.tsx +714 -0
- package/src/internal/FodsProvider.tsx +36 -0
- package/src/internal/MotionCaret.tsx +53 -0
- package/src/internal/NumberFormatInput.tsx +276 -0
- package/src/internal/SummaryDonut.tsx +359 -0
- package/src/internal/buttonSegment.ts +241 -0
- package/src/internal/collapseRoom.ts +130 -0
- package/src/internal/comboboxKeys.ts +90 -0
- package/src/internal/contentPresence.ts +46 -0
- package/src/internal/dayCell.ts +274 -0
- package/src/internal/dialogPortal.ts +50 -0
- package/src/internal/donutSweeps.ts +77 -0
- package/src/internal/enterOnViewGeometry.ts +53 -0
- package/src/internal/faqItem.ts +104 -0
- package/src/internal/floatingLabelMotion.tsx +109 -0
- package/src/internal/formBlockContext.ts +27 -0
- package/src/internal/heightRoom.ts +135 -0
- package/src/internal/numberSeparators.ts +93 -0
- package/src/internal/overlayMotion.tsx +32 -0
- package/src/internal/paginationItem.ts +106 -0
- package/src/internal/popoverSurface.ts +78 -0
- package/src/internal/portalContainer.ts +11 -0
- package/src/internal/progressBarItem.ts +356 -0
- package/src/internal/selectionControlText.ts +42 -0
- package/src/internal/statusSummaryParts.tsx +475 -0
- package/src/internal/summaryMotion.ts +111 -0
- package/src/internal/table/ChildConnector.tsx +57 -0
- package/src/internal/table/ChildRowPrefix.tsx +21 -0
- package/src/internal/table/ColumnSettings.tsx +194 -0
- package/src/internal/table/ScrollRegion.tsx +176 -0
- package/src/internal/table/TableEmpty.tsx +99 -0
- package/src/internal/table/TableLayout.tsx +29 -0
- package/src/internal/table/TableLoadStatus.tsx +60 -0
- package/src/internal/table/TableMobile.tsx +582 -0
- package/src/internal/table/TruncatedCell.tsx +35 -0
- package/src/internal/table/emptyValue.ts +11 -0
- package/src/internal/table/features.ts +44 -0
- package/src/internal/table/recipes.ts +263 -0
- package/src/internal/table/rowClick.ts +8 -0
- package/src/internal/table/types.ts +342 -0
- package/src/internal/tailwind-variants.ts +65 -0
- package/src/internal/tooltipContext.ts +15 -0
- package/src/internal/tw-merge-config.generated.ts +275 -0
- package/src/internal/useAnchoredPanel.ts +340 -0
- package/src/internal/useCountUp.ts +65 -0
- package/src/internal/useDateFieldTrigger.tsx +357 -0
- package/src/internal/useEChart.ts +88 -0
- package/src/internal/useEnterOnView.ts +80 -0
- package/src/internal/useFloatingBar.ts +125 -0
- package/src/internal/useFormReset.ts +47 -0
- package/src/internal/useIsMobile.ts +64 -0
- package/src/internal/useNoImplicitSubmit.ts +41 -0
- package/src/internal/useOneRowOverflow.ts +103 -0
- package/src/internal/usePrefersReducedMotion.ts +27 -0
- package/src/internal/useReturnFocus.ts +34 -0
- package/src/internal/utils.ts +58 -0
- package/src/recipes/EmptyState.stories.tsx +105 -0
- package/src/recipes/Form.stories.tsx +355 -0
- package/src/recipes/ModalWithForm.stories.tsx +219 -0
- package/src/recipes/Recipes.mdx +61 -0
- package/src/recipes/TableWithFilters.stories.tsx +278 -0
- package/src/storybook/FodsFamily.tsx +39 -0
- package/src/storybook/Section.tsx +36 -0
- package/src/storybook/a11y.ts +24 -0
- package/src/storybook/assets/banner-character-bartender.webp +0 -0
- package/src/storybook/assets/banner-invoice-sheet-left.webp +0 -0
- package/src/storybook/assets/banner-invoice-sheet-right.webp +0 -0
- package/src/storybook/assets/invoice-hero.webp +0 -0
- package/src/storybook/assets/invoice.webp +0 -0
- package/src/storybook/assets/section-document-info.svg +21 -0
- package/src/storybook/assets/section-gear-checklist.svg +11 -0
- package/src/storybook/assets/section-person-arrow-in.svg +15 -0
- package/src/storybook/assets/section-person-arrow-out.svg +22 -0
- package/src/storybook/assets/section-receipt-dollar.svg +23 -0
- package/src/storybook/assets/table-empty-folder-empty.png +0 -0
- package/src/storybook/assets/table-empty-folder-magnifying-glass.png +0 -0
- package/src/storybook/assets/table-empty-funnel.png +0 -0
- package/src/storybook/assets/table-empty-load-failed.png +0 -0
- package/src/storybook/assets/wallet-spot.png +0 -0
- package/src/storybook/assets.d.ts +17 -0
- package/src/storybook/componentDoc.ts +41 -0
- package/src/storybook/fitFrame.tsx +70 -0
- package/src/storybook/forceStates.tsx +647 -0
- package/src/storybook/illustrations.tsx +66 -0
- package/src/storybook/viewportFrame.tsx +58 -0
- package/src/styles/assets/label-brush-1.svg +6 -0
- package/src/styles/assets/pattern-dark.svg +113 -0
- package/src/styles/base.css +106 -0
- package/src/styles/index.css +15 -0
- package/src/styles/motion.css +157 -0
- package/src/styles/promo-sticker.css +27 -0
- package/src/styles/promo-surface.css +49 -0
- package/src/styles/shared.css +11 -0
- package/src/styles/theme.generated.css +314 -0
- package/src/styles/theme.map.json +278 -0
- package/src/styles/tracking.generated.css +12 -0
- package/src/tokens/index.ts +4 -0
- package/src/tokens/tokens.generated.ts +542 -0
|
@@ -0,0 +1,536 @@
|
|
|
1
|
+
import { Meta, Canvas, Controls } from '@storybook/addon-docs/blocks';
|
|
2
|
+
import * as FilterFacetStories from './FilterFacet.stories';
|
|
3
|
+
|
|
4
|
+
<Meta of={FilterFacetStories} tags={['autodocs']} />
|
|
5
|
+
|
|
6
|
+
# FilterFacet
|
|
7
|
+
|
|
8
|
+
## Metadata
|
|
9
|
+
|
|
10
|
+
- **Layer:** organism
|
|
11
|
+
- **Status:** draft
|
|
12
|
+
- **Composes:** [`FilterChip`](?path=/docs/design-system-atoms-filterchip--docs) (Facet trigger) + [`PopoverSurface`](?path=/docs/design-system-patterns-popover-surface--docs) (panel chrome) + [`ListRow`](?path=/docs/design-system-atoms-listrow--docs) Small 36 (`option` rows; checkbox rows under `multiple`) + [`TextField`](?path=/docs/design-system-atoms-textfield--docs) Small 40 (optional search header) · under `multiple` also [`Checkbox`](?path=/docs/design-system-atoms-checkbox--docs) Small 16, a label-only [`Divider`](?path=/docs/design-system-atoms-divider--docs) title and, on the mobile bottom sheet only, a [`Button`](?path=/docs/design-system-atoms-button--docs) footer
|
|
13
|
+
- **Behaviour engine:** [`@floating-ui/react`](https://floating-ui.com/docs/react) — positioning, list navigation, typeahead, dismiss, role, transition; under `multiple` and for a searchable single facet a non-modal focus manager instead of list navigation (the searchable single facet's input drives the row cursor itself)
|
|
14
|
+
- **Built against:** `filter-chip` manifest `1.14.1` (the organism has no manifest of its own)
|
|
15
|
+
- **Tokens used:** `--bg-active`, `--bg-hover`, `--bg-primary`, `--bg-secondary`, `--border-width-100`, `--border-width-200`, `--disabled-control`, `--disabled-foreground`, `--font-body`, `--font-size-base`, `--font-size-sm`, `--font-size-xs`, `--font-weight-normal`, `--font-weight-semibold`, `--icon-muted`, `--leading-loose`, `--leading-relaxed`, `--outline-default`, `--outline-focus`, `--outline-focus-inverse`, `--radius-200`, `--radius-300`, `--radius-400`, `--radius-500`, `--secondary`, `--secondary-active`, `--secondary-foreground`, `--secondary-hover`, `--secondary-solid`, `--shadow-overlay`, `--size-icon-small`, `--size-icon-xsmall`, `--space-100`, `--space-1000`, `--space-200`, `--space-300`, `--space-400`, `--space-500`, `--space-600`, `--space-900`, `--status-danger`, `--status-danger-foreground`, `--status-danger-hover`, `--status-danger-solid`, `--status-warning-foreground`, `--status-warning-hover`, `--status-warning-solid`, `--text-link`, `--text-link-hover`, `--text-primary`, `--text-secondary`, `--text-wrap-body`, `--z-index-dropdown`
|
|
16
|
+
|
|
17
|
+
## Overview
|
|
18
|
+
|
|
19
|
+
**FilterFacet** is the working half of a faceted filter bar: a `FilterChip` Facet and the options
|
|
20
|
+
panel it opens, wired together. You pass `options`, `value` and `onValueChange`; it owns open/close,
|
|
21
|
+
the keyboard model, the search header, collision flip/shift and the exit transition.
|
|
22
|
+
|
|
23
|
+
It ships **two selection models**, keyed on `multiple`, because they are two incompatible ARIA and
|
|
24
|
+
keyboard contracts rather than one widget with a flag:
|
|
25
|
+
|
|
26
|
+
- **Single** (the default) — § Filter facet. The chip is a `role="combobox"` that points into a
|
|
27
|
+
`listbox` with `aria-activedescendant`; a `Vše` row comes first, and a pick commits and closes.
|
|
28
|
+
- **Multiple** (`multiple`) — § Multi-select filter. The chip is a plain button with
|
|
29
|
+
`aria-haspopup="dialog"` (`filter-chip` 1.7.0), focus moves **into** a `role="group"` of native
|
|
30
|
+
checkboxes, every tick is applied live and the panel stays open.
|
|
31
|
+
|
|
32
|
+
The division is the spec's, not a convenience. The **chip** is the trigger and the applied-value
|
|
33
|
+
display — it morphs in place from the category noun into the chosen value and grows a clearing ×.
|
|
34
|
+
The **panel** is a separate composition that fills the shared popover surface with rows. Neither
|
|
35
|
+
knows the other's internals, which is why the chip alone is a usable control in a bar that has no
|
|
36
|
+
panel yet.
|
|
37
|
+
|
|
38
|
+
Reach for it when a filter-bar control picks **one value out of a bounded set** whose options carry
|
|
39
|
+
live result counts — Kraj, Stav, Obor činnosti — and for `multiple` when several values of one facet may
|
|
40
|
+
apply at once, OR-ed together — Dodavatel. For a binary flag use `FilterChip` with `type="toggle"`
|
|
41
|
+
directly: there is nothing to open.
|
|
42
|
+
|
|
43
|
+
<Canvas of={FilterFacetStories.Playground} />
|
|
44
|
+
<Controls />
|
|
45
|
+
|
|
46
|
+
The Playground drives the single form: CSF args cannot resolve the `multiple` union, so the multi
|
|
47
|
+
form has its own stories (see [Variants](#variants)).
|
|
48
|
+
|
|
49
|
+
## Rationale
|
|
50
|
+
|
|
51
|
+
Four things make this its own organism rather than a `Select` with a different trigger.
|
|
52
|
+
|
|
53
|
+
**The panel hugs, the field's panel does not.** A `Select` panel is never narrower than the field
|
|
54
|
+
that opened it, because a field has a meaningful width to fill. A chip does not — it is hug-width by
|
|
55
|
+
construction, so a panel matched to it would be a sliver. This one sits in the spec's compact-trigger
|
|
56
|
+
band instead, roughly 180 to 320.
|
|
57
|
+
|
|
58
|
+
**The trigger locks the row density.** The chip ships in two tiers, Small 32 and Medium 40, but the
|
|
59
|
+
panel has exactly one form: `ListRow` **Small 36** either way. That is stated in the chip's own
|
|
60
|
+
manifest and it is why the Matrix below shows two chip sizes opening the same panel.
|
|
61
|
+
|
|
62
|
+
**The reset lives in two places at once.** The × on an applied chip and the `Vše` row at the top of
|
|
63
|
+
the single panel do the same thing. Both exist because they answer the same question from different
|
|
64
|
+
places — one from the bar, one from inside the list — and dropping either one strands a user who is
|
|
65
|
+
looking in the wrong place. A `multiple` panel has no `Vše` row: unticking is the in-panel way out,
|
|
66
|
+
and the chip's × clears every tick at once. The panel is anchored to the trigger `<button>`, not to
|
|
67
|
+
the pill, so pressing × while the panel is open counts as an outside press: the panel closes first,
|
|
68
|
+
then the selection clears.
|
|
69
|
+
|
|
70
|
+
**Several values need a different panel, not a flag.** A `listbox` commits and closes on a single
|
|
71
|
+
pick, which is exactly wrong for "tick three, then keep ticking". So the multi form is the spec's
|
|
72
|
+
Multi-select filter — a `group` of real checkboxes that focus enters — and the chip announces that
|
|
73
|
+
panel as a dialog instead of a listbox. Same chip, same rows, same search header; different roles
|
|
74
|
+
and a different focus model.
|
|
75
|
+
|
|
76
|
+
## Anatomy
|
|
77
|
+
|
|
78
|
+
**Single** (the default):
|
|
79
|
+
|
|
80
|
+
```
|
|
81
|
+
[ ⌄ Dodavatel ] ← FilterChip, type="facet" — role="combobox", aria-haspopup="listbox"
|
|
82
|
+
│ aria-expanded, aria-controls, aria-activedescendant
|
|
83
|
+
│ ↕ --space-200 (4), bottom-start, flips on collision
|
|
84
|
+
┌─────┴──────────────────────┐
|
|
85
|
+
│ 🔍 Hledat… │ ← header — TextField Small 40, label-less, in an 8 / 4 frame.
|
|
86
|
+
├────────────────────────────┤ CONDITIONAL: only past ~5 options.
|
|
87
|
+
│ ✓ Vše │ ← the panel's bottom rule, added by the surface.
|
|
88
|
+
│ Čistota Plus 36 │ ← body — ListRow Small 36, showCount on,
|
|
89
|
+
│ Datacentrum Sever 24 │ one group at the 4px inset
|
|
90
|
+
│ Pekárna Růžička 19 │
|
|
91
|
+
│ Beta Servis 0 │ ← zero renders; the row goes Disabled, never hidden
|
|
92
|
+
└────────────────────────────┘
|
|
93
|
+
width: hug, min ~180 / max ~320 — never the trigger's width
|
|
94
|
+
```
|
|
95
|
+
|
|
96
|
+
**Multiple** (`multiple`):
|
|
97
|
+
|
|
98
|
+
```
|
|
99
|
+
[ ▣ Čistota Plus +2 × ] ← FilterChip, type="facet", popup="dialog" — plain <button>,
|
|
100
|
+
│ aria-haspopup="dialog", aria-expanded, aria-controls (while open)
|
|
101
|
+
│ ↕ --space-200 (4), bottom-start, flips on collision
|
|
102
|
+
┌─────┴──────────────────────┐ role="group", aria-labelledby → title (+ hidden count text)
|
|
103
|
+
│ 🔍 Hledat… │ ← header — the same search field and frame as single
|
|
104
|
+
├────────────────────────────┤
|
|
105
|
+
│ Dodavatel (3) │ ← title — label-only Divider, "(N)" only while N ≥ 1
|
|
106
|
+
│ ☑ Čistota Plus 36 │ ← ListRow Small 36 + Checkbox Small 16 in the leading slot;
|
|
107
|
+
│ ☑ Datacentrum Sever 24 │ the row text is a native <label htmlFor> to the checkbox
|
|
108
|
+
│ ☑ Pekárna Růžička 19 │
|
|
109
|
+
│ ☐ Alfa Obchod 11 │
|
|
110
|
+
│ ☐ Gama Telekom 0 │ ← zero → a genuinely disabled checkbox; the row stays
|
|
111
|
+
└────────────────────────────┘ ← no footer: every tick is already applied
|
|
112
|
+
```
|
|
113
|
+
|
|
114
|
+
The anchored multi panel has no footer. The „Hotovo“ footer (`doneLabel`) belongs to the mobile
|
|
115
|
+
bottom sheet only, see Accessibility → Mobile bottom sheet.
|
|
116
|
+
|
|
117
|
+
With fewer than about five options there is **no header and no divider**. The rule is the placement
|
|
118
|
+
law rather than a style preference: the divider's job is to separate the header from the rows, so
|
|
119
|
+
with nothing above them there is nothing to separate. The multi title is a **label-only** divider for
|
|
120
|
+
the same law — a line may never open the body.
|
|
121
|
+
|
|
122
|
+
**The search frame is the one exception to the 16px content column.** It pads `--space-400` (8)
|
|
123
|
+
horizontally and `--space-200` (4) vertically. The surface has no horizontal padding, a flat 4 top and
|
|
124
|
+
bottom, and a 4 gap between header, divider and body, so the field's **box** sits 8 from the panel edge
|
|
125
|
+
on top, left and right and 8 above the divider below it — the spec's "Search header frame padding"
|
|
126
|
+
row. Every other header/footer frame lands its content on the 16 column; this one aligns the field's
|
|
127
|
+
box, not its text. The frame lives in the organism, not in the generic header slot, and is the same in
|
|
128
|
+
both modes.
|
|
129
|
+
|
|
130
|
+
## Variants
|
|
131
|
+
|
|
132
|
+
The assembly has no variant axis of its own. What varies is the chip's selection, which the applied
|
|
133
|
+
value drives, whether the panel carries a search header, which the option count drives, and the
|
|
134
|
+
selection model, which `multiple` picks.
|
|
135
|
+
|
|
136
|
+
<Canvas of={FilterFacetStories.Matrix} />
|
|
137
|
+
|
|
138
|
+
### Multiple
|
|
139
|
+
|
|
140
|
+
<Canvas of={FilterFacetStories.MultiSelect} />
|
|
141
|
+
|
|
142
|
+
Each toggle emits the **whole** new array through `onValueChange`, live, and the panel stays open. The
|
|
143
|
+
array keeps **pick order**: a newly ticked value is appended, so the chip's leading value is the first
|
|
144
|
+
one applied and does not jump when an earlier option is ticked later. The chip shows the values in that
|
|
145
|
+
order, collapsing to `Čistota Plus +2` with the rest in `FilterChip`'s remainder Tooltip — which needs a
|
|
146
|
+
**`TooltipProvider` ancestor**. The chip's × emits `[]`.
|
|
147
|
+
|
|
148
|
+
## Sizes
|
|
149
|
+
|
|
150
|
+
`size` sets the **chip** tier only — Small 32 or Medium 40, matching the bar around it. The panel
|
|
151
|
+
does not follow. Its rows are Small 36 and its surface padding is the flat 4/4 under both. Under
|
|
152
|
+
`multiple` the checkbox is matched to that row — Small 16, never scaled.
|
|
153
|
+
|
|
154
|
+
<Canvas of={FilterFacetStories.ShortFacet} />
|
|
155
|
+
|
|
156
|
+
## States
|
|
157
|
+
|
|
158
|
+
**Single.** Row states come from `ListRow`: Default, Hover, Highlighted, Selected and Disabled.
|
|
159
|
+
Exactly one row is selected at a time, and it is marked by `ListRow`'s solid **`--bg-secondary`
|
|
160
|
+
Selected fill plus the leading checkmark** in `--secondary` (list-row 2.7.0); `aria-selected="true"`
|
|
161
|
+
carries the state for assistive tech. The label stays Regular: **no bolding, no recolour**.
|
|
162
|
+
|
|
163
|
+
Keyboard-current rows render the same `--bg-hover` wash as pointer hover — one visual for one
|
|
164
|
+
meaning, whichever device produced it — and on the chosen row the wash layers over the Selected
|
|
165
|
+
fill. The owner ruling of list-row 2.7.0 (2026-10-20) reverses an earlier design-QA build,
|
|
166
|
+
which had dropped the fill so the wash stayed the only one in the panel; see Migration notes.
|
|
167
|
+
|
|
168
|
+
**Multiple.** A checkbox row uses Default, Hover and Disabled; checked is read off the **checkbox**,
|
|
169
|
+
so `ListRow`'s Selected fill is never used and there is no checkmark — the box is the only selection
|
|
170
|
+
indicator, and the label stays Regular. The row never takes focus itself: the focus ring is the
|
|
171
|
+
checkbox's own, and the keyboard-current row gets the hover wash through CSS `:has(:focus-visible)`
|
|
172
|
+
(`has-[:focus-visible]:before:opacity-100`) while its checkbox holds keyboard focus. A zero-count or
|
|
173
|
+
`disabled` option renders a genuinely `disabled` checkbox — out of the tab order — and the row stays
|
|
174
|
+
visible, so the option set does not shift.
|
|
175
|
+
|
|
176
|
+
<Canvas of={FilterFacetStories.ZeroCounts} />
|
|
177
|
+
|
|
178
|
+
## Counts
|
|
179
|
+
|
|
180
|
+
A count answers **"how many rows would I get if I applied this"**. Three rules follow from that
|
|
181
|
+
sentence and all three are easy to get wrong:
|
|
182
|
+
|
|
183
|
+
- **Zero renders.** It is an answer, not an absence, so the row stays and goes Disabled. A row that
|
|
184
|
+
disappears makes the user hunt for an option that is simply empty right now.
|
|
185
|
+
- **Counts belong to the rows, never to an unselected chip.** A category is not appliable, so the
|
|
186
|
+
number on it would only ever be the unfiltered total. `FilterChip` enforces this structurally —
|
|
187
|
+
a Facet renders no count node at all.
|
|
188
|
+
- **An option's count is computed against the OTHER facets only.** Never against this facet's own
|
|
189
|
+
pick — or, under `multiple`, its own ticks. Counting against its own selection zeroes every sibling
|
|
190
|
+
the moment one supplier is chosen, and the filter reads as broken. The counts are the consumer's
|
|
191
|
+
job; the organism only renders what `options[].count` carries.
|
|
192
|
+
|
|
193
|
+
<Canvas of={FilterFacetStories.Searchable} />
|
|
194
|
+
|
|
195
|
+
## Search
|
|
196
|
+
|
|
197
|
+
The header appears from roughly **five** options. Below that the rows are faster to scan than to
|
|
198
|
+
type, and the spec's Do/Don't forbids a search input on a two- or three-option facet — a dev warning
|
|
199
|
+
fires in both directions.
|
|
200
|
+
|
|
201
|
+
The input is a label-less `TextField` Small 40 with a leading `magnifying-glass` glyph, pinned above the scroll
|
|
202
|
+
region, in the 8 / 4 frame described under [Anatomy](#anatomy). It is the same in both modes.
|
|
203
|
+
Matching folds diacritics, so `ruzicka` finds `Pekárna Růžička`. In single mode the `Vše` row is never
|
|
204
|
+
filtered out: it is not one of the options, it is the way out of an applied filter. Under `multiple`
|
|
205
|
+
the query only hides rows — a ticked value that does not match stays applied. Closing the panel clears
|
|
206
|
+
the query — re-opening to a stale filter would hide rows the user never chose to hide.
|
|
207
|
+
|
|
208
|
+
## Sorting
|
|
209
|
+
|
|
210
|
+
Sort rows by count, descending, **only where the option set has no order of its own.** A supplier
|
|
211
|
+
list qualifies. A period does not — it runs newest to oldest — and neither does a status, which runs
|
|
212
|
+
paid to overdue. Re-sorting either by number destroys the information the sequence itself carries.
|
|
213
|
+
|
|
214
|
+
## API
|
|
215
|
+
|
|
216
|
+
`FilterFacetProps` is a union discriminated on `multiple` — `FilterFacetSingleProps` |
|
|
217
|
+
`FilterFacetMultipleProps`, both exported. The props a form does not accept are type errors, not
|
|
218
|
+
silently ignored values.
|
|
219
|
+
|
|
220
|
+
<table>
|
|
221
|
+
<thead>
|
|
222
|
+
<tr><th>Prop</th><th>Form</th><th>Type</th><th>Note</th></tr>
|
|
223
|
+
</thead>
|
|
224
|
+
<tbody>
|
|
225
|
+
<tr><td><code>label</code></td><td>both</td><td><code>string</code></td><td>Required. The category noun on the chip; under <code>multiple</code> also the panel's title and the group's name.</td></tr>
|
|
226
|
+
<tr><td><code>options</code></td><td>both</td><td><code>FilterFacetOption[]</code></td><td>Required. <code>value</code>, <code>label</code>, optional <code>count</code>, <code>disabled</code>, <code>testId</code>. A <code>count</code> of <code>0</code> disables the row.</td></tr>
|
|
227
|
+
<tr><td><code>clearLabel</code></td><td>both</td><td><code>string</code></td><td>Required. The chip ×'s accessible name.</td></tr>
|
|
228
|
+
<tr><td><code>search</code></td><td>both</td><td>object: <code>label</code>, <code>placeholder?</code>, <code>emptyLabel</code></td><td>Opt-in search header. <code>label</code> names the label-less input, <code>emptyLabel</code> shows when the query matches nothing.</td></tr>
|
|
229
|
+
<tr><td><code>size</code></td><td>both</td><td><code>'sm' | 'md'</code></td><td>Chip tier only; default <code>'md'</code>.</td></tr>
|
|
230
|
+
<tr><td><code>leadingIcon</code></td><td>both</td><td><code>IconName | null</code></td><td>Forwarded to the chip.</td></tr>
|
|
231
|
+
<tr><td><code>disabled</code></td><td>both</td><td><code>boolean</code></td><td>Disables the chip (trigger and ×), so the panel cannot open.</td></tr>
|
|
232
|
+
<tr><td><code>className</code>, <code>data-testid</code></td><td>both</td><td><code>string</code></td><td>Land on the chip.</td></tr>
|
|
233
|
+
<tr><td><code>multiple</code></td><td>single</td><td><code>false</code> (optional)</td><td>Omit for the single form.</td></tr>
|
|
234
|
+
<tr><td><code>value</code></td><td>single</td><td><code>string</code></td><td>The applied value; the chip shows that option's label.</td></tr>
|
|
235
|
+
<tr><td><code>onValueChange</code></td><td>single</td><td><code>(value: string | undefined) => void</code></td><td>The picked value, or <code>undefined</code> from <code>Vše</code> or the ×.</td></tr>
|
|
236
|
+
<tr><td><code>allLabel</code></td><td>single</td><td><code>string</code></td><td>Required. The reset row's text. Not accepted under <code>multiple</code>, which has no reset row.</td></tr>
|
|
237
|
+
<tr><td><code>multiple</code></td><td>multiple</td><td><code>true</code></td><td>Required to pick the multi form.</td></tr>
|
|
238
|
+
<tr><td><code>value</code></td><td>multiple</td><td><code>string[]</code></td><td>The applied values, OR-ed together, in pick order.</td></tr>
|
|
239
|
+
<tr><td><code>onValueChange</code></td><td>multiple</td><td><code>(value: string[]) => void</code></td><td>Fired live on every toggle with the whole new array; <code>[]</code> from the ×.</td></tr>
|
|
240
|
+
<tr><td><code>selectedCountLabel</code></td><td>multiple</td><td><code>(count: number) => string</code></td><td>Required. The checked count as words for assistive tech (<code>Vybráno 2</code>). On the anchored panel (from <code>sm</code> up) it is part of the group's name; on the mobile bottom sheet it is the group's description and what the sheet's live region speaks. Called only for a count of 1 and up.</td></tr>
|
|
241
|
+
<tr><td><code>doneLabel</code></td><td>multiple</td><td><code>string</code></td><td>Default <code>'Hotovo'</code>. The label of the button in the mobile bottom sheet's footer, which only <strong>closes</strong> the sheet — it never commits, because every tick was already applied. The anchored panel from <code>sm</code> up has no footer and ignores it.</td></tr>
|
|
242
|
+
<tr><td><code>sheetCloseLabel</code></td><td>both</td><td><code>string</code></td><td>Default <code>'Zavřít'</code>. The name of the mobile bottom sheet's visually hidden close button.</td></tr>
|
|
243
|
+
</tbody>
|
|
244
|
+
</table>
|
|
245
|
+
|
|
246
|
+
The required strings — `label`, `clearLabel`, `allLabel`, `selectedCountLabel` and the strings inside
|
|
247
|
+
`search` — have no default. This organism ships on nine markets and has no locale of its own; a fallback string would
|
|
248
|
+
announce Czech on the PL, SK or EN sites. The caller translates them — and `selectedCountLabel` is a
|
|
249
|
+
function precisely so numeral agreement stays the locale's business — the same contract `FilterChip`
|
|
250
|
+
already carries for `clearLabel`.
|
|
251
|
+
|
|
252
|
+
The two strings of the mobile bottom sheet, `sheetCloseLabel` and `doneLabel`, are optional and fall
|
|
253
|
+
back to Czech („Zavřít“, „Hotovo“). They are locale texts: an app with more than one language version
|
|
254
|
+
passes both from its translations on every use. The full list of such props is in
|
|
255
|
+
[Consuming → Texts and locale](?path=/docs/getting-started-consuming--docs#texts-and-locale).
|
|
256
|
+
|
|
257
|
+
## Do / Don't
|
|
258
|
+
|
|
259
|
+
<table>
|
|
260
|
+
<thead>
|
|
261
|
+
<tr><th>✓ Do</th><th>✗ Don't</th></tr>
|
|
262
|
+
</thead>
|
|
263
|
+
<tbody>
|
|
264
|
+
<tr><td>Put <code>Vše</code> first, as the single facet's reset</td><td>Bury the reset among the value rows, or leave it out</td></tr>
|
|
265
|
+
<tr><td>Show the search header once the options outgrow scanning</td><td>Add a search input to a two- or three-option facet</td></tr>
|
|
266
|
+
<tr><td>Mark the chosen row with the Selected fill plus a leading <code>--secondary</code> checkmark (single)</td><td>Bold or recolour the selected row's label to show the choice</td></tr>
|
|
267
|
+
<tr><td>Commit and close on pick (single)</td><td>Leave the panel open after a single-select commit</td></tr>
|
|
268
|
+
<tr><td>Keep the panel open and apply every tick live (<code>multiple</code>)</td><td>Close the panel on a tick, or make <code>doneLabel</code> the moment the filter applies</td></tr>
|
|
269
|
+
<tr><td>Let the checkbox be the only selection indicator (<code>multiple</code>)</td><td>Add a checkmark or a Selected fill to a checked row</td></tr>
|
|
270
|
+
<tr><td>Render a zero count and disable the row</td><td>Hide an option that currently returns nothing</td></tr>
|
|
271
|
+
<tr><td>Let the chip show the applied value</td><td>Prefix it with the category — the morph replaces the label, it does not annotate it</td></tr>
|
|
272
|
+
</tbody>
|
|
273
|
+
</table>
|
|
274
|
+
|
|
275
|
+
## Accessibility
|
|
276
|
+
|
|
277
|
+
### Single
|
|
278
|
+
|
|
279
|
+
Two shapes, keyed on whether the panel carries the search header (`filter-chip` 1.9.0
|
|
280
|
+
`delivery.react`).
|
|
281
|
+
|
|
282
|
+
**Without search** — the trigger is the chip's own `<button role="combobox" aria-haspopup="listbox" aria-expanded>`, with
|
|
283
|
+
`aria-controls` pointing at the listbox while it is open. The panel is a `listbox` named by
|
|
284
|
+
`aria-label` = `label`, its rows are `option` with `aria-selected`, and **DOM focus never leaves the
|
|
285
|
+
trigger** — the current row is pointed at by `aria-activedescendant`, the virtual-focus model a
|
|
286
|
+
trigger that must keep focus requires. Since `filter-chip` 1.6.0 that is also what the spec says.
|
|
287
|
+
|
|
288
|
+
The role is written by `FilterChip` itself, not stamped by floating-ui, so a Facet announces the same
|
|
289
|
+
whoever mounts it. A combobox takes no name from its content, so the trigger is named by an
|
|
290
|
+
`aria-label`: the category (*"Dodavatel"*), or the category plus the applied value (*"Dodavatel:
|
|
291
|
+
Čistota Plus"*).
|
|
292
|
+
|
|
293
|
+
That wiring lands on the trigger button through `triggerProps`, not on the chip's root. The root is a
|
|
294
|
+
plain `<span>`, and `aria-activedescendant` is only read on the element that actually holds focus.
|
|
295
|
+
|
|
296
|
+
Keyboard: Enter, Space or ↓ / ↑ opens; ↑ ↓ move the highlight; Home and End jump; Enter or Space commits and
|
|
297
|
+
closes; Esc closes and returns focus to the trigger. Typing jumps to a matching row.
|
|
298
|
+
|
|
299
|
+
**With search** — the Combobox (search) pattern (`filter-chip` 1.8.0 focus model, 1.9.0 roles). The
|
|
300
|
+
chip trigger is a plain `<button aria-haspopup="listbox" aria-expanded>` (`FilterChip searchable`):
|
|
301
|
+
no `combobox` role, no `aria-activedescendant`. Opening moves **DOM focus into the search input**,
|
|
302
|
+
and the input is the combobox: `role="combobox"`, `aria-expanded`, `aria-autocomplete="list"`,
|
|
303
|
+
`aria-controls` pointing at the listbox and `aria-activedescendant` pointing at the highlighted
|
|
304
|
+
option. Because the input sits inside the panel, the panel is a `dialog` and the rows group below the
|
|
305
|
+
search header is the `listbox` (a listbox may own only options and groups), named by `label`. The
|
|
306
|
+
input owns the keys — the same handler `Combobox` uses: ↑ ↓ move the highlight, Home and
|
|
307
|
+
End jump, Enter commits the highlighted option and closes, Esc closes; in both cases focus returns
|
|
308
|
+
to the **chip trigger**, which is not a persistent input the way a Combobox field is. Typing narrows
|
|
309
|
+
the rows and re-seats the highlight on the first enabled match, so Enter after typing commits what
|
|
310
|
+
was searched for; with an empty query the highlight starts on the applied row (else `Vše`). A rows
|
|
311
|
+
change under an unchanged query — a parent re-rendering with a fresh but equal `options` array, or
|
|
312
|
+
a count update — keeps the highlight on the same option by value, and only re-seats it when that
|
|
313
|
+
option is gone or disabled, so Enter still commits the row reached with ↓. Enter, Space or ↓ / ↑
|
|
314
|
+
on the closed chip open the panel.
|
|
315
|
+
|
|
316
|
+
Focus returns to the trigger **button**: the floating reference is the button inside the pill, while
|
|
317
|
+
the panel is still positioned against the whole pill (`setPositionReference` on the root `<span>`).
|
|
318
|
+
Registering the span as the reference — as before — sent focus nowhere on close, because the span is
|
|
319
|
+
not focusable.
|
|
320
|
+
|
|
321
|
+
A disabled row carries `aria-disabled` and is skipped by navigation rather than removed, so the
|
|
322
|
+
sequence a screen-reader user hears matches what is on screen.
|
|
323
|
+
|
|
324
|
+
### Multiple
|
|
325
|
+
|
|
326
|
+
The trigger is a **plain** `<button aria-haspopup="dialog" aria-expanded>` — `FilterChip` with
|
|
327
|
+
`popup="dialog"`, `filter-chip` 1.7.0. It has no `combobox` role and no `aria-activedescendant`;
|
|
328
|
+
`aria-controls` points at the panel while it is open. The accessible name is the same string as in
|
|
329
|
+
single mode: the category followed by every applied value (*"Dodavatel: Čistota Plus, Datacentrum Sever,
|
|
330
|
+
Pekárna Růžička"*).
|
|
331
|
+
|
|
332
|
+
The panel is `role="group"`, named by `aria-labelledby` pointing at the title divider's label — and,
|
|
333
|
+
from one ticked row up, also at a hidden node holding `selectedCountLabel(n)`, so the group reads
|
|
334
|
+
*"Dodavatel Vybráno 2"* and the visual `(2)` is never the only carrier of how many filters are active.
|
|
335
|
+
Each row is a real `<input type="checkbox">` (`Checkbox` Small) whose name comes from the row text, a
|
|
336
|
+
native `<label htmlFor>` pointing at it; clicking the text toggles the box.
|
|
337
|
+
|
|
338
|
+
Keyboard: Enter or Space on the chip opens the panel and **focus moves in** — onto the search field
|
|
339
|
+
when there is one, else the first enabled checkbox. Tab / Shift-Tab walk the controls in DOM order,
|
|
340
|
+
Space toggles the focused checkbox and the panel stays open; there are no arrow keys and no typeahead,
|
|
341
|
+
because these are independent form controls, not a single-selection list. Esc closes and returns
|
|
342
|
+
focus to the chip. The focus manager is non-modal: there is **no focus trap** — it is a `group`, not a
|
|
343
|
+
modal dialog.
|
|
344
|
+
|
|
345
|
+
### Mobile bottom sheet (below `sm`)
|
|
346
|
+
|
|
347
|
+
Below `sm` a list facet opens a bottom sheet instead of the anchored panel (`overlay-behavior.md` §
|
|
348
|
+
Mobile; `filter-chip` § Accessibility). The sheet is a modal `dialog` (`aria-modal`, page `inert`)
|
|
349
|
+
titled by the facet `label`; Esc, the scrim, a drag down and the hidden „Zavřít“ button close it, and
|
|
350
|
+
focus returns to the **chip trigger**. The trigger is a plain `<button aria-haspopup="dialog"
|
|
351
|
+
aria-expanded>` in every form — no `combobox` role, no `aria-activedescendant`. A Range facet is not
|
|
352
|
+
a list facet and stays anchored. For the hidden close button, its name is the optional `sheetCloseLabel` (default „Zavřít“), which an app with more than one language version passes from its translations on every use; the full list of such props is in [Consuming → Texts and locale](?path=/docs/getting-started-consuming--docs#texts-and-locale).
|
|
353
|
+
|
|
354
|
+
- **Single without search** — the rows are a `listbox` named by `label`, `Vše` first, each row an
|
|
355
|
+
`option` with `aria-selected`; DOM focus moves onto the applied row (else `Vše`) and arrows, Home and
|
|
356
|
+
End move it roving-tabindex style; Enter or Space commits and closes. The applied row carries the
|
|
357
|
+
Selected fill and a trailing check after the count.
|
|
358
|
+
- **Single with search** — the search row at the top of the sheet is the combobox: focus moves into
|
|
359
|
+
it, it owns `role="combobox"`, `aria-controls`, `aria-activedescendant` and the same keys as
|
|
360
|
+
`Combobox`'s sheet; it is labelled by the sheet title.
|
|
361
|
+
- **Multiple** — the multi-select filter sheet. Every row is a native checkbox and focus moves onto
|
|
362
|
+
the first enabled checkbox, not the search row; the search input is named by `search.label`.
|
|
363
|
+
- *Title and names.* The sheet title is the facet `label` followed by ` (N)` while N ≥ 1 boxes are
|
|
364
|
+
ticked — `Dodavatel (2)`, bare `Dodavatel` at zero. The `(N)` sits in an `aria-hidden` span, so
|
|
365
|
+
the dialog's accessible name stays the bare label.
|
|
366
|
+
- *Group.* The rows are a `role="group"` with `aria-labelledby` pointing at the sheet title, so it
|
|
367
|
+
is named by the same bare label. The sheet's single row group renders no label and no count of its
|
|
368
|
+
own: a divider under the header would only repeat the title.
|
|
369
|
+
- *Count on entry.* From N ≥ 1 the group also carries `aria-describedby` pointing at a `hidden`
|
|
370
|
+
`<span id>` holding `selectedCountLabel(N)`, so a screen reader hears the count with the bare
|
|
371
|
+
group name when the sheet opens — `Dodavatel`, described as „Vybráno 2“. At N = 0 neither the span
|
|
372
|
+
nor `aria-describedby` is rendered.
|
|
373
|
+
- *Live region.* A visually hidden `role="status" aria-live="polite"` node
|
|
374
|
+
(`data-fods-part="live-count"`) speaks the total as `selectedCountLabel(N)` — „Vybráno 3“ in the
|
|
375
|
+
stories. It waits `curves.duration.slow` after the last tick, so each settled change is spoken
|
|
376
|
+
once: ticks that land closer together than that delay are spoken only as their final total. It
|
|
377
|
+
is silent on open, since the count the sheet opened with is already the group's description, and
|
|
378
|
+
silent at N = 0, where the unticked checkbox has already announced itself. Each checkbox
|
|
379
|
+
announces its own state; the region carries only the total.
|
|
380
|
+
- *Footer.* The sheet always renders a fixed footer (`data-fods-part="footer-action"`) holding a
|
|
381
|
+
full-width Primary `Button` `lg` labelled by `doneLabel` (default „Hotovo“). It is the sheet's one
|
|
382
|
+
closing action and only closes — every tick is already applied. Esc, the scrim, a drag down and
|
|
383
|
+
„Zavřít“ close it as well.
|
|
384
|
+
- *Safe area.* The footer pads `--space-600` on the top and sides and `--space-600` plus the bottom
|
|
385
|
+
safe-area inset below. A sheet without a footer — the single forms — keeps `--space-800` plus the
|
|
386
|
+
bottom inset under its last row instead. Row groups are inset by the larger of `--space-400` and
|
|
387
|
+
the left / right safe-area inset.
|
|
388
|
+
|
|
389
|
+
### a11y floor
|
|
390
|
+
|
|
391
|
+
The rows of the FODS a11y floor (`spec/01-foundations/accessibility.md`) that apply, per form.
|
|
392
|
+
|
|
393
|
+
<table>
|
|
394
|
+
<thead>
|
|
395
|
+
<tr><th>Floor row</th><th>Single</th><th>Multiple</th></tr>
|
|
396
|
+
</thead>
|
|
397
|
+
<tbody>
|
|
398
|
+
<tr><td>A role without visible text has a name enforced in TypeScript</td><td>✓ <code>listbox</code> gets <code>aria-label</code> from the required <code>label</code></td><td>✓ <code>group</code> gets <code>aria-labelledby</code> to the title rendered from the required <code>label</code></td></tr>
|
|
399
|
+
<tr><td>Checkbox / selection</td><td>✓ <code>aria-selected</code> on every <code>option</code> inside the listbox</td><td>✓ native <code><input type="checkbox"></code> + a native <code><label htmlFor></code></td></tr>
|
|
400
|
+
<tr><td><code>aria-expanded</code> explicit <code>"false"</code> when closed</td><td>✓ written by <code>FilterChip</code> from <code>open</code></td><td>✓ the same</td></tr>
|
|
401
|
+
<tr><td>Counter / status text</td><td>— no checked count; per-row counts are row content</td><td>✓ the count text has an <code>id</code> and is in the group's name via <code>aria-labelledby</code> — the first of the two options § Multi-select filter allows. On the mobile bottom sheet the group keeps the bare name; the count text has its own <code>id</code> and is the group's description via <code>aria-describedby</code> (N ≥ 1 only), and a polite <code>role="status"</code> region (<code>data-fods-part="live-count"</code>) speaks each settled change of the total</td></tr>
|
|
402
|
+
<tr><td>Disabled</td><td>✓ a disabled row is <code>aria-disabled</code>, <code>--disabled-foreground</code>, skipped by navigation</td><td>✓ a genuinely <code>disabled</code> input, out of the tab order, <code>--disabled-foreground</code> on the row</td></tr>
|
|
403
|
+
<tr><td>Disabled composite</td><td colSpan="2">✓ <code>disabled</code> reaches the chip's trigger and × as the native attribute plus <code>aria-disabled</code>, so the panel cannot be opened and the value cannot be cleared</td></tr>
|
|
404
|
+
<tr><td>Icon-only control / decorative icons</td><td colSpan="2">✓ the × is named by the required <code>clearLabel</code>; every glyph (caret, leading, checkmark, search) goes through <code>Icon</code> with <code>aria-hidden</code></td></tr>
|
|
405
|
+
<tr><td>Focus is visible</td><td>✓ the chip's offset ring — focus never leaves it without search; with search the input's own focus treatment while open, the chip's ring again after close</td><td>✓ the checkbox's own <code>:focus-visible</code> ring and the search field's; never on the row</td></tr>
|
|
406
|
+
<tr><td><code>aria-live</code> on a list</td><td>— no live region; the empty-search text is a plain paragraph</td><td>— no live region on the anchored panel; the empty-search text is a plain paragraph. The mobile bottom sheet adds one <code>role="status"</code> region for the checked total, outside the row group</td></tr>
|
|
407
|
+
</tbody>
|
|
408
|
+
</table>
|
|
409
|
+
|
|
410
|
+
The search field has no visible label by spec; it is named by `aria-label` from the required
|
|
411
|
+
`search.label`.
|
|
412
|
+
|
|
413
|
+
Accessibility floor for every FODS component: `spec/01-foundations/accessibility.md`.
|
|
414
|
+
|
|
415
|
+
## Mobile bottom sheet
|
|
416
|
+
|
|
417
|
+
<Canvas of={FilterFacetStories.MobileSheet} />
|
|
418
|
+
|
|
419
|
+
At a 390 viewport each list facet opens the bottom sheet described under Accessibility → Mobile bottom
|
|
420
|
+
sheet: a single facet (Stav), a searchable single facet (Odběratel) and a multiple facet
|
|
421
|
+
(Dodavatel) with three suppliers ticked, so its sheet opens titled `Dodavatel (3)` above the
|
|
422
|
+
„Hotovo“ footer. The story's `play` opens the Dodavatel sheet, checks that the dialog is named by
|
|
423
|
+
the bare `Dodavatel` and closes it with „Hotovo“. The docs column is wider than `sm`; open the story
|
|
424
|
+
in the canvas to see the sheet.
|
|
425
|
+
|
|
426
|
+
## Usage
|
|
427
|
+
|
|
428
|
+
<Canvas of={FilterFacetStories.FilterBar} />
|
|
429
|
+
|
|
430
|
+
Within one facet the values OR together; across facets they AND. The bar above has both: Kraj and
|
|
431
|
+
Stav are single facets, Dodavatel is `multiple`. Per-row counts are the consumer's job, computed
|
|
432
|
+
against the other facets only.
|
|
433
|
+
|
|
434
|
+
The bar-level reset that clears every facet at once is a **Tertiary Button beside the chips**, not a
|
|
435
|
+
facet affordance. It is also the only way to clear a facet that has gone Disabled while applied.
|
|
436
|
+
|
|
437
|
+
```tsx
|
|
438
|
+
import { FilterFacet, TooltipProvider } from '@invoiceonline/ui-react';
|
|
439
|
+
|
|
440
|
+
// Good — single: commit and close, Vše first
|
|
441
|
+
<FilterFacet
|
|
442
|
+
size="sm"
|
|
443
|
+
label="Stav"
|
|
444
|
+
leadingIcon="funnel-simple"
|
|
445
|
+
options={statuses} // ordered paid → overdue, not by count
|
|
446
|
+
value={filters.status}
|
|
447
|
+
onValueChange={status => setFilters(prev => ({ ...prev, status }))}
|
|
448
|
+
allLabel={t('filters.all')}
|
|
449
|
+
clearLabel={t('filters.clear', { facet: 'Stav' })}
|
|
450
|
+
/>
|
|
451
|
+
|
|
452
|
+
// Good — multiple: live array, chip collapses to "Čistota Plus +2"
|
|
453
|
+
<TooltipProvider>
|
|
454
|
+
<FilterFacet
|
|
455
|
+
multiple
|
|
456
|
+
size="sm"
|
|
457
|
+
label="Dodavatel"
|
|
458
|
+
leadingIcon="buildings"
|
|
459
|
+
options={suppliers} // counts computed against the OTHER facets
|
|
460
|
+
value={filters.suppliers} // string[], pick order
|
|
461
|
+
onValueChange={suppliers => setFilters(prev => ({ ...prev, suppliers }))}
|
|
462
|
+
clearLabel={t('filters.clear', { facet: 'Dodavatel' })}
|
|
463
|
+
selectedCountLabel={count => t('filters.selectedCount', { count })}
|
|
464
|
+
doneLabel={t('filters.done')} // the mobile sheet's closing button
|
|
465
|
+
search={{
|
|
466
|
+
label: t('filters.searchSupplier'),
|
|
467
|
+
placeholder: t('filters.searchPlaceholder'),
|
|
468
|
+
emptyLabel: t('filters.noSupplier'),
|
|
469
|
+
}}
|
|
470
|
+
/>
|
|
471
|
+
</TooltipProvider>
|
|
472
|
+
```
|
|
473
|
+
|
|
474
|
+
```tsx
|
|
475
|
+
// Don't — allLabel on a multiple facet; there is no reset row (type error)
|
|
476
|
+
<FilterFacet multiple allLabel="Vše" ... />
|
|
477
|
+
|
|
478
|
+
// Don't — count an option against this facet's own ticks; siblings zero out
|
|
479
|
+
options={suppliers.map(s => ({ ...s, count: countWith({ ...filters, suppliers: [s.value] }) }))}
|
|
480
|
+
|
|
481
|
+
// Don't — hardcode the strings; this organism ships on nine markets
|
|
482
|
+
<FilterFacet multiple selectedCountLabel={n => `Vybráno ${n}`} ... />
|
|
483
|
+
```
|
|
484
|
+
|
|
485
|
+
## Related
|
|
486
|
+
|
|
487
|
+
- [`FilterChip`](?path=/docs/design-system-atoms-filterchip--docs) — the trigger on its own; use it
|
|
488
|
+
directly for a Toggle flag, which opens nothing. Its `popup` prop is what this organism sets to
|
|
489
|
+
`dialog` under `multiple`
|
|
490
|
+
- [`Checkbox`](?path=/docs/design-system-atoms-checkbox--docs) — the native input in every
|
|
491
|
+
`multiple` row, at Small 16
|
|
492
|
+
- [`Select`](?path=/docs/design-system-organisms-select--docs) — the same substrate under a field
|
|
493
|
+
trigger; its panel matches the field width and its rows follow the trigger density
|
|
494
|
+
- [`Menu`](?path=/docs/design-system-organisms-menu--docs) — for commands (verbs), not values
|
|
495
|
+
- [`Chip`](?path=/docs/design-system-atoms-chip--docs) — the 22/30 tag tier, whose selection lives in
|
|
496
|
+
a checkbox and whose pill never recolours
|
|
497
|
+
|
|
498
|
+
## Migration notes
|
|
499
|
+
|
|
500
|
+
New composition — no product screen renders it yet.
|
|
501
|
+
|
|
502
|
+
**`filter-chip` 1.6.0 / 1.7.0 (2026-10-05).** 1.6.0 rewrote the spec's Facet trigger to
|
|
503
|
+
`role="combobox"` + `aria-haspopup="listbox"` + `aria-expanded` — what this build already shipped
|
|
504
|
+
(team decision after designer QA, 2026-09-29), so the deviation this page used to record is closed
|
|
505
|
+
and the single form did not change. 1.7.0 decided how a facet that opens a `group` announces itself:
|
|
506
|
+
a plain `<button aria-haspopup="dialog" aria-expanded>`, no `aria-activedescendant`, focus moves into
|
|
507
|
+
the panel. That unblocked `multiple`, which this page previously listed as deliberately not built.
|
|
508
|
+
For a single-form caller nothing changes; `multiple` is additive.
|
|
509
|
+
|
|
510
|
+
**`filter-chip` 1.8.0 / 1.9.0 (2026-10-08).** A single-value facet **with search** follows the
|
|
511
|
+
Combobox (search) pattern: focus moves into the search input, which takes `role="combobox"` and the
|
|
512
|
+
`aria-activedescendant` wiring, and the chip trigger becomes a plain listbox button; Enter / Esc / a
|
|
513
|
+
click on a row return focus to the trigger. After the × clears, focus lands on the same chip's
|
|
514
|
+
trigger. Without search nothing changes. The × focus ring is now structured in the manifest as
|
|
515
|
+
`chrome.clear.focus.ring = --outline-focus-inverse`; the chip already bound it.
|
|
516
|
+
|
|
517
|
+
**`list-row` 2.7.0 (2026-10-20, owner ruling).** The single facet's chosen row takes the
|
|
518
|
+
`ListRow` Selected fill (`--bg-secondary`) again, next to its checkmark — the design-QA build
|
|
519
|
+
(2026-10-12) had dropped the fill. The checkmark is `--secondary` (blue) at every size: leading on
|
|
520
|
+
the anchored panel (was `--text-secondary`), trailing on the bottom sheet (was `--text-primary`).
|
|
521
|
+
|
|
522
|
+
**`filter-chip` 1.11.2 → 1.14.1.** 1.11.2 takes Období out of the facets — it is a Select Field — so
|
|
523
|
+
the stories show Kraj instead. 1.14.0 adds the optional `sheetCloseLabel`, the name of the bottom
|
|
524
|
+
sheet's hidden close button. 1.12.0, 1.13.0, 1.13.1 and 1.14.1 change nothing here: the icon rule is
|
|
525
|
+
docs-only, the status and the caret motion are the chip's own, and 1.14.1 only renames copy examples.
|
|
526
|
+
|
|
527
|
+
### Known limitations
|
|
528
|
+
|
|
529
|
+
- **The facet title does not become sticky on scroll.** § Multi-select filter moves the title of a
|
|
530
|
+
facet whose rows pass the cap into a sticky header frame; here the title stays a label-only divider
|
|
531
|
+
inside the scroll body, so it scrolls away with the rows.
|
|
532
|
+
- **The keyboard-current row wash is CSS.** Under `multiple` the row is washed through
|
|
533
|
+
`:has(:focus-visible)` on the checkbox it holds, not by the substrate's highlight state.
|
|
534
|
+
- **A numeric range facet is not built.** `filter-chip.manifest.json` `intent.rules[7]` puts a Field
|
|
535
|
+
Pair in the panel with the unit stated once and the applied bounds pre-filled on re-open. It has no
|
|
536
|
+
section in `popover-patterns.md` yet.
|