@invoiceonline/ui-react 0.0.0 → 0.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +99 -0
- package/CHANGELOG.md +131 -0
- package/LICENSE +9 -0
- package/README.md +77 -1
- package/dist/assets/label-brush-1.svg +6 -0
- package/dist/assets/pattern-dark.svg +113 -0
- package/dist/components/action-row/ActionRow.d.ts +178 -0
- package/dist/components/action-row/ActionRow.js +340 -0
- package/dist/components/action-row/index.d.ts +2 -0
- package/dist/components/action-row/index.js +1 -0
- package/dist/components/alert/Alert.d.ts +314 -0
- package/dist/components/alert/Alert.js +446 -0
- package/dist/components/alert/index.d.ts +2 -0
- package/dist/components/alert/index.js +1 -0
- package/dist/components/anchored-panel/AnchoredPanel.d.ts +41 -0
- package/dist/components/anchored-panel/AnchoredPanel.js +72 -0
- package/dist/components/anchored-panel/index.d.ts +3 -0
- package/dist/components/anchored-panel/index.js +3 -0
- package/dist/components/badge/Badge.d.ts +146 -0
- package/dist/components/badge/Badge.js +258 -0
- package/dist/components/badge/index.d.ts +2 -0
- package/dist/components/badge/index.js +1 -0
- package/dist/components/banner/Banner.d.ts +209 -0
- package/dist/components/banner/Banner.js +339 -0
- package/dist/components/banner/index.d.ts +2 -0
- package/dist/components/banner/index.js +1 -0
- package/dist/components/button/Button.d.ts +54 -0
- package/dist/components/button/Button.js +312 -0
- package/dist/components/button/index.d.ts +2 -0
- package/dist/components/button/index.js +1 -0
- package/dist/components/button-group/ButtonGroup.d.ts +187 -0
- package/dist/components/button-group/ButtonGroup.js +217 -0
- package/dist/components/button-group/index.d.ts +2 -0
- package/dist/components/button-group/index.js +1 -0
- package/dist/components/card-select/CardSelect.d.ts +274 -0
- package/dist/components/card-select/CardSelect.js +561 -0
- package/dist/components/card-select/CardSelectGroup.d.ts +92 -0
- package/dist/components/card-select/CardSelectGroup.js +72 -0
- package/dist/components/card-select/index.d.ts +3 -0
- package/dist/components/card-select/index.js +3 -0
- package/dist/components/checkbox/Checkbox.d.ts +104 -0
- package/dist/components/checkbox/Checkbox.js +194 -0
- package/dist/components/checkbox/index.d.ts +2 -0
- package/dist/components/checkbox/index.js +1 -0
- package/dist/components/chip/Chip.d.ts +250 -0
- package/dist/components/chip/Chip.js +441 -0
- package/dist/components/chip/index.d.ts +2 -0
- package/dist/components/chip/index.js +1 -0
- package/dist/components/column-header/ColumnHeader.d.ts +144 -0
- package/dist/components/column-header/ColumnHeader.js +209 -0
- package/dist/components/column-header/index.d.ts +2 -0
- package/dist/components/column-header/index.js +1 -0
- package/dist/components/combobox-field/Combobox.d.ts +104 -0
- package/dist/components/combobox-field/Combobox.js +355 -0
- package/dist/components/combobox-field/ComboboxField.d.ts +76 -0
- package/dist/components/combobox-field/ComboboxField.js +98 -0
- package/dist/components/combobox-field/index.d.ts +3 -0
- package/dist/components/combobox-field/index.js +3 -0
- package/dist/components/date-field/DateField.d.ts +52 -0
- package/dist/components/date-field/DateField.js +45 -0
- package/dist/components/date-field/index.d.ts +2 -0
- package/dist/components/date-field/index.js +1 -0
- package/dist/components/date-picker/DatePicker.d.ts +53 -0
- package/dist/components/date-picker/DatePicker.js +329 -0
- package/dist/components/date-picker/index.d.ts +2 -0
- package/dist/components/date-picker/index.js +1 -0
- package/dist/components/divider/Divider.d.ts +81 -0
- package/dist/components/divider/Divider.js +93 -0
- package/dist/components/divider/index.d.ts +2 -0
- package/dist/components/divider/index.js +1 -0
- package/dist/components/drawer/Drawer.d.ts +128 -0
- package/dist/components/drawer/Drawer.js +367 -0
- package/dist/components/drawer/index.d.ts +2 -0
- package/dist/components/drawer/index.js +1 -0
- package/dist/components/dropdown-button/DropdownButton.d.ts +72 -0
- package/dist/components/dropdown-button/DropdownButton.js +122 -0
- package/dist/components/dropdown-button/index.d.ts +2 -0
- package/dist/components/dropdown-button/index.js +1 -0
- package/dist/components/faq/FAQ.d.ts +135 -0
- package/dist/components/faq/FAQ.js +258 -0
- package/dist/components/faq/index.d.ts +2 -0
- package/dist/components/faq/index.js +1 -0
- package/dist/components/field/Field.d.ts +118 -0
- package/dist/components/field/Field.js +327 -0
- package/dist/components/field/index.d.ts +2 -0
- package/dist/components/field/index.js +1 -0
- package/dist/components/field-pair/FieldPair.d.ts +194 -0
- package/dist/components/field-pair/FieldPair.js +321 -0
- package/dist/components/field-pair/index.d.ts +2 -0
- package/dist/components/field-pair/index.js +1 -0
- package/dist/components/file-upload/FileUpload.d.ts +137 -0
- package/dist/components/file-upload/FileUpload.js +434 -0
- package/dist/components/file-upload/index.d.ts +2 -0
- package/dist/components/file-upload/index.js +1 -0
- package/dist/components/filter-chip/FilterChip.d.ts +373 -0
- package/dist/components/filter-chip/FilterChip.js +517 -0
- package/dist/components/filter-chip/index.d.ts +2 -0
- package/dist/components/filter-chip/index.js +1 -0
- package/dist/components/filter-facet/FilterFacet.d.ts +116 -0
- package/dist/components/filter-facet/FilterFacet.js +632 -0
- package/dist/components/filter-facet/index.d.ts +2 -0
- package/dist/components/filter-facet/index.js +1 -0
- package/dist/components/firm-avatar/FirmAvatar.d.ts +75 -0
- package/dist/components/firm-avatar/FirmAvatar.js +119 -0
- package/dist/components/firm-avatar/index.d.ts +2 -0
- package/dist/components/firm-avatar/index.js +1 -0
- package/dist/components/form-actions/FormActions.d.ts +123 -0
- package/dist/components/form-actions/FormActions.js +195 -0
- package/dist/components/form-actions/index.d.ts +2 -0
- package/dist/components/form-actions/index.js +1 -0
- package/dist/components/form-block/FormBlock.d.ts +252 -0
- package/dist/components/form-block/FormBlock.js +420 -0
- package/dist/components/form-block/index.d.ts +3 -0
- package/dist/components/form-block/index.js +3 -0
- package/dist/components/form-section/FormSection.d.ts +130 -0
- package/dist/components/form-section/FormSection.js +206 -0
- package/dist/components/form-section/index.d.ts +2 -0
- package/dist/components/form-section/index.js +1 -0
- package/dist/components/heading/Heading.d.ts +69 -0
- package/dist/components/heading/Heading.js +79 -0
- package/dist/components/heading/index.d.ts +2 -0
- package/dist/components/heading/index.js +1 -0
- package/dist/components/heading-group/HeadingGroup.d.ts +258 -0
- package/dist/components/heading-group/HeadingGroup.js +255 -0
- package/dist/components/heading-group/index.d.ts +2 -0
- package/dist/components/heading-group/index.js +1 -0
- package/dist/components/hero/Hero.d.ts +268 -0
- package/dist/components/hero/Hero.js +316 -0
- package/dist/components/hero/index.d.ts +2 -0
- package/dist/components/hero/index.js +1 -0
- package/dist/components/icon/Icon.d.ts +27 -0
- package/dist/components/icon/Icon.js +30 -0
- package/dist/components/icon/index.d.ts +3 -0
- package/dist/components/icon/index.js +3 -0
- package/dist/components/icon-button/IconButton.d.ts +75 -0
- package/dist/components/icon-button/IconButton.js +151 -0
- package/dist/components/icon-button/index.d.ts +2 -0
- package/dist/components/icon-button/index.js +1 -0
- package/dist/components/item-row/ItemRow.d.ts +253 -0
- package/dist/components/item-row/ItemRow.js +496 -0
- package/dist/components/item-row/index.d.ts +2 -0
- package/dist/components/item-row/index.js +1 -0
- package/dist/components/list-row/ListRow.d.ts +165 -0
- package/dist/components/list-row/ListRow.js +233 -0
- package/dist/components/list-row/index.d.ts +2 -0
- package/dist/components/list-row/index.js +1 -0
- package/dist/components/menu/Menu.d.ts +64 -0
- package/dist/components/menu/Menu.js +186 -0
- package/dist/components/menu/index.d.ts +2 -0
- package/dist/components/menu/index.js +1 -0
- package/dist/components/modal/Modal.d.ts +272 -0
- package/dist/components/modal/Modal.js +788 -0
- package/dist/components/modal/index.d.ts +2 -0
- package/dist/components/modal/index.js +1 -0
- package/dist/components/nav-link/NavLink.d.ts +123 -0
- package/dist/components/nav-link/NavLink.js +157 -0
- package/dist/components/nav-link/index.d.ts +2 -0
- package/dist/components/nav-link/index.js +1 -0
- package/dist/components/number-field/NumberField.d.ts +62 -0
- package/dist/components/number-field/NumberField.js +210 -0
- package/dist/components/number-field/index.d.ts +2 -0
- package/dist/components/number-field/index.js +1 -0
- package/dist/components/pagination/Pagination.d.ts +133 -0
- package/dist/components/pagination/Pagination.js +217 -0
- package/dist/components/pagination/index.d.ts +3 -0
- package/dist/components/pagination/index.js +3 -0
- package/dist/components/popover-surface/index.d.ts +2 -0
- package/dist/components/popover-surface/index.js +1 -0
- package/dist/components/progress-bar/ProgressBar.d.ts +260 -0
- package/dist/components/progress-bar/ProgressBar.js +470 -0
- package/dist/components/progress-bar/index.d.ts +2 -0
- package/dist/components/progress-bar/index.js +1 -0
- package/dist/components/promo-sticker/PromoSticker.d.ts +204 -0
- package/dist/components/promo-sticker/PromoSticker.js +177 -0
- package/dist/components/promo-sticker/index.d.ts +2 -0
- package/dist/components/promo-sticker/index.js +1 -0
- package/dist/components/promo-surface/PromoSurface.d.ts +94 -0
- package/dist/components/promo-surface/PromoSurface.js +119 -0
- package/dist/components/promo-surface/index.d.ts +2 -0
- package/dist/components/promo-surface/index.js +1 -0
- package/dist/components/radio/Radio.d.ts +92 -0
- package/dist/components/radio/Radio.js +171 -0
- package/dist/components/radio/index.d.ts +2 -0
- package/dist/components/radio/index.js +1 -0
- package/dist/components/radio-group/RadioGroup.d.ts +61 -0
- package/dist/components/radio-group/RadioGroup.js +51 -0
- package/dist/components/radio-group/index.d.ts +2 -0
- package/dist/components/radio-group/index.js +1 -0
- package/dist/components/select/Select.d.ts +65 -0
- package/dist/components/select/Select.js +176 -0
- package/dist/components/select/index.d.ts +2 -0
- package/dist/components/select/index.js +1 -0
- package/dist/components/select-field/SelectField.d.ts +16 -0
- package/dist/components/select-field/SelectField.js +55 -0
- package/dist/components/select-field/index.d.ts +2 -0
- package/dist/components/select-field/index.js +1 -0
- package/dist/components/skeleton/Skeleton.d.ts +64 -0
- package/dist/components/skeleton/Skeleton.js +65 -0
- package/dist/components/skeleton/index.d.ts +2 -0
- package/dist/components/skeleton/index.js +1 -0
- package/dist/components/split-button/SplitButton.d.ts +80 -0
- package/dist/components/split-button/SplitButton.js +182 -0
- package/dist/components/split-button/index.d.ts +2 -0
- package/dist/components/split-button/index.js +1 -0
- package/dist/components/status-summary-bar/StatusSummaryBar.d.ts +118 -0
- package/dist/components/status-summary-bar/StatusSummaryBar.js +278 -0
- package/dist/components/status-summary-bar/index.d.ts +2 -0
- package/dist/components/status-summary-bar/index.js +1 -0
- package/dist/components/subject-lookup-field/SubjectLookupField.d.ts +157 -0
- package/dist/components/subject-lookup-field/SubjectLookupField.js +663 -0
- package/dist/components/subject-lookup-field/index.d.ts +2 -0
- package/dist/components/subject-lookup-field/index.js +1 -0
- package/dist/components/switch/Switch.d.ts +152 -0
- package/dist/components/switch/Switch.js +307 -0
- package/dist/components/switch/index.d.ts +2 -0
- package/dist/components/switch/index.js +1 -0
- package/dist/components/table/Table.d.ts +5 -0
- package/dist/components/table/Table.js +601 -0
- package/dist/components/table/index.d.ts +6 -0
- package/dist/components/table/index.js +6 -0
- package/dist/components/text-field/TextField.d.ts +65 -0
- package/dist/components/text-field/TextField.js +173 -0
- package/dist/components/text-field/index.d.ts +2 -0
- package/dist/components/text-field/index.js +1 -0
- package/dist/components/text-link/TextLink.d.ts +260 -0
- package/dist/components/text-link/TextLink.js +303 -0
- package/dist/components/text-link/index.d.ts +2 -0
- package/dist/components/text-link/index.js +1 -0
- package/dist/components/textarea/Textarea.d.ts +93 -0
- package/dist/components/textarea/Textarea.js +256 -0
- package/dist/components/textarea/index.d.ts +2 -0
- package/dist/components/textarea/index.js +1 -0
- package/dist/components/tooltip/Tooltip.d.ts +129 -0
- package/dist/components/tooltip/Tooltip.js +457 -0
- package/dist/components/tooltip/index.d.ts +2 -0
- package/dist/components/tooltip/index.js +1 -0
- package/dist/components/unit-field/UnitField.d.ts +46 -0
- package/dist/components/unit-field/UnitField.js +133 -0
- package/dist/components/unit-field/index.d.ts +2 -0
- package/dist/components/unit-field/index.js +1 -0
- package/dist/icons/icon-registry.generated.js +500 -0
- package/dist/icons/icon-types.generated.d.ts +2 -0
- package/dist/icons/icon-types.generated.js +126 -0
- package/dist/index.d.ts +132 -0
- package/dist/index.js +75 -0
- package/dist/internal/BottomSheet.js +496 -0
- package/dist/internal/FodsProvider.d.ts +25 -0
- package/dist/internal/FodsProvider.js +32 -0
- package/dist/internal/MotionCaret.js +35 -0
- package/dist/internal/NumberFormatInput.d.ts +21 -0
- package/dist/internal/NumberFormatInput.js +126 -0
- package/dist/internal/SummaryDonut.d.ts +3 -0
- package/dist/internal/SummaryDonut.js +300 -0
- package/dist/internal/buttonSegment.d.ts +44 -0
- package/dist/internal/buttonSegment.js +126 -0
- package/dist/internal/collapseRoom.js +128 -0
- package/dist/internal/comboboxKeys.js +44 -0
- package/dist/internal/contentPresence.js +46 -0
- package/dist/internal/dayCell.js +95 -0
- package/dist/internal/dialogPortal.d.ts +2 -0
- package/dist/internal/dialogPortal.js +21 -0
- package/dist/internal/donutSweeps.js +65 -0
- package/dist/internal/enterOnViewGeometry.js +46 -0
- package/dist/internal/faqItem.js +80 -0
- package/dist/internal/floatingLabelMotion.js +68 -0
- package/dist/internal/formBlockContext.d.ts +22 -0
- package/dist/internal/formBlockContext.js +20 -0
- package/dist/internal/heightRoom.js +87 -0
- package/dist/internal/numberSeparators.js +62 -0
- package/dist/internal/overlayMotion.js +48 -0
- package/dist/internal/paginationItem.d.ts +8 -0
- package/dist/internal/paginationItem.js +22 -0
- package/dist/internal/popoverSurface.d.ts +8 -0
- package/dist/internal/popoverSurface.js +23 -0
- package/dist/internal/portalContainer.d.ts +1 -0
- package/dist/internal/portalContainer.js +6 -0
- package/dist/internal/progressBarItem.d.ts +207 -0
- package/dist/internal/progressBarItem.js +264 -0
- package/dist/internal/selectionControlText.js +12 -0
- package/dist/internal/statusSummaryParts.js +371 -0
- package/dist/internal/summaryMotion.js +75 -0
- package/dist/internal/table/ChildConnector.js +62 -0
- package/dist/internal/table/ChildRowPrefix.d.ts +9 -0
- package/dist/internal/table/ChildRowPrefix.js +27 -0
- package/dist/internal/table/ColumnSettings.js +135 -0
- package/dist/internal/table/ScrollRegion.js +114 -0
- package/dist/internal/table/TableEmpty.js +93 -0
- package/dist/internal/table/TableLayout.d.ts +17 -0
- package/dist/internal/table/TableLayout.js +29 -0
- package/dist/internal/table/TableLoadStatus.js +56 -0
- package/dist/internal/table/TableMobile.js +488 -0
- package/dist/internal/table/TruncatedCell.js +33 -0
- package/dist/internal/table/emptyValue.js +10 -0
- package/dist/internal/table/features.d.ts +41 -0
- package/dist/internal/table/features.js +31 -0
- package/dist/internal/table/recipes.js +227 -0
- package/dist/internal/table/rowClick.js +9 -0
- package/dist/internal/table/types.d.ts +325 -0
- package/dist/internal/table/types.js +13 -0
- package/dist/internal/tailwind-variants.d.ts +3 -0
- package/dist/internal/tailwind-variants.js +37 -0
- package/dist/internal/tooltipContext.js +5 -0
- package/dist/internal/tw-merge-config.generated.js +314 -0
- package/dist/internal/useAnchoredPanel.d.ts +87 -0
- package/dist/internal/useAnchoredPanel.js +108 -0
- package/dist/internal/useCountUp.js +53 -0
- package/dist/internal/useDateFieldTrigger.js +183 -0
- package/dist/internal/useEChart.js +59 -0
- package/dist/internal/useEnterOnView.js +42 -0
- package/dist/internal/useFloatingBar.js +100 -0
- package/dist/internal/useFormReset.js +37 -0
- package/dist/internal/useIsMobile.js +44 -0
- package/dist/internal/useOneRowOverflow.js +88 -0
- package/dist/internal/usePrefersReducedMotion.js +25 -0
- package/dist/internal/useReturnFocus.js +26 -0
- package/dist/internal/utils.d.ts +7 -0
- package/dist/internal/utils.js +58 -0
- package/dist/node_modules/@tanstack/store/dist/store.d.ts +29 -0
- package/dist/node_modules/@tanstack/store/dist/types.d.ts +38 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/cells/coreCellsFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/cells/coreCellsFeature.types.d.ts +53 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/columns/coreColumnsFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/columns/coreColumnsFeature.types.d.ts +90 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/coreFeatures.d.ts +17 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/headers/coreHeadersFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/headers/coreHeadersFeature.types.d.ts +114 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/reactivity/coreReactivityFeature.types.d.ts +51 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/row-models/coreRowModelsFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/row-models/coreRowModelsFeature.types.d.ts +29 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/rows/coreRowsFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/rows/coreRowsFeature.types.d.ts +129 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/table/coreTablesFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/table/coreTablesFeature.types.d.ts +203 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/cell-selection/cellSelectionFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/cell-selection/cellSelectionFeature.types.d.ts +294 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/cell-spanning/cellSpanningFeature.d.ts +11 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/cell-spanning/cellSpanningFeature.types.d.ts +148 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-faceting/columnFacetingFeature.d.ts +12 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-faceting/columnFacetingFeature.types.d.ts +63 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/columnFilteringFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/columnFilteringFeature.types.d.ts +209 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/filterFns.d.ts +35 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-grouping/columnGroupingFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-grouping/columnGroupingFeature.types.d.ts +128 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-ordering/columnOrderingFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-ordering/columnOrderingFeature.types.d.ts +82 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-pinning/columnPinningFeature.d.ts +11 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-pinning/columnPinningFeature.types.d.ts +195 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-resizing/columnResizingFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-resizing/columnResizingFeature.types.d.ts +73 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-sizing/columnSizingFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-sizing/columnSizingFeature.types.d.ts +134 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-visibility/columnVisibilityFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-visibility/columnVisibilityFeature.types.d.ts +92 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/global-filtering/globalFilteringFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/global-filtering/globalFilteringFeature.types.d.ts +67 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/aggregationFns.d.ts +23 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.types.d.ts +183 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.utils.d.ts +18 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-expanding/rowExpandingFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-expanding/rowExpandingFeature.types.d.ts +125 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-pagination/rowPaginationFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-pagination/rowPaginationFeature.types.d.ts +135 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-pinning/rowPinningFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-pinning/rowPinningFeature.types.d.ts +76 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-selection/rowSelectionFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-selection/rowSelectionFeature.types.d.ts +187 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/rowSortingFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/rowSortingFeature.types.d.ts +236 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/sortFns.d.ts +23 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/stockFeatures.d.ts +37 -0
- package/dist/node_modules/@tanstack/table-core/dist/helpers/columnHelper.d.ts +47 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/Cell.d.ts +16 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/Column.d.ts +30 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/ColumnDef.d.ts +123 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/Header.d.ts +12 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/HeaderGroup.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/Row.d.ts +24 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/RowModel.d.ts +19 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/RowModelFns.d.ts +11 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/Table.d.ts +53 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/TableFeatures.d.ts +416 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/TableOptions.d.ts +78 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/TableState.d.ts +46 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/type-utils.d.ts +25 -0
- package/dist/shared.css +179 -0
- package/dist/styles.css +5467 -0
- package/dist/theme.css +314 -0
- package/dist/theme.map.json +278 -0
- package/dist/tokens/index.d.ts +2 -0
- package/dist/tokens/index.js +1 -0
- package/dist/tokens/tokens.generated.d.ts +2040 -0
- package/dist/tokens/tokens.generated.js +2053 -0
- package/dist/tokens.css +484 -0
- package/dist/tokens.flat.json +429 -0
- package/docs/Consuming.mdx +379 -0
- package/docs/Contributing.mdx +78 -0
- package/docs/ForAgents.mdx +53 -0
- package/docs/Introduction.mdx +54 -0
- package/llms.txt +556 -0
- package/package.json +351 -3
- package/src/components/action-row/ActionRow.mdx +686 -0
- package/src/components/action-row/ActionRow.stories.tsx +669 -0
- package/src/components/action-row/ActionRow.tsx +632 -0
- package/src/components/action-row/index.ts +9 -0
- package/src/components/alert/Alert.mdx +377 -0
- package/src/components/alert/Alert.stories.tsx +674 -0
- package/src/components/alert/Alert.tsx +579 -0
- package/src/components/alert/index.ts +13 -0
- package/src/components/anchored-panel/AnchoredPanel.mdx +381 -0
- package/src/components/anchored-panel/AnchoredPanel.stories.tsx +593 -0
- package/src/components/anchored-panel/AnchoredPanel.tsx +176 -0
- package/src/components/anchored-panel/index.ts +15 -0
- package/src/components/badge/Badge.mdx +487 -0
- package/src/components/badge/Badge.stories.tsx +375 -0
- package/src/components/badge/Badge.tsx +360 -0
- package/src/components/badge/index.ts +10 -0
- package/src/components/banner/Banner.mdx +704 -0
- package/src/components/banner/Banner.stories.tsx +448 -0
- package/src/components/banner/Banner.tsx +602 -0
- package/src/components/banner/index.ts +14 -0
- package/src/components/button/Button.mdx +286 -0
- package/src/components/button/Button.stories.tsx +381 -0
- package/src/components/button/Button.tsx +384 -0
- package/src/components/button/index.ts +1 -0
- package/src/components/button-group/ButtonGroup.mdx +512 -0
- package/src/components/button-group/ButtonGroup.stories.tsx +714 -0
- package/src/components/button-group/ButtonGroup.tsx +491 -0
- package/src/components/button-group/index.ts +10 -0
- package/src/components/card-select/CardSelect.mdx +662 -0
- package/src/components/card-select/CardSelect.stories.tsx +784 -0
- package/src/components/card-select/CardSelect.tsx +783 -0
- package/src/components/card-select/CardSelectGroup.tsx +169 -0
- package/src/components/card-select/index.ts +18 -0
- package/src/components/checkbox/Checkbox.mdx +269 -0
- package/src/components/checkbox/Checkbox.stories.tsx +306 -0
- package/src/components/checkbox/Checkbox.tsx +343 -0
- package/src/components/checkbox/index.ts +1 -0
- package/src/components/chip/Chip.mdx +683 -0
- package/src/components/chip/Chip.stories.tsx +734 -0
- package/src/components/chip/Chip.tsx +732 -0
- package/src/components/chip/index.ts +9 -0
- package/src/components/column-header/ColumnHeader.mdx +301 -0
- package/src/components/column-header/ColumnHeader.stories.tsx +319 -0
- package/src/components/column-header/ColumnHeader.tsx +287 -0
- package/src/components/column-header/index.ts +7 -0
- package/src/components/combobox-field/Combobox.tsx +693 -0
- package/src/components/combobox-field/ComboboxField.mdx +525 -0
- package/src/components/combobox-field/ComboboxField.stories.tsx +502 -0
- package/src/components/combobox-field/ComboboxField.tsx +259 -0
- package/src/components/combobox-field/index.ts +12 -0
- package/src/components/date-field/DateField.mdx +340 -0
- package/src/components/date-field/DateField.stories.tsx +221 -0
- package/src/components/date-field/DateField.tsx +176 -0
- package/src/components/date-field/index.ts +1 -0
- package/src/components/date-picker/DatePicker.mdx +436 -0
- package/src/components/date-picker/DatePicker.stories.tsx +458 -0
- package/src/components/date-picker/DatePicker.tsx +688 -0
- package/src/components/date-picker/index.ts +9 -0
- package/src/components/divider/Divider.mdx +256 -0
- package/src/components/divider/Divider.stories.tsx +177 -0
- package/src/components/divider/Divider.tsx +193 -0
- package/src/components/divider/index.ts +1 -0
- package/src/components/drawer/Drawer.mdx +518 -0
- package/src/components/drawer/Drawer.stories.tsx +392 -0
- package/src/components/drawer/Drawer.tsx +683 -0
- package/src/components/drawer/index.ts +1 -0
- package/src/components/dropdown-button/DropdownButton.mdx +285 -0
- package/src/components/dropdown-button/DropdownButton.stories.tsx +398 -0
- package/src/components/dropdown-button/DropdownButton.tsx +198 -0
- package/src/components/dropdown-button/index.ts +7 -0
- package/src/components/faq/FAQ.mdx +364 -0
- package/src/components/faq/FAQ.stories.tsx +343 -0
- package/src/components/faq/FAQ.tsx +337 -0
- package/src/components/faq/index.ts +1 -0
- package/src/components/field/Field.mdx +129 -0
- package/src/components/field/Field.stories.tsx +461 -0
- package/src/components/field/Field.tsx +765 -0
- package/src/components/field/index.ts +20 -0
- package/src/components/field-pair/FieldPair.mdx +308 -0
- package/src/components/field-pair/FieldPair.stories.tsx +530 -0
- package/src/components/field-pair/FieldPair.tsx +796 -0
- package/src/components/field-pair/index.ts +9 -0
- package/src/components/file-upload/FileUpload.mdx +345 -0
- package/src/components/file-upload/FileUpload.stories.tsx +698 -0
- package/src/components/file-upload/FileUpload.tsx +802 -0
- package/src/components/file-upload/index.ts +6 -0
- package/src/components/filter-chip/FilterChip.mdx +778 -0
- package/src/components/filter-chip/FilterChip.stories.tsx +827 -0
- package/src/components/filter-chip/FilterChip.tsx +881 -0
- package/src/components/filter-chip/index.ts +11 -0
- package/src/components/filter-facet/FilterFacet.mdx +536 -0
- package/src/components/filter-facet/FilterFacet.stories.tsx +506 -0
- package/src/components/filter-facet/FilterFacet.tsx +1160 -0
- package/src/components/filter-facet/index.ts +7 -0
- package/src/components/firm-avatar/FirmAvatar.mdx +280 -0
- package/src/components/firm-avatar/FirmAvatar.stories.tsx +147 -0
- package/src/components/firm-avatar/FirmAvatar.tsx +172 -0
- package/src/components/firm-avatar/index.ts +7 -0
- package/src/components/form-actions/FormActions.mdx +518 -0
- package/src/components/form-actions/FormActions.stories.tsx +621 -0
- package/src/components/form-actions/FormActions.tsx +273 -0
- package/src/components/form-actions/index.ts +6 -0
- package/src/components/form-block/FormBlock.mdx +728 -0
- package/src/components/form-block/FormBlock.stories.tsx +813 -0
- package/src/components/form-block/FormBlock.tsx +679 -0
- package/src/components/form-block/index.ts +13 -0
- package/src/components/form-section/FormSection.mdx +436 -0
- package/src/components/form-section/FormSection.stories.tsx +407 -0
- package/src/components/form-section/FormSection.tsx +290 -0
- package/src/components/form-section/index.ts +17 -0
- package/src/components/heading/Heading.mdx +206 -0
- package/src/components/heading/Heading.stories.tsx +169 -0
- package/src/components/heading/Heading.tsx +124 -0
- package/src/components/heading/index.ts +8 -0
- package/src/components/heading-group/HeadingGroup.mdx +521 -0
- package/src/components/heading-group/HeadingGroup.stories.tsx +353 -0
- package/src/components/heading-group/HeadingGroup.tsx +396 -0
- package/src/components/heading-group/index.ts +7 -0
- package/src/components/hero/Hero.mdx +742 -0
- package/src/components/hero/Hero.stories.tsx +527 -0
- package/src/components/hero/Hero.tsx +807 -0
- package/src/components/hero/index.ts +1 -0
- package/src/components/icon/Icon.mdx +329 -0
- package/src/components/icon/Icon.stories.tsx +398 -0
- package/src/components/icon/Icon.tsx +97 -0
- package/src/components/icon/index.ts +2 -0
- package/src/components/icon-button/IconButton.mdx +206 -0
- package/src/components/icon-button/IconButton.stories.tsx +341 -0
- package/src/components/icon-button/IconButton.tsx +273 -0
- package/src/components/icon-button/index.ts +1 -0
- package/src/components/item-row/ItemRow.mdx +533 -0
- package/src/components/item-row/ItemRow.stories.tsx +434 -0
- package/src/components/item-row/ItemRow.tsx +676 -0
- package/src/components/item-row/index.ts +9 -0
- package/src/components/list-row/ListRow.mdx +404 -0
- package/src/components/list-row/ListRow.stories.tsx +404 -0
- package/src/components/list-row/ListRow.tsx +424 -0
- package/src/components/list-row/index.ts +1 -0
- package/src/components/menu/Menu.mdx +268 -0
- package/src/components/menu/Menu.stories.tsx +455 -0
- package/src/components/menu/Menu.tsx +452 -0
- package/src/components/menu/index.ts +1 -0
- package/src/components/modal/Modal.mdx +854 -0
- package/src/components/modal/Modal.stories.tsx +881 -0
- package/src/components/modal/Modal.tsx +1434 -0
- package/src/components/modal/index.ts +1 -0
- package/src/components/nav-link/NavLink.mdx +196 -0
- package/src/components/nav-link/NavLink.stories.tsx +243 -0
- package/src/components/nav-link/NavLink.tsx +222 -0
- package/src/components/nav-link/index.ts +1 -0
- package/src/components/number-field/NumberField.mdx +223 -0
- package/src/components/number-field/NumberField.stories.tsx +291 -0
- package/src/components/number-field/NumberField.tsx +388 -0
- package/src/components/number-field/index.ts +6 -0
- package/src/components/pagination/Pagination.mdx +305 -0
- package/src/components/pagination/Pagination.stories.tsx +333 -0
- package/src/components/pagination/Pagination.tsx +343 -0
- package/src/components/pagination/index.ts +8 -0
- package/src/components/popover-surface/PopoverSurface.mdx +158 -0
- package/src/components/popover-surface/PopoverSurface.stories.tsx +421 -0
- package/src/components/popover-surface/index.ts +1 -0
- package/src/components/progress-bar/ProgressBar.mdx +802 -0
- package/src/components/progress-bar/ProgressBar.stories.tsx +533 -0
- package/src/components/progress-bar/ProgressBar.tsx +654 -0
- package/src/components/progress-bar/index.ts +9 -0
- package/src/components/promo-sticker/PromoSticker.mdx +436 -0
- package/src/components/promo-sticker/PromoSticker.stories.tsx +363 -0
- package/src/components/promo-sticker/PromoSticker.tsx +313 -0
- package/src/components/promo-sticker/index.ts +7 -0
- package/src/components/promo-surface/PromoSurface.mdx +399 -0
- package/src/components/promo-surface/PromoSurface.stories.tsx +270 -0
- package/src/components/promo-surface/PromoSurface.tsx +305 -0
- package/src/components/promo-surface/index.ts +7 -0
- package/src/components/radio/Radio.mdx +243 -0
- package/src/components/radio/Radio.stories.tsx +307 -0
- package/src/components/radio/Radio.tsx +288 -0
- package/src/components/radio/index.ts +1 -0
- package/src/components/radio-group/RadioGroup.mdx +119 -0
- package/src/components/radio-group/RadioGroup.stories.tsx +225 -0
- package/src/components/radio-group/RadioGroup.tsx +139 -0
- package/src/components/radio-group/index.ts +1 -0
- package/src/components/select/Select.mdx +241 -0
- package/src/components/select/Select.stories.tsx +404 -0
- package/src/components/select/Select.tsx +381 -0
- package/src/components/select/index.ts +1 -0
- package/src/components/select-field/SelectField.mdx +324 -0
- package/src/components/select-field/SelectField.stories.tsx +460 -0
- package/src/components/select-field/SelectField.tsx +138 -0
- package/src/components/select-field/index.ts +1 -0
- package/src/components/skeleton/Skeleton.mdx +194 -0
- package/src/components/skeleton/Skeleton.stories.tsx +260 -0
- package/src/components/skeleton/Skeleton.tsx +107 -0
- package/src/components/skeleton/index.ts +1 -0
- package/src/components/split-button/SplitButton.mdx +445 -0
- package/src/components/split-button/SplitButton.stories.tsx +465 -0
- package/src/components/split-button/SplitButton.tsx +361 -0
- package/src/components/split-button/index.ts +7 -0
- package/src/components/status-summary-bar/StatusSummaryBar.mdx +338 -0
- package/src/components/status-summary-bar/StatusSummaryBar.stories.tsx +408 -0
- package/src/components/status-summary-bar/StatusSummaryBar.tsx +428 -0
- package/src/components/status-summary-bar/index.ts +8 -0
- package/src/components/subject-lookup-field/SubjectLookupField.mdx +378 -0
- package/src/components/subject-lookup-field/SubjectLookupField.stories.tsx +393 -0
- package/src/components/subject-lookup-field/SubjectLookupField.tsx +1079 -0
- package/src/components/subject-lookup-field/index.ts +11 -0
- package/src/components/switch/Switch.mdx +376 -0
- package/src/components/switch/Switch.stories.tsx +296 -0
- package/src/components/switch/Switch.tsx +483 -0
- package/src/components/switch/index.ts +1 -0
- package/src/components/table/Table.mdx +575 -0
- package/src/components/table/Table.stories.tsx +1049 -0
- package/src/components/table/Table.tsx +745 -0
- package/src/components/table/TableConsumers.stories.tsx +195 -0
- package/src/components/table/_tableFixtures.ts +1189 -0
- package/src/components/table/index.ts +22 -0
- package/src/components/text-field/TextField.mdx +479 -0
- package/src/components/text-field/TextField.stories.tsx +366 -0
- package/src/components/text-field/TextField.tsx +391 -0
- package/src/components/text-field/index.ts +8 -0
- package/src/components/text-link/TextLink.mdx +353 -0
- package/src/components/text-link/TextLink.stories.tsx +458 -0
- package/src/components/text-link/TextLink.tsx +504 -0
- package/src/components/text-link/index.ts +10 -0
- package/src/components/textarea/Textarea.mdx +244 -0
- package/src/components/textarea/Textarea.stories.tsx +371 -0
- package/src/components/textarea/Textarea.tsx +489 -0
- package/src/components/textarea/index.ts +9 -0
- package/src/components/tooltip/Tooltip.mdx +462 -0
- package/src/components/tooltip/Tooltip.stories.tsx +500 -0
- package/src/components/tooltip/Tooltip.tsx +756 -0
- package/src/components/tooltip/index.ts +13 -0
- package/src/components/unit-field/UnitField.mdx +215 -0
- package/src/components/unit-field/UnitField.stories.tsx +291 -0
- package/src/components/unit-field/UnitField.tsx +255 -0
- package/src/components/unit-field/index.ts +7 -0
- package/src/icons/icon-registry.generated.ts +510 -0
- package/src/icons/icon-types.generated.ts +256 -0
- package/src/index.ts +71 -0
- package/src/internal/BottomSheet.tsx +714 -0
- package/src/internal/FodsProvider.tsx +36 -0
- package/src/internal/MotionCaret.tsx +53 -0
- package/src/internal/NumberFormatInput.tsx +276 -0
- package/src/internal/SummaryDonut.tsx +359 -0
- package/src/internal/buttonSegment.ts +241 -0
- package/src/internal/collapseRoom.ts +130 -0
- package/src/internal/comboboxKeys.ts +90 -0
- package/src/internal/contentPresence.ts +46 -0
- package/src/internal/dayCell.ts +274 -0
- package/src/internal/dialogPortal.ts +50 -0
- package/src/internal/donutSweeps.ts +77 -0
- package/src/internal/enterOnViewGeometry.ts +53 -0
- package/src/internal/faqItem.ts +104 -0
- package/src/internal/floatingLabelMotion.tsx +109 -0
- package/src/internal/formBlockContext.ts +27 -0
- package/src/internal/heightRoom.ts +135 -0
- package/src/internal/numberSeparators.ts +93 -0
- package/src/internal/overlayMotion.tsx +32 -0
- package/src/internal/paginationItem.ts +106 -0
- package/src/internal/popoverSurface.ts +78 -0
- package/src/internal/portalContainer.ts +11 -0
- package/src/internal/progressBarItem.ts +356 -0
- package/src/internal/selectionControlText.ts +42 -0
- package/src/internal/statusSummaryParts.tsx +475 -0
- package/src/internal/summaryMotion.ts +111 -0
- package/src/internal/table/ChildConnector.tsx +57 -0
- package/src/internal/table/ChildRowPrefix.tsx +21 -0
- package/src/internal/table/ColumnSettings.tsx +194 -0
- package/src/internal/table/ScrollRegion.tsx +176 -0
- package/src/internal/table/TableEmpty.tsx +99 -0
- package/src/internal/table/TableLayout.tsx +29 -0
- package/src/internal/table/TableLoadStatus.tsx +60 -0
- package/src/internal/table/TableMobile.tsx +582 -0
- package/src/internal/table/TruncatedCell.tsx +35 -0
- package/src/internal/table/emptyValue.ts +11 -0
- package/src/internal/table/features.ts +44 -0
- package/src/internal/table/recipes.ts +263 -0
- package/src/internal/table/rowClick.ts +8 -0
- package/src/internal/table/types.ts +342 -0
- package/src/internal/tailwind-variants.ts +65 -0
- package/src/internal/tooltipContext.ts +15 -0
- package/src/internal/tw-merge-config.generated.ts +275 -0
- package/src/internal/useAnchoredPanel.ts +340 -0
- package/src/internal/useCountUp.ts +65 -0
- package/src/internal/useDateFieldTrigger.tsx +357 -0
- package/src/internal/useEChart.ts +88 -0
- package/src/internal/useEnterOnView.ts +80 -0
- package/src/internal/useFloatingBar.ts +125 -0
- package/src/internal/useFormReset.ts +47 -0
- package/src/internal/useIsMobile.ts +64 -0
- package/src/internal/useNoImplicitSubmit.ts +41 -0
- package/src/internal/useOneRowOverflow.ts +103 -0
- package/src/internal/usePrefersReducedMotion.ts +27 -0
- package/src/internal/useReturnFocus.ts +34 -0
- package/src/internal/utils.ts +58 -0
- package/src/recipes/EmptyState.stories.tsx +105 -0
- package/src/recipes/Form.stories.tsx +355 -0
- package/src/recipes/ModalWithForm.stories.tsx +219 -0
- package/src/recipes/Recipes.mdx +61 -0
- package/src/recipes/TableWithFilters.stories.tsx +278 -0
- package/src/storybook/FodsFamily.tsx +39 -0
- package/src/storybook/Section.tsx +36 -0
- package/src/storybook/a11y.ts +24 -0
- package/src/storybook/assets/banner-character-bartender.webp +0 -0
- package/src/storybook/assets/banner-invoice-sheet-left.webp +0 -0
- package/src/storybook/assets/banner-invoice-sheet-right.webp +0 -0
- package/src/storybook/assets/invoice-hero.webp +0 -0
- package/src/storybook/assets/invoice.webp +0 -0
- package/src/storybook/assets/section-document-info.svg +21 -0
- package/src/storybook/assets/section-gear-checklist.svg +11 -0
- package/src/storybook/assets/section-person-arrow-in.svg +15 -0
- package/src/storybook/assets/section-person-arrow-out.svg +22 -0
- package/src/storybook/assets/section-receipt-dollar.svg +23 -0
- package/src/storybook/assets/table-empty-folder-empty.png +0 -0
- package/src/storybook/assets/table-empty-folder-magnifying-glass.png +0 -0
- package/src/storybook/assets/table-empty-funnel.png +0 -0
- package/src/storybook/assets/table-empty-load-failed.png +0 -0
- package/src/storybook/assets/wallet-spot.png +0 -0
- package/src/storybook/assets.d.ts +17 -0
- package/src/storybook/componentDoc.ts +41 -0
- package/src/storybook/fitFrame.tsx +70 -0
- package/src/storybook/forceStates.tsx +647 -0
- package/src/storybook/illustrations.tsx +66 -0
- package/src/storybook/viewportFrame.tsx +58 -0
- package/src/styles/assets/label-brush-1.svg +6 -0
- package/src/styles/assets/pattern-dark.svg +113 -0
- package/src/styles/base.css +106 -0
- package/src/styles/index.css +15 -0
- package/src/styles/motion.css +157 -0
- package/src/styles/promo-sticker.css +27 -0
- package/src/styles/promo-surface.css +49 -0
- package/src/styles/shared.css +11 -0
- package/src/styles/theme.generated.css +314 -0
- package/src/styles/theme.map.json +278 -0
- package/src/styles/tracking.generated.css +12 -0
- package/src/tokens/index.ts +4 -0
- package/src/tokens/tokens.generated.ts +542 -0
|
@@ -0,0 +1,654 @@
|
|
|
1
|
+
"use client";
|
|
2
|
+
import * as React from 'react';
|
|
3
|
+
import { flushSync } from 'react-dom';
|
|
4
|
+
import { tv } from '../../internal/tailwind-variants';
|
|
5
|
+
import {
|
|
6
|
+
progressBarItemVariants,
|
|
7
|
+
type ProgressBarItemLayout,
|
|
8
|
+
type ProgressBarItemSize,
|
|
9
|
+
type ProgressBarItemState,
|
|
10
|
+
type ProgressBarItemVariant,
|
|
11
|
+
} from '../../internal/progressBarItem';
|
|
12
|
+
import { cn } from '../../internal/utils';
|
|
13
|
+
|
|
14
|
+
/**
|
|
15
|
+
* Phosphor `check-circle` (regular), drawn at the ring's diameter — Done's marker glyph.
|
|
16
|
+
* Circle outline and check are ONE path coloured as a unit through `currentColor`, which
|
|
17
|
+
* is what `families[].states.done.icon` describes.
|
|
18
|
+
*
|
|
19
|
+
* NOT a systemic gap any more: `<Icon name="check-circle" />` renders this exact
|
|
20
|
+
* Phosphor drawing as an SVG. It stays inline for a GEOMETRY reason, not an
|
|
21
|
+
* availability one. `size-full` makes the glyph exactly the ring's diameter by
|
|
22
|
+
* construction, which is what `sizes[].note` ("the same Ø as the ring, so the markers
|
|
23
|
+
* keep one baseline") asks for. An `Icon` is sized as a `--size-icon*` slot box, and
|
|
24
|
+
* the drawing fills only 0.82 of that box, so matching the ring would mean writing
|
|
25
|
+
* the 24 / 22 diameters a second time as a glyph size next to the recipe that already owns
|
|
26
|
+
* them — a duplicated magic number where there is none today. Revisit if the marker ever
|
|
27
|
+
* gets a real icon slot in `internal/progressBarItem.ts`.
|
|
28
|
+
*/
|
|
29
|
+
const CHECK_CIRCLE_PATH =
|
|
30
|
+
'M173.66,98.34a8,8,0,0,1,0,11.32l-56,56a8,8,0,0,1-11.32,0l-24-24a8,8,0,0,1,11.32-11.32L112,148.69l50.34-50.35A8,8,0,0,1,173.66,98.34ZM232,128A104,104,0,1,1,128,24,104.11,104.11,0,0,1,232,128Zm-16,0a88,88,0,1,0-88,88A88.1,88.1,0,0,0,216,128Z';
|
|
31
|
+
|
|
32
|
+
/**
|
|
33
|
+
* The pointer callout's rounded-corner triangle, pointing DOWN at the marker. Decorative —
|
|
34
|
+
* the callout's meaning is carried by the label text next to it.
|
|
35
|
+
*
|
|
36
|
+
* The path was traced from a marketing-artboard instance (11.7965 × 8.36064) and normalised
|
|
37
|
+
* into this 12 × 9 viewBox. The FODS master is 16 × 12 and constant across both sizes
|
|
38
|
+
* (`parts.pointer-label.note`), so the RENDERED size comes from `pointerArrow` in
|
|
39
|
+
* `internal/progressBarItem.ts`, not from the viewBox: 12 : 9 and 16 : 12 are the same 4 : 3,
|
|
40
|
+
* so the box scales the traced path exactly, with no redraw.
|
|
41
|
+
*/
|
|
42
|
+
const POINTER_ARROW_PATH =
|
|
43
|
+
'M5.106 8.61a1.13 1.13 0 0 0 1.585 0l4.896-6.36c.506-.658.037-1.61-.793-1.61H1.002c-.83 0-1.299.952-.793 1.61z';
|
|
44
|
+
|
|
45
|
+
/**
|
|
46
|
+
* ProgressBar — a multi-step progress indicator (spec 04-molecules/progress-bar.md,
|
|
47
|
+
* manifest progress-bar.manifest.json 1.11.1; the step is the private
|
|
48
|
+
* _progress-bar-item.manifest.json 3.4.0, whose recipe lives in
|
|
49
|
+
* `internal/progressBarItem.ts`).
|
|
50
|
+
*
|
|
51
|
+
* One continuous rail behind self-describing markers, filled up to the Current step. Use
|
|
52
|
+
* it for a fixed, ordered sequence whose position must be visible at a glance — a wizard
|
|
53
|
+
* step band (Small) or a marketing rollout narrative (Large). NOT for paging a result set
|
|
54
|
+
* (→ Pagination), NOT for a percentage or indeterminate load (it has no such mode), NOT
|
|
55
|
+
* for independent actions (→ Button Group).
|
|
56
|
+
*
|
|
57
|
+
* ─── The bar owns ONE track ───────────────────────────────────────────────────
|
|
58
|
+
*
|
|
59
|
+
* `intent.rules[0]`: the rail and the fill belong to the BAR, never to the steps. That is
|
|
60
|
+
* the whole reason the v1 shape (StepperItem with per-item connector halves) is retired —
|
|
61
|
+
* a single element can slide forward, N joined segments cannot. Track and fill are two
|
|
62
|
+
* absolutely positioned elements rendered BEFORE the step list — as a SIBLING of the
|
|
63
|
+
* `<ol>`, never inside it, so the list holds the steps and nothing else — and the paint
|
|
64
|
+
* order comes out rail → fill → halo → marker from DOM order alone (`delivery.react`).
|
|
65
|
+
* The only `z-index` in the bar is the Done wash's `::before` layer (`-z-10`), scoped
|
|
66
|
+
* by the root's `isolate` so it paints under the rail and never escapes the bar.
|
|
67
|
+
*
|
|
68
|
+
* Progress is expressed entirely through the children: everything before `currentStep` is
|
|
69
|
+
* Done, `currentStep` is Current, everything after is Upcoming. The fill length is derived
|
|
70
|
+
* from that invariant — `(currentStep / (stepCount − 1)) * 100%` — and is never settable
|
|
71
|
+
* on its own. At the 2-step floor the two valid renders (0% and 100%) are correct results
|
|
72
|
+
* of that formula, not edge cases (`intent.rules[5]`).
|
|
73
|
+
*
|
|
74
|
+
* ─── Rail geometry: measured from real marker CENTRES ─────────────────────────
|
|
75
|
+
*
|
|
76
|
+
* `motion.states.value.note`, verbatim: "Measure the rail's ends from the real marker centres,
|
|
77
|
+
* not from a halo-derived inset: a titled step is as wide as its text, so a halo-based
|
|
78
|
+
* inset leaves the rail sticking out past the first marker."
|
|
79
|
+
*
|
|
80
|
+
* Both layouts get that from CSS grid, with no measurement and no JS. The grid is owned
|
|
81
|
+
* by the root wrapper; the `<ol>` spans it and takes over its tracks through `subgrid`,
|
|
82
|
+
* so the steps sit in the wrapper's tracks while the track — the `<ol>`'s sibling — is
|
|
83
|
+
* placed into the same grid areas as before. `subgrid`, not `display: contents`: the
|
|
84
|
+
* Row → Stack fallback measures real boxes, and a `contents` list has none (older WebKit
|
|
85
|
+
* also drops its list role).
|
|
86
|
+
*
|
|
87
|
+
* - Row — N equal columns (`gridTemplateColumns: repeat(N, minmax(0, 1fr))`), each marker
|
|
88
|
+
* horizontally centred in its own column, so the first and last marker centres sit
|
|
89
|
+
* exactly half a column in from each edge: `left = right = 50 / N %`. The track is an
|
|
90
|
+
* ABSOLUTELY positioned grid child placed into the grid area `1 / -1` of row 1 — a grid
|
|
91
|
+
* area is the containing block for an abspos grid child, which is what makes the
|
|
92
|
+
* percentage resolve against the steps' box (and keeps the rail inside the pointer's top
|
|
93
|
+
* padding instead of measuring from the border edge).
|
|
94
|
+
*
|
|
95
|
+
* - Stack — N rows; the marker is at the top of its step, so its centre is half a marker
|
|
96
|
+
* box below the step's top edge. The track is placed in grid area `1 / N`, then `top:
|
|
97
|
+
* box/2` walks its head onto the first marker's centre and a negative `bottom` walks its
|
|
98
|
+
* tail onto the last one's. That bottom inset is `−(row gap + box/2)`, NOT `−box/2`: a
|
|
99
|
+
* grid area ending on line N reaches the END of track N−1, and the last track starts one
|
|
100
|
+
* GUTTER further down — so the rail would otherwise stop --space-200 short of the last
|
|
101
|
+
* marker, at every step count. The gap term stays a `calc()` on the token so the rail
|
|
102
|
+
* follows a retune of the row gap instead of silently drifting.
|
|
103
|
+
*
|
|
104
|
+
* Halving the marker BOX (13 / 12), not the halo: the halo is centred on the box and only
|
|
105
|
+
* describes how much air the rail loses at each marker, never where the centre is.
|
|
106
|
+
*
|
|
107
|
+
* ─── Motion ───────────────────────────────────────────────────────────────────
|
|
108
|
+
*
|
|
109
|
+
* The fill transitions `width` (Row) / `height` (Stack) over --duration-normal with
|
|
110
|
+
* --easing-standard. `motion` calls this the deliberate exception to the
|
|
111
|
+
* transform-and-opacity-only rule: the fill's ENDS carry the meaning (it must stop exactly
|
|
112
|
+
* on a marker centre) and a scaled transform would distort the --radius-200 cap.
|
|
113
|
+
*
|
|
114
|
+
* The arriving Current dot fades in (opacity 0 → 1, no scale) over --duration-fast on
|
|
115
|
+
* --easing-enter, delayed by (normal − fast) so it lands exactly as the fill arrives
|
|
116
|
+
* (`_progress-bar-item` 3.4.1 `motion.states.value`, inherited by the bar). It is a named keyframe, not a
|
|
117
|
+
* transition, because the dot is a newly MOUNTED element on every step change — and it is
|
|
118
|
+
* armed only after the first `currentStep` change, since "a mounted bar renders its
|
|
119
|
+
* position with no animation" (`motion.trigger`).
|
|
120
|
+
*
|
|
121
|
+
* Under prefers-reduced-motion both are KEPT and shortened to --duration-instant, never
|
|
122
|
+
* removed: a progress indicator is essential motion, and a frozen bar is indistinguishable
|
|
123
|
+
* from a stalled one (`motion.reducedMotion`).
|
|
124
|
+
*
|
|
125
|
+
* ─── Row ↔ Stack: the bar's own content-fit fallback (1.9.0) ─────────────────
|
|
126
|
+
*
|
|
127
|
+
* `layout` is the PREFERRED layout, not a breakpoint. Given Row, the bar renders Row,
|
|
128
|
+
* measures real overflow of its own root (`scrollWidth > clientWidth`) and falls back to
|
|
129
|
+
* Stack by itself — the same principle as 06-patterns/responsive-collapse.md
|
|
130
|
+
* (`delivery.react`: "A consumer passes the preferred Layout and never has to wire the
|
|
131
|
+
* fallback"). `_progress-bar-item` `sizes[].minWidthWhen` (150 on a step with text) is the
|
|
132
|
+
* clip floor that makes that measurement fire. The question is only ever asked in Row —
|
|
133
|
+
* asked while stacked it would always answer "fits" and the bar could never go back — so
|
|
134
|
+
* every width change of the PARENT re-renders Row once and measures it before paint. The
|
|
135
|
+
* parent, not the root: a stacked bar may be content-sized (`max-w-fit`) and then never
|
|
136
|
+
* resizes. The rendered layout is published as `data-layout` for consumer styling. DOM
|
|
137
|
+
* order is sequence order in both layouts, so `aria-current` needs no per-layout
|
|
138
|
+
* special-casing.
|
|
139
|
+
*
|
|
140
|
+
* ─── Done steps are the only interactive element ──────────────────────────────
|
|
141
|
+
*
|
|
142
|
+
* `_progress-bar-item` 3.0.0 gave the step an Interaction axis (Default · Hover · Active)
|
|
143
|
+
* on State=Done: a completed step is a button that returns the flow to it. Current and
|
|
144
|
+
* Upcoming stay inert — a user cannot skip ahead — the bar itself never holds focus, and
|
|
145
|
+
* nothing here takes `disabled`. The ring attaches to the step's own button (manifest
|
|
146
|
+
* `focus`), NOT at this level as the pre-3.0.0 comment here predicted.
|
|
147
|
+
*
|
|
148
|
+
* It is OPT-IN, through `onStepClick` (manifest 1.10.0, `_progress-bar-item` 3.1.0): a
|
|
149
|
+
* product wizard wires the return; a marketing timeline (the e-invoice rollout) renders
|
|
150
|
+
* Done static — no button, no hover / press wash, no focus stop. Without the callback the
|
|
151
|
+
* markup is exactly what shipped before 3.0.0.
|
|
152
|
+
*
|
|
153
|
+
* ─── Accessibility (spec § Accessibility) ─────────────────────────────────────
|
|
154
|
+
*
|
|
155
|
+
* `<ol>` + one `<li>` per step carries the sequence; `aria-current="step"` marks the
|
|
156
|
+
* Current one. Marker, halo, ring and glyph are decorative and `aria-hidden` — a step's
|
|
157
|
+
* accessible name is its Title. In the bare-marker mode (both text booleans off) there is
|
|
158
|
+
* no Title to draw that name from, so `stepLabels` becomes REQUIRED through the props
|
|
159
|
+
* union and renders visually hidden: `aria-current` alone does not let a screen-reader
|
|
160
|
+
* user place themselves in the sequence. A step that merely omits its `title` under the
|
|
161
|
+
* default `showTitle` is outside what the union can see, so it gets a dev-only warning
|
|
162
|
+
* when no `stepLabels` entry covers it — a clickable Done step would otherwise be a
|
|
163
|
+
* nameless button. State is coded by marker SHAPE as well as colour
|
|
164
|
+
* (check / ring / ring + digit), so it survives a grayscale rendering.
|
|
165
|
+
*
|
|
166
|
+
* SIX sub-AA ratios here are REGISTERED upstream exceptions, not oversights — do not
|
|
167
|
+
* re-derive or "fix" them. accessibility.md carries one named section per case:
|
|
168
|
+
* the Upcoming digit's --text-placeholder (2.71:1, decorative-duplicated), the Orange
|
|
169
|
+
* fill (2.37:1 / 1.79:1, confined to the marketing slots), the --outline-default rail
|
|
170
|
+
* (1.32:1 — the rail is ground, not a signal), the pointer callout's --primary label
|
|
171
|
+
* and arrow (2.37:1, `Show pointer` defaults off outside marketing) and the Upcoming
|
|
172
|
+
* ring's --outline-strong (1.73:1, same token and reasoning as the resting control &
|
|
173
|
+
* field edge border) and the Done step's --bg-hover / --bg-active wash (cursor and focus
|
|
174
|
+
* ring duplicate the state).
|
|
175
|
+
*/
|
|
176
|
+
const progressBarVariants = tv({
|
|
177
|
+
slots: {
|
|
178
|
+
/**
|
|
179
|
+
* The wrapper: owns the grid in both layouts and is the positioning context for the
|
|
180
|
+
* track. `isolate` scopes the Done wash — a `-z-10` pseudo on the step button, see
|
|
181
|
+
* `internal/progressBarItem.ts` — to the bar, so it paints under the rail.
|
|
182
|
+
*/
|
|
183
|
+
root: 'relative isolate grid',
|
|
184
|
+
/** The `<ol>`: the steps and nothing else, laid onto the root's tracks via `subgrid`. */
|
|
185
|
+
list: 'grid list-none',
|
|
186
|
+
/** The neutral rail (`parts.track`) — accent-independent, --outline-default in both accents. */
|
|
187
|
+
track: 'absolute rounded-200 bg-outline-default',
|
|
188
|
+
/**
|
|
189
|
+
* The progressed run (`parts.track-fill`) — same geometry as the rail, ending on the
|
|
190
|
+
* Current marker's centre. Its length is an inline percentage, see the header.
|
|
191
|
+
*/
|
|
192
|
+
fill: 'absolute rounded-200',
|
|
193
|
+
},
|
|
194
|
+
variants: {
|
|
195
|
+
size: {
|
|
196
|
+
lg: {},
|
|
197
|
+
sm: {},
|
|
198
|
+
},
|
|
199
|
+
layout: {
|
|
200
|
+
row: {
|
|
201
|
+
// Track 4px thick in both sizes (sizes[].note) = --space-200.
|
|
202
|
+
track: 'h-200',
|
|
203
|
+
fill: 'inset-y-0 left-0 transition-[width] duration-normal ease-standard motion-reduce:duration-instant',
|
|
204
|
+
},
|
|
205
|
+
stack: {
|
|
206
|
+
// Step pitch = the item's min-height 64 plus this --space-200 row gap.
|
|
207
|
+
root: 'gap-200',
|
|
208
|
+
track: 'w-200',
|
|
209
|
+
fill: 'inset-x-0 top-0 transition-[height] duration-normal ease-standard motion-reduce:duration-instant',
|
|
210
|
+
},
|
|
211
|
+
},
|
|
212
|
+
/** Manifest Accent. The rail stays neutral in both; only the fill takes the accent. */
|
|
213
|
+
variant: {
|
|
214
|
+
blue: { fill: 'bg-secondary-solid' },
|
|
215
|
+
orange: { fill: 'bg-primary' },
|
|
216
|
+
},
|
|
217
|
+
/**
|
|
218
|
+
* Row only: reserves the height the floating pointer callout occupies. Applied at the
|
|
219
|
+
* BAR level and driven by "any step has a pointer", never by which step is Current —
|
|
220
|
+
* otherwise every marker would jump by the reserve as the sequence advances.
|
|
221
|
+
*/
|
|
222
|
+
hasPointer: {
|
|
223
|
+
true: {},
|
|
224
|
+
false: {},
|
|
225
|
+
},
|
|
226
|
+
},
|
|
227
|
+
compoundVariants: [
|
|
228
|
+
// Row: the rail's centre line is the marker's centre line — box/2 minus half the
|
|
229
|
+
// rail's own 4px thickness, measured from the top of the steps' grid area.
|
|
230
|
+
{
|
|
231
|
+
layout: 'row',
|
|
232
|
+
size: 'lg',
|
|
233
|
+
class: {
|
|
234
|
+
// fods-lint-disable-next-line 11 = marker box 26 / 2 - rail 4 / 2, i.e. the rail centred on the Large marker centre line; a derived offset, not a spacing step
|
|
235
|
+
track: 'top-[11px]',
|
|
236
|
+
},
|
|
237
|
+
},
|
|
238
|
+
// Small: 24 / 2 − 2 = 10 = --space-450.
|
|
239
|
+
{ layout: 'row', size: 'sm', class: { track: 'top-450' } },
|
|
240
|
+
// Stack: same centring horizontally, plus the two ends walked onto the first and
|
|
241
|
+
// last marker centres (see the header). Large: box 26 → 11 / 13 / −13.
|
|
242
|
+
{
|
|
243
|
+
layout: 'stack',
|
|
244
|
+
size: 'lg',
|
|
245
|
+
class: {
|
|
246
|
+
track: [
|
|
247
|
+
// fods-lint-disable-next-line 11 = marker box 26 / 2 - rail 4 / 2 — the rail centred on the Large marker column
|
|
248
|
+
'left-[11px]',
|
|
249
|
+
// fods-lint-disable-next-line 13 = marker box 26 / 2 — the first marker's centre, measured from the step's top edge
|
|
250
|
+
'top-[13px]',
|
|
251
|
+
'-bottom-[calc(var(--space-200)_+_13px)]',
|
|
252
|
+
],
|
|
253
|
+
},
|
|
254
|
+
},
|
|
255
|
+
// Small: box 24 → 10 (--space-450) / 12 (--space-500) / −(gap + 12).
|
|
256
|
+
{
|
|
257
|
+
layout: 'stack',
|
|
258
|
+
size: 'sm',
|
|
259
|
+
class: { track: ['left-450', 'top-500', '-bottom-[calc(var(--space-200)_+_12px)]'] },
|
|
260
|
+
},
|
|
261
|
+
// 40px of clearance for the Caveat label plus its 9px arrow and 5px tip gap.
|
|
262
|
+
{ layout: 'row', hasPointer: true, class: { root: 'pt-1000' } },
|
|
263
|
+
],
|
|
264
|
+
defaultVariants: {
|
|
265
|
+
// properties[0].default = Small — the product wizard band is the common case;
|
|
266
|
+
// Large is the marketing/hero exception you opt into.
|
|
267
|
+
size: 'sm',
|
|
268
|
+
layout: 'row',
|
|
269
|
+
variant: 'blue',
|
|
270
|
+
hasPointer: false,
|
|
271
|
+
},
|
|
272
|
+
});
|
|
273
|
+
|
|
274
|
+
/** Manifest Size axis — `lg` = marketing / hero, `sm` = the product wizard band. */
|
|
275
|
+
export type ProgressBarSize = ProgressBarItemSize;
|
|
276
|
+
/** Manifest Layout axis — the PREFERRED layout; Row falls back to Stack when it overflows. */
|
|
277
|
+
export type ProgressBarLayout = ProgressBarItemLayout;
|
|
278
|
+
/** Manifest Accent axis — `orange` only in the four marketing / signature slots. */
|
|
279
|
+
export type ProgressBarVariant = ProgressBarItemVariant;
|
|
280
|
+
|
|
281
|
+
export interface ProgressBarStep {
|
|
282
|
+
/** Step label — short, active-voice, ~28 chars; wraps rather than truncates. */
|
|
283
|
+
title?: string;
|
|
284
|
+
/** One supporting line, ~55 chars, ellipsis past two lines. */
|
|
285
|
+
detail?: string;
|
|
286
|
+
/**
|
|
287
|
+
* Current-only marketing callout, e.g. "Jste tady". Row only — Stack masters carry no
|
|
288
|
+
* pointer node. A fixed short phrase in the hand-lettered marketing voice, never user
|
|
289
|
+
* content and never a wizard tone.
|
|
290
|
+
*/
|
|
291
|
+
pointerLabel?: string;
|
|
292
|
+
}
|
|
293
|
+
|
|
294
|
+
export interface ProgressBarBaseProps
|
|
295
|
+
extends Omit<React.HTMLAttributes<HTMLDivElement>, 'children'> {
|
|
296
|
+
/**
|
|
297
|
+
* The sequence, 2–6 steps (`intent.variants`). Content, not a variant: there is no
|
|
298
|
+
* Steps axis. Below 2 there is no progression to show and the fill renders 0%.
|
|
299
|
+
*/
|
|
300
|
+
steps: ProgressBarStep[];
|
|
301
|
+
/**
|
|
302
|
+
* 0-based index of the Current step. Everything before it is Done, everything after is
|
|
303
|
+
* Upcoming, and the fill length follows — exactly one Current per bar.
|
|
304
|
+
*/
|
|
305
|
+
currentStep: number;
|
|
306
|
+
size?: ProgressBarSize;
|
|
307
|
+
/**
|
|
308
|
+
* The preferred layout. Row falls back to Stack on its own whenever it overflows the
|
|
309
|
+
* available width (1.9.0) — never wire the fallback in the consumer. Stack is final.
|
|
310
|
+
*/
|
|
311
|
+
layout?: ProgressBarLayout;
|
|
312
|
+
variant?: ProgressBarVariant;
|
|
313
|
+
/** Figma `Show title`. Off + `showDetail` off = the bare-marker wizard band. */
|
|
314
|
+
showTitle?: boolean;
|
|
315
|
+
/** Figma `Show detail`. */
|
|
316
|
+
showDetail?: boolean;
|
|
317
|
+
/**
|
|
318
|
+
* Figma `Show number` (`properties[Show number].maps`), code-only on the bar: it covers
|
|
319
|
+
* every Upcoming step at once, because Figma cannot bind a parent boolean to a nested
|
|
320
|
+
* instance's property. Off leaves the neutral ring EMPTY at the same size — Current keeps
|
|
321
|
+
* its centre dot, so the states still differ by shape rather than by colour alone.
|
|
322
|
+
*/
|
|
323
|
+
showNumbers?: boolean;
|
|
324
|
+
/**
|
|
325
|
+
* Makes every Done step a button that calls back with its 0-based index
|
|
326
|
+
* (`_progress-bar-item` 3.0.0 Interaction). Current and Upcoming never become
|
|
327
|
+
* interactive, whatever this is set to.
|
|
328
|
+
*
|
|
329
|
+
* Opt-in on purpose: the manifest states the button unconditionally because it
|
|
330
|
+
* describes a wizard, but a bar that narrates a fixed timeline has nowhere to jump
|
|
331
|
+
* back to, and buttons there are dead tab stops. Omit it and the step renders
|
|
332
|
+
* exactly as it did before 3.0.0.
|
|
333
|
+
*/
|
|
334
|
+
onStepClick?: (index: number) => void;
|
|
335
|
+
}
|
|
336
|
+
|
|
337
|
+
/**
|
|
338
|
+
* `stepLabels` is REQUIRED once the Title is hidden — enforced in the type rather than at
|
|
339
|
+
* runtime, the same shape `FilterChipProps` uses for its clear-button name. Spec
|
|
340
|
+
* § Accessibility: "In the bare-marker mode (Small × Row, both text booleans off) there is
|
|
341
|
+
* no Title to draw that name from, so the consumer must supply a visually-hidden ordinal
|
|
342
|
+
* label per step." The design system is locale-agnostic — these strings come from the
|
|
343
|
+
* consumer's own translations ("Krok 1", "Step 1", …), never from a default here.
|
|
344
|
+
*/
|
|
345
|
+
export type ProgressBarProps = ProgressBarBaseProps &
|
|
346
|
+
(
|
|
347
|
+
| { showTitle?: true; stepLabels?: string[] }
|
|
348
|
+
| { showTitle: false; stepLabels: string[] }
|
|
349
|
+
);
|
|
350
|
+
|
|
351
|
+
const ProgressBar = React.forwardRef<HTMLDivElement, ProgressBarProps>(
|
|
352
|
+
(
|
|
353
|
+
{
|
|
354
|
+
className,
|
|
355
|
+
style,
|
|
356
|
+
steps,
|
|
357
|
+
currentStep,
|
|
358
|
+
size = 'sm',
|
|
359
|
+
layout = 'row',
|
|
360
|
+
variant = 'blue',
|
|
361
|
+
showTitle = true,
|
|
362
|
+
showDetail = true,
|
|
363
|
+
showNumbers = true,
|
|
364
|
+
onStepClick,
|
|
365
|
+
stepLabels,
|
|
366
|
+
...props
|
|
367
|
+
},
|
|
368
|
+
ref,
|
|
369
|
+
) => {
|
|
370
|
+
/**
|
|
371
|
+
* The bloom is armed by the first `currentStep` CHANGE, never by mount: a bar that
|
|
372
|
+
* renders straight into step 3 must show step 3, not animate into it
|
|
373
|
+
* (`motion.trigger`). Once armed it stays armed — the animation itself re-plays on
|
|
374
|
+
* its own, because the arriving marker's dot is a fresh element every time.
|
|
375
|
+
*/
|
|
376
|
+
const seenStep = React.useRef(currentStep);
|
|
377
|
+
const [bloomArmed, setBloomArmed] = React.useState(false);
|
|
378
|
+
React.useEffect(() => {
|
|
379
|
+
if (seenStep.current === currentStep) return;
|
|
380
|
+
seenStep.current = currentStep;
|
|
381
|
+
setBloomArmed(true);
|
|
382
|
+
}, [currentStep]);
|
|
383
|
+
|
|
384
|
+
const rootRef = React.useRef<HTMLDivElement | null>(null);
|
|
385
|
+
const setRefs = React.useCallback(
|
|
386
|
+
(node: HTMLDivElement | null) => {
|
|
387
|
+
rootRef.current = node;
|
|
388
|
+
if (typeof ref === 'function') ref(node);
|
|
389
|
+
else if (ref) ref.current = node;
|
|
390
|
+
},
|
|
391
|
+
[ref],
|
|
392
|
+
);
|
|
393
|
+
|
|
394
|
+
/*
|
|
395
|
+
* Content-fit fallback, see the header. `measure` renders Row for one layout pass;
|
|
396
|
+
* the layout effect reads the overflow before paint and settles on Row or Stack.
|
|
397
|
+
* Re-measured on every width change of the parent, whenever the content changes and
|
|
398
|
+
* when a web font finishes loading.
|
|
399
|
+
*/
|
|
400
|
+
const [fit, setFit] = React.useState<'measure' | 'row' | 'stack'>('measure');
|
|
401
|
+
const contentKey = `${steps.map(step => `${step.title ?? ''}|${step.detail ?? ''}|${step.pointerLabel ?? ''}`).join('/')}|${size}|${String(showTitle)}|${String(showDetail)}`;
|
|
402
|
+
|
|
403
|
+
React.useLayoutEffect(() => {
|
|
404
|
+
setFit('measure');
|
|
405
|
+
}, [layout, contentKey]);
|
|
406
|
+
|
|
407
|
+
React.useLayoutEffect(() => {
|
|
408
|
+
if (fit !== 'measure' || layout !== 'row') return;
|
|
409
|
+
const root = rootRef.current;
|
|
410
|
+
setFit(root && root.scrollWidth > root.clientWidth ? 'stack' : 'row');
|
|
411
|
+
}, [fit, layout]);
|
|
412
|
+
|
|
413
|
+
React.useLayoutEffect(() => {
|
|
414
|
+
const host = rootRef.current?.parentElement;
|
|
415
|
+
if (layout !== 'row' || !host || typeof ResizeObserver === 'undefined') return undefined;
|
|
416
|
+
// Synchronous, so the Row probe and its verdict land in the same frame.
|
|
417
|
+
const remeasure = () => flushSync(() => setFit('measure'));
|
|
418
|
+
let lastWidth = host.clientWidth;
|
|
419
|
+
let frame: number | undefined;
|
|
420
|
+
const observer = new ResizeObserver(() => {
|
|
421
|
+
if (host.clientWidth === lastWidth) return;
|
|
422
|
+
lastWidth = host.clientWidth;
|
|
423
|
+
// Deferred to the next frame: the probe changes the host's height, and doing that
|
|
424
|
+
// inside the observer callback trips "ResizeObserver loop completed with
|
|
425
|
+
// undelivered notifications".
|
|
426
|
+
if (frame !== undefined) cancelAnimationFrame(frame);
|
|
427
|
+
frame = requestAnimationFrame(() => {
|
|
428
|
+
frame = undefined;
|
|
429
|
+
remeasure();
|
|
430
|
+
});
|
|
431
|
+
});
|
|
432
|
+
observer.observe(host);
|
|
433
|
+
// A web font landing after the first probe widens the text without resizing the host.
|
|
434
|
+
const fonts = typeof document !== 'undefined' ? document.fonts : undefined;
|
|
435
|
+
fonts?.addEventListener('loadingdone', remeasure);
|
|
436
|
+
return () => {
|
|
437
|
+
observer.disconnect();
|
|
438
|
+
if (frame !== undefined) cancelAnimationFrame(frame);
|
|
439
|
+
fonts?.removeEventListener('loadingdone', remeasure);
|
|
440
|
+
};
|
|
441
|
+
}, [layout]);
|
|
442
|
+
|
|
443
|
+
const effectiveLayout: ProgressBarLayout = layout === 'row' && fit === 'stack' ? 'stack' : layout;
|
|
444
|
+
|
|
445
|
+
const stepCount = steps.length;
|
|
446
|
+
const lastIndex = stepCount - 1;
|
|
447
|
+
const activeStep = Math.min(Math.max(currentStep, 0), Math.max(lastIndex, 0));
|
|
448
|
+
|
|
449
|
+
// Indices of clickable Done steps whose `<button>` would have no accessible name:
|
|
450
|
+
// no visible Title, no visible detail, and no ordinal to stand in — the case the
|
|
451
|
+
// props union cannot express (a `title` missing under `showTitle`).
|
|
452
|
+
const unnamedSteps = onStepClick
|
|
453
|
+
? steps
|
|
454
|
+
.map((step, index) =>
|
|
455
|
+
index < activeStep &&
|
|
456
|
+
!(showTitle && step.title) &&
|
|
457
|
+
!(showDetail && step.detail) &&
|
|
458
|
+
!stepLabels?.[index]
|
|
459
|
+
? index
|
|
460
|
+
: -1,
|
|
461
|
+
)
|
|
462
|
+
.filter(index => index >= 0)
|
|
463
|
+
.join(', ')
|
|
464
|
+
: '';
|
|
465
|
+
React.useEffect(() => {
|
|
466
|
+
if (process.env.NODE_ENV === 'production' || !unnamedSteps) return;
|
|
467
|
+
// eslint-disable-next-line no-console
|
|
468
|
+
console.warn(
|
|
469
|
+
`ProgressBar: Done step(s) ${unnamedSteps} render as buttons with no title, no detail and no \`stepLabels\` entry, so they have no accessible name. Pass a \`stepLabels\` entry for every step without a visible title.`,
|
|
470
|
+
);
|
|
471
|
+
}, [unnamedSteps]);
|
|
472
|
+
// Guarded division: a single step has no rail to travel along (manifest floor is 2).
|
|
473
|
+
const fillPercent = lastIndex > 0 ? (activeStep / lastIndex) * 100 : 0;
|
|
474
|
+
|
|
475
|
+
const isRow = effectiveLayout === 'row';
|
|
476
|
+
// Reserved for the whole bar, not for the Current step — see the recipe's `hasPointer`.
|
|
477
|
+
const hasPointer = isRow && steps.some(step => Boolean(step.pointerLabel));
|
|
478
|
+
|
|
479
|
+
const slots = progressBarVariants({ size, layout: effectiveLayout, variant, hasPointer });
|
|
480
|
+
|
|
481
|
+
return (
|
|
482
|
+
<div
|
|
483
|
+
ref={setRefs}
|
|
484
|
+
data-fods-component="progress-bar"
|
|
485
|
+
data-fods-part="root"
|
|
486
|
+
{...props}
|
|
487
|
+
data-layout={effectiveLayout}
|
|
488
|
+
className={cn(slots.root(), className)}
|
|
489
|
+
style={{
|
|
490
|
+
...(isRow
|
|
491
|
+
? { gridTemplateColumns: `repeat(${Math.max(stepCount, 1)}, minmax(0, 1fr))` }
|
|
492
|
+
: { gridTemplateRows: `repeat(${Math.max(stepCount, 1)}, auto)` }),
|
|
493
|
+
...style,
|
|
494
|
+
}}
|
|
495
|
+
>
|
|
496
|
+
{stepCount > 1 && (
|
|
497
|
+
<div
|
|
498
|
+
aria-hidden="true"
|
|
499
|
+
data-fods-part="track"
|
|
500
|
+
className={slots.track()}
|
|
501
|
+
style={
|
|
502
|
+
isRow
|
|
503
|
+
// Half a column in from each edge = the first / last marker's centre.
|
|
504
|
+
? { gridRow: 1, gridColumn: '1 / -1', left: `${50 / stepCount}%`, right: `${50 / stepCount}%` }
|
|
505
|
+
// Rows 1..N−1, i.e. down to the last step's top edge; the recipe's
|
|
506
|
+
// negative bottom inset walks it on to that step's marker centre.
|
|
507
|
+
: { gridColumn: 1, gridRow: `1 / ${stepCount}` }
|
|
508
|
+
}
|
|
509
|
+
>
|
|
510
|
+
<span
|
|
511
|
+
data-fods-part="track-fill"
|
|
512
|
+
className={slots.fill()}
|
|
513
|
+
style={isRow ? { width: `${fillPercent}%` } : { height: `${fillPercent}%` }}
|
|
514
|
+
/>
|
|
515
|
+
</div>
|
|
516
|
+
)}
|
|
517
|
+
|
|
518
|
+
<ol
|
|
519
|
+
// <ol> is the sequence semantics; `role="list"` keeps them in Safari, where
|
|
520
|
+
// `list-style: none` (Tailwind preflight) otherwise drops the list role.
|
|
521
|
+
role="list"
|
|
522
|
+
className={slots.list()}
|
|
523
|
+
style={
|
|
524
|
+
isRow
|
|
525
|
+
? { gridRow: 1, gridColumn: '1 / -1', gridTemplateColumns: 'subgrid' }
|
|
526
|
+
: { gridColumn: 1, gridRow: '1 / -1', gridTemplateRows: 'subgrid' }
|
|
527
|
+
}
|
|
528
|
+
>
|
|
529
|
+
|
|
530
|
+
{steps.map((step, index) => {
|
|
531
|
+
let state: ProgressBarItemState = 'upcoming';
|
|
532
|
+
if (index < activeStep) state = 'done';
|
|
533
|
+
else if (index === activeStep) state = 'current';
|
|
534
|
+
|
|
535
|
+
const titleVisible = showTitle && Boolean(step.title);
|
|
536
|
+
const detailVisible = showDetail && Boolean(step.detail);
|
|
537
|
+
|
|
538
|
+
const item = progressBarItemVariants({
|
|
539
|
+
size,
|
|
540
|
+
layout: effectiveLayout,
|
|
541
|
+
variant,
|
|
542
|
+
state,
|
|
543
|
+
bloom: bloomArmed && state === 'current',
|
|
544
|
+
// Row's 150 text floor rides on this: a marker-only step must not carry
|
|
545
|
+
// it, or the item outgrows its 1fr column and the rail — which measures
|
|
546
|
+
// from COLUMN centres — no longer lands on the markers. See the compound
|
|
547
|
+
// in internal/progressBarItem.ts.
|
|
548
|
+
hasText: titleVisible || detailVisible,
|
|
549
|
+
});
|
|
550
|
+
// The ordinal stands in for the Title whenever the Title is not rendered — that
|
|
551
|
+
// is the whole point of the type union above.
|
|
552
|
+
const ordinalLabel = titleVisible ? undefined : stepLabels?.[index];
|
|
553
|
+
// Row × Current only; Stack masters carry no pointer node (parts.pointer-label).
|
|
554
|
+
const pointerVisible = isRow && state === 'current' && Boolean(step.pointerLabel);
|
|
555
|
+
|
|
556
|
+
// Done alone is interactive (`properties[Interaction]`), and only where the
|
|
557
|
+
// consumer gave the click somewhere to go.
|
|
558
|
+
const clickable = state === 'done' && Boolean(onStepClick);
|
|
559
|
+
|
|
560
|
+
// The item's content is the same either way — what changes is whether a
|
|
561
|
+
// button wraps it. Naming it once keeps the two branches from drifting.
|
|
562
|
+
const content = (
|
|
563
|
+
<>
|
|
564
|
+
<span className={item.markerBox()}>
|
|
565
|
+
<span aria-hidden="true" data-fods-part="halo" className={item.halo()} />
|
|
566
|
+
<span aria-hidden="true" data-fods-part="marker" className={item.marker()}>
|
|
567
|
+
{state === 'done' && (
|
|
568
|
+
<svg viewBox="0 0 256 256" fill="currentColor" className="size-full">
|
|
569
|
+
<path d={CHECK_CIRCLE_PATH} />
|
|
570
|
+
</svg>
|
|
571
|
+
)}
|
|
572
|
+
{state === 'current' && (
|
|
573
|
+
<span data-fods-part="dot" className={item.dot()} />
|
|
574
|
+
)}
|
|
575
|
+
{state === 'upcoming' && showNumbers && (
|
|
576
|
+
<span data-fods-part="number" className={item.number()}>
|
|
577
|
+
{index + 1}
|
|
578
|
+
</span>
|
|
579
|
+
)}
|
|
580
|
+
</span>
|
|
581
|
+
{pointerVisible && (
|
|
582
|
+
<span data-fods-part="pointer-label" className={item.pointer()}>
|
|
583
|
+
<span className={item.pointerLabel()}>
|
|
584
|
+
{step.pointerLabel}
|
|
585
|
+
</span>
|
|
586
|
+
<svg
|
|
587
|
+
viewBox="0 0 12 9"
|
|
588
|
+
fill="currentColor"
|
|
589
|
+
aria-hidden="true"
|
|
590
|
+
className={item.pointerArrow()}
|
|
591
|
+
>
|
|
592
|
+
<path d={POINTER_ARROW_PATH} />
|
|
593
|
+
</svg>
|
|
594
|
+
</span>
|
|
595
|
+
)}
|
|
596
|
+
</span>
|
|
597
|
+
|
|
598
|
+
{/*
|
|
599
|
+
The visually-hidden ordinal sits OUTSIDE the text column: in bare-marker
|
|
600
|
+
mode that column would otherwise render as an empty flex box and add its
|
|
601
|
+
gap under every marker.
|
|
602
|
+
*/}
|
|
603
|
+
{ordinalLabel && <span className="sr-only">{ordinalLabel}</span>}
|
|
604
|
+
|
|
605
|
+
{(titleVisible || detailVisible) && (
|
|
606
|
+
<span className={item.text()}>
|
|
607
|
+
{titleVisible && (
|
|
608
|
+
<span data-fods-part="title" className={item.title()}>
|
|
609
|
+
{step.title}
|
|
610
|
+
</span>
|
|
611
|
+
)}
|
|
612
|
+
{detailVisible && (
|
|
613
|
+
<span data-fods-part="detail" className={item.detail()}>
|
|
614
|
+
{step.detail}
|
|
615
|
+
</span>
|
|
616
|
+
)}
|
|
617
|
+
</span>
|
|
618
|
+
)}
|
|
619
|
+
</>
|
|
620
|
+
);
|
|
621
|
+
|
|
622
|
+
return (
|
|
623
|
+
<li
|
|
624
|
+
key={index}
|
|
625
|
+
data-fods-part="step"
|
|
626
|
+
data-fods-state={state}
|
|
627
|
+
aria-current={state === 'current' ? 'step' : undefined}
|
|
628
|
+
// The `<li>` hands its layout to the button when there is one, so the
|
|
629
|
+
// wash and the ring wrap the whole item rather than a box inside it.
|
|
630
|
+
className={clickable ? item.stepCell() : item.step()}
|
|
631
|
+
>
|
|
632
|
+
{clickable ? (
|
|
633
|
+
<button
|
|
634
|
+
type="button"
|
|
635
|
+
data-fods-part="surface"
|
|
636
|
+
onClick={() => onStepClick?.(index)}
|
|
637
|
+
className={cn(item.step(), item.surface())}
|
|
638
|
+
>
|
|
639
|
+
{content}
|
|
640
|
+
</button>
|
|
641
|
+
) : (
|
|
642
|
+
content
|
|
643
|
+
)}
|
|
644
|
+
</li>
|
|
645
|
+
);
|
|
646
|
+
})}
|
|
647
|
+
</ol>
|
|
648
|
+
</div>
|
|
649
|
+
);
|
|
650
|
+
},
|
|
651
|
+
);
|
|
652
|
+
ProgressBar.displayName = 'ProgressBar';
|
|
653
|
+
|
|
654
|
+
export { ProgressBar, progressBarVariants };
|