@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,15 @@
1
+ "use client";
2
+ import * as React from 'react';
3
+
4
+ /**
5
+ * Provided inside a toggletip bubble (`<Tooltip toggletip>`). A `TextLink` rendered in
6
+ * the bubble reads it to point its `aria-describedby` at the body text and to close the
7
+ * bubble once activated (ui-system Tooltip 1.3.0 § Toggletip mode). Lives apart from
8
+ * Tooltip.tsx so TextLink can read it without importing the Tooltip module.
9
+ */
10
+ export interface TooltipBodyContextValue {
11
+ bodyId: string;
12
+ close: () => void;
13
+ }
14
+
15
+ export const TooltipBodyContext = React.createContext<TooltipBodyContextValue | null>(null);
@@ -0,0 +1,275 @@
1
+ // Generated by scripts/generate-tw-merge-config.mjs. Do not edit: run `npm run generate -w @invoiceonline/ui-react`.
2
+ // Source: src/styles/theme.map.json.
3
+ //
4
+ // `override.theme` replaces every theme scale of tailwind-merge with the values the
5
+ // package theme has, so a class outside the theme is never read as a colour or a size.
6
+ // `extend.classGroups` adds the token values to the groups that read no theme scale.
7
+ // `override.classGroups` keeps the bare `outline` out of the outline widths
8
+ // (rule `bareOutline` in the generator).
9
+ import { validators, type ConfigExtension, type DefaultClassGroupIds, type DefaultThemeGroupIds } from 'tailwind-merge';
10
+
11
+ export const twMergeConfig: ConfigExtension<DefaultClassGroupIds, DefaultThemeGroupIds> = {
12
+ override: {
13
+ theme: {
14
+ animate: [
15
+ 'spin',
16
+ 'skeleton-pulse',
17
+ 'skeleton-pulse-reduced',
18
+ 'progress-dot-bloom',
19
+ 'progress-dot-bloom-reduced',
20
+ 'progress-pointer-enter',
21
+ 'progress-pointer-enter-reduced',
22
+ 'field-label-float-in',
23
+ 'field-label-rest-in',
24
+ 'field-label-out',
25
+ 'lookup-check-ring',
26
+ 'lookup-check-tick',
27
+ 'lookup-check-burst',
28
+ 'lookup-check-spark',
29
+ 'hero-enter-rise',
30
+ 'hero-enter-fade',
31
+ ],
32
+ aspect: [],
33
+ blur: [],
34
+ breakpoint: ['xxs', 'xs', 'sm', 'md', 'lg', 'xl'],
35
+ color: [
36
+ 'inherit',
37
+ 'current',
38
+ 'transparent',
39
+ 'primary',
40
+ 'primary-solid',
41
+ 'primary-hover',
42
+ 'primary-active',
43
+ 'primary-foreground',
44
+ 'primary-subtle',
45
+ 'primary-soft',
46
+ 'primary-tint-foreground',
47
+ 'primary-subtle-border',
48
+ 'secondary',
49
+ 'secondary-solid',
50
+ 'secondary-hover',
51
+ 'secondary-active',
52
+ 'secondary-foreground',
53
+ 'secondary-subtle',
54
+ 'secondary-soft',
55
+ 'secondary-tint-foreground',
56
+ 'secondary-subtle-border',
57
+ 'tertiary',
58
+ 'tertiary-solid',
59
+ 'tertiary-hover',
60
+ 'tertiary-active',
61
+ 'tertiary-foreground',
62
+ 'tertiary-subtle',
63
+ 'tertiary-soft',
64
+ 'tertiary-tint-foreground',
65
+ 'tertiary-subtle-border',
66
+ 'background-primary',
67
+ 'background-secondary',
68
+ 'background-readonly',
69
+ 'background-hover',
70
+ 'background-active',
71
+ 'background-hover-inverse',
72
+ 'background-active-inverse',
73
+ 'background-overlay',
74
+ 'background-skeleton',
75
+ 'background-edge-shadow',
76
+ 'background-inverse',
77
+ 'icon-default',
78
+ 'icon-brand',
79
+ 'icon-muted',
80
+ 'text-primary',
81
+ 'text-secondary',
82
+ 'text-placeholder',
83
+ 'text-tertiary',
84
+ 'text-inverted',
85
+ 'text-inverted-secondary',
86
+ 'text-link',
87
+ 'text-link-hover',
88
+ 'outline-default',
89
+ 'outline-strong',
90
+ 'outline-focus-inverse',
91
+ 'outline-focus',
92
+ 'disabled',
93
+ 'disabled-control',
94
+ 'disabled-background',
95
+ 'disabled-foreground',
96
+ 'disabled-inverse',
97
+ 'status-info',
98
+ 'status-info-solid',
99
+ 'status-info-hover',
100
+ 'status-info-active',
101
+ 'status-info-foreground',
102
+ 'status-info-subtle',
103
+ 'status-info-soft',
104
+ 'status-info-tint-foreground',
105
+ 'status-info-subtle-border',
106
+ 'status-success',
107
+ 'status-success-solid',
108
+ 'status-success-hover',
109
+ 'status-success-active',
110
+ 'status-success-foreground',
111
+ 'status-success-subtle',
112
+ 'status-success-soft',
113
+ 'status-success-tint-foreground',
114
+ 'status-success-subtle-border',
115
+ 'status-warning',
116
+ 'status-warning-solid',
117
+ 'status-warning-hover',
118
+ 'status-warning-active',
119
+ 'status-warning-foreground',
120
+ 'status-warning-subtle',
121
+ 'status-warning-soft',
122
+ 'status-warning-tint-foreground',
123
+ 'status-warning-subtle-border',
124
+ 'status-danger',
125
+ 'status-danger-solid',
126
+ 'status-danger-hover',
127
+ 'status-danger-active',
128
+ 'status-danger-foreground',
129
+ 'status-danger-subtle',
130
+ 'status-danger-soft',
131
+ 'status-danger-tint-foreground',
132
+ 'status-danger-subtle-border',
133
+ 'status-violet',
134
+ 'status-violet-solid',
135
+ 'status-violet-hover',
136
+ 'status-violet-active',
137
+ 'status-violet-foreground',
138
+ 'status-violet-subtle',
139
+ 'status-violet-soft',
140
+ 'status-violet-tint-foreground',
141
+ 'status-violet-subtle-border',
142
+ 'notification-dot',
143
+ 'brand-primary',
144
+ 'brand-primary-hover',
145
+ 'brand-secondary',
146
+ 'brand-secondary-hover',
147
+ 'status-info-bg',
148
+ 'status-info-bg-foreground',
149
+ 'status-info-border',
150
+ 'status-success-bg',
151
+ 'status-success-bg-foreground',
152
+ 'status-success-border',
153
+ 'status-warning-bg',
154
+ 'status-warning-bg-foreground',
155
+ 'status-warning-border',
156
+ 'status-danger-bg',
157
+ 'status-danger-bg-foreground',
158
+ 'status-danger-border',
159
+ ],
160
+ container: [
161
+ 'content-narrow',
162
+ 'content-medium',
163
+ 'content-wide',
164
+ 'container-sm',
165
+ 'container-md',
166
+ 'container-lg',
167
+ 'container-xl',
168
+ ],
169
+ 'drop-shadow': [],
170
+ ease: ['standard', 'enter', 'exit', 'linear'],
171
+ font: ['inter', 'poppins', 'caveat'],
172
+ 'font-weight': ['light', 'normal', 'medium', 'semibold', 'bold', 'black'],
173
+ 'inset-shadow': [],
174
+ leading: ['compact', 'tight', 'relaxed', 'loose', 'extra-loose'],
175
+ perspective: [],
176
+ radius: ['0', '100', '200', '300', '400', '500', '600', '700', '800', 'full'],
177
+ shadow: ['raised', 'overlay', 'modal'],
178
+ spacing: [
179
+ 'px',
180
+ 'icon-2xsmall',
181
+ 'icon-xsmall',
182
+ 'icon-small',
183
+ 'icon',
184
+ 'icon-large',
185
+ 'icon-display',
186
+ 'illustration-spot',
187
+ 'illustration-section',
188
+ 'illustration-card',
189
+ 'illustration-empty',
190
+ 'illustration-person',
191
+ 'illustration-page',
192
+ '0',
193
+ '100',
194
+ '200',
195
+ '300',
196
+ '400',
197
+ '450',
198
+ '500',
199
+ '600',
200
+ '700',
201
+ '800',
202
+ '900',
203
+ '1000',
204
+ '1100',
205
+ '1200',
206
+ '1300',
207
+ ],
208
+ text: [
209
+ 'body-xxs',
210
+ 'body-xs',
211
+ 'body-sm',
212
+ 'body-base',
213
+ 'body-lg',
214
+ 'body-xl',
215
+ 'heading-h1',
216
+ 'heading-h2',
217
+ 'heading-h3',
218
+ 'heading-h4',
219
+ 'heading-h5',
220
+ 'display-d1',
221
+ 'display-d2',
222
+ 'display-d3',
223
+ 'heading-xxl',
224
+ ],
225
+ 'text-shadow': [],
226
+ tracking: [],
227
+ },
228
+ classGroups: {
229
+ 'outline-w': [{ outline: [validators.isNumber, validators.isArbitraryVariableLength, validators.isArbitraryLength, '100', '200'] }],
230
+ },
231
+ },
232
+ extend: {
233
+ classGroups: {
234
+ 'outline-style': [{ outline: [''] }],
235
+ z: [{ z: [
236
+ 'base',
237
+ 'dropdown',
238
+ 'sticky',
239
+ 'fixed',
240
+ 'modal-backdrop',
241
+ 'modal',
242
+ 'popover',
243
+ 'toast',
244
+ ] }],
245
+ duration: [{ duration: [
246
+ 'instant',
247
+ 'fast',
248
+ 'normal',
249
+ 'slow',
250
+ 'hover',
251
+ 'press',
252
+ 'toggle',
253
+ 'spin',
254
+ 'pulse',
255
+ 'counter',
256
+ 'draw',
257
+ ] }],
258
+ 'border-w': [{ border: ['100', '200'] }],
259
+ 'border-w-x': [{ 'border-x': ['100', '200'] }],
260
+ 'border-w-y': [{ 'border-y': ['100', '200'] }],
261
+ 'border-w-s': [{ 'border-s': ['100', '200'] }],
262
+ 'border-w-e': [{ 'border-e': ['100', '200'] }],
263
+ 'border-w-bs': [{ 'border-bs': ['100', '200'] }],
264
+ 'border-w-be': [{ 'border-be': ['100', '200'] }],
265
+ 'border-w-t': [{ 'border-t': ['100', '200'] }],
266
+ 'border-w-r': [{ 'border-r': ['100', '200'] }],
267
+ 'border-w-b': [{ 'border-b': ['100', '200'] }],
268
+ 'border-w-l': [{ 'border-l': ['100', '200'] }],
269
+ 'divide-x': [{ 'divide-x': ['100', '200'] }],
270
+ 'divide-y': [{ 'divide-y': ['100', '200'] }],
271
+ 'ring-w': [{ ring: ['100', '200'] }],
272
+ 'inset-ring-w': [{ 'inset-ring': ['100', '200'] }],
273
+ },
274
+ },
275
+ };
@@ -0,0 +1,340 @@
1
+ "use client";
2
+ import * as React from 'react';
3
+ import {
4
+ useFloating,
5
+ autoUpdate,
6
+ offset,
7
+ flip,
8
+ shift,
9
+ size as sizeMiddleware,
10
+ useClick,
11
+ useDismiss,
12
+ useRole,
13
+ useListNavigation,
14
+ useTypeahead,
15
+ useInteractions,
16
+ useTransitionStyles,
17
+ type Placement,
18
+ } from '@floating-ui/react';
19
+ // Read at runtime because the transition is applied as INLINE styles by
20
+ // floating-ui, which a CSS media query cannot override.
21
+ import { usePrefersReducedMotion } from './usePrefersReducedMotion';
22
+ import { useDialogRoot } from './dialogPortal';
23
+
24
+ // =============================================================================
25
+ // useAnchoredPanel — the shared BEHAVIOUR substrate for every panel anchored to a
26
+ // trigger (spec 06-patterns/overlay-behavior.md).
27
+ //
28
+ // "Anchored" is the spec's own word for these surfaces ("anchored to the trigger",
29
+ // "overlays stay anchored") and it names the invariant that separates them from a
30
+ // Modal: position is derived from a trigger. Deliberately NOT "dropdown" — that is
31
+ // a motion, not a function, and the family principle warns against naming code
32
+ // after it (a Select's panel is not a "dropdown" to its caller).
33
+ //
34
+ // The design system splits such a panel into three layers:
35
+ // 1. chrome — `popoverSurface.ts` (token bindings, no component)
36
+ // 2. behaviour — THIS hook (positioning, dismissal, focus, transition)
37
+ // 3. semantics — the ORGANISM (`role`, keyboard contract, selection model)
38
+ //
39
+ // Layer 3 is deliberately NOT here. The family principle (spec
40
+ // 04-molecules/_menu-family-planning.md § Core principle) forbids one component
41
+ // switching between `menu | listbox | combobox` — those are three incompatible
42
+ // ARIA + keyboard contracts. What they legitimately share is everything below:
43
+ // where the panel sits, when it closes, how it animates, and how a list cursor
44
+ // moves. The organism passes in which role and focus model it needs.
45
+ //
46
+ // Focus models (spec § Focus & the highlight model):
47
+ // 'virtual' — DOM focus stays on the trigger, the current row is pointed at by
48
+ // `aria-activedescendant` (Select / Combobox: a field trigger must
49
+ // keep focus so typing keeps working).
50
+ // 'roving' — DOM focus moves INTO the panel with a roving tabindex (Menu: a
51
+ // command menu owns focus while open).
52
+ // =============================================================================
53
+
54
+ /** ARIA role of the panel — supplied by the organism, never by the substrate. */
55
+ export type AnchoredPanelRole = 'listbox' | 'menu' | 'group' | 'dialog';
56
+
57
+ /** Where DOM focus lives while the panel is open. */
58
+ export type AnchoredFocusModel = 'virtual' | 'roving';
59
+
60
+ /**
61
+ * Panel width rule (spec § Positioning):
62
+ * - `trigger` — panel fills the trigger's width (Select / Combobox: the panel is
63
+ * the field's own drop-down, so it must not be narrower than the field).
64
+ * - `content` — panel hugs its longest row within a min/max band (Menu / Popover:
65
+ * a kebab or button trigger has no meaningful width to fill).
66
+ */
67
+ export type AnchoredWidthPolicy = 'trigger' | 'content';
68
+
69
+ /** Panel density — one step below the trigger that opened it. */
70
+ export type AnchoredPanelSize = 'md' | 'sm';
71
+
72
+ // Soft height cap for the panel body — `--ds-overlay-max-height`, the spec's
73
+ // ~8–10-row cap (8 rows of 40 plus the surface padding). Density-INDEPENDENT on
74
+ // purpose: the cap expresses a ROW COUNT, so it does not shrink with the panel's
75
+ // own density (spec 06-patterns/popover-patterns.md § Height, locked value).
76
+ // A panel built from taller rows derives its own value the same way.
77
+
78
+ // Content-hugging width band for `widthPolicy: 'content'` — the spec states
79
+ // `min ~180 / max ~320` px as approximate values with no token behind them — unlike
80
+ // the max-height cap above, these two never got one. Stand-ins, not authored tokens.
81
+ const CONTENT_MIN_WIDTH = 180;
82
+ const CONTENT_MAX_WIDTH = 320;
83
+
84
+ // Gap between trigger and panel — `--space-200` (4). Spec § Positioning.
85
+ const PANEL_OFFSET = 4;
86
+
87
+ // Viewport padding kept clear when flipping / shifting.
88
+ const COLLISION_PADDING = 8;
89
+
90
+ // Open / close transition — a fixed 150 ms tween. overlay-behavior.md § Motion asks
91
+ // for `--spring-standard` instead; until that lands this is a stand-in, not a token.
92
+ const TRANSITION_DURATION = 150;
93
+
94
+ export interface UseAnchoredPanelOptions {
95
+ /** Controlled open state. */
96
+ open: boolean;
97
+ /** Requested open/close — the organism owns the state. */
98
+ onOpenChange: (open: boolean) => void;
99
+ /** Panel ARIA role; drives floating-ui's role wiring. */
100
+ role: AnchoredPanelRole;
101
+ /** Where DOM focus lives while open. */
102
+ focusModel: AnchoredFocusModel;
103
+ /** Panel width rule. */
104
+ widthPolicy: AnchoredWidthPolicy;
105
+ /** Number of navigable rows. */
106
+ itemCount: number;
107
+ /** Indices that are present but skipped by keyboard navigation. */
108
+ disabledIndices?: number[];
109
+ /** Row labels for typeahead; pass `null` for a non-matchable row. */
110
+ labels?: Array<string | null>;
111
+ /** Index of the persistently selected row, if the family has selection. */
112
+ selectedIndex?: number | null;
113
+ /** Enable type-to-jump. */
114
+ typeahead?: boolean;
115
+ /**
116
+ * Whether the panel's content is a navigable LIST.
117
+ *
118
+ * `'list'` (default) is the menu/select/combobox case: the substrate binds the
119
+ * arrow keys, Home/End and typeahead to a row cursor.
120
+ *
121
+ * `'none'` is for a panel whose content owns its own keyboard model and would
122
+ * be broken by that binding — a Date Picker's grid moves a focused DAY with
123
+ * the arrow keys and pages months with PageUp/PageDown, so the list cursor has
124
+ * to stay out of the way. It is not a list, and there are no rows to count.
125
+ */
126
+ navigation?: 'list' | 'none';
127
+ /** Preferred placement; flips on collision. */
128
+ placement?: Placement;
129
+ }
130
+
131
+ export interface UseAnchoredPanelReturn {
132
+ /**
133
+ * Floating refs — `setReference` on the trigger, `setFloating` on the panel. When the
134
+ * focusable trigger is not the box the panel should align to (a FilterChip pill
135
+ * holding the trigger and the × as siblings), `setPositionReference` takes the box.
136
+ */
137
+ refs: ReturnType<typeof useFloating>['refs'];
138
+ /** Absolute positioning styles for the panel's outer wrapper. */
139
+ floatingStyles: React.CSSProperties;
140
+ /** Enter/exit transition styles for the surface element. */
141
+ transitionStyles: React.CSSProperties;
142
+ /** True while the panel should be in the DOM (covers the exit transition). */
143
+ isMounted: boolean;
144
+ /** floating-ui context — for `FloatingFocusManager` in the roving model. */
145
+ context: ReturnType<typeof useFloating>['context'];
146
+ /** Keyboard cursor / hovered row index. */
147
+ activeIndex: number | null;
148
+ setActiveIndex: React.Dispatch<React.SetStateAction<number | null>>;
149
+ /** Ref array the organism fills with its row elements. */
150
+ listRef: React.MutableRefObject<Array<HTMLElement | null>>;
151
+ getReferenceProps: ReturnType<typeof useInteractions>['getReferenceProps'];
152
+ getFloatingProps: ReturnType<typeof useInteractions>['getFloatingProps'];
153
+ getItemProps: ReturnType<typeof useInteractions>['getItemProps'];
154
+ /** Width/height CSS custom properties to spread onto the panel wrapper. */
155
+ panelStyle: React.CSSProperties;
156
+ /** Max-height for the scrolling body region. */
157
+ bodyStyle: React.CSSProperties;
158
+ /** Close the panel and return focus to the trigger (spec § Dismissal). */
159
+ close: () => void;
160
+ /** True while a typeahead query is in flight — suppresses Space-as-select. */
161
+ isTypingRef: React.MutableRefObject<boolean>;
162
+ /** The enclosing Radix dialog, passed as `FloatingPortal root`; undefined outside a dialog. */
163
+ portalRoot?: HTMLElement;
164
+ }
165
+
166
+ export function useAnchoredPanel({
167
+ open,
168
+ onOpenChange,
169
+ role,
170
+ focusModel,
171
+ widthPolicy,
172
+ itemCount,
173
+ disabledIndices,
174
+ labels,
175
+ selectedIndex = null,
176
+ typeahead = true,
177
+ navigation = 'list',
178
+ placement = 'bottom-start',
179
+ }: UseAnchoredPanelOptions): UseAnchoredPanelReturn {
180
+ const isList = navigation === 'list';
181
+ const [activeIndex, setActiveIndex] = React.useState<number | null>(null);
182
+ // True while the user is typing a typeahead query — lets a Menu/Select tell
183
+ // "Space selects the active row" apart from "Space is part of the query".
184
+ const isTypingRef = React.useRef(false);
185
+
186
+ const { refs, floatingStyles, context } = useFloating({
187
+ open,
188
+ onOpenChange,
189
+ placement,
190
+ // Fixed makes the viewport the containing block: a panel portalled into a Modal is
191
+ // not clipped by the card's overflow-hidden, and flip/shift/size measure against the
192
+ // viewport rather than the card (see internal/dialogPortal.ts).
193
+ strategy: 'fixed',
194
+ whileElementsMounted: autoUpdate,
195
+ middleware: [
196
+ // Anchored below the trigger with the 4px (--space-200) offset.
197
+ offset(PANEL_OFFSET),
198
+ // Collision handling — flip above / shift within the viewport.
199
+ flip({ padding: COLLISION_PADDING }),
200
+ // A panel wider than the padded viewport (the single-month Date Picker, 366 px, on a
201
+ // 360 px phone) drops the padding and starts at the viewport's left edge rather than
202
+ // 8 px in — date-picker.manifest `chrome.mobile.positioning` permits the edge.
203
+ shift(({ rects }) => ({
204
+ padding: rects.floating.width + COLLISION_PADDING * 2 > document.documentElement.clientWidth
205
+ ? 0
206
+ : COLLISION_PADDING,
207
+ })),
208
+ // Width per policy + soft-cap the height so long lists scroll inside the
209
+ // body rather than off-screen.
210
+ sizeMiddleware({
211
+ padding: COLLISION_PADDING,
212
+ apply({ rects, elements, availableHeight }) {
213
+ if (widthPolicy === 'trigger') {
214
+ elements.floating.style.setProperty(
215
+ '--panel-min-width',
216
+ `${rects.reference.width}px`,
217
+ );
218
+ }
219
+ // Only the VIEWPORT half of the clamp. The spec writes the cap as
220
+ // `min(var(--ds-overlay-max-height), calc(100vh - <trigger offset>))` and
221
+ // makes a hardcoded 320 a MUST NOT — "the panel then stops following the
222
+ // token the moment design moves it". Doing the `min()` in JS forced that
223
+ // literal, because floating-ui hands us a number and not the token; doing
224
+ // it in CSS (see `bodyStyle`) lets the token stay the token.
225
+ elements.floating.style.setProperty(
226
+ '--panel-available-height',
227
+ `${availableHeight}px`,
228
+ );
229
+ },
230
+ }),
231
+ ],
232
+ });
233
+
234
+ const listRef = React.useRef<Array<HTMLElement | null>>([]);
235
+ const labelsRef = React.useRef<Array<string | null>>(labels ?? []);
236
+ labelsRef.current = labels ?? [];
237
+
238
+ // Virtual navigation keeps DOM focus on the trigger and points at the current
239
+ // row with `aria-activedescendant`; roving moves focus into the panel.
240
+ const listNav = useListNavigation(context, {
241
+ // A non-list panel keeps its own key handling; binding the row cursor here
242
+ // would swallow the Arrow keys before its content ever saw them.
243
+ enabled: isList,
244
+ listRef,
245
+ activeIndex,
246
+ selectedIndex,
247
+ onNavigate: setActiveIndex,
248
+ virtual: focusModel === 'virtual',
249
+ loop: true,
250
+ disabledIndices,
251
+ // A menu opens with its first item current, however it was opened (APG); the
252
+ // default `'auto'` only does that for keyboard opens, which left a
253
+ // click-opened menu with no cursor and focus stranded on the panel. A field
254
+ // trigger keeps `'auto'` — its cursor starts on the SELECTED option instead.
255
+ focusItemOnOpen: focusModel === 'roving' ? true : 'auto',
256
+ });
257
+ const typeaheadInteraction = useTypeahead(context, {
258
+ listRef: labelsRef,
259
+ activeIndex,
260
+ selectedIndex,
261
+ onMatch: setActiveIndex,
262
+ enabled: typeahead && isList,
263
+ onTypingChange(isTyping) {
264
+ isTypingRef.current = isTyping;
265
+ },
266
+ });
267
+ const click = useClick(context);
268
+ const dismiss = useDismiss(context);
269
+ // floating-ui wires the trigger↔panel ARIA pair for the roles it knows. A
270
+ // `group` panel (the multi-select filter Popover) is not one of them — there
271
+ // the organism sets `role="group"` itself through `panelProps`.
272
+ const roleInteraction = useRole(context, {
273
+ role: role === 'group' ? 'dialog' : role,
274
+ enabled: role !== 'group',
275
+ });
276
+
277
+ const { getReferenceProps, getFloatingProps, getItemProps } = useInteractions([
278
+ listNav,
279
+ typeaheadInteraction,
280
+ click,
281
+ dismiss,
282
+ roleInteraction,
283
+ ]);
284
+
285
+ // Reduced motion drops the slide and the duration; the panel still fades in
286
+ // instantly rather than popping mid-frame.
287
+ const prefersReducedMotion = usePrefersReducedMotion();
288
+ const { isMounted, styles: transitionStyles } = useTransitionStyles(context, {
289
+ duration: prefersReducedMotion ? 0 : TRANSITION_DURATION,
290
+ initial: prefersReducedMotion
291
+ ? { opacity: 0 }
292
+ : { opacity: 0, transform: `translateY(-${PANEL_OFFSET}px)` },
293
+ });
294
+
295
+ // Focus returns to the trigger on every dismissal (spec § Dismissal). In the
296
+ // roving model `FloatingFocusManager` restores it; in the virtual model focus
297
+ // never left, so this is a no-op safeguard for pointer-driven closes.
298
+ const close = React.useCallback(() => {
299
+ onOpenChange(false);
300
+ setActiveIndex(null);
301
+ const trigger = refs.domReference.current;
302
+ if (trigger instanceof HTMLElement) trigger.focus();
303
+ }, [onOpenChange, refs.domReference]);
304
+
305
+ const panelStyle: React.CSSProperties =
306
+ widthPolicy === 'trigger'
307
+ ? { minWidth: 'var(--panel-min-width)' }
308
+ : { minWidth: CONTENT_MIN_WIDTH, maxWidth: CONTENT_MAX_WIDTH };
309
+
310
+ // The token governs, the viewport only clamps it further — exactly the shape
311
+ // popover-patterns.md § Filling rules spells out.
312
+ const bodyStyle: React.CSSProperties = {
313
+ maxHeight: 'min(var(--ds-overlay-max-height), var(--panel-available-height, 100vh))',
314
+ };
315
+
316
+ // itemCount is part of the public options so the organism documents its list
317
+ // length in one place; floating-ui derives navigation from `listRef` itself.
318
+ void itemCount;
319
+
320
+ const portalRoot = useDialogRoot(context.elements.domReference);
321
+
322
+ return {
323
+ refs,
324
+ floatingStyles,
325
+ transitionStyles,
326
+ isMounted,
327
+ context,
328
+ activeIndex,
329
+ setActiveIndex,
330
+ listRef,
331
+ getReferenceProps,
332
+ getFloatingProps,
333
+ getItemProps,
334
+ panelStyle,
335
+ bodyStyle,
336
+ close,
337
+ isTypingRef,
338
+ portalRoot,
339
+ };
340
+ }