@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,518 @@
|
|
|
1
|
+
import { Meta, Canvas, Controls } from '@storybook/addon-docs/blocks';
|
|
2
|
+
import * as FormActionsStories from './FormActions.stories';
|
|
3
|
+
|
|
4
|
+
<Meta of={FormActionsStories} tags={['autodocs']} />
|
|
5
|
+
|
|
6
|
+
# FormActions
|
|
7
|
+
|
|
8
|
+
## Metadata
|
|
9
|
+
|
|
10
|
+
- **Layer:** organism
|
|
11
|
+
- **Kind:** region
|
|
12
|
+
- **Status:** draft
|
|
13
|
+
- **Tokens used:** `--bg-edge-shadow`, `--bg-primary`, `--border-width-100`, `--radius-700`, `--space-1000`, `--space-500`, `--space-600`, `--space-800`, `--z-index-dropdown`
|
|
14
|
+
- **Manifest version:** `2.1.2`
|
|
15
|
+
- **Composes:** nothing of its own — the slot holds the form's [Button](?path=/docs/design-system-atoms-button--docs), [IconButton](?path=/docs/design-system-atoms-iconbutton--docs) and [TextLink](?path=/docs/design-system-atoms-textlink--docs) actions; the manifest's Fade Overlay is realised as an edge band of the bar's own (see Anatomy)
|
|
16
|
+
|
|
17
|
+
The token list above covers the bar's own classes; the
|
|
18
|
+
actions in the slot bring their own atoms' tokens.
|
|
19
|
+
|
|
20
|
+
## Overview
|
|
21
|
+
|
|
22
|
+
**FormActions** is the sticky actions bar that closes a form page: one slot the form fills with its
|
|
23
|
+
own actions, laid out in one row or two rows per breakpoint, the Brand primary last.
|
|
24
|
+
|
|
25
|
+
The bar owns sticking and floating, the padding and gaps, and the one-row / two-row layout. The form
|
|
26
|
+
owns everything about each action: which actions exist, element types, labels, icons, handlers,
|
|
27
|
+
loading and disabled state, the commit lock and any per-breakpoint restyling.
|
|
28
|
+
|
|
29
|
+
Render it **once per form page**, as the last element after the last Form Block, inside the page
|
|
30
|
+
`<form>`. Do **not** use it as a Sticky Context Bar, as a generic toolbar, or inside a Form Block.
|
|
31
|
+
|
|
32
|
+
## Rationale
|
|
33
|
+
|
|
34
|
+
Every form page ends with commit actions, and one element in flow after the last block keeps them
|
|
35
|
+
reachable by sticking to the viewport bottom while the form continues below. The bar owns only
|
|
36
|
+
position and layout, so each form keeps its own action set while every form page lays it out the same
|
|
37
|
+
way. The row switch follows the page breakpoint the form names with `stackBelow`, so the layout at a
|
|
38
|
+
given viewport is known before render. A form whose actions may not fit one row above that breakpoint
|
|
39
|
+
turns on `stackOnOverflow`: the bar then also stacks when its one-row content does not fit, so a narrow
|
|
40
|
+
column or a longer locale never wraps at a random action (`chrome.layout.stack-on-overflow`, see
|
|
41
|
+
Variants → Overflow).
|
|
42
|
+
|
|
43
|
+
## Anatomy
|
|
44
|
+
|
|
45
|
+
The component renders two siblings: the **root** (the sticky box) and, directly after it, the
|
|
46
|
+
**sentinel**. Inside the root sit the edge band and the painted bar, in that order; the bar holds the
|
|
47
|
+
children exactly as given.
|
|
48
|
+
|
|
49
|
+
<table>
|
|
50
|
+
<thead>
|
|
51
|
+
<tr><th>Part</th><th>Element</th><th>Role</th><th>Tokens</th></tr>
|
|
52
|
+
</thead>
|
|
53
|
+
<tbody>
|
|
54
|
+
<tr>
|
|
55
|
+
<td><code>root</code></td><td><code><div></code></td>
|
|
56
|
+
<td>An <strong>unpainted</strong> positioning box: <code>position: sticky; bottom: 0</code>, <code>w-full</code> capped at <code>--ds-content-wide</code> (<code>max-w-content-wide</code>). No landmark role. Carries <code>data-fods-component="form-actions"</code> and, while floating, <code>data-floating</code>. On a viewport <code>max-height: 480px</code> it is <code>position: static</code>. Receives <code>className</code>, every other HTML attribute and the <code>ref</code>.</td>
|
|
57
|
+
<td>stacking one step below <code>--z-index-dropdown</code> (deviation, see States); floating footprint <code>--space-800</code>, <code>--space-600</code></td>
|
|
58
|
+
</tr>
|
|
59
|
+
<tr>
|
|
60
|
+
<td><code>edge-shadow</code></td><td><code><div aria-hidden></code></td>
|
|
61
|
+
<td>The edge band above the floating bar: absolutely positioned, full width, <code>pointer-events: none</code>, <code>display: none</code> unless the root carries <code>data-floating</code>. Its height is <code>--space-1000 + --radius-700</code> and its bottom edge sits <code>--radius-700</code> below the root's top, so the band runs on under the bar's top corners. A vertical gradient from <code>--bg-edge-shadow</code> at zero alpha to the full token at the bar.</td>
|
|
62
|
+
<td><code>--bg-edge-shadow</code>; <code>--space-1000</code>, <code>--radius-700</code></td>
|
|
63
|
+
</tr>
|
|
64
|
+
<tr>
|
|
65
|
+
<td><code>bar</code></td><td><code><div></code></td>
|
|
66
|
+
<td>The painted surface and the <code>actions</code> slot: the children, rendered as given. A sibling of the band after it in tree order, so it paints over the band's tucked end (a sticky root opens a stacking context, so the surface cannot be the root). A transparent <code>--border-width-100</code> border on all sides. A wrapping flex row — layout under Variants. With <code>stackOnOverflow</code>, carries <code>data-stacked</code> while its one-row content does not fit (Variants → Overflow).</td>
|
|
67
|
+
<td>fill <code>--bg-primary</code>; radius <code>--radius-700</code>; gap <code>--space-500</code>; padding → Sizes; floating → States</td>
|
|
68
|
+
</tr>
|
|
69
|
+
<tr>
|
|
70
|
+
<td><code>spacer</code></td><td><code><span aria-hidden="true"></code></td>
|
|
71
|
+
<td><code>FormActions.Spacer</code> — optional, at most one per bar. Empty, <code>flex: 1 1 0</code>: in one row it takes the free space, so the children before it sit at the start and the children after it at the end. <code>display: none</code> in two rows.</td>
|
|
72
|
+
<td>—</td>
|
|
73
|
+
</tr>
|
|
74
|
+
<tr>
|
|
75
|
+
<td><code>sentinel</code></td><td><code><div aria-hidden></code></td>
|
|
76
|
+
<td>Zero height, rendered directly after the root (outside it). The floating detection watches it. Decorative.</td>
|
|
77
|
+
<td>—</td>
|
|
78
|
+
</tr>
|
|
79
|
+
</tbody>
|
|
80
|
+
</table>
|
|
81
|
+
|
|
82
|
+
The actions themselves are not parts of the bar. They keep their own atoms' markers
|
|
83
|
+
(`data-fods-component="button"` and so on).
|
|
84
|
+
|
|
85
|
+
## Variants
|
|
86
|
+
|
|
87
|
+
No variant prop. The manifest's two axes are both resolved without one: **Breakpoint** is the viewport
|
|
88
|
+
(see Sizes) and **Layout** (One row · Two rows) follows from `stackBelow` and the viewport. XL and LG
|
|
89
|
+
are One row only, MD and SM both, Mobile Two rows only — 7 variants. The Matrix frames each one at its
|
|
90
|
+
real viewport width, with the recipe that uses that layout there; SM One row is the back-link recipe with
|
|
91
|
+
`stackBelow="sm"`.
|
|
92
|
+
|
|
93
|
+
<Canvas of={FormActionsStories.Matrix} />
|
|
94
|
+
|
|
95
|
+
<table>
|
|
96
|
+
<thead>
|
|
97
|
+
<tr><th>Layout</th><th>How the children sit</th><th>Classes on the bar</th></tr>
|
|
98
|
+
</thead>
|
|
99
|
+
<tbody>
|
|
100
|
+
<tr>
|
|
101
|
+
<td>One row</td>
|
|
102
|
+
<td>All children on one row, end-aligned; each action hugs its label. The spacer takes the free space, so the children before it sit at the start; without a spacer every action sits at the end.</td>
|
|
103
|
+
<td><code>flex flex-wrap items-center justify-end gap-500</code></td>
|
|
104
|
+
</tr>
|
|
105
|
+
<tr>
|
|
106
|
+
<td>Two rows</td>
|
|
107
|
+
<td>The last child (the primary) alone on the second row at full width. The spacer is hidden. Every other action on the first row, and the last action before the primary fills the remaining width — the spacer never counts, so in back, spacer, primary the back action fills.</td>
|
|
108
|
+
<td>below the <code>stackBelow</code> breakpoint (<code>max-lg:</code> / <code>max-md:</code> / <code>max-sm:</code>) and, above it, while the bar carries <code>data-stacked</code> (<code>stackOnOverflow</code> only) (<code>data-stacked:not-data-measuring:</code>): <code>[&>:last-child]:basis-full</code>, <code>[&>[data-fods-part=spacer]]:hidden</code>, <code>flex-1 min-w-0</code> on <code>:nth-last-child(2)</code> unless it is the spacer, else on <code>:nth-last-child(3)</code> when the spacer follows it</td>
|
|
109
|
+
</tr>
|
|
110
|
+
</tbody>
|
|
111
|
+
</table>
|
|
112
|
+
|
|
113
|
+
<table>
|
|
114
|
+
<thead>
|
|
115
|
+
<tr><th><code>stackBelow</code></th><th>Two rows at</th><th>Use when</th></tr>
|
|
116
|
+
</thead>
|
|
117
|
+
<tbody>
|
|
118
|
+
<tr><td><code>'lg'</code></td><td>MD, SM, Mobile</td><td>the one-row set does not fit at MD (the two-commits recipe)</td></tr>
|
|
119
|
+
<tr><td><code>'md'</code> (default)</td><td>SM, Mobile</td><td>the one-row set fits down to MD (the back-link recipe)</td></tr>
|
|
120
|
+
<tr><td><code>'sm'</code></td><td>Mobile</td><td>the one-row set fits down to SM</td></tr>
|
|
121
|
+
</tbody>
|
|
122
|
+
</table>
|
|
123
|
+
|
|
124
|
+
- **One DOM tree, never re-ordered.** The bar renders the children as given at every breakpoint and
|
|
125
|
+
uses no CSS `order`: DOM order = visual order = Tab order, the primary last.
|
|
126
|
+
- **The breakpoint is the floor, overflow stacks above it.** Below the `stackBelow` breakpoint the
|
|
127
|
+
switch is the viewport media query alone, nothing is measured; Mobile is two rows for every value.
|
|
128
|
+
From the breakpoint up the bar is one row; with `stackOnOverflow` it is two rows whenever the
|
|
129
|
+
children do not fit one row — see Overflow below.
|
|
130
|
+
|
|
131
|
+
### Overflow
|
|
132
|
+
|
|
133
|
+
<Canvas of={FormActionsStories.Overflow} />
|
|
134
|
+
|
|
135
|
+
**`stackOnOverflow`** (`chrome.layout.stack-on-overflow`, manifest 2.1.0; the re-measure triggers
|
|
136
|
+
named in 2.1.1). The page Breakpoint itself is never an overflow measurement — only the Layout axis
|
|
137
|
+
(rows) follows one, and only with this prop. With the breakpoint alone, a one-row set that does not fit the bar — a column narrower than the viewport, the
|
|
138
|
+
docs canvas, longer labels in another locale, a width just above the breakpoint — wraps the flex row
|
|
139
|
+
wherever the last item overflows, typically the primary alone at the end of a second row. With the
|
|
140
|
+
opt-in boolean `stackOnOverflow` the bar keeps `stackBelow` as the floor and, above it, lays out the same
|
|
141
|
+
Two rows when one row does not fit. It is off by default: the measurement keeps two observers on the bar
|
|
142
|
+
for its whole life, which a bar whose one row always fits (the back-link recipe: a back link and one button) does not
|
|
143
|
+
need. The two-commits stories turn it on, the back-link stories do not; the third bar of the Overflow story
|
|
144
|
+
shows long labels without it.
|
|
145
|
+
|
|
146
|
+
Mechanism (`internal/useOneRowOverflow.ts`; with `stackOnOverflow` off it attaches no observer, no
|
|
147
|
+
fonts listener and no media query subscription, and `data-stacked` is never set):
|
|
148
|
+
|
|
149
|
+
1. The bar gets `data-measuring` for one synchronous measurement: the one-row probe layout
|
|
150
|
+
(`flex-nowrap`, `justify-start`, every child `shrink-0`) with the `data-stacked` rules switched off.
|
|
151
|
+
One row does not fit when its last child ends past the bar's content box (not `scrollWidth`: Chrome
|
|
152
|
+
leaves the inline-end padding out of it, so a row running only into the padding read as fitting). The attribute is removed
|
|
153
|
+
in the same task, so the probe layout is never painted, and the answer does not depend on the layout
|
|
154
|
+
currently shown, so it cannot oscillate.
|
|
155
|
+
2. The result sets `data-stacked` on the bar, which applies the Two rows rules under
|
|
156
|
+
`data-stacked:not-data-measuring:` — the same six rules as under the breakpoint prefix.
|
|
157
|
+
3. It re-measures on a size change of the bar (`ResizeObserver` — a narrower column, a 200 % zoom),
|
|
158
|
+
on any change inside it — children, text, attributes of the actions such as a new label, a locale
|
|
159
|
+
switch or Loading (`MutationObserver`; the bar's own `data-measuring` and `data-stacked` are
|
|
160
|
+
ignored) — and once web fonts are ready (`document.fonts.ready`), never only at mount. Two rows
|
|
161
|
+
reached this way at XL and LG use the MD Two-rows geometry (no separate Figma variant).
|
|
162
|
+
4. Nothing is measured while the `stackBelow` media query matches. Without JavaScript, and on the
|
|
163
|
+
server, only the breakpoint switch applies.
|
|
164
|
+
|
|
165
|
+
### Recipes
|
|
166
|
+
|
|
167
|
+
The two recipes of the manifest (`chrome.recipes`) are compositions of the slot, not variants. Each
|
|
168
|
+
restyles **one element per action** with CSS — the stories build them that way.
|
|
169
|
+
|
|
170
|
+
<Canvas of={FormActionsStories.RecipeTwoCommits} />
|
|
171
|
+
|
|
172
|
+
**Preview and two commits** (`chrome.recipes.faktura`) — `stackBelow="lg"`, `stackOnOverflow`: preview · spacer · «Uložit návrh» · «Vystavit a odeslat»
|
|
173
|
+
(`value="send"`) · «Vystavit a stáhnout» (Brand, `value="download"`). Preview is the Secondary Button
|
|
174
|
+
with a transparent border from LG — the Tertiary look, since Button's Tertiary differs from Secondary by
|
|
175
|
+
that border alone — and reads «Náhled» at SM through a second `aria-hidden` span. At Mobile preview
|
|
176
|
+
and save take Icon Button lg geometry (width 44, no inline padding, no gap) with the label
|
|
177
|
+
visually hidden and the full label as `aria-label`; the secondary reads «Odeslat» through a second
|
|
178
|
+
`aria-hidden` span while its full label stays as visually hidden text.
|
|
179
|
+
|
|
180
|
+
<Canvas of={FormActionsStories.RecipeBackLink} />
|
|
181
|
+
|
|
182
|
+
**Back link and one commit** (`chrome.recipes.vydaj`) — `stackBelow="md"`: back link · spacer · «Uložit výdaj» (Brand, `value="save"`). The back
|
|
183
|
+
action is one `<a href>`: the Button Secondary lg recipe below MD (where the bar fills it across row 1),
|
|
184
|
+
the Text Link Strong md look, Underline=Off, from MD, with a centred `::before` hit zone of at least
|
|
185
|
+
`--space-1000 + 2 × --space-100` each way and a 3 px focus offset.
|
|
186
|
+
|
|
187
|
+
## Sizes
|
|
188
|
+
|
|
189
|
+
**There is no size axis.** Breakpoint is the size dimension and it is **not a prop**: padding follows
|
|
190
|
+
the viewport media queries (Mobile unprefixed, SM and up `sm:`), and the rows follow `stackBelow`. The
|
|
191
|
+
Breakpoint stories pin the viewport to each band minimum (1280 / 1024 / 768 / 640) and the 390 Mobile
|
|
192
|
+
canvas — see the Matrix above, or open e.g. `Breakpoint · Mobile` and use the toolbar viewports.
|
|
193
|
+
|
|
194
|
+
<table>
|
|
195
|
+
<thead>
|
|
196
|
+
<tr>
|
|
197
|
+
<th>Breakpoint</th>
|
|
198
|
+
<th>Viewport</th>
|
|
199
|
+
<th>Docked padding (block / inline)</th>
|
|
200
|
+
<th>Layout</th>
|
|
201
|
+
</tr>
|
|
202
|
+
</thead>
|
|
203
|
+
<tbody>
|
|
204
|
+
<tr><td>XL</td><td>≥ 1280</td><td><code>--space-800</code> / <code>--space-800</code></td><td>One row</td></tr>
|
|
205
|
+
<tr><td>LG</td><td>1024–1279</td><td><code>--space-800</code> / <code>--space-800</code></td><td>One row</td></tr>
|
|
206
|
+
<tr><td>MD</td><td>768–1023</td><td><code>--space-800</code> / <code>--space-800</code></td><td>One row · Two rows (<code>stackBelow="lg"</code>)</td></tr>
|
|
207
|
+
<tr><td>SM</td><td>640–767</td><td><code>--space-800</code> / <code>--space-800</code></td><td>One row (<code>stackBelow="sm"</code>) · Two rows</td></tr>
|
|
208
|
+
<tr><td>Mobile</td><td>below 640</td><td><code>--space-800</code> / <code>--space-600</code></td><td>Two rows</td></tr>
|
|
209
|
+
</tbody>
|
|
210
|
+
</table>
|
|
211
|
+
|
|
212
|
+
- Row gap and action gap are one step, `--space-500`, in both directions.
|
|
213
|
+
- Below MD the bar runs full-bleed and its inline padding stands in for the page side gutter. The
|
|
214
|
+
stories model the page (`--bg-secondary`, the gutter from MD) with a decorator; the gutter belongs to
|
|
215
|
+
the page, not the bar.
|
|
216
|
+
- The bar sets no height. The manifest's `chrome.measurements` give the resulting bar heights with
|
|
217
|
+
Size lg (44) actions — docked 92 (one row) / 148 (two rows), floating 76 / 132 — as outcomes of
|
|
218
|
+
padding, rows and gaps. The rendered bar is **2 px taller** than each of them because of the
|
|
219
|
+
transparent `--border-width-100` border on all sides that forced colors paint (Accessibility →
|
|
220
|
+
Contrast); the manifest's arithmetic leaves the border out. They are not measured on this page.
|
|
221
|
+
|
|
222
|
+
## States
|
|
223
|
+
|
|
224
|
+
FormActions has **no state axis** (manifest `intent.states`). Hover, focus, pressed, disabled and
|
|
225
|
+
loading are the composed actions' own, set by the form. The bar adds one behaviour: docked / floating.
|
|
226
|
+
|
|
227
|
+
### Pending (set by the form)
|
|
228
|
+
|
|
229
|
+
<Canvas of={FormActionsStories.Pending} />
|
|
230
|
+
|
|
231
|
+
While one commit runs, the form renders it as Button `loading` (spinner, `aria-busy`, clicks
|
|
232
|
+
suppressed) and sets `aria-disabled="true"` on the other commit until it clears; the stories' form also
|
|
233
|
+
ignores a submit whose submitter is `aria-disabled`. The bar has no prop for any of it. In the recipe
|
|
234
|
+
stories a click on a commit runs it for a moment.
|
|
235
|
+
|
|
236
|
+
### Docked / floating
|
|
237
|
+
|
|
238
|
+
<Canvas of={FormActionsStories.FloatingStatic} />
|
|
239
|
+
|
|
240
|
+
`Floating (static)` pins `data-floating` on the second bar of each pair so the floating look renders
|
|
241
|
+
without scrolling. The live behaviour is in the
|
|
242
|
+
[Floating demo](?path=/story/design-system-organisms-form-actions--floating-demo) story: four Form
|
|
243
|
+
Blocks, then the bar — scroll the canvas.
|
|
244
|
+
|
|
245
|
+
<table>
|
|
246
|
+
<thead>
|
|
247
|
+
<tr><th></th><th>Docked</th><th>Floating (<code>data-floating</code>)</th></tr>
|
|
248
|
+
</thead>
|
|
249
|
+
<tbody>
|
|
250
|
+
<tr><td>Corners</td><td><code>--radius-700</code> on all four</td><td>top <code>--radius-700</code>, bottom 0</td></tr>
|
|
251
|
+
<tr><td>Padding-block</td><td><code>--space-800</code></td><td><code>--space-600</code></td></tr>
|
|
252
|
+
<tr><td>Padding-inline, actions, layout</td><td>per Sizes</td><td>unchanged</td></tr>
|
|
253
|
+
<tr><td>Border (<code>--border-width-100</code>)</td><td>transparent</td><td><code>--outline-default</code></td></tr>
|
|
254
|
+
<tr><td>Edge band above the bar</td><td><code>display: none</code></td><td>shown</td></tr>
|
|
255
|
+
</tbody>
|
|
256
|
+
</table>
|
|
257
|
+
|
|
258
|
+
**Mechanism** (`useFloatingBar`):
|
|
259
|
+
|
|
260
|
+
1. An `IntersectionObserver` with `rootMargin` `0px 0px 16px 0px` watches the sentinel. The bar is
|
|
261
|
+
floating while the sentinel is outside the viewport and docked while it intersects; scrolling back
|
|
262
|
+
up floats it again.
|
|
263
|
+
2. **Deviation from `delivery.react`:** the contract says the 16 px `rootMargin` alone keeps the switch
|
|
264
|
+
from oscillating. It cannot. The bar is in flow, so when it floats and loses
|
|
265
|
+
2 × (`--space-800` − `--space-600`) of padding-block, the sentinel after it moves up by the same
|
|
266
|
+
amount, and for any rootMargin there is a scroll band where the docked layout says "float" and the
|
|
267
|
+
floating layout says "dock" — `data-floating` would flip every frame. While floating, the root
|
|
268
|
+
therefore carries a compensating `margin-bottom` of exactly that difference: the in-flow footprint
|
|
269
|
+
never changes and the sentinel never moves. Sticky `bottom: 0` places the border box, so the margin
|
|
270
|
+
does not lift the painted bar off the viewport bottom.
|
|
271
|
+
3. While floating, the page scroller (`document.documentElement`) gets `scroll-padding-bottom` equal to
|
|
272
|
+
the bar's current height, kept in sync by a `ResizeObserver`. Several bars share one registry: the
|
|
273
|
+
tallest floating bar wins, and the previous inline value is restored only when the last of them
|
|
274
|
+
docks or unmounts.
|
|
275
|
+
4. On a viewport `max-height: 480px` no observer is attached, `data-floating` is never set and the root
|
|
276
|
+
is `position: static`.
|
|
277
|
+
|
|
278
|
+
The switch between docked and floating has no transition of its own — and that is the contract, not an omission:
|
|
279
|
+
manifest 2.1.2 `motion.none` makes it „instant by design — border, corners, padding-block and the Edge shadow swap with
|
|
280
|
+
no transition, so the bar never moves under the pointer". The actions carry their own motion (`inherits: [button,
|
|
281
|
+
icon-button, text-link]` — hover over `--duration-hover`, press over `--duration-press`).
|
|
282
|
+
|
|
283
|
+
**Stacking.** The root sits one step below `--z-index-dropdown`, not at `--z-index-sticky` (which is
|
|
284
|
+
above it): a Select, Combobox or Date Picker panel opened from a field near the viewport bottom must
|
|
285
|
+
paint over the floating bar, not under it.
|
|
286
|
+
|
|
287
|
+
**Known limitation — the sentinel is a sibling.** The zero-height sentinel renders after the root, not
|
|
288
|
+
inside it. In a flex or grid parent with a `gap` (or under `space-y-*`) it is an item of its own: it
|
|
289
|
+
adds one extra gap below the bar, and it sits that gap further from the bar than the switch assumes.
|
|
290
|
+
For the last gap's worth of scroll before the bar docks, the bar is already back in its in-flow place
|
|
291
|
+
— up to one gap above the viewport bottom — but still wears the floating look (square bottom corners,
|
|
292
|
+
border, edge band). The Floating demo shows it: its form is a flex column with `gap-800`. Render the bar
|
|
293
|
+
as the last child of a parent without a gap to avoid it.
|
|
294
|
+
|
|
295
|
+
## API
|
|
296
|
+
|
|
297
|
+
<Controls of={FormActionsStories.Playground} />
|
|
298
|
+
|
|
299
|
+
The Controls table drives the Playground; `content` is a story-only arg that picks the slot content
|
|
300
|
+
(a neutral sample, one of the recipes, or the sample with long labels).
|
|
301
|
+
|
|
302
|
+
- **`children`** (`ReactNode`, required) — the form's action elements in reading order, the Brand
|
|
303
|
+
primary last, optionally one `<FormActions.Spacer />`. Rendered as given, never re-ordered.
|
|
304
|
+
- **`stackBelow`** (`'lg' | 'md' | 'sm'`, default `'md'`) — two rows below this breakpoint, one row
|
|
305
|
+
from it up. Type `FormActionsStackBelow`.
|
|
306
|
+
- **`stackOnOverflow`** (`boolean`, default `false`) — two rows also above `stackBelow` when the one
|
|
307
|
+
row does not fit the bar (`data-stacked`; Variants → Overflow). Turn it on for bars with many or
|
|
308
|
+
long-labelled actions.
|
|
309
|
+
- Every other `<div>` attribute (including `className`) goes to the root; `ref` points to the root
|
|
310
|
+
(`forwardRef`). `data-floating` (root) and `data-stacked` (bar) are owned by the component.
|
|
311
|
+
- **`FormActions.Spacer`** — no props; an empty `aria-hidden` `<span>` with `flex: 1 1 0`. At most one
|
|
312
|
+
per bar.
|
|
313
|
+
|
|
314
|
+
Also exported: `formActionsVariants` (the `tv` recipe) and the types `FormActionsProps`,
|
|
315
|
+
`FormActionsStackBelow`.
|
|
316
|
+
|
|
317
|
+
**What the form sets on the children** (the bar has no props for any of it):
|
|
318
|
+
|
|
319
|
+
- **Element types.** Commit actions are `type="submit"` with `name="intent"` and a value the page reads
|
|
320
|
+
from `SubmitEvent.submitter` (`send` · `download` in the two-commits recipe, `save` in the back-link recipe); preview and save are
|
|
321
|
+
`type="button"`; back is an `<a href>`.
|
|
322
|
+
- **Commit lock.** The running commit is Button `loading`; the other commits carry `aria-disabled`
|
|
323
|
+
until it clears.
|
|
324
|
+
- **Per-breakpoint restyling.** One element per action: Icon Button geometry with the full label as
|
|
325
|
+
`aria-label`, a short label in a second `aria-hidden` span, Text Link ↔ Button — never a different
|
|
326
|
+
element per breakpoint.
|
|
327
|
+
- **No implicit submission.** The form cancels it, so Enter in a text field never commits. The stories'
|
|
328
|
+
form calls `useNoImplicitSubmit` (`internal/useNoImplicitSubmit.ts`) with a
|
|
329
|
+
ref to the `<form>`: it listens for `keydown` on the form's document (bubble phase, filtered to
|
|
330
|
+
targets inside that form) and cancels the default of Enter on a text-like `<input>` — `text`,
|
|
331
|
+
`search`, `url`, `tel`, `email`, `password`, `number`. Every other input type, textareas, buttons,
|
|
332
|
+
IME composition and an Enter a field has already prevented are left alone.
|
|
333
|
+
|
|
334
|
+
## Do / Don't
|
|
335
|
+
|
|
336
|
+
- ✅ Render the bar once, in flow after the last Form Block, inside the page `<form>`.
|
|
337
|
+
- ✅ Pass the actions as children in reading order, the Brand primary last.
|
|
338
|
+
- ✅ Keep exactly one Brand primary.
|
|
339
|
+
- ✅ Name the row switch with `stackBelow`.
|
|
340
|
+
- ✅ Turn on `stackOnOverflow` for a bar whose actions may not fit one row above `stackBelow` — many actions, long labels, other locales, a narrow column.
|
|
341
|
+
- ✅ Use at most one `<FormActions.Spacer />`, between the quiet actions and the commit cluster.
|
|
342
|
+
- ✅ Restyle one element per action across breakpoints; an icon-only action keeps the full label as `aria-label`.
|
|
343
|
+
- ✅ Lock the other commits with `aria-disabled` while one runs.
|
|
344
|
+
- ✅ Let the page own the gap above the bar.
|
|
345
|
+
- ❌ Don't render a fixed bar plus a static copy at the end of the form.
|
|
346
|
+
- ❌ Don't re-order children with CSS so Tab order and visual order part.
|
|
347
|
+
- ❌ Don't add a second Brand or filled button, or put the primary anywhere but last.
|
|
348
|
+
- ❌ Don't add a Breakpoint prop.
|
|
349
|
+
- ❌ Don't turn on `stackOnOverflow` for a bar whose one row always fits — it keeps two observers running for nothing.
|
|
350
|
+
- ❌ Don't add a second spacer or a third row.
|
|
351
|
+
- ❌ Don't render a different element per breakpoint, fold actions into a «…» menu, or use `title` as the accessible name.
|
|
352
|
+
- ❌ Don't add a top margin, a cast shadow or `overflow: hidden` to the bar.
|
|
353
|
+
|
|
354
|
+
## Accessibility
|
|
355
|
+
|
|
356
|
+
- **Semantics** — the root is a `<div>` with no landmark role and no `aria-label`; the bar adds no role
|
|
357
|
+
around the children, so the actions are read as ordinary controls of the form. The edge band, the
|
|
358
|
+
spacer and the sentinel are `aria-hidden`. The actions' semantics are the form's: in the recipes,
|
|
359
|
+
commits are native `<button type="submit">`, preview and save `<button type="button">`, the back
|
|
360
|
+
action an `<a href>` at every breakpoint.
|
|
361
|
+
- **Keyboard** — DOM order = visual order = Tab order in both layouts: the bar never re-orders its
|
|
362
|
+
children, so the primary, as the last child, is reached last. Docked and floating do not change the
|
|
363
|
+
order. Enter in a text field does not commit once the form cancels implicit submission (see API).
|
|
364
|
+
- **ARIA / names** — set by the form. In the two-commits recipe preview and save carry `aria-label` with the
|
|
365
|
+
full label («Náhled dokladu», «Uložit návrh») at every breakpoint, so at Mobile the icon-only button
|
|
366
|
+
is named by it and at SM the name contains the visible short «Náhled». The secondary has no
|
|
367
|
+
`aria-label`: its full label stays as visually hidden text at Mobile while the visible «Odeslat» is
|
|
368
|
+
`aria-hidden`. Loading is `aria-busy`; the locked commit carries `aria-disabled="true"`.
|
|
369
|
+
- **Focus** — the actions draw their own `:focus-visible` rings. The bar does not clip, so rings paint in
|
|
370
|
+
full. While floating, the page scroller's `scroll-padding-bottom` reserves the bar's height so a
|
|
371
|
+
focused field is not scrolled in under it.
|
|
372
|
+
- **Target** — the recipes use Button size `lg` (min height 44; the Mobile icon-only ones also width 44);
|
|
373
|
+
the back link from MD gets a centred hit zone of at least `--space-1000 + 2 × --space-100` each
|
|
374
|
+
way.
|
|
375
|
+
- **Contrast & motion** — the bar has no visible border while docked; it is separated by surface
|
|
376
|
+
(`--bg-primary` on `--bg-secondary`). Under forced colors the surface change vanishes, so the bar
|
|
377
|
+
carries a transparent `--border-width-100` border that forced colors paint. The bar adds no motion of
|
|
378
|
+
its own (manifest `motion.none`; the docked ↔ floating switch is instant by design, see States).
|
|
379
|
+
|
|
380
|
+
Accessibility floor for every FODS component: `spec/01-foundations/accessibility.md`.
|
|
381
|
+
|
|
382
|
+
## Copy
|
|
383
|
+
|
|
384
|
+
Voice: action wording follows the [Button](?path=/docs/design-system-atoms-button--docs) copy rules
|
|
385
|
+
— verb-first infinitive, sentence case, consistent terminology; a back link follows the
|
|
386
|
+
[TextLink](?path=/docs/design-system-atoms-textlink--docs) copy rules. The bar sets no text of its own:
|
|
387
|
+
every label is set by the form on its child actions. Examples are Czech; the rules hold for every
|
|
388
|
+
language.
|
|
389
|
+
|
|
390
|
+
- **Action label** (`action-label`) — the visible label of a Button in the bar, passed as the action's
|
|
391
|
+
children. One line; it truncates only if a localized label outgrows a full-width Button. Max 24
|
|
392
|
+
characters — guidance, not an enforced limit, because label length varies by language. The form
|
|
393
|
+
picks labels that fit its layout at each breakpoint; a label shortens only where the recipe says
|
|
394
|
+
so, and the short form keeps the verb.
|
|
395
|
+
- **Accessible name** (`accessible-name`) — not rendered: the `aria-label` of an action shown as an
|
|
396
|
+
Icon Button at a narrow breakpoint. It is the full label the action shows at the wider breakpoints,
|
|
397
|
+
never a shortened form: ✅ `aria-label="Náhled dokladu"` ❌ `aria-label="Náhled"`.
|
|
398
|
+
- **Back link** — a destination, verb-first («Zpět na …»), sentence case, no terminal period:
|
|
399
|
+
✅ «Zpět na seznam výdajů» ❌ «Zpět» · «Klikněte zde».
|
|
400
|
+
|
|
401
|
+
The recipes' labels:
|
|
402
|
+
|
|
403
|
+
<table>
|
|
404
|
+
<thead>
|
|
405
|
+
<tr><th>Recipe</th><th>Action</th><th>Label</th><th>Icon</th></tr>
|
|
406
|
+
</thead>
|
|
407
|
+
<tbody>
|
|
408
|
+
<tr><td>Two commits</td><td>preview</td><td>«Náhled dokladu» («Náhled» at SM)</td><td><code>eye</code></td></tr>
|
|
409
|
+
<tr><td>Two commits</td><td>save</td><td>«Uložit návrh»</td><td><code>floppy-disk</code></td></tr>
|
|
410
|
+
<tr><td>Two commits</td><td>secondary</td><td>«Vystavit a odeslat» («Odeslat» at Mobile)</td><td><code>paper-plane-tilt</code></td></tr>
|
|
411
|
+
<tr><td>Two commits</td><td>primary</td><td>«Vystavit a stáhnout»</td><td><code>download-simple</code></td></tr>
|
|
412
|
+
<tr><td>Back link</td><td>back</td><td>«Zpět na seznam výdajů»</td><td><code>arrow-left</code></td></tr>
|
|
413
|
+
<tr><td>Back link</td><td>primary</td><td>«Uložit výdaj»</td><td><code>floppy-disk</code></td></tr>
|
|
414
|
+
</tbody>
|
|
415
|
+
</table>
|
|
416
|
+
|
|
417
|
+
- **The two invoice commits are a deliberate exception** to the Button rule of one action per button.
|
|
418
|
+
«Vystavit a odeslat» and «Vystavit a stáhnout» are each a single commit of the invoice, and the
|
|
419
|
+
second verb names its delivery: sent by e-mail or downloaded. Keep both labels as written:
|
|
420
|
+
✅ «Vystavit a odeslat» ❌ «Odeslat» at XL.
|
|
421
|
+
- **Two abbreviations only.** «Náhled» at SM and «Odeslat» at Mobile, both in the two-commits recipe,
|
|
422
|
+
are the only per-breakpoint label changes; no other recipe label shortens at any breakpoint:
|
|
423
|
+
✅ «Odeslat» at Mobile ❌ «Uložit» for «Uložit návrh» at SM.
|
|
424
|
+
|
|
425
|
+
## Usage
|
|
426
|
+
|
|
427
|
+
```tsx
|
|
428
|
+
import { Button, FormActions, Icon } from '@invoiceonline/ui-react';
|
|
429
|
+
|
|
430
|
+
// The two-commits recipe — stackBelow="lg"
|
|
431
|
+
<form ref={formRef} onSubmit={handleSubmit}>
|
|
432
|
+
…
|
|
433
|
+
<FormActions stackBelow="lg" stackOnOverflow>
|
|
434
|
+
<Button type="button" variant="secondary" size="lg" leadingIcon={<Icon name="eye" />} aria-label="Náhled dokladu" onClick={openPreview}>
|
|
435
|
+
Náhled dokladu
|
|
436
|
+
</Button>
|
|
437
|
+
<FormActions.Spacer />
|
|
438
|
+
<Button type="button" variant="secondary" size="lg" leadingIcon={<Icon name="floppy-disk" />} aria-label="Uložit návrh" onClick={saveDraft}>
|
|
439
|
+
Uložit návrh
|
|
440
|
+
</Button>
|
|
441
|
+
<Button type="submit" name="intent" value="send" variant="secondary" size="lg" loading={pending === 'send'} aria-disabled={pending === 'download' || undefined}>
|
|
442
|
+
Vystavit a odeslat
|
|
443
|
+
</Button>
|
|
444
|
+
<Button type="submit" name="intent" value="download" variant="brand" size="lg" loading={pending === 'download'} aria-disabled={pending === 'send' || undefined}>
|
|
445
|
+
Vystavit a stáhnout
|
|
446
|
+
</Button>
|
|
447
|
+
</FormActions>
|
|
448
|
+
</form>
|
|
449
|
+
|
|
450
|
+
// The back-link recipe — stackBelow defaults to "md"
|
|
451
|
+
<FormActions>
|
|
452
|
+
<a href="#">Zpět na seznam výdajů</a>
|
|
453
|
+
<FormActions.Spacer />
|
|
454
|
+
<Button type="submit" name="intent" value="save" variant="brand" size="lg">Uložit výdaj</Button>
|
|
455
|
+
</FormActions>
|
|
456
|
+
```
|
|
457
|
+
|
|
458
|
+
The per-breakpoint restyling of the recipes (icon-only at Mobile, the short labels, the back link's
|
|
459
|
+
Text Link ↔ Button classes) is in `FormActions.stories.tsx` (`TwoCommitsActions`, `BackLinkActions`).
|
|
460
|
+
|
|
461
|
+
Don't:
|
|
462
|
+
|
|
463
|
+
```tsx
|
|
464
|
+
// Outside the page form: the commits submit nothing.
|
|
465
|
+
<form>…</form>
|
|
466
|
+
<FormActions>…</FormActions>
|
|
467
|
+
|
|
468
|
+
// A different element per breakpoint instead of one element restyled.
|
|
469
|
+
<FormActions>
|
|
470
|
+
{isMobile ? <IconButton aria-label="Náhled dokladu" … /> : <Button …>Náhled dokladu</Button>}
|
|
471
|
+
…
|
|
472
|
+
</FormActions>
|
|
473
|
+
```
|
|
474
|
+
|
|
475
|
+
## Related
|
|
476
|
+
|
|
477
|
+
- [Button](?path=/docs/design-system-atoms-button--docs) — every Button action in the recipes; the
|
|
478
|
+
back link is built on its recipe.
|
|
479
|
+
- [IconButton](?path=/docs/design-system-atoms-iconbutton--docs) — the manifest's Mobile preview /
|
|
480
|
+
save; the recipe reproduces it as Button geometry so it stays one `<button>`.
|
|
481
|
+
- [TextLink](?path=/docs/design-system-atoms-textlink--docs) — the back link's look from MD.
|
|
482
|
+
- [FormBlock](?path=/docs/design-system-organisms-form-block--docs) — the tiles above the bar; same
|
|
483
|
+
surface and corner radius.
|
|
484
|
+
- [FormSection](?path=/docs/design-system-organisms-form-section--docs) — the groups of fields inside
|
|
485
|
+
the blocks.
|
|
486
|
+
- Spec: `spec/05-organisms/form-actions.md`
|
|
487
|
+
(patterns: `form-layout.md` § Form Actions placement, `scrollbar.md` § The edge band, `focus-ring.md`).
|
|
488
|
+
|
|
489
|
+
## Migration notes
|
|
490
|
+
|
|
491
|
+
**Motion (manifest 2.1.2, 2026-11-03) — documentation only.** The motion audit declares the bar static and the docked ↔
|
|
492
|
+
floating switch instant by design, which is what the bar already did. No code change.
|
|
493
|
+
|
|
494
|
+
From the upstream spec's Migration notes: Form Actions 2.0.0 replaces the fixed per-Document action
|
|
495
|
+
sets of 1.x with one slot the form fills.
|
|
496
|
+
|
|
497
|
+
<table>
|
|
498
|
+
<thead>
|
|
499
|
+
<tr><th></th><th>1.x</th><th>2.0.0</th></tr>
|
|
500
|
+
</thead>
|
|
501
|
+
<tbody>
|
|
502
|
+
<tr><td>Figma axes</td><td>Breakpoint × Document (Faktura · Výdaj), 10 variants</td><td>Breakpoint × Layout (One row · Two rows), 7 variants</td></tr>
|
|
503
|
+
<tr><td>Figma content</td><td>regions <code>quiet</code> and <code>submit</code> with fixed action slots</td><td>one slot <code>Actions</code>; the action sets are default content supplied by the manifest recipes (<code>chrome.recipes</code>)</td></tr>
|
|
504
|
+
<tr><td>Choosing the action set</td><td><code>document</code> prop (<code>'faktura'</code> · <code>'vydaj'</code>)</td><td><code>children</code>, plus <code>stackBelow</code> for the row switch and <code><FormActions.Spacer /></code> for the one-row split</td></tr>
|
|
505
|
+
<tr><td>Handlers</td><td><code>onPreview</code>, <code>onSaveDraft</code>, <code>onSend</code>, <code>onDownload</code>, <code>onSave</code></td><td>set on the child elements by the form</td></tr>
|
|
506
|
+
<tr><td>Back link</td><td><code>backHref</code></td><td>an <code><a href></code> child set by the form</td></tr>
|
|
507
|
+
<tr><td>Loading and disabled</td><td><code>pendingAction</code>, <code>disabledActions</code></td><td>set on the child elements by the form</td></tr>
|
|
508
|
+
<tr><td>Labels and icons</td><td>fixed by the bar per Document</td><td>set by the form; the sample labels live in the recipes</td></tr>
|
|
509
|
+
</tbody>
|
|
510
|
+
</table>
|
|
511
|
+
|
|
512
|
+
The 1.x component also read its eight labels from its own translation keys with a `labels`
|
|
513
|
+
override; 2.0.0 drops both, the label-key map and the per-Document prop, action-key and label types.
|
|
514
|
+
The bar also no longer cancels implicit submission itself — the form does (see API).
|
|
515
|
+
|
|
516
|
+
**2.1.0 / 2.1.1:** the opt-in `stackOnOverflow` prop (Variants → Overflow) — Two rows also above the
|
|
517
|
+
`stackBelow` breakpoint when one row does not fit — is part of the spec (`chrome.layout.stack-on-overflow`,
|
|
518
|
+
on in the `faktura` recipe, off in `vydaj`).
|