@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,686 @@
1
+ import { Meta, Canvas, Controls } from '@storybook/addon-docs/blocks';
2
+ import * as ActionRowStories from './ActionRow.stories';
3
+
4
+ <Meta of={ActionRowStories} tags={['autodocs']} />
5
+
6
+ # ActionRow
7
+
8
+ ## Metadata
9
+
10
+ - **Layer:** atom
11
+ - **Status:** stable
12
+ - **Tokens used:** `--bg-active`, `--bg-hover`, `--bg-primary`, `--border-width-100`, `--border-width-200`, `--font-heading`, `--font-size-base`, `--font-size-heading-h5`, `--font-size-sm`, `--font-weight-normal`, `--font-weight-semibold`, `--leading-loose`, `--leading-relaxed`, `--outline-focus`, `--radius-400`, `--secondary`, `--secondary-hover`, `--secondary-solid`, `--secondary-subtle`, `--secondary-tint-foreground`, `--size-icon-small`, `--space-100`, `--space-1100`, `--space-300`, `--space-400`, `--space-500`, `--space-800`, `--space-900`, `--tertiary-tint-foreground`, `--text-inverted`, `--text-primary`, `--text-secondary`
13
+ - **Manifest version:** `2.2.4`
14
+
15
+ ## Overview
16
+
17
+ **ActionRow** is the **firm row in the account menu** — one row per firm; selecting a row switches
18
+ the active firm. The row both **navigates** (switch into this firm) and carries **inline
19
+ row-actions** (rename in place, set as home) without leaving the panel. A firm row shows a
20
+ [`FirmAvatar`](?path=/docs/design-system-atoms-firmavatar--docs) (`avatar`) and, on a firm that is
21
+ not the active one, a tariff-state [`Badge`](?path=/docs/design-system-atoms-badge--docs) (`badge`).
22
+
23
+ The same row serves **manageable-entity rows** (bank accounts, units) on a management surface —
24
+ there it takes an entity glyph through `leadingIcon` instead of the avatar.
25
+
26
+ Navigation is wired through **`onActivate`** — it fires on Enter / Space (the nav button is a real
27
+ `<button>`) and on a click anywhere in the row, including the padding and the badge.
28
+
29
+ **Do not** use it for a plain option in a Select / Combobox (→ [`ListRow`](?path=/docs/design-system-atoms-listrow--docs),
30
+ which owns no interactive controls), for a command list (→ a Menu of ListRows), or for a table row
31
+ with columns.
32
+
33
+ <Canvas of={ActionRowStories.Playground} />
34
+
35
+ ## Rationale
36
+
37
+ 1. **A navigation row *with* row-actions — deliberately not a ListRow.** A ListRow that is a
38
+ listbox `option` / `menuitem` must never wrap an interactive control. ActionRow avoids that trap
39
+ by **not putting the interactivity on the row at all**: the row root is a presentational
40
+ container, the navigation affordance is a real `<button>` around the text stack, and the
41
+ rename / set-home Icon Buttons are its **siblings**. Every control in the row — navigate,
42
+ rename, set home, confirm — stays operable and in the accessibility tree at once.
43
+ 2. **Row-actions reveal on hover / keyboard focus — desktop only; home persists.** The rename /
44
+ set-home affordances appear on hover or keyboard focus so the resting row stays quiet; the
45
+ **home house** is visible whenever the row *is* the home firm (status, not an action).
46
+ 3. **One home at a time.** Home is single-select across the firm set — the consuming organism
47
+ owns the mutual exclusion; the row only guarantees that `onSetHome` is never rendered on the
48
+ row that already is home.
49
+ 4. **Rename in place.** Editing is an **inline** state on the row itself (name → text input +
50
+ confirm), never a separate modal.
51
+ 5. **Selected marks the active firm — fill, ink *and* weight.** Three signals carry it at once
52
+ (persistent `--secondary-subtle` fill, `--secondary-tint-foreground` name, **Semi Bold**), and
53
+ the Firm Avatar turns Solid, so it still reads on Mobile, where there is no hover. The state is
54
+ named **Selected**, not "Active": Active is the Button family's pressed (`:active`) state.
55
+ 6. **The badge belongs to the other firms.** The active firm's tariff state lives in the account
56
+ card's Alert, so the Selected row never shows a badge; every other firm carries its tariff state
57
+ on its own row.
58
+
59
+ ## Anatomy
60
+
61
+ A horizontal row. Layer order (manifest `notes[2]`): **leading element** (Firm Avatar *or* entity
62
+ glyph, never both) · **text stack** (the **name** plus an optional one-line **description**) ·
63
+ **badge** · **trailing area** (the revealed **rename** and **set-home** Icon Buttons, then the
64
+ **home status** house). In **Editing** the name becomes an inline text input and a **confirm** (✓)
65
+ affordance appears.
66
+
67
+ Geometry: `rounded-400`, leading edge `pl-300` (6), trailing edge `pr-500` (12), `py-400` (8) on
68
+ Desktop / `py-500` (12) on Mobile; item gap `gap-100` (2), and the text stack carries its own
69
+ `px-300` (6), so the leading element sits 2 + 6 = 8 from the name. The trailing actions group has
70
+ `gap-400` (8). Glyphs are `--size-icon-small` (20) inside a `size-800` (24×24) hit area.
71
+
72
+ - **Firm Avatar** (`avatar`) — always rendered at `size="sm"`; its Fill is **derived** from the row:
73
+ Solid when `selected`, Subtle otherwise. The prop takes only `name` and `email` — `selected` and
74
+ `size` are not forwardable.
75
+ - **Entity glyph** (`leadingIcon`) — `--text-secondary`, 20 glyph. `avatar` and `leadingIcon` are
76
+ mutually exclusive in the TypeScript union; if both still arrive at runtime, the avatar is
77
+ rendered, the glyph dropped, and a development warning is logged.
78
+ - Either leading element **stays** in Editing — it is the firm's identity, which a rename does not
79
+ change, and the Figma Editing variant keeps both layers.
80
+ - **Description** — one line, `text-body-sm`, Regular, `--text-secondary`, truncates with `…`.
81
+ An empty string renders no line.
82
+ - **Badge** — `appearance="soft"`, `size="sm"`, `emotion` from `badge.emotion` (`success` /
83
+ `warning` / `danger`). It sits **inside** the nav button, right after the text stack, so a click
84
+ on it is a click on the row. Not rendered on the Selected row (with a development warning) and
85
+ not rendered in Editing.
86
+
87
+ **DOM shape.** The root `<div>` is **presentational** — no `role`, no `tabIndex`:
88
+
89
+ ```
90
+ <div data-selected="true|false" class="group relative …"> ← presentational, delegates the click
91
+ <div class="relative flex …">
92
+ <FirmAvatar size="sm" /> | <span>leadingIcon</span>
93
+ <button data-action-row-nav aria-current…> ← the only focus stop of the row
94
+ name · description · Badge · sr-only tooltip text · sr-only labels.home
95
+ </button>
96
+ <span> ← trailing area
97
+ <span><IconButton rename /> <IconButton setHome /></span>
98
+ <span house />
99
+ </span>
100
+ </div>
101
+ </div>
102
+ ```
103
+
104
+ While `editing`, the button is replaced by a `<div>` holding the text input — an input may not
105
+ live inside a button. `data-selected` exists for the runtime verifier: `aria-current` is absent
106
+ (not `"false"`) on an unselected row, so it cannot tell the two apart.
107
+
108
+ Implementation notes that matter when reading the code:
109
+
110
+ - **Selected+Hover is solved by layering, not by logic** — the Selected fill sits on the root
111
+ (`bg-secondary-subtle`) and the hover wash is a `::before` overlay (`before:bg-background-hover`),
112
+ so the wash simply stacks over the fill. Same mechanic as
113
+ [`ListRow`](?path=/docs/design-system-atoms-listrow--docs). The content lives in a `relative`
114
+ wrapper so it paints above `::before`.
115
+ - **The whole row is clickable through delegation, not a stretched overlay** — the root owns the
116
+ click handler and the nav button's own click (mouse *or* the one Enter / Space synthesises)
117
+ bubbles into it, so both input paths take exactly one code path.
118
+ - **Row-actions are revealed with opacity, never `hidden` / `invisible`** — they are real focus
119
+ stops (Tab), so `opacity-0` + `group-hover` / `group-focus-within` is deliberate. They carry
120
+ `pointer-events-none` while invisible, so an invisible glyph can never swallow a tap.
121
+
122
+ <Canvas of={ActionRowStories.FirmSwitcher} />
123
+
124
+ <Canvas of={ActionRowStories.WithDescription} />
125
+
126
+ <Canvas of={ActionRowStories.WithLeadingIcon} />
127
+
128
+ ## Variants
129
+
130
+ <Canvas of={ActionRowStories.Matrix} />
131
+
132
+ Three axes — **State × Home × Platform** — with **13 variants, a deliberately sparse matrix**
133
+ (not the full 5 × 2 × 2 = 20). The content toggles avatar · leading icon · description · badge sit
134
+ on top of the matrix; they are props, not variants.
135
+
136
+ <table>
137
+ <thead>
138
+ <tr><th>Axis</th><th>Values</th><th>Prop</th></tr>
139
+ </thead>
140
+ <tbody>
141
+ <tr>
142
+ <td><strong>State</strong></td>
143
+ <td>Default · Hover · Editing · Selected · Selected+Hover</td>
144
+ <td><code>highlighted</code>, <code>editing</code>, <code>selected</code></td>
145
+ </tr>
146
+ <tr>
147
+ <td><strong>Home</strong></td>
148
+ <td>Off · On</td>
149
+ <td><code>isHome</code></td>
150
+ </tr>
151
+ <tr>
152
+ <td><strong>Platform</strong></td>
153
+ <td>Desktop · Mobile</td>
154
+ <td><code>platform</code></td>
155
+ </tr>
156
+ </tbody>
157
+ </table>
158
+
159
+ <table>
160
+ <thead>
161
+ <tr><th>Platform</th><th>States that exist</th><th style={{ textAlign: 'right' }}>Variants</th></tr>
162
+ </thead>
163
+ <tbody>
164
+ <tr>
165
+ <td>Desktop</td>
166
+ <td>Default · Hover · Selected · Selected+Hover (each Home Off / On) + Editing (Home Off only)</td>
167
+ <td style={{ textAlign: 'right' }}>9</td>
168
+ </tr>
169
+ <tr>
170
+ <td>Mobile</td>
171
+ <td>Default · Selected (each Home Off / On)</td>
172
+ <td style={{ textAlign: 'right' }}>4</td>
173
+ </tr>
174
+ </tbody>
175
+ </table>
176
+
177
+ **Why sparse:** touch has neither hover nor inline editing, so Hover, Selected+Hover and Editing
178
+ deliberately do not exist on Mobile — **both `editing` and `highlighted` are ignored when
179
+ `platform="mobile"`** (the component guards them, passing them is a no-op). In Editing the row
180
+ **is** an input, so the Home axis has nothing to render — Editing is a single variant.
181
+
182
+ **Keyboard focus is not a variant.** It is the cross-cutting **focus-ring pattern**: the same
183
+ `--bg-hover` wash (recycled from Hover) **plus** an additive `--outline-focus` ring — a 2px stroke
184
+ sitting **outside** the row with a 2px gap. Because the focus lives on the nav button but the ring
185
+ belongs to the row, it is drawn with a scoped `:has()` on the root
186
+ (`has-[[data-action-row-nav]:focus-visible]:outline-200 …:outline-offset-2`), **not** a border and
187
+ **not** a bare `has-[:focus-visible]` — that would also fire for the row-actions, which ring
188
+ themselves.
189
+
190
+ ## Sizes
191
+
192
+ <Canvas of={ActionRowStories.Platforms} />
193
+
194
+ Platform is a **density axis, not a size scale** (there is no S/M/L here). The manifest files this
195
+ axis under `axes.size` with the values `Desktop` / `Mobile`; in code it is the `platform` prop, and
196
+ the two spellings name the same axis.
197
+ Pick the platform the row actually renders on — **never scale one up to fake the other**. Heights
198
+ are **min-heights**: a single-line row renders the floor with its content centred, a row with a
199
+ description hugs its text stack.
200
+
201
+ <table>
202
+ <thead>
203
+ <tr><th>Platform</th><th>Class</th><th>Padding</th><th>Behaviour</th><th style={{ textAlign: 'right' }}>Min height</th></tr>
204
+ </thead>
205
+ <tbody>
206
+ <tr>
207
+ <td><code>desktop</code></td>
208
+ <td><code>min-h-1100</code></td>
209
+ <td><code>pl-300</code> / <code>pr-500</code> / <code>py-400</code></td>
210
+ <td>pointer: hover wash, revealed row-actions, inline editing, badge tooltip</td>
211
+ <td style={{ textAlign: 'right' }}>48</td>
212
+ </tr>
213
+ <tr>
214
+ <td><code>mobile</code></td>
215
+ <td><code>min-h-[56px]</code></td>
216
+ <td><code>pl-300</code> / <code>pr-500</code> / <code>py-500</code></td>
217
+ <td>touch: Default + Selected only, no row-actions, no tooltip; home house trailing</td>
218
+ <td style={{ textAlign: 'right' }}>56</td>
219
+ </tr>
220
+ </tbody>
221
+ </table>
222
+
223
+ - **Desktop** — 8 + 24 + 8 = 40 is below the `--space-1100` floor, so a single-line row renders 48.
224
+ With the description on, Figma measures 62 (8 + 24 + 22 + 8). In code it lands ~60: the shared
225
+ `text-body-sm` class carries line-height 1.4 rather than Figma's 1.6 — the one accepted
226
+ implementation deviation the manifest records (`notes[9]`), kept consistent with
227
+ [`ListRow`](?path=/docs/design-system-atoms-listrow--docs).
228
+ - **Mobile** — 12 + 24 + 12 = 48 &lt; 56, so the floor is what renders. **56 is a raw value, not a
229
+ token**: the space scale has no 56 step (`--space-1100` = 48, `--space-1200` = 64), which the
230
+ manifest records as an open system gap. The source carries a `fods-lint-disable-next-line` for it.
231
+
232
+ Name typography is `text-body-base` (Body/M) on **both** platforms — Mobile is a taller touch row,
233
+ not smaller type.
234
+
235
+ ## States
236
+
237
+ <Canvas of={ActionRowStories.States} />
238
+
239
+ <table>
240
+ <thead>
241
+ <tr><th>State</th><th>Prop</th><th>Token / behaviour</th></tr>
242
+ </thead>
243
+ <tbody>
244
+ <tr>
245
+ <td><strong>Default</strong></td>
246
+ <td>—</td>
247
+ <td>no fill; name <code>--text-primary</code>, <strong><code>font-normal</code></strong>; toolbar hidden (<code>opacity-0</code>); Firm Avatar Subtle</td>
248
+ </tr>
249
+ <tr>
250
+ <td><strong>Hover</strong> (desktop)</td>
251
+ <td><code>:hover</code> / <code>highlighted</code></td>
252
+ <td><code>--bg-hover</code> wash as a <code>::before</code> overlay; rename / set-home fade in; name stays <strong><code>font-normal</code></strong>. Hovering a badge opens its tariff tooltip</td>
253
+ </tr>
254
+ <tr>
255
+ <td><strong>Keyboard focus</strong> (desktop)</td>
256
+ <td><code>:focus-visible</code> on the nav button</td>
257
+ <td>the Hover wash <em>plus</em> the additive offset <code>--outline-focus</code> ring, drawn on the row via <code>has-[[data-action-row-nav]:focus-visible]</code>; toolbar revealed via <code>group-focus-within</code>; on a row with a badge tooltip, the tooltip opens — <strong>not a variant</strong></td>
258
+ </tr>
259
+ <tr>
260
+ <td><strong>Pressed</strong></td>
261
+ <td><code>:active</code></td>
262
+ <td>the row's <code>::before</code> wash steps to <code>--bg-active</code> (layered over the Selected fill on the active firm); revealed rename / set-home stay visible. A <strong>code rule</strong> (manifest 2.1.0 <code>notes[6]</code>) — Figma draws no Pressed variant and <code>axes.state</code> does not list it, so it is a CSS state with no prop. Pressing a row-action is that action's press, not the row's: the row keeps its hover wash meanwhile. Unlike Hover it is <strong>not platform-gated</strong>, so on Mobile a tap presses the row straight to <code>--bg-active</code>, Selected included (manifest 2.2.0 <code>notes[5]</code>; the Platform table above lists Figma variants, and Pressed is not one)</td>
263
+ </tr>
264
+ <tr>
265
+ <td><strong>Editing</strong> (desktop)</td>
266
+ <td><code>editing</code></td>
267
+ <td><code>bg-background-primary</code> + a 1px <code>--outline-focus</code> stroke drawn as an <strong>inset outline</strong> (manifest <code>strokeMode: "inset-outline"</code>), so the row does not grow off its floor; name → text input (<code>font-normal</code>, auto-focused and selected on entering) + a <code>--text-secondary</code> confirm ✓; no wash; the avatar / leading glyph <strong>stays</strong> so the name does not shift, while description, badge, home house, rename and set-home are not rendered — confirm is the only trailing control (manifest 2.1.0 <code>notes[6]</code>); Enter commits, Esc cancels, and no key but Tab leaks out of the field</td>
268
+ </tr>
269
+ <tr>
270
+ <td><strong>Selected</strong> (both platforms)</td>
271
+ <td><code>selected</code></td>
272
+ <td>persistent <code>bg-secondary-subtle</code> fill + name <code>text-secondary-tint-foreground</code>, <strong><code>font-semibold</code></strong>; Firm Avatar Solid; no badge</td>
273
+ </tr>
274
+ <tr>
275
+ <td><strong>Selected + Hover</strong> (desktop)</td>
276
+ <td><code>selected highlighted</code></td>
277
+ <td>the wash layered <em>over</em> the same <code>--secondary-subtle</code> fill; name ink and weight as in Selected — <strong>there is no hover ink step</strong></td>
278
+ </tr>
279
+ <tr>
280
+ <td><strong>Home = On</strong> (across states)</td>
281
+ <td><code>isHome</code></td>
282
+ <td>trailing house shown as <strong>status</strong> in <code>--secondary</code> on <strong>both</strong> platforms; never dimmed with the row-actions. The glyph is decorative, so <code>labels.home</code> rides along as sr-only text inside the nav button</td>
283
+ </tr>
284
+ </tbody>
285
+ </table>
286
+
287
+ **Name weight.** `font-normal` in Default / Hover / Editing, **`font-semibold` in Selected and
288
+ Selected+Hover** — the manifest's per-state `weight` slot.
289
+
290
+ **Row-action tones — the one thing that is easy to get wrong.** The **home house at Home = On** is
291
+ `--secondary` because it is a persistent **status** (decorative). The **rename** pencil and the
292
+ **set-home** action on a non-home row rest at `--text-secondary`; on hover (and press) of the icon
293
+ itself the glyph takes `--text-primary` over IconButton's own tertiary `--bg-hover` wash at its
294
+ `rounded-200` — never `--secondary`, which is reserved for the status house so that
295
+ "nastavit jako výchozí" never looks pre-selected. Pressed keeps `--text-primary` and
296
+ steps IconButton's wash to `--bg-active` (manifest 2.1.0 `notes[6]`). The **confirm ✓** is the exception: it hovers to
297
+ `--secondary` with **no** wash — it commits, it is not a status.
298
+
299
+ **Editing caret — colour only.** The rename input keeps the browser's **native** caret and binds
300
+ its colour: `caret-tertiary-tint-foreground`. Manifest 2.1.0 (`notes[6]`) states exactly that —
301
+ "the native text caret in --tertiary-tint-foreground (colour only — its size is the browser's)" —
302
+ so what used to be the approved deviation `action-row-native-caret` (the earlier 2×20 drawn caret)
303
+ is closed.
304
+
305
+ **Disabled is not a state** of this row — a firm you cannot enter is not listed.
306
+
307
+ **Motion** (manifest 2.2.4 `motion`, all on `--easing-standard`). **Hover** — the `::before` wash fades
308
+ in (`opacity`) and the two trailing actions **fade in** while the row is hovered or keyboard-focused
309
+ (`opacity`, nothing slides), both over `--duration-hover` (150ms); the Rename / Set home glyph ink and
310
+ wash come from IconButton's own recipe (`--duration-hover`, press `--duration-press`). **Press** — the
311
+ row's wash `background-color` steps to `--bg-active` over `--duration-press` (100ms). **Toggle** — the
312
+ Selected fill (`background-color`) and the name ink (`color`) flip over `--duration-toggle` (100ms); the
313
+ Firm Avatar's Subtle ↔ Solid fill has no transition of its own and flips with the row. Badge and Tooltip
314
+ bring their own motion (`inherits`). Property lists are explicit, so the row's focus ring is never eased.
315
+ Colour and opacity only, so there is no reduced-motion override.
316
+
317
+ <Canvas of={ActionRowStories.HomeIndicator} />
318
+
319
+ <Canvas of={ActionRowStories.Editing} />
320
+
321
+ <Canvas of={ActionRowStories.RowActions} />
322
+
323
+ <Canvas of={ActionRowStories.Keyboard} />
324
+
325
+ ## API
326
+
327
+ <Controls />
328
+
329
+ The props, in the order they matter:
330
+
331
+ <table>
332
+ <thead>
333
+ <tr><th>Prop</th><th>Type</th><th>Notes</th></tr>
334
+ </thead>
335
+ <tbody>
336
+ <tr>
337
+ <td><code>name</code> <strong>(required)</strong></td>
338
+ <td><code>string</code></td>
339
+ <td>the visible label — the firm / entity name; single line, truncates with <code>…</code>. Also the rename input's accessible name</td>
340
+ </tr>
341
+ <tr>
342
+ <td><code>labels</code> <strong>(required)</strong></td>
343
+ <td><code>&#123; rename, confirm, setHome, home &#125;</code></td>
344
+ <td>accessible names for the three icon-only actions plus the sr-only home suffix. No defaults — the design system is locale-agnostic, so the consumer supplies and translates them. <code>rename</code> is also the edit input's fallback name when <code>name</code> is empty</td>
345
+ </tr>
346
+ <tr>
347
+ <td><code>platform</code></td>
348
+ <td><code>'desktop' | 'mobile'</code> (<code>desktop</code>)</td>
349
+ <td>density axis (min 48 / 56), not a size scale; <code>mobile</code> drops hover, editing, row-actions and the badge tooltip</td>
350
+ </tr>
351
+ <tr>
352
+ <td><code>onActivate</code></td>
353
+ <td><code>() =&gt; void</code></td>
354
+ <td><strong>navigation</strong> — fires on Enter / Space and on a click anywhere in the row, the badge included (the root delegates). Not fired while editing</td>
355
+ </tr>
356
+ <tr>
357
+ <td><code>selected</code></td>
358
+ <td><code>boolean</code></td>
359
+ <td>the active firm: <code>--secondary-subtle</code> fill + <code>--secondary-tint-foreground</code> Semi Bold name; turns the avatar Solid, drops the badge, sets <code>aria-current</code> on the nav button and <code>data-selected="true"</code> on the root</td>
360
+ </tr>
361
+ <tr>
362
+ <td><code>avatar</code></td>
363
+ <td><code>&#123; name?: string | null; email?: string | null &#125;</code></td>
364
+ <td>Firm Avatar, always Size S, Fill derived from <code>selected</code>. Mutually exclusive with <code>leadingIcon</code></td>
365
+ </tr>
366
+ <tr>
367
+ <td><code>leadingIcon</code></td>
368
+ <td><code>ReactNode</code></td>
369
+ <td>entity glyph for non-firm rows. Mutually exclusive with <code>avatar</code>; stays in Editing</td>
370
+ </tr>
371
+ <tr>
372
+ <td><code>description</code></td>
373
+ <td><code>string</code></td>
374
+ <td>one secondary line; renders when non-empty; single line, ellipsis; never in Editing</td>
375
+ </tr>
376
+ <tr>
377
+ <td><code>badge</code></td>
378
+ <td><code>&#123; emotion: 'success' | 'warning' | 'danger'; label: string; tooltip?: string &#125;</code></td>
379
+ <td>tariff state of a non-active firm. Dropped on the Selected row (development warning) and in Editing. <code>tooltip</code> = tariff name + end date: a Desktop tooltip and, on both platforms, visually-hidden text in the nav button's name. A Desktop badge with <code>tooltip</code> mounts a Tooltip, so it needs a <code>TooltipProvider</code> ancestor</td>
380
+ </tr>
381
+ <tr>
382
+ <td><code>isHome</code></td>
383
+ <td><code>boolean</code></td>
384
+ <td>this row is the home firm — shows the trailing house status icon and adds <code>labels.home</code> to the name</td>
385
+ </tr>
386
+ <tr>
387
+ <td><code>highlighted</code></td>
388
+ <td><code>boolean</code></td>
389
+ <td><strong>forced hover wash for keyboard-current</strong> — visually identical to <code>:hover</code>, and it also reveals the row-actions. Desktop only</td>
390
+ </tr>
391
+ <tr>
392
+ <td><code>editing</code></td>
393
+ <td><code>boolean</code></td>
394
+ <td>inline rename; ignored on <code>mobile</code></td>
395
+ </tr>
396
+ <tr>
397
+ <td><code>onRename</code></td>
398
+ <td><code>() =&gt; void</code></td>
399
+ <td>renders the pencil (desktop); omit to hide it</td>
400
+ </tr>
401
+ <tr>
402
+ <td><code>onSetHome</code></td>
403
+ <td><code>() =&gt; void</code></td>
404
+ <td>renders the set-home house (desktop, non-home rows only); omit to hide it</td>
405
+ </tr>
406
+ <tr>
407
+ <td><code>editValue</code> / <code>onEditValueChange</code></td>
408
+ <td><code>string</code> / <code>(value: string) =&gt; void</code></td>
409
+ <td>controlled value of the inline rename input</td>
410
+ </tr>
411
+ <tr>
412
+ <td><code>onEditCommit</code> / <code>onEditCancel</code></td>
413
+ <td><code>() =&gt; void</code></td>
414
+ <td>Enter / ✓ commits, Esc cancels; neither triggers the row's navigation</td>
415
+ </tr>
416
+ <tr>
417
+ <td><code>navTabIndex</code> / <code>navRef</code></td>
418
+ <td><code>number</code> / <code>Ref&lt;HTMLButtonElement&gt;</code></td>
419
+ <td>roving tabindex: set <code>-1</code> on every row but the current one and move focus through <code>navRef</code></td>
420
+ </tr>
421
+ <tr>
422
+ <td>…rest</td>
423
+ <td><code>HTMLAttributes&lt;HTMLDivElement&gt;</code> (without <code>children</code>)</td>
424
+ <td>spread on the root <code>div</code>; <code>ref</code> points at the root. A user <code>onClick</code> still fires — it runs <em>after</em> <code>onActivate</code>. Do <strong>not</strong> put <code>role</code> or <code>tabIndex</code> on the root — see Accessibility</td>
425
+ </tr>
426
+ </tbody>
427
+ </table>
428
+
429
+ ## Do / Don't
430
+
431
+ - ✅ Use it only where a row both **navigates** and needs inline management — the firm switcher and manageable-entity rows.
432
+ - ✅ Pass `avatar` on firm rows and `leadingIcon` on entity rows — one leading element per row.
433
+ - ✅ Let the avatar Fill follow the row — it is derived from `selected`, there is nothing to set.
434
+ - ✅ Pass a `badge` only on firms that are **not** the active one.
435
+ - ✅ Keep the badge label a short status (`Aktivní`, `Končí za 3 týdny`, `Tarif skončil`) and put the tariff name + date in `tooltip` (`Premium do 26. 07. 2026`).
436
+ - ✅ Mark the active firm with `selected` — fill, recoloured name, **`font-semibold`**.
437
+ - ✅ Keep exactly **one** `isHome` row across the whole set (the organism enforces it).
438
+ - ✅ Use `description` as one neutral fact (`IČO 12345678`, `IBAN nevyplněno`); nothing to say → omit it.
439
+ - ✅ Wire navigation through `onActivate` — it covers Enter / Space and a click anywhere in the row.
440
+ - ❌ Drop it into a listbox / menu where the row is an `option` / `menuitem`. Use [`ListRow`](?path=/docs/design-system-atoms-listrow--docs).
441
+ - ❌ Put `role` or `tabIndex` on the root, or rebuild activation on top of a root `onClick`.
442
+ - ❌ Pass both `avatar` and `leadingIcon`, or a `badge` on the Selected row — both are dropped with a warning.
443
+ - ❌ Give the badge its own action or link it to the tariff settings — a click on it is a click on the row.
444
+ - ❌ Chain two facts in `description` (`IBAN nevyplněno, tarif skončil`).
445
+ - ❌ Bold a name in any state other than Selected / Selected+Hover.
446
+ - ❌ Name the state "Active" in code — this is `aria-current`, not the Button `:active`.
447
+ - ❌ Reveal the toolbar at rest on desktop, or put hover / row-actions / editing on Mobile.
448
+ - ❌ Scale the Desktop row up to fake a touch target (or vice versa) — switch `platform`.
449
+ - ❌ Hide the row-actions with `hidden` / `invisible` — they must stay focusable.
450
+
451
+ ## Accessibility
452
+
453
+ - **Semantics** — the row root is a **presentational container** (no `role`, no `tabIndex`); the navigation affordance is a real `<button>` around the text stack and the row-actions are its **siblings**. Never put `role="button"` / `"menuitem"` / `"option"` on the root: all three have **presentational children**, so the rename / set-home buttons would disappear from the accessibility tree. For arrow-key navigation across rows, drive it from the organism through `navTabIndex` / `navRef`.
454
+ - **Keyboard** — Enter / Space on the nav button switches into the firm through `onActivate` (native `<button>` behaviour). Tab steps onto the rename / set-home Icon Buttons, each a real focus stop that swallows Enter / Space so a surrounding list never reads them as row activation. The badge is **not** focusable and adds no tab stop. In Editing, focus lands in the text input when the row *enters* Editing (with the name selected); **Enter commits, Esc cancels**, and **no key but Tab bubbles out** of the field. A row mounted already editing does not steal focus.
455
+ - **Focus** — the only focus stop of the row itself is the nav button, so roving tabindex is `navTabIndex={isCurrent ? 0 : -1}` plus a `navRef`. The focus ring (hover wash + additive `--outline-focus` outline, offset 2px) is painted on the **row** via `has-[[data-action-row-nav]:focus-visible]`. Each action button keeps its own `:focus-visible` ring.
456
+ - **ARIA & state** — `selected` sets `aria-current` on the nav button, not on the root. `aria-selected` is **not** used: without a listbox / grid owner it is invalid. The home house is **decorative** (not a button); the announceable half is `labels.home`, rendered as sr-only text inside the nav button. The Firm Avatar is `aria-hidden` — the name carries the firm.
457
+ - **Accessible name** — composed from the DOM in the manifest's order: name, description, badge label, the badge `tooltip` text as sr-only text, then `labels.home` on the home row ("Gama a.s. Aktivní Premium do 26. 07. 2026"). The tariff text is in the name on **both** platforms, so screen-reader users get it without the tooltip.
458
+ - **Badge tooltip** (Desktop only) — a controlled Radix Tooltip that opens on pointer hover over the badge **and** when the nav button receives `:focus-visible`, so keyboard users reach it without an extra tab stop. Any close request from Radix (e.g. Escape) clears both the hover and the focus source, so a dismissed tooltip stays dismissed while focus stays put (WCAG 1.4.13). It is visual only: the badge carries no `aria-describedby` (the text is already in the name — a description would announce it twice). No tooltip on Mobile. It needs a `TooltipProvider` above the row.
459
+ - **Rename input name** — `aria-label` is the row's `name` (the firm being renamed), distinct from its `value`, which changes with every keystroke. An empty `name` falls back to `labels.rename` — a generic name beats a nameless field (WCAG 4.1.2).
460
+ - **Action labels** — the icon-only actions carry `aria-label`s from `labels` (`rename` / `setHome` / `confirm`). None has a default, so an untranslated name cannot ship unnoticed.
461
+ - **Target size** — row-actions are 24×24 hit areas around a 20 glyph, an accepted exception (`accessibility.md` § Touch targets): pointer-only affordances on a Desktop row; the Mobile row, which is the touch surface, does not render them. While invisible they are `pointer-events-none`.
462
+ - **Contrast & motion** — every colour maps to a design token; the wash and the row-action reveal are colour / opacity fades on `--duration-hover` / `--duration-press` / `--duration-toggle` (see [States](#states)); nothing moves, and the focus ring is never transitioned.
463
+
464
+ Accessibility floor for every FODS component: `spec/01-foundations/accessibility.md`.
465
+
466
+ ## Copy
467
+
468
+ Voice: the product tone of voice, impersonal and in-app. The shared voice principles are
469
+ TextField's (`spec/03-atoms/text-field.md` → Copy); the runs below are ActionRow's own.
470
+
471
+ - **Name** (`name`) — the firm name (or the entity name on a management surface), as the firm is
472
+ named. Single line; a long name truncates with `…` and never wraps. Recommended at most 60
473
+ characters — guidance, not an enforced limit. Pass the full name (`Beta s.r.o.`) and let CSS
474
+ truncate; never shorten it by hand (`Beta s.r…`).
475
+ - **Description** (`description`) — one secondary fact about the row, e.g. `IBAN nevyplněno`.
476
+ Single line, truncates with `…`. One fact only; when several apply, the blocking fact wins
477
+ (`IBAN nevyplněno`, not `IBAN nevyplněno, tarif skončil`). Nothing to say → omit it, never an
478
+ empty or placeholder line. Not shown in Editing.
479
+
480
+ **Badge label** (`badge.label`) — the tariff state of a firm that is **not** the active one. A
481
+ short status, not a sentence. `Aktivní` means the firm's tariff is active, not that the firm is
482
+ the one currently selected; the active firm's row carries no badge.
483
+
484
+ <table>
485
+ <thead>
486
+ <tr><th>Emotion</th><th>Label</th></tr>
487
+ </thead>
488
+ <tbody>
489
+ <tr><td>Success</td><td><code>Aktivní</code></td></tr>
490
+ <tr><td>Warning</td><td><code>Končí za …</code> — counts down over the tariff's last month: <code>za měsíc</code> (28–30 days) · <code>za 3 týdny</code> (21–27) · <code>za 2 týdny</code> (14–20) · <code>za 13 dní</code> … <code>za 5 dní</code> · <code>za 4 dny</code> … <code>za 2 dny</code> · <code>zítra</code> · <code>dnes</code>. Never hours.</td></tr>
491
+ <tr><td>Danger</td><td><code>Tarif skončil</code></td></tr>
492
+ </tbody>
493
+ </table>
494
+
495
+ The tariff name and date never go into the label (not `Váš tarif Premium skončil 26. 07. 2026`);
496
+ they belong in the tooltip.
497
+
498
+ **Badge tooltip** (`badge.tooltip`) — the tariff name and its end date, nothing else, in the form
499
+ `<tariff> do <date>`: no middle dot and no extra words (not `Premium · platí do 26. 07. 2026`).
500
+ The same string is part of the nav button's accessible name as visually-hidden text. The tooltip
501
+ itself is Desktop only.
502
+
503
+ <table>
504
+ <thead>
505
+ <tr><th>Badge</th><th>Tooltip</th></tr>
506
+ </thead>
507
+ <tbody>
508
+ <tr><td><code>Aktivní</code></td><td><code>Premium do 26. 07. 2026</code></td></tr>
509
+ <tr><td><code>Končí za 3 týdny</code></td><td><code>Premium do 13. 10. 2026</code></td></tr>
510
+ <tr><td><code>Tarif skončil</code></td><td><code>Mini do 26. 07. 2023</code></td></tr>
511
+ </tbody>
512
+ </table>
513
+
514
+ **Accessible-only text** (not visible) — the rename input's name, the visually-hidden tariff text,
515
+ the visually-hidden home label and the action-button labels (`labels`); see
516
+ [Accessibility](#accessibility).
517
+
518
+ ## Usage
519
+
520
+ ```tsx
521
+ import { ActionRow, TooltipProvider, Icon } from '@invoiceonline/ui-react';
522
+
523
+ const labels = {
524
+ rename: 'Přejmenovat',
525
+ confirm: 'Potvrdit',
526
+ setHome: 'Nastavit jako výchozí',
527
+ home: 'Výchozí firma',
528
+ };
529
+
530
+ // Good — firm switcher row: avatar, tariff badge on a non-active firm, rename + set-as-home
531
+ <TooltipProvider>
532
+ <ActionRow
533
+ labels={labels}
534
+ name="Gama a.s."
535
+ avatar={{ name: 'Gama a.s.', email: 'firma@priklad.cz' }}
536
+ badge={{ emotion: 'warning', label: 'Končí za 3 týdny', tooltip: 'Premium do 13. 10. 2026' }}
537
+ selected={firm.id === currentId}
538
+ isHome={firm.isHome}
539
+ onActivate={() => switchTo(firm.id)}
540
+ onRename={() => startRename(firm.id)}
541
+ onSetHome={() => setHome(firm.id)}
542
+ />
543
+ </TooltipProvider>
544
+
545
+ // Good — roving tabindex driven by the organism
546
+ <ActionRow
547
+ labels={labels}
548
+ name="Acme s.r.o."
549
+ avatar={{ name: 'Acme s.r.o.' }}
550
+ navTabIndex={index === cursor ? 0 : -1}
551
+ navRef={index === cursor ? cursorRef : undefined}
552
+ highlighted={index === cursor}
553
+ onActivate={() => switchTo(firm.id)}
554
+ />
555
+
556
+ // Good — manageable-entity row: entity glyph + one status line
557
+ <ActionRow
558
+ labels={labels}
559
+ name="Běžný účet"
560
+ leadingIcon={<Icon name="credit-card" />}
561
+ description="IBAN nevyplněno"
562
+ onRename={() => editAccount(account.id)}
563
+ />
564
+
565
+ // Good — inline rename (desktop): Enter commits, Esc cancels
566
+ <ActionRow
567
+ labels={labels}
568
+ name={firmName}
569
+ editing
570
+ editValue={draft}
571
+ onEditValueChange={setDraft}
572
+ onEditCommit={commit}
573
+ onEditCancel={cancel}
574
+ />
575
+
576
+ // Good — touch surface: Default / Selected only, house trailing
577
+ <ActionRow labels={labels} platform="mobile" isHome selected name="Acme s.r.o." avatar={{ name: 'Acme s.r.o.' }} />
578
+
579
+ // Don't — avatar and entity glyph together (the glyph is dropped with a warning)
580
+ <ActionRow labels={labels} name="Acme s.r.o." avatar={{ name: 'Acme s.r.o.' }} leadingIcon={<Icon name="credit-card" />} />
581
+
582
+ // Don't — a badge on the active firm (dropped with a warning; the account card carries it)
583
+ <ActionRow labels={labels} selected name="Acme s.r.o." badge={{ emotion: 'success', label: 'Aktivní' }} />
584
+
585
+ // Don't — a role on the root: the rename and set-home buttons vanish from the accessibility tree
586
+ <ActionRow labels={labels} role="option" name="Acme s.r.o." onRename={rename} />
587
+ ```
588
+
589
+ ## Related
590
+
591
+ - **[`ListRow`](?path=/docs/design-system-atoms-listrow--docs)** — the sibling row: a **listbox /
592
+ menu option** that must **never** wrap an interactive control. If your row is just an option →
593
+ ListRow. If it must navigate *and* be acted on → ActionRow.
594
+ - **[`FirmAvatar`](?path=/docs/design-system-atoms-firmavatar--docs)** — the leading firm identity
595
+ chip (Size S here, Fill derived from the row).
596
+ - **[`Badge`](?path=/docs/design-system-atoms-badge--docs)** — the tariff-state badge (Soft / Small).
597
+ - **[`Tooltip`](?path=/docs/design-system-atoms-tooltip--docs)** — the Desktop tariff tooltip on the badge.
598
+ - **[`IconButton`](?path=/docs/design-system-atoms-iconbutton--docs)** — the rename / set-home /
599
+ confirm affordances (tertiary, tone overridden).
600
+ - **[Popover surface](?path=/docs/design-system-patterns-popover-surface--docs)** /
601
+ **[`Divider`](?path=/docs/design-system-atoms-divider--docs)** — the panel the rows are composed into.
602
+ - Spec: `spec/03-atoms/action-row.md`
603
+
604
+ ## Migration notes
605
+
606
+ ### 2.2.3 → 2.2.4 (motion audit)
607
+
608
+ - The manifest gains `motion.states.hover` / `press` / `toggle` and `inherits [badge, tooltip]`. The
609
+ untokenised `duration-150` transitions (root `transition-colors`, wash and row-action reveal
610
+ `transition-opacity`) became `--duration-toggle` (Selected fill, plus the name ink, which had no
611
+ transition before), `--duration-hover` / `--duration-press` (wash) and `--duration-hover` (reveal) on
612
+ `--easing-standard`, over explicit property lists — see [States](#states) → Motion.
613
+
614
+ ### 2.1.1 → 2.2.0 (pressed rules completed — no code change)
615
+
616
+ - `notes[5]` / `notes[6]` now state what the row already does: pressing a row action leaves the row
617
+ on `--bg-hover`, and on Mobile a tap presses the row straight to `--bg-active`.
618
+
619
+ ### 2.0.3 → 2.1.0 (pressed recorded — no API change)
620
+
621
+ - **Pressed** row: the `::before` wash steps to `--bg-active` on `:active` (new code). Pressing a
622
+ rename / set-home action leaves the row on its hover wash — the action owns that press.
623
+ - Rename / set-home pressed (`--text-primary` over `--bg-active`), the Editing content (leading
624
+ element stays, confirm is the only trailing control) and the native caret (colour only) were
625
+ already built that way; 2.1.0 records them, which closes the deviation `action-row-native-caret`.
626
+
627
+ ### 1.10.3 → 2.0.3 (firm-switcher re-spec — breaking API)
628
+
629
+ Manifest changelog 2.0.0: *"Firm-switcher re-spec: Show avatar (Firm Avatar S) + Show badge (Badge
630
+ Soft/Small) slots, Name/Description text props; Desktop min-height 40 → 48, Mobile pad-Y 12; home
631
+ trailing on both platforms; name + description single line with ellipsis; Selected =
632
+ --secondary-subtle + --secondary-tint-foreground Semi Bold name."* 2.0.1 – 2.0.3 are copy-only
633
+ (badge tooltip `<tariff> do <date>`, Warning countdown ending with «Končí dnes»).
634
+
635
+ <table>
636
+ <thead>
637
+ <tr><th></th><th>1.10.3</th><th>2.0.3</th></tr>
638
+ </thead>
639
+ <tbody>
640
+ <tr><td>Label</td><td><code>children</code></td><td><code>name: string</code> (required)</td></tr>
641
+ <tr><td>Description</td><td>string or array, up to 2 lines</td><td><code>description?: string</code>, 1 line, truncates</td></tr>
642
+ <tr><td>Leading</td><td><code>leading</code></td><td><code>avatar?: &#123; name; email? &#125;</code> <em>or</em> <code>leadingIcon?</code> (mutually exclusive)</td></tr>
643
+ <tr><td>Badge</td><td>—</td><td><code>badge?: &#123; emotion; label; tooltip? &#125;</code>; never on the Selected row</td></tr>
644
+ <tr><td>Home house</td><td>trailing on Desktop, leading on Mobile</td><td>trailing on both</td></tr>
645
+ <tr><td>Selected / Selected+Hover</td><td><code>--bg-secondary</code> fill; name <code>--secondary-active</code> / <code>--secondary-hover</code></td><td><code>--secondary-subtle</code> fill; name <code>--secondary-tint-foreground</code> in both (no hover ink step)</td></tr>
646
+ <tr><td>Desktop</td><td>min 40, <code>px-500</code></td><td>min 48 (<code>min-h-1100</code>), <code>pl-300</code> / <code>pr-500</code>, <code>py-400</code></td></tr>
647
+ <tr><td>Mobile</td><td>min 56, <code>py-600</code></td><td>min 56 (raw value, open system gap), <code>py-500</code></td></tr>
648
+ <tr><td>Actions gap</td><td><code>gap-200</code> (approved deviation <code>action-row-action-gap</code>)</td><td><code>gap-400</code> per manifest <code>notes[6]</code> — the deviation is closed</td></tr>
649
+ <tr><td>Rename / set-home hover</td><td><code>--secondary</code></td><td><code>--text-primary</code> ink + <code>--bg-hover</code> wash, <code>rounded-200</code></td></tr>
650
+ <tr><td>Confirm ✓ hover</td><td>as the other actions</td><td><code>--secondary</code>, no wash</td></tr>
651
+ </tbody>
652
+ </table>
653
+
654
+ **Consumer migration:**
655
+
656
+ - `<ActionRow>Acme s.r.o.</ActionRow>` → `<ActionRow name="Acme s.r.o." />` — `children` is no
657
+ longer accepted.
658
+ - `leading={…}` → `leadingIcon={…}` on entity rows; firm rows pass `avatar={{ name, email }}`.
659
+ - `description={['IBAN nevyplněno', '123456789/0800']}` → one string with the blocking fact:
660
+ `description="IBAN nevyplněno"`.
661
+ - A row showing a tariff badge with a `tooltip` on Desktop needs a `TooltipProvider` ancestor.
662
+ - The root now carries `data-selected="true|false"` (for the runtime verifier).
663
+
664
+ Editing: the leading element now **stays** (1.x hid it); badge, description and home house are
665
+ still hidden — 2.1.0 now states this in full in `notes[6]`. The rename input keeps the native
666
+ caret and now takes the manifest's caret colour (see States → *Editing caret*).
667
+
668
+ ### Earlier history (1.x)
669
+
670
+ - **2026-07-01** — new atom, renamed from the **Agenda / Agenda Row** working name; confirmed **not**
671
+ a ListRow (a ListRow-with-trailing-slot build was reverted 2026-06-30).
672
+ - **2026-07-02** — the `Focused` render variant was dropped; keyboard focus became the cross-cutting
673
+ focus-ring pattern.
674
+ - **2026-07-07** — Selected / Selected+Hover shipped (7 → 13 variants); the State axis was renamed
675
+ **Active → Selected** to avoid colliding with the Button `:active`.
676
+ - **2026-07-10** (1.3.0) — leading slot and description line; fixed heights became min-heights.
677
+ - **2026-07-31** (1.4.0) — the name is Semi Bold in Selected / Selected+Hover (the older "never
678
+ Semibold" claim was inverted).
679
+ - **2026-08-05** (1.5.0) — the row stopped being a focusable `div`: the nav affordance became a real
680
+ `<button>` with the actions as siblings, `onActivate` replaced a root `onClick`, and the Editing
681
+ stroke became an inset outline.
682
+ - **2026-08-07** (1.6.0 / 1.7.0) — per-state `weight` slot and `parts.description` ink became
683
+ machine-checkable.
684
+ - **2026-08-21** (1.10.0) — Mobile row grew 44 → 56.
685
+ - **2026-09-16** (1.10.2) — rename input named by the row's pre-edit name; 1.10.3 was a
686
+ structure-only `typography.runs` migration.