@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,343 @@
|
|
|
1
|
+
"use client";
|
|
2
|
+
import * as React from 'react';
|
|
3
|
+
import { tv } from '../../internal/tailwind-variants';
|
|
4
|
+
import { Icon } from '../icon/Icon';
|
|
5
|
+
import { useIsMobile } from '../../internal/useIsMobile';
|
|
6
|
+
import { Button } from '../button/Button';
|
|
7
|
+
import { paginationItemVariants, type PaginationItemState } from '../../internal/paginationItem';
|
|
8
|
+
import { cn } from '../../internal/utils';
|
|
9
|
+
|
|
10
|
+
/**
|
|
11
|
+
* Pagination — the paging footer under a Table or any long, page-broken list
|
|
12
|
+
* (spec 04-molecules/pagination.md, manifest pagination.manifest.json 1.3.1;
|
|
13
|
+
* cell manifest _pagination-item.manifest.json 1.3.3).
|
|
14
|
+
*
|
|
15
|
+
* `[Previous] numbers [Next]`, one 32px-high row. The manifest is
|
|
16
|
+
* `kind: "composite"` with empty `parts` and empty `families` — Pagination owns
|
|
17
|
+
* NO colour of its own. Every visual fact is inherited:
|
|
18
|
+
* - each number / ellipsis cell from `internal/paginationItem.ts`
|
|
19
|
+
* - Previous / Next from the hosted `Button` (Tertiary, S) — manifest `slots`
|
|
20
|
+
* The single token this component binds itself is the row gap,
|
|
21
|
+
* `composition.container.gap` = `--space-400` (8px).
|
|
22
|
+
*
|
|
23
|
+
* The four Figma variants (Default · First page · Last page · Many pages) are
|
|
24
|
+
* authored SNAPSHOTS of runtime situations, not a parametrized variant set the
|
|
25
|
+
* consumer configures — Figma carries them as a `Type` property, the code does not
|
|
26
|
+
* expose one. The real axis is runtime state, computed from `currentPage` /
|
|
27
|
+
* `totalPages` / `siblingCount`.
|
|
28
|
+
*
|
|
29
|
+
* ─── Deviations from the manifest, both approved ──────────────────────────────
|
|
30
|
+
*
|
|
31
|
+
* 1. MOBILE PREVIOUS / NEXT ARE ICON-ONLY. The manifest gives both triggers a
|
|
32
|
+
* fixed text label (`text.prev-label` / `next-label`) and § Do / Don't
|
|
33
|
+
* explicitly forbids swapping them for icon-only buttons. Below `sm` the row
|
|
34
|
+
* would not fit next to the number run, so the label is hidden with
|
|
35
|
+
* `max-sm:sr-only` — never `sr-only sm:not-sr-only`: a host page may ship an
|
|
36
|
+
* unlayered global `.sr-only` that beats Tailwind's
|
|
37
|
+
* layered `sm:not-sr-only` and hides the label on desktop. This is a CSS hide, not a conditional render: the
|
|
38
|
+
* accessible name stays in the DOM at every width, so the "text label is part
|
|
39
|
+
* of the a11y contract" half of the rule still holds and there is no
|
|
40
|
+
* viewport-dependent markup to mismatch on hydration. The button also drops to
|
|
41
|
+
* symmetric `px-300` there, which lands it at exactly 32×32 (6 + 20px glyph + 6)
|
|
42
|
+
* instead of inheriting Button's optical `pl-400 pr-500` around a hidden label.
|
|
43
|
+
*
|
|
44
|
+
* 2. A PAGE CELL BECOMES AN ANCHOR WHEN `pageHref` IS GIVEN. Spec § Accessibility
|
|
45
|
+
* says every page number is a real `<button>`. Without a crawlable `href` the
|
|
46
|
+
* blog's pages 2+ are unreachable and their articles end up orphaned, so the
|
|
47
|
+
* consumer may hand in a URL builder; the cell then renders `<a href>` with the
|
|
48
|
+
* same `aria-label` / `aria-current` and intercepts plain left-clicks for SPA
|
|
49
|
+
* navigation. Modified clicks (new tab, etc.) fall through to the browser.
|
|
50
|
+
*
|
|
51
|
+
* ─── Two rules that are NOT deviations, and must not drift ────────────────────
|
|
52
|
+
*
|
|
53
|
+
* The row carries no border, no divider and no `overflow-hidden`: the cells are
|
|
54
|
+
* NOT fused into one clipped strip the way Button Group's segments are
|
|
55
|
+
* (`composition.builtFrom.note`), and clipping would additionally swallow every
|
|
56
|
+
* cell's OUTWARD offset focus ring.
|
|
57
|
+
*
|
|
58
|
+
* Nothing renders at `totalPages <= 1` — the whole component is absent, never a
|
|
59
|
+
* lone fully-disabled single-page bar (spec § States). Previous / Next go
|
|
60
|
+
* `disabled` at the ends instead of disappearing, so the row's width and tab
|
|
61
|
+
* order stay stable across pages.
|
|
62
|
+
*
|
|
63
|
+
* Ellipsis is inert: no button, no tab stop, no hover, `aria-hidden` glyph plus
|
|
64
|
+
* visually-hidden copy so a screen-reader user gets an equivalent of the skipped
|
|
65
|
+
* run instead of silence.
|
|
66
|
+
*/
|
|
67
|
+
const paginationVariants = tv({
|
|
68
|
+
slots: {
|
|
69
|
+
// The landmark row. `composition.container.gap` — the one token Pagination
|
|
70
|
+
// owns. `flex-wrap` is a safety net for a very long run at a narrow width;
|
|
71
|
+
// it is not a manifest fact.
|
|
72
|
+
nav: 'flex flex-wrap items-center justify-center gap-400',
|
|
73
|
+
// Previous / Next. Only the mobile padding correction lives here — the ink,
|
|
74
|
+
// height and radius are Button's own contract (see deviation 1).
|
|
75
|
+
trigger: 'max-sm:px-300',
|
|
76
|
+
},
|
|
77
|
+
});
|
|
78
|
+
|
|
79
|
+
export interface PaginationLabels {
|
|
80
|
+
/**
|
|
81
|
+
* Names the landmark itself — `<nav aria-label>`. Spec § Copy: "Stránkování",
|
|
82
|
+
* matching the pattern other landmark labels use, never a generic "Navigace".
|
|
83
|
+
*/
|
|
84
|
+
nav: string;
|
|
85
|
+
/**
|
|
86
|
+
* Fixed nav labels (manifest `text.prev-label` / `next-label`) — always the
|
|
87
|
+
* market's direct equivalent of "Předchozí" / "Další", never a per-screen
|
|
88
|
+
* synonym. `Zpět` / `Vpřed` would break consistency with every other paged
|
|
89
|
+
* list in the product.
|
|
90
|
+
*/
|
|
91
|
+
previous: string;
|
|
92
|
+
next: string;
|
|
93
|
+
/**
|
|
94
|
+
* Accessible name PREFIX for a page cell, composed with the number:
|
|
95
|
+
* `"Stránka"` → `aria-label="Stránka 3"`, as `_pagination-item` 1.3.2 `delivery.react`
|
|
96
|
+
* and pagination.md § Accessibility spell it (owner ruling 2026-10-20).
|
|
97
|
+
*/
|
|
98
|
+
page: string;
|
|
99
|
+
/** Visually-hidden equivalent of a collapsed run, e.g. "Další stránky". */
|
|
100
|
+
morePages: string;
|
|
101
|
+
}
|
|
102
|
+
|
|
103
|
+
export interface PaginationProps
|
|
104
|
+
extends Omit<React.HTMLAttributes<HTMLElement>, 'children'> {
|
|
105
|
+
/** The active page, 1-based. Drives which cell renders Current. */
|
|
106
|
+
currentPage: number;
|
|
107
|
+
/** Total page count. At `<= 1` the component renders nothing. */
|
|
108
|
+
totalPages: number;
|
|
109
|
+
onPageChange: (page: number) => void;
|
|
110
|
+
/**
|
|
111
|
+
* Optional URL builder. Present → cells render as crawlable anchors
|
|
112
|
+
* (see deviation 2); absent → plain buttons per spec.
|
|
113
|
+
*/
|
|
114
|
+
pageHref?: (page: number) => string;
|
|
115
|
+
/**
|
|
116
|
+
* Neighbours of `currentPage` kept visible on each side before collapsing to
|
|
117
|
+
* an ellipsis (manifest `properties[2]`, default 1 — the shape the Many pages
|
|
118
|
+
* Figma example demonstrates). Forced to 0 below `sm`, where a five-cell run
|
|
119
|
+
* plus both triggers does not fit: the row degrades to `1 … 6 … 12`.
|
|
120
|
+
*/
|
|
121
|
+
siblingCount?: number;
|
|
122
|
+
/**
|
|
123
|
+
* Copy override. OPTIONAL — every string falls back to the component's own
|
|
124
|
+
* Czech default, so the common case passes nothing at all.
|
|
125
|
+
* Override a single key when a screen (or a non-Czech market) needs different
|
|
126
|
+
* wording; the rest keep their defaults. The defaults are Czech; an app with more
|
|
127
|
+
* language versions passes them from its translations.
|
|
128
|
+
*/
|
|
129
|
+
labels?: Partial<PaginationLabels>;
|
|
130
|
+
}
|
|
131
|
+
|
|
132
|
+
/** Inclusive integer range. */
|
|
133
|
+
const range = (start: number, end: number): number[] =>
|
|
134
|
+
Array.from({ length: end - start + 1 }, (_, i) => start + i);
|
|
135
|
+
|
|
136
|
+
const ELLIPSIS = 'ellipsis' as const;
|
|
137
|
+
type PageSlot = number | typeof ELLIPSIS;
|
|
138
|
+
|
|
139
|
+
/**
|
|
140
|
+
* The collapse rule (spec § Variants, manifest `intent.whenToUse`): show every
|
|
141
|
+
* number while the run is short; once it would crowd the row, keep the first
|
|
142
|
+
* page, the last page and `currentPage`'s immediate neighbours, and collapse
|
|
143
|
+
* everything else into ONE ellipsis per side.
|
|
144
|
+
*
|
|
145
|
+
* `1 + 1 + 1 + 2 * siblingCount + 2` = first + last + current + neighbours + the
|
|
146
|
+
* two ellipsis slots, i.e. 7 cells at the default `siblingCount` — which is also
|
|
147
|
+
* where "roughly 7+ pages" in the manifest comes from.
|
|
148
|
+
*
|
|
149
|
+
* The two edge branches deliberately render `3 + 2 * siblingCount` numbers
|
|
150
|
+
* instead of just current's neighbours, so the run keeps the same cell count on
|
|
151
|
+
* page 1 as it has in the middle and the row does not visibly shrink while
|
|
152
|
+
* paging. Reference sequence, `siblingCount=1`, page 6 of 12 (the Many pages
|
|
153
|
+
* example): `1 … 5 [6] 7 … 12`.
|
|
154
|
+
*/
|
|
155
|
+
export function paginationRange(
|
|
156
|
+
currentPage: number,
|
|
157
|
+
totalPages: number,
|
|
158
|
+
siblingCount: number,
|
|
159
|
+
): PageSlot[] {
|
|
160
|
+
const maxCells = 2 * siblingCount + 5;
|
|
161
|
+
if (totalPages <= maxCells) return range(1, totalPages);
|
|
162
|
+
|
|
163
|
+
const leftSibling = Math.max(currentPage - siblingCount, 1);
|
|
164
|
+
const rightSibling = Math.min(currentPage + siblingCount, totalPages);
|
|
165
|
+
const showLeftEllipsis = leftSibling > 2;
|
|
166
|
+
const showRightEllipsis = rightSibling < totalPages - 1;
|
|
167
|
+
const edgeCount = 3 + 2 * siblingCount;
|
|
168
|
+
|
|
169
|
+
if (!showLeftEllipsis && showRightEllipsis) {
|
|
170
|
+
return [...range(1, edgeCount), ELLIPSIS, totalPages];
|
|
171
|
+
}
|
|
172
|
+
if (showLeftEllipsis && !showRightEllipsis) {
|
|
173
|
+
return [1, ELLIPSIS, ...range(totalPages - edgeCount + 1, totalPages)];
|
|
174
|
+
}
|
|
175
|
+
return [1, ELLIPSIS, ...range(leftSibling, rightSibling), ELLIPSIS, totalPages];
|
|
176
|
+
}
|
|
177
|
+
|
|
178
|
+
const Pagination = React.forwardRef<HTMLElement, PaginationProps>(
|
|
179
|
+
(
|
|
180
|
+
{
|
|
181
|
+
className,
|
|
182
|
+
currentPage,
|
|
183
|
+
totalPages,
|
|
184
|
+
onPageChange,
|
|
185
|
+
pageHref,
|
|
186
|
+
siblingCount = 1,
|
|
187
|
+
labels,
|
|
188
|
+
...props
|
|
189
|
+
},
|
|
190
|
+
ref,
|
|
191
|
+
) => {
|
|
192
|
+
const slots = paginationVariants();
|
|
193
|
+
// A VIEWPORT measure, read synchronously on the first render (the hook is
|
|
194
|
+
// built on useSyncExternalStore precisely so it does not flash or fight
|
|
195
|
+
// hydration). Called before the early return below — rules of hooks.
|
|
196
|
+
const isMobile = useIsMobile('sm');
|
|
197
|
+
|
|
198
|
+
/**
|
|
199
|
+
* Every string falls back to its Czech default unless the consumer overrode it.
|
|
200
|
+
*
|
|
201
|
+
* `||` and not `??` on purpose. An empty
|
|
202
|
+
* accessible name is never intentional — it would leave `aria-label=" 3"` on
|
|
203
|
+
* a page cell and trip the a11y floor — so an empty override falls back too.
|
|
204
|
+
*/
|
|
205
|
+
const copy: PaginationLabels = {
|
|
206
|
+
nav: labels?.nav || 'Stránkování',
|
|
207
|
+
previous: labels?.previous || 'Předchozí',
|
|
208
|
+
next: labels?.next || 'Další',
|
|
209
|
+
page: labels?.page || 'Stránka',
|
|
210
|
+
morePages: labels?.morePages || 'Další stránky',
|
|
211
|
+
};
|
|
212
|
+
|
|
213
|
+
// Never a disabled single-page bar (spec § States) — so a call site does not
|
|
214
|
+
// have to gate on the page count itself.
|
|
215
|
+
if (totalPages <= 1) return null;
|
|
216
|
+
|
|
217
|
+
// Below `sm` the run collapses to first · current · last (`1 … 6 … 12`): five
|
|
218
|
+
// cells plus two triggers do not fit at 375px. This is the one place the
|
|
219
|
+
// component overrides the consumer's `siblingCount`, and it overrides DOWN
|
|
220
|
+
// only — a narrow viewport can never grow the run.
|
|
221
|
+
const effectiveSiblingCount = isMobile ? 0 : siblingCount;
|
|
222
|
+
const slotsToRender = paginationRange(currentPage, totalPages, effectiveSiblingCount);
|
|
223
|
+
|
|
224
|
+
// Plain left-clicks drive SPA navigation; a modified click (new tab, middle
|
|
225
|
+
// button) is left to the browser so the crawlable href stays useful to humans.
|
|
226
|
+
const handleAnchorClick = (page: number) => (event: React.MouseEvent<HTMLAnchorElement>) => {
|
|
227
|
+
if (
|
|
228
|
+
event.defaultPrevented
|
|
229
|
+
|| event.button !== 0
|
|
230
|
+
|| event.metaKey
|
|
231
|
+
|| event.ctrlKey
|
|
232
|
+
|| event.shiftKey
|
|
233
|
+
|| event.altKey
|
|
234
|
+
) return;
|
|
235
|
+
event.preventDefault();
|
|
236
|
+
onPageChange(page);
|
|
237
|
+
};
|
|
238
|
+
|
|
239
|
+
const renderPage = (page: number) => {
|
|
240
|
+
const isCurrent = page === currentPage;
|
|
241
|
+
const state: PaginationItemState = isCurrent ? 'current' : 'default';
|
|
242
|
+
const cellClass = paginationItemVariants({ state });
|
|
243
|
+
const label = `${copy.page} ${page}`;
|
|
244
|
+
const href = pageHref?.(page);
|
|
245
|
+
|
|
246
|
+
// `data-page-state` is published for the same reason DatePicker publishes
|
|
247
|
+
// `data-day-state`: the state is computed here and nothing outside could
|
|
248
|
+
// otherwise select a cell by what it shows. It is what lets CSS, tests and
|
|
249
|
+
// the FODS probe tell a Current cell from a Default one in a row that
|
|
250
|
+
// renders both at once — `aria-current` can express "is current" but not
|
|
251
|
+
// "is NOT current".
|
|
252
|
+
if (href) {
|
|
253
|
+
return (
|
|
254
|
+
<a
|
|
255
|
+
key={page}
|
|
256
|
+
href={href}
|
|
257
|
+
onClick={handleAnchorClick(page)}
|
|
258
|
+
aria-label={label}
|
|
259
|
+
aria-current={isCurrent ? 'page' : undefined}
|
|
260
|
+
data-fods-part="item"
|
|
261
|
+
data-page-state={state}
|
|
262
|
+
className={cellClass}
|
|
263
|
+
>
|
|
264
|
+
{page}
|
|
265
|
+
</a>
|
|
266
|
+
);
|
|
267
|
+
}
|
|
268
|
+
|
|
269
|
+
return (
|
|
270
|
+
<button
|
|
271
|
+
key={page}
|
|
272
|
+
type="button"
|
|
273
|
+
onClick={() => onPageChange(page)}
|
|
274
|
+
aria-label={label}
|
|
275
|
+
aria-current={isCurrent ? 'page' : undefined}
|
|
276
|
+
data-fods-part="item"
|
|
277
|
+
data-page-state={state}
|
|
278
|
+
className={cellClass}
|
|
279
|
+
>
|
|
280
|
+
{page}
|
|
281
|
+
</button>
|
|
282
|
+
);
|
|
283
|
+
};
|
|
284
|
+
|
|
285
|
+
return (
|
|
286
|
+
<nav
|
|
287
|
+
ref={ref}
|
|
288
|
+
data-fods-component="pagination"
|
|
289
|
+
data-fods-part="container"
|
|
290
|
+
{...props}
|
|
291
|
+
aria-label={copy.nav}
|
|
292
|
+
className={cn(slots.nav(), className)}
|
|
293
|
+
>
|
|
294
|
+
<Button
|
|
295
|
+
variant="tertiary"
|
|
296
|
+
size="sm"
|
|
297
|
+
leadingIcon={<Icon name="caret-left-small" />}
|
|
298
|
+
disabled={currentPage <= 1}
|
|
299
|
+
onClick={() => onPageChange(currentPage - 1)}
|
|
300
|
+
// Overrides Button's own `root` marker: inside this row the trigger is
|
|
301
|
+
// the `prev` slot the pagination manifest describes.
|
|
302
|
+
data-fods-part="prev"
|
|
303
|
+
className={slots.trigger()}
|
|
304
|
+
>
|
|
305
|
+
<span className="max-sm:sr-only">{copy.previous}</span>
|
|
306
|
+
</Button>
|
|
307
|
+
|
|
308
|
+
{slotsToRender.map((slot, index) => (
|
|
309
|
+
slot === ELLIPSIS
|
|
310
|
+
? (
|
|
311
|
+
<span
|
|
312
|
+
// Two ellipses can appear in one row; the index disambiguates the
|
|
313
|
+
// left one from the right one.
|
|
314
|
+
key={`ellipsis-${index}`}
|
|
315
|
+
data-fods-part="item"
|
|
316
|
+
data-page-state="ellipsis"
|
|
317
|
+
className={paginationItemVariants({ state: 'ellipsis' })}
|
|
318
|
+
>
|
|
319
|
+
<span aria-hidden="true">…</span>
|
|
320
|
+
<span className="sr-only">{copy.morePages}</span>
|
|
321
|
+
</span>
|
|
322
|
+
)
|
|
323
|
+
: renderPage(slot)
|
|
324
|
+
))}
|
|
325
|
+
|
|
326
|
+
<Button
|
|
327
|
+
variant="tertiary"
|
|
328
|
+
size="sm"
|
|
329
|
+
trailingIcon={<Icon name="caret-right-small" />}
|
|
330
|
+
disabled={currentPage >= totalPages}
|
|
331
|
+
onClick={() => onPageChange(currentPage + 1)}
|
|
332
|
+
data-fods-part="next"
|
|
333
|
+
className={slots.trigger()}
|
|
334
|
+
>
|
|
335
|
+
<span className="max-sm:sr-only">{copy.next}</span>
|
|
336
|
+
</Button>
|
|
337
|
+
</nav>
|
|
338
|
+
);
|
|
339
|
+
},
|
|
340
|
+
);
|
|
341
|
+
Pagination.displayName = 'Pagination';
|
|
342
|
+
|
|
343
|
+
export { Pagination, paginationVariants };
|
|
@@ -0,0 +1,158 @@
|
|
|
1
|
+
import { Meta, Canvas } from '@storybook/addon-docs/blocks';
|
|
2
|
+
import * as PopoverSurfaceStories from './PopoverSurface.stories';
|
|
3
|
+
|
|
4
|
+
<Meta of={PopoverSurfaceStories} tags={['autodocs']} />
|
|
5
|
+
|
|
6
|
+
# Popover Surface
|
|
7
|
+
|
|
8
|
+
## Metadata
|
|
9
|
+
|
|
10
|
+
- **Layer:** pattern (chrome recipe — **not a component**)
|
|
11
|
+
- **Status:** recipe (retired as an atom 2026-07-01)
|
|
12
|
+
- **Tokens used:** `--bg-primary`, `--border-width-100`, `--font-size-sm`, `--font-weight-semibold`, `--leading-loose`, `--outline-default`, `--radius-500`, `--shadow-overlay`, `--space-100`, `--space-200`, `--space-400`, `--space-600`, `--space-800`, `--text-primary`, `--text-secondary`, `--z-index-dropdown`
|
|
13
|
+
|
|
14
|
+
## Overview
|
|
15
|
+
|
|
16
|
+
The **Popover surface** is the shared **chrome recipe** every floating dropdown surface applies for itself —
|
|
17
|
+
`Select.Content`, the `Combobox` popup, `Menu`, `Popover`, a multi-select filter, an action menu. It is
|
|
18
|
+
deliberately **NOT a component**: there is no `<PopoverSurface>` wrapper, no Figma component, no slots, and no
|
|
19
|
+
molecule. Instead there is **one shared base style** — [`popoverSurfaceVariants`](?path=/story/design-system-patterns-popover-surface--full-panel) —
|
|
20
|
+
that each `*.Content` extends, and the panel body is composed by dropping real
|
|
21
|
+
[`ListRow`](?path=/docs/design-system-atoms-listrow--docs) + [`Divider`](?path=/docs/design-system-atoms-divider--docs)
|
|
22
|
+
atoms straight in.
|
|
23
|
+
|
|
24
|
+
Why a recipe and not a component: a single token-bound chrome is what prevents drift
|
|
25
|
+
(hardcoded hex values, two menu skins, mismatched sizes). One chrome for **all**
|
|
26
|
+
dropdowns; the **role + keyboard contract come from the organism**, never from the surface.
|
|
27
|
+
|
|
28
|
+
## Chrome contract
|
|
29
|
+
|
|
30
|
+
Every dropdown surface **MUST** bind exactly (via `popoverSurfaceVariants`):
|
|
31
|
+
|
|
32
|
+
<table>
|
|
33
|
+
<thead>
|
|
34
|
+
<tr><th>Property</th><th>Token</th><th>Tailwind</th></tr>
|
|
35
|
+
</thead>
|
|
36
|
+
<tbody>
|
|
37
|
+
<tr><td>background</td><td><code>--bg-primary</code></td><td><code>bg-background-primary</code></td></tr>
|
|
38
|
+
<tr><td>border</td><td>1px <code>--outline-default</code></td><td><code>border border-outline-default</code></td></tr>
|
|
39
|
+
<tr><td>border-radius</td><td><code>--radius-500</code> (12)</td><td><code>rounded-500</code></td></tr>
|
|
40
|
+
<tr><td>box-shadow</td><td><code>--shadow-overlay</code></td><td><code>shadow-overlay</code></td></tr>
|
|
41
|
+
<tr><td>z-index</td><td><code>--z-index-dropdown</code></td><td><code>z-dropdown</code></td></tr>
|
|
42
|
+
<tr><td>padding</td><td><strong>symmetric</strong> Y, 0 X — flat <code>--space-200</code> (4), Medium and Small alike</td><td><code>py-200</code>, <code>px-0</code></td></tr>
|
|
43
|
+
</tbody>
|
|
44
|
+
</table>
|
|
45
|
+
|
|
46
|
+
**MUST NOT** — hardcode any hex / px; ship a second surface skin; re-derive the chrome per component; or add
|
|
47
|
+
slots / a wrapper molecule. One base style, every `*.Content` extends it.
|
|
48
|
+
|
|
49
|
+
## Anatomy
|
|
50
|
+
|
|
51
|
+
<Canvas of={PopoverSurfaceStories.FullPanel} />
|
|
52
|
+
|
|
53
|
+
Top to bottom, a filled panel is:
|
|
54
|
+
|
|
55
|
+
1. **Header** — optional, **sticky OUTSIDE the scroll body**. A frame (title, or title + a
|
|
56
|
+
[`TextLink`](?path=/docs/design-system-atoms-textlink--docs)),
|
|
57
|
+
padding 16 / 8 (`px-600 py-400`) so the title lands on the row content column. Carries a **plain bottom
|
|
58
|
+
`Divider`** (full-bleed). Omit for a bare menu.
|
|
59
|
+
2. **Body** — required, the **scroll region**, `0` horizontal padding. Holds **groups** interleaved with
|
|
60
|
+
**`Divider` siblings**, on a uniform `--space-200` (4) rhythm. Scrolls past a soft ~8–10-row cap.
|
|
61
|
+
3. **Group** — rows wrapped in a transparent container with a **4px (`--space-200`) horizontal inset** (holds
|
|
62
|
+
the highlight off the border) and **no vertical padding** — rows are flush. A composition recipe, not a
|
|
63
|
+
component (the drafted `OptionGroup` molecule was retired 2026-07-15).
|
|
64
|
+
4. **Divider** — placed **between groups** as a **sibling at `0` inset** → full-bleed, edge-to-edge. A plain
|
|
65
|
+
`line` is a peer section break; a **`line-label`** (e.g. "Agendy" above) titles the section that follows.
|
|
66
|
+
5. **Footer** — optional, sticky, mirror of the header (padding 16 / 8, plain **top** `Divider`).
|
|
67
|
+
|
|
68
|
+
> **A chrome `TextLink` is never a `ListRow`.** A body row lands on the 16px content column as `4 + 12`
|
|
69
|
+
> (group inset + row padding) at min-height 40 with a hover wash; a header / footer frame reaches the same 16
|
|
70
|
+
> via `padL` directly, at `padY 8`. Dropping a row into the chrome breaks that column and adds a wash the frame
|
|
71
|
+
> must not have. `ListRow`'s `link` variant belongs in the **body** (e.g. "Přidat agendu" above) — and per
|
|
72
|
+
> `popover-patterns.md`
|
|
73
|
+
> § Account menu it should *host* a `TextLink` rather than restyle one.
|
|
74
|
+
>
|
|
75
|
+
> The chrome links above are real [`TextLink`](?path=/docs/design-system-atoms-textlink--docs) atoms —
|
|
76
|
+
> `variant="strong"` (the weight a standalone action link takes), `size="sm"` on both densities, and the default
|
|
77
|
+
> `underline="on"` (mandatory whenever no icon sits beside the label — WCAG 1.4.1). "Spravovat tarif" navigates,
|
|
78
|
+
> so it carries an `href` and renders an `<a>`; "Odhlásit se" is an in-page action and renders a `<button>` —
|
|
79
|
+
> *"never a bare clickable `<span>`"*. **Never hand-style a chrome link**; the ink, the weight and the focus
|
|
80
|
+
> ring are all the atom's.
|
|
81
|
+
>
|
|
82
|
+
> A **body row** is different: `ListRow`'s `link` variant renders its label as styled text with Text Link's
|
|
83
|
+
> Strong ink and underline, not a nested `TextLink`. A nested `<a>` inside a `menuitem` / `option` row would put
|
|
84
|
+
> an interactive element inside an interactive element (`list-row.manifest.json` `notes`).
|
|
85
|
+
|
|
86
|
+
> **One density per panel.** Every `ListRow`, header, and footer uses one size, **one step below the trigger**
|
|
87
|
+
> that opened it: trigger Medium 48 → rows Medium 40; trigger Small 40 → rows Small 36. Never mix.
|
|
88
|
+
|
|
89
|
+
## Bare menu
|
|
90
|
+
|
|
91
|
+
The simplest composition — a single group, no header / footer frames. The chrome is identical.
|
|
92
|
+
|
|
93
|
+
<Canvas of={PopoverSurfaceStories.BareMenu} />
|
|
94
|
+
|
|
95
|
+
## Matrix
|
|
96
|
+
|
|
97
|
+
Both grids the recipe has. **Chrome × density** is the anatomy matrix — the four ways the two optional
|
|
98
|
+
frames combine, against `size`, the one variant axis `popoverSurfaceVariants` itself takes.
|
|
99
|
+
**Section break × density** is the other body-level choice: a plain `line` between groups, or a titled
|
|
100
|
+
`line-label`. Read the cells against each other and the point of a single shared recipe is the thing
|
|
101
|
+
that does **not** change — same fill, same 1px border, same radius-12 corner, same overlay shadow,
|
|
102
|
+
same symmetric `--space-200` padding in every cell. `size` moves the row height, never the chrome.
|
|
103
|
+
|
|
104
|
+
<Canvas of={PopoverSurfaceStories.Matrix} />
|
|
105
|
+
|
|
106
|
+
The surface has **no interaction states of its own**: Hover / Selected / Disabled belong to
|
|
107
|
+
[`ListRow`](?path=/docs/design-system-atoms-listrow--docs), focus lives on the trigger, and the recipe
|
|
108
|
+
never paints a focus ring — which is why there is no state axis in the grid above. Every knob is live
|
|
109
|
+
on its own in the
|
|
110
|
+
[Playground story](?path=/story/design-system-patterns-popover-surface--playground).
|
|
111
|
+
|
|
112
|
+
## Do / Don't
|
|
113
|
+
|
|
114
|
+
- ✅ Apply `popoverSurfaceVariants` to the surface — one shared chrome for every dropdown.
|
|
115
|
+
- ✅ Compose the body from real `ListRow` + `Divider` atoms in `popoverGroupClass` groups.
|
|
116
|
+
- ✅ Keep one density per panel, one step below the trigger.
|
|
117
|
+
- ✅ Let the organism inject `role` + keyboard behaviour (`listbox`/`menu`/`combobox`).
|
|
118
|
+
- ✅ Use the `TextLink` atom for header / footer chrome links — `variant="strong"`, underline on.
|
|
119
|
+
- ❌ Don't build a `<PopoverSurface>` wrapper, add slots, or reach for a molecule.
|
|
120
|
+
- ❌ Don't hand-style a chrome link (a coloured `<span>`) — it loses the underline, focus ring and operable semantics.
|
|
121
|
+
- ❌ Don't hardcode hex / px, or ship a second surface skin.
|
|
122
|
+
- ❌ Don't re-derive the chrome per component — extend the one base style.
|
|
123
|
+
- ❌ Don't put horizontal padding on the surface or body — dividers must run full-bleed.
|
|
124
|
+
|
|
125
|
+
## Usage
|
|
126
|
+
|
|
127
|
+
```tsx
|
|
128
|
+
import {
|
|
129
|
+
popoverSurfaceVariants,
|
|
130
|
+
popoverBodyClass,
|
|
131
|
+
popoverGroupClass,
|
|
132
|
+
ListRow,
|
|
133
|
+
Divider,
|
|
134
|
+
} from '@invoiceonline/ui-react';
|
|
135
|
+
|
|
136
|
+
// Apply the shared chrome to your own *.Content surface, then compose rows in.
|
|
137
|
+
<div className={popoverSurfaceVariants({ size: 'md' })} role="listbox">
|
|
138
|
+
<div className={popoverBodyClass}>
|
|
139
|
+
<div className={popoverGroupClass}>
|
|
140
|
+
<ListRow role="option" selected>Faktura, s.r.o.</ListRow>
|
|
141
|
+
<ListRow role="option">Nová firma</ListRow>
|
|
142
|
+
</div>
|
|
143
|
+
<Divider variant="line" />
|
|
144
|
+
<div className={popoverGroupClass}>
|
|
145
|
+
<ListRow role="option">Nastavení</ListRow>
|
|
146
|
+
</div>
|
|
147
|
+
</div>
|
|
148
|
+
</div>
|
|
149
|
+
```
|
|
150
|
+
|
|
151
|
+
## Related
|
|
152
|
+
|
|
153
|
+
- **[ListRow](?path=/docs/design-system-atoms-listrow--docs)** — the option / menu rows composed into the body.
|
|
154
|
+
- **[Divider](?path=/docs/design-system-atoms-divider--docs)** — the full-bleed section breaks between groups.
|
|
155
|
+
- **[TextLink](?path=/docs/design-system-atoms-textlink--docs)** — the header / footer chrome links.
|
|
156
|
+
- **[SelectField](?path=/docs/design-system-molecules-selectfield--docs)** — a trigger whose panel is composed on this surface.
|
|
157
|
+
- Behaviour (positioning, dismissal, focus, highlight model, live-regions): `spec/06-patterns/overlay-behavior.md`.
|
|
158
|
+
- Spec: `spec/06-patterns/popover-patterns.md`.
|