@invoiceonline/ui-react 0.0.0-stage → 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 +78 -2
  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 +357 -4
  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,525 @@
1
+ import { Meta, Canvas, Controls } from '@storybook/addon-docs/blocks';
2
+ import * as ComboboxFieldStories from './ComboboxField.stories';
3
+
4
+ <Meta of={ComboboxFieldStories} tags={['autodocs']} />
5
+
6
+ # ComboboxField
7
+
8
+ ## Metadata
9
+
10
+ - **Layer:** molecule
11
+ - **Status:** `draft` (naše implementace) · upstream spec je `stable`
12
+ - **Tokens used:** `--bg-primary`, `--bg-readonly`, `--border-width-100`, `--border-width-200`, `--disabled-background`, `--disabled-foreground`, `--font-body`, `--font-size-base`, `--font-size-heading-h5`, `--font-size-sm`, `--font-size-xs`, `--font-size-xxs`, `--font-weight-bold`, `--font-weight-normal`, `--icon-muted`, `--leading-loose`, `--leading-relaxed`, `--outline-default`, `--outline-focus`, `--outline-strong`, `--radius-200`, `--radius-400`, `--size-icon`, `--size-icon-small`, `--space-1000`, `--space-1100`, `--space-200`, `--space-300`, `--space-400`, `--space-500`, `--space-700`, `--space-800`, `--status-danger`, `--status-success-solid`, `--status-success-tint-foreground`, `--text-placeholder`, `--text-primary`, `--text-secondary`, `--text-wrap-body`
13
+ - **Manifest version:** `1.13.1`
14
+
15
+ ## Overview
16
+
17
+ Use a **ComboboxField** as the trigger for choosing **one value from a set too large to scan** — the user
18
+ *types to narrow*, they don't scroll. It is the **generic** trigger: picking commits one plain
19
+ value into the field. Manifest 1.6.3 (2026-09-02) handed the **ARES subject lookup** — a search that queries saved contacts *and* the registry at once and
20
+ autofills a whole identity block — to its own molecule, **Subject Lookup Field** (built as
21
+ `SubjectLookupField`, see its own docs page). The stories below still use those Czech
22
+ labels because they are the familiar shape, not because this component owns those surfaces.
23
+
24
+ **This component is the trigger only** — a native `<input role="combobox">` inside the Text Field shell.
25
+ The result list is **not** part of it: that overlay is composed separately from a Popover surface +
26
+ `ListRow` `option` rows. The relationship is exactly the one **SelectField** has to its option panel.
27
+
28
+ Do **not** use it for a fixed set small enough to scan (→ **SelectField**), for short free-form text
29
+ (→ **TextField**), for dates (→ **DatePicker**), or for several values at once (→ a multi-select filter
30
+ Popover). The signal is *"you have to type to find it"* — a Select that grows a search box is the wrong
31
+ family.
32
+
33
+ <Canvas of={ComboboxFieldStories.Playground} />
34
+
35
+ ## Rationale
36
+
37
+ ComboboxField turns type-to-narrow into one token-bound trigger:
38
+
39
+ 1. **One shell for every field.** The trigger reuses the Text Field shell (`textFieldShellVariants` /
40
+ `textFieldValueVariants`) — same border, fill, radius, padding and floating-label behaviour as every
41
+ other field. Fix the shell once, it lands here too. There is no second field skin.
42
+ 2. **State is a life-cycle, not a skin.** A search is a *flow*: you focus, type, wait, read results, pick.
43
+ The `state` axis models exactly that sequence, so a builder wires **transitions**, not six unrelated looks.
44
+ 3. **The trailing slot carries the machine.** One glyph position tells you where you are — caret (closed /
45
+ open), spinner (loading), clear × (something is chosen).
46
+ 4. **Trigger ≠ overlay.** The field owns the input, the `combobox` role and the affordances; the result
47
+ list is a separate surface. Keeping them apart is what lets one trigger open either the Search or the
48
+ Inline overlay.
49
+
50
+ ## Anatomy
51
+
52
+ - **Shell** — the reused Text Field frame: `--bg-primary` fill, 1px `--outline-default` border
53
+ (`--border-width-100`) swapping to `--outline-focus`, radius `--radius-400`, horizontal padding
54
+ `--space-500`, gap `--space-400`. Height fixed on the 4-grid (`md` 48 / `sm` 40).
55
+ - **Input** — a native `<input type="text" role="combobox" aria-autocomplete="list">`. The typed query,
56
+ then the committed subject name, in `--text-primary`; the empty-state placeholder
57
+ (`Zadejte jméno, název nebo IČO…`) in `--text-placeholder`. Being editable it **scrolls** horizontally
58
+ (native), it never ellipsises.
59
+ - **Value description** (optional, `valueDescription`, Selected only) — one secondary line **inside the
60
+ shell** under the committed value: `Body/S` Regular, `--text-secondary`, single line with ellipsis. It
61
+ carries the picked entity's second fact (an IBAN under a bank-account name) or says in two words that
62
+ it is missing (`IBAN nevyplněn`). With it the fixed height becomes the **minimum** — the shell hugs both
63
+ lines with `--space-500` above and below and the clear × stays vertically centred. It is part of the
64
+ value, not the helper (the helper stays outside the shell).
65
+ - **Floating label** — NOT owned by ComboboxField; wrap it in **Field** (`label="Odběratel"`) for the
66
+ floating `<label>`, helper text and messaging.
67
+ - **Leading slot** (optional) — the search magnifier, `leadingIcon="magnifying-glass"`, bound to `--icon-muted`.
68
+ Available on the shell but **off by default** — the shipped trigger leads with the label and shows only
69
+ the trailing indicator.
70
+ - **Trailing slot** — the **state-driven indicator**, the only moving part: `caret-down-small`, turned
71
+ 180° while open → `spinner` (Loading) → clear `×` (Selected). The caret is `--icon-muted`;
72
+ the spinner and the clear × are `--text-secondary`.
73
+ - **The result overlay is NOT here** — it is composed from `popoverSurfaceVariants` + `ListRow` `option`
74
+ rows plus a sticky manual-entry row (`Zadám vše o subjektu ručně`). Below `sm` it is a bottom sheet
75
+ instead — see [Composed with a panel](#composed-with-a-panel).
76
+
77
+ ## Variants
78
+
79
+ <Canvas of={ComboboxFieldStories.Matrix} />
80
+
81
+ Two axes and nothing else: **`state`** (the flow — see [States](#states)) × **`size`** (density).
82
+ 12 combinations, mirroring the Figma labelled grid.
83
+
84
+ <table>
85
+ <thead>
86
+ <tr><th>Axis</th><th>Values</th><th>When / tokens</th></tr>
87
+ </thead>
88
+ <tbody>
89
+ <tr><td><code>state</code></td><td><code>default</code> · <code>focused</code> · <code>typing</code> · <code>loading</code> · <code>open</code> · <code>selected</code></td><td>The <strong>flow</strong> of one search. Only the border (<code>--outline-default</code> ↔ <code>--outline-focus</code>), the value ink (<code>--text-placeholder</code> → <code>--text-primary</code>) and the trailing indicator move.</td></tr>
90
+ <tr><td><code>size</code></td><td><code>md</code> (default) · <code>sm</code></td><td>Density / measurement axis — see <a href="#sizes">Sizes</a>.</td></tr>
91
+ <tr><td><code>leadingIcon</code></td><td><code>magnifying-glass</code> · unset (default)</td><td>Optional leading magnifier, <code>--icon-muted</code>. Not a variant of the design set — a per-instance shell capability.</td></tr>
92
+ </tbody>
93
+ </table>
94
+
95
+ There is deliberately **no** `error` / `success` / `disabled` / `readonly` axis on the trigger. Registry
96
+ validation (invalid IČO, verifying, verified, error/retry) happens on the **manual-entry TextFields** that
97
+ the overlay's *"Zadám vše o subjektu ručně"* escape hatch opens — those are plain TextFields carrying
98
+ the standard status states.
99
+
100
+ ## Sizes
101
+
102
+ <Canvas of={ComboboxFieldStories.Sizes} />
103
+
104
+ <table>
105
+ <thead>
106
+ <tr><th>Size</th><th style={{ textAlign: 'right' }}>Height</th><th>Padding (X)</th><th>Gap</th><th style={{ textAlign: 'right' }}>Icons (all slots)</th><th>Radius</th><th>Opens rows</th></tr>
107
+ </thead>
108
+ <tbody>
109
+ <tr><td><code>md</code> (default)</td><td style={{ textAlign: 'right' }}>48</td><td><code>--space-500</code></td><td><code>--space-400</code></td><td style={{ textAlign: 'right' }}>24 <code>--size-icon</code></td><td><code>--radius-400</code></td><td><code>md</code> ListRows (40)</td></tr>
110
+ <tr><td><code>sm</code></td><td style={{ textAlign: 'right' }}>40</td><td><code>--space-500</code></td><td><code>--space-400</code></td><td style={{ textAlign: 'right' }}>20 <code>--size-icon-small</code></td><td><code>--radius-400</code></td><td><code>sm</code> ListRows (36)</td></tr>
111
+ </tbody>
112
+ </table>
113
+
114
+ Heights are **fixed** on the 4-grid (inherited from TextField). **`md` (48)** is the default on standard
115
+ invoice forms; **`sm` (40)** is for dense filter bars and inline rows. Pick by density — the opened
116
+ overlay renders its result rows **one step below** the trigger (48 → 40, 40 → 36). Width is layout: the
117
+ field fills its column.
118
+
119
+ **Type does not step with the size.** The value and the placeholder are `Body/M` in **both** sizes —
120
+ the shell is a nested Text Field *instance*, and only the box shrinks. The manifest used to carry a
121
+ `sizes[1].textStyle: "Body/S"` at Small, which was Text Field's own Small-size style leaking into the
122
+ shell's row; 1.7.0 (2026-09-16) removed it. Our implementation shares TextField's value recipe, so it
123
+ never had the per-size step.
124
+
125
+ **The one exception to the fixed height is a Selected field with a value description** (1.8.0). The
126
+ fixed height becomes the minimum (`min-h-1100` / `min-h-1000`), the shell hugs its two lines with
127
+ `--space-500` above and below, and the clear × stays vertically centred. Only the description line is
128
+ `Body/S`; the value keeps `Body/M`.
129
+
130
+ <Canvas of={ComboboxFieldStories.WithValueDescription} />
131
+
132
+ > **Icon tier.** Every glyph in the shell (leading magnifier, caret, spinner, clear ×) uses the
133
+ > **TextField icon tier: `md` 24 / `sm` 20**. This used to be a documented departure — the manifest
134
+ > carried a flat 16 while the code rendered 24/20 — and `combobox-field` 1.6.2 (2026-09-02) resolved it
135
+ > in the code's favour: `sizes[].icon` is now 24 / 20 upstream too, for the reason this note always
136
+ > gave, that the number is the **slot box** the icon takes as its width and height (`<Icon size>`), not the drawn mark.
137
+ > The manifest 1.3.0 change (2026-07-15) was about the **glyph**, `caret-down` → `caret-down-small`,
138
+ > which is exactly what the `caret-down-small` below renders (turned 180° when open, manifest 1.12.0).
139
+
140
+ ## States
141
+
142
+ <Canvas of={ComboboxFieldStories.States} />
143
+
144
+ > **`state` is a FLOW axis, not a matrix of independent skins.** One search moves through the sequence
145
+ > below and the **transitions** are the contract a consumer wires. The shell is otherwise constant.
146
+
147
+ 1. **`default`** — resting, list closed. Border `--outline-default`; the placeholder
148
+ (`Zadejte jméno, název nebo IČO…`) in `--text-placeholder`; trailing `caret-down-small`
149
+ (`--icon-muted`). → focusing the field moves to **`focused`**.
150
+ 2. **`focused`** *(empty)* — the field has focus, nothing typed. Border swaps to `--outline-focus`
151
+ (**no ring**, border-swap only — TextField parity); interior empty; caret still down. On a real
152
+ Combobox, focusing may already open the panel showing just the manual-entry action.
153
+ → the first keystroke moves to **`typing`**.
154
+ 3. **`typing`** — a partial query (`Nov`). Value ink `--text-primary`; border `--outline-focus`; trailing
155
+ caret turns up (`caret-down-small` rotated 180°) — the list is open and filtering live. `aria-expanded="true"`.
156
+ → a fetch moves to **`loading`**, a synchronous filter straight to **`open`**.
157
+ 4. **`loading`** — results are being fetched (the ARES round-trip). The trailing becomes a spinning
158
+ `spinner` (`--text-secondary`) and the input gets `aria-busy="true"`; the panel is still open, so
159
+ `aria-expanded` stays true. The overlay announces *"Vyhledávám…"* through its `aria-live` region.
160
+ → **`open`** once results land.
161
+ 5. **`open`** *(results)* — matches are shown in the overlay below. Border `--outline-focus`; value
162
+ `--text-primary`; caret turned up. ↑/↓ move the highlight via `aria-activedescendant` while DOM
163
+ focus stays in the input. → Enter / a click commits to **`selected`**; Esc returns toward **`default`**.
164
+ 6. **`selected`** — a value is committed (`Novák s.r.o.`). Border returns to `--outline-default`; value
165
+ `--text-primary`; the trailing becomes the **clear ×** (`--text-secondary`, a real `<button>`).
166
+ With a `valueDescription` a second line shows under the value (see [Anatomy](#anatomy)); it never
167
+ appears in any other state — the type accepts the prop only on the `selected` branch.
168
+ → the clear × resets the query back to **`default`**.
169
+
170
+ <table>
171
+ <thead>
172
+ <tr><th>State</th><th>Border</th><th>Value ink</th><th>Trailing</th><th>ARIA derived</th></tr>
173
+ </thead>
174
+ <tbody>
175
+ <tr><td><code>default</code></td><td><code>--outline-default</code></td><td><code>--text-placeholder</code></td><td><code>caret-down-small</code> · <code>--icon-muted</code></td><td><code>aria-expanded="false"</code></td></tr>
176
+ <tr><td><code>focused</code></td><td><code>--outline-focus</code></td><td><code>--text-placeholder</code></td><td><code>caret-down-small</code> · <code>--icon-muted</code></td><td><code>aria-expanded="false"</code></td></tr>
177
+ <tr><td><code>typing</code></td><td><code>--outline-focus</code></td><td><code>--text-primary</code></td><td><code>caret-down-small</code> turned 180° · <code>--icon-muted</code></td><td><code>aria-expanded="true"</code></td></tr>
178
+ <tr><td><code>loading</code></td><td><code>--outline-focus</code></td><td><code>--text-primary</code></td><td><code>spinner</code> · <code>--text-secondary</code></td><td><code>aria-expanded="true"</code>, <code>aria-busy="true"</code></td></tr>
179
+ <tr><td><code>open</code></td><td><code>--outline-focus</code></td><td><code>--text-primary</code></td><td><code>caret-down-small</code> turned 180° · <code>--icon-muted</code></td><td><code>aria-expanded="true"</code></td></tr>
180
+ <tr><td><code>selected</code></td><td><code>--outline-default</code></td><td><code>--text-primary</code></td><td>clear <code>×</code> (<code>x-small</code>) · <code>--text-secondary</code></td><td><code>aria-expanded="false"</code></td></tr>
181
+ </tbody>
182
+ </table>
183
+
184
+ Because `state` is an explicit prop (not a CSS pseudo-state), every step above is rendered **statically**
185
+ with the data that step of the search would really hold — that is why the States canvas reads as a flow.
186
+
187
+ **The trailing slot is state-driven, not a user slot.** There is no `trailingIcon` prop: the state machine
188
+ owns that position. The clear × always renders on `state="selected"` — and the type system makes sure it
189
+ works, because that state *requires* `onClear` + `clearLabel` (see [API](#api)).
190
+
191
+ ### Motion
192
+
193
+ <Canvas of={ComboboxFieldStories.Motion} />
194
+
195
+ Manifest 1.12.0 `motion` — two things move. **The caret** (`states.open`): entering `typing` / `open`
196
+ turns the one `caret-down-small` glyph 180° (down → up) on `--spring-standard` (`springs.standard` from
197
+ the package tokens, in Motion), and leaving them turns it back — the field no longer swaps it for
198
+ `caret-up-small`. A quick re-toggle turns it around mid-turn (`interrupt`); the first paint and the server
199
+ render show the current pose without a turn. **The spinner** (`loop`): in `loading` it takes the caret slot
200
+ and turns once per `--duration-spin` on `--easing-linear`, forever (`animate-spin`). Under
201
+ `prefers-reduced-motion: reduce` the `MotionConfig` in `FodsProvider` drops the caret's transform animation, so it
202
+ shows its end pose at once; the spinner keeps turning — a loader is essential motion. The border swap and
203
+ floating label are the Text Field shell's (`inherits: [text-field]`).
204
+
205
+ > **Icon names.** The code uses the spec's names: `caret-down-small` (one glyph, turned 180° when open) /
206
+ > `magnifying-glass` / `x`. The clear × itself is `x-small` (manifest 1.10.0).
207
+
208
+ > **Placeholder ink — settled, not a drift.** `--text-placeholder` (claudy/400, 2.71:1) **is** canon:
209
+ > the token was minted 2026-07-08 for exactly this role, replacing the interim `--text-secondary`
210
+ > binding the `--text-tertiary` kill left behind, and its sub-AA ratio is an accepted exception for
211
+ > placeholder text. The manifest binds `--text-placeholder` in `families[].states`. This page used to call that a drift and
212
+ > ask for a retarget; manifest 1.7.0 (2026-09-16) corrected the stale prose in `text.placeholder.note`
213
+ > and `notes[4]` — nothing to file, nothing to fix. Our implementation is TextField parity
214
+ > (`placeholder:text-text-placeholder`) and always was.
215
+
216
+ ## API
217
+
218
+ <Controls />
219
+
220
+ Beyond the props above, every native `<input>` attribute passes through (`value`, `onChange`, `onKeyDown`,
221
+ `placeholder`, `id`, `aria-controls`, `aria-activedescendant`, …). Two things are **derived** but
222
+ overridable / never derived:
223
+
224
+ - `aria-expanded` is derived from `state` (`typing` / `loading` / `open` → `true`). An explicitly passed
225
+ `aria-expanded` always wins — the organism owning the popup knows better.
226
+ - `valueDescription` (optional) is accepted **only** on the `state="selected"` branch of the union —
227
+ every other branch types it as `undefined`, because the description never appears outside Selected.
228
+ The input references it via `aria-describedby`, merged with any `aria-describedby` you pass.
229
+ - `aria-controls` and `aria-activedescendant` are **never** derived: they reference ids this field does not
230
+ own, so they only pass through. The owning organism must supply them.
231
+ - `autoComplete` defaults to `"off"` — the browser autofill panel would cover the result listbox and fight
232
+ it for keystrokes (ARIA APG). Overridable if a consumer really wants native autofill.
233
+
234
+ > **TS gotcha — the clear-× union.** `state`, `onClear` and `clearLabel` are **one discriminated union**:
235
+ > `state="selected"` requires both handlers, every other state forbids them. That makes the spec's rule
236
+ > ("Selected always carries the clear ×", overlay decision S6) a compile-time guarantee and forces an
237
+ > accessible name onto the icon-only button (WCAG 4.1.2). A conditional spread —
238
+ > `{...(isSelected ? { onClear, clearLabel } : {})}` — widens the union away and no longer type-checks.
239
+ > **Branch the render instead** (see Usage).
240
+
241
+ ## Do / Don't
242
+
243
+ - ✅ Reach for it when the set is **too large to scan** and the user should **type to narrow** (contacts, ARES).
244
+ - ✅ Keep **focus in the input** for the whole search; move the highlight with `aria-activedescendant`.
245
+ - ✅ Let the **flow state** drive the trigger and own the trailing indicator.
246
+ - ✅ Wrap in **Field** for the floating `<label>` — it is the accessible name (or pass `aria-label`).
247
+ - ✅ Pass `aria-controls` / `aria-activedescendant` from the organism that owns the popup id.
248
+ - ✅ Render the overlay's result rows **one density step below** the trigger (48 → 40, 40 → 36).
249
+ - ✅ Pair `onClear` with a real `clearLabel` (`"Zrušit výběr"`) and branch the render, don't spread.
250
+ - ✅ Use `valueDescription` when the picked entity is known by two facts and the panel lists it as an
251
+ Action Row with a description — the field then shows the same two lines as the row the user picked.
252
+ - ❌ Don't put a rule, a hint or an error into `valueDescription` — that is the helper; never a third line.
253
+ - ❌ Don't use it for a short fixed set — that's a **SelectField**; don't bolt a search box onto a Select.
254
+ - ❌ Don't move DOM focus onto a result row — that turns a Combobox into a **Menu**.
255
+ - ❌ Don't treat the trailing slot as a free icon slot; the state owns it.
256
+ - ❌ Don't put registry validation on the trigger — invalid-IČO / verifying / error belong on the
257
+ manual-entry TextFields the escape hatch opens.
258
+ - ❌ Don't add a focus ring or a second, darker "open" border.
259
+ - ❌ Don't tint the surface — the field is always `--bg-primary`.
260
+ - ❌ Don't rebuild the ARES "nápověda" chrome here — that is the separate **Subject Lookup** pattern.
261
+
262
+ ## Accessibility
263
+
264
+ - **Semantics** — a native `<input role="combobox" aria-autocomplete="list">` inside the shell. The input
265
+ owns `aria-expanded`, `aria-controls` (the popup id) and `aria-activedescendant` (the current option id).
266
+ The popup body is `role="listbox"` and each result row an `option` — injected by the overlay organism,
267
+ not by this field. The floating label from `Field` is a real `<label for>`; a label-less filter variant
268
+ needs an explicit `aria-label`. The placeholder is **not** an accessible name.
269
+ - **The panel owes its own name.** `listbox` is name-required and a panel inherits **nothing** from the
270
+ trigger that opened it — the label sits on the *field*, which makes the panel look named when it is
271
+ not. Whichever organism renders the popup must point it at the same visible label with
272
+ `aria-labelledby` (the mechanism `Select` already uses via `Field`); `aria-label` only when nothing
273
+ visible names the input. Rule:
274
+ `overlay-behavior.md` § Naming.
275
+ - **Keyboard** — typing filters live · **↑ / ↓** move the highlight (via `aria-activedescendant`) ·
276
+ **Enter** selects + closes · **Esc** closes and clears the query, staying in the input ·
277
+ **Tab** leaves the combobox and closes the panel (WAI-ARIA APG) · **Home / End** jump within the ring.
278
+ The overlay's *"Zadám vše o subjektu ručně"* action is the **last item of the ↑/↓ ring** — an `option`
279
+ **without** `aria-selected` (a non-selectable option whose name states the action); Enter runs it, it
280
+ never becomes the value. While `loading`, the status row replaces the results, so the ring holds only
281
+ that action (or nothing): the previous results stay out of reach until the new ones are shown.
282
+ When they are, the highlight returns to the first result, unless the user moved it onto the action
283
+ while results were on screen and has not typed since.
284
+ - **Mobile bottom sheet (below `sm`)** — the field on the page is a read-only trigger
285
+ (`aria-haspopup="dialog"` + `aria-expanded`). The sheet is `role="dialog"` + `aria-modal="true"`, named
286
+ by its title (`sheetTitle`, else the field label); the page behind is `inert`. Focus lands on the sheet's
287
+ **search input**, which is the `combobox` while the sheet is open (`aria-controls` → the sheet listbox,
288
+ `aria-activedescendant` → the highlighted row, named by the title). The manual-entry action is a `link`
289
+ `ListRow` with `role="button"` in the fixed footer, reached with Tab. A visually hidden «Zavřít» button, Esc, a drag down and the
290
+ scrim close it without a change, and focus returns to the field. For the hidden close button,
291
+ its name is the optional `sheetCloseLabel` (default «Zavřít»), which an app with more than one language version passes from its translations on every use; the full list of such props is in [Consuming → Texts and locale](?path=/docs/getting-started-consuming--docs#texts-and-locale). Like `sheetTitle`, it is a prop of the `Combobox` organism.
292
+ - **Focus** — stays in the input for the whole search; it never lands on a result row. The field shows
293
+ focus by the **border swap to `--outline-focus`**, no additive ring. ⚠️ Accepted tradeoff inherited from
294
+ TextField: a 1px swap is borderline for WCAG 2.4.11 — if visibility becomes an issue, thicken the focus
295
+ border, don't re-add a ring. Result rows carry no focus ring, only the soft Highlighted fill. The clear ×
296
+ is itself focusable and **does** show a `focus-visible` ring (it is a button, not the field).
297
+ - **Value description** — not part of the input's value: the `<input>` holds the first line only; the
298
+ description is a text node inside the shell with its own `id`, and the input points at it with
299
+ `aria-describedby` (merged with a consumer-supplied one), so a screen reader reads it after the value.
300
+ - **State & ARIA** — `loading` sets `aria-busy="true"`; a committed value = `aria-selected` on its option +
301
+ the clear × on the trigger; the highlighted option = `aria-activedescendant` on the input.
302
+ - **Screen reader** — the list's runtime states are announced live: **Loading** *"Vyhledávám…"*,
303
+ **Empty** *"Žádné výsledky"* — never a silently blank panel. The **Error** row the spec also lists
304
+ (`combobox-field.md` § Accessibility) is not built: `Combobox` has no error state to show. Put the
305
+ `aria-live="polite"` on the **status row**, not on the listbox itself, or opening the panel re-announces
306
+ every option. The clear × announces its `clearLabel`.
307
+ - **Target** — the whole field is the hit area; the clear × is a **≥24px** target
308
+ (`min-h-800 min-w-800`) inside the trailing slot.
309
+ - **Contrast & motion** — caret/magnifier `--icon-muted` clears the 3:1 non-text floor; value
310
+ `--text-primary` and spinner/clear `--text-secondary` clear AA. The placeholder sits on
311
+ `--text-placeholder` (2.71:1) — an **accepted** sub-AA exception for placeholder ink, not an open
312
+ item; see the note in [States](#states). The spinner uses `animate-spin` (one turn per
313
+ `--duration-spin`, kept under reduced motion); the caret turn drops to its end pose under reduced
314
+ motion — see [Motion](#motion). The overlay fade is `--duration-fast` (150ms).
315
+
316
+ Accessibility floor for every FODS component: `spec/01-foundations/accessibility.md`.
317
+
318
+ ## Copy
319
+
320
+ Voice: the field copy rules of TextField hold here unchanged: impersonal, clear over clever,
321
+ concise, specific and helpful, consistent terminology. Examples are Czech; the rules apply to every
322
+ language version.
323
+
324
+ - **Label** — the subject role as a noun, sentence case, no colon: *Dodavatel* · *Odběratel*.
325
+ 1–2 words. Single line, truncates, max 24 characters.
326
+ - **Placeholder** (`placeholder`) — the empty-state search prompt naming what can be typed:
327
+ *Zadejte jméno, název nebo IČO…*. It states the accepted inputs and ends with an ellipsis; it is
328
+ the one place the impersonal voice bends to a light instruction. Not a bare label repeat
329
+ (*Odběratel*), not a command dressed as help (*Vyhledejte prosím…*). Shown only in Default and
330
+ Focused (empty). Single line, truncates, max 40 characters.
331
+ - **Value** — the typed query, then the committed subject's real name (*Novák s.r.o.*). Single
332
+ line; the input scrolls horizontally, no ellipsis. The clear × reverts to the placeholder prompt.
333
+ - **Value description** (`valueDescription`, Selected only, optional) — the entity's second fact as
334
+ data, not a sentence: an IBAN, an account number. When the fact is missing, say so in two words:
335
+ *IBAN nevyplněn*. Not a helper, never a rule or an error; no terminal period. Single line,
336
+ truncates, max 40 characters.
337
+ - **Sheet title** (`sheetTitle` on `Combobox`, optional) — the title of the mobile bottom sheet.
338
+ Leave it empty when the label names the field in full; set it when the label is abbreviated. A
339
+ noun phrase, no verb, no trailing period. Never shown on desktop. Single line, truncates, max 40
340
+ characters.
341
+ - **Sheet close label** (`sheetCloseLabel` on `Combobox`, optional, default *Zavřít*) — the name of
342
+ the hidden close button of the mobile bottom sheet, heard by a screen reader and seen only while
343
+ it holds keyboard focus. A bare imperative verb, no object, no period. An app with more than one
344
+ language version passes it from its translations. Never shown on desktop. Single line, truncates,
345
+ max 20 characters.
346
+ - **List runtime copy** (`loadingLabel`, `emptyLabel`, `manualEntry.label` on `Combobox`) — rendered
347
+ on the overlay and announced through `aria-live`. Loading is present tense, one word and an
348
+ ellipsis; no results is a plain noun phrase, never an apology or a command; the manual-entry
349
+ action is first person and verb-led, because bypassing the registry is the user's own choice.
350
+
351
+ Canonical texts:
352
+
353
+ <table>
354
+ <thead>
355
+ <tr><th>Run</th><th>Text</th></tr>
356
+ </thead>
357
+ <tbody>
358
+ <tr><td>Placeholder</td><td>Zadejte jméno, název nebo IČO…</td></tr>
359
+ <tr><td>Sheet title, label «DPH»</td><td>Sazba DPH</td></tr>
360
+ <tr><td>Sheet title, label «M.J.»</td><td>Měrná jednotka</td></tr>
361
+ <tr><td>Sheet close label</td><td>Zavřít</td></tr>
362
+ <tr><td>Loading</td><td>Vyhledávám…</td></tr>
363
+ <tr><td>No results</td><td>Žádné výsledky</td></tr>
364
+ <tr><td>Manual entry (Search overlay)</td><td>Zadám vše o subjektu ručně</td></tr>
365
+ <tr><td>Manual entry (inline)</td><td>Zadám vše ručně…</td></tr>
366
+ </tbody>
367
+ </table>
368
+
369
+ ## Usage
370
+
371
+ <Canvas of={ComboboxFieldStories.WithField} />
372
+
373
+ **`Field` and the floating label.** ComboboxField is not marked `autoFloating` in `Field`'s `FIELD_CHILD_TRAITS` — it
374
+ behaves like **TextField**: the label floats once the field is focused or filled. `Field` additionally
375
+ floats whenever a `placeholder` is set (`Field.tsx` → `hasPlaceholder`), and the spec's Default copy
376
+ always sets one, so **the resting field shows the floated label chip above the placeholder**.
377
+
378
+ > ⚠️ **Known deviation from Figma.** The Figma `State=Default` variant hides the label layer entirely and
379
+ > shows only the interior placeholder (the 2026-07-09 upstream fix, which removed a chip+placeholder
380
+ > collision). Our resting field keeps both. This is deliberate: the float rule belongs to `Field` and is
381
+ > shared by every field in the repo, and a labelless resting field would leave the placeholder as the
382
+ > only visible name. If the design side wants Figma parity, the change belongs in `Field`, not here.
383
+
384
+ ```tsx
385
+ // Good — wrapped in Field for the floating label; the <label> is the accessible name
386
+ <Field label="Odběratel" helperText="Hledá se podle jména, názvu nebo IČO">
387
+ <ComboboxField
388
+ id="subject"
389
+ value={query}
390
+ placeholder="Zadejte jméno, název nebo IČO…"
391
+ state={open ? 'open' : 'default'}
392
+ aria-controls="subject-listbox"
393
+ aria-activedescendant={open ? activeOptionId : undefined}
394
+ onChange={event => setQuery(event.target.value)}
395
+ />
396
+ </Field>
397
+
398
+ // Good — the clear-× contract is a TS union, so BRANCH the render
399
+ {selected ? (
400
+ <ComboboxField
401
+ state="selected"
402
+ value={selected.name}
403
+ aria-label="Odběratel"
404
+ onClear={reset}
405
+ clearLabel="Zrušit výběr"
406
+ />
407
+ ) : (
408
+ <ComboboxField state="default" value={query} placeholder="Zadejte jméno, název nebo IČO…" aria-label="Odběratel" />
409
+ )}
410
+
411
+ // Don't — a conditional spread widens the union away (and no longer compiles)
412
+ <ComboboxField state="selected" value="Novák s.r.o." {...(selected ? { onClear, clearLabel } : {})} />
413
+
414
+ // Don't — the trailing slot belongs to the flow state; there is no user icon slot
415
+ <ComboboxField state="open" trailingIcon="check" />
416
+
417
+ // Don't — no validation states on the trigger; put them on the manual-entry TextFields
418
+ <ComboboxField state="error" />
419
+ ```
420
+
421
+ The leading magnifier is opt-in per instance:
422
+
423
+ <Canvas of={ComboboxFieldStories.WithLeadingIcon} />
424
+
425
+ ```tsx
426
+ // Good — opt in where the search affordance genuinely helps
427
+ <ComboboxField leadingIcon="magnifying-glass" placeholder="Zadejte jméno, název nebo IČO…" aria-label="Odběratel" />
428
+ ```
429
+
430
+ ## Composed with a panel
431
+
432
+ ComboboxField is the **trigger only**. The open Combobox is the **`Combobox` organism**: the trigger + a
433
+ Popover surface + [ListRow](?path=/docs/design-system-atoms-listrow--docs) `option` rows, plus the sticky
434
+ manual-entry row (`manualEntry` — `Zadám vše o subjektu ručně`), a `link` row that is the **last item of
435
+ the ↑/↓ ring**: `role="option"` without `aria-selected`, Enter runs it. Focus never leaves the input: ↑/↓
436
+ move `aria-activedescendant`, Enter commits. Result rows sit one density step below the trigger.
437
+
438
+ **Dismissal belongs to the organism, not to the field** — a stateless trigger has nothing to close.
439
+ `Combobox` gets it from the shared `useAnchoredPanel` substrate, and it is the spec's closed set
440
+ (`overlay-behavior.md` § Dismissal): **Esc** (which also clears the query and stays in the input),
441
+ **outside pointer-down**, **selection**, route change, and **Tab**, which leaves the combobox and closes
442
+ the panel (WAI-ARIA APG — the manual-entry row is reached with ↓, not Tab). Two fields on one page
443
+ therefore can never be open at the same time.
444
+
445
+ **Below `sm` (640 viewport) the panel is a bottom sheet** (combobox-field 1.11.0, `overlay-behavior.md`
446
+ § Mobile): grab handle and centred title — `sheetTitle` on the `Combobox` organism, defaulting to the field
447
+ label (set it only when the label is abbreviated) — then the search row with a **line under it**, List Row
448
+ Mobile results (the chosen row with its trailing check in `--secondary`, list-row 2.7.0, no leading reserve), and the
449
+ manual-entry action in a fixed footer above a line. It stacks above a Modal at `--z-index-popover`; Esc
450
+ closes only the sheet. `sheetTitle` lives on the organism because this trigger owns no panel.
451
+
452
+ <Canvas of={ComboboxFieldStories.MobileSheet} />
453
+
454
+ Narrowing stays with the caller: `Combobox` takes `items` that are already filtered, because the same
455
+ organism serves a local match and a debounced ARES round trip.
456
+
457
+ <Canvas of={ComboboxFieldStories.WithPanel} />
458
+
459
+ ```tsx
460
+ <Field label="Odběratel">
461
+ <Combobox
462
+ items={results} // already filtered
463
+ query={query}
464
+ onQueryChange={setQuery}
465
+ value={subject} // the ComboboxItem, not its id
466
+ onValueChange={setSubject}
467
+ loading={isFetching}
468
+ // No defaults — the organism has no locale of its own, the strings come from
469
+ // the consumer's translation layer. The panel takes its name from the Field
470
+ // label (`panelLabel` is only the fallback for a field without a visible label).
471
+ emptyLabel="Žádné výsledky"
472
+ loadingLabel="Vyhledávám…"
473
+ clearLabel="Zrušit výběr"
474
+ manualEntry={{
475
+ label: 'Zadám vše o subjektu ručně',
476
+ icon: <Icon name="pencil-simple" size="small" />,
477
+ onSelect: openManualFields,
478
+ }}
479
+ sheetTitle="Odběratel" // only when the visible label is abbreviated
480
+ />
481
+ </Field>
482
+ ```
483
+
484
+ ## Related
485
+
486
+ - **TextField** — the shell ComboboxField reuses (`textFieldShellVariants` / `textFieldValueVariants`); the
487
+ trigger is pixel-locked to it, and the status states live there.
488
+ - **SelectField** — the same trigger-only relationship for a **fixed, scannable** set; reach for it when the
489
+ user shouldn't have to type.
490
+ - **Combobox** — the organism around this trigger: it owns the result panel, the `listbox` role and
491
+ dismissal. Reach for it rather than re-composing the surface by hand.
492
+ - **Select** — the composed single-select dropdown (trigger + panel) the Select family ships.
493
+ - **ListRow** — the `option` rows of the result surface.
494
+ - **Popover surface** — the shared overlay chrome recipe (`popoverSurfaceVariants`) the result panel sits on.
495
+ - **AnchoredPanel** — anchoring / offset / dismissal behaviour for the floating result surface.
496
+ - **Field** — the floating label / helper / error wrapper.
497
+ - Spec: `spec/04-molecules/combobox-field.md`.
498
+
499
+ ## Migration notes
500
+
501
+ - **ARES subject-lookup is its OWN component (upstream, 2026-07-10).** The ARES subject lookup is a dedicated **Subject Lookup** pattern,
502
+ because its chrome genuinely differs (no leading icon; its own trailing state machine — magic wand
503
+ while empty, spinner while searching, check when found, a clear × once it holds a query — grouped
504
+ contacts/registry results, collapse-to-summary card). ComboboxField stays the **generic** trigger; an earlier attempt to host the ARES brand icon here
505
+ (spec v1.1.0) was reverted in v1.2.0.
506
+ - **Caret glyph moved to the small tier** (manifest 1.3.0, 2026-07-15): `caret-down`/`caret-up` →
507
+ `caret-down-small`/`caret-up-small`. The slot itself
508
+ keeps the shared field icon tier (`md` 24 / `sm` 20), same as TextField and SelectField.
509
+ - **Manifest 1.8.0 → 1.10.0.** 1.9.0 renamed the Figma Size values to the code vocabulary
510
+ (Medium / Small → `md` / `sm`) — the `size` prop already used those, so no code change. 1.10.0 moves
511
+ the Selected clear `×` to the small-tier glyph `x-small` (a 9px cross, pairing with the small caret in
512
+ the same trailing slot); the icon set now carries it and the clear button uses it.
513
+ - **Manifest 1.10.0 → 1.11.0.** Optional code-only `text.sheet-title` → `sheetTitle` on the `Combobox`
514
+ organism, the mobile bottom-sheet title. Shipped together with the sheet itself.
515
+ - **Manifest 1.11.0 → 1.12.0 — motion audit (2026-11-03).** The open caret is no longer a glyph swap
516
+ (`caret-down-small` ↔ `caret-up-small`): one `caret-down-small` turns 180° in Motion on
517
+ `--spring-standard` (shared `internal/MotionCaret.tsx`), interruptible, end pose at once under reduced
518
+ motion. The spinner already turned on `animate-spin`, now `--duration-spin` + `--easing-linear`
519
+ (ui-system 0.17.0). New `Motion` story.
520
+ - **Manifest 1.12.0 → 1.13.0 (2026-11-13).** Optional code-only `text.sheet-close-label` →
521
+ `sheetCloseLabel` on the `Combobox` organism: the name of the hidden close button of the mobile bottom
522
+ sheet, default «Zavřít». An app with more language versions passes it from its translations.
523
+ - **`Combobox` `footer` → `manualEntry`.** The free `footer` node (a Tab-reachable command outside the
524
+ ring) is replaced by `manualEntry={{ label, onSelect, icon? }}`: the organism renders the row and puts it
525
+ LAST in the ↑/↓ ring as a non-selectable `option`. Tab now closes the panel.