@kjun-ui/react 0.21.0 → 0.23.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 (297) hide show
  1. package/README.md +19 -5
  2. package/dist/index.cjs +8795 -3753
  3. package/dist/index.js +9349 -4284
  4. package/dist/styles.css +2736 -480
  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 -4
  8. package/dist/types/packages/react/src/app-navigation.d.ts +14 -4
  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 +15 -6
  12. package/dist/types/packages/react/src/button.d.ts +15 -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.d.cts +10 -3
  16. package/dist/types/packages/react/src/card.d.ts +10 -3
  17. package/dist/types/packages/react/src/carousel.d.cts +8 -1
  18. package/dist/types/packages/react/src/carousel.d.ts +8 -1
  19. package/dist/types/packages/react/src/choice-controls.d.cts +99 -0
  20. package/dist/types/packages/react/src/choice-controls.d.ts +99 -0
  21. package/dist/types/packages/react/src/collapse.d.cts +4 -1
  22. package/dist/types/packages/react/src/collapse.d.ts +4 -1
  23. package/dist/types/packages/react/src/color-picker.d.cts +8 -1
  24. package/dist/types/packages/react/src/color-picker.d.ts +8 -1
  25. package/dist/types/packages/react/src/combobox.d.cts +18 -5
  26. package/dist/types/packages/react/src/combobox.d.ts +18 -5
  27. package/dist/types/packages/react/src/controls.d.cts +7 -74
  28. package/dist/types/packages/react/src/controls.d.ts +7 -74
  29. package/dist/types/packages/react/src/data-state.d.cts +19 -6
  30. package/dist/types/packages/react/src/data-state.d.ts +19 -6
  31. package/dist/types/packages/react/src/date-picker.d.cts +8 -2
  32. package/dist/types/packages/react/src/date-picker.d.ts +8 -2
  33. package/dist/types/packages/react/src/display.d.cts +33 -8
  34. package/dist/types/packages/react/src/display.d.ts +33 -8
  35. package/dist/types/packages/react/src/drawer.d.cts +11 -2
  36. package/dist/types/packages/react/src/drawer.d.ts +11 -2
  37. package/dist/types/packages/react/src/dropdown.d.cts +21 -6
  38. package/dist/types/packages/react/src/dropdown.d.ts +21 -6
  39. package/dist/types/packages/react/src/event-calendar.d.cts +47 -0
  40. package/dist/types/packages/react/src/event-calendar.d.ts +47 -0
  41. package/dist/types/packages/react/src/fab.d.cts +2 -0
  42. package/dist/types/packages/react/src/fab.d.ts +2 -0
  43. package/dist/types/packages/react/src/file-upload-row.d.cts +23 -0
  44. package/dist/types/packages/react/src/file-upload-row.d.ts +23 -0
  45. package/dist/types/packages/react/src/file-upload.d.cts +38 -0
  46. package/dist/types/packages/react/src/file-upload.d.ts +38 -0
  47. package/dist/types/packages/react/src/financial-display.d.cts +32 -11
  48. package/dist/types/packages/react/src/financial-display.d.ts +32 -11
  49. package/dist/types/packages/react/src/floating-panel.d.cts +6 -2
  50. package/dist/types/packages/react/src/floating-panel.d.ts +6 -2
  51. package/dist/types/packages/react/src/index.d.cts +12 -1
  52. package/dist/types/packages/react/src/index.d.ts +12 -1
  53. package/dist/types/packages/react/src/input.d.cts +27 -1
  54. package/dist/types/packages/react/src/input.d.ts +27 -1
  55. package/dist/types/packages/react/src/kpi-hero.d.cts +2 -0
  56. package/dist/types/packages/react/src/kpi-hero.d.ts +2 -0
  57. package/dist/types/packages/react/src/kpi-row.d.cts +5 -0
  58. package/dist/types/packages/react/src/kpi-row.d.ts +5 -0
  59. package/dist/types/packages/react/src/layout-primitives.d.cts +71 -139
  60. package/dist/types/packages/react/src/layout-primitives.d.ts +71 -139
  61. package/dist/types/packages/react/src/list-context.d.cts +2 -1
  62. package/dist/types/packages/react/src/list-context.d.ts +2 -1
  63. package/dist/types/packages/react/src/list.d.cts +49 -12
  64. package/dist/types/packages/react/src/list.d.ts +49 -12
  65. package/dist/types/packages/react/src/market-model.d.cts +15 -1
  66. package/dist/types/packages/react/src/market-model.d.ts +15 -1
  67. package/dist/types/packages/react/src/market-parts.d.cts +9 -0
  68. package/dist/types/packages/react/src/market-parts.d.ts +9 -0
  69. package/dist/types/packages/react/src/market-skeleton.d.cts +7 -1
  70. package/dist/types/packages/react/src/market-skeleton.d.ts +7 -1
  71. package/dist/types/packages/react/src/media.d.cts +6 -2
  72. package/dist/types/packages/react/src/media.d.ts +6 -2
  73. package/dist/types/packages/react/src/modal.d.cts +11 -2
  74. package/dist/types/packages/react/src/modal.d.ts +11 -2
  75. package/dist/types/packages/react/src/navigation.d.cts +34 -5
  76. package/dist/types/packages/react/src/navigation.d.ts +34 -5
  77. package/dist/types/packages/react/src/number-display.d.cts +8 -5
  78. package/dist/types/packages/react/src/number-display.d.ts +8 -5
  79. package/dist/types/packages/react/src/number-input.d.cts +28 -0
  80. package/dist/types/packages/react/src/number-input.d.ts +28 -0
  81. package/dist/types/packages/react/src/popover.d.cts +5 -2
  82. package/dist/types/packages/react/src/popover.d.ts +5 -2
  83. package/dist/types/packages/react/src/pressable.d.cts +17 -0
  84. package/dist/types/packages/react/src/pressable.d.ts +17 -0
  85. package/dist/types/packages/react/src/quantity-stepper.d.cts +3 -1
  86. package/dist/types/packages/react/src/quantity-stepper.d.ts +3 -1
  87. package/dist/types/packages/react/src/range-input.d.cts +15 -3
  88. package/dist/types/packages/react/src/range-input.d.ts +15 -3
  89. package/dist/types/packages/react/src/search-input.d.cts +6 -3
  90. package/dist/types/packages/react/src/search-input.d.ts +6 -3
  91. package/dist/types/packages/react/src/select-control.d.cts +7 -2
  92. package/dist/types/packages/react/src/select-control.d.ts +7 -2
  93. package/dist/types/packages/react/src/side-navigation-layout-spaces.d.cts +31 -0
  94. package/dist/types/packages/react/src/side-navigation-layout-spaces.d.ts +31 -0
  95. package/dist/types/packages/react/src/side-navigation-layout.d.cts +63 -0
  96. package/dist/types/packages/react/src/side-navigation-layout.d.ts +63 -0
  97. package/dist/types/packages/react/src/side-navigation.d.cts +74 -0
  98. package/dist/types/packages/react/src/side-navigation.d.ts +74 -0
  99. package/dist/types/packages/react/src/skeletons.d.cts +18 -3
  100. package/dist/types/packages/react/src/skeletons.d.ts +18 -3
  101. package/dist/types/packages/react/src/spinner-glyph.d.cts +8 -0
  102. package/dist/types/packages/react/src/spinner-glyph.d.ts +8 -0
  103. package/dist/types/packages/react/src/split-pane.d.cts +20 -5
  104. package/dist/types/packages/react/src/split-pane.d.ts +20 -5
  105. package/dist/types/packages/react/src/stacked-bar.d.cts +3 -1
  106. package/dist/types/packages/react/src/stacked-bar.d.ts +3 -1
  107. package/dist/types/packages/react/src/steps.d.cts +27 -0
  108. package/dist/types/packages/react/src/steps.d.ts +27 -0
  109. package/dist/types/packages/react/src/table-cards.d.cts +4 -12
  110. package/dist/types/packages/react/src/table-cards.d.ts +4 -12
  111. package/dist/types/packages/react/src/table-grid.d.cts +3 -7
  112. package/dist/types/packages/react/src/table-grid.d.ts +3 -7
  113. package/dist/types/packages/react/src/table-groups.d.cts +5 -0
  114. package/dist/types/packages/react/src/table-groups.d.ts +5 -0
  115. package/dist/types/packages/react/src/table-list.d.cts +2 -9
  116. package/dist/types/packages/react/src/table-list.d.ts +2 -9
  117. package/dist/types/packages/react/src/table-model.d.cts +6 -2
  118. package/dist/types/packages/react/src/table-model.d.ts +6 -2
  119. package/dist/types/packages/react/src/tabs.d.cts +3 -1
  120. package/dist/types/packages/react/src/tabs.d.ts +3 -1
  121. package/dist/types/packages/react/src/textarea.d.cts +6 -3
  122. package/dist/types/packages/react/src/textarea.d.ts +6 -3
  123. package/dist/types/packages/react/src/tiles.d.cts +18 -0
  124. package/dist/types/packages/react/src/tiles.d.ts +18 -0
  125. package/dist/types/packages/react/src/time-picker.d.cts +12 -2
  126. package/dist/types/packages/react/src/time-picker.d.ts +12 -2
  127. package/dist/types/packages/react/src/time-wheel.d.cts +18 -0
  128. package/dist/types/packages/react/src/time-wheel.d.ts +18 -0
  129. package/dist/types/packages/react/src/use-filter-scroll.d.cts +5 -0
  130. package/dist/types/packages/react/src/use-filter-scroll.d.ts +5 -0
  131. package/dist/types/shared/package-runtime/accordion-state.d.cts +2 -0
  132. package/dist/types/shared/package-runtime/accordion-state.d.ts +2 -0
  133. package/dist/types/shared/package-runtime/action-size.d.cts +4 -0
  134. package/dist/types/shared/package-runtime/action-size.d.ts +4 -0
  135. package/dist/types/shared/package-runtime/alert-actions.d.cts +7 -0
  136. package/dist/types/shared/package-runtime/alert-actions.d.ts +7 -0
  137. package/dist/types/shared/package-runtime/alert-exit.d.cts +6 -0
  138. package/dist/types/shared/package-runtime/alert-exit.d.ts +6 -0
  139. package/dist/types/shared/package-runtime/alert-live.d.cts +2 -0
  140. package/dist/types/shared/package-runtime/alert-live.d.ts +2 -0
  141. package/dist/types/shared/package-runtime/avatar-group.d.cts +18 -0
  142. package/dist/types/shared/package-runtime/avatar-group.d.ts +18 -0
  143. package/dist/types/shared/package-runtime/badge-tone.d.cts +8 -2
  144. package/dist/types/shared/package-runtime/badge-tone.d.ts +8 -2
  145. package/dist/types/shared/package-runtime/bottom-bar.d.cts +1 -1
  146. package/dist/types/shared/package-runtime/bottom-bar.d.ts +1 -1
  147. package/dist/types/shared/package-runtime/bottom-navigation.d.cts +10 -0
  148. package/dist/types/shared/package-runtime/bottom-navigation.d.ts +10 -0
  149. package/dist/types/shared/package-runtime/calendar.d.cts +21 -7
  150. package/dist/types/shared/package-runtime/calendar.d.ts +21 -7
  151. package/dist/types/shared/package-runtime/card-layout.d.cts +8 -0
  152. package/dist/types/shared/package-runtime/card-layout.d.ts +8 -0
  153. package/dist/types/shared/package-runtime/carousel-scroll.d.cts +2 -0
  154. package/dist/types/shared/package-runtime/carousel-scroll.d.ts +2 -0
  155. package/dist/types/shared/package-runtime/carousel.d.cts +12 -2
  156. package/dist/types/shared/package-runtime/carousel.d.ts +12 -2
  157. package/dist/types/shared/package-runtime/chart-skeleton.d.cts +1 -1
  158. package/dist/types/shared/package-runtime/chart-skeleton.d.ts +1 -1
  159. package/dist/types/shared/package-runtime/clipboard.d.cts +6 -0
  160. package/dist/types/shared/package-runtime/clipboard.d.ts +6 -0
  161. package/dist/types/shared/package-runtime/combobox-options.d.cts +13 -0
  162. package/dist/types/shared/package-runtime/combobox-options.d.ts +13 -0
  163. package/dist/types/shared/package-runtime/combobox.d.cts +3 -1
  164. package/dist/types/shared/package-runtime/combobox.d.ts +3 -1
  165. package/dist/types/shared/package-runtime/copy-button.d.cts +11 -0
  166. package/dist/types/shared/package-runtime/copy-button.d.ts +11 -0
  167. package/dist/types/shared/package-runtime/data-cells.d.cts +36 -0
  168. package/dist/types/shared/package-runtime/data-cells.d.ts +36 -0
  169. package/dist/types/shared/package-runtime/development.d.cts +4 -0
  170. package/dist/types/shared/package-runtime/development.d.ts +4 -0
  171. package/dist/types/shared/package-runtime/distribution.d.cts +36 -1
  172. package/dist/types/shared/package-runtime/distribution.d.ts +36 -1
  173. package/dist/types/shared/package-runtime/drawer-geometry.d.cts +7 -0
  174. package/dist/types/shared/package-runtime/drawer-geometry.d.ts +7 -0
  175. package/dist/types/shared/package-runtime/event-calendar.d.cts +81 -0
  176. package/dist/types/shared/package-runtime/event-calendar.d.ts +81 -0
  177. package/dist/types/shared/package-runtime/external-link.d.cts +4 -0
  178. package/dist/types/shared/package-runtime/external-link.d.ts +4 -0
  179. package/dist/types/shared/package-runtime/field-group.d.cts +17 -0
  180. package/dist/types/shared/package-runtime/field-group.d.ts +17 -0
  181. package/dist/types/shared/package-runtime/file-upload.d.cts +128 -0
  182. package/dist/types/shared/package-runtime/file-upload.d.ts +128 -0
  183. package/dist/types/shared/package-runtime/filter-scroll.d.cts +5 -0
  184. package/dist/types/shared/package-runtime/filter-scroll.d.ts +5 -0
  185. package/dist/types/shared/package-runtime/filter-value.d.cts +2 -0
  186. package/dist/types/shared/package-runtime/filter-value.d.ts +2 -0
  187. package/dist/types/shared/package-runtime/input-field.d.cts +23 -0
  188. package/dist/types/shared/package-runtime/input-field.d.ts +23 -0
  189. package/dist/types/shared/package-runtime/input-variant.d.cts +7 -0
  190. package/dist/types/shared/package-runtime/input-variant.d.ts +7 -0
  191. package/dist/types/shared/package-runtime/kpi.d.cts +13 -0
  192. package/dist/types/shared/package-runtime/kpi.d.ts +13 -0
  193. package/dist/types/shared/package-runtime/layout-primitives.d.cts +115 -6
  194. package/dist/types/shared/package-runtime/layout-primitives.d.ts +115 -6
  195. package/dist/types/shared/package-runtime/list-row.d.cts +71 -8
  196. package/dist/types/shared/package-runtime/list-row.d.ts +71 -8
  197. package/dist/types/shared/package-runtime/market-layout.d.cts +3 -1
  198. package/dist/types/shared/package-runtime/market-layout.d.ts +3 -1
  199. package/dist/types/shared/package-runtime/market-query.d.cts +6 -0
  200. package/dist/types/shared/package-runtime/market-query.d.ts +6 -0
  201. package/dist/types/shared/package-runtime/market-table.d.cts +32 -0
  202. package/dist/types/shared/package-runtime/market-table.d.ts +32 -0
  203. package/dist/types/shared/package-runtime/menu-button.d.cts +4 -0
  204. package/dist/types/shared/package-runtime/menu-button.d.ts +4 -0
  205. package/dist/types/shared/package-runtime/messages/ko.d.cts +77 -1
  206. package/dist/types/shared/package-runtime/messages/ko.d.ts +77 -1
  207. package/dist/types/shared/package-runtime/messages-context.d.cts +69 -1
  208. package/dist/types/shared/package-runtime/messages-context.d.ts +69 -1
  209. package/dist/types/shared/package-runtime/minimum-loading.d.cts +3 -0
  210. package/dist/types/shared/package-runtime/minimum-loading.d.ts +3 -0
  211. package/dist/types/shared/package-runtime/modal-geometry.d.cts +15 -0
  212. package/dist/types/shared/package-runtime/modal-geometry.d.ts +15 -0
  213. package/dist/types/shared/package-runtime/navigation.d.cts +9 -2
  214. package/dist/types/shared/package-runtime/navigation.d.ts +9 -2
  215. package/dist/types/shared/package-runtime/nested-controls.d.cts +7 -0
  216. package/dist/types/shared/package-runtime/nested-controls.d.ts +7 -0
  217. package/dist/types/shared/package-runtime/node-text.d.cts +1 -0
  218. package/dist/types/shared/package-runtime/node-text.d.ts +1 -0
  219. package/dist/types/shared/package-runtime/number-input.d.cts +73 -0
  220. package/dist/types/shared/package-runtime/number-input.d.ts +73 -0
  221. package/dist/types/shared/package-runtime/options.d.cts +25 -5
  222. package/dist/types/shared/package-runtime/options.d.ts +25 -5
  223. package/dist/types/shared/package-runtime/pagination.d.cts +12 -0
  224. package/dist/types/shared/package-runtime/pagination.d.ts +12 -0
  225. package/dist/types/shared/package-runtime/press-repeat.d.cts +13 -0
  226. package/dist/types/shared/package-runtime/press-repeat.d.ts +13 -0
  227. package/dist/types/shared/package-runtime/progress-circle.d.cts +5 -0
  228. package/dist/types/shared/package-runtime/progress-circle.d.ts +5 -0
  229. package/dist/types/shared/package-runtime/progress-marker.d.cts +7 -0
  230. package/dist/types/shared/package-runtime/progress-marker.d.ts +7 -0
  231. package/dist/types/shared/package-runtime/progress-tone.d.cts +6 -0
  232. package/dist/types/shared/package-runtime/progress-tone.d.ts +6 -0
  233. package/dist/types/shared/package-runtime/select-trigger.d.cts +23 -0
  234. package/dist/types/shared/package-runtime/select-trigger.d.ts +23 -0
  235. package/dist/types/shared/package-runtime/sheet-drag.d.cts +24 -0
  236. package/dist/types/shared/package-runtime/sheet-drag.d.ts +24 -0
  237. package/dist/types/shared/package-runtime/side-navigation-keys.d.cts +23 -0
  238. package/dist/types/shared/package-runtime/side-navigation-keys.d.ts +23 -0
  239. package/dist/types/shared/package-runtime/side-navigation-layout.d.cts +24 -0
  240. package/dist/types/shared/package-runtime/side-navigation-layout.d.ts +24 -0
  241. package/dist/types/shared/package-runtime/side-navigation-scroll.d.cts +7 -0
  242. package/dist/types/shared/package-runtime/side-navigation-scroll.d.ts +7 -0
  243. package/dist/types/shared/package-runtime/side-navigation.d.cts +277 -0
  244. package/dist/types/shared/package-runtime/side-navigation.d.ts +277 -0
  245. package/dist/types/shared/package-runtime/signed-number.d.cts +33 -0
  246. package/dist/types/shared/package-runtime/signed-number.d.ts +33 -0
  247. package/dist/types/shared/package-runtime/skeleton-text.d.cts +4 -0
  248. package/dist/types/shared/package-runtime/skeleton-text.d.ts +4 -0
  249. package/dist/types/shared/package-runtime/slider-view.d.cts +17 -2
  250. package/dist/types/shared/package-runtime/slider-view.d.ts +17 -2
  251. package/dist/types/shared/package-runtime/sparkline.d.cts +8 -4
  252. package/dist/types/shared/package-runtime/sparkline.d.ts +8 -4
  253. package/dist/types/shared/package-runtime/spinner-geometry.d.cts +14 -0
  254. package/dist/types/shared/package-runtime/spinner-geometry.d.ts +14 -0
  255. package/dist/types/shared/package-runtime/split-pane.d.cts +40 -1
  256. package/dist/types/shared/package-runtime/split-pane.d.ts +40 -1
  257. package/dist/types/shared/package-runtime/steps.d.cts +51 -0
  258. package/dist/types/shared/package-runtime/steps.d.ts +51 -0
  259. package/dist/types/shared/package-runtime/tab-keyboard.d.cts +6 -0
  260. package/dist/types/shared/package-runtime/tab-keyboard.d.ts +6 -0
  261. package/dist/types/shared/package-runtime/table-columns.d.cts +8 -0
  262. package/dist/types/shared/package-runtime/table-columns.d.ts +8 -0
  263. package/dist/types/shared/package-runtime/table-model.d.cts +23 -3
  264. package/dist/types/shared/package-runtime/table-model.d.ts +23 -3
  265. package/dist/types/shared/package-runtime/table-presentation.d.cts +12 -2
  266. package/dist/types/shared/package-runtime/table-presentation.d.ts +12 -2
  267. package/dist/types/shared/package-runtime/table.d.cts +17 -2
  268. package/dist/types/shared/package-runtime/table.d.ts +17 -2
  269. package/dist/types/shared/package-runtime/textarea.d.cts +6 -4
  270. package/dist/types/shared/package-runtime/textarea.d.ts +6 -4
  271. package/dist/types/shared/package-runtime/tiles-children.d.cts +7 -0
  272. package/dist/types/shared/package-runtime/tiles-children.d.ts +7 -0
  273. package/dist/types/shared/package-runtime/tiles.d.cts +18 -0
  274. package/dist/types/shared/package-runtime/tiles.d.ts +18 -0
  275. package/dist/types/shared/package-runtime/time-segments.d.cts +24 -0
  276. package/dist/types/shared/package-runtime/time-segments.d.ts +24 -0
  277. package/dist/types/shared/package-runtime/time-wheel.d.cts +54 -0
  278. package/dist/types/shared/package-runtime/time-wheel.d.ts +54 -0
  279. package/dist/types/shared/package-runtime/trailing-overflow.d.cts +1 -0
  280. package/dist/types/shared/package-runtime/trailing-overflow.d.ts +1 -0
  281. package/dist/types/shared/package-runtime/use-color-picker.d.cts +3 -0
  282. package/dist/types/shared/package-runtime/use-color-picker.d.ts +3 -0
  283. package/dist/types/shared/package-runtime/use-copy-feedback.d.cts +10 -0
  284. package/dist/types/shared/package-runtime/use-copy-feedback.d.ts +10 -0
  285. package/dist/types/shared/package-runtime/use-open-state.d.cts +5 -0
  286. package/dist/types/shared/package-runtime/use-open-state.d.ts +5 -0
  287. package/dist/types/shared/package-runtime/use-pending-action.d.cts +6 -0
  288. package/dist/types/shared/package-runtime/use-pending-action.d.ts +6 -0
  289. package/dist/types/shared/package-runtime/use-side-navigation-state.d.cts +25 -0
  290. package/dist/types/shared/package-runtime/use-side-navigation-state.d.ts +25 -0
  291. package/dist/types/shared/package-runtime/use-slide.d.cts +3 -0
  292. package/dist/types/shared/package-runtime/use-slide.d.ts +3 -0
  293. package/package.json +3 -3
  294. package/dist/types/packages/react/src/compound-control.d.cts +0 -1
  295. package/dist/types/packages/react/src/compound-control.d.ts +0 -1
  296. package/dist/types/shared/package-runtime/center-option.d.cts +0 -1
  297. package/dist/types/shared/package-runtime/center-option.d.ts +0 -1
@@ -16,6 +16,8 @@ export interface KjunDataStateProps extends QueryDisplayProps {
16
16
  loadingPadding?: "default" | "none";
17
17
  empty?: boolean;
18
18
  emptyText?: string;
19
+ /** Why it is empty and what to do next, under the title. */
20
+ emptyDescription?: string;
19
21
  emptyIcon?: string;
20
22
  emptyActionText?: string;
21
23
  loadingText?: string;
@@ -33,26 +35,37 @@ export interface KjunDataStateProps extends QueryDisplayProps {
33
35
  onRetry?: () => void;
34
36
  onEmptyAction?: () => void;
35
37
  }
36
- export declare function KjunDataState({ preserveContent, refreshing, refreshError, refreshingText, loadingPadding, empty, emptyText, emptyIcon, emptyActionText, loadingText, loadingDelay, retryText, size, skeleton, skeletonType, skeletonCount, children, loadingContent, emptyContent, errorContent, onRetry, onEmptyAction, ...query }: KjunDataStateProps): import("react/jsx-runtime").JSX.Element;
38
+ export declare function KjunDataState({ preserveContent, refreshing, refreshError, refreshingText, loadingPadding, empty, emptyText, emptyDescription, emptyIcon, emptyActionText, loadingText, loadingDelay, retryText, size, skeleton, skeletonType, skeletonCount, children, loadingContent, emptyContent, errorContent, onRetry, onEmptyAction, ...query }: KjunDataStateProps): import("react/jsx-runtime").JSX.Element;
37
39
  export interface KjunErrorBoundaryProps {
38
40
  children: ReactNode;
39
41
  fallbackMessage?: string;
40
42
  /** The default fallback's padding and minimum height, like KjunDataState: md for pages and panels, sm for cards, lg for full pages. */
41
43
  size?: "sm" | "md" | "lg";
42
- fallback?: ReactNode;
44
+ /** Replaces the default fallback; a function receives the caught error and reset, like Vue's fallback slot. */
45
+ fallback?: ReactNode | ((props: KjunErrorFallbackProps) => ReactNode);
46
+ /** A change in any of these values (a route, a query) resets a failed boundary, like pressing retry. */
47
+ resetKeys?: readonly unknown[];
43
48
  onError?: (error: Error, info: ErrorInfo) => void;
49
+ /** Called after the boundary resets, from retry, a fallback's reset or a resetKeys change. */
44
50
  onReset?: () => void;
45
51
  }
52
+ export interface KjunErrorFallbackProps {
53
+ error: Error;
54
+ reset: () => void;
55
+ }
46
56
  export declare class KjunErrorBoundary extends Component<KjunErrorBoundaryProps, {
47
- error: boolean;
57
+ error: Error | null;
48
58
  }> {
49
59
  state: {
50
- error: boolean;
60
+ error: Error | null;
51
61
  };
52
- static getDerivedStateFromError(): {
53
- error: boolean;
62
+ static getDerivedStateFromError(error: unknown): {
63
+ error: Error;
54
64
  };
55
65
  componentDidCatch(error: Error, info: ErrorInfo): void;
66
+ componentDidUpdate(previous: KjunErrorBoundaryProps, state: {
67
+ error: Error | null;
68
+ }): void;
56
69
  reset: () => void;
57
70
  render(): string | number | bigint | boolean | Iterable<ReactNode> | Promise<string | number | bigint | boolean | import("react").ReactPortal | import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | import("react/jsx-runtime").JSX.Element | null | undefined;
58
71
  }
@@ -17,6 +17,9 @@ interface DateFieldProps extends CalendarOptions {
17
17
  id?: string;
18
18
  /** Submits the value with a form through a hidden input. */
19
19
  name?: string;
20
+ /** Opens and closes the calendar from the app; leave it out to let the field own it. */
21
+ open?: boolean;
22
+ onOpenChange?: (open: boolean) => void;
20
23
  }
21
24
  export interface KjunDatePickerProps extends DateFieldProps {
22
25
  /** YYYY-MM-DD, or an empty string. */
@@ -24,7 +27,7 @@ export interface KjunDatePickerProps extends DateFieldProps {
24
27
  onValueChange?: (value: string) => void;
25
28
  onChange?: (value: string) => void;
26
29
  }
27
- export declare function KjunDatePicker({ value, placeholder, clearable, min, max, weekStart, markSunday, isDateUnavailable, onValueChange, onChange, ...field }: KjunDatePickerProps): import("react/jsx-runtime").JSX.Element;
30
+ export declare function KjunDatePicker({ value, placeholder, clearable, min, max, weekStart, markSunday, markSaturday, isDateUnavailable, onValueChange, onChange, open: controlled, onOpenChange, ...field }: KjunDatePickerProps): import("react/jsx-runtime").JSX.Element;
28
31
  export interface KjunDateRangePickerProps extends DateFieldProps {
29
32
  /** Start and end as YYYY-MM-DD; empty strings while unset. A reversed or out-of-bounds range is shown in order and inside the bounds. */
30
33
  value: DateRange;
@@ -34,7 +37,10 @@ export interface KjunDateRangePickerProps extends DateFieldProps {
34
37
  presets?: readonly DateRangePreset[];
35
38
  /** Commits as soon as the second day is picked, without Apply. */
36
39
  autoApply?: boolean;
40
+ /** Shortest and longest range in days, counting both ends; other ends fade while the end is picked and start a new range when pressed. */
41
+ minDays?: number;
42
+ maxDays?: number;
37
43
  }
38
44
  /** Two dates picked in one calendar: the first pick starts the range, the second ends it, and Apply commits it. */
39
- export declare function KjunDateRangePicker({ value: given, placeholder, clearable, min, max, weekStart, markSunday, isDateUnavailable, presets, autoApply, onValueChange, onChange, ...field }: KjunDateRangePickerProps): import("react/jsx-runtime").JSX.Element;
45
+ export declare function KjunDateRangePicker({ value: given, placeholder, clearable, min, max, weekStart, markSunday, markSaturday, isDateUnavailable, presets, autoApply, minDays, maxDays, onValueChange, onChange, open: controlled, onOpenChange, ...field }: KjunDateRangePickerProps): import("react/jsx-runtime").JSX.Element;
40
46
  export type { DateRange, DateRangePreset };
@@ -17,6 +17,9 @@ interface DateFieldProps extends CalendarOptions {
17
17
  id?: string;
18
18
  /** Submits the value with a form through a hidden input. */
19
19
  name?: string;
20
+ /** Opens and closes the calendar from the app; leave it out to let the field own it. */
21
+ open?: boolean;
22
+ onOpenChange?: (open: boolean) => void;
20
23
  }
21
24
  export interface KjunDatePickerProps extends DateFieldProps {
22
25
  /** YYYY-MM-DD, or an empty string. */
@@ -24,7 +27,7 @@ export interface KjunDatePickerProps extends DateFieldProps {
24
27
  onValueChange?: (value: string) => void;
25
28
  onChange?: (value: string) => void;
26
29
  }
27
- export declare function KjunDatePicker({ value, placeholder, clearable, min, max, weekStart, markSunday, isDateUnavailable, onValueChange, onChange, ...field }: KjunDatePickerProps): import("react/jsx-runtime").JSX.Element;
30
+ export declare function KjunDatePicker({ value, placeholder, clearable, min, max, weekStart, markSunday, markSaturday, isDateUnavailable, onValueChange, onChange, open: controlled, onOpenChange, ...field }: KjunDatePickerProps): import("react/jsx-runtime").JSX.Element;
28
31
  export interface KjunDateRangePickerProps extends DateFieldProps {
29
32
  /** Start and end as YYYY-MM-DD; empty strings while unset. A reversed or out-of-bounds range is shown in order and inside the bounds. */
30
33
  value: DateRange;
@@ -34,7 +37,10 @@ export interface KjunDateRangePickerProps extends DateFieldProps {
34
37
  presets?: readonly DateRangePreset[];
35
38
  /** Commits as soon as the second day is picked, without Apply. */
36
39
  autoApply?: boolean;
40
+ /** Shortest and longest range in days, counting both ends; other ends fade while the end is picked and start a new range when pressed. */
41
+ minDays?: number;
42
+ maxDays?: number;
37
43
  }
38
44
  /** Two dates picked in one calendar: the first pick starts the range, the second ends it, and Apply commits it. */
39
- export declare function KjunDateRangePicker({ value: given, placeholder, clearable, min, max, weekStart, markSunday, isDateUnavailable, presets, autoApply, onValueChange, onChange, ...field }: KjunDateRangePickerProps): import("react/jsx-runtime").JSX.Element;
45
+ export declare function KjunDateRangePicker({ value: given, placeholder, clearable, min, max, weekStart, markSunday, markSaturday, isDateUnavailable, presets, autoApply, minDays, maxDays, onValueChange, onChange, open: controlled, onOpenChange, ...field }: KjunDateRangePickerProps): import("react/jsx-runtime").JSX.Element;
40
46
  export type { DateRange, DateRangePreset };
@@ -15,7 +15,8 @@ export interface KjunBadgeProps extends HTMLAttributes<HTMLSpanElement> {
15
15
  /** What the badge means to a screen reader, e.g. "읽지 않은 알림 3개"; the drawn text is then hidden from it. Give it to a dot-only badge. */
16
16
  label?: string;
17
17
  }
18
- export declare function KjunBadge({ variant, size, dot, count, max, label, children, style, ...props }: KjunBadgeProps): import("react/jsx-runtime").JSX.Element | null;
18
+ /** Like Chip, the ref reaches the badge's root span. */
19
+ export declare const KjunBadge: import("react").ForwardRefExoticComponent<KjunBadgeProps & import("react").RefAttributes<HTMLSpanElement>>;
19
20
  export { KjunCard } from "./card.cjs";
20
21
  export type { KjunCardProps } from "./card.cjs";
21
22
  export interface KjunEmptyProps extends Omit<HTMLAttributes<HTMLDivElement>, "children"> {
@@ -38,20 +39,26 @@ export interface KjunSpinnerProps {
38
39
  text?: string;
39
40
  }
40
41
  export declare function KjunSpinner({ size, text }: KjunSpinnerProps): import("react/jsx-runtime").JSX.Element;
41
- export interface KjunAlertProps {
42
+ export interface KjunAlertProps extends Omit<HTMLAttributes<HTMLDivElement>, "title" | "children" | "role"> {
42
43
  type?: "info" | "success" | "warning" | "danger" | "error";
43
44
  variant?: SemanticTone;
44
45
  size?: "sm" | "md" | "lg";
45
46
  title?: ReactNode;
47
+ /** An icon name in place of the tone's icon (its filled form when the icon has one), or false for no icon. */
48
+ icon?: string | false;
46
49
  closable?: boolean;
47
50
  /** How screen readers announce it: assertive (role alert), polite (status) or off; defaults to alert for danger, status otherwise. */
48
51
  live?: AlertLive;
49
52
  children?: ReactNode;
50
- /** Buttons placed under the message; unsized KjunButtons follow the alert size. */
53
+ /** Buttons for the alert, under the message when it has a title, beside it otherwise (under it when the alert is too narrow for both); unsized KjunButtons follow the alert size. */
51
54
  actions?: ReactNode;
55
+ /** Extra class on the alert root, for placement in the page layout; it leaves with the alert when closed. */
56
+ className?: string;
52
57
  onClose?: () => void;
53
58
  }
54
- export declare function KjunAlert({ type, variant, size, title, closable, live, children, actions, onClose, }: KjunAlertProps): import("react/jsx-runtime").JSX.Element | null;
59
+ /** Other HTML attributes (id, style, tabIndex, aria-*, data-*) and the ref go to the root, so a page can point at the alert or move focus to it. */
60
+ export declare const KjunAlert: import("react").ForwardRefExoticComponent<KjunAlertProps & import("react").RefAttributes<HTMLDivElement>>;
61
+ export type KjunProgressVariant = SemanticTone | "neutral";
55
62
  export interface KjunProgressProps {
56
63
  /** null is missing data; omission keeps the zero default. */
57
64
  value?: number | null;
@@ -59,25 +66,43 @@ export interface KjunProgressProps {
59
66
  indeterminate?: boolean;
60
67
  max?: number;
61
68
  size?: "sm" | "md" | "lg";
62
- variant?: SemanticTone;
69
+ /** neutral draws the fill in the tertiary text colour, for a stale or reference reading that should not call for attention. */
70
+ variant?: KjunProgressVariant;
63
71
  showLabel?: boolean;
72
+ /** Shown and read in place of the rounded percent while the value is known, e.g. "37.4%" or "3.2 / 8 GB". */
73
+ valueText?: string;
74
+ /** A reference point across the bar on the value's own scale (0 to max), such as today's share of a budget. Bars only; not drawn while indeterminate or missing. */
75
+ marker?: number;
76
+ /** Read by screen readers as the bar's description, e.g. "오늘 기준 53%". Put visible wording in subLabel. */
77
+ markerLabel?: string;
64
78
  label?: ReactNode;
79
+ /** Names the bar for screen readers without showing text, e.g. "업로드 진행률"; takes the place of a label's name. */
80
+ ariaLabel?: string;
65
81
  subLabel?: ReactNode;
66
82
  shape?: "bar" | "circle";
67
83
  }
68
- export declare function KjunProgress({ value, indeterminate, max, size, variant, showLabel, label, subLabel, shape, }: KjunProgressProps): import("react/jsx-runtime").JSX.Element;
84
+ export declare function KjunProgress({ value, indeterminate, max, size, variant, showLabel, valueText, marker, markerLabel, label, ariaLabel, subLabel, shape, }: KjunProgressProps): import("react/jsx-runtime").JSX.Element;
69
85
  export interface KjunSkeletonProps {
70
86
  /** "line" is one line of text: a bar in the line box of `role`, or of the surrounding text when no role is given. */
71
87
  type?: "text" | "line" | "avatar" | "card" | "table" | "stat" | "block";
72
- /** Typography role for type="line"; omit it to take the surrounding text's line height. */
88
+ /**
89
+ * Typography role of the text a "line" or "text" skeleton stands in for. Omitted, a line takes the surrounding
90
+ * text's line height and a paragraph the body role.
91
+ */
73
92
  role?: TypographyRole;
74
93
  /** Announces loading to screen readers (a status); the skeleton itself stays silent. */
75
94
  loadingText?: string;
95
+ /** Lines of a "text" or "card" skeleton, body rows of a "table" one; floored, 0–100. */
76
96
  rows?: number;
97
+ /** Columns of a "table" skeleton; floored, 0–100. */
77
98
  columns?: number;
78
99
  height?: CSSProperties["height"];
79
100
  width?: CSSProperties["width"];
80
101
  animated?: boolean;
81
102
  rounded?: boolean;
103
+ className?: string;
104
+ /** Merged over the root's own width. */
105
+ style?: CSSProperties;
106
+ id?: string;
82
107
  }
83
- export declare function KjunSkeleton({ type, rows, columns, height, width, animated, rounded, role, loadingText, }: KjunSkeletonProps): import("react/jsx-runtime").JSX.Element;
108
+ export declare function KjunSkeleton({ type, rows, columns, height, width, animated, rounded, role, loadingText, className, style, id, }: KjunSkeletonProps): import("react/jsx-runtime").JSX.Element;
@@ -15,7 +15,8 @@ export interface KjunBadgeProps extends HTMLAttributes<HTMLSpanElement> {
15
15
  /** What the badge means to a screen reader, e.g. "읽지 않은 알림 3개"; the drawn text is then hidden from it. Give it to a dot-only badge. */
16
16
  label?: string;
17
17
  }
18
- export declare function KjunBadge({ variant, size, dot, count, max, label, children, style, ...props }: KjunBadgeProps): import("react/jsx-runtime").JSX.Element | null;
18
+ /** Like Chip, the ref reaches the badge's root span. */
19
+ export declare const KjunBadge: import("react").ForwardRefExoticComponent<KjunBadgeProps & import("react").RefAttributes<HTMLSpanElement>>;
19
20
  export { KjunCard } from "./card.js";
20
21
  export type { KjunCardProps } from "./card.js";
21
22
  export interface KjunEmptyProps extends Omit<HTMLAttributes<HTMLDivElement>, "children"> {
@@ -38,20 +39,26 @@ export interface KjunSpinnerProps {
38
39
  text?: string;
39
40
  }
40
41
  export declare function KjunSpinner({ size, text }: KjunSpinnerProps): import("react/jsx-runtime").JSX.Element;
41
- export interface KjunAlertProps {
42
+ export interface KjunAlertProps extends Omit<HTMLAttributes<HTMLDivElement>, "title" | "children" | "role"> {
42
43
  type?: "info" | "success" | "warning" | "danger" | "error";
43
44
  variant?: SemanticTone;
44
45
  size?: "sm" | "md" | "lg";
45
46
  title?: ReactNode;
47
+ /** An icon name in place of the tone's icon (its filled form when the icon has one), or false for no icon. */
48
+ icon?: string | false;
46
49
  closable?: boolean;
47
50
  /** How screen readers announce it: assertive (role alert), polite (status) or off; defaults to alert for danger, status otherwise. */
48
51
  live?: AlertLive;
49
52
  children?: ReactNode;
50
- /** Buttons placed under the message; unsized KjunButtons follow the alert size. */
53
+ /** Buttons for the alert, under the message when it has a title, beside it otherwise (under it when the alert is too narrow for both); unsized KjunButtons follow the alert size. */
51
54
  actions?: ReactNode;
55
+ /** Extra class on the alert root, for placement in the page layout; it leaves with the alert when closed. */
56
+ className?: string;
52
57
  onClose?: () => void;
53
58
  }
54
- export declare function KjunAlert({ type, variant, size, title, closable, live, children, actions, onClose, }: KjunAlertProps): import("react/jsx-runtime").JSX.Element | null;
59
+ /** Other HTML attributes (id, style, tabIndex, aria-*, data-*) and the ref go to the root, so a page can point at the alert or move focus to it. */
60
+ export declare const KjunAlert: import("react").ForwardRefExoticComponent<KjunAlertProps & import("react").RefAttributes<HTMLDivElement>>;
61
+ export type KjunProgressVariant = SemanticTone | "neutral";
55
62
  export interface KjunProgressProps {
56
63
  /** null is missing data; omission keeps the zero default. */
57
64
  value?: number | null;
@@ -59,25 +66,43 @@ export interface KjunProgressProps {
59
66
  indeterminate?: boolean;
60
67
  max?: number;
61
68
  size?: "sm" | "md" | "lg";
62
- variant?: SemanticTone;
69
+ /** neutral draws the fill in the tertiary text colour, for a stale or reference reading that should not call for attention. */
70
+ variant?: KjunProgressVariant;
63
71
  showLabel?: boolean;
72
+ /** Shown and read in place of the rounded percent while the value is known, e.g. "37.4%" or "3.2 / 8 GB". */
73
+ valueText?: string;
74
+ /** A reference point across the bar on the value's own scale (0 to max), such as today's share of a budget. Bars only; not drawn while indeterminate or missing. */
75
+ marker?: number;
76
+ /** Read by screen readers as the bar's description, e.g. "오늘 기준 53%". Put visible wording in subLabel. */
77
+ markerLabel?: string;
64
78
  label?: ReactNode;
79
+ /** Names the bar for screen readers without showing text, e.g. "업로드 진행률"; takes the place of a label's name. */
80
+ ariaLabel?: string;
65
81
  subLabel?: ReactNode;
66
82
  shape?: "bar" | "circle";
67
83
  }
68
- export declare function KjunProgress({ value, indeterminate, max, size, variant, showLabel, label, subLabel, shape, }: KjunProgressProps): import("react/jsx-runtime").JSX.Element;
84
+ export declare function KjunProgress({ value, indeterminate, max, size, variant, showLabel, valueText, marker, markerLabel, label, ariaLabel, subLabel, shape, }: KjunProgressProps): import("react/jsx-runtime").JSX.Element;
69
85
  export interface KjunSkeletonProps {
70
86
  /** "line" is one line of text: a bar in the line box of `role`, or of the surrounding text when no role is given. */
71
87
  type?: "text" | "line" | "avatar" | "card" | "table" | "stat" | "block";
72
- /** Typography role for type="line"; omit it to take the surrounding text's line height. */
88
+ /**
89
+ * Typography role of the text a "line" or "text" skeleton stands in for. Omitted, a line takes the surrounding
90
+ * text's line height and a paragraph the body role.
91
+ */
73
92
  role?: TypographyRole;
74
93
  /** Announces loading to screen readers (a status); the skeleton itself stays silent. */
75
94
  loadingText?: string;
95
+ /** Lines of a "text" or "card" skeleton, body rows of a "table" one; floored, 0–100. */
76
96
  rows?: number;
97
+ /** Columns of a "table" skeleton; floored, 0–100. */
77
98
  columns?: number;
78
99
  height?: CSSProperties["height"];
79
100
  width?: CSSProperties["width"];
80
101
  animated?: boolean;
81
102
  rounded?: boolean;
103
+ className?: string;
104
+ /** Merged over the root's own width. */
105
+ style?: CSSProperties;
106
+ id?: string;
82
107
  }
83
- export declare function KjunSkeleton({ type, rows, columns, height, width, animated, rounded, role, loadingText, }: KjunSkeletonProps): import("react/jsx-runtime").JSX.Element;
108
+ export declare function KjunSkeleton({ type, rows, columns, height, width, animated, rounded, role, loadingText, className, style, id, }: KjunSkeletonProps): import("react/jsx-runtime").JSX.Element;
@@ -1,4 +1,5 @@
1
- import type { ReactNode } from "react";
1
+ import { type ReactNode } from "react";
2
+ import { type FocusReturn } from "./floating-panel.cjs";
2
3
  export interface KjunDrawerProps {
3
4
  open: boolean;
4
5
  onOpenChange: (v: boolean) => void;
@@ -10,15 +11,23 @@ export interface KjunDrawerProps {
10
11
  closeOnEsc?: boolean;
11
12
  noPadding?: boolean;
12
13
  header?: ReactNode;
14
+ /** Secondary actions in the title row, before the close button (such as a reset button). */
15
+ headerActions?: ReactNode;
13
16
  footer?: ReactNode;
14
17
  children: ReactNode;
15
18
  onClose?: () => void;
16
19
  /** Called once after the close finishes and the layer has left the screen (not when it mounts closed or reopens during the exit). */
17
20
  onAfterClose?: () => void;
18
21
  ariaLabel?: string;
22
+ /** Id of the element that describes the drawer, read after its name. */
23
+ ariaDescribedBy?: string;
24
+ /** Read after the exit finishes; a missing target falls back to the opener or parent window. */
25
+ returnFocus?: FocusReturn;
26
+ /** Bottom drawers: a grab handle above the header; dragging the handle or header down closes the drawer. */
27
+ handle?: boolean;
19
28
  /** Keeps clear of KjunProvider's safe area (default true): padded inside the panel and kept clear beyond a sheet. */
20
29
  safeArea?: boolean;
21
30
  /** Height limit in px for top and bottom drawers; by default they stop a sheet gap short of the opposite edge. */
22
31
  maxHeight?: number;
23
32
  }
24
- export declare function KjunDrawer({ open, onOpenChange, title, position, width, closable, closeOnOverlay, closeOnEsc, noPadding, header, footer, children, onClose, onAfterClose, ariaLabel, safeArea, maxHeight, }: KjunDrawerProps): import("react/jsx-runtime").JSX.Element | null;
33
+ export declare function KjunDrawer({ open, onOpenChange, title, position, width, closable, closeOnOverlay, closeOnEsc, noPadding, header, headerActions, footer, children, onClose, onAfterClose, ariaLabel, ariaDescribedBy, returnFocus, handle, safeArea, maxHeight, }: KjunDrawerProps): import("react/jsx-runtime").JSX.Element | null;
@@ -1,4 +1,5 @@
1
- import type { ReactNode } from "react";
1
+ import { type ReactNode } from "react";
2
+ import { type FocusReturn } from "./floating-panel.js";
2
3
  export interface KjunDrawerProps {
3
4
  open: boolean;
4
5
  onOpenChange: (v: boolean) => void;
@@ -10,15 +11,23 @@ export interface KjunDrawerProps {
10
11
  closeOnEsc?: boolean;
11
12
  noPadding?: boolean;
12
13
  header?: ReactNode;
14
+ /** Secondary actions in the title row, before the close button (such as a reset button). */
15
+ headerActions?: ReactNode;
13
16
  footer?: ReactNode;
14
17
  children: ReactNode;
15
18
  onClose?: () => void;
16
19
  /** Called once after the close finishes and the layer has left the screen (not when it mounts closed or reopens during the exit). */
17
20
  onAfterClose?: () => void;
18
21
  ariaLabel?: string;
22
+ /** Id of the element that describes the drawer, read after its name. */
23
+ ariaDescribedBy?: string;
24
+ /** Read after the exit finishes; a missing target falls back to the opener or parent window. */
25
+ returnFocus?: FocusReturn;
26
+ /** Bottom drawers: a grab handle above the header; dragging the handle or header down closes the drawer. */
27
+ handle?: boolean;
19
28
  /** Keeps clear of KjunProvider's safe area (default true): padded inside the panel and kept clear beyond a sheet. */
20
29
  safeArea?: boolean;
21
30
  /** Height limit in px for top and bottom drawers; by default they stop a sheet gap short of the opposite edge. */
22
31
  maxHeight?: number;
23
32
  }
24
- export declare function KjunDrawer({ open, onOpenChange, title, position, width, closable, closeOnOverlay, closeOnEsc, noPadding, header, footer, children, onClose, onAfterClose, ariaLabel, safeArea, maxHeight, }: KjunDrawerProps): import("react/jsx-runtime").JSX.Element | null;
33
+ export declare function KjunDrawer({ open, onOpenChange, title, position, width, closable, closeOnOverlay, closeOnEsc, noPadding, header, headerActions, footer, children, onClose, onAfterClose, ariaLabel, ariaDescribedBy, returnFocus, handle, safeArea, maxHeight, }: KjunDrawerProps): import("react/jsx-runtime").JSX.Element | null;
@@ -3,6 +3,10 @@ import { type KjunButtonProps } from "./button.cjs";
3
3
  import { type FocusReturn, type Placement } from "./floating-panel.cjs";
4
4
  import { type KjunTooltipProps } from "./popover.cjs";
5
5
  export interface KjunDropdownProps {
6
+ /** Controls visibility; omit for internal state. */
7
+ open?: boolean;
8
+ /** Asked to open or close; with `open`, update it to accept. onOpen and onClose report the visibility that follows. */
9
+ onOpenChange?: (open: boolean) => void;
6
10
  disabled?: boolean;
7
11
  placement?: Extract<Placement, "bottom-start" | "bottom-end" | "top-start" | "top-end">;
8
12
  menuId?: string;
@@ -17,7 +21,7 @@ export interface KjunDropdownProps {
17
21
  /** Where focus goes when the menu closes by choosing or Escape, instead of the trigger (e.g. an edited cell). Web only. */
18
22
  returnFocus?: FocusReturn;
19
23
  }
20
- export declare function KjunDropdown({ disabled, placement, menuId, triggerId, menuClass, density, trigger, children, onOpen, onClose, returnFocus, }: KjunDropdownProps): import("react/jsx-runtime").JSX.Element;
24
+ export declare function KjunDropdown({ open: openProp, onOpenChange, disabled, placement, menuId, triggerId, menuClass, density, trigger, children, onOpen, onClose, returnFocus, }: KjunDropdownProps): import("react/jsx-runtime").JSX.Element;
21
25
  export interface KjunDropdownItemProps {
22
26
  id?: string;
23
27
  variant?: "default" | "danger";
@@ -34,23 +38,29 @@ export interface KjunDropdownItemProps {
34
38
  textValue?: string;
35
39
  /** Keeps the menu open after choosing, for toggles the user flips several times. */
36
40
  keepOpen?: boolean;
41
+ /** Inside a KjunDropdownSection with `value`: the value this single choice stands for. */
42
+ value?: string;
37
43
  /** Makes the item a link; the browser follows it. */
38
44
  href?: string;
39
45
  target?: string;
40
46
  children: ReactNode;
41
47
  onClick?: () => void;
42
48
  }
43
- export declare function KjunDropdownItem({ id, variant, icon, disabled, selected, checked, description, shortcut, textValue, keepOpen, href, target, children, onClick, }: KjunDropdownItemProps): import("react/jsx-runtime").JSX.Element | null;
49
+ export declare function KjunDropdownItem({ id, variant, icon, disabled, selected, checked, description, shortcut, textValue, keepOpen, value, href, target, children, onClick, }: KjunDropdownItemProps): import("react/jsx-runtime").JSX.Element | null;
44
50
  export interface KjunDropdownSectionProps {
45
51
  /** Small heading over the group; it names the group for screen readers. */
46
52
  title?: string;
47
53
  /** Names the group for screen readers when it has no visible title. */
48
54
  ariaLabel?: string;
55
+ /** Makes the items with a `value` one single choice: the item whose value matches shows the check. null chooses none. */
56
+ value?: string | null;
57
+ /** Called with the chosen item's value. */
58
+ onValueChange?: (value: string) => void;
49
59
  children: ReactNode;
50
60
  }
51
- export declare function KjunDropdownSection({ title, ariaLabel, children }: KjunDropdownSectionProps): import("react/jsx-runtime").JSX.Element;
61
+ export declare function KjunDropdownSection({ title, ariaLabel, value, onValueChange, children }: KjunDropdownSectionProps): import("react/jsx-runtime").JSX.Element;
52
62
  export interface KjunDropdownSubmenuProps {
53
- /** Stable key for the submenu; defaults to the label. */
63
+ /** Stable key for the submenu; defaults to the label. Give each submenu its own id when two at one level share a label. */
54
64
  id?: string;
55
65
  label: string;
56
66
  icon?: string;
@@ -61,15 +71,20 @@ export interface KjunDropdownSubmenuProps {
61
71
  export declare function KjunDropdownSubmenu({ id, label, icon, disabled, children }: KjunDropdownSubmenuProps): import("react/jsx-runtime").JSX.Element;
62
72
  export declare function KjunDropdownDivider(): import("react/jsx-runtime").JSX.Element | null;
63
73
  export interface KjunMenuButtonProps extends Omit<KjunDropdownProps, "trigger"> {
64
- label?: string;
74
+ /** The visible label; a node can carry an icon or a colour swatch. Without readable text in it, give ariaLabel. */
75
+ label?: ReactNode;
65
76
  size?: KjunButtonProps["size"];
66
77
  variant?: KjunButtonProps["variant"];
67
78
  /** Show a square dots-vertical button; label remains its accessible name. */
68
79
  compact?: boolean;
80
+ /** Icon before the label, or in place of dots-vertical when compact or unlabelled. */
81
+ icon?: string;
82
+ /** Show the chevron after a visible label (default true); false where the icon already says it opens a menu. */
83
+ chevron?: boolean;
69
84
  loading?: boolean;
70
85
  tooltip?: string;
71
86
  tooltipPlacement?: KjunTooltipProps["placement"];
72
87
  tooltipDelay?: number;
73
88
  ariaLabel?: string;
74
89
  }
75
- export declare function KjunMenuButton({ label, size, variant, compact, loading, tooltip, tooltipPlacement, tooltipDelay, ariaLabel, onOpen, onClose, ...props }: KjunMenuButtonProps): import("react/jsx-runtime").JSX.Element;
90
+ export declare function KjunMenuButton({ label, size, variant, compact, icon, chevron, loading, tooltip, tooltipPlacement, tooltipDelay, ariaLabel, onOpen, onClose, ...props }: KjunMenuButtonProps): import("react/jsx-runtime").JSX.Element;
@@ -3,6 +3,10 @@ import { type KjunButtonProps } from "./button.js";
3
3
  import { type FocusReturn, type Placement } from "./floating-panel.js";
4
4
  import { type KjunTooltipProps } from "./popover.js";
5
5
  export interface KjunDropdownProps {
6
+ /** Controls visibility; omit for internal state. */
7
+ open?: boolean;
8
+ /** Asked to open or close; with `open`, update it to accept. onOpen and onClose report the visibility that follows. */
9
+ onOpenChange?: (open: boolean) => void;
6
10
  disabled?: boolean;
7
11
  placement?: Extract<Placement, "bottom-start" | "bottom-end" | "top-start" | "top-end">;
8
12
  menuId?: string;
@@ -17,7 +21,7 @@ export interface KjunDropdownProps {
17
21
  /** Where focus goes when the menu closes by choosing or Escape, instead of the trigger (e.g. an edited cell). Web only. */
18
22
  returnFocus?: FocusReturn;
19
23
  }
20
- export declare function KjunDropdown({ disabled, placement, menuId, triggerId, menuClass, density, trigger, children, onOpen, onClose, returnFocus, }: KjunDropdownProps): import("react/jsx-runtime").JSX.Element;
24
+ export declare function KjunDropdown({ open: openProp, onOpenChange, disabled, placement, menuId, triggerId, menuClass, density, trigger, children, onOpen, onClose, returnFocus, }: KjunDropdownProps): import("react/jsx-runtime").JSX.Element;
21
25
  export interface KjunDropdownItemProps {
22
26
  id?: string;
23
27
  variant?: "default" | "danger";
@@ -34,23 +38,29 @@ export interface KjunDropdownItemProps {
34
38
  textValue?: string;
35
39
  /** Keeps the menu open after choosing, for toggles the user flips several times. */
36
40
  keepOpen?: boolean;
41
+ /** Inside a KjunDropdownSection with `value`: the value this single choice stands for. */
42
+ value?: string;
37
43
  /** Makes the item a link; the browser follows it. */
38
44
  href?: string;
39
45
  target?: string;
40
46
  children: ReactNode;
41
47
  onClick?: () => void;
42
48
  }
43
- export declare function KjunDropdownItem({ id, variant, icon, disabled, selected, checked, description, shortcut, textValue, keepOpen, href, target, children, onClick, }: KjunDropdownItemProps): import("react/jsx-runtime").JSX.Element | null;
49
+ export declare function KjunDropdownItem({ id, variant, icon, disabled, selected, checked, description, shortcut, textValue, keepOpen, value, href, target, children, onClick, }: KjunDropdownItemProps): import("react/jsx-runtime").JSX.Element | null;
44
50
  export interface KjunDropdownSectionProps {
45
51
  /** Small heading over the group; it names the group for screen readers. */
46
52
  title?: string;
47
53
  /** Names the group for screen readers when it has no visible title. */
48
54
  ariaLabel?: string;
55
+ /** Makes the items with a `value` one single choice: the item whose value matches shows the check. null chooses none. */
56
+ value?: string | null;
57
+ /** Called with the chosen item's value. */
58
+ onValueChange?: (value: string) => void;
49
59
  children: ReactNode;
50
60
  }
51
- export declare function KjunDropdownSection({ title, ariaLabel, children }: KjunDropdownSectionProps): import("react/jsx-runtime").JSX.Element;
61
+ export declare function KjunDropdownSection({ title, ariaLabel, value, onValueChange, children }: KjunDropdownSectionProps): import("react/jsx-runtime").JSX.Element;
52
62
  export interface KjunDropdownSubmenuProps {
53
- /** Stable key for the submenu; defaults to the label. */
63
+ /** Stable key for the submenu; defaults to the label. Give each submenu its own id when two at one level share a label. */
54
64
  id?: string;
55
65
  label: string;
56
66
  icon?: string;
@@ -61,15 +71,20 @@ export interface KjunDropdownSubmenuProps {
61
71
  export declare function KjunDropdownSubmenu({ id, label, icon, disabled, children }: KjunDropdownSubmenuProps): import("react/jsx-runtime").JSX.Element;
62
72
  export declare function KjunDropdownDivider(): import("react/jsx-runtime").JSX.Element | null;
63
73
  export interface KjunMenuButtonProps extends Omit<KjunDropdownProps, "trigger"> {
64
- label?: string;
74
+ /** The visible label; a node can carry an icon or a colour swatch. Without readable text in it, give ariaLabel. */
75
+ label?: ReactNode;
65
76
  size?: KjunButtonProps["size"];
66
77
  variant?: KjunButtonProps["variant"];
67
78
  /** Show a square dots-vertical button; label remains its accessible name. */
68
79
  compact?: boolean;
80
+ /** Icon before the label, or in place of dots-vertical when compact or unlabelled. */
81
+ icon?: string;
82
+ /** Show the chevron after a visible label (default true); false where the icon already says it opens a menu. */
83
+ chevron?: boolean;
69
84
  loading?: boolean;
70
85
  tooltip?: string;
71
86
  tooltipPlacement?: KjunTooltipProps["placement"];
72
87
  tooltipDelay?: number;
73
88
  ariaLabel?: string;
74
89
  }
75
- export declare function KjunMenuButton({ label, size, variant, compact, loading, tooltip, tooltipPlacement, tooltipDelay, ariaLabel, onOpen, onClose, ...props }: KjunMenuButtonProps): import("react/jsx-runtime").JSX.Element;
90
+ export declare function KjunMenuButton({ label, size, variant, compact, icon, chevron, loading, tooltip, tooltipPlacement, tooltipDelay, ariaLabel, onOpen, onClose, ...props }: KjunMenuButtonProps): import("react/jsx-runtime").JSX.Element;
@@ -0,0 +1,47 @@
1
+ import { type WeekStart } from "../../../shared/package-runtime/calendar.cjs";
2
+ import { type DayMarks, type HolidayTest } from "../../../shared/package-runtime/event-calendar.cjs";
3
+ import { type CSSProperties } from "react";
4
+ export type { DayMarks, DaySpan, HolidayTest } from "../../../shared/package-runtime/event-calendar.cjs";
5
+ export interface KjunEventCalendarProps {
6
+ /** A whole month (default) or one week. */
7
+ view?: "month" | "week";
8
+ /** The month shown, "YYYY-MM" (controlled; this month when missing or malformed). */
9
+ month?: string;
10
+ /** Asked for another month by a swipe, the keyboard or an outside day; without it the month does not change. */
11
+ onMonthChange?: (month: string) => void;
12
+ /** Week view: any day of the week shown, "YYYY-MM-DD" (controlled; this week when missing). */
13
+ week?: string;
14
+ /** Asked for another week with that week's first day; without it the week does not change. */
15
+ onWeekChange?: (week: string) => void;
16
+ /** The picked day, "YYYY-MM-DD"; null picks nothing. Clearing it is up to the app. */
17
+ value?: string | null;
18
+ /** A day was pressed; the app decides whether it becomes the value. */
19
+ onSelect?: (iso: string) => void;
20
+ /** Touch hold, right click or Shift+Enter on a day; without it these are left to the browser. */
21
+ onDayLongPress?: (iso: string) => void;
22
+ /** Describes the long press to screen readers, e.g. "이날 약속 추가". */
23
+ dayLongPressLabel?: string;
24
+ /** What a day shows under its number: the first span, an icon and up to three dots; count is spoken only. */
25
+ marks?: (iso: string) => DayMarks | undefined;
26
+ /** Holidays draw a danger number; a string also names the day for screen readers. */
27
+ isHoliday?: HolidayTest;
28
+ /** Fades the numbers and marks of days before today (default true); span bars keep their colour. */
29
+ dimPast?: boolean;
30
+ /** The first column of the week: 0 Sunday (default), 1 Monday. */
31
+ weekStart?: WeekStart;
32
+ /** Paints Sundays with the danger role (default true). */
33
+ markSunday?: boolean;
34
+ /** Paints Saturdays with the info role (default true). */
35
+ markSaturday?: boolean;
36
+ /** The app's today, "YYYY-MM-DD" (server time, another time zone); the device's today when missing or malformed. */
37
+ today?: string;
38
+ /** The app is still fetching the period's events: day numbers step back to the past fade and the grid is busy. Days stay pressable. */
39
+ loading?: boolean;
40
+ /** A horizontal touch swipe asks for the next or previous month or week (default true). Mouse drags never do. */
41
+ swipeable?: boolean;
42
+ className?: string;
43
+ style?: CSSProperties;
44
+ id?: string;
45
+ }
46
+ /** A month or week of days that show events as dots, an icon and a span bar. It draws no card or heading. */
47
+ export declare function KjunEventCalendar({ view, month, onMonthChange, week, onWeekChange, value, onSelect, onDayLongPress, dayLongPressLabel, marks, isHoliday, dimPast, weekStart, markSunday, markSaturday, swipeable, today: todayProp, loading, className, style, id }: KjunEventCalendarProps): import("react/jsx-runtime").JSX.Element;
@@ -0,0 +1,47 @@
1
+ import { type WeekStart } from "../../../shared/package-runtime/calendar.js";
2
+ import { type DayMarks, type HolidayTest } from "../../../shared/package-runtime/event-calendar.js";
3
+ import { type CSSProperties } from "react";
4
+ export type { DayMarks, DaySpan, HolidayTest } from "../../../shared/package-runtime/event-calendar.js";
5
+ export interface KjunEventCalendarProps {
6
+ /** A whole month (default) or one week. */
7
+ view?: "month" | "week";
8
+ /** The month shown, "YYYY-MM" (controlled; this month when missing or malformed). */
9
+ month?: string;
10
+ /** Asked for another month by a swipe, the keyboard or an outside day; without it the month does not change. */
11
+ onMonthChange?: (month: string) => void;
12
+ /** Week view: any day of the week shown, "YYYY-MM-DD" (controlled; this week when missing). */
13
+ week?: string;
14
+ /** Asked for another week with that week's first day; without it the week does not change. */
15
+ onWeekChange?: (week: string) => void;
16
+ /** The picked day, "YYYY-MM-DD"; null picks nothing. Clearing it is up to the app. */
17
+ value?: string | null;
18
+ /** A day was pressed; the app decides whether it becomes the value. */
19
+ onSelect?: (iso: string) => void;
20
+ /** Touch hold, right click or Shift+Enter on a day; without it these are left to the browser. */
21
+ onDayLongPress?: (iso: string) => void;
22
+ /** Describes the long press to screen readers, e.g. "이날 약속 추가". */
23
+ dayLongPressLabel?: string;
24
+ /** What a day shows under its number: the first span, an icon and up to three dots; count is spoken only. */
25
+ marks?: (iso: string) => DayMarks | undefined;
26
+ /** Holidays draw a danger number; a string also names the day for screen readers. */
27
+ isHoliday?: HolidayTest;
28
+ /** Fades the numbers and marks of days before today (default true); span bars keep their colour. */
29
+ dimPast?: boolean;
30
+ /** The first column of the week: 0 Sunday (default), 1 Monday. */
31
+ weekStart?: WeekStart;
32
+ /** Paints Sundays with the danger role (default true). */
33
+ markSunday?: boolean;
34
+ /** Paints Saturdays with the info role (default true). */
35
+ markSaturday?: boolean;
36
+ /** The app's today, "YYYY-MM-DD" (server time, another time zone); the device's today when missing or malformed. */
37
+ today?: string;
38
+ /** The app is still fetching the period's events: day numbers step back to the past fade and the grid is busy. Days stay pressable. */
39
+ loading?: boolean;
40
+ /** A horizontal touch swipe asks for the next or previous month or week (default true). Mouse drags never do. */
41
+ swipeable?: boolean;
42
+ className?: string;
43
+ style?: CSSProperties;
44
+ id?: string;
45
+ }
46
+ /** A month or week of days that show events as dots, an icon and a span bar. It draws no card or heading. */
47
+ export declare function KjunEventCalendar({ view, month, onMonthChange, week, onWeekChange, value, onSelect, onDayLongPress, dayLongPressLabel, marks, isHoliday, dimPast, weekStart, markSunday, markSaturday, swipeable, today: todayProp, loading, className, style, id }: KjunEventCalendarProps): import("react/jsx-runtime").JSX.Element;
@@ -4,6 +4,8 @@ export interface KjunFabProps extends Omit<ButtonHTMLAttributes<HTMLButtonElemen
4
4
  icon: string;
5
5
  /** Visible text beside the icon; the circle becomes a capsule of the same height. */
6
6
  label?: string;
7
+ /** Folds a labelled FAB back into its circle (e.g. while the page scrolls); the label stays its name. */
8
+ collapsed?: boolean;
7
9
  /** The accessible name. Required without a label, since the icon alone says nothing. */
8
10
  ariaLabel?: string;
9
11
  /** "md" (default) is 56, "sm" is 48. Both take a label, loading and every state. */