@invoiceonline/ui-react 0.0.0-stage → 0.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +99 -0
- package/CHANGELOG.md +131 -0
- package/LICENSE +9 -0
- package/README.md +78 -2
- package/dist/assets/label-brush-1.svg +6 -0
- package/dist/assets/pattern-dark.svg +113 -0
- package/dist/components/action-row/ActionRow.d.ts +178 -0
- package/dist/components/action-row/ActionRow.js +340 -0
- package/dist/components/action-row/index.d.ts +2 -0
- package/dist/components/action-row/index.js +1 -0
- package/dist/components/alert/Alert.d.ts +314 -0
- package/dist/components/alert/Alert.js +446 -0
- package/dist/components/alert/index.d.ts +2 -0
- package/dist/components/alert/index.js +1 -0
- package/dist/components/anchored-panel/AnchoredPanel.d.ts +41 -0
- package/dist/components/anchored-panel/AnchoredPanel.js +72 -0
- package/dist/components/anchored-panel/index.d.ts +3 -0
- package/dist/components/anchored-panel/index.js +3 -0
- package/dist/components/badge/Badge.d.ts +146 -0
- package/dist/components/badge/Badge.js +258 -0
- package/dist/components/badge/index.d.ts +2 -0
- package/dist/components/badge/index.js +1 -0
- package/dist/components/banner/Banner.d.ts +209 -0
- package/dist/components/banner/Banner.js +339 -0
- package/dist/components/banner/index.d.ts +2 -0
- package/dist/components/banner/index.js +1 -0
- package/dist/components/button/Button.d.ts +54 -0
- package/dist/components/button/Button.js +312 -0
- package/dist/components/button/index.d.ts +2 -0
- package/dist/components/button/index.js +1 -0
- package/dist/components/button-group/ButtonGroup.d.ts +187 -0
- package/dist/components/button-group/ButtonGroup.js +217 -0
- package/dist/components/button-group/index.d.ts +2 -0
- package/dist/components/button-group/index.js +1 -0
- package/dist/components/card-select/CardSelect.d.ts +274 -0
- package/dist/components/card-select/CardSelect.js +561 -0
- package/dist/components/card-select/CardSelectGroup.d.ts +92 -0
- package/dist/components/card-select/CardSelectGroup.js +72 -0
- package/dist/components/card-select/index.d.ts +3 -0
- package/dist/components/card-select/index.js +3 -0
- package/dist/components/checkbox/Checkbox.d.ts +104 -0
- package/dist/components/checkbox/Checkbox.js +194 -0
- package/dist/components/checkbox/index.d.ts +2 -0
- package/dist/components/checkbox/index.js +1 -0
- package/dist/components/chip/Chip.d.ts +250 -0
- package/dist/components/chip/Chip.js +441 -0
- package/dist/components/chip/index.d.ts +2 -0
- package/dist/components/chip/index.js +1 -0
- package/dist/components/column-header/ColumnHeader.d.ts +144 -0
- package/dist/components/column-header/ColumnHeader.js +209 -0
- package/dist/components/column-header/index.d.ts +2 -0
- package/dist/components/column-header/index.js +1 -0
- package/dist/components/combobox-field/Combobox.d.ts +104 -0
- package/dist/components/combobox-field/Combobox.js +355 -0
- package/dist/components/combobox-field/ComboboxField.d.ts +76 -0
- package/dist/components/combobox-field/ComboboxField.js +98 -0
- package/dist/components/combobox-field/index.d.ts +3 -0
- package/dist/components/combobox-field/index.js +3 -0
- package/dist/components/date-field/DateField.d.ts +52 -0
- package/dist/components/date-field/DateField.js +45 -0
- package/dist/components/date-field/index.d.ts +2 -0
- package/dist/components/date-field/index.js +1 -0
- package/dist/components/date-picker/DatePicker.d.ts +53 -0
- package/dist/components/date-picker/DatePicker.js +329 -0
- package/dist/components/date-picker/index.d.ts +2 -0
- package/dist/components/date-picker/index.js +1 -0
- package/dist/components/divider/Divider.d.ts +81 -0
- package/dist/components/divider/Divider.js +93 -0
- package/dist/components/divider/index.d.ts +2 -0
- package/dist/components/divider/index.js +1 -0
- package/dist/components/drawer/Drawer.d.ts +128 -0
- package/dist/components/drawer/Drawer.js +367 -0
- package/dist/components/drawer/index.d.ts +2 -0
- package/dist/components/drawer/index.js +1 -0
- package/dist/components/dropdown-button/DropdownButton.d.ts +72 -0
- package/dist/components/dropdown-button/DropdownButton.js +122 -0
- package/dist/components/dropdown-button/index.d.ts +2 -0
- package/dist/components/dropdown-button/index.js +1 -0
- package/dist/components/faq/FAQ.d.ts +135 -0
- package/dist/components/faq/FAQ.js +258 -0
- package/dist/components/faq/index.d.ts +2 -0
- package/dist/components/faq/index.js +1 -0
- package/dist/components/field/Field.d.ts +118 -0
- package/dist/components/field/Field.js +327 -0
- package/dist/components/field/index.d.ts +2 -0
- package/dist/components/field/index.js +1 -0
- package/dist/components/field-pair/FieldPair.d.ts +194 -0
- package/dist/components/field-pair/FieldPair.js +321 -0
- package/dist/components/field-pair/index.d.ts +2 -0
- package/dist/components/field-pair/index.js +1 -0
- package/dist/components/file-upload/FileUpload.d.ts +137 -0
- package/dist/components/file-upload/FileUpload.js +434 -0
- package/dist/components/file-upload/index.d.ts +2 -0
- package/dist/components/file-upload/index.js +1 -0
- package/dist/components/filter-chip/FilterChip.d.ts +373 -0
- package/dist/components/filter-chip/FilterChip.js +517 -0
- package/dist/components/filter-chip/index.d.ts +2 -0
- package/dist/components/filter-chip/index.js +1 -0
- package/dist/components/filter-facet/FilterFacet.d.ts +116 -0
- package/dist/components/filter-facet/FilterFacet.js +632 -0
- package/dist/components/filter-facet/index.d.ts +2 -0
- package/dist/components/filter-facet/index.js +1 -0
- package/dist/components/firm-avatar/FirmAvatar.d.ts +75 -0
- package/dist/components/firm-avatar/FirmAvatar.js +119 -0
- package/dist/components/firm-avatar/index.d.ts +2 -0
- package/dist/components/firm-avatar/index.js +1 -0
- package/dist/components/form-actions/FormActions.d.ts +123 -0
- package/dist/components/form-actions/FormActions.js +195 -0
- package/dist/components/form-actions/index.d.ts +2 -0
- package/dist/components/form-actions/index.js +1 -0
- package/dist/components/form-block/FormBlock.d.ts +252 -0
- package/dist/components/form-block/FormBlock.js +420 -0
- package/dist/components/form-block/index.d.ts +3 -0
- package/dist/components/form-block/index.js +3 -0
- package/dist/components/form-section/FormSection.d.ts +130 -0
- package/dist/components/form-section/FormSection.js +206 -0
- package/dist/components/form-section/index.d.ts +2 -0
- package/dist/components/form-section/index.js +1 -0
- package/dist/components/heading/Heading.d.ts +69 -0
- package/dist/components/heading/Heading.js +79 -0
- package/dist/components/heading/index.d.ts +2 -0
- package/dist/components/heading/index.js +1 -0
- package/dist/components/heading-group/HeadingGroup.d.ts +258 -0
- package/dist/components/heading-group/HeadingGroup.js +255 -0
- package/dist/components/heading-group/index.d.ts +2 -0
- package/dist/components/heading-group/index.js +1 -0
- package/dist/components/hero/Hero.d.ts +268 -0
- package/dist/components/hero/Hero.js +316 -0
- package/dist/components/hero/index.d.ts +2 -0
- package/dist/components/hero/index.js +1 -0
- package/dist/components/icon/Icon.d.ts +27 -0
- package/dist/components/icon/Icon.js +30 -0
- package/dist/components/icon/index.d.ts +3 -0
- package/dist/components/icon/index.js +3 -0
- package/dist/components/icon-button/IconButton.d.ts +75 -0
- package/dist/components/icon-button/IconButton.js +151 -0
- package/dist/components/icon-button/index.d.ts +2 -0
- package/dist/components/icon-button/index.js +1 -0
- package/dist/components/item-row/ItemRow.d.ts +253 -0
- package/dist/components/item-row/ItemRow.js +496 -0
- package/dist/components/item-row/index.d.ts +2 -0
- package/dist/components/item-row/index.js +1 -0
- package/dist/components/list-row/ListRow.d.ts +165 -0
- package/dist/components/list-row/ListRow.js +233 -0
- package/dist/components/list-row/index.d.ts +2 -0
- package/dist/components/list-row/index.js +1 -0
- package/dist/components/menu/Menu.d.ts +64 -0
- package/dist/components/menu/Menu.js +186 -0
- package/dist/components/menu/index.d.ts +2 -0
- package/dist/components/menu/index.js +1 -0
- package/dist/components/modal/Modal.d.ts +272 -0
- package/dist/components/modal/Modal.js +788 -0
- package/dist/components/modal/index.d.ts +2 -0
- package/dist/components/modal/index.js +1 -0
- package/dist/components/nav-link/NavLink.d.ts +123 -0
- package/dist/components/nav-link/NavLink.js +157 -0
- package/dist/components/nav-link/index.d.ts +2 -0
- package/dist/components/nav-link/index.js +1 -0
- package/dist/components/number-field/NumberField.d.ts +62 -0
- package/dist/components/number-field/NumberField.js +210 -0
- package/dist/components/number-field/index.d.ts +2 -0
- package/dist/components/number-field/index.js +1 -0
- package/dist/components/pagination/Pagination.d.ts +133 -0
- package/dist/components/pagination/Pagination.js +217 -0
- package/dist/components/pagination/index.d.ts +3 -0
- package/dist/components/pagination/index.js +3 -0
- package/dist/components/popover-surface/index.d.ts +2 -0
- package/dist/components/popover-surface/index.js +1 -0
- package/dist/components/progress-bar/ProgressBar.d.ts +260 -0
- package/dist/components/progress-bar/ProgressBar.js +470 -0
- package/dist/components/progress-bar/index.d.ts +2 -0
- package/dist/components/progress-bar/index.js +1 -0
- package/dist/components/promo-sticker/PromoSticker.d.ts +204 -0
- package/dist/components/promo-sticker/PromoSticker.js +177 -0
- package/dist/components/promo-sticker/index.d.ts +2 -0
- package/dist/components/promo-sticker/index.js +1 -0
- package/dist/components/promo-surface/PromoSurface.d.ts +94 -0
- package/dist/components/promo-surface/PromoSurface.js +119 -0
- package/dist/components/promo-surface/index.d.ts +2 -0
- package/dist/components/promo-surface/index.js +1 -0
- package/dist/components/radio/Radio.d.ts +92 -0
- package/dist/components/radio/Radio.js +171 -0
- package/dist/components/radio/index.d.ts +2 -0
- package/dist/components/radio/index.js +1 -0
- package/dist/components/radio-group/RadioGroup.d.ts +61 -0
- package/dist/components/radio-group/RadioGroup.js +51 -0
- package/dist/components/radio-group/index.d.ts +2 -0
- package/dist/components/radio-group/index.js +1 -0
- package/dist/components/select/Select.d.ts +65 -0
- package/dist/components/select/Select.js +176 -0
- package/dist/components/select/index.d.ts +2 -0
- package/dist/components/select/index.js +1 -0
- package/dist/components/select-field/SelectField.d.ts +16 -0
- package/dist/components/select-field/SelectField.js +55 -0
- package/dist/components/select-field/index.d.ts +2 -0
- package/dist/components/select-field/index.js +1 -0
- package/dist/components/skeleton/Skeleton.d.ts +64 -0
- package/dist/components/skeleton/Skeleton.js +65 -0
- package/dist/components/skeleton/index.d.ts +2 -0
- package/dist/components/skeleton/index.js +1 -0
- package/dist/components/split-button/SplitButton.d.ts +80 -0
- package/dist/components/split-button/SplitButton.js +182 -0
- package/dist/components/split-button/index.d.ts +2 -0
- package/dist/components/split-button/index.js +1 -0
- package/dist/components/status-summary-bar/StatusSummaryBar.d.ts +118 -0
- package/dist/components/status-summary-bar/StatusSummaryBar.js +278 -0
- package/dist/components/status-summary-bar/index.d.ts +2 -0
- package/dist/components/status-summary-bar/index.js +1 -0
- package/dist/components/subject-lookup-field/SubjectLookupField.d.ts +157 -0
- package/dist/components/subject-lookup-field/SubjectLookupField.js +663 -0
- package/dist/components/subject-lookup-field/index.d.ts +2 -0
- package/dist/components/subject-lookup-field/index.js +1 -0
- package/dist/components/switch/Switch.d.ts +152 -0
- package/dist/components/switch/Switch.js +307 -0
- package/dist/components/switch/index.d.ts +2 -0
- package/dist/components/switch/index.js +1 -0
- package/dist/components/table/Table.d.ts +5 -0
- package/dist/components/table/Table.js +601 -0
- package/dist/components/table/index.d.ts +6 -0
- package/dist/components/table/index.js +6 -0
- package/dist/components/text-field/TextField.d.ts +65 -0
- package/dist/components/text-field/TextField.js +173 -0
- package/dist/components/text-field/index.d.ts +2 -0
- package/dist/components/text-field/index.js +1 -0
- package/dist/components/text-link/TextLink.d.ts +260 -0
- package/dist/components/text-link/TextLink.js +303 -0
- package/dist/components/text-link/index.d.ts +2 -0
- package/dist/components/text-link/index.js +1 -0
- package/dist/components/textarea/Textarea.d.ts +93 -0
- package/dist/components/textarea/Textarea.js +256 -0
- package/dist/components/textarea/index.d.ts +2 -0
- package/dist/components/textarea/index.js +1 -0
- package/dist/components/tooltip/Tooltip.d.ts +129 -0
- package/dist/components/tooltip/Tooltip.js +457 -0
- package/dist/components/tooltip/index.d.ts +2 -0
- package/dist/components/tooltip/index.js +1 -0
- package/dist/components/unit-field/UnitField.d.ts +46 -0
- package/dist/components/unit-field/UnitField.js +133 -0
- package/dist/components/unit-field/index.d.ts +2 -0
- package/dist/components/unit-field/index.js +1 -0
- package/dist/icons/icon-registry.generated.js +500 -0
- package/dist/icons/icon-types.generated.d.ts +2 -0
- package/dist/icons/icon-types.generated.js +126 -0
- package/dist/index.d.ts +132 -0
- package/dist/index.js +75 -0
- package/dist/internal/BottomSheet.js +496 -0
- package/dist/internal/FodsProvider.d.ts +25 -0
- package/dist/internal/FodsProvider.js +32 -0
- package/dist/internal/MotionCaret.js +35 -0
- package/dist/internal/NumberFormatInput.d.ts +21 -0
- package/dist/internal/NumberFormatInput.js +126 -0
- package/dist/internal/SummaryDonut.d.ts +3 -0
- package/dist/internal/SummaryDonut.js +300 -0
- package/dist/internal/buttonSegment.d.ts +44 -0
- package/dist/internal/buttonSegment.js +126 -0
- package/dist/internal/collapseRoom.js +128 -0
- package/dist/internal/comboboxKeys.js +44 -0
- package/dist/internal/contentPresence.js +46 -0
- package/dist/internal/dayCell.js +95 -0
- package/dist/internal/dialogPortal.d.ts +2 -0
- package/dist/internal/dialogPortal.js +21 -0
- package/dist/internal/donutSweeps.js +65 -0
- package/dist/internal/enterOnViewGeometry.js +46 -0
- package/dist/internal/faqItem.js +80 -0
- package/dist/internal/floatingLabelMotion.js +68 -0
- package/dist/internal/formBlockContext.d.ts +22 -0
- package/dist/internal/formBlockContext.js +20 -0
- package/dist/internal/heightRoom.js +87 -0
- package/dist/internal/numberSeparators.js +62 -0
- package/dist/internal/overlayMotion.js +48 -0
- package/dist/internal/paginationItem.d.ts +8 -0
- package/dist/internal/paginationItem.js +22 -0
- package/dist/internal/popoverSurface.d.ts +8 -0
- package/dist/internal/popoverSurface.js +23 -0
- package/dist/internal/portalContainer.d.ts +1 -0
- package/dist/internal/portalContainer.js +6 -0
- package/dist/internal/progressBarItem.d.ts +207 -0
- package/dist/internal/progressBarItem.js +264 -0
- package/dist/internal/selectionControlText.js +12 -0
- package/dist/internal/statusSummaryParts.js +371 -0
- package/dist/internal/summaryMotion.js +75 -0
- package/dist/internal/table/ChildConnector.js +62 -0
- package/dist/internal/table/ChildRowPrefix.d.ts +9 -0
- package/dist/internal/table/ChildRowPrefix.js +27 -0
- package/dist/internal/table/ColumnSettings.js +135 -0
- package/dist/internal/table/ScrollRegion.js +114 -0
- package/dist/internal/table/TableEmpty.js +93 -0
- package/dist/internal/table/TableLayout.d.ts +17 -0
- package/dist/internal/table/TableLayout.js +29 -0
- package/dist/internal/table/TableLoadStatus.js +56 -0
- package/dist/internal/table/TableMobile.js +488 -0
- package/dist/internal/table/TruncatedCell.js +33 -0
- package/dist/internal/table/emptyValue.js +10 -0
- package/dist/internal/table/features.d.ts +41 -0
- package/dist/internal/table/features.js +31 -0
- package/dist/internal/table/recipes.js +227 -0
- package/dist/internal/table/rowClick.js +9 -0
- package/dist/internal/table/types.d.ts +325 -0
- package/dist/internal/table/types.js +13 -0
- package/dist/internal/tailwind-variants.d.ts +3 -0
- package/dist/internal/tailwind-variants.js +37 -0
- package/dist/internal/tooltipContext.js +5 -0
- package/dist/internal/tw-merge-config.generated.js +314 -0
- package/dist/internal/useAnchoredPanel.d.ts +87 -0
- package/dist/internal/useAnchoredPanel.js +108 -0
- package/dist/internal/useCountUp.js +53 -0
- package/dist/internal/useDateFieldTrigger.js +183 -0
- package/dist/internal/useEChart.js +59 -0
- package/dist/internal/useEnterOnView.js +42 -0
- package/dist/internal/useFloatingBar.js +100 -0
- package/dist/internal/useFormReset.js +37 -0
- package/dist/internal/useIsMobile.js +44 -0
- package/dist/internal/useOneRowOverflow.js +88 -0
- package/dist/internal/usePrefersReducedMotion.js +25 -0
- package/dist/internal/useReturnFocus.js +26 -0
- package/dist/internal/utils.d.ts +7 -0
- package/dist/internal/utils.js +58 -0
- package/dist/node_modules/@tanstack/store/dist/store.d.ts +29 -0
- package/dist/node_modules/@tanstack/store/dist/types.d.ts +38 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/cells/coreCellsFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/cells/coreCellsFeature.types.d.ts +53 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/columns/coreColumnsFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/columns/coreColumnsFeature.types.d.ts +90 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/coreFeatures.d.ts +17 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/headers/coreHeadersFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/headers/coreHeadersFeature.types.d.ts +114 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/reactivity/coreReactivityFeature.types.d.ts +51 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/row-models/coreRowModelsFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/row-models/coreRowModelsFeature.types.d.ts +29 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/rows/coreRowsFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/rows/coreRowsFeature.types.d.ts +129 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/table/coreTablesFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/table/coreTablesFeature.types.d.ts +203 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/cell-selection/cellSelectionFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/cell-selection/cellSelectionFeature.types.d.ts +294 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/cell-spanning/cellSpanningFeature.d.ts +11 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/cell-spanning/cellSpanningFeature.types.d.ts +148 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-faceting/columnFacetingFeature.d.ts +12 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-faceting/columnFacetingFeature.types.d.ts +63 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/columnFilteringFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/columnFilteringFeature.types.d.ts +209 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/filterFns.d.ts +35 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-grouping/columnGroupingFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-grouping/columnGroupingFeature.types.d.ts +128 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-ordering/columnOrderingFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-ordering/columnOrderingFeature.types.d.ts +82 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-pinning/columnPinningFeature.d.ts +11 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-pinning/columnPinningFeature.types.d.ts +195 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-resizing/columnResizingFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-resizing/columnResizingFeature.types.d.ts +73 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-sizing/columnSizingFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-sizing/columnSizingFeature.types.d.ts +134 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-visibility/columnVisibilityFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-visibility/columnVisibilityFeature.types.d.ts +92 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/global-filtering/globalFilteringFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/global-filtering/globalFilteringFeature.types.d.ts +67 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/aggregationFns.d.ts +23 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.types.d.ts +183 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.utils.d.ts +18 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-expanding/rowExpandingFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-expanding/rowExpandingFeature.types.d.ts +125 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-pagination/rowPaginationFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-pagination/rowPaginationFeature.types.d.ts +135 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-pinning/rowPinningFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-pinning/rowPinningFeature.types.d.ts +76 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-selection/rowSelectionFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-selection/rowSelectionFeature.types.d.ts +187 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/rowSortingFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/rowSortingFeature.types.d.ts +236 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/sortFns.d.ts +23 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/stockFeatures.d.ts +37 -0
- package/dist/node_modules/@tanstack/table-core/dist/helpers/columnHelper.d.ts +47 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/Cell.d.ts +16 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/Column.d.ts +30 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/ColumnDef.d.ts +123 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/Header.d.ts +12 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/HeaderGroup.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/Row.d.ts +24 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/RowModel.d.ts +19 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/RowModelFns.d.ts +11 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/Table.d.ts +53 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/TableFeatures.d.ts +416 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/TableOptions.d.ts +78 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/TableState.d.ts +46 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/type-utils.d.ts +25 -0
- package/dist/shared.css +179 -0
- package/dist/styles.css +5467 -0
- package/dist/theme.css +314 -0
- package/dist/theme.map.json +278 -0
- package/dist/tokens/index.d.ts +2 -0
- package/dist/tokens/index.js +1 -0
- package/dist/tokens/tokens.generated.d.ts +2040 -0
- package/dist/tokens/tokens.generated.js +2053 -0
- package/dist/tokens.css +484 -0
- package/dist/tokens.flat.json +429 -0
- package/docs/Consuming.mdx +379 -0
- package/docs/Contributing.mdx +78 -0
- package/docs/ForAgents.mdx +53 -0
- package/docs/Introduction.mdx +54 -0
- package/llms.txt +556 -0
- package/package.json +357 -4
- package/src/components/action-row/ActionRow.mdx +686 -0
- package/src/components/action-row/ActionRow.stories.tsx +669 -0
- package/src/components/action-row/ActionRow.tsx +632 -0
- package/src/components/action-row/index.ts +9 -0
- package/src/components/alert/Alert.mdx +377 -0
- package/src/components/alert/Alert.stories.tsx +674 -0
- package/src/components/alert/Alert.tsx +579 -0
- package/src/components/alert/index.ts +13 -0
- package/src/components/anchored-panel/AnchoredPanel.mdx +381 -0
- package/src/components/anchored-panel/AnchoredPanel.stories.tsx +593 -0
- package/src/components/anchored-panel/AnchoredPanel.tsx +176 -0
- package/src/components/anchored-panel/index.ts +15 -0
- package/src/components/badge/Badge.mdx +487 -0
- package/src/components/badge/Badge.stories.tsx +375 -0
- package/src/components/badge/Badge.tsx +360 -0
- package/src/components/badge/index.ts +10 -0
- package/src/components/banner/Banner.mdx +704 -0
- package/src/components/banner/Banner.stories.tsx +448 -0
- package/src/components/banner/Banner.tsx +602 -0
- package/src/components/banner/index.ts +14 -0
- package/src/components/button/Button.mdx +286 -0
- package/src/components/button/Button.stories.tsx +381 -0
- package/src/components/button/Button.tsx +384 -0
- package/src/components/button/index.ts +1 -0
- package/src/components/button-group/ButtonGroup.mdx +512 -0
- package/src/components/button-group/ButtonGroup.stories.tsx +714 -0
- package/src/components/button-group/ButtonGroup.tsx +491 -0
- package/src/components/button-group/index.ts +10 -0
- package/src/components/card-select/CardSelect.mdx +662 -0
- package/src/components/card-select/CardSelect.stories.tsx +784 -0
- package/src/components/card-select/CardSelect.tsx +783 -0
- package/src/components/card-select/CardSelectGroup.tsx +169 -0
- package/src/components/card-select/index.ts +18 -0
- package/src/components/checkbox/Checkbox.mdx +269 -0
- package/src/components/checkbox/Checkbox.stories.tsx +306 -0
- package/src/components/checkbox/Checkbox.tsx +343 -0
- package/src/components/checkbox/index.ts +1 -0
- package/src/components/chip/Chip.mdx +683 -0
- package/src/components/chip/Chip.stories.tsx +734 -0
- package/src/components/chip/Chip.tsx +732 -0
- package/src/components/chip/index.ts +9 -0
- package/src/components/column-header/ColumnHeader.mdx +301 -0
- package/src/components/column-header/ColumnHeader.stories.tsx +319 -0
- package/src/components/column-header/ColumnHeader.tsx +287 -0
- package/src/components/column-header/index.ts +7 -0
- package/src/components/combobox-field/Combobox.tsx +693 -0
- package/src/components/combobox-field/ComboboxField.mdx +525 -0
- package/src/components/combobox-field/ComboboxField.stories.tsx +502 -0
- package/src/components/combobox-field/ComboboxField.tsx +259 -0
- package/src/components/combobox-field/index.ts +12 -0
- package/src/components/date-field/DateField.mdx +340 -0
- package/src/components/date-field/DateField.stories.tsx +221 -0
- package/src/components/date-field/DateField.tsx +176 -0
- package/src/components/date-field/index.ts +1 -0
- package/src/components/date-picker/DatePicker.mdx +436 -0
- package/src/components/date-picker/DatePicker.stories.tsx +458 -0
- package/src/components/date-picker/DatePicker.tsx +688 -0
- package/src/components/date-picker/index.ts +9 -0
- package/src/components/divider/Divider.mdx +256 -0
- package/src/components/divider/Divider.stories.tsx +177 -0
- package/src/components/divider/Divider.tsx +193 -0
- package/src/components/divider/index.ts +1 -0
- package/src/components/drawer/Drawer.mdx +518 -0
- package/src/components/drawer/Drawer.stories.tsx +392 -0
- package/src/components/drawer/Drawer.tsx +683 -0
- package/src/components/drawer/index.ts +1 -0
- package/src/components/dropdown-button/DropdownButton.mdx +285 -0
- package/src/components/dropdown-button/DropdownButton.stories.tsx +398 -0
- package/src/components/dropdown-button/DropdownButton.tsx +198 -0
- package/src/components/dropdown-button/index.ts +7 -0
- package/src/components/faq/FAQ.mdx +364 -0
- package/src/components/faq/FAQ.stories.tsx +343 -0
- package/src/components/faq/FAQ.tsx +337 -0
- package/src/components/faq/index.ts +1 -0
- package/src/components/field/Field.mdx +129 -0
- package/src/components/field/Field.stories.tsx +461 -0
- package/src/components/field/Field.tsx +765 -0
- package/src/components/field/index.ts +20 -0
- package/src/components/field-pair/FieldPair.mdx +308 -0
- package/src/components/field-pair/FieldPair.stories.tsx +530 -0
- package/src/components/field-pair/FieldPair.tsx +796 -0
- package/src/components/field-pair/index.ts +9 -0
- package/src/components/file-upload/FileUpload.mdx +345 -0
- package/src/components/file-upload/FileUpload.stories.tsx +698 -0
- package/src/components/file-upload/FileUpload.tsx +802 -0
- package/src/components/file-upload/index.ts +6 -0
- package/src/components/filter-chip/FilterChip.mdx +778 -0
- package/src/components/filter-chip/FilterChip.stories.tsx +827 -0
- package/src/components/filter-chip/FilterChip.tsx +881 -0
- package/src/components/filter-chip/index.ts +11 -0
- package/src/components/filter-facet/FilterFacet.mdx +536 -0
- package/src/components/filter-facet/FilterFacet.stories.tsx +506 -0
- package/src/components/filter-facet/FilterFacet.tsx +1160 -0
- package/src/components/filter-facet/index.ts +7 -0
- package/src/components/firm-avatar/FirmAvatar.mdx +280 -0
- package/src/components/firm-avatar/FirmAvatar.stories.tsx +147 -0
- package/src/components/firm-avatar/FirmAvatar.tsx +172 -0
- package/src/components/firm-avatar/index.ts +7 -0
- package/src/components/form-actions/FormActions.mdx +518 -0
- package/src/components/form-actions/FormActions.stories.tsx +621 -0
- package/src/components/form-actions/FormActions.tsx +273 -0
- package/src/components/form-actions/index.ts +6 -0
- package/src/components/form-block/FormBlock.mdx +728 -0
- package/src/components/form-block/FormBlock.stories.tsx +813 -0
- package/src/components/form-block/FormBlock.tsx +679 -0
- package/src/components/form-block/index.ts +13 -0
- package/src/components/form-section/FormSection.mdx +436 -0
- package/src/components/form-section/FormSection.stories.tsx +407 -0
- package/src/components/form-section/FormSection.tsx +290 -0
- package/src/components/form-section/index.ts +17 -0
- package/src/components/heading/Heading.mdx +206 -0
- package/src/components/heading/Heading.stories.tsx +169 -0
- package/src/components/heading/Heading.tsx +124 -0
- package/src/components/heading/index.ts +8 -0
- package/src/components/heading-group/HeadingGroup.mdx +521 -0
- package/src/components/heading-group/HeadingGroup.stories.tsx +353 -0
- package/src/components/heading-group/HeadingGroup.tsx +396 -0
- package/src/components/heading-group/index.ts +7 -0
- package/src/components/hero/Hero.mdx +742 -0
- package/src/components/hero/Hero.stories.tsx +527 -0
- package/src/components/hero/Hero.tsx +807 -0
- package/src/components/hero/index.ts +1 -0
- package/src/components/icon/Icon.mdx +329 -0
- package/src/components/icon/Icon.stories.tsx +398 -0
- package/src/components/icon/Icon.tsx +97 -0
- package/src/components/icon/index.ts +2 -0
- package/src/components/icon-button/IconButton.mdx +206 -0
- package/src/components/icon-button/IconButton.stories.tsx +341 -0
- package/src/components/icon-button/IconButton.tsx +273 -0
- package/src/components/icon-button/index.ts +1 -0
- package/src/components/item-row/ItemRow.mdx +533 -0
- package/src/components/item-row/ItemRow.stories.tsx +434 -0
- package/src/components/item-row/ItemRow.tsx +676 -0
- package/src/components/item-row/index.ts +9 -0
- package/src/components/list-row/ListRow.mdx +404 -0
- package/src/components/list-row/ListRow.stories.tsx +404 -0
- package/src/components/list-row/ListRow.tsx +424 -0
- package/src/components/list-row/index.ts +1 -0
- package/src/components/menu/Menu.mdx +268 -0
- package/src/components/menu/Menu.stories.tsx +455 -0
- package/src/components/menu/Menu.tsx +452 -0
- package/src/components/menu/index.ts +1 -0
- package/src/components/modal/Modal.mdx +854 -0
- package/src/components/modal/Modal.stories.tsx +881 -0
- package/src/components/modal/Modal.tsx +1434 -0
- package/src/components/modal/index.ts +1 -0
- package/src/components/nav-link/NavLink.mdx +196 -0
- package/src/components/nav-link/NavLink.stories.tsx +243 -0
- package/src/components/nav-link/NavLink.tsx +222 -0
- package/src/components/nav-link/index.ts +1 -0
- package/src/components/number-field/NumberField.mdx +223 -0
- package/src/components/number-field/NumberField.stories.tsx +291 -0
- package/src/components/number-field/NumberField.tsx +388 -0
- package/src/components/number-field/index.ts +6 -0
- package/src/components/pagination/Pagination.mdx +305 -0
- package/src/components/pagination/Pagination.stories.tsx +333 -0
- package/src/components/pagination/Pagination.tsx +343 -0
- package/src/components/pagination/index.ts +8 -0
- package/src/components/popover-surface/PopoverSurface.mdx +158 -0
- package/src/components/popover-surface/PopoverSurface.stories.tsx +421 -0
- package/src/components/popover-surface/index.ts +1 -0
- package/src/components/progress-bar/ProgressBar.mdx +802 -0
- package/src/components/progress-bar/ProgressBar.stories.tsx +533 -0
- package/src/components/progress-bar/ProgressBar.tsx +654 -0
- package/src/components/progress-bar/index.ts +9 -0
- package/src/components/promo-sticker/PromoSticker.mdx +436 -0
- package/src/components/promo-sticker/PromoSticker.stories.tsx +363 -0
- package/src/components/promo-sticker/PromoSticker.tsx +313 -0
- package/src/components/promo-sticker/index.ts +7 -0
- package/src/components/promo-surface/PromoSurface.mdx +399 -0
- package/src/components/promo-surface/PromoSurface.stories.tsx +270 -0
- package/src/components/promo-surface/PromoSurface.tsx +305 -0
- package/src/components/promo-surface/index.ts +7 -0
- package/src/components/radio/Radio.mdx +243 -0
- package/src/components/radio/Radio.stories.tsx +307 -0
- package/src/components/radio/Radio.tsx +288 -0
- package/src/components/radio/index.ts +1 -0
- package/src/components/radio-group/RadioGroup.mdx +119 -0
- package/src/components/radio-group/RadioGroup.stories.tsx +225 -0
- package/src/components/radio-group/RadioGroup.tsx +139 -0
- package/src/components/radio-group/index.ts +1 -0
- package/src/components/select/Select.mdx +241 -0
- package/src/components/select/Select.stories.tsx +404 -0
- package/src/components/select/Select.tsx +381 -0
- package/src/components/select/index.ts +1 -0
- package/src/components/select-field/SelectField.mdx +324 -0
- package/src/components/select-field/SelectField.stories.tsx +460 -0
- package/src/components/select-field/SelectField.tsx +138 -0
- package/src/components/select-field/index.ts +1 -0
- package/src/components/skeleton/Skeleton.mdx +194 -0
- package/src/components/skeleton/Skeleton.stories.tsx +260 -0
- package/src/components/skeleton/Skeleton.tsx +107 -0
- package/src/components/skeleton/index.ts +1 -0
- package/src/components/split-button/SplitButton.mdx +445 -0
- package/src/components/split-button/SplitButton.stories.tsx +465 -0
- package/src/components/split-button/SplitButton.tsx +361 -0
- package/src/components/split-button/index.ts +7 -0
- package/src/components/status-summary-bar/StatusSummaryBar.mdx +338 -0
- package/src/components/status-summary-bar/StatusSummaryBar.stories.tsx +408 -0
- package/src/components/status-summary-bar/StatusSummaryBar.tsx +428 -0
- package/src/components/status-summary-bar/index.ts +8 -0
- package/src/components/subject-lookup-field/SubjectLookupField.mdx +378 -0
- package/src/components/subject-lookup-field/SubjectLookupField.stories.tsx +393 -0
- package/src/components/subject-lookup-field/SubjectLookupField.tsx +1079 -0
- package/src/components/subject-lookup-field/index.ts +11 -0
- package/src/components/switch/Switch.mdx +376 -0
- package/src/components/switch/Switch.stories.tsx +296 -0
- package/src/components/switch/Switch.tsx +483 -0
- package/src/components/switch/index.ts +1 -0
- package/src/components/table/Table.mdx +575 -0
- package/src/components/table/Table.stories.tsx +1049 -0
- package/src/components/table/Table.tsx +745 -0
- package/src/components/table/TableConsumers.stories.tsx +195 -0
- package/src/components/table/_tableFixtures.ts +1189 -0
- package/src/components/table/index.ts +22 -0
- package/src/components/text-field/TextField.mdx +479 -0
- package/src/components/text-field/TextField.stories.tsx +366 -0
- package/src/components/text-field/TextField.tsx +391 -0
- package/src/components/text-field/index.ts +8 -0
- package/src/components/text-link/TextLink.mdx +353 -0
- package/src/components/text-link/TextLink.stories.tsx +458 -0
- package/src/components/text-link/TextLink.tsx +504 -0
- package/src/components/text-link/index.ts +10 -0
- package/src/components/textarea/Textarea.mdx +244 -0
- package/src/components/textarea/Textarea.stories.tsx +371 -0
- package/src/components/textarea/Textarea.tsx +489 -0
- package/src/components/textarea/index.ts +9 -0
- package/src/components/tooltip/Tooltip.mdx +462 -0
- package/src/components/tooltip/Tooltip.stories.tsx +500 -0
- package/src/components/tooltip/Tooltip.tsx +756 -0
- package/src/components/tooltip/index.ts +13 -0
- package/src/components/unit-field/UnitField.mdx +215 -0
- package/src/components/unit-field/UnitField.stories.tsx +291 -0
- package/src/components/unit-field/UnitField.tsx +255 -0
- package/src/components/unit-field/index.ts +7 -0
- package/src/icons/icon-registry.generated.ts +510 -0
- package/src/icons/icon-types.generated.ts +256 -0
- package/src/index.ts +71 -0
- package/src/internal/BottomSheet.tsx +714 -0
- package/src/internal/FodsProvider.tsx +36 -0
- package/src/internal/MotionCaret.tsx +53 -0
- package/src/internal/NumberFormatInput.tsx +276 -0
- package/src/internal/SummaryDonut.tsx +359 -0
- package/src/internal/buttonSegment.ts +241 -0
- package/src/internal/collapseRoom.ts +130 -0
- package/src/internal/comboboxKeys.ts +90 -0
- package/src/internal/contentPresence.ts +46 -0
- package/src/internal/dayCell.ts +274 -0
- package/src/internal/dialogPortal.ts +50 -0
- package/src/internal/donutSweeps.ts +77 -0
- package/src/internal/enterOnViewGeometry.ts +53 -0
- package/src/internal/faqItem.ts +104 -0
- package/src/internal/floatingLabelMotion.tsx +109 -0
- package/src/internal/formBlockContext.ts +27 -0
- package/src/internal/heightRoom.ts +135 -0
- package/src/internal/numberSeparators.ts +93 -0
- package/src/internal/overlayMotion.tsx +32 -0
- package/src/internal/paginationItem.ts +106 -0
- package/src/internal/popoverSurface.ts +78 -0
- package/src/internal/portalContainer.ts +11 -0
- package/src/internal/progressBarItem.ts +356 -0
- package/src/internal/selectionControlText.ts +42 -0
- package/src/internal/statusSummaryParts.tsx +475 -0
- package/src/internal/summaryMotion.ts +111 -0
- package/src/internal/table/ChildConnector.tsx +57 -0
- package/src/internal/table/ChildRowPrefix.tsx +21 -0
- package/src/internal/table/ColumnSettings.tsx +194 -0
- package/src/internal/table/ScrollRegion.tsx +176 -0
- package/src/internal/table/TableEmpty.tsx +99 -0
- package/src/internal/table/TableLayout.tsx +29 -0
- package/src/internal/table/TableLoadStatus.tsx +60 -0
- package/src/internal/table/TableMobile.tsx +582 -0
- package/src/internal/table/TruncatedCell.tsx +35 -0
- package/src/internal/table/emptyValue.ts +11 -0
- package/src/internal/table/features.ts +44 -0
- package/src/internal/table/recipes.ts +263 -0
- package/src/internal/table/rowClick.ts +8 -0
- package/src/internal/table/types.ts +342 -0
- package/src/internal/tailwind-variants.ts +65 -0
- package/src/internal/tooltipContext.ts +15 -0
- package/src/internal/tw-merge-config.generated.ts +275 -0
- package/src/internal/useAnchoredPanel.ts +340 -0
- package/src/internal/useCountUp.ts +65 -0
- package/src/internal/useDateFieldTrigger.tsx +357 -0
- package/src/internal/useEChart.ts +88 -0
- package/src/internal/useEnterOnView.ts +80 -0
- package/src/internal/useFloatingBar.ts +125 -0
- package/src/internal/useFormReset.ts +47 -0
- package/src/internal/useIsMobile.ts +64 -0
- package/src/internal/useNoImplicitSubmit.ts +41 -0
- package/src/internal/useOneRowOverflow.ts +103 -0
- package/src/internal/usePrefersReducedMotion.ts +27 -0
- package/src/internal/useReturnFocus.ts +34 -0
- package/src/internal/utils.ts +58 -0
- package/src/recipes/EmptyState.stories.tsx +105 -0
- package/src/recipes/Form.stories.tsx +355 -0
- package/src/recipes/ModalWithForm.stories.tsx +219 -0
- package/src/recipes/Recipes.mdx +61 -0
- package/src/recipes/TableWithFilters.stories.tsx +278 -0
- package/src/storybook/FodsFamily.tsx +39 -0
- package/src/storybook/Section.tsx +36 -0
- package/src/storybook/a11y.ts +24 -0
- package/src/storybook/assets/banner-character-bartender.webp +0 -0
- package/src/storybook/assets/banner-invoice-sheet-left.webp +0 -0
- package/src/storybook/assets/banner-invoice-sheet-right.webp +0 -0
- package/src/storybook/assets/invoice-hero.webp +0 -0
- package/src/storybook/assets/invoice.webp +0 -0
- package/src/storybook/assets/section-document-info.svg +21 -0
- package/src/storybook/assets/section-gear-checklist.svg +11 -0
- package/src/storybook/assets/section-person-arrow-in.svg +15 -0
- package/src/storybook/assets/section-person-arrow-out.svg +22 -0
- package/src/storybook/assets/section-receipt-dollar.svg +23 -0
- package/src/storybook/assets/table-empty-folder-empty.png +0 -0
- package/src/storybook/assets/table-empty-folder-magnifying-glass.png +0 -0
- package/src/storybook/assets/table-empty-funnel.png +0 -0
- package/src/storybook/assets/table-empty-load-failed.png +0 -0
- package/src/storybook/assets/wallet-spot.png +0 -0
- package/src/storybook/assets.d.ts +17 -0
- package/src/storybook/componentDoc.ts +41 -0
- package/src/storybook/fitFrame.tsx +70 -0
- package/src/storybook/forceStates.tsx +647 -0
- package/src/storybook/illustrations.tsx +66 -0
- package/src/storybook/viewportFrame.tsx +58 -0
- package/src/styles/assets/label-brush-1.svg +6 -0
- package/src/styles/assets/pattern-dark.svg +113 -0
- package/src/styles/base.css +106 -0
- package/src/styles/index.css +15 -0
- package/src/styles/motion.css +157 -0
- package/src/styles/promo-sticker.css +27 -0
- package/src/styles/promo-surface.css +49 -0
- package/src/styles/shared.css +11 -0
- package/src/styles/theme.generated.css +314 -0
- package/src/styles/theme.map.json +278 -0
- package/src/styles/tracking.generated.css +12 -0
- package/src/tokens/index.ts +4 -0
- package/src/tokens/tokens.generated.ts +542 -0
|
@@ -0,0 +1,756 @@
|
|
|
1
|
+
"use client";
|
|
2
|
+
import * as React from 'react';
|
|
3
|
+
import * as TooltipPrimitive from '@radix-ui/react-tooltip';
|
|
4
|
+
import {
|
|
5
|
+
useFloating,
|
|
6
|
+
autoUpdate,
|
|
7
|
+
offset,
|
|
8
|
+
flip,
|
|
9
|
+
shift,
|
|
10
|
+
size as sizeMiddleware,
|
|
11
|
+
arrow as arrowMiddleware,
|
|
12
|
+
useHover,
|
|
13
|
+
useFocus,
|
|
14
|
+
useClick,
|
|
15
|
+
useDismiss,
|
|
16
|
+
useInteractions,
|
|
17
|
+
useMergeRefs,
|
|
18
|
+
safePolygon,
|
|
19
|
+
FloatingPortal,
|
|
20
|
+
FloatingFocusManager,
|
|
21
|
+
FloatingArrow,
|
|
22
|
+
type OpenChangeReason,
|
|
23
|
+
} from '@floating-ui/react';
|
|
24
|
+
import { AnimatePresence, motion, useReducedMotion, type HTMLMotionProps } from 'motion/react';
|
|
25
|
+
import { curves, semantic, springs } from '../../tokens';
|
|
26
|
+
import { tv, type VariantProps } from '../../internal/tailwind-variants';
|
|
27
|
+
import { cn } from '../../internal/utils';
|
|
28
|
+
import { TooltipBodyContext } from '../../internal/tooltipContext';
|
|
29
|
+
import { useDialogRoot, usePortalTarget } from '../../internal/dialogPortal';
|
|
30
|
+
|
|
31
|
+
/**
|
|
32
|
+
* Tooltip — a transient label that explains the element under the pointer / keyboard
|
|
33
|
+
* focus. It is chrome, not content: it never holds buttons or form fields (that is a
|
|
34
|
+
* Popover), and in the plain mode it disappears as soon as the trigger loses hover or
|
|
35
|
+
* focus. One inline link is allowed, but only in the TOGGLETIP mode (`toggletip`
|
|
36
|
+
* prop, manifest 1.3.0) — which is also the mode for a touch-only trigger.
|
|
37
|
+
*
|
|
38
|
+
* Anatomy (spec `03-atoms/tooltip.md`):
|
|
39
|
+
* - BUBBLE — the floating surface: `--bg-inverse` fill, `--text-inverted` text,
|
|
40
|
+
* `--radius-400` corners, `--shadow-raised` lift, `--space-100` gap between the
|
|
41
|
+
* stacked title and body.
|
|
42
|
+
* - TITLE — a short phrase that wraps, `--text-body-sm` semibold. MEDIUM ONLY; the Small
|
|
43
|
+
* size is a bare one-line label and never carries a title.
|
|
44
|
+
* - BODY / LABEL — the explanation itself, `--text-body-xs` regular. Wraps in BOTH
|
|
45
|
+
* sizes: Medium inside its 280 cap, Small once it runs out of available width.
|
|
46
|
+
* Neither ever truncates (WCAG 1.4.13) — "Small is one line" is a copy
|
|
47
|
+
* recommendation, not a CSS contract (manifest 1.2.0 splits the runs:
|
|
48
|
+
* `text.label` 60 chars for Small, `text.body` 160 for Medium).
|
|
49
|
+
* - CARET — a 12×6 (base × depth) triangle filled with the same `--bg-inverse`,
|
|
50
|
+
* pointing back at the trigger. Optional.
|
|
51
|
+
*
|
|
52
|
+
* Sizes: `sm` (label, `--space-400` / `--space-500` padding, hug width then wrap) and
|
|
53
|
+
* `md` (title + wrapping body, `--space-500` / `--space-600` padding, capped width).
|
|
54
|
+
*
|
|
55
|
+
* The simplified `<Tooltip>` renders the bubble through `TooltipPortal` on <body>, so a
|
|
56
|
+
* clipping ancestor (`overflow: hidden` / `auto`) can never cut it off; low-level
|
|
57
|
+
* compositions have to add the portal themselves. `sideOffset` is the gap between the
|
|
58
|
+
* caret TIP and the trigger edge and defaults to `--space-200` (manifest
|
|
59
|
+
* `chrome.trigger-offset`, 1.5.0) on every placement, in both engines.
|
|
60
|
+
*
|
|
61
|
+
* Motion (manifest 1.6.1 `motion`): a `--duration-slow` hover-intent delay before it
|
|
62
|
+
* appears, then a fade plus a `--space-100` travel TOWARD the trigger on `springs.standard`
|
|
63
|
+
* (side=top starts higher and settles down onto the trigger); exit is the reverse, back
|
|
64
|
+
* away. No scale — a tooltip is text. Mounted through `AnimatePresence`, so a pointer that
|
|
65
|
+
* leaves before the bubble has landed reverses it from where it is. Under reduced motion
|
|
66
|
+
* (`useReducedMotion()`, no `MotionConfig` needed) the bubble drops the travel and the fade
|
|
67
|
+
* shortens itself to `--duration-instant`.
|
|
68
|
+
*
|
|
69
|
+
* A tooltip has only SHOWN and HIDDEN — it owns no hover, focus or disabled state of
|
|
70
|
+
* its own, because it is never a target. Those states belong to the trigger.
|
|
71
|
+
*
|
|
72
|
+
* Colour, spacing, radius and shadow are mapped 1:1 from the design system — no
|
|
73
|
+
* hardcoded values.
|
|
74
|
+
*/
|
|
75
|
+
const tooltipVariants = tv({
|
|
76
|
+
slots: {
|
|
77
|
+
// The bubble. Colour / radius / shadow chrome is shared by every size.
|
|
78
|
+
// No `overflow-hidden` here: the Radix caret is rendered as an absolutely
|
|
79
|
+
// positioned child that sits OUTSIDE the bubble box, so clipping would eat it.
|
|
80
|
+
content: [
|
|
81
|
+
// --z-index-popover (1500): the layer the FODS tokens name for tooltips — portalled to
|
|
82
|
+
// <body> (the toggletip into an enclosing dialog instead), it sits above the
|
|
83
|
+
// Modal / Drawer (1400) it can be opened from.
|
|
84
|
+
'z-popover flex flex-col gap-100',
|
|
85
|
+
'rounded-400 bg-background-inverse text-text-inverted shadow-raised',
|
|
86
|
+
// Enter / exit are Motion props on the bubble (TooltipMotionBubble), not classes.
|
|
87
|
+
],
|
|
88
|
+
// Medium only — the spec forbids a title on the Small size.
|
|
89
|
+
title: 'text-body-sm font-semibold',
|
|
90
|
+
body: 'text-body-xs font-normal',
|
|
91
|
+
// Caret shares the bubble fill; geometry (12×6) is set on the Arrow element.
|
|
92
|
+
arrow: 'fill-background-inverse',
|
|
93
|
+
},
|
|
94
|
+
variants: {
|
|
95
|
+
size: {
|
|
96
|
+
// Label, hugs its text — no title. `w-max` keeps it on a single line the way
|
|
97
|
+
// `whitespace-nowrap` did, but the cap is the width Radix leaves to the viewport
|
|
98
|
+
// edge (--radix-tooltip-content-available-width, set by Radix on this element), so an
|
|
99
|
+
// over-long label WRAPS instead of running off screen. That is the contract, not a
|
|
100
|
+
// fallback: manifest text.label sets overflow: wrap and the bubble must never clip
|
|
101
|
+
// supplementary content (WCAG 1.4.13) — never add `truncate` / `whitespace-nowrap`
|
|
102
|
+
// here. The ~60-char Small budget is a copy recommendation, not a CSS limit.
|
|
103
|
+
sm: {
|
|
104
|
+
content:
|
|
105
|
+
'w-max max-w-[var(--radix-tooltip-content-available-width)] px-500 py-400 text-body-xs font-normal',
|
|
106
|
+
},
|
|
107
|
+
// Title + wrapping body. The 280px cap is a COMPONENT CONSTANT: the
|
|
108
|
+
// spec states tooltip widths are not tokenised, so there is no width token to
|
|
109
|
+
// map onto and the Figma measurement is encoded here.
|
|
110
|
+
md: {
|
|
111
|
+
// fods-lint-disable-next-line Medium width cap is a component constant from Figma; the spec states tooltip widths are deliberately NOT tokenised, so there is no token to map onto
|
|
112
|
+
content: 'max-w-[280px] px-600 py-500 text-body-xs font-normal',
|
|
113
|
+
},
|
|
114
|
+
},
|
|
115
|
+
},
|
|
116
|
+
defaultVariants: {
|
|
117
|
+
size: 'sm',
|
|
118
|
+
},
|
|
119
|
+
});
|
|
120
|
+
|
|
121
|
+
export type TooltipSize = 'sm' | 'md';
|
|
122
|
+
|
|
123
|
+
/** Hover-intent delay before the bubble appears, in ms (--duration-slow = 300). */
|
|
124
|
+
const TOOLTIP_DELAY_DURATION = curves.duration.slow * 1000;
|
|
125
|
+
|
|
126
|
+
/** Caret geometry from Figma: 12px base × 6px depth. */
|
|
127
|
+
const TOOLTIP_ARROW_WIDTH = 12;
|
|
128
|
+
const TOOLTIP_ARROW_HEIGHT = 6;
|
|
129
|
+
|
|
130
|
+
/**
|
|
131
|
+
* Caret tip → trigger edge, --space-200 (manifest chrome.trigger-offset). Positioning
|
|
132
|
+
* engines take a number, not a CSS variable, so the token's px value is read here (4).
|
|
133
|
+
* Radix measures `sideOffset` from the caret tip (it adds the arrow height itself);
|
|
134
|
+
* the floating-ui toggletip measures from the bubble edge and adds the caret depth.
|
|
135
|
+
*/
|
|
136
|
+
const TOOLTIP_TRIGGER_OFFSET = parseFloat(semantic.spacing['200'].resolvedValue);
|
|
137
|
+
|
|
138
|
+
type TooltipSide = 'top' | 'right' | 'bottom' | 'left';
|
|
139
|
+
|
|
140
|
+
/**
|
|
141
|
+
* --space-100 as a number: a px keyframe needs no DOM measurement, so the exit can start
|
|
142
|
+
* (and, with animations skipped, finish) in the same frame as the close.
|
|
143
|
+
*/
|
|
144
|
+
const TRAVEL = parseFloat(semantic.spacing['100'].resolvedValue);
|
|
145
|
+
const TRAVEL_BACK = -TRAVEL;
|
|
146
|
+
|
|
147
|
+
/**
|
|
148
|
+
* The pose AWAY from the trigger per placed side: entering settles from it toward the
|
|
149
|
+
* trigger, exiting moves back to it (side=top sits above the trigger, so it starts higher).
|
|
150
|
+
*/
|
|
151
|
+
const AWAY_FROM_TRIGGER: Record<TooltipSide, { x?: number; y?: number }> = {
|
|
152
|
+
top: { y: TRAVEL_BACK },
|
|
153
|
+
bottom: { y: TRAVEL },
|
|
154
|
+
left: { x: TRAVEL_BACK },
|
|
155
|
+
right: { x: TRAVEL },
|
|
156
|
+
};
|
|
157
|
+
|
|
158
|
+
const isTooltipSide = (side: unknown): side is TooltipSide =>
|
|
159
|
+
side === 'top' || side === 'bottom' || side === 'left' || side === 'right';
|
|
160
|
+
|
|
161
|
+
type TooltipMotionBubbleProps = HTMLMotionProps<'div'> & { 'data-side'?: string };
|
|
162
|
+
|
|
163
|
+
/**
|
|
164
|
+
* Set inside a bubble. Radix's `asChild` Content repeats its `children` — this very
|
|
165
|
+
* bubble element — in the visually hidden `role="tooltip"` copy it nests in the host; the
|
|
166
|
+
* repeat sees the flag and renders the bare content, so the copy stays plain text.
|
|
167
|
+
*/
|
|
168
|
+
const InsideBubbleContext = React.createContext(false);
|
|
169
|
+
|
|
170
|
+
/**
|
|
171
|
+
* The bubble as a Motion element. Both engines write the PLACED side (after a collision
|
|
172
|
+
* flip) to `data-side`, so the travel direction follows where the bubble really is.
|
|
173
|
+
*/
|
|
174
|
+
const TooltipMotionBubble = React.forwardRef<HTMLDivElement, TooltipMotionBubbleProps>(
|
|
175
|
+
(props, ref) => {
|
|
176
|
+
const reduce = useReducedMotion();
|
|
177
|
+
const insideBubble = React.useContext(InsideBubbleContext);
|
|
178
|
+
if (insideBubble) return <>{props.children as React.ReactNode}</>;
|
|
179
|
+
const side = props['data-side'];
|
|
180
|
+
// Reduced motion: no movement, the bubble only fades.
|
|
181
|
+
const away = reduce ? { opacity: 0 } : { opacity: 0, ...AWAY_FROM_TRIGGER[isTooltipSide(side) ? side : 'top'] };
|
|
182
|
+
return (
|
|
183
|
+
<InsideBubbleContext.Provider value>
|
|
184
|
+
<motion.div
|
|
185
|
+
ref={ref}
|
|
186
|
+
initial={away}
|
|
187
|
+
animate={{ opacity: 1, x: 0, y: 0 }}
|
|
188
|
+
exit={away}
|
|
189
|
+
transition={reduce ? { duration: curves.duration.instant } : springs.standard}
|
|
190
|
+
{...props}
|
|
191
|
+
/>
|
|
192
|
+
</InsideBubbleContext.Provider>
|
|
193
|
+
);
|
|
194
|
+
},
|
|
195
|
+
);
|
|
196
|
+
TooltipMotionBubble.displayName = 'TooltipMotionBubble';
|
|
197
|
+
|
|
198
|
+
/**
|
|
199
|
+
* Open state of the enclosing `TooltipRoot`, so `TooltipPortal` / `TooltipContent` can mount
|
|
200
|
+
* through `AnimatePresence` and play the exit. `null` under a bare Radix Root: the bubble
|
|
201
|
+
* then still enters, but unmounts without an exit.
|
|
202
|
+
*/
|
|
203
|
+
const TooltipOpenContext = React.createContext<boolean | null>(null);
|
|
204
|
+
/** True inside a `TooltipPortal` that already owns the `AnimatePresence`. */
|
|
205
|
+
const TooltipPresenceContext = React.createContext(false);
|
|
206
|
+
|
|
207
|
+
const TooltipProvider = ({
|
|
208
|
+
delayDuration = TOOLTIP_DELAY_DURATION,
|
|
209
|
+
...props
|
|
210
|
+
}: React.ComponentPropsWithoutRef<typeof TooltipPrimitive.Provider>) => (
|
|
211
|
+
<TooltipPrimitive.Provider delayDuration={delayDuration} {...props} />
|
|
212
|
+
);
|
|
213
|
+
|
|
214
|
+
/**
|
|
215
|
+
* Radix Root with its open state mirrored into `TooltipOpenContext` — Radix keeps it
|
|
216
|
+
* private, and the exit animation needs it above the portal.
|
|
217
|
+
*/
|
|
218
|
+
const TooltipRoot = ({
|
|
219
|
+
open: openProp,
|
|
220
|
+
defaultOpen = false,
|
|
221
|
+
onOpenChange,
|
|
222
|
+
...props
|
|
223
|
+
}: React.ComponentPropsWithoutRef<typeof TooltipPrimitive.Root>) => {
|
|
224
|
+
const [uncontrolledOpen, setUncontrolledOpen] = React.useState(defaultOpen);
|
|
225
|
+
const isControlled = openProp !== undefined;
|
|
226
|
+
const open = isControlled ? openProp : uncontrolledOpen;
|
|
227
|
+
const handleOpenChange = React.useCallback(
|
|
228
|
+
(next: boolean) => {
|
|
229
|
+
if (!isControlled) setUncontrolledOpen(next);
|
|
230
|
+
onOpenChange?.(next);
|
|
231
|
+
},
|
|
232
|
+
[isControlled, onOpenChange],
|
|
233
|
+
);
|
|
234
|
+
return (
|
|
235
|
+
<TooltipOpenContext.Provider value={open}>
|
|
236
|
+
<TooltipPrimitive.Root open={open} onOpenChange={handleOpenChange} {...props} />
|
|
237
|
+
</TooltipOpenContext.Provider>
|
|
238
|
+
);
|
|
239
|
+
};
|
|
240
|
+
const TooltipTrigger = TooltipPrimitive.Trigger;
|
|
241
|
+
/**
|
|
242
|
+
* Renders the bubble in a portal on <body> (or the surface's `PortalContainerContext`
|
|
243
|
+
* element). The simplified `<Tooltip>` uses it by default; low-level compositions must add
|
|
244
|
+
* it themselves whenever the trigger sits in a container that clips (`overflow: hidden` /
|
|
245
|
+
* `auto`), otherwise the bubble gets cut off.
|
|
246
|
+
*/
|
|
247
|
+
const TooltipPortal = ({ container, ...props }: TooltipPrimitive.TooltipPortalProps) => {
|
|
248
|
+
const portalTarget = usePortalTarget();
|
|
249
|
+
const open = React.useContext(TooltipOpenContext);
|
|
250
|
+
if (open === null) {
|
|
251
|
+
return <TooltipPrimitive.Portal container={container ?? portalTarget} {...props} />;
|
|
252
|
+
}
|
|
253
|
+
return (
|
|
254
|
+
<TooltipPresenceContext.Provider value>
|
|
255
|
+
<AnimatePresence>
|
|
256
|
+
{open && (
|
|
257
|
+
<TooltipPrimitive.Portal
|
|
258
|
+
key="tooltip"
|
|
259
|
+
forceMount
|
|
260
|
+
container={container ?? portalTarget}
|
|
261
|
+
{...props}
|
|
262
|
+
/>
|
|
263
|
+
)}
|
|
264
|
+
</AnimatePresence>
|
|
265
|
+
</TooltipPresenceContext.Provider>
|
|
266
|
+
);
|
|
267
|
+
};
|
|
268
|
+
|
|
269
|
+
const TooltipArrow = React.forwardRef<
|
|
270
|
+
React.ComponentRef<typeof TooltipPrimitive.Arrow>,
|
|
271
|
+
React.ComponentPropsWithoutRef<typeof TooltipPrimitive.Arrow>
|
|
272
|
+
>(({ className, width = TOOLTIP_ARROW_WIDTH, height = TOOLTIP_ARROW_HEIGHT, ...props }, ref) => (
|
|
273
|
+
<TooltipPrimitive.Arrow
|
|
274
|
+
ref={ref}
|
|
275
|
+
width={width}
|
|
276
|
+
height={height}
|
|
277
|
+
// Radix renders the arrow as a bare <svg> with no a11y attribute of its own, so
|
|
278
|
+
// the decorative-glyph rule has to be satisfied here — everywhere else in the DS
|
|
279
|
+
// it comes free from <Icon>, which hardcodes aria-hidden.
|
|
280
|
+
aria-hidden="true"
|
|
281
|
+
// data-fods-part marks the component's parts for measurement in the browser.
|
|
282
|
+
// Not inert in this package: `styles/base.css` scopes its reset to these attributes.
|
|
283
|
+
data-fods-part="caret"
|
|
284
|
+
className={cn(tooltipVariants().arrow(), className)}
|
|
285
|
+
{...props}
|
|
286
|
+
/>
|
|
287
|
+
));
|
|
288
|
+
TooltipArrow.displayName = TooltipPrimitive.Arrow.displayName;
|
|
289
|
+
|
|
290
|
+
export interface TooltipContentProps
|
|
291
|
+
extends React.ComponentPropsWithoutRef<typeof TooltipPrimitive.Content>,
|
|
292
|
+
VariantProps<typeof tooltipVariants> {
|
|
293
|
+
/**
|
|
294
|
+
* Bubble size.
|
|
295
|
+
* - `sm` — one-line label, hug width, no title.
|
|
296
|
+
* - `md` — optional title + wrapping body, width capped at the Medium constant.
|
|
297
|
+
*/
|
|
298
|
+
size?: TooltipSize;
|
|
299
|
+
}
|
|
300
|
+
|
|
301
|
+
const TooltipContent = React.forwardRef<
|
|
302
|
+
React.ComponentRef<typeof TooltipPrimitive.Content>,
|
|
303
|
+
TooltipContentProps
|
|
304
|
+
>(({ className, size = 'sm', sideOffset = TOOLTIP_TRIGGER_OFFSET, children, ...props }, ref) => {
|
|
305
|
+
const open = React.useContext(TooltipOpenContext);
|
|
306
|
+
const inPresence = React.useContext(TooltipPresenceContext);
|
|
307
|
+
const content = (
|
|
308
|
+
<TooltipPrimitive.Content
|
|
309
|
+
ref={ref}
|
|
310
|
+
// Kept mounted while closed so AnimatePresence can play the exit (data-state="closed").
|
|
311
|
+
{...(open !== null ? { forceMount: true as const } : {})}
|
|
312
|
+
asChild
|
|
313
|
+
sideOffset={sideOffset}
|
|
314
|
+
// The bubble is this component's root: it carries the manifest id so the
|
|
315
|
+
// runtime probe can attribute every nested part to `tooltip`.
|
|
316
|
+
data-fods-component="tooltip"
|
|
317
|
+
data-fods-part="bubble"
|
|
318
|
+
className={cn(tooltipVariants({ size }).content(), className)}
|
|
319
|
+
{...props}
|
|
320
|
+
>
|
|
321
|
+
<TooltipMotionBubble>{children}</TooltipMotionBubble>
|
|
322
|
+
</TooltipPrimitive.Content>
|
|
323
|
+
);
|
|
324
|
+
// An inline composition (no TooltipPortal) owns its presence here.
|
|
325
|
+
if (open === null || inPresence) return content;
|
|
326
|
+
return <AnimatePresence>{open && content}</AnimatePresence>;
|
|
327
|
+
});
|
|
328
|
+
TooltipContent.displayName = TooltipPrimitive.Content.displayName;
|
|
329
|
+
|
|
330
|
+
// ============================================
|
|
331
|
+
// 🎯 SIMPLIFIED TOOLTIP - Main Component
|
|
332
|
+
// ============================================
|
|
333
|
+
|
|
334
|
+
export interface TooltipProps {
|
|
335
|
+
/**
|
|
336
|
+
* Tooltip body (string or JSX element). A link is allowed ONLY together with
|
|
337
|
+
* `toggletip`, and only as one inline `<TextLink surface="inverse">` in the copy.
|
|
338
|
+
*/
|
|
339
|
+
content: React.ReactNode;
|
|
340
|
+
/** Optional heading above the body. Rendered for `size="md"` only. */
|
|
341
|
+
title?: React.ReactNode;
|
|
342
|
+
/** Bubble size — `sm` (one-line label) or `md` (title + wrapping body) */
|
|
343
|
+
size?: TooltipSize;
|
|
344
|
+
/** Child element to trigger the tooltip */
|
|
345
|
+
children: React.ReactElement;
|
|
346
|
+
/** Tooltip position relative to trigger */
|
|
347
|
+
side?: 'top' | 'right' | 'bottom' | 'left';
|
|
348
|
+
/**
|
|
349
|
+
* Gap in pixels between the caret tip and the trigger edge (the bubble edge when
|
|
350
|
+
* `showArrow` is off). Defaults to 4 = `--space-200` (manifest chrome.trigger-offset).
|
|
351
|
+
*/
|
|
352
|
+
sideOffset?: number;
|
|
353
|
+
/** Show arrow pointing to trigger */
|
|
354
|
+
showArrow?: boolean;
|
|
355
|
+
/**
|
|
356
|
+
* Delay before showing the tooltip in ms. Left unset it inherits the value from
|
|
357
|
+
* `TooltipProvider` (300 = --duration-slow) instead of overriding it. The hover
|
|
358
|
+
* preview of a toggletip does not read the provider: left unset it takes the same 300.
|
|
359
|
+
*/
|
|
360
|
+
delayDuration?: number;
|
|
361
|
+
/** Controlled open state — for a trigger that opens on more than its own hover/focus. */
|
|
362
|
+
open?: boolean;
|
|
363
|
+
onOpenChange?: (open: boolean) => void;
|
|
364
|
+
/**
|
|
365
|
+
* Toggletip mode (manifest 1.3.0) — REQUIRED when `content` carries a link, and for a
|
|
366
|
+
* trigger that has no hover (touch-only). Hover / focus still preview the bubble;
|
|
367
|
+
* click, tap, Enter or Space pins it open; it closes on Escape, a second activation,
|
|
368
|
+
* an outside pointer-down or focus leaving trigger and bubble. The trigger must be a
|
|
369
|
+
* `<button>`: it gets `aria-expanded` + `aria-controls`, and the bubble drops
|
|
370
|
+
* `role="tooltip"`.
|
|
371
|
+
*/
|
|
372
|
+
toggletip?: boolean;
|
|
373
|
+
}
|
|
374
|
+
|
|
375
|
+
interface TooltipBubbleInnerProps {
|
|
376
|
+
size: TooltipSize;
|
|
377
|
+
title?: React.ReactNode;
|
|
378
|
+
content: React.ReactNode;
|
|
379
|
+
showTitle: boolean;
|
|
380
|
+
titleId?: string;
|
|
381
|
+
bodyId?: string;
|
|
382
|
+
caret?: React.ReactNode;
|
|
383
|
+
}
|
|
384
|
+
|
|
385
|
+
/**
|
|
386
|
+
* Title / body / caret — the chrome both engines (Radix for the plain mode,
|
|
387
|
+
* floating-ui for the toggletip) render inside their bubble.
|
|
388
|
+
*/
|
|
389
|
+
function TooltipBubbleInner({
|
|
390
|
+
size,
|
|
391
|
+
title,
|
|
392
|
+
content,
|
|
393
|
+
showTitle,
|
|
394
|
+
titleId,
|
|
395
|
+
bodyId,
|
|
396
|
+
caret,
|
|
397
|
+
}: TooltipBubbleInnerProps) {
|
|
398
|
+
const slots = tooltipVariants({ size });
|
|
399
|
+
|
|
400
|
+
return (
|
|
401
|
+
<>
|
|
402
|
+
{/*
|
|
403
|
+
Block wrappers, not `<span>`: `content` / `title` accept ReactNode, so a
|
|
404
|
+
caller may pass block-level JSX, which would be invalid inside an inline
|
|
405
|
+
element (the parser fosters it out and SSR reports a hydration mismatch).
|
|
406
|
+
Both are flex items of the bubble either way, so `div` changes no layout.
|
|
407
|
+
*/}
|
|
408
|
+
{showTitle && (
|
|
409
|
+
<div id={titleId} data-fods-part="title" className={slots.title()}>
|
|
410
|
+
{title}
|
|
411
|
+
</div>
|
|
412
|
+
)}
|
|
413
|
+
<div id={bodyId} data-fods-part="body" className={slots.body()}>
|
|
414
|
+
{content}
|
|
415
|
+
</div>
|
|
416
|
+
{caret}
|
|
417
|
+
</>
|
|
418
|
+
);
|
|
419
|
+
}
|
|
420
|
+
|
|
421
|
+
let warnedAboutPlainLink = false;
|
|
422
|
+
|
|
423
|
+
/**
|
|
424
|
+
* Dev-only: a link in a plain tooltip is unreachable (the bubble closes on blur and
|
|
425
|
+
* pointer-leave) and Radix duplicates the content into a visually hidden
|
|
426
|
+
* `role="tooltip"` node, so the link would also exist twice in the accessibility tree.
|
|
427
|
+
*/
|
|
428
|
+
const warnOnPlainLink = (node: HTMLElement | null) => {
|
|
429
|
+
if (process.env.NODE_ENV === 'production' || warnedAboutPlainLink || node == null) return;
|
|
430
|
+
if (node.querySelector('a[href]') == null) return;
|
|
431
|
+
warnedAboutPlainLink = true;
|
|
432
|
+
console.warn(
|
|
433
|
+
'Tooltip: `content` contains a link, which is only allowed with `toggletip`. ' +
|
|
434
|
+
'A plain tooltip closes before the link can be reached, and Radix duplicates the ' +
|
|
435
|
+
'content into a hidden role="tooltip" node. Pass `toggletip`.',
|
|
436
|
+
);
|
|
437
|
+
};
|
|
438
|
+
|
|
439
|
+
type TooltipEngineProps = Omit<TooltipProps, 'toggletip'> & {
|
|
440
|
+
size: TooltipSize;
|
|
441
|
+
side: NonNullable<TooltipProps['side']>;
|
|
442
|
+
sideOffset: number;
|
|
443
|
+
showArrow: boolean;
|
|
444
|
+
showTitle: boolean;
|
|
445
|
+
};
|
|
446
|
+
|
|
447
|
+
function ToggletipImpl({
|
|
448
|
+
content,
|
|
449
|
+
title,
|
|
450
|
+
size,
|
|
451
|
+
children,
|
|
452
|
+
side,
|
|
453
|
+
sideOffset,
|
|
454
|
+
showArrow,
|
|
455
|
+
showTitle,
|
|
456
|
+
delayDuration,
|
|
457
|
+
open: openProp,
|
|
458
|
+
onOpenChange,
|
|
459
|
+
}: TooltipEngineProps) {
|
|
460
|
+
const isControlled = openProp !== undefined;
|
|
461
|
+
const [uncontrolledOpen, setUncontrolledOpen] = React.useState(false);
|
|
462
|
+
const open = isControlled ? openProp : uncontrolledOpen;
|
|
463
|
+
// PINNED = opened by an activation (click / tap / Enter / Space), as opposed to a
|
|
464
|
+
// hover / focus preview. Only a pinned bubble reports aria-expanded="true".
|
|
465
|
+
const [pinned, setPinned] = React.useState(false);
|
|
466
|
+
const [hasLink, setHasLink] = React.useState(false);
|
|
467
|
+
const [bubbleEl, setBubbleEl] = React.useState<HTMLDivElement | null>(null);
|
|
468
|
+
const triggerElRef = React.useRef<HTMLElement | null>(null);
|
|
469
|
+
const floatingElRef = React.useRef<HTMLDivElement | null>(null);
|
|
470
|
+
const arrowRef = React.useRef<SVGSVGElement | null>(null);
|
|
471
|
+
// Mounted from opening until the exit animation has finished.
|
|
472
|
+
const [present, setPresent] = React.useState(false);
|
|
473
|
+
React.useLayoutEffect(() => {
|
|
474
|
+
if (open) setPresent(true);
|
|
475
|
+
}, [open]);
|
|
476
|
+
const isMounted = open || present;
|
|
477
|
+
|
|
478
|
+
const baseId = React.useId();
|
|
479
|
+
const bubbleId = `${baseId}-bubble`;
|
|
480
|
+
const titleId = `${baseId}-title`;
|
|
481
|
+
const bodyId = `${baseId}-body`;
|
|
482
|
+
|
|
483
|
+
const setOpen = React.useCallback(
|
|
484
|
+
(next: boolean) => {
|
|
485
|
+
if (!isControlled) setUncontrolledOpen(next);
|
|
486
|
+
onOpenChange?.(next);
|
|
487
|
+
},
|
|
488
|
+
[isControlled, onOpenChange],
|
|
489
|
+
);
|
|
490
|
+
|
|
491
|
+
// A parent closing a controlled bubble must also drop the pin.
|
|
492
|
+
React.useEffect(() => {
|
|
493
|
+
if (!open) setPinned(false);
|
|
494
|
+
}, [open]);
|
|
495
|
+
|
|
496
|
+
// The focus manager hands focus back to the trigger once the exit has played; that
|
|
497
|
+
// returned focus must not reopen the preview.
|
|
498
|
+
const ignoreReturnedFocusRef = React.useRef(false);
|
|
499
|
+
|
|
500
|
+
const close = React.useCallback(() => {
|
|
501
|
+
const active = document.activeElement;
|
|
502
|
+
ignoreReturnedFocusRef.current = active != null && floatingElRef.current?.contains(active) === true;
|
|
503
|
+
setPinned(false);
|
|
504
|
+
setOpen(false);
|
|
505
|
+
}, [setOpen]);
|
|
506
|
+
|
|
507
|
+
const handleOpenChange = React.useCallback(
|
|
508
|
+
(next: boolean, _event?: Event, reason?: OpenChangeReason) => {
|
|
509
|
+
if (next) {
|
|
510
|
+
const returnedFocus = reason === 'focus' && ignoreReturnedFocusRef.current;
|
|
511
|
+
ignoreReturnedFocusRef.current = false;
|
|
512
|
+
if (returnedFocus) return;
|
|
513
|
+
if (reason === 'click') setPinned(true);
|
|
514
|
+
if (!open) setOpen(true);
|
|
515
|
+
return;
|
|
516
|
+
}
|
|
517
|
+
// useHover already ignores pointer-leave once a click opened it; this also covers
|
|
518
|
+
// a bubble pinned on top of a running hover preview.
|
|
519
|
+
if (pinned && (reason === 'hover' || reason === 'safe-polygon')) return;
|
|
520
|
+
// Without a link the focus manager is off, so nothing returns focus from the
|
|
521
|
+
// (tabIndex=-1) bubble surface on Escape — do it here.
|
|
522
|
+
if (reason === 'escape-key') {
|
|
523
|
+
const active = document.activeElement;
|
|
524
|
+
if (active != null && floatingElRef.current?.contains(active)) {
|
|
525
|
+
triggerElRef.current?.focus();
|
|
526
|
+
}
|
|
527
|
+
}
|
|
528
|
+
close();
|
|
529
|
+
},
|
|
530
|
+
[open, pinned, setOpen, close],
|
|
531
|
+
);
|
|
532
|
+
|
|
533
|
+
const { refs, floatingStyles, context, placement } = useFloating({
|
|
534
|
+
open,
|
|
535
|
+
onOpenChange: handleOpenChange,
|
|
536
|
+
placement: side,
|
|
537
|
+
// Fixed: a bubble portalled into a Modal escapes the card's overflow-hidden (see internal/dialogPortal.ts).
|
|
538
|
+
strategy: 'fixed',
|
|
539
|
+
whileElementsMounted: autoUpdate,
|
|
540
|
+
middleware: [
|
|
541
|
+
// floating-ui offsets the bubble edge; add the caret depth so `sideOffset` means
|
|
542
|
+
// caret tip → trigger, the same as in the Radix engine.
|
|
543
|
+
offset(sideOffset + (showArrow ? TOOLTIP_ARROW_HEIGHT : 0)),
|
|
544
|
+
flip({ padding: 8 }),
|
|
545
|
+
shift({ padding: 8 }),
|
|
546
|
+
sizeMiddleware({
|
|
547
|
+
padding: 8,
|
|
548
|
+
// The `sm` slot caps its width with the variable Radix sets in the plain mode;
|
|
549
|
+
// feed it the same value so both engines wrap at the viewport edge.
|
|
550
|
+
apply: ({ availableWidth, elements }) => {
|
|
551
|
+
elements.floating.style.setProperty(
|
|
552
|
+
'--radix-tooltip-content-available-width',
|
|
553
|
+
`${availableWidth}px`,
|
|
554
|
+
);
|
|
555
|
+
},
|
|
556
|
+
}),
|
|
557
|
+
arrowMiddleware({ element: arrowRef, padding: 8 }),
|
|
558
|
+
],
|
|
559
|
+
});
|
|
560
|
+
const dialogRoot = useDialogRoot(context.elements.domReference);
|
|
561
|
+
|
|
562
|
+
const hover = useHover(context, {
|
|
563
|
+
delay: { open: delayDuration ?? TOOLTIP_DELAY_DURATION },
|
|
564
|
+
handleClose: safePolygon(),
|
|
565
|
+
mouseOnly: true,
|
|
566
|
+
// Without this a mousemove after Escape would reopen the preview.
|
|
567
|
+
move: false,
|
|
568
|
+
});
|
|
569
|
+
// visibleOnly (default) keeps a mouse-click focus from previewing; after Escape it
|
|
570
|
+
// blocks the returned focus from reopening until a fresh interaction.
|
|
571
|
+
const focus = useFocus(context);
|
|
572
|
+
// stickIfOpen (default) turns an activation during a preview into a pin.
|
|
573
|
+
const click = useClick(context);
|
|
574
|
+
const dismiss = useDismiss(context);
|
|
575
|
+
const { getReferenceProps, getFloatingProps } = useInteractions([hover, focus, click, dismiss]);
|
|
576
|
+
|
|
577
|
+
React.useLayoutEffect(() => {
|
|
578
|
+
if (bubbleEl != null) setHasLink(bubbleEl.querySelector('a[href]') != null);
|
|
579
|
+
}, [bubbleEl, content]);
|
|
580
|
+
|
|
581
|
+
const childProps = children.props as React.HTMLProps<HTMLElement> & {
|
|
582
|
+
ref?: React.Ref<HTMLElement>;
|
|
583
|
+
};
|
|
584
|
+
const triggerRef = useMergeRefs<HTMLElement>([refs.setReference, triggerElRef, childProps.ref]);
|
|
585
|
+
const floatingRef = useMergeRefs<HTMLDivElement>([refs.setFloating, floatingElRef]);
|
|
586
|
+
|
|
587
|
+
// With a link focus lands on the link, which carries the description itself; the
|
|
588
|
+
// trigger keeps it only when nothing in the bubble can take focus.
|
|
589
|
+
const describedBy =
|
|
590
|
+
[childProps['aria-describedby'], isMounted && !hasLink ? bodyId : undefined]
|
|
591
|
+
.filter(Boolean)
|
|
592
|
+
.join(' ') || undefined;
|
|
593
|
+
|
|
594
|
+
const trigger = React.cloneElement(
|
|
595
|
+
children,
|
|
596
|
+
getReferenceProps({
|
|
597
|
+
...childProps,
|
|
598
|
+
ref: triggerRef,
|
|
599
|
+
'aria-expanded': open && pinned,
|
|
600
|
+
'aria-controls': isMounted ? bubbleId : undefined,
|
|
601
|
+
'aria-describedby': describedBy,
|
|
602
|
+
}) as React.HTMLProps<HTMLElement>,
|
|
603
|
+
);
|
|
604
|
+
|
|
605
|
+
const bodyContext = React.useMemo(() => ({ bodyId, close }), [bodyId, close]);
|
|
606
|
+
const placedSide = placement.split('-')[0];
|
|
607
|
+
|
|
608
|
+
return (
|
|
609
|
+
<>
|
|
610
|
+
{trigger}
|
|
611
|
+
{/* Right after the trigger: preserveTabOrder puts the focus guards here, so the
|
|
612
|
+
bubble follows the trigger in the tab order (whether portalled to <body> or
|
|
613
|
+
into an enclosing dialog). */}
|
|
614
|
+
{isMounted && (
|
|
615
|
+
// Inside a Modal / Drawer the bubble portals into the dialog (see
|
|
616
|
+
// internal/dialogPortal), otherwise the Radix focus trap keeps its link
|
|
617
|
+
// out of keyboard reach.
|
|
618
|
+
<FloatingPortal root={dialogRoot}>
|
|
619
|
+
<FloatingFocusManager
|
|
620
|
+
context={context}
|
|
621
|
+
modal={false}
|
|
622
|
+
initialFocus={-1}
|
|
623
|
+
returnFocus
|
|
624
|
+
closeOnFocusOut
|
|
625
|
+
disabled={!hasLink}
|
|
626
|
+
>
|
|
627
|
+
<div
|
|
628
|
+
ref={floatingRef}
|
|
629
|
+
style={floatingStyles}
|
|
630
|
+
// Focusable so a click on the bubble text does not blur to <body>
|
|
631
|
+
// (which would read as focus leaving and close it).
|
|
632
|
+
tabIndex={-1}
|
|
633
|
+
className="z-popover outline-none"
|
|
634
|
+
{...getFloatingProps()}
|
|
635
|
+
>
|
|
636
|
+
{/* Presence sits INSIDE the focus manager: an exiting subtree is frozen, and the
|
|
637
|
+
manager must see the live `context` (open=false) to hand focus back. */}
|
|
638
|
+
<AnimatePresence onExitComplete={() => setPresent(false)}>
|
|
639
|
+
{open && (
|
|
640
|
+
<TooltipMotionBubble
|
|
641
|
+
key="bubble"
|
|
642
|
+
ref={setBubbleEl}
|
|
643
|
+
id={bubbleId}
|
|
644
|
+
data-fods-component="tooltip"
|
|
645
|
+
data-fods-part="bubble"
|
|
646
|
+
data-side={placedSide}
|
|
647
|
+
// A non-modal popup, not role="tooltip" (that role may not hold
|
|
648
|
+
// interactive content); a group only when it has a name.
|
|
649
|
+
role={showTitle ? 'group' : undefined}
|
|
650
|
+
aria-labelledby={showTitle ? titleId : undefined}
|
|
651
|
+
className={tooltipVariants({ size }).content()}
|
|
652
|
+
>
|
|
653
|
+
<TooltipBodyContext.Provider value={bodyContext}>
|
|
654
|
+
<TooltipBubbleInner
|
|
655
|
+
size={size}
|
|
656
|
+
title={title}
|
|
657
|
+
content={content}
|
|
658
|
+
showTitle={showTitle}
|
|
659
|
+
titleId={titleId}
|
|
660
|
+
bodyId={bodyId}
|
|
661
|
+
caret={
|
|
662
|
+
showArrow && (
|
|
663
|
+
<FloatingArrow
|
|
664
|
+
ref={arrowRef}
|
|
665
|
+
context={context}
|
|
666
|
+
width={TOOLTIP_ARROW_WIDTH}
|
|
667
|
+
height={TOOLTIP_ARROW_HEIGHT}
|
|
668
|
+
aria-hidden="true"
|
|
669
|
+
data-fods-part="caret"
|
|
670
|
+
className={tooltipVariants().arrow()}
|
|
671
|
+
/>
|
|
672
|
+
)
|
|
673
|
+
}
|
|
674
|
+
/>
|
|
675
|
+
</TooltipBodyContext.Provider>
|
|
676
|
+
</TooltipMotionBubble>
|
|
677
|
+
)}
|
|
678
|
+
</AnimatePresence>
|
|
679
|
+
</div>
|
|
680
|
+
</FloatingFocusManager>
|
|
681
|
+
</FloatingPortal>
|
|
682
|
+
)}
|
|
683
|
+
</>
|
|
684
|
+
);
|
|
685
|
+
}
|
|
686
|
+
|
|
687
|
+
const Tooltip: React.FC<TooltipProps> = ({
|
|
688
|
+
content,
|
|
689
|
+
title,
|
|
690
|
+
size = 'sm',
|
|
691
|
+
children,
|
|
692
|
+
side = 'top',
|
|
693
|
+
sideOffset = TOOLTIP_TRIGGER_OFFSET,
|
|
694
|
+
showArrow = true,
|
|
695
|
+
delayDuration,
|
|
696
|
+
open,
|
|
697
|
+
onOpenChange,
|
|
698
|
+
toggletip = false,
|
|
699
|
+
}) => {
|
|
700
|
+
// Title is a Medium-only affordance — a Small bubble is a bare one-line label.
|
|
701
|
+
const showTitle = size === 'md' && title != null;
|
|
702
|
+
|
|
703
|
+
if (process.env.NODE_ENV !== 'production' && size === 'sm' && title != null) {
|
|
704
|
+
console.warn(
|
|
705
|
+
'Tooltip: `title` is a Medium-only affordance and is dropped for size="sm". ' +
|
|
706
|
+
'Pass size="md" to render it, or fold the text into `content`.',
|
|
707
|
+
);
|
|
708
|
+
}
|
|
709
|
+
|
|
710
|
+
if (toggletip) {
|
|
711
|
+
return (
|
|
712
|
+
<ToggletipImpl
|
|
713
|
+
content={content}
|
|
714
|
+
title={title}
|
|
715
|
+
size={size}
|
|
716
|
+
side={side}
|
|
717
|
+
sideOffset={sideOffset}
|
|
718
|
+
showArrow={showArrow}
|
|
719
|
+
showTitle={showTitle}
|
|
720
|
+
delayDuration={delayDuration}
|
|
721
|
+
open={open}
|
|
722
|
+
onOpenChange={onOpenChange}
|
|
723
|
+
>
|
|
724
|
+
{children}
|
|
725
|
+
</ToggletipImpl>
|
|
726
|
+
);
|
|
727
|
+
}
|
|
728
|
+
|
|
729
|
+
return (
|
|
730
|
+
<TooltipRoot delayDuration={delayDuration} open={open} onOpenChange={onOpenChange}>
|
|
731
|
+
<TooltipPrimitive.Trigger asChild>{children}</TooltipPrimitive.Trigger>
|
|
732
|
+
<TooltipPortal>
|
|
733
|
+
<TooltipContent ref={warnOnPlainLink} size={size} side={side} sideOffset={sideOffset}>
|
|
734
|
+
<TooltipBubbleInner
|
|
735
|
+
size={size}
|
|
736
|
+
title={title}
|
|
737
|
+
content={content}
|
|
738
|
+
showTitle={showTitle}
|
|
739
|
+
caret={showArrow && <TooltipArrow />}
|
|
740
|
+
/>
|
|
741
|
+
</TooltipContent>
|
|
742
|
+
</TooltipPortal>
|
|
743
|
+
</TooltipRoot>
|
|
744
|
+
);
|
|
745
|
+
};
|
|
746
|
+
|
|
747
|
+
export {
|
|
748
|
+
Tooltip,
|
|
749
|
+
TooltipRoot,
|
|
750
|
+
TooltipTrigger,
|
|
751
|
+
TooltipContent,
|
|
752
|
+
TooltipPortal,
|
|
753
|
+
TooltipProvider,
|
|
754
|
+
TooltipArrow,
|
|
755
|
+
tooltipVariants,
|
|
756
|
+
};
|