@invoiceonline/ui-react 0.0.0 → 0.2.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 +100 -0
- package/CHANGELOG.md +149 -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-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 +119 -0
- package/dist/components/field/Field.js +332 -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 +210 -0
- package/dist/components/field-pair/FieldPair.js +335 -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 +160 -0
- package/dist/components/text-field/TextField.js +244 -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 +130 -0
- package/dist/index.js +74 -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.d.ts +60 -0
- package/dist/internal/useDateFieldTrigger.js +235 -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 +44 -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 +396 -0
- package/docs/Contributing.mdx +78 -0
- package/docs/ForAgents.mdx +53 -0
- package/docs/Introduction.mdx +54 -0
- package/llms.txt +550 -0
- package/package.json +347 -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-picker/DatePicker.mdx +440 -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 +787 -0
- package/src/components/field/index.ts +20 -0
- package/src/components/field-pair/FieldPair.mdx +312 -0
- package/src/components/field-pair/FieldPair.stories.tsx +539 -0
- package/src/components/field-pair/FieldPair.tsx +845 -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 +699 -0
- package/src/components/text-field/TextField.stories.tsx +674 -0
- package/src/components/text-field/TextField.tsx +645 -0
- package/src/components/text-field/index.ts +11 -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 +70 -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 +497 -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 +57 -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 +360 -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,662 @@
|
|
|
1
|
+
import { Meta, Canvas, Controls } from '@storybook/addon-docs/blocks';
|
|
2
|
+
import * as CardSelectStories from './CardSelect.stories';
|
|
3
|
+
|
|
4
|
+
<Meta of={CardSelectStories} tags={['autodocs']} />
|
|
5
|
+
|
|
6
|
+
# CardSelect
|
|
7
|
+
|
|
8
|
+
## Metadata
|
|
9
|
+
|
|
10
|
+
- **Layer:** atom
|
|
11
|
+
- **Status:** draft
|
|
12
|
+
- **Tokens used:** `--bg-hover`, `--bg-primary`, `--border-width-100`, `--border-width-200`, `--disabled-control`, `--disabled-foreground`, `--font-size-base`, `--font-size-xs`, `--font-weight-normal`, `--font-weight-semibold`, `--leading-loose`, `--leading-relaxed`, `--outline-default`, `--outline-focus`, `--outline-strong`, `--radius-500`, `--radius-full`, `--secondary`, `--secondary-solid`, `--secondary-subtle`, `--size-illustration-card`, `--space-200`, `--space-400`, `--space-500`, `--space-600`, `--space-900`, `--status-danger-hover`, `--status-danger-soft`, `--status-danger-subtle`, `--status-danger-subtle-border`, `--status-danger-tint-foreground`, `--text-primary`, `--text-secondary`, `--text-wrap-body`
|
|
13
|
+
- **Manifest version:** `3.0.3`
|
|
14
|
+
|
|
15
|
+
## Overview
|
|
16
|
+
|
|
17
|
+
CardSelect is the **whole-card selection control** — a card the user picks with a click, with a
|
|
18
|
+
media slot (icon or illustration), a semibold label and an optional subtitle, laid out **Stacked**
|
|
19
|
+
(media on top), **Horizontal** (media left) or **Option** (a leading radio, no media). Selection
|
|
20
|
+
shows as a `--secondary` (brand-blue) border and a top-right `--secondary` check-circle on a
|
|
21
|
+
`--bg-primary` disc (in Option: the selected leading radio), over a `--secondary-subtle` fill. It is `Radio` / `Checkbox` wearing a card: reach for it when a choice needs
|
|
22
|
+
**more than a bare label** to be made — a visual plus a line of description — inside a dialog or a
|
|
23
|
+
wizard step. Typical usages (manifest `intent.whenToUse`) are an authentication-method or two-factor
|
|
24
|
+
picker, a tax-mode or tax-band tile, a correction-type choice and, as **Option**, the choice of which
|
|
25
|
+
firm a mailbox connects to.
|
|
26
|
+
|
|
27
|
+
**It always ships as a group.** `CardSelect` is rendered inside a `CardSelectGroup`, which owns the
|
|
28
|
+
selection and carries the question as its accessible name — a lone card is a modelling bug.
|
|
29
|
+
|
|
30
|
+
**Do NOT use it** for a plain option list with no description (that is `Radio` for one-of,
|
|
31
|
+
`Checkbox` for many), for more than ~6 options (`Select`), for a single binary on/off (`Checkbox`),
|
|
32
|
+
or for a card that carries **its own action button plus a benefit list** — that is the
|
|
33
|
+
comparison-card, a separate pattern whose selection lives on a Button, and nesting a button or a link
|
|
34
|
+
inside the card's `<label>` is forbidden by both the spec and the roving radiogroup (see
|
|
35
|
+
[Accessibility](#accessibility)) — a follow-up link or field lives only in **Details**, outside the
|
|
36
|
+
label.
|
|
37
|
+
|
|
38
|
+
Two optional slots extend it (3.0.0): a recommendation **Badge** on the top border (every layout) and
|
|
39
|
+
**Details** — an Alert or plain text — that opens under the **selected** card (Stacked and Option).
|
|
40
|
+
|
|
41
|
+
<Canvas of={CardSelectStories.Playground} />
|
|
42
|
+
|
|
43
|
+
## Rationale
|
|
44
|
+
|
|
45
|
+
The upstream spec promotes the pattern to a named atom for three reasons, and the React
|
|
46
|
+
implementation follows each of them:
|
|
47
|
+
|
|
48
|
+
- **One whole-card control.** This atom is the **whole-card** model only; the comparison card is
|
|
49
|
+
deliberately kept apart.
|
|
50
|
+
- **It settles the selection language.** Selection is a `--secondary` border plus a `--secondary`
|
|
51
|
+
corner check-circle on a `--secondary-subtle` fill. The border uses the colored-border role
|
|
52
|
+
`--secondary`, never the focus-ring token `--outline-focus`, so the two roles stay clean.
|
|
53
|
+
- **It flexes through one Layout axis and content properties** — `layout` (Stacked · Horizontal ·
|
|
54
|
+
Option),
|
|
55
|
+
an optional media slot, an optional subtitle — rather than a spray of variants; text is always
|
|
56
|
+
left-aligned (a centred tile is an instance override, not a prop), and it
|
|
57
|
+
carries **no in-card tooltip**: supplementary text lives in the subtitle, which keeps the
|
|
58
|
+
one-tab-stop radiogroup free of an unreachable focusable ⓘ.
|
|
59
|
+
|
|
60
|
+
Two implementation decisions are worth stating here, because they are contract, not style:
|
|
61
|
+
|
|
62
|
+
- **`CardSelect` and `CardSelectGroup` are two components.** The group provides `name`, the selected
|
|
63
|
+
`value` and the shared `layout` / `tone` / `disabled` through `CardSelectGroupContext`; the
|
|
64
|
+
card reads them and falls back to its own props. The group also enforces its accessible name **at
|
|
65
|
+
the TypeScript level** (a union of `aria-label` or `aria-labelledby`, never neither), because
|
|
66
|
+
axe-core sets `accessibleNameRequired: false` on `radiogroup` and would report nothing.
|
|
67
|
+
- **Selection and colour family are derived, not props.** Selection resolves as `checked` › the
|
|
68
|
+
group's `value` › the component's own state seeded from `defaultChecked`; the family is computed
|
|
69
|
+
from `tone` plus that selection. See [Variants](#variants).
|
|
70
|
+
|
|
71
|
+
## Anatomy
|
|
72
|
+
|
|
73
|
+
Layout decides how the parts are arranged — `layout="stacked"` (default): media on top, the text
|
|
74
|
+
block below it; `layout="horizontal"`: media left, the text block right, items vertically centred;
|
|
75
|
+
`layout="option"`: a leading radio left, the text block right, vertically centred — no media and no
|
|
76
|
+
corner check. Text is left-aligned in all three.
|
|
77
|
+
|
|
78
|
+
- **Root** — a `div` (the spec's `div.card-select`, 3.0.1) wrapping the hit area, the Badge and
|
|
79
|
+
Details. It owns the chrome (fill, a `--border-width-100` inset border, radius) and the focus ring,
|
|
80
|
+
and does not clip, because the Badge protrudes above it. Every state selector on it targets the
|
|
81
|
+
card's **own** input (`data-card-select-input`), never a field inside Details. Emits
|
|
82
|
+
`data-fods-component="card-select"`, `data-fods-part="root"` plus `data-fods-family`.
|
|
83
|
+
- **Hit area** — the `<label>` inside the root, so the card's content is the hit target *and* the
|
|
84
|
+
accessible name of its input. It carries the padding and the media→content gap, and it alone
|
|
85
|
+
triggers the hover wash: hovering Details does not wash the card. It grows to fill the root, so a
|
|
86
|
+
stretched card in a row stays clickable edge to edge. Emits `data-fods-part="hit-area"`.
|
|
87
|
+
- **Input** — a native `<input type="radio">`, visually hidden with `sr-only` (never `display: none`
|
|
88
|
+
/ `hidden`, which would take it out of the tab order and kill the focus ring). Selection, keyboard
|
|
89
|
+
and the checked state all come from it.
|
|
90
|
+
- **Media** — holding its content directly (no wrapper, **0 vertical padding in every
|
|
91
|
+
layout**). One nullable prop with two accepted contents: an `IconName` renders an `Icon` glyph
|
|
92
|
+
(24), or a `React.ReactElement` renders an illustration in an **80×80** box, greyed
|
|
93
|
+
with `grayscale` when disabled. Omitting the prop (`Show media` off) renders nothing — valid in
|
|
94
|
+
Stacked and Horizontal since 2.3.1. Layout=Option has no media; the prop is ignored there.
|
|
95
|
+
- **Label** — the choice name, `--font-weight-semibold`, `--font-size-base` (Body/M), clamped to 2
|
|
96
|
+
lines.
|
|
97
|
+
- **Subtitle** *(optional)* — `--font-size-xs` (Body/XS, `sizes[].runTextStyles.subtitle`) at
|
|
98
|
+
`--font-weight-normal`, clamped to 2 lines. **This is where supplementary help lives.**
|
|
99
|
+
- **Check** — the `check-circle` glyph (24, the icon-size step) on a `--bg-primary` disc
|
|
100
|
+
(`--radius-full`), absolutely positioned at the top right, inset `--space-600` and
|
|
101
|
+
**centred on the media's axis**. It needs no offset table for that: it keeps its flex *static
|
|
102
|
+
position*, so in Stacked it is rendered inside the `items-center` media container (centred on a 24
|
|
103
|
+
icon and an 80 illustration alike), and in Horizontal inside the `items-center` card. A Stacked
|
|
104
|
+
card **without media** centres it on the **label's first line** instead: the check sits at the top
|
|
105
|
+
of the `items-start` card, level with the label, whose first line is 24 high (Body/M, 16 × 1.5) —
|
|
106
|
+
an exact match. Not rendered in Option. Rendered **only when selected** — the primary, NON-COLOUR selection cue (WCAG 1.4.1). In Horizontal,
|
|
107
|
+
and in a Stacked card without media, the text block reserves `--space-900` on the right, so the
|
|
108
|
+
check never overlaps the text and selecting never reflows the card.
|
|
109
|
+
- **Leading control** *(Option only)* — the card's own native input, shown as a Radio md (20) box and
|
|
110
|
+
dot. It is not a second control: the box and dot come from `radioVariants` and react to the input
|
|
111
|
+
through `peer-*`. Two deliberate overrides — Selected · Hover renders as Selected · Default, and the
|
|
112
|
+
box draws no focus ring of its own (the card carries the one ring). Emits
|
|
113
|
+
`data-fods-part="leading-control"`.
|
|
114
|
+
- **Trailing** *(Option only, optional)* — a status `Badge` with its icon at the end of the label
|
|
115
|
+
line (`2 dodavatelé` · `Jiné DIČ` · `Nová`): the label fills, the slot hugs, centred on the label
|
|
116
|
+
line, gap `--space-400`. It sits **inside** the label, so it is part of the accessible name, and it
|
|
117
|
+
keeps its own colours on a Disabled card — it says why the card cannot be chosen. Emits
|
|
118
|
+
`data-fods-part="trailing"`.
|
|
119
|
+
- **Badge** *(optional, every layout)* — a recommendation `Badge` with its icon (Info · **Solid** · sm,
|
|
120
|
+
`Doporučeno`; the Figma examples — the manifest default says Soft, which on a
|
|
121
|
+
Selected card is the same `--ds-blue-100` as the card fill) on the **top border**: a strip inset `--space-600` on both sides whose vertical centre
|
|
122
|
+
sits on the border, so the Badge protrudes by half its height and never moves the content.
|
|
123
|
+
`badgeAlign` places it `start` (default) · `center` · `end`; it never covers the check-circle, so
|
|
124
|
+
Stacked and Horizontal do not take `end`. It sits **outside** the label and is announced as the
|
|
125
|
+
input's description. Emits `data-fods-part="badge"`.
|
|
126
|
+
- **Details** *(optional; Stacked and Option, Selected only)* — an `Alert` (Info, no title, no
|
|
127
|
+
action, no `live`) or plain text after the label, rendered **only on the Selected card**. Stacked:
|
|
128
|
+
the content width; Option: inset `--space-900` to line up with the text column. The row↔details
|
|
129
|
+
gap `--space-400` is the label's bottom padding, so it still selects. Being outside the label, a
|
|
130
|
+
link or a field inside it is a control of its own. Emits `data-fods-part="details"`.
|
|
131
|
+
- **Group** — the `CardSelectGroup` wrapper: `role="radiogroup"`, a flex column (or row with
|
|
132
|
+
`orientation="horizontal"`) at a `--space-400` gap — a group where any card has a Badge needs at least
|
|
133
|
+
half the badge height (Badge sm 22 → `className="gap-500"`). It carries no `data-fods-*` attributes, since it
|
|
134
|
+
is not a part of the `card-select` manifest.
|
|
135
|
+
|
|
136
|
+
The label↔subtitle gap is `--space-200` (`sizes[].textGap`). Height hugs the content (the manifest
|
|
137
|
+
states none, so no `h-*` class is emitted); the card is `w-full` and fills whatever track the group
|
|
138
|
+
gives it.
|
|
139
|
+
|
|
140
|
+
## Variants
|
|
141
|
+
|
|
142
|
+
<Canvas of={CardSelectStories.Matrix} />
|
|
143
|
+
|
|
144
|
+
The colour axis is **one combined `family` variant with four values** — Tone × Selection — derived in
|
|
145
|
+
the component from `tone` plus the resolved selection and never a public prop. Why one combined axis
|
|
146
|
+
rather than `tone` × `selected` as two recipe selectors: a family that needs TWO keys cannot be
|
|
147
|
+
written into `data-fods-family`, which carries a single value, and the runtime pass then
|
|
148
|
+
could not grade any family's interaction states. Hover is a real difference in three of the four
|
|
149
|
+
families, so leaving it ungraded would strip the interaction DoD of its only mechanical support.
|
|
150
|
+
|
|
151
|
+
<table>
|
|
152
|
+
<thead>
|
|
153
|
+
<tr><th>Family (<code>data-fods-family</code>)</th><th>Rendered by</th><th>Rest tokens</th></tr>
|
|
154
|
+
</thead>
|
|
155
|
+
<tbody>
|
|
156
|
+
<tr>
|
|
157
|
+
<td><code>unselected</code></td>
|
|
158
|
+
<td><code>tone="default"</code>, not selected</td>
|
|
159
|
+
<td>fill <code>--bg-primary</code>, border <code>--outline-strong</code> at <code>--border-width-100</code>, label <code>--text-primary</code>, subtitle <code>--text-secondary</code>, media <code>--secondary</code>, no checkmark</td>
|
|
160
|
+
</tr>
|
|
161
|
+
<tr>
|
|
162
|
+
<td><code>selected</code></td>
|
|
163
|
+
<td><code>tone="default"</code>, selected</td>
|
|
164
|
+
<td>fill <code>--secondary-subtle</code>, border <code>--secondary</code>, label <code>--text-primary</code>, subtitle <code>--text-secondary</code>, media <code>--secondary</code>, check-circle <code>--secondary</code> on a <code>--bg-primary</code> disc</td>
|
|
165
|
+
</tr>
|
|
166
|
+
<tr>
|
|
167
|
+
<td><code>danger-unselected</code></td>
|
|
168
|
+
<td><code>tone="danger"</code> (<strong>deprecated</strong>), not selected</td>
|
|
169
|
+
<td>a completely <strong>neutral box</strong> — fill <code>--bg-primary</code>, border <code>--outline-strong</code> — with red only in the ink: label and media <code>--status-danger-tint-foreground</code>, subtitle <code>--text-secondary</code></td>
|
|
170
|
+
</tr>
|
|
171
|
+
<tr>
|
|
172
|
+
<td><code>danger-selected</code></td>
|
|
173
|
+
<td><code>tone="danger"</code> (<strong>deprecated</strong>), selected</td>
|
|
174
|
+
<td>fill <code>--status-danger-subtle</code>, border <code>--status-danger-subtle-border</code>, label, subtitle, media and checkmark all <code>--status-danger-tint-foreground</code></td>
|
|
175
|
+
</tr>
|
|
176
|
+
</tbody>
|
|
177
|
+
</table>
|
|
178
|
+
|
|
179
|
+
<Canvas of={CardSelectStories.Tone} />
|
|
180
|
+
|
|
181
|
+
`tone="danger"` is **deprecated** since manifest 2.0.0 — do not build new work on it. It has no Option cells:
|
|
182
|
+
with `layout="option"` the component ignores the tone and renders Tone=Default. What it
|
|
183
|
+
recolours is deliberately narrow: the ink runs one ladder across both selections, and an Unselected
|
|
184
|
+
danger card keeps a neutral box. Only Selected tints the fill.
|
|
185
|
+
|
|
186
|
+
The danger Selected/Default **subtitle** is the one cell that joins the tinted ink
|
|
187
|
+
(`--status-danger-tint-foreground`); every other danger subtitle, including Selected/Hover, stays
|
|
188
|
+
`--text-secondary`.
|
|
189
|
+
|
|
190
|
+
<Canvas of={CardSelectStories.Layout} />
|
|
191
|
+
|
|
192
|
+
`layout` replaced the old `align` in 2.0.0. **Stacked** (default) puts the media on top, left-aligned
|
|
193
|
+
with the text; **Horizontal** puts the media left and the text right, vertically centred, with the
|
|
194
|
+
text block reserving `--space-900` for the check (as does a Stacked card without media). **Option**
|
|
195
|
+
(3.0.0) shows the card's own input as a leading radio, vertically centred with the text block, with
|
|
196
|
+
the Horizontal padding and gap; there is no media and no corner check, so nothing is reserved on the
|
|
197
|
+
right. Use it for a list of entities to pick one of (firms, accounts); a new record (*Nová firma*) is
|
|
198
|
+
one more Option, and the footer button relabels by the selection — a card never opens anything
|
|
199
|
+
itself. Text is always left-aligned — a centred tile is an instance override in the consuming layout
|
|
200
|
+
(`className`), not a prop. Use one `layout` per group.
|
|
201
|
+
|
|
202
|
+
<Canvas of={CardSelectStories.Media} />
|
|
203
|
+
|
|
204
|
+
The media prop is typed `IconName | React.ReactElement | null` — a `ReactNode` would subsume `string`
|
|
205
|
+
and silently type-check a non-existent icon name, so the union narrows on `typeof media === 'string'`
|
|
206
|
+
with no cast and no invalid-name hole. The illustration branch takes an element from the caller
|
|
207
|
+
because Illustrations are raster assets (`Illustration / Spot`), not components; the card gives it an
|
|
208
|
+
80×80 box and the element should fill it (`size-full`).
|
|
209
|
+
|
|
210
|
+
<Canvas of={CardSelectStories.BadgeSlot} />
|
|
211
|
+
|
|
212
|
+
`badge` takes the Badge element; `badgeAlign` is the screen's choice of its horizontal place. Keep a
|
|
213
|
+
recommendation here and a record's status in `trailing` (Option).
|
|
214
|
+
|
|
215
|
+
<Canvas of={CardSelectStories.Details} />
|
|
216
|
+
|
|
217
|
+
`details` is progressive disclosure: the selection, not a separate toggle, opens it, and it moves
|
|
218
|
+
with the selection. `layout="horizontal"` has no Details — the prop is ignored there.
|
|
219
|
+
|
|
220
|
+
<Canvas of={CardSelectStories.DetailsInteractive} />
|
|
221
|
+
|
|
222
|
+
A link or a field in Details is operable on its own: clicking or typing in it never changes the
|
|
223
|
+
selection, and the card's state never reacts to it.
|
|
224
|
+
|
|
225
|
+
## Sizes
|
|
226
|
+
|
|
227
|
+
<Canvas of={CardSelectStories.Sizes} />
|
|
228
|
+
|
|
229
|
+
<table>
|
|
230
|
+
<thead>
|
|
231
|
+
<tr><th>Layout</th><th>Padding (block / inline)</th><th>Main gap</th><th>Label↔subtitle</th></tr>
|
|
232
|
+
</thead>
|
|
233
|
+
<tbody>
|
|
234
|
+
<tr>
|
|
235
|
+
<td>Stacked</td>
|
|
236
|
+
<td><code>--space-600</code> (16) all sides</td>
|
|
237
|
+
<td>media↔text <code>--space-400</code></td>
|
|
238
|
+
<td><code>--space-200</code></td>
|
|
239
|
+
</tr>
|
|
240
|
+
<tr>
|
|
241
|
+
<td>Horizontal</td>
|
|
242
|
+
<td><code>--space-500</code> / <code>--space-600</code></td>
|
|
243
|
+
<td>media↔text <code>--space-500</code></td>
|
|
244
|
+
<td><code>--space-200</code></td>
|
|
245
|
+
</tr>
|
|
246
|
+
<tr>
|
|
247
|
+
<td>Option</td>
|
|
248
|
+
<td><code>--space-500</code> / <code>--space-600</code></td>
|
|
249
|
+
<td>radio↔text <code>--space-500</code></td>
|
|
250
|
+
<td><code>--space-200</code></td>
|
|
251
|
+
</tr>
|
|
252
|
+
</tbody>
|
|
253
|
+
</table>
|
|
254
|
+
|
|
255
|
+
**`md` is the only size** since manifest 3.0.0 (`sm` was removed).
|
|
256
|
+
`size="md"` stays accepted as a no-op (3.0.1). Radius `--radius-500` (12), label `--font-size-base`
|
|
257
|
+
(Body/M) Semibold, subtitle `--font-size-xs` (Body/XS) Regular; icon 24, check-circle 24, radio 20,
|
|
258
|
+
illustration 80×80. The check's right inset equals the inline padding (`--space-600`). Height hugs
|
|
259
|
+
the content. The per-layout numbers are `sizes[md].layouts` in the manifest.
|
|
260
|
+
|
|
261
|
+
## States
|
|
262
|
+
|
|
263
|
+
<Canvas of={CardSelectStories.States} />
|
|
264
|
+
|
|
265
|
+
<table>
|
|
266
|
+
<thead>
|
|
267
|
+
<tr><th>Family</th><th>Hover</th><th>Disabled</th></tr>
|
|
268
|
+
</thead>
|
|
269
|
+
<tbody>
|
|
270
|
+
<tr>
|
|
271
|
+
<td><code>unselected</code></td>
|
|
272
|
+
<td>fill <code>--bg-hover</code>; border stays <code>--outline-strong</code>; ink unchanged</td>
|
|
273
|
+
<td>fill <code>--disabled-control</code>, border <code>--outline-default</code>, all ink <code>--disabled-foreground</code>; an illustration renders <code>grayscale</code></td>
|
|
274
|
+
</tr>
|
|
275
|
+
<tr>
|
|
276
|
+
<td><code>selected</code></td>
|
|
277
|
+
<td><strong>identical to Default</strong> — the same <code>--secondary-subtle</code> fill and <code>--secondary</code> border</td>
|
|
278
|
+
<td>fill <code>--disabled-control</code>, border <code>--outline-default</code>, all ink incl. the check-circle <code>--disabled-foreground</code> (disc stays <code>--bg-primary</code>)</td>
|
|
279
|
+
</tr>
|
|
280
|
+
<tr>
|
|
281
|
+
<td><code>danger-unselected</code></td>
|
|
282
|
+
<td>the neutral box washes to <code>--bg-hover</code> (border stays <code>--outline-strong</code>) and the ink steps one rung to <code>--status-danger-hover</code>; subtitle stays <code>--text-secondary</code></td>
|
|
283
|
+
<td>same as the neutral families — a code contract in the manifest, no Figma cell</td>
|
|
284
|
+
</tr>
|
|
285
|
+
<tr>
|
|
286
|
+
<td><code>danger-selected</code></td>
|
|
287
|
+
<td>fill deepens <code>--status-danger-subtle</code> → <code>--status-danger-soft</code>, border strengthens to <code>--status-danger-tint-foreground</code>, label, media and checkmark step to <code>--status-danger-hover</code> — while the subtitle steps back to <code>--text-secondary</code></td>
|
|
288
|
+
<td>same as the neutral families — a code contract in the manifest, no Figma cell</td>
|
|
289
|
+
</tr>
|
|
290
|
+
</tbody>
|
|
291
|
+
</table>
|
|
292
|
+
|
|
293
|
+
- **Hover** is `has-[>label:hover]` on the root for fill and border — the spec's
|
|
294
|
+
`.card-select:has(> .card-select__label:hover)`, so only the label part washes the card and
|
|
295
|
+
hovering Details does not — and `group-hover` for the ink slots, keyed to the label: pointing
|
|
296
|
+
anywhere on the hit area must step the ink, not just pointing at the text. Neither is reachable by
|
|
297
|
+
a prop; the States story forces both statically.
|
|
298
|
+
- **Focus** is **not a variant**. It is the cross-cutting additive offset ring: `--outline-focus` at
|
|
299
|
+
`--border-width-200`, sitting 2px outside the card, never a border on it. It is painted as an
|
|
300
|
+
`outline` on the root under `has-[[data-card-select-input]:focus-visible]:` with a 2px
|
|
301
|
+
`outline-offset`, so its corners
|
|
302
|
+
follow the card radius grown by the offset (12 → ≈ 14) — no separate
|
|
303
|
+
ring-radius token, the same ring every FODS control uses. It cannot be a `peer-*` variant here: Tailwind compiles `peer-focus-visible:` to
|
|
304
|
+
`.peer:focus-visible ~ &`, a general-SIBLING combinator, and the input is a **descendant** of the
|
|
305
|
+
card — the rule could never match and the classes would be dead CSS. `:has()` is the same
|
|
306
|
+
relationship read the other way. The selector names the card's own input by its marker attribute,
|
|
307
|
+
not a bare `input`, so focusing a field inside Details rings the field and never the card. The root
|
|
308
|
+
is `isolate` and the Badge strip `-z-10` inside it, so the ring paints above the Badge, never under.
|
|
309
|
+
- **Disabled** is the only state prop. Greying is token-based (`--disabled-control` / `--disabled-foreground`),
|
|
310
|
+
never `opacity`, and it reaches the native input, which stops being operable and focusable. A
|
|
311
|
+
Selected + Disabled card **keeps its checkmark** in `--disabled-foreground` on the grey fill:
|
|
312
|
+
dropping it would leave selection carried by colour alone (WCAG 1.4.1) — and colour is exactly what
|
|
313
|
+
Disabled takes away. In Option the leading radio goes Disabled with the card (it is the same
|
|
314
|
+
input); a trailing Badge keeps its own colours. Details on a Disabled card is `inert`: nothing in it
|
|
315
|
+
can be focused or clicked.
|
|
316
|
+
- **There is no Active and no Error state on the card.** The manifest's state axis is Default ·
|
|
317
|
+
Hover, with Disabled declared per family. A required group validates with `aria-invalid`
|
|
318
|
+
plus helper text at the GROUP level, exactly like `RadioGroup`.
|
|
319
|
+
|
|
320
|
+
### Motion
|
|
321
|
+
|
|
322
|
+
Manifest 3.0.2 `motion`. The card's fill and border cross-fade on `--duration-toggle` /
|
|
323
|
+
`--easing-standard` when the selection changes, and the label, subtitle, media and check inks follow
|
|
324
|
+
on `--duration-hover` / `--easing-standard`. The hover wash of the card shares the toggle duration —
|
|
325
|
+
one transition rule on the root, because a separate hover duration would leak a hover class into the
|
|
326
|
+
Selected family (the States grid checks it). Details, on the newly Selected card, fades in over
|
|
327
|
+
`--duration-slow` / `--easing-enter` while its room opens: the room is the card's own `height`,
|
|
328
|
+
moving on `--spring-gentle` from the measured height to the new one and then back to `auto`, so the
|
|
329
|
+
cards below follow in the normal flow. Height, not a Motion `layout` transform, which would scale
|
|
330
|
+
the border, the radius and the focus ring (approved deviation `collapse-room-height`). On the card that
|
|
331
|
+
lost the selection, Details fades out over `--duration-fast` / `--easing-exit` first, is `inert`
|
|
332
|
+
while it fades, and is unmounted once the fade ends, so its links and fields leave the tab order;
|
|
333
|
+
the card holds its height meanwhile, and only then does the room close. The Stacked / Horizontal corner check-circle fades in on the same
|
|
334
|
+
fade and leaves at once. Changing the selection mid-way turns every movement around from where it
|
|
335
|
+
is. Nothing animates on the first render. Under `prefers-reduced-motion` the rooms open and close at
|
|
336
|
+
once and the fade shortens to `--duration-instant`.
|
|
337
|
+
|
|
338
|
+
<Canvas of={CardSelectStories.Motion} />
|
|
339
|
+
|
|
340
|
+
## API
|
|
341
|
+
|
|
342
|
+
<Controls />
|
|
343
|
+
|
|
344
|
+
Selection resolves in a fixed precedence: **`checked`** › the group's **`value`** › the component's
|
|
345
|
+
own state seeded from **`defaultChecked`**. The component needs it in JS, not only as `:checked` CSS,
|
|
346
|
+
because it decides whether the checkmark node exists at all and which family renders. `layout`,
|
|
347
|
+
`tone` and `disabled` resolve the same way: the card's own prop first, then the group's, then the
|
|
348
|
+
default (`stacked` / `default` / `false`). `tone="danger"` is ignored at `layout="option"`, and so are
|
|
349
|
+
`media` (Option has no media) and `trailing` outside Option. `size` accepts only `md` and changes
|
|
350
|
+
nothing (manifest 3.0.1).
|
|
351
|
+
|
|
352
|
+
`badge` (a Badge element) renders on every layout, placed by `badgeAlign` (`'start' | 'center' |
|
|
353
|
+
'end'`, type `CardSelectBadgeAlign`; `end` only in Option). `details` (an Alert or plain text) renders
|
|
354
|
+
only while the card is selected and never at `layout="horizontal"`. Both feed the input's
|
|
355
|
+
`aria-describedby`, merged after a caller's own value: the Badge always; Details only when it holds
|
|
356
|
+
no focusable content (a link or a field is read in tab order instead). States bind to the card's own
|
|
357
|
+
input only — a field in Details changes nothing on the card.
|
|
358
|
+
|
|
359
|
+
`CardSelectGroup` is a separate component, so its props are not in the table above:
|
|
360
|
+
|
|
361
|
+
<table>
|
|
362
|
+
<thead>
|
|
363
|
+
<tr><th>Prop</th><th>Type</th><th>Notes</th></tr>
|
|
364
|
+
</thead>
|
|
365
|
+
<tbody>
|
|
366
|
+
<tr>
|
|
367
|
+
<td><code>aria-label</code> / <code>aria-labelledby</code></td>
|
|
368
|
+
<td><code>string</code></td>
|
|
369
|
+
<td><strong>Required — exactly one of the two</strong>, enforced by a TypeScript union.</td>
|
|
370
|
+
</tr>
|
|
371
|
+
<tr>
|
|
372
|
+
<td><code>value</code> / <code>defaultValue</code></td>
|
|
373
|
+
<td><code>string</code></td>
|
|
374
|
+
<td><code>value</code> makes the group controlled; <code>defaultValue</code> seeds an uncontrolled one.</td>
|
|
375
|
+
</tr>
|
|
376
|
+
<tr>
|
|
377
|
+
<td><code>onValueChange</code></td>
|
|
378
|
+
<td><code>(value: string) => void</code></td>
|
|
379
|
+
<td>Called with the newly selected value.</td>
|
|
380
|
+
</tr>
|
|
381
|
+
<tr>
|
|
382
|
+
<td><code>name</code></td>
|
|
383
|
+
<td><code>string</code></td>
|
|
384
|
+
<td>Shared radio <code>name</code> tying the children into one native roving group; auto-generated when omitted.</td>
|
|
385
|
+
</tr>
|
|
386
|
+
<tr>
|
|
387
|
+
<td><code>layout</code> / <code>tone</code> / <code>disabled</code></td>
|
|
388
|
+
<td>as on the card</td>
|
|
389
|
+
<td>Inherited by every child through context. <code>size</code> (<code>'md'</code> only) is a no-op.</td>
|
|
390
|
+
</tr>
|
|
391
|
+
<tr>
|
|
392
|
+
<td><code>orientation</code></td>
|
|
393
|
+
<td><code>'vertical' | 'horizontal'</code></td>
|
|
394
|
+
<td>Flex direction; default <code>'vertical'</code>. Gap is <code>--space-400</code>.</td>
|
|
395
|
+
</tr>
|
|
396
|
+
</tbody>
|
|
397
|
+
</table>
|
|
398
|
+
|
|
399
|
+
## Do / Don't
|
|
400
|
+
|
|
401
|
+
- ✅ Always ship it inside a `CardSelectGroup` **with a group label** — a lone card-select is a
|
|
402
|
+
modelling bug; a single exclusive choice is a `Checkbox`.
|
|
403
|
+
- ✅ Let the group own the question ("Jak chcete ověřovat přihlášení?") and never repeat it in the
|
|
404
|
+
cards.
|
|
405
|
+
- ✅ Put supplementary help in the **subtitle**.
|
|
406
|
+
- ✅ Keep the label a short noun phrase (1–3 words, sentence case, no terminal period) — it clamps to
|
|
407
|
+
2 lines, so shorten instead of relying on the wrap.
|
|
408
|
+
- ✅ Use one `layout` per group; keep text left-aligned (centre a tile with an
|
|
409
|
+
instance override where a layout needs it).
|
|
410
|
+
- ✅ Use `tone="default"` for new work.
|
|
411
|
+
- ✅ Put a 24 icon or an 80×80 illustration straight into `media`.
|
|
412
|
+
- ✅ In Option, put a record's status in `trailing` as a Badge with its icon; add a new record
|
|
413
|
+
(*Nová firma*) as one more Option and let the footer button relabel by the selection.
|
|
414
|
+
- ✅ Put a recommendation in `badge`, clear of the check, and widen the group gap to at least half the
|
|
415
|
+
badge height.
|
|
416
|
+
- ✅ Put a longer note, a follow-up link or a field in `details` — it shows on the selected card only.
|
|
417
|
+
- ❌ Don't nest a button or a link inside the card's label — a card carrying its own CTA and a benefit
|
|
418
|
+
list is the comparison-card, a separate pattern; a follow-up link goes in `details`.
|
|
419
|
+
- ❌ Don't right-align the Badge (`badgeAlign="end"`) on a Stacked or Horizontal card — it would
|
|
420
|
+
cover the check-circle.
|
|
421
|
+
- ❌ Don't squeeze badged cards closer than half the badge height.
|
|
422
|
+
- ❌ Don't fake Details on an unselected card, or give an Alert in Details `live`, a title or an
|
|
423
|
+
action.
|
|
424
|
+
- ❌ Don't add an interactive ⓘ inside the card: a focusable tooltip trigger cannot live in a
|
|
425
|
+
one-tab-stop roving radiogroup.
|
|
426
|
+
- ❌ Don't signal selection by colour alone or invert the whole card — the checkmark is the cue.
|
|
427
|
+
- ❌ Don't start new work on `tone="danger"` — it is deprecated.
|
|
428
|
+
- ❌ Don't mix Stacked, Horizontal and Option cards in one group.
|
|
429
|
+
- ❌ Don't put a link or a button in `trailing` — it sits inside the card's `<label>`.
|
|
430
|
+
- ❌ Don't reach for CardSelect when the options need no description (`Radio` / `Checkbox`) or when
|
|
431
|
+
there are more than ~6 of them (`Select`).
|
|
432
|
+
- ❌ Don't override the chrome through `className` — every family × state pair is token-bound.
|
|
433
|
+
|
|
434
|
+
## Accessibility
|
|
435
|
+
|
|
436
|
+
- **Keyboard** — behaviour is **native**, from the shared radio `name`: the group is one tab stop,
|
|
437
|
+
arrow keys move the selection, Space selects. There is no custom key handling in the component and
|
|
438
|
+
therefore no roving tabindex to keep in sync. `disabled` removes a card from the tab order through
|
|
439
|
+
the native attribute on its input. Focusable content in the checked card's **Details** adds its own
|
|
440
|
+
tab stops after that radio: Tab enters Details, Shift+Tab returns, and the arrow keys inside a text
|
|
441
|
+
field there move the caret, not the selection.
|
|
442
|
+
- **ARIA** — the group renders `role="radiogroup"` and its accessible name is **required by the type
|
|
443
|
+
system** (`aria-label` or `aria-labelledby`), because axe-core sets `accessibleNameRequired: false`
|
|
444
|
+
on `radiogroup` and an optional prop would simply be left out. A `radiogroup` does not inherit a
|
|
445
|
+
name from an ancestor `<fieldset>` / `<legend>` either. Group-level validation attributes
|
|
446
|
+
(`aria-invalid`, `aria-describedby`) pass straight through to the group's root with the rest props.
|
|
447
|
+
A disabled card sets both the native `disabled` and `aria-disabled` on its input.
|
|
448
|
+
- **Screen reader** — the card IS the `<label>` of its input (`htmlFor`), so the accessible name is
|
|
449
|
+
the label plus the subtitle text; checked state is announced natively from the radio. Every glyph
|
|
450
|
+
goes through `Icon`, which always renders `aria-hidden="true"`, so the media and the checkmark are
|
|
451
|
+
decorative — the checkmark is the **visual** non-colour cue, not the announced one. In Option the
|
|
452
|
+
radio box and dot are `aria-hidden` drawings of the one native input, and the `trailing` Badge text
|
|
453
|
+
is read as part of the card's name. The top-border **Badge** is outside the label and is the input's
|
|
454
|
+
description (`aria-describedby`), so `Doporučeno` is announced without lengthening the name.
|
|
455
|
+
**Details** is outside the label too, so it is never part of the name: text-only Details is the
|
|
456
|
+
input's description; Details with links or fields is not referenced and is read in tab order. An
|
|
457
|
+
Alert in Details is plain content, not a live region, so arrowing through the group announces
|
|
458
|
+
nothing extra.
|
|
459
|
+
- **Contrast & motion** — the ratios below are quoted from the manifest's `notes` and the spec's
|
|
460
|
+
`## Accessibility` (computed against the main / red-v2 token values, which bind the same names).
|
|
461
|
+
Every danger **text** pairing clears the 4.5:1 floor: Unselected/Default ink
|
|
462
|
+
`--status-danger-tint-foreground` #c50000 on white = 6.22:1; Unselected/Hover ink
|
|
463
|
+
`--status-danger-hover` #ac0704 on the light `--bg-hover` wash is darker still; Selected/Default
|
|
464
|
+
label and subtitle #c50000 on `--status-danger-subtle` #ffebe8 = 5.42:1; Selected/Hover ink #ac0704
|
|
465
|
+
on `--status-danger-soft` #fed6cf = 5.65:1. The Selected/Hover border clears the 3:1 non-text floor
|
|
466
|
+
(6.22:1 on white, 4.66:1 on the `-soft` fill). The selected `--secondary` edge measures 5.93:1 on
|
|
467
|
+
white and 5.14:1 on its `--secondary-subtle` fill. The Unselected edge `--outline-strong` is 1.73:1
|
|
468
|
+
on `--bg-primary` — an accepted exception upstream (`accessibility.md`, "Card Select resting
|
|
469
|
+
edge"): the label, the media glyph and the Selected chrome carry the locator role. Disabled ink
|
|
470
|
+
`--disabled-foreground` on `--disabled-control` is 4.08:1 — WCAG exempts disabled controls anyway. One accepted limitation
|
|
471
|
+
remains, see [Known issues](#known-issues). `--outline-focus` shares its hue with the selected
|
|
472
|
+
`--secondary` border; the two are disambiguated by **shape and position** (an offset ring around the
|
|
473
|
+
whole card vs. an inset border plus a corner glyph). The focus ring never animates. The Details
|
|
474
|
+
reveal and the reflow of the cards below collapse to an instant change under
|
|
475
|
+
`prefers-reduced-motion`, and the fade shortens to `--duration-instant` (see [States](#states) →
|
|
476
|
+
Motion).
|
|
477
|
+
|
|
478
|
+
Accessibility floor for every FODS component: `spec/01-foundations/accessibility.md`.
|
|
479
|
+
|
|
480
|
+
## Known issues
|
|
481
|
+
|
|
482
|
+
- **Hover on the Default-tone `selected` family is legitimately identical to Default.** The manifest
|
|
483
|
+
binds the same `--secondary-subtle` fill and `--secondary` border in both states. On the two
|
|
484
|
+
Unselected families Hover only washes the fill — the border is `--outline-strong` at rest already.
|
|
485
|
+
- **The Horizontal / Option measurements are not statically graded.** They are structured in
|
|
486
|
+
`sizes[md].layouts` since 2.3.3, but the static grading does not read that field yet; the static pass
|
|
487
|
+
grades Stacked and the runtime pass carries the other two.
|
|
488
|
+
- **The group does not widen its gap for a Badge.** The spec asks for at least half the badge height
|
|
489
|
+
between cards when any card has one (Badge sm 22 → ≥ 11); the group default is `--space-400` (8),
|
|
490
|
+
so pass `gap-500` on the group yourself.
|
|
491
|
+
- **The hover wash is not gated on `(hover: hover)`.** It is a `:has(> label:hover)` selector on the
|
|
492
|
+
root, which Tailwind does not wrap in the hover media query, so on touch a tapped card may keep the
|
|
493
|
+
wash until the next tap. Tapping selects, and Selected has no hover step, so it shows only where
|
|
494
|
+
the tapped card stays Unselected.
|
|
495
|
+
- **The Badge's description does not repeat the subtitle.** The spec pairs the Badge id with the
|
|
496
|
+
subtitle id in `aria-describedby`; here the subtitle is already in the label's accessible name, so it
|
|
497
|
+
is not referenced a second time. There is no opt-out for a purely decorative Badge.
|
|
498
|
+
- **The check-circle size (24) comes from `slots.check` prose** — a
|
|
499
|
+
structured `sizes[].checkIcon` is an open upstream `backlog` item that needs a schema addition.
|
|
500
|
+
- **The check-circle is an `<Icon>` glyph on a disc of the same box.** The `check-circle` drawing's
|
|
501
|
+
circle fills ~0.81 em, so a thin `--bg-primary` rim of the disc
|
|
502
|
+
shows on the Selected tint.
|
|
503
|
+
- **Accepted a11y limitation, mirroring Figma:** the danger Selected/Default border
|
|
504
|
+
`--status-danger-subtle-border` #ffb7ac measures 1.66:1 against a white surround, under the 3:1
|
|
505
|
+
non-text floor — the check-circle and the `-subtle` fill carry selection there.
|
|
506
|
+
- **The group's layout model is unfinished upstream.** Responsive columns and equal-height cards are
|
|
507
|
+
an open manifest `backlog` item (`card-select-group`); until it lands, the group is the `RadioGroup`
|
|
508
|
+
precedent — a flex row/column at `--space-400`, with `w-full` cards filling whatever track they land
|
|
509
|
+
in.
|
|
510
|
+
- **The `type="checkbox"` many-of mode is not modelled yet.** `delivery.react` names it as a future
|
|
511
|
+
mode; the card is byte-identical there, so it stays a zero-cost later add.
|
|
512
|
+
|
|
513
|
+
## Copy
|
|
514
|
+
|
|
515
|
+
Voice: impersonal, clear, concise, specific, one word per concept. The examples are Czech; the rules
|
|
516
|
+
hold for every market mutation.
|
|
517
|
+
|
|
518
|
+
- **Label** (`label`, required) — a short noun or noun phrase naming the choice, parallel in form
|
|
519
|
+
across the group; sentence case, no terminal period, no command. 1–3 words, at most 40 characters.
|
|
520
|
+
It wraps to 2 lines at most (e.g. `Aplikacja uwierzytelniająca`), so shorten rather than let it
|
|
521
|
+
wrap.
|
|
522
|
+
- **Subtitle** (`subtitle`, optional) — one plain line on what the choice means or what follows from
|
|
523
|
+
it, at most 90 characters; it wraps to 2 lines at most. Supplementary help lives here, there is no
|
|
524
|
+
in-card tooltip. Description, not marketing.
|
|
525
|
+
- **Badge** (`badge` on the top border, `trailing` in Option) — one or two words, a recommendation
|
|
526
|
+
(top border) or a status (Trailing), sentence case, always with its icon.
|
|
527
|
+
- The **group** owns the question (`Jak chcete ověřovat?`); do not repeat it in each card.
|
|
528
|
+
|
|
529
|
+
<table>
|
|
530
|
+
<thead>
|
|
531
|
+
<tr><th>Run</th><th>Write</th><th>Don't write</th></tr>
|
|
532
|
+
</thead>
|
|
533
|
+
<tbody>
|
|
534
|
+
<tr><td>Label</td><td><code>Jen paušál</code> · <code>Paušál + DPH</code> · <code>Aplikacja uwierzytelniająca</code> (PL, wraps to 2 lines)</td><td><code>Vyberte si jen paušál</code></td></tr>
|
|
535
|
+
<tr><td>Badge</td><td><code>Odporúčané</code> · <code>Nová</code> · <code>2 dodávatelia</code> · <code>Iné DIČ</code></td><td><code>Najlepšia voľba!</code></td></tr>
|
|
536
|
+
<tr><td>Subtitle</td><td><code>Kód přijde na váš telefon</code> · <code>Google Authenticator, Authy apod.</code></td><td><code>Nejlepší volba pro každého podnikatele</code></td></tr>
|
|
537
|
+
</tbody>
|
|
538
|
+
</table>
|
|
539
|
+
|
|
540
|
+
## Usage
|
|
541
|
+
|
|
542
|
+
<Canvas of={CardSelectStories.Group} />
|
|
543
|
+
|
|
544
|
+
```tsx
|
|
545
|
+
import { CardSelect, CardSelectGroup } from '@invoiceonline/ui-react';
|
|
546
|
+
|
|
547
|
+
// Good — the group owns the question and the selection; the cards only carry choices
|
|
548
|
+
const [method, setMethod] = useState('sms');
|
|
549
|
+
|
|
550
|
+
<p id="two-factor-question">Jak chcete ověřovat přihlášení?</p>
|
|
551
|
+
<CardSelectGroup
|
|
552
|
+
aria-labelledby="two-factor-question"
|
|
553
|
+
value={method}
|
|
554
|
+
onValueChange={setMethod}
|
|
555
|
+
layout="horizontal"
|
|
556
|
+
>
|
|
557
|
+
<CardSelect value="sms" label="SMS" subtitle="Kód přijde na váš telefon" media="bell" />
|
|
558
|
+
<CardSelect
|
|
559
|
+
value="app"
|
|
560
|
+
label="Autentizační aplikace"
|
|
561
|
+
subtitle="Aplikace s ověřovacími kódy"
|
|
562
|
+
media="shield-check"
|
|
563
|
+
/>
|
|
564
|
+
</CardSelectGroup>
|
|
565
|
+
```
|
|
566
|
+
|
|
567
|
+
```tsx
|
|
568
|
+
// Don't — a lone card outside a group: no radiogroup, no group label, no shared name
|
|
569
|
+
<CardSelect value="sms" label="SMS" subtitle="Kód přijde na váš telefon" media="bell" />
|
|
570
|
+
|
|
571
|
+
// Don't — a nested control inside the card; that is the comparison-card pattern
|
|
572
|
+
<CardSelect value="app" label="Autentizační aplikace">
|
|
573
|
+
<Button variant="primary">Vybrat</Button>
|
|
574
|
+
</CardSelect>
|
|
575
|
+
|
|
576
|
+
// Don't — an interactive ⓘ in the card; supplementary help belongs in the subtitle
|
|
577
|
+
<CardSelect value="app" label="Autentizační aplikace" media="shield-check" />
|
|
578
|
+
<Tooltip content="Aplikace s ověřovacími kódy">…</Tooltip>
|
|
579
|
+
```
|
|
580
|
+
|
|
581
|
+
## Related
|
|
582
|
+
|
|
583
|
+
- [`Radio`](?path=/docs/design-system-atoms-radio--docs) and
|
|
584
|
+
[`RadioGroup`](?path=/docs/design-system-atoms-radiogroup--docs) — the plain one-of control this
|
|
585
|
+
atom dresses as a card; reach for them when the options need no description. `RadioGroup` is also
|
|
586
|
+
the layout and group-name precedent this component follows.
|
|
587
|
+
- [`Checkbox`](?path=/docs/design-system-atoms-checkbox--docs) — many-of, and the right control for a
|
|
588
|
+
single exclusive choice that would otherwise be a lone card.
|
|
589
|
+
- [`Select`](?path=/docs/design-system-organisms-select--docs) — past ~6 options.
|
|
590
|
+
- [`Modal`](?path=/docs/design-system-organisms-modal--docs) — the usual host: a dialog or a wizard
|
|
591
|
+
step.
|
|
592
|
+
- Spec: `spec/03-atoms/card-select.md`.
|
|
593
|
+
|
|
594
|
+
## Migration notes
|
|
595
|
+
|
|
596
|
+
**Manifest 3.0.2 → 3.0.3 (patch, documentation only).** `delivery.migration` records the waiver for
|
|
597
|
+
the 3.0.0 major: no consumer has a step to apply; the
|
|
598
|
+
Storybook, its only consumer, dropped `sm` at 3.0.1 (see the 2.3.1 → 3.0.1 table below). No code
|
|
599
|
+
change.
|
|
600
|
+
|
|
601
|
+
**Manifest 3.0.1 → 3.0.2 (patch, motion).** The card had no transition at all; it now cross-fades
|
|
602
|
+
fill and border on `--duration-toggle`, fades Details and the check-circle in and out, and moves the
|
|
603
|
+
cards below on `--spring-gentle` (see [States](#states) → Motion). No API change. The Details room
|
|
604
|
+
is the card's own height on `--spring-gentle`; `CardSelectGroup` needs no Motion `LayoutGroup`, the
|
|
605
|
+
cards below follow in the normal flow.
|
|
606
|
+
|
|
607
|
+
**Manifest 2.3.1 → 3.0.1 (major).**
|
|
608
|
+
|
|
609
|
+
<table>
|
|
610
|
+
<thead>
|
|
611
|
+
<tr><th>2.3.1</th><th>3.0.1</th></tr>
|
|
612
|
+
</thead>
|
|
613
|
+
<tbody>
|
|
614
|
+
<tr><td><code>size: 'md' | 'sm'</code> (card + group), <code>sm</code> deprecated</td><td><code>sm</code> <strong>removed</strong>; <code>size</code> accepts only <code>'md'</code> and is a no-op. No consumer set <code>sm</code>.</td></tr>
|
|
615
|
+
<tr><td><code>layout: 'stacked' | 'horizontal'</code></td><td>adds <strong><code>'option'</code></strong>: leading radio, no media, no check-circle, Horizontal padding and gap. <code>tone="danger"</code> is ignored there.</td></tr>
|
|
616
|
+
<tr><td>—</td><td><strong><code>trailing</code></strong> slot prop (Option only): a status Badge at the end of the label line.</td></tr>
|
|
617
|
+
<tr><td>—</td><td><strong><code>badge</code></strong> slot prop (every layout, on the top border, placed by <strong><code>badgeAlign</code></strong>) and <strong><code>details</code></strong> slot prop (Stacked and Option, Selected only, outside the <code><label></code>).</td></tr>
|
|
618
|
+
<tr><td>the card root is the <code><label></code></td><td>the root is a <code>div</code> owning the chrome; the <code><label></code> inside it (<code>data-fods-part="hit-area"</code>) owns hover, padding and the hit area. <code>className</code> still lands on the root. Visuals unchanged.</td></tr>
|
|
619
|
+
</tbody>
|
|
620
|
+
</table>
|
|
621
|
+
|
|
622
|
+
The 2.3.2 / 2.3.3 patches changed no value: the check note says 24, and the Horizontal numbers and
|
|
623
|
+
the subtitle style are structured (`sizes[].layouts`, `sizes[].runTextStyles`).
|
|
624
|
+
|
|
625
|
+
**Manifest 2.1.1 → 2.3.1 (one visual change, no API change).**
|
|
626
|
+
|
|
627
|
+
- **2.2.0** — the Selected check-circle is 24 (the icon-size step) at both sizes; `md` was 28, an
|
|
628
|
+
off-scale box. Visual change on `md` only (−4px); the position rules are unchanged.
|
|
629
|
+
- **2.1.2 / 2.1.3 / 2.3.0** — prose only: the illustration box names its size token
|
|
630
|
+
(80×80), `sizes[].icon` names the icon token, and the Figma Size values are renamed to the code
|
|
631
|
+
vocabulary (`md` / `sm`, which the `size` prop already used). The recipe now binds that token —
|
|
632
|
+
`size-illustration-card` (`--size-illustration-card`) instead of `size-1300`; same 80px.
|
|
633
|
+
- **2.3.1** — `Show media` off is valid on Stacked too: the text block reserves `--space-900` on
|
|
634
|
+
the right and the check centres on the label's first line. The focus ring is documented as what
|
|
635
|
+
ships — a CSS outline with a 2px offset whose corners follow the card radius.
|
|
636
|
+
|
|
637
|
+
**Manifest 2.1.0 → 2.1.1 (patch, nothing to rebuild).** `slots.media` now lists what the slot accepts
|
|
638
|
+
(`accepts`: icon, illustrations) — the `media` prop already takes an icon name or an illustration element.
|
|
639
|
+
|
|
640
|
+
**Manifest 2.0.1 → 2.1.0 (minor, no API change).** The illustration box is 80×80 (was 82×82), onto the
|
|
641
|
+
4px grid — the recipe is `size-1300`.
|
|
642
|
+
|
|
643
|
+
**Manifest 1.5.2 → 2.0.0 (major).** The React API changed in one breaking place and several visual
|
|
644
|
+
ones:
|
|
645
|
+
|
|
646
|
+
<table>
|
|
647
|
+
<thead>
|
|
648
|
+
<tr><th>1.5.2</th><th>2.0.0</th></tr>
|
|
649
|
+
</thead>
|
|
650
|
+
<tbody>
|
|
651
|
+
<tr><td><code>align: 'left' | 'center'</code> (card + group), type <code>CardSelectAlign</code></td><td><strong>removed</strong> → <code>layout: 'stacked' | 'horizontal'</code> (card + group), type <code>CardSelectLayout</code>. Centring is an instance override via <code>className</code>.</td></tr>
|
|
652
|
+
<tr><td>media container with <code>--space-400</code> vertical padding; illustration 64×64</td><td>no container padding; illustration <strong>82×82</strong> (80×80 since 2.1.0); disabled illustration <code>grayscale</code></td></tr>
|
|
653
|
+
<tr><td>Selected fill <code>--bg-secondary</code></td><td><code>--secondary-subtle</code></td></tr>
|
|
654
|
+
<tr><td>Unselected border <code>--outline-default</code> (hover <code>--outline-strong</code>)</td><td><code>--outline-strong</code> at rest and on hover</td></tr>
|
|
655
|
+
<tr><td>radius <code>md</code> <code>--radius-400</code> · <code>sm</code> <code>--radius-300</code></td><td><code>md</code> <code>--radius-500</code> · <code>sm</code> <code>--radius-400</code></td></tr>
|
|
656
|
+
<tr><td><code>check</code> glyph 20 / 16, no disc</td><td><code>check-circle</code> 28 / 24 on a <code>--bg-primary</code> disc, centred on the media's axis</td></tr>
|
|
657
|
+
<tr><td>subtitle <code>Body/XS</code> at both sizes</td><td><code>Body/XS</code> (<code>md</code>) / <code>Body/XXS</code> (<code>sm</code>)</td></tr>
|
|
658
|
+
<tr><td>Disabled fill <code>--disabled</code></td><td><code>--disabled-control</code> (1.6.0)</td></tr>
|
|
659
|
+
<tr><td><code>tone="danger"</code>, <code>size="sm"</code></td><td><strong>deprecated, kept</strong>; Danger is ignored at <code>sm</code></td></tr>
|
|
660
|
+
</tbody>
|
|
661
|
+
</table>
|
|
662
|
+
|