@invoiceonline/ui-react 0.0.0 → 0.1.0

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