@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,802 @@
|
|
|
1
|
+
import { Meta, Canvas, Controls } from '@storybook/addon-docs/blocks';
|
|
2
|
+
import * as ProgressBarStories from './ProgressBar.stories';
|
|
3
|
+
|
|
4
|
+
|
|
5
|
+
<Meta of={ProgressBarStories} tags={['autodocs']} />
|
|
6
|
+
|
|
7
|
+
# ProgressBar
|
|
8
|
+
|
|
9
|
+
## Metadata
|
|
10
|
+
|
|
11
|
+
- **Layer:** molecule
|
|
12
|
+
- **Status:** draft
|
|
13
|
+
- **Manifest version:** `1.12.1`
|
|
14
|
+
- **Step manifest:** `_progress-bar-item` version `3.4.1` — the private per-step contract (marker, halo, text runs, and the Done button's surface); no doc page of its own, everything a dev needs lives here
|
|
15
|
+
- **Tokens used:** `--bg-active`, `--bg-hover`, `--bg-primary`, `--border-width-200`, `--font-body`, `--font-decorative`, `--font-size-base`, `--font-size-lg`, `--font-size-sm`, `--font-size-xs`, `--font-weight-semibold`, `--leading-compact`, `--leading-loose`, `--leading-relaxed`, `--outline-default`, `--outline-focus`, `--outline-strong`, `--primary`, `--radius-200`, `--radius-300`, `--radius-full`, `--secondary-solid`, `--size-icon`, `--space-100`, `--space-1000`, `--space-1200`, `--space-200`, `--space-400`, `--space-450`, `--space-500`, `--space-600`, `--space-800`, `--status-success-solid`, `--text-placeholder`, `--text-primary`, `--text-secondary`, `--text-wrap-body`
|
|
16
|
+
|
|
17
|
+
The manifests are `spec/04-molecules/progress-bar.manifest.json` and
|
|
18
|
+
`spec/03-atoms/_progress-bar-item.manifest.json` (versions above); a bump of either one
|
|
19
|
+
re-opens the component per Definition of Done (e) (`COMPONENT-CODE-CONVENTIONS.md` §6).
|
|
20
|
+
|
|
21
|
+
## Overview
|
|
22
|
+
|
|
23
|
+
ProgressBar is a **multi-step progress indicator**: one continuous rail behind a row (or column)
|
|
24
|
+
of self-describing step markers, filled up to the Current step. Progress is expressed entirely by
|
|
25
|
+
the children — everything before `currentStep` is Done, `currentStep` is Current, everything after
|
|
26
|
+
is Upcoming, and the fill's length follows from that invariant.
|
|
27
|
+
|
|
28
|
+
**Use it** for a fixed, ordered sequence whose position must be visible at a glance: a product
|
|
29
|
+
wizard's step band (Small) or a marketing rollout / timeline narrative (Large).
|
|
30
|
+
|
|
31
|
+
**Do not use it** for paging a result set (that is `Pagination`), for a percentage or an
|
|
32
|
+
indeterminate load (the component has no such mode — there is no `value` prop, only `currentStep`),
|
|
33
|
+
or for a set of independent actions with no fixed order (that is `ButtonGroup`).
|
|
34
|
+
|
|
35
|
+
## Rationale
|
|
36
|
+
|
|
37
|
+
**One rail, owned by the bar.** The rail and the fill are two absolutely positioned elements
|
|
38
|
+
rendered *before* the step list; a step draws no connecting line of its own. That is the whole
|
|
39
|
+
reason the v1 shape — `StepperItem` with a connector half on each item — is retired: a single
|
|
40
|
+
element can slide forward, N joined half-segments cannot, and they break at every seam. The
|
|
41
|
+
manifest states it as `intent.rules[0]`, and the item manifest repeats it from the other side
|
|
42
|
+
("The item draws NO connecting line").
|
|
43
|
+
|
|
44
|
+
**The state is derived, never passed.** There is no `state` prop and no marker-content choice: the
|
|
45
|
+
index compared against `currentStep` picks Done / Current / Upcoming, and the marker construction
|
|
46
|
+
follows that state 1:1. A degree of freedom that was never real (a Done step is never anything but
|
|
47
|
+
a checkmark) is simply gone.
|
|
48
|
+
|
|
49
|
+
**The halo travels with the step.** The page-coloured disc under each marker belongs to the step,
|
|
50
|
+
not to the rail, so any composition that puts a rail behind these markers gets the track-to-marker
|
|
51
|
+
air for free instead of hand-placing ellipses (upstream had already drifted that geometry twice).
|
|
52
|
+
|
|
53
|
+
**Row ↔ Stack is the bar's own content-fit fallback.** Not a breakpoint, and not something the
|
|
54
|
+
consumer wires — it passes the preferred layout, see [Layout](#layout-row--stack).
|
|
55
|
+
|
|
56
|
+
## Anatomy
|
|
57
|
+
|
|
58
|
+
The rendered tree, with the `data-fods-part` markers the FODS probe grades against:
|
|
59
|
+
|
|
60
|
+
- **Root** (`<div>`, `data-fods-part="root"`) — `relative isolate grid`. It binds no colour of its
|
|
61
|
+
own; what it owns is the grid the rail geometry is measured against. Row sets
|
|
62
|
+
`grid-template-columns: repeat(N, minmax(0, 1fr))`, Stack sets `grid-template-rows: repeat(N, auto)`
|
|
63
|
+
plus a `--space-200` row gutter — both inline from `steps.length`, because the count is content and
|
|
64
|
+
no recipe variant could carry it. Your `className`, `style` and the forwarded `ref` land here.
|
|
65
|
+
- **Track** (`<div aria-hidden="true">`, `data-fods-part="track"`) — the neutral rail,
|
|
66
|
+
`--outline-default`, `--radius-200`, 4px thick (`h-200` in Row, `w-200` in Stack). It sits
|
|
67
|
+
**outside** the list, as the `<ol>`'s sibling inside the root, so the list holds the steps and
|
|
68
|
+
nothing else. It is a grid child of the root and takes its geometry from the same tracks the steps
|
|
69
|
+
sit in. `aria-hidden` keeps it out of what a reader hears. It renders only when there are more than
|
|
70
|
+
one step.
|
|
71
|
+
- **Track fill** (`<span>`, `data-fods-part="track-fill"`) — the progressed run, same geometry as the
|
|
72
|
+
rail, accent-coloured: `--secondary-solid` (Blue) / `--primary` (Orange). Its length is the inline
|
|
73
|
+
percentage `(currentStep / (stepCount − 1)) * 100%` — the manifest's own formula, chosen so it needs
|
|
74
|
+
no measurement and survives a container resize.
|
|
75
|
+
- **List** (`<ol role="list">`) — the steps and nothing else. It spans the root's grid and adopts its
|
|
76
|
+
tracks through `subgrid` (`display: contents` would leave the Row → Stack fallback no box to
|
|
77
|
+
measure). `role="list"` next to `<ol>` is not redundant: Tailwind preflight sets
|
|
78
|
+
`list-style: none`, which drops the list role in Safari.
|
|
79
|
+
- **Step** (`<li>`, `data-fods-part="step"`, `data-fods-state="done" | "current" | "upcoming"`) — one
|
|
80
|
+
per entry in `steps`. It carries no ink; what it carries is the state attribute every descendant
|
|
81
|
+
part narrows on, and `aria-current="step"` when it is the Current one.
|
|
82
|
+
- **Marker box** — the layout anchor, 26 / 24 (`sizes[].box`) — the marker's own Ø, not including
|
|
83
|
+
the halo, which overhangs it by 2 on every side (Ø 30 / 28). Half of this box is the offset that
|
|
84
|
+
puts the rail on the marker's centre line.
|
|
85
|
+
- **Halo** (`data-fods-part="halo"`, `aria-hidden`) — the page-coloured disc (`--bg-primary`) under the
|
|
86
|
+
marker, `--radius-full`, absolutely centred on the box. It is the air between the rail and the
|
|
87
|
+
marker edge. Constant across every state and accent.
|
|
88
|
+
- **Marker** (`data-fods-part="marker"`, `aria-hidden`) — the ring / glyph, `--radius-full`.
|
|
89
|
+
`relative` is load-bearing: the halo is an absolutely positioned *sibling*, and a positioned element
|
|
90
|
+
paints above non-positioned in-flow content whatever the DOM order, so the marker has to be
|
|
91
|
+
positioned too to land on top of its own halo.
|
|
92
|
+
- **Marker contents** — one of three, by state: an inline `check-circle` path filled with
|
|
93
|
+
`--status-success-solid` (Done), a centre **dot** (`data-fods-part="dot"`, accent fill) inside the
|
|
94
|
+
ring (Current), or the ordinal **number** (`data-fods-part="number"`, `--text-placeholder`) (Upcoming, unless
|
|
95
|
+
`showNumbers` is off — then the ring stays empty at the same size).
|
|
96
|
+
The Done path stays inline for geometry, not availability: the icon set does ship this drawing
|
|
97
|
+
(`<Icon name="check-circle" />`), but `size-full` ties the glyph to the
|
|
98
|
+
ring's diameter by construction, where an `<Icon>` glyph is sized as a `--size-icon*` slot box and
|
|
99
|
+
the drawing fills only part of it, so matching the ring would repeat the 24 / 22 numbers the recipe
|
|
100
|
+
already owns.
|
|
101
|
+
- **Text column** — **Title** (`data-fods-part="title"`, `--font-body` Semibold, `--text-primary` on
|
|
102
|
+
Done and Current, `--text-secondary` on Upcoming, wraps via `--text-wrap-body`) and **Detail**
|
|
103
|
+
(`data-fods-part="detail"`, constant `--text-secondary`, clamped at two lines). Row puts the column
|
|
104
|
+
under the marker and centres it, Stack puts it beside the marker.
|
|
105
|
+
- **Pointer callout** (`data-fods-part="pointer-label"`) — Row × Current only, see
|
|
106
|
+
[Pointer callout](#pointer-callout).
|
|
107
|
+
|
|
108
|
+
### Paint order comes out of the DOM, with one scoped `z-index`
|
|
109
|
+
|
|
110
|
+
rail → fill → halo → marker: the track pair renders **before** the step list, so each step paints
|
|
111
|
+
over it; inside a step the halo is absolutely positioned and the marker is `relative`, so the
|
|
112
|
+
marker paints over its own halo. Break that order and the geometry reads wrong. The only `z-index`
|
|
113
|
+
in the bar is the Done wash's: its `::before` layer is `-z-10` inside the root's `isolate` context,
|
|
114
|
+
which puts it under the rail — exactly where the button's own background used to paint — without
|
|
115
|
+
leaking out of the bar.
|
|
116
|
+
|
|
117
|
+
### Rail geometry, without measuring anything
|
|
118
|
+
|
|
119
|
+
The manifest is explicit (`motion.states.value.note`, verbatim): *"Measure the rail's ends from the real
|
|
120
|
+
marker centres, not from a halo-derived inset: a titled step is as wide as its text, so a halo-based
|
|
121
|
+
inset leaves the rail sticking out past the first marker."* Both layouts get that from CSS grid — the
|
|
122
|
+
track geometry itself needs no JS and no `ResizeObserver` (the only measurement the component does
|
|
123
|
+
is the Row ↔ Stack content-fit fallback since 1.9.0, which uses a `ResizeObserver` on the parent and
|
|
124
|
+
never touches the rail):
|
|
125
|
+
|
|
126
|
+
<table>
|
|
127
|
+
<thead>
|
|
128
|
+
<tr><th>Layout</th><th>Grid placement</th><th>Ends</th></tr>
|
|
129
|
+
</thead>
|
|
130
|
+
<tbody>
|
|
131
|
+
<tr>
|
|
132
|
+
<td><code>row</code></td>
|
|
133
|
+
<td>absolutely positioned child of grid area <code>1 / -1</code> in row 1</td>
|
|
134
|
+
<td><code>left</code> = <code>right</code> = <code>50 / N %</code> — with N equal columns each marker is centred in its own column, so the first and last centres sit exactly half a column in from each edge. The grid <em>area</em> is the containing block for an abspos grid child, which is what makes the percentage resolve against the steps' box rather than against the root's border edge (and keeps the rail below the pointer's top reserve).</td>
|
|
135
|
+
</tr>
|
|
136
|
+
<tr>
|
|
137
|
+
<td><code>stack</code></td>
|
|
138
|
+
<td>grid area <code>1 / N</code> in column 1</td>
|
|
139
|
+
<td><code>top</code> = half a marker box walks the head onto the first marker's centre; a negative <code>bottom</code> of <code>calc(--space-200 + box/2)</code> walks the tail onto the last one's. The gap term is <strong>not</strong> a typo: a grid area ending on line N reaches the end of track N−1, and the last track starts one gutter further down — without it the rail stops <code>--space-200</code> short of the last marker at every step count. Keeping it as a <code>calc()</code> on the token means the rail follows a retune of the row gap instead of silently drifting.</td>
|
|
140
|
+
</tr>
|
|
141
|
+
</tbody>
|
|
142
|
+
</table>
|
|
143
|
+
|
|
144
|
+
What is halved is the marker **box**, never the halo: the halo is centred on the box and only
|
|
145
|
+
describes how much air the rail loses at each marker, never where the centre is.
|
|
146
|
+
|
|
147
|
+
## Variants
|
|
148
|
+
|
|
149
|
+
<Canvas of={ProgressBarStories.Matrix} />
|
|
150
|
+
|
|
151
|
+
Three axes, 8 built variants — **Size** (Large · Small) × **Layout** (Row · Stack) × **Accent**
|
|
152
|
+
(Blue · Orange). Size and Layout get their own sections below; the Accent axis is the only one that
|
|
153
|
+
carries colour:
|
|
154
|
+
|
|
155
|
+
<table>
|
|
156
|
+
<thead>
|
|
157
|
+
<tr><th>Accent</th><th>When</th><th>Tokens</th></tr>
|
|
158
|
+
</thead>
|
|
159
|
+
<tbody>
|
|
160
|
+
<tr>
|
|
161
|
+
<td><code>blue</code> (default)</td>
|
|
162
|
+
<td>Everywhere in product, wizards included.</td>
|
|
163
|
+
<td>fill <code>--secondary-solid</code>; Current ring <code>--secondary-solid</code>; Current dot <code>--secondary-solid</code></td>
|
|
164
|
+
</tr>
|
|
165
|
+
<tr>
|
|
166
|
+
<td><code>orange</code></td>
|
|
167
|
+
<td>The four marketing / signature slots only — brand governance, not decoration.</td>
|
|
168
|
+
<td>fill <code>--primary</code>; Current ring <code>--primary</code>; Current dot <code>--primary</code></td>
|
|
169
|
+
</tr>
|
|
170
|
+
</tbody>
|
|
171
|
+
</table>
|
|
172
|
+
|
|
173
|
+
Accent-**independent** in both families: the rail (`--outline-default`), the Done check
|
|
174
|
+
(`--status-success-solid`), the Upcoming ring (`--outline-strong`), the Upcoming digit
|
|
175
|
+
(`--text-placeholder`), the halo (`--bg-primary`), Title, Detail — and the pointer label, which stays
|
|
176
|
+
`--primary` even inside a Blue bar because it is a brand flourish, not status ink. That callout is the
|
|
177
|
+
one place in this component the Accent axis does not reach.
|
|
178
|
+
|
|
179
|
+
### Layout (Row ↔ Stack)
|
|
180
|
+
|
|
181
|
+
<Canvas of={ProgressBarStories.ContentFitFallback} />
|
|
182
|
+
|
|
183
|
+
`layout` is the **preferred** layout, not a breakpoint. Since 1.9.0 the bar owns the content-fit
|
|
184
|
+
fallback (`delivery.react`): given Row it renders Row, measures real overflow of its own root
|
|
185
|
+
(`scrollWidth > clientWidth`) and falls back to Stack by itself — the same principle as
|
|
186
|
+
`06-patterns/responsive-collapse.md`. The consumer never wires the fallback. The question is only
|
|
187
|
+
asked in Row (asked while stacked it would always answer "fits"), so every width change of the
|
|
188
|
+
bar's **parent** re-renders Row once and measures it before paint; the parent, because a stacked
|
|
189
|
+
bar may be content-sized and then never resizes. A web font that finishes loading after the first
|
|
190
|
+
probe widens the text without resizing anything, so `document.fonts` `loadingdone` re-measures too.
|
|
191
|
+
The rendered layout is published as
|
|
192
|
+
`data-layout="row" | "stack"` on the root for consumer styling (`data-[layout=stack]:…`).
|
|
193
|
+
|
|
194
|
+
The clip floor that makes the measurement fire is `_progress-bar-item` `sizes[].minWidthWhen` —
|
|
195
|
+
`min-width: 150px` on a Row step that renders a Title or a Detail (3.0.1). A marker-only step has no
|
|
196
|
+
floor beyond its halo, which is what lets the 480 × 4 wizard band (120 per step) render as Row.
|
|
197
|
+
|
|
198
|
+
DOM order is sequence order in both layouts, so `aria-current` needs no per-layout special-casing.
|
|
199
|
+
|
|
200
|
+
### Boolean switches — what each one hides
|
|
201
|
+
|
|
202
|
+
Three independent booleans, each hiding exactly one thing and moving nothing else.
|
|
203
|
+
|
|
204
|
+
<Canvas of={ProgressBarStories.BareMarkers} />
|
|
205
|
+
|
|
206
|
+
`showTitle` and `showDetail` gate the two text runs (both default `true`); a run also needs the step
|
|
207
|
+
to actually carry the string, so a step with no `title` renders no Title even with `showTitle` on.
|
|
208
|
+
Both booleans off is the **bare-marker wizard band** — and in that mode `stepLabels` is required by
|
|
209
|
+
the props union, see [Accessibility](#accessibility).
|
|
210
|
+
|
|
211
|
+
<Canvas of={ProgressBarStories.NumberlessMarkers} />
|
|
212
|
+
|
|
213
|
+
`showNumbers` (default `true`) gates the ordinal digit in the Upcoming ring. The ring keeps its
|
|
214
|
+
diameter and renders empty, so nothing reflows; Done keeps its check and Current its centre dot,
|
|
215
|
+
which is why the three states stay apart by shape even with the digits gone. It is a bar-level prop
|
|
216
|
+
rather than per-step because Figma cannot bind a parent boolean to a nested instance property.
|
|
217
|
+
|
|
218
|
+
### Step count is content
|
|
219
|
+
|
|
220
|
+
<Canvas of={ProgressBarStories.StepCount} />
|
|
221
|
+
|
|
222
|
+
There is no Steps axis: the count is `steps.length`, bounded **2–6** by the manifest. Below 2 there is
|
|
223
|
+
no progression to show — the component clamps `fillPercent` to 0 when there is a single step and
|
|
224
|
+
renders no rail at all. Above 6 a Row band stops fitting a modal's capped column and the sequence
|
|
225
|
+
stops being glanceable; split the flow into more steps of fewer items instead of growing the bar.
|
|
226
|
+
|
|
227
|
+
At the 2-step floor the fill has exactly two valid renders — zero-length (Current is first) and
|
|
228
|
+
spanning the whole rail (Current is last). Both fall out of the same formula and both are correct,
|
|
229
|
+
not edge cases to special-case.
|
|
230
|
+
|
|
231
|
+
`currentStep` is clamped into range before anything is derived, so an out-of-range index degrades to
|
|
232
|
+
the first or the last step rather than rendering a bar with no Current at all.
|
|
233
|
+
|
|
234
|
+
## Sizes
|
|
235
|
+
|
|
236
|
+
<Canvas of={ProgressBarStories.Sizes} />
|
|
237
|
+
|
|
238
|
+
<table>
|
|
239
|
+
<thead>
|
|
240
|
+
<tr>
|
|
241
|
+
<th>Size</th>
|
|
242
|
+
<th>Marker box / halo</th>
|
|
243
|
+
<th>Ring / dot</th>
|
|
244
|
+
<th>Type</th>
|
|
245
|
+
<th>Rail offset</th>
|
|
246
|
+
</tr>
|
|
247
|
+
</thead>
|
|
248
|
+
<tbody>
|
|
249
|
+
<tr>
|
|
250
|
+
<td><code>lg</code> — marketing / hero</td>
|
|
251
|
+
<td>box 26px, halo 30px</td>
|
|
252
|
+
<td>ring 24px (<code>--size-icon</code>) at <code>--border-width-200</code>, dot 12px (<code>--space-500</code>)</td>
|
|
253
|
+
<td>Title <code>--font-size-base</code> Semibold, Detail <code>--font-size-sm</code> / <code>--leading-loose</code></td>
|
|
254
|
+
<td>Row <code>top: 11px</code>; Stack <code>left: 11px</code>, <code>top: 13px</code></td>
|
|
255
|
+
</tr>
|
|
256
|
+
<tr>
|
|
257
|
+
<td><code>sm</code> — product wizard band (default)</td>
|
|
258
|
+
<td>box 24px (<code>--space-800</code>), halo 28px</td>
|
|
259
|
+
<td>ring 22px at <code>--border-width-200</code>, dot 10px (<code>--space-450</code>)</td>
|
|
260
|
+
<td>Title <code>--font-size-sm</code> / <code>--leading-loose</code> Semibold, Detail <code>--font-size-xs</code></td>
|
|
261
|
+
<td>Row <code>top: --space-450</code>; Stack <code>left: --space-450</code>, <code>top: --space-500</code></td>
|
|
262
|
+
</tr>
|
|
263
|
+
</tbody>
|
|
264
|
+
</table>
|
|
265
|
+
|
|
266
|
+
Every construction on Small is one step smaller than on Large, with no exceptions — ring Ø = marker
|
|
267
|
+
box − 2 in **every** state, one rule since the 2026-08-21 unification. The rail is 4px
|
|
268
|
+
(`--space-200`) with `--radius-200` ends at both sizes; the rail offsets above are simply half the
|
|
269
|
+
marker box, minus half the rail thickness in Row.
|
|
270
|
+
|
|
271
|
+
Rhythm, identical in both sizes: Row marker → text `--space-400`; Stack marker → text `--space-600`,
|
|
272
|
+
Title → Detail `--space-200`, text block-padding `--space-100`, step floor `--space-1200`.
|
|
273
|
+
|
|
274
|
+
Never mix sizes inside one bar — pick by surface, not by taste.
|
|
275
|
+
|
|
276
|
+
**Row hugs its height** (1.11.1). The bar, the list and the steps carry no height of their own — a
|
|
277
|
+
`sm` marker-only band is as tall as its halo, an `lg` titled band as tall as marker + Title +
|
|
278
|
+
Detail. The fixed Figma row heights 64 / 130 this replaced left dead space under the markers; the
|
|
279
|
+
code row never had them. A consumer band that needs a floor (the Modal Wizard band) sets it on its
|
|
280
|
+
own chrome, not on the bar.
|
|
281
|
+
|
|
282
|
+
> ℹ️ **Resolved upstream.** `progress-bar.md` § Sizes used to describe "one deliberate
|
|
283
|
+
> asymmetry" — Large's Current ring one size step smaller than the Done/Upcoming rings — while the
|
|
284
|
+
> item manifest's 2026-08-21 changelog lists exactly that as one of three **corrected inversions** and
|
|
285
|
+
> gives Large a single ring Ø 24. The § Sizes paragraph was dropped in `progress-bar` 1.6.1 and the
|
|
286
|
+
> matching § Do / Don't bullet in 1.7.1, so spec and
|
|
287
|
+
> manifest now agree: Large's Current and Upcoming rings match.
|
|
288
|
+
|
|
289
|
+
## States
|
|
290
|
+
|
|
291
|
+
<Canvas of={ProgressBarStories.States} />
|
|
292
|
+
|
|
293
|
+
The bar itself has no state variants. Each step has three, derived from its index against
|
|
294
|
+
`currentStep`, and the marker construction follows the state 1:1 — there is no marker-content axis:
|
|
295
|
+
|
|
296
|
+
<table>
|
|
297
|
+
<thead>
|
|
298
|
+
<tr><th>State</th><th>When</th><th>Marker</th><th>Title ink</th></tr>
|
|
299
|
+
</thead>
|
|
300
|
+
<tbody>
|
|
301
|
+
<tr>
|
|
302
|
+
<td><code>done</code></td>
|
|
303
|
+
<td>index < <code>currentStep</code></td>
|
|
304
|
+
<td>check-circle glyph, <code>--status-success-solid</code>, drawn at the ring's diameter. No ring stroke, no dot.</td>
|
|
305
|
+
<td><code>--text-primary</code></td>
|
|
306
|
+
</tr>
|
|
307
|
+
<tr>
|
|
308
|
+
<td><code>current</code></td>
|
|
309
|
+
<td>index = <code>currentStep</code> — exactly one per bar</td>
|
|
310
|
+
<td>Accent ring (<code>--border-width-200</code>, <code>--secondary-solid</code> / <code>--primary</code>) on <code>--bg-primary</code>, plus an accent centre dot at half the ring.</td>
|
|
311
|
+
<td><code>--text-primary</code></td>
|
|
312
|
+
</tr>
|
|
313
|
+
<tr>
|
|
314
|
+
<td><code>upcoming</code></td>
|
|
315
|
+
<td>index > <code>currentStep</code></td>
|
|
316
|
+
<td>Neutral ring (<code>--border-width-200</code>, <code>--outline-strong</code>) on <code>--bg-primary</code> with the ordinal digit — Semibold <code>--font-size-sm</code>, <code>--text-placeholder</code>, <code>leading-none</code> so the ring rather than the line box centres it. With <code>showNumbers={false}</code> the ring renders empty at the same size.</td>
|
|
317
|
+
<td><code>--text-secondary</code></td>
|
|
318
|
+
</tr>
|
|
319
|
+
</tbody>
|
|
320
|
+
</table>
|
|
321
|
+
|
|
322
|
+
The state therefore reads by **shape** as well as by colour (check vs. ring vs. ring + digit), so it
|
|
323
|
+
survives a grayscale or colour-blind rendering. Detail ink is constant `--text-secondary` in all three.
|
|
324
|
+
That still holds with `showNumbers` off, where Upcoming drops to an empty ring — see
|
|
325
|
+
[Boolean switches](#boolean-switches--what-each-one-hides).
|
|
326
|
+
|
|
327
|
+
The stories render the states **statically** — one bar per `currentStep` value — rather than forcing
|
|
328
|
+
them with a pseudo-state addon, because Done / Current / Upcoming are data, not pseudo-classes: moving
|
|
329
|
+
`currentStep` is the only way to reach them, and it is also how a consumer reaches them.
|
|
330
|
+
|
|
331
|
+
### Interaction — Done steps, and nothing else
|
|
332
|
+
|
|
333
|
+
<Canvas of={ProgressBarStories.Interaction} />
|
|
334
|
+
|
|
335
|
+
`_progress-bar-item` 3.0.0 gave the step an **Interaction axis** (Default · Hover · Active) on
|
|
336
|
+
`State=Done` alone. A completed step is a `<button>` that returns the flow to it, and the target is
|
|
337
|
+
the **whole item** — marker and text in one, never the marker on its own. It paints `--bg-hover` /
|
|
338
|
+
`--bg-active` at `--radius-300`, and its keyboard ring is the shared
|
|
339
|
+
`06-patterns/focus-ring.md`
|
|
340
|
+
offset idiom: `--outline-focus` at `--border-width-200`, offset 2. The manifest asks for the ring's
|
|
341
|
+
radius to be one step up (`--radius-400`) and that costs no class — CSS derives an outline's radius
|
|
342
|
+
as border-radius + outline-offset, and `6 + 2` **is** the 8px `--radius-400`. The ring is drawn
|
|
343
|
+
"2px outside the **surface**" (`focus.note`), and in Row the surface is the grown hit box, not the
|
|
344
|
+
in-flow button — so the outline rides a pseudo-element (`::after`) with the surface's own geometry,
|
|
345
|
+
and the button's native outline is off. See the geometry paragraph below.
|
|
346
|
+
|
|
347
|
+
**Current and Upcoming stay inert.** A user cannot skip ahead, the bar itself never holds focus, and
|
|
348
|
+
no state takes `disabled`. This reverses the pre-3.0.0 contract, which called the step passive
|
|
349
|
+
display and said the ring would attach at the **bar** level if a step ever became clickable; it
|
|
350
|
+
attaches on the step's own button instead.
|
|
351
|
+
|
|
352
|
+
In code the axis is **opt-in, through `onStepClick`**, as the manifest states since 1.10.0: a Done
|
|
353
|
+
step is a button only where the flow can return to it. A product wizard wires the return; a
|
|
354
|
+
marketing timeline (Large — the e-invoice rollout) renders Done static, with no button, no hover /
|
|
355
|
+
press wash and no focus stop. Omit the callback and the markup is
|
|
356
|
+
exactly what shipped before 3.0.0 — the `<li>` keeps the layout and the bar has no tab stop at all.
|
|
357
|
+
Asserted in `ProgressBar.test.tsx` in both directions.
|
|
358
|
+
|
|
359
|
+
<Canvas of={ProgressBarStories.StaticDone} />
|
|
360
|
+
|
|
361
|
+
The wash rows in the canvas above are forced with a bare class rather than a pseudo-state addon:
|
|
362
|
+
Hover and Active are one 3 % step apart, so a row the addon quietly failed to force would be
|
|
363
|
+
indistinguishable from Default and the matrix would read as passing while showing nothing. The focus
|
|
364
|
+
ring is a real `:focus-visible` and cannot be shown that way — Tab into the bar to see it.
|
|
365
|
+
|
|
366
|
+
The geometry differs by layout (`_progress-bar-item` 3.2.0, `parts.surface.note`). **Row only:** the
|
|
367
|
+
surface spans the step's full column width and extends `--space-400` above and below the item so the
|
|
368
|
+
tint clears the halo without moving any content, with a 44px minimum height — in bare-marker mode the
|
|
369
|
+
marker is 26 / 24, so box + 16 would land at 42 / 40 and ship a sub-44 target. The extension is the
|
|
370
|
+
button's absolutely positioned `::before` (which also carries the wash), so the `<li>` keeps the
|
|
371
|
+
item's natural height and a Done step is exactly as tall as Current and Upcoming. The focus ring
|
|
372
|
+
circles that same grown box: it is the outline of an `::after` with the `::before` geometry, kept
|
|
373
|
+
at z auto so the rail cannot paint over its legs, where the wash sits at `-z-10` under the content.
|
|
374
|
+
**Stack has no extension:** the surface is the item's own bounds (both pseudos at `inset-0`), and
|
|
375
|
+
its `min-height` of 64 already clears the 44px target.
|
|
376
|
+
|
|
377
|
+
### Pointer callout
|
|
378
|
+
|
|
379
|
+
<Canvas of={ProgressBarStories.PointerCallout} />
|
|
380
|
+
|
|
381
|
+
The Current step of a **Row** bar may float a marketing callout above its marker: the hand-lettered
|
|
382
|
+
`--font-decorative` label at `--font-size-lg` / `--leading-compact` on `--primary`, plus a
|
|
383
|
+
rounded-corner arrow pointing down at the marker with **5px** clearance from its top edge — the
|
|
384
|
+
manifest's `parts.pointer-label.geometry` (`arrow-tip-clearance` 5; the older "2px" in the part note
|
|
385
|
+
was corrected upstream). The label keeps `--leading-compact`, because the body 1.5 leading would
|
|
386
|
+
inflate the 26px label box by 4px. 5 falls between `--space-100` and
|
|
387
|
+
`--space-300`, so it is the one raw value here. It is a fixed short phrase in the
|
|
388
|
+
marketing voice ("Jste tady"), never user content, never a wizard tone — Stack masters carry no
|
|
389
|
+
pointer node at all.
|
|
390
|
+
|
|
391
|
+
The height it occupies (`--space-1000`) is reserved on the **bar**, driven by "any step has a
|
|
392
|
+
pointer" rather than by which step is Current — otherwise every marker would jump by the reserve as
|
|
393
|
+
the sequence advances.
|
|
394
|
+
|
|
395
|
+
### Motion
|
|
396
|
+
|
|
397
|
+
<table>
|
|
398
|
+
<thead>
|
|
399
|
+
<tr><th>What</th><th>How</th><th>Reduced motion</th></tr>
|
|
400
|
+
</thead>
|
|
401
|
+
<tbody>
|
|
402
|
+
<tr>
|
|
403
|
+
<td>Fill travel</td>
|
|
404
|
+
<td><code>transition</code> on <code>width</code> (Row) / <code>height</code> (Stack), <code>--duration-normal</code>, <code>--easing-standard</code> (<code>motion.states.value</code>). Only on a Current change — a mounted bar renders its position with no animation (<code>motion.trigger</code>).</td>
|
|
405
|
+
<td>Kept, shortened to <code>--duration-instant</code>.</td>
|
|
406
|
+
</tr>
|
|
407
|
+
<tr>
|
|
408
|
+
<td>Arriving Current dot</td>
|
|
409
|
+
<td>A named keyframe: opacity 0 → 1, <strong>no scale</strong>, over <code>--duration-fast</code> with <code>--easing-enter</code>, delayed by (normal − fast) so it lands exactly as the fill arrives (<code>_progress-bar-item</code> 3.4.1 <code>motion.states.value</code>). Opacity only — never the marker's box, which would shift the layout.</td>
|
|
410
|
+
<td>Same keyframe at <code>--duration-instant</code>, no delay.</td>
|
|
411
|
+
</tr>
|
|
412
|
+
<tr>
|
|
413
|
+
<td>Pointer callout entrance</td>
|
|
414
|
+
<td>A named keyframe: opacity 0 → 1, over <code>--duration-normal</code> with <code>--easing-enter</code> (<code>_progress-bar-item</code> 3.4.1 <code>motion.enter</code>). The callout stays where it is — it never rises and never scales; no exit — when the step stops being Current the callout is simply removed. Plays once per Current step, never loops.</td>
|
|
415
|
+
<td>Same keyframe at <code>--duration-instant</code>.</td>
|
|
416
|
+
</tr>
|
|
417
|
+
</tbody>
|
|
418
|
+
</table>
|
|
419
|
+
|
|
420
|
+
Four things worth knowing:
|
|
421
|
+
|
|
422
|
+
- **`width` / `height` is a deliberate exception** to the transform-and-opacity-only rule in
|
|
423
|
+
`motion-system.md`. The fill's *ends* carry the meaning — it must stop exactly on a marker centre —
|
|
424
|
+
and a scaled transform would distort the `--radius-200` cap. The rail is 4px and the animation is a
|
|
425
|
+
single element, so the layout cost is negligible.
|
|
426
|
+
- **The dot is a keyframe, not a transition,** because it is a freshly *mounted* element on every step
|
|
427
|
+
change and a transition has no start value to travel from.
|
|
428
|
+
- **Reduced motion shortens, it does not remove.** A progress indicator is essential motion: a frozen
|
|
429
|
+
bar is indistinguishable from a stalled one. The bloom is also armed only by the first `currentStep`
|
|
430
|
+
*change* — a bar that mounts straight into step 3 shows step 3 rather than animating into it.
|
|
431
|
+
- **The pointer callout is the opposite on mount:** it *does* animate when the bar mounts with a step
|
|
432
|
+
already Current, and again on every Current change (the callout only exists on the Current step, so
|
|
433
|
+
it remounts). It is decorative, attention-seeking motion, so reduced motion shortens it for that
|
|
434
|
+
reason rather than the essential-motion one. Its keyframe animates `opacity` only, so it cannot
|
|
435
|
+
touch the callout's horizontal centring (`-translate-x-1/2`).
|
|
436
|
+
|
|
437
|
+
The story below replays the callout entrance: step Current back and forth with **Zpět** / **Další krok**
|
|
438
|
+
and the callout enters once on each newly Current step, then rests.
|
|
439
|
+
|
|
440
|
+
<Canvas of={ProgressBarStories.CalloutEntrance} />
|
|
441
|
+
|
|
442
|
+
## API
|
|
443
|
+
|
|
444
|
+
<Controls />
|
|
445
|
+
|
|
446
|
+
<table>
|
|
447
|
+
<thead>
|
|
448
|
+
<tr><th>Prop</th><th>Type</th><th>Default</th><th>Notes</th></tr>
|
|
449
|
+
</thead>
|
|
450
|
+
<tbody>
|
|
451
|
+
<tr>
|
|
452
|
+
<td><code>steps</code></td>
|
|
453
|
+
<td><code>ProgressBarStep[]</code></td>
|
|
454
|
+
<td>—</td>
|
|
455
|
+
<td>Required. Each entry may carry <code>title</code>, <code>detail</code> and <code>pointerLabel</code>. Length is the step count, bounded 2–6.</td>
|
|
456
|
+
</tr>
|
|
457
|
+
<tr>
|
|
458
|
+
<td><code>currentStep</code></td>
|
|
459
|
+
<td><code>number</code></td>
|
|
460
|
+
<td>—</td>
|
|
461
|
+
<td>Required, 0-based. Clamped into range; everything before it is Done, everything after Upcoming.</td>
|
|
462
|
+
</tr>
|
|
463
|
+
<tr>
|
|
464
|
+
<td><code>size</code></td>
|
|
465
|
+
<td><code>'lg' | 'sm'</code></td>
|
|
466
|
+
<td><code>'sm'</code></td>
|
|
467
|
+
<td>Figma <code>lg</code> / <code>sm</code> (renamed from Large / Small in 1.11.0).</td>
|
|
468
|
+
</tr>
|
|
469
|
+
<tr>
|
|
470
|
+
<td><code>layout</code></td>
|
|
471
|
+
<td><code>'row' | 'stack'</code></td>
|
|
472
|
+
<td><code>'row'</code></td>
|
|
473
|
+
<td>Figma Row / Stack. The <em>preferred</em> layout: Row falls back to Stack by itself when it overflows; the rendered one is on <code>data-layout</code>.</td>
|
|
474
|
+
</tr>
|
|
475
|
+
<tr>
|
|
476
|
+
<td><code>variant</code></td>
|
|
477
|
+
<td><code>'blue' | 'orange'</code></td>
|
|
478
|
+
<td><code>'blue'</code></td>
|
|
479
|
+
<td>Figma Accent.</td>
|
|
480
|
+
</tr>
|
|
481
|
+
<tr>
|
|
482
|
+
<td><code>showTitle</code></td>
|
|
483
|
+
<td><code>boolean</code></td>
|
|
484
|
+
<td><code>true</code></td>
|
|
485
|
+
<td>Setting it to <code>false</code> makes <code>stepLabels</code> mandatory at the type level.</td>
|
|
486
|
+
</tr>
|
|
487
|
+
<tr>
|
|
488
|
+
<td><code>showDetail</code></td>
|
|
489
|
+
<td><code>boolean</code></td>
|
|
490
|
+
<td><code>true</code></td>
|
|
491
|
+
<td>—</td>
|
|
492
|
+
</tr>
|
|
493
|
+
<tr>
|
|
494
|
+
<td><code>showNumbers</code></td>
|
|
495
|
+
<td><code>boolean</code></td>
|
|
496
|
+
<td><code>true</code></td>
|
|
497
|
+
<td>Figma <code>Show number</code>, code-only on the bar: it covers every Upcoming step at once. Off leaves the neutral ring empty at the same size.</td>
|
|
498
|
+
</tr>
|
|
499
|
+
<tr>
|
|
500
|
+
<td><code>onStepClick</code></td>
|
|
501
|
+
<td><code>(index: number) => void</code></td>
|
|
502
|
+
<td>—</td>
|
|
503
|
+
<td>Turns every <strong>Done</strong> step into a button that calls back with its 0-based index (<code>_progress-bar-item</code> 3.0.0 Interaction). Current and Upcoming never become interactive. Opt-in on purpose — see <a href="#interaction--done-steps-and-nothing-else">Interaction</a>; omit it and the bar keeps no tab stops.</td>
|
|
504
|
+
</tr>
|
|
505
|
+
<tr>
|
|
506
|
+
<td><code>stepLabels</code></td>
|
|
507
|
+
<td><code>string[]</code></td>
|
|
508
|
+
<td>—</td>
|
|
509
|
+
<td>Visually hidden ordinal per step. Optional while the Title is shown, required once it is not. Rendered whenever a step has no visible Title. It is also what names the Done button in bare-marker mode.</td>
|
|
510
|
+
</tr>
|
|
511
|
+
</tbody>
|
|
512
|
+
</table>
|
|
513
|
+
|
|
514
|
+
The rest of `React.HTMLAttributes<HTMLDivElement>` (minus `children`) is forwarded to the root
|
|
515
|
+
`<div>`, and the `ref` points at it. There is deliberately **no** `state`, no `value` and no `fillPercent`
|
|
516
|
+
prop — the fill length is derived and is never settable on its own.
|
|
517
|
+
|
|
518
|
+
## Do / Don't
|
|
519
|
+
|
|
520
|
+
- ✅ Derive progress from `currentStep` and let the component do the rest — exactly one step is
|
|
521
|
+
Current at any time (manifest `intent.rules[3]`).
|
|
522
|
+
- ✅ Treat the step count as content: add or remove entries in `steps`, never hunt for a "5-step"
|
|
523
|
+
variant (spec § Do / Don't).
|
|
524
|
+
- ✅ Pick Accent by surface — Blue everywhere in product, wizards included; Orange only in the four
|
|
525
|
+
marketing / signature slots (spec § Do / Don't, `color-system.md`).
|
|
526
|
+
- ✅ Let Row fall back to Stack by measuring real overflow, not at a fixed screen width
|
|
527
|
+
(spec § Do / Don't).
|
|
528
|
+
- ✅ Pass `stepLabels` whenever the Title is hidden — the type union already forces it, but pass a
|
|
529
|
+
*translated* string, not a hardcoded Czech one (spec § Accessibility; the design system ships no
|
|
530
|
+
locale).
|
|
531
|
+
- ❌ Don't reach for ProgressBar to show a percentage or an indeterminate load; it has no such mode
|
|
532
|
+
(spec § Do / Don't).
|
|
533
|
+
- ❌ Don't try to give a step its own connector line or its own marker glyph — both are owned by the
|
|
534
|
+
parent / fixed to State (spec § Do / Don't).
|
|
535
|
+
- ❌ Don't reuse the pointer callout in a product wizard: it is a marketing flourish in the
|
|
536
|
+
hand-lettered voice, not a wizard label (spec § Copy).
|
|
537
|
+
- ❌ Don't mix sizes inside one bar (manifest `intent.sizing`).
|
|
538
|
+
- ❌ Don't darken the Upcoming digit, the Orange fill, the rail, the pointer callout ink or the
|
|
539
|
+
Upcoming ring, or swap the Done-step hover / press wash for a stronger one, to chase a contrast ratio —
|
|
540
|
+
all six are registered upstream exceptions, see below.
|
|
541
|
+
- ❌ *Recommendation:* don't wire `layout` to a media query "because it is basically mobile" — a
|
|
542
|
+
narrow container inside a wide viewport is exactly the case the overflow measurement catches and a
|
|
543
|
+
breakpoint does not.
|
|
544
|
+
- ❌ *Recommendation:* don't let a Title grow past a line or two of copy — it wraps rather than
|
|
545
|
+
truncates, so a long title silently grows the whole band (spec § Copy calls out ~28 characters).
|
|
546
|
+
|
|
547
|
+
## Accessibility
|
|
548
|
+
|
|
549
|
+
- **Keyboard** — without `onStepClick` there is nothing to describe, on purpose: the bar renders no
|
|
550
|
+
interactive element and sets no `tabIndex`, so it takes no Tab stop and answers no key. With the
|
|
551
|
+
callback, every **Done** step becomes a real `<button>` and the keyboard comes free — Tab reaches
|
|
552
|
+
them in sequence order, Enter and Space activate them, and the `:focus-visible` ring is the shared
|
|
553
|
+
offset pattern. Current and Upcoming are never reachable, so nobody can Tab their way forward
|
|
554
|
+
through a flow they have not completed, and the bar itself still never holds focus.
|
|
555
|
+
- **ARIA** — an `<ol role="list">` carries the sequence, one `<li>` per step, and the Current step
|
|
556
|
+
carries `aria-current="step"`. The explicit `role="list"` compensates for `list-style: none`, which
|
|
557
|
+
drops the implicit role in Safari. The rail is a `<div aria-hidden="true">` outside the `<ol>`, so
|
|
558
|
+
the list a reader hears is the steps alone. Halo, marker, glyph, dot and the
|
|
559
|
+
pointer arrow are all `aria-hidden` or unlabelled decoration.
|
|
560
|
+
- **Screen reader** — a step's accessible name is its **Title**. In the bare-marker mode there is no
|
|
561
|
+
Title, so `stepLabels` becomes **required through the props union** (the same shape `FilterChip`
|
|
562
|
+
uses for its clear button) and renders as a visually hidden span: `aria-current` alone does not let
|
|
563
|
+
a screen-reader user place themselves in a sequence — it says "you are here", never "here is step
|
|
564
|
+
three of four". The strings come from the consumer's own translations ("Krok 1", "Step 1", …); the
|
|
565
|
+
design system is locale-agnostic and ships no default. Enforcing it in the type rather than at
|
|
566
|
+
runtime means a call site cannot forget it. A step that just omits its `title` under the default
|
|
567
|
+
`showTitle` is outside what the type can see; it logs a development-only `console.warn` when no
|
|
568
|
+
`stepLabels` entry names it, because a clickable Done step would otherwise be a nameless button.
|
|
569
|
+
- **Colour is not the only carrier** — Done / Current / Upcoming differ in marker *shape* (check ·
|
|
570
|
+
ring + dot · ring, with or without the digit), not just in ink. The same holds for the Done
|
|
571
|
+
button's hover: the pointer cursor and the focus ring say what the 3 % wash says.
|
|
572
|
+
- **Target size** — in Row a Done button spans the step's full column width and the extended
|
|
573
|
+
surface height (its `::before` layer), with a 44px floor (the extension is Row only). In bare-marker mode the marker is 26 / 24, so the surface's own construction
|
|
574
|
+
(box + 16) would land at 42 / 40; the floor is what keeps it clear of
|
|
575
|
+
`accessibility.md` § Touch targets. Stack has no extension — the surface is the item's own
|
|
576
|
+
bounds, already floored by its `min-height` of 64.
|
|
577
|
+
- **Contrast — six registered sub-AA exceptions.** These are owner-signed upstream decisions, not
|
|
578
|
+
oversights; do not re-derive them and do not "fix" them:
|
|
579
|
+
|
|
580
|
+
<table>
|
|
581
|
+
<thead>
|
|
582
|
+
<tr><th>What</th><th>Ratio</th><th>Grounds</th></tr>
|
|
583
|
+
</thead>
|
|
584
|
+
<tbody>
|
|
585
|
+
<tr>
|
|
586
|
+
<td>Upcoming ordinal digit, <code>--text-placeholder</code></td>
|
|
587
|
+
<td>2.71:1</td>
|
|
588
|
+
<td>Decorative-duplicated — the step's ordinal is already given by its position in the sequence, and the state is carried by the marker construction plus the fill's end. Registered 2026-08-20; <code>accessibility.md</code> § Accepted exception — Progress Bar Upcoming digit ink.</td>
|
|
589
|
+
</tr>
|
|
590
|
+
<tr>
|
|
591
|
+
<td>Accent=Orange fill, <code>--primary</code></td>
|
|
592
|
+
<td>2.37:1 on <code>--bg-primary</code>, 1.79:1 against the rail</td>
|
|
593
|
+
<td>Progress is never carried by the fill's colour alone — each marker states its state by construction and the fill's <em>length</em> states how far the sequence has run. Confined to the marketing slots; in-product bars are Blue and clear the floor. Registered 2026-08-21.</td>
|
|
594
|
+
</tr>
|
|
595
|
+
<tr>
|
|
596
|
+
<td>Pointer callout label + arrow, <code>--primary</code></td>
|
|
597
|
+
<td>2.37:1</td>
|
|
598
|
+
<td>A decorative marketing marker, never the sole carrier of meaning — the Current marker's own shape and the connector's colour hand-off already say which step is current. <code>Show pointer</code> defaults off outside marketing use. Owner, 2026-08-14.</td>
|
|
599
|
+
</tr>
|
|
600
|
+
<tr>
|
|
601
|
+
<td>Upcoming ring, <code>--outline-strong</code></td>
|
|
602
|
+
<td>1.73:1</td>
|
|
603
|
+
<td>Same token, ratio and reasoning as the resting control & field edge border exception, which names Checkbox / Radio and the field shells but not this ring. Owner, 2026-08-21.</td>
|
|
604
|
+
</tr>
|
|
605
|
+
<tr>
|
|
606
|
+
<td>Rail, <code>--outline-default</code></td>
|
|
607
|
+
<td>1.32:1</td>
|
|
608
|
+
<td>1.4.11 governs the graphical object a reader needs in order to understand the content — here that is the fill and its boundary, not the ground behind it.</td>
|
|
609
|
+
</tr>
|
|
610
|
+
<tr>
|
|
611
|
+
<td>Done-step hover / press wash, <code>--bg-hover</code> / <code>--bg-active</code></td>
|
|
612
|
+
<td>below 3:1 (3 % / 6 % over <code>--bg-primary</code>)</td>
|
|
613
|
+
<td>The system's one quiet interaction highlight, not retuned per surface; never the sole carrier — the pointer cursor, the separate <code>:focus-visible</code> ring and the Done check-circle duplicate it. Only where a Done step is a button (product wizard). Owner 2026-09-17, registered 2026-10-05; <code>accessibility.md</code> § Accepted exception — Progress Bar's Done-step hover / press wash.</td>
|
|
614
|
+
</tr>
|
|
615
|
+
</tbody>
|
|
616
|
+
</table>
|
|
617
|
+
|
|
618
|
+
- **Motion** — see [Motion](#motion). Under `prefers-reduced-motion` all three animations are kept and
|
|
619
|
+
shortened to `--duration-instant` rather than removed: the fill and the dot because a progress
|
|
620
|
+
indicator is essential motion, the pointer callout because the manifest keeps its transition and
|
|
621
|
+
only drops the emphasis.
|
|
622
|
+
|
|
623
|
+
Accessibility floor for every FODS component: `spec/01-foundations/accessibility.md`.
|
|
624
|
+
|
|
625
|
+
## Copy
|
|
626
|
+
|
|
627
|
+
Voice: the product tone of voice, impersonal and in-app. The pointer callout is the one exception
|
|
628
|
+
(see below).
|
|
629
|
+
|
|
630
|
+
- **Step label** (`steps[].title`) — a short, active-voice noun or verb phrase naming the step,
|
|
631
|
+
sentence case, no terminal period. It wraps rather than truncates, max 28 characters: a long
|
|
632
|
+
title crowds a dense Row band. In the bare-marker mode it is replaced by a visually hidden
|
|
633
|
+
ordinal label (`stepLabels`), never omitted entirely.
|
|
634
|
+
- **Detail** (`steps[].detail`) — one short supporting line under the title. It truncates past two
|
|
635
|
+
lines, so don't rely on a third line ever being visible.
|
|
636
|
+
- **Ordinal digit** — not authored copy; it is generated from the step's position (1–99).
|
|
637
|
+
- **Pointer label** (`steps[].pointerLabel`, Current step only) — a short, fixed phrase in the
|
|
638
|
+
hand-lettered marketing voice, not user content and not the neutral wizard tone. Never reuse it
|
|
639
|
+
in a product wizard.
|
|
640
|
+
|
|
641
|
+
Example texts from the spec:
|
|
642
|
+
|
|
643
|
+
<table>
|
|
644
|
+
<thead>
|
|
645
|
+
<tr><th>Run</th><th>Examples</th></tr>
|
|
646
|
+
</thead>
|
|
647
|
+
<tbody>
|
|
648
|
+
<tr><td>Step label</td><td>Implementujeme · Máme hotovo · Jste tady</td></tr>
|
|
649
|
+
<tr><td>Pointer label</td><td>Jste tady</td></tr>
|
|
650
|
+
</tbody>
|
|
651
|
+
</table>
|
|
652
|
+
|
|
653
|
+
## Usage
|
|
654
|
+
|
|
655
|
+
<Canvas of={ProgressBarStories.Playground} />
|
|
656
|
+
|
|
657
|
+
```tsx
|
|
658
|
+
// Good — a marketing rollout narrative: Large, titled steps, the callout on Current only.
|
|
659
|
+
<ProgressBar
|
|
660
|
+
size="lg"
|
|
661
|
+
variant="orange"
|
|
662
|
+
currentStep={1}
|
|
663
|
+
steps={[
|
|
664
|
+
{ title: 'Implementujeme', detail: 'Máme hotovo' },
|
|
665
|
+
{ title: 'Vy testujete', detail: 'Budete mít dva měsíce na testování', pointerLabel: 'Jste tady' },
|
|
666
|
+
{ title: 'Je to povinné', detail: 'Zatím není účinné' },
|
|
667
|
+
]}
|
|
668
|
+
/>
|
|
669
|
+
```
|
|
670
|
+
|
|
671
|
+
```tsx
|
|
672
|
+
// Good — the wizard band: bare markers, so every step brings a translated ordinal.
|
|
673
|
+
<ProgressBar
|
|
674
|
+
currentStep={step}
|
|
675
|
+
showTitle={false}
|
|
676
|
+
showDetail={false}
|
|
677
|
+
steps={[{}, {}, {}, {}]}
|
|
678
|
+
stepLabels={[t('wizard.step1'), t('wizard.step2'), t('wizard.step3'), t('wizard.step4')]}
|
|
679
|
+
/>
|
|
680
|
+
```
|
|
681
|
+
|
|
682
|
+
```tsx
|
|
683
|
+
// Good — pass the PREFERRED layout; the bar measures its own overflow and falls back
|
|
684
|
+
// to Stack by itself (1.9.0), re-checking whenever its parent's width changes.
|
|
685
|
+
<ProgressBar layout="row" currentStep={2} steps={steps} />
|
|
686
|
+
|
|
687
|
+
// Don't — measure in the consumer and feed the verdict back in; that is the bar's job.
|
|
688
|
+
<ProgressBar layout={measuredLayout} currentStep={2} steps={steps} />
|
|
689
|
+
```
|
|
690
|
+
|
|
691
|
+
```tsx
|
|
692
|
+
// Don't — the fill is derived; there is no percentage API and no indeterminate mode.
|
|
693
|
+
<ProgressBar value={65} steps={steps} />
|
|
694
|
+
|
|
695
|
+
// Don't — a bare-marker bar with no ordinals. The type union rejects this, and a
|
|
696
|
+
// screen-reader user would hear four unnamed list items.
|
|
697
|
+
<ProgressBar currentStep={2} showTitle={false} steps={[{}, {}, {}, {}]} />
|
|
698
|
+
|
|
699
|
+
// Don't — Orange in a product wizard. Accent is brand governance, not decoration.
|
|
700
|
+
<ProgressBar variant="orange" currentStep={1} steps={wizardSteps} />
|
|
701
|
+
```
|
|
702
|
+
|
|
703
|
+
## Related
|
|
704
|
+
|
|
705
|
+
- **Siblings:** [`Pagination`](?path=/docs/design-system-molecules-pagination--docs) — the paging
|
|
706
|
+
footer, for a result set rather than a fixed ordered flow.
|
|
707
|
+
[`ButtonGroup`](?path=/docs/design-system-molecules-buttongroup--docs) — for independent actions
|
|
708
|
+
with no fixed order. [`Skeleton`](?path=/docs/design-system-atoms-skeleton--docs) — the rail
|
|
709
|
+
used to borrow its `--bg-skeleton`; since 1.8.1 it binds the structural `--outline-default` (same
|
|
710
|
+
primitive, different intent).
|
|
711
|
+
- **Radix:** none — ProgressBar is plain semantic HTML (`<ol>` / `<li>`), no Radix primitive is
|
|
712
|
+
involved.
|
|
713
|
+
- **Spec:** `spec/04-molecules/progress-bar.md`,
|
|
714
|
+
`spec/04-molecules/progress-bar.manifest.json`,
|
|
715
|
+
`spec/03-atoms/_progress-bar-item.manifest.json`.
|
|
716
|
+
A runnable motion reference sits beside the spec as `progress-bar.motion.html` — hand-authored and
|
|
717
|
+
**not** authoritative; the manifest's `motion` block is.
|
|
718
|
+
- **Open upstream items:** none. The Done hover / active wash was registered in `accessibility.md`
|
|
719
|
+
with `_progress-bar-item` 3.3.1 (see [Accessibility](#accessibility)); it, the § Sizes ring
|
|
720
|
+
asymmetry (including its § Do / Don't bullet), the Stack rail overshoot and the Row-only
|
|
721
|
+
click-surface extension are resolved.
|
|
722
|
+
|
|
723
|
+
## Migration notes
|
|
724
|
+
|
|
725
|
+
ProgressBar replaces the **retired** standalone atom `StepperItem`. Its v1 shape drew a connector half
|
|
726
|
+
on every item and exposed a Marker-content axis independent of State; upstream deleted
|
|
727
|
+
`stepper-item.manifest.json` and shipped `progress-bar` 1.4.0 plus the private `_progress-bar-item`
|
|
728
|
+
2.2.1 in its place (today 1.11.2 / 3.4.1). That v1 shape is **superseded, not a reference** — do not build new consumers
|
|
729
|
+
against it.
|
|
730
|
+
|
|
731
|
+
Diff v1 (`StepperItem`) → v2 (`ProgressBar`), taken from the `_progress-bar-item` changelog entries of
|
|
732
|
+
2026-08-20 and 2026-08-21:
|
|
733
|
+
|
|
734
|
+
<table>
|
|
735
|
+
<thead>
|
|
736
|
+
<tr><th>v1 — Stepper Item</th><th>v2 — Progress Bar</th><th>Why</th></tr>
|
|
737
|
+
</thead>
|
|
738
|
+
<tbody>
|
|
739
|
+
<tr>
|
|
740
|
+
<td>Connector halves on every item</td>
|
|
741
|
+
<td><strong>Gone.</strong> The parent owns one continuous track.</td>
|
|
742
|
+
<td>A single element can slide forward; N joined half-segments break at the seams.</td>
|
|
743
|
+
</tr>
|
|
744
|
+
<tr>
|
|
745
|
+
<td><code>Marker content</code> axis, independent of State</td>
|
|
746
|
+
<td><strong>Gone.</strong> The marker construction follows State 1:1.</td>
|
|
747
|
+
<td>A Done step is never anything but a checkmark — the freedom was never real.</td>
|
|
748
|
+
</tr>
|
|
749
|
+
<tr>
|
|
750
|
+
<td>No Size axis</td>
|
|
751
|
+
<td><strong>Added</strong> — Large · Small (<code>size</code>).</td>
|
|
752
|
+
<td>Marketing/hero versus the product wizard band.</td>
|
|
753
|
+
</tr>
|
|
754
|
+
<tr>
|
|
755
|
+
<td>Halo hand-placed by each composition</td>
|
|
756
|
+
<td><strong>Added</strong> to the step as its bottom marker layer.</td>
|
|
757
|
+
<td>The geometry had already drifted twice; now every composition gets the air for free.</td>
|
|
758
|
+
</tr>
|
|
759
|
+
<tr>
|
|
760
|
+
<td>Current = an empty accent ring</td>
|
|
761
|
+
<td><strong>Added</strong> an accent centre <code>dot</code>, Ø half the ring.</td>
|
|
762
|
+
<td>Part of the 2026-08-21 marker-geometry unification.</td>
|
|
763
|
+
</tr>
|
|
764
|
+
<tr>
|
|
765
|
+
<td>No title toggle</td>
|
|
766
|
+
<td><strong>Added</strong> <code>showTitle</code>; with <code>showDetail</code> off it forms the bare-marker mode.</td>
|
|
767
|
+
<td>The Modal Wizard band needs markers with no copy.</td>
|
|
768
|
+
</tr>
|
|
769
|
+
<tr>
|
|
770
|
+
<td>Marker always carried its ordinal</td>
|
|
771
|
+
<td><strong>Added</strong> <code>showNumbers</code>; off leaves the Upcoming ring empty at the same Ø.</td>
|
|
772
|
+
<td>Added with <code>progress-bar</code> 1.5.0, later than the rest of this diff — a band can want the shape without the count.</td>
|
|
773
|
+
</tr>
|
|
774
|
+
<tr>
|
|
775
|
+
<td>Upcoming digit on the default ink</td>
|
|
776
|
+
<td>Recoloured to <code>--text-placeholder</code>.</td>
|
|
777
|
+
<td>Registered sub-AA exception — see Accessibility.</td>
|
|
778
|
+
</tr>
|
|
779
|
+
<tr>
|
|
780
|
+
<td>Mixed ring strokes</td>
|
|
781
|
+
<td>All ring strokes on <code>--border-width-200</code>, ring Ø = marker box − 2 in every state.</td>
|
|
782
|
+
<td>Corrects three inversions where Small was not uniformly smaller than Large.</td>
|
|
783
|
+
</tr>
|
|
784
|
+
</tbody>
|
|
785
|
+
</table>
|
|
786
|
+
|
|
787
|
+
Call-site mapping: a `StepperItem` list becomes one `ProgressBar` with a `steps` array; the per-item
|
|
788
|
+
`state` prop becomes the single `currentStep` index on the parent; any per-item connector or marker
|
|
789
|
+
override has no equivalent and should simply be dropped.
|
|
790
|
+
|
|
791
|
+
**Not yet built:** Blocked and Error are decided upstream as a *modifier* over Done/Current rather
|
|
792
|
+
than as new State values (Error = `warning-circle` on `--status-danger`, Blocked = `prohibit` on
|
|
793
|
+
`--icon-muted`, and the fill does not reach past a Blocked step). Neither exists in this component
|
|
794
|
+
today.
|
|
795
|
+
|
|
796
|
+
**Manifest 1.11.1 → 1.11.2 / `_progress-bar-item` 3.4.0 → 3.4.1 (motion audit, 2026-11-03).** The fill
|
|
797
|
+
transition moves from `motion.enter` to `motion.states.value` (same `--duration-normal` / `--easing-standard`
|
|
798
|
+
on `width` / `height`; the duplicate `enter` block contradicted the no-animation-on-mount trigger) and the bar
|
|
799
|
+
`inherits` `_progress-bar-item`. Two code changes follow from the item: the arriving dot **fades in only**
|
|
800
|
+
(the `scale(0)` bloom is gone) on `--easing-enter` instead of `--easing-standard`, and the pointer callout
|
|
801
|
+
**fades in only** (the `translateY(4px)` rise is dropped). Timing and reduced-motion handling are unchanged —
|
|
802
|
+
see [Motion](#motion).
|