@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,404 @@
1
+ import { Meta, Canvas, Controls } from '@storybook/addon-docs/blocks';
2
+ import * as ListRowStories from './ListRow.stories';
3
+
4
+
5
+ <Meta of={ListRowStories} tags={['autodocs']} />
6
+
7
+ # ListRow
8
+
9
+ ## Metadata
10
+
11
+ - **Layer:** atom
12
+ - **Status:** stable
13
+ - **Tokens used:** `--bg-active`, `--bg-hover`, `--bg-secondary`, `--disabled-foreground`, `--font-size-base`, `--font-size-sm`, `--font-size-xs`, `--font-weight-normal`, `--font-weight-semibold`, `--leading-loose`, `--leading-relaxed`, `--radius-400`, `--secondary`, `--secondary-active`, `--size-icon-small`, `--size-icon-xsmall`, `--space-100`, `--space-1000`, `--space-200`, `--space-300`, `--space-400`, `--space-500`, `--space-600`, `--status-danger`, `--text-link`, `--text-link-hover`, `--text-primary`, `--text-secondary`
14
+ - **Manifest version:** `2.7.1`
15
+
16
+ ## Overview
17
+
18
+ **ListRow** is the single **row** inside any dropdown surface — the shared atom every Menu / Select / Combobox / Popover panel is filled with. Use it for one line of a floating list: an account-menu command, a Select option, a combobox result, a filter row. Drop ListRows (+ Dividers) into a Popover surface and you have a dropdown.
19
+
20
+ **Do not** use it for a standalone clickable card, a table row with columns, or a form control — it is specifically the inside of a floating panel.
21
+
22
+ <Canvas of={ListRowStories.Playground} />
23
+
24
+ ## Rationale
25
+
26
+ Why ListRow exists as its own building block:
27
+
28
+ 1. **One row, no role.** ListRow carries **no ARIA role of its own** — the consuming organism injects `menuitem` / `option` / `menuitemradio` / `link` through rest props. A row that hard-coded a role couldn't be reused across the five family members.
29
+ 2. **One Hover visual for hover *and* keyboard.** Mouse hover and the keyboard cursor render **identically** — the soft `--bg-hover` wash, with no separate hover-vs-focus state. In code the keyboard-current case is the `highlighted` prop; visually it equals CSS `:hover`. The wash is the *whole* cue only where the row never holds DOM focus (`aria-activedescendant`); a roving-tabindex row adds a focus ring on top of it — see [Accessibility](#accessibility).
30
+ 3. **Information left, actions right.** The leading slot carries state (a checkmark / checkbox / icon); the trailing slot carries actions / navigation (a chevron). Both are colour-safe instance-swap slots. **One exception (2.6.0): at `mobile` the selected-option checkmark sits in the trailing slot** — on a bottom sheet the rows are full-width touch targets, a trailing check keeps every label on one left edge without a reserved empty column, and it reads as the row's end state. See [Selection checkmark](#selection-checkmark).
31
+ 4. **Selected ≠ bold.** Selection is a persistent **solid `--bg-secondary` fill** (+ an optional checkmark — leading at `md` / `sm`, trailing at `mobile`) — it never touches the label's weight or ink, never bolds it and never turns it blue. Hover = a transient wash; Selected = a solid fill — two fills, two meanings. What the rule is *not*: a claim that every label is Regular. **Resting weight is per family** (`families[].weight`, 1.10.0) — Regular in `default` and `danger`, **Semibold** in `nav` and `link` — and selection leaves whichever one the family renders exactly where it is.
32
+
33
+ ## Anatomy
34
+
35
+ A horizontal row composed of four parts:
36
+
37
+ - **Leading slot** (optional) — an instance-swap `icon` slot (swappable for a Checkbox or a checkmark — the checkmark only at `md` / `sm`). Carries state. Icon size `--size-icon-small` (20) on Medium, `--size-icon-xsmall` (16) on Small, applied to an `<Icon>` that is the **direct child** of the slot: wrap it in an element of your own and it keeps the Icon default `--size-icon`, while a Checkbox in the slot keeps its own check. Stays **vertically centred** on the whole row.
38
+ - **Text stack** — the **label** (`text-body-base` / `text-body-sm`, Regular in `default` / `danger` and **Semibold** in `nav` / `link`) and, under it, an optional **description** line. The label is single-line and truncates with `…` — **except on `link`**, where it may wrap to a 2nd line and truncates only past it (2.5.0); see [Label overflow](#label-overflow).
39
+ - **Count** (optional) — a trailing text run between the text stack and the trailing slot.
40
+ - **Trailing slot** (optional) — an instance-swap `icon` slot for actions / navigation (a caret on `nav`); at `mobile` also the selected-option checkmark (2.6.0). Its default glyph is `caret-right-small`. Row-centred, colour-safe.
41
+
42
+ The state fill (Hover wash / Selected solid) spans the full row at radius `--radius-400` (8) — nested inside the surface's `--radius-500` (12), which is why rows sit in a **4px-inset group** so the fill clears the panel border. Padding-inline is `--space-500` (12); with the group inset the content edge lands at 16.
43
+
44
+ **Description line** — a secondary `--text-secondary` line one type step below the label (`Body/S` on Medium, `Body/XS` on Small), Regular, capped at **max 2 lines**. The two lines are **semantic slots**, not free wrap: line 1 carries identifiers / status (`IČO: 12345678, DIČ: CZ12345678`), line 2 carries location / secondary detail (`Dlouhá 123, 110 00 Praha 1`). Pass `description` as an array `[identifiers, location]` — **each line truncates on its own** with `…`, so a long address never pushes a third line and identifiers never wrap into the address line; a single node renders one truncated line, and empty entries are omitted (no placeholders). With the description on, the row stops being fixed-height and **hugs** its text stack past the min-height. Use it for subject / entity rows only — **never on a `link` row** and never to smuggle in an action.
45
+
46
+ <Canvas of={ListRowStories.WithDescription} />
47
+
48
+ **Count** (1.8.0) — an optional trailing run carrying the **live result count** for this row's option under the current query, the shape filter / facet panels need. It sits **between the text stack and the trailing slot**, vertically centred, at the label's own Body size (`Body/M` on Medium, `Body/S` on Small) in Regular. The ink is **tone-independent**: `--text-secondary` in every variant — a count is metadata and never adopts the row's tone — and `--disabled-foreground` on a disabled row. Turn it on with `showCount` and pass the value as `count`; `0` is a legal, rendered value (an option with no matches still says so). Content is a bare locale-formatted integer, one line, up to ~6 characters (manifest `maxChars`, content guidance — not enforced). It overflows with `…` (`overflow: truncate`), but the label's text stack yields first: the count keeps its full width while the label truncates, and only cuts when the count alone no longer fits the row. The run is **layout-inert** — min-heights and slot centring are unchanged.
49
+
50
+ <Canvas of={ListRowStories.WithCount} />
51
+
52
+ ## Variants
53
+
54
+ <Canvas of={ListRowStories.Variants} />
55
+
56
+ Four variants, by **role + colour**:
57
+
58
+ <table>
59
+ <thead>
60
+ <tr><th>Variant</th><th>When</th><th>Tokens</th></tr>
61
+ </thead>
62
+ <tbody>
63
+ <tr>
64
+ <td><code>default</code></td>
65
+ <td>options, commands, results</td>
66
+ <td>label <code>--text-primary</code>, icon <code>--text-secondary</code></td>
67
+ </tr>
68
+ <tr>
69
+ <td><code>nav</code></td>
70
+ <td>navigation links (account menu); pairs with a trailing chevron when it opens a flyout</td>
71
+ <td>label <strong>Semibold</strong> / icon <code>--secondary</code>, hover <code>--secondary-active</code> (not <code>-hover</code>: since ui-system 0.9.0 that step is the same hex as the base, so it would be a no-op). The shift is triggered by hovering the <strong>whole row</strong>, not the label — see the note below the table</td>
72
+ </tr>
73
+ <tr>
74
+ <td><code>danger</code></td>
75
+ <td>destructive command (Smazat)</td>
76
+ <td>label / icon <code>--status-danger</code></td>
77
+ </tr>
78
+ <tr>
79
+ <td><code>link</code></td>
80
+ <td>standalone text-link action (manual entry, "Dalších N"); no description</td>
81
+ <td>label <code>--text-link</code> <strong>Semibold</strong> underlined (the Text Link <em>Strong</em> archetype, 1.10.0), hover <code>--text-link-hover</code>; wraps to max 2 lines (2.5.0)</td>
82
+ </tr>
83
+ </tbody>
84
+ </table>
85
+
86
+ **"Icon" above means the LEADING glyph** — it shares the label's ink in every tone and state. The
87
+ **trailing glyph is tone-independent**: neutral `--text-secondary` always (`--disabled-foreground`
88
+ when disabled), so a `nav` row's chevron never goes blue and never picks up the hover shift
89
+ (manifest 1.4.1). **The chevron still triggers it, though** — hover is one visual for the
90
+ whole row (`group` on the root, `group-hover:` on the ink), so pointing at the chevron, at
91
+ the padding or at the gaps steps the label and the leading glyph just like pointing at the
92
+ label does. Only the chevron's own ink stays neutral.
93
+
94
+ > **Glyph tier and naming are two different things.** The **tier** moved: the trailing slot's
95
+ > instance-swap default is `caret-right-small` as of `list-row` 2.2.0 — a library-wide owner
96
+ > decision of 2026-09-14 that deprecated the plain `caret-*` glyphs (icon 1.8.0). The slot box is
97
+ > unchanged; only the glyph is lighter, and the trigger family (Button Group, Split Button,
98
+ > Dropdown Button) took the same step so the small caret is one consistent affordance. The React
99
+ > `Icon` uses the canonical name `caret-right-small`; the legacy `chevron-right-small` is not
100
+ > an `IconName` in React.
101
+
102
+ The full 5 states × 4 variants × 3 sizes grid — a quick side-by-side of every variant in every state.
103
+
104
+ <Canvas of={ListRowStories.Matrix} />
105
+
106
+ ### Label overflow
107
+
108
+ `text.label` (manifest 2.5.0) splits the label's overflow by family. `default` / `nav` / `danger`
109
+ stay **single-line** and truncate with `…`. A **`link`** label may **wrap to a 2nd line** and
110
+ truncates only past it (`line-clamp-2`): a panel's only recovery action — Subject Lookup's no-match
111
+ "… nenalezen, údaje zadám ručně" — must never lose its verb to an ellipsis. The row hugs
112
+ vertically (heights in `sizes` are min-heights), so a 2-line link row simply grows by one label
113
+ line box; nothing else in the row moves.
114
+
115
+ <Canvas of={ListRowStories.LabelOverflow} />
116
+
117
+ ### Selection checkmark
118
+
119
+ The checkmark is **consumer content** — the `selected` prop only paints the fill — and manifest 2.6.0
120
+ moves it by size. Its ink is **`--secondary` (blue) at every size** (2.7.0, `slots.leading` /
121
+ `slots.trailing`): it is the one glyph that leaves the family ink, so the consumer inks it itself
122
+ (`text-secondary` on the `Icon`). `families[Default].states.selected.icon` (`--text-secondary`) is
123
+ the tone glyph's ink on a Selected row, not the checkmark's.
124
+
125
+ - **`md` / `sm`** — **leading**. Reserve the column on every other row (an `invisible` check) so the
126
+ labels share one edge.
127
+ - **`mobile`** — **trailing**, and **no reserved leading column**. The trailing wrapper stays
128
+ neutral `--text-secondary` because it also hosts the caret. With `showCount` on, the order is
129
+ label · count · check.
130
+
131
+ A single-select panel marks the chosen row with **both** the Selected fill and the checkmark.
132
+
133
+ Never put the check in the trailing slot at `md` / `sm`, or in the leading slot at `mobile`.
134
+
135
+ <Canvas of={ListRowStories.SelectedCheckmark} />
136
+
137
+ ## Sizes
138
+
139
+ <Canvas of={ListRowStories.Sizes} />
140
+
141
+ Two densities plus one platform row. **`md` / `sm` are densities**, set by the **trigger** the panel opens from (one step below the Text Field / Select shell) — **not** the button S/M/L scale. **`mobile` is not a third density step**: manifest 2.0.0 makes it platform-driven, used unconditionally on a touch surface (Drawer, bottom sheet) and never picked by matching a trigger. Since 1.3.0 the values are **min-heights**: a single-line row renders them pixel-identically, and a row with a description grows to hug its text stack. Use one value per panel — and never mix `mobile` with `md` / `sm` in the same one.
142
+
143
+ `mobile` sits outside the `xs · sm · md · lg · xl` vocabulary on purpose; the deviation was approved as `size-vocabulary-list-row-mobile` (`COMPONENT-CODE-CONVENTIONS.md` §7).
144
+
145
+ <table>
146
+ <thead>
147
+ <tr><th>Size</th><th>Padding-inline</th><th>Label font</th><th>Icon</th><th style={{ textAlign: 'right' }}>Min height</th></tr>
148
+ </thead>
149
+ <tbody>
150
+ <tr>
151
+ <td><code>md</code> (Medium)</td>
152
+ <td><code>--space-500</code> (12)</td>
153
+ <td><code>text-body-base</code></td>
154
+ <td><code>--size-icon-small</code> (20)</td>
155
+ <td style={{ textAlign: 'right' }}>40</td>
156
+ </tr>
157
+ <tr>
158
+ <td><code>sm</code> (Small)</td>
159
+ <td><code>--space-500</code> (12)</td>
160
+ <td><code>text-body-sm</code></td>
161
+ <td><code>--size-icon-xsmall</code> (16)</td>
162
+ <td style={{ textAlign: 'right' }}>36</td>
163
+ </tr>
164
+ <tr>
165
+ <td><code>mobile</code> (Mobile)</td>
166
+ <td><code>--space-500</code> (12)</td>
167
+ <td><code>text-body-base</code></td>
168
+ <td><code>--size-icon-small</code> (20)</td>
169
+ <td style={{ textAlign: 'right' }}>56</td>
170
+ </tr>
171
+ </tbody>
172
+ </table>
173
+
174
+ ## States
175
+
176
+ <Canvas of={ListRowStories.States} />
177
+
178
+ Five states the consuming organism drives, plus the CSS-only Pressed. **This atom** ships ringless — see [Accessibility](#accessibility) for why that depends on the consumer's keyboard model, not on the row.
179
+
180
+ <table>
181
+ <thead>
182
+ <tr><th>State</th><th>Prop</th><th>Token / behaviour</th></tr>
183
+ </thead>
184
+ <tbody>
185
+ <tr>
186
+ <td><strong>Default</strong></td>
187
+ <td>—</td>
188
+ <td>no fill; label in the variant colour at its family's resting weight — Regular on <code>default</code> / <code>danger</code>, Semibold on <code>nav</code> / <code>link</code></td>
189
+ </tr>
190
+ <tr>
191
+ <td><strong>Hover</strong></td>
192
+ <td><code>:hover</code> / <code>highlighted</code></td>
193
+ <td>soft <code>--bg-hover</code> wash — one visual for mouse hover <em>and</em> keyboard-current, rendered as a <code>::before</code> overlay. Wash and ink shift are <strong>one visual for the whole row</strong>: both fire from anywhere on it, the trailing chevron and the padding included</td>
194
+ </tr>
195
+ <tr>
196
+ <td><strong>Selected</strong></td>
197
+ <td><code>selected</code></td>
198
+ <td>persistent solid <code>--bg-secondary</code> fill; selection changes neither the label's weight nor its ink — it never bolds and never turns blue, whatever the family's resting weight is. The single-Select selection checkmark is <code>--secondary</code> (blue) at every size (2.7.0, <code>slots.leading</code> / <code>slots.trailing</code> — not <code>families[Default].states.selected.icon</code>, which stays the tone glyph's <code>--text-secondary</code>), supplied by the consumer — the <code>selected</code> prop itself only adds the fill, it does not recolour the icon. At <code>mobile</code> the check goes <strong>trailing</strong> (2.6.0) — see <a href="#selection-checkmark">Selection checkmark</a></td>
199
+ </tr>
200
+ <tr>
201
+ <td><strong>Selected + Hover</strong></td>
202
+ <td><code>selected highlighted</code></td>
203
+ <td>Hover wash layered <em>over</em> the Selected solid fill (<code>::before</code> above the fill). Hover's <strong>ink shift applies here too</strong> — a selected <code>nav</code> row still steps to <code>--secondary-active</code>, a <code>link</code> row to <code>--text-link-hover</code> (manifest 1.4.0; before that the shift stopped once the row was selected, so hovering a selected row rendered a <em>lighter</em> label than hovering an unselected one)</td>
204
+ </tr>
205
+ <tr>
206
+ <td><strong>Pressed</strong></td>
207
+ <td><code>:active</code></td>
208
+ <td>the same <code>::before</code> wash steps to <code>--bg-active</code>, ink unchanged; on a Selected row it layers over the <code>--bg-secondary</code> fill. A <strong>code rule</strong> (manifest 2.4.0) — Figma draws no Pressed variant and <code>axes.state</code> does not list it, so it is a CSS state with no prop and no Matrix column</td>
209
+ </tr>
210
+ <tr>
211
+ <td><strong>Disabled</strong></td>
212
+ <td><code>disabled</code></td>
213
+ <td><code>--disabled-foreground</code> label + icons, no wash, non-interactive (<code>aria-disabled</code>, no pointer events, and an injected <code>onClick</code> is suppressed)</td>
214
+ </tr>
215
+ </tbody>
216
+ </table>
217
+
218
+ **Motion** (manifest 2.7.1 `motion.states`, all on `--easing-standard`). **Hover** — the `::before` wash
219
+ fades in (`opacity`) and the `nav` / `link` label and leading-glyph ink steps (`color`) over
220
+ `--duration-hover` (150ms); keyboard `highlighted` uses the same timing. **Press** — the wash's
221
+ `background-color` steps to `--bg-active` over `--duration-press` (100ms). **Toggle** — the root's
222
+ Selected fill (`background-color`) flips over `--duration-toggle` (100ms). Every property list is explicit
223
+ (`transition-[background-color]`, `transition-[color]`, `before:transition-[opacity,background-color]`), never
224
+ `transition-colors`, so the inset focus ring an organism adds is never eased. The wash is a layer above the
225
+ Selected fill, so its hover fades by `opacity` rather than by `background-color` — the visual the manifest
226
+ describes. Colour only, nothing moves, so there is no reduced-motion override.
227
+
228
+ Naming: the state is **Selected**, not "Active" — Active is the Button family's pressed (`:active`) state; a row's persistent state is selection (`[aria-selected]`).
229
+
230
+ The full state grid across all variants and all three sizes is in the <code>Matrix</code> story.
231
+
232
+ ## API
233
+
234
+ <Controls />
235
+
236
+ ## Do / Don't
237
+
238
+ - ✅ Let the organism set the role (`menuitem` / `option` / `link`) via rest props — keep the row role-free.
239
+ - ✅ Use the same soft Hover wash for hover and keyboard-current (`highlighted`).
240
+ - ✅ Mark selection with the solid Selected fill; if you add the optional leading checkmark, reserve the column so labels align.
241
+ - ✅ At `mobile` put the checkmark in `trailing` instead, with no reserved leading column; ink it `--secondary` at every size.
242
+ - ✅ Pick the density from the trigger (Medium 40 / Small 36) and keep one density per panel.
243
+ - ✅ Use `description` for subject / entity rows that carry metadata (IČO/DIČ, address, status).
244
+ - ❌ Bold or recolour the label to show "selected" — use the solid fill (+ optional checkmark).
245
+ - ❌ Put the checkmark in `trailing` at `md` / `sm`, or in `leading` at `mobile`.
246
+ - ❌ Name the state "Active" in code — this is `[aria-selected]`, not the Button `:active`.
247
+ - ❌ Put a focus ring on a `listbox` **option** — the trigger holds focus there, and the wash is the whole cue. (A `menu` row is the opposite case: it holds real DOM focus and **must** ring. See Accessibility.)
248
+ - ❌ Mix Medium and Small rows in one panel.
249
+ - ❌ Put interactive controls inside a row that is itself a single `option`.
250
+ - ❌ Try to render the row AS an anchor or a button — it is deliberately not polymorphic (there is no `asChild`): its `children` are the label, and interactivity belongs to the organism. The `link` variant styles the label in place (`--text-link`, Semibold, underlined) rather than nesting a [`TextLink`](?path=/docs/design-system-atoms-textlink--docs) — the manifest dropped `slots.link` (`notes[2]`), so the styled text is the contract, not a divergence.
251
+ - ❌ Put a description on a `link` row, grow it past 2 lines, or use it to smuggle in an action / instruction.
252
+ - ❌ Recolour the `count` to match the row's tone, or use it for anything but a result count (it is not a badge and not a status).
253
+
254
+ ## Accessibility
255
+
256
+ - **Keyboard** — the current row is pointed at by `aria-activedescendant` (Select / Combobox on an anchored panel; Combobox results on the bottom sheet) or holds roving `tabindex` (Menu; Select / Menu / Simple List options on the bottom sheet); disabled rows are skipped by keyboard navigation. All of this is driven by the consuming organism — ListRow itself renders no interaction handlers.
257
+ - **ARIA** — ListRow is **role-free**; the consumer injects `role` and selection semantics (`aria-selected` / `aria-checked` / `aria-current`) through rest props. `disabled` sets `aria-disabled` automatically and also suppresses an injected `onClick` — `pointer-events-none` stops the mouse, but a keyboard-generated or programmatic click ignores pointer events, so a disabled row needs the handler guard on top.
258
+ - **Screen reader** — the label is the accessible name; selection / current state is conveyed by ARIA state, **not** by the visual fill alone. The soft description line reads after the label when present.
259
+ - **Focus — split by keyboard model, not by appearance** (`list-row.manifest.json` 2.6.0 → `focus`; `focus-ring.md` → Map). A row that is an **`option`** pointed at by `aria-activedescendant` (Select / Combobox on an anchored panel; Combobox results on the mobile bottom sheet, where the sheet's search input owns it) carries **no ring**: the trigger or search input holds DOM focus, and the Hover wash is the whole keyboard-current cue. A row with a **roving `tabindex`** (Menu; Select / Menu / Simple List options on the bottom sheet) holds real DOM focus and therefore **must** ring — a 3%-opacity wash is not a visible focus indicator (WCAG 2.4.7). The ring is `--outline-focus` at `--border-width-200`, **inset** and a **single band**: rows sit flush in a scrolling panel, so an offset ring would overlap its neighbours and be clipped, and no row state puts a colour under the ring that `--outline-focus` cannot read against (4.45:1 on `--bg-primary`, 4.22:1 over the wash, 4.20:1 on the Selected fill) — so no `--bg-primary` gap band. This atom stays ringless because it carries no `role`; the organism that gives the row a roving `tabindex` adds the ring (`Menu.tsx` → `MENU_ROW_FOCUS_RING`).
260
+ - **Keyboard-current wash contrast — a known, owner-signed exception.** On an `aria-activedescendant` row the `--bg-hover` wash is the only keyboard cue and measures **1.06:1** against the resting surface. Accepted as-is by the design owner and recorded in the upstream registry (`spec/01-foundations/accessibility.md`) with the measured numbers, the precedent boundary and a revision condition, plus a hook in the `list-row` manifest `backlog[]`. **Do not re-raise it on every audit** — and do not "fix" it by adding a ring here, which would break the option/menuitem split above.
261
+ - **Contrast & motion** — colours map 1:1 to design tokens (`--text-primary`, `--text-secondary`, `--text-link`, `--text-link-hover`, `--status-danger`, `--bg-hover`, `--bg-secondary`). Motion is colour and opacity only (`--duration-hover` / `--duration-press` / `--duration-toggle`, see [States](#states)); nothing moves, and the focus ring is never transitioned.
262
+
263
+ Accessibility floor for every FODS component: `spec/01-foundations/accessibility.md`.
264
+
265
+ ## Copy
266
+
267
+ Voice: the product tone of voice, impersonal and in-app. The row owns no fixed strings of its own: every text run is consumer content.
268
+
269
+ - **Label** (`children`) — the option, command or subject name. Single line, truncates with `…`. **The `link` family is the exception:** an action label may wrap to a second line and truncates only past it, because a panel's only way forward (Subject Lookup's no-match line, e.g. `{query} nenalezen, údaje zadám ručně`) must never lose its verb to an ellipsis. In a type-to-narrow panel (Subject Lookup) the matched substring is **bolded**, never coloured or inverted, and only in the label: matches inside identifiers are not highlighted.
270
+ - **Description** (`description`) — secondary metadata under the label, max 2 lines. Facts, not sentences: no verbs, no trailing period on a fragment. The two lines are **semantic slots, not free wrap** (table below); each truncates on its own with `…`, so a long address never pushes a third line and identifiers never wrap into the address line. Inline semibold on the numbers (`IČO: 12345678`) is a content-level override.
271
+ - **Count** (`showCount` + `count`) — a bare locale-formatted integer, the live result count for the row's option under the current query. One line, max 6 characters, truncates with `…`. No parentheses, no unit noun: ✓ `142`, ✗ `(142)` · `142 firem`. Zero is a legal, rendered value. The count is folded into the row's accessible name.
272
+
273
+ Description content model — what goes on which line:
274
+
275
+ <table>
276
+ <thead>
277
+ <tr><th>Line</th><th>Carries</th><th>Example</th></tr>
278
+ </thead>
279
+ <tbody>
280
+ <tr><td>description line 1</td><td>identifiers / status</td><td><code>IČO: 12345678, DIČ: CZ12345678</code> · <code>IBAN nevyplněno</code></td></tr>
281
+ <tr><td>description line 2</td><td>location / secondary detail</td><td><code>Dlouhá 123, 110 00 Praha 1</code></td></tr>
282
+ </tbody>
283
+ </table>
284
+
285
+ - **Fixed order, omit what is missing** — identifiers before location. A missing part simply does not render: no `DIČ: —` placeholders, no empty line. Address-only content sits on description line 1.
286
+ - **Partial identifiers** — render only what exists: `IČO: 12345678` alone (a non-VAT subject), `DIČ: CZ12345678` alone. Keep the `IČO:` / `DIČ:` prefixes so a lone number stays legible.
287
+ - **Nothing to show → no description.** A row with no secondary content leaves `description` unset and stays a plain single-line row at its min-height. Never render an empty or placeholder description line.
288
+ - **No label content** (an identifier-only subject) — the strongest identifier becomes the label (`IČO: 12345678` as the name line) and does not repeat in the description.
289
+ - Never put an instruction or an action into the description: actions live in the trailing slot or on the consuming surface.
290
+
291
+ ## Usage
292
+
293
+ ```tsx
294
+ import { ListRow, Icon } from '@invoiceonline/ui-react';
295
+
296
+ // Good — selected option in a single Select: role-free row, the organism injects
297
+ // role + selection semantics AND supplies the --secondary selection checkmark.
298
+ <ListRow
299
+ role="option"
300
+ aria-selected={selected}
301
+ selected={selected}
302
+ leading={<Icon name="check" className={selected ? 'text-secondary' : 'invisible'} />}
303
+ onClick={handleSelect}
304
+ >
305
+ Acme s.r.o.
306
+ </ListRow>
307
+
308
+ // Good — the same option on a mobile bottom sheet (2.6.0): the check goes TRAILING, still
309
+ // --secondary (2.7.0), and no leading column is reserved.
310
+ <ListRow
311
+ size="mobile"
312
+ role="option"
313
+ aria-selected={selected}
314
+ selected={selected}
315
+ trailing={selected ? <Icon name="check" className="text-secondary" /> : undefined}
316
+ onClick={handleSelect}
317
+ >
318
+ Acme s.r.o.
319
+ </ListRow>
320
+
321
+ // Good — subject row with a 2-line semantic description (each line truncates on its own)
322
+ <ListRow
323
+ leading={<Icon name="check" />}
324
+ description={['IČO: 12345678, DIČ: CZ12345678', 'Dlouhá 123, 110 00 Praha 1']}
325
+ >
326
+ Petr Novák
327
+ </ListRow>
328
+
329
+ // Don't — bold/blue is not how selection is shown; use `selected` (solid fill)
330
+ <ListRow>
331
+ <strong style={{ color: 'blue' }}>Acme s.r.o.</strong>
332
+ </ListRow>
333
+
334
+ // Don't — no description on a `link` row
335
+ <ListRow variant="link" description="anything">
336
+ View all results
337
+ </ListRow>
338
+ ```
339
+
340
+ ## Related
341
+
342
+ - **Menu / Dropdown / Select / Combobox / Popover** — the organisms ListRow is the substrate for; they compose ListRows (+ Divider) into a Popover surface and inject roles.
343
+ - **Icon** — leading / trailing slot content.
344
+ - Spec: `spec/03-atoms/list-row.md`
345
+
346
+ ## Migration notes
347
+
348
+ New atom; the manifest's baseline entry is dated 2026-07-03. The substrate for the Menu / Dropdown / Select arc. **One rule carried over from the manifest:** *"the anti-legacy 'selection never bolds' rule"* (`chrome` note). ListRow uses one soft `--bg-hover` wash for hover and a solid `--bg-secondary` fill for selection, and selection never changes the label's weight or ink.
349
+
350
+ - **2026-07-07** — the Selected model shipped as real states (`Selected` / `Selected+Hover`) so selection reads without relying on the checkmark; the Figma State axis was renamed **Active → Selected** to avoid colliding with the Button family (Active = `:active`).
351
+ - **2026-07-10** (1.3.0) — the **description line** shipped, closing the Subject Lookup gap (contact / registry rows with name + IČO/DIČ + address). The fixed 40 / 36 heights became min-heights (the row hugs); slots stay row-centred.
352
+ - **2026-08-08** (1.8.0) — the **count** run shipped for filter / facet panels (`showCount` + `count`). Hidden by default and layout-inert, so no existing row moves.
353
+ - **2026-08-14** (1.10.0) — the **`link` family went Semibold**. A link row is always a standalone action, which is the archetype `text-link.md` reserves for **Strong**; the family had been hosting the in-prose Default archetype, so the same affordance rendered at two weights across the patterns. `families[link].weight` is now `--font-weight-semibold` and no pattern overrides it. `families[nav].weight` was recorded in the same pass — nav has rendered Semibold since it shipped, the schema field for it was simply unused. Nothing else moves: the anti-legacy "selection never bolds" rule is unchanged, it just stopped being phrased as "the label is always Regular".
354
+ - **2026-08-21 / 2026-08-22** (2.0.0 + 2.1.0) — **`mobile` (56) joined `axes.size`** (major: the matrix grew a
355
+ value). It is a **platform** row, not a third density: full-screen mobile surfaces (Drawer,
356
+ sheets) use it for every row and never mix it with `md` / `sm`, and no trigger selects it. It
357
+ shares Medium's Body/M label, 20 glyph and `--space-200` description gap; only pad-Y steps to
358
+ `--space-600` (16), which with the 24 line box lands the floor on exactly 56 —
359
+ [`ActionRow`](?path=/docs/design-system-atoms-actionrow--docs) took the same 56 in its own
360
+ 1.10.0. The value sits outside the size vocabulary by an evidenced deviation (see
361
+ [Sizes](#sizes)). 2.1.0 retitled the Figma `variant` values to Title case
362
+ (`default` → `Default` …) — a rename in the manifest and the parts map only; no prop, token or
363
+ binding moved, and the React prop stays lowercase.
364
+ - **2026-09-14** (2.2.0) — the **trailing caret moved to the small tier**: the slot's instance-swap
365
+ default steps `caret-right` → `caret-right-small`, and the plain caret was dropped from the swap's
366
+ preferred values (plain `caret-*` deprecated library-wide, icon 1.8.0); the slot
367
+ box, its geometry and its neutral ink are unchanged — only the glyph is lighter. ListRow ships no
368
+ trailing glyph of its own (`trailing` is a consumer-supplied `ReactNode`), so nothing in the
369
+ component moved; the stories now hand in `caret-right-small`.
370
+ - **2026-09-29** (2.4.0) — **Pressed** recorded as a code rule: the `::before` wash steps to
371
+ `--bg-active` on `:active`, ink unchanged, layered over `--bg-secondary` on a Selected row (new
372
+ code; no prop, no Matrix column — Figma draws no Pressed variant). The description-row heights in
373
+ `sizes[].note` were corrected to include `descriptionGap` (Medium 66, Small 56, were 62 / 54) —
374
+ the row hugs its content, so nothing in the component moved.
375
+ - **2026-10-05** (2.4.2) — the description-row heights in `sizes[].note` are now derived from the
376
+ token line-heights instead of rounded: Body/S and Body/XS bind `--leading-loose` (1.6), so Medium
377
+ is 66.4 / 88.8 (one / two lines), Small 57.2 / 78, Mobile 82.4. Records what the row already
378
+ measures — no token, prop or class moved.
379
+ - **2026-10-09** (2.4.3) — `sizes[].icon` names the icon slot box by its size token instead of a
380
+ px value. Same sizes.
381
+ - **2026-10-12** (2.5.0 + 2.5.1) — the **`link` label may wrap to 2 lines**, then truncates
382
+ (`line-clamp-2`); the other families stay single-line — see [Label overflow](#label-overflow).
383
+ 2.5.1 only re-describes the link label per tier: Figma nests a Text Link instance, the code keeps
384
+ rendering styled text with no nested `<a>` (the 2.3.0 ARIA reason stands). No code change.
385
+ - **2026-10-19** (2.6.0) — at **`mobile`** the selected-option **checkmark moves to the trailing
386
+ slot**, inked `--text-primary`, with no reserved leading column (the bottom sheet list overlays
387
+ open as below `sm`); `md` / `sm` keep the leading `--text-secondary` check. The same release
388
+ scopes the focus model to the surface: on the bottom sheet Select / Menu / Simple List options
389
+ hold roving focus and take the inset ring, Combobox results stay `aria-activedescendant` options.
390
+ The check is consumer content, so no recipe class moved — the docs, the JSDoc and the
391
+ `SelectedCheckmark` story carry the rule.
392
+ - **2026-10-20** (2.7.0) — the selection **checkmark ink is `--secondary` (blue) at every size**:
393
+ leading at `md` / `sm` (was `--text-secondary`), trailing at `mobile` (was `--text-primary`). The
394
+ manifest gives the checkmark its own ink in `slots.leading` / `slots.trailing`;
395
+ `families[Default].states.selected.icon` stays `--text-secondary` for the tone glyph. A single-select
396
+ panel keeps the Selected fill plus the checkmark. The atom's recipe
397
+ is unchanged (the check is consumer content); `Select`, `Combobox` and `FilterFacet` recolour their
398
+ checks, and `FilterFacet` single passes `selected` again (an earlier build had dropped the fill).
399
+ - **2026-11-03** (2.7.1) — **motion audit**: the manifest gains `motion.states.hover` / `press` /
400
+ `toggle`. The untokenised `transition-colors duration-150` on the root and
401
+ `transition-opacity duration-150` on the wash became `--duration-toggle` (Selected fill),
402
+ `--duration-hover` / `--duration-press` (wash) and `--duration-hover` (label / leading ink, which
403
+ had no transition before) on `--easing-standard`, over explicit property lists — see
404
+ [States](#states) → Motion.