@kjun-ui/react 0.20.0 → 0.22.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 (327) hide show
  1. package/README.md +19 -5
  2. package/dist/index.cjs +11354 -4458
  3. package/dist/index.js +10951 -4033
  4. package/dist/styles.css +3948 -738
  5. package/dist/types/packages/react/src/actions.d.cts +21 -16
  6. package/dist/types/packages/react/src/actions.d.ts +21 -16
  7. package/dist/types/packages/react/src/app-navigation.d.cts +14 -5
  8. package/dist/types/packages/react/src/app-navigation.d.ts +14 -5
  9. package/dist/types/packages/react/src/avatar-group.d.cts +36 -0
  10. package/dist/types/packages/react/src/avatar-group.d.ts +36 -0
  11. package/dist/types/packages/react/src/button.d.cts +14 -6
  12. package/dist/types/packages/react/src/button.d.ts +14 -6
  13. package/dist/types/packages/react/src/calendar.d.cts +6 -2
  14. package/dist/types/packages/react/src/calendar.d.ts +6 -2
  15. package/dist/types/packages/react/src/card-actions-context.d.cts +2 -0
  16. package/dist/types/packages/react/src/card-actions-context.d.ts +2 -0
  17. package/dist/types/packages/react/src/card.d.cts +23 -6
  18. package/dist/types/packages/react/src/card.d.ts +23 -6
  19. package/dist/types/packages/react/src/carousel.d.cts +8 -1
  20. package/dist/types/packages/react/src/carousel.d.ts +8 -1
  21. package/dist/types/packages/react/src/chip.d.cts +4 -2
  22. package/dist/types/packages/react/src/chip.d.ts +4 -2
  23. package/dist/types/packages/react/src/choice-controls.d.cts +99 -0
  24. package/dist/types/packages/react/src/choice-controls.d.ts +99 -0
  25. package/dist/types/packages/react/src/collapse.d.cts +4 -1
  26. package/dist/types/packages/react/src/collapse.d.ts +4 -1
  27. package/dist/types/packages/react/src/color-picker-parts.d.cts +58 -0
  28. package/dist/types/packages/react/src/color-picker-parts.d.ts +58 -0
  29. package/dist/types/packages/react/src/color-picker.d.cts +58 -0
  30. package/dist/types/packages/react/src/color-picker.d.ts +58 -0
  31. package/dist/types/packages/react/src/combobox.d.cts +18 -5
  32. package/dist/types/packages/react/src/combobox.d.ts +18 -5
  33. package/dist/types/packages/react/src/controls.d.cts +7 -74
  34. package/dist/types/packages/react/src/controls.d.ts +7 -74
  35. package/dist/types/packages/react/src/data-state.d.cts +22 -9
  36. package/dist/types/packages/react/src/data-state.d.ts +22 -9
  37. package/dist/types/packages/react/src/date-picker.d.cts +8 -2
  38. package/dist/types/packages/react/src/date-picker.d.ts +8 -2
  39. package/dist/types/packages/react/src/display.d.cts +40 -11
  40. package/dist/types/packages/react/src/display.d.ts +40 -11
  41. package/dist/types/packages/react/src/drawer.d.cts +11 -2
  42. package/dist/types/packages/react/src/drawer.d.ts +11 -2
  43. package/dist/types/packages/react/src/dropdown.d.cts +19 -5
  44. package/dist/types/packages/react/src/dropdown.d.ts +19 -5
  45. package/dist/types/packages/react/src/event-calendar.d.cts +47 -0
  46. package/dist/types/packages/react/src/event-calendar.d.ts +47 -0
  47. package/dist/types/packages/react/src/fab.d.cts +18 -7
  48. package/dist/types/packages/react/src/fab.d.ts +18 -7
  49. package/dist/types/packages/react/src/file-upload-row.d.cts +23 -0
  50. package/dist/types/packages/react/src/file-upload-row.d.ts +23 -0
  51. package/dist/types/packages/react/src/file-upload.d.cts +38 -0
  52. package/dist/types/packages/react/src/file-upload.d.ts +38 -0
  53. package/dist/types/packages/react/src/financial-display.d.cts +32 -11
  54. package/dist/types/packages/react/src/financial-display.d.ts +32 -11
  55. package/dist/types/packages/react/src/floating-panel.d.cts +6 -2
  56. package/dist/types/packages/react/src/floating-panel.d.ts +6 -2
  57. package/dist/types/packages/react/src/index.d.cts +16 -1
  58. package/dist/types/packages/react/src/index.d.ts +16 -1
  59. package/dist/types/packages/react/src/input.d.cts +14 -1
  60. package/dist/types/packages/react/src/input.d.ts +14 -1
  61. package/dist/types/packages/react/src/kpi-hero.d.cts +55 -0
  62. package/dist/types/packages/react/src/kpi-hero.d.ts +55 -0
  63. package/dist/types/packages/react/src/kpi-row.d.cts +46 -0
  64. package/dist/types/packages/react/src/kpi-row.d.ts +46 -0
  65. package/dist/types/packages/react/src/kpi.d.cts +2 -72
  66. package/dist/types/packages/react/src/kpi.d.ts +2 -72
  67. package/dist/types/packages/react/src/layout-primitives.d.cts +71 -139
  68. package/dist/types/packages/react/src/layout-primitives.d.ts +71 -139
  69. package/dist/types/packages/react/src/list-context.d.cts +9 -0
  70. package/dist/types/packages/react/src/list-context.d.ts +9 -0
  71. package/dist/types/packages/react/src/list.d.cts +84 -11
  72. package/dist/types/packages/react/src/list.d.ts +84 -11
  73. package/dist/types/packages/react/src/market-model.d.cts +13 -1
  74. package/dist/types/packages/react/src/market-model.d.ts +13 -1
  75. package/dist/types/packages/react/src/market-parts.d.cts +9 -0
  76. package/dist/types/packages/react/src/market-parts.d.ts +9 -0
  77. package/dist/types/packages/react/src/market-skeleton.d.cts +7 -1
  78. package/dist/types/packages/react/src/market-skeleton.d.ts +7 -1
  79. package/dist/types/packages/react/src/media.d.cts +6 -2
  80. package/dist/types/packages/react/src/media.d.ts +6 -2
  81. package/dist/types/packages/react/src/modal.d.cts +14 -2
  82. package/dist/types/packages/react/src/modal.d.ts +14 -2
  83. package/dist/types/packages/react/src/navigation.d.cts +36 -6
  84. package/dist/types/packages/react/src/navigation.d.ts +36 -6
  85. package/dist/types/packages/react/src/number-display.d.cts +10 -5
  86. package/dist/types/packages/react/src/number-display.d.ts +10 -5
  87. package/dist/types/packages/react/src/number-input.d.cts +28 -0
  88. package/dist/types/packages/react/src/number-input.d.ts +28 -0
  89. package/dist/types/packages/react/src/popover.d.cts +5 -2
  90. package/dist/types/packages/react/src/popover.d.ts +5 -2
  91. package/dist/types/packages/react/src/pressable.d.cts +17 -0
  92. package/dist/types/packages/react/src/pressable.d.ts +17 -0
  93. package/dist/types/packages/react/src/quantity-stepper.d.cts +3 -1
  94. package/dist/types/packages/react/src/quantity-stepper.d.ts +3 -1
  95. package/dist/types/packages/react/src/range-input.d.cts +15 -3
  96. package/dist/types/packages/react/src/range-input.d.ts +15 -3
  97. package/dist/types/packages/react/src/reorder-controls.d.cts +43 -0
  98. package/dist/types/packages/react/src/reorder-controls.d.ts +43 -0
  99. package/dist/types/packages/react/src/search-input.d.cts +6 -3
  100. package/dist/types/packages/react/src/search-input.d.ts +6 -3
  101. package/dist/types/packages/react/src/select-control.d.cts +7 -2
  102. package/dist/types/packages/react/src/select-control.d.ts +7 -2
  103. package/dist/types/packages/react/src/side-navigation-layout.d.cts +47 -0
  104. package/dist/types/packages/react/src/side-navigation-layout.d.ts +47 -0
  105. package/dist/types/packages/react/src/side-navigation.d.cts +74 -0
  106. package/dist/types/packages/react/src/side-navigation.d.ts +74 -0
  107. package/dist/types/packages/react/src/skeletons.d.cts +19 -3
  108. package/dist/types/packages/react/src/skeletons.d.ts +19 -3
  109. package/dist/types/packages/react/src/spinner-glyph.d.cts +8 -0
  110. package/dist/types/packages/react/src/spinner-glyph.d.ts +8 -0
  111. package/dist/types/packages/react/src/split-pane.d.cts +43 -0
  112. package/dist/types/packages/react/src/split-pane.d.ts +43 -0
  113. package/dist/types/packages/react/src/stacked-bar.d.cts +24 -0
  114. package/dist/types/packages/react/src/stacked-bar.d.ts +24 -0
  115. package/dist/types/packages/react/src/steps.d.cts +26 -0
  116. package/dist/types/packages/react/src/steps.d.ts +26 -0
  117. package/dist/types/packages/react/src/table-cards.d.cts +4 -12
  118. package/dist/types/packages/react/src/table-cards.d.ts +4 -12
  119. package/dist/types/packages/react/src/table-grid.d.cts +3 -7
  120. package/dist/types/packages/react/src/table-grid.d.ts +3 -7
  121. package/dist/types/packages/react/src/table-groups.d.cts +5 -0
  122. package/dist/types/packages/react/src/table-groups.d.ts +5 -0
  123. package/dist/types/packages/react/src/table-list.d.cts +2 -9
  124. package/dist/types/packages/react/src/table-list.d.ts +2 -9
  125. package/dist/types/packages/react/src/table-model.d.cts +6 -2
  126. package/dist/types/packages/react/src/table-model.d.ts +6 -2
  127. package/dist/types/packages/react/src/tabs.d.cts +3 -1
  128. package/dist/types/packages/react/src/tabs.d.ts +3 -1
  129. package/dist/types/packages/react/src/textarea.d.cts +6 -3
  130. package/dist/types/packages/react/src/textarea.d.ts +6 -3
  131. package/dist/types/packages/react/src/tiles.d.cts +18 -0
  132. package/dist/types/packages/react/src/tiles.d.ts +18 -0
  133. package/dist/types/packages/react/src/time-picker.d.cts +12 -2
  134. package/dist/types/packages/react/src/time-picker.d.ts +12 -2
  135. package/dist/types/packages/react/src/time-wheel.d.cts +18 -0
  136. package/dist/types/packages/react/src/time-wheel.d.ts +18 -0
  137. package/dist/types/packages/react/src/use-filter-scroll.d.cts +5 -0
  138. package/dist/types/packages/react/src/use-filter-scroll.d.ts +5 -0
  139. package/dist/types/packages/react/src/zone-gauge.d.cts +28 -0
  140. package/dist/types/packages/react/src/zone-gauge.d.ts +28 -0
  141. package/dist/types/shared/package-runtime/accordion-state.d.cts +2 -0
  142. package/dist/types/shared/package-runtime/accordion-state.d.ts +2 -0
  143. package/dist/types/shared/package-runtime/action-size.d.cts +4 -0
  144. package/dist/types/shared/package-runtime/action-size.d.ts +4 -0
  145. package/dist/types/shared/package-runtime/alert-action-size.d.cts +1 -0
  146. package/dist/types/shared/package-runtime/alert-action-size.d.ts +1 -0
  147. package/dist/types/shared/package-runtime/alert-actions.d.cts +7 -0
  148. package/dist/types/shared/package-runtime/alert-actions.d.ts +7 -0
  149. package/dist/types/shared/package-runtime/alert-exit.d.cts +6 -0
  150. package/dist/types/shared/package-runtime/alert-exit.d.ts +6 -0
  151. package/dist/types/shared/package-runtime/alert-live.d.cts +2 -0
  152. package/dist/types/shared/package-runtime/alert-live.d.ts +2 -0
  153. package/dist/types/shared/package-runtime/avatar-group.d.cts +18 -0
  154. package/dist/types/shared/package-runtime/avatar-group.d.ts +18 -0
  155. package/dist/types/shared/package-runtime/badge-tone.d.cts +8 -2
  156. package/dist/types/shared/package-runtime/badge-tone.d.ts +8 -2
  157. package/dist/types/shared/package-runtime/bottom-bar.d.cts +15 -0
  158. package/dist/types/shared/package-runtime/bottom-bar.d.ts +15 -0
  159. package/dist/types/shared/package-runtime/bottom-navigation.d.cts +30 -0
  160. package/dist/types/shared/package-runtime/bottom-navigation.d.ts +30 -0
  161. package/dist/types/shared/package-runtime/calendar.d.cts +21 -7
  162. package/dist/types/shared/package-runtime/calendar.d.ts +21 -7
  163. package/dist/types/shared/package-runtime/card-layout.d.cts +42 -0
  164. package/dist/types/shared/package-runtime/card-layout.d.ts +42 -0
  165. package/dist/types/shared/package-runtime/carousel-scroll.d.cts +2 -0
  166. package/dist/types/shared/package-runtime/carousel-scroll.d.ts +2 -0
  167. package/dist/types/shared/package-runtime/carousel.d.cts +12 -2
  168. package/dist/types/shared/package-runtime/carousel.d.ts +12 -2
  169. package/dist/types/shared/package-runtime/chart-skeleton.d.cts +2 -2
  170. package/dist/types/shared/package-runtime/chart-skeleton.d.ts +2 -2
  171. package/dist/types/shared/package-runtime/chip-size.d.cts +4 -0
  172. package/dist/types/shared/package-runtime/chip-size.d.ts +4 -0
  173. package/dist/types/shared/package-runtime/clipboard.d.cts +6 -0
  174. package/dist/types/shared/package-runtime/clipboard.d.ts +6 -0
  175. package/dist/types/shared/package-runtime/color-picker-model.d.cts +51 -0
  176. package/dist/types/shared/package-runtime/color-picker-model.d.ts +51 -0
  177. package/dist/types/shared/package-runtime/color-picker.d.cts +92 -0
  178. package/dist/types/shared/package-runtime/color-picker.d.ts +92 -0
  179. package/dist/types/shared/package-runtime/color.d.cts +22 -0
  180. package/dist/types/shared/package-runtime/color.d.ts +22 -0
  181. package/dist/types/shared/package-runtime/combobox-options.d.cts +13 -0
  182. package/dist/types/shared/package-runtime/combobox-options.d.ts +13 -0
  183. package/dist/types/shared/package-runtime/combobox.d.cts +3 -1
  184. package/dist/types/shared/package-runtime/combobox.d.ts +3 -1
  185. package/dist/types/shared/package-runtime/copy-button.d.cts +11 -0
  186. package/dist/types/shared/package-runtime/copy-button.d.ts +11 -0
  187. package/dist/types/shared/package-runtime/data-cells.d.cts +36 -0
  188. package/dist/types/shared/package-runtime/data-cells.d.ts +36 -0
  189. package/dist/types/shared/package-runtime/development.d.cts +4 -0
  190. package/dist/types/shared/package-runtime/development.d.ts +4 -0
  191. package/dist/types/shared/package-runtime/distribution.d.cts +168 -0
  192. package/dist/types/shared/package-runtime/distribution.d.ts +168 -0
  193. package/dist/types/shared/package-runtime/drawer-geometry.d.cts +7 -0
  194. package/dist/types/shared/package-runtime/drawer-geometry.d.ts +7 -0
  195. package/dist/types/shared/package-runtime/empty-geometry.d.cts +19 -0
  196. package/dist/types/shared/package-runtime/empty-geometry.d.ts +19 -0
  197. package/dist/types/shared/package-runtime/event-calendar.d.cts +81 -0
  198. package/dist/types/shared/package-runtime/event-calendar.d.ts +81 -0
  199. package/dist/types/shared/package-runtime/external-link.d.cts +4 -0
  200. package/dist/types/shared/package-runtime/external-link.d.ts +4 -0
  201. package/dist/types/shared/package-runtime/file-upload.d.cts +128 -0
  202. package/dist/types/shared/package-runtime/file-upload.d.ts +128 -0
  203. package/dist/types/shared/package-runtime/filter-scroll.d.cts +5 -0
  204. package/dist/types/shared/package-runtime/filter-scroll.d.ts +5 -0
  205. package/dist/types/shared/package-runtime/filter-value.d.cts +2 -0
  206. package/dist/types/shared/package-runtime/filter-value.d.ts +2 -0
  207. package/dist/types/shared/package-runtime/input-field.d.cts +23 -0
  208. package/dist/types/shared/package-runtime/input-field.d.ts +23 -0
  209. package/dist/types/shared/package-runtime/input-variant.d.cts +7 -0
  210. package/dist/types/shared/package-runtime/input-variant.d.ts +7 -0
  211. package/dist/types/shared/package-runtime/kpi.d.cts +102 -0
  212. package/dist/types/shared/package-runtime/kpi.d.ts +102 -0
  213. package/dist/types/shared/package-runtime/layer-state.d.cts +2 -1
  214. package/dist/types/shared/package-runtime/layer-state.d.ts +2 -1
  215. package/dist/types/shared/package-runtime/layout-primitives.d.cts +115 -6
  216. package/dist/types/shared/package-runtime/layout-primitives.d.ts +115 -6
  217. package/dist/types/shared/package-runtime/list-leading.d.cts +38 -0
  218. package/dist/types/shared/package-runtime/list-leading.d.ts +38 -0
  219. package/dist/types/shared/package-runtime/list-row.d.cts +152 -4
  220. package/dist/types/shared/package-runtime/list-row.d.ts +152 -4
  221. package/dist/types/shared/package-runtime/market-layout.d.cts +6 -2
  222. package/dist/types/shared/package-runtime/market-layout.d.ts +6 -2
  223. package/dist/types/shared/package-runtime/market-query.d.cts +21 -0
  224. package/dist/types/shared/package-runtime/market-query.d.ts +21 -0
  225. package/dist/types/shared/package-runtime/market-table.d.cts +32 -0
  226. package/dist/types/shared/package-runtime/market-table.d.ts +32 -0
  227. package/dist/types/shared/package-runtime/menu-button.d.cts +4 -0
  228. package/dist/types/shared/package-runtime/menu-button.d.ts +4 -0
  229. package/dist/types/shared/package-runtime/messages/ko.d.cts +101 -1
  230. package/dist/types/shared/package-runtime/messages/ko.d.ts +101 -1
  231. package/dist/types/shared/package-runtime/messages-context.d.cts +93 -1
  232. package/dist/types/shared/package-runtime/messages-context.d.ts +93 -1
  233. package/dist/types/shared/package-runtime/minimum-loading.d.cts +3 -0
  234. package/dist/types/shared/package-runtime/minimum-loading.d.ts +3 -0
  235. package/dist/types/shared/package-runtime/modal-geometry.d.cts +15 -0
  236. package/dist/types/shared/package-runtime/modal-geometry.d.ts +15 -0
  237. package/dist/types/shared/package-runtime/navigation.d.cts +9 -2
  238. package/dist/types/shared/package-runtime/navigation.d.ts +9 -2
  239. package/dist/types/shared/package-runtime/nested-controls.d.cts +7 -0
  240. package/dist/types/shared/package-runtime/nested-controls.d.ts +7 -0
  241. package/dist/types/shared/package-runtime/number-input.d.cts +63 -0
  242. package/dist/types/shared/package-runtime/number-input.d.ts +63 -0
  243. package/dist/types/shared/package-runtime/number-sign.d.cts +9 -0
  244. package/dist/types/shared/package-runtime/number-sign.d.ts +9 -0
  245. package/dist/types/shared/package-runtime/options.d.cts +25 -5
  246. package/dist/types/shared/package-runtime/options.d.ts +25 -5
  247. package/dist/types/shared/package-runtime/pagination.d.cts +12 -0
  248. package/dist/types/shared/package-runtime/pagination.d.ts +12 -0
  249. package/dist/types/shared/package-runtime/popover-scroll.d.cts +3 -0
  250. package/dist/types/shared/package-runtime/popover-scroll.d.ts +3 -0
  251. package/dist/types/shared/package-runtime/press-repeat.d.cts +13 -0
  252. package/dist/types/shared/package-runtime/press-repeat.d.ts +13 -0
  253. package/dist/types/shared/package-runtime/progress-circle.d.cts +5 -0
  254. package/dist/types/shared/package-runtime/progress-circle.d.ts +5 -0
  255. package/dist/types/shared/package-runtime/progress-marker.d.cts +7 -0
  256. package/dist/types/shared/package-runtime/progress-marker.d.ts +7 -0
  257. package/dist/types/shared/package-runtime/radio-keyboard.d.cts +2 -0
  258. package/dist/types/shared/package-runtime/radio-keyboard.d.ts +2 -0
  259. package/dist/types/shared/package-runtime/reorder-session.d.cts +62 -0
  260. package/dist/types/shared/package-runtime/reorder-session.d.ts +62 -0
  261. package/dist/types/shared/package-runtime/reorder.d.cts +81 -0
  262. package/dist/types/shared/package-runtime/reorder.d.ts +81 -0
  263. package/dist/types/shared/package-runtime/select-trigger.d.cts +23 -0
  264. package/dist/types/shared/package-runtime/select-trigger.d.ts +23 -0
  265. package/dist/types/shared/package-runtime/sheet-drag.d.cts +24 -0
  266. package/dist/types/shared/package-runtime/sheet-drag.d.ts +24 -0
  267. package/dist/types/shared/package-runtime/side-navigation-keys.d.cts +23 -0
  268. package/dist/types/shared/package-runtime/side-navigation-keys.d.ts +23 -0
  269. package/dist/types/shared/package-runtime/side-navigation-scroll.d.cts +7 -0
  270. package/dist/types/shared/package-runtime/side-navigation-scroll.d.ts +7 -0
  271. package/dist/types/shared/package-runtime/side-navigation.d.cts +277 -0
  272. package/dist/types/shared/package-runtime/side-navigation.d.ts +277 -0
  273. package/dist/types/shared/package-runtime/signed-number.d.cts +33 -0
  274. package/dist/types/shared/package-runtime/signed-number.d.ts +33 -0
  275. package/dist/types/shared/package-runtime/skeleton-text.d.cts +18 -0
  276. package/dist/types/shared/package-runtime/skeleton-text.d.ts +18 -0
  277. package/dist/types/shared/package-runtime/slider-view.d.cts +17 -2
  278. package/dist/types/shared/package-runtime/slider-view.d.ts +17 -2
  279. package/dist/types/shared/package-runtime/sparkline.d.cts +8 -4
  280. package/dist/types/shared/package-runtime/sparkline.d.ts +8 -4
  281. package/dist/types/shared/package-runtime/spinner-geometry.d.cts +14 -0
  282. package/dist/types/shared/package-runtime/spinner-geometry.d.ts +14 -0
  283. package/dist/types/shared/package-runtime/split-pane.d.cts +85 -0
  284. package/dist/types/shared/package-runtime/split-pane.d.ts +85 -0
  285. package/dist/types/shared/package-runtime/steps.d.cts +37 -0
  286. package/dist/types/shared/package-runtime/steps.d.ts +37 -0
  287. package/dist/types/shared/package-runtime/tab-keyboard.d.cts +6 -0
  288. package/dist/types/shared/package-runtime/tab-keyboard.d.ts +6 -0
  289. package/dist/types/shared/package-runtime/table-columns.d.cts +36 -0
  290. package/dist/types/shared/package-runtime/table-columns.d.ts +36 -0
  291. package/dist/types/shared/package-runtime/table-model.d.cts +23 -3
  292. package/dist/types/shared/package-runtime/table-model.d.ts +23 -3
  293. package/dist/types/shared/package-runtime/table-presentation.d.cts +33 -4
  294. package/dist/types/shared/package-runtime/table-presentation.d.ts +33 -4
  295. package/dist/types/shared/package-runtime/table.d.cts +44 -2
  296. package/dist/types/shared/package-runtime/table.d.ts +44 -2
  297. package/dist/types/shared/package-runtime/textarea.d.cts +6 -4
  298. package/dist/types/shared/package-runtime/textarea.d.ts +6 -4
  299. package/dist/types/shared/package-runtime/tiles-children.d.cts +7 -0
  300. package/dist/types/shared/package-runtime/tiles-children.d.ts +7 -0
  301. package/dist/types/shared/package-runtime/tiles.d.cts +18 -0
  302. package/dist/types/shared/package-runtime/tiles.d.ts +18 -0
  303. package/dist/types/shared/package-runtime/time-segments.d.cts +24 -0
  304. package/dist/types/shared/package-runtime/time-segments.d.ts +24 -0
  305. package/dist/types/shared/package-runtime/time-wheel.d.cts +54 -0
  306. package/dist/types/shared/package-runtime/time-wheel.d.ts +54 -0
  307. package/dist/types/shared/package-runtime/trailing-overflow.d.cts +1 -0
  308. package/dist/types/shared/package-runtime/trailing-overflow.d.ts +1 -0
  309. package/dist/types/shared/package-runtime/use-color-picker.d.cts +54 -0
  310. package/dist/types/shared/package-runtime/use-color-picker.d.ts +54 -0
  311. package/dist/types/shared/package-runtime/use-copy-feedback.d.cts +10 -0
  312. package/dist/types/shared/package-runtime/use-copy-feedback.d.ts +10 -0
  313. package/dist/types/shared/package-runtime/use-layer.d.cts +4 -2
  314. package/dist/types/shared/package-runtime/use-layer.d.ts +4 -2
  315. package/dist/types/shared/package-runtime/use-open-state.d.cts +5 -0
  316. package/dist/types/shared/package-runtime/use-open-state.d.ts +5 -0
  317. package/dist/types/shared/package-runtime/use-pending-action.d.cts +6 -0
  318. package/dist/types/shared/package-runtime/use-pending-action.d.ts +6 -0
  319. package/dist/types/shared/package-runtime/use-side-navigation-state.d.cts +25 -0
  320. package/dist/types/shared/package-runtime/use-side-navigation-state.d.ts +25 -0
  321. package/dist/types/shared/package-runtime/use-slide.d.cts +3 -0
  322. package/dist/types/shared/package-runtime/use-slide.d.ts +3 -0
  323. package/package.json +3 -3
  324. package/dist/types/packages/react/src/compound-control.d.cts +0 -1
  325. package/dist/types/packages/react/src/compound-control.d.ts +0 -1
  326. package/dist/types/shared/package-runtime/center-option.d.cts +0 -1
  327. package/dist/types/shared/package-runtime/center-option.d.ts +0 -1
@@ -1,4 +1,5 @@
1
- export interface KjunChipProps {
1
+ import { type HTMLAttributes } from "react";
2
+ export interface KjunChipProps extends Omit<HTMLAttributes<HTMLSpanElement>, "children"> {
2
3
  label: string;
3
4
  icon?: string;
4
5
  removable?: boolean;
@@ -7,4 +8,5 @@ export interface KjunChipProps {
7
8
  removeLabel?: string;
8
9
  onRemove?: () => void;
9
10
  }
10
- export declare function KjunChip({ label, icon, removable, disabled, size, removeLabel, onRemove }: KjunChipProps): import("react/jsx-runtime").JSX.Element;
11
+ /** The ref reaches the removal button, the chip's only focus target; it is null when the chip is not removable. */
12
+ export declare const KjunChip: import("react").ForwardRefExoticComponent<KjunChipProps & import("react").RefAttributes<HTMLButtonElement>>;
@@ -1,4 +1,5 @@
1
- export interface KjunChipProps {
1
+ import { type HTMLAttributes } from "react";
2
+ export interface KjunChipProps extends Omit<HTMLAttributes<HTMLSpanElement>, "children"> {
2
3
  label: string;
3
4
  icon?: string;
4
5
  removable?: boolean;
@@ -7,4 +8,5 @@ export interface KjunChipProps {
7
8
  removeLabel?: string;
8
9
  onRemove?: () => void;
9
10
  }
10
- export declare function KjunChip({ label, icon, removable, disabled, size, removeLabel, onRemove }: KjunChipProps): import("react/jsx-runtime").JSX.Element;
11
+ /** The ref reaches the removal button, the chip's only focus target; it is null when the chip is not removable. */
12
+ export declare const KjunChip: import("react").ForwardRefExoticComponent<KjunChipProps & import("react").RefAttributes<HTMLButtonElement>>;
@@ -0,0 +1,99 @@
1
+ import { type InputSize } from "@kjun-ui/tokens";
2
+ import { type ReactNode, type Ref } from "react";
3
+ export type ChoiceValue = string | number | boolean | null;
4
+ export interface ChoiceOption<T = ChoiceValue> {
5
+ value: T;
6
+ label: string;
7
+ disabled?: boolean;
8
+ icon?: string;
9
+ /** ButtonGroup only: show the icon alone in a square segment; label becomes the accessible name and tooltip. */
10
+ iconOnly?: boolean;
11
+ /** FilterGroup only: a count after the label ("진행 중 12"), joined to the label in the accessible name. A string is shown as given. */
12
+ count?: number | string;
13
+ dot?: string;
14
+ }
15
+ export interface KjunCheckboxProps<T = ChoiceValue> {
16
+ value: boolean | T[];
17
+ /** Mixed selection display; value and change callbacks keep their boolean/array shape. */
18
+ indeterminate?: boolean;
19
+ val?: T;
20
+ label?: string;
21
+ ariaLabel?: string;
22
+ disabled?: boolean;
23
+ size?: InputSize;
24
+ /** Supporting text under the label; it also describes the checkbox to screen readers. */
25
+ description?: string;
26
+ children?: ReactNode;
27
+ /** Submits with a form under this name while checked. */
28
+ name?: string;
29
+ /** The value a form submits while checked (default "on"). */
30
+ formValue?: string;
31
+ /** The checkbox input's id, e.g. to reach it from an outside <label for>. */
32
+ id?: string;
33
+ /** The checkbox's input, e.g. to move focus to the first box of a group that failed validation. */
34
+ inputRef?: Ref<HTMLInputElement>;
35
+ onValueChange?: (value: boolean | T[]) => void;
36
+ onChange?: (value: boolean | T[]) => void;
37
+ }
38
+ export declare function KjunCheckbox<T = ChoiceValue>({ value, indeterminate, val, label, ariaLabel, disabled, size, description, children, name, formValue, id, inputRef, onValueChange, onChange, }: KjunCheckboxProps<T>): import("react/jsx-runtime").JSX.Element;
39
+ export interface KjunSwitchProps {
40
+ value: boolean;
41
+ label?: string;
42
+ ariaLabel?: string;
43
+ disabled?: boolean;
44
+ size?: InputSize;
45
+ /** Supporting text under the label; it also describes the switch to screen readers. */
46
+ description?: string;
47
+ /** Saving: a spinner turns in the thumb and presses are ignored, without dimming the switch like disabled. */
48
+ loading?: boolean;
49
+ children?: ReactNode;
50
+ /** Submits with a form under this name while the switch is on. */
51
+ name?: string;
52
+ /** The value a form submits while on (default "on"). */
53
+ formValue?: string;
54
+ id?: string;
55
+ autoFocus?: boolean;
56
+ onFocus?: () => void;
57
+ onBlur?: () => void;
58
+ /** The switch's input, e.g. to move focus back after a failed save. */
59
+ inputRef?: Ref<HTMLInputElement>;
60
+ onValueChange?: (value: boolean) => void;
61
+ onChange?: (value: boolean) => void;
62
+ }
63
+ export declare function KjunSwitch({ value, label, ariaLabel, disabled, size, description, loading, children, name, formValue, id, autoFocus, onFocus, onBlur, inputRef, onValueChange, onChange, }: KjunSwitchProps): import("react/jsx-runtime").JSX.Element;
64
+ export interface KjunRadioProps {
65
+ value?: ChoiceValue;
66
+ val: ChoiceValue;
67
+ label?: string;
68
+ disabled?: boolean;
69
+ name?: string;
70
+ ariaLabel?: string;
71
+ /** Inside a RadioGroup the group's size applies unless this is set. */
72
+ size?: InputSize;
73
+ /** Supporting text under the label; it also describes the radio to screen readers. */
74
+ description?: string;
75
+ children?: ReactNode;
76
+ /** The radio input's id, e.g. to reach it from an outside <label for>. */
77
+ id?: string;
78
+ /** The radio's input, e.g. to move focus to it from code. */
79
+ inputRef?: Ref<HTMLInputElement>;
80
+ onValueChange?: (value: ChoiceValue) => void;
81
+ onChange?: (value: ChoiceValue) => void;
82
+ }
83
+ export declare function KjunRadio({ value, val, label, disabled, name, ariaLabel, size, description, children, id, inputRef, onValueChange, onChange, }: KjunRadioProps): import("react/jsx-runtime").JSX.Element;
84
+ export interface KjunRadioGroupProps {
85
+ value: ChoiceValue;
86
+ options?: ChoiceOption[];
87
+ direction?: "horizontal" | "vertical";
88
+ ariaLabel?: string;
89
+ /** Size of every radio in the group. */
90
+ size?: InputSize;
91
+ /** Disables every radio in the group. */
92
+ disabled?: boolean;
93
+ /** The form field name the chosen radio submits under (default: a generated name). */
94
+ name?: string;
95
+ children?: ReactNode;
96
+ onValueChange?: (value: ChoiceValue) => void;
97
+ onChange?: (value: ChoiceValue) => void;
98
+ }
99
+ export declare function KjunRadioGroup({ value, options, direction, ariaLabel, size, disabled, name, children, onValueChange, onChange, }: KjunRadioGroupProps): import("react/jsx-runtime").JSX.Element;
@@ -0,0 +1,99 @@
1
+ import { type InputSize } from "@kjun-ui/tokens";
2
+ import { type ReactNode, type Ref } from "react";
3
+ export type ChoiceValue = string | number | boolean | null;
4
+ export interface ChoiceOption<T = ChoiceValue> {
5
+ value: T;
6
+ label: string;
7
+ disabled?: boolean;
8
+ icon?: string;
9
+ /** ButtonGroup only: show the icon alone in a square segment; label becomes the accessible name and tooltip. */
10
+ iconOnly?: boolean;
11
+ /** FilterGroup only: a count after the label ("진행 중 12"), joined to the label in the accessible name. A string is shown as given. */
12
+ count?: number | string;
13
+ dot?: string;
14
+ }
15
+ export interface KjunCheckboxProps<T = ChoiceValue> {
16
+ value: boolean | T[];
17
+ /** Mixed selection display; value and change callbacks keep their boolean/array shape. */
18
+ indeterminate?: boolean;
19
+ val?: T;
20
+ label?: string;
21
+ ariaLabel?: string;
22
+ disabled?: boolean;
23
+ size?: InputSize;
24
+ /** Supporting text under the label; it also describes the checkbox to screen readers. */
25
+ description?: string;
26
+ children?: ReactNode;
27
+ /** Submits with a form under this name while checked. */
28
+ name?: string;
29
+ /** The value a form submits while checked (default "on"). */
30
+ formValue?: string;
31
+ /** The checkbox input's id, e.g. to reach it from an outside <label for>. */
32
+ id?: string;
33
+ /** The checkbox's input, e.g. to move focus to the first box of a group that failed validation. */
34
+ inputRef?: Ref<HTMLInputElement>;
35
+ onValueChange?: (value: boolean | T[]) => void;
36
+ onChange?: (value: boolean | T[]) => void;
37
+ }
38
+ export declare function KjunCheckbox<T = ChoiceValue>({ value, indeterminate, val, label, ariaLabel, disabled, size, description, children, name, formValue, id, inputRef, onValueChange, onChange, }: KjunCheckboxProps<T>): import("react/jsx-runtime").JSX.Element;
39
+ export interface KjunSwitchProps {
40
+ value: boolean;
41
+ label?: string;
42
+ ariaLabel?: string;
43
+ disabled?: boolean;
44
+ size?: InputSize;
45
+ /** Supporting text under the label; it also describes the switch to screen readers. */
46
+ description?: string;
47
+ /** Saving: a spinner turns in the thumb and presses are ignored, without dimming the switch like disabled. */
48
+ loading?: boolean;
49
+ children?: ReactNode;
50
+ /** Submits with a form under this name while the switch is on. */
51
+ name?: string;
52
+ /** The value a form submits while on (default "on"). */
53
+ formValue?: string;
54
+ id?: string;
55
+ autoFocus?: boolean;
56
+ onFocus?: () => void;
57
+ onBlur?: () => void;
58
+ /** The switch's input, e.g. to move focus back after a failed save. */
59
+ inputRef?: Ref<HTMLInputElement>;
60
+ onValueChange?: (value: boolean) => void;
61
+ onChange?: (value: boolean) => void;
62
+ }
63
+ export declare function KjunSwitch({ value, label, ariaLabel, disabled, size, description, loading, children, name, formValue, id, autoFocus, onFocus, onBlur, inputRef, onValueChange, onChange, }: KjunSwitchProps): import("react/jsx-runtime").JSX.Element;
64
+ export interface KjunRadioProps {
65
+ value?: ChoiceValue;
66
+ val: ChoiceValue;
67
+ label?: string;
68
+ disabled?: boolean;
69
+ name?: string;
70
+ ariaLabel?: string;
71
+ /** Inside a RadioGroup the group's size applies unless this is set. */
72
+ size?: InputSize;
73
+ /** Supporting text under the label; it also describes the radio to screen readers. */
74
+ description?: string;
75
+ children?: ReactNode;
76
+ /** The radio input's id, e.g. to reach it from an outside <label for>. */
77
+ id?: string;
78
+ /** The radio's input, e.g. to move focus to it from code. */
79
+ inputRef?: Ref<HTMLInputElement>;
80
+ onValueChange?: (value: ChoiceValue) => void;
81
+ onChange?: (value: ChoiceValue) => void;
82
+ }
83
+ export declare function KjunRadio({ value, val, label, disabled, name, ariaLabel, size, description, children, id, inputRef, onValueChange, onChange, }: KjunRadioProps): import("react/jsx-runtime").JSX.Element;
84
+ export interface KjunRadioGroupProps {
85
+ value: ChoiceValue;
86
+ options?: ChoiceOption[];
87
+ direction?: "horizontal" | "vertical";
88
+ ariaLabel?: string;
89
+ /** Size of every radio in the group. */
90
+ size?: InputSize;
91
+ /** Disables every radio in the group. */
92
+ disabled?: boolean;
93
+ /** The form field name the chosen radio submits under (default: a generated name). */
94
+ name?: string;
95
+ children?: ReactNode;
96
+ onValueChange?: (value: ChoiceValue) => void;
97
+ onChange?: (value: ChoiceValue) => void;
98
+ }
99
+ export declare function KjunRadioGroup({ value, options, direction, ariaLabel, size, disabled, name, children, onValueChange, onChange, }: KjunRadioGroupProps): import("react/jsx-runtime").JSX.Element;
@@ -1,7 +1,10 @@
1
1
  import { type ReactNode } from "react";
2
2
  /** keepMounted: once opened, the body stays mounted (inert, hidden from assistive technology) while closed. */
3
- export declare function Collapse({ open, keepMounted, children }: {
3
+ /** onSettled reports a finished change of state (opened or closed), once its height motion has ended; not the first render,
4
+ * a change that was reversed before it finished, or the body resizing while open. */
5
+ export declare function Collapse({ open, keepMounted, onSettled, children }: {
4
6
  open: boolean;
5
7
  keepMounted?: boolean;
8
+ onSettled?: (open: boolean) => void;
6
9
  children: ReactNode;
7
10
  }): import("react/jsx-runtime").JSX.Element | null;
@@ -1,7 +1,10 @@
1
1
  import { type ReactNode } from "react";
2
2
  /** keepMounted: once opened, the body stays mounted (inert, hidden from assistive technology) while closed. */
3
- export declare function Collapse({ open, keepMounted, children }: {
3
+ /** onSettled reports a finished change of state (opened or closed), once its height motion has ended; not the first render,
4
+ * a change that was reversed before it finished, or the body resizing while open. */
5
+ export declare function Collapse({ open, keepMounted, onSettled, children }: {
4
6
  open: boolean;
5
7
  keepMounted?: boolean;
8
+ onSettled?: (open: boolean) => void;
6
9
  children: ReactNode;
7
10
  }): import("react/jsx-runtime").JSX.Element | null;
@@ -0,0 +1,58 @@
1
+ import { type Hsv } from "../../../shared/package-runtime/color.cjs";
2
+ /** Drag reports through onMove between onStart and onEnd; a key is a whole pick through onPick. */
3
+ export interface DragHandlers<T> {
4
+ onMove: (value: T) => void;
5
+ onPick: (value: T) => void;
6
+ onStart: () => void;
7
+ onEnd: () => void;
8
+ }
9
+ /** The saturation/brightness area; with no value yet (empty) it shows a hint instead of a thumb. */
10
+ export declare function ColorArea({ hsv, label, valueText, empty, hint, areaRef, onMove, onPick, onStart, onEnd }: {
11
+ hsv: Hsv;
12
+ label: string;
13
+ valueText: string;
14
+ empty: boolean;
15
+ hint: string;
16
+ areaRef: (el: HTMLElement | null) => void;
17
+ } & DragHandlers<Hsv>): import("react/jsx-runtime").JSX.Element;
18
+ export declare function ColorChannel({ channel, value, max, label, valueText, color, onMove, onPick, onStart, onEnd }: {
19
+ channel: "hue" | "alpha";
20
+ value: number;
21
+ max: number;
22
+ label: string;
23
+ valueText: string;
24
+ color: string;
25
+ } & DragHandlers<number>): import("react/jsx-runtime").JSX.Element;
26
+ /** One radio group of color items; "no color" is the item whose value is null. */
27
+ export declare function SwatchGrid({ items, selected, label, onPick, swatchRef }: {
28
+ items: {
29
+ value: string | null;
30
+ label: string;
31
+ }[];
32
+ selected: number;
33
+ label: string;
34
+ onPick: (value: string | null) => void;
35
+ swatchRef?: (index: number, el: HTMLButtonElement | null) => void;
36
+ }): import("react/jsx-runtime").JSX.Element;
37
+ /** A swatch row under a caption (the swatches when recent colors show too, and the recent colors). */
38
+ export declare function SwatchGroup({ caption, ...grid }: {
39
+ caption: string;
40
+ } & Parameters<typeof SwatchGrid>[0]): import("react/jsx-runtime").JSX.Element;
41
+ /** The eyedropper button and the hex and % fields. Typing changes the value once a code is complete;
42
+ * Enter or leaving a field commits it (a short code expands, a bad one reverts). */
43
+ export declare function ColorInputs({ fields, value, alpha, alphaPercent, clearable, hexLabel, alphaLabel, eyeDropper, onEdit, onCommit, hexRef }: {
44
+ fields: boolean;
45
+ value: string | null;
46
+ alpha: boolean;
47
+ alphaPercent: number;
48
+ clearable: boolean;
49
+ hexLabel: string;
50
+ alphaLabel: string;
51
+ eyeDropper: {
52
+ label: string;
53
+ onPick: () => void;
54
+ } | null;
55
+ onEdit: (live: string | null) => void;
56
+ onCommit: (next: string | null | "revert") => void;
57
+ hexRef: (el: HTMLInputElement | null) => void;
58
+ }): import("react/jsx-runtime").JSX.Element;
@@ -0,0 +1,58 @@
1
+ import { type Hsv } from "../../../shared/package-runtime/color.js";
2
+ /** Drag reports through onMove between onStart and onEnd; a key is a whole pick through onPick. */
3
+ export interface DragHandlers<T> {
4
+ onMove: (value: T) => void;
5
+ onPick: (value: T) => void;
6
+ onStart: () => void;
7
+ onEnd: () => void;
8
+ }
9
+ /** The saturation/brightness area; with no value yet (empty) it shows a hint instead of a thumb. */
10
+ export declare function ColorArea({ hsv, label, valueText, empty, hint, areaRef, onMove, onPick, onStart, onEnd }: {
11
+ hsv: Hsv;
12
+ label: string;
13
+ valueText: string;
14
+ empty: boolean;
15
+ hint: string;
16
+ areaRef: (el: HTMLElement | null) => void;
17
+ } & DragHandlers<Hsv>): import("react/jsx-runtime").JSX.Element;
18
+ export declare function ColorChannel({ channel, value, max, label, valueText, color, onMove, onPick, onStart, onEnd }: {
19
+ channel: "hue" | "alpha";
20
+ value: number;
21
+ max: number;
22
+ label: string;
23
+ valueText: string;
24
+ color: string;
25
+ } & DragHandlers<number>): import("react/jsx-runtime").JSX.Element;
26
+ /** One radio group of color items; "no color" is the item whose value is null. */
27
+ export declare function SwatchGrid({ items, selected, label, onPick, swatchRef }: {
28
+ items: {
29
+ value: string | null;
30
+ label: string;
31
+ }[];
32
+ selected: number;
33
+ label: string;
34
+ onPick: (value: string | null) => void;
35
+ swatchRef?: (index: number, el: HTMLButtonElement | null) => void;
36
+ }): import("react/jsx-runtime").JSX.Element;
37
+ /** A swatch row under a caption (the swatches when recent colors show too, and the recent colors). */
38
+ export declare function SwatchGroup({ caption, ...grid }: {
39
+ caption: string;
40
+ } & Parameters<typeof SwatchGrid>[0]): import("react/jsx-runtime").JSX.Element;
41
+ /** The eyedropper button and the hex and % fields. Typing changes the value once a code is complete;
42
+ * Enter or leaving a field commits it (a short code expands, a bad one reverts). */
43
+ export declare function ColorInputs({ fields, value, alpha, alphaPercent, clearable, hexLabel, alphaLabel, eyeDropper, onEdit, onCommit, hexRef }: {
44
+ fields: boolean;
45
+ value: string | null;
46
+ alpha: boolean;
47
+ alphaPercent: number;
48
+ clearable: boolean;
49
+ hexLabel: string;
50
+ alphaLabel: string;
51
+ eyeDropper: {
52
+ label: string;
53
+ onPick: () => void;
54
+ } | null;
55
+ onEdit: (live: string | null) => void;
56
+ onCommit: (next: string | null | "revert") => void;
57
+ hexRef: (el: HTMLInputElement | null) => void;
58
+ }): import("react/jsx-runtime").JSX.Element;
@@ -0,0 +1,58 @@
1
+ import { type CSSProperties, type ReactNode } from "react";
2
+ import { type InputSize } from "@kjun-ui/tokens";
3
+ import { type ColorSwatchInput } from "../../../shared/package-runtime/color-picker.cjs";
4
+ export type KjunColorSwatch = ColorSwatchInput;
5
+ export interface KjunColorPickerProps {
6
+ /** Uppercase #RRGGBB (#RRGGBBAA with alpha), or null for no color. */
7
+ value?: string | null;
8
+ defaultValue?: string | null;
9
+ /** Every change, also while dragging. */
10
+ onValueChange?: (value: string | null) => void;
11
+ /** Once per finished pick: drag released, swatch, key or eyedropper, hex or % field entered (Enter or leaving it). */
12
+ onChangeCommit?: (value: string | null) => void;
13
+ /** Colors the app offers; strings or { value, label }. A label names the color on the trigger and in the swatch's tooltip. */
14
+ swatches?: KjunColorSwatch[];
15
+ /** Saturation/brightness area and hue slider. */
16
+ custom?: boolean;
17
+ /** Opacity slider and % field; the value always carries AA. */
18
+ alpha?: boolean;
19
+ /** Hex field. */
20
+ input?: boolean;
21
+ /** A "no color" swatch that sets the value to null. */
22
+ clearable?: boolean;
23
+ /** Recent colors the app keeps (strings or { value, label }); giving it shows a "recent" row of up to 8 under the swatches,
24
+ * leaving out colors the swatches already offer. */
25
+ recentColors?: KjunColorSwatch[];
26
+ /** The next recent colors, once the panel closes on a new value: that value first, at most 8. Store it to keep the row. */
27
+ onRecentColorsChange?: (colors: string[]) => void;
28
+ /** A button that picks a color from the screen, where the browser has an EyeDropper (Chromium desktop); hidden elsewhere. */
29
+ eyeDropper?: boolean;
30
+ open?: boolean;
31
+ defaultOpen?: boolean;
32
+ onOpenChange?: (open: boolean) => void;
33
+ size?: InputSize;
34
+ placeholder?: string;
35
+ ariaLabel?: string;
36
+ error?: boolean;
37
+ disabled?: boolean;
38
+ readOnly?: boolean;
39
+ /** Trigger id for an outside <label for>; defaults to the FormGroup's id. */
40
+ id?: string;
41
+ /** Submits the value with a form through a hidden input. */
42
+ name?: string;
43
+ /** Draws the panel in the page flow, without a trigger: a filled 240px block for settings screens. open, size, placeholder,
44
+ * variant and renderTrigger do not apply. Recent colors move after each finished pick that did not come from the recent row. */
45
+ inline?: boolean;
46
+ /** "swatch" draws a square color button as tall as the field (for toolbars) instead of the field trigger. */
47
+ variant?: "field" | "swatch";
48
+ /** With variant="swatch": an icon over a bar of the color, on a clear button (a text-color tool). */
49
+ icon?: string;
50
+ /** Draws the trigger's content; the trigger button and its accessibility stay KJUN's. */
51
+ renderTrigger?: (state: {
52
+ value: string | null;
53
+ open: boolean;
54
+ }) => ReactNode;
55
+ className?: string;
56
+ style?: CSSProperties;
57
+ }
58
+ export declare function KjunColorPicker({ value, defaultValue, onValueChange, onChangeCommit, swatches: rawSwatches, custom, alpha, input, clearable, recentColors, onRecentColorsChange, eyeDropper, open: openGiven, defaultOpen, onOpenChange, size, placeholder, ariaLabel, error, disabled, readOnly, id, name, inline, variant, icon, renderTrigger, className, style, }: KjunColorPickerProps): import("react/jsx-runtime").JSX.Element;
@@ -0,0 +1,58 @@
1
+ import { type CSSProperties, type ReactNode } from "react";
2
+ import { type InputSize } from "@kjun-ui/tokens";
3
+ import { type ColorSwatchInput } from "../../../shared/package-runtime/color-picker.js";
4
+ export type KjunColorSwatch = ColorSwatchInput;
5
+ export interface KjunColorPickerProps {
6
+ /** Uppercase #RRGGBB (#RRGGBBAA with alpha), or null for no color. */
7
+ value?: string | null;
8
+ defaultValue?: string | null;
9
+ /** Every change, also while dragging. */
10
+ onValueChange?: (value: string | null) => void;
11
+ /** Once per finished pick: drag released, swatch, key or eyedropper, hex or % field entered (Enter or leaving it). */
12
+ onChangeCommit?: (value: string | null) => void;
13
+ /** Colors the app offers; strings or { value, label }. A label names the color on the trigger and in the swatch's tooltip. */
14
+ swatches?: KjunColorSwatch[];
15
+ /** Saturation/brightness area and hue slider. */
16
+ custom?: boolean;
17
+ /** Opacity slider and % field; the value always carries AA. */
18
+ alpha?: boolean;
19
+ /** Hex field. */
20
+ input?: boolean;
21
+ /** A "no color" swatch that sets the value to null. */
22
+ clearable?: boolean;
23
+ /** Recent colors the app keeps (strings or { value, label }); giving it shows a "recent" row of up to 8 under the swatches,
24
+ * leaving out colors the swatches already offer. */
25
+ recentColors?: KjunColorSwatch[];
26
+ /** The next recent colors, once the panel closes on a new value: that value first, at most 8. Store it to keep the row. */
27
+ onRecentColorsChange?: (colors: string[]) => void;
28
+ /** A button that picks a color from the screen, where the browser has an EyeDropper (Chromium desktop); hidden elsewhere. */
29
+ eyeDropper?: boolean;
30
+ open?: boolean;
31
+ defaultOpen?: boolean;
32
+ onOpenChange?: (open: boolean) => void;
33
+ size?: InputSize;
34
+ placeholder?: string;
35
+ ariaLabel?: string;
36
+ error?: boolean;
37
+ disabled?: boolean;
38
+ readOnly?: boolean;
39
+ /** Trigger id for an outside <label for>; defaults to the FormGroup's id. */
40
+ id?: string;
41
+ /** Submits the value with a form through a hidden input. */
42
+ name?: string;
43
+ /** Draws the panel in the page flow, without a trigger: a filled 240px block for settings screens. open, size, placeholder,
44
+ * variant and renderTrigger do not apply. Recent colors move after each finished pick that did not come from the recent row. */
45
+ inline?: boolean;
46
+ /** "swatch" draws a square color button as tall as the field (for toolbars) instead of the field trigger. */
47
+ variant?: "field" | "swatch";
48
+ /** With variant="swatch": an icon over a bar of the color, on a clear button (a text-color tool). */
49
+ icon?: string;
50
+ /** Draws the trigger's content; the trigger button and its accessibility stay KJUN's. */
51
+ renderTrigger?: (state: {
52
+ value: string | null;
53
+ open: boolean;
54
+ }) => ReactNode;
55
+ className?: string;
56
+ style?: CSSProperties;
57
+ }
58
+ export declare function KjunColorPicker({ value, defaultValue, onValueChange, onChangeCommit, swatches: rawSwatches, custom, alpha, input, clearable, recentColors, onRecentColorsChange, eyeDropper, open: openGiven, defaultOpen, onOpenChange, size, placeholder, ariaLabel, error, disabled, readOnly, id, name, inline, variant, icon, renderTrigger, className, style, }: KjunColorPickerProps): import("react/jsx-runtime").JSX.Element;
@@ -1,5 +1,6 @@
1
1
  import { type InputSize } from "@kjun-ui/tokens";
2
- import { type ReactNode } from "react";
2
+ import { type ReactNode, type Ref } from "react";
3
+ import { type KjunInputProps } from "./input.cjs";
3
4
  import { type FocusReturn } from "./floating-panel.cjs";
4
5
  import { OptionValue, SelectOption } from "./select-options.cjs";
5
6
  export interface KjunComboboxProps<T extends SelectOption = SelectOption> {
@@ -9,13 +10,18 @@ export interface KjunComboboxProps<T extends SelectOption = SelectOption> {
9
10
  ariaLabel?: string;
10
11
  labelKey?: string;
11
12
  valueKey?: string;
13
+ /** Replaces the default ranked label/searchKeys match; results keep the original order. */
12
14
  filterFn?: (option: T, query: string) => boolean;
15
+ /** Option fields searched besides the label; matches rank after label matches. */
16
+ searchKeys?: string[];
13
17
  size?: InputSize;
14
18
  disabled?: boolean;
15
19
  error?: boolean;
16
20
  clearable?: boolean;
17
21
  emptyText?: string;
18
- renderOption?: (option: T) => ReactNode;
22
+ /** Candidates are being fetched: the list shows a searching row and options cannot be chosen. */
23
+ loading?: boolean;
24
+ renderOption?: (option: T, selected: boolean) => ReactNode;
19
25
  onValueChange?: (v: OptionValue | null) => void;
20
26
  onChange?: (v: OptionValue | null) => void;
21
27
  onSearch?: (v: string) => void;
@@ -23,7 +29,7 @@ export interface KjunComboboxProps<T extends SelectOption = SelectOption> {
23
29
  /** Where focus goes after choosing an option or Escape. Closing while typing keeps focus in the input. Web only. */
24
30
  returnFocus?: FocusReturn;
25
31
  }
26
- export declare function KjunCombobox<T extends SelectOption = SelectOption>({ value, options, placeholder, ariaLabel, labelKey, valueKey, filterFn, size, disabled, error, clearable, emptyText, renderOption, onValueChange, onChange, onSearch, onClear, returnFocus, }: KjunComboboxProps<T>): import("react/jsx-runtime").JSX.Element;
32
+ export declare function KjunCombobox<T extends SelectOption = SelectOption>({ value, options, placeholder, ariaLabel, labelKey, valueKey, filterFn, searchKeys, size, disabled, error, clearable, emptyText, loading, renderOption, onValueChange, onChange, onSearch, onClear, returnFocus, }: KjunComboboxProps<T>): import("react/jsx-runtime").JSX.Element;
27
33
  export interface SearchFieldProps<T extends SelectOption> {
28
34
  value: string;
29
35
  size: InputSize;
@@ -42,11 +48,18 @@ export interface SearchFieldProps<T extends SelectOption> {
42
48
  /** A failed request; shown instead of the empty text so the two never look alike. */
43
49
  failed?: boolean;
44
50
  errorText?: string;
45
- renderOption?: (o: T) => ReactNode;
51
+ /** The field's chosen option: checked in the list and highlighted when the list opens. */
52
+ isSelected?: (o: T) => boolean;
53
+ renderOption?: (o: T, selected: boolean) => ReactNode;
46
54
  onValueChange: (v: string) => void;
47
55
  onSelect: (o: T) => void;
48
56
  onClear?: () => void;
49
57
  onEnter?: () => void;
50
58
  returnFocus?: () => HTMLElement | null;
59
+ /** SearchInput's own input attributes (id, name, className, autoFocus, focus handlers) and its ref. */
60
+ inputProps?: SearchFieldInputProps;
61
+ inputRef?: Ref<HTMLInputElement>;
51
62
  }
52
- export declare function SearchField<T extends SelectOption>({ value, size, placeholder, ariaLabel, disabled, error, clearable, open, onOpenChange, options, labelKey, itemKey, emptyText, loading, failed, errorText, renderOption, onValueChange, onSelect, onClear, onEnter, returnFocus, }: SearchFieldProps<T>): import("react/jsx-runtime").JSX.Element;
63
+ /** Input attributes a search field passes through; the field owns value, typing, keys and the popup wiring. */
64
+ export type SearchFieldInputProps = Omit<KjunInputProps, "value" | "size" | "placeholder" | "ariaLabel" | "disabled" | "error" | "clearable" | "prefixIcon" | "role" | "onValueChange" | "onClear" | "onEnter" | "onChange" | "onKeyDown" | "onClick" | "onCompositionStart" | "onCompositionEnd">;
65
+ export declare function SearchField<T extends SelectOption>({ value, size, placeholder, ariaLabel, disabled, error, clearable, open, onOpenChange, options, labelKey, itemKey, emptyText, loading, failed, errorText, isSelected, renderOption, onValueChange, onSelect, onClear, onEnter, returnFocus, inputProps, inputRef, }: SearchFieldProps<T>): import("react/jsx-runtime").JSX.Element;
@@ -1,5 +1,6 @@
1
1
  import { type InputSize } from "@kjun-ui/tokens";
2
- import { type ReactNode } from "react";
2
+ import { type ReactNode, type Ref } from "react";
3
+ import { type KjunInputProps } from "./input.js";
3
4
  import { type FocusReturn } from "./floating-panel.js";
4
5
  import { OptionValue, SelectOption } from "./select-options.js";
5
6
  export interface KjunComboboxProps<T extends SelectOption = SelectOption> {
@@ -9,13 +10,18 @@ export interface KjunComboboxProps<T extends SelectOption = SelectOption> {
9
10
  ariaLabel?: string;
10
11
  labelKey?: string;
11
12
  valueKey?: string;
13
+ /** Replaces the default ranked label/searchKeys match; results keep the original order. */
12
14
  filterFn?: (option: T, query: string) => boolean;
15
+ /** Option fields searched besides the label; matches rank after label matches. */
16
+ searchKeys?: string[];
13
17
  size?: InputSize;
14
18
  disabled?: boolean;
15
19
  error?: boolean;
16
20
  clearable?: boolean;
17
21
  emptyText?: string;
18
- renderOption?: (option: T) => ReactNode;
22
+ /** Candidates are being fetched: the list shows a searching row and options cannot be chosen. */
23
+ loading?: boolean;
24
+ renderOption?: (option: T, selected: boolean) => ReactNode;
19
25
  onValueChange?: (v: OptionValue | null) => void;
20
26
  onChange?: (v: OptionValue | null) => void;
21
27
  onSearch?: (v: string) => void;
@@ -23,7 +29,7 @@ export interface KjunComboboxProps<T extends SelectOption = SelectOption> {
23
29
  /** Where focus goes after choosing an option or Escape. Closing while typing keeps focus in the input. Web only. */
24
30
  returnFocus?: FocusReturn;
25
31
  }
26
- export declare function KjunCombobox<T extends SelectOption = SelectOption>({ value, options, placeholder, ariaLabel, labelKey, valueKey, filterFn, size, disabled, error, clearable, emptyText, renderOption, onValueChange, onChange, onSearch, onClear, returnFocus, }: KjunComboboxProps<T>): import("react/jsx-runtime").JSX.Element;
32
+ export declare function KjunCombobox<T extends SelectOption = SelectOption>({ value, options, placeholder, ariaLabel, labelKey, valueKey, filterFn, searchKeys, size, disabled, error, clearable, emptyText, loading, renderOption, onValueChange, onChange, onSearch, onClear, returnFocus, }: KjunComboboxProps<T>): import("react/jsx-runtime").JSX.Element;
27
33
  export interface SearchFieldProps<T extends SelectOption> {
28
34
  value: string;
29
35
  size: InputSize;
@@ -42,11 +48,18 @@ export interface SearchFieldProps<T extends SelectOption> {
42
48
  /** A failed request; shown instead of the empty text so the two never look alike. */
43
49
  failed?: boolean;
44
50
  errorText?: string;
45
- renderOption?: (o: T) => ReactNode;
51
+ /** The field's chosen option: checked in the list and highlighted when the list opens. */
52
+ isSelected?: (o: T) => boolean;
53
+ renderOption?: (o: T, selected: boolean) => ReactNode;
46
54
  onValueChange: (v: string) => void;
47
55
  onSelect: (o: T) => void;
48
56
  onClear?: () => void;
49
57
  onEnter?: () => void;
50
58
  returnFocus?: () => HTMLElement | null;
59
+ /** SearchInput's own input attributes (id, name, className, autoFocus, focus handlers) and its ref. */
60
+ inputProps?: SearchFieldInputProps;
61
+ inputRef?: Ref<HTMLInputElement>;
51
62
  }
52
- export declare function SearchField<T extends SelectOption>({ value, size, placeholder, ariaLabel, disabled, error, clearable, open, onOpenChange, options, labelKey, itemKey, emptyText, loading, failed, errorText, renderOption, onValueChange, onSelect, onClear, onEnter, returnFocus, }: SearchFieldProps<T>): import("react/jsx-runtime").JSX.Element;
63
+ /** Input attributes a search field passes through; the field owns value, typing, keys and the popup wiring. */
64
+ export type SearchFieldInputProps = Omit<KjunInputProps, "value" | "size" | "placeholder" | "ariaLabel" | "disabled" | "error" | "clearable" | "prefixIcon" | "role" | "onValueChange" | "onClear" | "onEnter" | "onChange" | "onKeyDown" | "onClick" | "onCompositionStart" | "onCompositionEnd">;
65
+ export declare function SearchField<T extends SelectOption>({ value, size, placeholder, ariaLabel, disabled, error, clearable, open, onOpenChange, options, labelKey, itemKey, emptyText, loading, failed, errorText, isSelected, renderOption, onValueChange, onSelect, onClear, onEnter, returnFocus, inputProps, inputRef, }: SearchFieldProps<T>): import("react/jsx-runtime").JSX.Element;