@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,683 @@
1
+ "use client";
2
+ import * as React from 'react';
3
+ import * as DialogPrimitive from '@radix-ui/react-dialog';
4
+ import { AnimatePresence, motion, useReducedMotion } from 'motion/react';
5
+ import { curves, semantic, springs } from '../../tokens';
6
+ import { tv } from '../../internal/tailwind-variants';
7
+ import { Icon } from '../icon/Icon';
8
+ import { IconButton } from '../icon-button/IconButton';
9
+ import { hasOpenFloatingPanel, usePortalTarget } from '../../internal/dialogPortal';
10
+ import { InertWhileExiting, scrimFade } from '../../internal/overlayMotion';
11
+ import { useReturnFocus } from '../../internal/useReturnFocus';
12
+ import { cn } from '../../internal/utils';
13
+
14
+ /**
15
+ * Drawer — the Drawer Surface (`drawer.manifest.json`, organism, v1.0.5).
16
+ *
17
+ * Spec: `spec/05-organisms/drawer.md`.
18
+ *
19
+ * The mobile menu chrome — the full-screen open state of the Nav Bar's Menu button: a
20
+ * header, a scrollable Body slot and an optional pinned Footer slot. It is chrome ONLY —
21
+ * the account card, the agenda rows and the navigation rows are all consumer content
22
+ * mounted into the slots (`intent.whenToUse`).
23
+ *
24
+ * Built on Radix `Dialog` primitives, per `delivery.react`: `Dialog.Root` /
25
+ * `Dialog.Portal` supply the focus trap, the scroll lock, the Esc handling and the
26
+ * portal mount. `Dialog.Overlay` (scrim) and `Dialog.Content` (panel) are SIBLINGS
27
+ * inside the portal — never the panel nested in the scrim with a manual
28
+ * `stopPropagation()`, which is the pattern that silently breaks outside-click
29
+ * dismissal once the panel is as large as the overlay.
30
+ *
31
+ * Two Figma axes, three variants (`intent.variants`, `axes`):
32
+ * - Placement=Right, Level=Root — one close Icon Button (Secondary / md, `x`) at the right
33
+ * end, where the Menu button sits; the title is visually hidden and only names the
34
+ * dialog.
35
+ * - Placement=Right, Level=Nested — back (Tertiary / md, `arrow-left`) · the centred title
36
+ * · the same close.
37
+ * - Placement=Left, Level=Root — the parked agenda-panel model, unchanged: the visible
38
+ * title and one hinge-side arrow (Tertiary / lg) that closes, against a hidden spacer.
39
+ *
40
+ * Level maps to the code prop `nested` (`delivery.react`). It is a TypeScript union so
41
+ * `onBack` and `backLabel` cannot go missing on a Nested level, and so a Nested level
42
+ * cannot be asked of Placement=Left, which has none (`properties[Level].maps`).
43
+ *
44
+ * Why Esc always fully closes, even from Nested: `intent.rules` — Nested is a level
45
+ * inside a BLOCKING dialog, not a non-blocking anchored flyout, so `accessibility.md`'s
46
+ * global "Esc closes any modal, drawer, or popover" governs instead of
47
+ * `overlay-behavior.md` § Submenu's Esc-steps-back convention. Back is reached only
48
+ * through the back button. There is no swipe gesture (1.0.4).
49
+ */
50
+
51
+ const drawerVariants = tv({
52
+ slots: {
53
+ /*
54
+ * `overlay.fill` / `overlay.zIndex`. The scrim is a blocking-surface backdrop, so it
55
+ * takes --bg-overlay at --z-index-modal-backdrop, one step under the panel.
56
+ *
57
+ * Motion: it fades on --duration-slow + --easing-enter / --easing-exit (Motion props,
58
+ * see useDrawerMotion).
59
+ */
60
+ scrim: ['fixed inset-0', 'bg-background-overlay z-modal-backdrop'],
61
+ /*
62
+ * `container` — --bg-primary, --radius-0 (deliberately unrounded: the panel is bled
63
+ * to the viewport edge), --shadow-modal (the blocking-surface elevation, NOT
64
+ * --shadow-overlay), --z-index-modal.
65
+ *
66
+ * `w-full` is the whole width story. `sizes[0].width = 390` is the Mobile
67
+ * breakpoint's reference canvas, NOT a measurement to implement — `intent.sizing`
68
+ * spells this out, so there is no `w-[390px]` anywhere here.
69
+ */
70
+ root: [
71
+ 'fixed inset-y-0 w-full',
72
+ 'flex flex-col',
73
+ 'bg-background-primary rounded-0 shadow-modal z-modal',
74
+ ],
75
+ /*
76
+ * `regions[header]` — a row, items centred, gap --space-400. The bottom rule is a plain
77
+ * token border (--outline-default / --border-width-100), the same recipe Modal uses —
78
+ * NOT a mounted Divider instance, which `divider.md` scopes to a floating popover
79
+ * panel. Box and padding are placement-dependent (see the variant).
80
+ */
81
+ header: [
82
+ 'flex shrink-0 items-center gap-400',
83
+ 'border-b-100 border-b-outline-default',
84
+ ],
85
+ /*
86
+ * `parts.title` — the shell's ONLY inked text. Heading/H5 resolved from
87
+ * `spec/02-tokens/text-styles.json`: --font-heading (Poppins), --font-size-heading-h5,
88
+ * --font-weight-semibold; the leading rides along with `text-heading-h5`. Whether it
89
+ * is shown or only names the dialog is the `titleVisible` variant.
90
+ */
91
+ title: 'font-poppins text-heading-h5 font-semibold text-text-primary',
92
+ /*
93
+ * Placement=Right `slots.close` / `slots.back` — Icon Button Size md, square
94
+ * (`delivery.react`): `items-center` on the header already keeps the cross axis from
95
+ * stretching them, `shrink-0` keeps a long title from squeezing them along the main
96
+ * axis. `ml-auto` puts close at the right end at Root, where it is the only box in
97
+ * the row's flow (the hidden title is taken out of it).
98
+ */
99
+ close: 'ml-auto shrink-0',
100
+ back: 'shrink-0',
101
+ /*
102
+ * Placement=Left (parked) opposite end-cap. It exists only so the title-centering maths
103
+ * is symmetric: no fill, no border, not focusable, hidden from assistive tech
104
+ * (`regions[header].note`). Its box matches Icon Button Size lg exactly, and 44 is not on
105
+ * the --space grid — same treatment, and the same suppression, that `IconButton.tsx`
106
+ * gives its own `lg`.
107
+ */
108
+ // fods-lint-disable-next-line off-grid 44px end-cap spacer matching Icon Button L; not on the --space grid
109
+ spacer: 'size-[44px] shrink-0',
110
+ /*
111
+ * `regions[1]` — the single scroll region, filling everything between header and
112
+ * footer. `min-h-0` is what actually lets it shrink inside the flex column;
113
+ * `overflow-x-hidden` clips the Level shift, `relative` is the containing block the
114
+ * outgoing level is absolutely positioned against.
115
+ */
116
+ body: 'relative min-h-0 flex-1 overflow-y-auto overflow-x-hidden',
117
+ /** `regions[2]` — hugs its content, pinned under the Body. */
118
+ footer: 'shrink-0',
119
+ },
120
+ variants: {
121
+ /*
122
+ * `axes.placement`: which viewport edge the panel is hinged to, which direction it
123
+ * slides from, and which header the panel carries (`regions[header].note`).
124
+ */
125
+ placement: {
126
+ /*
127
+ * Parked, unchanged: no explicit height — the manifest's 69 is --space-500 ×2 + the
128
+ * 44 arrow + the 1px rule, exactly what this padding, the Size lg control and the
129
+ * border produce. Inline padding --space-400 on the hinge side (the arrow's icon box
130
+ * aligns optically with the content edge), --space-500 opposite.
131
+ */
132
+ left: {
133
+ root: 'left-0',
134
+ header: 'py-500 pl-400 pr-500',
135
+ },
136
+ /*
137
+ * The open state of the Menu button: 60 tall, fixed — the Nav Bar's main-bar height
138
+ * at Mobile, no vertical padding, the Size md buttons sit centred. 60 has no token
139
+ * (the manifest records it as a measurement, not a binding), so it is the one
140
+ * arbitrary length here; border-box, so the 1px rule is inside it. Side padding =
141
+ * the page container's side padding per breakpoint, 16 · 24 · 32 · 40 at Mobile · SM ·
142
+ * MD · LG (--space-600 · 800 · 900 · 1000) — the Layout collection is design-only, so
143
+ * the steps come from the container, the same ladder FAQ uses. Fill --bg-primary.
144
+ */
145
+ right: {
146
+ root: 'right-0',
147
+ header: [
148
+ // fods-lint-disable-next-line tw-px 60px header = the Nav Bar main-bar height at Mobile (drawer.manifest regions[header].note); no token
149
+ 'h-[60px]',
150
+ 'bg-background-primary px-600 sm:px-800 md:px-900 lg:px-1000',
151
+ ],
152
+ },
153
+ },
154
+ /*
155
+ * Placement=Left and Level=Nested show the title; Placement=Right, Level=Root renders it
156
+ * visually hidden as the dialog's accessible name (`properties[Title].maps`). Shown, it
157
+ * fills the space between the two end boxes, centred, one line, truncating — the clip
158
+ * sits on the title, never on the header, or the buttons' focus rings get cut.
159
+ *
160
+ * No `[text-wrap:var(--text-wrap-heading)]` even though the style binds one: `text.title`
161
+ * is `overflow: truncate`, `lines: 1`, and `truncate`'s own `white-space: nowrap` makes
162
+ * any wrap rule dead CSS.
163
+ */
164
+ titleVisible: {
165
+ true: { title: 'min-w-0 flex-1 truncate text-center' },
166
+ false: { title: 'sr-only' },
167
+ },
168
+ },
169
+ defaultVariants: {
170
+ /* `properties[].default` = Left. */
171
+ placement: 'left',
172
+ titleVisible: true,
173
+ },
174
+ });
175
+
176
+ /** Which viewport edge the panel is hinged to (`axes.placement`, default Left). */
177
+ export type DrawerPlacement = 'left' | 'right';
178
+
179
+ /** Which way a Level change is travelling. Root -> Nested is `deeper`. */
180
+ type DrawerLevelDirection = 'deeper' | 'back';
181
+
182
+ /*
183
+ * Level change, per `motion.note`: a content transition inside the standing panel's Body.
184
+ * The outgoing level fades out on --duration-fast / --easing-exit while shifting
185
+ * --space-900 away; the incoming one starts --duration-instant later, fades in on
186
+ * --duration-slow / --easing-enter and settles --space-900 to its place on --spring-gentle.
187
+ * The direction is PLACEMENT-RELATIVE: deeper content arrives from the panel's own FAR edge
188
+ * (away from its hinge) — a Left panel takes it from the right, a Right panel from the
189
+ * left — and back reverses it. Reduced motion: a cross-fade at --duration-instant, no shift.
190
+ */
191
+ /** --space-900 as a number — a px keyframe needs no DOM measurement before it can start. */
192
+ const LEVEL_SHIFT = parseFloat(semantic.spacing['900'].resolvedValue);
193
+ const LEVEL_SHIFT_BACK = -LEVEL_SHIFT;
194
+
195
+ function useDrawerMotion(placement: DrawerPlacement, direction: DrawerLevelDirection | null) {
196
+ const reduce = useReducedMotion() ?? false;
197
+ const scrim = scrimFade(reduce);
198
+
199
+ // `motion.enter` / `motion.exit`: a full-panel-width slide from the panel's own edge.
200
+ // Reduced motion: no slide, an opacity-only fade at --duration-instant.
201
+ const offEdge = reduce ? { opacity: 0 } : { x: placement === 'left' ? '-100%' : '100%' };
202
+ const panel = {
203
+ initial: offEdge,
204
+ animate: { opacity: 1, x: 0 },
205
+ exit: offEdge,
206
+ transition: reduce ? { duration: curves.duration.instant } : springs.gentle,
207
+ };
208
+
209
+ // Incoming from the far edge on `deeper` (Left: +x), from the hinge side on `back`.
210
+ const fromFar = (placement === 'left') === (direction === 'deeper');
211
+ const shiftIn = reduce ? 0 : fromFar ? LEVEL_SHIFT : LEVEL_SHIFT_BACK;
212
+ const shiftOut = reduce ? 0 : fromFar ? LEVEL_SHIFT_BACK : LEVEL_SHIFT;
213
+ const delay = reduce ? 0 : curves.duration.instant;
214
+ const outgoing = {
215
+ initial: { opacity: 1, x: 0 },
216
+ animate: { opacity: 0, x: shiftOut },
217
+ transition: {
218
+ duration: reduce ? curves.duration.instant : curves.duration.fast,
219
+ ease: curves.easing.exit,
220
+ },
221
+ };
222
+ const incoming = {
223
+ initial: direction === null ? false : { opacity: 0, x: shiftIn },
224
+ animate: { opacity: 1, x: 0 },
225
+ transition: {
226
+ opacity: {
227
+ duration: reduce ? curves.duration.instant : curves.duration.slow,
228
+ ease: curves.easing.enter,
229
+ delay,
230
+ },
231
+ x: { ...springs.gentle, delay },
232
+ },
233
+ } as const;
234
+
235
+ return { scrim, panel, outgoing, incoming };
236
+ }
237
+
238
+ interface DrawerBaseProps {
239
+ /** Open state. The drawer is always controlled — it has no trigger of its own. */
240
+ open: boolean;
241
+ /**
242
+ * Fully closes the drawer. Called by the close button (Placement=Left: the arrow) on
243
+ * every level, and ALWAYS by Esc — including from Nested (`intent.rules`).
244
+ */
245
+ onClose: () => void;
246
+ /**
247
+ * The panel's name, and always the dialog's accessible name. Placement=Right, Root: the
248
+ * panel name rendered visually hidden (`Menu`). Nested: the destination's name from the
249
+ * row that opened it, shown (`Nastavení agendy`). Placement=Left: shown (`Agenda a účet`).
250
+ */
251
+ title: string;
252
+ /**
253
+ * Accessible name of the close button (Placement=Left: of the arrow that closes).
254
+ * Translated by the caller (cs: Zavřít).
255
+ */
256
+ closeLabel: string;
257
+ /** Body slot — the CURRENT level's content only. Never a second level. */
258
+ children: React.ReactNode;
259
+ /** Footer slot content. */
260
+ footer?: React.ReactNode;
261
+ /**
262
+ * Toggles the pinned Footer region (`properties[].default` = true). The region is only
263
+ * rendered when a `footer` is actually supplied, so turning it on without content does
264
+ * not leave an empty box in the layout.
265
+ */
266
+ showFooter?: boolean;
267
+ className?: string;
268
+ }
269
+
270
+ /**
271
+ * Level (`axes.level`) maps to `nested`, and it is tied to Placement: a Nested level
272
+ * without a back handler or without a translated label would render a back button that
273
+ * does nothing or announces nothing, and Placement=Left has no Nested level at all
274
+ * (`properties[Level].maps`). The union makes both unrepresentable, the same way
275
+ * `RadioGroup` forces its accessible name.
276
+ */
277
+ type DrawerLevelProps =
278
+ | {
279
+ /** Which viewport edge the panel is hinged to (`axes.placement`, default Left). */
280
+ placement?: DrawerPlacement;
281
+ /** Level=Root. */
282
+ nested?: false;
283
+ onBack?: never;
284
+ backLabel?: never;
285
+ }
286
+ | {
287
+ /** Level=Nested exists on Placement=Right only. */
288
+ placement: 'right';
289
+ /** Level=Nested — back · title · close. */
290
+ nested: true;
291
+ /** Steps back one level. Called by the back button only, never by Esc. */
292
+ onBack: () => void;
293
+ /** Accessible name of the back button. Translated by the caller (cs: Zpět). */
294
+ backLabel: string;
295
+ };
296
+
297
+ export type DrawerProps = DrawerBaseProps & DrawerLevelProps;
298
+
299
+ /** The Body's level state: which level is showing, and what is still sliding out of it. */
300
+ interface DrawerLevelState {
301
+ /** `nested` as of the level currently occupying the Body. */
302
+ nested: boolean;
303
+ /** Bumped on every level change so the incoming layer remounts and replays its entrance. */
304
+ key: number;
305
+ /** The previous level's children, kept mounted for the transition's duration. */
306
+ outgoing: React.ReactNode;
307
+ /** `null` while nothing is in flight. */
308
+ direction: DrawerLevelDirection | null;
309
+ }
310
+
311
+ /**
312
+ * The value `value` held at the previous render. Radix's own `usePrevious` idiom: the ref
313
+ * is advanced inside a memo keyed on the value, so the extra render the level adjustment
314
+ * below schedules does not move it on.
315
+ */
316
+ function usePreviousChildren(value: React.ReactNode): React.ReactNode {
317
+ const ref = React.useRef({ value, previous: value });
318
+
319
+ return React.useMemo(() => {
320
+ if (ref.current.value !== value) {
321
+ ref.current.previous = ref.current.value;
322
+ ref.current.value = value;
323
+ }
324
+ return ref.current.previous;
325
+ }, [value]);
326
+ }
327
+
328
+ // Disabled controls are counted too, so a row disabled while the Nested level is open
329
+ // does not shift the index onto its neighbour — it is skipped at focus time instead.
330
+ const FOCUS_CANDIDATE_SELECTOR = 'a[href], button, input, select, textarea, [tabindex]';
331
+
332
+ const focusCandidatesIn = (container: HTMLElement | null): HTMLElement[] =>
333
+ container
334
+ ? Array.from(container.querySelectorAll<HTMLElement>(FOCUS_CANDIDATE_SELECTOR))
335
+ : [];
336
+
337
+ // `useId` output (`:r1:` / `«r1»` / `_r_1_` across React versions) is re-issued when the
338
+ // row remounts, so it would never match on the way back.
339
+ const GENERATED_ID = /^[:«_]r\w*[:»_]$/;
340
+
341
+ /** What identifies the opening row once its node is gone: id, else href, else tag + name. */
342
+ const fingerprintOf = (element: HTMLElement): string => {
343
+ if (element.id && !GENERATED_ID.test(element.id)) {
344
+ return `id:${element.id}`;
345
+ }
346
+ const href = element.getAttribute('href');
347
+ if (href) {
348
+ return `href:${href}`;
349
+ }
350
+ const name = element.getAttribute('aria-label') ?? element.textContent ?? '';
351
+ return `${element.tagName}:${name.trim().replace(/\s+/g, ' ')}`;
352
+ };
353
+
354
+ type DrawerOpenerRegion = 'body' | 'footer';
355
+
356
+ interface DrawerOpenerRecord {
357
+ region: DrawerOpenerRegion;
358
+ index: number;
359
+ fingerprint: string;
360
+ }
361
+
362
+ const Drawer = React.forwardRef<
363
+ React.ComponentRef<typeof DialogPrimitive.Content>,
364
+ DrawerProps
365
+ >(
366
+ (
367
+ {
368
+ open,
369
+ onClose,
370
+ title,
371
+ closeLabel,
372
+ children,
373
+ footer,
374
+ showFooter = true,
375
+ placement = 'left',
376
+ nested = false,
377
+ onBack,
378
+ backLabel,
379
+ className,
380
+ },
381
+ ref,
382
+ ) => {
383
+ // Placement=Left has no Nested level (`properties[Level].maps`); the union already
384
+ // forbids it, this keeps a JS caller that passes it anyway on the parked header.
385
+ const titleVisible = placement === 'left' || nested;
386
+ const slots = drawerVariants({ placement, titleVisible });
387
+ const portalTarget = usePortalTarget();
388
+ // The control that closes: the close button (Right) or the hinge-side arrow (Left).
389
+ const closeRef = React.useRef<HTMLButtonElement>(null);
390
+ const backRef = React.useRef<HTMLButtonElement>(null);
391
+ const levelLayerRef = React.useRef<HTMLDivElement>(null);
392
+ const footerRef = React.useRef<HTMLDivElement>(null);
393
+ /*
394
+ * `delivery.react` has the shell keep "a reference to the opening row per level". The
395
+ * row remounts on the way back (the incoming layer is re-keyed, and the footer is
396
+ * consumer content that may unmount on Nested), so the node itself is gone by then. What
397
+ * is kept is an identification of it instead: its region, its position among that
398
+ * region's focus candidates, and a fingerprint that catches Root content which changed
399
+ * in between. `nested` is a boolean, so one slot is the whole per-level history.
400
+ */
401
+ const openerRef = React.useRef<DrawerOpenerRecord | null>(null);
402
+ // A level change in the same render that opens the drawer is not a transition: no
403
+ // transition, and no focus move that would pre-empt the open's own initial focus and the
404
+ // trigger capture `useReturnFocus` makes after it.
405
+ const wasOpenRef = React.useRef(open);
406
+
407
+ const previousChildren = usePreviousChildren(children);
408
+ const [level, setLevel] = React.useState<DrawerLevelState>({
409
+ nested,
410
+ key: 0,
411
+ outgoing: null,
412
+ direction: null,
413
+ });
414
+
415
+ /*
416
+ * Adjusting state while rendering, which is what React prescribes for "a prop
417
+ * changed and some derived state has to follow". Doing it in an effect instead would
418
+ * paint one frame of the incoming level alone, and the outgoing level would then pop
419
+ * back in for the transition.
420
+ *
421
+ * `delivery.react`: keeping the outgoing Body mounted next to the incoming one is the
422
+ * shell's own concern — the consumer only ever passes the current level's children.
423
+ * While the drawer is closed, or opens in this very render, there is nothing to animate,
424
+ * so the snapshot is skipped.
425
+ */
426
+ if (level.nested !== nested) {
427
+ // Read during render on purpose: once this change commits, the opening row is
428
+ // unmounted with the outgoing layer and focus has already fallen to <body>.
429
+ const transitioning = open && wasOpenRef.current;
430
+ if (transitioning && nested) {
431
+ const active = document.activeElement as HTMLElement | null;
432
+ const region: DrawerOpenerRegion =
433
+ active && footerRef.current?.contains(active) ? 'footer' : 'body';
434
+ const container = region === 'footer' ? footerRef.current : levelLayerRef.current;
435
+ const index = active ? focusCandidatesIn(container).indexOf(active) : -1;
436
+ openerRef.current =
437
+ active && index !== -1 ? { region, index, fingerprint: fingerprintOf(active) } : null;
438
+ }
439
+ setLevel(previous => ({
440
+ nested,
441
+ key: previous.key + 1,
442
+ outgoing: transitioning ? previousChildren : null,
443
+ direction: transitioning ? (nested ? 'deeper' : 'back') : null,
444
+ }));
445
+ }
446
+
447
+ /*
448
+ * `delivery.react`: drilling in focuses the back button of the new level, never the
449
+ * container — the opening row left with the outgoing layer. Stepping back focuses the
450
+ * row that opened the level once Root's content is mounted again: the candidate at the
451
+ * recorded position if it still carries the opener's fingerprint, else the first one in
452
+ * the same region that does (rows were inserted or removed meanwhile), else the close
453
+ * button. A disabled opener also yields the close button, never a neighbour.
454
+ * A layout effect, so focus is placed before Radix's FocusScope reacts to the removed
455
+ * node by focusing the container.
456
+ */
457
+ React.useLayoutEffect(() => {
458
+ if (level.direction === 'deeper') {
459
+ (backRef.current ?? closeRef.current)?.focus();
460
+ } else if (level.direction === 'back') {
461
+ const record = openerRef.current;
462
+ openerRef.current = null;
463
+ let opener: HTMLElement | undefined;
464
+ if (record) {
465
+ const candidates = focusCandidatesIn(
466
+ record.region === 'footer' ? footerRef.current : levelLayerRef.current,
467
+ );
468
+ const atIndex = candidates[record.index];
469
+ opener =
470
+ atIndex && fingerprintOf(atIndex) === record.fingerprint
471
+ ? atIndex
472
+ : candidates.find(candidate => fingerprintOf(candidate) === record.fingerprint);
473
+ }
474
+ (opener && !opener.matches(':disabled') ? opener : closeRef.current)?.focus();
475
+ }
476
+ // The transition-complete reset (direction -> null) re-runs this as a no-op.
477
+ }, [level.key, level.direction]);
478
+
479
+ React.useEffect(() => {
480
+ wasOpenRef.current = open;
481
+ if (!open) {
482
+ openerRef.current = null;
483
+ }
484
+ }, [open]);
485
+
486
+ const handleOpenChange = (next: boolean) => {
487
+ if (!next) {
488
+ onClose();
489
+ }
490
+ };
491
+
492
+ const handleOpenAutoFocus = (event: Event) => {
493
+ // `delivery.react`: on open, focus lands on the close button — present at every level.
494
+ event.preventDefault();
495
+ closeRef.current?.focus();
496
+ };
497
+
498
+ const handleCloseAutoFocus = useReturnFocus(open);
499
+
500
+ const [rootNode, setRootNode] = React.useState<HTMLDivElement | null>(null);
501
+ const setRootRef = React.useCallback(
502
+ (node: HTMLDivElement | null) => {
503
+ setRootNode(node);
504
+ if (typeof ref === 'function') ref(node);
505
+ else if (ref) ref.current = node;
506
+ },
507
+ [ref],
508
+ );
509
+
510
+ // An open floating-ui panel takes Escape, not the drawer — see Modal's handleEscapeKeyDown.
511
+ const handleEscapeKeyDown = (event: KeyboardEvent) => {
512
+ if (hasOpenFloatingPanel(rootNode)) {
513
+ event.preventDefault();
514
+ }
515
+ };
516
+
517
+ // The incoming layer lands last (it starts --duration-instant later), so its settle ends
518
+ // the transition and drops the outgoing layer.
519
+ const handleLevelAnimationComplete = () => {
520
+ setLevel(previous =>
521
+ previous.direction === null ? previous : { ...previous, outgoing: null, direction: null },
522
+ );
523
+ };
524
+
525
+ const drawerMotion = useDrawerMotion(placement, level.direction);
526
+
527
+ const titleNode = (
528
+ <DialogPrimitive.Title data-fods-part="title" className={slots.title()}>
529
+ {title}
530
+ </DialogPrimitive.Title>
531
+ );
532
+
533
+ /*
534
+ * Placement=Right (`slots.close` / `slots.back`, `regions[header]`): back · title · close
535
+ * on Nested, close alone at the right end on Root. Close is the same node on both
536
+ * levels — the `false` hole the Root level leaves keeps its position in the children —
537
+ * so a level change never re-mounts it. The header is not animated: its controls and
538
+ * title update instantly on a Level change (`motion.note`).
539
+ */
540
+ const rightHeader = (
541
+ <>
542
+ {nested && (
543
+ <IconButton
544
+ ref={backRef}
545
+ variant="tertiary"
546
+ size="md"
547
+ icon={<Icon name="arrow-left" />}
548
+ // Destructuring drops the union's correlation between `nested` and `backLabel`,
549
+ // so TypeScript widens the label to `string | undefined` here; the props type
550
+ // has already guaranteed it on a nested level.
551
+ aria-label={backLabel as string}
552
+ onClick={onBack}
553
+ data-fods-part="back"
554
+ className={slots.back()}
555
+ />
556
+ )}
557
+ {titleNode}
558
+ <IconButton
559
+ ref={closeRef}
560
+ variant="secondary"
561
+ size="md"
562
+ icon={<Icon name="x" />}
563
+ aria-label={closeLabel}
564
+ onClick={onClose}
565
+ data-fods-part="close"
566
+ className={slots.close()}
567
+ />
568
+ </>
569
+ );
570
+
571
+ /*
572
+ * Placement=Left (parked, `slots.dismiss-or-back`): the earlier header, unchanged — one
573
+ * Icon Button Tertiary / Size lg with `arrow-left` at the hinge-side end-cap, which
574
+ * closes the panel, the visible title, and a hidden spacer of the same box opposite.
575
+ */
576
+ const leftHeader = (
577
+ <>
578
+ <IconButton
579
+ ref={closeRef}
580
+ variant="tertiary"
581
+ size="lg"
582
+ icon={<Icon name="arrow-left" />}
583
+ aria-label={closeLabel}
584
+ onClick={onClose}
585
+ data-fods-part="dismiss-or-back"
586
+ />
587
+ {titleNode}
588
+ <span aria-hidden="true" data-fods-part="spacer" className={slots.spacer()} />
589
+ </>
590
+ );
591
+
592
+ return (
593
+ <DialogPrimitive.Root open={open} onOpenChange={handleOpenChange}>
594
+ {/*
595
+ * Radix parts force-mounted under AnimatePresence: the exit plays before Radix
596
+ * unmounts, then focus returns and the scroll lock lifts.
597
+ */}
598
+ <AnimatePresence>
599
+ {open && (
600
+ <DialogPrimitive.Portal key="drawer" forceMount container={portalTarget}>
601
+ {/*
602
+ * The scrim is a SIBLING of the panel, which is Radix's own model and what
603
+ * `delivery.react` requires. It also means it sits outside the panel's subtree,
604
+ * so it carries `data-fods-component` itself — the runtime probe resolves a
605
+ * part's owner with `closest('[data-fods-component]')` and would otherwise find
606
+ * no owner for it.
607
+ *
608
+ * Its outside-click handling is deliberately left alone. At the current Mobile
609
+ * size the panel covers the scrim's entire rect, so there is no pointer-reachable
610
+ * area and the handler is simply inert (`overlay.note`); it starts working by itself
611
+ * the day a narrower-than-viewport breakpoint exists.
612
+ */}
613
+ <DialogPrimitive.Overlay
614
+ forceMount
615
+ asChild
616
+ data-fods-component="drawer"
617
+ data-fods-part="scrim"
618
+ className={slots.scrim()}
619
+ >
620
+ <motion.div {...drawerMotion.scrim} />
621
+ </DialogPrimitive.Overlay>
622
+ <InertWhileExiting>
623
+ <DialogPrimitive.Content
624
+ forceMount
625
+ asChild
626
+ ref={setRootRef}
627
+ data-fods-component="drawer"
628
+ data-fods-part="root"
629
+ // Radix sets no aria-modal of its own.
630
+ aria-modal="true"
631
+ // The shell has no description run of its own; the explicit `undefined` is
632
+ // Radix's documented way of saying so instead of warning about it.
633
+ aria-describedby={undefined}
634
+ onOpenAutoFocus={handleOpenAutoFocus}
635
+ onCloseAutoFocus={handleCloseAutoFocus}
636
+ onEscapeKeyDown={handleEscapeKeyDown}
637
+ className={cn(slots.root(), className)}
638
+ >
639
+ <motion.div {...drawerMotion.panel}>
640
+ <header data-fods-part="header" className={slots.header()}>
641
+ {placement === 'right' ? rightHeader : leftHeader}
642
+ </header>
643
+ <div data-fods-part="body" className={slots.body()}>
644
+ {level.direction !== null && (
645
+ <motion.div
646
+ // Still on screen, already gone as far as the user and assistive tech are
647
+ // concerned. `inert` also takes it out of the tab order while it fades;
648
+ // `aria-hidden` covers the browsers that do not support `inert`.
649
+ inert
650
+ aria-hidden="true"
651
+ className="absolute inset-0"
652
+ {...drawerMotion.outgoing}
653
+ >
654
+ {level.outgoing}
655
+ </motion.div>
656
+ )}
657
+ <motion.div
658
+ key={level.key}
659
+ ref={levelLayerRef}
660
+ onAnimationComplete={handleLevelAnimationComplete}
661
+ {...drawerMotion.incoming}
662
+ >
663
+ {children}
664
+ </motion.div>
665
+ </div>
666
+ {showFooter && footer != null && (
667
+ <div ref={footerRef} data-fods-part="footer" className={slots.footer()}>
668
+ {footer}
669
+ </div>
670
+ )}
671
+ </motion.div>
672
+ </DialogPrimitive.Content>
673
+ </InertWhileExiting>
674
+ </DialogPrimitive.Portal>
675
+ )}
676
+ </AnimatePresence>
677
+ </DialogPrimitive.Root>
678
+ );
679
+ },
680
+ );
681
+ Drawer.displayName = 'Drawer';
682
+
683
+ export { Drawer, drawerVariants };
@@ -0,0 +1 @@
1
+ export { Drawer, drawerVariants, type DrawerProps, type DrawerPlacement } from './Drawer';