@invoiceonline/ui-react 0.0.0-stage → 0.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +99 -0
- package/CHANGELOG.md +131 -0
- package/LICENSE +9 -0
- package/README.md +78 -2
- package/dist/assets/label-brush-1.svg +6 -0
- package/dist/assets/pattern-dark.svg +113 -0
- package/dist/components/action-row/ActionRow.d.ts +178 -0
- package/dist/components/action-row/ActionRow.js +340 -0
- package/dist/components/action-row/index.d.ts +2 -0
- package/dist/components/action-row/index.js +1 -0
- package/dist/components/alert/Alert.d.ts +314 -0
- package/dist/components/alert/Alert.js +446 -0
- package/dist/components/alert/index.d.ts +2 -0
- package/dist/components/alert/index.js +1 -0
- package/dist/components/anchored-panel/AnchoredPanel.d.ts +41 -0
- package/dist/components/anchored-panel/AnchoredPanel.js +72 -0
- package/dist/components/anchored-panel/index.d.ts +3 -0
- package/dist/components/anchored-panel/index.js +3 -0
- package/dist/components/badge/Badge.d.ts +146 -0
- package/dist/components/badge/Badge.js +258 -0
- package/dist/components/badge/index.d.ts +2 -0
- package/dist/components/badge/index.js +1 -0
- package/dist/components/banner/Banner.d.ts +209 -0
- package/dist/components/banner/Banner.js +339 -0
- package/dist/components/banner/index.d.ts +2 -0
- package/dist/components/banner/index.js +1 -0
- package/dist/components/button/Button.d.ts +54 -0
- package/dist/components/button/Button.js +312 -0
- package/dist/components/button/index.d.ts +2 -0
- package/dist/components/button/index.js +1 -0
- package/dist/components/button-group/ButtonGroup.d.ts +187 -0
- package/dist/components/button-group/ButtonGroup.js +217 -0
- package/dist/components/button-group/index.d.ts +2 -0
- package/dist/components/button-group/index.js +1 -0
- package/dist/components/card-select/CardSelect.d.ts +274 -0
- package/dist/components/card-select/CardSelect.js +561 -0
- package/dist/components/card-select/CardSelectGroup.d.ts +92 -0
- package/dist/components/card-select/CardSelectGroup.js +72 -0
- package/dist/components/card-select/index.d.ts +3 -0
- package/dist/components/card-select/index.js +3 -0
- package/dist/components/checkbox/Checkbox.d.ts +104 -0
- package/dist/components/checkbox/Checkbox.js +194 -0
- package/dist/components/checkbox/index.d.ts +2 -0
- package/dist/components/checkbox/index.js +1 -0
- package/dist/components/chip/Chip.d.ts +250 -0
- package/dist/components/chip/Chip.js +441 -0
- package/dist/components/chip/index.d.ts +2 -0
- package/dist/components/chip/index.js +1 -0
- package/dist/components/column-header/ColumnHeader.d.ts +144 -0
- package/dist/components/column-header/ColumnHeader.js +209 -0
- package/dist/components/column-header/index.d.ts +2 -0
- package/dist/components/column-header/index.js +1 -0
- package/dist/components/combobox-field/Combobox.d.ts +104 -0
- package/dist/components/combobox-field/Combobox.js +355 -0
- package/dist/components/combobox-field/ComboboxField.d.ts +76 -0
- package/dist/components/combobox-field/ComboboxField.js +98 -0
- package/dist/components/combobox-field/index.d.ts +3 -0
- package/dist/components/combobox-field/index.js +3 -0
- package/dist/components/date-field/DateField.d.ts +52 -0
- package/dist/components/date-field/DateField.js +45 -0
- package/dist/components/date-field/index.d.ts +2 -0
- package/dist/components/date-field/index.js +1 -0
- package/dist/components/date-picker/DatePicker.d.ts +53 -0
- package/dist/components/date-picker/DatePicker.js +329 -0
- package/dist/components/date-picker/index.d.ts +2 -0
- package/dist/components/date-picker/index.js +1 -0
- package/dist/components/divider/Divider.d.ts +81 -0
- package/dist/components/divider/Divider.js +93 -0
- package/dist/components/divider/index.d.ts +2 -0
- package/dist/components/divider/index.js +1 -0
- package/dist/components/drawer/Drawer.d.ts +128 -0
- package/dist/components/drawer/Drawer.js +367 -0
- package/dist/components/drawer/index.d.ts +2 -0
- package/dist/components/drawer/index.js +1 -0
- package/dist/components/dropdown-button/DropdownButton.d.ts +72 -0
- package/dist/components/dropdown-button/DropdownButton.js +122 -0
- package/dist/components/dropdown-button/index.d.ts +2 -0
- package/dist/components/dropdown-button/index.js +1 -0
- package/dist/components/faq/FAQ.d.ts +135 -0
- package/dist/components/faq/FAQ.js +258 -0
- package/dist/components/faq/index.d.ts +2 -0
- package/dist/components/faq/index.js +1 -0
- package/dist/components/field/Field.d.ts +118 -0
- package/dist/components/field/Field.js +327 -0
- package/dist/components/field/index.d.ts +2 -0
- package/dist/components/field/index.js +1 -0
- package/dist/components/field-pair/FieldPair.d.ts +194 -0
- package/dist/components/field-pair/FieldPair.js +321 -0
- package/dist/components/field-pair/index.d.ts +2 -0
- package/dist/components/field-pair/index.js +1 -0
- package/dist/components/file-upload/FileUpload.d.ts +137 -0
- package/dist/components/file-upload/FileUpload.js +434 -0
- package/dist/components/file-upload/index.d.ts +2 -0
- package/dist/components/file-upload/index.js +1 -0
- package/dist/components/filter-chip/FilterChip.d.ts +373 -0
- package/dist/components/filter-chip/FilterChip.js +517 -0
- package/dist/components/filter-chip/index.d.ts +2 -0
- package/dist/components/filter-chip/index.js +1 -0
- package/dist/components/filter-facet/FilterFacet.d.ts +116 -0
- package/dist/components/filter-facet/FilterFacet.js +632 -0
- package/dist/components/filter-facet/index.d.ts +2 -0
- package/dist/components/filter-facet/index.js +1 -0
- package/dist/components/firm-avatar/FirmAvatar.d.ts +75 -0
- package/dist/components/firm-avatar/FirmAvatar.js +119 -0
- package/dist/components/firm-avatar/index.d.ts +2 -0
- package/dist/components/firm-avatar/index.js +1 -0
- package/dist/components/form-actions/FormActions.d.ts +123 -0
- package/dist/components/form-actions/FormActions.js +195 -0
- package/dist/components/form-actions/index.d.ts +2 -0
- package/dist/components/form-actions/index.js +1 -0
- package/dist/components/form-block/FormBlock.d.ts +252 -0
- package/dist/components/form-block/FormBlock.js +420 -0
- package/dist/components/form-block/index.d.ts +3 -0
- package/dist/components/form-block/index.js +3 -0
- package/dist/components/form-section/FormSection.d.ts +130 -0
- package/dist/components/form-section/FormSection.js +206 -0
- package/dist/components/form-section/index.d.ts +2 -0
- package/dist/components/form-section/index.js +1 -0
- package/dist/components/heading/Heading.d.ts +69 -0
- package/dist/components/heading/Heading.js +79 -0
- package/dist/components/heading/index.d.ts +2 -0
- package/dist/components/heading/index.js +1 -0
- package/dist/components/heading-group/HeadingGroup.d.ts +258 -0
- package/dist/components/heading-group/HeadingGroup.js +255 -0
- package/dist/components/heading-group/index.d.ts +2 -0
- package/dist/components/heading-group/index.js +1 -0
- package/dist/components/hero/Hero.d.ts +268 -0
- package/dist/components/hero/Hero.js +316 -0
- package/dist/components/hero/index.d.ts +2 -0
- package/dist/components/hero/index.js +1 -0
- package/dist/components/icon/Icon.d.ts +27 -0
- package/dist/components/icon/Icon.js +30 -0
- package/dist/components/icon/index.d.ts +3 -0
- package/dist/components/icon/index.js +3 -0
- package/dist/components/icon-button/IconButton.d.ts +75 -0
- package/dist/components/icon-button/IconButton.js +151 -0
- package/dist/components/icon-button/index.d.ts +2 -0
- package/dist/components/icon-button/index.js +1 -0
- package/dist/components/item-row/ItemRow.d.ts +253 -0
- package/dist/components/item-row/ItemRow.js +496 -0
- package/dist/components/item-row/index.d.ts +2 -0
- package/dist/components/item-row/index.js +1 -0
- package/dist/components/list-row/ListRow.d.ts +165 -0
- package/dist/components/list-row/ListRow.js +233 -0
- package/dist/components/list-row/index.d.ts +2 -0
- package/dist/components/list-row/index.js +1 -0
- package/dist/components/menu/Menu.d.ts +64 -0
- package/dist/components/menu/Menu.js +186 -0
- package/dist/components/menu/index.d.ts +2 -0
- package/dist/components/menu/index.js +1 -0
- package/dist/components/modal/Modal.d.ts +272 -0
- package/dist/components/modal/Modal.js +788 -0
- package/dist/components/modal/index.d.ts +2 -0
- package/dist/components/modal/index.js +1 -0
- package/dist/components/nav-link/NavLink.d.ts +123 -0
- package/dist/components/nav-link/NavLink.js +157 -0
- package/dist/components/nav-link/index.d.ts +2 -0
- package/dist/components/nav-link/index.js +1 -0
- package/dist/components/number-field/NumberField.d.ts +62 -0
- package/dist/components/number-field/NumberField.js +210 -0
- package/dist/components/number-field/index.d.ts +2 -0
- package/dist/components/number-field/index.js +1 -0
- package/dist/components/pagination/Pagination.d.ts +133 -0
- package/dist/components/pagination/Pagination.js +217 -0
- package/dist/components/pagination/index.d.ts +3 -0
- package/dist/components/pagination/index.js +3 -0
- package/dist/components/popover-surface/index.d.ts +2 -0
- package/dist/components/popover-surface/index.js +1 -0
- package/dist/components/progress-bar/ProgressBar.d.ts +260 -0
- package/dist/components/progress-bar/ProgressBar.js +470 -0
- package/dist/components/progress-bar/index.d.ts +2 -0
- package/dist/components/progress-bar/index.js +1 -0
- package/dist/components/promo-sticker/PromoSticker.d.ts +204 -0
- package/dist/components/promo-sticker/PromoSticker.js +177 -0
- package/dist/components/promo-sticker/index.d.ts +2 -0
- package/dist/components/promo-sticker/index.js +1 -0
- package/dist/components/promo-surface/PromoSurface.d.ts +94 -0
- package/dist/components/promo-surface/PromoSurface.js +119 -0
- package/dist/components/promo-surface/index.d.ts +2 -0
- package/dist/components/promo-surface/index.js +1 -0
- package/dist/components/radio/Radio.d.ts +92 -0
- package/dist/components/radio/Radio.js +171 -0
- package/dist/components/radio/index.d.ts +2 -0
- package/dist/components/radio/index.js +1 -0
- package/dist/components/radio-group/RadioGroup.d.ts +61 -0
- package/dist/components/radio-group/RadioGroup.js +51 -0
- package/dist/components/radio-group/index.d.ts +2 -0
- package/dist/components/radio-group/index.js +1 -0
- package/dist/components/select/Select.d.ts +65 -0
- package/dist/components/select/Select.js +176 -0
- package/dist/components/select/index.d.ts +2 -0
- package/dist/components/select/index.js +1 -0
- package/dist/components/select-field/SelectField.d.ts +16 -0
- package/dist/components/select-field/SelectField.js +55 -0
- package/dist/components/select-field/index.d.ts +2 -0
- package/dist/components/select-field/index.js +1 -0
- package/dist/components/skeleton/Skeleton.d.ts +64 -0
- package/dist/components/skeleton/Skeleton.js +65 -0
- package/dist/components/skeleton/index.d.ts +2 -0
- package/dist/components/skeleton/index.js +1 -0
- package/dist/components/split-button/SplitButton.d.ts +80 -0
- package/dist/components/split-button/SplitButton.js +182 -0
- package/dist/components/split-button/index.d.ts +2 -0
- package/dist/components/split-button/index.js +1 -0
- package/dist/components/status-summary-bar/StatusSummaryBar.d.ts +118 -0
- package/dist/components/status-summary-bar/StatusSummaryBar.js +278 -0
- package/dist/components/status-summary-bar/index.d.ts +2 -0
- package/dist/components/status-summary-bar/index.js +1 -0
- package/dist/components/subject-lookup-field/SubjectLookupField.d.ts +157 -0
- package/dist/components/subject-lookup-field/SubjectLookupField.js +663 -0
- package/dist/components/subject-lookup-field/index.d.ts +2 -0
- package/dist/components/subject-lookup-field/index.js +1 -0
- package/dist/components/switch/Switch.d.ts +152 -0
- package/dist/components/switch/Switch.js +307 -0
- package/dist/components/switch/index.d.ts +2 -0
- package/dist/components/switch/index.js +1 -0
- package/dist/components/table/Table.d.ts +5 -0
- package/dist/components/table/Table.js +601 -0
- package/dist/components/table/index.d.ts +6 -0
- package/dist/components/table/index.js +6 -0
- package/dist/components/text-field/TextField.d.ts +65 -0
- package/dist/components/text-field/TextField.js +173 -0
- package/dist/components/text-field/index.d.ts +2 -0
- package/dist/components/text-field/index.js +1 -0
- package/dist/components/text-link/TextLink.d.ts +260 -0
- package/dist/components/text-link/TextLink.js +303 -0
- package/dist/components/text-link/index.d.ts +2 -0
- package/dist/components/text-link/index.js +1 -0
- package/dist/components/textarea/Textarea.d.ts +93 -0
- package/dist/components/textarea/Textarea.js +256 -0
- package/dist/components/textarea/index.d.ts +2 -0
- package/dist/components/textarea/index.js +1 -0
- package/dist/components/tooltip/Tooltip.d.ts +129 -0
- package/dist/components/tooltip/Tooltip.js +457 -0
- package/dist/components/tooltip/index.d.ts +2 -0
- package/dist/components/tooltip/index.js +1 -0
- package/dist/components/unit-field/UnitField.d.ts +46 -0
- package/dist/components/unit-field/UnitField.js +133 -0
- package/dist/components/unit-field/index.d.ts +2 -0
- package/dist/components/unit-field/index.js +1 -0
- package/dist/icons/icon-registry.generated.js +500 -0
- package/dist/icons/icon-types.generated.d.ts +2 -0
- package/dist/icons/icon-types.generated.js +126 -0
- package/dist/index.d.ts +132 -0
- package/dist/index.js +75 -0
- package/dist/internal/BottomSheet.js +496 -0
- package/dist/internal/FodsProvider.d.ts +25 -0
- package/dist/internal/FodsProvider.js +32 -0
- package/dist/internal/MotionCaret.js +35 -0
- package/dist/internal/NumberFormatInput.d.ts +21 -0
- package/dist/internal/NumberFormatInput.js +126 -0
- package/dist/internal/SummaryDonut.d.ts +3 -0
- package/dist/internal/SummaryDonut.js +300 -0
- package/dist/internal/buttonSegment.d.ts +44 -0
- package/dist/internal/buttonSegment.js +126 -0
- package/dist/internal/collapseRoom.js +128 -0
- package/dist/internal/comboboxKeys.js +44 -0
- package/dist/internal/contentPresence.js +46 -0
- package/dist/internal/dayCell.js +95 -0
- package/dist/internal/dialogPortal.d.ts +2 -0
- package/dist/internal/dialogPortal.js +21 -0
- package/dist/internal/donutSweeps.js +65 -0
- package/dist/internal/enterOnViewGeometry.js +46 -0
- package/dist/internal/faqItem.js +80 -0
- package/dist/internal/floatingLabelMotion.js +68 -0
- package/dist/internal/formBlockContext.d.ts +22 -0
- package/dist/internal/formBlockContext.js +20 -0
- package/dist/internal/heightRoom.js +87 -0
- package/dist/internal/numberSeparators.js +62 -0
- package/dist/internal/overlayMotion.js +48 -0
- package/dist/internal/paginationItem.d.ts +8 -0
- package/dist/internal/paginationItem.js +22 -0
- package/dist/internal/popoverSurface.d.ts +8 -0
- package/dist/internal/popoverSurface.js +23 -0
- package/dist/internal/portalContainer.d.ts +1 -0
- package/dist/internal/portalContainer.js +6 -0
- package/dist/internal/progressBarItem.d.ts +207 -0
- package/dist/internal/progressBarItem.js +264 -0
- package/dist/internal/selectionControlText.js +12 -0
- package/dist/internal/statusSummaryParts.js +371 -0
- package/dist/internal/summaryMotion.js +75 -0
- package/dist/internal/table/ChildConnector.js +62 -0
- package/dist/internal/table/ChildRowPrefix.d.ts +9 -0
- package/dist/internal/table/ChildRowPrefix.js +27 -0
- package/dist/internal/table/ColumnSettings.js +135 -0
- package/dist/internal/table/ScrollRegion.js +114 -0
- package/dist/internal/table/TableEmpty.js +93 -0
- package/dist/internal/table/TableLayout.d.ts +17 -0
- package/dist/internal/table/TableLayout.js +29 -0
- package/dist/internal/table/TableLoadStatus.js +56 -0
- package/dist/internal/table/TableMobile.js +488 -0
- package/dist/internal/table/TruncatedCell.js +33 -0
- package/dist/internal/table/emptyValue.js +10 -0
- package/dist/internal/table/features.d.ts +41 -0
- package/dist/internal/table/features.js +31 -0
- package/dist/internal/table/recipes.js +227 -0
- package/dist/internal/table/rowClick.js +9 -0
- package/dist/internal/table/types.d.ts +325 -0
- package/dist/internal/table/types.js +13 -0
- package/dist/internal/tailwind-variants.d.ts +3 -0
- package/dist/internal/tailwind-variants.js +37 -0
- package/dist/internal/tooltipContext.js +5 -0
- package/dist/internal/tw-merge-config.generated.js +314 -0
- package/dist/internal/useAnchoredPanel.d.ts +87 -0
- package/dist/internal/useAnchoredPanel.js +108 -0
- package/dist/internal/useCountUp.js +53 -0
- package/dist/internal/useDateFieldTrigger.js +183 -0
- package/dist/internal/useEChart.js +59 -0
- package/dist/internal/useEnterOnView.js +42 -0
- package/dist/internal/useFloatingBar.js +100 -0
- package/dist/internal/useFormReset.js +37 -0
- package/dist/internal/useIsMobile.js +44 -0
- package/dist/internal/useOneRowOverflow.js +88 -0
- package/dist/internal/usePrefersReducedMotion.js +25 -0
- package/dist/internal/useReturnFocus.js +26 -0
- package/dist/internal/utils.d.ts +7 -0
- package/dist/internal/utils.js +58 -0
- package/dist/node_modules/@tanstack/store/dist/store.d.ts +29 -0
- package/dist/node_modules/@tanstack/store/dist/types.d.ts +38 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/cells/coreCellsFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/cells/coreCellsFeature.types.d.ts +53 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/columns/coreColumnsFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/columns/coreColumnsFeature.types.d.ts +90 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/coreFeatures.d.ts +17 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/headers/coreHeadersFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/headers/coreHeadersFeature.types.d.ts +114 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/reactivity/coreReactivityFeature.types.d.ts +51 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/row-models/coreRowModelsFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/row-models/coreRowModelsFeature.types.d.ts +29 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/rows/coreRowsFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/rows/coreRowsFeature.types.d.ts +129 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/table/coreTablesFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/table/coreTablesFeature.types.d.ts +203 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/cell-selection/cellSelectionFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/cell-selection/cellSelectionFeature.types.d.ts +294 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/cell-spanning/cellSpanningFeature.d.ts +11 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/cell-spanning/cellSpanningFeature.types.d.ts +148 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-faceting/columnFacetingFeature.d.ts +12 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-faceting/columnFacetingFeature.types.d.ts +63 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/columnFilteringFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/columnFilteringFeature.types.d.ts +209 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/filterFns.d.ts +35 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-grouping/columnGroupingFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-grouping/columnGroupingFeature.types.d.ts +128 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-ordering/columnOrderingFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-ordering/columnOrderingFeature.types.d.ts +82 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-pinning/columnPinningFeature.d.ts +11 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-pinning/columnPinningFeature.types.d.ts +195 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-resizing/columnResizingFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-resizing/columnResizingFeature.types.d.ts +73 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-sizing/columnSizingFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-sizing/columnSizingFeature.types.d.ts +134 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-visibility/columnVisibilityFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-visibility/columnVisibilityFeature.types.d.ts +92 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/global-filtering/globalFilteringFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/global-filtering/globalFilteringFeature.types.d.ts +67 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/aggregationFns.d.ts +23 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.types.d.ts +183 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.utils.d.ts +18 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-expanding/rowExpandingFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-expanding/rowExpandingFeature.types.d.ts +125 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-pagination/rowPaginationFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-pagination/rowPaginationFeature.types.d.ts +135 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-pinning/rowPinningFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-pinning/rowPinningFeature.types.d.ts +76 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-selection/rowSelectionFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-selection/rowSelectionFeature.types.d.ts +187 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/rowSortingFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/rowSortingFeature.types.d.ts +236 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/sortFns.d.ts +23 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/stockFeatures.d.ts +37 -0
- package/dist/node_modules/@tanstack/table-core/dist/helpers/columnHelper.d.ts +47 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/Cell.d.ts +16 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/Column.d.ts +30 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/ColumnDef.d.ts +123 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/Header.d.ts +12 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/HeaderGroup.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/Row.d.ts +24 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/RowModel.d.ts +19 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/RowModelFns.d.ts +11 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/Table.d.ts +53 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/TableFeatures.d.ts +416 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/TableOptions.d.ts +78 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/TableState.d.ts +46 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/type-utils.d.ts +25 -0
- package/dist/shared.css +179 -0
- package/dist/styles.css +5467 -0
- package/dist/theme.css +314 -0
- package/dist/theme.map.json +278 -0
- package/dist/tokens/index.d.ts +2 -0
- package/dist/tokens/index.js +1 -0
- package/dist/tokens/tokens.generated.d.ts +2040 -0
- package/dist/tokens/tokens.generated.js +2053 -0
- package/dist/tokens.css +484 -0
- package/dist/tokens.flat.json +429 -0
- package/docs/Consuming.mdx +379 -0
- package/docs/Contributing.mdx +78 -0
- package/docs/ForAgents.mdx +53 -0
- package/docs/Introduction.mdx +54 -0
- package/llms.txt +556 -0
- package/package.json +357 -4
- package/src/components/action-row/ActionRow.mdx +686 -0
- package/src/components/action-row/ActionRow.stories.tsx +669 -0
- package/src/components/action-row/ActionRow.tsx +632 -0
- package/src/components/action-row/index.ts +9 -0
- package/src/components/alert/Alert.mdx +377 -0
- package/src/components/alert/Alert.stories.tsx +674 -0
- package/src/components/alert/Alert.tsx +579 -0
- package/src/components/alert/index.ts +13 -0
- package/src/components/anchored-panel/AnchoredPanel.mdx +381 -0
- package/src/components/anchored-panel/AnchoredPanel.stories.tsx +593 -0
- package/src/components/anchored-panel/AnchoredPanel.tsx +176 -0
- package/src/components/anchored-panel/index.ts +15 -0
- package/src/components/badge/Badge.mdx +487 -0
- package/src/components/badge/Badge.stories.tsx +375 -0
- package/src/components/badge/Badge.tsx +360 -0
- package/src/components/badge/index.ts +10 -0
- package/src/components/banner/Banner.mdx +704 -0
- package/src/components/banner/Banner.stories.tsx +448 -0
- package/src/components/banner/Banner.tsx +602 -0
- package/src/components/banner/index.ts +14 -0
- package/src/components/button/Button.mdx +286 -0
- package/src/components/button/Button.stories.tsx +381 -0
- package/src/components/button/Button.tsx +384 -0
- package/src/components/button/index.ts +1 -0
- package/src/components/button-group/ButtonGroup.mdx +512 -0
- package/src/components/button-group/ButtonGroup.stories.tsx +714 -0
- package/src/components/button-group/ButtonGroup.tsx +491 -0
- package/src/components/button-group/index.ts +10 -0
- package/src/components/card-select/CardSelect.mdx +662 -0
- package/src/components/card-select/CardSelect.stories.tsx +784 -0
- package/src/components/card-select/CardSelect.tsx +783 -0
- package/src/components/card-select/CardSelectGroup.tsx +169 -0
- package/src/components/card-select/index.ts +18 -0
- package/src/components/checkbox/Checkbox.mdx +269 -0
- package/src/components/checkbox/Checkbox.stories.tsx +306 -0
- package/src/components/checkbox/Checkbox.tsx +343 -0
- package/src/components/checkbox/index.ts +1 -0
- package/src/components/chip/Chip.mdx +683 -0
- package/src/components/chip/Chip.stories.tsx +734 -0
- package/src/components/chip/Chip.tsx +732 -0
- package/src/components/chip/index.ts +9 -0
- package/src/components/column-header/ColumnHeader.mdx +301 -0
- package/src/components/column-header/ColumnHeader.stories.tsx +319 -0
- package/src/components/column-header/ColumnHeader.tsx +287 -0
- package/src/components/column-header/index.ts +7 -0
- package/src/components/combobox-field/Combobox.tsx +693 -0
- package/src/components/combobox-field/ComboboxField.mdx +525 -0
- package/src/components/combobox-field/ComboboxField.stories.tsx +502 -0
- package/src/components/combobox-field/ComboboxField.tsx +259 -0
- package/src/components/combobox-field/index.ts +12 -0
- package/src/components/date-field/DateField.mdx +340 -0
- package/src/components/date-field/DateField.stories.tsx +221 -0
- package/src/components/date-field/DateField.tsx +176 -0
- package/src/components/date-field/index.ts +1 -0
- package/src/components/date-picker/DatePicker.mdx +436 -0
- package/src/components/date-picker/DatePicker.stories.tsx +458 -0
- package/src/components/date-picker/DatePicker.tsx +688 -0
- package/src/components/date-picker/index.ts +9 -0
- package/src/components/divider/Divider.mdx +256 -0
- package/src/components/divider/Divider.stories.tsx +177 -0
- package/src/components/divider/Divider.tsx +193 -0
- package/src/components/divider/index.ts +1 -0
- package/src/components/drawer/Drawer.mdx +518 -0
- package/src/components/drawer/Drawer.stories.tsx +392 -0
- package/src/components/drawer/Drawer.tsx +683 -0
- package/src/components/drawer/index.ts +1 -0
- package/src/components/dropdown-button/DropdownButton.mdx +285 -0
- package/src/components/dropdown-button/DropdownButton.stories.tsx +398 -0
- package/src/components/dropdown-button/DropdownButton.tsx +198 -0
- package/src/components/dropdown-button/index.ts +7 -0
- package/src/components/faq/FAQ.mdx +364 -0
- package/src/components/faq/FAQ.stories.tsx +343 -0
- package/src/components/faq/FAQ.tsx +337 -0
- package/src/components/faq/index.ts +1 -0
- package/src/components/field/Field.mdx +129 -0
- package/src/components/field/Field.stories.tsx +461 -0
- package/src/components/field/Field.tsx +765 -0
- package/src/components/field/index.ts +20 -0
- package/src/components/field-pair/FieldPair.mdx +308 -0
- package/src/components/field-pair/FieldPair.stories.tsx +530 -0
- package/src/components/field-pair/FieldPair.tsx +796 -0
- package/src/components/field-pair/index.ts +9 -0
- package/src/components/file-upload/FileUpload.mdx +345 -0
- package/src/components/file-upload/FileUpload.stories.tsx +698 -0
- package/src/components/file-upload/FileUpload.tsx +802 -0
- package/src/components/file-upload/index.ts +6 -0
- package/src/components/filter-chip/FilterChip.mdx +778 -0
- package/src/components/filter-chip/FilterChip.stories.tsx +827 -0
- package/src/components/filter-chip/FilterChip.tsx +881 -0
- package/src/components/filter-chip/index.ts +11 -0
- package/src/components/filter-facet/FilterFacet.mdx +536 -0
- package/src/components/filter-facet/FilterFacet.stories.tsx +506 -0
- package/src/components/filter-facet/FilterFacet.tsx +1160 -0
- package/src/components/filter-facet/index.ts +7 -0
- package/src/components/firm-avatar/FirmAvatar.mdx +280 -0
- package/src/components/firm-avatar/FirmAvatar.stories.tsx +147 -0
- package/src/components/firm-avatar/FirmAvatar.tsx +172 -0
- package/src/components/firm-avatar/index.ts +7 -0
- package/src/components/form-actions/FormActions.mdx +518 -0
- package/src/components/form-actions/FormActions.stories.tsx +621 -0
- package/src/components/form-actions/FormActions.tsx +273 -0
- package/src/components/form-actions/index.ts +6 -0
- package/src/components/form-block/FormBlock.mdx +728 -0
- package/src/components/form-block/FormBlock.stories.tsx +813 -0
- package/src/components/form-block/FormBlock.tsx +679 -0
- package/src/components/form-block/index.ts +13 -0
- package/src/components/form-section/FormSection.mdx +436 -0
- package/src/components/form-section/FormSection.stories.tsx +407 -0
- package/src/components/form-section/FormSection.tsx +290 -0
- package/src/components/form-section/index.ts +17 -0
- package/src/components/heading/Heading.mdx +206 -0
- package/src/components/heading/Heading.stories.tsx +169 -0
- package/src/components/heading/Heading.tsx +124 -0
- package/src/components/heading/index.ts +8 -0
- package/src/components/heading-group/HeadingGroup.mdx +521 -0
- package/src/components/heading-group/HeadingGroup.stories.tsx +353 -0
- package/src/components/heading-group/HeadingGroup.tsx +396 -0
- package/src/components/heading-group/index.ts +7 -0
- package/src/components/hero/Hero.mdx +742 -0
- package/src/components/hero/Hero.stories.tsx +527 -0
- package/src/components/hero/Hero.tsx +807 -0
- package/src/components/hero/index.ts +1 -0
- package/src/components/icon/Icon.mdx +329 -0
- package/src/components/icon/Icon.stories.tsx +398 -0
- package/src/components/icon/Icon.tsx +97 -0
- package/src/components/icon/index.ts +2 -0
- package/src/components/icon-button/IconButton.mdx +206 -0
- package/src/components/icon-button/IconButton.stories.tsx +341 -0
- package/src/components/icon-button/IconButton.tsx +273 -0
- package/src/components/icon-button/index.ts +1 -0
- package/src/components/item-row/ItemRow.mdx +533 -0
- package/src/components/item-row/ItemRow.stories.tsx +434 -0
- package/src/components/item-row/ItemRow.tsx +676 -0
- package/src/components/item-row/index.ts +9 -0
- package/src/components/list-row/ListRow.mdx +404 -0
- package/src/components/list-row/ListRow.stories.tsx +404 -0
- package/src/components/list-row/ListRow.tsx +424 -0
- package/src/components/list-row/index.ts +1 -0
- package/src/components/menu/Menu.mdx +268 -0
- package/src/components/menu/Menu.stories.tsx +455 -0
- package/src/components/menu/Menu.tsx +452 -0
- package/src/components/menu/index.ts +1 -0
- package/src/components/modal/Modal.mdx +854 -0
- package/src/components/modal/Modal.stories.tsx +881 -0
- package/src/components/modal/Modal.tsx +1434 -0
- package/src/components/modal/index.ts +1 -0
- package/src/components/nav-link/NavLink.mdx +196 -0
- package/src/components/nav-link/NavLink.stories.tsx +243 -0
- package/src/components/nav-link/NavLink.tsx +222 -0
- package/src/components/nav-link/index.ts +1 -0
- package/src/components/number-field/NumberField.mdx +223 -0
- package/src/components/number-field/NumberField.stories.tsx +291 -0
- package/src/components/number-field/NumberField.tsx +388 -0
- package/src/components/number-field/index.ts +6 -0
- package/src/components/pagination/Pagination.mdx +305 -0
- package/src/components/pagination/Pagination.stories.tsx +333 -0
- package/src/components/pagination/Pagination.tsx +343 -0
- package/src/components/pagination/index.ts +8 -0
- package/src/components/popover-surface/PopoverSurface.mdx +158 -0
- package/src/components/popover-surface/PopoverSurface.stories.tsx +421 -0
- package/src/components/popover-surface/index.ts +1 -0
- package/src/components/progress-bar/ProgressBar.mdx +802 -0
- package/src/components/progress-bar/ProgressBar.stories.tsx +533 -0
- package/src/components/progress-bar/ProgressBar.tsx +654 -0
- package/src/components/progress-bar/index.ts +9 -0
- package/src/components/promo-sticker/PromoSticker.mdx +436 -0
- package/src/components/promo-sticker/PromoSticker.stories.tsx +363 -0
- package/src/components/promo-sticker/PromoSticker.tsx +313 -0
- package/src/components/promo-sticker/index.ts +7 -0
- package/src/components/promo-surface/PromoSurface.mdx +399 -0
- package/src/components/promo-surface/PromoSurface.stories.tsx +270 -0
- package/src/components/promo-surface/PromoSurface.tsx +305 -0
- package/src/components/promo-surface/index.ts +7 -0
- package/src/components/radio/Radio.mdx +243 -0
- package/src/components/radio/Radio.stories.tsx +307 -0
- package/src/components/radio/Radio.tsx +288 -0
- package/src/components/radio/index.ts +1 -0
- package/src/components/radio-group/RadioGroup.mdx +119 -0
- package/src/components/radio-group/RadioGroup.stories.tsx +225 -0
- package/src/components/radio-group/RadioGroup.tsx +139 -0
- package/src/components/radio-group/index.ts +1 -0
- package/src/components/select/Select.mdx +241 -0
- package/src/components/select/Select.stories.tsx +404 -0
- package/src/components/select/Select.tsx +381 -0
- package/src/components/select/index.ts +1 -0
- package/src/components/select-field/SelectField.mdx +324 -0
- package/src/components/select-field/SelectField.stories.tsx +460 -0
- package/src/components/select-field/SelectField.tsx +138 -0
- package/src/components/select-field/index.ts +1 -0
- package/src/components/skeleton/Skeleton.mdx +194 -0
- package/src/components/skeleton/Skeleton.stories.tsx +260 -0
- package/src/components/skeleton/Skeleton.tsx +107 -0
- package/src/components/skeleton/index.ts +1 -0
- package/src/components/split-button/SplitButton.mdx +445 -0
- package/src/components/split-button/SplitButton.stories.tsx +465 -0
- package/src/components/split-button/SplitButton.tsx +361 -0
- package/src/components/split-button/index.ts +7 -0
- package/src/components/status-summary-bar/StatusSummaryBar.mdx +338 -0
- package/src/components/status-summary-bar/StatusSummaryBar.stories.tsx +408 -0
- package/src/components/status-summary-bar/StatusSummaryBar.tsx +428 -0
- package/src/components/status-summary-bar/index.ts +8 -0
- package/src/components/subject-lookup-field/SubjectLookupField.mdx +378 -0
- package/src/components/subject-lookup-field/SubjectLookupField.stories.tsx +393 -0
- package/src/components/subject-lookup-field/SubjectLookupField.tsx +1079 -0
- package/src/components/subject-lookup-field/index.ts +11 -0
- package/src/components/switch/Switch.mdx +376 -0
- package/src/components/switch/Switch.stories.tsx +296 -0
- package/src/components/switch/Switch.tsx +483 -0
- package/src/components/switch/index.ts +1 -0
- package/src/components/table/Table.mdx +575 -0
- package/src/components/table/Table.stories.tsx +1049 -0
- package/src/components/table/Table.tsx +745 -0
- package/src/components/table/TableConsumers.stories.tsx +195 -0
- package/src/components/table/_tableFixtures.ts +1189 -0
- package/src/components/table/index.ts +22 -0
- package/src/components/text-field/TextField.mdx +479 -0
- package/src/components/text-field/TextField.stories.tsx +366 -0
- package/src/components/text-field/TextField.tsx +391 -0
- package/src/components/text-field/index.ts +8 -0
- package/src/components/text-link/TextLink.mdx +353 -0
- package/src/components/text-link/TextLink.stories.tsx +458 -0
- package/src/components/text-link/TextLink.tsx +504 -0
- package/src/components/text-link/index.ts +10 -0
- package/src/components/textarea/Textarea.mdx +244 -0
- package/src/components/textarea/Textarea.stories.tsx +371 -0
- package/src/components/textarea/Textarea.tsx +489 -0
- package/src/components/textarea/index.ts +9 -0
- package/src/components/tooltip/Tooltip.mdx +462 -0
- package/src/components/tooltip/Tooltip.stories.tsx +500 -0
- package/src/components/tooltip/Tooltip.tsx +756 -0
- package/src/components/tooltip/index.ts +13 -0
- package/src/components/unit-field/UnitField.mdx +215 -0
- package/src/components/unit-field/UnitField.stories.tsx +291 -0
- package/src/components/unit-field/UnitField.tsx +255 -0
- package/src/components/unit-field/index.ts +7 -0
- package/src/icons/icon-registry.generated.ts +510 -0
- package/src/icons/icon-types.generated.ts +256 -0
- package/src/index.ts +71 -0
- package/src/internal/BottomSheet.tsx +714 -0
- package/src/internal/FodsProvider.tsx +36 -0
- package/src/internal/MotionCaret.tsx +53 -0
- package/src/internal/NumberFormatInput.tsx +276 -0
- package/src/internal/SummaryDonut.tsx +359 -0
- package/src/internal/buttonSegment.ts +241 -0
- package/src/internal/collapseRoom.ts +130 -0
- package/src/internal/comboboxKeys.ts +90 -0
- package/src/internal/contentPresence.ts +46 -0
- package/src/internal/dayCell.ts +274 -0
- package/src/internal/dialogPortal.ts +50 -0
- package/src/internal/donutSweeps.ts +77 -0
- package/src/internal/enterOnViewGeometry.ts +53 -0
- package/src/internal/faqItem.ts +104 -0
- package/src/internal/floatingLabelMotion.tsx +109 -0
- package/src/internal/formBlockContext.ts +27 -0
- package/src/internal/heightRoom.ts +135 -0
- package/src/internal/numberSeparators.ts +93 -0
- package/src/internal/overlayMotion.tsx +32 -0
- package/src/internal/paginationItem.ts +106 -0
- package/src/internal/popoverSurface.ts +78 -0
- package/src/internal/portalContainer.ts +11 -0
- package/src/internal/progressBarItem.ts +356 -0
- package/src/internal/selectionControlText.ts +42 -0
- package/src/internal/statusSummaryParts.tsx +475 -0
- package/src/internal/summaryMotion.ts +111 -0
- package/src/internal/table/ChildConnector.tsx +57 -0
- package/src/internal/table/ChildRowPrefix.tsx +21 -0
- package/src/internal/table/ColumnSettings.tsx +194 -0
- package/src/internal/table/ScrollRegion.tsx +176 -0
- package/src/internal/table/TableEmpty.tsx +99 -0
- package/src/internal/table/TableLayout.tsx +29 -0
- package/src/internal/table/TableLoadStatus.tsx +60 -0
- package/src/internal/table/TableMobile.tsx +582 -0
- package/src/internal/table/TruncatedCell.tsx +35 -0
- package/src/internal/table/emptyValue.ts +11 -0
- package/src/internal/table/features.ts +44 -0
- package/src/internal/table/recipes.ts +263 -0
- package/src/internal/table/rowClick.ts +8 -0
- package/src/internal/table/types.ts +342 -0
- package/src/internal/tailwind-variants.ts +65 -0
- package/src/internal/tooltipContext.ts +15 -0
- package/src/internal/tw-merge-config.generated.ts +275 -0
- package/src/internal/useAnchoredPanel.ts +340 -0
- package/src/internal/useCountUp.ts +65 -0
- package/src/internal/useDateFieldTrigger.tsx +357 -0
- package/src/internal/useEChart.ts +88 -0
- package/src/internal/useEnterOnView.ts +80 -0
- package/src/internal/useFloatingBar.ts +125 -0
- package/src/internal/useFormReset.ts +47 -0
- package/src/internal/useIsMobile.ts +64 -0
- package/src/internal/useNoImplicitSubmit.ts +41 -0
- package/src/internal/useOneRowOverflow.ts +103 -0
- package/src/internal/usePrefersReducedMotion.ts +27 -0
- package/src/internal/useReturnFocus.ts +34 -0
- package/src/internal/utils.ts +58 -0
- package/src/recipes/EmptyState.stories.tsx +105 -0
- package/src/recipes/Form.stories.tsx +355 -0
- package/src/recipes/ModalWithForm.stories.tsx +219 -0
- package/src/recipes/Recipes.mdx +61 -0
- package/src/recipes/TableWithFilters.stories.tsx +278 -0
- package/src/storybook/FodsFamily.tsx +39 -0
- package/src/storybook/Section.tsx +36 -0
- package/src/storybook/a11y.ts +24 -0
- package/src/storybook/assets/banner-character-bartender.webp +0 -0
- package/src/storybook/assets/banner-invoice-sheet-left.webp +0 -0
- package/src/storybook/assets/banner-invoice-sheet-right.webp +0 -0
- package/src/storybook/assets/invoice-hero.webp +0 -0
- package/src/storybook/assets/invoice.webp +0 -0
- package/src/storybook/assets/section-document-info.svg +21 -0
- package/src/storybook/assets/section-gear-checklist.svg +11 -0
- package/src/storybook/assets/section-person-arrow-in.svg +15 -0
- package/src/storybook/assets/section-person-arrow-out.svg +22 -0
- package/src/storybook/assets/section-receipt-dollar.svg +23 -0
- package/src/storybook/assets/table-empty-folder-empty.png +0 -0
- package/src/storybook/assets/table-empty-folder-magnifying-glass.png +0 -0
- package/src/storybook/assets/table-empty-funnel.png +0 -0
- package/src/storybook/assets/table-empty-load-failed.png +0 -0
- package/src/storybook/assets/wallet-spot.png +0 -0
- package/src/storybook/assets.d.ts +17 -0
- package/src/storybook/componentDoc.ts +41 -0
- package/src/storybook/fitFrame.tsx +70 -0
- package/src/storybook/forceStates.tsx +647 -0
- package/src/storybook/illustrations.tsx +66 -0
- package/src/storybook/viewportFrame.tsx +58 -0
- package/src/styles/assets/label-brush-1.svg +6 -0
- package/src/styles/assets/pattern-dark.svg +113 -0
- package/src/styles/base.css +106 -0
- package/src/styles/index.css +15 -0
- package/src/styles/motion.css +157 -0
- package/src/styles/promo-sticker.css +27 -0
- package/src/styles/promo-surface.css +49 -0
- package/src/styles/shared.css +11 -0
- package/src/styles/theme.generated.css +314 -0
- package/src/styles/theme.map.json +278 -0
- package/src/styles/tracking.generated.css +12 -0
- package/src/tokens/index.ts +4 -0
- package/src/tokens/tokens.generated.ts +542 -0
|
@@ -0,0 +1,407 @@
|
|
|
1
|
+
import * as React from 'react';
|
|
2
|
+
import type { Decorator, Meta, StoryObj } from '@storybook/react-vite';
|
|
3
|
+
import { Field } from '../field/Field';
|
|
4
|
+
import {
|
|
5
|
+
FormSection,
|
|
6
|
+
type FormSectionHeader,
|
|
7
|
+
type FormSectionHeadingLevel,
|
|
8
|
+
} from './FormSection';
|
|
9
|
+
import { TextField } from '../text-field/TextField';
|
|
10
|
+
import { componentDoc } from '../../storybook/componentDoc';
|
|
11
|
+
import {
|
|
12
|
+
SECTION_ILLUSTRATION_NAMES,
|
|
13
|
+
sectionIllustration,
|
|
14
|
+
type SectionIllustrationName,
|
|
15
|
+
} from '../../storybook/illustrations';
|
|
16
|
+
|
|
17
|
+
/** `axes.variant` — the Header axis, passed as the dedicated `header` prop. */
|
|
18
|
+
const HEADERS = ['none', 'h4', 'h3'] as const;
|
|
19
|
+
|
|
20
|
+
/**
|
|
21
|
+
* The five `Illustration / Section` pictures. The arg is the picture's name; the render
|
|
22
|
+
* passes the app-side element (`<img src={…} alt="" />`) — the package ships no picture.
|
|
23
|
+
*/
|
|
24
|
+
const ILLUSTRATIONS = SECTION_ILLUSTRATION_NAMES;
|
|
25
|
+
|
|
26
|
+
const HEADING_LEVELS = [2, 3, 4, 5, 6] as const;
|
|
27
|
+
|
|
28
|
+
/**
|
|
29
|
+
* `axes.breakpoint` — NOT a prop (`properties[Breakpoint].maps`): reproduced by the
|
|
30
|
+
* viewport. Each viewport is the band minimum (1280 / 1024 / 768 / 640), Mobile the 390
|
|
31
|
+
* reference canvas, so Tailwind lands on the right prefix.
|
|
32
|
+
*/
|
|
33
|
+
const BREAKPOINTS = ['XL', 'LG', 'MD', 'SM', 'Mobile'] as const;
|
|
34
|
+
|
|
35
|
+
const BREAKPOINT_WIDTH: Record<(typeof BREAKPOINTS)[number], number> = {
|
|
36
|
+
XL: 1280,
|
|
37
|
+
LG: 1024,
|
|
38
|
+
MD: 768,
|
|
39
|
+
SM: 640,
|
|
40
|
+
Mobile: 390,
|
|
41
|
+
};
|
|
42
|
+
|
|
43
|
+
const FORM_SECTION_VIEWPORTS = Object.fromEntries(
|
|
44
|
+
BREAKPOINTS.map(bp => [
|
|
45
|
+
bp,
|
|
46
|
+
{
|
|
47
|
+
name: `${bp} · ${BREAKPOINT_WIDTH[bp]}`,
|
|
48
|
+
// fods-lint-disable-next-line Storybook viewport sizes (band minimums), not design values
|
|
49
|
+
styles: { width: `${BREAKPOINT_WIDTH[bp]}px`, height: '900px' },
|
|
50
|
+
},
|
|
51
|
+
]),
|
|
52
|
+
);
|
|
53
|
+
|
|
54
|
+
/** The section never paints a surface; the Form Block does. Modelled as a plain page pad. */
|
|
55
|
+
const pagePad: Decorator = Story => (
|
|
56
|
+
<div className="w-full bg-background-primary p-600 md:p-900">
|
|
57
|
+
<Story />
|
|
58
|
+
</div>
|
|
59
|
+
);
|
|
60
|
+
|
|
61
|
+
interface DemoFieldProps {
|
|
62
|
+
label: string;
|
|
63
|
+
value?: string;
|
|
64
|
+
placeholder?: string;
|
|
65
|
+
hideLabel?: boolean;
|
|
66
|
+
error?: string;
|
|
67
|
+
}
|
|
68
|
+
|
|
69
|
+
/** A Size md Text Field with its floating label — the default slot content. */
|
|
70
|
+
function DemoField({ label, value, placeholder, hideLabel, error }: DemoFieldProps) {
|
|
71
|
+
const id = React.useId();
|
|
72
|
+
return (
|
|
73
|
+
<Field label={label} hideLabel={hideLabel} size="md" error={error}>
|
|
74
|
+
<TextField id={id} size="md" defaultValue={value} placeholder={placeholder} />
|
|
75
|
+
</Field>
|
|
76
|
+
);
|
|
77
|
+
}
|
|
78
|
+
|
|
79
|
+
/** Default slot content per Header (`slots.fields.note`). */
|
|
80
|
+
function NoneFields() {
|
|
81
|
+
return (
|
|
82
|
+
<>
|
|
83
|
+
<DemoField label="Číslo" value="V2026090001" />
|
|
84
|
+
<DemoField label="Číslo dokladu" />
|
|
85
|
+
<DemoField label="Datum vystavení" value="02. 09. 2026" />
|
|
86
|
+
<DemoField label="Datum zdanitelného plnění" />
|
|
87
|
+
</>
|
|
88
|
+
);
|
|
89
|
+
}
|
|
90
|
+
|
|
91
|
+
function H4Fields() {
|
|
92
|
+
return (
|
|
93
|
+
// A Text Field stands in for the Subject Lookup Field. A half at
|
|
94
|
+
// LG/XL, the full width at MD (width marker).
|
|
95
|
+
<FormSection.Cell span={{ md: 'full', lg: 1 }}>
|
|
96
|
+
<DemoField label="Prodejce" hideLabel placeholder="Vyhledejte název firmy nebo IČO" />
|
|
97
|
+
</FormSection.Cell>
|
|
98
|
+
);
|
|
99
|
+
}
|
|
100
|
+
|
|
101
|
+
function H3Fields() {
|
|
102
|
+
return (
|
|
103
|
+
<>
|
|
104
|
+
<DemoField label="IČO" />
|
|
105
|
+
<DemoField label="Jméno" />
|
|
106
|
+
<DemoField label="DIČ" />
|
|
107
|
+
<DemoField label="Ulice" />
|
|
108
|
+
</>
|
|
109
|
+
);
|
|
110
|
+
}
|
|
111
|
+
|
|
112
|
+
const COPY = {
|
|
113
|
+
h4: { title: 'Prodejce na dokladu', description: '… neboli Dodavatel' },
|
|
114
|
+
h3: { title: 'Informace o vás', description: '… neboli Dodavatel' },
|
|
115
|
+
} as const;
|
|
116
|
+
|
|
117
|
+
/** Flat story args; the render turns them into the right arm of the header union. */
|
|
118
|
+
interface FormSectionStoryArgs {
|
|
119
|
+
header: FormSectionHeader;
|
|
120
|
+
title: string;
|
|
121
|
+
description?: string;
|
|
122
|
+
illustration: SectionIllustrationName;
|
|
123
|
+
span: 1 | 'full';
|
|
124
|
+
headingLevel?: FormSectionHeadingLevel;
|
|
125
|
+
children?: React.ReactNode;
|
|
126
|
+
}
|
|
127
|
+
|
|
128
|
+
function defaultFields(header: FormSectionHeader) {
|
|
129
|
+
if (header === 'h4') return <H4Fields />;
|
|
130
|
+
if (header === 'h3') return <H3Fields />;
|
|
131
|
+
return <NoneFields />;
|
|
132
|
+
}
|
|
133
|
+
|
|
134
|
+
function renderSection({ header, title, description, illustration, span, headingLevel, children }: FormSectionStoryArgs) {
|
|
135
|
+
const fields = children ?? defaultFields(header);
|
|
136
|
+
if (header === 'h4') {
|
|
137
|
+
return (
|
|
138
|
+
<FormSection header="h4" title={title} description={description} span={span} headingLevel={headingLevel}>
|
|
139
|
+
{fields}
|
|
140
|
+
</FormSection>
|
|
141
|
+
);
|
|
142
|
+
}
|
|
143
|
+
if (header === 'h3') {
|
|
144
|
+
return (
|
|
145
|
+
<FormSection
|
|
146
|
+
header="h3"
|
|
147
|
+
title={title}
|
|
148
|
+
description={description}
|
|
149
|
+
illustration={sectionIllustration(illustration)}
|
|
150
|
+
span={span}
|
|
151
|
+
headingLevel={headingLevel}
|
|
152
|
+
>
|
|
153
|
+
{fields}
|
|
154
|
+
</FormSection>
|
|
155
|
+
);
|
|
156
|
+
}
|
|
157
|
+
return (
|
|
158
|
+
<FormSection span={span} headingLevel={headingLevel}>
|
|
159
|
+
{fields}
|
|
160
|
+
</FormSection>
|
|
161
|
+
);
|
|
162
|
+
}
|
|
163
|
+
|
|
164
|
+
const meta: Meta<FormSectionStoryArgs> = {
|
|
165
|
+
title: 'Design System/Organisms/Form Section',
|
|
166
|
+
// Storybook 10 types `component` against the story args; the flat args do not match
|
|
167
|
+
// the header union of FormSectionProps, so cast through unknown.
|
|
168
|
+
component: FormSection as unknown as React.ComponentType<FormSectionStoryArgs>,
|
|
169
|
+
// No autodocs tag — FormSection.mdx provides the dedicated Docs page.
|
|
170
|
+
decorators: [pagePad],
|
|
171
|
+
globals: { viewport: { value: 'XL' } },
|
|
172
|
+
parameters: {
|
|
173
|
+
layout: 'fullscreen',
|
|
174
|
+
viewport: { options: FORM_SECTION_VIEWPORTS },
|
|
175
|
+
docs: {
|
|
176
|
+
description: {
|
|
177
|
+
component: componentDoc({
|
|
178
|
+
summary:
|
|
179
|
+
'One group of fields inside a Form Block — an optional H4 heading over a responsive grid of halves, pairs and trio rows. Paints nothing; only lays out. Built against form-section.manifest.json 2.0.0.',
|
|
180
|
+
useCases: [
|
|
181
|
+
'`header="none"` (default) for a block\'s only group — the block header names it; the section element is the grid itself.',
|
|
182
|
+
'`header="h4"` for one of two or more sub-groups under a block header; never with a picture.',
|
|
183
|
+
'`header="h3"` is deprecated — the legacy parties tile only, with a required `illustration`.',
|
|
184
|
+
'The breakpoint is not a prop: tracks and gaps follow the viewport. Use the toolbar viewports or the Breakpoint stories.',
|
|
185
|
+
],
|
|
186
|
+
bestPractices: [
|
|
187
|
+
'Write children in mobile reading order; a bare child is a half, `<FormSection.Cell span="full">` the full width.',
|
|
188
|
+
'Three short related fields in a row go into `<FormSection.Trio>`; two short fields in one half into `<FormSection.Pair>`.',
|
|
189
|
+
'An input stays at or under ~768 px: a per-breakpoint Cell span such as `{ md: "full", lg: 1 }` keeps it a half at LG/XL.',
|
|
190
|
+
'`span={1}` when the section takes one track of the block grid — its fields then run on one track at LG/XL.',
|
|
191
|
+
],
|
|
192
|
+
knownIssues: [
|
|
193
|
+
'The H4 default content uses a Text Field in place of the Subject Lookup Field.',
|
|
194
|
+
],
|
|
195
|
+
docsLink: {
|
|
196
|
+
label: 'spec/05-organisms/form-section.md',
|
|
197
|
+
},
|
|
198
|
+
}),
|
|
199
|
+
},
|
|
200
|
+
},
|
|
201
|
+
},
|
|
202
|
+
argTypes: {
|
|
203
|
+
header: { control: 'inline-radio', options: HEADERS },
|
|
204
|
+
title: { control: 'text', if: { arg: 'header', neq: 'none' } },
|
|
205
|
+
description: { control: 'text', if: { arg: 'header', neq: 'none' } },
|
|
206
|
+
illustration: {
|
|
207
|
+
control: 'select',
|
|
208
|
+
options: ILLUSTRATIONS,
|
|
209
|
+
table: { type: { summary: 'React.ReactElement' } },
|
|
210
|
+
description:
|
|
211
|
+
'A React element (the app passes `<img src={…} alt="" />` of its own copy). The story maps the picked name to an `<img alt="">` of that Illustration / Section picture.',
|
|
212
|
+
if: { arg: 'header', eq: 'h3' },
|
|
213
|
+
},
|
|
214
|
+
span: { control: 'inline-radio', options: [1, 'full'] },
|
|
215
|
+
headingLevel: { control: 'select', options: HEADING_LEVELS, if: { arg: 'header', neq: 'none' } },
|
|
216
|
+
children: { table: { disable: true } },
|
|
217
|
+
},
|
|
218
|
+
args: {
|
|
219
|
+
header: 'none',
|
|
220
|
+
title: COPY.h4.title,
|
|
221
|
+
description: COPY.h4.description,
|
|
222
|
+
illustration: 'person-arrow-out',
|
|
223
|
+
span: 'full',
|
|
224
|
+
},
|
|
225
|
+
render: renderSection,
|
|
226
|
+
};
|
|
227
|
+
|
|
228
|
+
export default meta;
|
|
229
|
+
type Story = StoryObj<FormSectionStoryArgs>;
|
|
230
|
+
|
|
231
|
+
/** The interactive section — switch the viewport in the toolbar to walk the Breakpoint ladder. */
|
|
232
|
+
export const Playground: Story = {};
|
|
233
|
+
|
|
234
|
+
function Labelled({ label, children }: { label: string; children: React.ReactNode }) {
|
|
235
|
+
return (
|
|
236
|
+
<div className="flex flex-col gap-300">
|
|
237
|
+
<p className="text-body-xs text-text-secondary">{label}</p>
|
|
238
|
+
{children}
|
|
239
|
+
</div>
|
|
240
|
+
);
|
|
241
|
+
}
|
|
242
|
+
|
|
243
|
+
/**
|
|
244
|
+
* Header (rows) at the current viewport — the component has no size axis, the Breakpoint
|
|
245
|
+
* axis is the viewport. The second block compares `span={1}` with `'full'`.
|
|
246
|
+
*/
|
|
247
|
+
export const Matrix: Story = {
|
|
248
|
+
parameters: { controls: { disable: true } },
|
|
249
|
+
render: () => (
|
|
250
|
+
<div className="flex flex-col gap-1200">
|
|
251
|
+
{HEADERS.map(header => (
|
|
252
|
+
<Labelled key={header} label={`header = ${header}`}>
|
|
253
|
+
{renderSection({
|
|
254
|
+
header,
|
|
255
|
+
title: header === 'h3' ? COPY.h3.title : COPY.h4.title,
|
|
256
|
+
description: header === 'h3' ? COPY.h3.description : COPY.h4.description,
|
|
257
|
+
illustration: 'person-arrow-out',
|
|
258
|
+
span: 'full',
|
|
259
|
+
})}
|
|
260
|
+
</Labelled>
|
|
261
|
+
))}
|
|
262
|
+
<div className="grid grid-cols-1 gap-1000 lg:grid-cols-2">
|
|
263
|
+
<Labelled label="span = 1 (one block-grid track — fields on 1 track at LG/XL)">
|
|
264
|
+
<FormSection span={1}>
|
|
265
|
+
<NoneFields />
|
|
266
|
+
</FormSection>
|
|
267
|
+
</Labelled>
|
|
268
|
+
<Labelled label="span = full">
|
|
269
|
+
<FormSection span="full">
|
|
270
|
+
<NoneFields />
|
|
271
|
+
</FormSection>
|
|
272
|
+
</Labelled>
|
|
273
|
+
</div>
|
|
274
|
+
</div>
|
|
275
|
+
),
|
|
276
|
+
};
|
|
277
|
+
|
|
278
|
+
function TrioFields() {
|
|
279
|
+
return (
|
|
280
|
+
<FormSection.Trio>
|
|
281
|
+
<DemoField label="Jméno nebo název" />
|
|
282
|
+
<DemoField label="IČO" />
|
|
283
|
+
<DemoField label="DIČ" />
|
|
284
|
+
</FormSection.Trio>
|
|
285
|
+
);
|
|
286
|
+
}
|
|
287
|
+
|
|
288
|
+
/** A trio row: 3 tracks at LG/XL, 2 at MD (DIČ wraps under the first), 1 below. */
|
|
289
|
+
export const WithTrio: Story = {
|
|
290
|
+
args: { header: 'h4', title: 'Odběratel', description: undefined, children: <TrioFields /> },
|
|
291
|
+
};
|
|
292
|
+
|
|
293
|
+
/** A pair: PSČ + Město share one half; Ulice takes the other. */
|
|
294
|
+
export const WithPair: Story = {
|
|
295
|
+
args: {
|
|
296
|
+
header: 'h4',
|
|
297
|
+
title: 'Adresa',
|
|
298
|
+
description: undefined,
|
|
299
|
+
children: (
|
|
300
|
+
<>
|
|
301
|
+
<DemoField label="Ulice" />
|
|
302
|
+
<FormSection.Pair>
|
|
303
|
+
<DemoField label="PSČ" />
|
|
304
|
+
<DemoField label="Město" />
|
|
305
|
+
</FormSection.Pair>
|
|
306
|
+
</>
|
|
307
|
+
),
|
|
308
|
+
},
|
|
309
|
+
};
|
|
310
|
+
|
|
311
|
+
/** The five `Illustration / Section` pictures at the deprecated `h3` header. */
|
|
312
|
+
export const Illustrations: Story = {
|
|
313
|
+
parameters: { controls: { disable: true } },
|
|
314
|
+
render: () => (
|
|
315
|
+
<div className="flex flex-col gap-1200">
|
|
316
|
+
{ILLUSTRATIONS.map(illustration => (
|
|
317
|
+
<Labelled key={illustration} label={`illustration = ${illustration}`}>
|
|
318
|
+
{renderSection({
|
|
319
|
+
header: 'h3',
|
|
320
|
+
title: COPY.h3.title,
|
|
321
|
+
description: COPY.h3.description,
|
|
322
|
+
illustration,
|
|
323
|
+
span: 'full',
|
|
324
|
+
})}
|
|
325
|
+
</Labelled>
|
|
326
|
+
))}
|
|
327
|
+
</div>
|
|
328
|
+
),
|
|
329
|
+
};
|
|
330
|
+
|
|
331
|
+
/**
|
|
332
|
+
* An error message under one field of a row: cells align to the top, so the neighbour stays put
|
|
333
|
+
* and only the rows below move down (the section owns this layout consequence).
|
|
334
|
+
*/
|
|
335
|
+
export const ErrorInRow: Story = {
|
|
336
|
+
args: {
|
|
337
|
+
header: 'h4',
|
|
338
|
+
title: 'Odběratel',
|
|
339
|
+
description: undefined,
|
|
340
|
+
children: (
|
|
341
|
+
<>
|
|
342
|
+
<DemoField label="Číslo" value="V20260" error="Číslo dokladu musí mít 11 znaků" />
|
|
343
|
+
<DemoField label="Číslo dokladu" />
|
|
344
|
+
<DemoField label="Datum vystavení" value="02. 09. 2026" />
|
|
345
|
+
<DemoField label="Datum zdanitelného plnění" />
|
|
346
|
+
</>
|
|
347
|
+
),
|
|
348
|
+
},
|
|
349
|
+
};
|
|
350
|
+
|
|
351
|
+
/** H4 section with halves, a pair and a trio — every track change of the ladder at once. */
|
|
352
|
+
function BreakpointContent() {
|
|
353
|
+
return (
|
|
354
|
+
<>
|
|
355
|
+
<DemoField label="Číslo" value="V2026090001" />
|
|
356
|
+
<DemoField label="Číslo dokladu" />
|
|
357
|
+
<DemoField label="Ulice" />
|
|
358
|
+
<FormSection.Pair>
|
|
359
|
+
<DemoField label="PSČ" />
|
|
360
|
+
<DemoField label="Město" />
|
|
361
|
+
</FormSection.Pair>
|
|
362
|
+
<TrioFields />
|
|
363
|
+
</>
|
|
364
|
+
);
|
|
365
|
+
}
|
|
366
|
+
|
|
367
|
+
const breakpointArgs: Partial<FormSectionStoryArgs> = {
|
|
368
|
+
header: 'h4',
|
|
369
|
+
title: COPY.h4.title,
|
|
370
|
+
description: COPY.h4.description,
|
|
371
|
+
children: <BreakpointContent />,
|
|
372
|
+
};
|
|
373
|
+
|
|
374
|
+
/** XL — 1280: 2 tracks, column gap --space-1000, trio on 3 tracks. */
|
|
375
|
+
export const BreakpointXL: Story = {
|
|
376
|
+
name: 'Breakpoint · XL',
|
|
377
|
+
args: breakpointArgs,
|
|
378
|
+
globals: { viewport: { value: 'XL' } },
|
|
379
|
+
};
|
|
380
|
+
|
|
381
|
+
/** LG — 1024: same tracks and gaps as XL. */
|
|
382
|
+
export const BreakpointLG: Story = {
|
|
383
|
+
name: 'Breakpoint · LG',
|
|
384
|
+
args: breakpointArgs,
|
|
385
|
+
globals: { viewport: { value: 'LG' } },
|
|
386
|
+
};
|
|
387
|
+
|
|
388
|
+
/** MD — 768: 2 tracks, column gap --space-900, the trio wraps 2 + 1. */
|
|
389
|
+
export const BreakpointMD: Story = {
|
|
390
|
+
name: 'Breakpoint · MD',
|
|
391
|
+
args: breakpointArgs,
|
|
392
|
+
globals: { viewport: { value: 'MD' } },
|
|
393
|
+
};
|
|
394
|
+
|
|
395
|
+
/** SM — 640: 1 track, row gap --space-700; the pair keeps 2 tracks at column gap --space-600. */
|
|
396
|
+
export const BreakpointSM: Story = {
|
|
397
|
+
name: 'Breakpoint · SM',
|
|
398
|
+
args: breakpointArgs,
|
|
399
|
+
globals: { viewport: { value: 'SM' } },
|
|
400
|
+
};
|
|
401
|
+
|
|
402
|
+
/** Mobile — 390: everything on 1 track in child order, the pair included. */
|
|
403
|
+
export const BreakpointMobile: Story = {
|
|
404
|
+
name: 'Breakpoint · Mobile',
|
|
405
|
+
args: breakpointArgs,
|
|
406
|
+
globals: { viewport: { value: 'Mobile' } },
|
|
407
|
+
};
|
|
@@ -0,0 +1,290 @@
|
|
|
1
|
+
"use client";
|
|
2
|
+
|
|
3
|
+
import * as React from 'react';
|
|
4
|
+
import { tv } from '../../internal/tailwind-variants';
|
|
5
|
+
import { cn } from '../../internal/utils';
|
|
6
|
+
import { HeadingGroup } from '../heading-group/HeadingGroup';
|
|
7
|
+
|
|
8
|
+
/**
|
|
9
|
+
* FormSection — one group of fields inside a Form Block (`form-section.manifest.json`,
|
|
10
|
+
* organism, v2.0.0, `kind: "region"`).
|
|
11
|
+
*
|
|
12
|
+
* The section paints nothing (`container.note`); it only lays out: an optional Heading
|
|
13
|
+
* Group, then the field grid (`chrome.field-grid`), separated by `chrome.header-gap`.
|
|
14
|
+
*
|
|
15
|
+
* ## Breakpoint is not a prop
|
|
16
|
+
*
|
|
17
|
+
* `properties[Breakpoint].maps`: the section reads the viewport media queries, exactly
|
|
18
|
+
* like its Form Block. Mobile = unprefixed, SM = `sm:`, MD = `md:`, LG = `lg:`, XL = `xl:`.
|
|
19
|
+
* Every XL value equals its LG value, so `lg:` covers both.
|
|
20
|
+
*
|
|
21
|
+
* ## The fields container IS the grid
|
|
22
|
+
*
|
|
23
|
+
* `notes[0]` / `delivery.react`: at `header="none"` the section element itself is the
|
|
24
|
+
* grid; at `h4` / `h3` the `role="group"` element holds the header and exactly one grid,
|
|
25
|
+
* with no wrapper between that grid and the fields. Tracks are Tailwind's
|
|
26
|
+
* `grid-cols-N` = `repeat(N, minmax(0, 1fr))`, every child gets `min-w-0`, the grid
|
|
27
|
+
* auto-flows by row (never dense) and cells align to the top.
|
|
28
|
+
*
|
|
29
|
+
* ## Illustration (`h3` only)
|
|
30
|
+
*
|
|
31
|
+
* The package ships no picture (`delivery.react`, 1.3.0): at `header="h3"` the app passes
|
|
32
|
+
* the `Illustration / Section` picture as a React element (`<img src={…} alt="" />` or an
|
|
33
|
+
* inline SVG). The Heading Group draws it in its 48 px picture box, which is `aria-hidden`.
|
|
34
|
+
*
|
|
35
|
+
* ## No states
|
|
36
|
+
*
|
|
37
|
+
* No `axes.state`: focus, error, disabled and read-only live on the fields. Nothing in
|
|
38
|
+
* the section is interactive, so there is no disabled propagation to do.
|
|
39
|
+
*/
|
|
40
|
+
const formSectionVariants = tv({
|
|
41
|
+
slots: {
|
|
42
|
+
root: 'flex flex-col',
|
|
43
|
+
self: '',
|
|
44
|
+
// chrome.field-grid: 1 track below MD (row gap --space-700); 2 tracks from MD with
|
|
45
|
+
// column gap --space-900 (MD) / --space-1000 (LG/XL) and row gap --space-900.
|
|
46
|
+
fieldGrid: [
|
|
47
|
+
'grid grid-flow-row grid-cols-1 items-start gap-y-700 *:min-w-0',
|
|
48
|
+
'md:grid-cols-2 md:gap-x-900 md:gap-y-900',
|
|
49
|
+
'lg:gap-x-1000',
|
|
50
|
+
],
|
|
51
|
+
cell: 'min-w-0',
|
|
52
|
+
// chrome.trio: one full-width child of the field grid; 1 track below MD (row gap
|
|
53
|
+
// --space-700), 2 at MD (column --space-800, row --space-900), 3 at LG/XL.
|
|
54
|
+
trio: [
|
|
55
|
+
'col-span-full grid min-w-0 grid-flow-row grid-cols-1 items-start gap-y-700 *:min-w-0',
|
|
56
|
+
'md:grid-cols-2 md:gap-x-800 md:gap-y-900',
|
|
57
|
+
'lg:grid-cols-3',
|
|
58
|
+
],
|
|
59
|
+
// chrome.nested-pair: one half; 1 track at Mobile (row gap --space-700), 2 tracks
|
|
60
|
+
// from SM with column gap --space-600 (SM) / --space-800 (MD and up).
|
|
61
|
+
pair: [
|
|
62
|
+
'grid min-w-0 grid-flow-row grid-cols-1 items-start gap-y-700 *:min-w-0',
|
|
63
|
+
'sm:grid-cols-2 sm:gap-x-600',
|
|
64
|
+
'md:gap-x-800',
|
|
65
|
+
],
|
|
66
|
+
},
|
|
67
|
+
variants: {
|
|
68
|
+
// chrome.header-gap — no gap at none (the root is the grid itself).
|
|
69
|
+
header: {
|
|
70
|
+
none: {},
|
|
71
|
+
h4: { root: 'gap-600 md:gap-800' },
|
|
72
|
+
h3: { root: 'gap-800 md:gap-900' },
|
|
73
|
+
},
|
|
74
|
+
// delivery.react: span is the section's own width in the Form Block content grid
|
|
75
|
+
// (`self`, on whichever element is the root). A section on one track of the 2-track
|
|
76
|
+
// LG/XL block grid also runs its fields on 1 track. Below LG every section is full width.
|
|
77
|
+
span: {
|
|
78
|
+
1: { self: 'col-span-full lg:col-span-1', fieldGrid: 'lg:grid-cols-1' },
|
|
79
|
+
full: { self: 'col-span-full' },
|
|
80
|
+
},
|
|
81
|
+
},
|
|
82
|
+
defaultVariants: {
|
|
83
|
+
header: 'none',
|
|
84
|
+
span: 'full',
|
|
85
|
+
},
|
|
86
|
+
});
|
|
87
|
+
|
|
88
|
+
export type FormSectionHeader = 'none' | 'h4' | 'h3';
|
|
89
|
+
export type FormSectionHeadingLevel = 2 | 3 | 4 | 5 | 6;
|
|
90
|
+
|
|
91
|
+
interface FormSectionBaseProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'title' | 'children'> {
|
|
92
|
+
/**
|
|
93
|
+
* The section's own width in the Form Block grid: one block-grid track or the full
|
|
94
|
+
* width. `1` runs the fields on a single track at LG/XL. Default `'full'`.
|
|
95
|
+
*/
|
|
96
|
+
span?: 1 | 'full';
|
|
97
|
+
/** Heading element level (2–6). Defaults to 3 at `h4`, 2 at `h3`. */
|
|
98
|
+
headingLevel?: FormSectionHeadingLevel;
|
|
99
|
+
/** The fields, in mobile reading order. */
|
|
100
|
+
children?: React.ReactNode;
|
|
101
|
+
}
|
|
102
|
+
|
|
103
|
+
export type FormSectionProps = FormSectionBaseProps &
|
|
104
|
+
(
|
|
105
|
+
| { header?: 'none'; title?: never; description?: never; illustration?: never }
|
|
106
|
+
| { header: 'h4'; title: string; description?: string; illustration?: never }
|
|
107
|
+
| {
|
|
108
|
+
/** @deprecated `h3` exists only for the legacy parties tile — new screens use one Form Block per party. */
|
|
109
|
+
header: 'h3';
|
|
110
|
+
title: string;
|
|
111
|
+
description?: string;
|
|
112
|
+
/**
|
|
113
|
+
* The `Illustration / Section` picture, supplied by the app (e.g.
|
|
114
|
+
* `<img src={personArrowOut} alt="" />` or an inline SVG): the package ships no
|
|
115
|
+
* picture. Drawn in the Heading Group's 48 px picture box, which is `aria-hidden`.
|
|
116
|
+
*/
|
|
117
|
+
illustration: React.ReactElement;
|
|
118
|
+
}
|
|
119
|
+
);
|
|
120
|
+
|
|
121
|
+
const FormSectionRoot = React.forwardRef<HTMLDivElement, FormSectionProps>(
|
|
122
|
+
(
|
|
123
|
+
{ header = 'none', title, description, illustration, span = 'full', headingLevel, className, children, ...props },
|
|
124
|
+
ref,
|
|
125
|
+
) => {
|
|
126
|
+
const headingId = React.useId();
|
|
127
|
+
const descriptionId = React.useId();
|
|
128
|
+
const slots = formSectionVariants({ header, span });
|
|
129
|
+
|
|
130
|
+
if (header === 'none') {
|
|
131
|
+
return (
|
|
132
|
+
<div
|
|
133
|
+
ref={ref}
|
|
134
|
+
className={cn(slots.fieldGrid(), slots.self(), className)}
|
|
135
|
+
data-fods-component="form-section"
|
|
136
|
+
data-fods-part="field-grid"
|
|
137
|
+
{...props}
|
|
138
|
+
>
|
|
139
|
+
{children}
|
|
140
|
+
</div>
|
|
141
|
+
);
|
|
142
|
+
}
|
|
143
|
+
|
|
144
|
+
const hasDescription = description != null && description !== '';
|
|
145
|
+
|
|
146
|
+
return (
|
|
147
|
+
<div
|
|
148
|
+
ref={ref}
|
|
149
|
+
role="group"
|
|
150
|
+
aria-labelledby={headingId}
|
|
151
|
+
aria-describedby={hasDescription ? descriptionId : undefined}
|
|
152
|
+
className={cn(slots.root(), slots.self(), className)}
|
|
153
|
+
data-fods-component="form-section"
|
|
154
|
+
data-fods-part="root"
|
|
155
|
+
{...props}
|
|
156
|
+
>
|
|
157
|
+
<HeadingGroup
|
|
158
|
+
data-fods-part="header"
|
|
159
|
+
size={header}
|
|
160
|
+
level={headingLevel ?? (header === 'h3' ? 2 : 3)}
|
|
161
|
+
heading={title}
|
|
162
|
+
description={description}
|
|
163
|
+
headingId={headingId}
|
|
164
|
+
descriptionId={descriptionId}
|
|
165
|
+
illustration={header === 'h3' ? illustration : undefined}
|
|
166
|
+
/>
|
|
167
|
+
<div data-fods-part="field-grid" className={slots.fieldGrid()}>
|
|
168
|
+
{children}
|
|
169
|
+
</div>
|
|
170
|
+
</div>
|
|
171
|
+
);
|
|
172
|
+
},
|
|
173
|
+
);
|
|
174
|
+
FormSectionRoot.displayName = 'FormSection';
|
|
175
|
+
|
|
176
|
+
export type FormSectionBreakpoint = 'mobile' | 'sm' | 'md' | 'lg' | 'xl';
|
|
177
|
+
export type FormSectionCellSpanValue = 1 | 'full';
|
|
178
|
+
export type FormSectionCellSpan =
|
|
179
|
+
| FormSectionCellSpanValue
|
|
180
|
+
| Partial<Record<FormSectionBreakpoint, FormSectionCellSpanValue>>;
|
|
181
|
+
|
|
182
|
+
// Literal class strings so Tailwind's source scan generates every one of them.
|
|
183
|
+
const CELL_SPAN_CLASS: Record<FormSectionBreakpoint, Record<'1' | 'full', string>> = {
|
|
184
|
+
mobile: { 1: 'col-span-1', full: 'col-span-full' },
|
|
185
|
+
sm: { 1: 'sm:col-span-1', full: 'sm:col-span-full' },
|
|
186
|
+
md: { 1: 'md:col-span-1', full: 'md:col-span-full' },
|
|
187
|
+
lg: { 1: 'lg:col-span-1', full: 'lg:col-span-full' },
|
|
188
|
+
xl: { 1: 'xl:col-span-1', full: 'xl:col-span-full' },
|
|
189
|
+
};
|
|
190
|
+
|
|
191
|
+
const BREAKPOINTS_DESC: readonly FormSectionBreakpoint[] = ['xl', 'lg', 'md', 'sm', 'mobile'];
|
|
192
|
+
|
|
193
|
+
/**
|
|
194
|
+
* Resolves a Cell span to classes. An unlisted breakpoint inherits the next larger one
|
|
195
|
+
* (`delivery.react`), XL falls back to a half; a class is emitted only where the
|
|
196
|
+
* resolved value changes going up from Mobile.
|
|
197
|
+
*/
|
|
198
|
+
export function resolveCellSpanClasses(span: FormSectionCellSpan): string {
|
|
199
|
+
if (typeof span !== 'object') return span === 'full' ? CELL_SPAN_CLASS.mobile.full : '';
|
|
200
|
+
|
|
201
|
+
const resolved = {} as Record<FormSectionBreakpoint, FormSectionCellSpanValue>;
|
|
202
|
+
let inherited: FormSectionCellSpanValue = 1;
|
|
203
|
+
BREAKPOINTS_DESC.forEach((bp) => {
|
|
204
|
+
inherited = span[bp] ?? inherited;
|
|
205
|
+
resolved[bp] = inherited;
|
|
206
|
+
});
|
|
207
|
+
|
|
208
|
+
const classes: string[] = [];
|
|
209
|
+
let previous: FormSectionCellSpanValue = 1;
|
|
210
|
+
[...BREAKPOINTS_DESC].reverse().forEach((bp) => {
|
|
211
|
+
const value = resolved[bp];
|
|
212
|
+
if (bp === 'mobile' ? value === 'full' : value !== previous) {
|
|
213
|
+
classes.push(CELL_SPAN_CLASS[bp][value === 'full' ? 'full' : '1']);
|
|
214
|
+
}
|
|
215
|
+
previous = value;
|
|
216
|
+
});
|
|
217
|
+
return classes.join(' ');
|
|
218
|
+
}
|
|
219
|
+
|
|
220
|
+
export interface FormSectionCellProps extends React.HTMLAttributes<HTMLDivElement> {
|
|
221
|
+
/**
|
|
222
|
+
* Field-grid tracks the child takes: `1` (a half, default), `'full'`, or a
|
|
223
|
+
* per-breakpoint object such as `{ xl: 1, lg: 1, md: 'full' }`.
|
|
224
|
+
*/
|
|
225
|
+
span?: FormSectionCellSpan;
|
|
226
|
+
}
|
|
227
|
+
|
|
228
|
+
const FormSectionCell = React.forwardRef<HTMLDivElement, FormSectionCellProps>(
|
|
229
|
+
({ span = 1, className, ...props }, ref) => (
|
|
230
|
+
<div
|
|
231
|
+
ref={ref}
|
|
232
|
+
data-fods-part="cell"
|
|
233
|
+
className={cn(formSectionVariants().cell(), resolveCellSpanClasses(span), className)}
|
|
234
|
+
{...props}
|
|
235
|
+
/>
|
|
236
|
+
),
|
|
237
|
+
);
|
|
238
|
+
FormSectionCell.displayName = 'FormSection.Cell';
|
|
239
|
+
|
|
240
|
+
export interface FormSectionTrioProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'children'> {
|
|
241
|
+
/** Exactly three short related fields, in reading order. */
|
|
242
|
+
children: [React.ReactNode, React.ReactNode, React.ReactNode];
|
|
243
|
+
}
|
|
244
|
+
|
|
245
|
+
const FormSectionTrio = React.forwardRef<HTMLDivElement, FormSectionTrioProps>(
|
|
246
|
+
({ className, children, ...props }, ref) => {
|
|
247
|
+
if (process.env.NODE_ENV !== 'production' && React.Children.count(children) !== 3) {
|
|
248
|
+
console.error('FormSection.Trio takes exactly three fields; four or more are halves (chrome.trio).');
|
|
249
|
+
}
|
|
250
|
+
return (
|
|
251
|
+
<div ref={ref} data-fods-part="trio" className={cn(formSectionVariants().trio(), className)} {...props}>
|
|
252
|
+
{children}
|
|
253
|
+
</div>
|
|
254
|
+
);
|
|
255
|
+
},
|
|
256
|
+
);
|
|
257
|
+
FormSectionTrio.displayName = 'FormSection.Trio';
|
|
258
|
+
|
|
259
|
+
export interface FormSectionPairProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'children'> {
|
|
260
|
+
/** Exactly two short related fields whose labels fit one line. */
|
|
261
|
+
children: [React.ReactNode, React.ReactNode];
|
|
262
|
+
}
|
|
263
|
+
|
|
264
|
+
const FormSectionPair = React.forwardRef<HTMLDivElement, FormSectionPairProps>(
|
|
265
|
+
({ className, children, ...props }, ref) => {
|
|
266
|
+
if (process.env.NODE_ENV !== 'production' && React.Children.count(children) !== 2) {
|
|
267
|
+
console.error('FormSection.Pair takes exactly two fields; three in a row are a Trio (chrome.nested-pair).');
|
|
268
|
+
}
|
|
269
|
+
return (
|
|
270
|
+
<div ref={ref} data-fods-part="pair" className={cn(formSectionVariants().pair(), className)} {...props}>
|
|
271
|
+
{children}
|
|
272
|
+
</div>
|
|
273
|
+
);
|
|
274
|
+
},
|
|
275
|
+
);
|
|
276
|
+
FormSectionPair.displayName = 'FormSection.Pair';
|
|
277
|
+
|
|
278
|
+
type FormSectionComponent = typeof FormSectionRoot & {
|
|
279
|
+
Cell: typeof FormSectionCell;
|
|
280
|
+
Trio: typeof FormSectionTrio;
|
|
281
|
+
Pair: typeof FormSectionPair;
|
|
282
|
+
};
|
|
283
|
+
|
|
284
|
+
const FormSection = Object.assign(FormSectionRoot, {
|
|
285
|
+
Cell: FormSectionCell,
|
|
286
|
+
Trio: FormSectionTrio,
|
|
287
|
+
Pair: FormSectionPair,
|
|
288
|
+
}) as FormSectionComponent;
|
|
289
|
+
|
|
290
|
+
export { FormSection, FormSectionCell, FormSectionTrio, FormSectionPair, formSectionVariants };
|