@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,487 @@
1
+ import { Meta, Canvas, Controls } from '@storybook/addon-docs/blocks';
2
+ import * as BadgeStories from './Badge.stories';
3
+
4
+
5
+ <Meta of={BadgeStories} tags={['autodocs']} />
6
+
7
+ # Badge
8
+
9
+ ## Metadata
10
+
11
+ - **Layer:** atom
12
+ - **Status:** draft
13
+ - **Tokens used:** `--bg-primary`, `--border-width-100`, `--brand-primary`, `--font-body`, `--font-size-sm`, `--font-size-xxs`, `--font-weight-semibold`, `--leading-loose`, `--leading-relaxed`, `--primary-foreground`, `--radius-200`, `--radius-300`, `--radius-full`, `--size-icon-2xsmall`, `--size-icon-xsmall`, `--space-100`, `--space-200`, `--space-300`, `--space-400`, `--status-danger-foreground`, `--status-danger-solid`, `--status-danger-subtle`, `--status-danger-tint-foreground`, `--status-info-foreground`, `--status-info-solid`, `--status-info-subtle`, `--status-info-tint-foreground`, `--status-success-foreground`, `--status-success-solid`, `--status-success-subtle`, `--status-success-tint-foreground`, `--status-violet-foreground`, `--status-violet-solid`, `--status-violet-subtle`, `--status-violet-tint-foreground`, `--status-warning-foreground`, `--status-warning-solid`, `--status-warning-subtle`, `--status-warning-tint-foreground`, `--tertiary-foreground`, `--tertiary-solid`, `--tertiary-subtle`, `--tertiary-tint-foreground`, `--text-wrap-body`
14
+ - **Manifest version:** `3.1.0`
15
+
16
+ ## Overview
17
+
18
+ Badge is the small **read-only pill that labels the status or category of a record** — an invoice
19
+ state (*Návrh* / *Zaplaceno* / *Nezaplaceno* / *Po splatnosti* / *Budoucí* / *Koncept*), a payment
20
+ status, a plan tier. It carries a short label and an optional leading status glyph, and it *reports*
21
+ state inline in tables, rows and headers — it never acts on it.
22
+
23
+ **Do NOT use it** as a button, a filter, or a removable tag (that is the **Chip** family). A
24
+ **count** on a tab, a filter or a menu item takes `shape="round"` (see [Shape](#shape)); a bare
25
+ number outside such a host stays plain text. The six status emotions are read-only status colours; the
26
+ seventh, `brand`, is a **marketing / brand accent — not a status** (see
27
+ [Marketing usage](#marketing-usage)).
28
+
29
+ <Canvas of={BadgeStories.Playground} />
30
+
31
+ ## Rationale
32
+
33
+ The deprecated system had four parallel "badge" sets that conflated two jobs: *reporting* status
34
+ (Badge, Badge Advanced) and *interactive* chips (Selectable, Deleteable). Splitting them, **Badge**
35
+ keeps only the read-only status job — one clean atom on the status palette — while Selectable /
36
+ Deleteable become **Chip**. Badge also gives every status surface (list, detail
37
+ header, dashboard) a single token-bound source instead of ad-hoc coloured pills, and closes the AA
38
+ gaps (notably the brown warning fill).
39
+
40
+ **Why `brand` rides the Badge set** instead of being its own component: it shares Badge's shape,
41
+ sizes, icon slot, read-only nature and copy rules — only its *colour role* differs (a brand accent
42
+ instead of a status). It is one more value on the existing emotion axis; a separate component would
43
+ duplicate the whole size/padding matrix. What makes it distinct is **purpose, not structure**.
44
+
45
+ ## Anatomy
46
+
47
+ - **Pill** — the container (`<span>`). Chrome (fill + text per emotion × appearance, radius, inline
48
+ padding, gap) comes from the shared **Pill recipe**, the same one Chip builds on: radius
49
+ `--radius-300` (md) / `--radius-200` (sm), gap `--space-300` / `--space-200`. All status emotions
50
+ are **borderless** (the tint carries the shape); `brand` + `soft` is the single exception — an
51
+ outline (white `--bg-primary` fill + a 1px `--brand-primary` **inset outline**). It is drawn as
52
+ `outline` pulled back by its own width (`outline-offset: -1px`), so it costs no layout box and
53
+ every emotion keeps the same grid-derived height. That is not a local workaround: the manifest
54
+ declares it as `families["Brand / Soft"].states.default.strokeMode: "inset-outline"`, and the system-wide rule
55
+ is `spec/06-patterns/edge-outline.md`
56
+ — a stroke that only some states of a set carry must not take layout, or the pill stops lining up
57
+ with its siblings. **When QA-ing it, read `outline-width`, not `border-width`** — the latter is
58
+ `0px` by design, and the `border-color` a devtools panel reports is just the inherited
59
+ `currentColor`. An inset `box-shadow` (`ring-inset`) would look the same here but is ruled out
60
+ system-wide: a shadow paints *under* the element's children, so it vanishes on any container whose
61
+ children reach its edge.
62
+ - **Label** — `Body/S/Semibold` (md) / `Body/XXS/Semibold` (sm), colour = the family's text token.
63
+ 1–2 words, truncated on overflow (a badge is a status, not a sentence).
64
+ - **Icon** — on by default ([Icon rule](#icon-rule)); a **leading** status glyph (16px `--size-icon-xsmall` md / 14px `--size-icon-2xsmall` sm, through the Icon `size` prop) whose colour tracks the label
65
+ via `currentColor`. It is a *redundant at-a-glance cue* that carries meaning beyond colour alone
66
+ (WCAG 1.4.1), **not decoration** — pick a glyph that maps to the status (see `BADGE_STATUS_ICONS`).
67
+ When present, the icon-side (left) inline padding steps down one step.
68
+
69
+ Heights are **grid-derived** (line box + block padding) and land at ~30 / ~22 — deliberately not a
70
+ fixed `h-*`, so the pill hugs its label box. On `shape="round"` the pill is `--radius-full`, the
71
+ label is centred and the **min-width equals that same height** (see [Shape](#shape)); there is no
72
+ icon layer.
73
+
74
+ That hug is enforced with `w-fit h-fit`, which is not redundant with `inline-flex`: a grid item is
75
+ blockified to `flex` and then stretched by the default `justify-self` / `align-self: stretch`, which
76
+ would inflate the pill to its cell. `max-w-full` still clamps an over-long label so it truncates
77
+ instead of overflowing.
78
+
79
+ ### Icon rule
80
+
81
+ A Badge carries its **status glyph** (manifest 2.2.0 — the Button rule extended): the
82
+ glyph maps to the status (`warning` for Po splatnosti, `check-circle` for Zaplaceno, `prohibit` for
83
+ an unavailable record), never a placeholder left on an unrelated status. The one exception is
84
+ **space**: in a dense table cell or a row that cannot fit icon + label, the Badge goes text-only. A
85
+ missing fitting glyph is not an exception — pick one from the icon set by its use. `brand` is not a
86
+ status, so it has no glyph to map (it is absent from `BADGE_STATUS_ICONS`). Docs-only: the prop stays
87
+ optional and no default changed.
88
+
89
+ ## Variants
90
+
91
+ Two axes drive colour: **emotion** (7) × **appearance** (`soft` / `solid`); one drives geometry:
92
+ **shape** (`default` / `round`); across two sizes = **56 variants**. The full grid mirrors the Figma
93
+ labelled set (round columns carry the digit `3`, as in Figma):
94
+
95
+ <Canvas of={BadgeStories.Matrix} />
96
+
97
+ <table>
98
+ <thead>
99
+ <tr><th>Emotion</th><th>Kdy</th><th>Soft (at-rest)</th><th>Solid (emphasis)</th></tr>
100
+ </thead>
101
+ <tbody>
102
+ <tr>
103
+ <td><code>info</code></td>
104
+ <td>Informational / draft (<em>Návrh</em>)</td>
105
+ <td><code>--status-info-subtle</code> + <code>--status-info-tint-foreground</code></td>
106
+ <td><code>--status-info-solid</code> + <code>--status-info-foreground</code></td>
107
+ </tr>
108
+ <tr>
109
+ <td><code>success</code></td>
110
+ <td>Paid, done (<em>Zaplaceno</em>)</td>
111
+ <td><code>--status-success-subtle</code> + <code>--status-success-tint-foreground</code></td>
112
+ <td><code>--status-success-solid</code> + <code>--status-success-foreground</code></td>
113
+ </tr>
114
+ <tr>
115
+ <td><code>warning</code></td>
116
+ <td>Attention, unpaid (<em>Nezaplaceno</em>)</td>
117
+ <td><code>--status-warning-subtle</code> + <code>--status-warning-tint-foreground</code></td>
118
+ <td><code>--status-warning-solid</code> + <strong>dark</strong> <code>--status-warning-foreground</code></td>
119
+ </tr>
120
+ <tr>
121
+ <td><code>danger</code></td>
122
+ <td>Overdue, error (<em>Po splatnosti</em>)</td>
123
+ <td><code>--status-danger-subtle</code> + <code>--status-danger-tint-foreground</code></td>
124
+ <td><code>--status-danger-solid</code> + <code>--status-danger-foreground</code></td>
125
+ </tr>
126
+ <tr>
127
+ <td><code>violet</code></td>
128
+ <td>Upcoming (<em>Budoucí</em>)</td>
129
+ <td><code>--status-violet-subtle</code> + <code>--status-violet-tint-foreground</code></td>
130
+ <td><code>--status-violet-solid</code> + <code>--status-violet-foreground</code></td>
131
+ </tr>
132
+ <tr>
133
+ <td><code>neutral</code></td>
134
+ <td>Draft / no status (<em>Koncept</em>)</td>
135
+ <td><code>--tertiary-subtle</code> + <code>--tertiary-tint-foreground</code></td>
136
+ <td><code>--tertiary-solid</code> + <code>--tertiary-foreground</code></td>
137
+ </tr>
138
+ <tr>
139
+ <td><code>brand</code></td>
140
+ <td><strong>Marketing accent, not a status</strong> (<em>Novinka</em>, <em>Akce</em>)</td>
141
+ <td><strong>outline</strong> — <code>--bg-primary</code> fill + a 1px <code>--brand-primary</code> inset outline + <code>--brand-primary</code> text/icon</td>
142
+ <td><code>--brand-primary</code> fill + <code>--primary-foreground</code> text/icon</td>
143
+ </tr>
144
+ </tbody>
145
+ </table>
146
+
147
+ > **`warning` is the one family with a dark foreground on its solid fill.** Orange is too light for
148
+ > white text without darkening the fill to brown, so the vivid `--status-warning-solid` pairs with
149
+ > the dark `--status-warning-foreground`.
150
+
151
+ ### Shape
152
+
153
+ <Canvas of={BadgeStories.Shapes} />
154
+
155
+ <table>
156
+ <thead>
157
+ <tr><th>Shape</th><th>Kdy</th><th>Radius</th><th>Geometry</th></tr>
158
+ </thead>
159
+ <tbody>
160
+ <tr>
161
+ <td><code>default</code> (default)</td>
162
+ <td>Every status / category label (<em>Zaplaceno</em>, <em>Po splatnosti</em> …)</td>
163
+ <td><code>--radius-300</code> md / <code>--radius-200</code> sm</td>
164
+ <td>Hugs the label; see <a href="#sizes">Sizes</a>.</td>
165
+ </tr>
166
+ <tr>
167
+ <td><code>round</code></td>
168
+ <td><strong>Counts only</strong> — a number on a tab, a filter, a menu item</td>
169
+ <td><code>--radius-full</code> (both sizes)</td>
170
+ <td>Label centred; min-width = height, so one digit is a <strong>circle</strong> (30 md / 22 sm) and more digits a fully rounded pill with the inline padding unchanged. Digits only, <strong>no icon</strong> — <code>icon</code> is a type error on round (dropped + dev warning for a JS caller).</td>
171
+ </tr>
172
+ </tbody>
173
+ </table>
174
+
175
+ The min-width is not a token: Figma holds 30 / 22 as raw values (no size variable carries them),
176
+ so code derives it from the same sum the height is made of — the line box plus twice the block
177
+ padding (`calc(var(--font-size-sm) * var(--leading-loose) + var(--space-200) * 2)` md,
178
+ `calc(var(--font-size-xxs) * var(--leading-relaxed) + var(--space-100) * 2)` sm). Colour stays on
179
+ the emotion × appearance pair; shape changes geometry only.
180
+
181
+ ### Brand is not a status
182
+
183
+ <Canvas of={BadgeStories.Brand} />
184
+
185
+ The six status emotions report a record's state. `brand` (7th, added 2026-07-07) is a **marketing /
186
+ brand-accent** pill in brand orange (`--brand-primary`), pairing with the Button `brand` variant on the
187
+ same surface. Because brand has **no subtle-tint token family of its own**, its `soft` appearance is
188
+ an **outline** (white fill + a 1px brand **inset outline** + orange text), not a tint; `solid` is a filled orange
189
+ with white `--primary-foreground` text. Both put orange against white at **~2.3:1, below the AA
190
+ 4.5:1 threshold** — marketing emphasis only, never the sole carrier of essential text and never for
191
+ in-product status.
192
+
193
+ ### Marketing usage
194
+
195
+ <table>
196
+ <thead>
197
+ <tr><th>Marketing <strong>may</strong> use Brand for</th><th>Marketing <strong>may not</strong> use Brand for</th></tr>
198
+ </thead>
199
+ <tbody>
200
+ <tr>
201
+ <td>A promotional / brand-tied tag — a <em>Novinka</em> / <em>Akce</em> / <em>Tip</em> label, a marketing-landing highlight, a clearly promotional in-app callout</td>
202
+ <td>Reporting a record's <strong>status</strong> (invoice / payment state) — that is the status emotions</td>
203
+ </tr>
204
+ <tr>
205
+ <td>Pairing with the Button <code>brand</code> variant (orange) on the same marketing surface</td>
206
+ <td>An interactive or removable tag — that is the <strong>Chip</strong> family</td>
207
+ </tr>
208
+ <tr>
209
+ <td>At-rest emphasis with <code>soft</code> (outline); a single high-emphasis moment with <code>solid</code></td>
210
+ <td>The <strong>sole</strong> carrier of essential text — contrast ~2.3:1, below AA</td>
211
+ </tr>
212
+ </tbody>
213
+ </table>
214
+
215
+ Keep it rare: a brand badge is a **brand accent**, not a system status. In-product status stays on
216
+ the AA-tuned status emotions.
217
+
218
+ ## Sizes
219
+
220
+ <Canvas of={BadgeStories.Sizes} />
221
+
222
+ <table>
223
+ <thead>
224
+ <tr><th>Size</th><th style={{ textAlign: 'right' }}>Height</th><th>Label</th><th style={{ textAlign: 'right' }}>Icon</th><th>Radius</th><th>Inline padding (no icon / with icon)</th><th>Gap</th></tr>
225
+ </thead>
226
+ <tbody>
227
+ <tr>
228
+ <td><code>md</code> (default)</td>
229
+ <td style={{ textAlign: 'right' }}>~30px</td>
230
+ <td><code>Body/S/Semibold</code> (14)</td>
231
+ <td style={{ textAlign: 'right' }}>16px</td>
232
+ <td><code>--radius-300</code></td>
233
+ <td><code>--space-400</code> / <code>--space-300</code> left + <code>--space-400</code> right</td>
234
+ <td><code>--space-300</code></td>
235
+ </tr>
236
+ <tr>
237
+ <td><code>sm</code></td>
238
+ <td style={{ textAlign: 'right' }}>~22px</td>
239
+ <td><code>Body/XXS/Semibold</code> (12)</td>
240
+ <td style={{ textAlign: 'right' }}>14px</td>
241
+ <td><code>--radius-200</code></td>
242
+ <td><code>--space-300</code> / <code>--space-200</code> left + <code>--space-300</code> right</td>
243
+ <td><code>--space-200</code></td>
244
+ </tr>
245
+ </tbody>
246
+ </table>
247
+
248
+ Pick `md` by default; use `sm` in dense tables and inline runs. Heights are grid-derived from the
249
+ line box plus block padding — never a fixed height. The **Pill padding rule**: the text side keeps
250
+ the size base, the leading-glyph side steps down one spacing step for optical balance (a **code**
251
+ rule — Figma keeps the padding symmetric; same logic as Button).
252
+
253
+ > **Where the type contract lives (manifest 1.2.2).** The published style is now a manifest field —
254
+ > `sizes[].textStyle` = `Body/S` (md) / `Body/XXS` (sm) — so size and leading can no longer drift
255
+ > apart in prose. The **weight** stays on `typography.label` (`--font-weight-semibold`), which is
256
+ > still a **flat slot, not `typography.runs`**: a `runs.<run>.font` is required to be a single
257
+ > constant string, and Badge's style steps with the size, so it has nowhere to go there. That is a
258
+ > deliberate carve-out, not a pending migration — Badge did **not** move to the `runs` shape in
259
+ > 1.2.2 (`action-row` and `nav-link` did). The practical consequence for us is unchanged: the static
260
+ > pass reads `typography.runs.<run>` only, so neither the per-size style nor the weight is machine-
261
+ > checked on Badge, and both stay pinned by the recipe and its tests.
262
+
263
+ The `WithIcon` / `WithoutIcon` stories in the sidebar show the same statuses with and without the
264
+ leading glyph.
265
+
266
+ <Canvas of={BadgeStories.WithIcon} />
267
+
268
+ ## States
269
+
270
+ **None.** A badge is read-only — no hover, focus, active, selected, disabled or loading state. The
271
+ `soft` / `solid` axis is a **style** choice (calm vs emphasis) and `shape` a geometry choice — neither
272
+ is an interaction state. Anything
273
+ interactive (toggle, remove) belongs to the **Chip** family, not Badge. Consequently there is no
274
+ `States` story, and Badge is not focusable.
275
+
276
+ ## API
277
+
278
+ <Controls />
279
+
280
+ <table>
281
+ <thead>
282
+ <tr><th>Prop</th><th>Type</th><th>Default</th><th>Poznámka</th></tr>
283
+ </thead>
284
+ <tbody>
285
+ <tr>
286
+ <td><code>emotion</code></td>
287
+ <td><code>'info' | 'success' | 'warning' | 'danger' | 'violet' | 'neutral' | 'brand'</code></td>
288
+ <td><code>'info'</code></td>
289
+ <td>Colour family. The first six are status colours; <code>brand</code> is a marketing accent.</td>
290
+ </tr>
291
+ <tr>
292
+ <td><code>appearance</code></td>
293
+ <td><code>'soft' | 'solid'</code></td>
294
+ <td><code>'soft'</code></td>
295
+ <td>Colour treatment. Named <code>appearance</code> and not <code>style</code> (the Figma axis name), because <code>style</code> collides with the HTML attribute on a <code>&lt;span&gt;</code>.</td>
296
+ </tr>
297
+ <tr>
298
+ <td><code>size</code></td>
299
+ <td><code>'md' | 'sm'</code></td>
300
+ <td><code>'md'</code></td>
301
+ <td>~30px / ~22px.</td>
302
+ </tr>
303
+ <tr>
304
+ <td><code>shape</code></td>
305
+ <td><code>'default' | 'round'</code></td>
306
+ <td><code>'default'</code></td>
307
+ <td><code>round</code> = <code>--radius-full</code>, min-width = height (one digit is a circle). Counts only — digits, no icon.</td>
308
+ </tr>
309
+ <tr>
310
+ <td><code>icon</code></td>
311
+ <td><code>IconName</code></td>
312
+ <td>—</td>
313
+ <td>Optional <strong>leading</strong> status glyph, rendered in the label colour. Presence is the toggle (the Figma <code>Icon</code> boolean) and it drives the icon-side padding step-down. Not allowed on <code>shape="round"</code>: <code>BadgeProps</code> is a discriminated union — <code>{"{ shape?: 'default'; icon?: IconName } | { shape: 'round'; icon?: never }"}</code> — because Figma <code>Shape=Round</code> has no icon layer. A JS caller that passes both gets the icon dropped and a dev-only <code>console.warn</code>.</td>
314
+ </tr>
315
+ <tr>
316
+ <td><code>children</code></td>
317
+ <td><code>React.ReactNode</code></td>
318
+ <td>—</td>
319
+ <td>Visible label — a status noun, 1–2 words, ≤ ~20 chars, no terminal period.</td>
320
+ </tr>
321
+ </tbody>
322
+ </table>
323
+
324
+ The component also exports **`BADGE_STATUS_ICONS`** — the semantic glyph map per status emotion. It
325
+ is **not** applied automatically in code — the consumer passes it, and per the [Icon rule](#icon-rule)
326
+ a status badge carries it unless the host has no room.
327
+ `brand` is deliberately absent from the map (it is not a status, so no glyph maps to it).
328
+
329
+ <table>
330
+ <thead>
331
+ <tr><th>Emotion</th><th>Spec glyph</th><th>Icon name</th><th>Reads as</th></tr>
332
+ </thead>
333
+ <tbody>
334
+ <tr><td><code>info</code></td><td><code>info</code></td><td><code>info</code></td><td>informational / draft</td></tr>
335
+ <tr><td><code>success</code></td><td><code>check-circle</code></td><td><code>check</code></td><td>paid · done</td></tr>
336
+ <tr><td><code>warning</code></td><td><code>warning</code></td><td><code>warning</code></td><td>attention · unpaid</td></tr>
337
+ <tr><td><code>danger</code></td><td><code>warning-circle</code></td><td><code>warning-circle</code></td><td>overdue · error</td></tr>
338
+ <tr><td><code>violet</code></td><td><code>hourglass</code></td><td><code>hourglass</code></td><td>upcoming (<em>Budoucí</em>)</td></tr>
339
+ <tr><td><code>neutral</code></td><td><code>pencil-simple</code></td><td><code>pencil-simple</code></td><td>draft (<em>Koncept</em>)</td></tr>
340
+ </tbody>
341
+ </table>
342
+
343
+ > **Known issue / deviation from the spec.** The one real deviation is **success**: the icon set
344
+ > carries `check-circle`, but `BADGE_STATUS_ICONS` still renders the bare `check`. The *semantics*
345
+ > are preserved; that one shape differs from Figma.
346
+
347
+ ## Do / Don't
348
+
349
+ - ✅ Use `soft` for at-rest status; reach for `solid` to make a single status stand out.
350
+ - ✅ Keep the label to 1–2 words (≤ ~20 chars), sentence case, no terminal period.
351
+ - ✅ Give every status Badge its glyph via `BADGE_STATUS_ICONS`; go text-only only where the host
352
+ has no room for icon + label (a dense table cell, a tight row).
353
+ - ✅ Match the app's existing status vocabulary; don't invent synonyms per screen.
354
+ - ✅ Use `brand` only on marketing / brand-tied surfaces, sparingly, as a brand accent.
355
+ - ✅ Use `shape="round"` for a count on a tab, a filter or a menu item — digits only, no icon.
356
+ - ❌ Don't turn the glyph off by habit where the host has room for it.
357
+ - ❌ Don't use a badge as a button, filter, or removable tag — that is the **Chip** family.
358
+ - ❌ Don't put a status label (*Zaplaceno*, *Po splatnosti* …) or an icon on `shape="round"` — round
359
+ is for counts; and don't use a badge for a bare number outside such a host — that is plain text.
360
+ - ❌ Don't add a decorative or mismatched glyph, more than one glyph, or an avatar / logo; a missing
361
+ fitting glyph is not a reason to drop it — pick one from the icon set by its use.
362
+ - ❌ Don't put white text on the warning solid fill (dark text only), and don't stack many solid
363
+ badges next to each other.
364
+ - ❌ Don't use `brand` to report invoice / payment status, and never lean on its orange as the sole
365
+ signal (contrast ~2.3:1, below AA).
366
+ - ❌ Don't override the colours via `className` — the emotion × appearance pairs are token-bound.
367
+
368
+ ## Accessibility
369
+
370
+ - **Keyboard** — none. Badge is static text: it is **not focusable** and not in the tab order. If a
371
+ status needs to be actionable, it is a Button or a Chip, not a Badge.
372
+ - **ARIA** — no role is set; a badge is plain inline text inside a `<span>`. The leading glyph is
373
+ hidden from the a11y tree (`aria-hidden` on the icon) precisely *because* it is redundant with the
374
+ label — it carries meaning beyond colour for sighted users (WCAG 1.4.1) and would only be noise to
375
+ a screen reader — so the accessible text is the label alone —
376
+ which is why the label must state the status in words. No `aria-live`: a status *change* is
377
+ announced by the surrounding UI (row update, toast), not by the badge.
378
+ - **Screen reader** — the badge reads as its label text, nothing more. Never encode status in colour
379
+ or the glyph alone (WCAG 1.4.1) — the icon reinforces, it is never the sole signal.
380
+ - **Contrast & motion** — soft = `-tint-foreground` on `-subtle` (AA); solid = `-foreground` on
381
+ `-solid` (AA; **warning** uses dark text on orange, **success** relies on the semibold weight as
382
+ the accepted mitigation for white on green/600). **`brand` is the exception at ~2.3:1, below AA**
383
+ (both directions: orange text on white, white text on orange) — marketing emphasis only, always
384
+ backed by clear label context. No animation — the manifest declares the Badge static
385
+ (`motion.none`, 3.0.2) — so no reduced-motion considerations.
386
+ - **Counts (`shape="round"`)** — the badge reads as the bare digits. The host (tab, filter, menu
387
+ item) must give them their meaning in its own accessible name; a lone `3` says nothing.
388
+
389
+ Accessibility floor for every FODS component: `spec/01-foundations/accessibility.md`.
390
+
391
+ ## Copy
392
+
393
+ Voice: impersonal and in-app.
394
+
395
+ - **Label** (`children`) — a **status noun** or short noun phrase, sentence case, **no** terminal
396
+ period. 1–2 words — a status, not a sentence. Single line, max 20 characters; an over-long label
397
+ truncates with an ellipsis, so keep it short instead. If it needs more, it is not a badge — a
398
+ longer explanation belongs in a Tooltip or helper text. Match the app's existing status
399
+ vocabulary; don't invent synonyms per screen.
400
+
401
+ Canonical status labels:
402
+
403
+ <table>
404
+ <thead>
405
+ <tr><th>Label</th></tr>
406
+ </thead>
407
+ <tbody>
408
+ <tr><td>Zaplaceno</td></tr>
409
+ <tr><td>Po splatnosti</td></tr>
410
+ <tr><td>Budoucí</td></tr>
411
+ </tbody>
412
+ </table>
413
+
414
+ ## Usage
415
+
416
+ ```tsx
417
+ import { Badge, BADGE_STATUS_ICONS } from '@invoiceonline/ui-react';
418
+
419
+ // Good — status reported by the label, the glyph (on by default) and colour only reinforce it.
420
+ <Badge emotion="success" icon={BADGE_STATUS_ICONS.success}>Zaplaceno</Badge>
421
+ <Badge emotion="danger" icon={BADGE_STATUS_ICONS.danger}>Po splatnosti</Badge>
422
+
423
+ // Good — text-only, the exception: a dense invoice-table cell with no room for icon + label
424
+ <Badge emotion="violet" size="sm">Budoucí</Badge>
425
+
426
+ // Good — solid to lift one status out of a soft run
427
+ <Badge emotion="warning" appearance="solid" icon={BADGE_STATUS_ICONS.warning}>Nezaplaceno</Badge>
428
+
429
+ // Good — brand as a marketing accent on a landing page, never as a status
430
+ <Badge emotion="brand">Novinka</Badge>
431
+
432
+ <Badge emotion="neutral" shape="round" size="sm">3</Badge>
433
+ ```
434
+
435
+ ```tsx
436
+ // Don't — a badge is not a control; use Button / Chip
437
+ <Badge emotion="info" onClick={openFilter}>Filtr</Badge>
438
+
439
+ // Don't — brand is not a status
440
+ <Badge emotion="brand">Zaplaceno</Badge>
441
+
442
+ // Don't — a sentence in a badge; it truncates
443
+ <Badge emotion="danger">Faktura je 14 dní po splatnosti, pošlete upomínku.</Badge>
444
+
445
+ // Don't — a status badge without its glyph where the host has room for it
446
+ <Badge emotion="success">Zaplaceno</Badge>
447
+
448
+ // Don't — a decorative glyph that does not map to the status
449
+ <Badge emotion="success" icon="star">Zaplaceno</Badge>
450
+
451
+ // Don't — hardcoded colours instead of the emotion tokens
452
+ <Badge className="bg-[#e6f8ee] text-[#0a7a3d]">Zaplaceno</Badge>
453
+ ```
454
+
455
+ ## Related
456
+
457
+ - [**Chip**](?path=/docs/design-system-atoms-chip--docs) — the interactive sibling on the same Pill recipe (Basic · Selectable ·
458
+ Deleteable), with hover / focus / disabled states. Anything clickable or removable belongs there.
459
+ - [`Divider`](?path=/docs/design-system-atoms-divider--docs) — another atom on the same token-bound
460
+ foundation.
461
+ - **Button** — the `brand` variant Badge `brand` pairs with on marketing surfaces.
462
+ - Spec: `spec/03-atoms/badge.md`
463
+ and the shared chrome recipe
464
+ `spec/06-patterns/pill.md`.
465
+
466
+ ## Migration notes
467
+
468
+ - Replaces the deprecated **Badge** + **Badge Advanced** (= Badge + Tooltip, not a variant). The
469
+ interactive **Selectable** + **Deleteable** sets move to the separate **Chip** family.
470
+ - Warning fill un-browned: `orange/700` (white text) → `orange/500` + a **dark** foreground.
471
+ - The six deprecated emotions (incl. **violet**) are preserved; **XXSmall** was dropped (AA risk,
472
+ unused).
473
+ - **Migrated onto the Pill recipe (2026-07-02):** radius tightened one step (md
474
+ `--radius-400 → --radius-300`, sm `--radius-300 → --radius-200`), inline padding went per-size
475
+ (md `--space-400` / sm `--space-300`, leading-glyph side steps down one in code), gap md
476
+ `--space-200 → --space-300`. Same values as Chip.
477
+ - **`brand` emotion added (2026-07-07, manifest 1.1.0):** +4 variants → 28. Soft = outline, solid =
478
+ filled; contrast ~2.3:1, marketing emphasis only.
479
+ - **2.2.0 — icon rule (docs-only):** a status Badge carries its glyph by default; text-only only
480
+ where the host has no room. The `icon` prop stays optional — call sites without it keep rendering,
481
+ but are audit targets.
482
+ - **3.0.0 — `shape` axis (Default · Round), not breaking:** existing usages keep `default`. `round`
483
+ (`--radius-full`, min-width = height) is the count badge — +28 variants → 56. 3.0.2 declares the Badge static
484
+ (`motion.none`) — the recipe has no transition or animation.
485
+ - **React naming:** the Figma `Style` axis is exposed as the `appearance` prop (`style` collides with
486
+ the HTML attribute), and the Figma `Icon` boolean has no dedicated prop — passing `icon` is the
487
+ toggle.