@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,353 @@
1
+ import { Meta, Canvas, Controls } from '@storybook/addon-docs/blocks';
2
+ import * as TextLinkStories from './TextLink.stories';
3
+
4
+
5
+ <Meta of={TextLinkStories} tags={['autodocs']} />
6
+
7
+ # TextLink
8
+
9
+ ## Metadata
10
+
11
+ - **Layer:** atom
12
+ - **Status:** stable
13
+ - **Tokens used:** `--border-width-200`, `--disabled-foreground`, `--font-body`, `--font-size-base`, `--font-size-sm`, `--font-size-xxs`, `--font-weight-normal`, `--font-weight-semibold`, `--leading-loose`, `--leading-relaxed`, `--outline-focus`, `--outline-focus-inverse`, `--radius-300`, `--size-icon-2xsmall`, `--size-icon-small`, `--size-icon-xsmall`, `--space-200`, `--text-inverted`, `--text-inverted-secondary`, `--text-link`, `--text-link-hover`, `--text-secondary`
14
+ - **Manifest version:** 1.13.1
15
+
16
+ ## Overview
17
+
18
+ An **inline or standalone text link** — link-blue text with a decorative leading / trailing icon (a leading icon by default on a standalone link — see [Icon rule](#icon-rule)) and **no button chrome**: it reads as text that happens to be actionable. Use it for navigation or a low-emphasis action rendered as text: a link inside running prose (`default`), a standalone action like „Upravit údaje“ / „Přidat agendu“ (`strong`), or a footer link column (`quiet`).
19
+
20
+ Do **not** use it for an action that needs emphasis or a real hit-area (→ [`Button`](?path=/docs/design-system-atoms-button--docs)), for the current-page marker in the header nav (→ `NavLink`, whose underline means *current page*), or for an icon-only control (→ [`IconButton`](?path=/docs/design-system-atoms-iconbutton--docs)).
21
+
22
+ ## Rationale
23
+
24
+ Two findings shaped the model:
25
+
26
+ 1. **Real links are underlined; footer columns are not.** In-app, every action / inline link is underlined. The only un-underlined links are top-nav (a different component) and **footer columns**, where a wall of underlines reads as a *picket fence*. So underline is the rule **except** the footer case.
27
+ 2. **Both weights are real.** Standalone action links are commonly Semibold; inline links are Regular — and an inline link should simply inherit whatever the paragraph carries.
28
+
29
+ The 2026-06 model collapsed both findings into one semantic `variant` axis with the underline bundled in. That was **re-opened on 2026-07-17** (manifest 1.6.0): practice showed the line is *intent-orthogonal* — links ship with and without it evenly depending on context (the Modal wizard's „← Zpět“ was the tipping consumer). The line therefore moved onto its own **`underline` axis**; `variant` keeps intent, weight and colour. Icons follow `Button` exactly (booleans + instance-swap in Figma, `leadingIcon` / `trailingIcon` props here), so the family behaves consistently.
30
+
31
+ `default` is kept **deliberately**, even in a form-centric interface with little running prose, because it is the correct archetype for help text, in-app explanations and marketing pages.
32
+
33
+ ## Anatomy
34
+
35
+ A baseline-aligned horizontal row: optional **leading icon** + **label** + optional **trailing icon**.
36
+
37
+ - **Label** — the visible text and the accessible name. Colour `--text-link` (`quiet`: `--text-secondary`), Body text style per size, weight per variant. Underline per the `underline` axis. Never icon-only.
38
+ - **Icon** (leading and/or trailing) — an `Icon` instance at `currentColor`, its width and height set per tier from the manifest `sizes[].icon` through `[&_.icon]:size-icon-<step>` (14 / 16 / 20; `1em` of the running text under `size="inherit"`), gap to the label `--space-200` (4). Decorative: `Icon` already renders `aria-hidden="true"`.
39
+ - **Focus ring** — additive `--outline-focus` ring at `--border-width-200`, stroke **outside**, **3px** offset, radius `--radius-300`, **no padding** (an inline link must not bloat the line box).
40
+ - **Layout box** — with an icon the link becomes an `inline-flex` row (the gap needs a flex container); without one it stays `inline`, so a link inside running prose wraps with the paragraph instead of turning into an unbreakable box. The row aligns on two different axes on purpose: the **label** is `items-baseline`, which also makes it supply the flex container's own baseline, so the link needs no `vertical-align` override and sits on the paragraph's baseline. The **icon** is `self-center` instead — `.icon` is an inline-block `<svg>` whose glyph is drawn mid-box, while a baseline-aligned SVG sits its bottom edge on the baseline, so baseline-aligning it would visibly lift the glyph above the text. Centring it on the line box is what actually reads as baseline-aligned.
41
+
42
+ ### Icon rule
43
+
44
+ A **standalone** TextLink — an action or a navigation link on its own line, in a card, at the foot of a block or in an Alert — carries a **leading icon** that names where it goes or what it does (`plus` for „Přidat“, an arrow for a next step, `question` for help), never a placeholder left on an unrelated action (manifest 1.13.0, owner rule — the Button rule extended). Two exceptions stay text-only: a link **inside running text**, where the sentence is the context, and a host with **no room** for icon + label. A missing fitting glyph is not an exception — pick one from the icon set by its use. Docs-only: `leadingIcon` stays optional and absent by default (the Figma `Show leading icon` default stays off so inline links stay clean).
45
+
46
+ ## Variants
47
+
48
+ <Canvas of={TextLinkStories.Variants} />
49
+
50
+ <table>
51
+ <thead>
52
+ <tr><th>Variant</th><th>Weight</th><th>When</th><th>Tokens</th></tr>
53
+ </thead>
54
+ <tbody>
55
+ <tr>
56
+ <td><code>default</code></td>
57
+ <td>inherits (Regular standalone)</td>
58
+ <td>inline / in-prose links; chrome links with an icon (the Modal wizard's „← Zpět“)</td>
59
+ <td>rest <code>--text-link</code>, hover <code>--text-link-hover</code></td>
60
+ </tr>
61
+ <tr>
62
+ <td><code>strong</code></td>
63
+ <td>Semibold</td>
64
+ <td>standalone action links („Upravit údaje“, „Přidat agendu“)</td>
65
+ <td>rest <code>--text-link</code>, hover <code>--text-link-hover</code></td>
66
+ </tr>
67
+ <tr>
68
+ <td><code>quiet</code></td>
69
+ <td>Regular</td>
70
+ <td>de-emphasised links — footer link columns</td>
71
+ <td>rest <strong>and</strong> hover <code>--text-secondary</code> (the colour deliberately does not change — the underline is the hover signal)</td>
72
+ </tr>
73
+ </tbody>
74
+ </table>
75
+
76
+ `default` emits **no** font-weight class at all, which is the manifest's inline archetype (`font-weight: inherit`); `--font-weight-normal` on the Default family is only the standalone / Figma-rendering binding. `strong` pins Semibold, `quiet` pins Regular — both are standalone archetypes.
77
+
78
+ ### Underline — the orthogonal axis
79
+
80
+ <Canvas of={TextLinkStories.Underline} />
81
+
82
+ <table>
83
+ <thead>
84
+ <tr><th>Underline</th><th>Rest / Disabled</th><th>Hover</th><th>When</th></tr>
85
+ </thead>
86
+ <tbody>
87
+ <tr><td><code>on</code> (default)</td><td>underlined</td><td>underlined</td><td>running prose, standalone actions — the line is the non-colour signal</td></tr>
88
+ <tr><td><code>off</code></td><td>bare</td><td>underlined</td><td><strong>only</strong> where a non-colour affordance sits next to the label: a leading/trailing icon, or list grouping (footer columns) — WCAG 1.4.1</td></tr>
89
+ </tbody>
90
+ </table>
91
+
92
+ Pair `quiet` with `underline="off"` in footer columns so they don't become a picket fence — grouping and position carry the affordance at rest.
93
+
94
+ ### Full matrix
95
+
96
+ <Canvas of={TextLinkStories.Matrix} />
97
+
98
+ ### Colored links — a container-driven pattern, **not** an axis of this atom
99
+
100
+ Inside a status container (an Alert / callout) a link is **not** link-blue: it takes the container's status ink so it reads as part of the message (the orange „Pokračovat zvlášť“ in a warning callout, the green „Zkontrolovat“ in a success one). Use `variant="strong"` there. **This is owned by the container** — the atom stays blue-only and **the recipe below is NOT implemented in `TextLink`**; it is documented here so the Alert / callout consumer knows the contract.
101
+
102
+ <table>
103
+ <thead>
104
+ <tr><th>State</th><th>Colour</th><th>Underline</th></tr>
105
+ </thead>
106
+ <tbody>
107
+ <tr><td>Rest</td><td><code>--status-&#123;f&#125;-active</code> (the same ink the Alert title/body use)</td><td>on</td></tr>
108
+ <tr><td>Hover</td><td><code>color-mix(in oklab, var(--status-&#123;f&#125;-active), var(--text-primary) 15%)</code></td><td>on</td></tr>
109
+ <tr><td>Pressed</td><td><code>color-mix(in oklab, var(--status-&#123;f&#125;-active), var(--text-primary) 30%)</code></td><td>on</td></tr>
110
+ <tr><td>Disabled</td><td><code>--disabled-foreground</code></td><td>on</td></tr>
111
+ </tbody>
112
+ </table>
113
+
114
+ Why a text-colour wash and not a background: on a light status tint the AA-safe ink already sits at the dark end of the scale, so there is no scale step left to darken into, and `-foreground` is white for info / success / danger (invisible on the tint). Washing the ink toward `--text-primary` generalises across all families, needs no new tokens, and only ever *raises* contrast. Declare a plain-colour fallback first for pre-2023 browsers (`color-mix()` is Baseline Widely Available since May 2023). `Pressed` exists **only** for colored links — the base blue link has no pressed state.
115
+
116
+ ### Inverse surface — the second container-driven pattern, and this one IS an axis
117
+
118
+ Where the colored-link recipe above stays out of the atom, the **dark-ground** one is built in:
119
+ `surface="inverse"` (`axes.surface`, manifest 1.11.0). The architecture is the same — the container
120
+ owns the colour, the atom gains no new resting-colour family — but the render ships as a real axis
121
+ because the whole Figma set was doubled for it.
122
+
123
+ <Canvas of={TextLinkStories.InverseSurface} />
124
+
125
+ One ladder serves all three families; the family keeps only its weight and decoration mechanics.
126
+
127
+ <table>
128
+ <thead>
129
+ <tr><th>State</th><th>Colour</th><th>≈ on <code>--bg-inverse</code></th><th>Underline</th></tr>
130
+ </thead>
131
+ <tbody>
132
+ <tr><td>Rest</td><td><code>--text-inverted-secondary</code></td><td>7.10:1</td><td>on</td></tr>
133
+ <tr><td>Hover / Pressed</td><td><code>--text-inverted</code></td><td>9.43:1</td><td>on</td></tr>
134
+ <tr><td>Disabled</td><td><code>--text-inverted-secondary</code> at 50%</td><td>exempt (WCAG 1.4.3)</td><td>on</td></tr>
135
+ </tbody>
136
+ </table>
137
+
138
+ Rest is deliberately **not white**: the copy around a bar link already is `--text-inverted`, and a
139
+ white link would hang on the underline alone. The quiet blue step is the exact mirror of a blue link
140
+ sitting in black text on a light surface. Two plain tokens, no `color-mix` — 1.11.0 dropped the mix
141
+ midpoint the earlier `delivery.inverseLink` described, because Figma could not render it without
142
+ binding a Layer-1 primitive.
143
+
144
+ **Scope: `--bg-inverse` only.** On a `--secondary-solid` panel (Promo Surface `Solid` / `Inverse`)
145
+ the same two-step ladder measures rest **3.35** / hover-pressed **4.45** and fails AA for normal text,
146
+ so no quiet text action goes on that fill at all — compose the one filled `Brand` CTA instead. Use `variant="strong"` for a
147
+ bar CTA. Canonical prose: `spec/06-patterns/inverse-surface.md`.
148
+
149
+ ## Sizes
150
+
151
+ <Canvas of={TextLinkStories.Sizes} />
152
+
153
+ <table>
154
+ <thead>
155
+ <tr><th>Size</th><th>Font</th><th>Token</th><th style={{ textAlign: 'right' }}>Icon</th><th>Gap</th></tr>
156
+ </thead>
157
+ <tbody>
158
+ <tr><td><code>xxs</code></td><td><code>Body/XXS</code> (12)</td><td><code>--font-size-xxs</code></td><td style={{ textAlign: 'right' }}>14 (<code>--size-icon-2xsmall</code>)</td><td><code>--space-200</code> (4)</td></tr>
159
+ <tr><td><code>sm</code></td><td><code>Body/S</code> (14)</td><td><code>--font-size-sm</code></td><td style={{ textAlign: 'right' }}>16 (<code>--size-icon-xsmall</code>)</td><td><code>--space-200</code> (4)</td></tr>
160
+ <tr><td><code>md</code> (default)</td><td><code>Body/M</code> (16)</td><td><code>--font-size-base</code></td><td style={{ textAlign: 'right' }}>20 (<code>--size-icon-small</code>)</td><td><code>--space-200</code> (4)</td></tr>
161
+ <tr><td><code>inherit</code></td><td>from the wrapper</td><td>— (no class emitted)</td><td style={{ textAlign: 'right' }}><code>1em</code> (= label)</td><td><code>--space-200</code> (4)</td></tr>
162
+ </tbody>
163
+ </table>
164
+
165
+ `xxs` is for compact / dense contexts (footer columns, table meta, legal fine print); `sm` / `md` are the body tiers. The size is named XXS to match the type scale (`Body/XXS` = 12, `Body/XS` = 13) — it is not a 13px tier.
166
+
167
+ `inherit` is the **inline** tier and has no Figma counterpart — Figma cannot express "inherit", so the component set only carries XXS / S / M. The three named tiers emit `text-body-*`, which binds a font-size **and** a line-height; an inline link must inherit both from its paragraph (spec *Inline links inherit the surrounding text*), so `inherit` emits no type class. Its one class sizes the icon: `[&_.icon]:size-[1em]`, so the glyph follows the inherited font-size and lands on the label's tier. It is the one deliberate non-token icon size in the package — the tier has no manifest row, so there is no `sizes[].icon` token to bind, and a fixed `--size-icon*` step would fit one paragraph size and miss the rest.
168
+
169
+ ### Inline links inherit the surrounding text
170
+
171
+ An **inline** link carries no fixed size — it inherits the paragraph's font-size, line-height **and weight**. Pick the tier matching the surrounding body text (12px body → `xxs`, 14px → `sm`, 15–16px → `md`) so a link dropped into prose never changes the line.
172
+
173
+ <Canvas of={TextLinkStories.Compositions} />
174
+
175
+ ## States
176
+
177
+ <Canvas of={TextLinkStories.States} />
178
+
179
+ - **Default** — `--text-link` (`quiet`: `--text-secondary`); underline per the `underline` axis.
180
+ - **Hover** — `--text-link-hover`; the underline is always on here (`underline="off"` gains it). `quiet` keeps `--text-secondary` on purpose — only the line appears.
181
+ - **Focus** — **not a variant**, but the cross-cutting focus-ring pattern: an additive `--outline-focus` ring at `--border-width-200`, stroke outside, **3px** offset (a lighter element earns more air), radius `--radius-300`, no padding. Applied on `:focus-visible` only. On `surface="inverse"` the colour swaps to `--outline-focus-inverse` — mandatory, not cosmetic: the default ring measures 2.12:1 on `--bg-inverse`, under the 3:1 non-text floor, against 9.43:1 for the inverted one.
182
+ - **Disabled** — `--disabled-foreground` in every variant, underline stays on, `pointer-events: none`, `aria-disabled="true"`, out of the tab order. On the `<a>` branch the `href` is dropped and clicks are suppressed — and because that also strips the anchor's implicit `link` role, the role is re-stated explicitly so `aria-disabled` still reaches assistive tech. On the `<button>` branch the native `disabled` attribute is used as well.
183
+ - **Pressed** — does not exist for the blue link; only for [colored links](#colored-links--a-container-driven-pattern-not-an-axis-of-this-atom) inside a status container.
184
+ - **Motion** (manifest 1.13.1 `motion`) — hover eases the ink and the underline colour over `--duration-hover`, press over `--duration-press`, both on `--easing-standard` (`transition-[color,text-decoration-color] duration-hover ease-standard active:duration-press` on the root), on both the `<button>` and the `<a>` branch. The focus ring is not in the list, so it never animates. With `underline="off"` the line itself appears on hover — a line cannot fade in, only its colour eases. Press is wired but has nothing to ease today: the blue link has no pressed step and on `surface="inverse"` pressed shares the hover ink. Colour is not movement, so no reduced-motion guard.
185
+
186
+ The Focus row forces the real pseudo-state via `storybook-addon-pseudo-states`. **Hover cannot use it** — Tailwind v4 emits every `hover:` utility inside `@media (hover: hover)` and the addon does not rewrite rules nested in a media query, so Hover is a hand-written rule in `src/storybook/forceStates.tsx`.
187
+
188
+ ## API
189
+
190
+ <Controls />
191
+
192
+ Notable behaviour not visible in the table:
193
+
194
+ - With `href` → a real `<a href>`. Without `href` → a `<button type="button">` styled as a link (an in-page action). Never a clickable `<span>`.
195
+ - `target="_blank"` always ships `rel="noopener"`; when the consumer passes no `rel` of its own, the full `rel="noopener noreferrer"` is emitted. A consumer-supplied `rel` is respected and only topped up.
196
+ - `size="inherit"` emits no font-size and no line-height — use it for any link inside running prose, so the paragraph keeps its own rhythm.
197
+ - `leadingIcon` / `trailingIcon` take `IconName | ReactElement`: a string is always an icon name, rendered as an `Icon`; an element is rendered as given (e.g. an `<Icon name="caret-down-small" />` inside a wrapper the consumer turns itself). Either way TextLink sizes the glyph (the `.icon` inside follows the size tier), colours it with `currentColor` and centres the slot on the line — the consumer adds no alignment of its own.
198
+ - `asChild` renders a Radix `Slot` and merges the props onto a single child (e.g. a React Router `<Link>`). Icons are then composed by the consumer, and this component's `href` is ignored — the child carries its own `href` / `to`.
199
+ - In `asChild` mode root and label collapse onto one element, so the underline folds into a self-hover pair (`!underline` / `hover:!underline`) instead of the label slot: `group-hover:` compiles to a descendant selector and could never match the element itself, and the `!` beats an unlayered global anchor rule a consuming app may carry (the package ships no global anchor rule).
200
+ - `asChild` + `disabled` cannot strip the child's `href`, so the link stays copyable and middle-clickable. What it does apply is the disabled ink, `aria-disabled`, `tabIndex={-1}` and click suppression — which covers keyboard Enter too, since that fires a click. The suppression runs in the **capture phase**: Radix `Slot` composes handlers child-first, so a bubble-phase guard would fire only after the child's own `onClick` had already navigated or run its mutation. Because that child-first composition applies to capture handlers as well, a disabled `asChild` link also has the child's own `onClick` / `onClickCapture` stripped from the clone — otherwise a child-declared capture handler would run ahead of the guard.
201
+
202
+ ## Do / Don't
203
+
204
+ - ✅ Use `default` for links inside paragraphs, underlined — colour alone is not enough in prose (WCAG 1.4.1).
205
+ - ✅ Use `strong` for standalone actions („Přidat agendu“, „Spravovat tarif“), `quiet` + `underline="off"` for footer link columns.
206
+ - ✅ Use `underline="off"` **only** when a non-colour affordance (icon or list grouping) sits next to the label.
207
+ - ✅ Carry „(otevře se v novém okně)“ as **text** in the label of an external / new-tab link, and put the glyph on a standalone (`strong`) link only.
208
+ - ✅ Write verb-first, sentence-case labels with no terminal period („Zobrazit vše“); the label must be meaningful out of context.
209
+ - ✅ Give every standalone link a leading icon that names its action or destination; keep links inside a sentence text-only.
210
+ - ❌ Don't leave a standalone link text-only by habit, or put an icon on a link inside running text.
211
+ - ❌ Don't use a TextLink where the action needs emphasis or a hit-area — that is a `Button`.
212
+ - ❌ Don't reuse it as the header nav current-page marker — that is `NavLink`'s underline.
213
+ - ❌ Don't leave a link `--text-link` blue inside a coloured Alert — the container recolours it to its own family's `-active` ink (`--status-danger-active` in a danger Alert) and washes toward `--text-primary` on hover/pressed; never signal that with a background fill.
214
+ - ❌ Don't put an external-link glyph on an inline (`default`) link, and never let the icon, `title` or `aria-label` be the *only* signal that a link opens a new tab.
215
+ - ❌ Don't write „klikněte zde“ / „zde“, and don't ship an icon-only TextLink — that is an `IconButton`.
216
+
217
+ ## Accessibility
218
+
219
+ - **Keyboard** — a native `<a href>` / `<button>`, so Tab reaches it and Enter activates it (Space too on the button branch). Nothing is re-implemented in JS. `disabled` removes it from the tab order (`tabIndex={-1}` on the anchor branch, the native `disabled` attribute on the button branch).
220
+ - **ARIA** — `aria-disabled="true"` when disabled (an `<a>` has no native disabled state). Icons are decorative and already carry `aria-hidden="true"`. While enabled the component adds **no** `role` — the element semantics are correct by construction. The one exception is a disabled anchor: dropping its `href` turns it into a generic element, and `aria-disabled` on a generic element announces nothing, so `role="link"` is re-stated for exactly that case.
221
+ - **Screen reader** — the visible label **is** the accessible name; there is no icon-only mode. A disabled link announces as disabled (see the ARIA note on why that needs the explicit role) and is skipped when tabbing. For a new-tab link the „opens in a new window“ meaning must live in the accessible name — a visible „(otevře se v novém okně)“ suffix or a visually-hidden span, announced **once** (WCAG 3.2.5 · G201).
222
+ - **Contrast** — `--text-link` is **blue/700 at 5.93:1** on white, clear of AA. It used to be blue/600 at 4.45:1, covered by an underline-based exception; the token move **retired** that exception for links on white. The underline still matters, just for a different reason: it is the non-colour cue WCAG 1.4.1 asks for, which is why the spec permits `underline="off"` only beside another non-colour affordance (icon or list grouping). `--text-secondary` (`quiet`) is a muted body ink at 6.45:1, which is why `quiet` is reserved for footer columns where grouping carries the meaning.
223
+ - **Motion** — the only animation is a colour transition; no transform, nothing that needs a reduced-motion opt-out. The component runs `--duration-hover` (press `--duration-press`) on `--easing-standard` on both branches. The package ships no global anchor rule; the component's transition is a layered utility, so a consumer's own unlayered `a { transition: … }` rule outranks it.
224
+ - **Security (not a11y, but it rides `target`)** — `target="_blank"` always gets `rel="noopener"` to block reverse tabnabbing.
225
+
226
+ Accessibility floor for every FODS component: `spec/01-foundations/accessibility.md`.
227
+
228
+ ## Copy
229
+
230
+ Voice: impersonal and in-app. The link text is the affordance, so it says where the link goes or what it does. The general field-copy conventions live in `spec/03-atoms/text-field.md` → Copy; link text adds the rules below.
231
+
232
+ - **Label** (`children`) — a short action or destination phrase: verb-first for an action, a clear destination noun for navigation. Sentence case, no terminal period; a few words, because the label is the click target, not a sentence. It must be meaningful out of context (screen-reader link lists), so never „klikněte zde“ / „zde“. Single line, wrap, max 40 characters.
233
+
234
+ Canonical action labels:
235
+
236
+ <table>
237
+ <thead>
238
+ <tr><th>Label</th><th>Pattern</th></tr>
239
+ </thead>
240
+ <tbody>
241
+ <tr><td>Přidat agendu</td><td>verb-first action</td></tr>
242
+ <tr><td>Spravovat tarif</td><td>verb-first action</td></tr>
243
+ <tr><td>Zobrazit vše</td><td>verb-first action</td></tr>
244
+ </tbody>
245
+ </table>
246
+
247
+ ## Usage
248
+
249
+ <Canvas of={TextLinkStories.Icons} />
250
+
251
+ ```tsx
252
+ // Good — inline in prose: size="inherit", so size, line-height and weight all come from the paragraph
253
+ <p className="text-body-base text-text-primary">
254
+ Fakturu pro <strong>Acme s.r.o.</strong> odešlete e-mailem na{' '}
255
+ <TextLink href="mailto:firma@priklad.cz" size="inherit">firma@priklad.cz</TextLink>, nebo si ji stáhněte v{' '}
256
+ <TextLink href="#" size="inherit">PDF</TextLink>.
257
+ </p>
258
+
259
+ // Good — standalone action, no href → renders <button type="button">
260
+ <TextLink variant="strong" leadingIcon="plus" onClick={openAgendaDialog}>
261
+ Přidat agendu
262
+ </TextLink>
263
+
264
+ // Good — footer column: quiet + underline off, grouping carries the affordance
265
+ <ul className="flex flex-col gap-300">
266
+ <li><TextLink href="#" variant="quiet" size="xxs" underline="off">Obchodní podmínky</TextLink></li>
267
+ <li><TextLink href="#" variant="quiet" size="xxs" underline="off">Ceník</TextLink></li>
268
+ </ul>
269
+
270
+ // Good — external link: the warning is TEXT, rel is added automatically
271
+ <TextLink href="https://priklad.cz/podminky" target="_blank" variant="strong" leadingIcon="file-text" trailingIcon="arrow-square-out">
272
+ Obchodní podmínky (otevře se v novém okně)
273
+ </TextLink>
274
+
275
+ // Good — composed with a router link (asChild: the consumer composes the leading icon)
276
+ <TextLink asChild variant="strong">
277
+ <Link to="/">
278
+ <Icon name="file-text" />
279
+ Přehled faktur
280
+ </Link>
281
+ </TextLink>
282
+ ```
283
+
284
+ ```tsx
285
+ // Don't — a standalone action left text-only by habit (the host has room for the icon)
286
+ <TextLink variant="strong" onClick={openAgendaDialog}>Přidat agendu</TextLink>
287
+
288
+ // Don't — underline off with nothing but colour to signal the link (WCAG 1.4.1)
289
+ <TextLink href="#" underline="off">Ceník</TextLink>
290
+
291
+ // Don't — the new-tab meaning hidden in the icon / title only
292
+ <TextLink href="https://priklad.cz" target="_blank" title="Otevře se v novém okně" trailingIcon="arrow-square-out">
293
+ Obchodní podmínky
294
+ </TextLink>
295
+
296
+ // Don't — an inline link pinned to a fixed tier inside a differently-sized paragraph:
297
+ // text-body-* binds a line-height too, so this shifts the line. Use size="inherit".
298
+ <p className="text-body-sm">… více v <TextLink href="#" size="md">nápovědě</TextLink>.</p>
299
+
300
+ // Don't — a primary action rendered as a text link
301
+ <TextLink variant="strong" onClick={submit}>Vystavit fakturu</TextLink> // → <Button>
302
+
303
+ // Don't — icon-only "link"
304
+ <TextLink href="#" leadingIcon="pencil-simple">{''}</TextLink> // → <IconButton>
305
+ ```
306
+
307
+ ## Related
308
+
309
+ - [`Button`](?path=/docs/design-system-atoms-button--docs) — an action **with** chrome and a hit-area; the escalation target when a text link is not enough.
310
+ - [`IconButton`](?path=/docs/design-system-atoms-iconbutton--docs) — the icon-only control; a TextLink is never icon-only.
311
+ - `NavLink` — the header wayfinding link where the underline means *current page* (not yet in this Storybook).
312
+ - `Alert` / callout — owns the [colored-link](#colored-links--a-container-driven-pattern-not-an-axis-of-this-atom) recipe; the atom stays blue-only.
313
+ - [`Icon`](?path=/docs/design-system-atoms-icon--docs) — the decorative glyph rendered by `leadingIcon` / `trailingIcon`.
314
+ - Spec: `spec/03-atoms/text-link.md` + `text-link.manifest.json` (source of truth for the axes, token bindings and the `delivery.coloredLinks` contract).
315
+
316
+ ## Migration notes
317
+
318
+ **Known implementation deviations (React side)**
319
+
320
+ <table>
321
+ <thead>
322
+ <tr><th>Spec</th><th>Implementation</th><th>Why</th></tr>
323
+ </thead>
324
+ <tbody>
325
+ <tr>
326
+ <td>focus offset 3px</td>
327
+ <td><code>outline-offset-[3px]</code> (arbitrary value)</td>
328
+ <td>no 3px spacing token exists (the scale jumps 4 → 6) and Tailwind's <code>outline-offset-*</code> scale stops at 2 / 4. The ring colour stays on <code>--outline-focus</code>.</td>
329
+ </tr>
330
+ <tr>
331
+ <td>icon on size <code>inherit</code></td>
332
+ <td><code>[&amp;_.icon]:size-[1em]</code></td>
333
+ <td>the code-only tier has no manifest row, so no <code>sizes[].icon</code> token: the icon is <code>1em</code> of the surrounding text, so it follows whatever tier the paragraph uses. The three named tiers bind their <code>--size-icon*</code> step.</td>
334
+ </tr>
335
+ <tr>
336
+ <td>label on <code>Body/S</code> (160%) and <code>Body/XXS</code> (150%)</td>
337
+ <td><code>text-body-sm</code> → <code>--leading-loose</code>, <code>text-body-xxs</code> → <code>--leading-relaxed</code></td>
338
+ <td><strong>No deviation in this package:</strong> the package theme (<code>styles/theme.generated.css</code>) binds those two tiers to <code>--leading-loose</code> (160%) and <code>--leading-relaxed</code> (150%), as the typography spec says. Listed because earlier implementations bound these tiers to other leading tokens; this package does not.</td>
339
+ </tr>
340
+ <tr>
341
+ <td>size axis XXS / S / M</td>
342
+ <td>plus a fourth <code>inherit</code></td>
343
+ <td>the spec requires an inline link to inherit font-size <em>and</em> line-height, which none of the three named tiers can do (they all emit <code>text-body-*</code>). Figma cannot express "inherit", so this tier is code-only and the Figma set doubled to 108 variants.</td>
344
+ </tr>
345
+ <tr>
346
+ <td>colored links inside a status container</td>
347
+ <td><strong>not implemented</strong></td>
348
+ <td>container-driven by design — the Alert / callout owns the ink and the wash; the atom stays blue-only.</td>
349
+ </tr>
350
+ </tbody>
351
+ </table>
352
+
353
+ **2026-11-10 — icon slots accept an element (not breaking):** `leadingIcon` / `trailingIcon` widened from `IconName` to `IconName | ReactElement`, matching ui-system `COMPONENT-CODE-CONVENTIONS.md` §3 (a slot takes a rendered node or an icon name) and `Button`. Every existing name-string call is unchanged; the manifest is unchanged. The icon centring moved from `[&_.icon]:self-center` to every direct child except the label (`[&>:not([data-fods-part=label])]:self-center`), so an element slot — whose wrapper, not the nested `.icon`, is the flex item — centres exactly like a bare `Icon`. First consumer: FormBlock's toggle caret.