@invoiceonline/ui-react 0.0.0 → 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (738) hide show
  1. package/AGENTS.md +99 -0
  2. package/CHANGELOG.md +131 -0
  3. package/LICENSE +9 -0
  4. package/README.md +77 -1
  5. package/dist/assets/label-brush-1.svg +6 -0
  6. package/dist/assets/pattern-dark.svg +113 -0
  7. package/dist/components/action-row/ActionRow.d.ts +178 -0
  8. package/dist/components/action-row/ActionRow.js +340 -0
  9. package/dist/components/action-row/index.d.ts +2 -0
  10. package/dist/components/action-row/index.js +1 -0
  11. package/dist/components/alert/Alert.d.ts +314 -0
  12. package/dist/components/alert/Alert.js +446 -0
  13. package/dist/components/alert/index.d.ts +2 -0
  14. package/dist/components/alert/index.js +1 -0
  15. package/dist/components/anchored-panel/AnchoredPanel.d.ts +41 -0
  16. package/dist/components/anchored-panel/AnchoredPanel.js +72 -0
  17. package/dist/components/anchored-panel/index.d.ts +3 -0
  18. package/dist/components/anchored-panel/index.js +3 -0
  19. package/dist/components/badge/Badge.d.ts +146 -0
  20. package/dist/components/badge/Badge.js +258 -0
  21. package/dist/components/badge/index.d.ts +2 -0
  22. package/dist/components/badge/index.js +1 -0
  23. package/dist/components/banner/Banner.d.ts +209 -0
  24. package/dist/components/banner/Banner.js +339 -0
  25. package/dist/components/banner/index.d.ts +2 -0
  26. package/dist/components/banner/index.js +1 -0
  27. package/dist/components/button/Button.d.ts +54 -0
  28. package/dist/components/button/Button.js +312 -0
  29. package/dist/components/button/index.d.ts +2 -0
  30. package/dist/components/button/index.js +1 -0
  31. package/dist/components/button-group/ButtonGroup.d.ts +187 -0
  32. package/dist/components/button-group/ButtonGroup.js +217 -0
  33. package/dist/components/button-group/index.d.ts +2 -0
  34. package/dist/components/button-group/index.js +1 -0
  35. package/dist/components/card-select/CardSelect.d.ts +274 -0
  36. package/dist/components/card-select/CardSelect.js +561 -0
  37. package/dist/components/card-select/CardSelectGroup.d.ts +92 -0
  38. package/dist/components/card-select/CardSelectGroup.js +72 -0
  39. package/dist/components/card-select/index.d.ts +3 -0
  40. package/dist/components/card-select/index.js +3 -0
  41. package/dist/components/checkbox/Checkbox.d.ts +104 -0
  42. package/dist/components/checkbox/Checkbox.js +194 -0
  43. package/dist/components/checkbox/index.d.ts +2 -0
  44. package/dist/components/checkbox/index.js +1 -0
  45. package/dist/components/chip/Chip.d.ts +250 -0
  46. package/dist/components/chip/Chip.js +441 -0
  47. package/dist/components/chip/index.d.ts +2 -0
  48. package/dist/components/chip/index.js +1 -0
  49. package/dist/components/column-header/ColumnHeader.d.ts +144 -0
  50. package/dist/components/column-header/ColumnHeader.js +209 -0
  51. package/dist/components/column-header/index.d.ts +2 -0
  52. package/dist/components/column-header/index.js +1 -0
  53. package/dist/components/combobox-field/Combobox.d.ts +104 -0
  54. package/dist/components/combobox-field/Combobox.js +355 -0
  55. package/dist/components/combobox-field/ComboboxField.d.ts +76 -0
  56. package/dist/components/combobox-field/ComboboxField.js +98 -0
  57. package/dist/components/combobox-field/index.d.ts +3 -0
  58. package/dist/components/combobox-field/index.js +3 -0
  59. package/dist/components/date-field/DateField.d.ts +52 -0
  60. package/dist/components/date-field/DateField.js +45 -0
  61. package/dist/components/date-field/index.d.ts +2 -0
  62. package/dist/components/date-field/index.js +1 -0
  63. package/dist/components/date-picker/DatePicker.d.ts +53 -0
  64. package/dist/components/date-picker/DatePicker.js +329 -0
  65. package/dist/components/date-picker/index.d.ts +2 -0
  66. package/dist/components/date-picker/index.js +1 -0
  67. package/dist/components/divider/Divider.d.ts +81 -0
  68. package/dist/components/divider/Divider.js +93 -0
  69. package/dist/components/divider/index.d.ts +2 -0
  70. package/dist/components/divider/index.js +1 -0
  71. package/dist/components/drawer/Drawer.d.ts +128 -0
  72. package/dist/components/drawer/Drawer.js +367 -0
  73. package/dist/components/drawer/index.d.ts +2 -0
  74. package/dist/components/drawer/index.js +1 -0
  75. package/dist/components/dropdown-button/DropdownButton.d.ts +72 -0
  76. package/dist/components/dropdown-button/DropdownButton.js +122 -0
  77. package/dist/components/dropdown-button/index.d.ts +2 -0
  78. package/dist/components/dropdown-button/index.js +1 -0
  79. package/dist/components/faq/FAQ.d.ts +135 -0
  80. package/dist/components/faq/FAQ.js +258 -0
  81. package/dist/components/faq/index.d.ts +2 -0
  82. package/dist/components/faq/index.js +1 -0
  83. package/dist/components/field/Field.d.ts +118 -0
  84. package/dist/components/field/Field.js +327 -0
  85. package/dist/components/field/index.d.ts +2 -0
  86. package/dist/components/field/index.js +1 -0
  87. package/dist/components/field-pair/FieldPair.d.ts +194 -0
  88. package/dist/components/field-pair/FieldPair.js +321 -0
  89. package/dist/components/field-pair/index.d.ts +2 -0
  90. package/dist/components/field-pair/index.js +1 -0
  91. package/dist/components/file-upload/FileUpload.d.ts +137 -0
  92. package/dist/components/file-upload/FileUpload.js +434 -0
  93. package/dist/components/file-upload/index.d.ts +2 -0
  94. package/dist/components/file-upload/index.js +1 -0
  95. package/dist/components/filter-chip/FilterChip.d.ts +373 -0
  96. package/dist/components/filter-chip/FilterChip.js +517 -0
  97. package/dist/components/filter-chip/index.d.ts +2 -0
  98. package/dist/components/filter-chip/index.js +1 -0
  99. package/dist/components/filter-facet/FilterFacet.d.ts +116 -0
  100. package/dist/components/filter-facet/FilterFacet.js +632 -0
  101. package/dist/components/filter-facet/index.d.ts +2 -0
  102. package/dist/components/filter-facet/index.js +1 -0
  103. package/dist/components/firm-avatar/FirmAvatar.d.ts +75 -0
  104. package/dist/components/firm-avatar/FirmAvatar.js +119 -0
  105. package/dist/components/firm-avatar/index.d.ts +2 -0
  106. package/dist/components/firm-avatar/index.js +1 -0
  107. package/dist/components/form-actions/FormActions.d.ts +123 -0
  108. package/dist/components/form-actions/FormActions.js +195 -0
  109. package/dist/components/form-actions/index.d.ts +2 -0
  110. package/dist/components/form-actions/index.js +1 -0
  111. package/dist/components/form-block/FormBlock.d.ts +252 -0
  112. package/dist/components/form-block/FormBlock.js +420 -0
  113. package/dist/components/form-block/index.d.ts +3 -0
  114. package/dist/components/form-block/index.js +3 -0
  115. package/dist/components/form-section/FormSection.d.ts +130 -0
  116. package/dist/components/form-section/FormSection.js +206 -0
  117. package/dist/components/form-section/index.d.ts +2 -0
  118. package/dist/components/form-section/index.js +1 -0
  119. package/dist/components/heading/Heading.d.ts +69 -0
  120. package/dist/components/heading/Heading.js +79 -0
  121. package/dist/components/heading/index.d.ts +2 -0
  122. package/dist/components/heading/index.js +1 -0
  123. package/dist/components/heading-group/HeadingGroup.d.ts +258 -0
  124. package/dist/components/heading-group/HeadingGroup.js +255 -0
  125. package/dist/components/heading-group/index.d.ts +2 -0
  126. package/dist/components/heading-group/index.js +1 -0
  127. package/dist/components/hero/Hero.d.ts +268 -0
  128. package/dist/components/hero/Hero.js +316 -0
  129. package/dist/components/hero/index.d.ts +2 -0
  130. package/dist/components/hero/index.js +1 -0
  131. package/dist/components/icon/Icon.d.ts +27 -0
  132. package/dist/components/icon/Icon.js +30 -0
  133. package/dist/components/icon/index.d.ts +3 -0
  134. package/dist/components/icon/index.js +3 -0
  135. package/dist/components/icon-button/IconButton.d.ts +75 -0
  136. package/dist/components/icon-button/IconButton.js +151 -0
  137. package/dist/components/icon-button/index.d.ts +2 -0
  138. package/dist/components/icon-button/index.js +1 -0
  139. package/dist/components/item-row/ItemRow.d.ts +253 -0
  140. package/dist/components/item-row/ItemRow.js +496 -0
  141. package/dist/components/item-row/index.d.ts +2 -0
  142. package/dist/components/item-row/index.js +1 -0
  143. package/dist/components/list-row/ListRow.d.ts +165 -0
  144. package/dist/components/list-row/ListRow.js +233 -0
  145. package/dist/components/list-row/index.d.ts +2 -0
  146. package/dist/components/list-row/index.js +1 -0
  147. package/dist/components/menu/Menu.d.ts +64 -0
  148. package/dist/components/menu/Menu.js +186 -0
  149. package/dist/components/menu/index.d.ts +2 -0
  150. package/dist/components/menu/index.js +1 -0
  151. package/dist/components/modal/Modal.d.ts +272 -0
  152. package/dist/components/modal/Modal.js +788 -0
  153. package/dist/components/modal/index.d.ts +2 -0
  154. package/dist/components/modal/index.js +1 -0
  155. package/dist/components/nav-link/NavLink.d.ts +123 -0
  156. package/dist/components/nav-link/NavLink.js +157 -0
  157. package/dist/components/nav-link/index.d.ts +2 -0
  158. package/dist/components/nav-link/index.js +1 -0
  159. package/dist/components/number-field/NumberField.d.ts +62 -0
  160. package/dist/components/number-field/NumberField.js +210 -0
  161. package/dist/components/number-field/index.d.ts +2 -0
  162. package/dist/components/number-field/index.js +1 -0
  163. package/dist/components/pagination/Pagination.d.ts +133 -0
  164. package/dist/components/pagination/Pagination.js +217 -0
  165. package/dist/components/pagination/index.d.ts +3 -0
  166. package/dist/components/pagination/index.js +3 -0
  167. package/dist/components/popover-surface/index.d.ts +2 -0
  168. package/dist/components/popover-surface/index.js +1 -0
  169. package/dist/components/progress-bar/ProgressBar.d.ts +260 -0
  170. package/dist/components/progress-bar/ProgressBar.js +470 -0
  171. package/dist/components/progress-bar/index.d.ts +2 -0
  172. package/dist/components/progress-bar/index.js +1 -0
  173. package/dist/components/promo-sticker/PromoSticker.d.ts +204 -0
  174. package/dist/components/promo-sticker/PromoSticker.js +177 -0
  175. package/dist/components/promo-sticker/index.d.ts +2 -0
  176. package/dist/components/promo-sticker/index.js +1 -0
  177. package/dist/components/promo-surface/PromoSurface.d.ts +94 -0
  178. package/dist/components/promo-surface/PromoSurface.js +119 -0
  179. package/dist/components/promo-surface/index.d.ts +2 -0
  180. package/dist/components/promo-surface/index.js +1 -0
  181. package/dist/components/radio/Radio.d.ts +92 -0
  182. package/dist/components/radio/Radio.js +171 -0
  183. package/dist/components/radio/index.d.ts +2 -0
  184. package/dist/components/radio/index.js +1 -0
  185. package/dist/components/radio-group/RadioGroup.d.ts +61 -0
  186. package/dist/components/radio-group/RadioGroup.js +51 -0
  187. package/dist/components/radio-group/index.d.ts +2 -0
  188. package/dist/components/radio-group/index.js +1 -0
  189. package/dist/components/select/Select.d.ts +65 -0
  190. package/dist/components/select/Select.js +176 -0
  191. package/dist/components/select/index.d.ts +2 -0
  192. package/dist/components/select/index.js +1 -0
  193. package/dist/components/select-field/SelectField.d.ts +16 -0
  194. package/dist/components/select-field/SelectField.js +55 -0
  195. package/dist/components/select-field/index.d.ts +2 -0
  196. package/dist/components/select-field/index.js +1 -0
  197. package/dist/components/skeleton/Skeleton.d.ts +64 -0
  198. package/dist/components/skeleton/Skeleton.js +65 -0
  199. package/dist/components/skeleton/index.d.ts +2 -0
  200. package/dist/components/skeleton/index.js +1 -0
  201. package/dist/components/split-button/SplitButton.d.ts +80 -0
  202. package/dist/components/split-button/SplitButton.js +182 -0
  203. package/dist/components/split-button/index.d.ts +2 -0
  204. package/dist/components/split-button/index.js +1 -0
  205. package/dist/components/status-summary-bar/StatusSummaryBar.d.ts +118 -0
  206. package/dist/components/status-summary-bar/StatusSummaryBar.js +278 -0
  207. package/dist/components/status-summary-bar/index.d.ts +2 -0
  208. package/dist/components/status-summary-bar/index.js +1 -0
  209. package/dist/components/subject-lookup-field/SubjectLookupField.d.ts +157 -0
  210. package/dist/components/subject-lookup-field/SubjectLookupField.js +663 -0
  211. package/dist/components/subject-lookup-field/index.d.ts +2 -0
  212. package/dist/components/subject-lookup-field/index.js +1 -0
  213. package/dist/components/switch/Switch.d.ts +152 -0
  214. package/dist/components/switch/Switch.js +307 -0
  215. package/dist/components/switch/index.d.ts +2 -0
  216. package/dist/components/switch/index.js +1 -0
  217. package/dist/components/table/Table.d.ts +5 -0
  218. package/dist/components/table/Table.js +601 -0
  219. package/dist/components/table/index.d.ts +6 -0
  220. package/dist/components/table/index.js +6 -0
  221. package/dist/components/text-field/TextField.d.ts +65 -0
  222. package/dist/components/text-field/TextField.js +173 -0
  223. package/dist/components/text-field/index.d.ts +2 -0
  224. package/dist/components/text-field/index.js +1 -0
  225. package/dist/components/text-link/TextLink.d.ts +260 -0
  226. package/dist/components/text-link/TextLink.js +303 -0
  227. package/dist/components/text-link/index.d.ts +2 -0
  228. package/dist/components/text-link/index.js +1 -0
  229. package/dist/components/textarea/Textarea.d.ts +93 -0
  230. package/dist/components/textarea/Textarea.js +256 -0
  231. package/dist/components/textarea/index.d.ts +2 -0
  232. package/dist/components/textarea/index.js +1 -0
  233. package/dist/components/tooltip/Tooltip.d.ts +129 -0
  234. package/dist/components/tooltip/Tooltip.js +457 -0
  235. package/dist/components/tooltip/index.d.ts +2 -0
  236. package/dist/components/tooltip/index.js +1 -0
  237. package/dist/components/unit-field/UnitField.d.ts +46 -0
  238. package/dist/components/unit-field/UnitField.js +133 -0
  239. package/dist/components/unit-field/index.d.ts +2 -0
  240. package/dist/components/unit-field/index.js +1 -0
  241. package/dist/icons/icon-registry.generated.js +500 -0
  242. package/dist/icons/icon-types.generated.d.ts +2 -0
  243. package/dist/icons/icon-types.generated.js +126 -0
  244. package/dist/index.d.ts +132 -0
  245. package/dist/index.js +75 -0
  246. package/dist/internal/BottomSheet.js +496 -0
  247. package/dist/internal/FodsProvider.d.ts +25 -0
  248. package/dist/internal/FodsProvider.js +32 -0
  249. package/dist/internal/MotionCaret.js +35 -0
  250. package/dist/internal/NumberFormatInput.d.ts +21 -0
  251. package/dist/internal/NumberFormatInput.js +126 -0
  252. package/dist/internal/SummaryDonut.d.ts +3 -0
  253. package/dist/internal/SummaryDonut.js +300 -0
  254. package/dist/internal/buttonSegment.d.ts +44 -0
  255. package/dist/internal/buttonSegment.js +126 -0
  256. package/dist/internal/collapseRoom.js +128 -0
  257. package/dist/internal/comboboxKeys.js +44 -0
  258. package/dist/internal/contentPresence.js +46 -0
  259. package/dist/internal/dayCell.js +95 -0
  260. package/dist/internal/dialogPortal.d.ts +2 -0
  261. package/dist/internal/dialogPortal.js +21 -0
  262. package/dist/internal/donutSweeps.js +65 -0
  263. package/dist/internal/enterOnViewGeometry.js +46 -0
  264. package/dist/internal/faqItem.js +80 -0
  265. package/dist/internal/floatingLabelMotion.js +68 -0
  266. package/dist/internal/formBlockContext.d.ts +22 -0
  267. package/dist/internal/formBlockContext.js +20 -0
  268. package/dist/internal/heightRoom.js +87 -0
  269. package/dist/internal/numberSeparators.js +62 -0
  270. package/dist/internal/overlayMotion.js +48 -0
  271. package/dist/internal/paginationItem.d.ts +8 -0
  272. package/dist/internal/paginationItem.js +22 -0
  273. package/dist/internal/popoverSurface.d.ts +8 -0
  274. package/dist/internal/popoverSurface.js +23 -0
  275. package/dist/internal/portalContainer.d.ts +1 -0
  276. package/dist/internal/portalContainer.js +6 -0
  277. package/dist/internal/progressBarItem.d.ts +207 -0
  278. package/dist/internal/progressBarItem.js +264 -0
  279. package/dist/internal/selectionControlText.js +12 -0
  280. package/dist/internal/statusSummaryParts.js +371 -0
  281. package/dist/internal/summaryMotion.js +75 -0
  282. package/dist/internal/table/ChildConnector.js +62 -0
  283. package/dist/internal/table/ChildRowPrefix.d.ts +9 -0
  284. package/dist/internal/table/ChildRowPrefix.js +27 -0
  285. package/dist/internal/table/ColumnSettings.js +135 -0
  286. package/dist/internal/table/ScrollRegion.js +114 -0
  287. package/dist/internal/table/TableEmpty.js +93 -0
  288. package/dist/internal/table/TableLayout.d.ts +17 -0
  289. package/dist/internal/table/TableLayout.js +29 -0
  290. package/dist/internal/table/TableLoadStatus.js +56 -0
  291. package/dist/internal/table/TableMobile.js +488 -0
  292. package/dist/internal/table/TruncatedCell.js +33 -0
  293. package/dist/internal/table/emptyValue.js +10 -0
  294. package/dist/internal/table/features.d.ts +41 -0
  295. package/dist/internal/table/features.js +31 -0
  296. package/dist/internal/table/recipes.js +227 -0
  297. package/dist/internal/table/rowClick.js +9 -0
  298. package/dist/internal/table/types.d.ts +325 -0
  299. package/dist/internal/table/types.js +13 -0
  300. package/dist/internal/tailwind-variants.d.ts +3 -0
  301. package/dist/internal/tailwind-variants.js +37 -0
  302. package/dist/internal/tooltipContext.js +5 -0
  303. package/dist/internal/tw-merge-config.generated.js +314 -0
  304. package/dist/internal/useAnchoredPanel.d.ts +87 -0
  305. package/dist/internal/useAnchoredPanel.js +108 -0
  306. package/dist/internal/useCountUp.js +53 -0
  307. package/dist/internal/useDateFieldTrigger.js +183 -0
  308. package/dist/internal/useEChart.js +59 -0
  309. package/dist/internal/useEnterOnView.js +42 -0
  310. package/dist/internal/useFloatingBar.js +100 -0
  311. package/dist/internal/useFormReset.js +37 -0
  312. package/dist/internal/useIsMobile.js +44 -0
  313. package/dist/internal/useOneRowOverflow.js +88 -0
  314. package/dist/internal/usePrefersReducedMotion.js +25 -0
  315. package/dist/internal/useReturnFocus.js +26 -0
  316. package/dist/internal/utils.d.ts +7 -0
  317. package/dist/internal/utils.js +58 -0
  318. package/dist/node_modules/@tanstack/store/dist/store.d.ts +29 -0
  319. package/dist/node_modules/@tanstack/store/dist/types.d.ts +38 -0
  320. package/dist/node_modules/@tanstack/table-core/dist/core/cells/coreCellsFeature.d.ts +6 -0
  321. package/dist/node_modules/@tanstack/table-core/dist/core/cells/coreCellsFeature.types.d.ts +53 -0
  322. package/dist/node_modules/@tanstack/table-core/dist/core/columns/coreColumnsFeature.d.ts +6 -0
  323. package/dist/node_modules/@tanstack/table-core/dist/core/columns/coreColumnsFeature.types.d.ts +90 -0
  324. package/dist/node_modules/@tanstack/table-core/dist/core/coreFeatures.d.ts +17 -0
  325. package/dist/node_modules/@tanstack/table-core/dist/core/headers/coreHeadersFeature.d.ts +6 -0
  326. package/dist/node_modules/@tanstack/table-core/dist/core/headers/coreHeadersFeature.types.d.ts +114 -0
  327. package/dist/node_modules/@tanstack/table-core/dist/core/reactivity/coreReactivityFeature.types.d.ts +51 -0
  328. package/dist/node_modules/@tanstack/table-core/dist/core/row-models/coreRowModelsFeature.d.ts +6 -0
  329. package/dist/node_modules/@tanstack/table-core/dist/core/row-models/coreRowModelsFeature.types.d.ts +29 -0
  330. package/dist/node_modules/@tanstack/table-core/dist/core/rows/coreRowsFeature.d.ts +6 -0
  331. package/dist/node_modules/@tanstack/table-core/dist/core/rows/coreRowsFeature.types.d.ts +129 -0
  332. package/dist/node_modules/@tanstack/table-core/dist/core/table/coreTablesFeature.d.ts +6 -0
  333. package/dist/node_modules/@tanstack/table-core/dist/core/table/coreTablesFeature.types.d.ts +203 -0
  334. package/dist/node_modules/@tanstack/table-core/dist/features/cell-selection/cellSelectionFeature.d.ts +6 -0
  335. package/dist/node_modules/@tanstack/table-core/dist/features/cell-selection/cellSelectionFeature.types.d.ts +294 -0
  336. package/dist/node_modules/@tanstack/table-core/dist/features/cell-spanning/cellSpanningFeature.d.ts +11 -0
  337. package/dist/node_modules/@tanstack/table-core/dist/features/cell-spanning/cellSpanningFeature.types.d.ts +148 -0
  338. package/dist/node_modules/@tanstack/table-core/dist/features/column-faceting/columnFacetingFeature.d.ts +12 -0
  339. package/dist/node_modules/@tanstack/table-core/dist/features/column-faceting/columnFacetingFeature.types.d.ts +63 -0
  340. package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/columnFilteringFeature.d.ts +6 -0
  341. package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/columnFilteringFeature.types.d.ts +209 -0
  342. package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/filterFns.d.ts +35 -0
  343. package/dist/node_modules/@tanstack/table-core/dist/features/column-grouping/columnGroupingFeature.d.ts +6 -0
  344. package/dist/node_modules/@tanstack/table-core/dist/features/column-grouping/columnGroupingFeature.types.d.ts +128 -0
  345. package/dist/node_modules/@tanstack/table-core/dist/features/column-ordering/columnOrderingFeature.d.ts +6 -0
  346. package/dist/node_modules/@tanstack/table-core/dist/features/column-ordering/columnOrderingFeature.types.d.ts +82 -0
  347. package/dist/node_modules/@tanstack/table-core/dist/features/column-pinning/columnPinningFeature.d.ts +11 -0
  348. package/dist/node_modules/@tanstack/table-core/dist/features/column-pinning/columnPinningFeature.types.d.ts +195 -0
  349. package/dist/node_modules/@tanstack/table-core/dist/features/column-resizing/columnResizingFeature.d.ts +6 -0
  350. package/dist/node_modules/@tanstack/table-core/dist/features/column-resizing/columnResizingFeature.types.d.ts +73 -0
  351. package/dist/node_modules/@tanstack/table-core/dist/features/column-sizing/columnSizingFeature.d.ts +6 -0
  352. package/dist/node_modules/@tanstack/table-core/dist/features/column-sizing/columnSizingFeature.types.d.ts +134 -0
  353. package/dist/node_modules/@tanstack/table-core/dist/features/column-visibility/columnVisibilityFeature.d.ts +6 -0
  354. package/dist/node_modules/@tanstack/table-core/dist/features/column-visibility/columnVisibilityFeature.types.d.ts +92 -0
  355. package/dist/node_modules/@tanstack/table-core/dist/features/global-filtering/globalFilteringFeature.d.ts +6 -0
  356. package/dist/node_modules/@tanstack/table-core/dist/features/global-filtering/globalFilteringFeature.types.d.ts +67 -0
  357. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/aggregationFns.d.ts +23 -0
  358. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.d.ts +6 -0
  359. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.types.d.ts +183 -0
  360. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.utils.d.ts +18 -0
  361. package/dist/node_modules/@tanstack/table-core/dist/features/row-expanding/rowExpandingFeature.d.ts +6 -0
  362. package/dist/node_modules/@tanstack/table-core/dist/features/row-expanding/rowExpandingFeature.types.d.ts +125 -0
  363. package/dist/node_modules/@tanstack/table-core/dist/features/row-pagination/rowPaginationFeature.d.ts +6 -0
  364. package/dist/node_modules/@tanstack/table-core/dist/features/row-pagination/rowPaginationFeature.types.d.ts +135 -0
  365. package/dist/node_modules/@tanstack/table-core/dist/features/row-pinning/rowPinningFeature.d.ts +6 -0
  366. package/dist/node_modules/@tanstack/table-core/dist/features/row-pinning/rowPinningFeature.types.d.ts +76 -0
  367. package/dist/node_modules/@tanstack/table-core/dist/features/row-selection/rowSelectionFeature.d.ts +6 -0
  368. package/dist/node_modules/@tanstack/table-core/dist/features/row-selection/rowSelectionFeature.types.d.ts +187 -0
  369. package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/rowSortingFeature.d.ts +6 -0
  370. package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/rowSortingFeature.types.d.ts +236 -0
  371. package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/sortFns.d.ts +23 -0
  372. package/dist/node_modules/@tanstack/table-core/dist/features/stockFeatures.d.ts +37 -0
  373. package/dist/node_modules/@tanstack/table-core/dist/helpers/columnHelper.d.ts +47 -0
  374. package/dist/node_modules/@tanstack/table-core/dist/types/Cell.d.ts +16 -0
  375. package/dist/node_modules/@tanstack/table-core/dist/types/Column.d.ts +30 -0
  376. package/dist/node_modules/@tanstack/table-core/dist/types/ColumnDef.d.ts +123 -0
  377. package/dist/node_modules/@tanstack/table-core/dist/types/Header.d.ts +12 -0
  378. package/dist/node_modules/@tanstack/table-core/dist/types/HeaderGroup.d.ts +6 -0
  379. package/dist/node_modules/@tanstack/table-core/dist/types/Row.d.ts +24 -0
  380. package/dist/node_modules/@tanstack/table-core/dist/types/RowModel.d.ts +19 -0
  381. package/dist/node_modules/@tanstack/table-core/dist/types/RowModelFns.d.ts +11 -0
  382. package/dist/node_modules/@tanstack/table-core/dist/types/Table.d.ts +53 -0
  383. package/dist/node_modules/@tanstack/table-core/dist/types/TableFeatures.d.ts +416 -0
  384. package/dist/node_modules/@tanstack/table-core/dist/types/TableOptions.d.ts +78 -0
  385. package/dist/node_modules/@tanstack/table-core/dist/types/TableState.d.ts +46 -0
  386. package/dist/node_modules/@tanstack/table-core/dist/types/type-utils.d.ts +25 -0
  387. package/dist/shared.css +179 -0
  388. package/dist/styles.css +5467 -0
  389. package/dist/theme.css +314 -0
  390. package/dist/theme.map.json +278 -0
  391. package/dist/tokens/index.d.ts +2 -0
  392. package/dist/tokens/index.js +1 -0
  393. package/dist/tokens/tokens.generated.d.ts +2040 -0
  394. package/dist/tokens/tokens.generated.js +2053 -0
  395. package/dist/tokens.css +484 -0
  396. package/dist/tokens.flat.json +429 -0
  397. package/docs/Consuming.mdx +379 -0
  398. package/docs/Contributing.mdx +78 -0
  399. package/docs/ForAgents.mdx +53 -0
  400. package/docs/Introduction.mdx +54 -0
  401. package/llms.txt +556 -0
  402. package/package.json +351 -3
  403. package/src/components/action-row/ActionRow.mdx +686 -0
  404. package/src/components/action-row/ActionRow.stories.tsx +669 -0
  405. package/src/components/action-row/ActionRow.tsx +632 -0
  406. package/src/components/action-row/index.ts +9 -0
  407. package/src/components/alert/Alert.mdx +377 -0
  408. package/src/components/alert/Alert.stories.tsx +674 -0
  409. package/src/components/alert/Alert.tsx +579 -0
  410. package/src/components/alert/index.ts +13 -0
  411. package/src/components/anchored-panel/AnchoredPanel.mdx +381 -0
  412. package/src/components/anchored-panel/AnchoredPanel.stories.tsx +593 -0
  413. package/src/components/anchored-panel/AnchoredPanel.tsx +176 -0
  414. package/src/components/anchored-panel/index.ts +15 -0
  415. package/src/components/badge/Badge.mdx +487 -0
  416. package/src/components/badge/Badge.stories.tsx +375 -0
  417. package/src/components/badge/Badge.tsx +360 -0
  418. package/src/components/badge/index.ts +10 -0
  419. package/src/components/banner/Banner.mdx +704 -0
  420. package/src/components/banner/Banner.stories.tsx +448 -0
  421. package/src/components/banner/Banner.tsx +602 -0
  422. package/src/components/banner/index.ts +14 -0
  423. package/src/components/button/Button.mdx +286 -0
  424. package/src/components/button/Button.stories.tsx +381 -0
  425. package/src/components/button/Button.tsx +384 -0
  426. package/src/components/button/index.ts +1 -0
  427. package/src/components/button-group/ButtonGroup.mdx +512 -0
  428. package/src/components/button-group/ButtonGroup.stories.tsx +714 -0
  429. package/src/components/button-group/ButtonGroup.tsx +491 -0
  430. package/src/components/button-group/index.ts +10 -0
  431. package/src/components/card-select/CardSelect.mdx +662 -0
  432. package/src/components/card-select/CardSelect.stories.tsx +784 -0
  433. package/src/components/card-select/CardSelect.tsx +783 -0
  434. package/src/components/card-select/CardSelectGroup.tsx +169 -0
  435. package/src/components/card-select/index.ts +18 -0
  436. package/src/components/checkbox/Checkbox.mdx +269 -0
  437. package/src/components/checkbox/Checkbox.stories.tsx +306 -0
  438. package/src/components/checkbox/Checkbox.tsx +343 -0
  439. package/src/components/checkbox/index.ts +1 -0
  440. package/src/components/chip/Chip.mdx +683 -0
  441. package/src/components/chip/Chip.stories.tsx +734 -0
  442. package/src/components/chip/Chip.tsx +732 -0
  443. package/src/components/chip/index.ts +9 -0
  444. package/src/components/column-header/ColumnHeader.mdx +301 -0
  445. package/src/components/column-header/ColumnHeader.stories.tsx +319 -0
  446. package/src/components/column-header/ColumnHeader.tsx +287 -0
  447. package/src/components/column-header/index.ts +7 -0
  448. package/src/components/combobox-field/Combobox.tsx +693 -0
  449. package/src/components/combobox-field/ComboboxField.mdx +525 -0
  450. package/src/components/combobox-field/ComboboxField.stories.tsx +502 -0
  451. package/src/components/combobox-field/ComboboxField.tsx +259 -0
  452. package/src/components/combobox-field/index.ts +12 -0
  453. package/src/components/date-field/DateField.mdx +340 -0
  454. package/src/components/date-field/DateField.stories.tsx +221 -0
  455. package/src/components/date-field/DateField.tsx +176 -0
  456. package/src/components/date-field/index.ts +1 -0
  457. package/src/components/date-picker/DatePicker.mdx +436 -0
  458. package/src/components/date-picker/DatePicker.stories.tsx +458 -0
  459. package/src/components/date-picker/DatePicker.tsx +688 -0
  460. package/src/components/date-picker/index.ts +9 -0
  461. package/src/components/divider/Divider.mdx +256 -0
  462. package/src/components/divider/Divider.stories.tsx +177 -0
  463. package/src/components/divider/Divider.tsx +193 -0
  464. package/src/components/divider/index.ts +1 -0
  465. package/src/components/drawer/Drawer.mdx +518 -0
  466. package/src/components/drawer/Drawer.stories.tsx +392 -0
  467. package/src/components/drawer/Drawer.tsx +683 -0
  468. package/src/components/drawer/index.ts +1 -0
  469. package/src/components/dropdown-button/DropdownButton.mdx +285 -0
  470. package/src/components/dropdown-button/DropdownButton.stories.tsx +398 -0
  471. package/src/components/dropdown-button/DropdownButton.tsx +198 -0
  472. package/src/components/dropdown-button/index.ts +7 -0
  473. package/src/components/faq/FAQ.mdx +364 -0
  474. package/src/components/faq/FAQ.stories.tsx +343 -0
  475. package/src/components/faq/FAQ.tsx +337 -0
  476. package/src/components/faq/index.ts +1 -0
  477. package/src/components/field/Field.mdx +129 -0
  478. package/src/components/field/Field.stories.tsx +461 -0
  479. package/src/components/field/Field.tsx +765 -0
  480. package/src/components/field/index.ts +20 -0
  481. package/src/components/field-pair/FieldPair.mdx +308 -0
  482. package/src/components/field-pair/FieldPair.stories.tsx +530 -0
  483. package/src/components/field-pair/FieldPair.tsx +796 -0
  484. package/src/components/field-pair/index.ts +9 -0
  485. package/src/components/file-upload/FileUpload.mdx +345 -0
  486. package/src/components/file-upload/FileUpload.stories.tsx +698 -0
  487. package/src/components/file-upload/FileUpload.tsx +802 -0
  488. package/src/components/file-upload/index.ts +6 -0
  489. package/src/components/filter-chip/FilterChip.mdx +778 -0
  490. package/src/components/filter-chip/FilterChip.stories.tsx +827 -0
  491. package/src/components/filter-chip/FilterChip.tsx +881 -0
  492. package/src/components/filter-chip/index.ts +11 -0
  493. package/src/components/filter-facet/FilterFacet.mdx +536 -0
  494. package/src/components/filter-facet/FilterFacet.stories.tsx +506 -0
  495. package/src/components/filter-facet/FilterFacet.tsx +1160 -0
  496. package/src/components/filter-facet/index.ts +7 -0
  497. package/src/components/firm-avatar/FirmAvatar.mdx +280 -0
  498. package/src/components/firm-avatar/FirmAvatar.stories.tsx +147 -0
  499. package/src/components/firm-avatar/FirmAvatar.tsx +172 -0
  500. package/src/components/firm-avatar/index.ts +7 -0
  501. package/src/components/form-actions/FormActions.mdx +518 -0
  502. package/src/components/form-actions/FormActions.stories.tsx +621 -0
  503. package/src/components/form-actions/FormActions.tsx +273 -0
  504. package/src/components/form-actions/index.ts +6 -0
  505. package/src/components/form-block/FormBlock.mdx +728 -0
  506. package/src/components/form-block/FormBlock.stories.tsx +813 -0
  507. package/src/components/form-block/FormBlock.tsx +679 -0
  508. package/src/components/form-block/index.ts +13 -0
  509. package/src/components/form-section/FormSection.mdx +436 -0
  510. package/src/components/form-section/FormSection.stories.tsx +407 -0
  511. package/src/components/form-section/FormSection.tsx +290 -0
  512. package/src/components/form-section/index.ts +17 -0
  513. package/src/components/heading/Heading.mdx +206 -0
  514. package/src/components/heading/Heading.stories.tsx +169 -0
  515. package/src/components/heading/Heading.tsx +124 -0
  516. package/src/components/heading/index.ts +8 -0
  517. package/src/components/heading-group/HeadingGroup.mdx +521 -0
  518. package/src/components/heading-group/HeadingGroup.stories.tsx +353 -0
  519. package/src/components/heading-group/HeadingGroup.tsx +396 -0
  520. package/src/components/heading-group/index.ts +7 -0
  521. package/src/components/hero/Hero.mdx +742 -0
  522. package/src/components/hero/Hero.stories.tsx +527 -0
  523. package/src/components/hero/Hero.tsx +807 -0
  524. package/src/components/hero/index.ts +1 -0
  525. package/src/components/icon/Icon.mdx +329 -0
  526. package/src/components/icon/Icon.stories.tsx +398 -0
  527. package/src/components/icon/Icon.tsx +97 -0
  528. package/src/components/icon/index.ts +2 -0
  529. package/src/components/icon-button/IconButton.mdx +206 -0
  530. package/src/components/icon-button/IconButton.stories.tsx +341 -0
  531. package/src/components/icon-button/IconButton.tsx +273 -0
  532. package/src/components/icon-button/index.ts +1 -0
  533. package/src/components/item-row/ItemRow.mdx +533 -0
  534. package/src/components/item-row/ItemRow.stories.tsx +434 -0
  535. package/src/components/item-row/ItemRow.tsx +676 -0
  536. package/src/components/item-row/index.ts +9 -0
  537. package/src/components/list-row/ListRow.mdx +404 -0
  538. package/src/components/list-row/ListRow.stories.tsx +404 -0
  539. package/src/components/list-row/ListRow.tsx +424 -0
  540. package/src/components/list-row/index.ts +1 -0
  541. package/src/components/menu/Menu.mdx +268 -0
  542. package/src/components/menu/Menu.stories.tsx +455 -0
  543. package/src/components/menu/Menu.tsx +452 -0
  544. package/src/components/menu/index.ts +1 -0
  545. package/src/components/modal/Modal.mdx +854 -0
  546. package/src/components/modal/Modal.stories.tsx +881 -0
  547. package/src/components/modal/Modal.tsx +1434 -0
  548. package/src/components/modal/index.ts +1 -0
  549. package/src/components/nav-link/NavLink.mdx +196 -0
  550. package/src/components/nav-link/NavLink.stories.tsx +243 -0
  551. package/src/components/nav-link/NavLink.tsx +222 -0
  552. package/src/components/nav-link/index.ts +1 -0
  553. package/src/components/number-field/NumberField.mdx +223 -0
  554. package/src/components/number-field/NumberField.stories.tsx +291 -0
  555. package/src/components/number-field/NumberField.tsx +388 -0
  556. package/src/components/number-field/index.ts +6 -0
  557. package/src/components/pagination/Pagination.mdx +305 -0
  558. package/src/components/pagination/Pagination.stories.tsx +333 -0
  559. package/src/components/pagination/Pagination.tsx +343 -0
  560. package/src/components/pagination/index.ts +8 -0
  561. package/src/components/popover-surface/PopoverSurface.mdx +158 -0
  562. package/src/components/popover-surface/PopoverSurface.stories.tsx +421 -0
  563. package/src/components/popover-surface/index.ts +1 -0
  564. package/src/components/progress-bar/ProgressBar.mdx +802 -0
  565. package/src/components/progress-bar/ProgressBar.stories.tsx +533 -0
  566. package/src/components/progress-bar/ProgressBar.tsx +654 -0
  567. package/src/components/progress-bar/index.ts +9 -0
  568. package/src/components/promo-sticker/PromoSticker.mdx +436 -0
  569. package/src/components/promo-sticker/PromoSticker.stories.tsx +363 -0
  570. package/src/components/promo-sticker/PromoSticker.tsx +313 -0
  571. package/src/components/promo-sticker/index.ts +7 -0
  572. package/src/components/promo-surface/PromoSurface.mdx +399 -0
  573. package/src/components/promo-surface/PromoSurface.stories.tsx +270 -0
  574. package/src/components/promo-surface/PromoSurface.tsx +305 -0
  575. package/src/components/promo-surface/index.ts +7 -0
  576. package/src/components/radio/Radio.mdx +243 -0
  577. package/src/components/radio/Radio.stories.tsx +307 -0
  578. package/src/components/radio/Radio.tsx +288 -0
  579. package/src/components/radio/index.ts +1 -0
  580. package/src/components/radio-group/RadioGroup.mdx +119 -0
  581. package/src/components/radio-group/RadioGroup.stories.tsx +225 -0
  582. package/src/components/radio-group/RadioGroup.tsx +139 -0
  583. package/src/components/radio-group/index.ts +1 -0
  584. package/src/components/select/Select.mdx +241 -0
  585. package/src/components/select/Select.stories.tsx +404 -0
  586. package/src/components/select/Select.tsx +381 -0
  587. package/src/components/select/index.ts +1 -0
  588. package/src/components/select-field/SelectField.mdx +324 -0
  589. package/src/components/select-field/SelectField.stories.tsx +460 -0
  590. package/src/components/select-field/SelectField.tsx +138 -0
  591. package/src/components/select-field/index.ts +1 -0
  592. package/src/components/skeleton/Skeleton.mdx +194 -0
  593. package/src/components/skeleton/Skeleton.stories.tsx +260 -0
  594. package/src/components/skeleton/Skeleton.tsx +107 -0
  595. package/src/components/skeleton/index.ts +1 -0
  596. package/src/components/split-button/SplitButton.mdx +445 -0
  597. package/src/components/split-button/SplitButton.stories.tsx +465 -0
  598. package/src/components/split-button/SplitButton.tsx +361 -0
  599. package/src/components/split-button/index.ts +7 -0
  600. package/src/components/status-summary-bar/StatusSummaryBar.mdx +338 -0
  601. package/src/components/status-summary-bar/StatusSummaryBar.stories.tsx +408 -0
  602. package/src/components/status-summary-bar/StatusSummaryBar.tsx +428 -0
  603. package/src/components/status-summary-bar/index.ts +8 -0
  604. package/src/components/subject-lookup-field/SubjectLookupField.mdx +378 -0
  605. package/src/components/subject-lookup-field/SubjectLookupField.stories.tsx +393 -0
  606. package/src/components/subject-lookup-field/SubjectLookupField.tsx +1079 -0
  607. package/src/components/subject-lookup-field/index.ts +11 -0
  608. package/src/components/switch/Switch.mdx +376 -0
  609. package/src/components/switch/Switch.stories.tsx +296 -0
  610. package/src/components/switch/Switch.tsx +483 -0
  611. package/src/components/switch/index.ts +1 -0
  612. package/src/components/table/Table.mdx +575 -0
  613. package/src/components/table/Table.stories.tsx +1049 -0
  614. package/src/components/table/Table.tsx +745 -0
  615. package/src/components/table/TableConsumers.stories.tsx +195 -0
  616. package/src/components/table/_tableFixtures.ts +1189 -0
  617. package/src/components/table/index.ts +22 -0
  618. package/src/components/text-field/TextField.mdx +479 -0
  619. package/src/components/text-field/TextField.stories.tsx +366 -0
  620. package/src/components/text-field/TextField.tsx +391 -0
  621. package/src/components/text-field/index.ts +8 -0
  622. package/src/components/text-link/TextLink.mdx +353 -0
  623. package/src/components/text-link/TextLink.stories.tsx +458 -0
  624. package/src/components/text-link/TextLink.tsx +504 -0
  625. package/src/components/text-link/index.ts +10 -0
  626. package/src/components/textarea/Textarea.mdx +244 -0
  627. package/src/components/textarea/Textarea.stories.tsx +371 -0
  628. package/src/components/textarea/Textarea.tsx +489 -0
  629. package/src/components/textarea/index.ts +9 -0
  630. package/src/components/tooltip/Tooltip.mdx +462 -0
  631. package/src/components/tooltip/Tooltip.stories.tsx +500 -0
  632. package/src/components/tooltip/Tooltip.tsx +756 -0
  633. package/src/components/tooltip/index.ts +13 -0
  634. package/src/components/unit-field/UnitField.mdx +215 -0
  635. package/src/components/unit-field/UnitField.stories.tsx +291 -0
  636. package/src/components/unit-field/UnitField.tsx +255 -0
  637. package/src/components/unit-field/index.ts +7 -0
  638. package/src/icons/icon-registry.generated.ts +510 -0
  639. package/src/icons/icon-types.generated.ts +256 -0
  640. package/src/index.ts +71 -0
  641. package/src/internal/BottomSheet.tsx +714 -0
  642. package/src/internal/FodsProvider.tsx +36 -0
  643. package/src/internal/MotionCaret.tsx +53 -0
  644. package/src/internal/NumberFormatInput.tsx +276 -0
  645. package/src/internal/SummaryDonut.tsx +359 -0
  646. package/src/internal/buttonSegment.ts +241 -0
  647. package/src/internal/collapseRoom.ts +130 -0
  648. package/src/internal/comboboxKeys.ts +90 -0
  649. package/src/internal/contentPresence.ts +46 -0
  650. package/src/internal/dayCell.ts +274 -0
  651. package/src/internal/dialogPortal.ts +50 -0
  652. package/src/internal/donutSweeps.ts +77 -0
  653. package/src/internal/enterOnViewGeometry.ts +53 -0
  654. package/src/internal/faqItem.ts +104 -0
  655. package/src/internal/floatingLabelMotion.tsx +109 -0
  656. package/src/internal/formBlockContext.ts +27 -0
  657. package/src/internal/heightRoom.ts +135 -0
  658. package/src/internal/numberSeparators.ts +93 -0
  659. package/src/internal/overlayMotion.tsx +32 -0
  660. package/src/internal/paginationItem.ts +106 -0
  661. package/src/internal/popoverSurface.ts +78 -0
  662. package/src/internal/portalContainer.ts +11 -0
  663. package/src/internal/progressBarItem.ts +356 -0
  664. package/src/internal/selectionControlText.ts +42 -0
  665. package/src/internal/statusSummaryParts.tsx +475 -0
  666. package/src/internal/summaryMotion.ts +111 -0
  667. package/src/internal/table/ChildConnector.tsx +57 -0
  668. package/src/internal/table/ChildRowPrefix.tsx +21 -0
  669. package/src/internal/table/ColumnSettings.tsx +194 -0
  670. package/src/internal/table/ScrollRegion.tsx +176 -0
  671. package/src/internal/table/TableEmpty.tsx +99 -0
  672. package/src/internal/table/TableLayout.tsx +29 -0
  673. package/src/internal/table/TableLoadStatus.tsx +60 -0
  674. package/src/internal/table/TableMobile.tsx +582 -0
  675. package/src/internal/table/TruncatedCell.tsx +35 -0
  676. package/src/internal/table/emptyValue.ts +11 -0
  677. package/src/internal/table/features.ts +44 -0
  678. package/src/internal/table/recipes.ts +263 -0
  679. package/src/internal/table/rowClick.ts +8 -0
  680. package/src/internal/table/types.ts +342 -0
  681. package/src/internal/tailwind-variants.ts +65 -0
  682. package/src/internal/tooltipContext.ts +15 -0
  683. package/src/internal/tw-merge-config.generated.ts +275 -0
  684. package/src/internal/useAnchoredPanel.ts +340 -0
  685. package/src/internal/useCountUp.ts +65 -0
  686. package/src/internal/useDateFieldTrigger.tsx +357 -0
  687. package/src/internal/useEChart.ts +88 -0
  688. package/src/internal/useEnterOnView.ts +80 -0
  689. package/src/internal/useFloatingBar.ts +125 -0
  690. package/src/internal/useFormReset.ts +47 -0
  691. package/src/internal/useIsMobile.ts +64 -0
  692. package/src/internal/useNoImplicitSubmit.ts +41 -0
  693. package/src/internal/useOneRowOverflow.ts +103 -0
  694. package/src/internal/usePrefersReducedMotion.ts +27 -0
  695. package/src/internal/useReturnFocus.ts +34 -0
  696. package/src/internal/utils.ts +58 -0
  697. package/src/recipes/EmptyState.stories.tsx +105 -0
  698. package/src/recipes/Form.stories.tsx +355 -0
  699. package/src/recipes/ModalWithForm.stories.tsx +219 -0
  700. package/src/recipes/Recipes.mdx +61 -0
  701. package/src/recipes/TableWithFilters.stories.tsx +278 -0
  702. package/src/storybook/FodsFamily.tsx +39 -0
  703. package/src/storybook/Section.tsx +36 -0
  704. package/src/storybook/a11y.ts +24 -0
  705. package/src/storybook/assets/banner-character-bartender.webp +0 -0
  706. package/src/storybook/assets/banner-invoice-sheet-left.webp +0 -0
  707. package/src/storybook/assets/banner-invoice-sheet-right.webp +0 -0
  708. package/src/storybook/assets/invoice-hero.webp +0 -0
  709. package/src/storybook/assets/invoice.webp +0 -0
  710. package/src/storybook/assets/section-document-info.svg +21 -0
  711. package/src/storybook/assets/section-gear-checklist.svg +11 -0
  712. package/src/storybook/assets/section-person-arrow-in.svg +15 -0
  713. package/src/storybook/assets/section-person-arrow-out.svg +22 -0
  714. package/src/storybook/assets/section-receipt-dollar.svg +23 -0
  715. package/src/storybook/assets/table-empty-folder-empty.png +0 -0
  716. package/src/storybook/assets/table-empty-folder-magnifying-glass.png +0 -0
  717. package/src/storybook/assets/table-empty-funnel.png +0 -0
  718. package/src/storybook/assets/table-empty-load-failed.png +0 -0
  719. package/src/storybook/assets/wallet-spot.png +0 -0
  720. package/src/storybook/assets.d.ts +17 -0
  721. package/src/storybook/componentDoc.ts +41 -0
  722. package/src/storybook/fitFrame.tsx +70 -0
  723. package/src/storybook/forceStates.tsx +647 -0
  724. package/src/storybook/illustrations.tsx +66 -0
  725. package/src/storybook/viewportFrame.tsx +58 -0
  726. package/src/styles/assets/label-brush-1.svg +6 -0
  727. package/src/styles/assets/pattern-dark.svg +113 -0
  728. package/src/styles/base.css +106 -0
  729. package/src/styles/index.css +15 -0
  730. package/src/styles/motion.css +157 -0
  731. package/src/styles/promo-sticker.css +27 -0
  732. package/src/styles/promo-surface.css +49 -0
  733. package/src/styles/shared.css +11 -0
  734. package/src/styles/theme.generated.css +314 -0
  735. package/src/styles/theme.map.json +278 -0
  736. package/src/styles/tracking.generated.css +12 -0
  737. package/src/tokens/index.ts +4 -0
  738. package/src/tokens/tokens.generated.ts +542 -0
@@ -0,0 +1,7 @@
1
+ export {
2
+ FilterFacet,
3
+ type FilterFacetProps,
4
+ type FilterFacetSingleProps,
5
+ type FilterFacetMultipleProps,
6
+ type FilterFacetOption,
7
+ } from './FilterFacet';
@@ -0,0 +1,280 @@
1
+ import { Meta, Canvas, Controls } from '@storybook/addon-docs/blocks';
2
+ import * as FirmAvatarStories from './FirmAvatar.stories';
3
+
4
+
5
+ <Meta of={FirmAvatarStories} tags={['autodocs']} />
6
+
7
+ # FirmAvatar
8
+
9
+ ## Metadata
10
+
11
+ - **Layer:** atom
12
+ - **Status:** stable
13
+ - **Tokens used:** `--font-heading`, `--font-size-heading-h5`, `--font-weight-semibold`, `--leading-relaxed`, `--radius-400`, `--secondary-hover`, `--secondary-solid`, `--secondary-subtle`, `--secondary-tint-foreground`, `--space-1100`, `--space-900`, `--text-inverted`
14
+ - **Manifest version:** `1.1.1`
15
+
16
+ ## Overview
17
+
18
+ FirmAvatar is the **firm identity chip**: the initials of the firm name on a tinted square, where
19
+ Solid marks the active firm. It is the visual identity of a firm wherever firms are listed or
20
+ switched — the leading element of an Action Row in the account menu (`size="sm"`) and the account
21
+ card at the top of the account menu (`size="md"`).
22
+
23
+ **Do NOT use it** as a person avatar or as a status carrier. For a row about a non-firm entity
24
+ (a bank account, a unit) use Action Row's leading slot with an entity glyph instead. Tariff state is
25
+ never shown on the avatar — that is the Badge on the row or the Alert in the account card.
26
+
27
+ <Canvas of={FirmAvatarStories.Playground} />
28
+
29
+ ## Rationale
30
+
31
+ Two hosts render the same firm identity, and both need the same initials rule and the same
32
+ selection colours, so the chip is one atom rather than a detail of each host. The one constraint
33
+ that shapes it: the fill carries selection and nothing else.
34
+
35
+ Two implementation decisions are worth knowing:
36
+
37
+ - **The md Solid gradient is a layered `background-image`.** The `md` + Solid compound variant adds
38
+ `bg-[image:linear-gradient(135deg,var(--secondary-solid),var(--secondary-hover))]` on top of the
39
+ family's flat `bg-secondary-solid`. The Tailwind 4 shorthand `bg-linear-135` was not used, because
40
+ tailwind-merge 2.5 (the version in use when this was decided) classified it as a background colour and dropped it against `bg-secondary-solid`.
41
+ Layering keeps the manifest's flat Solid base true at both sizes. The static verifier has no
42
+ gradient aspect, so the gradient itself is asserted by the unit test
43
+ (`FirmAvatar.test.tsx`).
44
+ - **Initials are computed, never passed.** There is no initials prop — the component derives them
45
+ from `name` (and `email` as the fallback) through the exported `firmInitials` helper.
46
+
47
+ ## Anatomy
48
+
49
+ - **Root** (`data-fods-part="root"`) — a `<span>` square, `inline-grid` with `place-items-center`,
50
+ box `--space-900` (sm, 32 px) or `--space-1100` (md, 48 px), radius `--radius-400`. Fill per
51
+ family: `--secondary-subtle` (Subtle), flat `--secondary-solid` (sm Solid), or the 135deg
52
+ `--secondary-solid` → `--secondary-hover` gradient over the flat `--secondary-solid` base
53
+ (md Solid).
54
+ - **Initials** (`data-fods-part="initials"`) — the `initials` text run: Heading/H5 —
55
+ `--font-heading` (Poppins), `--font-size-heading-h5`, `--font-weight-semibold`, single line
56
+ (`whitespace-nowrap`), the same style at both sizes. Ink per family:
57
+ `--secondary-tint-foreground` (Subtle) or `--text-inverted` (Solid).
58
+
59
+ ## Variants
60
+
61
+ <Canvas of={FirmAvatarStories.Matrix} />
62
+
63
+ Three variants, a **sparse** set: sm × (Subtle · Solid), plus md Solid. **md Subtle does not
64
+ exist** — an md avatar always shows the active firm, so `size="md"` renders Solid whatever
65
+ `selected` says. The fill is a recolour axis driven by the host's selection (`selected`), not an
66
+ interaction state.
67
+
68
+ <table>
69
+ <thead>
70
+ <tr><th>Variant</th><th>Props</th><th>When</th><th>Tokens</th></tr>
71
+ </thead>
72
+ <tbody>
73
+ <tr>
74
+ <td>sm Subtle</td>
75
+ <td><code>size="sm"</code> (default), <code>selected</code> false (default)</td>
76
+ <td>Any firm that is not the active one, on an Action Row</td>
77
+ <td>fill <code>--secondary-subtle</code>, initials <code>--secondary-tint-foreground</code></td>
78
+ </tr>
79
+ <tr>
80
+ <td>sm Solid</td>
81
+ <td><code>size="sm"</code>, <code>selected</code></td>
82
+ <td>The active firm, on the Selected Action Row</td>
83
+ <td>fill <code>--secondary-solid</code> (flat), initials <code>--text-inverted</code></td>
84
+ </tr>
85
+ <tr>
86
+ <td>md Solid</td>
87
+ <td><code>size="md"</code> (<code>selected</code> ignored)</td>
88
+ <td>The active firm, in the account card</td>
89
+ <td>fill gradient 135deg <code>--secondary-solid</code> → <code>--secondary-hover</code> over flat <code>--secondary-solid</code>, initials <code>--text-inverted</code></td>
90
+ </tr>
91
+ </tbody>
92
+ </table>
93
+
94
+ sm Solid is flat and md Solid is a gradient **on purpose** (manifest `notes[1]`); do not unify them.
95
+
96
+ ## Sizes
97
+
98
+ The Matrix above shows both sizes. The host fixes the size — never choose it for emphasis.
99
+
100
+ <table>
101
+ <thead>
102
+ <tr><th>Size</th><th style={{ textAlign: 'right' }}>Box</th><th>Box token</th><th>Radius</th><th>Initials</th><th>Host</th><th>Fills</th></tr>
103
+ </thead>
104
+ <tbody>
105
+ <tr>
106
+ <td><code>sm</code> (S)</td>
107
+ <td style={{ textAlign: 'right' }}>32</td>
108
+ <td><code>--space-900</code></td>
109
+ <td><code>--radius-400</code></td>
110
+ <td>Heading/H5</td>
111
+ <td>Action Row leading element</td>
112
+ <td>Subtle or Solid</td>
113
+ </tr>
114
+ <tr>
115
+ <td><code>md</code> (M)</td>
116
+ <td style={{ textAlign: 'right' }}>48</td>
117
+ <td><code>--space-1100</code></td>
118
+ <td><code>--radius-400</code></td>
119
+ <td>Heading/H5</td>
120
+ <td>Account card</td>
121
+ <td>Solid only</td>
122
+ </tr>
123
+ </tbody>
124
+ </table>
125
+
126
+ The upstream spec lists the initials' line height as *Not specified*. The component uses
127
+ `text-heading-h5`, which carries Heading/H5's own leading (`--leading-relaxed`) — the same way the
128
+ Drawer title takes it.
129
+
130
+ ## States
131
+
132
+ None. The avatar is static and non-interactive: no hover, focus or pressed state of its own — the
133
+ host row owns those. There is no States story because there is nothing to show beyond the
134
+ Matrix.
135
+
136
+ The fill encodes selection:
137
+
138
+ - **Solid** — the active firm (`selected`, or any `size="md"`).
139
+ - **Subtle** — every other firm (sm only).
140
+
141
+ Solid appears on one firm at a time. The host passes the active flag; nothing on the avatar itself
142
+ drives the fill.
143
+
144
+ **Motion: none.** Manifest 1.1.1 `motion.none`: „no motion of its own; the Solid / Subtle fill flip is driven by the
145
+ host row's state toggle". The avatar declares no transition — the fill flips at once, in step with the host (in
146
+ [ActionRow](?path=/docs/design-system-atoms-actionrow--docs) the row's Selected fill eases over `--duration-toggle`
147
+ while the avatar swaps).
148
+
149
+ ### Initials
150
+
151
+ <Canvas of={FirmAvatarStories.Initials} />
152
+
153
+ `firmInitials(name, email)` implements the spec's initials rule; the story renders every row of
154
+ the spec's example table, and the unit test asserts each one.
155
+
156
+ 1. Take the **displayed** name — the caller resolves the label chain (firm name → supplier name) and
157
+ passes the result as `name`. The name is NFC-normalised. Characters that are neither letters nor
158
+ digits are trimmed from **both ends of every word**, and a word left empty is dropped
159
+ (`Novák & Syn` → `NS`, manifest 1.0.2).
160
+ 2. Skip legal forms — `spol. s r.o.`, `s r.o.`, `s.r.o.`, `spol.`, `a.s.`, `k.s.`, `v.o.s.`,
161
+ `z.s.`, `o.p.s.`, `s.p.` (whole words, case-insensitive, longest first) — and one-letter words.
162
+ A single digit is kept: it counts like a letter.
163
+ 3. Two or more words remain → the first character of each of the first two words; one word → its
164
+ first two characters.
165
+ 4. Uppercase with the Czech locale; diacritics are kept (`Truhlářství Černý` → `TČ`).
166
+ 5. Nothing left → the e-mail's local part split at `.` `_` `-` (`jan.novak` → `JN`, `info` → `IN`).
167
+
168
+ The code differs from the spec's **illustrative snippet** in two places: it takes characters by
169
+ **code point** (`Array.from`), not by UTF-16 unit, and with no name and no e-mail it returns an
170
+ **empty string** (the avatar then renders an empty square). The per-word trim and the legal-form
171
+ skip match the snippet since manifest 1.0.4.
172
+
173
+ ## API
174
+
175
+ <Controls />
176
+
177
+ `firmInitials` and `firmAvatarVariants` are exported alongside the component. The root accepts
178
+ the standard `<span>` HTML attributes except `children`, plus `className` and a forwarded `ref`.
179
+
180
+ ## Do / Don't
181
+
182
+ - ✅ Pass the displayed firm `name` and the account `email`; let the component compute the initials
183
+ - ✅ Drive `selected` from the host's active-firm flag — exactly one Solid avatar per menu
184
+ - ✅ Keep `md` for the account card and `sm` for Action Row
185
+ - ✅ Show tariff state with the Badge on the row, or the Alert in the account card
186
+ - ❌ Type initials as free text per screen (there is no prop for it)
187
+ - ❌ Pick Solid or Subtle for emphasis or decoration, or render two firms Solid at once
188
+ - ❌ Try to build an md Subtle — `size="md"` always renders Solid
189
+ - ❌ Use FirmAvatar for a person or a non-firm entity, or recolour it to show tariff state
190
+
191
+ ## Accessibility
192
+
193
+ - **Keyboard** — none. The root has no `role` and no `tabindex`; it is never a tab stop. Focus and
194
+ the focus ring belong to the host row.
195
+ - **ARIA** — the root always carries `aria-hidden="true"`. It is set **after** the spread props, so
196
+ a consumer cannot override it: both hosts always render the firm name beside the avatar, and the
197
+ initials would only repeat it.
198
+ - **Screen reader** — hears nothing from the avatar; the adjacent firm name carries the accessible
199
+ text. Selection is announced by the host, not by the fill.
200
+ - **Contrast & motion** — Subtle initials (`--secondary-tint-foreground` on `--secondary-subtle`)
201
+ clear AAA. Solid initials (`--text-inverted` on flat `--secondary-solid`, and on the
202
+ `--secondary-solid` end of the md gradient) are 4.45:1, 0.05 below AA-Normal — covered by the
203
+ accepted upstream `--secondary-solid` white-label exception because the initials are decorative
204
+ and the firm name carries the same information (manifest `notes[3]`). No motion (manifest `motion.none`).
205
+
206
+ Accessibility floor for every FODS component: `spec/01-foundations/accessibility.md`.
207
+
208
+ ## Copy
209
+
210
+ Voice: nobody writes the avatar's text; the code derives it, and consistency means one thing:
211
+ the same firm shows the same initials on every surface.
212
+
213
+ - **Initials** (`initials`): computed by `firmInitials` from `name`, with `email` as the
214
+ fallback; there is no prop for the text itself. Uppercase, diacritics kept. One line, at most
215
+ two characters, always exactly two (one only when the source string has a single letter). No
216
+ truncation and no ellipsis: the rule, not the string length, keeps it inside the square.
217
+
218
+ Canonical results of the initials rule:
219
+
220
+ <table>
221
+ <thead>
222
+ <tr><th>Source</th><th>Initials</th><th>Why</th></tr>
223
+ </thead>
224
+ <tbody>
225
+ <tr><td>Beta s.r.o.</td><td><code>BE</code></td><td>s.r.o. skipped; one word left → its first two letters</td></tr>
226
+ <tr><td>Café Karlín</td><td><code>CK</code></td><td>first letters of the first two words</td></tr>
227
+ <tr><td>Novák &amp; Syn</td><td><code>NS</code></td><td><code>&amp;</code> trims to nothing and is dropped</td></tr>
228
+ <tr><td>Zelená zahrada s.r.o.</td><td><code>ZZ</code></td><td>s.r.o. skipped; first two words</td></tr>
229
+ <tr><td>Studio Ateliér 7</td><td><code>SA</code></td><td>first letters of the first two words</td></tr>
230
+ <tr><td>Zemědělské družstvo Vysočina Horní Cerekev a.s.</td><td><code>ZD</code></td><td>first two words only; the rest is dropped</td></tr>
231
+ <tr><td>7 Hills s.r.o.</td><td><code>7H</code></td><td>a digit counts like a letter</td></tr>
232
+ <tr><td>Novák spol. s r.o.</td><td><code>NO</code></td><td>multi-word legal form skipped; one word left</td></tr>
233
+ <tr><td>Truhlářství Černý</td><td><code>TČ</code></td><td>diacritics kept</td></tr>
234
+ <tr><td>no firm name, supplier „Jan Novák“</td><td><code>JN</code></td><td>supplier name from the label chain</td></tr>
235
+ <tr><td>no name, e-mail <code>jan.novak@…</code></td><td><code>JN</code></td><td>e-mail local part split at <code>.</code></td></tr>
236
+ <tr><td>no name, e-mail <code>info@…</code></td><td><code>IN</code></td><td>single part → first two letters</td></tr>
237
+ </tbody>
238
+ </table>
239
+
240
+ Wrong results to watch for: `BS` for Beta s.r.o. (the legal form counted as a word), `ZDV`
241
+ (more than two characters), `B` for a one-word name (it gives two letters), `ck` (not
242
+ uppercased), an empty square when there is no firm name (the e-mail fallback skipped).
243
+
244
+ ## Usage
245
+
246
+ ```tsx
247
+ import { FirmAvatar } from '@invoiceonline/ui-react';
248
+
249
+ // Action Row leading element — Solid only for the active firm
250
+ <FirmAvatar name="Acme s.r.o." email="firma@priklad.cz" selected={isActiveFirm} />
251
+
252
+ // Account card — always the active firm, always Solid
253
+ <FirmAvatar name="Acme s.r.o." email="firma@priklad.cz" size="md" />
254
+ ```
255
+
256
+ Don't:
257
+
258
+ ```tsx
259
+ // Initials are derived, not passed; md cannot be Subtle; selection is not decoration
260
+ <FirmAvatar name="AC" />
261
+ <FirmAvatar name="Acme s.r.o." size="md" selected={false} />
262
+ <FirmAvatar name="Acme s.r.o." selected />
263
+ <FirmAvatar name="Beta s.r.o." selected />
264
+ ```
265
+
266
+ ## Related
267
+
268
+ - **Host:** ActionRow — the `sm` avatar is the row's leading element and `selected` follows the
269
+ row's Selected state ([ActionRow docs](?path=/docs/design-system-atoms-actionrow--docs)).
270
+ The account card (product composition) hosts the `md` avatar.
271
+ - **Tariff state, never on the avatar:** Badge (on the row) · Alert (in the account card).
272
+ - **Spec:** `spec/03-atoms/firm-avatar.md`
273
+
274
+ ## Migration notes
275
+
276
+ **Motion (manifest 1.1.1, 2026-11-03) — documentation only.** The motion audit declares the avatar static
277
+ (`motion.none`); the fill flip belongs to the host's toggle. No code change.
278
+
279
+ Not applicable — the manifest records no predecessor component, legacy class names or replaced
280
+ values ("No migration mapping is specified for Firm Avatar 1.0.0" — upstream spec).
@@ -0,0 +1,147 @@
1
+ import React from 'react';
2
+ import type { Meta, StoryObj } from '@storybook/react-vite';
3
+ import { FirmAvatar, firmInitials, type FirmAvatarSize } from './FirmAvatar';
4
+ import { Section, Showcase } from '../../storybook/Section';
5
+ import { FodsFamily } from '../../storybook/FodsFamily';
6
+ import { componentDoc } from '../../storybook/componentDoc';
7
+
8
+ const STYLES = ['subtle', 'solid'] as const;
9
+ const SIZES = ['sm', 'md'] as const satisfies readonly FirmAvatarSize[];
10
+
11
+ /** The spec § Copy example table, verbatim. */
12
+ const INITIALS_EXAMPLES = [
13
+ { name: 'Beta s.r.o.', why: 's.r.o. skipped; one word left → its first two letters' },
14
+ { name: 'Café Karlín', why: 'first letters of the first two words' },
15
+ { name: 'Novák & Syn', why: '& trims to nothing and is dropped' },
16
+ { name: 'Zelená zahrada s.r.o.', why: 's.r.o. skipped; first two words' },
17
+ { name: 'Studio Ateliér 7', why: 'first letters of the first two words' },
18
+ {
19
+ name: 'Zemědělské družstvo Vysočina Horní Cerekev a.s.',
20
+ why: 'first two words only; the rest is dropped',
21
+ },
22
+ { name: '7 Hills s.r.o.', why: 'a digit counts like a letter' },
23
+ { name: 'Novák spol. s r.o.', why: 'multi-word legal form skipped; one word left' },
24
+ { name: 'Truhlářství Černý', why: 'diacritics kept' },
25
+ { name: 'Jan Novák', source: 'no firm name, supplier „Jan Novák“', why: 'supplier name from the label chain' },
26
+ { email: 'jan.novak@example.cz', source: 'no name, e-mail jan.novak@…', why: 'e-mail local part split at .' },
27
+ { email: 'info@example.cz', source: 'no name, e-mail info@…', why: 'single part → first two letters' },
28
+ ] as const satisfies readonly { name?: string; email?: string; source?: string; why: string }[];
29
+
30
+ const meta = {
31
+ title: 'Design System/Atoms/FirmAvatar',
32
+ component: FirmAvatar,
33
+ parameters: {
34
+ layout: 'centered',
35
+ docs: {
36
+ description: {
37
+ component: componentDoc({
38
+ summary:
39
+ 'Firm identity chip — initials of the firm name on a tinted square; Solid marks the active firm. 3 variants (sparse): sm Subtle, sm Solid (flat), md Solid (135deg gradient). There is no md Subtle.',
40
+ useCases: [
41
+ '`size="sm"` — the leading element of an Action Row in the account menu; `selected` follows the row\'s Selected state',
42
+ '`size="md"` — the account card at the top of the account menu; always the active firm, always Solid',
43
+ ],
44
+ bestPractices: [
45
+ 'Pass the displayed firm `name` (firm name → supplier name) and the account `email` — the initials are computed by `firmInitials`, never typed as free text',
46
+ 'Drive `selected` from the host\'s active-firm flag; exactly one Solid avatar per menu',
47
+ 'Decorative: always `aria-hidden` — the firm name beside it carries the accessible text',
48
+ 'Never encode tariff state on the avatar — that is the Badge on the row or the Alert in the account card',
49
+ ],
50
+ }),
51
+ },
52
+ },
53
+ },
54
+ } satisfies Meta<typeof FirmAvatar>;
55
+
56
+ export default meta;
57
+ type Story = StoryObj<typeof meta>;
58
+
59
+ export const Playground: Story = {
60
+ args: {
61
+ name: 'Beta s.r.o.',
62
+ email: 'jan.novak@example.cz',
63
+ selected: false,
64
+ size: 'sm',
65
+ },
66
+ argTypes: {
67
+ name: { control: 'text' },
68
+ email: { control: 'text' },
69
+ selected: { control: 'boolean' },
70
+ size: { control: 'inline-radio', options: SIZES },
71
+ },
72
+ };
73
+
74
+ export const Matrix: Story = {
75
+ args: { name: 'Beta s.r.o.' },
76
+ parameters: {
77
+ docs: {
78
+ description: {
79
+ story:
80
+ 'The sparse Fill × Size set. Subtle = `--secondary-subtle` + `--secondary-tint-foreground`; Solid = `--text-inverted` initials on flat `--secondary-solid` (sm) or the 135deg `--secondary-solid` → `--secondary-hover` gradient (md). md Subtle does not exist — `size="md"` always renders Solid.',
81
+ },
82
+ },
83
+ },
84
+ render: () => (
85
+ <Showcase>
86
+ <Section title="Fill × size" layout="column">
87
+ <div className="grid grid-cols-[100px_repeat(2,minmax(0,max-content))] items-center gap-x-800 gap-y-500">
88
+ <div />
89
+ {SIZES.map(size => (
90
+ <div key={size} className="text-body-xs font-semibold text-text-secondary">
91
+ {size}
92
+ </div>
93
+ ))}
94
+ {STYLES.map(style => (
95
+ <FodsFamily key={style} name={style}>
96
+ <div className="text-body-sm text-text-secondary">{style}</div>
97
+ {SIZES.map(size =>
98
+ style === 'subtle' && size === 'md' ? (
99
+ <div key={size} className="text-body-xs text-text-tertiary">
100
+ n/a
101
+ </div>
102
+ ) : (
103
+ <div key={size}>
104
+ <FirmAvatar name="Beta s.r.o." size={size} selected={style === 'solid'} />
105
+ </div>
106
+ ),
107
+ )}
108
+ </FodsFamily>
109
+ ))}
110
+ </div>
111
+ </Section>
112
+ </Showcase>
113
+ ),
114
+ };
115
+
116
+ export const Initials: Story = {
117
+ args: { name: 'Beta s.r.o.' },
118
+ parameters: {
119
+ docs: {
120
+ description: {
121
+ story:
122
+ 'The initials rule (spec § Copy) applied to every row of the spec\'s example table: legal forms and one-letter words skipped (a digit counts), first characters of the first two words or the first two of a single word, uppercased with diacritics kept; nothing left → the e-mail local part split at `.` `_` `-`.',
123
+ },
124
+ },
125
+ },
126
+ render: () => (
127
+ <Showcase>
128
+ <Section title="Spec example table" layout="column">
129
+ <div className="grid grid-cols-[max-content_max-content_max-content_minmax(0,1fr)] items-center gap-x-600 gap-y-300">
130
+ {INITIALS_EXAMPLES.map((example) => {
131
+ const name = 'name' in example ? example.name : undefined;
132
+ const email = 'email' in example ? example.email : undefined;
133
+ const source = 'source' in example ? example.source : name;
134
+ return (
135
+ <React.Fragment key={source}>
136
+ <FirmAvatar name={name} email={email} />
137
+ <code className="text-body-sm text-text-primary">{firmInitials(name, email)}</code>
138
+ <span className="text-body-sm text-text-primary">{source}</span>
139
+ <span className="text-body-xs text-text-secondary">{example.why}</span>
140
+ </React.Fragment>
141
+ );
142
+ })}
143
+ </div>
144
+ </Section>
145
+ </Showcase>
146
+ ),
147
+ };
@@ -0,0 +1,172 @@
1
+ "use client";
2
+ import * as React from 'react';
3
+ import { tv } from '../../internal/tailwind-variants';
4
+ import { cn } from '../../internal/utils';
5
+
6
+ /**
7
+ * Firm Avatar — the firm identity chip (upstream spec `03-atoms/firm-avatar.md`,
8
+ * manifest 1.1.1): the initials of the firm name on a tinted square. Solid marks
9
+ * the active firm, Subtle every other one.
10
+ *
11
+ * Hosts fix the size: `sm` (32, `--space-900`) is the Action Row leading element,
12
+ * `md` (48, `--space-1100`) the account card. The variant set is SPARSE — there is
13
+ * no md Subtle, because an md avatar always shows the active firm, so `size="md"`
14
+ * renders Solid whatever `selected` says.
15
+ *
16
+ * Solid differs by size on purpose (manifest `notes[1]`): sm Solid is the flat
17
+ * `--secondary-solid` of `families[Solid]`, md Solid paints the
18
+ * `chrome.solid-fill.M` gradient — 135deg, `--secondary-solid` → `--secondary-hover`.
19
+ * The gradient is a `background-image` layered over the same flat base colour, so
20
+ * the family binding stays true at both sizes.
21
+ *
22
+ * Static and decorative: no role, no tabindex, no interaction state, always
23
+ * `aria-hidden` — the firm name rendered beside it carries the accessible text.
24
+ */
25
+ const firmAvatarVariants = tv({
26
+ slots: {
27
+ root: 'inline-grid shrink-0 place-items-center rounded-400',
28
+ /**
29
+ * `typography.runs.initials` — Heading/H5: `--font-heading` (Poppins),
30
+ * `--font-size-heading-h5`, `--font-weight-semibold`. The spec leaves the line
31
+ * height unspecified; `text-heading-h5` carries Heading/H5's own leading, the
32
+ * same way Drawer's title and Promo Sticker's label take it.
33
+ */
34
+ initials: 'whitespace-nowrap font-poppins text-heading-h5 font-semibold',
35
+ },
36
+ variants: {
37
+ fill: {
38
+ subtle: {
39
+ root: 'bg-secondary-subtle',
40
+ initials: 'text-secondary-tint-foreground',
41
+ },
42
+ solid: {
43
+ root: 'bg-secondary-solid',
44
+ initials: 'text-text-inverted',
45
+ },
46
+ },
47
+ size: {
48
+ sm: { root: 'size-900' },
49
+ md: { root: 'size-1100' },
50
+ },
51
+ },
52
+ compoundVariants: [
53
+ {
54
+ fill: 'solid',
55
+ size: 'md',
56
+ class: {
57
+ root: 'bg-[image:linear-gradient(135deg,var(--secondary-solid),var(--secondary-hover))]',
58
+ },
59
+ },
60
+ ],
61
+ defaultVariants: {
62
+ fill: 'subtle',
63
+ size: 'sm',
64
+ },
65
+ });
66
+
67
+ export type FirmAvatarSize = 'sm' | 'md';
68
+
69
+ /** Longest first, so `spol. s r.o.` is consumed before `s r.o.` and `spol.`. */
70
+ const LEGAL_FORMS = [
71
+ 'spol. s r.o.',
72
+ 's r.o.',
73
+ 's.r.o.',
74
+ 'spol.',
75
+ 'a.s.',
76
+ 'k.s.',
77
+ 'v.o.s.',
78
+ 'z.s.',
79
+ 'o.p.s.',
80
+ 's.p.',
81
+ ];
82
+
83
+ // A whole-word match may be wrapped in edge punctuation — `(s.r.o.)`, `„a.s.“`, `a.s.,` —
84
+ // which spec § Copy step 1 trims before the legal-form skip. A comma ends the word even with
85
+ // no space after it (`s.r.o.,IČ`).
86
+ const LEGAL_FORM_PATTERNS = LEGAL_FORMS.map(
87
+ form =>
88
+ new RegExp(
89
+ `(^|\\s)[^\\p{L}\\p{N}\\s]*${form.replace(/\./g, '\\.').replace(/ /g, '\\s+')}(?=[^\\p{L}\\p{N}\\s]*(?:[\\s,]|$))`,
90
+ 'giu',
91
+ ),
92
+ );
93
+
94
+ const EDGE_NON_ALNUM = /^[^\p{L}\p{N}]+|[^\p{L}\p{N}]+$/gu;
95
+
96
+ function initialsFrom(words: string[]): string {
97
+ // Array.from splits by code point, so an astral letter is never cut in half.
98
+ if (words.length >= 2) return Array.from(words[0])[0] + Array.from(words[1])[0];
99
+ return words.length === 1 ? Array.from(words[0]).slice(0, 2).join('') : '';
100
+ }
101
+
102
+ function wordsOfName(name: string): string[] {
103
+ let stripped = ` ${name.normalize('NFC')} `;
104
+ for (const pattern of LEGAL_FORM_PATTERNS) stripped = stripped.replace(pattern, ' ');
105
+ return stripped
106
+ .split(/\s+/)
107
+ .map(word => word.replace(EDGE_NON_ALNUM, ''))
108
+ // One-letter words are skipped; a single digit counts like a letter.
109
+ .filter(word => Array.from(word).length > 1 || /^\p{N}$/u.test(word));
110
+ }
111
+
112
+ /**
113
+ * The initials rule (spec § Copy): the displayed name with legal forms and
114
+ * one-letter words skipped → the first characters of the first two words, or the
115
+ * first two of a single word; nothing left → the e-mail's local part split at
116
+ * `.` `_` `-`. Uppercased with the Czech locale, diacritics kept.
117
+ *
118
+ * `name` is the DISPLAYED name — the caller resolves the label chain (firm name →
119
+ * supplier name) and passes the result.
120
+ */
121
+ export function firmInitials(name?: string | null, email?: string | null): string {
122
+ const fromName = name?.trim() ? initialsFrom(wordsOfName(name)) : '';
123
+ if (fromName) return fromName.toLocaleUpperCase('cs');
124
+
125
+ const local = (email ?? '').split('@')[0].normalize('NFC');
126
+ const parts = local
127
+ .split(/[._-]/)
128
+ .map(part => part.replace(EDGE_NON_ALNUM, ''))
129
+ .filter(Boolean);
130
+ return initialsFrom(parts).toLocaleUpperCase('cs');
131
+ }
132
+
133
+ export interface FirmAvatarProps
134
+ extends Omit<React.HTMLAttributes<HTMLSpanElement>, 'children'> {
135
+ /** The displayed firm name (firm name → supplier name); the initials are derived from it. */
136
+ name?: string | null;
137
+ /** The account e-mail — the initials fallback when `name` yields nothing. */
138
+ email?: string | null;
139
+ /**
140
+ * The active firm. Driven by the host's selection, never picked for emphasis —
141
+ * inside Action Row it follows the row's Selected state.
142
+ */
143
+ selected?: boolean;
144
+ /** `sm` (32, Action Row) or `md` (48, account card — always Solid). */
145
+ size?: FirmAvatarSize;
146
+ }
147
+
148
+ const FirmAvatar = React.forwardRef<HTMLSpanElement, FirmAvatarProps>(
149
+ ({ className, name, email, selected = false, size = 'sm', ...props }, ref) => {
150
+ // There is no md Subtle: an md avatar is always the active firm.
151
+ const fill = selected || size === 'md' ? 'solid' : 'subtle';
152
+ const slots = firmAvatarVariants({ fill, size });
153
+
154
+ return (
155
+ <span
156
+ ref={ref}
157
+ data-fods-component="firm-avatar"
158
+ data-fods-part="root"
159
+ className={cn(slots.root(), className)}
160
+ {...props}
161
+ aria-hidden="true"
162
+ >
163
+ <span data-fods-part="initials" className={slots.initials()}>
164
+ {firmInitials(name, email)}
165
+ </span>
166
+ </span>
167
+ );
168
+ },
169
+ );
170
+ FirmAvatar.displayName = 'FirmAvatar';
171
+
172
+ export { FirmAvatar, firmAvatarVariants };
@@ -0,0 +1,7 @@
1
+ export {
2
+ FirmAvatar,
3
+ firmAvatarVariants,
4
+ firmInitials,
5
+ type FirmAvatarProps,
6
+ type FirmAvatarSize,
7
+ } from './FirmAvatar';