@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,338 @@
|
|
|
1
|
+
import { Meta, Canvas, Controls } from '@storybook/addon-docs/blocks';
|
|
2
|
+
import * as StatusSummaryBarStories from './StatusSummaryBar.stories';
|
|
3
|
+
import { ViewportFrame } from '../../storybook/viewportFrame';
|
|
4
|
+
|
|
5
|
+
<Meta of={StatusSummaryBarStories} tags={['autodocs']} />
|
|
6
|
+
|
|
7
|
+
# StatusSummaryBar
|
|
8
|
+
|
|
9
|
+
## Metadata
|
|
10
|
+
|
|
11
|
+
- **Layer:** organism
|
|
12
|
+
- **Status:** draft
|
|
13
|
+
- **Manifest version:** `2.5.1`
|
|
14
|
+
- **Sub-component manifests:** `_summary-card` version `2.2.2` (the total card and its donut) · `_summary-cell` version `2.0.1` (one status cell)
|
|
15
|
+
- **Tokens used:** `--bg-active`, `--bg-hover`, `--bg-primary`, `--border-width-100`, `--border-width-200`, `--disabled-control`, `--disabled-foreground`, `--font-body`, `--font-heading`, `--font-size-base`, `--font-size-heading-h4`, `--font-size-lg`, `--font-size-md`, `--font-size-sm`, `--font-size-xs`, `--font-weight-normal`, `--font-weight-semibold`, `--leading-loose`, `--leading-relaxed`, `--leading-tight`, `--outline-default`, `--outline-focus`, `--primary-active`, `--primary-foreground`, `--primary-hover`, `--primary-solid`, `--radius-200`, `--radius-300`, `--radius-400`, `--radius-500`, `--secondary`, `--secondary-active`, `--secondary-foreground`, `--secondary-hover`, `--secondary-solid`, `--space-1000`, `--space-1100`, `--space-200`, `--space-300`, `--space-400`, `--space-500`, `--space-600`, `--space-700`, `--space-800`, `--space-900`, `--status-danger`, `--status-danger-active`, `--status-danger-foreground`, `--status-danger-hover`, `--status-danger-solid`, `--status-info-solid`, `--status-success-active`, `--status-success-foreground`, `--status-success-hover`, `--status-success-solid`, `--status-success-tint-foreground`, `--status-violet-solid`, `--status-warning-solid`, `--text-primary`, `--text-secondary`
|
|
16
|
+
|
|
17
|
+
The manifests are `spec/05-organisms/status-summary-bar.manifest.json`, `_summary-card.manifest.json` and `_summary-cell.manifest.json`; a bump of any of them re-opens the component per Definition of Done (e). The `Tokens used` line is traced by hand from the classes; the donut's colours are not in it because they are read in JS (see Anatomy → Donut).
|
|
18
|
+
|
|
19
|
+
## Overview
|
|
20
|
+
|
|
21
|
+
Status Summary Bar is the **filter-and-summary strip above a record list**: a bordered total card with a donut, then one filtering cell per document status. It answers two questions at once — how the total splits by status, and which statuses are currently in the table below.
|
|
22
|
+
|
|
23
|
+
**Use it** above a Table whose rows carry a status, when the list is long enough that the reader needs the shape of the whole set before reading any row. **Do not use it** as a general KPI or metric strip: every cell is a filter control bound to a status family, not a free-standing figure. A dashboard tile that only reports carries no checkbox and is not this organism.
|
|
24
|
+
|
|
25
|
+
Behaviour the component owns:
|
|
26
|
+
|
|
27
|
+
- **Filter** — every status ships **included**; pressing a cell **excludes** it (never an isolate gesture). The total card and the donut report the included set; a cell's own amount and count always describe its whole status.
|
|
28
|
+
- **Layout** — no density and no size axis: one total card, and each status cell **fills** between its widest child and 186px. A bar that fits one line spreads edge to edge; when the cells no longer fit one line the row wraps and every line is centred (see Sizes).
|
|
29
|
+
- **Amounts** are rounded to whole units before they reach `formatAmount` — total, cell and segment tooltip alike. Celkem is the sum of the **exact** amounts, rounded once, so it may differ by a few units from the sum of the cells on screen — that is the spec (`text.total-amount`), not a bug.
|
|
30
|
+
- **Motion** — the donut draws in once, on first render, segment by segment; every later change resizes the segments in place and never replays the draw-in (see States).
|
|
31
|
+
- **Collapse** hides everything but the toggle row; the filter stays applied. Collapsing, the card and cells fade out first (`--duration-fast` / `--easing-exit`), then their room closes on `--spring-gentle`; expanding, the room opens while they fade in (`--duration-slow` / `--easing-enter`). The caret turns 180° on `--spring-standard`. Under `prefers-reduced-motion` everything switches at once.
|
|
32
|
+
- **Below the `md` breakpoint** the bar becomes a list of rows — Celkem, then one row per status (the painted Chip with its checkbox and ⓘ on the left, amount on the right; no donut, no count, no collapse toggle), per the manifest's `chrome.mobile` (2.4.0). The rows share the filter, the total and the live announcement with the desktop cells. Touch has no hover, so on a row the ⓘ is its own button — a toggletip: a tap opens the status explanation and it stays open until a second tap, a tap outside or Escape; the tap never toggles the status. The switch is CSS only (`md:hidden` / `hidden md:grid`), so the server markup is the same at every width.
|
|
33
|
+
|
|
34
|
+
## Rationale
|
|
35
|
+
|
|
36
|
+
The organism is chrome and filling rules over composed atoms — a painted `Chip` per cell, two `Divider`s and a `Button` for the disclosure, the FODS `Tooltip` on the ring and on each cell. Its one structural rule is that **the whole cell, not the 16px checkbox inside it, is the control**, which makes a status both readable and tappable in the same gesture. Everything that varies between two lists (the statuses, their copy) is data, not a property.
|
|
37
|
+
|
|
38
|
+
Implementation decisions recorded here:
|
|
39
|
+
|
|
40
|
+
- **The donut is internal chrome, not a chart primitive.** FODS has no chart atom, so `internal/SummaryDonut.tsx` is not exported from the design-system barrel. The manifest backlog plans to extract it as its own atom the moment a second chart appears anywhere in FODS. It is drawn with ECharts, registered modularly (`echarts/core` + `PieChart` + `SVGRenderer` in `internal/useEChart.ts`) so only the pie series and the SVG renderer ship in the bundle — no ECharts tooltip component is registered.
|
|
41
|
+
- **Sweeps are computed, never authored.** `computeDonutSweeps` (`internal/donutSweeps.ts`) implements the manifest's `minimum-sweep` algorithm verbatim: size every non-zero segment proportionally, raise any segment below the floor **to** the floor and freeze it, redistribute the shortfall across the unfrozen segments in proportion, repeat. The floor is a **4px arc length at the ring's mid-radius** (`DONUT_MIN_ARC = 4`), so it re-derives with the box (≈6.82° at the 80px ring). A segment measures the **absolute exact** amount; a status that is excluded, or whose amount **displays** as 0 (a true zero, or under half a unit), draws no arc and never enters the pass; if the frozen floors alone would exceed 360° every segment is sized equally.
|
|
42
|
+
- **The segment tooltip is the FODS `Tooltip`, not the chart library's.** It follows the pointer while the pointer is over a segment, always placed above it (`_summary-card` 2.2.0 `chrome.donut.hover.tooltip`): ECharts' `mousemove` moves an invisible anchor to the pointer, and the bubble re-positions every frame (`updatePositionStrategy="always"`). It renders through `TooltipPortal`.
|
|
43
|
+
- **Motion binds to tokens** (`chrome.motion`). `getSummaryMotion()` (`internal/summaryMotion.ts`) parses the package tokens (`src/tokens/`): the amount count-up and the donut's in-place resize share `--duration-slow` × `--easing-standard`, so they run on one clock and one curve; the segment hover growth runs on `--duration-hover`; the one-off draw-in runs on `--easing-enter` with 350ms per segment and a 90ms stagger — plain constants, because the manifest gives them in ms and no token exists. The tokens are read on first use, not at module load, so a renamed token fails this organism rather than every design-system import.
|
|
44
|
+
- **No locale of its own.** All copy — labels, plural forms, money formatting, the live announcement — comes in through props.
|
|
45
|
+
|
|
46
|
+
## Anatomy
|
|
47
|
+
|
|
48
|
+
The root (`data-fods-component="status-summary-bar"`, `data-fods-part="root"`) is a vertical flex column, fill `--bg-primary`. The cells region sits in a collapse wrapper (a Motion `height` room, clipped with 4px of air for the focus ring and the donut overhang) whose bottom padding gives the `--space-500` gap to the toggle row; collapsed, the region is `inert` and ends `invisible`. It publishes `data-collapsed`. Your `className`, the forwarded `ref` and any other HTML attributes land here.
|
|
49
|
+
|
|
50
|
+
- **Items row** (`data-fods-part="cells-group"`) — **one** wrap container (`flex flex-wrap items-center`, column gap `--space-500` on one line and wrapped alike, row gap `--space-600`) holding the total card and every status cell, laid flat: the card is simply the first wrap item. Main-axis alignment follows manifest `chrome.container.alignment`: on one line `justify-between` (the card at the start edge, the last cell at the end edge, the leftover width shared between the gaps, never under the 12px column gap); once wrapped `justify-center` (every line centred, a lone cell in the middle of its line). The bar detects the wrap itself — a `ResizeObserver` on the row and the rule "the last item's top edge sits below the first item's bottom edge", never equal `offsetTop`, because the card and the cells differ in height. Server rendering and the first paint use the one-line alignment. It carries `role="group"` named by `groupLabel`.
|
|
51
|
+
- **Total card** (`data-fods-part="summary-card"`) — the one bordered element: `--radius-400`, 1px `--outline-default` stroke (`--border-width-100`), `--bg-primary` fill, block padding `--space-500`, inline padding 24 left (`--space-800`) / 16 right (`--space-600`) — asymmetric because the donut brings its own optical margin — and a `--space-800` gap to the donut. Its amount run is never narrower than `formatAmount(99_999_999)` (an invisible `aria-hidden` copy stacked in the same grid cell as the live amount), so the card keeps one width while the filter changes the total. It never clips (no `overflow-hidden`), because the donut's hover growth paints into its padding. A vertical text block (gap `--space-500` between the label + amount pair and the count) holds:
|
|
52
|
+
- **Label** (`total-label`) — Body/S Regular, `--text-secondary`.
|
|
53
|
+
- **Amount** (`total-amount`) — Heading/H4 (`font-poppins text-heading-h4`), Semibold, `--text-primary`; count-up animated.
|
|
54
|
+
- **Count** (`total-count`) — Body/XS Regular, `--text-secondary`; changes instantly (a count-up on an integer reads as noise).
|
|
55
|
+
- **Donut** (`data-fods-part="donut"`, `aria-hidden="true"`) — an 80px ring whose outer radius is half its box and whose hole is 0.68 of the outer radius. A `--bg-secondary` track sits under the segments; segments start at 12 o'clock and run clockwise in cell order, filled with the family's solid status colour (`--status-success-solid`, `--status-info-solid`, `--status-warning-solid`, `--status-danger-solid`, `--status-violet-solid`), separated by a 1px `--bg-primary` stroke. Every segment rounds all four corners, outer and inner, at `--radius-200` (4px); ECharts shrinks the radius on an arc too short to hold it, so a floor-width arc never inverts. The track is not rounded. A hovered segment's outer radius grows 40 → 44 at the 80 box; the inner edge stays. ECharts paints SVG attributes, which cannot resolve `var(--…)`, so these colours are read as resolved values from the package tokens (`semantic.color`) rather than as classes. The chart surface overhangs the box by 4px (`-inset-200`) so a grown segment is not cut by the SVG viewport.
|
|
56
|
+
- **Status cell** (repeated) — the `<button type="button">` (`data-fods-part="summary-cell"`) is itself the wrap item, with no wrapper around it: `flex-auto` (`flex: 1 1 auto`), `min-w-max` (never below its widest child) and a 186px cap. Vertical flex, both axes centred, gap `--space-400`, padding `--space-200` block / `--space-400` inline, `--radius-400`; its height hugs, and the row centres it against the taller card. The hover and pressed wash, the radius and the focus ring cover the whole cell at whatever width it has. The hidden element holding its description sits inside the button. Three runs top to bottom:
|
|
57
|
+
- **Amount** (`cell-amount`) — Body/M Semibold (`text-body-base`), `--text-primary`; count-up animated.
|
|
58
|
+
- **Status chip** (`status-chip`) — the Chip (Selectable · Medium) in the status family, **painted**: `pointer-events-none`, no input, no trigger of its own. A `pointer-events-auto` span around it is the trigger of the cell tooltip, so the tooltip opens over the chip only and the chip itself never enters its own hover. Its leading checkbox fills with the same solid status colour as its family's arc when included; the trailing info glyph is an `aria-hidden` icon.
|
|
59
|
+
- **Count** (`cell-count`) — Body/XS Regular, `--text-secondary`.
|
|
60
|
+
- **Status row** (below `md`, repeated) — a wrapper holding two siblings. The **control** (`data-fods-part="status-row"`) is an empty `<button type="button" role="checkbox">` stretched under the whole row (`absolute inset-0`); it carries the fill, `--radius-400`, the washes and the offset focus ring of the desktop cell. Over it, a `pointer-events-none` overlay (`min-h-1100`, padding `--space-200` block / `--space-400` inline, gap `--space-500`) lays out the painted chip on the left and the amount (`row-amount`) on the right, so every pointer hit falls through to the control. The chip's trailing ⓘ is the one exception: a real `<button type="button">` (`data-fods-part="status-info"`, `pointer-events-auto`) in the glyph's place, with a centred 44×44 `::before` hit zone and the Chip ⓘ's own offset focus ring. It is a sibling of the control, never nested in it. The hidden description sits beside them.
|
|
61
|
+
- **Collapse-toggle row** — `Divider` (flex-1, `aria-hidden`) → `Button` (`data-fods-part="collapse-toggle"`, Tertiary, XS, leading `caret-up-small`) → `Divider`.
|
|
62
|
+
- **Live region** — a visually hidden `<span role="status" aria-live="polite">` holding the last toggle's announcement.
|
|
63
|
+
|
|
64
|
+
## Variants
|
|
65
|
+
|
|
66
|
+
{/* The docs column is narrower than the 1270 container, so an inline canvas would squeeze
|
|
67
|
+
both frames. Framed at a real viewport instead. */}
|
|
68
|
+
<ViewportFrame storyId="design-system-organisms-status-summary-bar--matrix" width={1320} label="State — viewport 1320, container 1270" />
|
|
69
|
+
|
|
70
|
+
Two variants — **State** (Expanded · Collapsed), reached through `collapsed` / `defaultCollapsed`. There is no density: manifest 2.0.0 removed Comfortable · Compact, and the bar keeps one card at the former Comfortable measurements. Everything else that varies is data — how many cells, which families, their values.
|
|
71
|
+
|
|
72
|
+
<table>
|
|
73
|
+
<thead>
|
|
74
|
+
<tr><th>Axis value</th><th>When</th><th>What changes</th></tr>
|
|
75
|
+
</thead>
|
|
76
|
+
<tbody>
|
|
77
|
+
<tr>
|
|
78
|
+
<td><code>Expanded</code></td>
|
|
79
|
+
<td>Default</td>
|
|
80
|
+
<td>Card and every cell above the toggle row; label <code>collapseLabel</code>, caret up</td>
|
|
81
|
+
</tr>
|
|
82
|
+
<tr>
|
|
83
|
+
<td><code>Collapsed</code></td>
|
|
84
|
+
<td><code>collapsed</code> / <code>defaultCollapsed</code>, or a press on the toggle</td>
|
|
85
|
+
<td>Only the toggle row; the items row is <code>inert</code> and folds away, label <code>expandLabel</code>, caret rotated 180°</td>
|
|
86
|
+
</tr>
|
|
87
|
+
</tbody>
|
|
88
|
+
</table>
|
|
89
|
+
|
|
90
|
+
Two status sets at the container cap:
|
|
91
|
+
|
|
92
|
+
<ViewportFrame storyId="design-system-organisms-status-summary-bar--five-statuses" width={1320} label="Five statuses — container 1270, every cell at its cap" />
|
|
93
|
+
|
|
94
|
+
<ViewportFrame storyId="design-system-organisms-status-summary-bar--three-statuses" width={1320} label="Three statuses — container 1270, the one line spreads" />
|
|
95
|
+
|
|
96
|
+
## Sizes
|
|
97
|
+
|
|
98
|
+
{/* Docs canvases render inline in a desktop viewport, where `md:` always applies — so each
|
|
99
|
+
width is framed at its real viewport and scaled to fit the column. */}
|
|
100
|
+
<ViewportFrame storyId="design-system-organisms-status-summary-bar--viewport-full" width={1320} label="Container cap — viewport 1320, container 1270, one line, every cell at 186" />
|
|
101
|
+
<ViewportFrame storyId="design-system-organisms-status-summary-bar--viewport-wrapped" width={960} label="Wrapped — viewport 960, container 900, column gap 12, row gap 16, every line centred" />
|
|
102
|
+
<ViewportFrame storyId="design-system-organisms-status-summary-bar--viewport-below-md" width={390} label="Below md — viewport 390, a row per status inside the host gutter" />
|
|
103
|
+
<ViewportFrame storyId="design-system-organisms-status-summary-bar--viewport-below-md-filtered" width={390} label="Below md — Návrh excluded, Budoucí at zero" />
|
|
104
|
+
|
|
105
|
+
**Single size — there is no size or density axis.** The bar takes the width of its container (the app-shell container cap, 1270, in the manifest); the total card hugs its content and the cells fill the rest up to their cap. On one line the leftover width goes into the gaps (space-between); once the row wraps every line is centred.
|
|
106
|
+
|
|
107
|
+
<table>
|
|
108
|
+
<thead>
|
|
109
|
+
<tr><th>Element</th><th>Width rule</th><th>Notes</th></tr>
|
|
110
|
+
</thead>
|
|
111
|
+
<tbody>
|
|
112
|
+
<tr>
|
|
113
|
+
<td>Total card</td>
|
|
114
|
+
<td>Content-sized; the amount run is at least the width of <code>formatAmount(99_999_999)</code></td>
|
|
115
|
+
<td><code>shrink-0</code>; grows past the floor for a longer amount, never shrinks — the donut stays put while the filter changes the total</td>
|
|
116
|
+
</tr>
|
|
117
|
+
<tr>
|
|
118
|
+
<td>Donut box</td>
|
|
119
|
+
<td style={{ textAlign: 'right' }}>80 px</td>
|
|
120
|
+
<td>Component constant from <code>_summary-card</code> <code>chrome.donut.box</code>; no size token exists</td>
|
|
121
|
+
</tr>
|
|
122
|
+
<tr>
|
|
123
|
+
<td>Status cell</td>
|
|
124
|
+
<td><code>flex-auto</code> + <code>min-w-max</code> + <code>max-w-[186px]</code></td>
|
|
125
|
+
<td>FILL between its floor (widest child plus 8 each side) and 186. When the line cannot hold every cell at its floor the row wraps: cells on a line share the space between their floors and 186, and a lone cell grows only to 186 and sits in the middle of its line</td>
|
|
126
|
+
</tr>
|
|
127
|
+
<tr>
|
|
128
|
+
<td>Below <code>md</code></td>
|
|
129
|
+
<td>Full width of the container</td>
|
|
130
|
+
<td>A vertical list: Celkem, then one row per status, each at least <code>min-h-1100</code> (48) tall — label or Chip left, amount right. Celkem keeps the total card's Poppins H4 amount, so it leads the list as the card leads the bar; its secondary label steps up from the card's Body S to Body, since on one line beside the H4 it names the number rather than captioning it from above; the status rows keep the cell's Body semibold amount. Manifest <code>chrome.mobile</code> (2.1.0); the consumer supplies the container (the mobile filter sheet)</td>
|
|
131
|
+
</tr>
|
|
132
|
+
</tbody>
|
|
133
|
+
</table>
|
|
134
|
+
|
|
135
|
+
## States
|
|
136
|
+
|
|
137
|
+
<Canvas of={StatusSummaryBarStories.CellStates} />
|
|
138
|
+
|
|
139
|
+
<Canvas of={StatusSummaryBarStories.Motion} />
|
|
140
|
+
|
|
141
|
+
Per status cell, `_summary-cell` Selection (Included · Excluded) × State. In the story the hover, pressed and focus looks are forced with bare classes, not a pseudo-state addon.
|
|
142
|
+
|
|
143
|
+
<table>
|
|
144
|
+
<thead>
|
|
145
|
+
<tr><th>State</th><th>Fill</th><th>Checkbox</th></tr>
|
|
146
|
+
</thead>
|
|
147
|
+
<tbody>
|
|
148
|
+
<tr><td>Included</td><td><code>--bg-primary</code></td><td>Checked, box in the family's solid status colour</td></tr>
|
|
149
|
+
<tr><td>Included + Hover</td><td><code>--bg-hover</code></td><td>Checked</td></tr>
|
|
150
|
+
<tr><td>Included + Pressed</td><td><code>--bg-active</code></td><td>Checked</td></tr>
|
|
151
|
+
<tr><td>Focus</td><td><code>--bg-primary</code> + offset ring</td><td>Unchanged</td></tr>
|
|
152
|
+
<tr><td>Excluded</td><td><code>--bg-primary</code></td><td>Unchecked</td></tr>
|
|
153
|
+
<tr><td>Excluded + Hover</td><td><code>--bg-hover</code></td><td>Unchecked</td></tr>
|
|
154
|
+
<tr><td>Excluded + Pressed</td><td><code>--bg-active</code></td><td>Unchecked</td></tr>
|
|
155
|
+
</tbody>
|
|
156
|
+
</table>
|
|
157
|
+
|
|
158
|
+
- **Hover / Pressed** are neutral washes (`hover:` / `active:`), never family-tinted; the background-colour transition runs on `--duration-hover` (Pressed on `--duration-press`, `_summary-cell` 2.0.1) × `--easing-standard`; it names only `background-color`, so the focus ring never animates.
|
|
159
|
+
- **Focus** is the `offset` ring: a `::before` band 4px outside the cell (`-inset-200`) with a 2px `--outline-focus` border (`--border-width-200`) and `--radius-500` — one step above the cell's `--radius-400` — on `:focus-visible` only.
|
|
160
|
+
- **The Chip stays at rest** in every state: it is `pointer-events-none`, so it never enters its own `:hover`.
|
|
161
|
+
- **Cell tooltip** — the status `description` (Small, Top) anchors to the chip. It opens on hover over the chip (not over the amount or count) and on keyboard focus of the cell (`:focus-visible` — a mouse click does not open it); Escape, a click or leaving closes it. The mobile rows do **not** wire it this way: there the ⓘ is a toggletip button (see Accessibility), and neither a hover over the chip nor the row's focus opens it.
|
|
162
|
+
- **Cross-highlight** — hovering a donut segment puts the matching cell into its own Hover look (`data-cross-highlight="true"` → `--bg-hover`); hovering a cell grows its matching segment by 4px outward (40 → 44 at the 80 box), with no tooltip. The segment tooltip (Small, `{Status}: {amount}` using the same label string as the Chip) belongs to segment hover only; it follows the pointer, placed above it. The hovered segment keeps its rest colour.
|
|
163
|
+
- **Recalculation** — excluding a status subtracts its exact amount and its count from the total card and passes it to the donut with value 0, so its arc shrinks to nothing in place; re-including puts them back and the arc grows from its own start angle. Cells keep their own figures.
|
|
164
|
+
|
|
165
|
+
<ViewportFrame storyId="design-system-organisms-status-summary-bar--zero-value" width={1320} label="Zero-value status — container 1270" />
|
|
166
|
+
|
|
167
|
+
**Zero-value status** — no arc (also for an amount under half a unit, which displays as 0), but the cell keeps a fully live control: nothing is dimmed or disabled, and it stays in the tab order.
|
|
168
|
+
|
|
169
|
+
<ViewportFrame storyId="design-system-organisms-status-summary-bar--all-excluded" width={1320} label="All excluded — container 1270" />
|
|
170
|
+
|
|
171
|
+
**All excluded** — the total card shows the formatter's zero amount and a zero count, and the donut is the bare track. The card is never hidden.
|
|
172
|
+
|
|
173
|
+
<ViewportFrame storyId="design-system-organisms-status-summary-bar--negative-amount" width={1320} label="Negative amount — container 1270" />
|
|
174
|
+
|
|
175
|
+
**Negative amount** — the arc draws the absolute value; the sign is carried by the cell's own number.
|
|
176
|
+
|
|
177
|
+
<ViewportFrame storyId="design-system-organisms-status-summary-bar--refetch" width={1320} label="Data change — press the button to refetch — container 1270" />
|
|
178
|
+
|
|
179
|
+
**Motion** (`chrome.motion`) — on the bar's first render the donut **draws in once**: each segment grows clockwise from its own start angle, segment *i* starting *i* × 90ms after the first (counting drawn arcs, in cell order), 350ms each on `--easing-enter` — five segments finish at 710ms. Every later change — a toggle, or new `statuses` as in the story above — **never replays** the draw-in: all segments resize in place together over `--duration-slow` × `--easing-standard`, with no stagger, and the amounts count up on the same clock and curve from the value they currently show. A change arriving mid-animation continues from the intermediate value.
|
|
180
|
+
|
|
181
|
+
## API
|
|
182
|
+
|
|
183
|
+
<Controls />
|
|
184
|
+
|
|
185
|
+
- `statuses` — one `StatusSummaryItem` per status in reading order: `id`, `family` (`success` · `info` · `warning` · `danger` · `violet`), `label` (the Chip label and the segment tooltip's name), `description` (cell tooltip and accessible description), `amount` (may be negative or zero), `count`.
|
|
186
|
+
- Copy props, all required: `formatAmount`, `formatCount`, `totalLabel`, `groupLabel`, `collapseLabel`, `expandLabel`, `getAnnouncement`, `getInfoLabel`. `getAnnouncement` receives `{ status, included, totalAmount, totalCount }` — the toggled status, its new state, and the total card's values **after** the toggle.
|
|
187
|
+
- `getInfoLabel(status)` names a mobile row's ⓘ button — `Co znamená {status}`, e.g. `` status => `Co znamená ${status.label}` `` → "Co znamená Nezaplaceno" (the string is a first draft pending a native review). The glyph is `aria-hidden` and the status name sits in the row control, so without it every row would expose an unnamed button.
|
|
188
|
+
- `formatAmount` always receives an **integer**: the bar rounds every cell amount, Celkem (once, from the exact sum), every count-up frame and the segment tooltip to whole units first (a float sum that rounds to `-0` is passed as `0`). Format with `maximumFractionDigits: 0`. It is also called once with `99_999_999` to size the total card's amount run. `getAnnouncement`'s `totalAmount` is rounded the same way.
|
|
189
|
+
- Filter: controlled `excludedIds` or uncontrolled `defaultExcludedIds` (default: none, i.e. all included), plus `onExcludedIdsChange`.
|
|
190
|
+
- Collapse: controlled `collapsed` or uncontrolled `defaultCollapsed` (default `false`), plus `onCollapsedChange`.
|
|
191
|
+
- There is no alignment prop: the bar spreads a one-line row edge to edge and centres a wrapped one by itself (manifest 2.5.0 `chrome.container.alignment`).
|
|
192
|
+
- Pick controlled or uncontrolled once per prop and keep it for the bar's lifetime — switching `excludedIds` or `collapsed` between `undefined` and a value mid-flight falls back to the stale internal state, as with any React controlled input.
|
|
193
|
+
- Memoise `statuses` and `formatAmount` (or hoist them) — the bar keys the donut on its drawn content, so an inline array or formatter costs only recomputation, not a rebuild; still, a stable identity keeps parent re-renders cheap.
|
|
194
|
+
|
|
195
|
+
The bar renders its cell and segment tooltips with the Radix-based `Tooltip`, so it needs a `TooltipProvider` ancestor (the stories add one as a decorator). The mobile ⓘ uses the same `Tooltip` in its `toggletip` mode.
|
|
196
|
+
|
|
197
|
+
## Do / Don't
|
|
198
|
+
|
|
199
|
+
- ✅ Ship every status included and let the reader switch statuses off
|
|
200
|
+
- ✅ Pass a plural-rule lookup as `formatCount` (`1 faktura` · `3 faktury` · `14 faktur`)
|
|
201
|
+
- ✅ Pass the same status string as `label` everywhere — the Chip and the segment tooltip read it, so one number has one name
|
|
202
|
+
- ✅ Build `getAnnouncement` from the end state it receives (`included`, `totalAmount`, `totalCount`), not the delta
|
|
203
|
+
- ✅ Give the bar the full container width — it wraps on its own when the cells no longer fit
|
|
204
|
+
- ✅ Paint the trailing ⓘ and expose its text through the cell (desktop)
|
|
205
|
+
- ✅ On a mobile row, make the ⓘ a toggletip button beside the row's checkbox control
|
|
206
|
+
- ❌ Wire the gesture as isolate ("show only this status")
|
|
207
|
+
- ❌ Filter `statuses` down to the included ones — a cell reports its status over the whole set; exclusion goes through `excludedIds`
|
|
208
|
+
- ❌ Drop a status from `statuses` because its value is 0 today
|
|
209
|
+
- ❌ Concatenate the count and a noun (`` `${count} faktur` ``)
|
|
210
|
+
- ❌ Wrap the bar in a horizontally scrolling or clipping container — it wraps on its own, and the donut's hover growth paints outside its box
|
|
211
|
+
- ❌ Wire the ⓘ as its own trigger inside the desktop cell
|
|
212
|
+
- ❌ Leave the mobile ⓘ hover-only — on touch the explanation would be unreachable
|
|
213
|
+
|
|
214
|
+
## Accessibility
|
|
215
|
+
|
|
216
|
+
- **Keyboard** — each status cell is a native `<button type="button">`, one tab stop per cell, in `statuses` order; Enter and Space toggle it. The total card is not focusable. The collapse toggle is the next tab stop. While collapsed the items row is `inert` (and ends `invisible`), so the cells leave the tab order.
|
|
217
|
+
- **ARIA** — the items row is `role="group"` named by `groupLabel` (not `<fieldset>`/`<legend>`: these are buttons, not form controls). Inclusion is exposed as `role="checkbox"` + `aria-checked` on the cell's `<button>` — never `aria-pressed` (manifest 2.3.1 `delivery.inclusion`). Each cell's `aria-describedby` points at a hidden element holding its `description`, so the explanation reaches keyboard and screen-reader users, not only a pointer. The collapse button carries `aria-expanded` and `aria-controls` pointing at the items row. The donut, the Dividers and every icon are `aria-hidden`.
|
|
218
|
+
- **Screen reader** — a cell reads its amount, its status label, its count and its checked state, with the description as the accessible description. After every toggle the visually hidden `role="status"` (`aria-live="polite"`) node announces the string your `getAnnouncement` returns, e.g. "Nezaplaceno vyloučeno. Celkem 1 314 163 Kč, 19 faktur." — one announcement per toggle. The announcement is built from what the bar **rendered** after the toggle, not from the gesture: a controlled parent that does not apply the change produces no announcement, so the live region never contradicts `aria-checked` and the total. Animated digits never reach assistive technology: the final formatted value sits in flow (invisible, and sizing the run so the layout does not jitter) and the animated frames are painted over it in an `aria-hidden` copy.
|
|
219
|
+
- **Below `md`** — each status row is the same one control as a desktop cell: a `<button type="button" role="checkbox">` with `aria-checked` and the description wired through `aria-describedby`, in a `role="group"` named by `groupLabel`. The row control is named by its status label and amount. The ⓘ is a separate `<button type="button">` (`chrome.mobile.status-row.status-tooltip`): a 44×44 hit zone around the glyph, `aria-label` from `getInfoLabel` (`Co znamená {status}`), and `Tooltip` in toggletip mode, which gives it `aria-expanded` and `aria-controls` → the bubble (a non-modal popup, not `role="tooltip"`). It sits beside the row's checkbox control, layered over it, never nested inside it, and is its own tab stop right after the row. A tap, click, Enter or Space opens the explanation and it stays open; a second activation, a tap outside, focus leaving or Escape (focus stays on the ⓘ) closes it. It never toggles the status. The row keeps the explanation in its `aria-describedby`, so a screen reader still hears it on the row. The Celkem row is not focusable. The desktop layout is `display: none` there, so only one set of controls is in the tab order and the accessibility tree at any width.
|
|
220
|
+
- **Colour independence** — status is always named in text inside the Chip; the donut is redundant to the cells.
|
|
221
|
+
- **Contrast** — the manifest records three accepted exceptions: the total card's 1px `--outline-default` border (1.32:1, decorative grouping), the XS (28px) collapse button (isolated between two Dividers, full text label), and the white tick on `--status-warning-solid` (2.37:1, Chip's checked contract).
|
|
222
|
+
- **Motion** — `prefers-reduced-motion: reduce` (the count-up reads it through `usePrefersReducedMotion`; the ring and the collapse through Motion's `useReducedMotion`) snaps the count-up to the target and turns every chart animation off: the ring renders at its final sweeps with no draw-in, resizes without transition, and the segment hover growth is instant. The collapse (Motion) switches at once with no fade, and the caret flips without turning (the `MotionConfig reducedMotion="user"` of `FodsProvider` drops the transform).
|
|
223
|
+
|
|
224
|
+
Accessibility floor for every FODS component: `spec/01-foundations/accessibility.md`.
|
|
225
|
+
|
|
226
|
+
### Known divergences — for designer review
|
|
227
|
+
|
|
228
|
+
1. **The donut draw-in is ECharts, not the CSS `stroke-dasharray` recipe.** `chrome.motion.donut-enter.react` describes SVG arcs with `pathLength` 100 and a transition per arc; the ring here is an ECharts pie. ECharts' own first-render `expansion` animation starts **every** sector at the ring's start angle (12 o'clock), so each would sweep in from the top rather than grow from its own start. The bar therefore renders the segment series empty first and then adds the arcs: an added sector grows from its own start angle on ECharts' update channel, which carries the enter timing for that one pass (350ms, `--easing-enter`, delay = drawn-arc index × 90ms). The visible behaviour is the manifest's; the technique differs. One side effect: until its delay elapses, a waiting arc is a zero-width sector whose 1px `--bg-primary` separator shows as a hairline on the track at its start angle.
|
|
229
|
+
2. **The collapse room is the items row's height, not a transform.** `motion.layout` (2.4.3) names `transform`; scaling the row would stretch the cells, the card's hairline and the focus rings, so Motion animates the wrapper's `height` on `--spring-gentle` instead — whatever sits below the bar follows it, as the manifest asks.
|
|
230
|
+
|
|
231
|
+
## Copy
|
|
232
|
+
|
|
233
|
+
Voice: impersonal in-app copy. Every string comes from you through the copy props; the bar only joins the segment tooltip from them.
|
|
234
|
+
|
|
235
|
+
- **Cell amount** (`formatAmount`) — cs-CZ money in whole currency units, non-breaking spaces as the thousands separator and before the currency: `1 008 372 Kč`. No decimals; the rounding is display-only. One line, no character cap: it never wraps and never truncates, so a longer locale widens the cell instead.
|
|
236
|
+
- **Cell count** (`formatCount`) — the document count with its noun, correctly declined through the market's plural-rule lookup, never string concatenation. One line, truncates, max 20 characters.
|
|
237
|
+
- **Total label** (`totalLabel`) — `Celkem`: the word for the whole set, not a repeat of the entity. One line, truncates, max 14 characters.
|
|
238
|
+
- **Total amount** (`formatAmount`) — the total card's money run, same formatting as the cell amount, whole units with no decimals. It reports the included statuses, so it moves when the filter does. Celkem is computed from the exact amounts and rounded once, never summed from the rounded cell amounts, so it may differ by a few units from the sum of the cells on screen, and that is correct. One line, no character cap: it never truncates, and a longer total widens the card.
|
|
239
|
+
- **Total count** (`formatCount`) — the total card's count line: the same shape and the same plural lookup as the cell count, the bare declined count with no leading word (`19 faktur`, `4 výdaje`). It reports the included statuses, so it moves when the filter does. One line, truncates, max 20 characters.
|
|
240
|
+
- **Collapse label** (`collapseLabel` / `expandLabel`) — names what is being hidden, per consumer: `Skrýt stavy faktur` / `Skrýt stavy výdajů`, inverting to `Zobrazit stavy faktur` / `Zobrazit stavy výdajů` when collapsed. One line, truncates, max 28 characters.
|
|
241
|
+
- **Segment tooltip** — `{Status}: {amount}`, built by the bar from the status `label` and `formatAmount`, the amount in whole units as in the cell. The status name is the same string the cell's Chip carries: one number must not have two names. One line, truncates, max 40 characters.
|
|
242
|
+
- **Status explanation** (the status `description`) — what the status means, the one thing the cell cannot show. One sentence, impersonal, present tense, describing the document's situation rather than instructing the reader. It is the cell's tooltip and its accessible description, so it must read correctly out of visual context. Wraps, max 2 lines, max 110 characters.
|
|
243
|
+
|
|
244
|
+
Count forms in Czech (three forms):
|
|
245
|
+
|
|
246
|
+
<table>
|
|
247
|
+
<thead>
|
|
248
|
+
<tr><th>Count</th><th>faktury</th><th>výdaje</th></tr>
|
|
249
|
+
</thead>
|
|
250
|
+
<tbody>
|
|
251
|
+
<tr><td>1</td><td><code>1 faktura</code></td><td><code>1 výdaj</code></td></tr>
|
|
252
|
+
<tr><td>2–4</td><td><code>3 faktury</code></td><td><code>3 výdaje</code></td></tr>
|
|
253
|
+
<tr><td>0 and 5+</td><td><code>14 faktur</code></td><td><code>0 výdajů</code></td></tr>
|
|
254
|
+
</tbody>
|
|
255
|
+
</table>
|
|
256
|
+
|
|
257
|
+
Status explanations (CZ; a first draft pending a native review):
|
|
258
|
+
|
|
259
|
+
<table>
|
|
260
|
+
<thead>
|
|
261
|
+
<tr><th>Status</th><th>CZ</th></tr>
|
|
262
|
+
</thead>
|
|
263
|
+
<tbody>
|
|
264
|
+
<tr><td>Zaplaceno</td><td>Faktura je uhrazená, platba dorazila a je spárovaná.</td></tr>
|
|
265
|
+
<tr><td>Návrh</td><td>Faktura je rozpracovaná a zatím není vystavená.</td></tr>
|
|
266
|
+
<tr><td>Nezaplaceno</td><td>Faktura je vystavená a čeká na úhradu, splatnost zatím neuplynula.</td></tr>
|
|
267
|
+
<tr><td>Po splatnosti</td><td>Faktura je vystavená, splatnost uplynula a platba nedorazila.</td></tr>
|
|
268
|
+
<tr><td>Budoucí</td><td>Faktura má datum vystavení v budoucnu a vystaví se až v ten den.</td></tr>
|
|
269
|
+
</tbody>
|
|
270
|
+
</table>
|
|
271
|
+
|
|
272
|
+
## Usage
|
|
273
|
+
|
|
274
|
+
<Canvas of={StatusSummaryBarStories.Playground} />
|
|
275
|
+
|
|
276
|
+
```tsx
|
|
277
|
+
// Good — every string comes from the consumer; the bar owns the filter state.
|
|
278
|
+
// The bar rounds before formatting, so no fraction digits.
|
|
279
|
+
const formatAmount = (amount: number) =>
|
|
280
|
+
new Intl.NumberFormat('cs-CZ', { style: 'currency', currency: 'CZK', maximumFractionDigits: 0 }).format(amount);
|
|
281
|
+
const formatInvoices = (count: number) => czPlural(count, ['faktura', 'faktury', 'faktur']);
|
|
282
|
+
|
|
283
|
+
<StatusSummaryBar
|
|
284
|
+
statuses={[
|
|
285
|
+
{ id: 'paid', family: 'success', label: 'Zaplaceno', description: 'Faktura je uhrazená, platba dorazila a je spárovaná.', amount: 120000, count: 4 },
|
|
286
|
+
{ id: 'overdue', family: 'danger', label: 'Po splatnosti', description: 'Faktura je vystavená, splatnost uplynula a platba nedorazila.', amount: 18500.5, count: 1 },
|
|
287
|
+
]}
|
|
288
|
+
formatAmount={formatAmount}
|
|
289
|
+
formatCount={formatInvoices}
|
|
290
|
+
totalLabel="Celkem"
|
|
291
|
+
groupLabel="Filtr stavů faktur"
|
|
292
|
+
collapseLabel="Skrýt stavy faktur"
|
|
293
|
+
expandLabel="Zobrazit stavy faktur"
|
|
294
|
+
getAnnouncement={({ status, included, totalAmount, totalCount }) =>
|
|
295
|
+
`${status.label} ${included ? 'zahrnuto' : 'vyloučeno'}. Celkem ${formatAmount(totalAmount)}, ${formatInvoices(totalCount)}.`
|
|
296
|
+
}
|
|
297
|
+
excludedIds={excludedIds}
|
|
298
|
+
onExcludedIdsChange={setExcludedIds}
|
|
299
|
+
/>
|
|
300
|
+
```
|
|
301
|
+
|
|
302
|
+
```tsx
|
|
303
|
+
// Don't — narrowing the data instead of excluding. The excluded cells disappear,
|
|
304
|
+
// so the reader can never switch them back on.
|
|
305
|
+
<StatusSummaryBar statuses={statuses.filter(s => !excludedIds.includes(s.id))} … />
|
|
306
|
+
|
|
307
|
+
// Don't — concatenating the plural.
|
|
308
|
+
<StatusSummaryBar formatCount={count => `${count} faktur`} … />
|
|
309
|
+
```
|
|
310
|
+
|
|
311
|
+
## Related
|
|
312
|
+
|
|
313
|
+
- [`Chip`](?path=/docs/design-system-atoms-chip--docs) — the painted Selectable · Medium pill in every cell; this organism overrides its Info-is-the-trigger contract.
|
|
314
|
+
- [`Tooltip`](?path=/docs/design-system-atoms-tooltip--docs) — Small, Top; the segment tooltip and the status explanation.
|
|
315
|
+
- [`Button`](?path=/docs/design-system-atoms-button--docs) — the collapse toggle (Tertiary, XS).
|
|
316
|
+
- [`Divider`](?path=/docs/design-system-atoms-divider--docs) — the two rules flanking the toggle.
|
|
317
|
+
- [`Checkbox`](?path=/docs/design-system-atoms-checkbox--docs) — the inclusion mark, reached through the Chip.
|
|
318
|
+
- Table — the organism directly below this one; it scrolls horizontally where this bar wraps.
|
|
319
|
+
- [ECharts](https://echarts.apache.org/) — the library behind the donut (modular import, SVG renderer).
|
|
320
|
+
- Spec: `spec/05-organisms/status-summary-bar.md`.
|
|
321
|
+
|
|
322
|
+
## Migration notes
|
|
323
|
+
|
|
324
|
+
### 2.4.3 → 2.5.0 (alignment)
|
|
325
|
+
|
|
326
|
+
- **One line spreads, a wrapped row centres — automatically.** Before: every line centred, and a list could opt into edge-to-edge with `distribution="between"`. Now the bar does what the manifest's `chrome.container.alignment` asks on every list: `justify-content: space-between` while everything fits one line, `center` once it wraps (detected with a `ResizeObserver` on the row). The `distribution` prop and the `StatusSummaryDistribution` type are removed — drop the prop from call sites. The cells no longer carry `margin-inline: auto`, so on one line the last cell now sits at the end edge.
|
|
327
|
+
- Five cells at 1270 leave 8px to share and look the same as before; a card with three cells keeps spreading edge to edge.
|
|
328
|
+
|
|
329
|
+
### 2.4.2 → 2.4.3 (motion)
|
|
330
|
+
|
|
331
|
+
- **Collapse runs on Motion** (`@invoiceonline/ui-system` 0.17.0 springs). Before: the wrapper's grid row and opacity ran together on one CSS transition (`--duration-slow` / `--easing-standard`) and the caret rotated on the same transition. Now: `motion.exit` fades the card and cells out first (`--duration-fast` / `--easing-exit`) and the room closes after it, `motion.enter` fades them in while the room opens (`--duration-slow` / `--easing-enter`), `motion.layout` runs the room on `--spring-gentle`, `motion.states.open` turns the caret on `--spring-standard`, and a quick re-toggle reverses mid-turn (`motion.interrupt`). The items row stays `inert` from the press on and ends `invisible` once the room has closed — a test that read `invisible` synchronously after the press now needs `waitFor`.
|
|
332
|
+
- Segment hover growth, the cross-highlight and the value count-up (`motion.states.hover` / `value`) are unchanged.
|
|
333
|
+
|
|
334
|
+
### 2.3.1 → 2.4.0
|
|
335
|
+
|
|
336
|
+
- **New required prop `getInfoLabel(status)`** — the accessible name of the mobile row's ⓘ button (`Co znamená {status}`). TypeScript flags every call site that does not pass it.
|
|
337
|
+
- **Mobile row markup** — the row is no longer one `<button>` holding the chip and the amount: the control is an empty stretched `<button role="checkbox">` (still `data-fods-part="status-row"`, still `aria-checked` and `aria-describedby`), and the chip, the ⓘ button and the amount sit in a sibling overlay. A test that looked for the chip or the amount inside the row control must look in the row wrapper instead.
|
|
338
|
+
- **Mobile ⓘ behaviour** — the row's focus and a hover over its chip no longer open the explanation; only the ⓘ does, as a toggletip. The desktop cell is unchanged.
|