@invoiceonline/ui-react 0.0.0 → 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (738) hide show
  1. package/AGENTS.md +99 -0
  2. package/CHANGELOG.md +131 -0
  3. package/LICENSE +9 -0
  4. package/README.md +77 -1
  5. package/dist/assets/label-brush-1.svg +6 -0
  6. package/dist/assets/pattern-dark.svg +113 -0
  7. package/dist/components/action-row/ActionRow.d.ts +178 -0
  8. package/dist/components/action-row/ActionRow.js +340 -0
  9. package/dist/components/action-row/index.d.ts +2 -0
  10. package/dist/components/action-row/index.js +1 -0
  11. package/dist/components/alert/Alert.d.ts +314 -0
  12. package/dist/components/alert/Alert.js +446 -0
  13. package/dist/components/alert/index.d.ts +2 -0
  14. package/dist/components/alert/index.js +1 -0
  15. package/dist/components/anchored-panel/AnchoredPanel.d.ts +41 -0
  16. package/dist/components/anchored-panel/AnchoredPanel.js +72 -0
  17. package/dist/components/anchored-panel/index.d.ts +3 -0
  18. package/dist/components/anchored-panel/index.js +3 -0
  19. package/dist/components/badge/Badge.d.ts +146 -0
  20. package/dist/components/badge/Badge.js +258 -0
  21. package/dist/components/badge/index.d.ts +2 -0
  22. package/dist/components/badge/index.js +1 -0
  23. package/dist/components/banner/Banner.d.ts +209 -0
  24. package/dist/components/banner/Banner.js +339 -0
  25. package/dist/components/banner/index.d.ts +2 -0
  26. package/dist/components/banner/index.js +1 -0
  27. package/dist/components/button/Button.d.ts +54 -0
  28. package/dist/components/button/Button.js +312 -0
  29. package/dist/components/button/index.d.ts +2 -0
  30. package/dist/components/button/index.js +1 -0
  31. package/dist/components/button-group/ButtonGroup.d.ts +187 -0
  32. package/dist/components/button-group/ButtonGroup.js +217 -0
  33. package/dist/components/button-group/index.d.ts +2 -0
  34. package/dist/components/button-group/index.js +1 -0
  35. package/dist/components/card-select/CardSelect.d.ts +274 -0
  36. package/dist/components/card-select/CardSelect.js +561 -0
  37. package/dist/components/card-select/CardSelectGroup.d.ts +92 -0
  38. package/dist/components/card-select/CardSelectGroup.js +72 -0
  39. package/dist/components/card-select/index.d.ts +3 -0
  40. package/dist/components/card-select/index.js +3 -0
  41. package/dist/components/checkbox/Checkbox.d.ts +104 -0
  42. package/dist/components/checkbox/Checkbox.js +194 -0
  43. package/dist/components/checkbox/index.d.ts +2 -0
  44. package/dist/components/checkbox/index.js +1 -0
  45. package/dist/components/chip/Chip.d.ts +250 -0
  46. package/dist/components/chip/Chip.js +441 -0
  47. package/dist/components/chip/index.d.ts +2 -0
  48. package/dist/components/chip/index.js +1 -0
  49. package/dist/components/column-header/ColumnHeader.d.ts +144 -0
  50. package/dist/components/column-header/ColumnHeader.js +209 -0
  51. package/dist/components/column-header/index.d.ts +2 -0
  52. package/dist/components/column-header/index.js +1 -0
  53. package/dist/components/combobox-field/Combobox.d.ts +104 -0
  54. package/dist/components/combobox-field/Combobox.js +355 -0
  55. package/dist/components/combobox-field/ComboboxField.d.ts +76 -0
  56. package/dist/components/combobox-field/ComboboxField.js +98 -0
  57. package/dist/components/combobox-field/index.d.ts +3 -0
  58. package/dist/components/combobox-field/index.js +3 -0
  59. package/dist/components/date-field/DateField.d.ts +52 -0
  60. package/dist/components/date-field/DateField.js +45 -0
  61. package/dist/components/date-field/index.d.ts +2 -0
  62. package/dist/components/date-field/index.js +1 -0
  63. package/dist/components/date-picker/DatePicker.d.ts +53 -0
  64. package/dist/components/date-picker/DatePicker.js +329 -0
  65. package/dist/components/date-picker/index.d.ts +2 -0
  66. package/dist/components/date-picker/index.js +1 -0
  67. package/dist/components/divider/Divider.d.ts +81 -0
  68. package/dist/components/divider/Divider.js +93 -0
  69. package/dist/components/divider/index.d.ts +2 -0
  70. package/dist/components/divider/index.js +1 -0
  71. package/dist/components/drawer/Drawer.d.ts +128 -0
  72. package/dist/components/drawer/Drawer.js +367 -0
  73. package/dist/components/drawer/index.d.ts +2 -0
  74. package/dist/components/drawer/index.js +1 -0
  75. package/dist/components/dropdown-button/DropdownButton.d.ts +72 -0
  76. package/dist/components/dropdown-button/DropdownButton.js +122 -0
  77. package/dist/components/dropdown-button/index.d.ts +2 -0
  78. package/dist/components/dropdown-button/index.js +1 -0
  79. package/dist/components/faq/FAQ.d.ts +135 -0
  80. package/dist/components/faq/FAQ.js +258 -0
  81. package/dist/components/faq/index.d.ts +2 -0
  82. package/dist/components/faq/index.js +1 -0
  83. package/dist/components/field/Field.d.ts +118 -0
  84. package/dist/components/field/Field.js +327 -0
  85. package/dist/components/field/index.d.ts +2 -0
  86. package/dist/components/field/index.js +1 -0
  87. package/dist/components/field-pair/FieldPair.d.ts +194 -0
  88. package/dist/components/field-pair/FieldPair.js +321 -0
  89. package/dist/components/field-pair/index.d.ts +2 -0
  90. package/dist/components/field-pair/index.js +1 -0
  91. package/dist/components/file-upload/FileUpload.d.ts +137 -0
  92. package/dist/components/file-upload/FileUpload.js +434 -0
  93. package/dist/components/file-upload/index.d.ts +2 -0
  94. package/dist/components/file-upload/index.js +1 -0
  95. package/dist/components/filter-chip/FilterChip.d.ts +373 -0
  96. package/dist/components/filter-chip/FilterChip.js +517 -0
  97. package/dist/components/filter-chip/index.d.ts +2 -0
  98. package/dist/components/filter-chip/index.js +1 -0
  99. package/dist/components/filter-facet/FilterFacet.d.ts +116 -0
  100. package/dist/components/filter-facet/FilterFacet.js +632 -0
  101. package/dist/components/filter-facet/index.d.ts +2 -0
  102. package/dist/components/filter-facet/index.js +1 -0
  103. package/dist/components/firm-avatar/FirmAvatar.d.ts +75 -0
  104. package/dist/components/firm-avatar/FirmAvatar.js +119 -0
  105. package/dist/components/firm-avatar/index.d.ts +2 -0
  106. package/dist/components/firm-avatar/index.js +1 -0
  107. package/dist/components/form-actions/FormActions.d.ts +123 -0
  108. package/dist/components/form-actions/FormActions.js +195 -0
  109. package/dist/components/form-actions/index.d.ts +2 -0
  110. package/dist/components/form-actions/index.js +1 -0
  111. package/dist/components/form-block/FormBlock.d.ts +252 -0
  112. package/dist/components/form-block/FormBlock.js +420 -0
  113. package/dist/components/form-block/index.d.ts +3 -0
  114. package/dist/components/form-block/index.js +3 -0
  115. package/dist/components/form-section/FormSection.d.ts +130 -0
  116. package/dist/components/form-section/FormSection.js +206 -0
  117. package/dist/components/form-section/index.d.ts +2 -0
  118. package/dist/components/form-section/index.js +1 -0
  119. package/dist/components/heading/Heading.d.ts +69 -0
  120. package/dist/components/heading/Heading.js +79 -0
  121. package/dist/components/heading/index.d.ts +2 -0
  122. package/dist/components/heading/index.js +1 -0
  123. package/dist/components/heading-group/HeadingGroup.d.ts +258 -0
  124. package/dist/components/heading-group/HeadingGroup.js +255 -0
  125. package/dist/components/heading-group/index.d.ts +2 -0
  126. package/dist/components/heading-group/index.js +1 -0
  127. package/dist/components/hero/Hero.d.ts +268 -0
  128. package/dist/components/hero/Hero.js +316 -0
  129. package/dist/components/hero/index.d.ts +2 -0
  130. package/dist/components/hero/index.js +1 -0
  131. package/dist/components/icon/Icon.d.ts +27 -0
  132. package/dist/components/icon/Icon.js +30 -0
  133. package/dist/components/icon/index.d.ts +3 -0
  134. package/dist/components/icon/index.js +3 -0
  135. package/dist/components/icon-button/IconButton.d.ts +75 -0
  136. package/dist/components/icon-button/IconButton.js +151 -0
  137. package/dist/components/icon-button/index.d.ts +2 -0
  138. package/dist/components/icon-button/index.js +1 -0
  139. package/dist/components/item-row/ItemRow.d.ts +253 -0
  140. package/dist/components/item-row/ItemRow.js +496 -0
  141. package/dist/components/item-row/index.d.ts +2 -0
  142. package/dist/components/item-row/index.js +1 -0
  143. package/dist/components/list-row/ListRow.d.ts +165 -0
  144. package/dist/components/list-row/ListRow.js +233 -0
  145. package/dist/components/list-row/index.d.ts +2 -0
  146. package/dist/components/list-row/index.js +1 -0
  147. package/dist/components/menu/Menu.d.ts +64 -0
  148. package/dist/components/menu/Menu.js +186 -0
  149. package/dist/components/menu/index.d.ts +2 -0
  150. package/dist/components/menu/index.js +1 -0
  151. package/dist/components/modal/Modal.d.ts +272 -0
  152. package/dist/components/modal/Modal.js +788 -0
  153. package/dist/components/modal/index.d.ts +2 -0
  154. package/dist/components/modal/index.js +1 -0
  155. package/dist/components/nav-link/NavLink.d.ts +123 -0
  156. package/dist/components/nav-link/NavLink.js +157 -0
  157. package/dist/components/nav-link/index.d.ts +2 -0
  158. package/dist/components/nav-link/index.js +1 -0
  159. package/dist/components/number-field/NumberField.d.ts +62 -0
  160. package/dist/components/number-field/NumberField.js +210 -0
  161. package/dist/components/number-field/index.d.ts +2 -0
  162. package/dist/components/number-field/index.js +1 -0
  163. package/dist/components/pagination/Pagination.d.ts +133 -0
  164. package/dist/components/pagination/Pagination.js +217 -0
  165. package/dist/components/pagination/index.d.ts +3 -0
  166. package/dist/components/pagination/index.js +3 -0
  167. package/dist/components/popover-surface/index.d.ts +2 -0
  168. package/dist/components/popover-surface/index.js +1 -0
  169. package/dist/components/progress-bar/ProgressBar.d.ts +260 -0
  170. package/dist/components/progress-bar/ProgressBar.js +470 -0
  171. package/dist/components/progress-bar/index.d.ts +2 -0
  172. package/dist/components/progress-bar/index.js +1 -0
  173. package/dist/components/promo-sticker/PromoSticker.d.ts +204 -0
  174. package/dist/components/promo-sticker/PromoSticker.js +177 -0
  175. package/dist/components/promo-sticker/index.d.ts +2 -0
  176. package/dist/components/promo-sticker/index.js +1 -0
  177. package/dist/components/promo-surface/PromoSurface.d.ts +94 -0
  178. package/dist/components/promo-surface/PromoSurface.js +119 -0
  179. package/dist/components/promo-surface/index.d.ts +2 -0
  180. package/dist/components/promo-surface/index.js +1 -0
  181. package/dist/components/radio/Radio.d.ts +92 -0
  182. package/dist/components/radio/Radio.js +171 -0
  183. package/dist/components/radio/index.d.ts +2 -0
  184. package/dist/components/radio/index.js +1 -0
  185. package/dist/components/radio-group/RadioGroup.d.ts +61 -0
  186. package/dist/components/radio-group/RadioGroup.js +51 -0
  187. package/dist/components/radio-group/index.d.ts +2 -0
  188. package/dist/components/radio-group/index.js +1 -0
  189. package/dist/components/select/Select.d.ts +65 -0
  190. package/dist/components/select/Select.js +176 -0
  191. package/dist/components/select/index.d.ts +2 -0
  192. package/dist/components/select/index.js +1 -0
  193. package/dist/components/select-field/SelectField.d.ts +16 -0
  194. package/dist/components/select-field/SelectField.js +55 -0
  195. package/dist/components/select-field/index.d.ts +2 -0
  196. package/dist/components/select-field/index.js +1 -0
  197. package/dist/components/skeleton/Skeleton.d.ts +64 -0
  198. package/dist/components/skeleton/Skeleton.js +65 -0
  199. package/dist/components/skeleton/index.d.ts +2 -0
  200. package/dist/components/skeleton/index.js +1 -0
  201. package/dist/components/split-button/SplitButton.d.ts +80 -0
  202. package/dist/components/split-button/SplitButton.js +182 -0
  203. package/dist/components/split-button/index.d.ts +2 -0
  204. package/dist/components/split-button/index.js +1 -0
  205. package/dist/components/status-summary-bar/StatusSummaryBar.d.ts +118 -0
  206. package/dist/components/status-summary-bar/StatusSummaryBar.js +278 -0
  207. package/dist/components/status-summary-bar/index.d.ts +2 -0
  208. package/dist/components/status-summary-bar/index.js +1 -0
  209. package/dist/components/subject-lookup-field/SubjectLookupField.d.ts +157 -0
  210. package/dist/components/subject-lookup-field/SubjectLookupField.js +663 -0
  211. package/dist/components/subject-lookup-field/index.d.ts +2 -0
  212. package/dist/components/subject-lookup-field/index.js +1 -0
  213. package/dist/components/switch/Switch.d.ts +152 -0
  214. package/dist/components/switch/Switch.js +307 -0
  215. package/dist/components/switch/index.d.ts +2 -0
  216. package/dist/components/switch/index.js +1 -0
  217. package/dist/components/table/Table.d.ts +5 -0
  218. package/dist/components/table/Table.js +601 -0
  219. package/dist/components/table/index.d.ts +6 -0
  220. package/dist/components/table/index.js +6 -0
  221. package/dist/components/text-field/TextField.d.ts +65 -0
  222. package/dist/components/text-field/TextField.js +173 -0
  223. package/dist/components/text-field/index.d.ts +2 -0
  224. package/dist/components/text-field/index.js +1 -0
  225. package/dist/components/text-link/TextLink.d.ts +260 -0
  226. package/dist/components/text-link/TextLink.js +303 -0
  227. package/dist/components/text-link/index.d.ts +2 -0
  228. package/dist/components/text-link/index.js +1 -0
  229. package/dist/components/textarea/Textarea.d.ts +93 -0
  230. package/dist/components/textarea/Textarea.js +256 -0
  231. package/dist/components/textarea/index.d.ts +2 -0
  232. package/dist/components/textarea/index.js +1 -0
  233. package/dist/components/tooltip/Tooltip.d.ts +129 -0
  234. package/dist/components/tooltip/Tooltip.js +457 -0
  235. package/dist/components/tooltip/index.d.ts +2 -0
  236. package/dist/components/tooltip/index.js +1 -0
  237. package/dist/components/unit-field/UnitField.d.ts +46 -0
  238. package/dist/components/unit-field/UnitField.js +133 -0
  239. package/dist/components/unit-field/index.d.ts +2 -0
  240. package/dist/components/unit-field/index.js +1 -0
  241. package/dist/icons/icon-registry.generated.js +500 -0
  242. package/dist/icons/icon-types.generated.d.ts +2 -0
  243. package/dist/icons/icon-types.generated.js +126 -0
  244. package/dist/index.d.ts +132 -0
  245. package/dist/index.js +75 -0
  246. package/dist/internal/BottomSheet.js +496 -0
  247. package/dist/internal/FodsProvider.d.ts +25 -0
  248. package/dist/internal/FodsProvider.js +32 -0
  249. package/dist/internal/MotionCaret.js +35 -0
  250. package/dist/internal/NumberFormatInput.d.ts +21 -0
  251. package/dist/internal/NumberFormatInput.js +126 -0
  252. package/dist/internal/SummaryDonut.d.ts +3 -0
  253. package/dist/internal/SummaryDonut.js +300 -0
  254. package/dist/internal/buttonSegment.d.ts +44 -0
  255. package/dist/internal/buttonSegment.js +126 -0
  256. package/dist/internal/collapseRoom.js +128 -0
  257. package/dist/internal/comboboxKeys.js +44 -0
  258. package/dist/internal/contentPresence.js +46 -0
  259. package/dist/internal/dayCell.js +95 -0
  260. package/dist/internal/dialogPortal.d.ts +2 -0
  261. package/dist/internal/dialogPortal.js +21 -0
  262. package/dist/internal/donutSweeps.js +65 -0
  263. package/dist/internal/enterOnViewGeometry.js +46 -0
  264. package/dist/internal/faqItem.js +80 -0
  265. package/dist/internal/floatingLabelMotion.js +68 -0
  266. package/dist/internal/formBlockContext.d.ts +22 -0
  267. package/dist/internal/formBlockContext.js +20 -0
  268. package/dist/internal/heightRoom.js +87 -0
  269. package/dist/internal/numberSeparators.js +62 -0
  270. package/dist/internal/overlayMotion.js +48 -0
  271. package/dist/internal/paginationItem.d.ts +8 -0
  272. package/dist/internal/paginationItem.js +22 -0
  273. package/dist/internal/popoverSurface.d.ts +8 -0
  274. package/dist/internal/popoverSurface.js +23 -0
  275. package/dist/internal/portalContainer.d.ts +1 -0
  276. package/dist/internal/portalContainer.js +6 -0
  277. package/dist/internal/progressBarItem.d.ts +207 -0
  278. package/dist/internal/progressBarItem.js +264 -0
  279. package/dist/internal/selectionControlText.js +12 -0
  280. package/dist/internal/statusSummaryParts.js +371 -0
  281. package/dist/internal/summaryMotion.js +75 -0
  282. package/dist/internal/table/ChildConnector.js +62 -0
  283. package/dist/internal/table/ChildRowPrefix.d.ts +9 -0
  284. package/dist/internal/table/ChildRowPrefix.js +27 -0
  285. package/dist/internal/table/ColumnSettings.js +135 -0
  286. package/dist/internal/table/ScrollRegion.js +114 -0
  287. package/dist/internal/table/TableEmpty.js +93 -0
  288. package/dist/internal/table/TableLayout.d.ts +17 -0
  289. package/dist/internal/table/TableLayout.js +29 -0
  290. package/dist/internal/table/TableLoadStatus.js +56 -0
  291. package/dist/internal/table/TableMobile.js +488 -0
  292. package/dist/internal/table/TruncatedCell.js +33 -0
  293. package/dist/internal/table/emptyValue.js +10 -0
  294. package/dist/internal/table/features.d.ts +41 -0
  295. package/dist/internal/table/features.js +31 -0
  296. package/dist/internal/table/recipes.js +227 -0
  297. package/dist/internal/table/rowClick.js +9 -0
  298. package/dist/internal/table/types.d.ts +325 -0
  299. package/dist/internal/table/types.js +13 -0
  300. package/dist/internal/tailwind-variants.d.ts +3 -0
  301. package/dist/internal/tailwind-variants.js +37 -0
  302. package/dist/internal/tooltipContext.js +5 -0
  303. package/dist/internal/tw-merge-config.generated.js +314 -0
  304. package/dist/internal/useAnchoredPanel.d.ts +87 -0
  305. package/dist/internal/useAnchoredPanel.js +108 -0
  306. package/dist/internal/useCountUp.js +53 -0
  307. package/dist/internal/useDateFieldTrigger.js +183 -0
  308. package/dist/internal/useEChart.js +59 -0
  309. package/dist/internal/useEnterOnView.js +42 -0
  310. package/dist/internal/useFloatingBar.js +100 -0
  311. package/dist/internal/useFormReset.js +37 -0
  312. package/dist/internal/useIsMobile.js +44 -0
  313. package/dist/internal/useOneRowOverflow.js +88 -0
  314. package/dist/internal/usePrefersReducedMotion.js +25 -0
  315. package/dist/internal/useReturnFocus.js +26 -0
  316. package/dist/internal/utils.d.ts +7 -0
  317. package/dist/internal/utils.js +58 -0
  318. package/dist/node_modules/@tanstack/store/dist/store.d.ts +29 -0
  319. package/dist/node_modules/@tanstack/store/dist/types.d.ts +38 -0
  320. package/dist/node_modules/@tanstack/table-core/dist/core/cells/coreCellsFeature.d.ts +6 -0
  321. package/dist/node_modules/@tanstack/table-core/dist/core/cells/coreCellsFeature.types.d.ts +53 -0
  322. package/dist/node_modules/@tanstack/table-core/dist/core/columns/coreColumnsFeature.d.ts +6 -0
  323. package/dist/node_modules/@tanstack/table-core/dist/core/columns/coreColumnsFeature.types.d.ts +90 -0
  324. package/dist/node_modules/@tanstack/table-core/dist/core/coreFeatures.d.ts +17 -0
  325. package/dist/node_modules/@tanstack/table-core/dist/core/headers/coreHeadersFeature.d.ts +6 -0
  326. package/dist/node_modules/@tanstack/table-core/dist/core/headers/coreHeadersFeature.types.d.ts +114 -0
  327. package/dist/node_modules/@tanstack/table-core/dist/core/reactivity/coreReactivityFeature.types.d.ts +51 -0
  328. package/dist/node_modules/@tanstack/table-core/dist/core/row-models/coreRowModelsFeature.d.ts +6 -0
  329. package/dist/node_modules/@tanstack/table-core/dist/core/row-models/coreRowModelsFeature.types.d.ts +29 -0
  330. package/dist/node_modules/@tanstack/table-core/dist/core/rows/coreRowsFeature.d.ts +6 -0
  331. package/dist/node_modules/@tanstack/table-core/dist/core/rows/coreRowsFeature.types.d.ts +129 -0
  332. package/dist/node_modules/@tanstack/table-core/dist/core/table/coreTablesFeature.d.ts +6 -0
  333. package/dist/node_modules/@tanstack/table-core/dist/core/table/coreTablesFeature.types.d.ts +203 -0
  334. package/dist/node_modules/@tanstack/table-core/dist/features/cell-selection/cellSelectionFeature.d.ts +6 -0
  335. package/dist/node_modules/@tanstack/table-core/dist/features/cell-selection/cellSelectionFeature.types.d.ts +294 -0
  336. package/dist/node_modules/@tanstack/table-core/dist/features/cell-spanning/cellSpanningFeature.d.ts +11 -0
  337. package/dist/node_modules/@tanstack/table-core/dist/features/cell-spanning/cellSpanningFeature.types.d.ts +148 -0
  338. package/dist/node_modules/@tanstack/table-core/dist/features/column-faceting/columnFacetingFeature.d.ts +12 -0
  339. package/dist/node_modules/@tanstack/table-core/dist/features/column-faceting/columnFacetingFeature.types.d.ts +63 -0
  340. package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/columnFilteringFeature.d.ts +6 -0
  341. package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/columnFilteringFeature.types.d.ts +209 -0
  342. package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/filterFns.d.ts +35 -0
  343. package/dist/node_modules/@tanstack/table-core/dist/features/column-grouping/columnGroupingFeature.d.ts +6 -0
  344. package/dist/node_modules/@tanstack/table-core/dist/features/column-grouping/columnGroupingFeature.types.d.ts +128 -0
  345. package/dist/node_modules/@tanstack/table-core/dist/features/column-ordering/columnOrderingFeature.d.ts +6 -0
  346. package/dist/node_modules/@tanstack/table-core/dist/features/column-ordering/columnOrderingFeature.types.d.ts +82 -0
  347. package/dist/node_modules/@tanstack/table-core/dist/features/column-pinning/columnPinningFeature.d.ts +11 -0
  348. package/dist/node_modules/@tanstack/table-core/dist/features/column-pinning/columnPinningFeature.types.d.ts +195 -0
  349. package/dist/node_modules/@tanstack/table-core/dist/features/column-resizing/columnResizingFeature.d.ts +6 -0
  350. package/dist/node_modules/@tanstack/table-core/dist/features/column-resizing/columnResizingFeature.types.d.ts +73 -0
  351. package/dist/node_modules/@tanstack/table-core/dist/features/column-sizing/columnSizingFeature.d.ts +6 -0
  352. package/dist/node_modules/@tanstack/table-core/dist/features/column-sizing/columnSizingFeature.types.d.ts +134 -0
  353. package/dist/node_modules/@tanstack/table-core/dist/features/column-visibility/columnVisibilityFeature.d.ts +6 -0
  354. package/dist/node_modules/@tanstack/table-core/dist/features/column-visibility/columnVisibilityFeature.types.d.ts +92 -0
  355. package/dist/node_modules/@tanstack/table-core/dist/features/global-filtering/globalFilteringFeature.d.ts +6 -0
  356. package/dist/node_modules/@tanstack/table-core/dist/features/global-filtering/globalFilteringFeature.types.d.ts +67 -0
  357. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/aggregationFns.d.ts +23 -0
  358. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.d.ts +6 -0
  359. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.types.d.ts +183 -0
  360. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.utils.d.ts +18 -0
  361. package/dist/node_modules/@tanstack/table-core/dist/features/row-expanding/rowExpandingFeature.d.ts +6 -0
  362. package/dist/node_modules/@tanstack/table-core/dist/features/row-expanding/rowExpandingFeature.types.d.ts +125 -0
  363. package/dist/node_modules/@tanstack/table-core/dist/features/row-pagination/rowPaginationFeature.d.ts +6 -0
  364. package/dist/node_modules/@tanstack/table-core/dist/features/row-pagination/rowPaginationFeature.types.d.ts +135 -0
  365. package/dist/node_modules/@tanstack/table-core/dist/features/row-pinning/rowPinningFeature.d.ts +6 -0
  366. package/dist/node_modules/@tanstack/table-core/dist/features/row-pinning/rowPinningFeature.types.d.ts +76 -0
  367. package/dist/node_modules/@tanstack/table-core/dist/features/row-selection/rowSelectionFeature.d.ts +6 -0
  368. package/dist/node_modules/@tanstack/table-core/dist/features/row-selection/rowSelectionFeature.types.d.ts +187 -0
  369. package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/rowSortingFeature.d.ts +6 -0
  370. package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/rowSortingFeature.types.d.ts +236 -0
  371. package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/sortFns.d.ts +23 -0
  372. package/dist/node_modules/@tanstack/table-core/dist/features/stockFeatures.d.ts +37 -0
  373. package/dist/node_modules/@tanstack/table-core/dist/helpers/columnHelper.d.ts +47 -0
  374. package/dist/node_modules/@tanstack/table-core/dist/types/Cell.d.ts +16 -0
  375. package/dist/node_modules/@tanstack/table-core/dist/types/Column.d.ts +30 -0
  376. package/dist/node_modules/@tanstack/table-core/dist/types/ColumnDef.d.ts +123 -0
  377. package/dist/node_modules/@tanstack/table-core/dist/types/Header.d.ts +12 -0
  378. package/dist/node_modules/@tanstack/table-core/dist/types/HeaderGroup.d.ts +6 -0
  379. package/dist/node_modules/@tanstack/table-core/dist/types/Row.d.ts +24 -0
  380. package/dist/node_modules/@tanstack/table-core/dist/types/RowModel.d.ts +19 -0
  381. package/dist/node_modules/@tanstack/table-core/dist/types/RowModelFns.d.ts +11 -0
  382. package/dist/node_modules/@tanstack/table-core/dist/types/Table.d.ts +53 -0
  383. package/dist/node_modules/@tanstack/table-core/dist/types/TableFeatures.d.ts +416 -0
  384. package/dist/node_modules/@tanstack/table-core/dist/types/TableOptions.d.ts +78 -0
  385. package/dist/node_modules/@tanstack/table-core/dist/types/TableState.d.ts +46 -0
  386. package/dist/node_modules/@tanstack/table-core/dist/types/type-utils.d.ts +25 -0
  387. package/dist/shared.css +179 -0
  388. package/dist/styles.css +5467 -0
  389. package/dist/theme.css +314 -0
  390. package/dist/theme.map.json +278 -0
  391. package/dist/tokens/index.d.ts +2 -0
  392. package/dist/tokens/index.js +1 -0
  393. package/dist/tokens/tokens.generated.d.ts +2040 -0
  394. package/dist/tokens/tokens.generated.js +2053 -0
  395. package/dist/tokens.css +484 -0
  396. package/dist/tokens.flat.json +429 -0
  397. package/docs/Consuming.mdx +379 -0
  398. package/docs/Contributing.mdx +78 -0
  399. package/docs/ForAgents.mdx +53 -0
  400. package/docs/Introduction.mdx +54 -0
  401. package/llms.txt +556 -0
  402. package/package.json +351 -3
  403. package/src/components/action-row/ActionRow.mdx +686 -0
  404. package/src/components/action-row/ActionRow.stories.tsx +669 -0
  405. package/src/components/action-row/ActionRow.tsx +632 -0
  406. package/src/components/action-row/index.ts +9 -0
  407. package/src/components/alert/Alert.mdx +377 -0
  408. package/src/components/alert/Alert.stories.tsx +674 -0
  409. package/src/components/alert/Alert.tsx +579 -0
  410. package/src/components/alert/index.ts +13 -0
  411. package/src/components/anchored-panel/AnchoredPanel.mdx +381 -0
  412. package/src/components/anchored-panel/AnchoredPanel.stories.tsx +593 -0
  413. package/src/components/anchored-panel/AnchoredPanel.tsx +176 -0
  414. package/src/components/anchored-panel/index.ts +15 -0
  415. package/src/components/badge/Badge.mdx +487 -0
  416. package/src/components/badge/Badge.stories.tsx +375 -0
  417. package/src/components/badge/Badge.tsx +360 -0
  418. package/src/components/badge/index.ts +10 -0
  419. package/src/components/banner/Banner.mdx +704 -0
  420. package/src/components/banner/Banner.stories.tsx +448 -0
  421. package/src/components/banner/Banner.tsx +602 -0
  422. package/src/components/banner/index.ts +14 -0
  423. package/src/components/button/Button.mdx +286 -0
  424. package/src/components/button/Button.stories.tsx +381 -0
  425. package/src/components/button/Button.tsx +384 -0
  426. package/src/components/button/index.ts +1 -0
  427. package/src/components/button-group/ButtonGroup.mdx +512 -0
  428. package/src/components/button-group/ButtonGroup.stories.tsx +714 -0
  429. package/src/components/button-group/ButtonGroup.tsx +491 -0
  430. package/src/components/button-group/index.ts +10 -0
  431. package/src/components/card-select/CardSelect.mdx +662 -0
  432. package/src/components/card-select/CardSelect.stories.tsx +784 -0
  433. package/src/components/card-select/CardSelect.tsx +783 -0
  434. package/src/components/card-select/CardSelectGroup.tsx +169 -0
  435. package/src/components/card-select/index.ts +18 -0
  436. package/src/components/checkbox/Checkbox.mdx +269 -0
  437. package/src/components/checkbox/Checkbox.stories.tsx +306 -0
  438. package/src/components/checkbox/Checkbox.tsx +343 -0
  439. package/src/components/checkbox/index.ts +1 -0
  440. package/src/components/chip/Chip.mdx +683 -0
  441. package/src/components/chip/Chip.stories.tsx +734 -0
  442. package/src/components/chip/Chip.tsx +732 -0
  443. package/src/components/chip/index.ts +9 -0
  444. package/src/components/column-header/ColumnHeader.mdx +301 -0
  445. package/src/components/column-header/ColumnHeader.stories.tsx +319 -0
  446. package/src/components/column-header/ColumnHeader.tsx +287 -0
  447. package/src/components/column-header/index.ts +7 -0
  448. package/src/components/combobox-field/Combobox.tsx +693 -0
  449. package/src/components/combobox-field/ComboboxField.mdx +525 -0
  450. package/src/components/combobox-field/ComboboxField.stories.tsx +502 -0
  451. package/src/components/combobox-field/ComboboxField.tsx +259 -0
  452. package/src/components/combobox-field/index.ts +12 -0
  453. package/src/components/date-field/DateField.mdx +340 -0
  454. package/src/components/date-field/DateField.stories.tsx +221 -0
  455. package/src/components/date-field/DateField.tsx +176 -0
  456. package/src/components/date-field/index.ts +1 -0
  457. package/src/components/date-picker/DatePicker.mdx +436 -0
  458. package/src/components/date-picker/DatePicker.stories.tsx +458 -0
  459. package/src/components/date-picker/DatePicker.tsx +688 -0
  460. package/src/components/date-picker/index.ts +9 -0
  461. package/src/components/divider/Divider.mdx +256 -0
  462. package/src/components/divider/Divider.stories.tsx +177 -0
  463. package/src/components/divider/Divider.tsx +193 -0
  464. package/src/components/divider/index.ts +1 -0
  465. package/src/components/drawer/Drawer.mdx +518 -0
  466. package/src/components/drawer/Drawer.stories.tsx +392 -0
  467. package/src/components/drawer/Drawer.tsx +683 -0
  468. package/src/components/drawer/index.ts +1 -0
  469. package/src/components/dropdown-button/DropdownButton.mdx +285 -0
  470. package/src/components/dropdown-button/DropdownButton.stories.tsx +398 -0
  471. package/src/components/dropdown-button/DropdownButton.tsx +198 -0
  472. package/src/components/dropdown-button/index.ts +7 -0
  473. package/src/components/faq/FAQ.mdx +364 -0
  474. package/src/components/faq/FAQ.stories.tsx +343 -0
  475. package/src/components/faq/FAQ.tsx +337 -0
  476. package/src/components/faq/index.ts +1 -0
  477. package/src/components/field/Field.mdx +129 -0
  478. package/src/components/field/Field.stories.tsx +461 -0
  479. package/src/components/field/Field.tsx +765 -0
  480. package/src/components/field/index.ts +20 -0
  481. package/src/components/field-pair/FieldPair.mdx +308 -0
  482. package/src/components/field-pair/FieldPair.stories.tsx +530 -0
  483. package/src/components/field-pair/FieldPair.tsx +796 -0
  484. package/src/components/field-pair/index.ts +9 -0
  485. package/src/components/file-upload/FileUpload.mdx +345 -0
  486. package/src/components/file-upload/FileUpload.stories.tsx +698 -0
  487. package/src/components/file-upload/FileUpload.tsx +802 -0
  488. package/src/components/file-upload/index.ts +6 -0
  489. package/src/components/filter-chip/FilterChip.mdx +778 -0
  490. package/src/components/filter-chip/FilterChip.stories.tsx +827 -0
  491. package/src/components/filter-chip/FilterChip.tsx +881 -0
  492. package/src/components/filter-chip/index.ts +11 -0
  493. package/src/components/filter-facet/FilterFacet.mdx +536 -0
  494. package/src/components/filter-facet/FilterFacet.stories.tsx +506 -0
  495. package/src/components/filter-facet/FilterFacet.tsx +1160 -0
  496. package/src/components/filter-facet/index.ts +7 -0
  497. package/src/components/firm-avatar/FirmAvatar.mdx +280 -0
  498. package/src/components/firm-avatar/FirmAvatar.stories.tsx +147 -0
  499. package/src/components/firm-avatar/FirmAvatar.tsx +172 -0
  500. package/src/components/firm-avatar/index.ts +7 -0
  501. package/src/components/form-actions/FormActions.mdx +518 -0
  502. package/src/components/form-actions/FormActions.stories.tsx +621 -0
  503. package/src/components/form-actions/FormActions.tsx +273 -0
  504. package/src/components/form-actions/index.ts +6 -0
  505. package/src/components/form-block/FormBlock.mdx +728 -0
  506. package/src/components/form-block/FormBlock.stories.tsx +813 -0
  507. package/src/components/form-block/FormBlock.tsx +679 -0
  508. package/src/components/form-block/index.ts +13 -0
  509. package/src/components/form-section/FormSection.mdx +436 -0
  510. package/src/components/form-section/FormSection.stories.tsx +407 -0
  511. package/src/components/form-section/FormSection.tsx +290 -0
  512. package/src/components/form-section/index.ts +17 -0
  513. package/src/components/heading/Heading.mdx +206 -0
  514. package/src/components/heading/Heading.stories.tsx +169 -0
  515. package/src/components/heading/Heading.tsx +124 -0
  516. package/src/components/heading/index.ts +8 -0
  517. package/src/components/heading-group/HeadingGroup.mdx +521 -0
  518. package/src/components/heading-group/HeadingGroup.stories.tsx +353 -0
  519. package/src/components/heading-group/HeadingGroup.tsx +396 -0
  520. package/src/components/heading-group/index.ts +7 -0
  521. package/src/components/hero/Hero.mdx +742 -0
  522. package/src/components/hero/Hero.stories.tsx +527 -0
  523. package/src/components/hero/Hero.tsx +807 -0
  524. package/src/components/hero/index.ts +1 -0
  525. package/src/components/icon/Icon.mdx +329 -0
  526. package/src/components/icon/Icon.stories.tsx +398 -0
  527. package/src/components/icon/Icon.tsx +97 -0
  528. package/src/components/icon/index.ts +2 -0
  529. package/src/components/icon-button/IconButton.mdx +206 -0
  530. package/src/components/icon-button/IconButton.stories.tsx +341 -0
  531. package/src/components/icon-button/IconButton.tsx +273 -0
  532. package/src/components/icon-button/index.ts +1 -0
  533. package/src/components/item-row/ItemRow.mdx +533 -0
  534. package/src/components/item-row/ItemRow.stories.tsx +434 -0
  535. package/src/components/item-row/ItemRow.tsx +676 -0
  536. package/src/components/item-row/index.ts +9 -0
  537. package/src/components/list-row/ListRow.mdx +404 -0
  538. package/src/components/list-row/ListRow.stories.tsx +404 -0
  539. package/src/components/list-row/ListRow.tsx +424 -0
  540. package/src/components/list-row/index.ts +1 -0
  541. package/src/components/menu/Menu.mdx +268 -0
  542. package/src/components/menu/Menu.stories.tsx +455 -0
  543. package/src/components/menu/Menu.tsx +452 -0
  544. package/src/components/menu/index.ts +1 -0
  545. package/src/components/modal/Modal.mdx +854 -0
  546. package/src/components/modal/Modal.stories.tsx +881 -0
  547. package/src/components/modal/Modal.tsx +1434 -0
  548. package/src/components/modal/index.ts +1 -0
  549. package/src/components/nav-link/NavLink.mdx +196 -0
  550. package/src/components/nav-link/NavLink.stories.tsx +243 -0
  551. package/src/components/nav-link/NavLink.tsx +222 -0
  552. package/src/components/nav-link/index.ts +1 -0
  553. package/src/components/number-field/NumberField.mdx +223 -0
  554. package/src/components/number-field/NumberField.stories.tsx +291 -0
  555. package/src/components/number-field/NumberField.tsx +388 -0
  556. package/src/components/number-field/index.ts +6 -0
  557. package/src/components/pagination/Pagination.mdx +305 -0
  558. package/src/components/pagination/Pagination.stories.tsx +333 -0
  559. package/src/components/pagination/Pagination.tsx +343 -0
  560. package/src/components/pagination/index.ts +8 -0
  561. package/src/components/popover-surface/PopoverSurface.mdx +158 -0
  562. package/src/components/popover-surface/PopoverSurface.stories.tsx +421 -0
  563. package/src/components/popover-surface/index.ts +1 -0
  564. package/src/components/progress-bar/ProgressBar.mdx +802 -0
  565. package/src/components/progress-bar/ProgressBar.stories.tsx +533 -0
  566. package/src/components/progress-bar/ProgressBar.tsx +654 -0
  567. package/src/components/progress-bar/index.ts +9 -0
  568. package/src/components/promo-sticker/PromoSticker.mdx +436 -0
  569. package/src/components/promo-sticker/PromoSticker.stories.tsx +363 -0
  570. package/src/components/promo-sticker/PromoSticker.tsx +313 -0
  571. package/src/components/promo-sticker/index.ts +7 -0
  572. package/src/components/promo-surface/PromoSurface.mdx +399 -0
  573. package/src/components/promo-surface/PromoSurface.stories.tsx +270 -0
  574. package/src/components/promo-surface/PromoSurface.tsx +305 -0
  575. package/src/components/promo-surface/index.ts +7 -0
  576. package/src/components/radio/Radio.mdx +243 -0
  577. package/src/components/radio/Radio.stories.tsx +307 -0
  578. package/src/components/radio/Radio.tsx +288 -0
  579. package/src/components/radio/index.ts +1 -0
  580. package/src/components/radio-group/RadioGroup.mdx +119 -0
  581. package/src/components/radio-group/RadioGroup.stories.tsx +225 -0
  582. package/src/components/radio-group/RadioGroup.tsx +139 -0
  583. package/src/components/radio-group/index.ts +1 -0
  584. package/src/components/select/Select.mdx +241 -0
  585. package/src/components/select/Select.stories.tsx +404 -0
  586. package/src/components/select/Select.tsx +381 -0
  587. package/src/components/select/index.ts +1 -0
  588. package/src/components/select-field/SelectField.mdx +324 -0
  589. package/src/components/select-field/SelectField.stories.tsx +460 -0
  590. package/src/components/select-field/SelectField.tsx +138 -0
  591. package/src/components/select-field/index.ts +1 -0
  592. package/src/components/skeleton/Skeleton.mdx +194 -0
  593. package/src/components/skeleton/Skeleton.stories.tsx +260 -0
  594. package/src/components/skeleton/Skeleton.tsx +107 -0
  595. package/src/components/skeleton/index.ts +1 -0
  596. package/src/components/split-button/SplitButton.mdx +445 -0
  597. package/src/components/split-button/SplitButton.stories.tsx +465 -0
  598. package/src/components/split-button/SplitButton.tsx +361 -0
  599. package/src/components/split-button/index.ts +7 -0
  600. package/src/components/status-summary-bar/StatusSummaryBar.mdx +338 -0
  601. package/src/components/status-summary-bar/StatusSummaryBar.stories.tsx +408 -0
  602. package/src/components/status-summary-bar/StatusSummaryBar.tsx +428 -0
  603. package/src/components/status-summary-bar/index.ts +8 -0
  604. package/src/components/subject-lookup-field/SubjectLookupField.mdx +378 -0
  605. package/src/components/subject-lookup-field/SubjectLookupField.stories.tsx +393 -0
  606. package/src/components/subject-lookup-field/SubjectLookupField.tsx +1079 -0
  607. package/src/components/subject-lookup-field/index.ts +11 -0
  608. package/src/components/switch/Switch.mdx +376 -0
  609. package/src/components/switch/Switch.stories.tsx +296 -0
  610. package/src/components/switch/Switch.tsx +483 -0
  611. package/src/components/switch/index.ts +1 -0
  612. package/src/components/table/Table.mdx +575 -0
  613. package/src/components/table/Table.stories.tsx +1049 -0
  614. package/src/components/table/Table.tsx +745 -0
  615. package/src/components/table/TableConsumers.stories.tsx +195 -0
  616. package/src/components/table/_tableFixtures.ts +1189 -0
  617. package/src/components/table/index.ts +22 -0
  618. package/src/components/text-field/TextField.mdx +479 -0
  619. package/src/components/text-field/TextField.stories.tsx +366 -0
  620. package/src/components/text-field/TextField.tsx +391 -0
  621. package/src/components/text-field/index.ts +8 -0
  622. package/src/components/text-link/TextLink.mdx +353 -0
  623. package/src/components/text-link/TextLink.stories.tsx +458 -0
  624. package/src/components/text-link/TextLink.tsx +504 -0
  625. package/src/components/text-link/index.ts +10 -0
  626. package/src/components/textarea/Textarea.mdx +244 -0
  627. package/src/components/textarea/Textarea.stories.tsx +371 -0
  628. package/src/components/textarea/Textarea.tsx +489 -0
  629. package/src/components/textarea/index.ts +9 -0
  630. package/src/components/tooltip/Tooltip.mdx +462 -0
  631. package/src/components/tooltip/Tooltip.stories.tsx +500 -0
  632. package/src/components/tooltip/Tooltip.tsx +756 -0
  633. package/src/components/tooltip/index.ts +13 -0
  634. package/src/components/unit-field/UnitField.mdx +215 -0
  635. package/src/components/unit-field/UnitField.stories.tsx +291 -0
  636. package/src/components/unit-field/UnitField.tsx +255 -0
  637. package/src/components/unit-field/index.ts +7 -0
  638. package/src/icons/icon-registry.generated.ts +510 -0
  639. package/src/icons/icon-types.generated.ts +256 -0
  640. package/src/index.ts +71 -0
  641. package/src/internal/BottomSheet.tsx +714 -0
  642. package/src/internal/FodsProvider.tsx +36 -0
  643. package/src/internal/MotionCaret.tsx +53 -0
  644. package/src/internal/NumberFormatInput.tsx +276 -0
  645. package/src/internal/SummaryDonut.tsx +359 -0
  646. package/src/internal/buttonSegment.ts +241 -0
  647. package/src/internal/collapseRoom.ts +130 -0
  648. package/src/internal/comboboxKeys.ts +90 -0
  649. package/src/internal/contentPresence.ts +46 -0
  650. package/src/internal/dayCell.ts +274 -0
  651. package/src/internal/dialogPortal.ts +50 -0
  652. package/src/internal/donutSweeps.ts +77 -0
  653. package/src/internal/enterOnViewGeometry.ts +53 -0
  654. package/src/internal/faqItem.ts +104 -0
  655. package/src/internal/floatingLabelMotion.tsx +109 -0
  656. package/src/internal/formBlockContext.ts +27 -0
  657. package/src/internal/heightRoom.ts +135 -0
  658. package/src/internal/numberSeparators.ts +93 -0
  659. package/src/internal/overlayMotion.tsx +32 -0
  660. package/src/internal/paginationItem.ts +106 -0
  661. package/src/internal/popoverSurface.ts +78 -0
  662. package/src/internal/portalContainer.ts +11 -0
  663. package/src/internal/progressBarItem.ts +356 -0
  664. package/src/internal/selectionControlText.ts +42 -0
  665. package/src/internal/statusSummaryParts.tsx +475 -0
  666. package/src/internal/summaryMotion.ts +111 -0
  667. package/src/internal/table/ChildConnector.tsx +57 -0
  668. package/src/internal/table/ChildRowPrefix.tsx +21 -0
  669. package/src/internal/table/ColumnSettings.tsx +194 -0
  670. package/src/internal/table/ScrollRegion.tsx +176 -0
  671. package/src/internal/table/TableEmpty.tsx +99 -0
  672. package/src/internal/table/TableLayout.tsx +29 -0
  673. package/src/internal/table/TableLoadStatus.tsx +60 -0
  674. package/src/internal/table/TableMobile.tsx +582 -0
  675. package/src/internal/table/TruncatedCell.tsx +35 -0
  676. package/src/internal/table/emptyValue.ts +11 -0
  677. package/src/internal/table/features.ts +44 -0
  678. package/src/internal/table/recipes.ts +263 -0
  679. package/src/internal/table/rowClick.ts +8 -0
  680. package/src/internal/table/types.ts +342 -0
  681. package/src/internal/tailwind-variants.ts +65 -0
  682. package/src/internal/tooltipContext.ts +15 -0
  683. package/src/internal/tw-merge-config.generated.ts +275 -0
  684. package/src/internal/useAnchoredPanel.ts +340 -0
  685. package/src/internal/useCountUp.ts +65 -0
  686. package/src/internal/useDateFieldTrigger.tsx +357 -0
  687. package/src/internal/useEChart.ts +88 -0
  688. package/src/internal/useEnterOnView.ts +80 -0
  689. package/src/internal/useFloatingBar.ts +125 -0
  690. package/src/internal/useFormReset.ts +47 -0
  691. package/src/internal/useIsMobile.ts +64 -0
  692. package/src/internal/useNoImplicitSubmit.ts +41 -0
  693. package/src/internal/useOneRowOverflow.ts +103 -0
  694. package/src/internal/usePrefersReducedMotion.ts +27 -0
  695. package/src/internal/useReturnFocus.ts +34 -0
  696. package/src/internal/utils.ts +58 -0
  697. package/src/recipes/EmptyState.stories.tsx +105 -0
  698. package/src/recipes/Form.stories.tsx +355 -0
  699. package/src/recipes/ModalWithForm.stories.tsx +219 -0
  700. package/src/recipes/Recipes.mdx +61 -0
  701. package/src/recipes/TableWithFilters.stories.tsx +278 -0
  702. package/src/storybook/FodsFamily.tsx +39 -0
  703. package/src/storybook/Section.tsx +36 -0
  704. package/src/storybook/a11y.ts +24 -0
  705. package/src/storybook/assets/banner-character-bartender.webp +0 -0
  706. package/src/storybook/assets/banner-invoice-sheet-left.webp +0 -0
  707. package/src/storybook/assets/banner-invoice-sheet-right.webp +0 -0
  708. package/src/storybook/assets/invoice-hero.webp +0 -0
  709. package/src/storybook/assets/invoice.webp +0 -0
  710. package/src/storybook/assets/section-document-info.svg +21 -0
  711. package/src/storybook/assets/section-gear-checklist.svg +11 -0
  712. package/src/storybook/assets/section-person-arrow-in.svg +15 -0
  713. package/src/storybook/assets/section-person-arrow-out.svg +22 -0
  714. package/src/storybook/assets/section-receipt-dollar.svg +23 -0
  715. package/src/storybook/assets/table-empty-folder-empty.png +0 -0
  716. package/src/storybook/assets/table-empty-folder-magnifying-glass.png +0 -0
  717. package/src/storybook/assets/table-empty-funnel.png +0 -0
  718. package/src/storybook/assets/table-empty-load-failed.png +0 -0
  719. package/src/storybook/assets/wallet-spot.png +0 -0
  720. package/src/storybook/assets.d.ts +17 -0
  721. package/src/storybook/componentDoc.ts +41 -0
  722. package/src/storybook/fitFrame.tsx +70 -0
  723. package/src/storybook/forceStates.tsx +647 -0
  724. package/src/storybook/illustrations.tsx +66 -0
  725. package/src/storybook/viewportFrame.tsx +58 -0
  726. package/src/styles/assets/label-brush-1.svg +6 -0
  727. package/src/styles/assets/pattern-dark.svg +113 -0
  728. package/src/styles/base.css +106 -0
  729. package/src/styles/index.css +15 -0
  730. package/src/styles/motion.css +157 -0
  731. package/src/styles/promo-sticker.css +27 -0
  732. package/src/styles/promo-surface.css +49 -0
  733. package/src/styles/shared.css +11 -0
  734. package/src/styles/theme.generated.css +314 -0
  735. package/src/styles/theme.map.json +278 -0
  736. package/src/styles/tracking.generated.css +12 -0
  737. package/src/tokens/index.ts +4 -0
  738. package/src/tokens/tokens.generated.ts +542 -0
@@ -0,0 +1 @@
1
+ export { Modal, ModalTitle, modalVariants, type ModalProps, type ModalType, type ModalSize } from './Modal';
@@ -0,0 +1,196 @@
1
+ import { Meta, Canvas, Controls } from '@storybook/addon-docs/blocks';
2
+ import * as NavLinkStories from './NavLink.stories';
3
+
4
+ <Meta of={NavLinkStories} tags={['autodocs']} />
5
+
6
+ # NavLink
7
+
8
+ ## Metadata
9
+
10
+ - **Layer:** atom
11
+ - **Status:** draft
12
+ - **Tokens used:** `--border-width-200`, `--disabled-foreground`, `--duration-hover`, `--duration-toggle`, `--easing-standard`, `--font-body`, `--font-size-base`, `--font-weight-semibold`, `--leading-relaxed`, `--outline-focus`, `--outline-strong`, `--radius-200`, `--secondary`, `--secondary-active`, `--size-icon`, `--space-1000`, `--space-400`, `--text-wrap-body`
13
+ - **Manifest version:** `1.4.4`
14
+
15
+ ## Overview
16
+
17
+ One item of a navigation group: the header menu, in-app section tabs, a sub-nav. A ghost link in the `--secondary` blue with an optional decorative leading icon and a 2px indicator bar at its bottom edge. It marks **where you are** (the Current state, `aria-current="page"`), not what you trigger.
18
+
19
+ Do **not** use it for an action that does something (→ [`Button`](?path=/docs/design-system-atoms-button--docs)), for a footer or in-prose link (→ [`TextLink`](?path=/docs/design-system-atoms-textlink--docs)), or for an icon-only control (→ [`IconButton`](?path=/docs/design-system-atoms-iconbutton--docs)).
20
+
21
+ ## Rationale
22
+
23
+ A nav item looks like a ghost button, but two things a button does not express are promoted into this component:
24
+
25
+ 1. **Current page.** A nav item needs a persistent *you-are-here* state, distinct from a pressed `:active`. Current is `aria-current="page"` and is shown by the active ink **plus** a 2px bottom indicator bar, a non-colour cue (WCAG 1.4.1), so Current never relies on a blue-against-darker-blue difference alone. Hover previews the same bar in a muted neutral.
26
+ 2. **Spacing and collapse belong to the row, not the link.** NavLink has no side padding: the spacing between items is one `gap` on the parent menu. The leading icon can be switched off, so a responsive-collapse controller can drop it as the first reduction step while the label stays.
27
+
28
+ ## Anatomy
29
+
30
+ A real `<a href>`, laid out as an `inline-flex` row centred on its cross axis, with these parts (`data-fods-part`):
31
+
32
+ - **`root`** — the anchor. Row height 40 (`--space-1000`), gap `--space-400` between icon and label, radius `--radius-200`, **no side padding**. It carries the ink of both the label and the icon.
33
+ - **`leading-icon`** — optional, default glyph `house`, sized `--size-icon` (24). It draws in `currentColor`, so it follows the root's ink in every state. Decorative: hidden from assistive tech. Switched off by `showIcon={false}`.
34
+ - **`label`** — `children`. `Body/M` (`--font-size-base`), `--font-weight-semibold`, one line, truncated with an ellipsis when its slot is narrower than the text. The accessible name.
35
+ - **`indicator`** — the 2px bar, an empty decorative span (`aria-hidden="true"`) absolutely positioned flush at the bottom edge. It spans the whole content row (icon + gap + label), so it shrinks to the label alone when the icon is off and grows with a longer label. Its height is `--border-width-200`: the span's only box is a transparent `border-b-200`, and its background carries the state colour.
36
+
37
+ ## Variants
38
+
39
+ No variant axis: NavLink has one ghost style. The only content switch is the leading icon, shown with and without it in [States](#states).
40
+
41
+ <table>
42
+ <thead>
43
+ <tr><th>Prop</th><th>Values</th><th>Default</th><th>Notes</th></tr>
44
+ </thead>
45
+ <tbody>
46
+ <tr><td><code>showIcon</code></td><td><code>true</code> / <code>false</code></td><td><code>true</code></td><td>The handle a responsive-collapse controller turns off first; the label always stays.</td></tr>
47
+ <tr><td><code>leadingIcon</code></td><td>an icon name</td><td><code>house</code></td><td>The leading glyph. Decorative.</td></tr>
48
+ </tbody>
49
+ </table>
50
+
51
+ ## Sizes
52
+
53
+ One size only (M, the header row height); there is no size prop.
54
+
55
+ <table>
56
+ <thead>
57
+ <tr><th>Size</th><th style={{ textAlign: 'right' }}>Row height</th><th>Font</th><th style={{ textAlign: 'right' }}>Icon</th><th>Gap</th><th>Radius</th><th>Side padding</th></tr>
58
+ </thead>
59
+ <tbody>
60
+ <tr>
61
+ <td><code>M</code></td>
62
+ <td style={{ textAlign: 'right' }}>40 (<code>--space-1000</code>)</td>
63
+ <td><code>Body/M</code>, semibold</td>
64
+ <td style={{ textAlign: 'right' }}>24 (<code>--size-icon</code>)</td>
65
+ <td><code>--space-400</code> (8)</td>
66
+ <td><code>--radius-200</code></td>
67
+ <td>none</td>
68
+ </tr>
69
+ </tbody>
70
+ </table>
71
+
72
+ The 40 row height is the tap target, and the missing side padding does not reduce it. In a dense or touch layout add vertical hit-padding; never shrink the row.
73
+
74
+ ## States
75
+
76
+ <Canvas of={NavLinkStories.Matrix} />
77
+
78
+ <table>
79
+ <thead>
80
+ <tr><th>State</th><th>Ink (label + icon)</th><th>Indicator bar</th><th>How it is reached</th></tr>
81
+ </thead>
82
+ <tbody>
83
+ <tr><td>Default</td><td><code>--secondary</code></td><td>none</td><td>rest</td></tr>
84
+ <tr><td>Hover</td><td><code>--secondary-active</code></td><td><code>--outline-strong</code> (muted preview)</td><td><code>:hover</code>; only on an item that is not the current one</td></tr>
85
+ <tr><td>Current</td><td><code>--secondary-active</code></td><td><code>--secondary-active</code></td><td><code>aria-current</code> set to any value other than <code>false</code></td></tr>
86
+ <tr><td>Disabled</td><td><code>--disabled-foreground</code></td><td>none</td><td><code>disabled</code></td></tr>
87
+ </tbody>
88
+ </table>
89
+
90
+ - **Hover and Current share the ink**, so the bar is what tells them apart: muted on Hover, blue on Current.
91
+ - **Current** is read from `aria-current`; there is no `current` prop. Any value other than `false` / `"false"` counts, so `"location"` on a sub-nav paints the same cue a screen reader announces.
92
+ - **Disabled** shows no Current cue and announces none: a disabled item does not render `aria-current`, even when you pass it.
93
+ - **Focus** is not a state of the axis but the additive focus ring on `:focus-visible`: an `--outline-focus` outline at `--border-width-200`, 2px outside the root. The ink does not change. The ring follows the root's `--radius-200` corner 2px out.
94
+ - **Motion** — the ink and the bar ease on `--easing-standard`: over `--duration-hover` on an ordinary item, over `--duration-toggle` on the current one (a CSS transition takes the duration of the state it enters). These are colour fades, not movement.
95
+
96
+ In the grid above, Hover and Focus are drawn by copies of the component's own classes, so they show without a pointer or a keyboard.
97
+
98
+ ## API
99
+
100
+ <Controls />
101
+
102
+ Notable behaviour not visible in the table:
103
+
104
+ - `href` is required: NavLink always renders an `<a>`. There is no `asChild`.
105
+ - `aria-current` drives the Current state (see [States](#states)).
106
+ - `disabled` removes the `href`, sets `aria-disabled="true"` and `tabIndex={-1}`, drops `aria-current`, cancels the click (neither your `onClick` nor your `onClickCapture` is called) and re-states `role="link"`, because an anchor without `href` loses its implicit link role.
107
+ - The ref is forwarded to the `<a>`; every other anchor attribute is passed through. `className` is merged onto the root.
108
+
109
+ ## Do / Don't
110
+
111
+ - ✅ Let the **parent menu's `gap`** set the spacing between links; links hug their text and align flush to the group edge.
112
+ - ✅ Drive **Current** from `aria-current="page"`; the indicator bar is the redundant, colour-independent cue.
113
+ - ✅ Turn the icon off with `showIcon={false}` under responsive collapse: the icon goes first, the label stays.
114
+ - ✅ Keep the **40px row height** as the tap target.
115
+ - ✅ Keep the indicator bar at the full content width (icon + label, or the label alone when the icon is off).
116
+ - ❌ Don't add horizontal padding to the link to space items out; that belongs to the container.
117
+ - ❌ Don't use NavLink for footer links (`TextLink`) or for actions (`Button`).
118
+ - ❌ Don't signal Current with colour alone; keep the indicator bar.
119
+ - ❌ Don't remove the focus ring.
120
+
121
+ ## Accessibility
122
+
123
+ - **Keyboard** — a native `<a href>`: Tab reaches it, Enter follows it. Nothing is re-implemented in JS. A disabled item is taken out of the tab order (`tabIndex={-1}`).
124
+ - **ARIA (what you provide)** — `aria-current="page"` on the item of the open route. Wrap the items in a `<nav>` with an `aria-label` and a list, as in the [Navigation](#usage) example. While enabled the component adds no `role`; a disabled item gets `aria-disabled="true"` and `role="link"` and loses `aria-current`. Give each `<nav>` on a page its own name.
125
+ - **Screen reader** — the visible label is the accessible name; the icon and the indicator bar are decorative (`aria-hidden`). Dropping the icon on responsive collapse changes neither the name nor the current-page semantics.
126
+ - **Contrast** — the resting ink `--secondary` is the AA-safe blue step. Current is not carried by colour alone: the 2px bar is the non-colour cue WCAG 1.4.1 asks for, mirroring `aria-current`.
127
+ - **Disabled** — prefer hiding a route to disabling it. A disabled item is skipped by Tab, but a screen reader still reads it in browse mode as an unavailable link, so say why elsewhere.
128
+ - **Forced colours** — only the current item's bar is drawn (`forced-colors:visible`); the bar of every other item is hidden, so Current keeps its cue when the system replaces the colours.
129
+ - **Motion** — only colour transitions (ink and bar), no transform, so nothing needs a reduced-motion opt-out.
130
+ - **Target** — the 40px row is the tap target; the missing side padding does not reduce it. On a touch layout add vertical hit-padding around it.
131
+
132
+ ## Copy
133
+
134
+ Voice: impersonal and plain, with consistent terminology. A nav item names a destination, not an action.
135
+
136
+ - **Label** (`children`) — a short destination noun, one or two words: „Přehled“, „Faktury“, „Výdaje“, „Kontakty“, never a verb phrase such as „Zobrazit faktury“ (that is a Button label). The same word as the page or section it leads to, and the same term in the header, the breadcrumb and a sub-nav. Sentence case, no trailing punctuation. Single line, truncated; about 20 characters as guidance. A screen reader hears the whole label, the eye only the part that fits. Responsive collapse drops the icon, never the word, so the label alone must be self-explanatory.
137
+
138
+ Canonical labels:
139
+
140
+ <table>
141
+ <thead>
142
+ <tr><th>Label</th><th>Not</th></tr>
143
+ </thead>
144
+ <tbody>
145
+ <tr><td>Přehled</td><td></td></tr>
146
+ <tr><td>Faktury</td><td>Zobrazit faktury</td></tr>
147
+ <tr><td>Výdaje</td><td>Přejít na výdaje</td></tr>
148
+ <tr><td>Kontakty</td><td>Kontakty: / KONTAKTY</td></tr>
149
+ </tbody>
150
+ </table>
151
+
152
+ ## Usage
153
+
154
+ <Canvas of={NavLinkStories.Navigation} />
155
+
156
+ <Canvas of={NavLinkStories.LongLabel} />
157
+
158
+ ```tsx
159
+ import { NavLink } from '@invoiceonline/ui-react';
160
+
161
+ // Good — a header menu: the parent sets one gap, the open route carries aria-current
162
+ <nav aria-label="Hlavní navigace">
163
+ <ul className="flex items-center gap-500">
164
+ <li><NavLink href="#" leadingIcon="house">Přehled</NavLink></li>
165
+ <li><NavLink href="#" leadingIcon="invoice-new" aria-current="page">Faktury</NavLink></li>
166
+ <li><NavLink href="#" leadingIcon="expense">Výdaje</NavLink></li>
167
+ <li><NavLink href="#" leadingIcon="address-book">Kontakty</NavLink></li>
168
+ </ul>
169
+ </nav>
170
+
171
+ // Good — after the first collapse step: icons off, labels stay
172
+ <NavLink href="#" showIcon={false} aria-current="page">Faktury</NavLink>
173
+ ```
174
+
175
+ ```tsx
176
+ // Don't — padding on the link to space the items out (the parent's gap does that)
177
+ <NavLink href="#" className="px-500">Faktury</NavLink>
178
+
179
+ // Don't — an action dressed as a nav item
180
+ <NavLink href="#" onClick={createInvoice}>Vystavit fakturu</NavLink> // → <Button>
181
+
182
+ // Don't — a verb phrase as the label
183
+ <NavLink href="#">Zobrazit faktury</NavLink> // → „Faktury“
184
+ ```
185
+
186
+ ## Related
187
+
188
+ - [`Button`](?path=/docs/design-system-atoms-button--docs) — an action with chrome; NavLink is wayfinding, not an action.
189
+ - [`TextLink`](?path=/docs/design-system-atoms-textlink--docs) — footer and in-prose links.
190
+ - [`IconButton`](?path=/docs/design-system-atoms-iconbutton--docs) — the icon-only control.
191
+ - [`Icon`](?path=/docs/design-system-atoms-icon--docs) — the decorative glyph rendered by `leadingIcon`.
192
+ - Spec: `spec/03-atoms/nav-link.md` + `nav-link.manifest.json`.
193
+
194
+ ## Migration notes
195
+
196
+ Not applicable: the component was built against manifest `1.4.4` and has not been rebuilt against another version.
@@ -0,0 +1,243 @@
1
+ import type { Meta, StoryObj } from '@storybook/react-vite';
2
+ import { expect, userEvent, within } from 'storybook/test';
3
+ import { NavLink } from './NavLink';
4
+ import { Section, Showcase } from '../../storybook/Section';
5
+ import { componentDoc } from '../../storybook/componentDoc';
6
+
7
+ /** `axes.state` of the manifest. Hover is `:hover`, Current is `aria-current`, never a prop. */
8
+ const STATES = ['default', 'hover', 'current', 'disabled'] as const;
9
+ /** The `Show icon` boolean. */
10
+ const SHOW_ICON = [true, false] as const;
11
+ /** The manifest's own example destinations. */
12
+ const ITEMS = [
13
+ { label: 'Přehled', icon: 'house' },
14
+ { label: 'Faktury', icon: 'invoice-new' },
15
+ { label: 'Výdaje', icon: 'expense' },
16
+ { label: 'Kontakty', icon: 'address-book' },
17
+ ] as const;
18
+ /** A secondary menu with one item that is not available. */
19
+ const SECONDARY_ITEMS = [
20
+ { label: 'Nastavení', disabled: false },
21
+ { label: 'Zprávy', disabled: true },
22
+ { label: 'Nápověda', disabled: false },
23
+ ] as const;
24
+
25
+ /**
26
+ * Bare twins of NavLink's own `hover:` classes, for the Hover row: the
27
+ * `--secondary-active` ink on the root and the muted `--outline-strong` bar. A
28
+ * docs cell cannot show them without a live pointer: Tailwind v4 wraps every
29
+ * `hover:` utility in `@media (hover: hover)`, which `storybook-addon-pseudo-states`
30
+ * does not rewrite. The ink keeps the component's `!` so tailwind-merge replaces
31
+ * the resting `!text-secondary` instead of losing to it.
32
+ */
33
+ const FORCE_HOVER = '!text-secondary-active [&>[data-fods-part=indicator]]:bg-outline-strong';
34
+ /** Bare twin of the `focus-visible:` ring (manifest `focus`: offset, `--outline-focus`, 2px). */
35
+ const FORCE_RING = 'outline outline-200 outline-outline-focus outline-offset-2';
36
+
37
+ const meta = {
38
+ title: 'Design System/Atoms/NavLink',
39
+ component: NavLink,
40
+ parameters: {
41
+ layout: 'centered',
42
+ docs: {
43
+ description: {
44
+ component: componentDoc({
45
+ summary:
46
+ 'One item of a navigation group: a ghost link in the `--secondary` blue with an optional leading icon and a 2px indicator bar at its bottom edge. It marks where you are (the Current state, `aria-current="page"`), not what you trigger.',
47
+ useCases: [
48
+ 'The header menu, section tabs, a sub-nav',
49
+ '`aria-current="page"` on the item of the open route paints the Current state: the active ink plus the indicator bar',
50
+ '`showIcon={false}` drops the leading icon; it is what the responsive-collapse controller turns off first, the label stays',
51
+ ],
52
+ bestPractices: [
53
+ 'The parent menu sets the spacing between items with one `gap`; the link itself has no side padding',
54
+ 'The label is a short destination noun and the accessible name; the icon and the bar are decorative',
55
+ 'Never signal Current by colour alone: the bar is the non-colour cue',
56
+ 'Not for actions (`Button`) or footer and in-prose links (`TextLink`)',
57
+ ],
58
+ knownIssues: [
59
+ 'The bar is `--border-width-200` tall, and the theme has no height utility for a border-width token, so it is drawn as a transparent `border-b-200` on an empty span whose background carries the state colour',
60
+ ],
61
+ docsLink: {
62
+ label: 'spec/03-atoms/nav-link.md',
63
+ },
64
+ }),
65
+ },
66
+ },
67
+ },
68
+ } satisfies Meta<typeof NavLink>;
69
+
70
+ export default meta;
71
+ type Story = StoryObj<typeof meta>;
72
+
73
+ export const Playground: Story = {
74
+ args: {
75
+ children: 'Faktury',
76
+ href: '#',
77
+ leadingIcon: 'house',
78
+ showIcon: true,
79
+ disabled: false,
80
+ 'aria-current': undefined,
81
+ },
82
+ argTypes: {
83
+ href: { control: 'text' },
84
+ leadingIcon: { control: 'select', options: ITEMS.map(item => item.icon) },
85
+ showIcon: { control: 'boolean' },
86
+ disabled: { control: 'boolean' },
87
+ 'aria-current': { control: 'select', options: [undefined, 'page'] },
88
+ },
89
+ };
90
+
91
+ /** Static props per state row. Hover is a forced class pair, never a prop. */
92
+ function stateProps(state: (typeof STATES)[number]) {
93
+ switch (state) {
94
+ case 'hover':
95
+ return { className: FORCE_HOVER };
96
+ case 'current':
97
+ return { 'aria-current': 'page' as const };
98
+ case 'disabled':
99
+ return { disabled: true };
100
+ default:
101
+ return {};
102
+ }
103
+ }
104
+
105
+ export const Matrix: Story = {
106
+ args: { children: 'Faktury', href: '#' },
107
+ parameters: {
108
+ docs: {
109
+ description: {
110
+ story:
111
+ 'Every state of the manifest, with and without the icon. Default `--secondary`; Hover `--secondary-active` with the muted `--outline-strong` bar; Current `--secondary-active` with the `--secondary-active` bar; Disabled `--disabled-foreground`, no bar. The bar spans the whole content row, so it shrinks to the label when the icon is off. Focus is the cross-cutting ring, not a state of the axis: `--outline-focus`, 2px outside. Hover and Focus are drawn by bare twins of the component\'s own classes, so the grid shows them without a pointer or a keyboard.',
112
+ },
113
+ },
114
+ },
115
+ render: () => (
116
+ <Showcase>
117
+ {STATES.map(state => (
118
+ <Section key={state} title={state}>
119
+ {SHOW_ICON.map(showIcon => (
120
+ <NavLink key={String(showIcon)} href="#" showIcon={showIcon} {...stateProps(state)}>
121
+ Faktury
122
+ </NavLink>
123
+ ))}
124
+ </Section>
125
+ ))}
126
+ <Section title="focus">
127
+ {SHOW_ICON.map(showIcon => (
128
+ <NavLink key={String(showIcon)} href="#" showIcon={showIcon} className={FORCE_RING}>
129
+ Faktury
130
+ </NavLink>
131
+ ))}
132
+ </Section>
133
+ </Showcase>
134
+ ),
135
+ };
136
+
137
+ export const Navigation: Story = {
138
+ args: { children: 'Přehled', href: '#' },
139
+ parameters: {
140
+ docs: {
141
+ description: {
142
+ story:
143
+ 'A header menu: the parent sets one `gap` and the items carry no side padding. The open route carries `aria-current="page"`. Below, the same menu after the first step of responsive collapse: the icons are gone, the labels stay, and the gap steps up from `--space-500` to `--space-600` so the links do not read as one line (spec/06-patterns/responsive-collapse.md). Last, a secondary menu with one disabled item: it has no href, no `aria-current` and is skipped by Tab.',
144
+ },
145
+ },
146
+ },
147
+ render: () => (
148
+ <Showcase>
149
+ <Section title="With icons">
150
+ <nav aria-label="Hlavní navigace">
151
+ <ul className="flex items-center gap-500">
152
+ {ITEMS.map((item, index) => (
153
+ <li key={item.label}>
154
+ <NavLink href="#" leadingIcon={item.icon} aria-current={index === 1 ? 'page' : undefined}>
155
+ {item.label}
156
+ </NavLink>
157
+ </li>
158
+ ))}
159
+ </ul>
160
+ </nav>
161
+ </Section>
162
+ <Section title="Collapsed: icons off">
163
+ <nav aria-label="Sbalená navigace">
164
+ <ul className="flex items-center gap-600">
165
+ {ITEMS.map((item, index) => (
166
+ <li key={item.label}>
167
+ <NavLink href="#" leadingIcon={item.icon} showIcon={false} aria-current={index === 1 ? 'page' : undefined}>
168
+ {item.label}
169
+ </NavLink>
170
+ </li>
171
+ ))}
172
+ </ul>
173
+ </nav>
174
+ </Section>
175
+ <Section title="With a disabled item">
176
+ <nav aria-label="Vedlejší navigace">
177
+ <ul className="flex items-center gap-600">
178
+ {SECONDARY_ITEMS.map(item => (
179
+ <li key={item.label}>
180
+ <NavLink href="#" showIcon={false} disabled={item.disabled}>
181
+ {item.label}
182
+ </NavLink>
183
+ </li>
184
+ ))}
185
+ </ul>
186
+ </nav>
187
+ </Section>
188
+ </Showcase>
189
+ ),
190
+ play: async ({ canvasElement }) => {
191
+ const canvas = within(canvasElement);
192
+ const main = within(canvas.getByRole('navigation', { name: 'Hlavní navigace' }));
193
+ const first = main.getByRole('link', { name: 'Přehled' });
194
+
195
+ // Tab reaches the first link and draws the real :focus-visible ring
196
+ // (manifest focus: offset style, 2px outside).
197
+ await userEvent.tab();
198
+ await expect(first).toHaveFocus();
199
+ const ring = getComputedStyle(first);
200
+ await expect(ring.outlineStyle).not.toBe('none');
201
+ // fods-lint-disable-next-line px — asserts the computed offset of manifest focus.offset (2px); the computed value is a px string, not a token
202
+ await expect(ring.outlineOffset).toBe('2px');
203
+
204
+ // Tab skips the disabled item of the secondary menu.
205
+ const secondary = within(canvas.getByRole('navigation', { name: 'Vedlejší navigace' }));
206
+ const before = secondary.getByRole('link', { name: 'Nastavení' });
207
+ const disabled = secondary.getByRole('link', { name: 'Zprávy' });
208
+ const after = secondary.getByRole('link', { name: 'Nápověda' });
209
+ await expect(disabled).toHaveAttribute('aria-disabled', 'true');
210
+ await expect(disabled).not.toHaveAttribute('href');
211
+ for (let i = 0; i < 20 && document.activeElement !== before; i++) await userEvent.tab();
212
+ await expect(before).toHaveFocus();
213
+ await userEvent.tab();
214
+ await expect(after).toHaveFocus();
215
+ await expect(disabled).not.toHaveFocus();
216
+ },
217
+ };
218
+
219
+ export const LongLabel: Story = {
220
+ args: { children: 'Nastavení oznámení', href: '#' },
221
+ parameters: {
222
+ docs: {
223
+ description: {
224
+ story:
225
+ 'A label wider than its slot: each link sits in a cell `--space-1300` wide. The label stays on one line (manifest `text.label`) and truncates with an ellipsis, and the bar spans the whole link, so it still marks the Current item at the cell\'s width; with the icon on, the glyph and the gap leave the label less room. Twenty characters is the guidance for a label.',
226
+ },
227
+ },
228
+ },
229
+ render: args => (
230
+ <Showcase>
231
+ <Section title="With icon">
232
+ <div className="w-1300 shrink-0">
233
+ <NavLink {...args} aria-current="page" />
234
+ </div>
235
+ </Section>
236
+ <Section title="Icon off">
237
+ <div className="w-1300 shrink-0">
238
+ <NavLink {...args} aria-current="page" showIcon={false} />
239
+ </div>
240
+ </Section>
241
+ </Showcase>
242
+ ),
243
+ };
@@ -0,0 +1,222 @@
1
+ "use client";
2
+ import * as React from 'react';
3
+ // The configured `tv`: its extended tailwind-merge knows that `text-body-*` is a
4
+ // font-size and `text-secondary` a colour, so the two do not annihilate each other.
5
+ import { tv, type VariantProps } from '../../internal/tailwind-variants';
6
+ import { Icon, type IconName } from '../icon/Icon';
7
+ import { cn, suppressDisabledClick } from '../../internal/utils';
8
+
9
+ /**
10
+ * NavLink — one item of a navigation group: the header menu, section tabs, a sub-nav
11
+ * (ui-system atom `nav-link`, manifest 1.4.4, Figma node 6173-36717). A ghost link in
12
+ * the `--secondary` blue with an optional decorative leading icon and a 2px indicator
13
+ * bar at its bottom edge. It marks WHERE you are, not what you trigger: an action is a
14
+ * `Button`, a footer or in-prose link a `TextLink`, an icon-only control an `IconButton`.
15
+ *
16
+ * Token bindings (manifest `families[0].states`, `indicator`, `sizes[0]`, `focus`,
17
+ * `typography.runs.label`):
18
+ * - ink (label + icon): default `--secondary`; hover and current `--secondary-active`;
19
+ * disabled `--disabled-foreground`. The icon draws in `currentColor`, so it follows
20
+ * the root's ink.
21
+ * - indicator bar: hover `--outline-strong` (the muted preview), current
22
+ * `--secondary-active`; nothing on default and disabled. Height `--border-width-200`
23
+ * (see note 1).
24
+ * - size M: row height 40 (`min-h-1000`, the `--space-1000` step, as Button md); gap
25
+ * `--space-400`; icon `--size-icon`; radius `--radius-200`; no side padding at all
26
+ * (manifest notes[0]: the spacing between items is the parent menu's `gap`).
27
+ * - label: Body/M (`text-body-base`), `--font-weight-semibold`, one line, truncated.
28
+ * - focus: additive `--outline-focus` ring on `:focus-visible`, `--border-width-200`,
29
+ * 2px outside. On the `--radius-200` root a 2px offset draws the ring at 6px, which
30
+ * is the `--radius-300` the manifest's `focus.note` asks for; no ink recolour.
31
+ *
32
+ * Notes worth knowing:
33
+ *
34
+ * 1. INDICATOR HEIGHT. The bar is `--border-width-200` tall, and the theme has no
35
+ * height utility that reads a border-width token (`--border-width-*` maps to
36
+ * border, outline and ring widths only). So the bar is an EMPTY absolutely
37
+ * positioned span whose only box is a transparent `border-b-200`: its height is
38
+ * exactly `--border-width-200`, and its `background-color` (which paints under a
39
+ * transparent border, `background-clip: border-box`) carries the state colour. The
40
+ * colour stays a fill, as the manifest's motion block describes it
41
+ * (`background-color is the 2px bottom indicator bar`).
42
+ * 2. CURRENT IS `aria-current`, NOT A PROP. The manifest maps `State=Current` to
43
+ * `aria-current="page"` (`properties[0].maps`), and the spec says "Drive Current
44
+ * from aria-current". So there is no `current` prop: pass `aria-current="page"` on
45
+ * the open route and the component reads it. Any value other than `false` /
46
+ * `"false"` counts, so `"location"` on a sub-nav paints the same cue the screen
47
+ * reader announces.
48
+ * 3. MOTION (manifest `motion.states`): ink and bar ease on `--easing-standard`, over
49
+ * `--duration-hover` for hover and `--duration-toggle` when the item becomes the
50
+ * current one. A CSS transition takes the duration of the state it is entering,
51
+ * so the current item carries `duration-toggle` and every other item
52
+ * `duration-hover`. These are colour fades, not movement, so they stay under
53
+ * `prefers-reduced-motion` as on Button and TextLink.
54
+ * 4. `!` ON THE INK. A consuming app may carry a global unlayered `a { color }` rule,
55
+ * which beats every layered colour utility on an anchor. The `!` forces only the
56
+ * precedence; the values are tokens. Same workaround as TextLink and Button.
57
+ *
58
+ * Semantics / a11y:
59
+ * - always a real `<a href>`; the label is the accessible name, the icon and the bar
60
+ * are decorative (`aria-hidden`).
61
+ * - `disabled` has no native equivalent on an anchor, so the href is dropped,
62
+ * `aria-disabled="true"` and `tabIndex={-1}` are set and clicks are suppressed in
63
+ * the CAPTURE phase (`suppressDisabledClick`, as TextLink does), so neither the
64
+ * consumer's `onClick` nor its `onClickCapture` runs. Dropping the href also drops
65
+ * the implicit `link` role, so `role="link"` is re-stated while disabled (TextLink
66
+ * does the same). A disabled item renders no `aria-current`: it shows no current
67
+ * cue, so the screen reader is not told "current page" either. While `disabled` is
68
+ * false, a consumer's own `aria-disabled` passes through untouched.
69
+ * - forced colours: the bar is a transparent border painted by its background, which
70
+ * forced-colors mode repaints as one system colour on every item, so the bar is
71
+ * `invisible` there except on the current item. The ink is forced to one system
72
+ * colour on every item too, so the bar is what keeps Current visible.
73
+ */
74
+ const navLinkVariants = tv({
75
+ slots: {
76
+ root: [
77
+ // `relative`: the indicator bar is positioned against the root. `group`: the
78
+ // bar's hover preview is driven by the pointer anywhere on the link.
79
+ 'group relative inline-flex min-w-0 max-w-full items-center',
80
+ // sizes[0] (M): 40 tap-target row, --space-400 icon↔label gap, --size-icon
81
+ // glyph, --radius-200. No padding-inline: spacing is the parent's gap.
82
+ 'min-h-1000 gap-400 rounded-200 [&_.icon]:size-icon',
83
+ 'font-inter cursor-pointer !no-underline hover:!no-underline',
84
+ '!text-secondary hover:!text-secondary-active',
85
+ 'transition-[color] duration-hover ease-standard',
86
+ // Additive offset outline per focus-ring.md (manifest focus: style offset,
87
+ // --outline-focus, 2px). Never removed, no ink change.
88
+ 'focus-visible:outline focus-visible:outline-200 focus-visible:outline-outline-focus focus-visible:outline-offset-2',
89
+ ],
90
+ icon: 'shrink-0',
91
+ // typography.runs.label: Body/M, semibold, and the style's --text-wrap-body.
92
+ // text.label: one line, truncated. The wrap token goes on the `text-wrap-style`
93
+ // longhand on purpose: the `text-wrap` shorthand also sets `text-wrap-mode`
94
+ // and could undo the `nowrap` that `truncate` depends on.
95
+ label: 'min-w-0 truncate text-body-base font-semibold [text-wrap-style:var(--text-wrap-body)]',
96
+ // The bar: see JSDoc note 1. Spans the root, which has no side padding, so it
97
+ // covers the full content row (icon + gap + label, or the label alone).
98
+ indicator: [
99
+ 'pointer-events-none absolute bottom-0 left-0 right-0',
100
+ 'border-b-200 border-transparent',
101
+ 'transition-[background-color] duration-hover ease-standard',
102
+ // Forced colours: only the current bar stays (see Semantics / a11y).
103
+ 'forced-colors:invisible',
104
+ ],
105
+ },
106
+ variants: {
107
+ current: {
108
+ true: {
109
+ root: '!text-secondary-active duration-toggle',
110
+ indicator: 'bg-secondary-active duration-toggle forced-colors:visible',
111
+ },
112
+ // Only a link that is not the current one previews the bar on hover.
113
+ false: { indicator: 'group-hover:bg-outline-strong' },
114
+ },
115
+ /**
116
+ * Declared after `current` so tailwind-merge keeps the disabled ink. The root
117
+ * takes no pointer events, so neither the hover ink nor the hover bar can fire.
118
+ * No `cursor-not-allowed`: it would sit on an element that ignores the pointer.
119
+ */
120
+ disabled: {
121
+ true: {
122
+ root: 'pointer-events-none !text-disabled-foreground hover:!text-disabled-foreground',
123
+ },
124
+ false: {},
125
+ },
126
+ },
127
+ defaultVariants: {
128
+ current: false,
129
+ disabled: false,
130
+ },
131
+ });
132
+
133
+ export type NavLinkCurrent = React.AriaAttributes['aria-current'];
134
+
135
+ export interface NavLinkProps
136
+ extends Omit<React.AnchorHTMLAttributes<HTMLAnchorElement>, 'children' | 'href'>,
137
+ Omit<VariantProps<typeof navLinkVariants>, 'current' | 'disabled'> {
138
+ /** The destination. A nav item is always a real `<a href>`. */
139
+ href: string;
140
+ /**
141
+ * `"page"` on the item of the open route: the Current state, with the indicator
142
+ * bar. The component reads it, there is no separate `current` prop. Not rendered
143
+ * while `disabled`.
144
+ */
145
+ 'aria-current'?: NavLinkCurrent;
146
+ /** Leading glyph (manifest `slots.leading-icon`, default `house`). Decorative. */
147
+ leadingIcon?: IconName;
148
+ /**
149
+ * Show the leading icon. The responsive-collapse controller turns it off first;
150
+ * the label always stays.
151
+ */
152
+ showIcon?: boolean;
153
+ /**
154
+ * Not actionable: `--disabled-foreground`, no href, `aria-disabled`, out of the tab
155
+ * order, no `aria-current`.
156
+ */
157
+ disabled?: boolean;
158
+ /** The destination's name: a short noun, which is also the accessible name. */
159
+ children: React.ReactNode;
160
+ }
161
+
162
+ function isCurrentValue(value: NavLinkCurrent): boolean {
163
+ return value != null && value !== false && value !== 'false';
164
+ }
165
+
166
+ const NavLink = React.forwardRef<HTMLAnchorElement, NavLinkProps>(
167
+ (
168
+ {
169
+ className,
170
+ href,
171
+ leadingIcon = 'house',
172
+ showIcon = true,
173
+ disabled = false,
174
+ 'aria-current': ariaCurrent,
175
+ onClick,
176
+ onClickCapture,
177
+ 'aria-disabled': ariaDisabled,
178
+ children,
179
+ ...props
180
+ },
181
+ ref,
182
+ ) => {
183
+ // A disabled item shows no current cue (the manifest has no Disabled + Current
184
+ // cell), and so does not announce one: `aria-current` is dropped with it.
185
+ const current = isCurrentValue(ariaCurrent) && !disabled;
186
+ const slots = navLinkVariants({ current, disabled });
187
+
188
+ // `data-fods-*` before the spread (a host may re-label the element as its own
189
+ // part); the behavioural props after it, so a consumer cannot shadow them.
190
+ return (
191
+ <a
192
+ ref={ref}
193
+ // data-fods-part marks the component's parts for measurement in the browser.
194
+ // Not inert in this package: `styles/base.css` scopes its reset to these attributes.
195
+ data-fods-component="nav-link"
196
+ data-fods-part="root"
197
+ {...props}
198
+ href={disabled ? undefined : href}
199
+ aria-current={disabled ? undefined : ariaCurrent}
200
+ // Without an href the anchor is a generic element, on which `aria-disabled`
201
+ // announces nothing, so the role is re-stated while disabled.
202
+ role={disabled ? 'link' : props.role}
203
+ aria-disabled={disabled ? true : ariaDisabled}
204
+ tabIndex={disabled ? -1 : props.tabIndex}
205
+ // While disabled the click is cancelled in the CAPTURE phase, as TextLink does,
206
+ // and the consumer's own handlers are dropped: there is nothing left for them.
207
+ onClick={disabled ? undefined : onClick}
208
+ onClickCapture={disabled ? suppressDisabledClick : onClickCapture}
209
+ className={cn(slots.root(), className)}
210
+ >
211
+ {showIcon && <Icon name={leadingIcon} data-fods-part="leading-icon" className={slots.icon()} />}
212
+ <span data-fods-part="label" className={slots.label()}>
213
+ {children}
214
+ </span>
215
+ <span data-fods-part="indicator" aria-hidden="true" className={slots.indicator()} />
216
+ </a>
217
+ );
218
+ },
219
+ );
220
+ NavLink.displayName = 'NavLink';
221
+
222
+ export { NavLink, navLinkVariants };
@@ -0,0 +1 @@
1
+ export { NavLink, navLinkVariants, type NavLinkProps, type NavLinkCurrent } from './NavLink';