@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,436 @@
|
|
|
1
|
+
import { Meta, Canvas, Controls } from '@storybook/addon-docs/blocks';
|
|
2
|
+
import * as FormSectionStories from './FormSection.stories';
|
|
3
|
+
import { ViewportFrame } from '../../storybook/viewportFrame';
|
|
4
|
+
|
|
5
|
+
<Meta of={FormSectionStories} tags={['autodocs']} />
|
|
6
|
+
|
|
7
|
+
# FormSection
|
|
8
|
+
|
|
9
|
+
## Metadata
|
|
10
|
+
|
|
11
|
+
- **Layer:** organism
|
|
12
|
+
- **Kind:** region
|
|
13
|
+
- **Status:** draft
|
|
14
|
+
- **Tokens used:** `--font-body`, `--font-decorative`, `--font-size-4xl`, `--font-size-base`, `--font-size-display-d1`, `--font-size-display-d2`, `--font-size-display-d3`, `--font-size-heading-h1`, `--font-size-heading-h2`, `--font-size-heading-h3`, `--font-size-heading-h4`, `--font-size-heading-h5`, `--font-size-lg`, `--font-size-md`, `--font-size-sm`, `--leading-compact`, `--leading-loose`, `--leading-relaxed`, `--leading-tight`, `--secondary`, `--size-icon`, `--size-illustration-spot`, `--space-1000`, `--space-200`, `--space-400`, `--space-600`, `--space-700`, `--space-800`, `--space-900`, `--text-secondary`, `--text-wrap-body`
|
|
15
|
+
- **Manifest version:** `2.0.0`
|
|
16
|
+
- **Composes:** [HeadingGroup](?path=/docs/design-system-molecules-headinggroup--docs) (manifest `slots.header.ref` → `heading-group`); the fields are the caller's children (manifest `slots.fields.accepts`)
|
|
17
|
+
|
|
18
|
+
The token list above covers the component and everything it renders (the nested
|
|
19
|
+
HeadingGroup contributes the type and ink tokens). The section's own values are the five spacing
|
|
20
|
+
tokens `--space-600` … `--space-1000` of `chrome.header-gap`, `chrome.field-grid`, `chrome.trio` and
|
|
21
|
+
`chrome.nested-pair`.
|
|
22
|
+
|
|
23
|
+
## Overview
|
|
24
|
+
|
|
25
|
+
**FormSection** is one group of fields inside a Form Block: an optional heading over a responsive
|
|
26
|
+
field grid of halves, pairs and trio rows that fills row by row, in the order the fields are read.
|
|
27
|
+
It paints no surface — the Form Block owns the tile — and only lays out.
|
|
28
|
+
|
|
29
|
+
`header` picks the shape of the group:
|
|
30
|
+
|
|
31
|
+
- **`none`** (default, the common case) — the block's only group. No heading of its own; the Form
|
|
32
|
+
Block's header names it.
|
|
33
|
+
- **`h4`** — one of two or more sub-groups under one block header. An H4 heading, never a picture;
|
|
34
|
+
the description is optional.
|
|
35
|
+
- **`h3`** — **deprecated**. Only for the deprecated parties tile, where the block hides its own header
|
|
36
|
+
and each party section carries a pictured H3. A new screen gives each party its own Form Block.
|
|
37
|
+
|
|
38
|
+
Do **not** use it for a set of radios or checkboxes that answer one question (that is the control
|
|
39
|
+
group pattern, placed inside a section as one grid child), and not for the line items
|
|
40
|
+
(a Form Block at `content="stack"` — see [Form Block → Line items](?path=/docs/design-system-organisms-form-block--docs#line-items)).
|
|
41
|
+
|
|
42
|
+
## Rationale
|
|
43
|
+
|
|
44
|
+
A form page repeats one unit — a group of fields — and every copy needs the same heading gap, the
|
|
45
|
+
same tracks and the same stacking order. The fields sit on a real grid that fills row by row in
|
|
46
|
+
child order, so the desktop layout and the phone stack are one sequence and tab order follows it.
|
|
47
|
+
Three shapes that would otherwise look arbitrary come from the spec:
|
|
48
|
+
|
|
49
|
+
- **The field grid has 2 tracks; three short fields form a trio.** A child is a half or the full
|
|
50
|
+
width, which keeps every field the same width in every row. Three related short fields share a row
|
|
51
|
+
through a nested 3-track trio, so the grid itself never needs a third track.
|
|
52
|
+
- **`h4` never takes a picture** — the section accepts a picture only at the deprecated `h3` header (`illustration` is typed `never` at `h4`).
|
|
53
|
+
- **A pair or a trio never holds another grid** — one nested grid level keeps the reading order linear.
|
|
54
|
+
|
|
55
|
+
## Anatomy
|
|
56
|
+
|
|
57
|
+
At `header="none"` the section element **is** the field grid. At `h4` / `h3` it is a vertical stack
|
|
58
|
+
of the header and one field grid, separated by the header gap, with no wrapper between that grid and
|
|
59
|
+
the fields. No part paints a fill, border, radius, shadow or padding.
|
|
60
|
+
|
|
61
|
+
<table>
|
|
62
|
+
<thead>
|
|
63
|
+
<tr><th>Part</th><th>Element</th><th>Role</th><th>Tokens</th></tr>
|
|
64
|
+
</thead>
|
|
65
|
+
<tbody>
|
|
66
|
+
<tr>
|
|
67
|
+
<td><code>root</code></td><td><code><div role="group"></code></td>
|
|
68
|
+
<td>Only at <code>h4</code> / <code>h3</code>. Column: <code>header</code>, then <code>field-grid</code>. Carries <code>data-fods-component="form-section"</code>, <code>aria-labelledby</code> and (with a description) <code>aria-describedby</code>.</td>
|
|
69
|
+
<td>header gap (<code>chrome.header-gap</code>): <code>h4</code> <code>--space-600</code> below MD / <code>--space-800</code> from MD; <code>h3</code> <code>--space-800</code> / <code>--space-900</code></td>
|
|
70
|
+
</tr>
|
|
71
|
+
<tr>
|
|
72
|
+
<td><code>header</code></td><td>HeadingGroup root <code><div></code></td>
|
|
73
|
+
<td>Only at <code>h4</code> / <code>h3</code>. The nested HeadingGroup at <code>size</code> = <code>header</code>, fed <code>title</code>, <code>description</code>, the illustration (<code>h3</code> only) and the heading / description ids.</td>
|
|
74
|
+
<td>HeadingGroup's own ladder</td>
|
|
75
|
+
</tr>
|
|
76
|
+
<tr>
|
|
77
|
+
<td><code>field-grid</code></td><td><code><div></code></td>
|
|
78
|
+
<td>The grid the children sit on: <code>grid-cols-1</code> below MD, <code>md:grid-cols-2</code> (equal <code>minmax(0, 1fr)</code> tracks), <code>grid-flow-row</code>, <code>items-start</code>, every child <code>min-w-0</code>. At <code>header="none"</code> this is the component root.</td>
|
|
79
|
+
<td>row gap <code>--space-700</code> below MD / <code>--space-900</code> from MD; column gap <code>--space-900</code> at MD / <code>--space-1000</code> at LG/XL</td>
|
|
80
|
+
</tr>
|
|
81
|
+
<tr>
|
|
82
|
+
<td><code>cell</code></td><td><code><div></code> (<code>FormSection.Cell</code>)</td>
|
|
83
|
+
<td>Optional wrapper that sets a child's width in the field grid: <code>min-w-0</code> plus the resolved column span.</td>
|
|
84
|
+
<td>—</td>
|
|
85
|
+
</tr>
|
|
86
|
+
<tr>
|
|
87
|
+
<td><code>trio</code></td><td><code><div></code> (<code>FormSection.Trio</code>)</td>
|
|
88
|
+
<td>One full-width child (<code>col-span-full</code>) holding a nested grid of three fields: 1 track below MD, 2 at MD (the third field wraps under the first), 3 at LG/XL.</td>
|
|
89
|
+
<td>row gap <code>--space-700</code> below MD / <code>--space-900</code> at MD; column gap <code>--space-800</code> from MD</td>
|
|
90
|
+
</tr>
|
|
91
|
+
<tr>
|
|
92
|
+
<td><code>pair</code></td><td><code><div></code> (<code>FormSection.Pair</code>)</td>
|
|
93
|
+
<td>One half holding a nested grid of two fields: 1 track at Mobile, 2 tracks from SM.</td>
|
|
94
|
+
<td>row gap <code>--space-700</code> at Mobile; column gap <code>--space-600</code> at SM / <code>--space-800</code> from MD</td>
|
|
95
|
+
</tr>
|
|
96
|
+
</tbody>
|
|
97
|
+
</table>
|
|
98
|
+
|
|
99
|
+
The `header` part is the HeadingGroup's own root renamed by the section, so it carries both
|
|
100
|
+
`data-fods-component="heading-group"` and `data-fods-part="header"`.
|
|
101
|
+
|
|
102
|
+
## Variants
|
|
103
|
+
|
|
104
|
+
One axis in code — `header` (manifest `axes.variant`: None · H4 · H3), a dedicated prop rather than
|
|
105
|
+
`variant`. The manifest's second axis, Breakpoint, is not a prop (see Sizes). The fields are the one
|
|
106
|
+
slot (`children`).
|
|
107
|
+
|
|
108
|
+
{/* Docs canvases render inline at the column width, where the viewport media queries follow the
|
|
109
|
+
browser window — so the matrix is also framed at its real viewport and scaled to fit. */}
|
|
110
|
+
<Canvas of={FormSectionStories.Matrix} />
|
|
111
|
+
|
|
112
|
+
<ViewportFrame storyId="design-system-organisms-form-section--matrix" width={1280} label="Matrix · XL — viewport 1280" />
|
|
113
|
+
<ViewportFrame storyId="design-system-organisms-form-section--matrix" width={390} label="Matrix · Mobile — viewport 390" />
|
|
114
|
+
|
|
115
|
+
<table>
|
|
116
|
+
<thead>
|
|
117
|
+
<tr><th><code>header</code></th><th>Renders</th><th>Heading element</th><th>When</th><th>Header gap</th></tr>
|
|
118
|
+
</thead>
|
|
119
|
+
<tbody>
|
|
120
|
+
<tr>
|
|
121
|
+
<td><code>none</code> (default)</td>
|
|
122
|
+
<td>The field grid only — a plain <code><div></code>, no role</td>
|
|
123
|
+
<td>none</td>
|
|
124
|
+
<td>The block's only group; the Form Block header names it</td>
|
|
125
|
+
<td>none</td>
|
|
126
|
+
</tr>
|
|
127
|
+
<tr>
|
|
128
|
+
<td><code>h4</code></td>
|
|
129
|
+
<td>HeadingGroup <code>size="h4"</code>, no picture; description optional</td>
|
|
130
|
+
<td><code>h3</code> (override with <code>headingLevel</code>)</td>
|
|
131
|
+
<td>One of two or more sub-groups under one block header</td>
|
|
132
|
+
<td><code>--space-600</code> below MD, <code>--space-800</code> from MD</td>
|
|
133
|
+
</tr>
|
|
134
|
+
<tr>
|
|
135
|
+
<td><code>h3</code> (<code>@deprecated</code>)</td>
|
|
136
|
+
<td>HeadingGroup <code>size="h3"</code> with a required <code>Illustration / Section</code> picture; description optional</td>
|
|
137
|
+
<td><code>h2</code> (override with <code>headingLevel</code>)</td>
|
|
138
|
+
<td>Legacy parties tile only</td>
|
|
139
|
+
<td><code>--space-800</code> below MD, <code>--space-900</code> from MD</td>
|
|
140
|
+
</tr>
|
|
141
|
+
</tbody>
|
|
142
|
+
</table>
|
|
143
|
+
|
|
144
|
+
`title`, `description` and `illustration` are typed as a discriminated union on `header`: at
|
|
145
|
+
`none` none of them is accepted, at `h4` `title` is required and `illustration` is not accepted, at
|
|
146
|
+
`h3` both `title` and `illustration` are required.
|
|
147
|
+
|
|
148
|
+
### Children: halves, Cell, Pair, Trio
|
|
149
|
+
|
|
150
|
+
<Canvas of={FormSectionStories.WithTrio} />
|
|
151
|
+
|
|
152
|
+
<Canvas of={FormSectionStories.WithPair} />
|
|
153
|
+
|
|
154
|
+
<table>
|
|
155
|
+
<thead>
|
|
156
|
+
<tr><th>Child</th><th>Width in the field grid</th><th>In code</th></tr>
|
|
157
|
+
</thead>
|
|
158
|
+
<tbody>
|
|
159
|
+
<tr><td>Half (default)</td><td>1 track</td><td>a bare child, no Cell needed</td></tr>
|
|
160
|
+
<tr><td>Full width</td><td>all tracks (<code>col-span-full</code>)</td><td><code><FormSection.Cell span="full"></code></td></tr>
|
|
161
|
+
<tr><td>Per-breakpoint width</td><td>a different span per breakpoint, e.g. <code>{"{ md: 'full', lg: 1 }"}</code> — full at MD, a half at LG/XL</td><td><code>FormSection.Cell</code> with a per-breakpoint <code>span</code> object (see API)</td></tr>
|
|
162
|
+
<tr><td>Pair — two short fields in one half</td><td>1 track</td><td><code><FormSection.Pair></code>, exactly two children</td></tr>
|
|
163
|
+
<tr><td>Trio — three short fields in one row</td><td>full width</td><td><code><FormSection.Trio></code>, exactly three children</td></tr>
|
|
164
|
+
</tbody>
|
|
165
|
+
</table>
|
|
166
|
+
|
|
167
|
+
`FormSection.Pair` and `FormSection.Trio` type their `children` as a 2- and 3-tuple; outside
|
|
168
|
+
production they also log a `console.error` when the child count is wrong.
|
|
169
|
+
|
|
170
|
+
### Illustrations (deprecated `h3`)
|
|
171
|
+
|
|
172
|
+
<Canvas of={FormSectionStories.Illustrations} />
|
|
173
|
+
|
|
174
|
+
The package ships no picture (manifest 1.3.0 `delivery.react`): `illustration` is a React element
|
|
175
|
+
the app supplies — its own copy of the `Illustration / Section` picture as `<img src={…} alt="" />` or
|
|
176
|
+
an inline SVG. The section passes it to HeadingGroup, which draws it in its `aria-hidden="true"`
|
|
177
|
+
picture box; the section owns only that box. Which picture goes with which heading is in the
|
|
178
|
+
upstream `spec/03-atoms/illustrations.md` (Variants); how an app supplies pictures:
|
|
179
|
+
[Consuming → Assets](?path=/docs/getting-started-consuming--docs#assets). The stories pass the five
|
|
180
|
+
`Illustration / Section` pictures this way.
|
|
181
|
+
|
|
182
|
+
## Sizes
|
|
183
|
+
|
|
184
|
+
**There is no size axis.** Breakpoint is the size dimension and it is **not a prop**: the section
|
|
185
|
+
reads the viewport media queries, exactly like its Form Block — Mobile unprefixed, SM `sm:`, MD
|
|
186
|
+
`md:`, LG `lg:`. Every XL value equals its LG value, so `lg:` covers XL too. The Breakpoint stories
|
|
187
|
+
pin the viewport to each band minimum (1280 / 1024 / 768 / 640) and the 390 Mobile canvas.
|
|
188
|
+
|
|
189
|
+
{/* Docs canvases render inline at the column width, where no breakpoint applies — so the
|
|
190
|
+
Breakpoint stories are framed at their real viewport and scaled to fit. */}
|
|
191
|
+
<ViewportFrame storyId="design-system-organisms-form-section--breakpoint-xl" width={1280} label="Breakpoint · XL — viewport 1280" />
|
|
192
|
+
<ViewportFrame storyId="design-system-organisms-form-section--breakpoint-lg" width={1024} label="Breakpoint · LG — viewport 1024" />
|
|
193
|
+
<ViewportFrame storyId="design-system-organisms-form-section--breakpoint-md" width={768} label="Breakpoint · MD — viewport 768" />
|
|
194
|
+
<ViewportFrame storyId="design-system-organisms-form-section--breakpoint-sm" width={640} label="Breakpoint · SM — viewport 640" />
|
|
195
|
+
<ViewportFrame storyId="design-system-organisms-form-section--breakpoint-mobile" width={390} label="Breakpoint · Mobile — viewport 390" />
|
|
196
|
+
|
|
197
|
+
<table>
|
|
198
|
+
<thead>
|
|
199
|
+
<tr>
|
|
200
|
+
<th>Breakpoint</th>
|
|
201
|
+
<th>Field grid</th>
|
|
202
|
+
<th>Trio</th>
|
|
203
|
+
<th>Pair</th>
|
|
204
|
+
<th>Header gap · <code>h4</code> / <code>h3</code></th>
|
|
205
|
+
</tr>
|
|
206
|
+
</thead>
|
|
207
|
+
<tbody>
|
|
208
|
+
<tr>
|
|
209
|
+
<td>XL, LG</td>
|
|
210
|
+
<td>2 tracks (1 at <code>span=1</code>); column <code>--space-1000</code>, row <code>--space-900</code></td>
|
|
211
|
+
<td>3 tracks; column <code>--space-800</code></td>
|
|
212
|
+
<td>2 tracks; column <code>--space-800</code></td>
|
|
213
|
+
<td><code>--space-800</code> / <code>--space-900</code></td>
|
|
214
|
+
</tr>
|
|
215
|
+
<tr>
|
|
216
|
+
<td>MD</td>
|
|
217
|
+
<td>2 tracks; column <code>--space-900</code>, row <code>--space-900</code></td>
|
|
218
|
+
<td>2 tracks; column <code>--space-800</code>, row <code>--space-900</code></td>
|
|
219
|
+
<td>2 tracks; column <code>--space-800</code></td>
|
|
220
|
+
<td><code>--space-800</code> / <code>--space-900</code></td>
|
|
221
|
+
</tr>
|
|
222
|
+
<tr>
|
|
223
|
+
<td>SM</td>
|
|
224
|
+
<td>1 track; row <code>--space-700</code></td>
|
|
225
|
+
<td>1 track; row <code>--space-700</code></td>
|
|
226
|
+
<td>2 tracks; column <code>--space-600</code></td>
|
|
227
|
+
<td><code>--space-600</code> / <code>--space-800</code></td>
|
|
228
|
+
</tr>
|
|
229
|
+
<tr>
|
|
230
|
+
<td>Mobile</td>
|
|
231
|
+
<td>1 track; row <code>--space-700</code></td>
|
|
232
|
+
<td>1 track; row <code>--space-700</code></td>
|
|
233
|
+
<td>1 track; row <code>--space-700</code></td>
|
|
234
|
+
<td><code>--space-600</code> / <code>--space-800</code></td>
|
|
235
|
+
</tr>
|
|
236
|
+
</tbody>
|
|
237
|
+
</table>
|
|
238
|
+
|
|
239
|
+
- **Gap law** (manifest 1.1.0): fields side by side inside one row (a pair or a trio) are
|
|
240
|
+
`--space-800` apart from MD up; the two columns of the field grid are `--space-1000` apart at LG/XL
|
|
241
|
+
(`--space-900` at MD).
|
|
242
|
+
- **`span`** is the section's own width in the Form Block grid: the root gets `col-span-full`, and
|
|
243
|
+
`span={1}` adds `lg:col-span-1` (one block-grid track at LG/XL) plus `lg:grid-cols-1`, so that
|
|
244
|
+
section runs its fields on one track. Below LG every section is full width.
|
|
245
|
+
- **Widths come from tracks**, never from px. An input stays at or under ~768 px — an authoring rule
|
|
246
|
+
(the manifest's width marker), not a clamp: at LG/XL a field that would go full width takes a half,
|
|
247
|
+
e.g. `FormSection.Cell span={{ md: 'full', lg: 1 }}` in the `h4` default content.
|
|
248
|
+
- **Fields stay Size md** at every breakpoint; the grid reflows, the controls keep their size.
|
|
249
|
+
|
|
250
|
+
Reference widths the manifest draws the variants at (`sizes[]`, the Form Block's content box):
|
|
251
|
+
XL 1110 (535 at a 1-track span), LG 864 (412), MD 624, SM 592, Mobile 358. The stories wrap the
|
|
252
|
+
section in a page pad, not a Form Block, so they do not reproduce these widths.
|
|
253
|
+
|
|
254
|
+
## States
|
|
255
|
+
|
|
256
|
+
FormSection has **no state axis** (manifest `intent.states`). Focus, error, disabled and read-only
|
|
257
|
+
live on the fields; nothing in the section is interactive, so there is no disabled propagation and
|
|
258
|
+
no `States` story. The grid reserves no helper space: a validation message under a field pushes the
|
|
259
|
+
rows below it down (cells align to the top, `items-start`), while its neighbour in the row stays put:
|
|
260
|
+
|
|
261
|
+
<Canvas of={FormSectionStories.ErrorInRow} />
|
|
262
|
+
|
|
263
|
+
**Motion: none of its own.** Manifest 1.2.1 `motion.none`: „structure only; the fields inside carry the motion“, with
|
|
264
|
+
`inherits` listing every accepted fields-slot child that owns motion — Text Field, Select Field, Combobox Field, Number
|
|
265
|
+
Field, Unit Field, Textarea, File Upload, Subject Lookup Field, Checkbox, Radio, Card Select and Table. Each brings its
|
|
266
|
+
own motion and documents it on its own page; the section adds no transition around them (a validation message pushing
|
|
267
|
+
the next row down reflows at once).
|
|
268
|
+
|
|
269
|
+
## API
|
|
270
|
+
|
|
271
|
+
<Controls of={FormSectionStories.Playground} />
|
|
272
|
+
|
|
273
|
+
- **`header`** (`'none' | 'h4' | 'h3'`, default `'none'`) — the heading the section carries; `'h3'`
|
|
274
|
+
is marked `@deprecated`.
|
|
275
|
+
- **`title`** (`string`) — the heading text; required at `h4` / `h3`, not accepted at `none`.
|
|
276
|
+
- **`description`** (`string`, optional) — the line under the heading; only `h4` / `h3`. An empty
|
|
277
|
+
string renders no `aria-describedby`.
|
|
278
|
+
- **`illustration`** (`React.ReactElement`) — the `Illustration / Section` picture the app supplies
|
|
279
|
+
(`<img src={…} alt="" />` or an inline SVG); required at `h3`, not accepted otherwise.
|
|
280
|
+
- **`headingLevel`** (`2`–`6`, optional) — the heading element; defaults to `3` at `h4`, `2` at `h3`.
|
|
281
|
+
- **`span`** (`1 | 'full'`, default `'full'`) — the section's width in the Form Block grid
|
|
282
|
+
(`col-span-full`, plus `lg:col-span-1` at `1`); `1` also runs the fields on one track at LG/XL.
|
|
283
|
+
- **`children`** — the fields, in mobile reading order.
|
|
284
|
+
- Every other `<div>` attribute (including `className`) goes to the root; `ref` points to the root
|
|
285
|
+
(`forwardRef`). At `header="none"` the root is the field grid.
|
|
286
|
+
|
|
287
|
+
Subcomponents:
|
|
288
|
+
|
|
289
|
+
- **`FormSection.Cell`** — **`span`** (`1 | 'full' | Partial<Record<'mobile' | 'sm' | 'md' | 'lg' | 'xl', 1 | 'full'>>`,
|
|
290
|
+
default `1`) — how many field-grid tracks the child takes: `1` is one track (a half where the
|
|
291
|
+
grid has two), `'full'` is all tracks (`col-span-full`).
|
|
292
|
+
- **Per-breakpoint object** — a different span per breakpoint. It reads **desktop-first**: a
|
|
293
|
+
breakpoint you leave out takes the value of the next *larger* one, and XL, when left out, is
|
|
294
|
+
`1`. That is the opposite of Tailwind prefixes, so `{ md: 'full' }` means full at MD, SM and
|
|
295
|
+
Mobile, and a half at LG/XL.
|
|
296
|
+
- Only MD–XL can show a difference: below MD the field grid has one track, so `mobile` / `sm`
|
|
297
|
+
change nothing visible; in a section at `span={1}` the grid is one track at LG/XL as well.
|
|
298
|
+
- Typical use — keep an input at or under ~768 px: `span={{ md: 'full', lg: 1 }}` is full width
|
|
299
|
+
at MD and a half at LG/XL (table below).
|
|
300
|
+
- **`FormSection.Trio`** — exactly three children.
|
|
301
|
+
- **`FormSection.Pair`** — exactly two children.
|
|
302
|
+
|
|
303
|
+
<table>
|
|
304
|
+
<thead>
|
|
305
|
+
<tr><th><code>{"span={{ md: 'full', lg: 1 }}"}</code></th><th>XL</th><th>LG</th><th>MD</th><th>SM</th><th>Mobile</th></tr>
|
|
306
|
+
</thead>
|
|
307
|
+
<tbody>
|
|
308
|
+
<tr><td>Resolved value</td><td><code>1</code> (default)</td><td><code>1</code></td><td><code>'full'</code></td><td><code>'full'</code> (from MD)</td><td><code>'full'</code> (from MD)</td></tr>
|
|
309
|
+
<tr><td>Rendered</td><td>a half</td><td>a half</td><td>the whole row</td><td>full (1-track grid)</td><td>full (1-track grid)</td></tr>
|
|
310
|
+
</tbody>
|
|
311
|
+
</table>
|
|
312
|
+
|
|
313
|
+
The Controls table drives the story's flat args; the stories' render turns them into the right arm
|
|
314
|
+
of the `header` union.
|
|
315
|
+
|
|
316
|
+
## Do / Don't
|
|
317
|
+
|
|
318
|
+
- ✅ Run a block's only group at `header="none"`; the block header names it.
|
|
319
|
+
- ✅ Use `header="h4"` for two or more sub-groups under one block header, without a picture.
|
|
320
|
+
- ✅ Write children in the order they should read on a phone; a left/right neighbour is the next child.
|
|
321
|
+
- ✅ Size a field by its span: a half (the default) or `FormSection.Cell span="full"`.
|
|
322
|
+
- ✅ Give an input a half where the section is wider than ~768 px (LG/XL at full block width); send a Table full width always.
|
|
323
|
+
- ✅ Put two short fields whose labels fit one line into `FormSection.Pair`, three short related fields into `FormSection.Trio`.
|
|
324
|
+
- ✅ Keep fields and selection controls at Size md at every breakpoint.
|
|
325
|
+
- ✅ Enter radios, checkboxes and card selects that answer one question as one control group child.
|
|
326
|
+
- ✅ Keep each field's own label; the heading names the group, not the fields.
|
|
327
|
+
- ❌ Don't give a lone group a heading of its own.
|
|
328
|
+
- ❌ Don't use `header="h3"` in new work — give each party its own Form Block.
|
|
329
|
+
- ❌ Don't let a child's visual position differ from its child order, or reorder with a positive `tabindex`.
|
|
330
|
+
- ❌ Don't set a px width on a field.
|
|
331
|
+
- ❌ Don't use Field Pair for them, nest a grid inside a pair or a trio, or put four or more fields in a trio.
|
|
332
|
+
- ❌ Don't add a wrapper between the grid and the fields, or reserve empty helper space under a field.
|
|
333
|
+
- ❌ Don't wrap a section in `fieldset` / `legend` — the named group is `role="group"`.
|
|
334
|
+
|
|
335
|
+
## Accessibility
|
|
336
|
+
|
|
337
|
+
- **Keyboard** — the section adds no key handling and no focusable element. DOM order, child order
|
|
338
|
+
and row-major grid order (`grid-flow-row`, never dense) are one sequence, so tab order follows the
|
|
339
|
+
mobile reading order row by row. The section does not clip, so a field's focus ring at the grid's
|
|
340
|
+
edge is not cut off.
|
|
341
|
+
- **ARIA** — at `header="none"` the section is a plain `<div>` with no role; the Form Block names
|
|
342
|
+
the group. At `h4` / `h3` the root is `role="group"` with `aria-labelledby` pointing at the heading
|
|
343
|
+
and, when `description` is non-empty, `aria-describedby` pointing at the description `<p>`. Both ids
|
|
344
|
+
come from `useId` and reach the HeadingGroup through its `headingId` / `descriptionId` props. The
|
|
345
|
+
description `<p>` is a sibling of the heading, so the group's name is the title alone.
|
|
346
|
+
- **Heading level** — `h3` at `h4`, `h2` at `h3`, independent of the visual size; pass
|
|
347
|
+
`headingLevel` when the page outline needs another level.
|
|
348
|
+
- **Illustration** — decorative: the app's element sits inside HeadingGroup's `aria-hidden="true"`
|
|
349
|
+
box, so an `<img>` takes `alt=""` and the title names the group.
|
|
350
|
+
- **Screen reader** — at `h4` / `h3` the group is announced with its heading as its name and the
|
|
351
|
+
description as its description. The section adds no live region; a validation message is announced
|
|
352
|
+
by the field that owns it. Each field keeps its own label and accessible name.
|
|
353
|
+
- **Contrast & motion** — the section paints nothing; heading and description ink are HeadingGroup's
|
|
354
|
+
(description `--text-secondary`). No animation of its own (manifest `motion.none`; the fields carry theirs).
|
|
355
|
+
|
|
356
|
+
The manifest has no `focus` block.
|
|
357
|
+
Accessibility floor: `spec/01-foundations/accessibility.md`.
|
|
358
|
+
|
|
359
|
+
## Usage
|
|
360
|
+
|
|
361
|
+
```tsx
|
|
362
|
+
import { Field, FormSection, TextField } from '@invoiceonline/ui-react';
|
|
363
|
+
|
|
364
|
+
// A block's only group: the section is the grid itself.
|
|
365
|
+
<FormSection>
|
|
366
|
+
<Field label="Číslo" size="md"><TextField id="doc-number" size="md" /></Field>
|
|
367
|
+
<Field label="Číslo dokladu" size="md"><TextField id="doc-ref" size="md" /></Field>
|
|
368
|
+
<Field label="Ulice" size="md"><TextField id="street" size="md" /></Field>
|
|
369
|
+
<FormSection.Pair>
|
|
370
|
+
<Field label="PSČ" size="md"><TextField id="zip" size="md" /></Field>
|
|
371
|
+
<Field label="Město" size="md"><TextField id="city" size="md" /></Field>
|
|
372
|
+
</FormSection.Pair>
|
|
373
|
+
<FormSection.Trio>
|
|
374
|
+
<Field label="Jméno nebo název" size="md"><TextField id="name" size="md" defaultValue="Acme s.r.o." /></Field>
|
|
375
|
+
<Field label="IČO" size="md"><TextField id="ico" size="md" defaultValue="12345678" /></Field>
|
|
376
|
+
<Field label="DIČ" size="md"><TextField id="dic" size="md" /></Field>
|
|
377
|
+
</FormSection.Trio>
|
|
378
|
+
</FormSection>
|
|
379
|
+
|
|
380
|
+
// A sub-group with an H4 heading (an h3 element); a half at LG/XL, full width at MD.
|
|
381
|
+
<FormSection header="h4" title="Prodejce na dokladu" description="… neboli Dodavatel">
|
|
382
|
+
<FormSection.Cell span={{ md: 'full', lg: 1 }}>
|
|
383
|
+
<Field label="Prodejce" size="md"><TextField id="seller" size="md" /></Field>
|
|
384
|
+
</FormSection.Cell>
|
|
385
|
+
</FormSection>
|
|
386
|
+
```
|
|
387
|
+
|
|
388
|
+
```tsx
|
|
389
|
+
// Don't: a wrapper between the grid and the fields, a px width on a field.
|
|
390
|
+
<FormSection>
|
|
391
|
+
<div className="flex">
|
|
392
|
+
<TextField className="w-[900px]" />
|
|
393
|
+
</div>
|
|
394
|
+
</FormSection>
|
|
395
|
+
|
|
396
|
+
// Don't: four fields in a trio — the tuple type rejects it, and dev logs a console.error.
|
|
397
|
+
<FormSection.Trio>{fourFields}</FormSection.Trio>
|
|
398
|
+
```
|
|
399
|
+
|
|
400
|
+
## Related
|
|
401
|
+
|
|
402
|
+
- [HeadingGroup](?path=/docs/design-system-molecules-headinggroup--docs) — the nested header;
|
|
403
|
+
`headingId` / `descriptionId` exist for this component's `aria-labelledby` / `aria-describedby`.
|
|
404
|
+
- [Field](?path=/docs/design-system-atoms-field--docs) and
|
|
405
|
+
[TextField](?path=/docs/design-system-atoms-textfield--docs) — the stories' default field content.
|
|
406
|
+
- [FieldPair](?path=/docs/design-system-molecules-fieldpair--docs) — the fused od–do range; not the
|
|
407
|
+
same as `FormSection.Pair`.
|
|
408
|
+
- Spec: `spec/05-organisms/form-section.md`
|
|
409
|
+
(parent tile: `spec/05-organisms/form-block.md`).
|
|
410
|
+
|
|
411
|
+
## Migration notes
|
|
412
|
+
|
|
413
|
+
**Manifest 1.3.0 → 2.0.0 (2026-11-17) — the same change, recorded as a major.** The manifest now records this change as a major: it breaks the implementation already built against 1.x in the existing Storybook, and `delivery.migration` lists the steps. The code here already takes the element; nothing else changes.
|
|
414
|
+
|
|
415
|
+
**Manifest 1.2.1 → 1.3.0 (2026-11-13) — the app supplies the picture.** `delivery.react`: the
|
|
416
|
+
illustration is a React element the consumer supplies; the component ships no picture and owns only
|
|
417
|
+
its box. In code `illustration` at `header="h3"` changes from a name to a `React.ReactElement`, and
|
|
418
|
+
`SECTION_ILLUSTRATIONS`, `FormSection.illustrations` and the `FormSectionIllustration` type are
|
|
419
|
+
removed. Replace `illustration="document-info"` with `illustration={<img src={documentInfo} alt="" />}`,
|
|
420
|
+
`documentInfo` being the app's own copy of that picture.
|
|
421
|
+
|
|
422
|
+
**Stable + motion (manifest 1.2.0 / 1.2.1, 2026-11-03) — documentation only.** 1.2.0 marks the organism ready (status
|
|
423
|
+
draft → stable, no design, token or measurement change); 1.2.1 records the motion audit — the section is static and
|
|
424
|
+
lists the children whose motion applies (see [States](#states)). No code change. **Local status stays `draft`** (decided 2026-11-10): the upstream status is information only; this build marks a component stable by its own criterion.
|
|
425
|
+
|
|
426
|
+
No earlier React component is replaced — FormSection is new in this codebase. From the upstream
|
|
427
|
+
spec: the spec and its manifest own the field-area rules (tracks, gaps, field-to-field rhythm, the
|
|
428
|
+
nested grid and the sub-group header); `form-layout.md` is the page recipe, and for the field area
|
|
429
|
+
this spec applies. List a section's fields row by row, so the neighbours in a row are consecutive
|
|
430
|
+
children.
|
|
431
|
+
|
|
432
|
+
Manifest 1.1.0 (2026-10-12): "Pair column gap 16 → 24 at XL/LG/MD (16 kept at SM), matching the
|
|
433
|
+
trio; gap law recorded — in-row neighbours 24, field-grid columns 40."
|
|
434
|
+
|
|
435
|
+
**Known deviation in the stories:** the `h4` default content uses a Field + TextField in place of
|
|
436
|
+
the Subject Lookup Field.
|