@invoiceonline/ui-react 0.0.0 → 0.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +99 -0
- package/CHANGELOG.md +131 -0
- package/LICENSE +9 -0
- package/README.md +77 -1
- package/dist/assets/label-brush-1.svg +6 -0
- package/dist/assets/pattern-dark.svg +113 -0
- package/dist/components/action-row/ActionRow.d.ts +178 -0
- package/dist/components/action-row/ActionRow.js +340 -0
- package/dist/components/action-row/index.d.ts +2 -0
- package/dist/components/action-row/index.js +1 -0
- package/dist/components/alert/Alert.d.ts +314 -0
- package/dist/components/alert/Alert.js +446 -0
- package/dist/components/alert/index.d.ts +2 -0
- package/dist/components/alert/index.js +1 -0
- package/dist/components/anchored-panel/AnchoredPanel.d.ts +41 -0
- package/dist/components/anchored-panel/AnchoredPanel.js +72 -0
- package/dist/components/anchored-panel/index.d.ts +3 -0
- package/dist/components/anchored-panel/index.js +3 -0
- package/dist/components/badge/Badge.d.ts +146 -0
- package/dist/components/badge/Badge.js +258 -0
- package/dist/components/badge/index.d.ts +2 -0
- package/dist/components/badge/index.js +1 -0
- package/dist/components/banner/Banner.d.ts +209 -0
- package/dist/components/banner/Banner.js +339 -0
- package/dist/components/banner/index.d.ts +2 -0
- package/dist/components/banner/index.js +1 -0
- package/dist/components/button/Button.d.ts +54 -0
- package/dist/components/button/Button.js +312 -0
- package/dist/components/button/index.d.ts +2 -0
- package/dist/components/button/index.js +1 -0
- package/dist/components/button-group/ButtonGroup.d.ts +187 -0
- package/dist/components/button-group/ButtonGroup.js +217 -0
- package/dist/components/button-group/index.d.ts +2 -0
- package/dist/components/button-group/index.js +1 -0
- package/dist/components/card-select/CardSelect.d.ts +274 -0
- package/dist/components/card-select/CardSelect.js +561 -0
- package/dist/components/card-select/CardSelectGroup.d.ts +92 -0
- package/dist/components/card-select/CardSelectGroup.js +72 -0
- package/dist/components/card-select/index.d.ts +3 -0
- package/dist/components/card-select/index.js +3 -0
- package/dist/components/checkbox/Checkbox.d.ts +104 -0
- package/dist/components/checkbox/Checkbox.js +194 -0
- package/dist/components/checkbox/index.d.ts +2 -0
- package/dist/components/checkbox/index.js +1 -0
- package/dist/components/chip/Chip.d.ts +250 -0
- package/dist/components/chip/Chip.js +441 -0
- package/dist/components/chip/index.d.ts +2 -0
- package/dist/components/chip/index.js +1 -0
- package/dist/components/column-header/ColumnHeader.d.ts +144 -0
- package/dist/components/column-header/ColumnHeader.js +209 -0
- package/dist/components/column-header/index.d.ts +2 -0
- package/dist/components/column-header/index.js +1 -0
- package/dist/components/combobox-field/Combobox.d.ts +104 -0
- package/dist/components/combobox-field/Combobox.js +355 -0
- package/dist/components/combobox-field/ComboboxField.d.ts +76 -0
- package/dist/components/combobox-field/ComboboxField.js +98 -0
- package/dist/components/combobox-field/index.d.ts +3 -0
- package/dist/components/combobox-field/index.js +3 -0
- package/dist/components/date-field/DateField.d.ts +52 -0
- package/dist/components/date-field/DateField.js +45 -0
- package/dist/components/date-field/index.d.ts +2 -0
- package/dist/components/date-field/index.js +1 -0
- package/dist/components/date-picker/DatePicker.d.ts +53 -0
- package/dist/components/date-picker/DatePicker.js +329 -0
- package/dist/components/date-picker/index.d.ts +2 -0
- package/dist/components/date-picker/index.js +1 -0
- package/dist/components/divider/Divider.d.ts +81 -0
- package/dist/components/divider/Divider.js +93 -0
- package/dist/components/divider/index.d.ts +2 -0
- package/dist/components/divider/index.js +1 -0
- package/dist/components/drawer/Drawer.d.ts +128 -0
- package/dist/components/drawer/Drawer.js +367 -0
- package/dist/components/drawer/index.d.ts +2 -0
- package/dist/components/drawer/index.js +1 -0
- package/dist/components/dropdown-button/DropdownButton.d.ts +72 -0
- package/dist/components/dropdown-button/DropdownButton.js +122 -0
- package/dist/components/dropdown-button/index.d.ts +2 -0
- package/dist/components/dropdown-button/index.js +1 -0
- package/dist/components/faq/FAQ.d.ts +135 -0
- package/dist/components/faq/FAQ.js +258 -0
- package/dist/components/faq/index.d.ts +2 -0
- package/dist/components/faq/index.js +1 -0
- package/dist/components/field/Field.d.ts +118 -0
- package/dist/components/field/Field.js +327 -0
- package/dist/components/field/index.d.ts +2 -0
- package/dist/components/field/index.js +1 -0
- package/dist/components/field-pair/FieldPair.d.ts +194 -0
- package/dist/components/field-pair/FieldPair.js +321 -0
- package/dist/components/field-pair/index.d.ts +2 -0
- package/dist/components/field-pair/index.js +1 -0
- package/dist/components/file-upload/FileUpload.d.ts +137 -0
- package/dist/components/file-upload/FileUpload.js +434 -0
- package/dist/components/file-upload/index.d.ts +2 -0
- package/dist/components/file-upload/index.js +1 -0
- package/dist/components/filter-chip/FilterChip.d.ts +373 -0
- package/dist/components/filter-chip/FilterChip.js +517 -0
- package/dist/components/filter-chip/index.d.ts +2 -0
- package/dist/components/filter-chip/index.js +1 -0
- package/dist/components/filter-facet/FilterFacet.d.ts +116 -0
- package/dist/components/filter-facet/FilterFacet.js +632 -0
- package/dist/components/filter-facet/index.d.ts +2 -0
- package/dist/components/filter-facet/index.js +1 -0
- package/dist/components/firm-avatar/FirmAvatar.d.ts +75 -0
- package/dist/components/firm-avatar/FirmAvatar.js +119 -0
- package/dist/components/firm-avatar/index.d.ts +2 -0
- package/dist/components/firm-avatar/index.js +1 -0
- package/dist/components/form-actions/FormActions.d.ts +123 -0
- package/dist/components/form-actions/FormActions.js +195 -0
- package/dist/components/form-actions/index.d.ts +2 -0
- package/dist/components/form-actions/index.js +1 -0
- package/dist/components/form-block/FormBlock.d.ts +252 -0
- package/dist/components/form-block/FormBlock.js +420 -0
- package/dist/components/form-block/index.d.ts +3 -0
- package/dist/components/form-block/index.js +3 -0
- package/dist/components/form-section/FormSection.d.ts +130 -0
- package/dist/components/form-section/FormSection.js +206 -0
- package/dist/components/form-section/index.d.ts +2 -0
- package/dist/components/form-section/index.js +1 -0
- package/dist/components/heading/Heading.d.ts +69 -0
- package/dist/components/heading/Heading.js +79 -0
- package/dist/components/heading/index.d.ts +2 -0
- package/dist/components/heading/index.js +1 -0
- package/dist/components/heading-group/HeadingGroup.d.ts +258 -0
- package/dist/components/heading-group/HeadingGroup.js +255 -0
- package/dist/components/heading-group/index.d.ts +2 -0
- package/dist/components/heading-group/index.js +1 -0
- package/dist/components/hero/Hero.d.ts +268 -0
- package/dist/components/hero/Hero.js +316 -0
- package/dist/components/hero/index.d.ts +2 -0
- package/dist/components/hero/index.js +1 -0
- package/dist/components/icon/Icon.d.ts +27 -0
- package/dist/components/icon/Icon.js +30 -0
- package/dist/components/icon/index.d.ts +3 -0
- package/dist/components/icon/index.js +3 -0
- package/dist/components/icon-button/IconButton.d.ts +75 -0
- package/dist/components/icon-button/IconButton.js +151 -0
- package/dist/components/icon-button/index.d.ts +2 -0
- package/dist/components/icon-button/index.js +1 -0
- package/dist/components/item-row/ItemRow.d.ts +253 -0
- package/dist/components/item-row/ItemRow.js +496 -0
- package/dist/components/item-row/index.d.ts +2 -0
- package/dist/components/item-row/index.js +1 -0
- package/dist/components/list-row/ListRow.d.ts +165 -0
- package/dist/components/list-row/ListRow.js +233 -0
- package/dist/components/list-row/index.d.ts +2 -0
- package/dist/components/list-row/index.js +1 -0
- package/dist/components/menu/Menu.d.ts +64 -0
- package/dist/components/menu/Menu.js +186 -0
- package/dist/components/menu/index.d.ts +2 -0
- package/dist/components/menu/index.js +1 -0
- package/dist/components/modal/Modal.d.ts +272 -0
- package/dist/components/modal/Modal.js +788 -0
- package/dist/components/modal/index.d.ts +2 -0
- package/dist/components/modal/index.js +1 -0
- package/dist/components/nav-link/NavLink.d.ts +123 -0
- package/dist/components/nav-link/NavLink.js +157 -0
- package/dist/components/nav-link/index.d.ts +2 -0
- package/dist/components/nav-link/index.js +1 -0
- package/dist/components/number-field/NumberField.d.ts +62 -0
- package/dist/components/number-field/NumberField.js +210 -0
- package/dist/components/number-field/index.d.ts +2 -0
- package/dist/components/number-field/index.js +1 -0
- package/dist/components/pagination/Pagination.d.ts +133 -0
- package/dist/components/pagination/Pagination.js +217 -0
- package/dist/components/pagination/index.d.ts +3 -0
- package/dist/components/pagination/index.js +3 -0
- package/dist/components/popover-surface/index.d.ts +2 -0
- package/dist/components/popover-surface/index.js +1 -0
- package/dist/components/progress-bar/ProgressBar.d.ts +260 -0
- package/dist/components/progress-bar/ProgressBar.js +470 -0
- package/dist/components/progress-bar/index.d.ts +2 -0
- package/dist/components/progress-bar/index.js +1 -0
- package/dist/components/promo-sticker/PromoSticker.d.ts +204 -0
- package/dist/components/promo-sticker/PromoSticker.js +177 -0
- package/dist/components/promo-sticker/index.d.ts +2 -0
- package/dist/components/promo-sticker/index.js +1 -0
- package/dist/components/promo-surface/PromoSurface.d.ts +94 -0
- package/dist/components/promo-surface/PromoSurface.js +119 -0
- package/dist/components/promo-surface/index.d.ts +2 -0
- package/dist/components/promo-surface/index.js +1 -0
- package/dist/components/radio/Radio.d.ts +92 -0
- package/dist/components/radio/Radio.js +171 -0
- package/dist/components/radio/index.d.ts +2 -0
- package/dist/components/radio/index.js +1 -0
- package/dist/components/radio-group/RadioGroup.d.ts +61 -0
- package/dist/components/radio-group/RadioGroup.js +51 -0
- package/dist/components/radio-group/index.d.ts +2 -0
- package/dist/components/radio-group/index.js +1 -0
- package/dist/components/select/Select.d.ts +65 -0
- package/dist/components/select/Select.js +176 -0
- package/dist/components/select/index.d.ts +2 -0
- package/dist/components/select/index.js +1 -0
- package/dist/components/select-field/SelectField.d.ts +16 -0
- package/dist/components/select-field/SelectField.js +55 -0
- package/dist/components/select-field/index.d.ts +2 -0
- package/dist/components/select-field/index.js +1 -0
- package/dist/components/skeleton/Skeleton.d.ts +64 -0
- package/dist/components/skeleton/Skeleton.js +65 -0
- package/dist/components/skeleton/index.d.ts +2 -0
- package/dist/components/skeleton/index.js +1 -0
- package/dist/components/split-button/SplitButton.d.ts +80 -0
- package/dist/components/split-button/SplitButton.js +182 -0
- package/dist/components/split-button/index.d.ts +2 -0
- package/dist/components/split-button/index.js +1 -0
- package/dist/components/status-summary-bar/StatusSummaryBar.d.ts +118 -0
- package/dist/components/status-summary-bar/StatusSummaryBar.js +278 -0
- package/dist/components/status-summary-bar/index.d.ts +2 -0
- package/dist/components/status-summary-bar/index.js +1 -0
- package/dist/components/subject-lookup-field/SubjectLookupField.d.ts +157 -0
- package/dist/components/subject-lookup-field/SubjectLookupField.js +663 -0
- package/dist/components/subject-lookup-field/index.d.ts +2 -0
- package/dist/components/subject-lookup-field/index.js +1 -0
- package/dist/components/switch/Switch.d.ts +152 -0
- package/dist/components/switch/Switch.js +307 -0
- package/dist/components/switch/index.d.ts +2 -0
- package/dist/components/switch/index.js +1 -0
- package/dist/components/table/Table.d.ts +5 -0
- package/dist/components/table/Table.js +601 -0
- package/dist/components/table/index.d.ts +6 -0
- package/dist/components/table/index.js +6 -0
- package/dist/components/text-field/TextField.d.ts +65 -0
- package/dist/components/text-field/TextField.js +173 -0
- package/dist/components/text-field/index.d.ts +2 -0
- package/dist/components/text-field/index.js +1 -0
- package/dist/components/text-link/TextLink.d.ts +260 -0
- package/dist/components/text-link/TextLink.js +303 -0
- package/dist/components/text-link/index.d.ts +2 -0
- package/dist/components/text-link/index.js +1 -0
- package/dist/components/textarea/Textarea.d.ts +93 -0
- package/dist/components/textarea/Textarea.js +256 -0
- package/dist/components/textarea/index.d.ts +2 -0
- package/dist/components/textarea/index.js +1 -0
- package/dist/components/tooltip/Tooltip.d.ts +129 -0
- package/dist/components/tooltip/Tooltip.js +457 -0
- package/dist/components/tooltip/index.d.ts +2 -0
- package/dist/components/tooltip/index.js +1 -0
- package/dist/components/unit-field/UnitField.d.ts +46 -0
- package/dist/components/unit-field/UnitField.js +133 -0
- package/dist/components/unit-field/index.d.ts +2 -0
- package/dist/components/unit-field/index.js +1 -0
- package/dist/icons/icon-registry.generated.js +500 -0
- package/dist/icons/icon-types.generated.d.ts +2 -0
- package/dist/icons/icon-types.generated.js +126 -0
- package/dist/index.d.ts +132 -0
- package/dist/index.js +75 -0
- package/dist/internal/BottomSheet.js +496 -0
- package/dist/internal/FodsProvider.d.ts +25 -0
- package/dist/internal/FodsProvider.js +32 -0
- package/dist/internal/MotionCaret.js +35 -0
- package/dist/internal/NumberFormatInput.d.ts +21 -0
- package/dist/internal/NumberFormatInput.js +126 -0
- package/dist/internal/SummaryDonut.d.ts +3 -0
- package/dist/internal/SummaryDonut.js +300 -0
- package/dist/internal/buttonSegment.d.ts +44 -0
- package/dist/internal/buttonSegment.js +126 -0
- package/dist/internal/collapseRoom.js +128 -0
- package/dist/internal/comboboxKeys.js +44 -0
- package/dist/internal/contentPresence.js +46 -0
- package/dist/internal/dayCell.js +95 -0
- package/dist/internal/dialogPortal.d.ts +2 -0
- package/dist/internal/dialogPortal.js +21 -0
- package/dist/internal/donutSweeps.js +65 -0
- package/dist/internal/enterOnViewGeometry.js +46 -0
- package/dist/internal/faqItem.js +80 -0
- package/dist/internal/floatingLabelMotion.js +68 -0
- package/dist/internal/formBlockContext.d.ts +22 -0
- package/dist/internal/formBlockContext.js +20 -0
- package/dist/internal/heightRoom.js +87 -0
- package/dist/internal/numberSeparators.js +62 -0
- package/dist/internal/overlayMotion.js +48 -0
- package/dist/internal/paginationItem.d.ts +8 -0
- package/dist/internal/paginationItem.js +22 -0
- package/dist/internal/popoverSurface.d.ts +8 -0
- package/dist/internal/popoverSurface.js +23 -0
- package/dist/internal/portalContainer.d.ts +1 -0
- package/dist/internal/portalContainer.js +6 -0
- package/dist/internal/progressBarItem.d.ts +207 -0
- package/dist/internal/progressBarItem.js +264 -0
- package/dist/internal/selectionControlText.js +12 -0
- package/dist/internal/statusSummaryParts.js +371 -0
- package/dist/internal/summaryMotion.js +75 -0
- package/dist/internal/table/ChildConnector.js +62 -0
- package/dist/internal/table/ChildRowPrefix.d.ts +9 -0
- package/dist/internal/table/ChildRowPrefix.js +27 -0
- package/dist/internal/table/ColumnSettings.js +135 -0
- package/dist/internal/table/ScrollRegion.js +114 -0
- package/dist/internal/table/TableEmpty.js +93 -0
- package/dist/internal/table/TableLayout.d.ts +17 -0
- package/dist/internal/table/TableLayout.js +29 -0
- package/dist/internal/table/TableLoadStatus.js +56 -0
- package/dist/internal/table/TableMobile.js +488 -0
- package/dist/internal/table/TruncatedCell.js +33 -0
- package/dist/internal/table/emptyValue.js +10 -0
- package/dist/internal/table/features.d.ts +41 -0
- package/dist/internal/table/features.js +31 -0
- package/dist/internal/table/recipes.js +227 -0
- package/dist/internal/table/rowClick.js +9 -0
- package/dist/internal/table/types.d.ts +325 -0
- package/dist/internal/table/types.js +13 -0
- package/dist/internal/tailwind-variants.d.ts +3 -0
- package/dist/internal/tailwind-variants.js +37 -0
- package/dist/internal/tooltipContext.js +5 -0
- package/dist/internal/tw-merge-config.generated.js +314 -0
- package/dist/internal/useAnchoredPanel.d.ts +87 -0
- package/dist/internal/useAnchoredPanel.js +108 -0
- package/dist/internal/useCountUp.js +53 -0
- package/dist/internal/useDateFieldTrigger.js +183 -0
- package/dist/internal/useEChart.js +59 -0
- package/dist/internal/useEnterOnView.js +42 -0
- package/dist/internal/useFloatingBar.js +100 -0
- package/dist/internal/useFormReset.js +37 -0
- package/dist/internal/useIsMobile.js +44 -0
- package/dist/internal/useOneRowOverflow.js +88 -0
- package/dist/internal/usePrefersReducedMotion.js +25 -0
- package/dist/internal/useReturnFocus.js +26 -0
- package/dist/internal/utils.d.ts +7 -0
- package/dist/internal/utils.js +58 -0
- package/dist/node_modules/@tanstack/store/dist/store.d.ts +29 -0
- package/dist/node_modules/@tanstack/store/dist/types.d.ts +38 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/cells/coreCellsFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/cells/coreCellsFeature.types.d.ts +53 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/columns/coreColumnsFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/columns/coreColumnsFeature.types.d.ts +90 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/coreFeatures.d.ts +17 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/headers/coreHeadersFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/headers/coreHeadersFeature.types.d.ts +114 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/reactivity/coreReactivityFeature.types.d.ts +51 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/row-models/coreRowModelsFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/row-models/coreRowModelsFeature.types.d.ts +29 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/rows/coreRowsFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/rows/coreRowsFeature.types.d.ts +129 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/table/coreTablesFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/table/coreTablesFeature.types.d.ts +203 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/cell-selection/cellSelectionFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/cell-selection/cellSelectionFeature.types.d.ts +294 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/cell-spanning/cellSpanningFeature.d.ts +11 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/cell-spanning/cellSpanningFeature.types.d.ts +148 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-faceting/columnFacetingFeature.d.ts +12 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-faceting/columnFacetingFeature.types.d.ts +63 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/columnFilteringFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/columnFilteringFeature.types.d.ts +209 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/filterFns.d.ts +35 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-grouping/columnGroupingFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-grouping/columnGroupingFeature.types.d.ts +128 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-ordering/columnOrderingFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-ordering/columnOrderingFeature.types.d.ts +82 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-pinning/columnPinningFeature.d.ts +11 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-pinning/columnPinningFeature.types.d.ts +195 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-resizing/columnResizingFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-resizing/columnResizingFeature.types.d.ts +73 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-sizing/columnSizingFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-sizing/columnSizingFeature.types.d.ts +134 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-visibility/columnVisibilityFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-visibility/columnVisibilityFeature.types.d.ts +92 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/global-filtering/globalFilteringFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/global-filtering/globalFilteringFeature.types.d.ts +67 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/aggregationFns.d.ts +23 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.types.d.ts +183 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.utils.d.ts +18 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-expanding/rowExpandingFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-expanding/rowExpandingFeature.types.d.ts +125 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-pagination/rowPaginationFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-pagination/rowPaginationFeature.types.d.ts +135 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-pinning/rowPinningFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-pinning/rowPinningFeature.types.d.ts +76 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-selection/rowSelectionFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-selection/rowSelectionFeature.types.d.ts +187 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/rowSortingFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/rowSortingFeature.types.d.ts +236 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/sortFns.d.ts +23 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/stockFeatures.d.ts +37 -0
- package/dist/node_modules/@tanstack/table-core/dist/helpers/columnHelper.d.ts +47 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/Cell.d.ts +16 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/Column.d.ts +30 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/ColumnDef.d.ts +123 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/Header.d.ts +12 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/HeaderGroup.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/Row.d.ts +24 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/RowModel.d.ts +19 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/RowModelFns.d.ts +11 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/Table.d.ts +53 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/TableFeatures.d.ts +416 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/TableOptions.d.ts +78 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/TableState.d.ts +46 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/type-utils.d.ts +25 -0
- package/dist/shared.css +179 -0
- package/dist/styles.css +5467 -0
- package/dist/theme.css +314 -0
- package/dist/theme.map.json +278 -0
- package/dist/tokens/index.d.ts +2 -0
- package/dist/tokens/index.js +1 -0
- package/dist/tokens/tokens.generated.d.ts +2040 -0
- package/dist/tokens/tokens.generated.js +2053 -0
- package/dist/tokens.css +484 -0
- package/dist/tokens.flat.json +429 -0
- package/docs/Consuming.mdx +379 -0
- package/docs/Contributing.mdx +78 -0
- package/docs/ForAgents.mdx +53 -0
- package/docs/Introduction.mdx +54 -0
- package/llms.txt +556 -0
- package/package.json +351 -3
- package/src/components/action-row/ActionRow.mdx +686 -0
- package/src/components/action-row/ActionRow.stories.tsx +669 -0
- package/src/components/action-row/ActionRow.tsx +632 -0
- package/src/components/action-row/index.ts +9 -0
- package/src/components/alert/Alert.mdx +377 -0
- package/src/components/alert/Alert.stories.tsx +674 -0
- package/src/components/alert/Alert.tsx +579 -0
- package/src/components/alert/index.ts +13 -0
- package/src/components/anchored-panel/AnchoredPanel.mdx +381 -0
- package/src/components/anchored-panel/AnchoredPanel.stories.tsx +593 -0
- package/src/components/anchored-panel/AnchoredPanel.tsx +176 -0
- package/src/components/anchored-panel/index.ts +15 -0
- package/src/components/badge/Badge.mdx +487 -0
- package/src/components/badge/Badge.stories.tsx +375 -0
- package/src/components/badge/Badge.tsx +360 -0
- package/src/components/badge/index.ts +10 -0
- package/src/components/banner/Banner.mdx +704 -0
- package/src/components/banner/Banner.stories.tsx +448 -0
- package/src/components/banner/Banner.tsx +602 -0
- package/src/components/banner/index.ts +14 -0
- package/src/components/button/Button.mdx +286 -0
- package/src/components/button/Button.stories.tsx +381 -0
- package/src/components/button/Button.tsx +384 -0
- package/src/components/button/index.ts +1 -0
- package/src/components/button-group/ButtonGroup.mdx +512 -0
- package/src/components/button-group/ButtonGroup.stories.tsx +714 -0
- package/src/components/button-group/ButtonGroup.tsx +491 -0
- package/src/components/button-group/index.ts +10 -0
- package/src/components/card-select/CardSelect.mdx +662 -0
- package/src/components/card-select/CardSelect.stories.tsx +784 -0
- package/src/components/card-select/CardSelect.tsx +783 -0
- package/src/components/card-select/CardSelectGroup.tsx +169 -0
- package/src/components/card-select/index.ts +18 -0
- package/src/components/checkbox/Checkbox.mdx +269 -0
- package/src/components/checkbox/Checkbox.stories.tsx +306 -0
- package/src/components/checkbox/Checkbox.tsx +343 -0
- package/src/components/checkbox/index.ts +1 -0
- package/src/components/chip/Chip.mdx +683 -0
- package/src/components/chip/Chip.stories.tsx +734 -0
- package/src/components/chip/Chip.tsx +732 -0
- package/src/components/chip/index.ts +9 -0
- package/src/components/column-header/ColumnHeader.mdx +301 -0
- package/src/components/column-header/ColumnHeader.stories.tsx +319 -0
- package/src/components/column-header/ColumnHeader.tsx +287 -0
- package/src/components/column-header/index.ts +7 -0
- package/src/components/combobox-field/Combobox.tsx +693 -0
- package/src/components/combobox-field/ComboboxField.mdx +525 -0
- package/src/components/combobox-field/ComboboxField.stories.tsx +502 -0
- package/src/components/combobox-field/ComboboxField.tsx +259 -0
- package/src/components/combobox-field/index.ts +12 -0
- package/src/components/date-field/DateField.mdx +340 -0
- package/src/components/date-field/DateField.stories.tsx +221 -0
- package/src/components/date-field/DateField.tsx +176 -0
- package/src/components/date-field/index.ts +1 -0
- package/src/components/date-picker/DatePicker.mdx +436 -0
- package/src/components/date-picker/DatePicker.stories.tsx +458 -0
- package/src/components/date-picker/DatePicker.tsx +688 -0
- package/src/components/date-picker/index.ts +9 -0
- package/src/components/divider/Divider.mdx +256 -0
- package/src/components/divider/Divider.stories.tsx +177 -0
- package/src/components/divider/Divider.tsx +193 -0
- package/src/components/divider/index.ts +1 -0
- package/src/components/drawer/Drawer.mdx +518 -0
- package/src/components/drawer/Drawer.stories.tsx +392 -0
- package/src/components/drawer/Drawer.tsx +683 -0
- package/src/components/drawer/index.ts +1 -0
- package/src/components/dropdown-button/DropdownButton.mdx +285 -0
- package/src/components/dropdown-button/DropdownButton.stories.tsx +398 -0
- package/src/components/dropdown-button/DropdownButton.tsx +198 -0
- package/src/components/dropdown-button/index.ts +7 -0
- package/src/components/faq/FAQ.mdx +364 -0
- package/src/components/faq/FAQ.stories.tsx +343 -0
- package/src/components/faq/FAQ.tsx +337 -0
- package/src/components/faq/index.ts +1 -0
- package/src/components/field/Field.mdx +129 -0
- package/src/components/field/Field.stories.tsx +461 -0
- package/src/components/field/Field.tsx +765 -0
- package/src/components/field/index.ts +20 -0
- package/src/components/field-pair/FieldPair.mdx +308 -0
- package/src/components/field-pair/FieldPair.stories.tsx +530 -0
- package/src/components/field-pair/FieldPair.tsx +796 -0
- package/src/components/field-pair/index.ts +9 -0
- package/src/components/file-upload/FileUpload.mdx +345 -0
- package/src/components/file-upload/FileUpload.stories.tsx +698 -0
- package/src/components/file-upload/FileUpload.tsx +802 -0
- package/src/components/file-upload/index.ts +6 -0
- package/src/components/filter-chip/FilterChip.mdx +778 -0
- package/src/components/filter-chip/FilterChip.stories.tsx +827 -0
- package/src/components/filter-chip/FilterChip.tsx +881 -0
- package/src/components/filter-chip/index.ts +11 -0
- package/src/components/filter-facet/FilterFacet.mdx +536 -0
- package/src/components/filter-facet/FilterFacet.stories.tsx +506 -0
- package/src/components/filter-facet/FilterFacet.tsx +1160 -0
- package/src/components/filter-facet/index.ts +7 -0
- package/src/components/firm-avatar/FirmAvatar.mdx +280 -0
- package/src/components/firm-avatar/FirmAvatar.stories.tsx +147 -0
- package/src/components/firm-avatar/FirmAvatar.tsx +172 -0
- package/src/components/firm-avatar/index.ts +7 -0
- package/src/components/form-actions/FormActions.mdx +518 -0
- package/src/components/form-actions/FormActions.stories.tsx +621 -0
- package/src/components/form-actions/FormActions.tsx +273 -0
- package/src/components/form-actions/index.ts +6 -0
- package/src/components/form-block/FormBlock.mdx +728 -0
- package/src/components/form-block/FormBlock.stories.tsx +813 -0
- package/src/components/form-block/FormBlock.tsx +679 -0
- package/src/components/form-block/index.ts +13 -0
- package/src/components/form-section/FormSection.mdx +436 -0
- package/src/components/form-section/FormSection.stories.tsx +407 -0
- package/src/components/form-section/FormSection.tsx +290 -0
- package/src/components/form-section/index.ts +17 -0
- package/src/components/heading/Heading.mdx +206 -0
- package/src/components/heading/Heading.stories.tsx +169 -0
- package/src/components/heading/Heading.tsx +124 -0
- package/src/components/heading/index.ts +8 -0
- package/src/components/heading-group/HeadingGroup.mdx +521 -0
- package/src/components/heading-group/HeadingGroup.stories.tsx +353 -0
- package/src/components/heading-group/HeadingGroup.tsx +396 -0
- package/src/components/heading-group/index.ts +7 -0
- package/src/components/hero/Hero.mdx +742 -0
- package/src/components/hero/Hero.stories.tsx +527 -0
- package/src/components/hero/Hero.tsx +807 -0
- package/src/components/hero/index.ts +1 -0
- package/src/components/icon/Icon.mdx +329 -0
- package/src/components/icon/Icon.stories.tsx +398 -0
- package/src/components/icon/Icon.tsx +97 -0
- package/src/components/icon/index.ts +2 -0
- package/src/components/icon-button/IconButton.mdx +206 -0
- package/src/components/icon-button/IconButton.stories.tsx +341 -0
- package/src/components/icon-button/IconButton.tsx +273 -0
- package/src/components/icon-button/index.ts +1 -0
- package/src/components/item-row/ItemRow.mdx +533 -0
- package/src/components/item-row/ItemRow.stories.tsx +434 -0
- package/src/components/item-row/ItemRow.tsx +676 -0
- package/src/components/item-row/index.ts +9 -0
- package/src/components/list-row/ListRow.mdx +404 -0
- package/src/components/list-row/ListRow.stories.tsx +404 -0
- package/src/components/list-row/ListRow.tsx +424 -0
- package/src/components/list-row/index.ts +1 -0
- package/src/components/menu/Menu.mdx +268 -0
- package/src/components/menu/Menu.stories.tsx +455 -0
- package/src/components/menu/Menu.tsx +452 -0
- package/src/components/menu/index.ts +1 -0
- package/src/components/modal/Modal.mdx +854 -0
- package/src/components/modal/Modal.stories.tsx +881 -0
- package/src/components/modal/Modal.tsx +1434 -0
- package/src/components/modal/index.ts +1 -0
- package/src/components/nav-link/NavLink.mdx +196 -0
- package/src/components/nav-link/NavLink.stories.tsx +243 -0
- package/src/components/nav-link/NavLink.tsx +222 -0
- package/src/components/nav-link/index.ts +1 -0
- package/src/components/number-field/NumberField.mdx +223 -0
- package/src/components/number-field/NumberField.stories.tsx +291 -0
- package/src/components/number-field/NumberField.tsx +388 -0
- package/src/components/number-field/index.ts +6 -0
- package/src/components/pagination/Pagination.mdx +305 -0
- package/src/components/pagination/Pagination.stories.tsx +333 -0
- package/src/components/pagination/Pagination.tsx +343 -0
- package/src/components/pagination/index.ts +8 -0
- package/src/components/popover-surface/PopoverSurface.mdx +158 -0
- package/src/components/popover-surface/PopoverSurface.stories.tsx +421 -0
- package/src/components/popover-surface/index.ts +1 -0
- package/src/components/progress-bar/ProgressBar.mdx +802 -0
- package/src/components/progress-bar/ProgressBar.stories.tsx +533 -0
- package/src/components/progress-bar/ProgressBar.tsx +654 -0
- package/src/components/progress-bar/index.ts +9 -0
- package/src/components/promo-sticker/PromoSticker.mdx +436 -0
- package/src/components/promo-sticker/PromoSticker.stories.tsx +363 -0
- package/src/components/promo-sticker/PromoSticker.tsx +313 -0
- package/src/components/promo-sticker/index.ts +7 -0
- package/src/components/promo-surface/PromoSurface.mdx +399 -0
- package/src/components/promo-surface/PromoSurface.stories.tsx +270 -0
- package/src/components/promo-surface/PromoSurface.tsx +305 -0
- package/src/components/promo-surface/index.ts +7 -0
- package/src/components/radio/Radio.mdx +243 -0
- package/src/components/radio/Radio.stories.tsx +307 -0
- package/src/components/radio/Radio.tsx +288 -0
- package/src/components/radio/index.ts +1 -0
- package/src/components/radio-group/RadioGroup.mdx +119 -0
- package/src/components/radio-group/RadioGroup.stories.tsx +225 -0
- package/src/components/radio-group/RadioGroup.tsx +139 -0
- package/src/components/radio-group/index.ts +1 -0
- package/src/components/select/Select.mdx +241 -0
- package/src/components/select/Select.stories.tsx +404 -0
- package/src/components/select/Select.tsx +381 -0
- package/src/components/select/index.ts +1 -0
- package/src/components/select-field/SelectField.mdx +324 -0
- package/src/components/select-field/SelectField.stories.tsx +460 -0
- package/src/components/select-field/SelectField.tsx +138 -0
- package/src/components/select-field/index.ts +1 -0
- package/src/components/skeleton/Skeleton.mdx +194 -0
- package/src/components/skeleton/Skeleton.stories.tsx +260 -0
- package/src/components/skeleton/Skeleton.tsx +107 -0
- package/src/components/skeleton/index.ts +1 -0
- package/src/components/split-button/SplitButton.mdx +445 -0
- package/src/components/split-button/SplitButton.stories.tsx +465 -0
- package/src/components/split-button/SplitButton.tsx +361 -0
- package/src/components/split-button/index.ts +7 -0
- package/src/components/status-summary-bar/StatusSummaryBar.mdx +338 -0
- package/src/components/status-summary-bar/StatusSummaryBar.stories.tsx +408 -0
- package/src/components/status-summary-bar/StatusSummaryBar.tsx +428 -0
- package/src/components/status-summary-bar/index.ts +8 -0
- package/src/components/subject-lookup-field/SubjectLookupField.mdx +378 -0
- package/src/components/subject-lookup-field/SubjectLookupField.stories.tsx +393 -0
- package/src/components/subject-lookup-field/SubjectLookupField.tsx +1079 -0
- package/src/components/subject-lookup-field/index.ts +11 -0
- package/src/components/switch/Switch.mdx +376 -0
- package/src/components/switch/Switch.stories.tsx +296 -0
- package/src/components/switch/Switch.tsx +483 -0
- package/src/components/switch/index.ts +1 -0
- package/src/components/table/Table.mdx +575 -0
- package/src/components/table/Table.stories.tsx +1049 -0
- package/src/components/table/Table.tsx +745 -0
- package/src/components/table/TableConsumers.stories.tsx +195 -0
- package/src/components/table/_tableFixtures.ts +1189 -0
- package/src/components/table/index.ts +22 -0
- package/src/components/text-field/TextField.mdx +479 -0
- package/src/components/text-field/TextField.stories.tsx +366 -0
- package/src/components/text-field/TextField.tsx +391 -0
- package/src/components/text-field/index.ts +8 -0
- package/src/components/text-link/TextLink.mdx +353 -0
- package/src/components/text-link/TextLink.stories.tsx +458 -0
- package/src/components/text-link/TextLink.tsx +504 -0
- package/src/components/text-link/index.ts +10 -0
- package/src/components/textarea/Textarea.mdx +244 -0
- package/src/components/textarea/Textarea.stories.tsx +371 -0
- package/src/components/textarea/Textarea.tsx +489 -0
- package/src/components/textarea/index.ts +9 -0
- package/src/components/tooltip/Tooltip.mdx +462 -0
- package/src/components/tooltip/Tooltip.stories.tsx +500 -0
- package/src/components/tooltip/Tooltip.tsx +756 -0
- package/src/components/tooltip/index.ts +13 -0
- package/src/components/unit-field/UnitField.mdx +215 -0
- package/src/components/unit-field/UnitField.stories.tsx +291 -0
- package/src/components/unit-field/UnitField.tsx +255 -0
- package/src/components/unit-field/index.ts +7 -0
- package/src/icons/icon-registry.generated.ts +510 -0
- package/src/icons/icon-types.generated.ts +256 -0
- package/src/index.ts +71 -0
- package/src/internal/BottomSheet.tsx +714 -0
- package/src/internal/FodsProvider.tsx +36 -0
- package/src/internal/MotionCaret.tsx +53 -0
- package/src/internal/NumberFormatInput.tsx +276 -0
- package/src/internal/SummaryDonut.tsx +359 -0
- package/src/internal/buttonSegment.ts +241 -0
- package/src/internal/collapseRoom.ts +130 -0
- package/src/internal/comboboxKeys.ts +90 -0
- package/src/internal/contentPresence.ts +46 -0
- package/src/internal/dayCell.ts +274 -0
- package/src/internal/dialogPortal.ts +50 -0
- package/src/internal/donutSweeps.ts +77 -0
- package/src/internal/enterOnViewGeometry.ts +53 -0
- package/src/internal/faqItem.ts +104 -0
- package/src/internal/floatingLabelMotion.tsx +109 -0
- package/src/internal/formBlockContext.ts +27 -0
- package/src/internal/heightRoom.ts +135 -0
- package/src/internal/numberSeparators.ts +93 -0
- package/src/internal/overlayMotion.tsx +32 -0
- package/src/internal/paginationItem.ts +106 -0
- package/src/internal/popoverSurface.ts +78 -0
- package/src/internal/portalContainer.ts +11 -0
- package/src/internal/progressBarItem.ts +356 -0
- package/src/internal/selectionControlText.ts +42 -0
- package/src/internal/statusSummaryParts.tsx +475 -0
- package/src/internal/summaryMotion.ts +111 -0
- package/src/internal/table/ChildConnector.tsx +57 -0
- package/src/internal/table/ChildRowPrefix.tsx +21 -0
- package/src/internal/table/ColumnSettings.tsx +194 -0
- package/src/internal/table/ScrollRegion.tsx +176 -0
- package/src/internal/table/TableEmpty.tsx +99 -0
- package/src/internal/table/TableLayout.tsx +29 -0
- package/src/internal/table/TableLoadStatus.tsx +60 -0
- package/src/internal/table/TableMobile.tsx +582 -0
- package/src/internal/table/TruncatedCell.tsx +35 -0
- package/src/internal/table/emptyValue.ts +11 -0
- package/src/internal/table/features.ts +44 -0
- package/src/internal/table/recipes.ts +263 -0
- package/src/internal/table/rowClick.ts +8 -0
- package/src/internal/table/types.ts +342 -0
- package/src/internal/tailwind-variants.ts +65 -0
- package/src/internal/tooltipContext.ts +15 -0
- package/src/internal/tw-merge-config.generated.ts +275 -0
- package/src/internal/useAnchoredPanel.ts +340 -0
- package/src/internal/useCountUp.ts +65 -0
- package/src/internal/useDateFieldTrigger.tsx +357 -0
- package/src/internal/useEChart.ts +88 -0
- package/src/internal/useEnterOnView.ts +80 -0
- package/src/internal/useFloatingBar.ts +125 -0
- package/src/internal/useFormReset.ts +47 -0
- package/src/internal/useIsMobile.ts +64 -0
- package/src/internal/useNoImplicitSubmit.ts +41 -0
- package/src/internal/useOneRowOverflow.ts +103 -0
- package/src/internal/usePrefersReducedMotion.ts +27 -0
- package/src/internal/useReturnFocus.ts +34 -0
- package/src/internal/utils.ts +58 -0
- package/src/recipes/EmptyState.stories.tsx +105 -0
- package/src/recipes/Form.stories.tsx +355 -0
- package/src/recipes/ModalWithForm.stories.tsx +219 -0
- package/src/recipes/Recipes.mdx +61 -0
- package/src/recipes/TableWithFilters.stories.tsx +278 -0
- package/src/storybook/FodsFamily.tsx +39 -0
- package/src/storybook/Section.tsx +36 -0
- package/src/storybook/a11y.ts +24 -0
- package/src/storybook/assets/banner-character-bartender.webp +0 -0
- package/src/storybook/assets/banner-invoice-sheet-left.webp +0 -0
- package/src/storybook/assets/banner-invoice-sheet-right.webp +0 -0
- package/src/storybook/assets/invoice-hero.webp +0 -0
- package/src/storybook/assets/invoice.webp +0 -0
- package/src/storybook/assets/section-document-info.svg +21 -0
- package/src/storybook/assets/section-gear-checklist.svg +11 -0
- package/src/storybook/assets/section-person-arrow-in.svg +15 -0
- package/src/storybook/assets/section-person-arrow-out.svg +22 -0
- package/src/storybook/assets/section-receipt-dollar.svg +23 -0
- package/src/storybook/assets/table-empty-folder-empty.png +0 -0
- package/src/storybook/assets/table-empty-folder-magnifying-glass.png +0 -0
- package/src/storybook/assets/table-empty-funnel.png +0 -0
- package/src/storybook/assets/table-empty-load-failed.png +0 -0
- package/src/storybook/assets/wallet-spot.png +0 -0
- package/src/storybook/assets.d.ts +17 -0
- package/src/storybook/componentDoc.ts +41 -0
- package/src/storybook/fitFrame.tsx +70 -0
- package/src/storybook/forceStates.tsx +647 -0
- package/src/storybook/illustrations.tsx +66 -0
- package/src/storybook/viewportFrame.tsx +58 -0
- package/src/styles/assets/label-brush-1.svg +6 -0
- package/src/styles/assets/pattern-dark.svg +113 -0
- package/src/styles/base.css +106 -0
- package/src/styles/index.css +15 -0
- package/src/styles/motion.css +157 -0
- package/src/styles/promo-sticker.css +27 -0
- package/src/styles/promo-surface.css +49 -0
- package/src/styles/shared.css +11 -0
- package/src/styles/theme.generated.css +314 -0
- package/src/styles/theme.map.json +278 -0
- package/src/styles/tracking.generated.css +12 -0
- package/src/tokens/index.ts +4 -0
- package/src/tokens/tokens.generated.ts +542 -0
|
@@ -0,0 +1,169 @@
|
|
|
1
|
+
"use client";
|
|
2
|
+
import * as React from 'react';
|
|
3
|
+
import type { CardSelectLayout, CardSelectSize, CardSelectTone } from './CardSelect';
|
|
4
|
+
import { cn } from '../../internal/utils';
|
|
5
|
+
|
|
6
|
+
/**
|
|
7
|
+
* Shared configuration a `<CardSelectGroup>` provides to the `<CardSelect>` children it
|
|
8
|
+
* wraps. `null` when a card is rendered outside any group.
|
|
9
|
+
*/
|
|
10
|
+
export interface CardSelectGroupContextValue {
|
|
11
|
+
/** Shared radio `name`, tying the children into one native roving group. */
|
|
12
|
+
name: string;
|
|
13
|
+
/** Currently selected value (owned by the group, controlled or not). */
|
|
14
|
+
value?: string;
|
|
15
|
+
/** Notifies the group that a child was selected. */
|
|
16
|
+
onValueChange: (value: string) => void;
|
|
17
|
+
/** Inherited card size. */
|
|
18
|
+
size?: CardSelectSize;
|
|
19
|
+
/** Inherited card layout. */
|
|
20
|
+
layout?: CardSelectLayout;
|
|
21
|
+
/** Inherited tone. */
|
|
22
|
+
tone?: CardSelectTone;
|
|
23
|
+
/** Inherited disabled state. */
|
|
24
|
+
disabled?: boolean;
|
|
25
|
+
}
|
|
26
|
+
|
|
27
|
+
export const CardSelectGroupContext = React.createContext<CardSelectGroupContextValue | null>(
|
|
28
|
+
null,
|
|
29
|
+
);
|
|
30
|
+
|
|
31
|
+
export interface CardSelectGroupBaseProps
|
|
32
|
+
extends Omit<
|
|
33
|
+
React.HTMLAttributes<HTMLDivElement>,
|
|
34
|
+
'onChange' | 'defaultValue' | 'aria-label' | 'aria-labelledby'
|
|
35
|
+
> {
|
|
36
|
+
/** Selected value — makes the group controlled. */
|
|
37
|
+
value?: string;
|
|
38
|
+
/** Initial value for an uncontrolled group. */
|
|
39
|
+
defaultValue?: string;
|
|
40
|
+
/** Called with the newly selected value. */
|
|
41
|
+
onValueChange?: (value: string) => void;
|
|
42
|
+
/** Shared radio `name`; auto-generated when omitted. */
|
|
43
|
+
name?: string;
|
|
44
|
+
/** Card size shared by every child — `md` is the only size (no-op since 3.0.1). */
|
|
45
|
+
size?: CardSelectSize;
|
|
46
|
+
/** Card layout shared by every child — one Layout per group, per the spec. */
|
|
47
|
+
layout?: CardSelectLayout;
|
|
48
|
+
/**
|
|
49
|
+
* Tone shared by every child.
|
|
50
|
+
* @deprecated `danger` is kept for one open ticket only (see `CardSelect` `tone`).
|
|
51
|
+
*/
|
|
52
|
+
tone?: CardSelectTone;
|
|
53
|
+
/** Disables every child card. */
|
|
54
|
+
disabled?: boolean;
|
|
55
|
+
/** Layout direction. */
|
|
56
|
+
orientation?: 'vertical' | 'horizontal';
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
/**
|
|
60
|
+
* A `role="radiogroup"` must carry an accessible name (WCAG 4.1.2 / ARIA APG Radio
|
|
61
|
+
* Group) — and it does NOT inherit one from an ancestor `<fieldset>` / `<legend>`, since
|
|
62
|
+
* that names the fieldset, not a nested ARIA container. The card-select spec requires a
|
|
63
|
+
* group label too (the group owns the question, the cards must not repeat it), so the
|
|
64
|
+
* contract forces exactly one of `aria-label` / `aria-labelledby` at the TYPE level.
|
|
65
|
+
*
|
|
66
|
+
* It has to be the type system: axe-core sets `accessibleNameRequired: false` on
|
|
67
|
+
* `radiogroup` and reports nothing, so an optional prop would just be left out.
|
|
68
|
+
*/
|
|
69
|
+
type CardSelectGroupA11yName =
|
|
70
|
+
| { 'aria-label': string; 'aria-labelledby'?: never }
|
|
71
|
+
| { 'aria-labelledby': string; 'aria-label'?: never };
|
|
72
|
+
|
|
73
|
+
export type CardSelectGroupProps = CardSelectGroupBaseProps & CardSelectGroupA11yName;
|
|
74
|
+
|
|
75
|
+
/**
|
|
76
|
+
* CardSelectGroup — the group a `<CardSelect>` always ships inside (the spec's first
|
|
77
|
+
* Do: "ship it as a group with a group label"; a lone card should be a `Checkbox`). It
|
|
78
|
+
* owns the selection state and shares `size` / `layout` / `tone` / `disabled` with its
|
|
79
|
+
* children through `CardSelectGroupContext`.
|
|
80
|
+
*
|
|
81
|
+
* Keyboard behaviour — one tab stop, arrows moving the selection, Space selecting — is
|
|
82
|
+
* handled NATIVELY by the shared radio `name`, so there is no custom key handling here
|
|
83
|
+
* and nothing to keep in sync (the roving-tabindex mistake this component would otherwise
|
|
84
|
+
* repeat is recorded in the a11y floor).
|
|
85
|
+
*
|
|
86
|
+
* Validation lives here, not on the card: a required group announces itself with
|
|
87
|
+
* `aria-invalid` + helper text, which the caller passes through (`aria-invalid`,
|
|
88
|
+
* `aria-describedby` reach the root with the rest props). No `error` state on the cards.
|
|
89
|
+
*
|
|
90
|
+
* **Layout is the `RadioGroup` precedent, deliberately:** a flex row/column at a
|
|
91
|
+
* `--space-400` gap. The manifest's own `backlog` still lists "a `card-select-group` for
|
|
92
|
+
* columns + equal-height" as an OPEN item, so a grid track model and equal-height cards
|
|
93
|
+
* are not specified yet; until they are, this stays the simple flex group every other FODS
|
|
94
|
+
* group uses. Cards are `w-full`, so they fill whatever track they land in.
|
|
95
|
+
*
|
|
96
|
+
* The group carries no `data-fods-*` attributes: it is not a part of the `card-select`
|
|
97
|
+
* manifest (whose `parts` map is verified empty), and a second node claiming
|
|
98
|
+
* `data-fods-component="card-select"` would fight the card's own root in the runtime
|
|
99
|
+
* measurement merge.
|
|
100
|
+
*/
|
|
101
|
+
const CardSelectGroup = React.forwardRef<HTMLDivElement, CardSelectGroupProps>(
|
|
102
|
+
(
|
|
103
|
+
{
|
|
104
|
+
value,
|
|
105
|
+
defaultValue,
|
|
106
|
+
onValueChange,
|
|
107
|
+
name,
|
|
108
|
+
size,
|
|
109
|
+
layout,
|
|
110
|
+
tone,
|
|
111
|
+
disabled,
|
|
112
|
+
orientation = 'vertical',
|
|
113
|
+
className,
|
|
114
|
+
children,
|
|
115
|
+
...rest
|
|
116
|
+
},
|
|
117
|
+
ref,
|
|
118
|
+
) => {
|
|
119
|
+
const generatedName = React.useId();
|
|
120
|
+
const groupName = name ?? generatedName;
|
|
121
|
+
|
|
122
|
+
const isControlled = value !== undefined;
|
|
123
|
+
const [internalValue, setInternalValue] = React.useState(defaultValue);
|
|
124
|
+
const currentValue = isControlled ? value : internalValue;
|
|
125
|
+
|
|
126
|
+
const handleChange = React.useCallback(
|
|
127
|
+
(next: string) => {
|
|
128
|
+
if (!isControlled) {
|
|
129
|
+
setInternalValue(next);
|
|
130
|
+
}
|
|
131
|
+
onValueChange?.(next);
|
|
132
|
+
},
|
|
133
|
+
[isControlled, onValueChange],
|
|
134
|
+
);
|
|
135
|
+
|
|
136
|
+
const contextValue = React.useMemo<CardSelectGroupContextValue>(
|
|
137
|
+
() => ({
|
|
138
|
+
name: groupName,
|
|
139
|
+
value: currentValue,
|
|
140
|
+
onValueChange: handleChange,
|
|
141
|
+
size,
|
|
142
|
+
layout,
|
|
143
|
+
tone,
|
|
144
|
+
disabled,
|
|
145
|
+
}),
|
|
146
|
+
[groupName, currentValue, handleChange, size, layout, tone, disabled],
|
|
147
|
+
);
|
|
148
|
+
|
|
149
|
+
return (
|
|
150
|
+
<CardSelectGroupContext.Provider value={contextValue}>
|
|
151
|
+
<div
|
|
152
|
+
ref={ref}
|
|
153
|
+
role="radiogroup"
|
|
154
|
+
className={cn(
|
|
155
|
+
'flex gap-400',
|
|
156
|
+
orientation === 'horizontal' ? 'flex-row' : 'flex-col',
|
|
157
|
+
className,
|
|
158
|
+
)}
|
|
159
|
+
{...rest}
|
|
160
|
+
>
|
|
161
|
+
{children}
|
|
162
|
+
</div>
|
|
163
|
+
</CardSelectGroupContext.Provider>
|
|
164
|
+
);
|
|
165
|
+
},
|
|
166
|
+
);
|
|
167
|
+
CardSelectGroup.displayName = 'CardSelectGroup';
|
|
168
|
+
|
|
169
|
+
export { CardSelectGroup };
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
export {
|
|
2
|
+
CardSelect,
|
|
3
|
+
cardSelectVariants,
|
|
4
|
+
type CardSelectProps,
|
|
5
|
+
type CardSelectSize,
|
|
6
|
+
type CardSelectLayout,
|
|
7
|
+
type CardSelectTone,
|
|
8
|
+
type CardSelectFamily,
|
|
9
|
+
type CardSelectMedia,
|
|
10
|
+
type CardSelectBadgeAlign,
|
|
11
|
+
} from './CardSelect';
|
|
12
|
+
export {
|
|
13
|
+
CardSelectGroup,
|
|
14
|
+
CardSelectGroupContext,
|
|
15
|
+
type CardSelectGroupProps,
|
|
16
|
+
type CardSelectGroupBaseProps,
|
|
17
|
+
type CardSelectGroupContextValue,
|
|
18
|
+
} from './CardSelectGroup';
|
|
@@ -0,0 +1,269 @@
|
|
|
1
|
+
import { Meta, Canvas, Controls } from '@storybook/addon-docs/blocks';
|
|
2
|
+
import * as CheckboxStories from './Checkbox.stories';
|
|
3
|
+
|
|
4
|
+
|
|
5
|
+
<Meta of={CheckboxStories} tags={['autodocs']} />
|
|
6
|
+
|
|
7
|
+
# Checkbox
|
|
8
|
+
|
|
9
|
+
## Metadata
|
|
10
|
+
|
|
11
|
+
- **Layer:** atom
|
|
12
|
+
- **Status:** stable
|
|
13
|
+
- **Tokens used:** `--bg-primary`, `--border-width-100`, `--border-width-200`, `--disabled-control`, `--disabled-foreground`, `--font-size-base`, `--font-size-sm`, `--font-size-xs`, `--leading-loose`, `--leading-relaxed`, `--outline-default`, `--outline-focus`, `--outline-strong`, `--radius-200`, `--secondary`, `--secondary-foreground`, `--secondary-hover`, `--secondary-solid`, `--size-icon-2xsmall`, `--space-100`, `--space-400`, `--space-600`, `--space-700`, `--space-900`, `--status-danger`, `--text-primary`, `--text-secondary`
|
|
14
|
+
- **Manifest version:** `1.9.0`
|
|
15
|
+
|
|
16
|
+
## Overview
|
|
17
|
+
|
|
18
|
+
A selection control for choosing **zero or more** options. Use it for independent boolean choices: a single opt-in ("Jsem plátce DPH", "Souhlasím s podmínkami") or a set where any number can be on (a multi-select list, a filter column chooser). Each box is independent — toggling one never changes another.
|
|
19
|
+
|
|
20
|
+
Do **not** use a Checkbox for choosing exactly one of several options (→ [Radio](?path=/docs/design-system-atoms-radio--docs)), for an instant-apply on/off setting that reads as a switch (→ Toggle, future), or to trigger an action (→ [Button](?path=/docs/design-system-atoms-button--docs)).
|
|
21
|
+
|
|
22
|
+
## Rationale
|
|
23
|
+
|
|
24
|
+
This Checkbox codifies three things the design system needs:
|
|
25
|
+
|
|
26
|
+
1. **One filled-blue selection language**, shared with [Radio](?path=/docs/design-system-atoms-radio--docs) — checked = `--secondary-solid` fill + white glyph, so the two controls read as one family.
|
|
27
|
+
2. **Indeterminate is first-class** — a `minus` glyph + `aria-checked="mixed"` for a select-all / partial-group parent.
|
|
28
|
+
3. **The control is the atom; the label is composition.** The same box serves a standalone labelled form field *and* a bare leading-slot indicator in a list — omitting `label` switches between them, so list and form share one source.
|
|
29
|
+
|
|
30
|
+
## Anatomy
|
|
31
|
+
|
|
32
|
+
A horizontal row: **control slot** + (gap `--space-400`) + **text block** (optional).
|
|
33
|
+
|
|
34
|
+
- **Control slot** — the box's carrier, a fixed height equal to the label's line-height for that size (S 22 / M 24), with the box centred inside it and the glyph riding along as an absolute child. That is what puts the box's centre on the label's centre line, and — once Support text is on — keeps it on the **label's** line rather than the middle of the block. The row itself is top-aligned, not centred, because the label wraps and a centred control against a two-line label reads as broken. Consequence: a label-less instance measures 16×22 / 20×24 rather than 16×16 / 20×20; the extra is transparent padding and the visual box does not move, because a bare control sits in a centre-aligned parent.
|
|
35
|
+
- **Box** — square frame, radius `--radius-200`. Unchecked = `--bg-primary` fill + `--outline-strong` border at `--border-width-100` (1px). Checked / indeterminate = `--secondary-solid` fill, no border.
|
|
36
|
+
- **Glyph** — centred `check` (Checked) or `minus` (Indeterminate) Icon, `--secondary-foreground` (white); absent when Unchecked.
|
|
37
|
+
- **Label** — the control's own clickable label (`--text-primary`); rendered only when the `label` prop is set. Clicking it toggles the box.
|
|
38
|
+
- **Support text** — an optional second line under the label (`supportText`), `--text-secondary` at `Body/XS` in **both** sizes — only the label steps with the size. Off by default and inert without a label. In **Error** it is the error line: `--status-danger`, carrying `errorMessage` instead of the description — never both (manifest 1.7.0). That is the **lone** checkbox's error carrier; inside a Control group the group's error line holds the sentence and the member's support line stays off.
|
|
39
|
+
- **Focus ring** — additive `--outline-focus` offset ring, 2px wide, 2px outside the box. The control owns it; the box border is never swapped.
|
|
40
|
+
|
|
41
|
+
## Variants
|
|
42
|
+
|
|
43
|
+
The variant axes are **Selection** (Unchecked · Checked · Indeterminate) and **State** (Default · Hover · Disabled · Error). Selection drives the box fill + glyph; State drives the border / interaction treatment. The grid below is at the default `md` size — see [Sizes](#sizes) for the same axes across S and M.
|
|
44
|
+
|
|
45
|
+
<Canvas of={CheckboxStories.Variants} />
|
|
46
|
+
|
|
47
|
+
<table>
|
|
48
|
+
<thead>
|
|
49
|
+
<tr><th>Selection</th><th>When</th><th>Tokens</th></tr>
|
|
50
|
+
</thead>
|
|
51
|
+
<tbody>
|
|
52
|
+
<tr>
|
|
53
|
+
<td><code>Unchecked</code></td>
|
|
54
|
+
<td>Option is off (default)</td>
|
|
55
|
+
<td>fill <code>--bg-primary</code>, border <code>--outline-strong</code></td>
|
|
56
|
+
</tr>
|
|
57
|
+
<tr>
|
|
58
|
+
<td><code>Checked</code> (<code>checked</code> / <code>defaultChecked</code>)</td>
|
|
59
|
+
<td>Option is on</td>
|
|
60
|
+
<td>fill <code>--secondary-solid</code>, <code>check</code> glyph <code>--secondary-foreground</code></td>
|
|
61
|
+
</tr>
|
|
62
|
+
<tr>
|
|
63
|
+
<td><code>Indeterminate</code> (<code>indeterminate</code>)</td>
|
|
64
|
+
<td>Parent summarising a partially-selected group (select-all)</td>
|
|
65
|
+
<td>fill <code>--secondary-solid</code>, <code>minus</code> glyph <code>--secondary-foreground</code></td>
|
|
66
|
+
</tr>
|
|
67
|
+
</tbody>
|
|
68
|
+
</table>
|
|
69
|
+
|
|
70
|
+
## Sizes
|
|
71
|
+
|
|
72
|
+
Two sizes, locked to the field / list size system (not the button S/M/L scale). Never scale one up to fake the other — both ship a crisp 1px border. The `md` size is the default.
|
|
73
|
+
|
|
74
|
+
<Canvas of={CheckboxStories.Matrix} />
|
|
75
|
+
|
|
76
|
+
<table>
|
|
77
|
+
<thead>
|
|
78
|
+
<tr>
|
|
79
|
+
<th>Size</th>
|
|
80
|
+
<th style={{ textAlign: 'right' }}>Box</th>
|
|
81
|
+
<th style={{ textAlign: 'right' }}>Glyph</th>
|
|
82
|
+
<th>Radius</th>
|
|
83
|
+
<th>Label</th>
|
|
84
|
+
</tr>
|
|
85
|
+
</thead>
|
|
86
|
+
<tbody>
|
|
87
|
+
<tr>
|
|
88
|
+
<td><code>sm</code> (spec S)</td>
|
|
89
|
+
<td style={{ textAlign: 'right' }}>16</td>
|
|
90
|
+
<td style={{ textAlign: 'right' }}>14 (<code>--size-icon-2xsmall</code>)</td>
|
|
91
|
+
<td><code>--radius-200</code></td>
|
|
92
|
+
<td><code>Body/S</code> (14)</td>
|
|
93
|
+
</tr>
|
|
94
|
+
<tr>
|
|
95
|
+
<td><code>md</code> (spec M, default)</td>
|
|
96
|
+
<td style={{ textAlign: 'right' }}>20</td>
|
|
97
|
+
<td style={{ textAlign: 'right' }}>14 (<code>--size-icon-2xsmall</code>)</td>
|
|
98
|
+
<td><code>--radius-200</code></td>
|
|
99
|
+
<td><code>Body/M</code> (16)</td>
|
|
100
|
+
</tr>
|
|
101
|
+
</tbody>
|
|
102
|
+
</table>
|
|
103
|
+
|
|
104
|
+
## States
|
|
105
|
+
|
|
106
|
+
<Canvas of={CheckboxStories.Unchecked} />
|
|
107
|
+
<Canvas of={CheckboxStories.Checked} />
|
|
108
|
+
<Canvas of={CheckboxStories.Indeterminate} />
|
|
109
|
+
<Canvas of={CheckboxStories.Disabled} />
|
|
110
|
+
<Canvas of={CheckboxStories.Error} />
|
|
111
|
+
|
|
112
|
+
<table>
|
|
113
|
+
<thead>
|
|
114
|
+
<tr><th>State</th><th>Treatment</th></tr>
|
|
115
|
+
</thead>
|
|
116
|
+
<tbody>
|
|
117
|
+
<tr>
|
|
118
|
+
<td><strong>Default</strong></td>
|
|
119
|
+
<td>Per Selection (above).</td>
|
|
120
|
+
</tr>
|
|
121
|
+
<tr>
|
|
122
|
+
<td><strong>Hover</strong></td>
|
|
123
|
+
<td>Unchecked border → <code>--secondary</code>; checked fill → <code>--secondary-hover</code>. <strong>Triggered by the whole hit-target, painted on the control only</strong> — see below.</td>
|
|
124
|
+
</tr>
|
|
125
|
+
<tr>
|
|
126
|
+
<td><strong>Focus</strong></td>
|
|
127
|
+
<td>Not a variant — an additive <code>--outline-focus</code> offset ring on <code>:focus-visible</code>. The box is unchanged, never a border-swap.</td>
|
|
128
|
+
</tr>
|
|
129
|
+
<tr>
|
|
130
|
+
<td><strong>Disabled</strong></td>
|
|
131
|
+
<td><code>--disabled-control</code> fill + <code>--outline-default</code> border at <code>--border-width-100</code> in every Selection, <code>--disabled-foreground</code> glyph / label; <code>not-allowed</code> cursor, not toggleable.</td>
|
|
132
|
+
</tr>
|
|
133
|
+
<tr>
|
|
134
|
+
<td><strong>Error</strong></td>
|
|
135
|
+
<td>Unchecked border → <code>--status-danger</code> (required-but-unchecked) + <code>aria-invalid</code>; on a lone checkbox the support line turns <code>--status-danger</code> and carries <code>errorMessage</code>. The label stays <code>--text-primary</code>. A checked or indeterminate box is never in error — ticking it drops the danger border, the error line and <code>aria-invalid</code> together.</td>
|
|
136
|
+
</tr>
|
|
137
|
+
</tbody>
|
|
138
|
+
</table>
|
|
139
|
+
|
|
140
|
+
**Uncontrolled checked state.** Without `checked`, the component mirrors the box's state from its own change events, so Error clears the moment the user ticks it; a native form reset (which fires no change event) re-syncs that mirror to the restored `defaultChecked`. A consumer `aria-describedby` is merged with — not replaced by — the id of the component's own support line.
|
|
141
|
+
|
|
142
|
+
**What hover responds to.** The trigger is the **whole hit-target**, not the 16/20px box: with a
|
|
143
|
+
label that means the entire row, so pointing at the label text lights the control exactly as
|
|
144
|
+
pointing at the box does. Anything clickable that gives no feedback is a false affordance — and the
|
|
145
|
+
row here *is* clickable. In code the hover is bound to the wrapping `<label>` (`group-hover`), never
|
|
146
|
+
to the input alone (`peer-hover`), and stays gated on `enabled`.
|
|
147
|
+
|
|
148
|
+
**What hover paints.** The **control only** — the box's border or fill. The row itself gets **no
|
|
149
|
+
wash**: a row-wide `--bg-hover` is the ListRow / ActionRow language, where the row is the thing being
|
|
150
|
+
chosen. Here the row is merely the target and the box is the thing. Where a host row owns a wash of
|
|
151
|
+
its own (a filter Popover row, a table row), the two compose — the row washes, the box recolours —
|
|
152
|
+
and neither replaces the other.
|
|
153
|
+
|
|
154
|
+
**Motion** (manifest 1.8.1 `motion.states`). The box's `border-color` / `background-color` ease on
|
|
155
|
+
`--easing-standard`: hover over `--duration-hover` (150ms), the selection flip over `--duration-toggle`
|
|
156
|
+
(100ms). The tick appears with the fill — the glyph has no transition of its own — and checked ↔
|
|
157
|
+
indeterminate swaps the glyph at once. The property list is explicit (`transition-[background-color,border-color]`,
|
|
158
|
+
not `transition-colors`), so the focus ring is never eased. One limit of CSS: a transition takes its
|
|
159
|
+
duration from the state it lands in, and a **pointer** flip lands in the same hovered state as a
|
|
160
|
+
hover-in, so it runs on `--duration-hover`; a **keyboard** flip lands under `:focus-visible` and gets
|
|
161
|
+
`--duration-toggle`. Colour only, nothing moves, so there is no reduced-motion override.
|
|
162
|
+
|
|
163
|
+
A **bare control** (no label) has no row to speak of: its hit-target is the ≥32×32 input over the
|
|
164
|
+
box, so trigger and paint coincide.
|
|
165
|
+
|
|
166
|
+
### Without label
|
|
167
|
+
|
|
168
|
+
A bare control (no `label`) — e.g. a leading slot in a ListRow. The consumer **must** supply an
|
|
169
|
+
`aria-label` so the control keeps an accessible name (see Accessibility / Usage).
|
|
170
|
+
|
|
171
|
+
Figma's **Show label** boolean maps to the **presence of the `label` prop** — there is no `showLabel`
|
|
172
|
+
boolean on the component (manifest 1.5.0). That is the selection-control rule and the opposite of the
|
|
173
|
+
field family, where the label element stays in the DOM and `Field`'s `hideLabel` hides it visually: a
|
|
174
|
+
checkbox with no label has no floating chip to hide, so the name has to come from `aria-label` instead.
|
|
175
|
+
|
|
176
|
+
<Canvas of={CheckboxStories.WithoutLabel} />
|
|
177
|
+
|
|
178
|
+
## API
|
|
179
|
+
|
|
180
|
+
<Controls />
|
|
181
|
+
|
|
182
|
+
## Do / Don't
|
|
183
|
+
|
|
184
|
+
- ✅ Use `indeterminate` for a parent that summarises a partially-selected group (select-all).
|
|
185
|
+
- ✅ Prefer the `label` prop over an external `<label>` — it wires `htmlFor`/`id` and makes the whole row clickable.
|
|
186
|
+
- ✅ Pass `id` when you need a stable target; otherwise one is generated via `useId`.
|
|
187
|
+
- ✅ Phrase the label so **checked = the affirmative** ("Zobrazit i stornované", not "Neskrývat…").
|
|
188
|
+
- ❌ Don't use a lone Checkbox where exactly one of several must be chosen — that's a [Radio](?path=/docs/design-system-atoms-radio--docs) group.
|
|
189
|
+
- ❌ Don't rely on the error colour alone — give a lone checkbox an `errorMessage` (colour is a second, non-text cue).
|
|
190
|
+
- ❌ Don't show the description and the error message at once — in Error the message replaces the support line.
|
|
191
|
+
- ❌ Don't render a bare control (no `label`) without an `aria-label` on the consumer side.
|
|
192
|
+
|
|
193
|
+
## Accessibility
|
|
194
|
+
|
|
195
|
+
- **Keyboard** — Space toggles the box; Tab moves between controls. All native `<input type="checkbox">` behaviour.
|
|
196
|
+
- **ARIA** — **Indeterminate** sets the DOM `indeterminate` property **and** `aria-checked="mixed"` (the visual minus alone is not enough). **Error** sets `aria-invalid` and is announced by text, never colour alone: a lone checkbox references its support line — now `errorMessage` — via `aria-describedby`. In a Control group `aria-invalid` and the message sit on the group, not on the member.
|
|
197
|
+
- **Screen reader** — the `label` prop is the accessible name and stays associated via `htmlFor`/`id`. A bare control (no `label`, e.g. a ListRow leading slot) **must** get an `aria-label` from the consumer.
|
|
198
|
+
- **Support text is a description, not the name** — `supportText` carries its own `id` and the input points at it with `aria-describedby`, while `aria-labelledby` narrows the name back to the label line. Left unqualified inside the wrapping `<label>` the two ran together into one name ("Zasílat kopiiKopie odejde hned.") with no description at all.
|
|
199
|
+
- **Focus** — the additive `--outline-focus` offset ring appears on `:focus-visible`; it is never removed and the box is not recoloured.
|
|
200
|
+
- **Contrast exception (ACCEPTED)** — the resting, unchecked `--outline-strong` border is **1.73:1** on white and is the control's only boundary, below the 3:1 non-text minimum (WCAG 1.4.11). Recorded as an accepted exception, not an oversight: the box is never the sole cue (the label carries the meaning), it sits inside a ≥32×32 target, it takes the 2px offset focus ring — and no darker neutral outline token exists. Mirrored in `checkbox.manifest.json` 1.5.0 and `spec/02-tokens/color-tokens.md`.
|
|
201
|
+
- **Target** — with a `label`, the whole row is one hit-target. A bare control (no `label`) still exposes a **≥ 32×32px** hit area: the hidden input is enlarged and centred over the 16/20px visual box, so the box size never limits the tap target (clears WCAG 2.5.8 · 24×24). This is the selection-control minimum; general tap targets aim for 44×44 (see `spec/01-foundations/accessibility.md` § Touch targets).
|
|
202
|
+
|
|
203
|
+
Accessibility floor for every FODS component: `spec/01-foundations/accessibility.md`.
|
|
204
|
+
|
|
205
|
+
## Copy
|
|
206
|
+
|
|
207
|
+
Voice: the product tone of voice, impersonal and in-app. The label is the control's **own** name. The general field-copy conventions of [TextField](?path=/docs/design-system-atoms-textfield--docs) apply; a checkbox adds:
|
|
208
|
+
|
|
209
|
+
- **Label** (`label`) — a short **affirmative / imperative** phrase the user is agreeing to or enabling. **Sentence case, no terminal period**, even when it reads like a sentence. Phrase it so **checked = the affirmative**; never a double negative (*Neskrývat…* → *Zobrazit…*). Single line, wraps if long, never truncated (the label is the accessible name); max 60 characters.
|
|
210
|
+
- **Support text** (`supportText`) — says what *ticking the box actually does*: the consequence, never a restatement of the label. Sentence case, no terminal period. One line, wraps to 2; max 90 characters. If it needs two sentences, the label is probably wrong.
|
|
211
|
+
- **Error message** (`errorMessage`, the support line in Error) — one sentence naming what is missing and what to do. It replaces the support text while the error lasts; never both.
|
|
212
|
+
|
|
213
|
+
Canonical examples:
|
|
214
|
+
|
|
215
|
+
<table>
|
|
216
|
+
<thead>
|
|
217
|
+
<tr><th>Run</th><th>Text</th></tr>
|
|
218
|
+
</thead>
|
|
219
|
+
<tbody>
|
|
220
|
+
<tr><td>Label</td><td>Jsem plátce DPH</td></tr>
|
|
221
|
+
<tr><td>Label</td><td>Souhlasím s obchodními podmínkami</td></tr>
|
|
222
|
+
<tr><td>Label</td><td>Zobrazit i stornované</td></tr>
|
|
223
|
+
<tr><td>Error message</td><td>Potvrďte souhlas s podmínkami</td></tr>
|
|
224
|
+
</tbody>
|
|
225
|
+
</table>
|
|
226
|
+
|
|
227
|
+
## Usage
|
|
228
|
+
|
|
229
|
+
```tsx
|
|
230
|
+
import { Checkbox } from '@invoiceonline/ui-react';
|
|
231
|
+
|
|
232
|
+
// Good — standalone labelled form field; label toggles the box
|
|
233
|
+
<Checkbox label="Jsem plátce DPH" defaultChecked />
|
|
234
|
+
|
|
235
|
+
// Good — bare control for a list row, accessible name via aria-label
|
|
236
|
+
<Checkbox aria-label="Vybrat řádek Acme s.r.o." />
|
|
237
|
+
|
|
238
|
+
// Good — parent summarising a partially-selected group
|
|
239
|
+
<Checkbox label="Vybrat vše" indeterminate />
|
|
240
|
+
|
|
241
|
+
// Good — required-but-unchecked validation on a lone checkbox; the message
|
|
242
|
+
// replaces the support line while the error lasts
|
|
243
|
+
<Checkbox label="Souhlasím s podmínkami" error errorMessage="Potvrďte souhlas s podmínkami" />
|
|
244
|
+
|
|
245
|
+
// Good — a member of a Control group: border cue only, the group owns the message
|
|
246
|
+
<Checkbox label="Faktury" error />
|
|
247
|
+
|
|
248
|
+
// Don't — mutually-exclusive choices belong in a Radio group
|
|
249
|
+
<Checkbox label="Měsíčně" />
|
|
250
|
+
<Checkbox label="Ročně" />
|
|
251
|
+
|
|
252
|
+
// Don't — bare control with no accessible name
|
|
253
|
+
<Checkbox />
|
|
254
|
+
```
|
|
255
|
+
|
|
256
|
+
## Related
|
|
257
|
+
|
|
258
|
+
- [Radio](?path=/docs/design-system-atoms-radio--docs) — sibling selection control for choosing exactly one option (shared filled-blue language).
|
|
259
|
+
- **Field** — wraps a Checkbox with label / helper / error text in forms.
|
|
260
|
+
- **ListRow** — hosts a bare Checkbox in its leading slot for multi-select / filter lists.
|
|
261
|
+
- Spec: `spec/03-atoms/checkbox.md`
|
|
262
|
+
|
|
263
|
+
## Migration notes
|
|
264
|
+
|
|
265
|
+
**Manifest 1.5.0 → 1.7.0 (ui-system 0.13.0).** Disabled now draws a `--outline-default` border at `--border-width-100` on a `--disabled-control` fill (was a borderless `--disabled` fill), in every Selection. In Error the support line carries the new `errorMessage` prop in `--status-danger` instead of the description; a checkbox in a Control group passes `error` without a message.
|
|
266
|
+
|
|
267
|
+
**Manifest 1.8.0 → 1.8.1 (motion audit, 2026-11-03).** The manifest gains a `motion` block (`states.hover`, `states.toggle`). The box's untokenised `transition-colors` (Tailwind's 150ms default) became `--duration-hover` / `--duration-toggle` on `--easing-standard` over an explicit property list — see [States](#states) → Motion.
|
|
268
|
+
|
|
269
|
+
**Manifest 1.8.1 → 1.9.0 (2026-11-12).** The glyph is `--size-icon-2xsmall` at both sizes. At `sm` the check and the minus grow from 12 px to that step; `md` keeps its size.
|