@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.
Files changed (738) hide show
  1. package/AGENTS.md +99 -0
  2. package/CHANGELOG.md +131 -0
  3. package/LICENSE +9 -0
  4. package/README.md +78 -2
  5. package/dist/assets/label-brush-1.svg +6 -0
  6. package/dist/assets/pattern-dark.svg +113 -0
  7. package/dist/components/action-row/ActionRow.d.ts +178 -0
  8. package/dist/components/action-row/ActionRow.js +340 -0
  9. package/dist/components/action-row/index.d.ts +2 -0
  10. package/dist/components/action-row/index.js +1 -0
  11. package/dist/components/alert/Alert.d.ts +314 -0
  12. package/dist/components/alert/Alert.js +446 -0
  13. package/dist/components/alert/index.d.ts +2 -0
  14. package/dist/components/alert/index.js +1 -0
  15. package/dist/components/anchored-panel/AnchoredPanel.d.ts +41 -0
  16. package/dist/components/anchored-panel/AnchoredPanel.js +72 -0
  17. package/dist/components/anchored-panel/index.d.ts +3 -0
  18. package/dist/components/anchored-panel/index.js +3 -0
  19. package/dist/components/badge/Badge.d.ts +146 -0
  20. package/dist/components/badge/Badge.js +258 -0
  21. package/dist/components/badge/index.d.ts +2 -0
  22. package/dist/components/badge/index.js +1 -0
  23. package/dist/components/banner/Banner.d.ts +209 -0
  24. package/dist/components/banner/Banner.js +339 -0
  25. package/dist/components/banner/index.d.ts +2 -0
  26. package/dist/components/banner/index.js +1 -0
  27. package/dist/components/button/Button.d.ts +54 -0
  28. package/dist/components/button/Button.js +312 -0
  29. package/dist/components/button/index.d.ts +2 -0
  30. package/dist/components/button/index.js +1 -0
  31. package/dist/components/button-group/ButtonGroup.d.ts +187 -0
  32. package/dist/components/button-group/ButtonGroup.js +217 -0
  33. package/dist/components/button-group/index.d.ts +2 -0
  34. package/dist/components/button-group/index.js +1 -0
  35. package/dist/components/card-select/CardSelect.d.ts +274 -0
  36. package/dist/components/card-select/CardSelect.js +561 -0
  37. package/dist/components/card-select/CardSelectGroup.d.ts +92 -0
  38. package/dist/components/card-select/CardSelectGroup.js +72 -0
  39. package/dist/components/card-select/index.d.ts +3 -0
  40. package/dist/components/card-select/index.js +3 -0
  41. package/dist/components/checkbox/Checkbox.d.ts +104 -0
  42. package/dist/components/checkbox/Checkbox.js +194 -0
  43. package/dist/components/checkbox/index.d.ts +2 -0
  44. package/dist/components/checkbox/index.js +1 -0
  45. package/dist/components/chip/Chip.d.ts +250 -0
  46. package/dist/components/chip/Chip.js +441 -0
  47. package/dist/components/chip/index.d.ts +2 -0
  48. package/dist/components/chip/index.js +1 -0
  49. package/dist/components/column-header/ColumnHeader.d.ts +144 -0
  50. package/dist/components/column-header/ColumnHeader.js +209 -0
  51. package/dist/components/column-header/index.d.ts +2 -0
  52. package/dist/components/column-header/index.js +1 -0
  53. package/dist/components/combobox-field/Combobox.d.ts +104 -0
  54. package/dist/components/combobox-field/Combobox.js +355 -0
  55. package/dist/components/combobox-field/ComboboxField.d.ts +76 -0
  56. package/dist/components/combobox-field/ComboboxField.js +98 -0
  57. package/dist/components/combobox-field/index.d.ts +3 -0
  58. package/dist/components/combobox-field/index.js +3 -0
  59. package/dist/components/date-field/DateField.d.ts +52 -0
  60. package/dist/components/date-field/DateField.js +45 -0
  61. package/dist/components/date-field/index.d.ts +2 -0
  62. package/dist/components/date-field/index.js +1 -0
  63. package/dist/components/date-picker/DatePicker.d.ts +53 -0
  64. package/dist/components/date-picker/DatePicker.js +329 -0
  65. package/dist/components/date-picker/index.d.ts +2 -0
  66. package/dist/components/date-picker/index.js +1 -0
  67. package/dist/components/divider/Divider.d.ts +81 -0
  68. package/dist/components/divider/Divider.js +93 -0
  69. package/dist/components/divider/index.d.ts +2 -0
  70. package/dist/components/divider/index.js +1 -0
  71. package/dist/components/drawer/Drawer.d.ts +128 -0
  72. package/dist/components/drawer/Drawer.js +367 -0
  73. package/dist/components/drawer/index.d.ts +2 -0
  74. package/dist/components/drawer/index.js +1 -0
  75. package/dist/components/dropdown-button/DropdownButton.d.ts +72 -0
  76. package/dist/components/dropdown-button/DropdownButton.js +122 -0
  77. package/dist/components/dropdown-button/index.d.ts +2 -0
  78. package/dist/components/dropdown-button/index.js +1 -0
  79. package/dist/components/faq/FAQ.d.ts +135 -0
  80. package/dist/components/faq/FAQ.js +258 -0
  81. package/dist/components/faq/index.d.ts +2 -0
  82. package/dist/components/faq/index.js +1 -0
  83. package/dist/components/field/Field.d.ts +118 -0
  84. package/dist/components/field/Field.js +327 -0
  85. package/dist/components/field/index.d.ts +2 -0
  86. package/dist/components/field/index.js +1 -0
  87. package/dist/components/field-pair/FieldPair.d.ts +194 -0
  88. package/dist/components/field-pair/FieldPair.js +321 -0
  89. package/dist/components/field-pair/index.d.ts +2 -0
  90. package/dist/components/field-pair/index.js +1 -0
  91. package/dist/components/file-upload/FileUpload.d.ts +137 -0
  92. package/dist/components/file-upload/FileUpload.js +434 -0
  93. package/dist/components/file-upload/index.d.ts +2 -0
  94. package/dist/components/file-upload/index.js +1 -0
  95. package/dist/components/filter-chip/FilterChip.d.ts +373 -0
  96. package/dist/components/filter-chip/FilterChip.js +517 -0
  97. package/dist/components/filter-chip/index.d.ts +2 -0
  98. package/dist/components/filter-chip/index.js +1 -0
  99. package/dist/components/filter-facet/FilterFacet.d.ts +116 -0
  100. package/dist/components/filter-facet/FilterFacet.js +632 -0
  101. package/dist/components/filter-facet/index.d.ts +2 -0
  102. package/dist/components/filter-facet/index.js +1 -0
  103. package/dist/components/firm-avatar/FirmAvatar.d.ts +75 -0
  104. package/dist/components/firm-avatar/FirmAvatar.js +119 -0
  105. package/dist/components/firm-avatar/index.d.ts +2 -0
  106. package/dist/components/firm-avatar/index.js +1 -0
  107. package/dist/components/form-actions/FormActions.d.ts +123 -0
  108. package/dist/components/form-actions/FormActions.js +195 -0
  109. package/dist/components/form-actions/index.d.ts +2 -0
  110. package/dist/components/form-actions/index.js +1 -0
  111. package/dist/components/form-block/FormBlock.d.ts +252 -0
  112. package/dist/components/form-block/FormBlock.js +420 -0
  113. package/dist/components/form-block/index.d.ts +3 -0
  114. package/dist/components/form-block/index.js +3 -0
  115. package/dist/components/form-section/FormSection.d.ts +130 -0
  116. package/dist/components/form-section/FormSection.js +206 -0
  117. package/dist/components/form-section/index.d.ts +2 -0
  118. package/dist/components/form-section/index.js +1 -0
  119. package/dist/components/heading/Heading.d.ts +69 -0
  120. package/dist/components/heading/Heading.js +79 -0
  121. package/dist/components/heading/index.d.ts +2 -0
  122. package/dist/components/heading/index.js +1 -0
  123. package/dist/components/heading-group/HeadingGroup.d.ts +258 -0
  124. package/dist/components/heading-group/HeadingGroup.js +255 -0
  125. package/dist/components/heading-group/index.d.ts +2 -0
  126. package/dist/components/heading-group/index.js +1 -0
  127. package/dist/components/hero/Hero.d.ts +268 -0
  128. package/dist/components/hero/Hero.js +316 -0
  129. package/dist/components/hero/index.d.ts +2 -0
  130. package/dist/components/hero/index.js +1 -0
  131. package/dist/components/icon/Icon.d.ts +27 -0
  132. package/dist/components/icon/Icon.js +30 -0
  133. package/dist/components/icon/index.d.ts +3 -0
  134. package/dist/components/icon/index.js +3 -0
  135. package/dist/components/icon-button/IconButton.d.ts +75 -0
  136. package/dist/components/icon-button/IconButton.js +151 -0
  137. package/dist/components/icon-button/index.d.ts +2 -0
  138. package/dist/components/icon-button/index.js +1 -0
  139. package/dist/components/item-row/ItemRow.d.ts +253 -0
  140. package/dist/components/item-row/ItemRow.js +496 -0
  141. package/dist/components/item-row/index.d.ts +2 -0
  142. package/dist/components/item-row/index.js +1 -0
  143. package/dist/components/list-row/ListRow.d.ts +165 -0
  144. package/dist/components/list-row/ListRow.js +233 -0
  145. package/dist/components/list-row/index.d.ts +2 -0
  146. package/dist/components/list-row/index.js +1 -0
  147. package/dist/components/menu/Menu.d.ts +64 -0
  148. package/dist/components/menu/Menu.js +186 -0
  149. package/dist/components/menu/index.d.ts +2 -0
  150. package/dist/components/menu/index.js +1 -0
  151. package/dist/components/modal/Modal.d.ts +272 -0
  152. package/dist/components/modal/Modal.js +788 -0
  153. package/dist/components/modal/index.d.ts +2 -0
  154. package/dist/components/modal/index.js +1 -0
  155. package/dist/components/nav-link/NavLink.d.ts +123 -0
  156. package/dist/components/nav-link/NavLink.js +157 -0
  157. package/dist/components/nav-link/index.d.ts +2 -0
  158. package/dist/components/nav-link/index.js +1 -0
  159. package/dist/components/number-field/NumberField.d.ts +62 -0
  160. package/dist/components/number-field/NumberField.js +210 -0
  161. package/dist/components/number-field/index.d.ts +2 -0
  162. package/dist/components/number-field/index.js +1 -0
  163. package/dist/components/pagination/Pagination.d.ts +133 -0
  164. package/dist/components/pagination/Pagination.js +217 -0
  165. package/dist/components/pagination/index.d.ts +3 -0
  166. package/dist/components/pagination/index.js +3 -0
  167. package/dist/components/popover-surface/index.d.ts +2 -0
  168. package/dist/components/popover-surface/index.js +1 -0
  169. package/dist/components/progress-bar/ProgressBar.d.ts +260 -0
  170. package/dist/components/progress-bar/ProgressBar.js +470 -0
  171. package/dist/components/progress-bar/index.d.ts +2 -0
  172. package/dist/components/progress-bar/index.js +1 -0
  173. package/dist/components/promo-sticker/PromoSticker.d.ts +204 -0
  174. package/dist/components/promo-sticker/PromoSticker.js +177 -0
  175. package/dist/components/promo-sticker/index.d.ts +2 -0
  176. package/dist/components/promo-sticker/index.js +1 -0
  177. package/dist/components/promo-surface/PromoSurface.d.ts +94 -0
  178. package/dist/components/promo-surface/PromoSurface.js +119 -0
  179. package/dist/components/promo-surface/index.d.ts +2 -0
  180. package/dist/components/promo-surface/index.js +1 -0
  181. package/dist/components/radio/Radio.d.ts +92 -0
  182. package/dist/components/radio/Radio.js +171 -0
  183. package/dist/components/radio/index.d.ts +2 -0
  184. package/dist/components/radio/index.js +1 -0
  185. package/dist/components/radio-group/RadioGroup.d.ts +61 -0
  186. package/dist/components/radio-group/RadioGroup.js +51 -0
  187. package/dist/components/radio-group/index.d.ts +2 -0
  188. package/dist/components/radio-group/index.js +1 -0
  189. package/dist/components/select/Select.d.ts +65 -0
  190. package/dist/components/select/Select.js +176 -0
  191. package/dist/components/select/index.d.ts +2 -0
  192. package/dist/components/select/index.js +1 -0
  193. package/dist/components/select-field/SelectField.d.ts +16 -0
  194. package/dist/components/select-field/SelectField.js +55 -0
  195. package/dist/components/select-field/index.d.ts +2 -0
  196. package/dist/components/select-field/index.js +1 -0
  197. package/dist/components/skeleton/Skeleton.d.ts +64 -0
  198. package/dist/components/skeleton/Skeleton.js +65 -0
  199. package/dist/components/skeleton/index.d.ts +2 -0
  200. package/dist/components/skeleton/index.js +1 -0
  201. package/dist/components/split-button/SplitButton.d.ts +80 -0
  202. package/dist/components/split-button/SplitButton.js +182 -0
  203. package/dist/components/split-button/index.d.ts +2 -0
  204. package/dist/components/split-button/index.js +1 -0
  205. package/dist/components/status-summary-bar/StatusSummaryBar.d.ts +118 -0
  206. package/dist/components/status-summary-bar/StatusSummaryBar.js +278 -0
  207. package/dist/components/status-summary-bar/index.d.ts +2 -0
  208. package/dist/components/status-summary-bar/index.js +1 -0
  209. package/dist/components/subject-lookup-field/SubjectLookupField.d.ts +157 -0
  210. package/dist/components/subject-lookup-field/SubjectLookupField.js +663 -0
  211. package/dist/components/subject-lookup-field/index.d.ts +2 -0
  212. package/dist/components/subject-lookup-field/index.js +1 -0
  213. package/dist/components/switch/Switch.d.ts +152 -0
  214. package/dist/components/switch/Switch.js +307 -0
  215. package/dist/components/switch/index.d.ts +2 -0
  216. package/dist/components/switch/index.js +1 -0
  217. package/dist/components/table/Table.d.ts +5 -0
  218. package/dist/components/table/Table.js +601 -0
  219. package/dist/components/table/index.d.ts +6 -0
  220. package/dist/components/table/index.js +6 -0
  221. package/dist/components/text-field/TextField.d.ts +65 -0
  222. package/dist/components/text-field/TextField.js +173 -0
  223. package/dist/components/text-field/index.d.ts +2 -0
  224. package/dist/components/text-field/index.js +1 -0
  225. package/dist/components/text-link/TextLink.d.ts +260 -0
  226. package/dist/components/text-link/TextLink.js +303 -0
  227. package/dist/components/text-link/index.d.ts +2 -0
  228. package/dist/components/text-link/index.js +1 -0
  229. package/dist/components/textarea/Textarea.d.ts +93 -0
  230. package/dist/components/textarea/Textarea.js +256 -0
  231. package/dist/components/textarea/index.d.ts +2 -0
  232. package/dist/components/textarea/index.js +1 -0
  233. package/dist/components/tooltip/Tooltip.d.ts +129 -0
  234. package/dist/components/tooltip/Tooltip.js +457 -0
  235. package/dist/components/tooltip/index.d.ts +2 -0
  236. package/dist/components/tooltip/index.js +1 -0
  237. package/dist/components/unit-field/UnitField.d.ts +46 -0
  238. package/dist/components/unit-field/UnitField.js +133 -0
  239. package/dist/components/unit-field/index.d.ts +2 -0
  240. package/dist/components/unit-field/index.js +1 -0
  241. package/dist/icons/icon-registry.generated.js +500 -0
  242. package/dist/icons/icon-types.generated.d.ts +2 -0
  243. package/dist/icons/icon-types.generated.js +126 -0
  244. package/dist/index.d.ts +132 -0
  245. package/dist/index.js +75 -0
  246. package/dist/internal/BottomSheet.js +496 -0
  247. package/dist/internal/FodsProvider.d.ts +25 -0
  248. package/dist/internal/FodsProvider.js +32 -0
  249. package/dist/internal/MotionCaret.js +35 -0
  250. package/dist/internal/NumberFormatInput.d.ts +21 -0
  251. package/dist/internal/NumberFormatInput.js +126 -0
  252. package/dist/internal/SummaryDonut.d.ts +3 -0
  253. package/dist/internal/SummaryDonut.js +300 -0
  254. package/dist/internal/buttonSegment.d.ts +44 -0
  255. package/dist/internal/buttonSegment.js +126 -0
  256. package/dist/internal/collapseRoom.js +128 -0
  257. package/dist/internal/comboboxKeys.js +44 -0
  258. package/dist/internal/contentPresence.js +46 -0
  259. package/dist/internal/dayCell.js +95 -0
  260. package/dist/internal/dialogPortal.d.ts +2 -0
  261. package/dist/internal/dialogPortal.js +21 -0
  262. package/dist/internal/donutSweeps.js +65 -0
  263. package/dist/internal/enterOnViewGeometry.js +46 -0
  264. package/dist/internal/faqItem.js +80 -0
  265. package/dist/internal/floatingLabelMotion.js +68 -0
  266. package/dist/internal/formBlockContext.d.ts +22 -0
  267. package/dist/internal/formBlockContext.js +20 -0
  268. package/dist/internal/heightRoom.js +87 -0
  269. package/dist/internal/numberSeparators.js +62 -0
  270. package/dist/internal/overlayMotion.js +48 -0
  271. package/dist/internal/paginationItem.d.ts +8 -0
  272. package/dist/internal/paginationItem.js +22 -0
  273. package/dist/internal/popoverSurface.d.ts +8 -0
  274. package/dist/internal/popoverSurface.js +23 -0
  275. package/dist/internal/portalContainer.d.ts +1 -0
  276. package/dist/internal/portalContainer.js +6 -0
  277. package/dist/internal/progressBarItem.d.ts +207 -0
  278. package/dist/internal/progressBarItem.js +264 -0
  279. package/dist/internal/selectionControlText.js +12 -0
  280. package/dist/internal/statusSummaryParts.js +371 -0
  281. package/dist/internal/summaryMotion.js +75 -0
  282. package/dist/internal/table/ChildConnector.js +62 -0
  283. package/dist/internal/table/ChildRowPrefix.d.ts +9 -0
  284. package/dist/internal/table/ChildRowPrefix.js +27 -0
  285. package/dist/internal/table/ColumnSettings.js +135 -0
  286. package/dist/internal/table/ScrollRegion.js +114 -0
  287. package/dist/internal/table/TableEmpty.js +93 -0
  288. package/dist/internal/table/TableLayout.d.ts +17 -0
  289. package/dist/internal/table/TableLayout.js +29 -0
  290. package/dist/internal/table/TableLoadStatus.js +56 -0
  291. package/dist/internal/table/TableMobile.js +488 -0
  292. package/dist/internal/table/TruncatedCell.js +33 -0
  293. package/dist/internal/table/emptyValue.js +10 -0
  294. package/dist/internal/table/features.d.ts +41 -0
  295. package/dist/internal/table/features.js +31 -0
  296. package/dist/internal/table/recipes.js +227 -0
  297. package/dist/internal/table/rowClick.js +9 -0
  298. package/dist/internal/table/types.d.ts +325 -0
  299. package/dist/internal/table/types.js +13 -0
  300. package/dist/internal/tailwind-variants.d.ts +3 -0
  301. package/dist/internal/tailwind-variants.js +37 -0
  302. package/dist/internal/tooltipContext.js +5 -0
  303. package/dist/internal/tw-merge-config.generated.js +314 -0
  304. package/dist/internal/useAnchoredPanel.d.ts +87 -0
  305. package/dist/internal/useAnchoredPanel.js +108 -0
  306. package/dist/internal/useCountUp.js +53 -0
  307. package/dist/internal/useDateFieldTrigger.js +183 -0
  308. package/dist/internal/useEChart.js +59 -0
  309. package/dist/internal/useEnterOnView.js +42 -0
  310. package/dist/internal/useFloatingBar.js +100 -0
  311. package/dist/internal/useFormReset.js +37 -0
  312. package/dist/internal/useIsMobile.js +44 -0
  313. package/dist/internal/useOneRowOverflow.js +88 -0
  314. package/dist/internal/usePrefersReducedMotion.js +25 -0
  315. package/dist/internal/useReturnFocus.js +26 -0
  316. package/dist/internal/utils.d.ts +7 -0
  317. package/dist/internal/utils.js +58 -0
  318. package/dist/node_modules/@tanstack/store/dist/store.d.ts +29 -0
  319. package/dist/node_modules/@tanstack/store/dist/types.d.ts +38 -0
  320. package/dist/node_modules/@tanstack/table-core/dist/core/cells/coreCellsFeature.d.ts +6 -0
  321. package/dist/node_modules/@tanstack/table-core/dist/core/cells/coreCellsFeature.types.d.ts +53 -0
  322. package/dist/node_modules/@tanstack/table-core/dist/core/columns/coreColumnsFeature.d.ts +6 -0
  323. package/dist/node_modules/@tanstack/table-core/dist/core/columns/coreColumnsFeature.types.d.ts +90 -0
  324. package/dist/node_modules/@tanstack/table-core/dist/core/coreFeatures.d.ts +17 -0
  325. package/dist/node_modules/@tanstack/table-core/dist/core/headers/coreHeadersFeature.d.ts +6 -0
  326. package/dist/node_modules/@tanstack/table-core/dist/core/headers/coreHeadersFeature.types.d.ts +114 -0
  327. package/dist/node_modules/@tanstack/table-core/dist/core/reactivity/coreReactivityFeature.types.d.ts +51 -0
  328. package/dist/node_modules/@tanstack/table-core/dist/core/row-models/coreRowModelsFeature.d.ts +6 -0
  329. package/dist/node_modules/@tanstack/table-core/dist/core/row-models/coreRowModelsFeature.types.d.ts +29 -0
  330. package/dist/node_modules/@tanstack/table-core/dist/core/rows/coreRowsFeature.d.ts +6 -0
  331. package/dist/node_modules/@tanstack/table-core/dist/core/rows/coreRowsFeature.types.d.ts +129 -0
  332. package/dist/node_modules/@tanstack/table-core/dist/core/table/coreTablesFeature.d.ts +6 -0
  333. package/dist/node_modules/@tanstack/table-core/dist/core/table/coreTablesFeature.types.d.ts +203 -0
  334. package/dist/node_modules/@tanstack/table-core/dist/features/cell-selection/cellSelectionFeature.d.ts +6 -0
  335. package/dist/node_modules/@tanstack/table-core/dist/features/cell-selection/cellSelectionFeature.types.d.ts +294 -0
  336. package/dist/node_modules/@tanstack/table-core/dist/features/cell-spanning/cellSpanningFeature.d.ts +11 -0
  337. package/dist/node_modules/@tanstack/table-core/dist/features/cell-spanning/cellSpanningFeature.types.d.ts +148 -0
  338. package/dist/node_modules/@tanstack/table-core/dist/features/column-faceting/columnFacetingFeature.d.ts +12 -0
  339. package/dist/node_modules/@tanstack/table-core/dist/features/column-faceting/columnFacetingFeature.types.d.ts +63 -0
  340. package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/columnFilteringFeature.d.ts +6 -0
  341. package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/columnFilteringFeature.types.d.ts +209 -0
  342. package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/filterFns.d.ts +35 -0
  343. package/dist/node_modules/@tanstack/table-core/dist/features/column-grouping/columnGroupingFeature.d.ts +6 -0
  344. package/dist/node_modules/@tanstack/table-core/dist/features/column-grouping/columnGroupingFeature.types.d.ts +128 -0
  345. package/dist/node_modules/@tanstack/table-core/dist/features/column-ordering/columnOrderingFeature.d.ts +6 -0
  346. package/dist/node_modules/@tanstack/table-core/dist/features/column-ordering/columnOrderingFeature.types.d.ts +82 -0
  347. package/dist/node_modules/@tanstack/table-core/dist/features/column-pinning/columnPinningFeature.d.ts +11 -0
  348. package/dist/node_modules/@tanstack/table-core/dist/features/column-pinning/columnPinningFeature.types.d.ts +195 -0
  349. package/dist/node_modules/@tanstack/table-core/dist/features/column-resizing/columnResizingFeature.d.ts +6 -0
  350. package/dist/node_modules/@tanstack/table-core/dist/features/column-resizing/columnResizingFeature.types.d.ts +73 -0
  351. package/dist/node_modules/@tanstack/table-core/dist/features/column-sizing/columnSizingFeature.d.ts +6 -0
  352. package/dist/node_modules/@tanstack/table-core/dist/features/column-sizing/columnSizingFeature.types.d.ts +134 -0
  353. package/dist/node_modules/@tanstack/table-core/dist/features/column-visibility/columnVisibilityFeature.d.ts +6 -0
  354. package/dist/node_modules/@tanstack/table-core/dist/features/column-visibility/columnVisibilityFeature.types.d.ts +92 -0
  355. package/dist/node_modules/@tanstack/table-core/dist/features/global-filtering/globalFilteringFeature.d.ts +6 -0
  356. package/dist/node_modules/@tanstack/table-core/dist/features/global-filtering/globalFilteringFeature.types.d.ts +67 -0
  357. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/aggregationFns.d.ts +23 -0
  358. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.d.ts +6 -0
  359. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.types.d.ts +183 -0
  360. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.utils.d.ts +18 -0
  361. package/dist/node_modules/@tanstack/table-core/dist/features/row-expanding/rowExpandingFeature.d.ts +6 -0
  362. package/dist/node_modules/@tanstack/table-core/dist/features/row-expanding/rowExpandingFeature.types.d.ts +125 -0
  363. package/dist/node_modules/@tanstack/table-core/dist/features/row-pagination/rowPaginationFeature.d.ts +6 -0
  364. package/dist/node_modules/@tanstack/table-core/dist/features/row-pagination/rowPaginationFeature.types.d.ts +135 -0
  365. package/dist/node_modules/@tanstack/table-core/dist/features/row-pinning/rowPinningFeature.d.ts +6 -0
  366. package/dist/node_modules/@tanstack/table-core/dist/features/row-pinning/rowPinningFeature.types.d.ts +76 -0
  367. package/dist/node_modules/@tanstack/table-core/dist/features/row-selection/rowSelectionFeature.d.ts +6 -0
  368. package/dist/node_modules/@tanstack/table-core/dist/features/row-selection/rowSelectionFeature.types.d.ts +187 -0
  369. package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/rowSortingFeature.d.ts +6 -0
  370. package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/rowSortingFeature.types.d.ts +236 -0
  371. package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/sortFns.d.ts +23 -0
  372. package/dist/node_modules/@tanstack/table-core/dist/features/stockFeatures.d.ts +37 -0
  373. package/dist/node_modules/@tanstack/table-core/dist/helpers/columnHelper.d.ts +47 -0
  374. package/dist/node_modules/@tanstack/table-core/dist/types/Cell.d.ts +16 -0
  375. package/dist/node_modules/@tanstack/table-core/dist/types/Column.d.ts +30 -0
  376. package/dist/node_modules/@tanstack/table-core/dist/types/ColumnDef.d.ts +123 -0
  377. package/dist/node_modules/@tanstack/table-core/dist/types/Header.d.ts +12 -0
  378. package/dist/node_modules/@tanstack/table-core/dist/types/HeaderGroup.d.ts +6 -0
  379. package/dist/node_modules/@tanstack/table-core/dist/types/Row.d.ts +24 -0
  380. package/dist/node_modules/@tanstack/table-core/dist/types/RowModel.d.ts +19 -0
  381. package/dist/node_modules/@tanstack/table-core/dist/types/RowModelFns.d.ts +11 -0
  382. package/dist/node_modules/@tanstack/table-core/dist/types/Table.d.ts +53 -0
  383. package/dist/node_modules/@tanstack/table-core/dist/types/TableFeatures.d.ts +416 -0
  384. package/dist/node_modules/@tanstack/table-core/dist/types/TableOptions.d.ts +78 -0
  385. package/dist/node_modules/@tanstack/table-core/dist/types/TableState.d.ts +46 -0
  386. package/dist/node_modules/@tanstack/table-core/dist/types/type-utils.d.ts +25 -0
  387. package/dist/shared.css +179 -0
  388. package/dist/styles.css +5467 -0
  389. package/dist/theme.css +314 -0
  390. package/dist/theme.map.json +278 -0
  391. package/dist/tokens/index.d.ts +2 -0
  392. package/dist/tokens/index.js +1 -0
  393. package/dist/tokens/tokens.generated.d.ts +2040 -0
  394. package/dist/tokens/tokens.generated.js +2053 -0
  395. package/dist/tokens.css +484 -0
  396. package/dist/tokens.flat.json +429 -0
  397. package/docs/Consuming.mdx +379 -0
  398. package/docs/Contributing.mdx +78 -0
  399. package/docs/ForAgents.mdx +53 -0
  400. package/docs/Introduction.mdx +54 -0
  401. package/llms.txt +556 -0
  402. package/package.json +357 -4
  403. package/src/components/action-row/ActionRow.mdx +686 -0
  404. package/src/components/action-row/ActionRow.stories.tsx +669 -0
  405. package/src/components/action-row/ActionRow.tsx +632 -0
  406. package/src/components/action-row/index.ts +9 -0
  407. package/src/components/alert/Alert.mdx +377 -0
  408. package/src/components/alert/Alert.stories.tsx +674 -0
  409. package/src/components/alert/Alert.tsx +579 -0
  410. package/src/components/alert/index.ts +13 -0
  411. package/src/components/anchored-panel/AnchoredPanel.mdx +381 -0
  412. package/src/components/anchored-panel/AnchoredPanel.stories.tsx +593 -0
  413. package/src/components/anchored-panel/AnchoredPanel.tsx +176 -0
  414. package/src/components/anchored-panel/index.ts +15 -0
  415. package/src/components/badge/Badge.mdx +487 -0
  416. package/src/components/badge/Badge.stories.tsx +375 -0
  417. package/src/components/badge/Badge.tsx +360 -0
  418. package/src/components/badge/index.ts +10 -0
  419. package/src/components/banner/Banner.mdx +704 -0
  420. package/src/components/banner/Banner.stories.tsx +448 -0
  421. package/src/components/banner/Banner.tsx +602 -0
  422. package/src/components/banner/index.ts +14 -0
  423. package/src/components/button/Button.mdx +286 -0
  424. package/src/components/button/Button.stories.tsx +381 -0
  425. package/src/components/button/Button.tsx +384 -0
  426. package/src/components/button/index.ts +1 -0
  427. package/src/components/button-group/ButtonGroup.mdx +512 -0
  428. package/src/components/button-group/ButtonGroup.stories.tsx +714 -0
  429. package/src/components/button-group/ButtonGroup.tsx +491 -0
  430. package/src/components/button-group/index.ts +10 -0
  431. package/src/components/card-select/CardSelect.mdx +662 -0
  432. package/src/components/card-select/CardSelect.stories.tsx +784 -0
  433. package/src/components/card-select/CardSelect.tsx +783 -0
  434. package/src/components/card-select/CardSelectGroup.tsx +169 -0
  435. package/src/components/card-select/index.ts +18 -0
  436. package/src/components/checkbox/Checkbox.mdx +269 -0
  437. package/src/components/checkbox/Checkbox.stories.tsx +306 -0
  438. package/src/components/checkbox/Checkbox.tsx +343 -0
  439. package/src/components/checkbox/index.ts +1 -0
  440. package/src/components/chip/Chip.mdx +683 -0
  441. package/src/components/chip/Chip.stories.tsx +734 -0
  442. package/src/components/chip/Chip.tsx +732 -0
  443. package/src/components/chip/index.ts +9 -0
  444. package/src/components/column-header/ColumnHeader.mdx +301 -0
  445. package/src/components/column-header/ColumnHeader.stories.tsx +319 -0
  446. package/src/components/column-header/ColumnHeader.tsx +287 -0
  447. package/src/components/column-header/index.ts +7 -0
  448. package/src/components/combobox-field/Combobox.tsx +693 -0
  449. package/src/components/combobox-field/ComboboxField.mdx +525 -0
  450. package/src/components/combobox-field/ComboboxField.stories.tsx +502 -0
  451. package/src/components/combobox-field/ComboboxField.tsx +259 -0
  452. package/src/components/combobox-field/index.ts +12 -0
  453. package/src/components/date-field/DateField.mdx +340 -0
  454. package/src/components/date-field/DateField.stories.tsx +221 -0
  455. package/src/components/date-field/DateField.tsx +176 -0
  456. package/src/components/date-field/index.ts +1 -0
  457. package/src/components/date-picker/DatePicker.mdx +436 -0
  458. package/src/components/date-picker/DatePicker.stories.tsx +458 -0
  459. package/src/components/date-picker/DatePicker.tsx +688 -0
  460. package/src/components/date-picker/index.ts +9 -0
  461. package/src/components/divider/Divider.mdx +256 -0
  462. package/src/components/divider/Divider.stories.tsx +177 -0
  463. package/src/components/divider/Divider.tsx +193 -0
  464. package/src/components/divider/index.ts +1 -0
  465. package/src/components/drawer/Drawer.mdx +518 -0
  466. package/src/components/drawer/Drawer.stories.tsx +392 -0
  467. package/src/components/drawer/Drawer.tsx +683 -0
  468. package/src/components/drawer/index.ts +1 -0
  469. package/src/components/dropdown-button/DropdownButton.mdx +285 -0
  470. package/src/components/dropdown-button/DropdownButton.stories.tsx +398 -0
  471. package/src/components/dropdown-button/DropdownButton.tsx +198 -0
  472. package/src/components/dropdown-button/index.ts +7 -0
  473. package/src/components/faq/FAQ.mdx +364 -0
  474. package/src/components/faq/FAQ.stories.tsx +343 -0
  475. package/src/components/faq/FAQ.tsx +337 -0
  476. package/src/components/faq/index.ts +1 -0
  477. package/src/components/field/Field.mdx +129 -0
  478. package/src/components/field/Field.stories.tsx +461 -0
  479. package/src/components/field/Field.tsx +765 -0
  480. package/src/components/field/index.ts +20 -0
  481. package/src/components/field-pair/FieldPair.mdx +308 -0
  482. package/src/components/field-pair/FieldPair.stories.tsx +530 -0
  483. package/src/components/field-pair/FieldPair.tsx +796 -0
  484. package/src/components/field-pair/index.ts +9 -0
  485. package/src/components/file-upload/FileUpload.mdx +345 -0
  486. package/src/components/file-upload/FileUpload.stories.tsx +698 -0
  487. package/src/components/file-upload/FileUpload.tsx +802 -0
  488. package/src/components/file-upload/index.ts +6 -0
  489. package/src/components/filter-chip/FilterChip.mdx +778 -0
  490. package/src/components/filter-chip/FilterChip.stories.tsx +827 -0
  491. package/src/components/filter-chip/FilterChip.tsx +881 -0
  492. package/src/components/filter-chip/index.ts +11 -0
  493. package/src/components/filter-facet/FilterFacet.mdx +536 -0
  494. package/src/components/filter-facet/FilterFacet.stories.tsx +506 -0
  495. package/src/components/filter-facet/FilterFacet.tsx +1160 -0
  496. package/src/components/filter-facet/index.ts +7 -0
  497. package/src/components/firm-avatar/FirmAvatar.mdx +280 -0
  498. package/src/components/firm-avatar/FirmAvatar.stories.tsx +147 -0
  499. package/src/components/firm-avatar/FirmAvatar.tsx +172 -0
  500. package/src/components/firm-avatar/index.ts +7 -0
  501. package/src/components/form-actions/FormActions.mdx +518 -0
  502. package/src/components/form-actions/FormActions.stories.tsx +621 -0
  503. package/src/components/form-actions/FormActions.tsx +273 -0
  504. package/src/components/form-actions/index.ts +6 -0
  505. package/src/components/form-block/FormBlock.mdx +728 -0
  506. package/src/components/form-block/FormBlock.stories.tsx +813 -0
  507. package/src/components/form-block/FormBlock.tsx +679 -0
  508. package/src/components/form-block/index.ts +13 -0
  509. package/src/components/form-section/FormSection.mdx +436 -0
  510. package/src/components/form-section/FormSection.stories.tsx +407 -0
  511. package/src/components/form-section/FormSection.tsx +290 -0
  512. package/src/components/form-section/index.ts +17 -0
  513. package/src/components/heading/Heading.mdx +206 -0
  514. package/src/components/heading/Heading.stories.tsx +169 -0
  515. package/src/components/heading/Heading.tsx +124 -0
  516. package/src/components/heading/index.ts +8 -0
  517. package/src/components/heading-group/HeadingGroup.mdx +521 -0
  518. package/src/components/heading-group/HeadingGroup.stories.tsx +353 -0
  519. package/src/components/heading-group/HeadingGroup.tsx +396 -0
  520. package/src/components/heading-group/index.ts +7 -0
  521. package/src/components/hero/Hero.mdx +742 -0
  522. package/src/components/hero/Hero.stories.tsx +527 -0
  523. package/src/components/hero/Hero.tsx +807 -0
  524. package/src/components/hero/index.ts +1 -0
  525. package/src/components/icon/Icon.mdx +329 -0
  526. package/src/components/icon/Icon.stories.tsx +398 -0
  527. package/src/components/icon/Icon.tsx +97 -0
  528. package/src/components/icon/index.ts +2 -0
  529. package/src/components/icon-button/IconButton.mdx +206 -0
  530. package/src/components/icon-button/IconButton.stories.tsx +341 -0
  531. package/src/components/icon-button/IconButton.tsx +273 -0
  532. package/src/components/icon-button/index.ts +1 -0
  533. package/src/components/item-row/ItemRow.mdx +533 -0
  534. package/src/components/item-row/ItemRow.stories.tsx +434 -0
  535. package/src/components/item-row/ItemRow.tsx +676 -0
  536. package/src/components/item-row/index.ts +9 -0
  537. package/src/components/list-row/ListRow.mdx +404 -0
  538. package/src/components/list-row/ListRow.stories.tsx +404 -0
  539. package/src/components/list-row/ListRow.tsx +424 -0
  540. package/src/components/list-row/index.ts +1 -0
  541. package/src/components/menu/Menu.mdx +268 -0
  542. package/src/components/menu/Menu.stories.tsx +455 -0
  543. package/src/components/menu/Menu.tsx +452 -0
  544. package/src/components/menu/index.ts +1 -0
  545. package/src/components/modal/Modal.mdx +854 -0
  546. package/src/components/modal/Modal.stories.tsx +881 -0
  547. package/src/components/modal/Modal.tsx +1434 -0
  548. package/src/components/modal/index.ts +1 -0
  549. package/src/components/nav-link/NavLink.mdx +196 -0
  550. package/src/components/nav-link/NavLink.stories.tsx +243 -0
  551. package/src/components/nav-link/NavLink.tsx +222 -0
  552. package/src/components/nav-link/index.ts +1 -0
  553. package/src/components/number-field/NumberField.mdx +223 -0
  554. package/src/components/number-field/NumberField.stories.tsx +291 -0
  555. package/src/components/number-field/NumberField.tsx +388 -0
  556. package/src/components/number-field/index.ts +6 -0
  557. package/src/components/pagination/Pagination.mdx +305 -0
  558. package/src/components/pagination/Pagination.stories.tsx +333 -0
  559. package/src/components/pagination/Pagination.tsx +343 -0
  560. package/src/components/pagination/index.ts +8 -0
  561. package/src/components/popover-surface/PopoverSurface.mdx +158 -0
  562. package/src/components/popover-surface/PopoverSurface.stories.tsx +421 -0
  563. package/src/components/popover-surface/index.ts +1 -0
  564. package/src/components/progress-bar/ProgressBar.mdx +802 -0
  565. package/src/components/progress-bar/ProgressBar.stories.tsx +533 -0
  566. package/src/components/progress-bar/ProgressBar.tsx +654 -0
  567. package/src/components/progress-bar/index.ts +9 -0
  568. package/src/components/promo-sticker/PromoSticker.mdx +436 -0
  569. package/src/components/promo-sticker/PromoSticker.stories.tsx +363 -0
  570. package/src/components/promo-sticker/PromoSticker.tsx +313 -0
  571. package/src/components/promo-sticker/index.ts +7 -0
  572. package/src/components/promo-surface/PromoSurface.mdx +399 -0
  573. package/src/components/promo-surface/PromoSurface.stories.tsx +270 -0
  574. package/src/components/promo-surface/PromoSurface.tsx +305 -0
  575. package/src/components/promo-surface/index.ts +7 -0
  576. package/src/components/radio/Radio.mdx +243 -0
  577. package/src/components/radio/Radio.stories.tsx +307 -0
  578. package/src/components/radio/Radio.tsx +288 -0
  579. package/src/components/radio/index.ts +1 -0
  580. package/src/components/radio-group/RadioGroup.mdx +119 -0
  581. package/src/components/radio-group/RadioGroup.stories.tsx +225 -0
  582. package/src/components/radio-group/RadioGroup.tsx +139 -0
  583. package/src/components/radio-group/index.ts +1 -0
  584. package/src/components/select/Select.mdx +241 -0
  585. package/src/components/select/Select.stories.tsx +404 -0
  586. package/src/components/select/Select.tsx +381 -0
  587. package/src/components/select/index.ts +1 -0
  588. package/src/components/select-field/SelectField.mdx +324 -0
  589. package/src/components/select-field/SelectField.stories.tsx +460 -0
  590. package/src/components/select-field/SelectField.tsx +138 -0
  591. package/src/components/select-field/index.ts +1 -0
  592. package/src/components/skeleton/Skeleton.mdx +194 -0
  593. package/src/components/skeleton/Skeleton.stories.tsx +260 -0
  594. package/src/components/skeleton/Skeleton.tsx +107 -0
  595. package/src/components/skeleton/index.ts +1 -0
  596. package/src/components/split-button/SplitButton.mdx +445 -0
  597. package/src/components/split-button/SplitButton.stories.tsx +465 -0
  598. package/src/components/split-button/SplitButton.tsx +361 -0
  599. package/src/components/split-button/index.ts +7 -0
  600. package/src/components/status-summary-bar/StatusSummaryBar.mdx +338 -0
  601. package/src/components/status-summary-bar/StatusSummaryBar.stories.tsx +408 -0
  602. package/src/components/status-summary-bar/StatusSummaryBar.tsx +428 -0
  603. package/src/components/status-summary-bar/index.ts +8 -0
  604. package/src/components/subject-lookup-field/SubjectLookupField.mdx +378 -0
  605. package/src/components/subject-lookup-field/SubjectLookupField.stories.tsx +393 -0
  606. package/src/components/subject-lookup-field/SubjectLookupField.tsx +1079 -0
  607. package/src/components/subject-lookup-field/index.ts +11 -0
  608. package/src/components/switch/Switch.mdx +376 -0
  609. package/src/components/switch/Switch.stories.tsx +296 -0
  610. package/src/components/switch/Switch.tsx +483 -0
  611. package/src/components/switch/index.ts +1 -0
  612. package/src/components/table/Table.mdx +575 -0
  613. package/src/components/table/Table.stories.tsx +1049 -0
  614. package/src/components/table/Table.tsx +745 -0
  615. package/src/components/table/TableConsumers.stories.tsx +195 -0
  616. package/src/components/table/_tableFixtures.ts +1189 -0
  617. package/src/components/table/index.ts +22 -0
  618. package/src/components/text-field/TextField.mdx +479 -0
  619. package/src/components/text-field/TextField.stories.tsx +366 -0
  620. package/src/components/text-field/TextField.tsx +391 -0
  621. package/src/components/text-field/index.ts +8 -0
  622. package/src/components/text-link/TextLink.mdx +353 -0
  623. package/src/components/text-link/TextLink.stories.tsx +458 -0
  624. package/src/components/text-link/TextLink.tsx +504 -0
  625. package/src/components/text-link/index.ts +10 -0
  626. package/src/components/textarea/Textarea.mdx +244 -0
  627. package/src/components/textarea/Textarea.stories.tsx +371 -0
  628. package/src/components/textarea/Textarea.tsx +489 -0
  629. package/src/components/textarea/index.ts +9 -0
  630. package/src/components/tooltip/Tooltip.mdx +462 -0
  631. package/src/components/tooltip/Tooltip.stories.tsx +500 -0
  632. package/src/components/tooltip/Tooltip.tsx +756 -0
  633. package/src/components/tooltip/index.ts +13 -0
  634. package/src/components/unit-field/UnitField.mdx +215 -0
  635. package/src/components/unit-field/UnitField.stories.tsx +291 -0
  636. package/src/components/unit-field/UnitField.tsx +255 -0
  637. package/src/components/unit-field/index.ts +7 -0
  638. package/src/icons/icon-registry.generated.ts +510 -0
  639. package/src/icons/icon-types.generated.ts +256 -0
  640. package/src/index.ts +71 -0
  641. package/src/internal/BottomSheet.tsx +714 -0
  642. package/src/internal/FodsProvider.tsx +36 -0
  643. package/src/internal/MotionCaret.tsx +53 -0
  644. package/src/internal/NumberFormatInput.tsx +276 -0
  645. package/src/internal/SummaryDonut.tsx +359 -0
  646. package/src/internal/buttonSegment.ts +241 -0
  647. package/src/internal/collapseRoom.ts +130 -0
  648. package/src/internal/comboboxKeys.ts +90 -0
  649. package/src/internal/contentPresence.ts +46 -0
  650. package/src/internal/dayCell.ts +274 -0
  651. package/src/internal/dialogPortal.ts +50 -0
  652. package/src/internal/donutSweeps.ts +77 -0
  653. package/src/internal/enterOnViewGeometry.ts +53 -0
  654. package/src/internal/faqItem.ts +104 -0
  655. package/src/internal/floatingLabelMotion.tsx +109 -0
  656. package/src/internal/formBlockContext.ts +27 -0
  657. package/src/internal/heightRoom.ts +135 -0
  658. package/src/internal/numberSeparators.ts +93 -0
  659. package/src/internal/overlayMotion.tsx +32 -0
  660. package/src/internal/paginationItem.ts +106 -0
  661. package/src/internal/popoverSurface.ts +78 -0
  662. package/src/internal/portalContainer.ts +11 -0
  663. package/src/internal/progressBarItem.ts +356 -0
  664. package/src/internal/selectionControlText.ts +42 -0
  665. package/src/internal/statusSummaryParts.tsx +475 -0
  666. package/src/internal/summaryMotion.ts +111 -0
  667. package/src/internal/table/ChildConnector.tsx +57 -0
  668. package/src/internal/table/ChildRowPrefix.tsx +21 -0
  669. package/src/internal/table/ColumnSettings.tsx +194 -0
  670. package/src/internal/table/ScrollRegion.tsx +176 -0
  671. package/src/internal/table/TableEmpty.tsx +99 -0
  672. package/src/internal/table/TableLayout.tsx +29 -0
  673. package/src/internal/table/TableLoadStatus.tsx +60 -0
  674. package/src/internal/table/TableMobile.tsx +582 -0
  675. package/src/internal/table/TruncatedCell.tsx +35 -0
  676. package/src/internal/table/emptyValue.ts +11 -0
  677. package/src/internal/table/features.ts +44 -0
  678. package/src/internal/table/recipes.ts +263 -0
  679. package/src/internal/table/rowClick.ts +8 -0
  680. package/src/internal/table/types.ts +342 -0
  681. package/src/internal/tailwind-variants.ts +65 -0
  682. package/src/internal/tooltipContext.ts +15 -0
  683. package/src/internal/tw-merge-config.generated.ts +275 -0
  684. package/src/internal/useAnchoredPanel.ts +340 -0
  685. package/src/internal/useCountUp.ts +65 -0
  686. package/src/internal/useDateFieldTrigger.tsx +357 -0
  687. package/src/internal/useEChart.ts +88 -0
  688. package/src/internal/useEnterOnView.ts +80 -0
  689. package/src/internal/useFloatingBar.ts +125 -0
  690. package/src/internal/useFormReset.ts +47 -0
  691. package/src/internal/useIsMobile.ts +64 -0
  692. package/src/internal/useNoImplicitSubmit.ts +41 -0
  693. package/src/internal/useOneRowOverflow.ts +103 -0
  694. package/src/internal/usePrefersReducedMotion.ts +27 -0
  695. package/src/internal/useReturnFocus.ts +34 -0
  696. package/src/internal/utils.ts +58 -0
  697. package/src/recipes/EmptyState.stories.tsx +105 -0
  698. package/src/recipes/Form.stories.tsx +355 -0
  699. package/src/recipes/ModalWithForm.stories.tsx +219 -0
  700. package/src/recipes/Recipes.mdx +61 -0
  701. package/src/recipes/TableWithFilters.stories.tsx +278 -0
  702. package/src/storybook/FodsFamily.tsx +39 -0
  703. package/src/storybook/Section.tsx +36 -0
  704. package/src/storybook/a11y.ts +24 -0
  705. package/src/storybook/assets/banner-character-bartender.webp +0 -0
  706. package/src/storybook/assets/banner-invoice-sheet-left.webp +0 -0
  707. package/src/storybook/assets/banner-invoice-sheet-right.webp +0 -0
  708. package/src/storybook/assets/invoice-hero.webp +0 -0
  709. package/src/storybook/assets/invoice.webp +0 -0
  710. package/src/storybook/assets/section-document-info.svg +21 -0
  711. package/src/storybook/assets/section-gear-checklist.svg +11 -0
  712. package/src/storybook/assets/section-person-arrow-in.svg +15 -0
  713. package/src/storybook/assets/section-person-arrow-out.svg +22 -0
  714. package/src/storybook/assets/section-receipt-dollar.svg +23 -0
  715. package/src/storybook/assets/table-empty-folder-empty.png +0 -0
  716. package/src/storybook/assets/table-empty-folder-magnifying-glass.png +0 -0
  717. package/src/storybook/assets/table-empty-funnel.png +0 -0
  718. package/src/storybook/assets/table-empty-load-failed.png +0 -0
  719. package/src/storybook/assets/wallet-spot.png +0 -0
  720. package/src/storybook/assets.d.ts +17 -0
  721. package/src/storybook/componentDoc.ts +41 -0
  722. package/src/storybook/fitFrame.tsx +70 -0
  723. package/src/storybook/forceStates.tsx +647 -0
  724. package/src/storybook/illustrations.tsx +66 -0
  725. package/src/storybook/viewportFrame.tsx +58 -0
  726. package/src/styles/assets/label-brush-1.svg +6 -0
  727. package/src/styles/assets/pattern-dark.svg +113 -0
  728. package/src/styles/base.css +106 -0
  729. package/src/styles/index.css +15 -0
  730. package/src/styles/motion.css +157 -0
  731. package/src/styles/promo-sticker.css +27 -0
  732. package/src/styles/promo-surface.css +49 -0
  733. package/src/styles/shared.css +11 -0
  734. package/src/styles/theme.generated.css +314 -0
  735. package/src/styles/theme.map.json +278 -0
  736. package/src/styles/tracking.generated.css +12 -0
  737. package/src/tokens/index.ts +4 -0
  738. 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
+ };