@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,693 @@
1
+ "use client";
2
+
3
+ import * as React from 'react';
4
+ import { Icon } from '../icon/Icon';
5
+ import { cn } from '../../internal/utils';
6
+ import { ComboboxField } from './ComboboxField';
7
+ import { ListRow } from '../list-row/ListRow';
8
+ import { AnchoredPanel } from '../anchored-panel/AnchoredPanel';
9
+ import { useAnchoredPanel } from '../../internal/useAnchoredPanel';
10
+ import { comboboxKeyDown, seekEnabled } from '../../internal/comboboxKeys';
11
+ import {
12
+ BottomSheet,
13
+ BottomSheetSearch,
14
+ SHEET_ROW_FOCUS_RING,
15
+ resolveFieldLabel,
16
+ useSheetPresentation,
17
+ } from '../../internal/BottomSheet';
18
+
19
+ // =============================================================================
20
+ // Combobox — the FODS type-to-narrow picker ORGANISM (spec
21
+ // 06-patterns/overlay-behavior.md · 04-molecules/combobox-field.md).
22
+ //
23
+ // `ComboboxField` is the TRIGGER only — it is stateless by design and owns no
24
+ // panel. This organism supplies everything the manifest delegates away from the
25
+ // field: the result surface, the `listbox` role, the keyboard contract, and
26
+ // DISMISSAL. Sibling of `Select`; the difference is that the trigger is typeable,
27
+ // so the caller owns the filtering and DOM focus never leaves the input.
28
+ //
29
+ // Dismissal: Esc (which also clears the query, per combobox-field.md § Keyboard),
30
+ // outside pointer-down, selection, and Tab — Tab leaves the combobox and closes the
31
+ // popup (WAI-ARIA APG; combobox-field 1.11.0 § Keyboard). The manual-entry row is
32
+ // not a Tab stop: it is the LAST item of the ↑/↓ ring, a non-selectable `option`
33
+ // (no `aria-selected`) that Enter runs (popover-patterns.md § Combobox (search)).
34
+ //
35
+ // Below `sm` (viewport width) the panel is the mobile BOTTOM SHEET instead
36
+ // (overlay-behavior.md § Mobile). The field on the page is then only a read-only
37
+ // trigger (`aria-haspopup="dialog"` + `aria-expanded`); the sheet carries its own
38
+ // search input, which takes over the `combobox` contract (`aria-expanded`,
39
+ // `aria-controls`, `aria-activedescendant`) while the sheet is open and is focused on
40
+ // open. The manual-entry action sits in the sheet's fixed footer as a `ListRow` with
41
+ // `role="button"`, reached with Tab. Esc, a drag down, the scrim and the hidden «Zavřít» close the
42
+ // sheet without a change; focus returns to the field.
43
+ // =============================================================================
44
+
45
+ export interface ComboboxItem {
46
+ /** Stable identity of the row. */
47
+ value: string;
48
+ /** Visible label — the row's first line and, once chosen, the trigger's value. */
49
+ label: string;
50
+ /** Second line of the row (e.g. `IČO 12345678 · Praha 3`). */
51
+ description?: React.ReactNode | React.ReactNode[];
52
+ /** Present but skipped by ↑/↓ and not selectable. */
53
+ disabled?: boolean;
54
+ /** Forwarded to the row's `data-testid`. */
55
+ testId?: string;
56
+ }
57
+
58
+ export interface ComboboxProps {
59
+ /**
60
+ * The rows to show — ALREADY filtered. Narrowing is the caller's job: the query
61
+ * that produces them may be a local `String.includes` or a debounced ARES round
62
+ * trip, and the organism must not care which.
63
+ */
64
+ items: ComboboxItem[];
65
+ /** The text in the input. Controlled, so a remote lookup can debounce off it. */
66
+ query: string;
67
+ onQueryChange: (query: string) => void;
68
+ /**
69
+ * The chosen item, not its id: the selection has to keep rendering its label in
70
+ * the trigger after the query narrowed `items` down to something that no longer
71
+ * contains it, and an id would have nothing left to resolve against.
72
+ */
73
+ value?: ComboboxItem | null;
74
+ onValueChange?: (item: ComboboxItem | null) => void;
75
+ /** Mid-lookup — spinner in the trigger, `aria-busy`, and an announced status row. */
76
+ loading?: boolean;
77
+ /** Trigger height — Medium (48) / Small (40); rows drop one density step. */
78
+ size?: 'md' | 'sm';
79
+ placeholder?: string;
80
+ /**
81
+ * The manual-entry escape hatch („Zadám vše o subjektu ručně"), pinned below the
82
+ * results as a `link` row. An ACTION, not a value: on the anchored panel it is the
83
+ * last item of the ↑/↓ ring — `role="option"` without `aria-selected`, Enter runs
84
+ * it, it never takes the Selected look and is never committed as the value. On the
85
+ * mobile sheet it is a `ListRow` with `role="button"` in the fixed footer, reached with Tab.
86
+ */
87
+ manualEntry?: ComboboxManualEntry;
88
+ /**
89
+ * Title of the mobile bottom sheet (combobox-field 1.11.0 `text.sheet-title`). Leave
90
+ * it empty when the field label names the field in full — the sheet then shows the
91
+ * label; set it when the label is abbreviated. Never shown on desktop.
92
+ */
93
+ sheetTitle?: string;
94
+ /**
95
+ * Accessible name of the visually hidden close button of the mobile bottom sheet.
96
+ * Defaults to «Zavřít» (Czech); an app with more language versions passes it from
97
+ * its translations.
98
+ */
99
+ sheetCloseLabel?: string;
100
+ // The required copy props below carry NO defaults on purpose: the consumer's
101
+ // translation layer supplies them (same rule as ActionRow's `labels` and
102
+ // Textarea's `overLimitLabel`). `sheetCloseLabel` above is the one optional
103
+ // text with a Czech default (Consuming.mdx → Texts and locale).
104
+ /** Empty-result copy — a plain noun phrase, never an apology. */
105
+ emptyLabel: string;
106
+ /** Announced while `loading`. */
107
+ loadingLabel: string;
108
+ /**
109
+ * Id of the visible text that names the panel. The panel is portalled out of
110
+ * the field and inherits no name from the input, so it points at the field's
111
+ * label (overlay-behavior.md § Naming). `Field` injects it — inside a labelled
112
+ * `Field` there is nothing to pass.
113
+ */
114
+ panelLabelledBy?: string;
115
+ /**
116
+ * Fallback name of the panel, used only when nothing visible names the field
117
+ * (no `Field` label, input named by `aria-label`) — then it has to be a
118
+ * translated string kept in step with that `aria-label`.
119
+ */
120
+ panelLabel?: string;
121
+ /** Accessible name of the clear ×. Required — the button is icon-only. */
122
+ clearLabel: string;
123
+ /** Id on the input — `Field` reads it for `<label htmlFor>` / helper wiring. */
124
+ id?: string;
125
+ className?: string;
126
+ /** Accessible name when there is no `Field` label. */
127
+ 'aria-label'?: string;
128
+ /** Set by `Field` when the field is in error. */
129
+ 'aria-invalid'?: boolean;
130
+ /** Set by `Field` to point at the helper/error message. */
131
+ 'aria-describedby'?: string;
132
+ /**
133
+ * `Field` injects its own status here. The Combobox trigger has NO error /
134
+ * success / disabled axis (combobox-field.md § States — registry validation
135
+ * lives on the manual-entry fields the escape hatch opens), so it is accepted
136
+ * and dropped; `aria-invalid` still passes through.
137
+ */
138
+ state?: string;
139
+ onFocus?: React.FocusEventHandler<HTMLInputElement>;
140
+ onBlur?: React.FocusEventHandler<HTMLInputElement>;
141
+ 'data-testid'?: string;
142
+ }
143
+
144
+ export interface ComboboxManualEntry {
145
+ /** Visible label, which is also the accessible name — it states the action. */
146
+ label: string;
147
+ /** Runs the action; the panel closes first. */
148
+ onSelect: () => void;
149
+ /** Optional leading glyph of the `link` row (e.g. the `pencil-simple` icon). Decorative. */
150
+ icon?: React.ReactNode;
151
+ }
152
+
153
+ const Combobox = React.forwardRef<HTMLInputElement, ComboboxProps>(
154
+ (
155
+ {
156
+ items,
157
+ query,
158
+ onQueryChange,
159
+ value = null,
160
+ onValueChange,
161
+ loading = false,
162
+ size = 'md',
163
+ placeholder,
164
+ manualEntry,
165
+ sheetTitle,
166
+ sheetCloseLabel,
167
+ emptyLabel,
168
+ loadingLabel,
169
+ panelLabelledBy,
170
+ panelLabel,
171
+ clearLabel,
172
+ id,
173
+ className,
174
+ onFocus,
175
+ onBlur,
176
+ 'aria-label': ariaLabel,
177
+ 'aria-invalid': ariaInvalid,
178
+ 'aria-describedby': ariaDescribedby,
179
+ 'data-testid': dataTestid,
180
+ },
181
+ forwardedRef,
182
+ ) => {
183
+ const [open, setOpen] = React.useState(false);
184
+ const [activeIndex, setActiveIndex] = React.useState<number | null>(null);
185
+ const isSheet = useSheetPresentation();
186
+ // The field's own label, read when the sheet opens — the default sheet title.
187
+ const [fieldLabel, setFieldLabel] = React.useState('');
188
+
189
+ const panelUnnamed = !panelLabelledBy && !panelLabel;
190
+ React.useEffect(() => {
191
+ if (process.env.NODE_ENV !== 'production' && panelUnnamed) {
192
+ // eslint-disable-next-line no-console
193
+ console.warn(
194
+ 'Combobox: the result listbox has no accessible name — wrap it in a labelled ' +
195
+ '`Field`, or pass `panelLabel` when nothing visible names the field.',
196
+ );
197
+ }
198
+ }, [panelUnnamed]);
199
+
200
+ const reactId = React.useId();
201
+ const optionId = (index: number) => `${reactId}-option-${index}`;
202
+ const sheetListboxId = `${reactId}-sheet-listbox`;
203
+ const sheetTitleId = `${reactId}-sheet-title`;
204
+ const sheetSearchRef = React.useRef<HTMLInputElement>(null);
205
+
206
+ // The ↑/↓ ring: the results, then — on the anchored panel only — the manual-entry
207
+ // row LAST. On the sheet that action is a plain footer button reached with Tab.
208
+ const manualIndex = manualEntry && !isSheet ? items.length : null;
209
+ const ringCount = items.length + (manualIndex != null ? 1 : 0);
210
+ // While `loading`, the status row stands in place of the result group
211
+ // (popover-patterns.md § Combobox (search) → runtime list states), yet a remote
212
+ // search usually keeps the previous `items` until the new ones land. Those rows
213
+ // are not on screen, so they are out of the ring: no highlight, no Enter. They
214
+ // are skipped rather than dropped from the count, so the ring keeps one shape
215
+ // whether or not a search is in flight.
216
+ const isRingDisabled = React.useCallback(
217
+ (index: number) => index < items.length && (loading || items[index].disabled === true),
218
+ [items, loading],
219
+ );
220
+
221
+ const inputRef = React.useRef<HTMLInputElement>(null);
222
+ const setInputRef = React.useCallback(
223
+ (node: HTMLInputElement | null) => {
224
+ inputRef.current = node;
225
+ if (typeof forwardedRef === 'function') forwardedRef(node);
226
+ else if (forwardedRef) forwardedRef.current = node;
227
+ },
228
+ [forwardedRef],
229
+ );
230
+
231
+ const panel = useAnchoredPanel({
232
+ // The anchored panel exists only from `sm` up; below it the sheet hosts the list.
233
+ open: open && !isSheet,
234
+ onOpenChange: setOpen,
235
+ role: 'listbox',
236
+ // DOM focus stays in the input for the whole search — moving it onto a row
237
+ // would turn this into a Menu (combobox-field manifest, intent rule 0).
238
+ focusModel: 'virtual',
239
+ // The panel is the field's own drop-down; it must never be narrower.
240
+ widthPolicy: 'trigger',
241
+ // The substrate's list cursor and typeahead are both deliberately off: the
242
+ // input IS the typeahead, and `useListNavigation` only wires the cursor
243
+ // through `getReferenceProps`, which a typeable trigger cannot spread (see
244
+ // the trigger below). This organism owns ↑/↓ / Home / End itself.
245
+ navigation: 'none',
246
+ itemCount: 0,
247
+ typeahead: false,
248
+ });
249
+
250
+ // By key, not by object: callers rebuild the `value` item on every render.
251
+ const selectedValue = value?.value;
252
+
253
+ // Whether the USER chose the manual-entry row (↑/↓, Home/End, pointer) while a
254
+ // result was in reach — as opposed to the cursor landing there because nothing
255
+ // else could take it (while `loading`, or on a query that matches nothing). A new
256
+ // keystroke drops the choice: a new query is a new search.
257
+ const manualChosenRef = React.useRef(false);
258
+ const navigate = React.useCallback<React.Dispatch<React.SetStateAction<number | null>>>(
259
+ (action) => {
260
+ const next = typeof action === 'function' ? action(activeIndex) : action;
261
+ manualChosenRef.current =
262
+ next != null && next === manualIndex && items.some((_, index) => !isRingDisabled(index));
263
+ setActiveIndex(next);
264
+ },
265
+ [activeIndex, manualIndex, items, isRingDisabled],
266
+ );
267
+
268
+ // The row list is rebuilt on every keystroke and the cursor is pinned by
269
+ // POSITION, so it is re-checked whenever the set changes underneath it. A cursor
270
+ // on a result keeps its index while that index is still an enabled result. The
271
+ // manual-entry row sits after the results, so a change in their count moves it:
272
+ // - chosen by the user, the cursor follows the row to its new index, so Enter
273
+ // still runs the action rather than a result that slid into the old one;
274
+ // - not chosen (seated there because no result was in reach, or slid under a
275
+ // result cursor by a shorter list), the cursor is seated afresh, so the top
276
+ // result is highlighted again (filter-and-select is the common path,
277
+ // popover-patterns.md § Combobox (search) → Intent).
278
+ const prevManualIndexRef = React.useRef(manualIndex);
279
+ React.useEffect(() => {
280
+ const prevManualIndex = prevManualIndexRef.current;
281
+ prevManualIndexRef.current = manualIndex;
282
+ // The flag is only ever set together with the cursor on the manual row, and
283
+ // every other move clears it — so a set flag means the cursor is there.
284
+ const keepManual = open && manualChosenRef.current && manualIndex != null;
285
+ if (!keepManual) manualChosenRef.current = false;
286
+ setActiveIndex((current) => {
287
+ if (!open) return null;
288
+ if (keepManual) return manualIndex;
289
+ // On the manual row without a kept choice — moved, or slid under the cursor by
290
+ // a shorter list — the cursor is seated afresh.
291
+ const seat = current === prevManualIndex || current === manualIndex ? null : current;
292
+ if (seat != null && seat < ringCount && !isRingDisabled(seat)) return seat;
293
+ // On open the highlight lands on the committed value, if it is in the list
294
+ // (popover-patterns.md § Combobox (search) — "On reopen, the highlight lands
295
+ // on the selected row").
296
+ const selectedIndex = selectedValue == null ? -1 : items.findIndex(item => item.value === selectedValue);
297
+ if (selectedIndex >= 0 && !isRingDisabled(selectedIndex)) return selectedIndex;
298
+ return seekEnabled(ringCount, isRingDisabled, 0, 1);
299
+ });
300
+ }, [items, ringCount, manualIndex, isRingDisabled, open, selectedValue]);
301
+
302
+ const closePanel = React.useCallback(() => {
303
+ setOpen(false);
304
+ setActiveIndex(null);
305
+ // The trigger the substrate would restore focus to is the wrapper element,
306
+ // which is not focusable; the caret belongs in the input.
307
+ inputRef.current?.focus();
308
+ }, []);
309
+
310
+ // On the sheet the sheet itself returns focus to the field once it has gone.
311
+ const dismiss = React.useCallback(() => {
312
+ if (isSheet) {
313
+ setOpen(false);
314
+ setActiveIndex(null);
315
+ } else {
316
+ closePanel();
317
+ }
318
+ }, [isSheet, closePanel]);
319
+
320
+ const runManualEntry = React.useCallback(() => {
321
+ if (!manualEntry) return;
322
+ // Close first, so focus the action moves (to the manual fields) is not undone.
323
+ dismiss();
324
+ manualEntry.onSelect();
325
+ }, [manualEntry, dismiss]);
326
+
327
+ const commit = React.useCallback(
328
+ (index: number) => {
329
+ if (index === manualIndex) {
330
+ runManualEntry();
331
+ return;
332
+ }
333
+ const item = items[index];
334
+ // A stale result behind the loading row is never committed (see the ring above).
335
+ if (!item || item.disabled || loading) return;
336
+ onValueChange?.(item);
337
+ // Selection commits and closes (spec § Dismissal).
338
+ dismiss();
339
+ },
340
+ [items, loading, onValueChange, dismiss, manualIndex, runManualEntry],
341
+ );
342
+
343
+ // Keep the moving cursor inside the panel's capped scroll region.
344
+ React.useEffect(() => {
345
+ if (!open || activeIndex == null) return;
346
+ panel.listRef.current[activeIndex]?.scrollIntoView({ block: 'nearest' });
347
+ }, [open, activeIndex, panel.listRef]);
348
+
349
+ const openSheet = () => {
350
+ setFieldLabel(resolveFieldLabel(inputRef.current));
351
+ setOpen(true);
352
+ };
353
+
354
+ const handleChange = (event: React.ChangeEvent<HTMLInputElement>) => {
355
+ // Typing over a committed value re-opens the search: the field is back to
356
+ // being a query, so the selection can no longer stand.
357
+ if (value) onValueChange?.(null);
358
+ manualChosenRef.current = false;
359
+ onQueryChange(event.target.value);
360
+ setOpen(true);
361
+ };
362
+
363
+ const handleKeyDown = (event: React.KeyboardEvent<HTMLInputElement>) => {
364
+ if (isSheet) {
365
+ // Below `sm` the field is only the trigger of the sheet.
366
+ if (['ArrowDown', 'ArrowUp', 'Enter', ' '].includes(event.key)) {
367
+ event.preventDefault();
368
+ openSheet();
369
+ }
370
+ return;
371
+ }
372
+ // Tab leaves the combobox and closes the popup (WAI-ARIA APG). Not prevented:
373
+ // focus moves on to the next element as usual.
374
+ if (event.key === 'Tab') {
375
+ if (open) {
376
+ setOpen(false);
377
+ setActiveIndex(null);
378
+ }
379
+ return;
380
+ }
381
+ comboboxKeyDown(event, {
382
+ open,
383
+ activeIndex,
384
+ count: ringCount,
385
+ isDisabled: isRingDisabled,
386
+ setActiveIndex: navigate,
387
+ onOpen: () => setOpen(true),
388
+ onCommit: commit,
389
+ // Esc closes AND clears the query, staying in the input
390
+ // (combobox-field.md § Keyboard).
391
+ onEscape: () => {
392
+ onQueryChange('');
393
+ closePanel();
394
+ },
395
+ });
396
+ };
397
+
398
+ // The sheet's own search input: same ring minus the manual row (a footer button
399
+ // there). Esc is the sheet's — Radix closes it without a change.
400
+ const handleSheetKeyDown = (event: React.KeyboardEvent<HTMLInputElement>) => {
401
+ if (event.key === 'Escape' || event.key === 'Tab') return;
402
+ comboboxKeyDown(event, {
403
+ open,
404
+ activeIndex,
405
+ count: ringCount,
406
+ isDisabled: isRingDisabled,
407
+ setActiveIndex: navigate,
408
+ onOpen: () => setOpen(true),
409
+ onCommit: commit,
410
+ onEscape: dismiss,
411
+ });
412
+ };
413
+
414
+ // Anywhere in the shell opens the panel — the padding is part of the trigger,
415
+ // not decoration you can click through. It opens but does NOT toggle, so a
416
+ // click that only repositions the caret keeps the results up. The clear × is
417
+ // excluded: it is a control of its own, and it closes. Below `sm` the sheet opens
418
+ // on the click instead, so the pointer-down cannot land focus on the page field
419
+ // after the sheet has taken it.
420
+ const handleTriggerPointerDown = (event: React.PointerEvent) => {
421
+ if (isSheet || event.target !== inputRef.current) return;
422
+ setOpen(true);
423
+ };
424
+ // A press on the caret or the shell padding is handled on mouse-down, whose default
425
+ // would move focus from the input to <body> (focus never leaves the input —
426
+ // combobox-field manifest). Not on pointer-down: preventing that does not stop the
427
+ // focus move, and a re-render there could detach the pressed glyph before mouse-down.
428
+ const handleTriggerMouseDown = (event: React.MouseEvent) => {
429
+ if (isSheet || event.target === inputRef.current) return;
430
+ if ((event.target as HTMLElement).closest('button')) return;
431
+ event.preventDefault();
432
+ inputRef.current?.focus();
433
+ setOpen(true);
434
+ };
435
+ const handleTriggerClick = (event: React.MouseEvent) => {
436
+ if (!isSheet || (event.target as HTMLElement).closest('button')) return;
437
+ openSheet();
438
+ };
439
+
440
+ // On the sheet the page field never shows the mid-search states: the search
441
+ // happens in the sheet, the field only mirrors the committed value.
442
+ const triggerState = isSheet
443
+ ? value
444
+ ? 'selected'
445
+ : 'default'
446
+ : loading
447
+ ? 'loading'
448
+ : value
449
+ ? 'selected'
450
+ : open
451
+ ? 'open'
452
+ : 'default';
453
+
454
+ const clearProps =
455
+ triggerState === 'selected'
456
+ ? ({
457
+ state: 'selected',
458
+ clearLabel,
459
+ onClear: () => {
460
+ onValueChange?.(null);
461
+ onQueryChange('');
462
+ inputRef.current?.focus();
463
+ },
464
+ } as const)
465
+ : ({ state: triggerState } as const);
466
+
467
+ const hasStatusRow = loading || items.length === 0;
468
+
469
+ // Below `sm` the field is a read-only trigger that opens a dialog; the sheet's
470
+ // search input owns the combobox contract while it is open.
471
+ const fieldInteraction = isSheet
472
+ ? ({ readOnly: true, 'aria-haspopup': 'dialog', 'aria-expanded': open } as const)
473
+ : {
474
+ onChange: handleChange,
475
+ // Passed explicitly rather than derived from the flow state, which the
476
+ // field would otherwise do: re-opening the panel on an already
477
+ // COMMITTED value keeps `state="selected"` (the × has to stay), and
478
+ // that state derives to `false` — the panel would be on screen while
479
+ // the input announced it closed. The field documents this override.
480
+ 'aria-expanded': open,
481
+ // Read off the substrate rather than minted here: floating-ui stamps
482
+ // its own id on the panel, and a second one of ours would leave
483
+ // `aria-controls` pointing at nothing. Dropped while the panel is
484
+ // unmounted for the same reason — a dangling idref is an a11y error,
485
+ // not a harmless leftover.
486
+ 'aria-controls': panel.isMounted ? panel.context.floatingId : undefined,
487
+ 'aria-activedescendant': open && activeIndex != null ? optionId(activeIndex) : undefined,
488
+ };
489
+
490
+ // Shared by both surfaces: the status row, or the result options.
491
+ const renderResults = (rowSize: 'md' | 'sm' | 'mobile') =>
492
+ hasStatusRow ? (
493
+ // A runtime state, not a value: no `option` role, and the live region
494
+ // sits HERE rather than on the listbox — on the listbox it would
495
+ // re-announce every result each time the panel opens
496
+ // (spec/01-foundations/accessibility.md).
497
+ <div role="status" aria-live="polite">
498
+ <ListRow size={rowSize} disabled>
499
+ {loading ? loadingLabel : emptyLabel}
500
+ </ListRow>
501
+ </div>
502
+ ) : (
503
+ items.map((item, index) => {
504
+ const isSelected = value?.value === item.value;
505
+ const isMobileRow = rowSize === 'mobile';
506
+ return (
507
+ <ListRow
508
+ key={item.value}
509
+ ref={(node) => {
510
+ panel.listRef.current[index] = node;
511
+ }}
512
+ id={optionId(index)}
513
+ role="option"
514
+ // The pattern owns this row, so it measures it under its own
515
+ // part name — the atom's `root` would collide with the trigger
516
+ // shell, and the runtime pass matches parts by name alone.
517
+ data-fods-part="option"
518
+ size={rowSize}
519
+ description={item.description}
520
+ highlighted={activeIndex === index}
521
+ disabled={item.disabled}
522
+ aria-selected={isSelected}
523
+ data-testid={item.testId}
524
+ // List Row Mobile (2.6.0): the chosen row carries the Selected fill
525
+ // and a TRAILING check, no leading reserve; the check is --secondary at
526
+ // every size (list-row 2.7.0). On the
527
+ // anchored panel: Selected = leading checkmark + the Selected fill,
528
+ // label stays Regular; the slot is blank-reserved on every other row
529
+ // so labels align (popover-patterns.md § Combobox (search)). Same
530
+ // indicator as Select — no `size` prop, the glyph tracks the row
531
+ // density via ListRow.
532
+ selected={isSelected}
533
+ {...(isMobileRow
534
+ ? { trailing: isSelected ? <Icon name="check" className="text-secondary" /> : undefined }
535
+ : { leading: <Icon name="check" className={cn(isSelected ? 'text-secondary' : 'invisible')} /> })}
536
+ onPointerEnter={() => navigate(index)}
537
+ onClick={() => commit(index)}
538
+ >
539
+ {item.label}
540
+ </ListRow>
541
+ );
542
+ })
543
+ );
544
+
545
+ const sheetTitleText = sheetTitle || fieldLabel || ariaLabel || panelLabel;
546
+
547
+ return (
548
+ <>
549
+ {/*
550
+ The reference is this wrapper, not the input: `widthPolicy: 'trigger'`
551
+ measures it to set the panel's min-width, and the input is narrower than
552
+ the shell by its padding and the trailing indicator. It is also what
553
+ `useDismiss` treats as "inside the trigger", so a click on the shell
554
+ padding does not read as an outside press.
555
+ */}
556
+ <div
557
+ ref={panel.refs.setReference}
558
+ onPointerDown={handleTriggerPointerDown}
559
+ onMouseDown={handleTriggerMouseDown}
560
+ onClick={handleTriggerClick}
561
+ data-testid={dataTestid}
562
+ >
563
+ <ComboboxField
564
+ {...clearProps}
565
+ ref={setInputRef}
566
+ id={id}
567
+ size={size}
568
+ className={className}
569
+ value={value ? value.label : query}
570
+ placeholder={placeholder}
571
+ onKeyDown={handleKeyDown}
572
+ onFocus={onFocus}
573
+ onBlur={onBlur}
574
+ aria-label={ariaLabel}
575
+ aria-invalid={ariaInvalid}
576
+ aria-describedby={ariaDescribedby}
577
+ {...fieldInteraction}
578
+ />
579
+ </div>
580
+
581
+ {isSheet && (
582
+ <BottomSheet
583
+ open={open}
584
+ onOpenChange={(next) => {
585
+ setOpen(next);
586
+ if (!next) setActiveIndex(null);
587
+ }}
588
+ title={sheetTitleText}
589
+ titleId={sheetTitleId}
590
+ closeLabel={sheetCloseLabel}
591
+ initialFocus={() => sheetSearchRef.current}
592
+ returnFocusRef={inputRef}
593
+ owner="combobox"
594
+ search={
595
+ // Borderless search row, at least --space-1100 tall: a 16 search icon in
596
+ // --text-secondary and the input, aligned to the rows' 16 content edge.
597
+ // The input is the combobox while the sheet is open; it is named by the
598
+ // sheet title, never by its placeholder alone. Its focus ring is the
599
+ // row's inset ring — no row in the list takes one.
600
+ <BottomSheetSearch
601
+ ref={sheetSearchRef}
602
+ role="combobox"
603
+ aria-autocomplete="list"
604
+ aria-expanded={open}
605
+ aria-controls={sheetListboxId}
606
+ aria-activedescendant={activeIndex != null ? optionId(activeIndex) : undefined}
607
+ aria-busy={loading || undefined}
608
+ aria-labelledby={sheetTitleId}
609
+ value={query}
610
+ placeholder={placeholder}
611
+ onChange={handleChange}
612
+ onKeyDown={handleSheetKeyDown}
613
+ />
614
+ }
615
+ footer={
616
+ manualEntry ? (
617
+ /* The footer has no padding of its own except --space-400 + the bottom
618
+ safe-area inset (overlay-behavior.md § Mobile → Footer); the body stops
619
+ paying the inset when a footer exists. */
620
+ <BottomSheet.Group className="pb-[calc(var(--space-400)+env(safe-area-inset-bottom))]">
621
+ {/* A button (a `ListRow` with `role="button"`) outside the listbox
622
+ (overlay-behavior.md § Mobile → Where focus goes on open): it holds
623
+ real DOM focus, so it takes the inset ring. */}
624
+ <ListRow
625
+ variant="link"
626
+ size="mobile"
627
+ role="button"
628
+ tabIndex={0}
629
+ data-fods-part="manual-entry"
630
+ leading={manualEntry.icon}
631
+ className={SHEET_ROW_FOCUS_RING}
632
+ onClick={runManualEntry}
633
+ onKeyDown={(event) => {
634
+ if (event.key === 'Enter' || event.key === ' ') {
635
+ event.preventDefault();
636
+ runManualEntry();
637
+ }
638
+ }}
639
+ >
640
+ {manualEntry.label}
641
+ </ListRow>
642
+ </BottomSheet.Group>
643
+ ) : undefined
644
+ }
645
+ >
646
+ <div id={sheetListboxId} role="listbox" aria-labelledby={sheetTitleId}>
647
+ <BottomSheet.Group>{renderResults('mobile')}</BottomSheet.Group>
648
+ </div>
649
+ </BottomSheet>
650
+ )}
651
+
652
+ <AnchoredPanel
653
+ panel={panel}
654
+ size={size}
655
+ focusModel="virtual"
656
+ panelProps={
657
+ panelLabelledBy ? { 'aria-labelledby': panelLabelledBy } : { 'aria-label': panelLabel }
658
+ }
659
+ footer={
660
+ manualIndex != null && manualEntry ? (
661
+ <AnchoredPanel.Group>
662
+ {/* The last item of the ↑/↓ ring: an `option` WITHOUT `aria-selected`
663
+ — a non-selectable option (ARIA 1.2) whose name states the action.
664
+ It sits inside the listbox element, which spans body and footer. */}
665
+ <ListRow
666
+ ref={(node) => {
667
+ panel.listRef.current[manualIndex] = node;
668
+ }}
669
+ id={optionId(manualIndex)}
670
+ role="option"
671
+ variant="link"
672
+ size={size}
673
+ data-fods-part="manual-entry"
674
+ leading={manualEntry.icon}
675
+ highlighted={activeIndex === manualIndex}
676
+ onPointerEnter={() => navigate(manualIndex)}
677
+ onClick={runManualEntry}
678
+ >
679
+ {manualEntry.label}
680
+ </ListRow>
681
+ </AnchoredPanel.Group>
682
+ ) : undefined
683
+ }
684
+ >
685
+ <AnchoredPanel.Group>{renderResults(size)}</AnchoredPanel.Group>
686
+ </AnchoredPanel>
687
+ </>
688
+ );
689
+ },
690
+ );
691
+ Combobox.displayName = 'Combobox';
692
+
693
+ export { Combobox };