@justanarthur/modo-ui 0.5.0 → 0.6.0-canary.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 (461) hide show
  1. package/DESIGN.md +608 -0
  2. package/README.md +61 -39
  3. package/blocks/sidebar-app/examples.mdx +33 -0
  4. package/blocks/sidebar-app/index.tsx +218 -0
  5. package/blocks/sidebar-app/inset-topbar.tsx +25 -0
  6. package/blocks/sidebar-app/menu-grid.ts +26 -0
  7. package/blocks/sidebar-app/nav-data.ts +36 -0
  8. package/blocks/sidebar-app/search-field.tsx +48 -0
  9. package/blocks/sidebar-app/user-footer.tsx +67 -0
  10. package/blocks/sidebar-app/workspace-header.tsx +129 -0
  11. package/components/AI/input-message/examples.mdx +124 -0
  12. package/components/AI/input-message/file-thumbnail.tsx +173 -0
  13. package/components/AI/input-message/index.tsx +1383 -0
  14. package/components/AI/thinking-indicator/examples.mdx +27 -0
  15. package/components/AI/thinking-indicator/index.tsx +210 -0
  16. package/components/accordion/examples.mdx +148 -0
  17. package/components/accordion/index.tsx +1034 -0
  18. package/components/avatar/examples.mdx +95 -0
  19. package/components/avatar/index.tsx +129 -0
  20. package/components/badge/change-demo.tsx +29 -0
  21. package/components/badge/examples.mdx +120 -0
  22. package/components/badge/index.tsx +225 -0
  23. package/components/badge/variants.ts +73 -0
  24. package/components/button/examples.mdx +164 -0
  25. package/components/button/index.tsx +416 -0
  26. package/components/button/loading-demo.tsx +25 -0
  27. package/components/button/variants.ts +166 -0
  28. package/components/card/examples.mdx +212 -0
  29. package/components/card/index.tsx +1037 -0
  30. package/components/copy/examples.mdx +87 -0
  31. package/components/copy/index.tsx +482 -0
  32. package/components/inputs/checkbox/examples.mdx +83 -0
  33. package/components/inputs/checkbox/index.tsx +611 -0
  34. package/components/inputs/checkbox/select-all-demo.tsx +48 -0
  35. package/components/inputs/color-picker/examples.mdx +72 -0
  36. package/components/inputs/color-picker/index.tsx +1955 -0
  37. package/components/inputs/color-picker/variants.ts +401 -0
  38. package/components/inputs/combobox/examples.mdx +273 -0
  39. package/components/inputs/combobox/index.tsx +1436 -0
  40. package/components/inputs/combobox/remote-demo.tsx +101 -0
  41. package/components/inputs/date-time/calendar/examples.mdx +34 -0
  42. package/components/inputs/date-time/calendar/index.tsx +351 -0
  43. package/components/inputs/date-time/calendar/use-month-window.ts +163 -0
  44. package/components/inputs/date-time/date-picker/examples.mdx +166 -0
  45. package/components/inputs/date-time/date-picker/index.tsx +385 -0
  46. package/components/inputs/date-time/date-picker/masked-date-input.tsx +336 -0
  47. package/components/inputs/date-time/date-range-picker/examples.mdx +29 -0
  48. package/components/inputs/date-time/date-range-picker/index.tsx +217 -0
  49. package/components/inputs/date-time/duration-picker/examples.mdx +16 -0
  50. package/components/inputs/date-time/duration-picker/index.tsx +189 -0
  51. package/components/inputs/date-time/month-picker/examples.mdx +16 -0
  52. package/components/inputs/date-time/month-picker/index.tsx +190 -0
  53. package/components/inputs/date-time/picker-shell.tsx +395 -0
  54. package/components/inputs/date-time/time-columns.tsx +91 -0
  55. package/components/inputs/date-time/time-picker/examples.mdx +26 -0
  56. package/components/inputs/date-time/time-picker/index.tsx +166 -0
  57. package/components/inputs/field/examples.mdx +113 -0
  58. package/components/inputs/field/index.tsx +267 -0
  59. package/components/inputs/file-dropzone/examples.mdx +73 -0
  60. package/components/inputs/file-dropzone/file-row.tsx +201 -0
  61. package/components/inputs/file-dropzone/index.tsx +296 -0
  62. package/components/inputs/file-dropzone/upload-demo.tsx +67 -0
  63. package/components/inputs/file-dropzone/variants.ts +94 -0
  64. package/components/inputs/input/examples.mdx +135 -0
  65. package/components/inputs/input/index.tsx +494 -0
  66. package/components/inputs/input/password-demo.tsx +30 -0
  67. package/components/inputs/label/examples.mdx +67 -0
  68. package/components/inputs/label/index.tsx +85 -0
  69. package/components/inputs/number-input/examples.mdx +56 -0
  70. package/components/inputs/number-input/index.tsx +214 -0
  71. package/components/inputs/radio/examples.mdx +77 -0
  72. package/components/inputs/radio/index.tsx +636 -0
  73. package/components/inputs/search/examples.mdx +74 -0
  74. package/components/inputs/search/index.tsx +333 -0
  75. package/components/inputs/select/examples.mdx +218 -0
  76. package/components/inputs/select/index.tsx +862 -0
  77. package/components/inputs/select/variants.ts +32 -0
  78. package/components/inputs/slider/examples.mdx +127 -0
  79. package/components/inputs/slider/index.tsx +1725 -0
  80. package/components/inputs/switch/examples.mdx +94 -0
  81. package/components/inputs/switch/index.tsx +504 -0
  82. package/components/inputs/textarea/examples.mdx +88 -0
  83. package/components/inputs/textarea/index.tsx +161 -0
  84. package/components/navigation/navigation-menu/examples.mdx +109 -0
  85. package/components/navigation/navigation-menu/index.tsx +613 -0
  86. package/components/navigation/pagination/examples.mdx +64 -0
  87. package/components/navigation/pagination/index.tsx +395 -0
  88. package/components/navigation/sidebar/examples.mdx +319 -0
  89. package/components/navigation/sidebar/index.tsx +453 -0
  90. package/components/navigation/sidebar/sidebar-core.tsx +1408 -0
  91. package/components/navigation/sidebar/sidebar-menu.tsx +1495 -0
  92. package/components/navigation/sidebar/sidebar.css +74 -0
  93. package/components/navigation/sidebar/variants.ts +55 -0
  94. package/components/navigation/tabs/examples.mdx +89 -0
  95. package/components/navigation/tabs/index.tsx +494 -0
  96. package/components/navigation/tabs-subtle/examples.mdx +49 -0
  97. package/components/navigation/tabs-subtle/index.tsx +512 -0
  98. package/components/overlays/alert-dialog/examples.mdx +123 -0
  99. package/components/overlays/alert-dialog/index.tsx +258 -0
  100. package/components/overlays/alert-dialog/pending-demo.tsx +36 -0
  101. package/components/overlays/command/examples.mdx +113 -0
  102. package/components/overlays/command/index.tsx +416 -0
  103. package/components/overlays/context-menu/examples.mdx +56 -0
  104. package/components/overlays/context-menu/index.tsx +279 -0
  105. package/components/overlays/dialog/examples.mdx +144 -0
  106. package/components/overlays/dialog/index.tsx +366 -0
  107. package/components/overlays/dropdown/dropdown-search.tsx +395 -0
  108. package/components/overlays/dropdown/examples.mdx +294 -0
  109. package/components/overlays/dropdown/index.tsx +1168 -0
  110. package/components/overlays/dropdown/menu-item.tsx +464 -0
  111. package/components/overlays/dropdown/menu-parts.tsx +660 -0
  112. package/components/overlays/popover/anchored-demo.tsx +59 -0
  113. package/components/overlays/popover/examples.mdx +180 -0
  114. package/components/overlays/popover/index.tsx +315 -0
  115. package/components/overlays/preview-card/examples.mdx +61 -0
  116. package/components/overlays/preview-card/index.tsx +204 -0
  117. package/components/overlays/sheet/examples.mdx +89 -0
  118. package/components/overlays/sheet/index.tsx +247 -0
  119. package/components/overlays/toast/examples.mdx +68 -0
  120. package/components/overlays/toast/global-demo.tsx +72 -0
  121. package/components/overlays/toast/index.tsx +474 -0
  122. package/components/overlays/toast/manager.ts +193 -0
  123. package/components/overlays/tooltip/examples.mdx +106 -0
  124. package/components/overlays/tooltip/index.tsx +519 -0
  125. package/components/progress/examples.mdx +59 -0
  126. package/components/progress/index.tsx +174 -0
  127. package/components/progress/progress.css +49 -0
  128. package/components/progress/step-demo.tsx +27 -0
  129. package/components/table/examples.mdx +184 -0
  130. package/components/table/index.tsx +510 -0
  131. package/components/table/sort-demo.tsx +61 -0
  132. package/dist/base.css +100 -0
  133. package/dist/blocks/sidebar-app/index.js +39 -26
  134. package/dist/components/AI/input-message/index.js +22 -16
  135. package/dist/components/AI/thinking-indicator/index.js +9 -6
  136. package/dist/components/accordion/index.js +16 -13
  137. package/dist/components/avatar/index.d.ts +46 -0
  138. package/dist/components/avatar/index.js +18 -0
  139. package/dist/components/badge/index.d.ts +18 -11
  140. package/dist/components/badge/index.js +11 -7
  141. package/dist/components/badge/variants.d.ts +33 -0
  142. package/dist/components/badge/variants.js +10 -0
  143. package/dist/components/button/index.d.ts +53 -17
  144. package/dist/components/button/index.js +10 -6
  145. package/dist/components/button/variants.d.ts +39 -0
  146. package/dist/components/button/variants.js +8 -0
  147. package/dist/components/card/index.d.ts +16 -3
  148. package/dist/components/card/index.js +16 -11
  149. package/dist/components/copy/index.js +13 -9
  150. package/dist/components/inputs/checkbox/index.d.ts +28 -9
  151. package/dist/components/inputs/checkbox/index.js +17 -13
  152. package/dist/components/inputs/color-picker/index.d.ts +13 -13
  153. package/dist/components/inputs/color-picker/index.js +25 -18
  154. package/dist/components/inputs/color-picker/variants.d.ts +61 -0
  155. package/dist/components/inputs/color-picker/variants.js +28 -0
  156. package/dist/components/inputs/combobox/index.d.ts +60 -17
  157. package/dist/components/inputs/combobox/index.js +26 -18
  158. package/dist/components/inputs/date-time/calendar/index.js +14 -11
  159. package/dist/components/inputs/date-time/date-picker/index.d.ts +53 -11
  160. package/dist/components/inputs/date-time/date-picker/index.js +33 -25
  161. package/dist/components/inputs/date-time/date-range-picker/index.d.ts +3 -3
  162. package/dist/components/inputs/date-time/date-range-picker/index.js +32 -24
  163. package/dist/components/inputs/date-time/duration-picker/index.d.ts +3 -3
  164. package/dist/components/inputs/date-time/duration-picker/index.js +32 -24
  165. package/dist/components/inputs/date-time/month-picker/index.d.ts +3 -3
  166. package/dist/components/inputs/date-time/month-picker/index.js +31 -23
  167. package/dist/components/inputs/date-time/time-picker/index.d.ts +3 -3
  168. package/dist/components/inputs/date-time/time-picker/index.js +32 -24
  169. package/dist/components/inputs/field/index.d.ts +116 -0
  170. package/dist/components/inputs/field/index.js +28 -0
  171. package/dist/components/inputs/file-dropzone/index.d.ts +165 -0
  172. package/dist/components/inputs/file-dropzone/index.js +32 -0
  173. package/dist/components/inputs/file-dropzone/variants.d.ts +35 -0
  174. package/dist/components/inputs/file-dropzone/variants.js +12 -0
  175. package/dist/components/inputs/input/index.d.ts +95 -13
  176. package/dist/components/inputs/input/index.js +17 -9
  177. package/dist/components/inputs/label/index.d.ts +32 -0
  178. package/dist/components/inputs/label/index.js +11 -0
  179. package/dist/components/inputs/number-input/index.d.ts +84 -0
  180. package/dist/components/inputs/number-input/index.js +20 -0
  181. package/dist/components/inputs/radio/index.d.ts +20 -5
  182. package/dist/components/inputs/radio/index.js +15 -12
  183. package/dist/components/inputs/search/index.js +25 -18
  184. package/dist/components/inputs/select/index.d.ts +41 -11
  185. package/dist/components/inputs/select/index.js +27 -14
  186. package/dist/components/inputs/select/variants.d.ts +5 -0
  187. package/dist/components/inputs/select/variants.js +6 -0
  188. package/dist/components/inputs/slider/index.js +7 -5
  189. package/dist/components/inputs/switch/index.d.ts +8 -2
  190. package/dist/components/inputs/switch/index.js +14 -12
  191. package/dist/components/inputs/textarea/index.d.ts +4 -0
  192. package/dist/components/inputs/textarea/index.js +8 -6
  193. package/dist/components/navigation/navigation-menu/index.d.ts +114 -0
  194. package/dist/components/navigation/navigation-menu/index.js +40 -0
  195. package/dist/components/navigation/pagination/index.d.ts +73 -0
  196. package/dist/components/navigation/pagination/index.js +39 -0
  197. package/dist/components/navigation/sidebar/index.d.ts +44 -21
  198. package/dist/components/navigation/sidebar/index.js +41 -31
  199. package/dist/components/navigation/sidebar/variants.d.ts +25 -0
  200. package/dist/components/navigation/sidebar/variants.js +28 -0
  201. package/dist/components/navigation/tabs/index.d.ts +8 -2
  202. package/dist/components/navigation/tabs/index.js +14 -10
  203. package/dist/components/navigation/tabs-subtle/index.js +12 -10
  204. package/dist/components/overlays/alert-dialog/index.d.ts +121 -15
  205. package/dist/components/overlays/alert-dialog/index.js +22 -13
  206. package/dist/components/overlays/command/index.js +24 -17
  207. package/dist/components/overlays/context-menu/index.d.ts +33 -17
  208. package/dist/components/overlays/context-menu/index.js +27 -18
  209. package/dist/components/overlays/dialog/index.js +17 -12
  210. package/dist/components/overlays/dropdown/index.d.ts +257 -31
  211. package/dist/components/overlays/dropdown/index.js +42 -17
  212. package/dist/components/overlays/popover/index.d.ts +31 -9
  213. package/dist/components/overlays/popover/index.js +12 -9
  214. package/dist/components/overlays/preview-card/index.js +11 -8
  215. package/dist/components/overlays/sheet/index.js +18 -13
  216. package/dist/components/overlays/toast/index.d.ts +123 -47
  217. package/dist/components/overlays/toast/index.js +18 -10
  218. package/dist/components/overlays/tooltip/index.d.ts +113 -21
  219. package/dist/components/overlays/tooltip/index.js +15 -6
  220. package/dist/components/progress/index.d.ts +56 -0
  221. package/dist/components/progress/index.js +15 -0
  222. package/dist/components/table/index.d.ts +63 -8
  223. package/dist/components/table/index.js +19 -9
  224. package/dist/index.d.ts +2201 -736
  225. package/dist/index.js +223 -82
  226. package/dist/lib/date-locale.d.ts +14 -0
  227. package/dist/lib/date-locale.js +16 -0
  228. package/dist/lib/field-classes.d.ts +144 -0
  229. package/dist/lib/field-classes.js +40 -0
  230. package/dist/lib/field-variants.d.ts +47 -0
  231. package/dist/lib/field-variants.js +26 -0
  232. package/dist/lib/fluid-hover-highlight.d.ts +112 -0
  233. package/dist/lib/fluid-hover-highlight.js +17 -0
  234. package/dist/lib/focus-ring.d.ts +18 -0
  235. package/dist/lib/focus-ring.js +10 -0
  236. package/dist/lib/goo-indicator.d.ts +46 -0
  237. package/dist/lib/goo-indicator.js +14 -0
  238. package/dist/lib/icon-context.d.ts +30 -0
  239. package/dist/lib/icon-context.js +12 -0
  240. package/dist/lib/inert.d.ts +9 -0
  241. package/dist/lib/inert.js +8 -0
  242. package/dist/lib/morph-layers.d.ts +93 -0
  243. package/dist/lib/morph-layers.js +13 -0
  244. package/dist/lib/morph-part.d.ts +21 -0
  245. package/dist/lib/morph-part.js +12 -0
  246. package/dist/lib/popup.d.ts +20 -0
  247. package/dist/lib/popup.js +12 -0
  248. package/dist/lib/reduced-motion.d.ts +9 -0
  249. package/dist/lib/reduced-motion.js +6 -0
  250. package/dist/lib/row-index.d.ts +10 -0
  251. package/dist/lib/row-index.js +8 -0
  252. package/dist/lib/row-order.d.ts +28 -0
  253. package/dist/lib/row-order.js +10 -0
  254. package/dist/lib/scroll-column.d.ts +27 -0
  255. package/dist/lib/scroll-column.js +18 -0
  256. package/dist/lib/shape-context.d.ts +30 -0
  257. package/dist/lib/shape-context.js +12 -0
  258. package/dist/lib/size-context.d.ts +94 -0
  259. package/dist/lib/size-context.js +20 -0
  260. package/dist/lib/size-scale.d.ts +79 -0
  261. package/dist/lib/size-scale.js +8 -0
  262. package/dist/lib/slot.d.ts +12 -0
  263. package/dist/lib/slot.js +6 -0
  264. package/dist/lib/springs.d.ts +44 -0
  265. package/dist/lib/springs.js +8 -0
  266. package/dist/lib/surface-classes.d.ts +19 -0
  267. package/dist/lib/surface-classes.js +10 -0
  268. package/dist/lib/surface-context.d.ts +9 -0
  269. package/dist/lib/surface-context.js +8 -0
  270. package/dist/lib/use-controllable-state.d.ts +2 -0
  271. package/dist/lib/use-controllable-state.js +6 -0
  272. package/dist/lib/use-fluid-hover.d.ts +138 -0
  273. package/dist/lib/use-fluid-hover.js +14 -0
  274. package/dist/lib/use-is-mobile.d.ts +2 -0
  275. package/dist/lib/use-is-mobile.js +6 -0
  276. package/dist/lib/use-keyboard-nav-gate.d.ts +20 -0
  277. package/dist/lib/use-keyboard-nav-gate.js +7 -0
  278. package/dist/lib/use-merge-split.d.ts +47 -0
  279. package/dist/lib/use-merge-split.js +15 -0
  280. package/dist/lib/use-morph.d.ts +101 -0
  281. package/dist/lib/use-morph.js +20 -0
  282. package/dist/lib/use-touch-primary.d.ts +2 -0
  283. package/dist/lib/use-touch-primary.js +6 -0
  284. package/dist/lib/utils.d.ts +3 -0
  285. package/dist/lib/utils.js +6 -0
  286. package/dist/preset.d.ts +17 -0
  287. package/dist/preset.js +22 -2
  288. package/dist/primitives/code/index.js +7 -5
  289. package/dist/primitives/craft/index.js +9 -6
  290. package/dist/primitives/fluid-hover/index.js +9 -8
  291. package/dist/primitives/morph/index.js +15 -10
  292. package/dist/primitives/motion/index.js +10 -8
  293. package/dist/primitives/scroll-area/index.js +4 -3
  294. package/dist/primitives/separator/index.d.ts +25 -0
  295. package/dist/primitives/separator/index.js +9 -0
  296. package/dist/primitives/sizes/index.js +6 -4
  297. package/dist/primitives/skeleton/index.d.ts +35 -0
  298. package/dist/primitives/skeleton/index.js +12 -0
  299. package/dist/primitives/surface/index.js +6 -4
  300. package/dist/shared/{components-3mkepka5.js → components-0jmqhx2k.js} +28 -25
  301. package/dist/shared/components-124epb7f.js +53 -0
  302. package/dist/shared/{components-gz8zf3ec.js → components-1k0wv53d.js} +15 -43
  303. package/dist/shared/components-26snnbs9.js +322 -0
  304. package/dist/shared/{components-2dxkv6zm.js → components-2c0qcfx4.js} +8 -7
  305. package/dist/shared/{components-473g814w.js → components-2mt9te6d.js} +243 -137
  306. package/dist/shared/{components-hawvy2qz.js → components-2z48g4fp.js} +9 -30
  307. package/dist/shared/components-34txk9rj.js +35 -0
  308. package/dist/shared/components-3h92d94m.js +23 -0
  309. package/dist/shared/{components-zfnmn5d4.js → components-3sp623ae.js} +36 -31
  310. package/dist/shared/{components-jwst3vtj.js → components-3wxkjgqn.js} +186 -76
  311. package/dist/shared/{components-s2bz1xpk.js → components-49bsynbw.js} +8 -5
  312. package/dist/shared/components-4bwsd46w.js +71 -0
  313. package/dist/shared/components-4n4f5m3e.js +297 -0
  314. package/dist/shared/{components-0q0sqfh4.js → components-4y816hwp.js} +27 -49
  315. package/dist/shared/components-52ngsgca.js +399 -0
  316. package/dist/shared/{components-y9y0g8er.js → components-52r5763g.js} +22 -19
  317. package/dist/shared/components-559tf7yb.js +28 -0
  318. package/dist/shared/components-5mkga9hj.js +440 -0
  319. package/dist/shared/{components-kwa6mrf9.js → components-5s0nfqvw.js} +14 -9
  320. package/dist/shared/{components-dk0gjr5a.js → components-60atskhp.js} +19 -18
  321. package/dist/shared/{components-rr7a6ja9.js → components-658b26nb.js} +21 -18
  322. package/dist/shared/{components-xxvdw7k1.js → components-65vwfjs6.js} +37 -34
  323. package/dist/shared/{components-frw34b65.js → components-6j2fh74k.js} +114 -123
  324. package/dist/shared/components-6zg1yft7.js +167 -0
  325. package/dist/shared/components-6zng858q.js +53 -0
  326. package/dist/shared/components-72w4ge68.js +64 -0
  327. package/dist/shared/{components-cv16mryv.js → components-78x40gee.js} +13 -7
  328. package/dist/shared/{components-b2wyq2cq.js → components-7d4r7hh1.js} +39 -57
  329. package/dist/shared/components-7ntvvegr.js +316 -0
  330. package/dist/shared/components-8nwsqjn8.js +34 -0
  331. package/dist/shared/{components-5xc2j8jz.js → components-8tt3xbb5.js} +19 -18
  332. package/dist/shared/{components-vc7vq5nz.js → components-9as3rf68.js} +6 -3
  333. package/dist/shared/components-9mys9jna.js +255 -0
  334. package/dist/shared/components-adkarj8n.js +35 -0
  335. package/dist/shared/{components-b3c5et5b.js → components-ae9fncz4.js} +32 -31
  336. package/dist/shared/{components-hqeq3w9q.js → components-awra5sff.js} +24 -16
  337. package/dist/shared/components-b1e239g3.js +28 -0
  338. package/dist/shared/{components-q5xj5c16.js → components-b1f2bjf1.js} +9 -8
  339. package/dist/shared/{components-qmmjx1qw.js → components-bn42vq6d.js} +71 -72
  340. package/dist/shared/components-c96g82th.js +1444 -0
  341. package/dist/shared/components-c9yr4ed1.js +44 -0
  342. package/dist/shared/components-d3shbwqq.js +95 -0
  343. package/dist/shared/{components-jjw69c4c.js → components-dcc02hs2.js} +7 -4
  344. package/dist/shared/{components-men63rwj.js → components-de99ykt7.js} +3 -2
  345. package/dist/shared/components-dhgk6mbt.js +16 -0
  346. package/dist/shared/components-drxrtnp2.js +25 -0
  347. package/dist/shared/{components-6p8tfcd6.js → components-ds9fqat9.js} +21 -18
  348. package/dist/shared/{components-mjthm1kf.js → components-egy4tyjt.js} +11 -8
  349. package/dist/shared/components-f0xfpkhh.js +82 -0
  350. package/dist/shared/components-f7h57m6t.js +59 -0
  351. package/dist/shared/{components-d6xtjht3.js → components-fjkpbg6n.js} +33 -30
  352. package/dist/shared/{components-gc5vtq2f.js → components-gh0qeey3.js} +63 -29
  353. package/dist/shared/{components-39jq9va1.js → components-gvbapfen.js} +29 -24
  354. package/dist/shared/{components-5vgpnxgy.js → components-gzesg7hy.js} +19 -16
  355. package/dist/shared/components-h6p86be3.js +19 -0
  356. package/dist/shared/components-h83az0bz.js +33 -0
  357. package/dist/shared/components-jjrj6ymn.js +104 -0
  358. package/dist/shared/{components-wvp1m52g.js → components-jp5v0m0f.js} +15 -14
  359. package/dist/shared/{components-zrkzcayz.js → components-jqpefjsn.js} +54 -6
  360. package/dist/shared/{components-1z6tdadk.js → components-k74j4hwh.js} +20 -17
  361. package/dist/shared/components-kswxnm3h.js +24 -0
  362. package/dist/shared/{components-jbbmdr74.js → components-mkkbbgb7.js} +36 -17
  363. package/dist/shared/{components-pbmqctfa.js → components-mpw667rb.js} +169 -65
  364. package/dist/shared/{components-s5ngg32c.js → components-paa08427.js} +121 -47
  365. package/dist/shared/{components-vfbhxf5r.js → components-pd42emw3.js} +6 -5
  366. package/dist/shared/{components-hw9yk32z.js → components-pmfszv7a.js} +35 -23
  367. package/dist/shared/{components-chacnk61.js → components-pw06rbxq.js} +19 -19
  368. package/dist/shared/components-q03cktx8.js +246 -0
  369. package/dist/shared/{components-kvr7f9hy.js → components-qdm3yh26.js} +19 -10
  370. package/dist/shared/{components-27nnvrwe.js → components-qs4rkqsj.js} +15 -14
  371. package/dist/shared/{components-s083f38z.js → components-r6gbmkew.js} +22 -21
  372. package/dist/shared/{components-ta7shw28.js → components-r8eqs7gz.js} +4 -4
  373. package/dist/shared/{components-sn1rxx1d.js → components-rm02h9nt.js} +12 -11
  374. package/dist/shared/{components-c6s6b43g.js → components-rrbpmfx4.js} +3 -2
  375. package/dist/shared/{components-n7mjr357.js → components-tz1fv35x.js} +3 -2
  376. package/dist/shared/components-tz4gaf1v.js +23 -0
  377. package/dist/shared/{components-zx6b6yby.js → components-vf45j12c.js} +4 -18
  378. package/dist/shared/{components-3ky44908.js → components-vfjc9jzz.js} +2 -3
  379. package/dist/shared/{components-39vmfq9s.js → components-vsa625vk.js} +21 -20
  380. package/dist/shared/components-wawnmkph.js +500 -0
  381. package/dist/shared/components-wktrrb4m.js +38 -0
  382. package/dist/shared/{components-8snj490h.js → components-wwd363me.js} +78 -32
  383. package/dist/shared/{components-5pnw8183.js → components-xcwvgcrd.js} +23 -22
  384. package/dist/shared/components-xdqmt6ed.js +20 -0
  385. package/dist/shared/{components-h2ajmhwn.js → components-y1w3a6wx.js} +107 -35
  386. package/dist/shared/{components-ar66gnt0.js → components-y6578b8h.js} +37 -34
  387. package/dist/shared/{components-59efxjd9.js → components-yhgq0qxx.js} +13 -12
  388. package/dist/shared/{components-jthe1pwb.js → components-yz84gpkq.js} +101 -404
  389. package/dist/shared/components-z3v0n0de.js +11 -0
  390. package/dist/shared/{components-7r3etddy.js → components-z9n19fyk.js} +19 -54
  391. package/dist/shared/components-zbvjzh1p.js +141 -0
  392. package/dist/styles.css +241 -16
  393. package/dist/tailwind.css +13 -0
  394. package/dist/tokens.css +34 -0
  395. package/index.ts +60 -0
  396. package/lib/date-locale.ts +50 -0
  397. package/lib/field-classes.ts +115 -0
  398. package/lib/field-variants.ts +117 -0
  399. package/lib/fluid-hover-highlight.tsx +139 -0
  400. package/lib/focus-ring.tsx +46 -0
  401. package/lib/goo-indicator.tsx +261 -0
  402. package/lib/icon-context.tsx +310 -0
  403. package/lib/inert.ts +22 -0
  404. package/lib/morph-layers.tsx +102 -0
  405. package/lib/morph-part.tsx +49 -0
  406. package/lib/popup.ts +52 -0
  407. package/lib/reduced-motion.ts +19 -0
  408. package/lib/row-index.tsx +29 -0
  409. package/lib/row-order.tsx +115 -0
  410. package/lib/scroll-column.tsx +244 -0
  411. package/lib/shape-context.tsx +124 -0
  412. package/lib/size-context.tsx +66 -0
  413. package/lib/size-scale.ts +115 -0
  414. package/lib/slot.ts +25 -0
  415. package/lib/springs.ts +62 -0
  416. package/lib/surface-classes.ts +58 -0
  417. package/lib/surface-context.tsx +21 -0
  418. package/lib/use-controllable-state.ts +44 -0
  419. package/lib/use-fluid-hover.ts +541 -0
  420. package/lib/use-is-mobile.ts +25 -0
  421. package/lib/use-keyboard-nav-gate.ts +45 -0
  422. package/lib/use-merge-split.tsx +209 -0
  423. package/lib/use-morph.ts +557 -0
  424. package/lib/use-touch-primary.tsx +43 -0
  425. package/lib/utils.ts +37 -0
  426. package/package.json +177 -4
  427. package/preset.ts +196 -0
  428. package/primitives/code/examples.mdx +27 -0
  429. package/primitives/code/index.tsx +80 -0
  430. package/primitives/craft/demos.tsx +173 -0
  431. package/primitives/craft/examples.mdx +138 -0
  432. package/primitives/craft/index.tsx +76 -0
  433. package/primitives/fluid-hover/examples.mdx +84 -0
  434. package/primitives/fluid-hover/index.tsx +316 -0
  435. package/primitives/morph/examples.mdx +135 -0
  436. package/primitives/morph/index.tsx +192 -0
  437. package/primitives/motion/examples.mdx +100 -0
  438. package/primitives/motion/index.tsx +160 -0
  439. package/primitives/scroll-area/examples.mdx +58 -0
  440. package/primitives/scroll-area/index.tsx +200 -0
  441. package/primitives/separator/examples.mdx +30 -0
  442. package/primitives/separator/index.tsx +53 -0
  443. package/primitives/sizes/examples.mdx +167 -0
  444. package/primitives/sizes/index.tsx +89 -0
  445. package/primitives/skeleton/examples.mdx +51 -0
  446. package/primitives/skeleton/index.tsx +72 -0
  447. package/primitives/skeleton/skeleton.css +15 -0
  448. package/primitives/surface/examples.mdx +173 -0
  449. package/primitives/surface/index.tsx +109 -0
  450. package/primitives/surface/surface.css +176 -0
  451. package/dist/shared/components-0sn7ypjw.js +0 -61
  452. package/dist/shared/components-1434p1mh.js +0 -123
  453. package/dist/shared/components-a86dytt0.js +0 -986
  454. package/dist/shared/components-gf5s6ap9.js +0 -42
  455. package/dist/shared/components-hyq23phv.js +0 -310
  456. package/dist/shared/components-ng72k97e.js +0 -128
  457. package/dist/shared/components-raknhppb.js +0 -64
  458. package/dist/shared/components-vynjtrk6.js +0 -19
  459. package/dist/shared/components-wy9jpqny.js +0 -146
  460. /package/dist/shared/{components-1v7rxytx.js → components-3ey0hzpb.js} +0 -0
  461. /package/dist/shared/{components-ezxhrmer.js → components-jcnjay5g.js} +0 -0
@@ -0,0 +1,862 @@
1
+ // biome-ignore-all lint: vendored upstream code keeps its own patterns (see the header)
2
+ /*
3
+ * Ported from Fluid Functionalism — github.com/mickadesign/fluid-functionalism
4
+ * `registry/base/select.tsx` @ b3587bdbd83fc66c2a6aae3817ffb856cb09260b
5
+ * MIT License © 2026 Micka Touillaud — fluidfunctionalism.com (notice: LICENSE.fluid-functionalism)
6
+ * Local modifications:
7
+ * - `"use client"` dropped; `framer-motion` → `motion/react`; `@/lib/*` and
8
+ * `@/hooks/*` → `../../../lib/*` (`SizeProvider` → `../../../primitives/sizes`);
9
+ * `@/lib/elevated` → `../../../primitives/surface`; `@/components/ui/scroll-area`
10
+ * → `../../../primitives/scroll-area`; `@/components/ui/fluid-hover-highlight` →
11
+ * `../../../lib/fluid-hover-highlight`.
12
+ * - `SelectProps` members re-declared one per line with the FF docs API-table
13
+ * descriptions (modo's props table lists only members declared in the
14
+ * interface body, and drops members whose type spans lines).
15
+ * - Uncontrolled selection was already upstream (`defaultValue` seeds the
16
+ * internal value, `onValueChange` still fires while controlled) — verified,
17
+ * kept as is rather than rerouted through `useControllableState`.
18
+ * - Compound statics `Select.Trigger/.Content/.Item/.Group/.Label/.Separator`
19
+ * attached as expando properties on the root function (TS infers them, so
20
+ * `<Select.Item>` typechecks); upstream's named exports are kept.
21
+ * - modo item: TSDoc + examples from the FF "Select" docs page, and a default
22
+ * export.
23
+ * - Styling reads DS tokens (AGENTS.md styling): `text-[Npx]` →
24
+ * `text-<role>[-compact]`; the hex focus-ring fallback →
25
+ * `ring-focus-ring` / `border-focus-ring`; `duration-80|120|160` and
26
+ * tier-length JS durations → `duration-<tier>` / `spring.*`.
27
+ * - The popup morphs out of its trigger through the shared morph layer
28
+ * (`lib/use-morph.ts` + `MorphSurface`, goo by default on
29
+ * `spring.goo`; `Select.Content` takes `from` / `effect` /
30
+ * `hideSource` / `tier`). The `scaleY` motion wrapper and the `actionsRef`
31
+ * deferred unmount (with its fallback timer) are gone: the morph holds Base
32
+ * UI's unmount itself. The popup paints its level through the morph's
33
+ * surface layers instead of `render={<Elevated/>}`, re-providing the level
34
+ * with `SurfaceProvider` as `Elevated` did.
35
+ * - `effect="morph"` with `hideSource` opens the menu in place over its
36
+ * trigger: the positioner's `sideOffset` becomes the engine's `inPlaceOffset`.
37
+ * - `Select.Item`'s `index` is optional: rows take their place in document
38
+ * order (`lib/row-order.tsx`), inside groups, conditionals and maps alike;
39
+ * the checked row is found by its own index rather than its DOM position.
40
+ * A row's label may be any node (the trigger shows it, through Base UI's
41
+ * `items`), with `textValue` for typeahead.
42
+ * - `Select.Value` (local): the trigger's value slot as a part, so a trigger
43
+ * can take it as children (shadcn's `<SelectValue placeholder>`).
44
+ * - `Select.Content` takes `side` / `align` / `sideOffset` (local).
45
+ * - The keyboard focus ring is the shared `FocusRing` (`lib/focus-ring.tsx`,
46
+ * pinned to the popup's rounded shape), so it also snaps under reduced motion.
47
+ * - `triggerVariants` moved to `variants.ts` (server-callable, no JSX or hooks)
48
+ * and re-exported here.
49
+ */
50
+
51
+ import { Select as SelectPrimitive } from '@base-ui/react/select'
52
+ import type { VariantProps } from 'class-variance-authority'
53
+ import { AnimatePresence, motion } from 'motion/react'
54
+ import {
55
+ Children,
56
+ createContext,
57
+ forwardRef,
58
+ type HTMLAttributes,
59
+ isValidElement,
60
+ type ReactNode,
61
+ useCallback,
62
+ useContext,
63
+ useEffect,
64
+ useImperativeHandle,
65
+ useMemo,
66
+ useRef,
67
+ useState,
68
+ } from 'react'
69
+ import { FluidHoverHighlight } from '../../../lib/fluid-hover-highlight'
70
+ import { FocusRing } from '../../../lib/focus-ring'
71
+ import type { IconComponent } from '../../../lib/icon-context'
72
+ import { MorphSurface } from '../../../lib/morph-layers'
73
+ import { isDisabledRow, popupScrollAreaClass, popupViewportClass } from '../../../lib/popup'
74
+ import { RowOrderContext, useRowOrder, useRowSlot } from '../../../lib/row-order'
75
+ import { shapeMap, useShape } from '../../../lib/shape-context'
76
+ import { type SizeVariant, useSize } from '../../../lib/size-context'
77
+ import { spring } from '../../../lib/springs'
78
+ import { SURFACE_BG, SURFACE_SHADOW } from '../../../lib/surface-classes'
79
+ import { SurfaceProvider, useSurface } from '../../../lib/surface-context'
80
+ import { useFluidHover, useRegisterFluidHoverItem } from '../../../lib/use-fluid-hover'
81
+ import { useKeyboardNavGate } from '../../../lib/use-keyboard-nav-gate'
82
+ import { inPlaceOffset, type MorphOrigin, opensInPlace, useMorph, useMorphOrigin } from '../../../lib/use-morph'
83
+ import { cn } from '../../../lib/utils'
84
+ import { ScrollArea } from '../../../primitives/scroll-area'
85
+ import { SizeProvider } from '../../../primitives/sizes'
86
+ import { triggerVariants } from './variants'
87
+
88
+ // ---------------------------------------------------------------------------
89
+ // Select context
90
+ //
91
+ // Built on Base UI's Select primitive, which owns positioning (collision
92
+ // flipping, anchor tracking), dismissal (outside press, focus-out, Escape
93
+ // nesting inside dialogs), list keyboard navigation + typeahead, combobox
94
+ // ARIA, and the hidden form input. This layer keeps the
95
+ // fluid-hover overlays, the morph open/close animation (lib/use-morph.ts),
96
+ // and the animated checkmark.
97
+ // ---------------------------------------------------------------------------
98
+
99
+ // How long a selection holds the popup open before closing, so the
100
+ // acknowledgment — the checkmark drawing in and the selected background
101
+ // springing to the picked row — is visible instead of being cut off by the
102
+ // ~60ms close fade. Escape and outside presses still close immediately.
103
+ const selectionAckMs = 300
104
+
105
+ interface SelectContextValue {
106
+ value: string
107
+ open: boolean
108
+ origin: React.RefObject<MorphOrigin>
109
+ /** Local: whether the picked row's label is plain text (trimmed and truncated) or a node (laid out as is). */
110
+ textLabel: boolean
111
+ }
112
+
113
+ const SelectContext = createContext<SelectContextValue | null>(null)
114
+
115
+ function useSelectContext() {
116
+ const ctx = useContext(SelectContext)
117
+ if (!ctx) throw new Error('Select compound components must be inside <Select>')
118
+ return ctx
119
+ }
120
+
121
+ // Content context for fluid hover
122
+ interface SelectContentContextValue {
123
+ registerItem: (index: number, element: HTMLElement | null) => void
124
+ activeIndex: number | null
125
+ checkedIndex?: number
126
+ }
127
+
128
+ const SelectContentContext = createContext<SelectContentContextValue | null>(null)
129
+
130
+ // ---------------------------------------------------------------------------
131
+ // Select (root)
132
+ // ---------------------------------------------------------------------------
133
+
134
+ // The trigger follows the global pill/rounded shape; the popup does not.
135
+ // Like Dropdown and Combobox, the list keeps the smaller "rounded" radii
136
+ // whatever the rest of the UI is shaped: pill corners on a popover distort
137
+ // its padding and break the concentric fit of the rows' hover and selection
138
+ // backgrounds inside it.
139
+ const popupShape = shapeMap.rounded
140
+
141
+ /**
142
+ * Walk the children tree collecting `{ value, label }` pairs from SelectItem
143
+ * elements. Passed to Base UI's `items` prop so the trigger can resolve the
144
+ * label of an initial value before the popup has ever mounted (items only
145
+ * render while open). The label is the row's children, whatever node they
146
+ * are; a row with none shows its raw value.
147
+ */
148
+ function collectSelectItems(node: ReactNode, out: { value: string; label: ReactNode }[] = []) {
149
+ Children.forEach(node, child => {
150
+ if (!isValidElement(child)) return
151
+ const props = child.props as { value?: unknown; children?: ReactNode }
152
+ if (typeof props.value === 'string') {
153
+ out.push({
154
+ value: props.value,
155
+ label: props.children ?? props.value,
156
+ })
157
+ } else if (props.children) {
158
+ collectSelectItems(props.children, out)
159
+ }
160
+ })
161
+ return out
162
+ }
163
+
164
+ interface SelectProps {
165
+ /** `Select.Trigger` and `Select.Content`. */
166
+ children: ReactNode
167
+ /** Controlled selected value. Pair with `onValueChange`. */
168
+ value?: string
169
+ /** Uncontrolled default value — the select then keeps the selection itself. */
170
+ defaultValue?: string
171
+ /** Called when the selected value changes. */
172
+ onValueChange?: (value: string) => void
173
+ /** Disables the entire select. Defaults to `false`. */
174
+ disabled?: boolean
175
+ /** Name for form submission (renders a hidden native input). */
176
+ name?: string
177
+ /** Marks the select as required in forms. Defaults to `false`. */
178
+ required?: boolean
179
+ /** Pins trigger and popup to one step of the size ladder (default 36px, compact 28px — see Sizes). Omitted, both follow the surrounding SizeProvider. */
180
+ size?: SizeVariant
181
+ }
182
+
183
+ /**
184
+ * An animated select menu: fluid hover on the rows, a popup that oozes out of
185
+ * its trigger, and a checkmark that draws itself as the selection lands.
186
+ *
187
+ * Built on Base UI's Select — positioning and collision flipping, dismissal,
188
+ * typeahead, combobox ARIA and the hidden form input all come from the
189
+ * primitive. This layer adds the magnetic hover background, the selected
190
+ * background that springs from the old row to the picked one, a keyboard
191
+ * focus ring that only appears once you actually use the keyboard, and the
192
+ * popup's open and close through the shared morph (see Morph), goo by
193
+ * default. A pick holds the popup open for 300ms so that acknowledgment is
194
+ * seen; Escape and outside presses close at once. Uncontrolled through
195
+ * `defaultValue`, controlled through `value` + `onValueChange`.
196
+ *
197
+ * Rows need no `index`: they take their place in document order, inside a
198
+ * `Select.Group` or out of a `map`. The trigger shows the picked row's
199
+ * label, whatever node it is (an icon and text, a badge), and a row's
200
+ * `textValue` is what typeahead matches when its children aren't plain text.
201
+ *
202
+ * Statics:
203
+ * - `Select.Trigger` — the field: `variant`, `icon`, `placeholder`, `error`;
204
+ * children replace its value slot (a `Select.Value`).
205
+ * - `Select.Value` — the value slot: the picked row's label, else the muted
206
+ * `placeholder`.
207
+ * - `Select.Content` — the popup: `side`, `align`, `sideOffset` and the morph
208
+ * options `from`, `effect`, `hideSource`, `tier`.
209
+ * - `Select.Item` — one row: `value`, optional `index`, `textValue`, `icon`,
210
+ * `disabled`; its children are the label.
211
+ * - `Select.Group`, `Select.Label`, `Select.Separator` — sections, their
212
+ * captions and hairlines between them.
213
+ *
214
+ * @example {@include ./examples.mdx}
215
+ */
216
+ function Select({ children, value, defaultValue, onValueChange, disabled = false, name, required, size }: SelectProps) {
217
+ const [internalValue, setInternalValue] = useState(defaultValue ?? '')
218
+ const [open, setOpen] = useState(false)
219
+ const { origin, capture } = useMorphOrigin()
220
+ const currentValue = value !== undefined ? value : internalValue
221
+
222
+ const items = useMemo(() => collectSelectItems(children), [children])
223
+
224
+ const handleValueChange = useCallback(
225
+ (next: string | null) => {
226
+ const v = next ?? ''
227
+ if (value === undefined) setInternalValue(v)
228
+ onValueChange?.(v)
229
+ },
230
+ [value, onValueChange],
231
+ )
232
+
233
+ const ackTimeoutRef = useRef<number | null>(null)
234
+ const cancelAckClose = useCallback(() => {
235
+ if (ackTimeoutRef.current !== null) {
236
+ clearTimeout(ackTimeoutRef.current)
237
+ ackTimeoutRef.current = null
238
+ }
239
+ }, [])
240
+ useEffect(() => cancelAckClose, [cancelAckClose])
241
+
242
+ // Picking an item acknowledges before closing: the close is deferred by
243
+ // selectionAckMs so the checkmark draw and the selected background's spring
244
+ // to the picked row are seen. Every other close reason (Escape, outside
245
+ // press, trigger toggle, focus-out) closes immediately and cancels any
246
+ // pending acknowledgment; re-picking within the window restarts it.
247
+ const handleOpenChange = useCallback(
248
+ (nextOpen: boolean, eventDetails: { reason: string; trigger?: Element; event?: Event }) => {
249
+ if (nextOpen) capture(eventDetails)
250
+ if (!nextOpen && eventDetails.reason === 'item-press') {
251
+ cancelAckClose()
252
+ ackTimeoutRef.current = window.setTimeout(() => {
253
+ ackTimeoutRef.current = null
254
+ setOpen(false)
255
+ }, selectionAckMs)
256
+ return
257
+ }
258
+ cancelAckClose()
259
+ setOpen(nextOpen)
260
+ },
261
+ [cancelAckClose, capture],
262
+ )
263
+
264
+ const picked = items.find(item => item.value === currentValue)?.label
265
+ const textLabel = picked === undefined || typeof picked === 'string' || typeof picked === 'number'
266
+ const ctx = useMemo(() => ({ value: currentValue, open, origin, textLabel }), [currentValue, open, origin, textLabel])
267
+
268
+ // A size prop pins the whole compound (trigger + portalled popup — React
269
+ // context crosses portals) to one step of the ladder.
270
+ const root = (
271
+ <SelectContext.Provider value={ctx}>
272
+ <SelectPrimitive.Root
273
+ // Always controlled; "" (no selection) maps to Base UI's null.
274
+ value={currentValue === '' ? null : currentValue}
275
+ onValueChange={handleValueChange}
276
+ open={open}
277
+ onOpenChange={handleOpenChange}
278
+ items={items}
279
+ disabled={disabled}
280
+ name={name}
281
+ required={required}
282
+ // Non-modal: the page keeps scrolling and the Positioner tracks the
283
+ // anchor, so the popup follows its trigger instead of detaching.
284
+ modal={false}
285
+ >
286
+ {children}
287
+ </SelectPrimitive.Root>
288
+ </SelectContext.Provider>
289
+ )
290
+
291
+ return size ? <SizeProvider size={size}>{root}</SizeProvider> : root
292
+ }
293
+
294
+ Select.displayName = 'Select'
295
+
296
+ // ---------------------------------------------------------------------------
297
+ // SelectValue
298
+ // ---------------------------------------------------------------------------
299
+
300
+ interface SelectValueProps {
301
+ /** Shown, muted, while nothing is selected. Defaults to `"Select…"`. */
302
+ placeholder?: ReactNode
303
+ /** Extra classes for the value text. */
304
+ className?: string
305
+ }
306
+
307
+ /** The trigger's value slot: the picked row's label (its children), else the muted placeholder. */
308
+ function SelectValue({ placeholder = 'Select…', className }: SelectValueProps) {
309
+ const { textLabel } = useSelectContext()
310
+ return (
311
+ <SelectPrimitive.Value
312
+ placeholder={placeholder}
313
+ // py-1/-my-1: truncate's overflow:hidden clips at the padding
314
+ // box, and the trimmed box excludes ascenders/descenders — the
315
+ // padding gives glyphs room while the negative margin keeps the
316
+ // trimmed layout box.
317
+ className={cn(
318
+ 'min-w-0 flex-1 text-left data-[placeholder]:text-muted-foreground',
319
+ // A node label (a badge, an icon and text) keeps its own box: trimming
320
+ // and clipping it would cut it top and bottom.
321
+ textLabel ? 'truncate [text-box:trim-both_cap_alphabetic] py-1 -my-1' : 'flex items-center',
322
+ className,
323
+ )}
324
+ />
325
+ )
326
+ }
327
+
328
+ SelectValue.displayName = 'SelectValue'
329
+
330
+ // ---------------------------------------------------------------------------
331
+ // SelectTrigger
332
+ // ---------------------------------------------------------------------------
333
+
334
+ interface SelectTriggerProps
335
+ extends Omit<HTMLAttributes<HTMLButtonElement>, 'children'>,
336
+ VariantProps<typeof triggerVariants> {
337
+ /** Replaces the built-in value slot, typically with a `Select.Value` (shadcn's `<SelectValue placeholder>`). The icon and chevron stay. */
338
+ children?: ReactNode
339
+ /** Visual style of the trigger. Defaults to `"bordered"`. */
340
+ variant?: 'bordered' | 'borderless'
341
+ /** Optional icon displayed before the value. */
342
+ icon?: IconComponent
343
+ /** Text shown when no value is selected. Defaults to `"Select…"`. */
344
+ placeholder?: string
345
+ /** Error message shown below the trigger; also tints the border and sets `aria-invalid`. */
346
+ error?: string
347
+ /** Size override for the trigger alone. Prefer the `size` prop on `<Select>` (or a surrounding SizeProvider) so the popup matches. */
348
+ size?: SizeVariant
349
+ /** Extra classes for the trigger button. */
350
+ className?: string
351
+ }
352
+
353
+ const SelectTrigger = forwardRef<HTMLButtonElement, SelectTriggerProps>(
354
+ ({ className, variant, icon: Icon, placeholder = 'Select…', error, size, children, ...props }, ref) => {
355
+ const shape = useShape()
356
+ const sizeClasses = useSize(size)
357
+ const compact = sizeClasses.variant === 'compact'
358
+
359
+ return (
360
+ <div className="flex flex-col gap-1">
361
+ <SelectPrimitive.Trigger
362
+ ref={ref}
363
+ aria-invalid={!!error || undefined}
364
+ className={cn(
365
+ triggerVariants({ variant }),
366
+ sizeClasses.control,
367
+ sizeClasses.text,
368
+ sizeClasses.px,
369
+ sizeClasses.gap,
370
+ compact ? 'min-w-[128px]' : 'min-w-[160px]',
371
+ shape.input,
372
+ error && 'border-destructive/50 hover:border-destructive/50',
373
+ className,
374
+ )}
375
+ {...props}
376
+ >
377
+ <span className={cn('flex items-center min-w-0 flex-1', sizeClasses.gap)}>
378
+ {Icon && (
379
+ <Icon
380
+ size={sizeClasses.icon}
381
+ strokeWidth={1.5}
382
+ className="shrink-0 text-muted-foreground transition-[color,stroke-width] duration-fast group-hover:text-foreground group-hover:stroke-[2]"
383
+ />
384
+ )}
385
+ {children ?? <SelectValue placeholder={placeholder} />}
386
+ </span>
387
+
388
+ <svg
389
+ width={sizeClasses.icon}
390
+ height={sizeClasses.icon}
391
+ viewBox="0 0 24 24"
392
+ fill="none"
393
+ stroke="currentColor"
394
+ strokeWidth={2}
395
+ strokeLinecap="round"
396
+ strokeLinejoin="round"
397
+ className="shrink-0 text-muted-foreground transition-colors duration-fast group-hover:text-foreground"
398
+ >
399
+ <path d="M6 9l6 6 6-6" />
400
+ </svg>
401
+ </SelectPrimitive.Trigger>
402
+ {error && <span className="text-caption text-destructive pl-3">{error}</span>}
403
+ </div>
404
+ )
405
+ },
406
+ )
407
+
408
+ SelectTrigger.displayName = 'SelectTrigger'
409
+
410
+ // ---------------------------------------------------------------------------
411
+ // SelectContent
412
+ // ---------------------------------------------------------------------------
413
+
414
+ interface SelectContentProps {
415
+ /** Where the menu grows from (see Morph): the trigger, the pointer, its own center, a viewport edge, or a ref to any element. Defaults to `'trigger'`. */
416
+ from?: 'trigger' | 'pointer' | 'center' | 'top' | 'right' | 'bottom' | 'left' | React.RefObject<HTMLElement | null>
417
+ /** How it grows (see Morph): with the liquid goo neck, a plain morph, a slide or a fade. Defaults to `'goo'`. */
418
+ effect?: 'goo' | 'morph' | 'slide' | 'fade'
419
+ /** Hide the trigger while open, so it reads as turning into the menu. Defaults to `false`. */
420
+ hideSource?: boolean
421
+ /** Spring tier of a plain morph, slide or fade; goo runs on its own `spring.goo`. Defaults to `'moderate'`. */
422
+ tier?: 'moderate' | 'slow'
423
+ /** Side of the trigger the menu prefers; it flips when there is no room. Defaults to `"bottom"`. */
424
+ side?: 'top' | 'bottom' | 'left' | 'right'
425
+ /** Alignment against the trigger. Defaults to `"start"`. */
426
+ align?: 'start' | 'center' | 'end'
427
+ /** Gap to the trigger, in px. Ignored when the menu opens in place over the trigger (`effect="morph"` with `hideSource`). Defaults to `6`. */
428
+ sideOffset?: number
429
+ /** Additional classes for the menu container. */
430
+ className?: string
431
+ /** `Select.Item`, `Select.Group`, `Select.Label`, `Select.Separator`. */
432
+ children: ReactNode
433
+ }
434
+
435
+ const SelectContent = forwardRef<HTMLDivElement, SelectContentProps>(
436
+ (
437
+ {
438
+ from,
439
+ effect,
440
+ hideSource,
441
+ tier = 'moderate',
442
+ side = 'bottom',
443
+ align = 'start',
444
+ sideOffset = 6,
445
+ className,
446
+ children,
447
+ },
448
+ ref,
449
+ ) => {
450
+ const { open, value, origin } = useSelectContext()
451
+ const rowOrder = useRowOrder()
452
+ const morph = useMorph(open, origin, { from, effect, hideSource, tier })
453
+ useImperativeHandle(ref, () => morph.popup as HTMLDivElement, [morph.popup])
454
+ // Lifts 2 levels off its substrate with a fixed shadow (see Elevated).
455
+ const level = Math.min(useSurface() + 2, 8)
456
+ const shape = popupShape
457
+ const containerRef = useRef<HTMLDivElement>(null)
458
+
459
+ const hover = useFluidHover(containerRef, { isItemDisabled: isDisabledRow })
460
+ const { activeIndex, setActiveIndex, itemRects, isMeasured, handlers, registerItem, remeasure } = hover
461
+
462
+ const [focusedIndex, setFocusedIndex] = useState<number | null>(null)
463
+
464
+ // Keyboard focus ring gate: seeded from the trigger's :focus-visible at
465
+ // open, earned by navigation keys inside the popup.
466
+ const { keyboardNavRef, trackKeyboardNav } = useKeyboardNavGate(open)
467
+ const [checkedIndex, setCheckedIndex] = useState<number | undefined>(undefined)
468
+
469
+ // Fresh rects once per open. Measuring is the hook's job — it owns the
470
+ // one coalesced pass that item registration and container resizes both
471
+ // feed into, and a second pass from elsewhere is what used to land a
472
+ // corrected rect on an already-mounted overlay. The popup keeps its items
473
+ // registered while it sits hidden between opens, so registration alone
474
+ // would never trigger a fresh pass on reopen.
475
+ useEffect(() => {
476
+ if (!open) return
477
+ remeasure()
478
+ }, [open, remeasure])
479
+
480
+ // Detect the checked row. Deliberately does NOT remeasure on a value
481
+ // change while open: the rows haven't moved, so the published rects stay
482
+ // trustworthy and only checkedIndex switches — which lets the selected
483
+ // marker spring from the old row to the picked one (the selection
484
+ // acknowledgment) instead of unmounting and snapping.
485
+ useEffect(() => {
486
+ if (!open) return
487
+ // Double rAF: first waits for React commit, second for layout
488
+ let inner: number
489
+ const outer = requestAnimationFrame(() => {
490
+ inner = requestAnimationFrame(() => {
491
+ const container = containerRef.current
492
+ if (container) {
493
+ // The row's own index: rows may be numbered out of DOM order (an explicit `index`).
494
+ const row = Array.from(container.querySelectorAll<HTMLElement>('[data-fluid-hover-index]')).find(
495
+ el => el.getAttribute('data-value') === value,
496
+ )
497
+ setCheckedIndex(row ? Number(row.getAttribute('data-fluid-hover-index')) : undefined)
498
+ }
499
+ })
500
+ })
501
+ return () => {
502
+ cancelAnimationFrame(outer)
503
+ cancelAnimationFrame(inner)
504
+ }
505
+ }, [open, value])
506
+
507
+ // Reset every overlay index as the close begins. checkedIndex otherwise
508
+ // lags one open behind value (picking an item closes the popup before the
509
+ // effect above re-syncs it), and a leftover activeIndex is worse: Base UI
510
+ // keeps the popup mounted through the exit tween, so on reopen the hover
511
+ // pill would still be sitting on the previously active row and spring from
512
+ // there to the row that auto-focus lands on.
513
+ useEffect(() => {
514
+ if (open) return
515
+ setCheckedIndex(undefined)
516
+ setActiveIndex(null)
517
+ setFocusedIndex(null)
518
+ }, [open, setActiveIndex])
519
+
520
+ // Overlays read rects only once the hook reports the item set fully
521
+ // measured. Positioning one from an incomplete pass mounts it at the wrong
522
+ // row, and the correcting pass then springs it across the list.
523
+ const checkedRect = isMeasured && checkedIndex != null ? itemRects[checkedIndex] : null
524
+ const focusRect = isMeasured && focusedIndex !== null ? itemRects[focusedIndex] : null
525
+
526
+ const contentCtx = useMemo(
527
+ () => ({ registerItem, activeIndex, checkedIndex }),
528
+ [registerItem, activeIndex, checkedIndex],
529
+ )
530
+
531
+ return (
532
+ <SelectPrimitive.Portal>
533
+ <SelectPrimitive.Positioner
534
+ side={side}
535
+ align={align}
536
+ sideOffset={opensInPlace({ effect, hideSource }) ? inPlaceOffset : sideOffset}
537
+ alignItemWithTrigger={false}
538
+ className="z-50 outline-none"
539
+ >
540
+ <SelectContentContext.Provider value={contentCtx}>
541
+ <SelectPrimitive.Popup
542
+ ref={morph.popupRef}
543
+ // Capture phase: the primitive moves focus during its own keydown
544
+ // handling, so the nav flag must be set before then.
545
+ onKeyDownCapture={trackKeyboardNav}
546
+ onMouseEnter={() => {
547
+ handlers.onMouseEnter()
548
+ setFocusedIndex(null)
549
+ }}
550
+ onMouseMove={handlers.onMouseMove}
551
+ onMouseLeave={handlers.onMouseLeave}
552
+ onClick={handlers.onClick}
553
+ onFocus={e => {
554
+ const indexAttr = (e.target as HTMLElement)
555
+ .closest('[data-fluid-hover-index]')
556
+ ?.getAttribute('data-fluid-hover-index')
557
+ if (indexAttr != null) {
558
+ const idx = Number(indexAttr)
559
+ setActiveIndex(idx)
560
+ setFocusedIndex(
561
+ keyboardNavRef.current && (e.target as HTMLElement).matches(':focus-visible') ? idx : null,
562
+ )
563
+ }
564
+ }}
565
+ onBlur={e => {
566
+ // The popup itself takes focus when the pointer leaves a row; only a
567
+ // departure from the whole popup ends the hover session.
568
+ if (e.currentTarget.contains(e.relatedTarget as Node)) return
569
+ setFocusedIndex(null)
570
+ setActiveIndex(null)
571
+ }}
572
+ className="relative select-none outline-none"
573
+ >
574
+ <SurfaceProvider value={level}>
575
+ <MorphSurface
576
+ morph={morph}
577
+ bg={SURFACE_BG[level]}
578
+ shadow={SURFACE_SHADOW[3]}
579
+ radius={shape.container}
580
+ className={cn(
581
+ // min-w tracks the trigger via the Positioner's --anchor-width
582
+ // var, matching the pre-migration minWidth: triggerRect.width.
583
+ `flex flex-col min-w-[var(--anchor-width)] max-h-[min(300px,var(--available-height))] overflow-hidden ${shape.container}`,
584
+ className,
585
+ )}
586
+ >
587
+ {/* The list scrolls inside a ScrollArea; this wrapper is the rows'
588
+ offsetParent, so the overlays scroll with them. */}
589
+ <ScrollArea
590
+ className={popupScrollAreaClass}
591
+ viewportClassName={cn(popupViewportClass, 'scroll-fade')}
592
+ >
593
+ <div ref={containerRef} className="relative flex flex-col p-1">
594
+ {/* The three overlays are torn down as the close begins rather
595
+ than exit-animated, because an overlay still mounted when the
596
+ popup reopens is one AnimatePresence re-adopts under its old
597
+ key: `initial` never runs again, so it keeps the position of the
598
+ row it had before and animates from there to the new one. The
599
+ popup's own fade covers their disappearance. */}
600
+ {/* Selected background */}
601
+ {open && (
602
+ <AnimatePresence>
603
+ {checkedRect && (
604
+ <motion.div
605
+ className={`absolute ${shape.bg} bg-active pointer-events-none`}
606
+ // Position lives in `animate` so an in-session value
607
+ // change springs the marker to the picked row (the
608
+ // selection acknowledgment). Safe against the reopen
609
+ // slide: the `open &&` teardown means no marker
610
+ // survives a close, and a fresh mount with
611
+ // initial={false} renders snapped at these values.
612
+ initial={false}
613
+ animate={{
614
+ top: checkedRect.top,
615
+ left: checkedRect.left,
616
+ width: checkedRect.width,
617
+ height: checkedRect.height,
618
+ opacity: 1,
619
+ }}
620
+ exit={{ opacity: 0, transition: spring.moderate.exit }}
621
+ transition={{
622
+ ...spring.moderate,
623
+ opacity: { duration: spring.fast.duration },
624
+ }}
625
+ />
626
+ )}
627
+ </AnimatePresence>
628
+ )}
629
+
630
+ {/* Hover background */}
631
+ <FluidHoverHighlight hover={hover} hidden={!open} className={shape.bg} />
632
+
633
+ {/* Focus ring */}
634
+ {open && <FocusRing rect={focusRect} shape="rounded" />}
635
+
636
+ <RowOrderContext.Provider value={rowOrder}>{children}</RowOrderContext.Provider>
637
+ </div>
638
+ </ScrollArea>
639
+ </MorphSurface>
640
+ </SurfaceProvider>
641
+ </SelectPrimitive.Popup>
642
+ </SelectContentContext.Provider>
643
+ </SelectPrimitive.Positioner>
644
+ </SelectPrimitive.Portal>
645
+ )
646
+ },
647
+ )
648
+
649
+ SelectContent.displayName = 'SelectContent'
650
+
651
+ // ---------------------------------------------------------------------------
652
+ // SelectItem
653
+ // ---------------------------------------------------------------------------
654
+
655
+ interface SelectItemProps extends HTMLAttributes<HTMLDivElement> {
656
+ /** Optional icon displayed before the label. */
657
+ icon?: IconComponent
658
+ /** Position among the menu's rows — what fluid hover measures rows by. Defaults to the row's place in document order. */
659
+ index?: number
660
+ /** Unique value for this option. */
661
+ value: string
662
+ /** The row's text for typeahead, when its children are not a plain string. */
663
+ textValue?: string
664
+ /** Disables this individual item. Defaults to `false`. */
665
+ disabled?: boolean
666
+ /** The row label. A string label is also what the trigger shows for this value. */
667
+ children?: ReactNode
668
+ }
669
+
670
+ const SelectItem = forwardRef<HTMLDivElement, SelectItemProps>(
671
+ ({ className, children, icon: Icon, value, index: indexProp, textValue, disabled = false, ...props }, ref) => {
672
+ const selectCtx = useSelectContext()
673
+ const contentCtx = useContext(SelectContentContext)
674
+ const internalRef = useRef<HTMLDivElement>(null)
675
+ const shape = popupShape
676
+ const sizeClasses = useSize()
677
+ const compact = sizeClasses.variant === 'compact'
678
+ const hasMounted = useRef(false)
679
+
680
+ useEffect(() => {
681
+ hasMounted.current = true
682
+ }, [])
683
+
684
+ // Register with fluid hover. Depends on the (stable) registerItem
685
+ // rather than the content context, which is rebuilt on every activeIndex
686
+ // change: keying the effect to the whole context re-ran it per mousemove,
687
+ // unregistering and re-registering every row and so keeping the hook's
688
+ // measurement permanently unsettled while the pointer moved.
689
+ const registerItem = contentCtx?.registerItem
690
+ const { index } = useRowSlot(internalRef, indexProp)
691
+ useRegisterFluidHoverItem(registerItem, index, internalRef)
692
+
693
+ const isActive = contentCtx?.activeIndex === index
694
+ const isChecked = selectCtx.value === value
695
+ const skipAnimation = !hasMounted.current
696
+
697
+ return (
698
+ <SelectPrimitive.Item
699
+ value={value}
700
+ disabled={disabled}
701
+ label={textValue ?? (typeof children === 'string' ? children : undefined)}
702
+ render={
703
+ <div
704
+ ref={(node: HTMLDivElement | null) => {
705
+ ;(internalRef as React.MutableRefObject<HTMLDivElement | null>).current = node
706
+ if (typeof ref === 'function') ref(node)
707
+ else if (ref) (ref as React.MutableRefObject<HTMLDivElement | null>).current = node
708
+ }}
709
+ data-fluid-hover-index={index}
710
+ data-value={value}
711
+ className={cn(
712
+ // Fixed height (was py-2 around a 19.5px line box ≈ 35.5px) so
713
+ // the text-box trim on the item text doesn't shrink the row.
714
+ // shrink-0: the popup is a max-height flex column, so without it
715
+ // a long list compresses rows to fit instead of scrolling.
716
+ `relative z-10 flex ${sizeClasses.control} shrink-0 items-center ${sizeClasses.gap} ${shape.item} ${sizeClasses.itemPx} ${sizeClasses.text} cursor-pointer outline-none select-none`,
717
+ 'transition-[color] duration-fast',
718
+ isActive || isChecked ? 'text-foreground' : 'text-muted-foreground',
719
+ disabled && 'opacity-50 pointer-events-none',
720
+ className,
721
+ )}
722
+ {...props}
723
+ />
724
+ }
725
+ >
726
+ {Icon && (
727
+ <Icon
728
+ size={sizeClasses.icon}
729
+ strokeWidth={isActive || isChecked ? 2 : 1.5}
730
+ className="shrink-0 transition-[color,stroke-width] duration-fast"
731
+ />
732
+ )}
733
+
734
+ <SelectPrimitive.ItemText
735
+ // py-1/-my-1 keeps truncate's overflow:hidden from clipping
736
+ // ascenders/descenders outside the trimmed box.
737
+ render={
738
+ <span
739
+ className={cn(
740
+ 'flex-1 min-w-0',
741
+ // Nodes keep their own box; only text is trimmed and truncated.
742
+ typeof children === 'string' || typeof children === 'number'
743
+ ? 'truncate [text-box:trim-both_cap_alphabetic] py-1 -my-1'
744
+ : 'flex items-center',
745
+ )}
746
+ />
747
+ }
748
+ >
749
+ {children}
750
+ </SelectPrimitive.ItemText>
751
+
752
+ {/* Always-rendered fixed slot so the check appearing/disappearing
753
+ never changes the row's intrinsic width — without it the whole
754
+ popup resizes when a selection lands. */}
755
+ <span aria-hidden className={cn('shrink-0', compact ? 'w-3.5 h-3.5' : 'w-4 h-4')}>
756
+ <AnimatePresence>
757
+ {isChecked && (
758
+ <motion.svg
759
+ key="check"
760
+ width={sizeClasses.icon}
761
+ height={sizeClasses.icon}
762
+ viewBox="0 0 24 24"
763
+ fill="none"
764
+ stroke="currentColor"
765
+ strokeWidth={2}
766
+ strokeLinecap="round"
767
+ strokeLinejoin="round"
768
+ className="text-foreground"
769
+ initial={{ opacity: 1 }}
770
+ animate={{ opacity: 1 }}
771
+ exit={{ opacity: 1 }}
772
+ >
773
+ <motion.path
774
+ d="M4 12L9 17L20 6"
775
+ initial={{ pathLength: skipAnimation ? 1 : 0 }}
776
+ animate={{
777
+ pathLength: 1,
778
+ transition: { duration: spring.fast.duration, ease: 'easeOut' },
779
+ }}
780
+ exit={{
781
+ pathLength: 0,
782
+ transition: { duration: 0.04, ease: 'easeIn' },
783
+ }}
784
+ />
785
+ </motion.svg>
786
+ )}
787
+ </AnimatePresence>
788
+ </span>
789
+ </SelectPrimitive.Item>
790
+ )
791
+ },
792
+ )
793
+
794
+ SelectItem.displayName = 'SelectItem'
795
+
796
+ // ---------------------------------------------------------------------------
797
+ // SelectGroup + SelectLabel + SelectSeparator
798
+ // ---------------------------------------------------------------------------
799
+
800
+ function SelectGroup({ children, className, ...props }: HTMLAttributes<HTMLDivElement>) {
801
+ return (
802
+ <div role="group" className={className} {...props}>
803
+ {children}
804
+ </div>
805
+ )
806
+ }
807
+
808
+ SelectGroup.displayName = 'SelectGroup'
809
+
810
+ const SelectLabel = forwardRef<HTMLDivElement, HTMLAttributes<HTMLDivElement>>(({ className, ...props }, ref) => {
811
+ // Group labels are the caption role of the type scale — see /docs/sizes.
812
+ const compact = useSize().variant === 'compact'
813
+ return (
814
+ <div
815
+ ref={ref}
816
+ className={cn(
817
+ 'px-2 py-1.5 shrink-0 text-muted-foreground',
818
+ compact ? 'text-caption-compact' : 'text-caption',
819
+ className,
820
+ )}
821
+ {...props}
822
+ />
823
+ )
824
+ })
825
+
826
+ SelectLabel.displayName = 'SelectLabel'
827
+
828
+ const SelectSeparator = forwardRef<HTMLDivElement, HTMLAttributes<HTMLDivElement>>(({ className, ...props }, ref) => (
829
+ <div ref={ref} role="separator" className={cn('my-1 -mx-1 h-px shrink-0 bg-border/60', className)} {...props} />
830
+ ))
831
+
832
+ SelectSeparator.displayName = 'SelectSeparator'
833
+
834
+ // Compound statics: `<Select.Trigger>`, `<Select.Item>`, … Assigned directly
835
+ // (not through Object.assign) so TypeScript's expando inference types them
836
+ // onto the root function declaration.
837
+ Select.Trigger = SelectTrigger
838
+ Select.Value = SelectValue
839
+ Select.Content = SelectContent
840
+ Select.Item = SelectItem
841
+ Select.Group = SelectGroup
842
+ Select.Label = SelectLabel
843
+ Select.Separator = SelectSeparator
844
+
845
+ // ---------------------------------------------------------------------------
846
+ // Exports
847
+ // ---------------------------------------------------------------------------
848
+
849
+ export type { SelectContentProps, SelectItemProps, SelectProps, SelectTriggerProps, SelectValueProps }
850
+ export {
851
+ Select,
852
+ SelectContent,
853
+ SelectGroup,
854
+ SelectItem,
855
+ SelectLabel,
856
+ SelectSeparator,
857
+ SelectTrigger,
858
+ SelectValue,
859
+ triggerVariants,
860
+ }
861
+
862
+ export default Select