@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,119 @@
|
|
|
1
|
+
import { Meta, Canvas, Controls } from '@storybook/addon-docs/blocks';
|
|
2
|
+
import * as RadioGroupStories from './RadioGroup.stories';
|
|
3
|
+
|
|
4
|
+
|
|
5
|
+
<Meta of={RadioGroupStories} tags={['autodocs']} />
|
|
6
|
+
|
|
7
|
+
# RadioGroup
|
|
8
|
+
|
|
9
|
+
## Metadata
|
|
10
|
+
|
|
11
|
+
- **Layer:** atom — the group **carrier** of the `control-group` pattern for a set of mutually exclusive controls, listed under Atoms beside `Radio`. **Not a design-system entity of its own:** upstream ships no `radio-group` manifest and no Figma component set, because the group is a contract, not a component (`control-group.md`: *"a shared contract, not a component"*).
|
|
12
|
+
- **Status:** draft — the upstream pattern it binds is `status: draft` (minted 2026-09-03).
|
|
13
|
+
- **Manifest version:** not applicable — a pattern carrier. The control it groups carries its own (`radio` 1.7.0).
|
|
14
|
+
- **Closes:** `radio.manifest.json` `gaps[0]` ("a carrier for the GROUP a radio always lives in"), marked **resolved** upstream once `control-group.md` landed.
|
|
15
|
+
|
|
16
|
+
## Overview
|
|
17
|
+
|
|
18
|
+
A `role="radiogroup"` container for selecting **one** value from a set of mutually exclusive options. It owns the selection state and shares `name` / value / `size` / `disabled` / `error` with its [`Radio`](?path=/docs/design-system-atoms-radio--docs) children through context. Keyboard behaviour — one tab stop, arrow keys move selection, Space selects — comes natively from the shared `name`; no JS key handling. For the atom itself (variants, sizes, states) see the [`Radio`](?path=/docs/design-system-atoms-radio--docs) docs.
|
|
19
|
+
|
|
20
|
+
The group **must** carry an accessible name — the contract requires either `aria-label` or `aria-labelledby`. A wrapping `FieldSet` + `FieldLegend` gives visual grouping but does **not** name the `role="radiogroup"` on its own, so point `aria-labelledby` at the legend's `id`.
|
|
21
|
+
|
|
22
|
+
## Variants
|
|
23
|
+
|
|
24
|
+
<Canvas of={RadioGroupStories.Variants} />
|
|
25
|
+
|
|
26
|
+
## States
|
|
27
|
+
|
|
28
|
+
<Canvas of={RadioGroupStories.States} />
|
|
29
|
+
|
|
30
|
+
## Compositions
|
|
31
|
+
|
|
32
|
+
<Canvas of={RadioGroupStories.Compositions} />
|
|
33
|
+
|
|
34
|
+
## API
|
|
35
|
+
|
|
36
|
+
<Controls />
|
|
37
|
+
|
|
38
|
+
## Do / Don't
|
|
39
|
+
|
|
40
|
+
- ✅ Let `RadioGroup` own the selection — children read state from context
|
|
41
|
+
- ✅ Always give the group a name — `aria-label`, or `aria-labelledby` pointing at a `FieldLegend` `id`
|
|
42
|
+
- ✅ Use horizontal layout (`orientation="horizontal"`) for ≤3 short options
|
|
43
|
+
- ✅ Pass `id` when you need a stable target for a `Radio`
|
|
44
|
+
- ❌ Don't ship a single radio — use a `Checkbox`
|
|
45
|
+
- ❌ Don't use RadioGroup for >5 options — switch to `Select`
|
|
46
|
+
- ❌ Don't use RadioGroup for a boolean toggle — use Switch / Checkbox
|
|
47
|
+
- ❌ Don't nest `role="group"` around the `role="radiogroup"` — put `aria-labelledby` on the group
|
|
48
|
+
|
|
49
|
+
## Accessibility
|
|
50
|
+
|
|
51
|
+
- **Native semantics** — each child is a native `<input type="radio">` sharing one `name`; the container is `role="radiogroup"`. No `role`/`aria-checked` is faked — the browser provides it.
|
|
52
|
+
- **Keyboard** — the group is **one tab stop**. Arrow Up/Down (or Left/Right) moves selection, **automatically selecting** the focused option; Space selects the focused one. This is native behaviour of same-`name` radios, not scripted — the browser owns the roving focus. A hand-written roving `tabIndex` belongs only to groups whose members are *not* native inputs; over real radios it is a documented source of regressions (`radio` manifest 1.5.0).
|
|
53
|
+
- **Group label (required)** — the contract enforces `aria-label` **or** `aria-labelledby`; a `role="radiogroup"` without an accessible name fails WCAG 4.1.2. `FieldSet` + `FieldLegend` gives visual grouping but does **not** name the radiogroup by itself — wire `aria-labelledby` to the legend's `id`. SR then announces the label before each item ("Payment method, Bank Transfer, radio button, 1 of 3").
|
|
54
|
+
- **"Fake legend" pattern** — when you need a label *next to* the group (horizontal layout), put `aria-labelledby="my-id"` **on the `RadioGroup`** itself (it already carries `role="radiogroup"`) and reference a regular heading — do **not** wrap it in another `role="group"` (nested/colliding roles).
|
|
55
|
+
- **Item label association** — `Radio` links its `<label>` to the input via `htmlFor` / `id` (auto-generated with `useId` when `id` is omitted); pass `id` only when you need a stable target.
|
|
56
|
+
- **Disabled state** — `disabled` on the group disables all items; `disabled` on an individual `Radio` disables just that one.
|
|
57
|
+
- **Required field** — RadioGroup itself has no `required` semantics. Wrap in `FieldSet` and surface a `Field` `error` message ("Please select an option") on submit failure; pass `error` to signal the group-level invalid border.
|
|
58
|
+
|
|
59
|
+
Accessibility floor for every FODS component: `spec/01-foundations/accessibility.md`.
|
|
60
|
+
|
|
61
|
+
## Usage
|
|
62
|
+
|
|
63
|
+
```tsx
|
|
64
|
+
import { RadioGroup, Radio, FieldSet, FieldLegend } from '@invoiceonline/ui-react';
|
|
65
|
+
|
|
66
|
+
// Good — recommended pattern: FieldSet legend + aria-labelledby naming the group
|
|
67
|
+
<FieldSet>
|
|
68
|
+
<FieldLegend id="pay-legend">Payment method</FieldLegend>
|
|
69
|
+
<RadioGroup defaultValue="bank" aria-labelledby="pay-legend">
|
|
70
|
+
<Radio value="bank" id="pay-bank" label="Bank Transfer" />
|
|
71
|
+
<Radio value="card" id="pay-card" label="Credit Card" />
|
|
72
|
+
<Radio value="cash" id="pay-cash" label="Cash" />
|
|
73
|
+
</RadioGroup>
|
|
74
|
+
</FieldSet>
|
|
75
|
+
|
|
76
|
+
// Good — horizontal layout for ≤3 short options
|
|
77
|
+
<RadioGroup defaultValue="yes" orientation="horizontal" aria-label="Answer">
|
|
78
|
+
<Radio value="yes" id="ans-yes" label="Yes" />
|
|
79
|
+
<Radio value="no" id="ans-no" label="No" />
|
|
80
|
+
</RadioGroup>
|
|
81
|
+
|
|
82
|
+
// Good — controlled mode for business logic
|
|
83
|
+
<RadioGroup value={value} onValueChange={setValue} aria-label="Payment method">
|
|
84
|
+
...
|
|
85
|
+
</RadioGroup>
|
|
86
|
+
|
|
87
|
+
// Good — group-level props inherited by every child
|
|
88
|
+
<RadioGroup defaultValue="bank" size="sm" disabled aria-label="Payment method">
|
|
89
|
+
<Radio value="bank" id="pay-bank" label="Bank Transfer" />
|
|
90
|
+
<Radio value="card" id="pay-card" label="Credit Card" />
|
|
91
|
+
</RadioGroup>
|
|
92
|
+
```
|
|
93
|
+
|
|
94
|
+
```tsx
|
|
95
|
+
// Don't — a lone radio (an exclusive control of one should be a Checkbox)
|
|
96
|
+
<RadioGroup>
|
|
97
|
+
<Radio value="on" id="on" label="On" />
|
|
98
|
+
</RadioGroup>
|
|
99
|
+
|
|
100
|
+
// Don't — RadioGroup for >5 options (use Select instead)
|
|
101
|
+
<RadioGroup>
|
|
102
|
+
{twentyCountries.map(...)} {/* too many — Select is better */}
|
|
103
|
+
</RadioGroup>
|
|
104
|
+
|
|
105
|
+
// Don't — RadioGroup for a binary boolean (use Switch / Checkbox)
|
|
106
|
+
<RadioGroup>
|
|
107
|
+
<Radio value="on" id="on" label="On" />
|
|
108
|
+
<Radio value="off" id="off" label="Off" />
|
|
109
|
+
</RadioGroup>
|
|
110
|
+
```
|
|
111
|
+
|
|
112
|
+
## Related
|
|
113
|
+
|
|
114
|
+
- [`Radio`](?path=/docs/design-system-atoms-radio--docs) — the atom this group composes
|
|
115
|
+
- [`Checkbox`](?path=/docs/design-system-atoms-checkbox--docs) — for zero-or-more independent options
|
|
116
|
+
- [`Field`](?path=/docs/design-system-atoms-field--docs) — for `FieldSet` + `FieldLegend`
|
|
117
|
+
- [`Select`](?path=/docs/design-system-organisms-select--docs) — for >5 options
|
|
118
|
+
- `spec/06-patterns/control-group.md` — the upstream pattern RadioGroup binds
|
|
119
|
+
|
|
@@ -0,0 +1,225 @@
|
|
|
1
|
+
import type { ComponentType } from 'react';
|
|
2
|
+
import type { Meta, StoryObj } from '@storybook/react-vite';
|
|
3
|
+
import { RadioGroup } from './RadioGroup';
|
|
4
|
+
import { Radio } from '../radio/Radio';
|
|
5
|
+
import { FieldSet, FieldLegend } from '../field/Field';
|
|
6
|
+
import type { RadioGroupBaseProps } from './RadioGroup';
|
|
7
|
+
import { Section, Showcase } from '../../storybook/Section';
|
|
8
|
+
import { componentDoc } from '../../storybook/componentDoc';
|
|
9
|
+
import { FORCE_FOCUS } from '../../storybook/forceStates';
|
|
10
|
+
|
|
11
|
+
// RadioGroupProps enforces an accessible name via an exclusive `aria-label` /
|
|
12
|
+
// `aria-labelledby` union — great for consumers, but CSF's `Args` machinery
|
|
13
|
+
// cannot resolve a union prop type. Type the stories against the base (no
|
|
14
|
+
// a11y-name keys) so Storybook stays happy; each render body sets the name
|
|
15
|
+
// literally on the real component, where the required-name contract still bites.
|
|
16
|
+
type RadioGroupStoryArgs = RadioGroupBaseProps;
|
|
17
|
+
|
|
18
|
+
const meta = {
|
|
19
|
+
title: 'Design System/Atoms/RadioGroup',
|
|
20
|
+
// Storybook 10 types `component` against the story args; the a11y-name union
|
|
21
|
+
// of RadioGroupProps does not overlap the base props, so cast through unknown.
|
|
22
|
+
component: RadioGroup as unknown as ComponentType<RadioGroupStoryArgs>,
|
|
23
|
+
parameters: {
|
|
24
|
+
layout: 'centered',
|
|
25
|
+
containerWidth: 320,
|
|
26
|
+
docs: {
|
|
27
|
+
description: {
|
|
28
|
+
component: componentDoc({
|
|
29
|
+
summary:
|
|
30
|
+
'Radio button group for selecting one value from multiple options. A `role="radiogroup"` container that owns the selection state and shares `name` / value with its `Radio` children via context; keyboard behaviour (roving focus, arrow keys, Space) comes natively from the shared `name`. See the `Radio` story for the atom itself.',
|
|
31
|
+
useCases: [
|
|
32
|
+
'`Radio` — the recommended radio + label child',
|
|
33
|
+
'`FieldSet` + `FieldLegend` — semantically correct way to label the group',
|
|
34
|
+
'`className="flex-row"` (or `orientation="horizontal"`) — horizontal layout for 2-3 short options (Yes/No)',
|
|
35
|
+
'`disabled` / `size` / `error` on the group — inherited by every child radio',
|
|
36
|
+
'"Fake legend" with `aria-labelledby` on the group — when you need a label next to it',
|
|
37
|
+
],
|
|
38
|
+
bestPractices: [
|
|
39
|
+
'Let `RadioGroup` own the selection — children read `name` / `checked` / `onChange` from context',
|
|
40
|
+
'For more than ~5 options consider Select instead of RadioGroup',
|
|
41
|
+
'For a horizontal label next to the group use a "fake legend" with ARIA, not a CSS hack on `<legend>`',
|
|
42
|
+
'Always set a unique `id` for each item — pairs radio with its label',
|
|
43
|
+
],
|
|
44
|
+
knownIssues: [
|
|
45
|
+
'FieldSet + FieldLegend horizontal layout is not possible — `<legend>` must be above content (HTML standard)',
|
|
46
|
+
],
|
|
47
|
+
docsLink: { label: 'spec/06-patterns/control-group.md' },
|
|
48
|
+
}),
|
|
49
|
+
},
|
|
50
|
+
},
|
|
51
|
+
},
|
|
52
|
+
// No autodocs tag — RadioGroup.mdx provides the dedicated Docs page.
|
|
53
|
+
} satisfies Meta<RadioGroupStoryArgs>;
|
|
54
|
+
|
|
55
|
+
export default meta;
|
|
56
|
+
type Story = StoryObj<RadioGroupStoryArgs>;
|
|
57
|
+
|
|
58
|
+
export const Playground: Story = {
|
|
59
|
+
args: {
|
|
60
|
+
defaultValue: 'bank',
|
|
61
|
+
disabled: false,
|
|
62
|
+
className: '',
|
|
63
|
+
},
|
|
64
|
+
argTypes: {
|
|
65
|
+
defaultValue: { control: 'select', options: ['bank', 'card', 'cash'] },
|
|
66
|
+
disabled: { control: 'boolean' },
|
|
67
|
+
className: { control: 'text', description: 'e.g. "flex-row" for horizontal layout' },
|
|
68
|
+
},
|
|
69
|
+
render: args => (
|
|
70
|
+
<RadioGroup {...args} aria-label="Payment method">
|
|
71
|
+
<Radio value="bank" id="pg-bank" label="Bank Transfer" />
|
|
72
|
+
<Radio value="card" id="pg-card" label="Credit Card" />
|
|
73
|
+
<Radio value="cash" id="pg-cash" label="Cash" />
|
|
74
|
+
</RadioGroup>
|
|
75
|
+
),
|
|
76
|
+
};
|
|
77
|
+
|
|
78
|
+
export const Variants: Story = {
|
|
79
|
+
parameters: {
|
|
80
|
+
docs: { description: { story: 'Vertical (default) and horizontal layout for various option counts.' } },
|
|
81
|
+
},
|
|
82
|
+
render: () => (
|
|
83
|
+
<Showcase>
|
|
84
|
+
<Section title="Vertical (default)" layout="column">
|
|
85
|
+
<RadioGroup defaultValue="bank" aria-label="Payment method (vertical)">
|
|
86
|
+
<Radio value="bank" id="v-bank" label="Bank Transfer" />
|
|
87
|
+
<Radio value="card" id="v-card" label="Credit Card" />
|
|
88
|
+
<Radio value="cash" id="v-cash" label="Cash" />
|
|
89
|
+
</RadioGroup>
|
|
90
|
+
</Section>
|
|
91
|
+
<Section title="Horizontal (flex-row)" layout="column">
|
|
92
|
+
<RadioGroup defaultValue="with-vat" className="flex-row" aria-label="Entering prices (horizontal)">
|
|
93
|
+
<Radio value="with-vat" id="h-with" label="with VAT" />
|
|
94
|
+
<Radio value="without-vat" id="h-without" label="without VAT" />
|
|
95
|
+
</RadioGroup>
|
|
96
|
+
</Section>
|
|
97
|
+
</Showcase>
|
|
98
|
+
),
|
|
99
|
+
};
|
|
100
|
+
|
|
101
|
+
export const States: Story = {
|
|
102
|
+
parameters: {
|
|
103
|
+
docs: { description: { story: 'States — unchecked, checked, disabled (whole group), partially disabled (single item).' } },
|
|
104
|
+
},
|
|
105
|
+
render: () => (
|
|
106
|
+
<Showcase>
|
|
107
|
+
<Section title="Unchecked (no defaultValue)" layout="column">
|
|
108
|
+
<RadioGroup aria-label="Unchecked group">
|
|
109
|
+
<Radio value="option1" id="s-u1" label="Option 1" />
|
|
110
|
+
<Radio value="option2" id="s-u2" label="Option 2" />
|
|
111
|
+
</RadioGroup>
|
|
112
|
+
</Section>
|
|
113
|
+
<Section title="Checked (defaultValue)" layout="column">
|
|
114
|
+
<RadioGroup defaultValue="option1" aria-label="Checked group">
|
|
115
|
+
<Radio value="option1" id="s-c1" label="Option 1" />
|
|
116
|
+
<Radio value="option2" id="s-c2" label="Option 2" />
|
|
117
|
+
</RadioGroup>
|
|
118
|
+
</Section>
|
|
119
|
+
<Section title="Whole group disabled" layout="column">
|
|
120
|
+
<RadioGroup defaultValue="option1" disabled aria-label="Disabled group">
|
|
121
|
+
<Radio value="option1" id="s-d1" label="Option 1" disabled />
|
|
122
|
+
<Radio value="option2" id="s-d2" label="Option 2" disabled />
|
|
123
|
+
</RadioGroup>
|
|
124
|
+
</Section>
|
|
125
|
+
<Section title="Partially disabled (single item)" layout="column">
|
|
126
|
+
<RadioGroup defaultValue="bank" aria-label="Payment method (partially disabled)">
|
|
127
|
+
<Radio value="bank" id="s-p1" label="Bank Transfer" />
|
|
128
|
+
<Radio value="card" id="s-p2" label="Credit Card (unavailable)" disabled />
|
|
129
|
+
<Radio value="cash" id="s-p3" label="Cash" />
|
|
130
|
+
</RadioGroup>
|
|
131
|
+
</Section>
|
|
132
|
+
</Showcase>
|
|
133
|
+
),
|
|
134
|
+
};
|
|
135
|
+
|
|
136
|
+
export const RovingFocus: Story = {
|
|
137
|
+
parameters: {
|
|
138
|
+
docs: {
|
|
139
|
+
description: {
|
|
140
|
+
story:
|
|
141
|
+
'Roving focus (roving tabindex) — the group is a single Tab stop; arrow keys move focus between items. Here the focus ring is forced (via storybook-addon-pseudo-states) on the unselected middle item to show that focus can rest on a non-selected radio mid-navigation, while the selection stays on the first item. This is what sets a RadioGroup apart from a set of independent Checkboxes.',
|
|
142
|
+
},
|
|
143
|
+
},
|
|
144
|
+
},
|
|
145
|
+
render: () => (
|
|
146
|
+
<Showcase>
|
|
147
|
+
<Section title="Focus on an unselected item (mid arrow-navigation)" layout="column">
|
|
148
|
+
<RadioGroup defaultValue="bank" aria-label="Payment method (roving focus)">
|
|
149
|
+
<Radio value="bank" id="rf-bank" label="Bank Transfer" />
|
|
150
|
+
{/* Force :focus-visible on this unselected item's native input. */}
|
|
151
|
+
<span className={FORCE_FOCUS}>
|
|
152
|
+
<Radio value="card" id="rf-card" label="Credit Card" />
|
|
153
|
+
</span>
|
|
154
|
+
<Radio value="cash" id="rf-cash" label="Cash" />
|
|
155
|
+
</RadioGroup>
|
|
156
|
+
</Section>
|
|
157
|
+
</Showcase>
|
|
158
|
+
),
|
|
159
|
+
};
|
|
160
|
+
|
|
161
|
+
export const Compositions: Story = {
|
|
162
|
+
parameters: {
|
|
163
|
+
docs: {
|
|
164
|
+
description: {
|
|
165
|
+
story:
|
|
166
|
+
'Real combinations — FieldSet + FieldLegend (preferred a11y pattern), "fake legend" with ARIA for a horizontal label next to the group, and a long list.',
|
|
167
|
+
},
|
|
168
|
+
},
|
|
169
|
+
},
|
|
170
|
+
render: () => (
|
|
171
|
+
<Showcase>
|
|
172
|
+
<Section title="FieldSet + FieldLegend (preferred)" layout="column">
|
|
173
|
+
<FieldSet>
|
|
174
|
+
<FieldLegend id="c-fs-legend">Entering Prices</FieldLegend>
|
|
175
|
+
{/* role="radiogroup" does NOT inherit the name from <legend>; point aria-labelledby at it. */}
|
|
176
|
+
<RadioGroup defaultValue="with-vat" className="flex-row" aria-labelledby="c-fs-legend">
|
|
177
|
+
<Radio value="with-vat" id="c-fs-with" label="with VAT" />
|
|
178
|
+
<Radio value="without-vat" id="c-fs-without" label="without VAT" />
|
|
179
|
+
</RadioGroup>
|
|
180
|
+
</FieldSet>
|
|
181
|
+
</Section>
|
|
182
|
+
<Section title="Fake legend (label beside group via ARIA)" layout="column">
|
|
183
|
+
<div className="flex flex-row items-center gap-500">
|
|
184
|
+
<span id="entering-prices-label" className="text-heading-h5 font-inter font-bold text-text-primary">
|
|
185
|
+
Entering Prices
|
|
186
|
+
</span>
|
|
187
|
+
<RadioGroup
|
|
188
|
+
defaultValue="with-vat"
|
|
189
|
+
className="flex-row"
|
|
190
|
+
aria-labelledby="entering-prices-label"
|
|
191
|
+
>
|
|
192
|
+
<Radio value="with-vat" id="c-fl-with" label="with VAT" />
|
|
193
|
+
<Radio value="without-vat" id="c-fl-without" label="without VAT" />
|
|
194
|
+
</RadioGroup>
|
|
195
|
+
</div>
|
|
196
|
+
</Section>
|
|
197
|
+
<Section title="Long list inside FieldSet" layout="column">
|
|
198
|
+
<FieldSet className="max-w-[calc(var(--space-1000)*10)]">
|
|
199
|
+
<FieldLegend id="c-country-legend">Select Your Country</FieldLegend>
|
|
200
|
+
<RadioGroup defaultValue="cz" aria-labelledby="c-country-legend">
|
|
201
|
+
{[
|
|
202
|
+
{ value: 'cz', label: 'Czech Republic' },
|
|
203
|
+
{ value: 'sk', label: 'Slovakia' },
|
|
204
|
+
{ value: 'de', label: 'Germany' },
|
|
205
|
+
{ value: 'at', label: 'Austria' },
|
|
206
|
+
{ value: 'pl', label: 'Poland' },
|
|
207
|
+
{ value: 'hu', label: 'Hungary' },
|
|
208
|
+
{ value: 'gb', label: 'United Kingdom' },
|
|
209
|
+
{ value: 'fr', label: 'France' },
|
|
210
|
+
{ value: 'es', label: 'Spain' },
|
|
211
|
+
{ value: 'it', label: 'Italy' },
|
|
212
|
+
].map(option => (
|
|
213
|
+
<Radio
|
|
214
|
+
key={option.value}
|
|
215
|
+
value={option.value}
|
|
216
|
+
id={`c-country-${option.value}`}
|
|
217
|
+
label={option.label}
|
|
218
|
+
/>
|
|
219
|
+
))}
|
|
220
|
+
</RadioGroup>
|
|
221
|
+
</FieldSet>
|
|
222
|
+
</Section>
|
|
223
|
+
</Showcase>
|
|
224
|
+
),
|
|
225
|
+
};
|
|
@@ -0,0 +1,139 @@
|
|
|
1
|
+
"use client";
|
|
2
|
+
import * as React from 'react';
|
|
3
|
+
import { cn } from '../../internal/utils';
|
|
4
|
+
|
|
5
|
+
/**
|
|
6
|
+
* Shared configuration a `<RadioGroup>` provides to the `<Radio>` children it
|
|
7
|
+
* wraps. `null` when a Radio is rendered outside any group.
|
|
8
|
+
*/
|
|
9
|
+
export interface RadioGroupContextValue {
|
|
10
|
+
/** Shared radio `name`, tying the children into one native roving group. */
|
|
11
|
+
name: string;
|
|
12
|
+
/** Currently selected value (controlled by the group). */
|
|
13
|
+
value?: string;
|
|
14
|
+
/** Notifies the group that a child was selected. */
|
|
15
|
+
onValueChange: (value: string) => void;
|
|
16
|
+
/** Inherited box size. */
|
|
17
|
+
size?: 'sm' | 'md';
|
|
18
|
+
/** Inherited disabled state. */
|
|
19
|
+
disabled?: boolean;
|
|
20
|
+
/** Inherited error state. */
|
|
21
|
+
error?: boolean;
|
|
22
|
+
}
|
|
23
|
+
|
|
24
|
+
export const RadioGroupContext = React.createContext<RadioGroupContextValue | null>(null);
|
|
25
|
+
|
|
26
|
+
export interface RadioGroupBaseProps
|
|
27
|
+
extends Omit<
|
|
28
|
+
React.HTMLAttributes<HTMLDivElement>,
|
|
29
|
+
'onChange' | 'defaultValue' | 'aria-label' | 'aria-labelledby'
|
|
30
|
+
> {
|
|
31
|
+
/** Selected value — makes the group controlled. */
|
|
32
|
+
value?: string;
|
|
33
|
+
/** Initial value for an uncontrolled group. */
|
|
34
|
+
defaultValue?: string;
|
|
35
|
+
/** Called with the newly selected value. */
|
|
36
|
+
onValueChange?: (value: string) => void;
|
|
37
|
+
/** Shared radio `name`; auto-generated when omitted. */
|
|
38
|
+
name?: string;
|
|
39
|
+
/** Disables every child radio. */
|
|
40
|
+
disabled?: boolean;
|
|
41
|
+
/** Box size shared by every child radio. */
|
|
42
|
+
size?: 'sm' | 'md';
|
|
43
|
+
/** Error state shared by every child radio. */
|
|
44
|
+
error?: boolean;
|
|
45
|
+
/** Layout direction. */
|
|
46
|
+
orientation?: 'vertical' | 'horizontal';
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
/**
|
|
50
|
+
* A `role="radiogroup"` must carry an accessible name (WCAG 4.1.2 / ARIA APG
|
|
51
|
+
* Radio Group) — and it does NOT inherit one from an ancestor `<fieldset>`/
|
|
52
|
+
* `<legend>`, since that names the fieldset, not a nested ARIA container. The
|
|
53
|
+
* spec (`radio.md`) requires a group label, so the contract forces exactly one
|
|
54
|
+
* of `aria-label` / `aria-labelledby` at the type level.
|
|
55
|
+
*/
|
|
56
|
+
type RadioGroupA11yName =
|
|
57
|
+
| { 'aria-label': string; 'aria-labelledby'?: never }
|
|
58
|
+
| { 'aria-labelledby': string; 'aria-label'?: never };
|
|
59
|
+
|
|
60
|
+
export type RadioGroupProps = RadioGroupBaseProps & RadioGroupA11yName;
|
|
61
|
+
|
|
62
|
+
/**
|
|
63
|
+
* RadioGroup — a native-radio group. It owns the selection state and shares it
|
|
64
|
+
* with `<Radio>` children via `RadioGroupContext`. Keyboard behaviour (roving
|
|
65
|
+
* focus, arrow keys, Space) is handled natively by the shared `name`, so no
|
|
66
|
+
* custom key handling is needed.
|
|
67
|
+
*/
|
|
68
|
+
const RadioGroup = React.forwardRef<HTMLDivElement, RadioGroupProps>(
|
|
69
|
+
(
|
|
70
|
+
{
|
|
71
|
+
value,
|
|
72
|
+
defaultValue,
|
|
73
|
+
onValueChange,
|
|
74
|
+
name,
|
|
75
|
+
disabled,
|
|
76
|
+
size,
|
|
77
|
+
error,
|
|
78
|
+
orientation = 'vertical',
|
|
79
|
+
className,
|
|
80
|
+
children,
|
|
81
|
+
...rest
|
|
82
|
+
},
|
|
83
|
+
ref,
|
|
84
|
+
) => {
|
|
85
|
+
const generatedName = React.useId();
|
|
86
|
+
const groupName = name ?? generatedName;
|
|
87
|
+
|
|
88
|
+
// Controlled when `value` is provided, otherwise track internally.
|
|
89
|
+
const isControlled = value !== undefined;
|
|
90
|
+
const [internalValue, setInternalValue] = React.useState(defaultValue);
|
|
91
|
+
const currentValue = isControlled ? value : internalValue;
|
|
92
|
+
|
|
93
|
+
const handleChange = React.useCallback(
|
|
94
|
+
(next: string) => {
|
|
95
|
+
if (!isControlled) {
|
|
96
|
+
setInternalValue(next);
|
|
97
|
+
}
|
|
98
|
+
onValueChange?.(next);
|
|
99
|
+
},
|
|
100
|
+
[isControlled, onValueChange],
|
|
101
|
+
);
|
|
102
|
+
|
|
103
|
+
const contextValue = React.useMemo<RadioGroupContextValue>(
|
|
104
|
+
() => ({
|
|
105
|
+
name: groupName,
|
|
106
|
+
value: currentValue,
|
|
107
|
+
onValueChange: handleChange,
|
|
108
|
+
size,
|
|
109
|
+
disabled,
|
|
110
|
+
error,
|
|
111
|
+
}),
|
|
112
|
+
[groupName, currentValue, handleChange, size, disabled, error],
|
|
113
|
+
);
|
|
114
|
+
|
|
115
|
+
return (
|
|
116
|
+
<RadioGroupContext.Provider value={contextValue}>
|
|
117
|
+
<div
|
|
118
|
+
ref={ref}
|
|
119
|
+
role="radiogroup"
|
|
120
|
+
// `error` is a GROUP-level state — spec/03-atoms/radio.md:73 says the
|
|
121
|
+
// danger cue means "nothing chosen in a required group", never an
|
|
122
|
+
// individual radio, and :87 requires it to be announced on the group via
|
|
123
|
+
// aria-invalid. Without this the error is carried by colour alone
|
|
124
|
+
// (WCAG 1.4.1) — the children's red borders are the second cue, not the
|
|
125
|
+
// first. The message itself belongs to the wrapping Field.
|
|
126
|
+
aria-invalid={error || undefined}
|
|
127
|
+
// Default `gap-400` rhythm between items, per the Figma group spec.
|
|
128
|
+
className={cn('flex gap-400', orientation === 'horizontal' ? 'flex-row' : 'flex-col', className)}
|
|
129
|
+
{...rest}
|
|
130
|
+
>
|
|
131
|
+
{children}
|
|
132
|
+
</div>
|
|
133
|
+
</RadioGroupContext.Provider>
|
|
134
|
+
);
|
|
135
|
+
},
|
|
136
|
+
);
|
|
137
|
+
RadioGroup.displayName = 'RadioGroup';
|
|
138
|
+
|
|
139
|
+
export { RadioGroup };
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export { RadioGroup, RadioGroupContext, type RadioGroupProps } from './RadioGroup';
|