@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,133 @@
|
|
|
1
|
+
import * as React from "react";
|
|
2
|
+
/**
|
|
3
|
+
* Pagination — the paging footer under a Table or any long, page-broken list
|
|
4
|
+
* (spec 04-molecules/pagination.md, manifest pagination.manifest.json 1.3.1;
|
|
5
|
+
* cell manifest _pagination-item.manifest.json 1.3.3).
|
|
6
|
+
*
|
|
7
|
+
* `[Previous] numbers [Next]`, one 32px-high row. The manifest is
|
|
8
|
+
* `kind: "composite"` with empty `parts` and empty `families` — Pagination owns
|
|
9
|
+
* NO colour of its own. Every visual fact is inherited:
|
|
10
|
+
* - each number / ellipsis cell from `internal/paginationItem.ts`
|
|
11
|
+
* - Previous / Next from the hosted `Button` (Tertiary, S) — manifest `slots`
|
|
12
|
+
* The single token this component binds itself is the row gap,
|
|
13
|
+
* `composition.container.gap` = `--space-400` (8px).
|
|
14
|
+
*
|
|
15
|
+
* The four Figma variants (Default · First page · Last page · Many pages) are
|
|
16
|
+
* authored SNAPSHOTS of runtime situations, not a parametrized variant set the
|
|
17
|
+
* consumer configures — Figma carries them as a `Type` property, the code does not
|
|
18
|
+
* expose one. The real axis is runtime state, computed from `currentPage` /
|
|
19
|
+
* `totalPages` / `siblingCount`.
|
|
20
|
+
*
|
|
21
|
+
* ─── Deviations from the manifest, both approved ──────────────────────────────
|
|
22
|
+
*
|
|
23
|
+
* 1. MOBILE PREVIOUS / NEXT ARE ICON-ONLY. The manifest gives both triggers a
|
|
24
|
+
* fixed text label (`text.prev-label` / `next-label`) and § Do / Don't
|
|
25
|
+
* explicitly forbids swapping them for icon-only buttons. Below `sm` the row
|
|
26
|
+
* would not fit next to the number run, so the label is hidden with
|
|
27
|
+
* `max-sm:sr-only` — never `sr-only sm:not-sr-only`: a host page may ship an
|
|
28
|
+
* unlayered global `.sr-only` that beats Tailwind's
|
|
29
|
+
* layered `sm:not-sr-only` and hides the label on desktop. This is a CSS hide, not a conditional render: the
|
|
30
|
+
* accessible name stays in the DOM at every width, so the "text label is part
|
|
31
|
+
* of the a11y contract" half of the rule still holds and there is no
|
|
32
|
+
* viewport-dependent markup to mismatch on hydration. The button also drops to
|
|
33
|
+
* symmetric `px-300` there, which lands it at exactly 32×32 (6 + 20px glyph + 6)
|
|
34
|
+
* instead of inheriting Button's optical `pl-400 pr-500` around a hidden label.
|
|
35
|
+
*
|
|
36
|
+
* 2. A PAGE CELL BECOMES AN ANCHOR WHEN `pageHref` IS GIVEN. Spec § Accessibility
|
|
37
|
+
* says every page number is a real `<button>`. Without a crawlable `href` the
|
|
38
|
+
* blog's pages 2+ are unreachable and their articles end up orphaned, so the
|
|
39
|
+
* consumer may hand in a URL builder; the cell then renders `<a href>` with the
|
|
40
|
+
* same `aria-label` / `aria-current` and intercepts plain left-clicks for SPA
|
|
41
|
+
* navigation. Modified clicks (new tab, etc.) fall through to the browser.
|
|
42
|
+
*
|
|
43
|
+
* ─── Two rules that are NOT deviations, and must not drift ────────────────────
|
|
44
|
+
*
|
|
45
|
+
* The row carries no border, no divider and no `overflow-hidden`: the cells are
|
|
46
|
+
* NOT fused into one clipped strip the way Button Group's segments are
|
|
47
|
+
* (`composition.builtFrom.note`), and clipping would additionally swallow every
|
|
48
|
+
* cell's OUTWARD offset focus ring.
|
|
49
|
+
*
|
|
50
|
+
* Nothing renders at `totalPages <= 1` — the whole component is absent, never a
|
|
51
|
+
* lone fully-disabled single-page bar (spec § States). Previous / Next go
|
|
52
|
+
* `disabled` at the ends instead of disappearing, so the row's width and tab
|
|
53
|
+
* order stay stable across pages.
|
|
54
|
+
*
|
|
55
|
+
* Ellipsis is inert: no button, no tab stop, no hover, `aria-hidden` glyph plus
|
|
56
|
+
* visually-hidden copy so a screen-reader user gets an equivalent of the skipped
|
|
57
|
+
* run instead of silence.
|
|
58
|
+
*/
|
|
59
|
+
declare const paginationVariants: import("tailwind-variants").TVReturnType<{}, {
|
|
60
|
+
nav: string;
|
|
61
|
+
trigger: string;
|
|
62
|
+
}, undefined, undefined, undefined, undefined>;
|
|
63
|
+
export interface PaginationLabels {
|
|
64
|
+
/**
|
|
65
|
+
* Names the landmark itself — `<nav aria-label>`. Spec § Copy: "Stránkování",
|
|
66
|
+
* matching the pattern other landmark labels use, never a generic "Navigace".
|
|
67
|
+
*/
|
|
68
|
+
nav: string;
|
|
69
|
+
/**
|
|
70
|
+
* Fixed nav labels (manifest `text.prev-label` / `next-label`) — always the
|
|
71
|
+
* market's direct equivalent of "Předchozí" / "Další", never a per-screen
|
|
72
|
+
* synonym. `Zpět` / `Vpřed` would break consistency with every other paged
|
|
73
|
+
* list in the product.
|
|
74
|
+
*/
|
|
75
|
+
previous: string;
|
|
76
|
+
next: string;
|
|
77
|
+
/**
|
|
78
|
+
* Accessible name PREFIX for a page cell, composed with the number:
|
|
79
|
+
* `"Stránka"` → `aria-label="Stránka 3"`, as `_pagination-item` 1.3.2 `delivery.react`
|
|
80
|
+
* and pagination.md § Accessibility spell it (owner ruling 2026-10-20).
|
|
81
|
+
*/
|
|
82
|
+
page: string;
|
|
83
|
+
/** Visually-hidden equivalent of a collapsed run, e.g. "Další stránky". */
|
|
84
|
+
morePages: string;
|
|
85
|
+
}
|
|
86
|
+
export interface PaginationProps extends Omit<React.HTMLAttributes<HTMLElement>, 'children'> {
|
|
87
|
+
/** The active page, 1-based. Drives which cell renders Current. */
|
|
88
|
+
currentPage: number;
|
|
89
|
+
/** Total page count. At `<= 1` the component renders nothing. */
|
|
90
|
+
totalPages: number;
|
|
91
|
+
onPageChange: (page: number) => void;
|
|
92
|
+
/**
|
|
93
|
+
* Optional URL builder. Present → cells render as crawlable anchors
|
|
94
|
+
* (see deviation 2); absent → plain buttons per spec.
|
|
95
|
+
*/
|
|
96
|
+
pageHref?: (page: number) => string;
|
|
97
|
+
/**
|
|
98
|
+
* Neighbours of `currentPage` kept visible on each side before collapsing to
|
|
99
|
+
* an ellipsis (manifest `properties[2]`, default 1 — the shape the Many pages
|
|
100
|
+
* Figma example demonstrates). Forced to 0 below `sm`, where a five-cell run
|
|
101
|
+
* plus both triggers does not fit: the row degrades to `1 … 6 … 12`.
|
|
102
|
+
*/
|
|
103
|
+
siblingCount?: number;
|
|
104
|
+
/**
|
|
105
|
+
* Copy override. OPTIONAL — every string falls back to the component's own
|
|
106
|
+
* Czech default, so the common case passes nothing at all.
|
|
107
|
+
* Override a single key when a screen (or a non-Czech market) needs different
|
|
108
|
+
* wording; the rest keep their defaults. The defaults are Czech; an app with more
|
|
109
|
+
* language versions passes them from its translations.
|
|
110
|
+
*/
|
|
111
|
+
labels?: Partial<PaginationLabels>;
|
|
112
|
+
}
|
|
113
|
+
declare const ELLIPSIS: "ellipsis";
|
|
114
|
+
type PageSlot = number | typeof ELLIPSIS;
|
|
115
|
+
/**
|
|
116
|
+
* The collapse rule (spec § Variants, manifest `intent.whenToUse`): show every
|
|
117
|
+
* number while the run is short; once it would crowd the row, keep the first
|
|
118
|
+
* page, the last page and `currentPage`'s immediate neighbours, and collapse
|
|
119
|
+
* everything else into ONE ellipsis per side.
|
|
120
|
+
*
|
|
121
|
+
* `1 + 1 + 1 + 2 * siblingCount + 2` = first + last + current + neighbours + the
|
|
122
|
+
* two ellipsis slots, i.e. 7 cells at the default `siblingCount` — which is also
|
|
123
|
+
* where "roughly 7+ pages" in the manifest comes from.
|
|
124
|
+
*
|
|
125
|
+
* The two edge branches deliberately render `3 + 2 * siblingCount` numbers
|
|
126
|
+
* instead of just current's neighbours, so the run keeps the same cell count on
|
|
127
|
+
* page 1 as it has in the middle and the row does not visibly shrink while
|
|
128
|
+
* paging. Reference sequence, `siblingCount=1`, page 6 of 12 (the Many pages
|
|
129
|
+
* example): `1 … 5 [6] 7 … 12`.
|
|
130
|
+
*/
|
|
131
|
+
export declare function paginationRange(currentPage: number, totalPages: number, siblingCount: number): PageSlot[];
|
|
132
|
+
declare const Pagination: React.ForwardRefExoticComponent<PaginationProps & React.RefAttributes<HTMLElement>>;
|
|
133
|
+
export { Pagination, paginationVariants };
|
|
@@ -0,0 +1,217 @@
|
|
|
1
|
+
"use client";
|
|
2
|
+
import { tv } from "../../internal/tailwind-variants.js";
|
|
3
|
+
import { Icon } from "../icon/Icon.js";
|
|
4
|
+
import { useIsMobile } from "../../internal/useIsMobile.js";
|
|
5
|
+
import { Button } from "../button/Button.js";
|
|
6
|
+
import { paginationItemVariants } from "../../internal/paginationItem.js";
|
|
7
|
+
import { cn } from "../../internal/utils.js";
|
|
8
|
+
import * as React from "react";
|
|
9
|
+
import { jsx, jsxs } from "react/jsx-runtime";
|
|
10
|
+
// src/components/pagination/Pagination.tsx
|
|
11
|
+
/**
|
|
12
|
+
* Pagination — the paging footer under a Table or any long, page-broken list
|
|
13
|
+
* (spec 04-molecules/pagination.md, manifest pagination.manifest.json 1.3.1;
|
|
14
|
+
* cell manifest _pagination-item.manifest.json 1.3.3).
|
|
15
|
+
*
|
|
16
|
+
* `[Previous] numbers [Next]`, one 32px-high row. The manifest is
|
|
17
|
+
* `kind: "composite"` with empty `parts` and empty `families` — Pagination owns
|
|
18
|
+
* NO colour of its own. Every visual fact is inherited:
|
|
19
|
+
* - each number / ellipsis cell from `internal/paginationItem.ts`
|
|
20
|
+
* - Previous / Next from the hosted `Button` (Tertiary, S) — manifest `slots`
|
|
21
|
+
* The single token this component binds itself is the row gap,
|
|
22
|
+
* `composition.container.gap` = `--space-400` (8px).
|
|
23
|
+
*
|
|
24
|
+
* The four Figma variants (Default · First page · Last page · Many pages) are
|
|
25
|
+
* authored SNAPSHOTS of runtime situations, not a parametrized variant set the
|
|
26
|
+
* consumer configures — Figma carries them as a `Type` property, the code does not
|
|
27
|
+
* expose one. The real axis is runtime state, computed from `currentPage` /
|
|
28
|
+
* `totalPages` / `siblingCount`.
|
|
29
|
+
*
|
|
30
|
+
* ─── Deviations from the manifest, both approved ──────────────────────────────
|
|
31
|
+
*
|
|
32
|
+
* 1. MOBILE PREVIOUS / NEXT ARE ICON-ONLY. The manifest gives both triggers a
|
|
33
|
+
* fixed text label (`text.prev-label` / `next-label`) and § Do / Don't
|
|
34
|
+
* explicitly forbids swapping them for icon-only buttons. Below `sm` the row
|
|
35
|
+
* would not fit next to the number run, so the label is hidden with
|
|
36
|
+
* `max-sm:sr-only` — never `sr-only sm:not-sr-only`: a host page may ship an
|
|
37
|
+
* unlayered global `.sr-only` that beats Tailwind's
|
|
38
|
+
* layered `sm:not-sr-only` and hides the label on desktop. This is a CSS hide, not a conditional render: the
|
|
39
|
+
* accessible name stays in the DOM at every width, so the "text label is part
|
|
40
|
+
* of the a11y contract" half of the rule still holds and there is no
|
|
41
|
+
* viewport-dependent markup to mismatch on hydration. The button also drops to
|
|
42
|
+
* symmetric `px-300` there, which lands it at exactly 32×32 (6 + 20px glyph + 6)
|
|
43
|
+
* instead of inheriting Button's optical `pl-400 pr-500` around a hidden label.
|
|
44
|
+
*
|
|
45
|
+
* 2. A PAGE CELL BECOMES AN ANCHOR WHEN `pageHref` IS GIVEN. Spec § Accessibility
|
|
46
|
+
* says every page number is a real `<button>`. Without a crawlable `href` the
|
|
47
|
+
* blog's pages 2+ are unreachable and their articles end up orphaned, so the
|
|
48
|
+
* consumer may hand in a URL builder; the cell then renders `<a href>` with the
|
|
49
|
+
* same `aria-label` / `aria-current` and intercepts plain left-clicks for SPA
|
|
50
|
+
* navigation. Modified clicks (new tab, etc.) fall through to the browser.
|
|
51
|
+
*
|
|
52
|
+
* ─── Two rules that are NOT deviations, and must not drift ────────────────────
|
|
53
|
+
*
|
|
54
|
+
* The row carries no border, no divider and no `overflow-hidden`: the cells are
|
|
55
|
+
* NOT fused into one clipped strip the way Button Group's segments are
|
|
56
|
+
* (`composition.builtFrom.note`), and clipping would additionally swallow every
|
|
57
|
+
* cell's OUTWARD offset focus ring.
|
|
58
|
+
*
|
|
59
|
+
* Nothing renders at `totalPages <= 1` — the whole component is absent, never a
|
|
60
|
+
* lone fully-disabled single-page bar (spec § States). Previous / Next go
|
|
61
|
+
* `disabled` at the ends instead of disappearing, so the row's width and tab
|
|
62
|
+
* order stay stable across pages.
|
|
63
|
+
*
|
|
64
|
+
* Ellipsis is inert: no button, no tab stop, no hover, `aria-hidden` glyph plus
|
|
65
|
+
* visually-hidden copy so a screen-reader user gets an equivalent of the skipped
|
|
66
|
+
* run instead of silence.
|
|
67
|
+
*/
|
|
68
|
+
const paginationVariants = tv({ slots: {
|
|
69
|
+
nav: "flex flex-wrap items-center justify-center gap-400",
|
|
70
|
+
trigger: "max-sm:px-300"
|
|
71
|
+
} });
|
|
72
|
+
/** Inclusive integer range. */
|
|
73
|
+
const range = (start, end) => Array.from({ length: end - start + 1 }, (_, i) => start + i);
|
|
74
|
+
const ELLIPSIS = "ellipsis";
|
|
75
|
+
/**
|
|
76
|
+
* The collapse rule (spec § Variants, manifest `intent.whenToUse`): show every
|
|
77
|
+
* number while the run is short; once it would crowd the row, keep the first
|
|
78
|
+
* page, the last page and `currentPage`'s immediate neighbours, and collapse
|
|
79
|
+
* everything else into ONE ellipsis per side.
|
|
80
|
+
*
|
|
81
|
+
* `1 + 1 + 1 + 2 * siblingCount + 2` = first + last + current + neighbours + the
|
|
82
|
+
* two ellipsis slots, i.e. 7 cells at the default `siblingCount` — which is also
|
|
83
|
+
* where "roughly 7+ pages" in the manifest comes from.
|
|
84
|
+
*
|
|
85
|
+
* The two edge branches deliberately render `3 + 2 * siblingCount` numbers
|
|
86
|
+
* instead of just current's neighbours, so the run keeps the same cell count on
|
|
87
|
+
* page 1 as it has in the middle and the row does not visibly shrink while
|
|
88
|
+
* paging. Reference sequence, `siblingCount=1`, page 6 of 12 (the Many pages
|
|
89
|
+
* example): `1 … 5 [6] 7 … 12`.
|
|
90
|
+
*/
|
|
91
|
+
function paginationRange(currentPage, totalPages, siblingCount) {
|
|
92
|
+
if (totalPages <= 2 * siblingCount + 5) return range(1, totalPages);
|
|
93
|
+
const leftSibling = Math.max(currentPage - siblingCount, 1);
|
|
94
|
+
const rightSibling = Math.min(currentPage + siblingCount, totalPages);
|
|
95
|
+
const showLeftEllipsis = leftSibling > 2;
|
|
96
|
+
const showRightEllipsis = rightSibling < totalPages - 1;
|
|
97
|
+
const edgeCount = 3 + 2 * siblingCount;
|
|
98
|
+
if (!showLeftEllipsis && showRightEllipsis) return [
|
|
99
|
+
...range(1, edgeCount),
|
|
100
|
+
ELLIPSIS,
|
|
101
|
+
totalPages
|
|
102
|
+
];
|
|
103
|
+
if (showLeftEllipsis && !showRightEllipsis) return [
|
|
104
|
+
1,
|
|
105
|
+
ELLIPSIS,
|
|
106
|
+
...range(totalPages - edgeCount + 1, totalPages)
|
|
107
|
+
];
|
|
108
|
+
return [
|
|
109
|
+
1,
|
|
110
|
+
ELLIPSIS,
|
|
111
|
+
...range(leftSibling, rightSibling),
|
|
112
|
+
ELLIPSIS,
|
|
113
|
+
totalPages
|
|
114
|
+
];
|
|
115
|
+
}
|
|
116
|
+
const Pagination = React.forwardRef(({ className, currentPage, totalPages, onPageChange, pageHref, siblingCount = 1, labels, ...props }, ref) => {
|
|
117
|
+
const slots = paginationVariants();
|
|
118
|
+
const isMobile = useIsMobile("sm");
|
|
119
|
+
/**
|
|
120
|
+
* Every string falls back to its Czech default unless the consumer overrode it.
|
|
121
|
+
*
|
|
122
|
+
* `||` and not `??` on purpose. An empty
|
|
123
|
+
* accessible name is never intentional — it would leave `aria-label=" 3"` on
|
|
124
|
+
* a page cell and trip the a11y floor — so an empty override falls back too.
|
|
125
|
+
*/
|
|
126
|
+
const copy = {
|
|
127
|
+
nav: labels?.nav || "Stránkování",
|
|
128
|
+
previous: labels?.previous || "Předchozí",
|
|
129
|
+
next: labels?.next || "Další",
|
|
130
|
+
page: labels?.page || "Stránka",
|
|
131
|
+
morePages: labels?.morePages || "Další stránky"
|
|
132
|
+
};
|
|
133
|
+
if (totalPages <= 1) return null;
|
|
134
|
+
const slotsToRender = paginationRange(currentPage, totalPages, isMobile ? 0 : siblingCount);
|
|
135
|
+
const handleAnchorClick = (page) => (event) => {
|
|
136
|
+
if (event.defaultPrevented || event.button !== 0 || event.metaKey || event.ctrlKey || event.shiftKey || event.altKey) return;
|
|
137
|
+
event.preventDefault();
|
|
138
|
+
onPageChange(page);
|
|
139
|
+
};
|
|
140
|
+
const renderPage = (page) => {
|
|
141
|
+
const isCurrent = page === currentPage;
|
|
142
|
+
const state = isCurrent ? "current" : "default";
|
|
143
|
+
const cellClass = paginationItemVariants({ state });
|
|
144
|
+
const label = `${copy.page} ${page}`;
|
|
145
|
+
const href = pageHref?.(page);
|
|
146
|
+
if (href) return /* @__PURE__ */ jsx("a", {
|
|
147
|
+
href,
|
|
148
|
+
onClick: handleAnchorClick(page),
|
|
149
|
+
"aria-label": label,
|
|
150
|
+
"aria-current": isCurrent ? "page" : void 0,
|
|
151
|
+
"data-fods-part": "item",
|
|
152
|
+
"data-page-state": state,
|
|
153
|
+
className: cellClass,
|
|
154
|
+
children: page
|
|
155
|
+
}, page);
|
|
156
|
+
return /* @__PURE__ */ jsx("button", {
|
|
157
|
+
type: "button",
|
|
158
|
+
onClick: () => onPageChange(page),
|
|
159
|
+
"aria-label": label,
|
|
160
|
+
"aria-current": isCurrent ? "page" : void 0,
|
|
161
|
+
"data-fods-part": "item",
|
|
162
|
+
"data-page-state": state,
|
|
163
|
+
className: cellClass,
|
|
164
|
+
children: page
|
|
165
|
+
}, page);
|
|
166
|
+
};
|
|
167
|
+
return /* @__PURE__ */ jsxs("nav", {
|
|
168
|
+
ref,
|
|
169
|
+
"data-fods-component": "pagination",
|
|
170
|
+
"data-fods-part": "container",
|
|
171
|
+
...props,
|
|
172
|
+
"aria-label": copy.nav,
|
|
173
|
+
className: cn(slots.nav(), className),
|
|
174
|
+
children: [
|
|
175
|
+
/* @__PURE__ */ jsx(Button, {
|
|
176
|
+
variant: "tertiary",
|
|
177
|
+
size: "sm",
|
|
178
|
+
leadingIcon: /* @__PURE__ */ jsx(Icon, { name: "caret-left-small" }),
|
|
179
|
+
disabled: currentPage <= 1,
|
|
180
|
+
onClick: () => onPageChange(currentPage - 1),
|
|
181
|
+
"data-fods-part": "prev",
|
|
182
|
+
className: slots.trigger(),
|
|
183
|
+
children: /* @__PURE__ */ jsx("span", {
|
|
184
|
+
className: "max-sm:sr-only",
|
|
185
|
+
children: copy.previous
|
|
186
|
+
})
|
|
187
|
+
}),
|
|
188
|
+
slotsToRender.map((slot, index) => slot === ELLIPSIS ? /* @__PURE__ */ jsxs("span", {
|
|
189
|
+
"data-fods-part": "item",
|
|
190
|
+
"data-page-state": "ellipsis",
|
|
191
|
+
className: paginationItemVariants({ state: "ellipsis" }),
|
|
192
|
+
children: [/* @__PURE__ */ jsx("span", {
|
|
193
|
+
"aria-hidden": "true",
|
|
194
|
+
children: "…"
|
|
195
|
+
}), /* @__PURE__ */ jsx("span", {
|
|
196
|
+
className: "sr-only",
|
|
197
|
+
children: copy.morePages
|
|
198
|
+
})]
|
|
199
|
+
}, `ellipsis-${index}`) : renderPage(slot)),
|
|
200
|
+
/* @__PURE__ */ jsx(Button, {
|
|
201
|
+
variant: "tertiary",
|
|
202
|
+
size: "sm",
|
|
203
|
+
trailingIcon: /* @__PURE__ */ jsx(Icon, { name: "caret-right-small" }),
|
|
204
|
+
disabled: currentPage >= totalPages,
|
|
205
|
+
onClick: () => onPageChange(currentPage + 1),
|
|
206
|
+
"data-fods-part": "next",
|
|
207
|
+
className: slots.trigger(),
|
|
208
|
+
children: /* @__PURE__ */ jsx("span", {
|
|
209
|
+
className: "max-sm:sr-only",
|
|
210
|
+
children: copy.next
|
|
211
|
+
})
|
|
212
|
+
})
|
|
213
|
+
]
|
|
214
|
+
});
|
|
215
|
+
});
|
|
216
|
+
Pagination.displayName = "Pagination";
|
|
217
|
+
export { Pagination, paginationRange, paginationVariants };
|
|
@@ -0,0 +1,3 @@
|
|
|
1
|
+
import { Pagination, PaginationLabels, PaginationProps, paginationRange, paginationVariants } from "./Pagination.js";
|
|
2
|
+
import { PaginationItemState, paginationItemVariants } from "../../internal/paginationItem.js";
|
|
3
|
+
export { Pagination, type PaginationItemState, type PaginationLabels, type PaginationProps, paginationItemVariants, paginationRange, paginationVariants };
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export { popoverBodyClass, popoverGroupClass, popoverSurfaceVariants } from "../../internal/popoverSurface.js";
|
|
@@ -0,0 +1,260 @@
|
|
|
1
|
+
import { ProgressBarItemLayout, ProgressBarItemSize, ProgressBarItemVariant } from "../../internal/progressBarItem.js";
|
|
2
|
+
import * as React from "react";
|
|
3
|
+
/**
|
|
4
|
+
* ProgressBar — a multi-step progress indicator (spec 04-molecules/progress-bar.md,
|
|
5
|
+
* manifest progress-bar.manifest.json 1.11.1; the step is the private
|
|
6
|
+
* _progress-bar-item.manifest.json 3.4.0, whose recipe lives in
|
|
7
|
+
* `internal/progressBarItem.ts`).
|
|
8
|
+
*
|
|
9
|
+
* One continuous rail behind self-describing markers, filled up to the Current step. Use
|
|
10
|
+
* it for a fixed, ordered sequence whose position must be visible at a glance — a wizard
|
|
11
|
+
* step band (Small) or a marketing rollout narrative (Large). NOT for paging a result set
|
|
12
|
+
* (→ Pagination), NOT for a percentage or indeterminate load (it has no such mode), NOT
|
|
13
|
+
* for independent actions (→ Button Group).
|
|
14
|
+
*
|
|
15
|
+
* ─── The bar owns ONE track ───────────────────────────────────────────────────
|
|
16
|
+
*
|
|
17
|
+
* `intent.rules[0]`: the rail and the fill belong to the BAR, never to the steps. That is
|
|
18
|
+
* the whole reason the v1 shape (StepperItem with per-item connector halves) is retired —
|
|
19
|
+
* a single element can slide forward, N joined segments cannot. Track and fill are two
|
|
20
|
+
* absolutely positioned elements rendered BEFORE the step list — as a SIBLING of the
|
|
21
|
+
* `<ol>`, never inside it, so the list holds the steps and nothing else — and the paint
|
|
22
|
+
* order comes out rail → fill → halo → marker from DOM order alone (`delivery.react`).
|
|
23
|
+
* The only `z-index` in the bar is the Done wash's `::before` layer (`-z-10`), scoped
|
|
24
|
+
* by the root's `isolate` so it paints under the rail and never escapes the bar.
|
|
25
|
+
*
|
|
26
|
+
* Progress is expressed entirely through the children: everything before `currentStep` is
|
|
27
|
+
* Done, `currentStep` is Current, everything after is Upcoming. The fill length is derived
|
|
28
|
+
* from that invariant — `(currentStep / (stepCount − 1)) * 100%` — and is never settable
|
|
29
|
+
* on its own. At the 2-step floor the two valid renders (0% and 100%) are correct results
|
|
30
|
+
* of that formula, not edge cases (`intent.rules[5]`).
|
|
31
|
+
*
|
|
32
|
+
* ─── Rail geometry: measured from real marker CENTRES ─────────────────────────
|
|
33
|
+
*
|
|
34
|
+
* `motion.states.value.note`, verbatim: "Measure the rail's ends from the real marker centres,
|
|
35
|
+
* not from a halo-derived inset: a titled step is as wide as its text, so a halo-based
|
|
36
|
+
* inset leaves the rail sticking out past the first marker."
|
|
37
|
+
*
|
|
38
|
+
* Both layouts get that from CSS grid, with no measurement and no JS. The grid is owned
|
|
39
|
+
* by the root wrapper; the `<ol>` spans it and takes over its tracks through `subgrid`,
|
|
40
|
+
* so the steps sit in the wrapper's tracks while the track — the `<ol>`'s sibling — is
|
|
41
|
+
* placed into the same grid areas as before. `subgrid`, not `display: contents`: the
|
|
42
|
+
* Row → Stack fallback measures real boxes, and a `contents` list has none (older WebKit
|
|
43
|
+
* also drops its list role).
|
|
44
|
+
*
|
|
45
|
+
* - Row — N equal columns (`gridTemplateColumns: repeat(N, minmax(0, 1fr))`), each marker
|
|
46
|
+
* horizontally centred in its own column, so the first and last marker centres sit
|
|
47
|
+
* exactly half a column in from each edge: `left = right = 50 / N %`. The track is an
|
|
48
|
+
* ABSOLUTELY positioned grid child placed into the grid area `1 / -1` of row 1 — a grid
|
|
49
|
+
* area is the containing block for an abspos grid child, which is what makes the
|
|
50
|
+
* percentage resolve against the steps' box (and keeps the rail inside the pointer's top
|
|
51
|
+
* padding instead of measuring from the border edge).
|
|
52
|
+
*
|
|
53
|
+
* - Stack — N rows; the marker is at the top of its step, so its centre is half a marker
|
|
54
|
+
* box below the step's top edge. The track is placed in grid area `1 / N`, then `top:
|
|
55
|
+
* box/2` walks its head onto the first marker's centre and a negative `bottom` walks its
|
|
56
|
+
* tail onto the last one's. That bottom inset is `−(row gap + box/2)`, NOT `−box/2`: a
|
|
57
|
+
* grid area ending on line N reaches the END of track N−1, and the last track starts one
|
|
58
|
+
* GUTTER further down — so the rail would otherwise stop --space-200 short of the last
|
|
59
|
+
* marker, at every step count. The gap term stays a `calc()` on the token so the rail
|
|
60
|
+
* follows a retune of the row gap instead of silently drifting.
|
|
61
|
+
*
|
|
62
|
+
* Halving the marker BOX (13 / 12), not the halo: the halo is centred on the box and only
|
|
63
|
+
* describes how much air the rail loses at each marker, never where the centre is.
|
|
64
|
+
*
|
|
65
|
+
* ─── Motion ───────────────────────────────────────────────────────────────────
|
|
66
|
+
*
|
|
67
|
+
* The fill transitions `width` (Row) / `height` (Stack) over --duration-normal with
|
|
68
|
+
* --easing-standard. `motion` calls this the deliberate exception to the
|
|
69
|
+
* transform-and-opacity-only rule: the fill's ENDS carry the meaning (it must stop exactly
|
|
70
|
+
* on a marker centre) and a scaled transform would distort the --radius-200 cap.
|
|
71
|
+
*
|
|
72
|
+
* The arriving Current dot fades in (opacity 0 → 1, no scale) over --duration-fast on
|
|
73
|
+
* --easing-enter, delayed by (normal − fast) so it lands exactly as the fill arrives
|
|
74
|
+
* (`_progress-bar-item` 3.4.1 `motion.states.value`, inherited by the bar). It is a named keyframe, not a
|
|
75
|
+
* transition, because the dot is a newly MOUNTED element on every step change — and it is
|
|
76
|
+
* armed only after the first `currentStep` change, since "a mounted bar renders its
|
|
77
|
+
* position with no animation" (`motion.trigger`).
|
|
78
|
+
*
|
|
79
|
+
* Under prefers-reduced-motion both are KEPT and shortened to --duration-instant, never
|
|
80
|
+
* removed: a progress indicator is essential motion, and a frozen bar is indistinguishable
|
|
81
|
+
* from a stalled one (`motion.reducedMotion`).
|
|
82
|
+
*
|
|
83
|
+
* ─── Row ↔ Stack: the bar's own content-fit fallback (1.9.0) ─────────────────
|
|
84
|
+
*
|
|
85
|
+
* `layout` is the PREFERRED layout, not a breakpoint. Given Row, the bar renders Row,
|
|
86
|
+
* measures real overflow of its own root (`scrollWidth > clientWidth`) and falls back to
|
|
87
|
+
* Stack by itself — the same principle as 06-patterns/responsive-collapse.md
|
|
88
|
+
* (`delivery.react`: "A consumer passes the preferred Layout and never has to wire the
|
|
89
|
+
* fallback"). `_progress-bar-item` `sizes[].minWidthWhen` (150 on a step with text) is the
|
|
90
|
+
* clip floor that makes that measurement fire. The question is only ever asked in Row —
|
|
91
|
+
* asked while stacked it would always answer "fits" and the bar could never go back — so
|
|
92
|
+
* every width change of the PARENT re-renders Row once and measures it before paint. The
|
|
93
|
+
* parent, not the root: a stacked bar may be content-sized (`max-w-fit`) and then never
|
|
94
|
+
* resizes. The rendered layout is published as `data-layout` for consumer styling. DOM
|
|
95
|
+
* order is sequence order in both layouts, so `aria-current` needs no per-layout
|
|
96
|
+
* special-casing.
|
|
97
|
+
*
|
|
98
|
+
* ─── Done steps are the only interactive element ──────────────────────────────
|
|
99
|
+
*
|
|
100
|
+
* `_progress-bar-item` 3.0.0 gave the step an Interaction axis (Default · Hover · Active)
|
|
101
|
+
* on State=Done: a completed step is a button that returns the flow to it. Current and
|
|
102
|
+
* Upcoming stay inert — a user cannot skip ahead — the bar itself never holds focus, and
|
|
103
|
+
* nothing here takes `disabled`. The ring attaches to the step's own button (manifest
|
|
104
|
+
* `focus`), NOT at this level as the pre-3.0.0 comment here predicted.
|
|
105
|
+
*
|
|
106
|
+
* It is OPT-IN, through `onStepClick` (manifest 1.10.0, `_progress-bar-item` 3.1.0): a
|
|
107
|
+
* product wizard wires the return; a marketing timeline (the e-invoice rollout) renders
|
|
108
|
+
* Done static — no button, no hover / press wash, no focus stop. Without the callback the
|
|
109
|
+
* markup is exactly what shipped before 3.0.0.
|
|
110
|
+
*
|
|
111
|
+
* ─── Accessibility (spec § Accessibility) ─────────────────────────────────────
|
|
112
|
+
*
|
|
113
|
+
* `<ol>` + one `<li>` per step carries the sequence; `aria-current="step"` marks the
|
|
114
|
+
* Current one. Marker, halo, ring and glyph are decorative and `aria-hidden` — a step's
|
|
115
|
+
* accessible name is its Title. In the bare-marker mode (both text booleans off) there is
|
|
116
|
+
* no Title to draw that name from, so `stepLabels` becomes REQUIRED through the props
|
|
117
|
+
* union and renders visually hidden: `aria-current` alone does not let a screen-reader
|
|
118
|
+
* user place themselves in the sequence. A step that merely omits its `title` under the
|
|
119
|
+
* default `showTitle` is outside what the union can see, so it gets a dev-only warning
|
|
120
|
+
* when no `stepLabels` entry covers it — a clickable Done step would otherwise be a
|
|
121
|
+
* nameless button. State is coded by marker SHAPE as well as colour
|
|
122
|
+
* (check / ring / ring + digit), so it survives a grayscale rendering.
|
|
123
|
+
*
|
|
124
|
+
* SIX sub-AA ratios here are REGISTERED upstream exceptions, not oversights — do not
|
|
125
|
+
* re-derive or "fix" them. accessibility.md carries one named section per case:
|
|
126
|
+
* the Upcoming digit's --text-placeholder (2.71:1, decorative-duplicated), the Orange
|
|
127
|
+
* fill (2.37:1 / 1.79:1, confined to the marketing slots), the --outline-default rail
|
|
128
|
+
* (1.32:1 — the rail is ground, not a signal), the pointer callout's --primary label
|
|
129
|
+
* and arrow (2.37:1, `Show pointer` defaults off outside marketing) and the Upcoming
|
|
130
|
+
* ring's --outline-strong (1.73:1, same token and reasoning as the resting control &
|
|
131
|
+
* field edge border) and the Done step's --bg-hover / --bg-active wash (cursor and focus
|
|
132
|
+
* ring duplicate the state).
|
|
133
|
+
*/
|
|
134
|
+
declare const progressBarVariants: import("tailwind-variants").TVReturnType<{
|
|
135
|
+
size: {
|
|
136
|
+
lg: {};
|
|
137
|
+
sm: {};
|
|
138
|
+
};
|
|
139
|
+
layout: {
|
|
140
|
+
row: {
|
|
141
|
+
track: string;
|
|
142
|
+
fill: string;
|
|
143
|
+
};
|
|
144
|
+
stack: {
|
|
145
|
+
root: string;
|
|
146
|
+
track: string;
|
|
147
|
+
fill: string;
|
|
148
|
+
};
|
|
149
|
+
};
|
|
150
|
+
/** Manifest Accent. The rail stays neutral in both; only the fill takes the accent. */
|
|
151
|
+
variant: {
|
|
152
|
+
blue: {
|
|
153
|
+
fill: string;
|
|
154
|
+
};
|
|
155
|
+
orange: {
|
|
156
|
+
fill: string;
|
|
157
|
+
};
|
|
158
|
+
};
|
|
159
|
+
/**
|
|
160
|
+
* Row only: reserves the height the floating pointer callout occupies. Applied at the
|
|
161
|
+
* BAR level and driven by "any step has a pointer", never by which step is Current —
|
|
162
|
+
* otherwise every marker would jump by the reserve as the sequence advances.
|
|
163
|
+
*/
|
|
164
|
+
hasPointer: {
|
|
165
|
+
true: {};
|
|
166
|
+
false: {};
|
|
167
|
+
};
|
|
168
|
+
}, {
|
|
169
|
+
/**
|
|
170
|
+
* The wrapper: owns the grid in both layouts and is the positioning context for the
|
|
171
|
+
* track. `isolate` scopes the Done wash — a `-z-10` pseudo on the step button, see
|
|
172
|
+
* `internal/progressBarItem.ts` — to the bar, so it paints under the rail.
|
|
173
|
+
*/
|
|
174
|
+
root: string;
|
|
175
|
+
/** The `<ol>`: the steps and nothing else, laid onto the root's tracks via `subgrid`. */
|
|
176
|
+
list: string;
|
|
177
|
+
/** The neutral rail (`parts.track`) — accent-independent, --outline-default in both accents. */
|
|
178
|
+
track: string;
|
|
179
|
+
/**
|
|
180
|
+
* The progressed run (`parts.track-fill`) — same geometry as the rail, ending on the
|
|
181
|
+
* Current marker's centre. Its length is an inline percentage, see the header.
|
|
182
|
+
*/
|
|
183
|
+
fill: string;
|
|
184
|
+
}, undefined, undefined, undefined, undefined>;
|
|
185
|
+
/** Manifest Size axis — `lg` = marketing / hero, `sm` = the product wizard band. */
|
|
186
|
+
export type ProgressBarSize = ProgressBarItemSize;
|
|
187
|
+
/** Manifest Layout axis — the PREFERRED layout; Row falls back to Stack when it overflows. */
|
|
188
|
+
export type ProgressBarLayout = ProgressBarItemLayout;
|
|
189
|
+
/** Manifest Accent axis — `orange` only in the four marketing / signature slots. */
|
|
190
|
+
export type ProgressBarVariant = ProgressBarItemVariant;
|
|
191
|
+
export interface ProgressBarStep {
|
|
192
|
+
/** Step label — short, active-voice, ~28 chars; wraps rather than truncates. */
|
|
193
|
+
title?: string;
|
|
194
|
+
/** One supporting line, ~55 chars, ellipsis past two lines. */
|
|
195
|
+
detail?: string;
|
|
196
|
+
/**
|
|
197
|
+
* Current-only marketing callout, e.g. "Jste tady". Row only — Stack masters carry no
|
|
198
|
+
* pointer node. A fixed short phrase in the hand-lettered marketing voice, never user
|
|
199
|
+
* content and never a wizard tone.
|
|
200
|
+
*/
|
|
201
|
+
pointerLabel?: string;
|
|
202
|
+
}
|
|
203
|
+
export interface ProgressBarBaseProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'children'> {
|
|
204
|
+
/**
|
|
205
|
+
* The sequence, 2–6 steps (`intent.variants`). Content, not a variant: there is no
|
|
206
|
+
* Steps axis. Below 2 there is no progression to show and the fill renders 0%.
|
|
207
|
+
*/
|
|
208
|
+
steps: ProgressBarStep[];
|
|
209
|
+
/**
|
|
210
|
+
* 0-based index of the Current step. Everything before it is Done, everything after is
|
|
211
|
+
* Upcoming, and the fill length follows — exactly one Current per bar.
|
|
212
|
+
*/
|
|
213
|
+
currentStep: number;
|
|
214
|
+
size?: ProgressBarSize;
|
|
215
|
+
/**
|
|
216
|
+
* The preferred layout. Row falls back to Stack on its own whenever it overflows the
|
|
217
|
+
* available width (1.9.0) — never wire the fallback in the consumer. Stack is final.
|
|
218
|
+
*/
|
|
219
|
+
layout?: ProgressBarLayout;
|
|
220
|
+
variant?: ProgressBarVariant;
|
|
221
|
+
/** Figma `Show title`. Off + `showDetail` off = the bare-marker wizard band. */
|
|
222
|
+
showTitle?: boolean;
|
|
223
|
+
/** Figma `Show detail`. */
|
|
224
|
+
showDetail?: boolean;
|
|
225
|
+
/**
|
|
226
|
+
* Figma `Show number` (`properties[Show number].maps`), code-only on the bar: it covers
|
|
227
|
+
* every Upcoming step at once, because Figma cannot bind a parent boolean to a nested
|
|
228
|
+
* instance's property. Off leaves the neutral ring EMPTY at the same size — Current keeps
|
|
229
|
+
* its centre dot, so the states still differ by shape rather than by colour alone.
|
|
230
|
+
*/
|
|
231
|
+
showNumbers?: boolean;
|
|
232
|
+
/**
|
|
233
|
+
* Makes every Done step a button that calls back with its 0-based index
|
|
234
|
+
* (`_progress-bar-item` 3.0.0 Interaction). Current and Upcoming never become
|
|
235
|
+
* interactive, whatever this is set to.
|
|
236
|
+
*
|
|
237
|
+
* Opt-in on purpose: the manifest states the button unconditionally because it
|
|
238
|
+
* describes a wizard, but a bar that narrates a fixed timeline has nowhere to jump
|
|
239
|
+
* back to, and buttons there are dead tab stops. Omit it and the step renders
|
|
240
|
+
* exactly as it did before 3.0.0.
|
|
241
|
+
*/
|
|
242
|
+
onStepClick?: (index: number) => void;
|
|
243
|
+
}
|
|
244
|
+
/**
|
|
245
|
+
* `stepLabels` is REQUIRED once the Title is hidden — enforced in the type rather than at
|
|
246
|
+
* runtime, the same shape `FilterChipProps` uses for its clear-button name. Spec
|
|
247
|
+
* § Accessibility: "In the bare-marker mode (Small × Row, both text booleans off) there is
|
|
248
|
+
* no Title to draw that name from, so the consumer must supply a visually-hidden ordinal
|
|
249
|
+
* label per step." The design system is locale-agnostic — these strings come from the
|
|
250
|
+
* consumer's own translations ("Krok 1", "Step 1", …), never from a default here.
|
|
251
|
+
*/
|
|
252
|
+
export type ProgressBarProps = ProgressBarBaseProps & ({
|
|
253
|
+
showTitle?: true;
|
|
254
|
+
stepLabels?: string[];
|
|
255
|
+
} | {
|
|
256
|
+
showTitle: false;
|
|
257
|
+
stepLabels: string[];
|
|
258
|
+
});
|
|
259
|
+
declare const ProgressBar: React.ForwardRefExoticComponent<ProgressBarProps & React.RefAttributes<HTMLDivElement>>;
|
|
260
|
+
export { ProgressBar, progressBarVariants };
|