@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,525 @@
|
|
|
1
|
+
import { Meta, Canvas, Controls } from '@storybook/addon-docs/blocks';
|
|
2
|
+
import * as ComboboxFieldStories from './ComboboxField.stories';
|
|
3
|
+
|
|
4
|
+
<Meta of={ComboboxFieldStories} tags={['autodocs']} />
|
|
5
|
+
|
|
6
|
+
# ComboboxField
|
|
7
|
+
|
|
8
|
+
## Metadata
|
|
9
|
+
|
|
10
|
+
- **Layer:** molecule
|
|
11
|
+
- **Status:** `draft` (naše implementace) · upstream spec je `stable`
|
|
12
|
+
- **Tokens used:** `--bg-primary`, `--bg-readonly`, `--border-width-100`, `--border-width-200`, `--disabled-background`, `--disabled-foreground`, `--font-body`, `--font-size-base`, `--font-size-heading-h5`, `--font-size-sm`, `--font-size-xs`, `--font-size-xxs`, `--font-weight-bold`, `--font-weight-normal`, `--icon-muted`, `--leading-loose`, `--leading-relaxed`, `--outline-default`, `--outline-focus`, `--outline-strong`, `--radius-200`, `--radius-400`, `--size-icon`, `--size-icon-small`, `--space-1000`, `--space-1100`, `--space-200`, `--space-300`, `--space-400`, `--space-500`, `--space-700`, `--space-800`, `--status-danger`, `--status-success-solid`, `--status-success-tint-foreground`, `--text-placeholder`, `--text-primary`, `--text-secondary`, `--text-wrap-body`
|
|
13
|
+
- **Manifest version:** `1.13.1`
|
|
14
|
+
|
|
15
|
+
## Overview
|
|
16
|
+
|
|
17
|
+
Use a **ComboboxField** as the trigger for choosing **one value from a set too large to scan** — the user
|
|
18
|
+
*types to narrow*, they don't scroll. It is the **generic** trigger: picking commits one plain
|
|
19
|
+
value into the field. Manifest 1.6.3 (2026-09-02) handed the **ARES subject lookup** — a search that queries saved contacts *and* the registry at once and
|
|
20
|
+
autofills a whole identity block — to its own molecule, **Subject Lookup Field** (built as
|
|
21
|
+
`SubjectLookupField`, see its own docs page). The stories below still use those Czech
|
|
22
|
+
labels because they are the familiar shape, not because this component owns those surfaces.
|
|
23
|
+
|
|
24
|
+
**This component is the trigger only** — a native `<input role="combobox">` inside the Text Field shell.
|
|
25
|
+
The result list is **not** part of it: that overlay is composed separately from a Popover surface +
|
|
26
|
+
`ListRow` `option` rows. The relationship is exactly the one **SelectField** has to its option panel.
|
|
27
|
+
|
|
28
|
+
Do **not** use it for a fixed set small enough to scan (→ **SelectField**), for short free-form text
|
|
29
|
+
(→ **TextField**), for dates (→ **DatePicker**), or for several values at once (→ a multi-select filter
|
|
30
|
+
Popover). The signal is *"you have to type to find it"* — a Select that grows a search box is the wrong
|
|
31
|
+
family.
|
|
32
|
+
|
|
33
|
+
<Canvas of={ComboboxFieldStories.Playground} />
|
|
34
|
+
|
|
35
|
+
## Rationale
|
|
36
|
+
|
|
37
|
+
ComboboxField turns type-to-narrow into one token-bound trigger:
|
|
38
|
+
|
|
39
|
+
1. **One shell for every field.** The trigger reuses the Text Field shell (`textFieldShellVariants` /
|
|
40
|
+
`textFieldValueVariants`) — same border, fill, radius, padding and floating-label behaviour as every
|
|
41
|
+
other field. Fix the shell once, it lands here too. There is no second field skin.
|
|
42
|
+
2. **State is a life-cycle, not a skin.** A search is a *flow*: you focus, type, wait, read results, pick.
|
|
43
|
+
The `state` axis models exactly that sequence, so a builder wires **transitions**, not six unrelated looks.
|
|
44
|
+
3. **The trailing slot carries the machine.** One glyph position tells you where you are — caret (closed /
|
|
45
|
+
open), spinner (loading), clear × (something is chosen).
|
|
46
|
+
4. **Trigger ≠ overlay.** The field owns the input, the `combobox` role and the affordances; the result
|
|
47
|
+
list is a separate surface. Keeping them apart is what lets one trigger open either the Search or the
|
|
48
|
+
Inline overlay.
|
|
49
|
+
|
|
50
|
+
## Anatomy
|
|
51
|
+
|
|
52
|
+
- **Shell** — the reused Text Field frame: `--bg-primary` fill, 1px `--outline-default` border
|
|
53
|
+
(`--border-width-100`) swapping to `--outline-focus`, radius `--radius-400`, horizontal padding
|
|
54
|
+
`--space-500`, gap `--space-400`. Height fixed on the 4-grid (`md` 48 / `sm` 40).
|
|
55
|
+
- **Input** — a native `<input type="text" role="combobox" aria-autocomplete="list">`. The typed query,
|
|
56
|
+
then the committed subject name, in `--text-primary`; the empty-state placeholder
|
|
57
|
+
(`Zadejte jméno, název nebo IČO…`) in `--text-placeholder`. Being editable it **scrolls** horizontally
|
|
58
|
+
(native), it never ellipsises.
|
|
59
|
+
- **Value description** (optional, `valueDescription`, Selected only) — one secondary line **inside the
|
|
60
|
+
shell** under the committed value: `Body/S` Regular, `--text-secondary`, single line with ellipsis. It
|
|
61
|
+
carries the picked entity's second fact (an IBAN under a bank-account name) or says in two words that
|
|
62
|
+
it is missing (`IBAN nevyplněn`). With it the fixed height becomes the **minimum** — the shell hugs both
|
|
63
|
+
lines with `--space-500` above and below and the clear × stays vertically centred. It is part of the
|
|
64
|
+
value, not the helper (the helper stays outside the shell).
|
|
65
|
+
- **Floating label** — NOT owned by ComboboxField; wrap it in **Field** (`label="Odběratel"`) for the
|
|
66
|
+
floating `<label>`, helper text and messaging.
|
|
67
|
+
- **Leading slot** (optional) — the search magnifier, `leadingIcon="magnifying-glass"`, bound to `--icon-muted`.
|
|
68
|
+
Available on the shell but **off by default** — the shipped trigger leads with the label and shows only
|
|
69
|
+
the trailing indicator.
|
|
70
|
+
- **Trailing slot** — the **state-driven indicator**, the only moving part: `caret-down-small`, turned
|
|
71
|
+
180° while open → `spinner` (Loading) → clear `×` (Selected). The caret is `--icon-muted`;
|
|
72
|
+
the spinner and the clear × are `--text-secondary`.
|
|
73
|
+
- **The result overlay is NOT here** — it is composed from `popoverSurfaceVariants` + `ListRow` `option`
|
|
74
|
+
rows plus a sticky manual-entry row (`Zadám vše o subjektu ručně`). Below `sm` it is a bottom sheet
|
|
75
|
+
instead — see [Composed with a panel](#composed-with-a-panel).
|
|
76
|
+
|
|
77
|
+
## Variants
|
|
78
|
+
|
|
79
|
+
<Canvas of={ComboboxFieldStories.Matrix} />
|
|
80
|
+
|
|
81
|
+
Two axes and nothing else: **`state`** (the flow — see [States](#states)) × **`size`** (density).
|
|
82
|
+
12 combinations, mirroring the Figma labelled grid.
|
|
83
|
+
|
|
84
|
+
<table>
|
|
85
|
+
<thead>
|
|
86
|
+
<tr><th>Axis</th><th>Values</th><th>When / tokens</th></tr>
|
|
87
|
+
</thead>
|
|
88
|
+
<tbody>
|
|
89
|
+
<tr><td><code>state</code></td><td><code>default</code> · <code>focused</code> · <code>typing</code> · <code>loading</code> · <code>open</code> · <code>selected</code></td><td>The <strong>flow</strong> of one search. Only the border (<code>--outline-default</code> ↔ <code>--outline-focus</code>), the value ink (<code>--text-placeholder</code> → <code>--text-primary</code>) and the trailing indicator move.</td></tr>
|
|
90
|
+
<tr><td><code>size</code></td><td><code>md</code> (default) · <code>sm</code></td><td>Density / measurement axis — see <a href="#sizes">Sizes</a>.</td></tr>
|
|
91
|
+
<tr><td><code>leadingIcon</code></td><td><code>magnifying-glass</code> · unset (default)</td><td>Optional leading magnifier, <code>--icon-muted</code>. Not a variant of the design set — a per-instance shell capability.</td></tr>
|
|
92
|
+
</tbody>
|
|
93
|
+
</table>
|
|
94
|
+
|
|
95
|
+
There is deliberately **no** `error` / `success` / `disabled` / `readonly` axis on the trigger. Registry
|
|
96
|
+
validation (invalid IČO, verifying, verified, error/retry) happens on the **manual-entry TextFields** that
|
|
97
|
+
the overlay's *"Zadám vše o subjektu ručně"* escape hatch opens — those are plain TextFields carrying
|
|
98
|
+
the standard status states.
|
|
99
|
+
|
|
100
|
+
## Sizes
|
|
101
|
+
|
|
102
|
+
<Canvas of={ComboboxFieldStories.Sizes} />
|
|
103
|
+
|
|
104
|
+
<table>
|
|
105
|
+
<thead>
|
|
106
|
+
<tr><th>Size</th><th style={{ textAlign: 'right' }}>Height</th><th>Padding (X)</th><th>Gap</th><th style={{ textAlign: 'right' }}>Icons (all slots)</th><th>Radius</th><th>Opens rows</th></tr>
|
|
107
|
+
</thead>
|
|
108
|
+
<tbody>
|
|
109
|
+
<tr><td><code>md</code> (default)</td><td style={{ textAlign: 'right' }}>48</td><td><code>--space-500</code></td><td><code>--space-400</code></td><td style={{ textAlign: 'right' }}>24 <code>--size-icon</code></td><td><code>--radius-400</code></td><td><code>md</code> ListRows (40)</td></tr>
|
|
110
|
+
<tr><td><code>sm</code></td><td style={{ textAlign: 'right' }}>40</td><td><code>--space-500</code></td><td><code>--space-400</code></td><td style={{ textAlign: 'right' }}>20 <code>--size-icon-small</code></td><td><code>--radius-400</code></td><td><code>sm</code> ListRows (36)</td></tr>
|
|
111
|
+
</tbody>
|
|
112
|
+
</table>
|
|
113
|
+
|
|
114
|
+
Heights are **fixed** on the 4-grid (inherited from TextField). **`md` (48)** is the default on standard
|
|
115
|
+
invoice forms; **`sm` (40)** is for dense filter bars and inline rows. Pick by density — the opened
|
|
116
|
+
overlay renders its result rows **one step below** the trigger (48 → 40, 40 → 36). Width is layout: the
|
|
117
|
+
field fills its column.
|
|
118
|
+
|
|
119
|
+
**Type does not step with the size.** The value and the placeholder are `Body/M` in **both** sizes —
|
|
120
|
+
the shell is a nested Text Field *instance*, and only the box shrinks. The manifest used to carry a
|
|
121
|
+
`sizes[1].textStyle: "Body/S"` at Small, which was Text Field's own Small-size style leaking into the
|
|
122
|
+
shell's row; 1.7.0 (2026-09-16) removed it. Our implementation shares TextField's value recipe, so it
|
|
123
|
+
never had the per-size step.
|
|
124
|
+
|
|
125
|
+
**The one exception to the fixed height is a Selected field with a value description** (1.8.0). The
|
|
126
|
+
fixed height becomes the minimum (`min-h-1100` / `min-h-1000`), the shell hugs its two lines with
|
|
127
|
+
`--space-500` above and below, and the clear × stays vertically centred. Only the description line is
|
|
128
|
+
`Body/S`; the value keeps `Body/M`.
|
|
129
|
+
|
|
130
|
+
<Canvas of={ComboboxFieldStories.WithValueDescription} />
|
|
131
|
+
|
|
132
|
+
> **Icon tier.** Every glyph in the shell (leading magnifier, caret, spinner, clear ×) uses the
|
|
133
|
+
> **TextField icon tier: `md` 24 / `sm` 20**. This used to be a documented departure — the manifest
|
|
134
|
+
> carried a flat 16 while the code rendered 24/20 — and `combobox-field` 1.6.2 (2026-09-02) resolved it
|
|
135
|
+
> in the code's favour: `sizes[].icon` is now 24 / 20 upstream too, for the reason this note always
|
|
136
|
+
> gave, that the number is the **slot box** the icon takes as its width and height (`<Icon size>`), not the drawn mark.
|
|
137
|
+
> The manifest 1.3.0 change (2026-07-15) was about the **glyph**, `caret-down` → `caret-down-small`,
|
|
138
|
+
> which is exactly what the `caret-down-small` below renders (turned 180° when open, manifest 1.12.0).
|
|
139
|
+
|
|
140
|
+
## States
|
|
141
|
+
|
|
142
|
+
<Canvas of={ComboboxFieldStories.States} />
|
|
143
|
+
|
|
144
|
+
> **`state` is a FLOW axis, not a matrix of independent skins.** One search moves through the sequence
|
|
145
|
+
> below and the **transitions** are the contract a consumer wires. The shell is otherwise constant.
|
|
146
|
+
|
|
147
|
+
1. **`default`** — resting, list closed. Border `--outline-default`; the placeholder
|
|
148
|
+
(`Zadejte jméno, název nebo IČO…`) in `--text-placeholder`; trailing `caret-down-small`
|
|
149
|
+
(`--icon-muted`). → focusing the field moves to **`focused`**.
|
|
150
|
+
2. **`focused`** *(empty)* — the field has focus, nothing typed. Border swaps to `--outline-focus`
|
|
151
|
+
(**no ring**, border-swap only — TextField parity); interior empty; caret still down. On a real
|
|
152
|
+
Combobox, focusing may already open the panel showing just the manual-entry action.
|
|
153
|
+
→ the first keystroke moves to **`typing`**.
|
|
154
|
+
3. **`typing`** — a partial query (`Nov`). Value ink `--text-primary`; border `--outline-focus`; trailing
|
|
155
|
+
caret turns up (`caret-down-small` rotated 180°) — the list is open and filtering live. `aria-expanded="true"`.
|
|
156
|
+
→ a fetch moves to **`loading`**, a synchronous filter straight to **`open`**.
|
|
157
|
+
4. **`loading`** — results are being fetched (the ARES round-trip). The trailing becomes a spinning
|
|
158
|
+
`spinner` (`--text-secondary`) and the input gets `aria-busy="true"`; the panel is still open, so
|
|
159
|
+
`aria-expanded` stays true. The overlay announces *"Vyhledávám…"* through its `aria-live` region.
|
|
160
|
+
→ **`open`** once results land.
|
|
161
|
+
5. **`open`** *(results)* — matches are shown in the overlay below. Border `--outline-focus`; value
|
|
162
|
+
`--text-primary`; caret turned up. ↑/↓ move the highlight via `aria-activedescendant` while DOM
|
|
163
|
+
focus stays in the input. → Enter / a click commits to **`selected`**; Esc returns toward **`default`**.
|
|
164
|
+
6. **`selected`** — a value is committed (`Novák s.r.o.`). Border returns to `--outline-default`; value
|
|
165
|
+
`--text-primary`; the trailing becomes the **clear ×** (`--text-secondary`, a real `<button>`).
|
|
166
|
+
With a `valueDescription` a second line shows under the value (see [Anatomy](#anatomy)); it never
|
|
167
|
+
appears in any other state — the type accepts the prop only on the `selected` branch.
|
|
168
|
+
→ the clear × resets the query back to **`default`**.
|
|
169
|
+
|
|
170
|
+
<table>
|
|
171
|
+
<thead>
|
|
172
|
+
<tr><th>State</th><th>Border</th><th>Value ink</th><th>Trailing</th><th>ARIA derived</th></tr>
|
|
173
|
+
</thead>
|
|
174
|
+
<tbody>
|
|
175
|
+
<tr><td><code>default</code></td><td><code>--outline-default</code></td><td><code>--text-placeholder</code></td><td><code>caret-down-small</code> · <code>--icon-muted</code></td><td><code>aria-expanded="false"</code></td></tr>
|
|
176
|
+
<tr><td><code>focused</code></td><td><code>--outline-focus</code></td><td><code>--text-placeholder</code></td><td><code>caret-down-small</code> · <code>--icon-muted</code></td><td><code>aria-expanded="false"</code></td></tr>
|
|
177
|
+
<tr><td><code>typing</code></td><td><code>--outline-focus</code></td><td><code>--text-primary</code></td><td><code>caret-down-small</code> turned 180° · <code>--icon-muted</code></td><td><code>aria-expanded="true"</code></td></tr>
|
|
178
|
+
<tr><td><code>loading</code></td><td><code>--outline-focus</code></td><td><code>--text-primary</code></td><td><code>spinner</code> · <code>--text-secondary</code></td><td><code>aria-expanded="true"</code>, <code>aria-busy="true"</code></td></tr>
|
|
179
|
+
<tr><td><code>open</code></td><td><code>--outline-focus</code></td><td><code>--text-primary</code></td><td><code>caret-down-small</code> turned 180° · <code>--icon-muted</code></td><td><code>aria-expanded="true"</code></td></tr>
|
|
180
|
+
<tr><td><code>selected</code></td><td><code>--outline-default</code></td><td><code>--text-primary</code></td><td>clear <code>×</code> (<code>x-small</code>) · <code>--text-secondary</code></td><td><code>aria-expanded="false"</code></td></tr>
|
|
181
|
+
</tbody>
|
|
182
|
+
</table>
|
|
183
|
+
|
|
184
|
+
Because `state` is an explicit prop (not a CSS pseudo-state), every step above is rendered **statically**
|
|
185
|
+
with the data that step of the search would really hold — that is why the States canvas reads as a flow.
|
|
186
|
+
|
|
187
|
+
**The trailing slot is state-driven, not a user slot.** There is no `trailingIcon` prop: the state machine
|
|
188
|
+
owns that position. The clear × always renders on `state="selected"` — and the type system makes sure it
|
|
189
|
+
works, because that state *requires* `onClear` + `clearLabel` (see [API](#api)).
|
|
190
|
+
|
|
191
|
+
### Motion
|
|
192
|
+
|
|
193
|
+
<Canvas of={ComboboxFieldStories.Motion} />
|
|
194
|
+
|
|
195
|
+
Manifest 1.12.0 `motion` — two things move. **The caret** (`states.open`): entering `typing` / `open`
|
|
196
|
+
turns the one `caret-down-small` glyph 180° (down → up) on `--spring-standard` (`springs.standard` from
|
|
197
|
+
the package tokens, in Motion), and leaving them turns it back — the field no longer swaps it for
|
|
198
|
+
`caret-up-small`. A quick re-toggle turns it around mid-turn (`interrupt`); the first paint and the server
|
|
199
|
+
render show the current pose without a turn. **The spinner** (`loop`): in `loading` it takes the caret slot
|
|
200
|
+
and turns once per `--duration-spin` on `--easing-linear`, forever (`animate-spin`). Under
|
|
201
|
+
`prefers-reduced-motion: reduce` the `MotionConfig` in `FodsProvider` drops the caret's transform animation, so it
|
|
202
|
+
shows its end pose at once; the spinner keeps turning — a loader is essential motion. The border swap and
|
|
203
|
+
floating label are the Text Field shell's (`inherits: [text-field]`).
|
|
204
|
+
|
|
205
|
+
> **Icon names.** The code uses the spec's names: `caret-down-small` (one glyph, turned 180° when open) /
|
|
206
|
+
> `magnifying-glass` / `x`. The clear × itself is `x-small` (manifest 1.10.0).
|
|
207
|
+
|
|
208
|
+
> **Placeholder ink — settled, not a drift.** `--text-placeholder` (claudy/400, 2.71:1) **is** canon:
|
|
209
|
+
> the token was minted 2026-07-08 for exactly this role, replacing the interim `--text-secondary`
|
|
210
|
+
> binding the `--text-tertiary` kill left behind, and its sub-AA ratio is an accepted exception for
|
|
211
|
+
> placeholder text. The manifest binds `--text-placeholder` in `families[].states`. This page used to call that a drift and
|
|
212
|
+
> ask for a retarget; manifest 1.7.0 (2026-09-16) corrected the stale prose in `text.placeholder.note`
|
|
213
|
+
> and `notes[4]` — nothing to file, nothing to fix. Our implementation is TextField parity
|
|
214
|
+
> (`placeholder:text-text-placeholder`) and always was.
|
|
215
|
+
|
|
216
|
+
## API
|
|
217
|
+
|
|
218
|
+
<Controls />
|
|
219
|
+
|
|
220
|
+
Beyond the props above, every native `<input>` attribute passes through (`value`, `onChange`, `onKeyDown`,
|
|
221
|
+
`placeholder`, `id`, `aria-controls`, `aria-activedescendant`, …). Two things are **derived** but
|
|
222
|
+
overridable / never derived:
|
|
223
|
+
|
|
224
|
+
- `aria-expanded` is derived from `state` (`typing` / `loading` / `open` → `true`). An explicitly passed
|
|
225
|
+
`aria-expanded` always wins — the organism owning the popup knows better.
|
|
226
|
+
- `valueDescription` (optional) is accepted **only** on the `state="selected"` branch of the union —
|
|
227
|
+
every other branch types it as `undefined`, because the description never appears outside Selected.
|
|
228
|
+
The input references it via `aria-describedby`, merged with any `aria-describedby` you pass.
|
|
229
|
+
- `aria-controls` and `aria-activedescendant` are **never** derived: they reference ids this field does not
|
|
230
|
+
own, so they only pass through. The owning organism must supply them.
|
|
231
|
+
- `autoComplete` defaults to `"off"` — the browser autofill panel would cover the result listbox and fight
|
|
232
|
+
it for keystrokes (ARIA APG). Overridable if a consumer really wants native autofill.
|
|
233
|
+
|
|
234
|
+
> **TS gotcha — the clear-× union.** `state`, `onClear` and `clearLabel` are **one discriminated union**:
|
|
235
|
+
> `state="selected"` requires both handlers, every other state forbids them. That makes the spec's rule
|
|
236
|
+
> ("Selected always carries the clear ×", overlay decision S6) a compile-time guarantee and forces an
|
|
237
|
+
> accessible name onto the icon-only button (WCAG 4.1.2). A conditional spread —
|
|
238
|
+
> `{...(isSelected ? { onClear, clearLabel } : {})}` — widens the union away and no longer type-checks.
|
|
239
|
+
> **Branch the render instead** (see Usage).
|
|
240
|
+
|
|
241
|
+
## Do / Don't
|
|
242
|
+
|
|
243
|
+
- ✅ Reach for it when the set is **too large to scan** and the user should **type to narrow** (contacts, ARES).
|
|
244
|
+
- ✅ Keep **focus in the input** for the whole search; move the highlight with `aria-activedescendant`.
|
|
245
|
+
- ✅ Let the **flow state** drive the trigger and own the trailing indicator.
|
|
246
|
+
- ✅ Wrap in **Field** for the floating `<label>` — it is the accessible name (or pass `aria-label`).
|
|
247
|
+
- ✅ Pass `aria-controls` / `aria-activedescendant` from the organism that owns the popup id.
|
|
248
|
+
- ✅ Render the overlay's result rows **one density step below** the trigger (48 → 40, 40 → 36).
|
|
249
|
+
- ✅ Pair `onClear` with a real `clearLabel` (`"Zrušit výběr"`) and branch the render, don't spread.
|
|
250
|
+
- ✅ Use `valueDescription` when the picked entity is known by two facts and the panel lists it as an
|
|
251
|
+
Action Row with a description — the field then shows the same two lines as the row the user picked.
|
|
252
|
+
- ❌ Don't put a rule, a hint or an error into `valueDescription` — that is the helper; never a third line.
|
|
253
|
+
- ❌ Don't use it for a short fixed set — that's a **SelectField**; don't bolt a search box onto a Select.
|
|
254
|
+
- ❌ Don't move DOM focus onto a result row — that turns a Combobox into a **Menu**.
|
|
255
|
+
- ❌ Don't treat the trailing slot as a free icon slot; the state owns it.
|
|
256
|
+
- ❌ Don't put registry validation on the trigger — invalid-IČO / verifying / error belong on the
|
|
257
|
+
manual-entry TextFields the escape hatch opens.
|
|
258
|
+
- ❌ Don't add a focus ring or a second, darker "open" border.
|
|
259
|
+
- ❌ Don't tint the surface — the field is always `--bg-primary`.
|
|
260
|
+
- ❌ Don't rebuild the ARES "nápověda" chrome here — that is the separate **Subject Lookup** pattern.
|
|
261
|
+
|
|
262
|
+
## Accessibility
|
|
263
|
+
|
|
264
|
+
- **Semantics** — a native `<input role="combobox" aria-autocomplete="list">` inside the shell. The input
|
|
265
|
+
owns `aria-expanded`, `aria-controls` (the popup id) and `aria-activedescendant` (the current option id).
|
|
266
|
+
The popup body is `role="listbox"` and each result row an `option` — injected by the overlay organism,
|
|
267
|
+
not by this field. The floating label from `Field` is a real `<label for>`; a label-less filter variant
|
|
268
|
+
needs an explicit `aria-label`. The placeholder is **not** an accessible name.
|
|
269
|
+
- **The panel owes its own name.** `listbox` is name-required and a panel inherits **nothing** from the
|
|
270
|
+
trigger that opened it — the label sits on the *field*, which makes the panel look named when it is
|
|
271
|
+
not. Whichever organism renders the popup must point it at the same visible label with
|
|
272
|
+
`aria-labelledby` (the mechanism `Select` already uses via `Field`); `aria-label` only when nothing
|
|
273
|
+
visible names the input. Rule:
|
|
274
|
+
`overlay-behavior.md` § Naming.
|
|
275
|
+
- **Keyboard** — typing filters live · **↑ / ↓** move the highlight (via `aria-activedescendant`) ·
|
|
276
|
+
**Enter** selects + closes · **Esc** closes and clears the query, staying in the input ·
|
|
277
|
+
**Tab** leaves the combobox and closes the panel (WAI-ARIA APG) · **Home / End** jump within the ring.
|
|
278
|
+
The overlay's *"Zadám vše o subjektu ručně"* action is the **last item of the ↑/↓ ring** — an `option`
|
|
279
|
+
**without** `aria-selected` (a non-selectable option whose name states the action); Enter runs it, it
|
|
280
|
+
never becomes the value. While `loading`, the status row replaces the results, so the ring holds only
|
|
281
|
+
that action (or nothing): the previous results stay out of reach until the new ones are shown.
|
|
282
|
+
When they are, the highlight returns to the first result, unless the user moved it onto the action
|
|
283
|
+
while results were on screen and has not typed since.
|
|
284
|
+
- **Mobile bottom sheet (below `sm`)** — the field on the page is a read-only trigger
|
|
285
|
+
(`aria-haspopup="dialog"` + `aria-expanded`). The sheet is `role="dialog"` + `aria-modal="true"`, named
|
|
286
|
+
by its title (`sheetTitle`, else the field label); the page behind is `inert`. Focus lands on the sheet's
|
|
287
|
+
**search input**, which is the `combobox` while the sheet is open (`aria-controls` → the sheet listbox,
|
|
288
|
+
`aria-activedescendant` → the highlighted row, named by the title). The manual-entry action is a `link`
|
|
289
|
+
`ListRow` with `role="button"` in the fixed footer, reached with Tab. A visually hidden «Zavřít» button, Esc, a drag down and the
|
|
290
|
+
scrim close it without a change, and focus returns to the field. For the hidden close button,
|
|
291
|
+
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). Like `sheetTitle`, it is a prop of the `Combobox` organism.
|
|
292
|
+
- **Focus** — stays in the input for the whole search; it never lands on a result row. The field shows
|
|
293
|
+
focus by the **border swap to `--outline-focus`**, no additive ring. ⚠️ Accepted tradeoff inherited from
|
|
294
|
+
TextField: a 1px swap is borderline for WCAG 2.4.11 — if visibility becomes an issue, thicken the focus
|
|
295
|
+
border, don't re-add a ring. Result rows carry no focus ring, only the soft Highlighted fill. The clear ×
|
|
296
|
+
is itself focusable and **does** show a `focus-visible` ring (it is a button, not the field).
|
|
297
|
+
- **Value description** — not part of the input's value: the `<input>` holds the first line only; the
|
|
298
|
+
description is a text node inside the shell with its own `id`, and the input points at it with
|
|
299
|
+
`aria-describedby` (merged with a consumer-supplied one), so a screen reader reads it after the value.
|
|
300
|
+
- **State & ARIA** — `loading` sets `aria-busy="true"`; a committed value = `aria-selected` on its option +
|
|
301
|
+
the clear × on the trigger; the highlighted option = `aria-activedescendant` on the input.
|
|
302
|
+
- **Screen reader** — the list's runtime states are announced live: **Loading** *"Vyhledávám…"*,
|
|
303
|
+
**Empty** *"Žádné výsledky"* — never a silently blank panel. The **Error** row the spec also lists
|
|
304
|
+
(`combobox-field.md` § Accessibility) is not built: `Combobox` has no error state to show. Put the
|
|
305
|
+
`aria-live="polite"` on the **status row**, not on the listbox itself, or opening the panel re-announces
|
|
306
|
+
every option. The clear × announces its `clearLabel`.
|
|
307
|
+
- **Target** — the whole field is the hit area; the clear × is a **≥24px** target
|
|
308
|
+
(`min-h-800 min-w-800`) inside the trailing slot.
|
|
309
|
+
- **Contrast & motion** — caret/magnifier `--icon-muted` clears the 3:1 non-text floor; value
|
|
310
|
+
`--text-primary` and spinner/clear `--text-secondary` clear AA. The placeholder sits on
|
|
311
|
+
`--text-placeholder` (2.71:1) — an **accepted** sub-AA exception for placeholder ink, not an open
|
|
312
|
+
item; see the note in [States](#states). The spinner uses `animate-spin` (one turn per
|
|
313
|
+
`--duration-spin`, kept under reduced motion); the caret turn drops to its end pose under reduced
|
|
314
|
+
motion — see [Motion](#motion). The overlay fade is `--duration-fast` (150ms).
|
|
315
|
+
|
|
316
|
+
Accessibility floor for every FODS component: `spec/01-foundations/accessibility.md`.
|
|
317
|
+
|
|
318
|
+
## Copy
|
|
319
|
+
|
|
320
|
+
Voice: the field copy rules of TextField hold here unchanged: impersonal, clear over clever,
|
|
321
|
+
concise, specific and helpful, consistent terminology. Examples are Czech; the rules apply to every
|
|
322
|
+
language version.
|
|
323
|
+
|
|
324
|
+
- **Label** — the subject role as a noun, sentence case, no colon: *Dodavatel* · *Odběratel*.
|
|
325
|
+
1–2 words. Single line, truncates, max 24 characters.
|
|
326
|
+
- **Placeholder** (`placeholder`) — the empty-state search prompt naming what can be typed:
|
|
327
|
+
*Zadejte jméno, název nebo IČO…*. It states the accepted inputs and ends with an ellipsis; it is
|
|
328
|
+
the one place the impersonal voice bends to a light instruction. Not a bare label repeat
|
|
329
|
+
(*Odběratel*), not a command dressed as help (*Vyhledejte prosím…*). Shown only in Default and
|
|
330
|
+
Focused (empty). Single line, truncates, max 40 characters.
|
|
331
|
+
- **Value** — the typed query, then the committed subject's real name (*Novák s.r.o.*). Single
|
|
332
|
+
line; the input scrolls horizontally, no ellipsis. The clear × reverts to the placeholder prompt.
|
|
333
|
+
- **Value description** (`valueDescription`, Selected only, optional) — the entity's second fact as
|
|
334
|
+
data, not a sentence: an IBAN, an account number. When the fact is missing, say so in two words:
|
|
335
|
+
*IBAN nevyplněn*. Not a helper, never a rule or an error; no terminal period. Single line,
|
|
336
|
+
truncates, max 40 characters.
|
|
337
|
+
- **Sheet title** (`sheetTitle` on `Combobox`, optional) — the title of the mobile bottom sheet.
|
|
338
|
+
Leave it empty when the label names the field in full; set it when the label is abbreviated. A
|
|
339
|
+
noun phrase, no verb, no trailing period. Never shown on desktop. Single line, truncates, max 40
|
|
340
|
+
characters.
|
|
341
|
+
- **Sheet close label** (`sheetCloseLabel` on `Combobox`, optional, default *Zavřít*) — the name of
|
|
342
|
+
the hidden close button of the mobile bottom sheet, heard by a screen reader and seen only while
|
|
343
|
+
it holds keyboard focus. A bare imperative verb, no object, no period. An app with more than one
|
|
344
|
+
language version passes it from its translations. Never shown on desktop. Single line, truncates,
|
|
345
|
+
max 20 characters.
|
|
346
|
+
- **List runtime copy** (`loadingLabel`, `emptyLabel`, `manualEntry.label` on `Combobox`) — rendered
|
|
347
|
+
on the overlay and announced through `aria-live`. Loading is present tense, one word and an
|
|
348
|
+
ellipsis; no results is a plain noun phrase, never an apology or a command; the manual-entry
|
|
349
|
+
action is first person and verb-led, because bypassing the registry is the user's own choice.
|
|
350
|
+
|
|
351
|
+
Canonical texts:
|
|
352
|
+
|
|
353
|
+
<table>
|
|
354
|
+
<thead>
|
|
355
|
+
<tr><th>Run</th><th>Text</th></tr>
|
|
356
|
+
</thead>
|
|
357
|
+
<tbody>
|
|
358
|
+
<tr><td>Placeholder</td><td>Zadejte jméno, název nebo IČO…</td></tr>
|
|
359
|
+
<tr><td>Sheet title, label «DPH»</td><td>Sazba DPH</td></tr>
|
|
360
|
+
<tr><td>Sheet title, label «M.J.»</td><td>Měrná jednotka</td></tr>
|
|
361
|
+
<tr><td>Sheet close label</td><td>Zavřít</td></tr>
|
|
362
|
+
<tr><td>Loading</td><td>Vyhledávám…</td></tr>
|
|
363
|
+
<tr><td>No results</td><td>Žádné výsledky</td></tr>
|
|
364
|
+
<tr><td>Manual entry (Search overlay)</td><td>Zadám vše o subjektu ručně</td></tr>
|
|
365
|
+
<tr><td>Manual entry (inline)</td><td>Zadám vše ručně…</td></tr>
|
|
366
|
+
</tbody>
|
|
367
|
+
</table>
|
|
368
|
+
|
|
369
|
+
## Usage
|
|
370
|
+
|
|
371
|
+
<Canvas of={ComboboxFieldStories.WithField} />
|
|
372
|
+
|
|
373
|
+
**`Field` and the floating label.** ComboboxField is not marked `autoFloating` in `Field`'s `FIELD_CHILD_TRAITS` — it
|
|
374
|
+
behaves like **TextField**: the label floats once the field is focused or filled. `Field` additionally
|
|
375
|
+
floats whenever a `placeholder` is set (`Field.tsx` → `hasPlaceholder`), and the spec's Default copy
|
|
376
|
+
always sets one, so **the resting field shows the floated label chip above the placeholder**.
|
|
377
|
+
|
|
378
|
+
> ⚠️ **Known deviation from Figma.** The Figma `State=Default` variant hides the label layer entirely and
|
|
379
|
+
> shows only the interior placeholder (the 2026-07-09 upstream fix, which removed a chip+placeholder
|
|
380
|
+
> collision). Our resting field keeps both. This is deliberate: the float rule belongs to `Field` and is
|
|
381
|
+
> shared by every field in the repo, and a labelless resting field would leave the placeholder as the
|
|
382
|
+
> only visible name. If the design side wants Figma parity, the change belongs in `Field`, not here.
|
|
383
|
+
|
|
384
|
+
```tsx
|
|
385
|
+
// Good — wrapped in Field for the floating label; the <label> is the accessible name
|
|
386
|
+
<Field label="Odběratel" helperText="Hledá se podle jména, názvu nebo IČO">
|
|
387
|
+
<ComboboxField
|
|
388
|
+
id="subject"
|
|
389
|
+
value={query}
|
|
390
|
+
placeholder="Zadejte jméno, název nebo IČO…"
|
|
391
|
+
state={open ? 'open' : 'default'}
|
|
392
|
+
aria-controls="subject-listbox"
|
|
393
|
+
aria-activedescendant={open ? activeOptionId : undefined}
|
|
394
|
+
onChange={event => setQuery(event.target.value)}
|
|
395
|
+
/>
|
|
396
|
+
</Field>
|
|
397
|
+
|
|
398
|
+
// Good — the clear-× contract is a TS union, so BRANCH the render
|
|
399
|
+
{selected ? (
|
|
400
|
+
<ComboboxField
|
|
401
|
+
state="selected"
|
|
402
|
+
value={selected.name}
|
|
403
|
+
aria-label="Odběratel"
|
|
404
|
+
onClear={reset}
|
|
405
|
+
clearLabel="Zrušit výběr"
|
|
406
|
+
/>
|
|
407
|
+
) : (
|
|
408
|
+
<ComboboxField state="default" value={query} placeholder="Zadejte jméno, název nebo IČO…" aria-label="Odběratel" />
|
|
409
|
+
)}
|
|
410
|
+
|
|
411
|
+
// Don't — a conditional spread widens the union away (and no longer compiles)
|
|
412
|
+
<ComboboxField state="selected" value="Novák s.r.o." {...(selected ? { onClear, clearLabel } : {})} />
|
|
413
|
+
|
|
414
|
+
// Don't — the trailing slot belongs to the flow state; there is no user icon slot
|
|
415
|
+
<ComboboxField state="open" trailingIcon="check" />
|
|
416
|
+
|
|
417
|
+
// Don't — no validation states on the trigger; put them on the manual-entry TextFields
|
|
418
|
+
<ComboboxField state="error" />
|
|
419
|
+
```
|
|
420
|
+
|
|
421
|
+
The leading magnifier is opt-in per instance:
|
|
422
|
+
|
|
423
|
+
<Canvas of={ComboboxFieldStories.WithLeadingIcon} />
|
|
424
|
+
|
|
425
|
+
```tsx
|
|
426
|
+
// Good — opt in where the search affordance genuinely helps
|
|
427
|
+
<ComboboxField leadingIcon="magnifying-glass" placeholder="Zadejte jméno, název nebo IČO…" aria-label="Odběratel" />
|
|
428
|
+
```
|
|
429
|
+
|
|
430
|
+
## Composed with a panel
|
|
431
|
+
|
|
432
|
+
ComboboxField is the **trigger only**. The open Combobox is the **`Combobox` organism**: the trigger + a
|
|
433
|
+
Popover surface + [ListRow](?path=/docs/design-system-atoms-listrow--docs) `option` rows, plus the sticky
|
|
434
|
+
manual-entry row (`manualEntry` — `Zadám vše o subjektu ručně`), a `link` row that is the **last item of
|
|
435
|
+
the ↑/↓ ring**: `role="option"` without `aria-selected`, Enter runs it. Focus never leaves the input: ↑/↓
|
|
436
|
+
move `aria-activedescendant`, Enter commits. Result rows sit one density step below the trigger.
|
|
437
|
+
|
|
438
|
+
**Dismissal belongs to the organism, not to the field** — a stateless trigger has nothing to close.
|
|
439
|
+
`Combobox` gets it from the shared `useAnchoredPanel` substrate, and it is the spec's closed set
|
|
440
|
+
(`overlay-behavior.md` § Dismissal): **Esc** (which also clears the query and stays in the input),
|
|
441
|
+
**outside pointer-down**, **selection**, route change, and **Tab**, which leaves the combobox and closes
|
|
442
|
+
the panel (WAI-ARIA APG — the manual-entry row is reached with ↓, not Tab). Two fields on one page
|
|
443
|
+
therefore can never be open at the same time.
|
|
444
|
+
|
|
445
|
+
**Below `sm` (640 viewport) the panel is a bottom sheet** (combobox-field 1.11.0, `overlay-behavior.md`
|
|
446
|
+
§ Mobile): grab handle and centred title — `sheetTitle` on the `Combobox` organism, defaulting to the field
|
|
447
|
+
label (set it only when the label is abbreviated) — then the search row with a **line under it**, List Row
|
|
448
|
+
Mobile results (the chosen row with its trailing check in `--secondary`, list-row 2.7.0, no leading reserve), and the
|
|
449
|
+
manual-entry action in a fixed footer above a line. It stacks above a Modal at `--z-index-popover`; Esc
|
|
450
|
+
closes only the sheet. `sheetTitle` lives on the organism because this trigger owns no panel.
|
|
451
|
+
|
|
452
|
+
<Canvas of={ComboboxFieldStories.MobileSheet} />
|
|
453
|
+
|
|
454
|
+
Narrowing stays with the caller: `Combobox` takes `items` that are already filtered, because the same
|
|
455
|
+
organism serves a local match and a debounced ARES round trip.
|
|
456
|
+
|
|
457
|
+
<Canvas of={ComboboxFieldStories.WithPanel} />
|
|
458
|
+
|
|
459
|
+
```tsx
|
|
460
|
+
<Field label="Odběratel">
|
|
461
|
+
<Combobox
|
|
462
|
+
items={results} // already filtered
|
|
463
|
+
query={query}
|
|
464
|
+
onQueryChange={setQuery}
|
|
465
|
+
value={subject} // the ComboboxItem, not its id
|
|
466
|
+
onValueChange={setSubject}
|
|
467
|
+
loading={isFetching}
|
|
468
|
+
// No defaults — the organism has no locale of its own, the strings come from
|
|
469
|
+
// the consumer's translation layer. The panel takes its name from the Field
|
|
470
|
+
// label (`panelLabel` is only the fallback for a field without a visible label).
|
|
471
|
+
emptyLabel="Žádné výsledky"
|
|
472
|
+
loadingLabel="Vyhledávám…"
|
|
473
|
+
clearLabel="Zrušit výběr"
|
|
474
|
+
manualEntry={{
|
|
475
|
+
label: 'Zadám vše o subjektu ručně',
|
|
476
|
+
icon: <Icon name="pencil-simple" size="small" />,
|
|
477
|
+
onSelect: openManualFields,
|
|
478
|
+
}}
|
|
479
|
+
sheetTitle="Odběratel" // only when the visible label is abbreviated
|
|
480
|
+
/>
|
|
481
|
+
</Field>
|
|
482
|
+
```
|
|
483
|
+
|
|
484
|
+
## Related
|
|
485
|
+
|
|
486
|
+
- **TextField** — the shell ComboboxField reuses (`textFieldShellVariants` / `textFieldValueVariants`); the
|
|
487
|
+
trigger is pixel-locked to it, and the status states live there.
|
|
488
|
+
- **SelectField** — the same trigger-only relationship for a **fixed, scannable** set; reach for it when the
|
|
489
|
+
user shouldn't have to type.
|
|
490
|
+
- **Combobox** — the organism around this trigger: it owns the result panel, the `listbox` role and
|
|
491
|
+
dismissal. Reach for it rather than re-composing the surface by hand.
|
|
492
|
+
- **Select** — the composed single-select dropdown (trigger + panel) the Select family ships.
|
|
493
|
+
- **ListRow** — the `option` rows of the result surface.
|
|
494
|
+
- **Popover surface** — the shared overlay chrome recipe (`popoverSurfaceVariants`) the result panel sits on.
|
|
495
|
+
- **AnchoredPanel** — anchoring / offset / dismissal behaviour for the floating result surface.
|
|
496
|
+
- **Field** — the floating label / helper / error wrapper.
|
|
497
|
+
- Spec: `spec/04-molecules/combobox-field.md`.
|
|
498
|
+
|
|
499
|
+
## Migration notes
|
|
500
|
+
|
|
501
|
+
- **ARES subject-lookup is its OWN component (upstream, 2026-07-10).** The ARES subject lookup is a dedicated **Subject Lookup** pattern,
|
|
502
|
+
because its chrome genuinely differs (no leading icon; its own trailing state machine — magic wand
|
|
503
|
+
while empty, spinner while searching, check when found, a clear × once it holds a query — grouped
|
|
504
|
+
contacts/registry results, collapse-to-summary card). ComboboxField stays the **generic** trigger; an earlier attempt to host the ARES brand icon here
|
|
505
|
+
(spec v1.1.0) was reverted in v1.2.0.
|
|
506
|
+
- **Caret glyph moved to the small tier** (manifest 1.3.0, 2026-07-15): `caret-down`/`caret-up` →
|
|
507
|
+
`caret-down-small`/`caret-up-small`. The slot itself
|
|
508
|
+
keeps the shared field icon tier (`md` 24 / `sm` 20), same as TextField and SelectField.
|
|
509
|
+
- **Manifest 1.8.0 → 1.10.0.** 1.9.0 renamed the Figma Size values to the code vocabulary
|
|
510
|
+
(Medium / Small → `md` / `sm`) — the `size` prop already used those, so no code change. 1.10.0 moves
|
|
511
|
+
the Selected clear `×` to the small-tier glyph `x-small` (a 9px cross, pairing with the small caret in
|
|
512
|
+
the same trailing slot); the icon set now carries it and the clear button uses it.
|
|
513
|
+
- **Manifest 1.10.0 → 1.11.0.** Optional code-only `text.sheet-title` → `sheetTitle` on the `Combobox`
|
|
514
|
+
organism, the mobile bottom-sheet title. Shipped together with the sheet itself.
|
|
515
|
+
- **Manifest 1.11.0 → 1.12.0 — motion audit (2026-11-03).** The open caret is no longer a glyph swap
|
|
516
|
+
(`caret-down-small` ↔ `caret-up-small`): one `caret-down-small` turns 180° in Motion on
|
|
517
|
+
`--spring-standard` (shared `internal/MotionCaret.tsx`), interruptible, end pose at once under reduced
|
|
518
|
+
motion. The spinner already turned on `animate-spin`, now `--duration-spin` + `--easing-linear`
|
|
519
|
+
(ui-system 0.17.0). New `Motion` story.
|
|
520
|
+
- **Manifest 1.12.0 → 1.13.0 (2026-11-13).** Optional code-only `text.sheet-close-label` →
|
|
521
|
+
`sheetCloseLabel` on the `Combobox` organism: the name of the hidden close button of the mobile bottom
|
|
522
|
+
sheet, default «Zavřít». An app with more language versions passes it from its translations.
|
|
523
|
+
- **`Combobox` `footer` → `manualEntry`.** The free `footer` node (a Tab-reachable command outside the
|
|
524
|
+
ring) is replaced by `manualEntry={{ label, onSelect, icon? }}`: the organism renders the row and puts it
|
|
525
|
+
LAST in the ↑/↓ ring as a non-selectable `option`. Tab now closes the panel.
|