@jcsoftdev/ui 0.3.0 → 0.5.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 (383) hide show
  1. package/CHANGELOG.md +200 -1
  2. package/README.md +56 -3
  3. package/bin/ui-theme.mjs +13 -2
  4. package/dist/atoms/button/button.d.ts +8 -1
  5. package/dist/atoms/button/button.js +10 -3
  6. package/dist/atoms/checkbox/checkbox.js +3 -1
  7. package/dist/atoms/chip/chip.d.ts +11 -3
  8. package/dist/atoms/chip/chip.js +8 -1
  9. package/dist/atoms/chip/index.d.ts +1 -1
  10. package/dist/atoms/chip/index.js +2 -0
  11. package/dist/atoms/divider/divider.d.ts +15 -0
  12. package/dist/atoms/divider/divider.js +27 -0
  13. package/dist/atoms/divider/index.d.ts +1 -0
  14. package/dist/atoms/divider/index.js +1 -0
  15. package/dist/atoms/due-chip/due-chip.d.ts +31 -0
  16. package/dist/atoms/due-chip/due-chip.js +41 -0
  17. package/dist/atoms/due-chip/index.d.ts +2 -0
  18. package/dist/atoms/due-chip/index.js +6 -0
  19. package/dist/atoms/due-chip/model.d.ts +25 -0
  20. package/dist/atoms/due-chip/model.js +44 -0
  21. package/dist/atoms/icon-button/icon-button.d.ts +22 -0
  22. package/dist/atoms/icon-button/icon-button.js +38 -0
  23. package/dist/atoms/icon-button/index.d.ts +1 -0
  24. package/dist/atoms/icon-button/index.js +8 -0
  25. package/dist/atoms/index.d.ts +6 -0
  26. package/dist/atoms/index.js +6 -0
  27. package/dist/atoms/internal/hit-area.d.ts +6 -0
  28. package/dist/atoms/internal/hit-area.js +4 -0
  29. package/dist/atoms/kbd/index.d.ts +1 -0
  30. package/dist/atoms/kbd/index.js +4 -0
  31. package/dist/atoms/kbd/kbd.d.ts +7 -0
  32. package/dist/atoms/kbd/kbd.js +17 -0
  33. package/dist/atoms/radio-group/radio-group.js +6 -2
  34. package/dist/atoms/seal/index.d.ts +1 -0
  35. package/dist/atoms/seal/index.js +4 -0
  36. package/dist/atoms/seal/seal.d.ts +30 -0
  37. package/dist/atoms/seal/seal.js +71 -0
  38. package/dist/atoms/spinner/index.d.ts +1 -0
  39. package/dist/atoms/spinner/index.js +5 -0
  40. package/dist/atoms/spinner/spinner.d.ts +19 -0
  41. package/dist/atoms/spinner/spinner.js +31 -0
  42. package/dist/atoms/switch/switch.js +3 -1
  43. package/dist/auth/auth-illustration/auth-illustration.d.ts +35 -0
  44. package/dist/auth/auth-illustration/auth-illustration.js +72 -0
  45. package/dist/auth/auth-illustration/index.d.ts +3 -0
  46. package/dist/auth/auth-illustration/index.js +11 -0
  47. package/dist/auth/auth-illustration/look.d.ts +30 -0
  48. package/dist/auth/auth-illustration/look.js +0 -0
  49. package/dist/auth/auth-illustration/model.d.ts +133 -0
  50. package/dist/auth/auth-illustration/model.js +202 -0
  51. package/dist/auth/auth-illustration/use-art-pointer.d.ts +9 -0
  52. package/dist/auth/auth-illustration/use-art-pointer.js +69 -0
  53. package/dist/auth/auth-layout/auth-layout.d.ts +80 -0
  54. package/dist/auth/auth-layout/auth-layout.js +190 -0
  55. package/dist/auth/auth-layout/index.d.ts +1 -0
  56. package/dist/auth/auth-layout/index.js +1 -0
  57. package/dist/auth/character/character.d.ts +12 -0
  58. package/dist/auth/character/character.js +333 -0
  59. package/dist/auth/character/index.d.ts +1 -0
  60. package/dist/auth/character/index.js +1 -0
  61. package/dist/auth/index.d.ts +4 -0
  62. package/dist/auth/index.js +4 -0
  63. package/dist/auth/internal/auth-context.d.ts +17 -0
  64. package/dist/auth/internal/auth-context.js +10 -0
  65. package/dist/auth/internal/auth-styles.d.ts +1 -0
  66. package/dist/auth/internal/auth-styles.js +29 -0
  67. package/dist/auth/internal/portal-glyphs.d.ts +6 -0
  68. package/dist/auth/internal/portal-glyphs.js +39 -0
  69. package/dist/auth/login-form/context.d.ts +51 -0
  70. package/dist/auth/login-form/context.js +12 -0
  71. package/dist/auth/login-form/index.d.ts +2 -0
  72. package/dist/auth/login-form/index.js +23 -0
  73. package/dist/auth/login-form/login-form.d.ts +66 -0
  74. package/dist/auth/login-form/login-form.js +233 -0
  75. package/dist/auth/login-form/parts.d.ts +71 -0
  76. package/dist/auth/login-form/parts.js +371 -0
  77. package/dist/auth/looks/auth-illustration-any.d.ts +16 -0
  78. package/dist/auth/looks/auth-illustration-any.js +24 -0
  79. package/dist/auth/looks/index.d.ts +1 -0
  80. package/dist/auth/looks/index.js +1 -0
  81. package/dist/auth/mosaic/index.d.ts +1 -0
  82. package/dist/auth/mosaic/index.js +1 -0
  83. package/dist/auth/mosaic/mosaic.d.ts +11 -0
  84. package/dist/auth/mosaic/mosaic.js +195 -0
  85. package/dist/auth/slabs/index.d.ts +1 -0
  86. package/dist/auth/slabs/index.js +1 -0
  87. package/dist/auth/slabs/slabs.d.ts +13 -0
  88. package/dist/auth/slabs/slabs.js +136 -0
  89. package/dist/auth/stack/index.d.ts +1 -0
  90. package/dist/auth/stack/index.js +1 -0
  91. package/dist/auth/stack/stack.d.ts +6 -0
  92. package/dist/auth/stack/stack.js +222 -0
  93. package/dist/auth/statement/index.d.ts +1 -0
  94. package/dist/auth/statement/index.js +1 -0
  95. package/dist/auth/statement/statement.d.ts +13 -0
  96. package/dist/auth/statement/statement.js +99 -0
  97. package/dist/calendar/date-calendar/date-calendar.d.ts +32 -0
  98. package/dist/calendar/date-calendar/date-calendar.js +189 -0
  99. package/dist/calendar/date-calendar/index.d.ts +1 -0
  100. package/dist/calendar/date-calendar/index.js +6 -0
  101. package/dist/calendar/index.d.ts +1 -0
  102. package/dist/calendar/index.js +1 -0
  103. package/dist/calendar/internal/date-utils.d.ts +26 -0
  104. package/dist/calendar/internal/date-utils.js +95 -1
  105. package/dist/containers/aside/aside.d.ts +14 -0
  106. package/dist/containers/aside/aside.js +25 -0
  107. package/dist/containers/aside/index.d.ts +1 -0
  108. package/dist/containers/aside/index.js +5 -0
  109. package/dist/containers/banner/banner.d.ts +4 -1
  110. package/dist/containers/banner/banner.js +9 -1
  111. package/dist/containers/description-list/description-list.d.ts +29 -6
  112. package/dist/containers/description-list/description-list.js +47 -6
  113. package/dist/containers/feed/feed.d.ts +23 -0
  114. package/dist/containers/feed/feed.js +77 -0
  115. package/dist/containers/feed/index.d.ts +2 -0
  116. package/dist/containers/feed/index.js +10 -0
  117. package/dist/containers/feed/model.d.ts +19 -0
  118. package/dist/containers/feed/model.js +38 -0
  119. package/dist/containers/index.d.ts +6 -0
  120. package/dist/containers/index.js +6 -0
  121. package/dist/containers/kpi/kpi.d.ts +50 -8
  122. package/dist/containers/kpi/kpi.js +91 -39
  123. package/dist/containers/list-detail/index.d.ts +1 -0
  124. package/dist/containers/list-detail/index.js +20 -0
  125. package/dist/containers/list-detail/list-detail.d.ts +55 -0
  126. package/dist/containers/list-detail/list-detail.js +221 -0
  127. package/dist/containers/note/index.d.ts +1 -0
  128. package/dist/containers/note/index.js +4 -0
  129. package/dist/containers/note/note.d.ts +13 -0
  130. package/dist/containers/note/note.js +27 -0
  131. package/dist/containers/section/index.d.ts +1 -0
  132. package/dist/containers/section/index.js +6 -0
  133. package/dist/containers/section/section.d.ts +68 -0
  134. package/dist/containers/section/section.js +198 -0
  135. package/dist/containers/shortcuts/index.d.ts +1 -0
  136. package/dist/containers/shortcuts/index.js +8 -0
  137. package/dist/containers/shortcuts/shortcuts.d.ts +18 -0
  138. package/dist/containers/shortcuts/shortcuts.js +50 -0
  139. package/dist/containers/table/selection.d.ts +9 -0
  140. package/dist/containers/table/selection.js +20 -0
  141. package/dist/containers/table/table.d.ts +66 -4
  142. package/dist/containers/table/table.js +128 -7
  143. package/dist/containers/timeline/index.d.ts +1 -1
  144. package/dist/containers/timeline/index.js +4 -2
  145. package/dist/containers/timeline/timeline.d.ts +32 -5
  146. package/dist/containers/timeline/timeline.js +154 -90
  147. package/dist/forms/chip-group/chip-group.d.ts +54 -0
  148. package/dist/forms/chip-group/chip-group.js +114 -0
  149. package/dist/forms/chip-group/index.d.ts +1 -0
  150. package/dist/forms/chip-group/index.js +6 -0
  151. package/dist/forms/combobox/combobox.d.ts +60 -0
  152. package/dist/forms/combobox/combobox.js +281 -0
  153. package/dist/forms/combobox/index.d.ts +1 -0
  154. package/dist/forms/combobox/index.js +6 -0
  155. package/dist/forms/date-picker/date-picker.d.ts +40 -0
  156. package/dist/forms/date-picker/date-picker.js +183 -0
  157. package/dist/forms/date-picker/date-time-picker.d.ts +43 -0
  158. package/dist/forms/date-picker/date-time-picker.js +121 -0
  159. package/dist/forms/date-picker/index.d.ts +2 -0
  160. package/dist/forms/date-picker/index.js +10 -0
  161. package/dist/forms/date-picker/model.d.ts +35 -0
  162. package/dist/forms/date-picker/model.js +83 -0
  163. package/dist/forms/dropzone/dropzone.d.ts +30 -2
  164. package/dist/forms/dropzone/dropzone.js +153 -23
  165. package/dist/forms/field/field.d.ts +16 -10
  166. package/dist/forms/field/field.js +41 -5
  167. package/dist/forms/index.d.ts +5 -0
  168. package/dist/forms/index.js +5 -0
  169. package/dist/forms/input/index.d.ts +1 -1
  170. package/dist/forms/input/index.js +4 -1
  171. package/dist/forms/input/input.d.ts +21 -5
  172. package/dist/forms/input/input.js +75 -9
  173. package/dist/forms/input-icon/input-icon.d.ts +1 -1
  174. package/dist/forms/internal/listbox-items.d.ts +18 -0
  175. package/dist/forms/internal/listbox-items.js +88 -0
  176. package/dist/forms/internal/listbox.d.ts +44 -0
  177. package/dist/forms/internal/listbox.js +74 -0
  178. package/dist/forms/number-stepper/model.d.ts +16 -0
  179. package/dist/forms/number-stepper/model.js +23 -0
  180. package/dist/forms/number-stepper/number-stepper.d.ts +36 -6
  181. package/dist/forms/number-stepper/number-stepper.js +86 -37
  182. package/dist/forms/password-input/index.d.ts +1 -0
  183. package/dist/forms/password-input/index.js +1 -0
  184. package/dist/forms/password-input/password-input.d.ts +16 -0
  185. package/dist/forms/password-input/password-input.js +45 -0
  186. package/dist/forms/select-menu/index.d.ts +1 -0
  187. package/dist/forms/select-menu/index.js +6 -0
  188. package/dist/forms/select-menu/select-menu.d.ts +35 -0
  189. package/dist/forms/select-menu/select-menu.js +230 -0
  190. package/dist/i18n/strings.d.ts +153 -0
  191. package/dist/i18n/strings.js +86 -2
  192. package/dist/i18n/ui-strings-provider.d.ts +1 -1
  193. package/dist/i18n/ui-strings-provider.js +6 -2
  194. package/dist/icons/eye.d.ts +2 -0
  195. package/dist/icons/eye.js +11 -0
  196. package/dist/icons/graduation-cap.d.ts +2 -0
  197. package/dist/icons/graduation-cap.js +12 -0
  198. package/dist/icons/house.d.ts +2 -0
  199. package/dist/icons/house.js +11 -0
  200. package/dist/icons/index.d.ts +4 -0
  201. package/dist/icons/index.js +8 -0
  202. package/dist/icons/mail.d.ts +2 -0
  203. package/dist/icons/mail.js +11 -0
  204. package/dist/navigation/index.d.ts +1 -0
  205. package/dist/navigation/index.js +1 -0
  206. package/dist/navigation/stepper/index.d.ts +1 -1
  207. package/dist/navigation/stepper/index.js +3 -1
  208. package/dist/navigation/stepper/stepper.d.ts +8 -0
  209. package/dist/navigation/stepper/stepper.js +68 -45
  210. package/dist/navigation/tabs/index.d.ts +1 -0
  211. package/dist/navigation/tabs/index.js +6 -0
  212. package/dist/navigation/tabs/tabs-nav.d.ts +37 -0
  213. package/dist/navigation/tabs/tabs-nav.js +57 -0
  214. package/dist/navigation/wizard/index.d.ts +1 -0
  215. package/dist/navigation/wizard/index.js +6 -0
  216. package/dist/navigation/wizard/model.d.ts +33 -0
  217. package/dist/navigation/wizard/model.js +34 -0
  218. package/dist/navigation/wizard/wizard.d.ts +45 -0
  219. package/dist/navigation/wizard/wizard.js +169 -0
  220. package/dist/overlays/alert-dialog/alert-dialog.d.ts +103 -0
  221. package/dist/overlays/alert-dialog/alert-dialog.js +342 -0
  222. package/dist/overlays/alert-dialog/index.d.ts +1 -0
  223. package/dist/overlays/alert-dialog/index.js +26 -0
  224. package/dist/overlays/dropdown-menu/dropdown-menu.d.ts +17 -1
  225. package/dist/overlays/dropdown-menu/dropdown-menu.js +12 -4
  226. package/dist/overlays/dropdown-menu/index.d.ts +1 -1
  227. package/dist/overlays/dropdown-menu/index.js +8 -2
  228. package/dist/overlays/index.d.ts +2 -0
  229. package/dist/overlays/index.js +2 -0
  230. package/dist/overlays/testing/index.d.ts +5 -0
  231. package/dist/overlays/testing/index.js +4 -0
  232. package/dist/overlays/toaster/index.d.ts +2 -1
  233. package/dist/overlays/toaster/index.js +4 -2
  234. package/dist/overlays/toaster/toast-store.d.ts +6 -2
  235. package/dist/overlays/toaster/toast.d.ts +3 -0
  236. package/dist/overlays/toaster/toast.js +3 -0
  237. package/dist/overlays/toaster/toaster.d.ts +3 -0
  238. package/dist/overlays/toaster/toaster.js +36 -3
  239. package/dist/overlays/tooltip/index.d.ts +1 -0
  240. package/dist/overlays/tooltip/index.js +4 -0
  241. package/dist/overlays/tooltip/model.d.ts +10 -0
  242. package/dist/overlays/tooltip/model.js +13 -0
  243. package/dist/overlays/tooltip/tooltip.d.ts +41 -0
  244. package/dist/overlays/tooltip/tooltip.js +116 -0
  245. package/dist/primitives/use-dismissable-layer.js +1 -1
  246. package/dist/states/error-state/error-state.d.ts +6 -1
  247. package/dist/states/error-state/error-state.js +13 -9
  248. package/dist/states/skeleton/skeleton.d.ts +8 -2
  249. package/dist/states/skeleton/skeleton.js +44 -2
  250. package/icons/svg/eye.svg +4 -0
  251. package/icons/svg/graduation-cap.svg +5 -0
  252. package/icons/svg/house.svg +4 -0
  253. package/icons/svg/mail.svg +4 -0
  254. package/package.json +2 -2
  255. package/scripts/build-theme.mjs +12 -1
  256. package/src/atoms/button/button.tsx +25 -3
  257. package/src/atoms/checkbox/checkbox.tsx +3 -1
  258. package/src/atoms/chip/chip.tsx +18 -3
  259. package/src/atoms/chip/index.ts +2 -0
  260. package/src/atoms/divider/divider.tsx +40 -0
  261. package/src/atoms/divider/index.ts +1 -0
  262. package/src/atoms/due-chip/due-chip.tsx +75 -0
  263. package/src/atoms/due-chip/index.ts +2 -0
  264. package/src/atoms/due-chip/model.ts +67 -0
  265. package/src/atoms/icon-button/icon-button.tsx +58 -0
  266. package/src/atoms/icon-button/index.ts +6 -0
  267. package/src/atoms/index.ts +6 -0
  268. package/src/atoms/internal/hit-area.ts +7 -0
  269. package/src/atoms/kbd/index.ts +1 -0
  270. package/src/atoms/kbd/kbd.tsx +20 -0
  271. package/src/atoms/radio-group/radio-group.tsx +8 -2
  272. package/src/atoms/seal/index.ts +1 -0
  273. package/src/atoms/seal/seal.tsx +107 -0
  274. package/src/atoms/spinner/index.ts +1 -0
  275. package/src/atoms/spinner/spinner.tsx +49 -0
  276. package/src/atoms/switch/switch.tsx +3 -1
  277. package/src/auth/auth-illustration/auth-illustration.tsx +100 -0
  278. package/src/auth/auth-illustration/index.ts +8 -0
  279. package/src/auth/auth-illustration/look.ts +32 -0
  280. package/src/auth/auth-illustration/model.ts +330 -0
  281. package/src/auth/auth-illustration/use-art-pointer.ts +78 -0
  282. package/src/auth/auth-layout/auth-layout.tsx +282 -0
  283. package/src/auth/auth-layout/index.ts +1 -0
  284. package/src/auth/character/character.tsx +346 -0
  285. package/src/auth/character/index.ts +1 -0
  286. package/src/auth/index.ts +4 -0
  287. package/src/auth/internal/auth-context.ts +26 -0
  288. package/src/auth/internal/auth-styles.tsx +39 -0
  289. package/src/auth/internal/portal-glyphs.tsx +32 -0
  290. package/src/auth/login-form/context.ts +78 -0
  291. package/src/auth/login-form/index.ts +21 -0
  292. package/src/auth/login-form/login-form.tsx +330 -0
  293. package/src/auth/login-form/parts.tsx +457 -0
  294. package/src/auth/looks/auth-illustration-any.tsx +38 -0
  295. package/src/auth/looks/index.ts +1 -0
  296. package/src/auth/mosaic/index.ts +1 -0
  297. package/src/auth/mosaic/mosaic.tsx +255 -0
  298. package/src/auth/slabs/index.ts +1 -0
  299. package/src/auth/slabs/slabs.tsx +181 -0
  300. package/src/auth/stack/index.ts +1 -0
  301. package/src/auth/stack/stack.tsx +267 -0
  302. package/src/auth/statement/index.ts +1 -0
  303. package/src/auth/statement/statement.tsx +122 -0
  304. package/src/calendar/date-calendar/date-calendar.tsx +230 -0
  305. package/src/calendar/date-calendar/index.ts +5 -0
  306. package/src/calendar/index.ts +1 -0
  307. package/src/calendar/internal/date-utils.ts +115 -0
  308. package/src/containers/aside/aside.tsx +40 -0
  309. package/src/containers/aside/index.ts +1 -0
  310. package/src/containers/banner/banner.tsx +18 -1
  311. package/src/containers/description-list/description-list.tsx +85 -9
  312. package/src/containers/feed/feed.tsx +99 -0
  313. package/src/containers/feed/index.ts +8 -0
  314. package/src/containers/feed/model.ts +54 -0
  315. package/src/containers/index.ts +6 -0
  316. package/src/containers/kpi/kpi.tsx +161 -62
  317. package/src/containers/list-detail/index.ts +15 -0
  318. package/src/containers/list-detail/list-detail.tsx +293 -0
  319. package/src/containers/note/index.ts +1 -0
  320. package/src/containers/note/note.tsx +38 -0
  321. package/src/containers/section/index.ts +11 -0
  322. package/src/containers/section/section.tsx +281 -0
  323. package/src/containers/shortcuts/index.ts +6 -0
  324. package/src/containers/shortcuts/shortcuts.tsx +92 -0
  325. package/src/containers/table/selection.ts +26 -0
  326. package/src/containers/table/table.tsx +215 -13
  327. package/src/containers/timeline/index.ts +3 -0
  328. package/src/containers/timeline/timeline.tsx +204 -93
  329. package/src/forms/chip-group/chip-group.tsx +184 -0
  330. package/src/forms/chip-group/index.ts +8 -0
  331. package/src/forms/combobox/combobox.tsx +359 -0
  332. package/src/forms/combobox/index.ts +7 -0
  333. package/src/forms/date-picker/date-picker.tsx +239 -0
  334. package/src/forms/date-picker/date-time-picker.tsx +178 -0
  335. package/src/forms/date-picker/index.ts +10 -0
  336. package/src/forms/date-picker/model.ts +108 -0
  337. package/src/forms/dropzone/dropzone.tsx +217 -35
  338. package/src/forms/field/field.tsx +72 -7
  339. package/src/forms/index.ts +5 -0
  340. package/src/forms/input/index.ts +8 -1
  341. package/src/forms/input/input.tsx +99 -12
  342. package/src/forms/input-icon/input-icon.tsx +1 -1
  343. package/src/forms/internal/listbox-items.tsx +103 -0
  344. package/src/forms/internal/listbox.ts +124 -0
  345. package/src/forms/number-stepper/model.ts +35 -0
  346. package/src/forms/number-stepper/number-stepper.tsx +132 -42
  347. package/src/forms/password-input/index.ts +1 -0
  348. package/src/forms/password-input/password-input.tsx +57 -0
  349. package/src/forms/select-menu/index.ts +7 -0
  350. package/src/forms/select-menu/select-menu.tsx +280 -0
  351. package/src/i18n/strings.ts +153 -0
  352. package/src/i18n/ui-strings-provider.tsx +15 -4
  353. package/src/icons/eye.tsx +12 -0
  354. package/src/icons/graduation-cap.tsx +13 -0
  355. package/src/icons/house.tsx +12 -0
  356. package/src/icons/index.ts +4 -0
  357. package/src/icons/mail.tsx +12 -0
  358. package/src/navigation/index.ts +1 -0
  359. package/src/navigation/stepper/index.ts +7 -1
  360. package/src/navigation/stepper/stepper.tsx +41 -5
  361. package/src/navigation/tabs/index.ts +7 -0
  362. package/src/navigation/tabs/tabs-nav.tsx +131 -0
  363. package/src/navigation/wizard/index.ts +7 -0
  364. package/src/navigation/wizard/model.ts +61 -0
  365. package/src/navigation/wizard/wizard.tsx +222 -0
  366. package/src/overlays/alert-dialog/alert-dialog.tsx +486 -0
  367. package/src/overlays/alert-dialog/index.ts +19 -0
  368. package/src/overlays/dropdown-menu/dropdown-menu.tsx +29 -4
  369. package/src/overlays/dropdown-menu/index.ts +3 -0
  370. package/src/overlays/index.ts +2 -0
  371. package/src/overlays/testing/index.ts +5 -0
  372. package/src/overlays/toaster/index.ts +2 -0
  373. package/src/overlays/toaster/toast-store.ts +6 -2
  374. package/src/overlays/toaster/toast.ts +6 -0
  375. package/src/overlays/toaster/toaster.tsx +44 -2
  376. package/src/overlays/tooltip/index.ts +1 -0
  377. package/src/overlays/tooltip/model.ts +18 -0
  378. package/src/overlays/tooltip/tooltip.tsx +166 -0
  379. package/src/primitives/use-dismissable-layer.ts +7 -2
  380. package/src/states/error-state/error-state.tsx +19 -8
  381. package/src/states/skeleton/skeleton.tsx +68 -2
  382. package/styles/tailwind.css +33 -30
  383. package/styles/theme.css +33 -30
@@ -0,0 +1,54 @@
1
+ import { type ReactNode } from "react";
2
+ import type { ClassNames } from "../../utils/class-names.js";
3
+ export interface ChipGroupOption {
4
+ value: string;
5
+ label: ReactNode;
6
+ /** Small count after the label. */
7
+ count?: ReactNode;
8
+ /** Decorative glyph before the label (replaced by a check while selected in a multiple group). */
9
+ icon?: ReactNode;
10
+ disabled?: boolean;
11
+ }
12
+ export type ChipGroupPart = "root" | "chip" | "label" | "count" | "check";
13
+ interface ChipGroupCommon {
14
+ options: readonly ChipGroupOption[];
15
+ disabled?: boolean | undefined;
16
+ /** Form field name: a hidden input per selected value. */
17
+ name?: string | undefined;
18
+ /** Marks the group invalid (also set by `Field` through `aria-invalid`). */
19
+ invalid?: boolean | undefined;
20
+ /** Set by `Field`; the group is named from the field's label. */
21
+ id?: string | undefined;
22
+ "aria-label"?: string | undefined;
23
+ "aria-labelledby"?: string | undefined;
24
+ "aria-describedby"?: string | undefined;
25
+ "aria-invalid"?: boolean | "true" | "false" | undefined;
26
+ className?: string | undefined;
27
+ /** Per-part classes merged with `cn`; consumer classes win. `className` still targets the root. */
28
+ classNames?: ClassNames<ChipGroupPart>;
29
+ }
30
+ export interface ChipGroupMultipleProps extends ChipGroupCommon {
31
+ /** Any number of chips can be on. This is the default. */
32
+ type?: "multiple";
33
+ value?: string[] | undefined;
34
+ defaultValue?: string[] | undefined;
35
+ onValueChange?: ((value: string[]) => void) | undefined;
36
+ }
37
+ export interface ChipGroupSingleProps extends ChipGroupCommon {
38
+ /** At most one chip is on. */
39
+ type: "single";
40
+ value?: string | undefined;
41
+ defaultValue?: string | undefined;
42
+ onValueChange?: ((value: string) => void) | undefined;
43
+ /** Lets the pressed chip be pressed again to clear the choice (`""`). Off by default: a filter keeps one on. */
44
+ allowDeselect?: boolean | undefined;
45
+ }
46
+ export type ChipGroupProps = ChipGroupMultipleProps | ChipGroupSingleProps;
47
+ /**
48
+ * A set of chips that act as toggle buttons (`aria-pressed`) in a `fieldset` (a named group): pick several
49
+ * (`type="multiple"`, default) or one (`type="single"`). Arrow keys, Home and End move between
50
+ * chips and Space or Enter toggles; the group works inside `Field` (named from its label,
51
+ * described by its hint and error) and submits one hidden input per selected value when named.
52
+ */
53
+ export declare function ChipGroup(props: ChipGroupProps): import("react").JSX.Element;
54
+ export {};
@@ -0,0 +1,114 @@
1
+ "use client";
2
+ import { jsx, jsxs } from "react/jsx-runtime";
3
+ import { useEffect, useId, useRef, useState } from "react";
4
+ import { Check } from "../../icons/index.js";
5
+ import { cn } from "../../utils/cn.js";
6
+ import { useComposedRefs } from "../../utils/compose.js";
7
+ import { useRovingFocus } from "../../utils/roving-focus.js";
8
+ import { useControllableState } from "../../utils/use-controllable-state.js";
9
+ function ChipGroup(props) {
10
+ const {
11
+ options,
12
+ disabled,
13
+ name,
14
+ invalid,
15
+ id,
16
+ className,
17
+ classNames,
18
+ "aria-label": ariaLabel,
19
+ "aria-labelledby": ariaLabelledBy,
20
+ "aria-describedby": ariaDescribedBy,
21
+ "aria-invalid": ariaInvalid
22
+ } = props;
23
+ const single = props.type === "single";
24
+ const generated = useId();
25
+ const baseId = id ?? generated;
26
+ const [multiValue, setMultiValue] = useControllableState({
27
+ prop: props.type === "single" ? void 0 : props.value,
28
+ defaultProp: (props.type === "single" ? void 0 : props.defaultValue) ?? [],
29
+ onChange: props.type === "single" ? void 0 : props.onValueChange
30
+ });
31
+ const [singleValue, setSingleValue] = useControllableState({
32
+ prop: props.type === "single" ? props.value : void 0,
33
+ defaultProp: (props.type === "single" ? props.defaultValue : void 0) ?? "",
34
+ onChange: props.type === "single" ? props.onValueChange : void 0
35
+ });
36
+ const selected = single ? singleValue ? [singleValue] : [] : multiValue;
37
+ const toggle = (value) => {
38
+ if (props.type === "single") {
39
+ if (singleValue === value) {
40
+ if (props.allowDeselect) setSingleValue("");
41
+ } else setSingleValue(value);
42
+ return;
43
+ }
44
+ setMultiValue(
45
+ multiValue.includes(value) ? multiValue.filter((v) => v !== value) : [...multiValue, value]
46
+ );
47
+ };
48
+ const roving = useRovingFocus({
49
+ activeId: selected.find((v) => options.some((o) => o.value === v && !o.disabled)) ?? null
50
+ });
51
+ const { ref: rovingRef, onFocus: rovingOnFocus, tabIndex } = roving.rootProps;
52
+ const localRef = useRef(null);
53
+ const composedRef = useComposedRefs(rovingRef, localRef);
54
+ const [fieldLabel, setFieldLabel] = useState();
55
+ useEffect(() => {
56
+ if (ariaLabel || ariaLabelledBy || !id) return;
57
+ const label = Array.from(
58
+ localRef.current?.ownerDocument.querySelectorAll("label[for]") ?? []
59
+ ).find((candidate) => candidate.htmlFor === id);
60
+ setFieldLabel(label?.textContent?.trim() || void 0);
61
+ }, [id, ariaLabel, ariaLabelledBy]);
62
+ const isInvalid = invalid || ariaInvalid === true || ariaInvalid === "true";
63
+ return /* @__PURE__ */ jsxs(
64
+ "fieldset",
65
+ {
66
+ ref: composedRef,
67
+ id: baseId,
68
+ tabIndex,
69
+ "aria-label": ariaLabel ?? (ariaLabelledBy ? void 0 : fieldLabel),
70
+ "aria-labelledby": ariaLabelledBy,
71
+ "aria-describedby": ariaDescribedBy,
72
+ "data-type": single ? "single" : "multiple",
73
+ "data-invalid": isInvalid ? "" : void 0,
74
+ "data-disabled": disabled ? "" : void 0,
75
+ onFocus: rovingOnFocus,
76
+ className: cn(
77
+ "group/chips m-0 flex min-w-0 flex-wrap gap-1.5 border-0 p-0 outline-none",
78
+ classNames?.root,
79
+ className
80
+ ),
81
+ children: [
82
+ options.map((option) => {
83
+ const pressed = selected.includes(option.value);
84
+ const off = disabled || option.disabled;
85
+ const item = roving.getItemProps(option.value, { disabled: off });
86
+ return /* @__PURE__ */ jsxs(
87
+ "button",
88
+ {
89
+ type: "button",
90
+ "aria-pressed": pressed,
91
+ disabled: off,
92
+ ...item,
93
+ onClick: () => toggle(option.value),
94
+ className: cn(
95
+ "inline-flex min-h-7 cursor-pointer items-center gap-1.5 rounded-badge border-control bg-surface-control px-3 font-medium text-fs-130 text-ink-2 hover:bg-surface-2 focus-visible:focus-ring disabled:cursor-not-allowed disabled:opacity-50 aria-pressed:border-accent aria-pressed:bg-accent-soft aria-pressed:text-accent-ink group-data-[invalid]/chips:border-danger in-data-[density=touch]:min-h-11 [&_svg]:size-3",
96
+ classNames?.chip
97
+ ),
98
+ children: [
99
+ pressed && !single ? /* @__PURE__ */ jsx(Check, { "aria-hidden": "true", className: classNames?.check }) : option.icon ? /* @__PURE__ */ jsx("span", { "aria-hidden": "true", className: "inline-flex shrink-0", children: option.icon }) : null,
100
+ /* @__PURE__ */ jsx("span", { className: cn("min-w-0", classNames?.label), children: option.label }),
101
+ option.count !== void 0 ? /* @__PURE__ */ jsx("span", { className: cn("text-count tabular-nums", classNames?.count), children: option.count }) : null
102
+ ]
103
+ },
104
+ option.value
105
+ );
106
+ }),
107
+ name ? selected.map((value) => /* @__PURE__ */ jsx("input", { type: "hidden", name, value }, value)) : null
108
+ ]
109
+ }
110
+ );
111
+ }
112
+ export {
113
+ ChipGroup
114
+ };
@@ -0,0 +1 @@
1
+ export { ChipGroup, type ChipGroupMultipleProps, type ChipGroupOption, type ChipGroupPart, type ChipGroupProps, type ChipGroupSingleProps, } from "./chip-group.js";
@@ -0,0 +1,6 @@
1
+ import {
2
+ ChipGroup
3
+ } from "./chip-group.js";
4
+ export {
5
+ ChipGroup
6
+ };
@@ -0,0 +1,60 @@
1
+ import { type ComponentProps } from "react";
2
+ import type { ClassNames } from "../../utils/class-names.js";
3
+ import { type Material } from "../../utils/material.js";
4
+ import { type ListboxGroup, type ListboxOption } from "../internal/listbox.js";
5
+ export type ComboboxOption = ListboxOption;
6
+ export type ComboboxGroup = ListboxGroup<ComboboxOption>;
7
+ export type ComboboxPart = "root" | "input" | "clear" | "content" | "option" | "group" | "status";
8
+ export interface ComboboxProps extends Omit<ComponentProps<"input">, "value" | "defaultValue" | "onChange" | "type" | "role" | "size"> {
9
+ /** Options, optionally nested in labelled groups. For async search, pass the current results. */
10
+ options: readonly (ComboboxOption | ComboboxGroup)[];
11
+ /** Selected option value (controlled). `""` means nothing is selected. */
12
+ value?: string;
13
+ defaultValue?: string;
14
+ onValueChange?: (value: string, option: ComboboxOption | null) => void;
15
+ /**
16
+ * Called on every keystroke with the text typed, and with `""` when the search resets. Debounce
17
+ * in the caller before fetching; the component never delays or cancels requests.
18
+ */
19
+ onSearchChange?: (query: string) => void;
20
+ /**
21
+ * Local filtering. `true` (default) matches label, description and keywords ignoring case and
22
+ * accents; `false` shows `options` as given (server-side search); a function decides per option.
23
+ */
24
+ filter?: boolean | ((option: ComboboxOption, query: string) => boolean);
25
+ /** Most options rendered at once. Default 50. */
26
+ maxVisible?: number;
27
+ /** Shows the loading status, e.g. while an async search is in flight. */
28
+ loading?: boolean;
29
+ loadingText?: string;
30
+ /** Shown when nothing matches. Defaults to the localized "No results". */
31
+ emptyText?: string;
32
+ /** Shows a button that clears the selection. Default `true`. */
33
+ clearable?: boolean;
34
+ clearLabel?: string;
35
+ /** Label to show for `value` while it is not (yet) among `options`, e.g. after an async search moved on. */
36
+ valueLabel?: string;
37
+ /** Submits the value (not the typed text) with a surrounding `<form>` through a hidden input. */
38
+ name?: string;
39
+ invalid?: boolean;
40
+ /**
41
+ * `required` always sets `aria-required`. The native attribute, which blocks form submission
42
+ * with the browser's own bubble before your validation can render, is added only when this is
43
+ * `true`. Default `false`.
44
+ */
45
+ nativeRequired?: boolean;
46
+ size?: "sm" | "md";
47
+ /** Portal target for the popup. Defaults to `document.body`; pass an element to keep a scoped `data-style`. */
48
+ container?: HTMLElement | null;
49
+ /** Popup surface material; see `PopoverContent`. */
50
+ material?: Material;
51
+ /** Per-part classes merged with `cn`; consumer classes win. `className` still targets the root and is merged last. */
52
+ classNames?: ClassNames<ComboboxPart>;
53
+ }
54
+ /**
55
+ * Searchable single select (WAI-ARIA combobox with a listbox popup). The input shows the typed
56
+ * text while editing and the selected label otherwise; focus never leaves the input and the
57
+ * highlighted option is announced through `aria-activedescendant`. Works with local options or
58
+ * with results the caller loads from `onSearchChange`.
59
+ */
60
+ export declare function Combobox({ options, value: valueProp, defaultValue, onValueChange, onSearchChange, filter, maxVisible, loading, loadingText, emptyText, clearable, clearLabel, valueLabel, name, invalid, required, nativeRequired, size, container, material, disabled, className, classNames, ref, id, onFocus, onClick, onBlur, onKeyDown, "aria-label": ariaLabel, "aria-labelledby": ariaLabelledBy, "aria-invalid": ariaInvalid, ...props }: ComboboxProps): import("react").JSX.Element;
@@ -0,0 +1,281 @@
1
+ "use client";
2
+ import { jsx, jsxs } from "react/jsx-runtime";
3
+ import {
4
+ useEffect,
5
+ useId,
6
+ useMemo,
7
+ useRef,
8
+ useState
9
+ } from "react";
10
+ import { useUiStrings } from "../../i18n/index.js";
11
+ import { X } from "../../icons/index.js";
12
+ import * as PopoverPrimitive from "../../primitives/popover/popover.js";
13
+ import { cn } from "../../utils/cn.js";
14
+ import { useComposedRefs } from "../../utils/compose.js";
15
+ import { materialClass } from "../../utils/material.js";
16
+ import { useControllableState } from "../../utils/use-controllable-state.js";
17
+ import {
18
+ filterItems,
19
+ flattenItems,
20
+ matchesQuery,
21
+ moveActive
22
+ } from "../internal/listbox.js";
23
+ import { LISTBOX_SURFACE, ListboxItems, optionDomId } from "../internal/listbox-items.js";
24
+ function Combobox({
25
+ options,
26
+ value: valueProp,
27
+ defaultValue = "",
28
+ onValueChange,
29
+ onSearchChange,
30
+ filter = true,
31
+ maxVisible = 50,
32
+ loading = false,
33
+ loadingText,
34
+ emptyText,
35
+ clearable = true,
36
+ clearLabel,
37
+ valueLabel,
38
+ name,
39
+ invalid,
40
+ required,
41
+ nativeRequired = false,
42
+ size = "md",
43
+ container,
44
+ material,
45
+ disabled,
46
+ className,
47
+ classNames,
48
+ ref,
49
+ id,
50
+ onFocus,
51
+ onClick,
52
+ onBlur,
53
+ onKeyDown,
54
+ "aria-label": ariaLabel,
55
+ "aria-labelledby": ariaLabelledBy,
56
+ "aria-invalid": ariaInvalid,
57
+ ...props
58
+ }) {
59
+ const strings = useUiStrings();
60
+ const autoId = useId();
61
+ const inputId = id ?? autoId;
62
+ const listId = `${inputId}-listbox`;
63
+ const rootRef = useRef(null);
64
+ const inputRef = useRef(null);
65
+ const composedRef = useComposedRefs(ref, inputRef);
66
+ const allOptions = useMemo(() => flattenItems(options), [options]);
67
+ const [value, setValue] = useControllableState({
68
+ prop: valueProp,
69
+ defaultProp: defaultValue,
70
+ onChange: (next) => onValueChange?.(next, allOptions.find((option) => option.value === next) ?? null)
71
+ });
72
+ const [query, setQuery] = useState(null);
73
+ const [open, setOpen] = useState(false);
74
+ const [active, setActive] = useState(0);
75
+ const text = query ?? "";
76
+ const items = useMemo(() => {
77
+ const predicate = filter === false ? () => true : typeof filter === "function" ? (option) => filter(option, text) : (option) => matchesQuery(option, text);
78
+ return filterItems(options, predicate, maxVisible);
79
+ }, [options, filter, text, maxVisible]);
80
+ const flat = useMemo(() => flattenItems(items), [items]);
81
+ const selected = value === "" ? void 0 : allOptions.find((option) => option.value === value);
82
+ const selectedLabel = selected?.label ?? (value === "" ? "" : valueLabel ?? "");
83
+ const isOpen = open && !disabled;
84
+ const showList = isOpen && flat.length > 0;
85
+ const showEmpty = isOpen && !loading && flat.length === 0;
86
+ const activeIndex = flat[active] && !flat[active]?.disabled ? active : moveActive(flat, -1, "first");
87
+ useEffect(() => setActive(0), [query, isOpen]);
88
+ useEffect(() => {
89
+ if (!showList || activeIndex < 0) return;
90
+ document.getElementById(optionDomId(listId, activeIndex))?.scrollIntoView?.({ block: "nearest" });
91
+ }, [showList, activeIndex, listId]);
92
+ const resetSearch = () => {
93
+ if (query !== null) onSearchChange?.("");
94
+ setQuery(null);
95
+ };
96
+ const pick = (option) => {
97
+ if (!option || option.disabled) return;
98
+ setValue(option.value);
99
+ resetSearch();
100
+ setOpen(false);
101
+ };
102
+ const clear = () => {
103
+ setValue("");
104
+ resetSearch();
105
+ setOpen(false);
106
+ inputRef.current?.focus();
107
+ };
108
+ const handleKeyDown = (event) => {
109
+ onKeyDown?.(event);
110
+ if (event.defaultPrevented || event.altKey || event.ctrlKey || event.metaKey) return;
111
+ const { key } = event;
112
+ if (key === "ArrowDown") {
113
+ event.preventDefault();
114
+ if (!isOpen) setOpen(true);
115
+ else setActive(moveActive(flat, activeIndex, "next"));
116
+ } else if (key === "ArrowUp") {
117
+ event.preventDefault();
118
+ if (!isOpen) setOpen(true);
119
+ else setActive(moveActive(flat, activeIndex, "prev"));
120
+ } else if (key === "Enter") {
121
+ if (showList && flat[activeIndex]) {
122
+ event.preventDefault();
123
+ pick(flat[activeIndex]);
124
+ }
125
+ } else if (key === "Escape") {
126
+ if (isOpen) {
127
+ event.preventDefault();
128
+ setOpen(false);
129
+ } else if (query !== null) {
130
+ event.preventDefault();
131
+ resetSearch();
132
+ }
133
+ } else if (key === "Backspace" && clearable && text === "" && query !== null && selected) {
134
+ clear();
135
+ }
136
+ };
137
+ const hasClear = clearable && !disabled && value !== "";
138
+ return /* @__PURE__ */ jsxs(PopoverPrimitive.Root, { open: isOpen, onOpenChange: setOpen, children: [
139
+ /* @__PURE__ */ jsx(PopoverPrimitive.Anchor, { asChild: true, children: /* @__PURE__ */ jsxs(
140
+ "div",
141
+ {
142
+ ref: rootRef,
143
+ className: cn("relative flex w-full min-w-0", classNames?.root, className),
144
+ children: [
145
+ /* @__PURE__ */ jsx(
146
+ "input",
147
+ {
148
+ ...props,
149
+ ref: composedRef,
150
+ id: inputId,
151
+ type: "text",
152
+ role: "combobox",
153
+ "data-ui-layer": "",
154
+ autoComplete: "off",
155
+ "aria-expanded": isOpen,
156
+ "aria-controls": isOpen ? listId : void 0,
157
+ "aria-autocomplete": "list",
158
+ "aria-activedescendant": showList && activeIndex >= 0 ? optionDomId(listId, activeIndex) : void 0,
159
+ "aria-label": ariaLabel,
160
+ "aria-labelledby": ariaLabelledBy,
161
+ "aria-invalid": ariaInvalid ?? (invalid || void 0),
162
+ "aria-required": required || void 0,
163
+ required: nativeRequired ? required : void 0,
164
+ disabled,
165
+ value: query ?? selectedLabel,
166
+ onFocus: (event) => {
167
+ onFocus?.(event);
168
+ event.currentTarget.select();
169
+ setOpen(true);
170
+ },
171
+ onClick: (event) => {
172
+ onClick?.(event);
173
+ setOpen(true);
174
+ },
175
+ onChange: (event) => {
176
+ setQuery(event.target.value);
177
+ onSearchChange?.(event.target.value);
178
+ setOpen(true);
179
+ },
180
+ onBlur: (event) => {
181
+ onBlur?.(event);
182
+ setOpen(false);
183
+ resetSearch();
184
+ },
185
+ onKeyDown: handleKeyDown,
186
+ className: cn(
187
+ "w-full min-w-0 rounded-input border-control bg-surface-control pl-3 text-control text-ink placeholder:text-ink-3 focus:border-transparent focus:outline-2 focus:outline-accent-ink focus:-outline-offset-1 disabled:cursor-not-allowed disabled:opacity-50 aria-[invalid=true]:border-danger",
188
+ size === "sm" ? "h-control-sm" : "h-input min-h-(--touch-target)",
189
+ hasClear ? "pr-8" : "pr-3",
190
+ classNames?.input
191
+ )
192
+ }
193
+ ),
194
+ hasClear ? /* @__PURE__ */ jsx(
195
+ "button",
196
+ {
197
+ type: "button",
198
+ "aria-label": clearLabel ?? strings.clear,
199
+ onPointerDown: (event) => event.preventDefault(),
200
+ onMouseDown: (event) => event.preventDefault(),
201
+ onClick: clear,
202
+ className: cn(
203
+ "absolute inset-y-0 right-0 flex w-8 items-center justify-center rounded-input text-ink-3 outline-none hover:text-ink focus-visible:focus-ring",
204
+ classNames?.clear
205
+ ),
206
+ children: /* @__PURE__ */ jsx(X, { "aria-hidden": "true", className: "size-3.5" })
207
+ }
208
+ ) : null,
209
+ name ? /* @__PURE__ */ jsx("input", { type: "hidden", name, value, disabled }) : null
210
+ ]
211
+ }
212
+ ) }),
213
+ /* @__PURE__ */ jsx(PopoverPrimitive.Portal, { container, children: /* @__PURE__ */ jsxs(
214
+ PopoverPrimitive.Content,
215
+ {
216
+ role: "presentation",
217
+ sideOffset: 4,
218
+ collisionPadding: 8,
219
+ align: "start",
220
+ onOpenAutoFocus: (event) => event.preventDefault(),
221
+ onCloseAutoFocus: (event) => event.preventDefault(),
222
+ onInteractOutside: (event) => {
223
+ if (rootRef.current?.contains(event.detail.originalEvent.target)) {
224
+ event.preventDefault();
225
+ }
226
+ },
227
+ className: cn(
228
+ LISTBOX_SURFACE,
229
+ materialClass(material, "surface-solid"),
230
+ classNames?.content
231
+ ),
232
+ children: [
233
+ loading ? /* @__PURE__ */ jsx(
234
+ "p",
235
+ {
236
+ role: "status",
237
+ className: cn("px-2.5 py-1.5 text-ink-3 text-meta", classNames?.status),
238
+ children: loadingText ?? strings.loading
239
+ }
240
+ ) : null,
241
+ showEmpty ? /* @__PURE__ */ jsx(
242
+ "p",
243
+ {
244
+ role: "status",
245
+ className: cn("px-2.5 py-1.5 text-ink-3 text-meta", classNames?.status),
246
+ children: emptyText ?? strings.noResults
247
+ }
248
+ ) : null,
249
+ /* @__PURE__ */ jsx(
250
+ "div",
251
+ {
252
+ id: listId,
253
+ role: "listbox",
254
+ "data-ui-layer": "",
255
+ hidden: !showList,
256
+ "aria-label": ariaLabelledBy ? void 0 : ariaLabel,
257
+ "aria-labelledby": ariaLabelledBy,
258
+ children: showList ? /* @__PURE__ */ jsx(
259
+ ListboxItems,
260
+ {
261
+ items,
262
+ flat,
263
+ idBase: listId,
264
+ isSelected: (option) => option.value === value,
265
+ activeIndex,
266
+ onActivate: setActive,
267
+ onPick: pick,
268
+ optionClassName: classNames?.option,
269
+ groupClassName: classNames?.group
270
+ }
271
+ ) : null
272
+ }
273
+ )
274
+ ]
275
+ }
276
+ ) })
277
+ ] });
278
+ }
279
+ export {
280
+ Combobox
281
+ };
@@ -0,0 +1 @@
1
+ export { Combobox, type ComboboxGroup, type ComboboxOption, type ComboboxPart, type ComboboxProps, } from "./combobox.js";
@@ -0,0 +1,6 @@
1
+ import {
2
+ Combobox
3
+ } from "./combobox.js";
4
+ export {
5
+ Combobox
6
+ };
@@ -0,0 +1,40 @@
1
+ import { type ComponentProps } from "react";
2
+ import { type WeekStart } from "../../calendar/internal/date-utils.js";
3
+ import type { ClassNames } from "../../utils/class-names.js";
4
+ import { type Material } from "../../utils/material.js";
5
+ export type DatePickerPart = "root" | "input" | "clear" | "trigger" | "content" | "calendar";
6
+ export interface DatePickerProps extends Omit<ComponentProps<"input">, "value" | "defaultValue" | "onChange" | "type" | "min" | "max" | "size" | "inputMode" | "maxLength"> {
7
+ /** Selected date as "YYYY-MM-DD" (controlled); `""` means none. Never converted through a time zone. */
8
+ value?: string;
9
+ defaultValue?: string;
10
+ /** Called with a valid "YYYY-MM-DD" date, or `""` when the field is cleared. */
11
+ onValueChange?: (value: string) => void;
12
+ /** Earliest allowed date, "YYYY-MM-DD". */
13
+ min?: string;
14
+ /** Latest allowed date, "YYYY-MM-DD". */
15
+ max?: string;
16
+ /** Extra dates that cannot be picked or typed (holidays, taken days). */
17
+ isDateDisabled?: (date: string) => boolean;
18
+ /** BCP 47 locale for labels and the typed format. Defaults to the `locale` UI string (es-PE: dd/mm/aaaa). */
19
+ locale?: string;
20
+ /** First day of the week in the calendar, 0 (Sunday) to 6. Defaults from the locale (es-PE: Monday). */
21
+ weekStartsOn?: WeekStart;
22
+ /** Shows a button that clears the date. Default `true`. */
23
+ clearable?: boolean;
24
+ clearLabel?: string;
25
+ /** Submits the "YYYY-MM-DD" value with a surrounding `<form>` through a hidden input. */
26
+ name?: string;
27
+ invalid?: boolean;
28
+ /** Portal target for the calendar popover. Defaults to `document.body`. */
29
+ container?: HTMLElement | null;
30
+ /** Popover surface material; see `PopoverContent`. */
31
+ material?: Material;
32
+ /** Per-part classes merged with `cn`; consumer classes win. `className` still targets the input and is merged last. */
33
+ classNames?: ClassNames<DatePickerPart>;
34
+ }
35
+ /**
36
+ * Typed date field plus a calendar popover. The value is an ISO "YYYY-MM-DD" string end to end,
37
+ * so it never shifts with the time zone. The person types in the locale's order ("07/09/2026" in
38
+ * es-PE) or picks from the calendar; Alt+ArrowDown opens it from the keyboard.
39
+ */
40
+ export declare function DatePicker({ value: valueProp, defaultValue, onValueChange, min, max, isDateDisabled, locale: localeProp, weekStartsOn, clearable, clearLabel, name, invalid, container, material, disabled, placeholder, className, classNames, ref, onBlur, onKeyDown, "aria-invalid": ariaInvalid, ...props }: DatePickerProps): import("react").JSX.Element;