@invoiceonline/ui-react 0.0.0 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (731) hide show
  1. package/AGENTS.md +100 -0
  2. package/CHANGELOG.md +149 -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-picker/DatePicker.d.ts +53 -0
  60. package/dist/components/date-picker/DatePicker.js +329 -0
  61. package/dist/components/date-picker/index.d.ts +2 -0
  62. package/dist/components/date-picker/index.js +1 -0
  63. package/dist/components/divider/Divider.d.ts +81 -0
  64. package/dist/components/divider/Divider.js +93 -0
  65. package/dist/components/divider/index.d.ts +2 -0
  66. package/dist/components/divider/index.js +1 -0
  67. package/dist/components/drawer/Drawer.d.ts +128 -0
  68. package/dist/components/drawer/Drawer.js +367 -0
  69. package/dist/components/drawer/index.d.ts +2 -0
  70. package/dist/components/drawer/index.js +1 -0
  71. package/dist/components/dropdown-button/DropdownButton.d.ts +72 -0
  72. package/dist/components/dropdown-button/DropdownButton.js +122 -0
  73. package/dist/components/dropdown-button/index.d.ts +2 -0
  74. package/dist/components/dropdown-button/index.js +1 -0
  75. package/dist/components/faq/FAQ.d.ts +135 -0
  76. package/dist/components/faq/FAQ.js +258 -0
  77. package/dist/components/faq/index.d.ts +2 -0
  78. package/dist/components/faq/index.js +1 -0
  79. package/dist/components/field/Field.d.ts +119 -0
  80. package/dist/components/field/Field.js +332 -0
  81. package/dist/components/field/index.d.ts +2 -0
  82. package/dist/components/field/index.js +1 -0
  83. package/dist/components/field-pair/FieldPair.d.ts +210 -0
  84. package/dist/components/field-pair/FieldPair.js +335 -0
  85. package/dist/components/field-pair/index.d.ts +2 -0
  86. package/dist/components/field-pair/index.js +1 -0
  87. package/dist/components/file-upload/FileUpload.d.ts +137 -0
  88. package/dist/components/file-upload/FileUpload.js +434 -0
  89. package/dist/components/file-upload/index.d.ts +2 -0
  90. package/dist/components/file-upload/index.js +1 -0
  91. package/dist/components/filter-chip/FilterChip.d.ts +373 -0
  92. package/dist/components/filter-chip/FilterChip.js +517 -0
  93. package/dist/components/filter-chip/index.d.ts +2 -0
  94. package/dist/components/filter-chip/index.js +1 -0
  95. package/dist/components/filter-facet/FilterFacet.d.ts +116 -0
  96. package/dist/components/filter-facet/FilterFacet.js +632 -0
  97. package/dist/components/filter-facet/index.d.ts +2 -0
  98. package/dist/components/filter-facet/index.js +1 -0
  99. package/dist/components/firm-avatar/FirmAvatar.d.ts +75 -0
  100. package/dist/components/firm-avatar/FirmAvatar.js +119 -0
  101. package/dist/components/firm-avatar/index.d.ts +2 -0
  102. package/dist/components/firm-avatar/index.js +1 -0
  103. package/dist/components/form-actions/FormActions.d.ts +123 -0
  104. package/dist/components/form-actions/FormActions.js +195 -0
  105. package/dist/components/form-actions/index.d.ts +2 -0
  106. package/dist/components/form-actions/index.js +1 -0
  107. package/dist/components/form-block/FormBlock.d.ts +252 -0
  108. package/dist/components/form-block/FormBlock.js +420 -0
  109. package/dist/components/form-block/index.d.ts +3 -0
  110. package/dist/components/form-block/index.js +3 -0
  111. package/dist/components/form-section/FormSection.d.ts +130 -0
  112. package/dist/components/form-section/FormSection.js +206 -0
  113. package/dist/components/form-section/index.d.ts +2 -0
  114. package/dist/components/form-section/index.js +1 -0
  115. package/dist/components/heading/Heading.d.ts +69 -0
  116. package/dist/components/heading/Heading.js +79 -0
  117. package/dist/components/heading/index.d.ts +2 -0
  118. package/dist/components/heading/index.js +1 -0
  119. package/dist/components/heading-group/HeadingGroup.d.ts +258 -0
  120. package/dist/components/heading-group/HeadingGroup.js +255 -0
  121. package/dist/components/heading-group/index.d.ts +2 -0
  122. package/dist/components/heading-group/index.js +1 -0
  123. package/dist/components/hero/Hero.d.ts +268 -0
  124. package/dist/components/hero/Hero.js +316 -0
  125. package/dist/components/hero/index.d.ts +2 -0
  126. package/dist/components/hero/index.js +1 -0
  127. package/dist/components/icon/Icon.d.ts +27 -0
  128. package/dist/components/icon/Icon.js +30 -0
  129. package/dist/components/icon/index.d.ts +3 -0
  130. package/dist/components/icon/index.js +3 -0
  131. package/dist/components/icon-button/IconButton.d.ts +75 -0
  132. package/dist/components/icon-button/IconButton.js +151 -0
  133. package/dist/components/icon-button/index.d.ts +2 -0
  134. package/dist/components/icon-button/index.js +1 -0
  135. package/dist/components/item-row/ItemRow.d.ts +253 -0
  136. package/dist/components/item-row/ItemRow.js +496 -0
  137. package/dist/components/item-row/index.d.ts +2 -0
  138. package/dist/components/item-row/index.js +1 -0
  139. package/dist/components/list-row/ListRow.d.ts +165 -0
  140. package/dist/components/list-row/ListRow.js +233 -0
  141. package/dist/components/list-row/index.d.ts +2 -0
  142. package/dist/components/list-row/index.js +1 -0
  143. package/dist/components/menu/Menu.d.ts +64 -0
  144. package/dist/components/menu/Menu.js +186 -0
  145. package/dist/components/menu/index.d.ts +2 -0
  146. package/dist/components/menu/index.js +1 -0
  147. package/dist/components/modal/Modal.d.ts +272 -0
  148. package/dist/components/modal/Modal.js +788 -0
  149. package/dist/components/modal/index.d.ts +2 -0
  150. package/dist/components/modal/index.js +1 -0
  151. package/dist/components/nav-link/NavLink.d.ts +123 -0
  152. package/dist/components/nav-link/NavLink.js +157 -0
  153. package/dist/components/nav-link/index.d.ts +2 -0
  154. package/dist/components/nav-link/index.js +1 -0
  155. package/dist/components/number-field/NumberField.d.ts +62 -0
  156. package/dist/components/number-field/NumberField.js +210 -0
  157. package/dist/components/number-field/index.d.ts +2 -0
  158. package/dist/components/number-field/index.js +1 -0
  159. package/dist/components/pagination/Pagination.d.ts +133 -0
  160. package/dist/components/pagination/Pagination.js +217 -0
  161. package/dist/components/pagination/index.d.ts +3 -0
  162. package/dist/components/pagination/index.js +3 -0
  163. package/dist/components/popover-surface/index.d.ts +2 -0
  164. package/dist/components/popover-surface/index.js +1 -0
  165. package/dist/components/progress-bar/ProgressBar.d.ts +260 -0
  166. package/dist/components/progress-bar/ProgressBar.js +470 -0
  167. package/dist/components/progress-bar/index.d.ts +2 -0
  168. package/dist/components/progress-bar/index.js +1 -0
  169. package/dist/components/promo-sticker/PromoSticker.d.ts +204 -0
  170. package/dist/components/promo-sticker/PromoSticker.js +177 -0
  171. package/dist/components/promo-sticker/index.d.ts +2 -0
  172. package/dist/components/promo-sticker/index.js +1 -0
  173. package/dist/components/promo-surface/PromoSurface.d.ts +94 -0
  174. package/dist/components/promo-surface/PromoSurface.js +119 -0
  175. package/dist/components/promo-surface/index.d.ts +2 -0
  176. package/dist/components/promo-surface/index.js +1 -0
  177. package/dist/components/radio/Radio.d.ts +92 -0
  178. package/dist/components/radio/Radio.js +171 -0
  179. package/dist/components/radio/index.d.ts +2 -0
  180. package/dist/components/radio/index.js +1 -0
  181. package/dist/components/radio-group/RadioGroup.d.ts +61 -0
  182. package/dist/components/radio-group/RadioGroup.js +51 -0
  183. package/dist/components/radio-group/index.d.ts +2 -0
  184. package/dist/components/radio-group/index.js +1 -0
  185. package/dist/components/select/Select.d.ts +65 -0
  186. package/dist/components/select/Select.js +176 -0
  187. package/dist/components/select/index.d.ts +2 -0
  188. package/dist/components/select/index.js +1 -0
  189. package/dist/components/select-field/SelectField.d.ts +16 -0
  190. package/dist/components/select-field/SelectField.js +55 -0
  191. package/dist/components/select-field/index.d.ts +2 -0
  192. package/dist/components/select-field/index.js +1 -0
  193. package/dist/components/skeleton/Skeleton.d.ts +64 -0
  194. package/dist/components/skeleton/Skeleton.js +65 -0
  195. package/dist/components/skeleton/index.d.ts +2 -0
  196. package/dist/components/skeleton/index.js +1 -0
  197. package/dist/components/split-button/SplitButton.d.ts +80 -0
  198. package/dist/components/split-button/SplitButton.js +182 -0
  199. package/dist/components/split-button/index.d.ts +2 -0
  200. package/dist/components/split-button/index.js +1 -0
  201. package/dist/components/status-summary-bar/StatusSummaryBar.d.ts +118 -0
  202. package/dist/components/status-summary-bar/StatusSummaryBar.js +278 -0
  203. package/dist/components/status-summary-bar/index.d.ts +2 -0
  204. package/dist/components/status-summary-bar/index.js +1 -0
  205. package/dist/components/subject-lookup-field/SubjectLookupField.d.ts +157 -0
  206. package/dist/components/subject-lookup-field/SubjectLookupField.js +663 -0
  207. package/dist/components/subject-lookup-field/index.d.ts +2 -0
  208. package/dist/components/subject-lookup-field/index.js +1 -0
  209. package/dist/components/switch/Switch.d.ts +152 -0
  210. package/dist/components/switch/Switch.js +307 -0
  211. package/dist/components/switch/index.d.ts +2 -0
  212. package/dist/components/switch/index.js +1 -0
  213. package/dist/components/table/Table.d.ts +5 -0
  214. package/dist/components/table/Table.js +601 -0
  215. package/dist/components/table/index.d.ts +6 -0
  216. package/dist/components/table/index.js +6 -0
  217. package/dist/components/text-field/TextField.d.ts +160 -0
  218. package/dist/components/text-field/TextField.js +244 -0
  219. package/dist/components/text-field/index.d.ts +2 -0
  220. package/dist/components/text-field/index.js +1 -0
  221. package/dist/components/text-link/TextLink.d.ts +260 -0
  222. package/dist/components/text-link/TextLink.js +303 -0
  223. package/dist/components/text-link/index.d.ts +2 -0
  224. package/dist/components/text-link/index.js +1 -0
  225. package/dist/components/textarea/Textarea.d.ts +93 -0
  226. package/dist/components/textarea/Textarea.js +256 -0
  227. package/dist/components/textarea/index.d.ts +2 -0
  228. package/dist/components/textarea/index.js +1 -0
  229. package/dist/components/tooltip/Tooltip.d.ts +129 -0
  230. package/dist/components/tooltip/Tooltip.js +457 -0
  231. package/dist/components/tooltip/index.d.ts +2 -0
  232. package/dist/components/tooltip/index.js +1 -0
  233. package/dist/components/unit-field/UnitField.d.ts +46 -0
  234. package/dist/components/unit-field/UnitField.js +133 -0
  235. package/dist/components/unit-field/index.d.ts +2 -0
  236. package/dist/components/unit-field/index.js +1 -0
  237. package/dist/icons/icon-registry.generated.js +500 -0
  238. package/dist/icons/icon-types.generated.d.ts +2 -0
  239. package/dist/icons/icon-types.generated.js +126 -0
  240. package/dist/index.d.ts +130 -0
  241. package/dist/index.js +74 -0
  242. package/dist/internal/BottomSheet.js +496 -0
  243. package/dist/internal/FodsProvider.d.ts +25 -0
  244. package/dist/internal/FodsProvider.js +32 -0
  245. package/dist/internal/MotionCaret.js +35 -0
  246. package/dist/internal/NumberFormatInput.d.ts +21 -0
  247. package/dist/internal/NumberFormatInput.js +126 -0
  248. package/dist/internal/SummaryDonut.d.ts +3 -0
  249. package/dist/internal/SummaryDonut.js +300 -0
  250. package/dist/internal/buttonSegment.d.ts +44 -0
  251. package/dist/internal/buttonSegment.js +126 -0
  252. package/dist/internal/collapseRoom.js +128 -0
  253. package/dist/internal/comboboxKeys.js +44 -0
  254. package/dist/internal/contentPresence.js +46 -0
  255. package/dist/internal/dayCell.js +95 -0
  256. package/dist/internal/dialogPortal.d.ts +2 -0
  257. package/dist/internal/dialogPortal.js +21 -0
  258. package/dist/internal/donutSweeps.js +65 -0
  259. package/dist/internal/enterOnViewGeometry.js +46 -0
  260. package/dist/internal/faqItem.js +80 -0
  261. package/dist/internal/floatingLabelMotion.js +68 -0
  262. package/dist/internal/formBlockContext.d.ts +22 -0
  263. package/dist/internal/formBlockContext.js +20 -0
  264. package/dist/internal/heightRoom.js +87 -0
  265. package/dist/internal/numberSeparators.js +62 -0
  266. package/dist/internal/overlayMotion.js +48 -0
  267. package/dist/internal/paginationItem.d.ts +8 -0
  268. package/dist/internal/paginationItem.js +22 -0
  269. package/dist/internal/popoverSurface.d.ts +8 -0
  270. package/dist/internal/popoverSurface.js +23 -0
  271. package/dist/internal/portalContainer.d.ts +1 -0
  272. package/dist/internal/portalContainer.js +6 -0
  273. package/dist/internal/progressBarItem.d.ts +207 -0
  274. package/dist/internal/progressBarItem.js +264 -0
  275. package/dist/internal/selectionControlText.js +12 -0
  276. package/dist/internal/statusSummaryParts.js +371 -0
  277. package/dist/internal/summaryMotion.js +75 -0
  278. package/dist/internal/table/ChildConnector.js +62 -0
  279. package/dist/internal/table/ChildRowPrefix.d.ts +9 -0
  280. package/dist/internal/table/ChildRowPrefix.js +27 -0
  281. package/dist/internal/table/ColumnSettings.js +135 -0
  282. package/dist/internal/table/ScrollRegion.js +114 -0
  283. package/dist/internal/table/TableEmpty.js +93 -0
  284. package/dist/internal/table/TableLayout.d.ts +17 -0
  285. package/dist/internal/table/TableLayout.js +29 -0
  286. package/dist/internal/table/TableLoadStatus.js +56 -0
  287. package/dist/internal/table/TableMobile.js +488 -0
  288. package/dist/internal/table/TruncatedCell.js +33 -0
  289. package/dist/internal/table/emptyValue.js +10 -0
  290. package/dist/internal/table/features.d.ts +41 -0
  291. package/dist/internal/table/features.js +31 -0
  292. package/dist/internal/table/recipes.js +227 -0
  293. package/dist/internal/table/rowClick.js +9 -0
  294. package/dist/internal/table/types.d.ts +325 -0
  295. package/dist/internal/table/types.js +13 -0
  296. package/dist/internal/tailwind-variants.d.ts +3 -0
  297. package/dist/internal/tailwind-variants.js +37 -0
  298. package/dist/internal/tooltipContext.js +5 -0
  299. package/dist/internal/tw-merge-config.generated.js +314 -0
  300. package/dist/internal/useAnchoredPanel.d.ts +87 -0
  301. package/dist/internal/useAnchoredPanel.js +108 -0
  302. package/dist/internal/useCountUp.js +53 -0
  303. package/dist/internal/useDateFieldTrigger.d.ts +60 -0
  304. package/dist/internal/useDateFieldTrigger.js +235 -0
  305. package/dist/internal/useEChart.js +59 -0
  306. package/dist/internal/useEnterOnView.js +42 -0
  307. package/dist/internal/useFloatingBar.js +100 -0
  308. package/dist/internal/useFormReset.js +44 -0
  309. package/dist/internal/useIsMobile.js +44 -0
  310. package/dist/internal/useOneRowOverflow.js +88 -0
  311. package/dist/internal/usePrefersReducedMotion.js +25 -0
  312. package/dist/internal/useReturnFocus.js +26 -0
  313. package/dist/internal/utils.d.ts +7 -0
  314. package/dist/internal/utils.js +58 -0
  315. package/dist/node_modules/@tanstack/store/dist/store.d.ts +29 -0
  316. package/dist/node_modules/@tanstack/store/dist/types.d.ts +38 -0
  317. package/dist/node_modules/@tanstack/table-core/dist/core/cells/coreCellsFeature.d.ts +6 -0
  318. package/dist/node_modules/@tanstack/table-core/dist/core/cells/coreCellsFeature.types.d.ts +53 -0
  319. package/dist/node_modules/@tanstack/table-core/dist/core/columns/coreColumnsFeature.d.ts +6 -0
  320. package/dist/node_modules/@tanstack/table-core/dist/core/columns/coreColumnsFeature.types.d.ts +90 -0
  321. package/dist/node_modules/@tanstack/table-core/dist/core/coreFeatures.d.ts +17 -0
  322. package/dist/node_modules/@tanstack/table-core/dist/core/headers/coreHeadersFeature.d.ts +6 -0
  323. package/dist/node_modules/@tanstack/table-core/dist/core/headers/coreHeadersFeature.types.d.ts +114 -0
  324. package/dist/node_modules/@tanstack/table-core/dist/core/reactivity/coreReactivityFeature.types.d.ts +51 -0
  325. package/dist/node_modules/@tanstack/table-core/dist/core/row-models/coreRowModelsFeature.d.ts +6 -0
  326. package/dist/node_modules/@tanstack/table-core/dist/core/row-models/coreRowModelsFeature.types.d.ts +29 -0
  327. package/dist/node_modules/@tanstack/table-core/dist/core/rows/coreRowsFeature.d.ts +6 -0
  328. package/dist/node_modules/@tanstack/table-core/dist/core/rows/coreRowsFeature.types.d.ts +129 -0
  329. package/dist/node_modules/@tanstack/table-core/dist/core/table/coreTablesFeature.d.ts +6 -0
  330. package/dist/node_modules/@tanstack/table-core/dist/core/table/coreTablesFeature.types.d.ts +203 -0
  331. package/dist/node_modules/@tanstack/table-core/dist/features/cell-selection/cellSelectionFeature.d.ts +6 -0
  332. package/dist/node_modules/@tanstack/table-core/dist/features/cell-selection/cellSelectionFeature.types.d.ts +294 -0
  333. package/dist/node_modules/@tanstack/table-core/dist/features/cell-spanning/cellSpanningFeature.d.ts +11 -0
  334. package/dist/node_modules/@tanstack/table-core/dist/features/cell-spanning/cellSpanningFeature.types.d.ts +148 -0
  335. package/dist/node_modules/@tanstack/table-core/dist/features/column-faceting/columnFacetingFeature.d.ts +12 -0
  336. package/dist/node_modules/@tanstack/table-core/dist/features/column-faceting/columnFacetingFeature.types.d.ts +63 -0
  337. package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/columnFilteringFeature.d.ts +6 -0
  338. package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/columnFilteringFeature.types.d.ts +209 -0
  339. package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/filterFns.d.ts +35 -0
  340. package/dist/node_modules/@tanstack/table-core/dist/features/column-grouping/columnGroupingFeature.d.ts +6 -0
  341. package/dist/node_modules/@tanstack/table-core/dist/features/column-grouping/columnGroupingFeature.types.d.ts +128 -0
  342. package/dist/node_modules/@tanstack/table-core/dist/features/column-ordering/columnOrderingFeature.d.ts +6 -0
  343. package/dist/node_modules/@tanstack/table-core/dist/features/column-ordering/columnOrderingFeature.types.d.ts +82 -0
  344. package/dist/node_modules/@tanstack/table-core/dist/features/column-pinning/columnPinningFeature.d.ts +11 -0
  345. package/dist/node_modules/@tanstack/table-core/dist/features/column-pinning/columnPinningFeature.types.d.ts +195 -0
  346. package/dist/node_modules/@tanstack/table-core/dist/features/column-resizing/columnResizingFeature.d.ts +6 -0
  347. package/dist/node_modules/@tanstack/table-core/dist/features/column-resizing/columnResizingFeature.types.d.ts +73 -0
  348. package/dist/node_modules/@tanstack/table-core/dist/features/column-sizing/columnSizingFeature.d.ts +6 -0
  349. package/dist/node_modules/@tanstack/table-core/dist/features/column-sizing/columnSizingFeature.types.d.ts +134 -0
  350. package/dist/node_modules/@tanstack/table-core/dist/features/column-visibility/columnVisibilityFeature.d.ts +6 -0
  351. package/dist/node_modules/@tanstack/table-core/dist/features/column-visibility/columnVisibilityFeature.types.d.ts +92 -0
  352. package/dist/node_modules/@tanstack/table-core/dist/features/global-filtering/globalFilteringFeature.d.ts +6 -0
  353. package/dist/node_modules/@tanstack/table-core/dist/features/global-filtering/globalFilteringFeature.types.d.ts +67 -0
  354. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/aggregationFns.d.ts +23 -0
  355. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.d.ts +6 -0
  356. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.types.d.ts +183 -0
  357. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.utils.d.ts +18 -0
  358. package/dist/node_modules/@tanstack/table-core/dist/features/row-expanding/rowExpandingFeature.d.ts +6 -0
  359. package/dist/node_modules/@tanstack/table-core/dist/features/row-expanding/rowExpandingFeature.types.d.ts +125 -0
  360. package/dist/node_modules/@tanstack/table-core/dist/features/row-pagination/rowPaginationFeature.d.ts +6 -0
  361. package/dist/node_modules/@tanstack/table-core/dist/features/row-pagination/rowPaginationFeature.types.d.ts +135 -0
  362. package/dist/node_modules/@tanstack/table-core/dist/features/row-pinning/rowPinningFeature.d.ts +6 -0
  363. package/dist/node_modules/@tanstack/table-core/dist/features/row-pinning/rowPinningFeature.types.d.ts +76 -0
  364. package/dist/node_modules/@tanstack/table-core/dist/features/row-selection/rowSelectionFeature.d.ts +6 -0
  365. package/dist/node_modules/@tanstack/table-core/dist/features/row-selection/rowSelectionFeature.types.d.ts +187 -0
  366. package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/rowSortingFeature.d.ts +6 -0
  367. package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/rowSortingFeature.types.d.ts +236 -0
  368. package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/sortFns.d.ts +23 -0
  369. package/dist/node_modules/@tanstack/table-core/dist/features/stockFeatures.d.ts +37 -0
  370. package/dist/node_modules/@tanstack/table-core/dist/helpers/columnHelper.d.ts +47 -0
  371. package/dist/node_modules/@tanstack/table-core/dist/types/Cell.d.ts +16 -0
  372. package/dist/node_modules/@tanstack/table-core/dist/types/Column.d.ts +30 -0
  373. package/dist/node_modules/@tanstack/table-core/dist/types/ColumnDef.d.ts +123 -0
  374. package/dist/node_modules/@tanstack/table-core/dist/types/Header.d.ts +12 -0
  375. package/dist/node_modules/@tanstack/table-core/dist/types/HeaderGroup.d.ts +6 -0
  376. package/dist/node_modules/@tanstack/table-core/dist/types/Row.d.ts +24 -0
  377. package/dist/node_modules/@tanstack/table-core/dist/types/RowModel.d.ts +19 -0
  378. package/dist/node_modules/@tanstack/table-core/dist/types/RowModelFns.d.ts +11 -0
  379. package/dist/node_modules/@tanstack/table-core/dist/types/Table.d.ts +53 -0
  380. package/dist/node_modules/@tanstack/table-core/dist/types/TableFeatures.d.ts +416 -0
  381. package/dist/node_modules/@tanstack/table-core/dist/types/TableOptions.d.ts +78 -0
  382. package/dist/node_modules/@tanstack/table-core/dist/types/TableState.d.ts +46 -0
  383. package/dist/node_modules/@tanstack/table-core/dist/types/type-utils.d.ts +25 -0
  384. package/dist/shared.css +179 -0
  385. package/dist/styles.css +5467 -0
  386. package/dist/theme.css +314 -0
  387. package/dist/theme.map.json +278 -0
  388. package/dist/tokens/index.d.ts +2 -0
  389. package/dist/tokens/index.js +1 -0
  390. package/dist/tokens/tokens.generated.d.ts +2040 -0
  391. package/dist/tokens/tokens.generated.js +2053 -0
  392. package/dist/tokens.css +484 -0
  393. package/dist/tokens.flat.json +429 -0
  394. package/docs/Consuming.mdx +396 -0
  395. package/docs/Contributing.mdx +78 -0
  396. package/docs/ForAgents.mdx +53 -0
  397. package/docs/Introduction.mdx +54 -0
  398. package/llms.txt +550 -0
  399. package/package.json +347 -3
  400. package/src/components/action-row/ActionRow.mdx +686 -0
  401. package/src/components/action-row/ActionRow.stories.tsx +669 -0
  402. package/src/components/action-row/ActionRow.tsx +632 -0
  403. package/src/components/action-row/index.ts +9 -0
  404. package/src/components/alert/Alert.mdx +377 -0
  405. package/src/components/alert/Alert.stories.tsx +674 -0
  406. package/src/components/alert/Alert.tsx +579 -0
  407. package/src/components/alert/index.ts +13 -0
  408. package/src/components/anchored-panel/AnchoredPanel.mdx +381 -0
  409. package/src/components/anchored-panel/AnchoredPanel.stories.tsx +593 -0
  410. package/src/components/anchored-panel/AnchoredPanel.tsx +176 -0
  411. package/src/components/anchored-panel/index.ts +15 -0
  412. package/src/components/badge/Badge.mdx +487 -0
  413. package/src/components/badge/Badge.stories.tsx +375 -0
  414. package/src/components/badge/Badge.tsx +360 -0
  415. package/src/components/badge/index.ts +10 -0
  416. package/src/components/banner/Banner.mdx +704 -0
  417. package/src/components/banner/Banner.stories.tsx +448 -0
  418. package/src/components/banner/Banner.tsx +602 -0
  419. package/src/components/banner/index.ts +14 -0
  420. package/src/components/button/Button.mdx +286 -0
  421. package/src/components/button/Button.stories.tsx +381 -0
  422. package/src/components/button/Button.tsx +384 -0
  423. package/src/components/button/index.ts +1 -0
  424. package/src/components/button-group/ButtonGroup.mdx +512 -0
  425. package/src/components/button-group/ButtonGroup.stories.tsx +714 -0
  426. package/src/components/button-group/ButtonGroup.tsx +491 -0
  427. package/src/components/button-group/index.ts +10 -0
  428. package/src/components/card-select/CardSelect.mdx +662 -0
  429. package/src/components/card-select/CardSelect.stories.tsx +784 -0
  430. package/src/components/card-select/CardSelect.tsx +783 -0
  431. package/src/components/card-select/CardSelectGroup.tsx +169 -0
  432. package/src/components/card-select/index.ts +18 -0
  433. package/src/components/checkbox/Checkbox.mdx +269 -0
  434. package/src/components/checkbox/Checkbox.stories.tsx +306 -0
  435. package/src/components/checkbox/Checkbox.tsx +343 -0
  436. package/src/components/checkbox/index.ts +1 -0
  437. package/src/components/chip/Chip.mdx +683 -0
  438. package/src/components/chip/Chip.stories.tsx +734 -0
  439. package/src/components/chip/Chip.tsx +732 -0
  440. package/src/components/chip/index.ts +9 -0
  441. package/src/components/column-header/ColumnHeader.mdx +301 -0
  442. package/src/components/column-header/ColumnHeader.stories.tsx +319 -0
  443. package/src/components/column-header/ColumnHeader.tsx +287 -0
  444. package/src/components/column-header/index.ts +7 -0
  445. package/src/components/combobox-field/Combobox.tsx +693 -0
  446. package/src/components/combobox-field/ComboboxField.mdx +525 -0
  447. package/src/components/combobox-field/ComboboxField.stories.tsx +502 -0
  448. package/src/components/combobox-field/ComboboxField.tsx +259 -0
  449. package/src/components/combobox-field/index.ts +12 -0
  450. package/src/components/date-picker/DatePicker.mdx +440 -0
  451. package/src/components/date-picker/DatePicker.stories.tsx +458 -0
  452. package/src/components/date-picker/DatePicker.tsx +688 -0
  453. package/src/components/date-picker/index.ts +9 -0
  454. package/src/components/divider/Divider.mdx +256 -0
  455. package/src/components/divider/Divider.stories.tsx +177 -0
  456. package/src/components/divider/Divider.tsx +193 -0
  457. package/src/components/divider/index.ts +1 -0
  458. package/src/components/drawer/Drawer.mdx +518 -0
  459. package/src/components/drawer/Drawer.stories.tsx +392 -0
  460. package/src/components/drawer/Drawer.tsx +683 -0
  461. package/src/components/drawer/index.ts +1 -0
  462. package/src/components/dropdown-button/DropdownButton.mdx +285 -0
  463. package/src/components/dropdown-button/DropdownButton.stories.tsx +398 -0
  464. package/src/components/dropdown-button/DropdownButton.tsx +198 -0
  465. package/src/components/dropdown-button/index.ts +7 -0
  466. package/src/components/faq/FAQ.mdx +364 -0
  467. package/src/components/faq/FAQ.stories.tsx +343 -0
  468. package/src/components/faq/FAQ.tsx +337 -0
  469. package/src/components/faq/index.ts +1 -0
  470. package/src/components/field/Field.mdx +129 -0
  471. package/src/components/field/Field.stories.tsx +461 -0
  472. package/src/components/field/Field.tsx +787 -0
  473. package/src/components/field/index.ts +20 -0
  474. package/src/components/field-pair/FieldPair.mdx +312 -0
  475. package/src/components/field-pair/FieldPair.stories.tsx +539 -0
  476. package/src/components/field-pair/FieldPair.tsx +845 -0
  477. package/src/components/field-pair/index.ts +9 -0
  478. package/src/components/file-upload/FileUpload.mdx +345 -0
  479. package/src/components/file-upload/FileUpload.stories.tsx +698 -0
  480. package/src/components/file-upload/FileUpload.tsx +802 -0
  481. package/src/components/file-upload/index.ts +6 -0
  482. package/src/components/filter-chip/FilterChip.mdx +778 -0
  483. package/src/components/filter-chip/FilterChip.stories.tsx +827 -0
  484. package/src/components/filter-chip/FilterChip.tsx +881 -0
  485. package/src/components/filter-chip/index.ts +11 -0
  486. package/src/components/filter-facet/FilterFacet.mdx +536 -0
  487. package/src/components/filter-facet/FilterFacet.stories.tsx +506 -0
  488. package/src/components/filter-facet/FilterFacet.tsx +1160 -0
  489. package/src/components/filter-facet/index.ts +7 -0
  490. package/src/components/firm-avatar/FirmAvatar.mdx +280 -0
  491. package/src/components/firm-avatar/FirmAvatar.stories.tsx +147 -0
  492. package/src/components/firm-avatar/FirmAvatar.tsx +172 -0
  493. package/src/components/firm-avatar/index.ts +7 -0
  494. package/src/components/form-actions/FormActions.mdx +518 -0
  495. package/src/components/form-actions/FormActions.stories.tsx +621 -0
  496. package/src/components/form-actions/FormActions.tsx +273 -0
  497. package/src/components/form-actions/index.ts +6 -0
  498. package/src/components/form-block/FormBlock.mdx +728 -0
  499. package/src/components/form-block/FormBlock.stories.tsx +813 -0
  500. package/src/components/form-block/FormBlock.tsx +679 -0
  501. package/src/components/form-block/index.ts +13 -0
  502. package/src/components/form-section/FormSection.mdx +436 -0
  503. package/src/components/form-section/FormSection.stories.tsx +407 -0
  504. package/src/components/form-section/FormSection.tsx +290 -0
  505. package/src/components/form-section/index.ts +17 -0
  506. package/src/components/heading/Heading.mdx +206 -0
  507. package/src/components/heading/Heading.stories.tsx +169 -0
  508. package/src/components/heading/Heading.tsx +124 -0
  509. package/src/components/heading/index.ts +8 -0
  510. package/src/components/heading-group/HeadingGroup.mdx +521 -0
  511. package/src/components/heading-group/HeadingGroup.stories.tsx +353 -0
  512. package/src/components/heading-group/HeadingGroup.tsx +396 -0
  513. package/src/components/heading-group/index.ts +7 -0
  514. package/src/components/hero/Hero.mdx +742 -0
  515. package/src/components/hero/Hero.stories.tsx +527 -0
  516. package/src/components/hero/Hero.tsx +807 -0
  517. package/src/components/hero/index.ts +1 -0
  518. package/src/components/icon/Icon.mdx +329 -0
  519. package/src/components/icon/Icon.stories.tsx +398 -0
  520. package/src/components/icon/Icon.tsx +97 -0
  521. package/src/components/icon/index.ts +2 -0
  522. package/src/components/icon-button/IconButton.mdx +206 -0
  523. package/src/components/icon-button/IconButton.stories.tsx +341 -0
  524. package/src/components/icon-button/IconButton.tsx +273 -0
  525. package/src/components/icon-button/index.ts +1 -0
  526. package/src/components/item-row/ItemRow.mdx +533 -0
  527. package/src/components/item-row/ItemRow.stories.tsx +434 -0
  528. package/src/components/item-row/ItemRow.tsx +676 -0
  529. package/src/components/item-row/index.ts +9 -0
  530. package/src/components/list-row/ListRow.mdx +404 -0
  531. package/src/components/list-row/ListRow.stories.tsx +404 -0
  532. package/src/components/list-row/ListRow.tsx +424 -0
  533. package/src/components/list-row/index.ts +1 -0
  534. package/src/components/menu/Menu.mdx +268 -0
  535. package/src/components/menu/Menu.stories.tsx +455 -0
  536. package/src/components/menu/Menu.tsx +452 -0
  537. package/src/components/menu/index.ts +1 -0
  538. package/src/components/modal/Modal.mdx +854 -0
  539. package/src/components/modal/Modal.stories.tsx +881 -0
  540. package/src/components/modal/Modal.tsx +1434 -0
  541. package/src/components/modal/index.ts +1 -0
  542. package/src/components/nav-link/NavLink.mdx +196 -0
  543. package/src/components/nav-link/NavLink.stories.tsx +243 -0
  544. package/src/components/nav-link/NavLink.tsx +222 -0
  545. package/src/components/nav-link/index.ts +1 -0
  546. package/src/components/number-field/NumberField.mdx +223 -0
  547. package/src/components/number-field/NumberField.stories.tsx +291 -0
  548. package/src/components/number-field/NumberField.tsx +388 -0
  549. package/src/components/number-field/index.ts +6 -0
  550. package/src/components/pagination/Pagination.mdx +305 -0
  551. package/src/components/pagination/Pagination.stories.tsx +333 -0
  552. package/src/components/pagination/Pagination.tsx +343 -0
  553. package/src/components/pagination/index.ts +8 -0
  554. package/src/components/popover-surface/PopoverSurface.mdx +158 -0
  555. package/src/components/popover-surface/PopoverSurface.stories.tsx +421 -0
  556. package/src/components/popover-surface/index.ts +1 -0
  557. package/src/components/progress-bar/ProgressBar.mdx +802 -0
  558. package/src/components/progress-bar/ProgressBar.stories.tsx +533 -0
  559. package/src/components/progress-bar/ProgressBar.tsx +654 -0
  560. package/src/components/progress-bar/index.ts +9 -0
  561. package/src/components/promo-sticker/PromoSticker.mdx +436 -0
  562. package/src/components/promo-sticker/PromoSticker.stories.tsx +363 -0
  563. package/src/components/promo-sticker/PromoSticker.tsx +313 -0
  564. package/src/components/promo-sticker/index.ts +7 -0
  565. package/src/components/promo-surface/PromoSurface.mdx +399 -0
  566. package/src/components/promo-surface/PromoSurface.stories.tsx +270 -0
  567. package/src/components/promo-surface/PromoSurface.tsx +305 -0
  568. package/src/components/promo-surface/index.ts +7 -0
  569. package/src/components/radio/Radio.mdx +243 -0
  570. package/src/components/radio/Radio.stories.tsx +307 -0
  571. package/src/components/radio/Radio.tsx +288 -0
  572. package/src/components/radio/index.ts +1 -0
  573. package/src/components/radio-group/RadioGroup.mdx +119 -0
  574. package/src/components/radio-group/RadioGroup.stories.tsx +225 -0
  575. package/src/components/radio-group/RadioGroup.tsx +139 -0
  576. package/src/components/radio-group/index.ts +1 -0
  577. package/src/components/select/Select.mdx +241 -0
  578. package/src/components/select/Select.stories.tsx +404 -0
  579. package/src/components/select/Select.tsx +381 -0
  580. package/src/components/select/index.ts +1 -0
  581. package/src/components/select-field/SelectField.mdx +324 -0
  582. package/src/components/select-field/SelectField.stories.tsx +460 -0
  583. package/src/components/select-field/SelectField.tsx +138 -0
  584. package/src/components/select-field/index.ts +1 -0
  585. package/src/components/skeleton/Skeleton.mdx +194 -0
  586. package/src/components/skeleton/Skeleton.stories.tsx +260 -0
  587. package/src/components/skeleton/Skeleton.tsx +107 -0
  588. package/src/components/skeleton/index.ts +1 -0
  589. package/src/components/split-button/SplitButton.mdx +445 -0
  590. package/src/components/split-button/SplitButton.stories.tsx +465 -0
  591. package/src/components/split-button/SplitButton.tsx +361 -0
  592. package/src/components/split-button/index.ts +7 -0
  593. package/src/components/status-summary-bar/StatusSummaryBar.mdx +338 -0
  594. package/src/components/status-summary-bar/StatusSummaryBar.stories.tsx +408 -0
  595. package/src/components/status-summary-bar/StatusSummaryBar.tsx +428 -0
  596. package/src/components/status-summary-bar/index.ts +8 -0
  597. package/src/components/subject-lookup-field/SubjectLookupField.mdx +378 -0
  598. package/src/components/subject-lookup-field/SubjectLookupField.stories.tsx +393 -0
  599. package/src/components/subject-lookup-field/SubjectLookupField.tsx +1079 -0
  600. package/src/components/subject-lookup-field/index.ts +11 -0
  601. package/src/components/switch/Switch.mdx +376 -0
  602. package/src/components/switch/Switch.stories.tsx +296 -0
  603. package/src/components/switch/Switch.tsx +483 -0
  604. package/src/components/switch/index.ts +1 -0
  605. package/src/components/table/Table.mdx +575 -0
  606. package/src/components/table/Table.stories.tsx +1049 -0
  607. package/src/components/table/Table.tsx +745 -0
  608. package/src/components/table/TableConsumers.stories.tsx +195 -0
  609. package/src/components/table/_tableFixtures.ts +1189 -0
  610. package/src/components/table/index.ts +22 -0
  611. package/src/components/text-field/TextField.mdx +699 -0
  612. package/src/components/text-field/TextField.stories.tsx +674 -0
  613. package/src/components/text-field/TextField.tsx +645 -0
  614. package/src/components/text-field/index.ts +11 -0
  615. package/src/components/text-link/TextLink.mdx +353 -0
  616. package/src/components/text-link/TextLink.stories.tsx +458 -0
  617. package/src/components/text-link/TextLink.tsx +504 -0
  618. package/src/components/text-link/index.ts +10 -0
  619. package/src/components/textarea/Textarea.mdx +244 -0
  620. package/src/components/textarea/Textarea.stories.tsx +371 -0
  621. package/src/components/textarea/Textarea.tsx +489 -0
  622. package/src/components/textarea/index.ts +9 -0
  623. package/src/components/tooltip/Tooltip.mdx +462 -0
  624. package/src/components/tooltip/Tooltip.stories.tsx +500 -0
  625. package/src/components/tooltip/Tooltip.tsx +756 -0
  626. package/src/components/tooltip/index.ts +13 -0
  627. package/src/components/unit-field/UnitField.mdx +215 -0
  628. package/src/components/unit-field/UnitField.stories.tsx +291 -0
  629. package/src/components/unit-field/UnitField.tsx +255 -0
  630. package/src/components/unit-field/index.ts +7 -0
  631. package/src/icons/icon-registry.generated.ts +510 -0
  632. package/src/icons/icon-types.generated.ts +256 -0
  633. package/src/index.ts +70 -0
  634. package/src/internal/BottomSheet.tsx +714 -0
  635. package/src/internal/FodsProvider.tsx +36 -0
  636. package/src/internal/MotionCaret.tsx +53 -0
  637. package/src/internal/NumberFormatInput.tsx +276 -0
  638. package/src/internal/SummaryDonut.tsx +359 -0
  639. package/src/internal/buttonSegment.ts +241 -0
  640. package/src/internal/collapseRoom.ts +130 -0
  641. package/src/internal/comboboxKeys.ts +90 -0
  642. package/src/internal/contentPresence.ts +46 -0
  643. package/src/internal/dayCell.ts +274 -0
  644. package/src/internal/dialogPortal.ts +50 -0
  645. package/src/internal/donutSweeps.ts +77 -0
  646. package/src/internal/enterOnViewGeometry.ts +53 -0
  647. package/src/internal/faqItem.ts +104 -0
  648. package/src/internal/floatingLabelMotion.tsx +109 -0
  649. package/src/internal/formBlockContext.ts +27 -0
  650. package/src/internal/heightRoom.ts +135 -0
  651. package/src/internal/numberSeparators.ts +93 -0
  652. package/src/internal/overlayMotion.tsx +32 -0
  653. package/src/internal/paginationItem.ts +106 -0
  654. package/src/internal/popoverSurface.ts +78 -0
  655. package/src/internal/portalContainer.ts +11 -0
  656. package/src/internal/progressBarItem.ts +356 -0
  657. package/src/internal/selectionControlText.ts +42 -0
  658. package/src/internal/statusSummaryParts.tsx +475 -0
  659. package/src/internal/summaryMotion.ts +111 -0
  660. package/src/internal/table/ChildConnector.tsx +57 -0
  661. package/src/internal/table/ChildRowPrefix.tsx +21 -0
  662. package/src/internal/table/ColumnSettings.tsx +194 -0
  663. package/src/internal/table/ScrollRegion.tsx +176 -0
  664. package/src/internal/table/TableEmpty.tsx +99 -0
  665. package/src/internal/table/TableLayout.tsx +29 -0
  666. package/src/internal/table/TableLoadStatus.tsx +60 -0
  667. package/src/internal/table/TableMobile.tsx +582 -0
  668. package/src/internal/table/TruncatedCell.tsx +35 -0
  669. package/src/internal/table/emptyValue.ts +11 -0
  670. package/src/internal/table/features.ts +44 -0
  671. package/src/internal/table/recipes.ts +263 -0
  672. package/src/internal/table/rowClick.ts +8 -0
  673. package/src/internal/table/types.ts +342 -0
  674. package/src/internal/tailwind-variants.ts +65 -0
  675. package/src/internal/tooltipContext.ts +15 -0
  676. package/src/internal/tw-merge-config.generated.ts +275 -0
  677. package/src/internal/useAnchoredPanel.ts +340 -0
  678. package/src/internal/useCountUp.ts +65 -0
  679. package/src/internal/useDateFieldTrigger.tsx +497 -0
  680. package/src/internal/useEChart.ts +88 -0
  681. package/src/internal/useEnterOnView.ts +80 -0
  682. package/src/internal/useFloatingBar.ts +125 -0
  683. package/src/internal/useFormReset.ts +57 -0
  684. package/src/internal/useIsMobile.ts +64 -0
  685. package/src/internal/useNoImplicitSubmit.ts +41 -0
  686. package/src/internal/useOneRowOverflow.ts +103 -0
  687. package/src/internal/usePrefersReducedMotion.ts +27 -0
  688. package/src/internal/useReturnFocus.ts +34 -0
  689. package/src/internal/utils.ts +58 -0
  690. package/src/recipes/EmptyState.stories.tsx +105 -0
  691. package/src/recipes/Form.stories.tsx +360 -0
  692. package/src/recipes/ModalWithForm.stories.tsx +219 -0
  693. package/src/recipes/Recipes.mdx +61 -0
  694. package/src/recipes/TableWithFilters.stories.tsx +278 -0
  695. package/src/storybook/FodsFamily.tsx +39 -0
  696. package/src/storybook/Section.tsx +36 -0
  697. package/src/storybook/a11y.ts +24 -0
  698. package/src/storybook/assets/banner-character-bartender.webp +0 -0
  699. package/src/storybook/assets/banner-invoice-sheet-left.webp +0 -0
  700. package/src/storybook/assets/banner-invoice-sheet-right.webp +0 -0
  701. package/src/storybook/assets/invoice-hero.webp +0 -0
  702. package/src/storybook/assets/invoice.webp +0 -0
  703. package/src/storybook/assets/section-document-info.svg +21 -0
  704. package/src/storybook/assets/section-gear-checklist.svg +11 -0
  705. package/src/storybook/assets/section-person-arrow-in.svg +15 -0
  706. package/src/storybook/assets/section-person-arrow-out.svg +22 -0
  707. package/src/storybook/assets/section-receipt-dollar.svg +23 -0
  708. package/src/storybook/assets/table-empty-folder-empty.png +0 -0
  709. package/src/storybook/assets/table-empty-folder-magnifying-glass.png +0 -0
  710. package/src/storybook/assets/table-empty-funnel.png +0 -0
  711. package/src/storybook/assets/table-empty-load-failed.png +0 -0
  712. package/src/storybook/assets/wallet-spot.png +0 -0
  713. package/src/storybook/assets.d.ts +17 -0
  714. package/src/storybook/componentDoc.ts +41 -0
  715. package/src/storybook/fitFrame.tsx +70 -0
  716. package/src/storybook/forceStates.tsx +647 -0
  717. package/src/storybook/illustrations.tsx +66 -0
  718. package/src/storybook/viewportFrame.tsx +58 -0
  719. package/src/styles/assets/label-brush-1.svg +6 -0
  720. package/src/styles/assets/pattern-dark.svg +113 -0
  721. package/src/styles/base.css +106 -0
  722. package/src/styles/index.css +15 -0
  723. package/src/styles/motion.css +157 -0
  724. package/src/styles/promo-sticker.css +27 -0
  725. package/src/styles/promo-surface.css +49 -0
  726. package/src/styles/shared.css +11 -0
  727. package/src/styles/theme.generated.css +314 -0
  728. package/src/styles/theme.map.json +278 -0
  729. package/src/styles/tracking.generated.css +12 -0
  730. package/src/tokens/index.ts +4 -0
  731. package/src/tokens/tokens.generated.ts +542 -0
@@ -0,0 +1,504 @@
1
+ "use client";
2
+ import * as React from 'react';
3
+ import { Slot } from '@radix-ui/react-slot';
4
+ // The configured `tv` — its extended tailwind-merge knows that `text-body-*` is a
5
+ // font-size and `text-text-link` a colour, so the two do not annihilate each other
6
+ // (the plain `tailwind-variants` export classifies both as text-colour).
7
+ import { tv, type VariantProps } from '../../internal/tailwind-variants';
8
+ import { Icon, type IconName } from '../icon/Icon';
9
+ import { cn, stripChildClickHandlers, suppressDisabledClick } from '../../internal/utils';
10
+ import { TooltipBodyContext } from '../../internal/tooltipContext';
11
+
12
+ /**
13
+ * TextLink — an inline or standalone text link (ui-system atom, manifest 1.11.0,
14
+ * Figma node 6232-139323). Link-blue text with an optional decorative leading /
15
+ * trailing icon and NO button chrome: it reads as text that happens to be
16
+ * actionable. Distinct from `Button` (an action with chrome) and from the header
17
+ * nav current-page marker (NavLink).
18
+ *
19
+ * Two orthogonal axes (the underline was split out of the semantic axis in
20
+ * manifest 1.6.0):
21
+ *
22
+ * - `variant` carries intent, weight and colour — `default` (inline / in-prose),
23
+ * `strong` (Semibold standalone action links), `quiet` (muted `--text-secondary`,
24
+ * footer link columns);
25
+ * - `underline` carries only the line — `on` (default) is underlined in every
26
+ * state including disabled; `off` is bare at rest/disabled and underlines on
27
+ * hover. Use `off` ONLY where a non-colour affordance sits next to the label
28
+ * (an icon, or list grouping) — WCAG 1.4.1.
29
+ *
30
+ * Token bindings (manifest `families` / `sizes` / `focus`):
31
+ * - default + strong: rest `--text-link`, hover `--text-link-hover`
32
+ * - quiet: rest AND hover `--text-secondary` (the colour deliberately does not
33
+ * change — the hover signal is the underline)
34
+ * - disabled (every variant): `--disabled-foreground`
35
+ * - sizes: xxs `--font-size-xxs` (12) · s `--font-size-sm` (14) · m
36
+ * `--font-size-base` (16); icon↔label gap `--space-200` (4) on all three.
37
+ * `inherit` is the fourth, code-only tier — see note 1.
38
+ * - focus: additive `--outline-focus` ring, `--border-width-200`, stroke OUTSIDE,
39
+ * 3 px offset, radius `--radius-300`, no padding (an inline link must not bloat)
40
+ *
41
+ * Deviations from the manifest that are worth knowing:
42
+ *
43
+ * 1. INHERITANCE — the manifest's inline archetype says an inline link inherits
44
+ * BOTH the surrounding weight and its font-size / line-height (spec «Inline
45
+ * links inherit the surrounding text»). Weight: `default` emits NO font-weight
46
+ * class at all (`--font-weight-normal` on the Default family is only the
47
+ * standalone / Figma-rendering binding); `strong` pins `font-semibold`, `quiet`
48
+ * pins `font-normal` (both are standalone). Size: the three named tiers all
49
+ * emit `text-body-*`, which sets font-size AND line-height, so an inline link
50
+ * would always override the paragraph's rhythm — hence `size="inherit"`, which
51
+ * emits nothing at all. It has no Figma counterpart (Figma cannot express
52
+ * "inherit"); the standalone tiers stay the manifest's XXS / S / M.
53
+ * 2. FOCUS OFFSET — the design system has no 3 px spacing token and Tailwind's
54
+ * `outline-offset-*` scale stops at 2 / 4, so the 3 px offset is written as an
55
+ * arbitrary value. It is a ring geometry constant from the manifest, not a
56
+ * token bypass. Colour and width are both bound: `--outline-focus` through
57
+ * `outline-outline-focus`, and `--border-width-200` through `outline-200`
58
+ * (the config now carries an `outlineWidth` scale keyed on the width tokens,
59
+ * so the ring follows a re-tint instead of sitting on Tailwind's own 2 px).
60
+ * 3. ICON SIZE — width and height of every `.icon` in the link, from the
61
+ * manifest `sizes[].icon` (`[&_.icon]:size-icon-*`, as Button): xxs
62
+ * `--size-icon-2xsmall` (14) · s `--size-icon-xsmall` (16) · m
63
+ * `--size-icon-small` (20). `inherit` has no manifest row and no token: its
64
+ * icon is `1em`, so it follows the paragraph (see the size variant).
65
+ * 4. UNDERLINE SCOPE — the line lives on the LABEL slot, not on the root. The
66
+ * manifest's anatomy makes the icons decorative glyphs sitting beside the
67
+ * label, so underlining the root would drag the line under the icon and the
68
+ * flex gap would break it into disjoint segments at a different offset. The
69
+ * Underline=Off hover line is driven by `group-hover` so it still appears
70
+ * when the pointer rests on the icon.
71
+ *
72
+ * In `asChild` mode there is no label slot — root and label are the SAME
73
+ * element — and neither `slots.label()` nor `group-hover:` survives that
74
+ * collapse: `group-hover:` compiles to `:is(:where(.group):hover *)`, a
75
+ * DESCENDANT selector, so the group element never matches itself. That branch
76
+ * therefore emits its own folded pair (`!underline` / `hover:!underline`)
77
+ * instead of the label slot. The `!` is the same global-anchor workaround as
78
+ * the colours (note 5): an unlayered global `a { text-decoration: none }` in a consuming
79
+ * app beats a plain layered `underline` utility, leaving an `asChild` anchor with no line
80
+ * at all — and Underline=Off's hover line is the WCAG
81
+ * 1.4.1 non-colour signal the whole variant rests on.
82
+ * 5. `!` ON THE COLOURS — a consuming app may carry a global
83
+ * `a { color: var(--text-link) }` (and a `:hover` sibling); the package ships no
84
+ * anchor rule of its own. Such a rule OUTSIDE any `@layer` beats every Tailwind
85
+ * colour utility on an anchor; in `@layer base` with the specificity of a bare `a`,
86
+ * a plain utility wins. The `!` stays for now (it forces only precedence,
87
+ * the values are tokens); dropping it here and in `Button` is a separate cleanup.
88
+ *
89
+ * Semantics / a11y:
90
+ * - with `href` → a real `<a href>`; without `href` (an in-page action) → a
91
+ * `<button type="button">` styled as a link. Never a clickable `<span>`.
92
+ * - `disabled` on an `<a>` has no native equivalent, so the href is dropped and
93
+ * `aria-disabled="true"` + `tabIndex={-1}` are set and clicks are suppressed;
94
+ * on the `<button>` branch the native `disabled` attribute is used as well.
95
+ * Dropping the href also strips the anchor's IMPLICIT `link` role (an `<a>`
96
+ * without href is a generic element), and `aria-disabled` on a generic element
97
+ * announces nothing — so the role is re-stated explicitly while disabled. That
98
+ * is what makes "announced as disabled, skipped when tabbing" actually true.
99
+ * In `asChild` mode the child owns its href and its handlers, so the suppression
100
+ * moves to the CAPTURE phase — `Slot` composes handlers child-first, which puts a
101
+ * bubble-phase guard behind the child's own `onClick` (see `suppressDisabledClick`).
102
+ * For the same reason the child's own click handlers are stripped while disabled
103
+ * (`stripChildClickHandlers`): a child-declared `onClickCapture` would otherwise be
104
+ * composed ahead of the guard and still fire.
105
+ * - `target="_blank"` always ships `rel="noopener"` (plus `noreferrer` when the
106
+ * consumer passes no `rel` of its own) — a security control against reverse
107
+ * tabnabbing. Announcing "opens in a new window" is the LABEL's job (text in
108
+ * the accessible name), never the icon's.
109
+ * - icons are decorative: `Icon` already renders `aria-hidden="true"`.
110
+ */
111
+ const textLinkVariants = tv({
112
+ slots: {
113
+ root: [
114
+ 'group',
115
+ 'font-inter',
116
+ 'cursor-pointer',
117
+ // Motion (manifest 1.13.1 `motion.states`): hover eases the ink and the
118
+ // underline colour over --duration-hover, press over --duration-press, both on
119
+ // --easing-standard. No family has a pressed ink of its own today (inverse shares
120
+ // the hover ink, the light-surface families have no pressed step), so press is
121
+ // wired for the manifest but changes nothing visible.
122
+ // A consumer's global anchor rule in `@layer base` with the specificity of a bare `a`
123
+ // loses to this transition on an `<a>`; the package ships no anchor rule, and a
124
+ // consumer's unlayered `a` transition would win. Never `!` here: a layered
125
+ // `!important` would outrank an unlayered motion freeze in a test harness, which
126
+ // would then measure mid-transition.
127
+ 'transition-[color,text-decoration-color] duration-hover ease-standard active:duration-press',
128
+ 'rounded-300',
129
+ // The line belongs to the label slot, never to the root — see JSDoc note 4.
130
+ 'no-underline',
131
+ // 3 px offset — one step beyond the family's 2 px; text is lighter than a
132
+ // button, so it earns more air. No token exists for 3 px (see JSDoc note 2).
133
+ /* fods-lint-disable-next-line outline-offset — off-grid 3 px focus offset mandated by the manifest (text-link focus.offset); no spacing token exists and Tailwind's outline-offset scale skips 3 */
134
+ 'focus-visible:outline focus-visible:outline-200 focus-visible:outline-outline-focus focus-visible:outline-offset-[3px]',
135
+ ],
136
+ label: '',
137
+ },
138
+ variants: {
139
+ variant: {
140
+ // No font-weight class on purpose — the inline archetype inherits it.
141
+ // The `!` on every colour guards against a consumer's global anchor rule; it is not
142
+ // a token bypass — see JSDoc note 5.
143
+ default: { root: '!text-text-link hover:!text-text-link-hover' },
144
+ strong: { root: 'font-semibold !text-text-link hover:!text-text-link-hover' },
145
+ quiet: { root: 'font-normal !text-text-secondary hover:!text-text-secondary' },
146
+ },
147
+ size: {
148
+ // Icon = manifest sizes[].icon, as width/height on every `.icon` in the link
149
+ // (the glyph TextLink renders from a name and a consumer's element alike).
150
+ xxs: { root: 'text-body-xxs [&_.icon]:size-icon-2xsmall' },
151
+ sm: { root: 'text-body-sm [&_.icon]:size-icon-xsmall' },
152
+ md: { root: 'text-body-base [&_.icon]:size-icon-small' },
153
+ // The inline tier: no font-size and no line-height class, so both come from
154
+ // the surrounding paragraph (see JSDoc note 1). It is code-only (no manifest
155
+ // row), so there is no `sizes[].icon` token to bind: the glyph is sized `1em`
156
+ // to follow the running text it sits in, whatever tier that is. A fixed
157
+ // `--size-icon*` step would be right for one paragraph size and wrong for the
158
+ // rest. This is the one deliberate non-token icon size in the package.
159
+ inherit: { root: '[&_.icon]:size-[1em]' },
160
+ },
161
+ underline: {
162
+ on: { label: 'underline' },
163
+ // The hover line is driven from the root (`group`) so it also appears when
164
+ // the pointer sits on the icon rather than on the label itself.
165
+ off: { label: 'no-underline group-hover:underline' },
166
+ },
167
+ /**
168
+ * With an icon the link becomes a flex row (the gap needs a flex container);
169
+ * without one it stays `inline` so a link inside running prose wraps with the
170
+ * paragraph instead of becoming an unbreakable box.
171
+ */
172
+ hasIcon: {
173
+ // Two different alignments on purpose, and they are not interchangeable:
174
+ //
175
+ // - the LABEL is baseline-aligned (manifest anatomy: "a horizontal row,
176
+ // baseline-aligned"). Because it participates in baseline alignment it
177
+ // also supplies the flex container's own baseline, so no `vertical-align`
178
+ // override is needed and the link sits on the paragraph's baseline — an
179
+ // inline link must not shift the line;
180
+ // - the ICON is centred instead. `.icon` is an inline-block `<svg>` whose
181
+ // glyph is drawn in the middle of its box while the box's baseline is
182
+ // its bottom edge. Baseline-aligning that box therefore lifts
183
+ // the glyph visibly above the text. Centring it on the line box is what
184
+ // actually reads as baseline-aligned to the eye.
185
+ //
186
+ // The centring targets every direct child except the label, not `.icon`: an
187
+ // icon slot may be a rendered element (`<MotionCaret>` — an inline-flex span
188
+ // around the svg), and then that wrapper is the flex item, so `self-center`
189
+ // on the nested svg would centre nothing.
190
+ true: { root: 'inline-flex items-baseline gap-200 [&>:not([data-fods-part=label])]:self-center' },
191
+ false: { root: 'inline' },
192
+ },
193
+ /**
194
+ * Declared last so tailwind-merge drops the family colour in favour of the
195
+ * disabled ink; the `!` on top is the global-anchor workaround from note 5,
196
+ * without which a consumer's unlayered global anchor rule repaints a disabled link in link-blue.
197
+ *
198
+ * The rest underline is deliberately left alone: Underline=On stays underlined
199
+ * when disabled (manifest `families`), and Underline=Off cannot gain the hover
200
+ * line because the root takes no pointer events. No `cursor-not-allowed` — it
201
+ * would sit on the very element that just turned off pointer events, so it
202
+ * could never render.
203
+ */
204
+ disabled: {
205
+ true: {
206
+ root: ['pointer-events-none', '!text-disabled-foreground hover:!text-disabled-foreground'],
207
+ },
208
+ false: {},
209
+ },
210
+ /**
211
+ * The ground the link is composed on (`axes.surface`, full matrix x2). This is a
212
+ * CONTAINER-DRIVEN swap, not a new resting-colour axis of the atom: the dark
213
+ * container picks the value, and the whole ink + ring package travels with it
214
+ * (`spec/06-patterns/inverse-surface.md`).
215
+ *
216
+ * `inverse` renders ONE ladder for all three families — the family keeps only its
217
+ * weight and decoration mechanics. Rest is the QUIET step, `--text-inverted-secondary`
218
+ * (blue/200, 7.10:1), deliberately not white: the copy around a bar link is already
219
+ * `--text-inverted`, and a white link would hang on the underline alone. Interaction
220
+ * brightens to `--text-inverted` (9.43:1), the mirror of a light-surface link
221
+ * darkening toward `--text-primary`. Hover and pressed share it — 1.11.0 dropped the
222
+ * `color-mix` midpoint the older `delivery.inverseLink` described, because Figma could
223
+ * not render it without binding a Layer-1 primitive.
224
+ *
225
+ * SCOPE — `--bg-inverse` ONLY. On a `--secondary-solid` panel (Promo Surface
226
+ * Solid/Inverse) the same ladder measures 4.45 / 3.86 / 3.35 and fails AA for normal
227
+ * text, so no quiet text action goes on that fill at all: compose the one filled
228
+ * `Brand` CTA instead.
229
+ *
230
+ * The focus ring swaps with it. `--outline-focus` is 2.12:1 on `--bg-inverse`, under
231
+ * the 3:1 non-text floor; `--outline-focus-inverse` is 9.43:1. Mandatory, not cosmetic.
232
+ */
233
+ surface: {
234
+ default: {},
235
+ inverse: {
236
+ root: [
237
+ '!text-text-inverted-secondary hover:!text-text-inverted',
238
+ 'focus-visible:outline-outline-focus-inverse',
239
+ ],
240
+ },
241
+ },
242
+ },
243
+ compoundVariants: [
244
+ /*
245
+ * Disabled on inverse. `--disabled-foreground` is a light-surface ink and disappears
246
+ * on a dark ground, so the pattern dims the resting ink instead: "--text-inverted-
247
+ * secondary at 50% opacity" — exempt from contrast by WCAG 1.4.3. Declared after both
248
+ * variants so tailwind-merge keeps this colour over each of them.
249
+ */
250
+ {
251
+ surface: 'inverse',
252
+ disabled: true,
253
+ // Slot-scoped: with `slots`, a bare `class` on a compoundVariant does not land on
254
+ // the root, so the ink would silently stay at the resting inverse step.
255
+ class: {
256
+ root: '!text-text-inverted-secondary/50 hover:!text-text-inverted-secondary/50',
257
+ },
258
+ },
259
+ ],
260
+ defaultVariants: {
261
+ variant: 'default',
262
+ size: 'md',
263
+ underline: 'on',
264
+ hasIcon: false,
265
+ disabled: false,
266
+ surface: 'default',
267
+ },
268
+ });
269
+
270
+ export type TextLinkVariant = 'default' | 'strong' | 'quiet';
271
+ export type TextLinkSize = 'xxs' | 'sm' | 'md' | 'inherit';
272
+ export type TextLinkUnderline = 'on' | 'off';
273
+ export type TextLinkSurface = 'default' | 'inverse';
274
+ export type TextLinkElement = HTMLAnchorElement | HTMLButtonElement;
275
+
276
+ export interface TextLinkProps
277
+ extends Omit<React.AnchorHTMLAttributes<HTMLAnchorElement>, 'children'>,
278
+ Omit<VariantProps<typeof textLinkVariants>, 'hasIcon' | 'disabled'> {
279
+ /** Intent family — weight + colour. */
280
+ variant?: TextLinkVariant;
281
+ /**
282
+ * Standalone tiers 12 / 14 / 16. Use `inherit` for an INLINE link: it emits no
283
+ * font-size and no line-height, so both come from the surrounding paragraph and
284
+ * the link never shifts the line.
285
+ */
286
+ size?: TextLinkSize;
287
+ /** `on` (default) = underlined in every state; `off` = bare at rest, underlines on hover. */
288
+ underline?: TextLinkUnderline;
289
+ /**
290
+ * The ground this link is composed on. `inverse` is for `--bg-inverse` chrome ONLY —
291
+ * an announcement bar, dark page chrome — where the container swaps the whole ink and
292
+ * ring package (`spec/06-patterns/inverse-surface.md`). Not for a `--secondary-solid`
293
+ * panel: the ladder fails AA there, so that fill takes a filled `Brand` CTA and no
294
+ * quiet text action at all.
295
+ *
296
+ * Keep `underline="on"` (the default) on inverse — the line is the non-colour cue
297
+ * (WCAG 1.4.1), and use `variant="strong"` for a bar CTA.
298
+ */
299
+ surface?: TextLinkSurface;
300
+ /** Navigation target. Omit for an in-page action — the component then renders a `<button>`. */
301
+ href?: string;
302
+ /**
303
+ * Decorative glyph before the label — an icon name, or a rendered element (e.g. a
304
+ * turning caret). TextLink sizes it and colours it with `currentColor`.
305
+ */
306
+ leadingIcon?: IconName | React.ReactElement;
307
+ /**
308
+ * Decorative glyph after the label — an icon name, or a rendered element (e.g. a
309
+ * turning caret). TextLink sizes it and colours it with `currentColor`.
310
+ */
311
+ trailingIcon?: IconName | React.ReactElement;
312
+ /** Not actionable: `--disabled-foreground`, no href, `aria-disabled`, out of the tab order. */
313
+ disabled?: boolean;
314
+ /**
315
+ * Render as a Radix `Slot`, merging props onto the single child element
316
+ * (e.g. a React Router `<Link>`). The consumer owns the children, so icons are
317
+ * composed by hand and `href` on this component is ignored — the child carries
318
+ * its own `href` / `to`.
319
+ *
320
+ * `disabled` here cannot remove the child's href, so the link stays copyable and
321
+ * middle-clickable; what it does do is the disabled visual, `aria-disabled`,
322
+ * `tabIndex={-1}` and CAPTURE-phase click suppression (which also covers keyboard
323
+ * Enter, since that fires a click, and the child's OWN `onClick` / `onClickCapture`,
324
+ * which are stripped from the clone — `Slot` composes handlers child-first, so both a
325
+ * bubble-phase guard and a merged capture handler would arrive too late).
326
+ */
327
+ asChild?: boolean;
328
+ /** Visible label = the accessible name. Never icon-only. */
329
+ children: React.ReactNode;
330
+ }
331
+
332
+ /** A name is a glyph from the registry; an element is rendered as given. */
333
+ function renderIcon(icon: IconName | React.ReactElement): React.ReactNode {
334
+ return typeof icon === 'string' ? <Icon name={icon} /> : icon;
335
+ }
336
+
337
+ /**
338
+ * `target="_blank"` must not leave the new tab with a handle on `window.opener`.
339
+ * A consumer-supplied `rel` is respected and only topped up with `noopener`;
340
+ * with no `rel` at all we ship the full `noopener noreferrer`.
341
+ */
342
+ function resolveRel(target: string | undefined, rel: string | undefined): string | undefined {
343
+ if (target !== '_blank') return rel;
344
+ if (rel == null) return 'noopener noreferrer';
345
+
346
+ const tokens = rel.split(/\s+/).filter(Boolean);
347
+ if (!tokens.includes('noopener')) tokens.push('noopener');
348
+ return tokens.join(' ');
349
+ }
350
+
351
+ const TextLink = React.forwardRef<TextLinkElement, TextLinkProps>(
352
+ (
353
+ {
354
+ className,
355
+ variant = 'default',
356
+ size = 'md',
357
+ underline = 'on',
358
+ surface = 'default',
359
+ href,
360
+ target,
361
+ rel,
362
+ leadingIcon,
363
+ trailingIcon,
364
+ disabled = false,
365
+ asChild = false,
366
+ onClick,
367
+ children,
368
+ ...restProps
369
+ },
370
+ ref,
371
+ ) => {
372
+ // Inside a toggletip bubble the link is described by the bubble's body text and
373
+ // closes the bubble once activated (Tooltip 1.3.0).
374
+ const tooltipBody = React.useContext(TooltipBodyContext);
375
+ const props =
376
+ tooltipBody == null
377
+ ? restProps
378
+ : {
379
+ ...restProps,
380
+ 'aria-describedby': restProps['aria-describedby'] ?? tooltipBody.bodyId,
381
+ };
382
+ const hasIcon = leadingIcon != null || trailingIcon != null;
383
+ const slots = textLinkVariants({ variant, size, underline, surface, hasIcon, disabled });
384
+ const classes = cn(slots.root(), className);
385
+
386
+ const handleClick = (event: React.MouseEvent<TextLinkElement>) => {
387
+ if (disabled) {
388
+ event.preventDefault();
389
+ return;
390
+ }
391
+ onClick?.(event as React.MouseEvent<HTMLAnchorElement>);
392
+ tooltipBody?.close();
393
+ };
394
+
395
+ if (asChild) {
396
+ // Built as an object: `Slot`'s props type is element-agnostic, so anchor-only
397
+ // attributes (target / rel) cannot be written as JSX attributes on it.
398
+ //
399
+ // Root and label collapse onto one element here, which neither `slots.label()`
400
+ // nor `group-hover:` survives — hence the folded pair, and the `!` against an
401
+ // unlayered global anchor rule. See JSDoc note 4.
402
+ const foldedUnderline = underline === 'on' ? '!underline' : 'no-underline hover:!underline';
403
+ const slotProps = {
404
+ // Root and label are the same element in this branch, so it carries the root
405
+ // part only. Before the spread,
406
+ // like the two element branches below — a host that composes TextLink into a
407
+ // larger part has to be able to re-label it.
408
+ 'data-fods-component': 'text-link',
409
+ 'data-fods-part': 'root',
410
+ ...props,
411
+ className: cn(slots.root(), foldedUnderline, className),
412
+ 'aria-disabled': disabled || undefined,
413
+ // The child owns its href, so `disabled` cannot strip it — suppressing the
414
+ // click is what keeps a disabled link inoperable, keyboard Enter included.
415
+ tabIndex: disabled ? -1 : props.tabIndex,
416
+ // The suppression has to run in the CAPTURE phase: `Slot` composes handlers
417
+ // child-first, so a bubble-phase guard would only fire after the child's own
418
+ // `onClick` had already navigated (see `suppressDisabledClick`). Our own
419
+ // `onClick` is dropped while disabled — there is nothing left for it to do.
420
+ // A child that declares `onClickCapture` ITSELF would be composed child-first
421
+ // as well, so the children go through `stripChildClickHandlers` below.
422
+ ...(disabled
423
+ ? { onClick: undefined, onClickCapture: suppressDisabledClick }
424
+ : { onClick: handleClick }),
425
+ target,
426
+ rel: resolveRel(target, rel),
427
+ };
428
+
429
+ return (
430
+ <Slot ref={ref as React.Ref<HTMLElement>} {...slotProps}>
431
+ {disabled ? stripChildClickHandlers(children) : children}
432
+ </Slot>
433
+ );
434
+ }
435
+
436
+ const content = (
437
+ <>
438
+ {leadingIcon != null && renderIcon(leadingIcon)}
439
+ {/* The label carries the underline; the decorative icons stay bare. */}
440
+ <span data-fods-part="label" className={slots.label()}>
441
+ {children}
442
+ </span>
443
+ {trailingIcon != null && renderIcon(trailingIcon)}
444
+ </>
445
+ );
446
+
447
+ // In-page action — a <button> styled as a link, never a clickable <span>.
448
+ // `{...props}` deliberately goes FIRST in both branches: `type`, `disabled`,
449
+ // `rel` and the click suppression are load-bearing contracts, not defaults a
450
+ // consumer should be able to shadow. (Button / DropdownButton spread last.)
451
+ //
452
+ // That rule is about BEHAVIOURAL props only. The `data-fods-*` markers are
453
+ // metadata for the verifier, not behaviour, and they sit BEFORE the spread on
454
+ // purpose: a host that composes TextLink into a larger part (ActionRow) has to
455
+ // be able to re-label the element as its own part, or the runtime sweep grades
456
+ // the host's node against text-link's expectations. Overriding them changes
457
+ // nothing a user can see.
458
+ if (href == null) {
459
+ const buttonProps = props as unknown as React.ButtonHTMLAttributes<HTMLButtonElement>;
460
+ return (
461
+ <button
462
+ ref={ref as React.Ref<HTMLButtonElement>}
463
+ // data-fods-part marks the component's parts for measurement in the
464
+ // browser. Not inert in this package: `styles/base.css` scopes its reset to these attributes.
465
+ data-fods-component="text-link"
466
+ data-fods-part="root"
467
+ {...buttonProps}
468
+ type="button"
469
+ disabled={disabled}
470
+ aria-disabled={disabled || undefined}
471
+ onClick={handleClick}
472
+ className={classes}
473
+ >
474
+ {content}
475
+ </button>
476
+ );
477
+ }
478
+
479
+ return (
480
+ <a
481
+ ref={ref as React.Ref<HTMLAnchorElement>}
482
+ data-fods-component="text-link"
483
+ data-fods-part="root"
484
+ {...props}
485
+ href={disabled ? undefined : href}
486
+ target={target}
487
+ rel={resolveRel(target, rel)}
488
+ // Without an href the anchor is a generic element, and `aria-disabled` on a
489
+ // generic element announces nothing — so the role is re-stated while
490
+ // disabled to keep the state reaching assistive tech.
491
+ role={disabled ? 'link' : undefined}
492
+ aria-disabled={disabled || undefined}
493
+ tabIndex={disabled ? -1 : props.tabIndex}
494
+ onClick={handleClick}
495
+ className={classes}
496
+ >
497
+ {content}
498
+ </a>
499
+ );
500
+ },
501
+ );
502
+ TextLink.displayName = 'TextLink';
503
+
504
+ export { TextLink, textLinkVariants };
@@ -0,0 +1,10 @@
1
+ export {
2
+ TextLink,
3
+ textLinkVariants,
4
+ type TextLinkProps,
5
+ type TextLinkVariant,
6
+ type TextLinkSize,
7
+ type TextLinkUnderline,
8
+ type TextLinkSurface,
9
+ type TextLinkElement,
10
+ } from './TextLink';