@invoiceonline/ui-react 0.0.0 → 0.2.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 +100 -0
- package/CHANGELOG.md +149 -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-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 +119 -0
- package/dist/components/field/Field.js +332 -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 +210 -0
- package/dist/components/field-pair/FieldPair.js +335 -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 +160 -0
- package/dist/components/text-field/TextField.js +244 -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 +130 -0
- package/dist/index.js +74 -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.d.ts +60 -0
- package/dist/internal/useDateFieldTrigger.js +235 -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 +44 -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 +396 -0
- package/docs/Contributing.mdx +78 -0
- package/docs/ForAgents.mdx +53 -0
- package/docs/Introduction.mdx +54 -0
- package/llms.txt +550 -0
- package/package.json +347 -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-picker/DatePicker.mdx +440 -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 +787 -0
- package/src/components/field/index.ts +20 -0
- package/src/components/field-pair/FieldPair.mdx +312 -0
- package/src/components/field-pair/FieldPair.stories.tsx +539 -0
- package/src/components/field-pair/FieldPair.tsx +845 -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 +699 -0
- package/src/components/text-field/TextField.stories.tsx +674 -0
- package/src/components/text-field/TextField.tsx +645 -0
- package/src/components/text-field/index.ts +11 -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 +70 -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 +497 -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 +57 -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 +360 -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,462 @@
|
|
|
1
|
+
import { Meta, Canvas, Controls } from '@storybook/addon-docs/blocks';
|
|
2
|
+
import * as TooltipStories from './Tooltip.stories';
|
|
3
|
+
|
|
4
|
+
|
|
5
|
+
<Meta of={TooltipStories} tags={['autodocs']} />
|
|
6
|
+
|
|
7
|
+
# Tooltip
|
|
8
|
+
|
|
9
|
+
## Metadata
|
|
10
|
+
|
|
11
|
+
- **Layer:** atom
|
|
12
|
+
- **Status:** stable. The design acceptance of the Storybook DoD §6(d) was given on 2026-11-16 by the package maintainer instead of the designer; the designer may still fine-tune the component.
|
|
13
|
+
- **Tokens used:** `--bg-inverse`, `--font-size-sm`, `--font-size-xs`, `--font-weight-normal`, `--font-weight-semibold`, `--leading-loose`, `--radius-400`, `--shadow-raised`, `--space-100`, `--space-400`, `--space-500`, `--space-600`, `--text-inverted`, `--z-index-popover`
|
|
14
|
+
- **Manifest version:** `1.7.0`
|
|
15
|
+
|
|
16
|
+
The bubble stacks on `--z-index-popover` (1500, the layer the FODS tokens name for tooltips) through
|
|
17
|
+
the `z-popover` utility, above the Modal and Drawer (`--z-index-modal`, 1400) it can be opened from.
|
|
18
|
+
It also binds one CSS custom property that is **not** a FODS token, which is why it is absent
|
|
19
|
+
from the row above: the available-width variable Radix sets on the content element (see
|
|
20
|
+
[Sizes](#sizes)). The trigger offset `--space-200` (manifest `chrome.trigger-offset`) is absent
|
|
21
|
+
from the row too: the positioning engines take a number, so the component mirrors the token value
|
|
22
|
+
as its `sideOffset` default instead of binding a class (see [API](#api)). Motion is documented
|
|
23
|
+
under [States](#states).
|
|
24
|
+
|
|
25
|
+
## Overview
|
|
26
|
+
|
|
27
|
+
Tooltip is a **transient, dark overlay bubble** that gives supplementary help about the element
|
|
28
|
+
under the pointer or the keyboard focus — a term definition, a field explanation, the meaning of a
|
|
29
|
+
status. It is anchored to a trigger and points back at it with a small caret. Use it for
|
|
30
|
+
information that *aids* the task but is **not required** to complete it (WCAG 1.4.13). The
|
|
31
|
+
typical case is the info icon (ⓘ) beside a form label ("Co je to datum
|
|
32
|
+
zdanitelného plnění?").
|
|
33
|
+
|
|
34
|
+
**Do NOT use it** for essential instructions, validation errors, buttons, or form fields. Those
|
|
35
|
+
belong in visible helper text, an error region, or a Popover — a tooltip is chrome, not content. A
|
|
36
|
+
**link** is the one interactive element a tooltip may carry: one inline link in the copy, and its
|
|
37
|
+
presence switches the tooltip to the **toggletip mode** (see [States](#states)). The same mode
|
|
38
|
+
runs where the trigger has no hover to open it — a touch-only trigger.
|
|
39
|
+
|
|
40
|
+
## Rationale
|
|
41
|
+
|
|
42
|
+
Keeping the tooltip as its own atom does two things:
|
|
43
|
+
|
|
44
|
+
1. **No tooltip baked into a badge.** The retired "Advanced" status badge is **Badge + Tooltip**
|
|
45
|
+
composed, not a tooltip variant.
|
|
46
|
+
2. **One token-bound source for every info icon.** Every info-icon tooltip
|
|
47
|
+
shares one `--bg-inverse` surface.
|
|
48
|
+
|
|
49
|
+
## Anatomy
|
|
50
|
+
|
|
51
|
+
- **Bubble** — the floating surface. Fill `--bg-inverse` (blue/900 `#1b4a68`), radius
|
|
52
|
+
`--radius-400` (8), shadow `--shadow-raised`, `--space-100` (2) gap between the stacked title and
|
|
53
|
+
body. Padding per size (see Sizes).
|
|
54
|
+
- **Title** *(Medium only)* — `--font-size-sm` (14) at `--font-weight-semibold`, colour
|
|
55
|
+
`--text-inverted`. One step below body-base so the 14/13 title-vs-body pair stays compact. The
|
|
56
|
+
`title` prop is **dropped for `size="sm"`**.
|
|
57
|
+
- **Body / label** — `--font-size-xs` (13) regular, colour `--text-inverted`. Wraps in both sizes:
|
|
58
|
+
Small is a one-line label by recommendation, and a longer label wraps instead of being cut.
|
|
59
|
+
- **Caret** — a **12×6** (base × depth) triangle in the same `--bg-inverse` fill, centred on the
|
|
60
|
+
bubble edge facing the trigger. Optional (`showArrow`, default `true`). *(The deprecated caret
|
|
61
|
+
was an oversized 40×28 polygon.)*
|
|
62
|
+
- **Trigger offset** — the caret **tip** sits `--space-200` (4) from the trigger edge on every
|
|
63
|
+
placement (manifest `chrome.trigger-offset`, 1.5.0). Without a caret the bubble edge takes
|
|
64
|
+
that gap.
|
|
65
|
+
|
|
66
|
+
## Variants
|
|
67
|
+
|
|
68
|
+
Two axes: **Placement** (`side`) × **Size** (`size`). There is **no colour axis** — a tooltip is
|
|
69
|
+
always the single dark surface (unlike Badge, which is emotion-coloured).
|
|
70
|
+
|
|
71
|
+
<Canvas of={TooltipStories.Matrix} />
|
|
72
|
+
|
|
73
|
+
<table>
|
|
74
|
+
<thead>
|
|
75
|
+
<tr><th>Placement</th><th>Bubble sits…</th><th>Caret points</th><th>Tokeny</th></tr>
|
|
76
|
+
</thead>
|
|
77
|
+
<tbody>
|
|
78
|
+
<tr>
|
|
79
|
+
<td><code>top</code> (default)</td>
|
|
80
|
+
<td>above the trigger</td>
|
|
81
|
+
<td>down</td>
|
|
82
|
+
<td>fill <code>--bg-inverse</code>, text <code>--text-inverted</code></td>
|
|
83
|
+
</tr>
|
|
84
|
+
<tr>
|
|
85
|
+
<td><code>right</code></td>
|
|
86
|
+
<td>to the right</td>
|
|
87
|
+
<td>left</td>
|
|
88
|
+
<td>fill <code>--bg-inverse</code>, text <code>--text-inverted</code></td>
|
|
89
|
+
</tr>
|
|
90
|
+
<tr>
|
|
91
|
+
<td><code>bottom</code></td>
|
|
92
|
+
<td>below the trigger</td>
|
|
93
|
+
<td>up</td>
|
|
94
|
+
<td>fill <code>--bg-inverse</code>, text <code>--text-inverted</code></td>
|
|
95
|
+
</tr>
|
|
96
|
+
<tr>
|
|
97
|
+
<td><code>left</code></td>
|
|
98
|
+
<td>to the left</td>
|
|
99
|
+
<td>right</td>
|
|
100
|
+
<td>fill <code>--bg-inverse</code>, text <code>--text-inverted</code></td>
|
|
101
|
+
</tr>
|
|
102
|
+
</tbody>
|
|
103
|
+
</table>
|
|
104
|
+
|
|
105
|
+
`side` is a **preferred** side only: at runtime the bubble **flips to the opposite side** when it
|
|
106
|
+
would clip the viewport. Edge alignment (`-start` / `-end`) is out of scope for v1 — the caret stays
|
|
107
|
+
centred.
|
|
108
|
+
|
|
109
|
+
## Sizes
|
|
110
|
+
|
|
111
|
+
<Canvas of={TooltipStories.Sizes} />
|
|
112
|
+
|
|
113
|
+
<table>
|
|
114
|
+
<thead>
|
|
115
|
+
<tr>
|
|
116
|
+
<th>Size</th>
|
|
117
|
+
<th>Content</th>
|
|
118
|
+
<th>Padding (block × inline)</th>
|
|
119
|
+
<th>Gap</th>
|
|
120
|
+
<th>Type</th>
|
|
121
|
+
<th>Max-width</th>
|
|
122
|
+
</tr>
|
|
123
|
+
</thead>
|
|
124
|
+
<tbody>
|
|
125
|
+
<tr>
|
|
126
|
+
<td><code>sm</code> (default)</td>
|
|
127
|
+
<td>a label, <strong>no title</strong></td>
|
|
128
|
+
<td><code>--space-400</code> (8) × <code>--space-500</code> (12)</td>
|
|
129
|
+
<td><code>--space-100</code> (2)</td>
|
|
130
|
+
<td>label <code>--font-size-xs</code> (13)</td>
|
|
131
|
+
<td>hug content up to the available width, then wrap — <strong>never truncate</strong></td>
|
|
132
|
+
</tr>
|
|
133
|
+
<tr>
|
|
134
|
+
<td><code>md</code></td>
|
|
135
|
+
<td>title + wrapping body</td>
|
|
136
|
+
<td><code>--space-500</code> (12) × <code>--space-600</code> (16)</td>
|
|
137
|
+
<td><code>--space-100</code> (2)</td>
|
|
138
|
+
<td>title <code>--font-size-sm</code> (14) semibold + body <code>--font-size-xs</code> (13)</td>
|
|
139
|
+
<td><strong>280px</strong> (wraps)</td>
|
|
140
|
+
</tr>
|
|
141
|
+
</tbody>
|
|
142
|
+
</table>
|
|
143
|
+
|
|
144
|
+
Selection logic: **`sm`** for a short label or a one-line definition; **`md`** when the help needs
|
|
145
|
+
a heading plus an explanation (a field with a definition + example).
|
|
146
|
+
|
|
147
|
+
`max-width: 280px` is a **component constant** — the spec states tooltip widths are not
|
|
148
|
+
tokenised, so the Figma measurement is encoded in the component (it matches the deprecated ~296px
|
|
149
|
+
text column, rounded into the 4-grid neighbourhood).
|
|
150
|
+
|
|
151
|
+
`sm` hugs its text (`w-max`), but is capped by the width Radix leaves between the trigger and the
|
|
152
|
+
viewport edge — a label longer than the spec's ~60 chars therefore **wraps** instead of running off
|
|
153
|
+
screen or being cut. It never truncates: a tooltip may not clip supplementary content (WCAG 1.4.13).
|
|
154
|
+
"Single line" is a **copy recommendation** for scannability, not a CSS contract — which is why there
|
|
155
|
+
is no `whitespace-nowrap` and no `truncate` here. Radix exposes that width as a runtime custom
|
|
156
|
+
property on the content element (a positioning variable, **not** a design token, which is why it is
|
|
157
|
+
absent from **Tokens used** above):
|
|
158
|
+
|
|
159
|
+
```css
|
|
160
|
+
max-width: var(--radix-tooltip-content-available-width);
|
|
161
|
+
```
|
|
162
|
+
|
|
163
|
+
The manifest models the two sizes as two text runs since 1.2.0: `text.label` for `sm`
|
|
164
|
+
(`maxChars` 60, `overflow: wrap`) and `text.body` for `md` (160 / wrap). They no longer share one
|
|
165
|
+
entry, so the Small budget can no longer be read as the Medium one.
|
|
166
|
+
|
|
167
|
+
Copy guidance: `sm` — a noun phrase or short definition, no terminal period, ≤ ~60 chars, written to
|
|
168
|
+
read as one line (a longer one wraps rather than being cut). `md` title — the question or term the
|
|
169
|
+
user hovered; `md` body — one or two plain sentences, ≤ ~160 chars. Past that, use a Popover. Never
|
|
170
|
+
restate the visible label; add information.
|
|
171
|
+
|
|
172
|
+
## States
|
|
173
|
+
|
|
174
|
+
<Canvas of={TooltipStories.States} />
|
|
175
|
+
|
|
176
|
+
A tooltip has **only shown / hidden**. It is not focusable and owns **no hover, active, focus or
|
|
177
|
+
disabled state of its own** — those belong to the trigger.
|
|
178
|
+
|
|
179
|
+
- **Hidden** — the default; not in the accessibility tree.
|
|
180
|
+
- **Shown** — appears after a short hover-intent delay (`--duration-slow`, **300 ms**, the
|
|
181
|
+
`TooltipProvider` default; `delayDuration` on the component overrides it per instance) on
|
|
182
|
+
hover, **or immediately** on the trigger's focus — a focus induced by a click is suppressed, so in practice this is keyboard focus. Enter =
|
|
183
|
+
fade + a `--space-100` move toward the trigger (it starts that far out and settles in) on `--spring-standard`.
|
|
184
|
+
- **Dismiss** — on pointer-leave (of both trigger *and* bubble), on blur, and on `Escape`. Exit =
|
|
185
|
+
the reverse — fade + `--space-100` back away from the trigger, on the same spring.
|
|
186
|
+
|
|
187
|
+
### Motion
|
|
188
|
+
|
|
189
|
+
<Canvas of={TooltipStories.Motion} />
|
|
190
|
+
|
|
191
|
+
Manifest 1.6.1 `motion` — enter and exit are **Motion props on the bubble**, not CSS keyframes. The
|
|
192
|
+
bubble starts `--space-100` out from the trigger at opacity 0 and settles onto its resting position
|
|
193
|
+
on `springs.standard` (`--spring-standard`); exit runs the same spring back out. There is **no
|
|
194
|
+
scale**. The direction follows the resolved placement (`data-side`), so a bubble flipped to stay in
|
|
195
|
+
the viewport still moves toward its trigger. A re-hover during the exit retargets the running
|
|
196
|
+
spring from where it is — `AnimatePresence` keeps the bubble mounted until the exit settles, and
|
|
197
|
+
the toggletip keeps its focus manager live for that time.
|
|
198
|
+
|
|
199
|
+
Under `prefers-reduced-motion: reduce` the transition collapses to `--duration-instant`: the bubble
|
|
200
|
+
appears and disappears without perceptible travel.
|
|
201
|
+
|
|
202
|
+
### Toggletip mode — content with a link, or no hover
|
|
203
|
+
|
|
204
|
+
<Canvas of={TooltipStories.Toggletip} />
|
|
205
|
+
|
|
206
|
+
The tooltip behaves as a **toggletip** when its content contains a link, or when its trigger lives
|
|
207
|
+
where there is no hover — a touch-only surface such as the Status Summary Bar's mobile list. A
|
|
208
|
+
hover-only bubble disappears before the pointer reaches the link, cannot be reached by keyboard,
|
|
209
|
+
and never opens on touch, so neither case may run in the plain mode. The spec derives the mode
|
|
210
|
+
from the content or the surface; in code you opt in with the **`toggletip`** prop (no Figma
|
|
211
|
+
variant, no new token — same placements, sizes, chrome and motion).
|
|
212
|
+
|
|
213
|
+
- **Preview** — hover (after the hover-intent delay) or trigger `:focus-visible` shows the bubble
|
|
214
|
+
exactly as in the plain mode; pointer-leave hides it again, and so does blur — unless focus moves
|
|
215
|
+
into the bubble, which keeps it open.
|
|
216
|
+
- **Pin** — click, tap, `Enter` or `Space` on the trigger opens the bubble immediately and **pins**
|
|
217
|
+
it. Activating a trigger whose bubble is already showing as a preview pins it — it does not close
|
|
218
|
+
it.
|
|
219
|
+
- **Stays open** — while the pointer travels from the trigger into the bubble, while the bubble is
|
|
220
|
+
hovered, and while focus is inside the bubble.
|
|
221
|
+
- **Reaching the link** — `Tab` from the trigger moves focus into the bubble to the link (the bubble
|
|
222
|
+
follows the trigger in focus order); `Shift+Tab` returns to the trigger. The link is a
|
|
223
|
+
`<TextLink surface="inverse">` (focus ring `--outline-focus-inverse`).
|
|
224
|
+
- **Close** — `Escape` (focus returns to the trigger, and the preview stays suppressed until a fresh
|
|
225
|
+
interaction — the pointer re-entering the trigger, or focus leaving and returning), a second
|
|
226
|
+
click / tap / `Enter` / `Space` on the trigger, a pointer-down outside both trigger and bubble, or
|
|
227
|
+
focus leaving both. Activating the link follows it and closes the bubble.
|
|
228
|
+
- **Non-modal** — no focus trap, no backdrop; the page behind stays interactive.
|
|
229
|
+
|
|
230
|
+
A tooltip without a link on a surface with hover keeps the plain hover/focus lifecycle above,
|
|
231
|
+
unchanged.
|
|
232
|
+
|
|
233
|
+
**Implementation detail:** the plain mode runs on Radix Tooltip; the toggletip mode runs on
|
|
234
|
+
`@floating-ui/react` (Radix Tooltip hardcodes click → close and duplicates the content into a hidden
|
|
235
|
+
`role="tooltip"` node, which would duplicate the link). Both render the same bubble from
|
|
236
|
+
`tooltipVariants`. The toggletip does not share the provider's skip-delay between triggers.
|
|
237
|
+
|
|
238
|
+
Every plain `<Tooltip>` needs a `TooltipProvider` ancestor; `FodsProvider` mounts it once at the
|
|
239
|
+
root. The provider shares the open state and the hover-intent delay across triggers. Without a
|
|
240
|
+
provider ancestor the plain `<Tooltip>` and the low-level `TooltipRoot` throw
|
|
241
|
+
"`Tooltip` must be used within `TooltipProvider`" and the tree does not render. The `toggletip`
|
|
242
|
+
mode runs on `@floating-ui/react` and does not read the provider. The same requirement holds for
|
|
243
|
+
`Chip` with `info` and `Switch` with `infoIcon`, which render a plain `Tooltip`. Mount
|
|
244
|
+
`TooltipProvider` (exported from `@invoiceonline/ui-react`) yourself, below `FodsProvider`, only
|
|
245
|
+
for another `delayDuration`.
|
|
246
|
+
|
|
247
|
+
## API
|
|
248
|
+
|
|
249
|
+
<Controls />
|
|
250
|
+
|
|
251
|
+
The simplified `<Tooltip>` is the default API (`content`, `title`, `size`, `side`, `sideOffset`,
|
|
252
|
+
`showArrow`, `delayDuration`, `toggletip`, and an optional controlled `open` / `onOpenChange`). `sideOffset` is the gap
|
|
253
|
+
between the caret **tip** and the trigger edge and defaults to **4** (`--space-200`, manifest
|
|
254
|
+
`chrome.trigger-offset`) — the same in the plain and the toggletip mode, on every placement (with
|
|
255
|
+
`showArrow={false}` it is the bubble edge's gap); `delayDuration` has no own default and inherits
|
|
256
|
+
the `TooltipProvider` value. The bubble is rendered through `TooltipPortal` on `<body>`, so a
|
|
257
|
+
clipping ancestor (`overflow: hidden` / `auto` — tables, scroll areas, cards) can never cut it off.
|
|
258
|
+
|
|
259
|
+
Left uncontrolled it owns its open state; pass `open` / `onOpenChange` when something besides the
|
|
260
|
+
trigger's own hover and focus decides it (StatusSummaryBar opens the chip tooltip on keyboard focus
|
|
261
|
+
of the whole cell). For full control of the anatomy compose the low-level parts instead: `TooltipRoot` /
|
|
262
|
+
`TooltipTrigger` / `TooltipPortal` / `TooltipContent` / `TooltipArrow` (plus `TooltipProvider`).
|
|
263
|
+
**A low-level composition renders inline** — add `TooltipPortal` yourself whenever the trigger sits
|
|
264
|
+
in a clipping container. `TooltipContentProps` extends the Radix
|
|
265
|
+
content props with `size`; `tooltipVariants` (slots `content` / `title` / `body` / `arrow`) and the
|
|
266
|
+
`TooltipSize` type (`'sm' | 'md'`) are exported for consumers that need the raw classes.
|
|
267
|
+
|
|
268
|
+
## Do / Don't
|
|
269
|
+
|
|
270
|
+
- ✅ Use it for supplementary, non-essential help — a term, a field, a status.
|
|
271
|
+
- ✅ Make the trigger a real focusable control, so the tooltip appears on keyboard focus too.
|
|
272
|
+
- ✅ Keep it dismissible + hoverable + persistent (WCAG 1.4.13).
|
|
273
|
+
- ✅ Keep copy to a phrase or a sentence or two; pick `md` only when you genuinely need a heading.
|
|
274
|
+
- ✅ Give an icon-only trigger an `aria-label` — the icon alone has no accessible name.
|
|
275
|
+
- ✅ Let a link turn the tooltip into a toggletip — one inline `<TextLink surface="inverse">` in the
|
|
276
|
+
copy, with `toggletip`.
|
|
277
|
+
- ✅ Run a touch-only trigger as a toggletip — a tap pins the bubble.
|
|
278
|
+
- ❌ Never hide essential instructions, validation errors, or required steps in a tooltip.
|
|
279
|
+
- ❌ Don't put buttons or form fields inside — that is a Popover.
|
|
280
|
+
- ❌ Don't put a link in a tooltip that only opens on hover (a plain `<Tooltip>` without
|
|
281
|
+
`toggletip` — a dev-only console warning flags it).
|
|
282
|
+
- ❌ Don't leave a touch-only trigger hover-only — its help never opens.
|
|
283
|
+
- ❌ Don't auto-dismiss on a timer while the pointer is over the bubble.
|
|
284
|
+
- ❌ Don't pass `title` with `size="sm"` — it is dropped (with a dev-only console warning).
|
|
285
|
+
- ❌ Don't use "Advanced"-style composite badges; compose **Badge + Tooltip** instead.
|
|
286
|
+
|
|
287
|
+
## Accessibility
|
|
288
|
+
|
|
289
|
+
- **Keyboard** — the bubble itself is never focusable and never in the tab order. `Tab` moves focus
|
|
290
|
+
to the **trigger**, which shows the tooltip immediately (no delay); `Escape` dismisses it. Reaching
|
|
291
|
+
the tooltip must not require hover (WCAG 2.1.1) — the trigger has to be a `button` or otherwise
|
|
292
|
+
focusable element.
|
|
293
|
+
- **ARIA** — Radix puts `role="tooltip"` on a visually-hidden copy of the content (not on the
|
|
294
|
+
painted bubble) and points the trigger at it with `aria-describedby` while it is open. For an
|
|
295
|
+
**icon-only trigger** the tooltip text is often the
|
|
296
|
+
only name available, so the consumer must still put an `aria-label` on the trigger (see the
|
|
297
|
+
`Compositions` story) — `aria-describedby` is a description, not a name.
|
|
298
|
+
- **Toggletip mode** — the trigger is a `button` with `aria-expanded` (`false` / `true` while
|
|
299
|
+
pinned) and `aria-controls` pointing at the bubble. The bubble drops `role="tooltip"` — that role
|
|
300
|
+
may not hold interactive content — and is a non-modal popup: no `aria-modal`, no focus trap. It
|
|
301
|
+
takes `role="group"` only when it has a name (the Medium title, via `aria-labelledby`). With a
|
|
302
|
+
link, the trigger does not point at the bubble with `aria-describedby`; instead the **link**
|
|
303
|
+
carries `aria-describedby` → the body text (TextLink picks it up from the bubble automatically),
|
|
304
|
+
so focus landing on the link announces the explanation with it. Without a link (a touch-only
|
|
305
|
+
toggletip) focus never enters the bubble, so the trigger keeps `aria-describedby` → the body
|
|
306
|
+
text. Keyboard: `Enter` / `Space` toggle, `Tab` reaches the link, `Escape` closes and returns
|
|
307
|
+
focus to the trigger (WCAG 2.1.1, 1.4.13, 4.1.2).
|
|
308
|
+
- **Screen reader** — hidden state: the bubble is not in the accessibility tree at all. Shown
|
|
309
|
+
state: the trigger's name is announced first, then the tooltip text as its description. The
|
|
310
|
+
tooltip must never be the sole carrier of information.
|
|
311
|
+
- **Contrast & motion** — `--text-inverted` (white) on `--bg-inverse` (blue/900 `#1b4a68`) ≈ **9:1**,
|
|
312
|
+
AAA. **WCAG 1.4.13 (Content on Hover or Focus):** dismissible (`Escape`), hoverable (the pointer
|
|
313
|
+
can travel onto the bubble without it vanishing), persistent (it stays until dismissed or focus
|
|
314
|
+
is lost). Motion is a fade + `--space-100` travel on `--spring-standard` — small enough to be unobtrusive, and
|
|
315
|
+
collapsed to `--duration-instant` under `prefers-reduced-motion: reduce`; the bubble also flips placement to stay inside
|
|
316
|
+
the viewport.
|
|
317
|
+
|
|
318
|
+
Accessibility floor for every FODS component: `spec/01-foundations/accessibility.md`.
|
|
319
|
+
|
|
320
|
+
## Copy
|
|
321
|
+
|
|
322
|
+
Voice: the product tone of voice, impersonal and in-app. Tooltip copy is supplied by the consumer;
|
|
323
|
+
the component gives this guidance:
|
|
324
|
+
|
|
325
|
+
- **Label** (`size="sm"`, passed as `content`) — a noun phrase or short definition, no terminal
|
|
326
|
+
period: "Datum zdanitelného plnění". Recommended max 60 characters, written to read as a single
|
|
327
|
+
line. It wraps, never truncates: the limit is a recommendation for scannability, not an enforced
|
|
328
|
+
one.
|
|
329
|
+
- **Title** (`size="md"`, passed as `title`) — the term or question the user hovered: "Co je to
|
|
330
|
+
datum zdanitelného plnění?". Keep it to a phrase, max 60 characters; it wraps.
|
|
331
|
+
- **Body** (`size="md"`, passed as `content`) — one or two plain sentences answering the title;
|
|
332
|
+
full sentences get periods. Max 160 characters, it wraps; past that, use a Popover, not a
|
|
333
|
+
tooltip.
|
|
334
|
+
- Never restate the visible label: add information, don't echo it.
|
|
335
|
+
- **Link** (toggletip only) — one inline link, named for where it goes, never "zde" /
|
|
336
|
+
"klikněte"; see **Link copy** under Usage.
|
|
337
|
+
|
|
338
|
+
## Usage
|
|
339
|
+
|
|
340
|
+
<Canvas of={TooltipStories.Compositions} />
|
|
341
|
+
|
|
342
|
+
```tsx
|
|
343
|
+
import { FodsProvider, Tooltip, IconButton, Icon } from '@invoiceonline/ui-react';
|
|
344
|
+
|
|
345
|
+
// Good — FodsProvider once at the app root: it mounts the TooltipProvider
|
|
346
|
+
// (required: without one <Tooltip> throws)
|
|
347
|
+
<FodsProvider>
|
|
348
|
+
<App />
|
|
349
|
+
</FodsProvider>;
|
|
350
|
+
|
|
351
|
+
// Good — one-line label for an icon-only control; aria-label supplies the name
|
|
352
|
+
<Tooltip content="Kopírovat odkaz">
|
|
353
|
+
<IconButton variant="tertiary" icon={<Icon name="copy" />} aria-label="Kopírovat odkaz" />
|
|
354
|
+
</Tooltip>;
|
|
355
|
+
|
|
356
|
+
// Good — Medium explains a domain term next to a form label
|
|
357
|
+
<Tooltip
|
|
358
|
+
size="md"
|
|
359
|
+
title="Co je to datum zdanitelného plnění?"
|
|
360
|
+
content="Den dodání zboží nebo poskytnutí služby."
|
|
361
|
+
>
|
|
362
|
+
<IconButton
|
|
363
|
+
variant="tertiary"
|
|
364
|
+
size="xs"
|
|
365
|
+
icon={<Icon name="info" />}
|
|
366
|
+
aria-label="Co je to datum zdanitelného plnění?"
|
|
367
|
+
/>
|
|
368
|
+
</Tooltip>;
|
|
369
|
+
```
|
|
370
|
+
|
|
371
|
+
```tsx
|
|
372
|
+
// Don't — title is dropped on the Small size
|
|
373
|
+
<Tooltip size="sm" title="IČO" content="Identifikační číslo, např. 12345678">
|
|
374
|
+
<Button variant="secondary">IČO</Button>
|
|
375
|
+
</Tooltip>;
|
|
376
|
+
|
|
377
|
+
// Don't — essential info and interactive content inside a tooltip
|
|
378
|
+
<Tooltip size="md" title="Neplatné IČO" content={<a href="#">IČO musí mít 8 číslic</a>}>
|
|
379
|
+
<Icon name="warning" />
|
|
380
|
+
</Tooltip>; // ❌ a raw link, a non-focusable trigger and no toggletip
|
|
381
|
+
|
|
382
|
+
// Don't — a non-focusable trigger makes the tooltip keyboard-unreachable
|
|
383
|
+
<Tooltip content="Acme s.r.o., firma@priklad.cz">
|
|
384
|
+
<span>Odběratel</span>
|
|
385
|
+
</Tooltip>;
|
|
386
|
+
```
|
|
387
|
+
|
|
388
|
+
A link in the copy, or a touch-only trigger — the toggletip mode:
|
|
389
|
+
|
|
390
|
+
```tsx
|
|
391
|
+
import { Tooltip, TextLink, IconButton } from '@invoiceonline/ui-react';
|
|
392
|
+
|
|
393
|
+
<Tooltip
|
|
394
|
+
toggletip
|
|
395
|
+
size="md"
|
|
396
|
+
title="Odkud se číslo účtu bere?"
|
|
397
|
+
content={
|
|
398
|
+
<>
|
|
399
|
+
Číslo účtu se přebírá z údajů o firmě.{' '}
|
|
400
|
+
<TextLink surface="inverse" size="inherit" href="#">
|
|
401
|
+
Upravit v Nastavení
|
|
402
|
+
</TextLink>
|
|
403
|
+
</>
|
|
404
|
+
}
|
|
405
|
+
>
|
|
406
|
+
<IconButton variant="tertiary" size="xs" icon={<Icon name="info" />} aria-label="Odkud se číslo účtu bere?" />
|
|
407
|
+
</Tooltip>;
|
|
408
|
+
|
|
409
|
+
<Tooltip toggletip size="sm" side="top" content="Faktury po splatnosti">
|
|
410
|
+
<button type="button" aria-label="Co znamená tato hodnota?">ⓘ</button>
|
|
411
|
+
</Tooltip>;
|
|
412
|
+
```
|
|
413
|
+
|
|
414
|
+
**Link copy (toggletip):** one link, inline in the copy — wherever it reads naturally in the
|
|
415
|
+
sentence — named for where it goes ("Upravit v Nastavení"), never "zde" / "klikněte". The sentence
|
|
416
|
+
before it must make sense without following the link.
|
|
417
|
+
|
|
418
|
+
The `Playground` story exposes every prop as a control:
|
|
419
|
+
|
|
420
|
+
<Canvas of={TooltipStories.Playground} />
|
|
421
|
+
|
|
422
|
+
## Related
|
|
423
|
+
|
|
424
|
+
- **Popover / AnchoredPanel** — for content the user should read at leisure, or interactive
|
|
425
|
+
controls (buttons, fields). A single inline link stays in a toggletip. If the body needs more than ~160 chars, it is a Popover.
|
|
426
|
+
- [`Badge`](?path=/docs/design-system-atoms-badge--docs) — **Badge + Tooltip** composed replaces the
|
|
427
|
+
retired "Advanced" status badge.
|
|
428
|
+
- [`IconButton`](?path=/docs/design-system-atoms-iconbutton--docs) — the usual icon-only trigger;
|
|
429
|
+
it needs its own `aria-label`.
|
|
430
|
+
- [`TextLink`](?path=/docs/design-system-atoms-textlink--docs) — `surface="inverse"` is the link
|
|
431
|
+
inside a toggletip bubble.
|
|
432
|
+
- Pattern spec: `spec/06-patterns/inverse-surface.md`
|
|
433
|
+
— the inverse ink + `--outline-focus-inverse` ring a toggletip link takes.
|
|
434
|
+
- [Radix UI Tooltip](https://www.radix-ui.com/primitives/docs/components/tooltip) — the underlying
|
|
435
|
+
primitive of the plain mode (positioning, collision flipping, `role="tooltip"`, provider
|
|
436
|
+
semantics); the toggletip mode runs on `@floating-ui/react`.
|
|
437
|
+
- Spec: `spec/03-atoms/tooltip.md`.
|
|
438
|
+
|
|
439
|
+
## Migration notes
|
|
440
|
+
|
|
441
|
+
**1.4.0 → 1.6.1 — adopted.** 1.7.0 changed the spec status only (draft → stable), nothing to adopt.
|
|
442
|
+
|
|
443
|
+
- **1.5.0 — trigger offset (adopted).** `sideOffset` default **6 → 4** (`--space-200`), measured
|
|
444
|
+
from the caret tip. The toggletip mode used to measure from the bubble edge, so its tip touched
|
|
445
|
+
the trigger; it now adds the caret depth and matches the plain mode. A call site that passes its
|
|
446
|
+
own `sideOffset` keeps it.
|
|
447
|
+
- **1.6.0 / 1.6.1 — spring motion (adopted 2026-11-10, ui-system 0.17.0).** Enter / exit moved
|
|
448
|
+
from the `tooltip-in-*` / `tooltip-out-*` keyframes (`--duration-fast` + `--easing-enter` /
|
|
449
|
+
`--easing-exit`) onto Motion: fade + `--space-100` travel toward the trigger on
|
|
450
|
+
`springs.standard`, interruptible mid-flight; reduced motion = `--duration-instant`. No call-site
|
|
451
|
+
change — the low-level `TooltipRoot` / `TooltipPortal` / `TooltipContent` keep their API and now
|
|
452
|
+
hold the bubble mounted through its exit. Specs that assert the bubble is gone right after a
|
|
453
|
+
dismiss need `waitFor`.
|
|
454
|
+
|
|
455
|
+
**1.3.0 — toggletip mode.** Opt in with the `toggletip` prop wherever the content carries a link
|
|
456
|
+
or the trigger has no hover (touch-only). The link must be one inline
|
|
457
|
+
`<TextLink surface="inverse">` in the copy — not a raw `<a>`, not a button. The trigger must be a
|
|
458
|
+
real `<button>`. Plain tooltips are unchanged; a plain `<Tooltip>` whose content contains a link
|
|
459
|
+
logs a dev-only console warning.
|
|
460
|
+
|
|
461
|
+
**Choosing a size.** Reach for `size="md"` where the help needs a heading plus an
|
|
462
|
+
explanation, and never pass `title` on `sm` — it is dropped (with a dev-only console warning).
|