@invoiceonline/ui-react 0.0.0-stage → 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 +78 -2
- 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 +357 -4
- 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,241 @@
|
|
|
1
|
+
import { Meta, Canvas, Controls } from '@storybook/addon-docs/blocks';
|
|
2
|
+
import * as SelectStories from './Select.stories';
|
|
3
|
+
|
|
4
|
+
<Meta of={SelectStories} tags={['autodocs']} />
|
|
5
|
+
|
|
6
|
+
# Select
|
|
7
|
+
|
|
8
|
+
## Metadata
|
|
9
|
+
|
|
10
|
+
- **Layer:** organism
|
|
11
|
+
- **Status:** stable
|
|
12
|
+
- **Composes:** [`SelectField`](?path=/docs/design-system-molecules-selectfield--docs) (trigger) + [`PopoverSurface`](?path=/docs/design-system-patterns-popover-surface--docs) (panel chrome) + [`ListRow`](?path=/docs/design-system-atoms-listrow--docs) (`option` rows)
|
|
13
|
+
- **Behaviour engine:** [`@floating-ui/react`](https://floating-ui.com/docs/react) — positioning, list navigation, typeahead, dismiss, role, transition
|
|
14
|
+
- **Tokens used:** `--bg-hover`, `--bg-primary`, `--bg-readonly`, `--bg-secondary`, `--border-width-100`, `--border-width-200`, `--disabled-background`, `--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`, `--radius-200`, `--radius-400`, `--radius-500`, `--secondary`, `--secondary-active`, `--shadow-overlay`, `--size-icon-small`, `--size-icon-xsmall`, `--space-100`, `--space-1000`, `--space-1100`, `--space-200`, `--space-300`, `--space-400`, `--space-500`, `--space-600`, `--status-danger`, `--status-success-solid`, `--text-link`, `--text-link-hover`, `--text-placeholder`, `--text-primary`, `--text-secondary`, `--z-index-dropdown`
|
|
15
|
+
|
|
16
|
+
## Overview
|
|
17
|
+
|
|
18
|
+
Use a **Select** to pick **one value from a fixed, known set** — currency, country, VAT rate, unit,
|
|
19
|
+
payment method. It is the **working single-select organism**: a controlled widget you drive with
|
|
20
|
+
`options` + `value` + `onValueChange`. The design system ships the pieces (trigger, panel chrome,
|
|
21
|
+
rows); this organism wires them into a keyboard-driven, portalled dropdown and supplies what the
|
|
22
|
+
primitives deliberately do not — the role + keyboard contract, `aria-activedescendant` (DOM focus
|
|
23
|
+
stays on the trigger — virtual navigation), a portalled panel with collision flip/shift, and an exit
|
|
24
|
+
transition.
|
|
25
|
+
|
|
26
|
+
Wrap it in `Field` for a floating label, helper and error messaging — `Field` detects the Select and
|
|
27
|
+
keeps the label floating regardless of the open/closed state.
|
|
28
|
+
|
|
29
|
+
Do **not** use it for free-form text (→ **TextField**), for a large or **searchable / typed** set
|
|
30
|
+
(→ a Combobox / autocomplete), for **multi-select** or toggles (→ a Popover + checkbox list), or for
|
|
31
|
+
**navigation / commands** (→ a Menu). If the user should be able to *type to filter*, it is not a Select.
|
|
32
|
+
|
|
33
|
+
## Anatomy
|
|
34
|
+
|
|
35
|
+
- **Trigger** — a [`SelectField`](?path=/docs/design-system-molecules-selectfield--docs): the reused
|
|
36
|
+
Text Field shell + a trailing caret. Shows the selected option's label (or the placeholder) and a
|
|
37
|
+
caret that flips down → up on open. Rendered as a read-only `<button>`; DOM focus stays here while open.
|
|
38
|
+
- **Panel** — the shared [`PopoverSurface`](?path=/docs/design-system-patterns-popover-surface--docs)
|
|
39
|
+
chrome recipe (`popoverSurfaceVariants` + `popoverBodyClass` + `popoverGroupClass`), **portalled** into
|
|
40
|
+
the enclosing `Modal` or `Drawer` when the trigger sits inside one, else into the `PortalContainerContext`
|
|
41
|
+
element when one is provided, else to `document.body`, and anchored below the trigger. Per spec the surface is a chrome recipe, **not a component**.
|
|
42
|
+
- **Option rows** — [`ListRow`](?path=/docs/design-system-atoms-listrow--docs) `role="option"` rows. The
|
|
43
|
+
trigger size cascades: a Medium trigger opens Medium rows (40), a Small trigger Small rows (36).
|
|
44
|
+
Single-select → the chosen row carries the Selected fill and a **leading checkmark** in `--secondary` (blue,
|
|
45
|
+
list-row 2.7.0 `slots.leading`) — the one glyph that leaves the family ink; the others reserve the slot (invisible icon)
|
|
46
|
+
so labels stay aligned. The checkmark tracks the row density (20 at Medium, 16 at Small) via
|
|
47
|
+
`ListRow`'s leading slot, so it must not carry an `Icon size` of its own. A disabled option is dimmed
|
|
48
|
+
and skipped by keyboard nav.
|
|
49
|
+
- **Floating label / helper / error** — NOT owned by Select; wrap it in **Field**.
|
|
50
|
+
|
|
51
|
+
## Matrix
|
|
52
|
+
|
|
53
|
+
<Canvas of={SelectStories.Matrix} />
|
|
54
|
+
|
|
55
|
+
The full state × size grid, mirroring the Figma labelled grid — rows are states, columns are sizes.
|
|
56
|
+
Only the three states the trigger actually renders appear: open/focus is derived internally and never
|
|
57
|
+
passed in, so it has no cell of its own.
|
|
58
|
+
|
|
59
|
+
## Sizes
|
|
60
|
+
|
|
61
|
+
<Canvas of={SelectStories.Sizes} />
|
|
62
|
+
|
|
63
|
+
Medium (48) is the default for standard forms; Small (40) is for dense contexts (filter bars, table
|
|
64
|
+
cells, tight toolbars). The trigger size cascades to the panel rows. Keep **one size per form**. Width is
|
|
65
|
+
layout — the trigger fills its column and the panel takes the trigger width (min-width = trigger width).
|
|
66
|
+
|
|
67
|
+
## States
|
|
68
|
+
|
|
69
|
+
<Canvas of={SelectStories.States} />
|
|
70
|
+
|
|
71
|
+
Only **error** and **disabled** are passed in; open/focus is derived internally.
|
|
72
|
+
|
|
73
|
+
- **Default** — placeholder in `--text-placeholder`, caret-down in `--icon-muted`.
|
|
74
|
+
- **Focused (open)** — derived on open: the trigger border swaps to `--outline-focus` (no ring), the caret
|
|
75
|
+
flips up and the panel is anchored below.
|
|
76
|
+
- **Error** — `state="error"` (or `Field` injecting `aria-invalid`) → `--status-danger` border + a trailing
|
|
77
|
+
`warning-circle` status icon (replacing the caret); pair with a `Field` error message. Colour is never the sole cue (WCAG 1.4.1).
|
|
78
|
+
- **Disabled** — `--outline-default` border at `--border-width-100`, `--disabled-background` fill, content + caret in `--disabled-foreground` (nothing chosen → `–`); not focusable, does not open.
|
|
79
|
+
`disabled` wins over `state`.
|
|
80
|
+
|
|
81
|
+
## With Field
|
|
82
|
+
|
|
83
|
+
<Canvas of={SelectStories.WithField} />
|
|
84
|
+
|
|
85
|
+
A Select label **always floats to the top** (Select is in `Field`’s auto-float list): the label lives on
|
|
86
|
+
the top border, hidden when empty with a placeholder shown inside, and never rests inside. `Field` injects
|
|
87
|
+
`error` / `aria-invalid` / `aria-describedby` and reads `onOpenChange` (not `onFocus`) to drive the label
|
|
88
|
+
focus state while the panel is open.
|
|
89
|
+
|
|
90
|
+
## Long list
|
|
91
|
+
|
|
92
|
+
<Canvas of={SelectStories.LongList} />
|
|
93
|
+
|
|
94
|
+
The panel height is soft-capped (~8–10 rows), so a long set scrolls inside the body rather than off-screen;
|
|
95
|
+
collision **flip/shift** keeps the panel in the viewport.
|
|
96
|
+
|
|
97
|
+
## Disabled option
|
|
98
|
+
|
|
99
|
+
<Canvas of={SelectStories.WithDisabledOption} />
|
|
100
|
+
|
|
101
|
+
Mark an option `disabled: true` to render it dimmed and non-selectable — keyboard navigation steps over it.
|
|
102
|
+
|
|
103
|
+
## API
|
|
104
|
+
|
|
105
|
+
<Controls />
|
|
106
|
+
|
|
107
|
+
## Do / Don't
|
|
108
|
+
|
|
109
|
+
- ✅ Reach for a Select for a **fixed, known set** the user recognises.
|
|
110
|
+
- ✅ Keep it **controlled** — hold `value` in state, update it in `onValueChange`.
|
|
111
|
+
- ✅ Wrap in **Field** for the floating `<label>` (the accessible name) + helper / error.
|
|
112
|
+
- ✅ Give a label-less filter Select an explicit **`aria-label`**.
|
|
113
|
+
- ✅ Pair `state="error"` with a matching `error` message on the `Field`.
|
|
114
|
+
- ❌ Don't use it for a set the user must **type to find** (that's a Combobox) or for free-form text (TextField).
|
|
115
|
+
- ❌ Don't use it for >20-30 items — use a Combobox / search pattern.
|
|
116
|
+
- ❌ Don't use it for binary choices — use `RadioGroup` or a switch.
|
|
117
|
+
- ❌ Don't rely on the placeholder as the accessible name.
|
|
118
|
+
|
|
119
|
+
## Keyboard
|
|
120
|
+
|
|
121
|
+
<table>
|
|
122
|
+
<thead>
|
|
123
|
+
<tr><th>Key</th><th>Action</th></tr>
|
|
124
|
+
</thead>
|
|
125
|
+
<tbody>
|
|
126
|
+
<tr><td><kbd>Enter</kbd> / <kbd>Space</kbd> / <kbd>↓</kbd></td><td>Open the panel (highlight lands on the selected option)</td></tr>
|
|
127
|
+
<tr><td><kbd>↑</kbd> / <kbd>↓</kbd></td><td>Move the highlight (loops; skips disabled options)</td></tr>
|
|
128
|
+
<tr><td>typeahead</td><td>Type to jump to the option whose label matches</td></tr>
|
|
129
|
+
<tr><td><kbd>Home</kbd> / <kbd>End</kbd></td><td>Jump to the first / last option</td></tr>
|
|
130
|
+
<tr><td><kbd>Enter</kbd> / <kbd>Space</kbd></td><td>Select the highlighted option + close (Space suppressed mid-typeahead)</td></tr>
|
|
131
|
+
<tr><td><kbd>Esc</kbd></td><td>Close the panel and return focus to the trigger</td></tr>
|
|
132
|
+
</tbody>
|
|
133
|
+
</table>
|
|
134
|
+
|
|
135
|
+
Below `sm` the same keys work on the bottom sheet, with real DOM focus on the rows (roving `tabindex`)
|
|
136
|
+
instead of `aria-activedescendant`; there is no typeahead.
|
|
137
|
+
|
|
138
|
+
## Accessibility
|
|
139
|
+
|
|
140
|
+
- **Semantics** — the trigger is `role="combobox"` with `aria-haspopup="listbox"` and `aria-expanded`; the
|
|
141
|
+
panel is `role="listbox"` and each option is `role="option"` with `aria-selected`. A label-less filter Select
|
|
142
|
+
needs an explicit `aria-label` — the placeholder is **not** a label.
|
|
143
|
+
- **Two things need the name, not one.** The `Field` label names the **trigger** natively (`<label htmlFor>`),
|
|
144
|
+
but a `role="listbox"` is name-required in its own right and the panel is portalled out of the field, where
|
|
145
|
+
`htmlFor` cannot reach it. `Field` therefore also hands its label's `id` down as `aria-labelledby`, which
|
|
146
|
+
`Select` puts on the panel — so both are named by the same visible text, with nothing retyped. Exactly one of
|
|
147
|
+
`aria-labelledby` / `aria-label` ever lands on the panel: `aria-labelledby` wins the accessible-name
|
|
148
|
+
computation, so a co-existing `aria-label` would look present and never be announced. An `aria-label` you pass
|
|
149
|
+
yourself is treated as a deliberate override and `Field` stays out of the way.
|
|
150
|
+
- **Virtual focus** — DOM focus **stays on the trigger** while open; the current option is pointed at by
|
|
151
|
+
**`aria-activedescendant`** (list navigation is virtual). The rows never own a focus ring — the current option is
|
|
152
|
+
a soft `--bg-hover` highlight. On selection or dismissal, focus returns to the trigger.
|
|
153
|
+
- **State & ARIA** — open sets `aria-expanded="true"`; **Error** = `aria-invalid="true"` + `aria-describedby` at
|
|
154
|
+
the message id, signalled by colour **and** the status icon (WCAG 1.4.1). Disabled drops from the tab order.
|
|
155
|
+
- **Screen reader** — VoiceOver / NVDA announce "combobox", the current value and the option count; as the
|
|
156
|
+
highlight moves, each option is announced with its position.
|
|
157
|
+
|
|
158
|
+
- **Mobile bottom sheet (below `sm`)** — the trigger announces `aria-haspopup="dialog"` instead of
|
|
159
|
+
`listbox`. The sheet is `role="dialog"` + `aria-modal="true"`, named by its title (`sheetTitle`, else the
|
|
160
|
+
field label); the page behind is `inert`. Focus lands on the **selected row** (roving `tabindex`, the
|
|
161
|
+
rows hold real DOM focus and show the inset `--outline-focus` ring); ↑ ↓ / Home / End move it, Enter /
|
|
162
|
+
Space select + close. A visually hidden «Zavřít» button, Esc, a drag down and the scrim close the sheet
|
|
163
|
+
without a change, and focus returns to the trigger. Inside a Modal the sheet stacks above it
|
|
164
|
+
(`--z-index-popover`) and Esc closes only the sheet. 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).
|
|
165
|
+
|
|
166
|
+
Accessibility floor for every FODS component: `spec/01-foundations/accessibility.md`.
|
|
167
|
+
|
|
168
|
+
## Mobile bottom sheet
|
|
169
|
+
|
|
170
|
+
<Canvas of={SelectStories.MobileSheet} />
|
|
171
|
+
|
|
172
|
+
Below `sm` (640 viewport width, `useIsMobile('sm')`) the options open in a **bottom sheet** instead of the
|
|
173
|
+
anchored panel (`overlay-behavior.md` § Mobile, select-field 1.8.0): grab handle, centred title
|
|
174
|
+
(`sheetTitle`, defaulting to the field label), List Row Mobile rows with the trailing check in
|
|
175
|
+
`--secondary` (list-row 2.7.0), no divider under the header. The sheet caps at 80% of the visual viewport and goes
|
|
176
|
+
full-height when fewer than three rows would fit; it closes on selection, a drag down past a quarter of its
|
|
177
|
+
height, the scrim, Esc and the hidden «Zavřít».
|
|
178
|
+
|
|
179
|
+
## Positioning
|
|
180
|
+
|
|
181
|
+
Positioning and interactions come from `@floating-ui/react`:
|
|
182
|
+
|
|
183
|
+
- **Portal** — the panel renders in a `FloatingPortal` whose root is the enclosing `Modal` or `Drawer` dialog
|
|
184
|
+
when the trigger sits inside one (so the panel stays inside its focus trap), else the `PortalContainerContext`
|
|
185
|
+
element, else `document.body`; it floats over the page instead of pushing it (the page behind does not shift).
|
|
186
|
+
- **Anchor** — `placement: 'bottom-start'` with a **4px** (`--space-200`) `offset`, below the trigger.
|
|
187
|
+
- **Collision** — `flip` (above when there is no room below) + `shift` (nudge within the viewport), 8px padding.
|
|
188
|
+
- **Size** — the panel **min-width = trigger width**; the height is soft-capped so long lists scroll inside the body.
|
|
189
|
+
- **Transition** — fades + slides in/out over **150ms** (`--duration-fast`) via `useTransitionStyles`.
|
|
190
|
+
|
|
191
|
+
## Usage
|
|
192
|
+
|
|
193
|
+
```tsx
|
|
194
|
+
import { Field, Select } from '@invoiceonline/ui-react';
|
|
195
|
+
import type { SelectOption } from '@invoiceonline/ui-react';
|
|
196
|
+
|
|
197
|
+
const CURRENCIES: SelectOption[] = [
|
|
198
|
+
{ value: 'CZK', label: 'CZK — Česká koruna' },
|
|
199
|
+
{ value: 'EUR', label: 'EUR — Euro' },
|
|
200
|
+
{ value: 'USD', label: 'USD — americký dolar' },
|
|
201
|
+
];
|
|
202
|
+
|
|
203
|
+
function CurrencyPicker() {
|
|
204
|
+
const [value, setValue] = React.useState('CZK');
|
|
205
|
+
|
|
206
|
+
// Good — controlled, wrapped in Field for the floating label + helper
|
|
207
|
+
return (
|
|
208
|
+
<Field label="Měna" helperText="Použije se pro všechny položky faktury">
|
|
209
|
+
<Select id="currency" options={CURRENCIES} value={value} onValueChange={setValue} placeholder="Vyberte měnu" />
|
|
210
|
+
</Field>
|
|
211
|
+
);
|
|
212
|
+
}
|
|
213
|
+
|
|
214
|
+
// Good — label-less filter Select needs an explicit aria-label
|
|
215
|
+
<Select options={CURRENCIES} value={value} onValueChange={setValue} aria-label="Měna" />
|
|
216
|
+
|
|
217
|
+
// Good — small size for dense rows / filter bars
|
|
218
|
+
<Select size="sm" options={UNITS} value={unit} onValueChange={setUnit} aria-label="Jednotka" />
|
|
219
|
+
|
|
220
|
+
// Good — a non-selectable option
|
|
221
|
+
<Select options={[{ value: 'ex', label: 'Osvobozeno', disabled: true }, ...]} ... />
|
|
222
|
+
```
|
|
223
|
+
|
|
224
|
+
```tsx
|
|
225
|
+
// Don't — using <select> directly (Select is the widget)
|
|
226
|
+
<select onChange={...}>...</select>
|
|
227
|
+
|
|
228
|
+
// Don't — leaving it uncontrolled; hold `value` in state and update it in onValueChange
|
|
229
|
+
|
|
230
|
+
// Don't — relying on the placeholder as the accessible name; wrap in Field or add aria-label
|
|
231
|
+
<Select options={CURRENCIES} placeholder="Vyberte měnu" />
|
|
232
|
+
```
|
|
233
|
+
|
|
234
|
+
## Related
|
|
235
|
+
|
|
236
|
+
- [`SelectField`](?path=/docs/design-system-molecules-selectfield--docs) — the trigger this organism wires up
|
|
237
|
+
- [`PopoverSurface`](?path=/docs/design-system-patterns-popover-surface--docs) — the panel chrome recipe
|
|
238
|
+
- [`ListRow`](?path=/docs/design-system-atoms-listrow--docs) — the `option` rows
|
|
239
|
+
- [`Field`](?path=/docs/design-system-atoms-field--docs) — floating-label / helper / error wrapper
|
|
240
|
+
- [`RadioGroup`](?path=/docs/design-system-atoms-radiogroup--docs) — for ≤5 mutually exclusive options
|
|
241
|
+
- Spec: `spec/06-patterns/overlay-behavior.md`
|
|
@@ -0,0 +1,404 @@
|
|
|
1
|
+
import * as React from 'react';
|
|
2
|
+
import type { Meta, StoryObj } from '@storybook/react-vite';
|
|
3
|
+
import type { ReactNode } from 'react';
|
|
4
|
+
import { Field } from '../field/Field';
|
|
5
|
+
import { Select } from './Select';
|
|
6
|
+
import type { SelectOption } from './Select';
|
|
7
|
+
import { Section, Showcase } from '../../storybook/Section';
|
|
8
|
+
import { componentDoc } from '../../storybook/componentDoc';
|
|
9
|
+
|
|
10
|
+
const SIZES = ['md', 'sm'] as const;
|
|
11
|
+
// Only `error` and `disabled` change the trigger — the rest resolve to default
|
|
12
|
+
// (open/focus is derived internally, never passed in). See Select.tsx.
|
|
13
|
+
const STATES = ['default', 'error', 'disabled'] as const;
|
|
14
|
+
|
|
15
|
+
const Frame = ({ children }: { children: ReactNode }) => (
|
|
16
|
+
<div className="w-[calc(var(--space-1200)*4)]">{children}</div>
|
|
17
|
+
);
|
|
18
|
+
|
|
19
|
+
// -----------------------------------------------------------------------------
|
|
20
|
+
// Realistic option sets (cs) — a Select is for a fixed, known set.
|
|
21
|
+
// -----------------------------------------------------------------------------
|
|
22
|
+
const CURRENCIES: SelectOption[] = [
|
|
23
|
+
{ value: 'CZK', label: 'CZK — Česká koruna' },
|
|
24
|
+
{ value: 'EUR', label: 'EUR — Euro' },
|
|
25
|
+
{ value: 'USD', label: 'USD — americký dolar' },
|
|
26
|
+
{ value: 'GBP', label: 'GBP — britská libra' },
|
|
27
|
+
];
|
|
28
|
+
|
|
29
|
+
const UNITS: SelectOption[] = [
|
|
30
|
+
{ value: 'ks', label: 'ks' },
|
|
31
|
+
{ value: 'hod', label: 'hod' },
|
|
32
|
+
{ value: 'den', label: 'den' },
|
|
33
|
+
{ value: 'kg', label: 'kg' },
|
|
34
|
+
{ value: 'm', label: 'm' },
|
|
35
|
+
];
|
|
36
|
+
|
|
37
|
+
const VAT_RATES: SelectOption[] = [
|
|
38
|
+
{ value: '21', label: '21 %' },
|
|
39
|
+
{ value: '12', label: '12 %' },
|
|
40
|
+
{ value: '0', label: '0 %' },
|
|
41
|
+
{ value: 'osvobozeno', label: 'Osvobozeno od DPH' },
|
|
42
|
+
];
|
|
43
|
+
|
|
44
|
+
// A long set to demonstrate the panel's scroll cap (10+ rows).
|
|
45
|
+
const COUNTRIES: SelectOption[] = [
|
|
46
|
+
{ value: 'cz', label: 'Česká republika' },
|
|
47
|
+
{ value: 'sk', label: 'Slovensko' },
|
|
48
|
+
{ value: 'pl', label: 'Polsko' },
|
|
49
|
+
{ value: 'de', label: 'Německo' },
|
|
50
|
+
{ value: 'at', label: 'Rakousko' },
|
|
51
|
+
{ value: 'hu', label: 'Maďarsko' },
|
|
52
|
+
{ value: 'ro', label: 'Rumunsko' },
|
|
53
|
+
{ value: 'bg', label: 'Bulharsko' },
|
|
54
|
+
{ value: 'hr', label: 'Chorvatsko' },
|
|
55
|
+
{ value: 'si', label: 'Slovinsko' },
|
|
56
|
+
{ value: 'fr', label: 'Francie' },
|
|
57
|
+
{ value: 'es', label: 'Španělsko' },
|
|
58
|
+
{ value: 'it', label: 'Itálie' },
|
|
59
|
+
{ value: 'gb', label: 'Spojené království' },
|
|
60
|
+
{ value: 'nl', label: 'Nizozemsko' },
|
|
61
|
+
{ value: 'be', label: 'Belgie' },
|
|
62
|
+
{ value: 'ch', label: 'Švýcarsko' },
|
|
63
|
+
{ value: 'se', label: 'Švédsko' },
|
|
64
|
+
];
|
|
65
|
+
|
|
66
|
+
const meta = {
|
|
67
|
+
title: 'Design System/Organisms/Select',
|
|
68
|
+
component: Select,
|
|
69
|
+
parameters: {
|
|
70
|
+
layout: 'centered',
|
|
71
|
+
containerWidth: 300,
|
|
72
|
+
docs: {
|
|
73
|
+
description: {
|
|
74
|
+
component: componentDoc({
|
|
75
|
+
summary:
|
|
76
|
+
'Controlled single-select ORGANISM — the working widget that wires the `SelectField` trigger, the `PopoverSurface` chrome recipe and `ListRow` `option` rows into one keyboard-driven, portalled dropdown (via `@floating-ui/react`). You pass `options` + `value` + `onValueChange`; it owns open/close, virtual keyboard navigation (`aria-activedescendant`), collision flip/shift and the exit transition. Wrap it in `Field` for a floating label, helper or error messaging.',
|
|
77
|
+
useCases: [
|
|
78
|
+
'Pick one value from a fixed set — currency, unit, VAT rate, country, payment method',
|
|
79
|
+
'`size="md"` (48) — standard forms · `size="sm"` (40) — dense rows, filter bars',
|
|
80
|
+
'`state="error"` — the trigger caret is replaced by the `warning-circle` status icon; pair with a `Field` error message',
|
|
81
|
+
'`options[].disabled` — a non-selectable, dimmed row skipped by keyboard navigation',
|
|
82
|
+
],
|
|
83
|
+
bestPractices: [
|
|
84
|
+
'Wrap in `Field` for the floating label — the `<label>` is the accessible name, never the placeholder',
|
|
85
|
+
'For a label-less filter Select supply an explicit `aria-label`',
|
|
86
|
+
'Use for a fixed, discoverable set — reach for a Combobox/autocomplete for long, searchable, or type-to-filter lists',
|
|
87
|
+
'Keep it controlled — hold `value` in state and update it in `onValueChange`',
|
|
88
|
+
],
|
|
89
|
+
knownIssues: [
|
|
90
|
+
'Single-select only — searchable sets are a Combobox, multi-select is a Popover + checkbox list, command menus are a Menu',
|
|
91
|
+
'The panel height is soft-capped at `--ds-overlay-max-height` (320 ≈ 8 rows of 40), published since ui-system 0.10.0; longer lists scroll inside the body',
|
|
92
|
+
],
|
|
93
|
+
docsLink: { label: 'spec/06-patterns/popover-patterns.md' },
|
|
94
|
+
}),
|
|
95
|
+
},
|
|
96
|
+
},
|
|
97
|
+
},
|
|
98
|
+
} satisfies Meta<typeof Select>;
|
|
99
|
+
|
|
100
|
+
export default meta;
|
|
101
|
+
type Story = StoryObj<typeof Select>;
|
|
102
|
+
|
|
103
|
+
// Select is controlled — every demo owns the value in local state (the organism
|
|
104
|
+
// owns open/close). Hooks must live in components, not in Story `render` bodies
|
|
105
|
+
// (react-hooks/rules-of-hooks), so each story renders a small component below.
|
|
106
|
+
|
|
107
|
+
const PlaygroundDemo = (args: React.ComponentProps<typeof Select>) => {
|
|
108
|
+
const [value, setValue] = React.useState(args.value ?? '');
|
|
109
|
+
// Reset local value when the control changes it.
|
|
110
|
+
React.useEffect(() => setValue(args.value ?? ''), [args.value]);
|
|
111
|
+
return (
|
|
112
|
+
<Frame>
|
|
113
|
+
<Select {...args} value={value} onValueChange={setValue} />
|
|
114
|
+
</Frame>
|
|
115
|
+
);
|
|
116
|
+
};
|
|
117
|
+
|
|
118
|
+
export const Playground: Story = {
|
|
119
|
+
args: {
|
|
120
|
+
options: CURRENCIES,
|
|
121
|
+
value: '',
|
|
122
|
+
placeholder: 'Vyberte měnu',
|
|
123
|
+
size: 'md',
|
|
124
|
+
state: 'default',
|
|
125
|
+
disabled: false,
|
|
126
|
+
'aria-label': 'Měna',
|
|
127
|
+
},
|
|
128
|
+
argTypes: {
|
|
129
|
+
size: { control: 'select', options: SIZES },
|
|
130
|
+
state: { control: 'select', options: STATES },
|
|
131
|
+
disabled: { control: 'boolean' },
|
|
132
|
+
placeholder: { control: 'text' },
|
|
133
|
+
value: { control: 'text' },
|
|
134
|
+
options: { control: false },
|
|
135
|
+
},
|
|
136
|
+
render: args => <PlaygroundDemo {...args} />,
|
|
137
|
+
};
|
|
138
|
+
|
|
139
|
+
export const Matrix: Story = {
|
|
140
|
+
parameters: {
|
|
141
|
+
layout: 'padded',
|
|
142
|
+
docs: {
|
|
143
|
+
description: {
|
|
144
|
+
story:
|
|
145
|
+
'Full state × size matrix — mirrors the Figma labelled grid. Rows = states, columns = sizes. Only the three states the trigger actually renders are shown: open/focus is derived internally and never passed in, so it has no cell of its own.',
|
|
146
|
+
},
|
|
147
|
+
},
|
|
148
|
+
},
|
|
149
|
+
render: () => <MatrixDemo />,
|
|
150
|
+
};
|
|
151
|
+
|
|
152
|
+
const MatrixDemo = () => {
|
|
153
|
+
const [value, setValue] = React.useState('CZK');
|
|
154
|
+
return (
|
|
155
|
+
<Showcase>
|
|
156
|
+
{STATES.map(state => (
|
|
157
|
+
<Section key={state} title={state} layout="row">
|
|
158
|
+
{SIZES.map(size => (
|
|
159
|
+
<div key={size} className="w-[calc(var(--space-1000)*6)]">
|
|
160
|
+
<Select
|
|
161
|
+
state={state}
|
|
162
|
+
size={size}
|
|
163
|
+
options={CURRENCIES}
|
|
164
|
+
value={value}
|
|
165
|
+
onValueChange={setValue}
|
|
166
|
+
aria-label="Měna"
|
|
167
|
+
/>
|
|
168
|
+
</div>
|
|
169
|
+
))}
|
|
170
|
+
</Section>
|
|
171
|
+
))}
|
|
172
|
+
</Showcase>
|
|
173
|
+
);
|
|
174
|
+
};
|
|
175
|
+
|
|
176
|
+
export const Sizes: Story = {
|
|
177
|
+
parameters: {
|
|
178
|
+
docs: {
|
|
179
|
+
description: {
|
|
180
|
+
story:
|
|
181
|
+
'Medium (48) — standard forms · Small (40) — dense rows, filter bars. The trigger size cascades to the panel rows (Medium rows for Medium, Small rows for Small). Pick by density and keep one size per form.',
|
|
182
|
+
},
|
|
183
|
+
},
|
|
184
|
+
},
|
|
185
|
+
render: () => <SizesDemo />,
|
|
186
|
+
};
|
|
187
|
+
|
|
188
|
+
const SizesDemo = () => {
|
|
189
|
+
const [a, setA] = React.useState('CZK');
|
|
190
|
+
const [b, setB] = React.useState('CZK');
|
|
191
|
+
return (
|
|
192
|
+
<Showcase>
|
|
193
|
+
<Section title="Medium (default)" layout="column">
|
|
194
|
+
<Frame>
|
|
195
|
+
<Select size="md" options={CURRENCIES} value={a} onValueChange={setA} aria-label="Měna" />
|
|
196
|
+
</Frame>
|
|
197
|
+
</Section>
|
|
198
|
+
<Section title="Small" layout="column">
|
|
199
|
+
<Frame>
|
|
200
|
+
<Select size="sm" options={CURRENCIES} value={b} onValueChange={setB} aria-label="Měna" />
|
|
201
|
+
</Frame>
|
|
202
|
+
</Section>
|
|
203
|
+
</Showcase>
|
|
204
|
+
);
|
|
205
|
+
};
|
|
206
|
+
|
|
207
|
+
export const States: Story = {
|
|
208
|
+
parameters: {
|
|
209
|
+
docs: {
|
|
210
|
+
description: {
|
|
211
|
+
story:
|
|
212
|
+
'The trigger states that Select actually renders — Default (with a placeholder), Error (border + `warning-circle` status icon; shown inside a `Field` with a matching message) and Disabled (border kept, `--disabled-background` fill, dimmed, not focusable). Open/focus is derived internally, never passed in.',
|
|
213
|
+
},
|
|
214
|
+
},
|
|
215
|
+
},
|
|
216
|
+
render: () => <StatesDemo />,
|
|
217
|
+
};
|
|
218
|
+
|
|
219
|
+
const StatesDemo = () => {
|
|
220
|
+
const [def, setDef] = React.useState('');
|
|
221
|
+
const [err, setErr] = React.useState('');
|
|
222
|
+
return (
|
|
223
|
+
<Showcase>
|
|
224
|
+
<Section title="Default" layout="column">
|
|
225
|
+
<Frame>
|
|
226
|
+
<Select options={CURRENCIES} value={def} onValueChange={setDef} placeholder="Vyberte měnu" aria-label="Měna" />
|
|
227
|
+
</Frame>
|
|
228
|
+
</Section>
|
|
229
|
+
<Section title="Error (in Field)" layout="column">
|
|
230
|
+
<Frame>
|
|
231
|
+
<Field label="Měna" error="Vyberte měnu">
|
|
232
|
+
<Select id="currency-err" options={CURRENCIES} value={err} onValueChange={setErr} state="error" placeholder="Vyberte měnu" />
|
|
233
|
+
</Field>
|
|
234
|
+
</Frame>
|
|
235
|
+
</Section>
|
|
236
|
+
<Section title="Disabled" layout="column">
|
|
237
|
+
<Frame>
|
|
238
|
+
<Select options={CURRENCIES} value="CZK" disabled aria-label="Měna" />
|
|
239
|
+
</Frame>
|
|
240
|
+
</Section>
|
|
241
|
+
</Showcase>
|
|
242
|
+
);
|
|
243
|
+
};
|
|
244
|
+
|
|
245
|
+
export const WithField: Story = {
|
|
246
|
+
parameters: {
|
|
247
|
+
docs: {
|
|
248
|
+
description: {
|
|
249
|
+
story:
|
|
250
|
+
'Real usage — wrapped in `Field` for the floating label, helper and error messaging. A Select label **always floats to the top** (Select is in `Field`’s auto-float list): the label lives on the top border (hidden when empty, with a placeholder shown inside), it never rests inside. `Field` injects `error`/`aria-invalid`/`aria-describedby` and reads `onOpenChange` for the label focus state.',
|
|
251
|
+
},
|
|
252
|
+
},
|
|
253
|
+
},
|
|
254
|
+
render: () => <WithFieldDemo />,
|
|
255
|
+
};
|
|
256
|
+
|
|
257
|
+
const WithFieldDemo = () => {
|
|
258
|
+
const [filled, setFilled] = React.useState('CZK');
|
|
259
|
+
const [empty, setEmpty] = React.useState('');
|
|
260
|
+
const [err, setErr] = React.useState('');
|
|
261
|
+
return (
|
|
262
|
+
<Showcase>
|
|
263
|
+
<Section title="Editable" layout="column">
|
|
264
|
+
<Frame>
|
|
265
|
+
<Field label="Měna" helperText="Použije se pro všechny položky faktury">
|
|
266
|
+
<Select id="currency" options={CURRENCIES} value={filled} onValueChange={setFilled} placeholder="Vyberte měnu" />
|
|
267
|
+
</Field>
|
|
268
|
+
</Frame>
|
|
269
|
+
<Frame>
|
|
270
|
+
<Field label="Měna">
|
|
271
|
+
<Select id="currency-empty" options={CURRENCIES} value={empty} onValueChange={setEmpty} placeholder="Vyberte měnu" />
|
|
272
|
+
</Field>
|
|
273
|
+
</Frame>
|
|
274
|
+
<Frame>
|
|
275
|
+
<Field label="Měna" error="Vyberte měnu">
|
|
276
|
+
<Select id="currency-err2" options={CURRENCIES} value={err} onValueChange={setErr} state="error" placeholder="Vyberte měnu" />
|
|
277
|
+
</Field>
|
|
278
|
+
</Frame>
|
|
279
|
+
</Section>
|
|
280
|
+
</Showcase>
|
|
281
|
+
);
|
|
282
|
+
};
|
|
283
|
+
|
|
284
|
+
export const LongList: Story = {
|
|
285
|
+
name: 'Long list (scroll)',
|
|
286
|
+
parameters: {
|
|
287
|
+
docs: {
|
|
288
|
+
description: {
|
|
289
|
+
story:
|
|
290
|
+
'A long option set (18 countries). The panel height is soft-capped, so the list scrolls inside the body rather than running off-screen — with collision flip/shift keeping it in the viewport. Typeahead jumps to a matching label; Home/End reach the ends.',
|
|
291
|
+
},
|
|
292
|
+
},
|
|
293
|
+
},
|
|
294
|
+
render: () => <LongListDemo />,
|
|
295
|
+
};
|
|
296
|
+
|
|
297
|
+
const LongListDemo = () => {
|
|
298
|
+
const [value, setValue] = React.useState('cz');
|
|
299
|
+
return (
|
|
300
|
+
<Showcase>
|
|
301
|
+
<Section title="Country" layout="column">
|
|
302
|
+
<Frame>
|
|
303
|
+
<Field label="Země">
|
|
304
|
+
<Select id="country" options={COUNTRIES} value={value} onValueChange={setValue} placeholder="Vyberte zemi" />
|
|
305
|
+
</Field>
|
|
306
|
+
</Frame>
|
|
307
|
+
</Section>
|
|
308
|
+
</Showcase>
|
|
309
|
+
);
|
|
310
|
+
};
|
|
311
|
+
|
|
312
|
+
export const WithDisabledOption: Story = {
|
|
313
|
+
parameters: {
|
|
314
|
+
docs: {
|
|
315
|
+
description: {
|
|
316
|
+
story:
|
|
317
|
+
'A single option marked `disabled: true` — it is dimmed and skipped by keyboard navigation (↑ ↓ step over it, it cannot be selected). Here "Osvobozeno od DPH" is non-selectable.',
|
|
318
|
+
},
|
|
319
|
+
},
|
|
320
|
+
},
|
|
321
|
+
render: () => <WithDisabledOptionDemo />,
|
|
322
|
+
};
|
|
323
|
+
|
|
324
|
+
const WithDisabledOptionDemo = () => {
|
|
325
|
+
const options: SelectOption[] = VAT_RATES.map(o =>
|
|
326
|
+
o.value === 'osvobozeno' ? { ...o, disabled: true } : o,
|
|
327
|
+
);
|
|
328
|
+
const [value, setValue] = React.useState('21');
|
|
329
|
+
return (
|
|
330
|
+
<Showcase>
|
|
331
|
+
<Section title="VAT rate" layout="column">
|
|
332
|
+
<Frame>
|
|
333
|
+
<Field label="Sazba DPH">
|
|
334
|
+
<Select id="vat-rate" options={options} value={value} onValueChange={setValue} placeholder="Vyberte sazbu" />
|
|
335
|
+
</Field>
|
|
336
|
+
</Frame>
|
|
337
|
+
</Section>
|
|
338
|
+
</Showcase>
|
|
339
|
+
);
|
|
340
|
+
};
|
|
341
|
+
|
|
342
|
+
export const Units: Story = {
|
|
343
|
+
parameters: {
|
|
344
|
+
docs: { description: { story: 'A short units set — a compact fixed list, a typical dense-row Select.' } },
|
|
345
|
+
},
|
|
346
|
+
render: () => <UnitsDemo />,
|
|
347
|
+
};
|
|
348
|
+
|
|
349
|
+
const UnitsDemo = () => {
|
|
350
|
+
const [value, setValue] = React.useState('ks');
|
|
351
|
+
return (
|
|
352
|
+
<Showcase>
|
|
353
|
+
<Section title="Unit" layout="column">
|
|
354
|
+
<Frame>
|
|
355
|
+
<Select size="sm" options={UNITS} value={value} onValueChange={setValue} aria-label="Jednotka" />
|
|
356
|
+
</Frame>
|
|
357
|
+
</Section>
|
|
358
|
+
</Showcase>
|
|
359
|
+
);
|
|
360
|
+
};
|
|
361
|
+
|
|
362
|
+
/** A 390 viewport — below `sm`, where the list opens as the mobile bottom sheet. */
|
|
363
|
+
const MOBILE_VIEWPORTS = {
|
|
364
|
+
// fods-lint-disable-next-line Storybook viewport preset: the 390 mobile exhibit width, not a design value
|
|
365
|
+
mobile: { name: 'Below sm · 390', styles: { width: '390px', height: '844px' } },
|
|
366
|
+
};
|
|
367
|
+
|
|
368
|
+
const MobileSheetDemo = () => {
|
|
369
|
+
const [currency, setCurrency] = React.useState('CZK');
|
|
370
|
+
const [country, setCountry] = React.useState('');
|
|
371
|
+
return (
|
|
372
|
+
<div className="flex flex-col gap-600 p-600">
|
|
373
|
+
<Field label="Měna">
|
|
374
|
+
<Select id="currency-sheet" options={CURRENCIES} value={currency} onValueChange={setCurrency} placeholder="Vyberte měnu" />
|
|
375
|
+
</Field>
|
|
376
|
+
<Field label="Země">
|
|
377
|
+
<Select
|
|
378
|
+
id="country-sheet"
|
|
379
|
+
options={COUNTRIES}
|
|
380
|
+
value={country}
|
|
381
|
+
onValueChange={setCountry}
|
|
382
|
+
placeholder="Vyberte zemi"
|
|
383
|
+
sheetTitle="Země odběratele"
|
|
384
|
+
/>
|
|
385
|
+
</Field>
|
|
386
|
+
</div>
|
|
387
|
+
);
|
|
388
|
+
};
|
|
389
|
+
|
|
390
|
+
export const MobileSheet: Story = {
|
|
391
|
+
name: 'Mobile — bottom sheet',
|
|
392
|
+
parameters: {
|
|
393
|
+
layout: 'fullscreen',
|
|
394
|
+
viewport: { options: MOBILE_VIEWPORTS },
|
|
395
|
+
docs: {
|
|
396
|
+
description: {
|
|
397
|
+
story:
|
|
398
|
+
'Below `sm` (640 viewport) the options open as a **bottom sheet** (select-field 1.8.0): grab handle, centred title (the field label, or `sheetTitle` when the label is abbreviated), List Row Mobile rows with the trailing check in `--secondary` (list-row 2.7.0). The sheet is a modal `dialog` named by its title; focus lands on the selected row (roving, inset ring); drag down, the scrim, Esc or the hidden «Zavřít» close it and focus returns to the field. Open the story in the canvas — the docs column is wider than `sm`.',
|
|
399
|
+
},
|
|
400
|
+
},
|
|
401
|
+
},
|
|
402
|
+
globals: { viewport: { value: 'mobile' } },
|
|
403
|
+
render: () => <MobileSheetDemo />,
|
|
404
|
+
};
|