@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
@@ -2,6 +2,8 @@ import { type TableSort, type QueryDisplayProps } from "@kjun-ui/tokens";
2
2
  export type { TableSort } from "@kjun-ui/tokens";
3
3
  import { type ReactNode } from "react";
4
4
  import type { TableSummaryKind } from "./table-groups.cjs";
5
+ import type { TableColumnGroup } from "./table-columns.cjs";
6
+ export type { TableColumnGroup } from "./table-columns.cjs";
5
7
  export type { TableSummaryKind } from "./table-groups.cjs";
6
8
  import { type TableCompare } from "./table-model.cjs";
7
9
  export { getValue } from "./table-model.cjs";
@@ -25,6 +27,12 @@ export interface TableColumn<Row extends object = Record<string, unknown>> {
25
27
  secondary?: boolean;
26
28
  className?: string;
27
29
  headerClass?: string;
30
+ /** Makes the cell a button that runs this, instead of opening the row (row clicks and keys stay with the row elsewhere). */
31
+ onCellPress?: (row: Row, index: number) => void;
32
+ /** The cell button's accessible name when its content alone does not say what it does, e.g. "목표가 82,000원, 근거 보기". */
33
+ cellLabel?: (row: Row, index: number) => string;
34
+ /** Web: extra attributes for the grid cell element (data-*, aria-*, title). Native ignores it. */
35
+ cellProps?: (row: Row, index: number) => Record<string, unknown> | undefined;
28
36
  }
29
37
  export interface TableCardSection {
30
38
  key?: string;
@@ -40,6 +48,27 @@ export interface TablePagination {
40
48
  }
41
49
  export interface TableProps<Row extends object = Record<string, unknown>, MaxHeight = number> extends QueryDisplayProps {
42
50
  columns: TableColumn<Row>[];
51
+ /** Labels over runs of columns, by column key: the header gets a second row. Narrow cards use them as sections when cardSections is empty. */
52
+ columnGroups?: TableColumnGroup[];
53
+ /** How many columns a row's cell covers, counting itself (2 merges it with the next column). The covered cells are not drawn. */
54
+ cellSpan?: (row: Row, column: TableColumn<Row>) => number | null | undefined;
55
+ /** Rows listed in `order` get up and down buttons. The app keeps the order, passes `data` in it and saves it. */
56
+ reorderable?: boolean;
57
+ /** The rows' rowKey values in the order shown; a row whose key is not listed cannot move. */
58
+ order?: (string | number)[];
59
+ /** Called with the next order when a row moves; the app applies it. */
60
+ onOrderChange?: (order: (string | number)[]) => void;
61
+ /** The same move in detail: the row's key, where it was and where it went. */
62
+ onReorder?: (move: {
63
+ value: string | number;
64
+ from: number;
65
+ to: number;
66
+ order: (string | number)[];
67
+ }) => void;
68
+ /** Turns the move buttons off. They are also off while the table is sorted by a column or grouped. */
69
+ reorderDisabled?: boolean;
70
+ /** Why moving is off, shown under the table and read with the buttons; a sorted or grouped table says so by default. */
71
+ reorderDisabledText?: string;
43
72
  data?: Row[];
44
73
  rowKey?: string;
45
74
  skeletonRows?: number;
@@ -55,6 +84,10 @@ export interface TableProps<Row extends object = Record<string, unknown>, MaxHei
55
84
  hoverable?: boolean;
56
85
  searchable?: boolean;
57
86
  searchPlaceholder?: string;
87
+ /** "client" filters data by the search box itself (searchKeys, or every column); "server" (default) only reports the query through onSearch. */
88
+ searchMode?: "client" | "server";
89
+ /** Row fields (dot paths) a client search looks in. Default: every column's key. */
90
+ searchKeys?: string[];
58
91
  stickyHeader?: boolean;
59
92
  /** Without maxHeight a sticky header sticks under the page scroll; this is its distance from the viewport top (px). */
60
93
  stickyOffset?: number;
@@ -62,6 +95,8 @@ export interface TableProps<Row extends object = Record<string, unknown>, MaxHei
62
95
  pagination?: TablePagination | null;
63
96
  compact?: boolean;
64
97
  striped?: boolean;
98
+ /** "none" drops the first column's start padding and the last column's end padding in the grid, so the table lines up with text around it. For tables without row fills. */
99
+ edgeInset?: "default" | "none";
65
100
  ariaLabel?: string;
66
101
  responsive?: "card" | "list" | "compact" | "none" | null;
67
102
  mobileColumns?: string[];
@@ -77,7 +112,10 @@ export interface TableProps<Row extends object = Record<string, unknown>, MaxHei
77
112
  expandSingle?: boolean;
78
113
  rowClass?: string | ((row: Row, index: number) => string);
79
114
  selectable?: boolean;
115
+ /** The selected rows. Leave unset for internal selection; onSelectionChange still reports each change. */
80
116
  selected?: Row[];
117
+ /** Rows that can be selected: the others keep a disabled checkbox and are skipped by select all. Row clicks and expansion stay. */
118
+ rowSelectable?: (row: Row) => boolean;
81
119
  /** Row field (dot path) whose values split the rows into collapsible groups. */
82
120
  groupBy?: string;
83
121
  /** Original groupBy values of open groups. undefined: internal state, initially all open; []: all closed. */
@@ -112,15 +150,19 @@ export declare function useTableModel<Row extends object>(props: TableProps<Row,
112
150
  key: (row: Row, index?: number) => string | number;
113
151
  sort: TableSort;
114
152
  search: string;
153
+ selected: Row[];
115
154
  all: boolean;
116
155
  some: boolean;
156
+ selectableCount: number;
117
157
  selectedRow: (row: Row) => boolean;
158
+ selectableRow: (row: Row) => boolean;
118
159
  expanded: (string | number)[];
119
160
  searchChange: (q: string) => void;
120
161
  sortColumn: (col: TableColumn<Row>) => void;
121
162
  /** The narrow-screen sort choice: an exact key and order, or { key: "" } for the data's own order. */
122
163
  sortTo: (next: TableSort) => void;
123
- toggleRow: (row: Row) => void | undefined;
124
- toggleAll: () => void | undefined;
164
+ toggleRow: (row: Row) => void;
165
+ toggleAll: () => void;
166
+ clearSelection: () => void;
125
167
  toggleExpand: (row: Row, index: number) => void;
126
168
  };
@@ -2,6 +2,8 @@ import { type TableSort, type QueryDisplayProps } from "@kjun-ui/tokens";
2
2
  export type { TableSort } from "@kjun-ui/tokens";
3
3
  import { type ReactNode } from "react";
4
4
  import type { TableSummaryKind } from "./table-groups.js";
5
+ import type { TableColumnGroup } from "./table-columns.js";
6
+ export type { TableColumnGroup } from "./table-columns.js";
5
7
  export type { TableSummaryKind } from "./table-groups.js";
6
8
  import { type TableCompare } from "./table-model.js";
7
9
  export { getValue } from "./table-model.js";
@@ -25,6 +27,12 @@ export interface TableColumn<Row extends object = Record<string, unknown>> {
25
27
  secondary?: boolean;
26
28
  className?: string;
27
29
  headerClass?: string;
30
+ /** Makes the cell a button that runs this, instead of opening the row (row clicks and keys stay with the row elsewhere). */
31
+ onCellPress?: (row: Row, index: number) => void;
32
+ /** The cell button's accessible name when its content alone does not say what it does, e.g. "목표가 82,000원, 근거 보기". */
33
+ cellLabel?: (row: Row, index: number) => string;
34
+ /** Web: extra attributes for the grid cell element (data-*, aria-*, title). Native ignores it. */
35
+ cellProps?: (row: Row, index: number) => Record<string, unknown> | undefined;
28
36
  }
29
37
  export interface TableCardSection {
30
38
  key?: string;
@@ -40,6 +48,27 @@ export interface TablePagination {
40
48
  }
41
49
  export interface TableProps<Row extends object = Record<string, unknown>, MaxHeight = number> extends QueryDisplayProps {
42
50
  columns: TableColumn<Row>[];
51
+ /** Labels over runs of columns, by column key: the header gets a second row. Narrow cards use them as sections when cardSections is empty. */
52
+ columnGroups?: TableColumnGroup[];
53
+ /** How many columns a row's cell covers, counting itself (2 merges it with the next column). The covered cells are not drawn. */
54
+ cellSpan?: (row: Row, column: TableColumn<Row>) => number | null | undefined;
55
+ /** Rows listed in `order` get up and down buttons. The app keeps the order, passes `data` in it and saves it. */
56
+ reorderable?: boolean;
57
+ /** The rows' rowKey values in the order shown; a row whose key is not listed cannot move. */
58
+ order?: (string | number)[];
59
+ /** Called with the next order when a row moves; the app applies it. */
60
+ onOrderChange?: (order: (string | number)[]) => void;
61
+ /** The same move in detail: the row's key, where it was and where it went. */
62
+ onReorder?: (move: {
63
+ value: string | number;
64
+ from: number;
65
+ to: number;
66
+ order: (string | number)[];
67
+ }) => void;
68
+ /** Turns the move buttons off. They are also off while the table is sorted by a column or grouped. */
69
+ reorderDisabled?: boolean;
70
+ /** Why moving is off, shown under the table and read with the buttons; a sorted or grouped table says so by default. */
71
+ reorderDisabledText?: string;
43
72
  data?: Row[];
44
73
  rowKey?: string;
45
74
  skeletonRows?: number;
@@ -55,6 +84,10 @@ export interface TableProps<Row extends object = Record<string, unknown>, MaxHei
55
84
  hoverable?: boolean;
56
85
  searchable?: boolean;
57
86
  searchPlaceholder?: string;
87
+ /** "client" filters data by the search box itself (searchKeys, or every column); "server" (default) only reports the query through onSearch. */
88
+ searchMode?: "client" | "server";
89
+ /** Row fields (dot paths) a client search looks in. Default: every column's key. */
90
+ searchKeys?: string[];
58
91
  stickyHeader?: boolean;
59
92
  /** Without maxHeight a sticky header sticks under the page scroll; this is its distance from the viewport top (px). */
60
93
  stickyOffset?: number;
@@ -62,6 +95,8 @@ export interface TableProps<Row extends object = Record<string, unknown>, MaxHei
62
95
  pagination?: TablePagination | null;
63
96
  compact?: boolean;
64
97
  striped?: boolean;
98
+ /** "none" drops the first column's start padding and the last column's end padding in the grid, so the table lines up with text around it. For tables without row fills. */
99
+ edgeInset?: "default" | "none";
65
100
  ariaLabel?: string;
66
101
  responsive?: "card" | "list" | "compact" | "none" | null;
67
102
  mobileColumns?: string[];
@@ -77,7 +112,10 @@ export interface TableProps<Row extends object = Record<string, unknown>, MaxHei
77
112
  expandSingle?: boolean;
78
113
  rowClass?: string | ((row: Row, index: number) => string);
79
114
  selectable?: boolean;
115
+ /** The selected rows. Leave unset for internal selection; onSelectionChange still reports each change. */
80
116
  selected?: Row[];
117
+ /** Rows that can be selected: the others keep a disabled checkbox and are skipped by select all. Row clicks and expansion stay. */
118
+ rowSelectable?: (row: Row) => boolean;
81
119
  /** Row field (dot path) whose values split the rows into collapsible groups. */
82
120
  groupBy?: string;
83
121
  /** Original groupBy values of open groups. undefined: internal state, initially all open; []: all closed. */
@@ -112,15 +150,19 @@ export declare function useTableModel<Row extends object>(props: TableProps<Row,
112
150
  key: (row: Row, index?: number) => string | number;
113
151
  sort: TableSort;
114
152
  search: string;
153
+ selected: Row[];
115
154
  all: boolean;
116
155
  some: boolean;
156
+ selectableCount: number;
117
157
  selectedRow: (row: Row) => boolean;
158
+ selectableRow: (row: Row) => boolean;
118
159
  expanded: (string | number)[];
119
160
  searchChange: (q: string) => void;
120
161
  sortColumn: (col: TableColumn<Row>) => void;
121
162
  /** The narrow-screen sort choice: an exact key and order, or { key: "" } for the data's own order. */
122
163
  sortTo: (next: TableSort) => void;
123
- toggleRow: (row: Row) => void | undefined;
124
- toggleAll: () => void | undefined;
164
+ toggleRow: (row: Row) => void;
165
+ toggleAll: () => void;
166
+ clearSelection: () => void;
125
167
  toggleExpand: (row: Row, index: number) => void;
126
168
  };
@@ -1,9 +1,11 @@
1
1
  import { type InputSize } from "@kjun-ui/tokens";
2
2
  export declare const textareaMaxRows = 6;
3
+ /** A number of rows, or "none" for a field that grows with all of its text and never scrolls inside (a note, a document body). */
4
+ export type TextareaMaxRows = number | "none";
3
5
  /** Border-box height for a number of text rows at a field size. */
4
6
  export declare function textareaRowsHeight(size: InputSize, rows: number, footer?: boolean): number;
5
- /** The [minimum, maximum] border-box height; a maximum below the minimum keeps the field at `rows`. */
6
- export declare function textareaBounds(size: InputSize, rows: number, maxRows: number, footer?: boolean): readonly [
7
+ /** The [minimum, maximum] border-box height; a maximum below the minimum keeps the field at `rows`, and "none" has no maximum (Infinity). */
8
+ export declare function textareaBounds(size: InputSize, rows: number, maxRows: TextareaMaxRows, footer?: boolean): readonly [
7
9
  number,
8
10
  number
9
11
  ];
@@ -17,9 +19,9 @@ export type TextareaResize = "none" | "vertical" | "horizontal" | "both";
17
19
  /** A field the user can drag taller keeps the height they chose, so it does not also grow with its text. */
18
20
  export declare const textareaGrows: (minimum: number, maximum: number, resize?: TextareaResize) => boolean;
19
21
  /** The text inset: with a footer the wrapper carries the border, so the text keeps the field's own inset. */
20
- export declare function textareaPadding(size: InputSize, footer: boolean): {
22
+ export declare function textareaPadding(size: InputSize, footer: boolean, plain?: boolean): {
21
23
  top: 16 | 12 | 8;
22
- x: 20 | 16 | 12;
24
+ x: number;
23
25
  bottom: 4;
24
26
  } | {
25
27
  top: 16 | 12 | 8;
@@ -1,9 +1,11 @@
1
1
  import { type InputSize } from "@kjun-ui/tokens";
2
2
  export declare const textareaMaxRows = 6;
3
+ /** A number of rows, or "none" for a field that grows with all of its text and never scrolls inside (a note, a document body). */
4
+ export type TextareaMaxRows = number | "none";
3
5
  /** Border-box height for a number of text rows at a field size. */
4
6
  export declare function textareaRowsHeight(size: InputSize, rows: number, footer?: boolean): number;
5
- /** The [minimum, maximum] border-box height; a maximum below the minimum keeps the field at `rows`. */
6
- export declare function textareaBounds(size: InputSize, rows: number, maxRows: number, footer?: boolean): readonly [
7
+ /** The [minimum, maximum] border-box height; a maximum below the minimum keeps the field at `rows`, and "none" has no maximum (Infinity). */
8
+ export declare function textareaBounds(size: InputSize, rows: number, maxRows: TextareaMaxRows, footer?: boolean): readonly [
7
9
  number,
8
10
  number
9
11
  ];
@@ -17,9 +19,9 @@ export type TextareaResize = "none" | "vertical" | "horizontal" | "both";
17
19
  /** A field the user can drag taller keeps the height they chose, so it does not also grow with its text. */
18
20
  export declare const textareaGrows: (minimum: number, maximum: number, resize?: TextareaResize) => boolean;
19
21
  /** The text inset: with a footer the wrapper carries the border, so the text keeps the field's own inset. */
20
- export declare function textareaPadding(size: InputSize, footer: boolean): {
22
+ export declare function textareaPadding(size: InputSize, footer: boolean, plain?: boolean): {
21
23
  top: 16 | 12 | 8;
22
- x: 20 | 16 | 12;
24
+ x: number;
23
25
  bottom: 4;
24
26
  } | {
25
27
  top: 16 | 12 | 8;
@@ -0,0 +1,7 @@
1
+ import { type ReactNode } from "react";
2
+ /** The cells: every child, fragments opened, with nothing for false, null and blank strings. Keys keep the
3
+ * fragment path so a child inside a fragment never shares a key with one outside it. */
4
+ export declare function tileItems(children: ReactNode, path?: string): [
5
+ string,
6
+ ReactNode
7
+ ][];
@@ -0,0 +1,7 @@
1
+ import { type ReactNode } from "react";
2
+ /** The cells: every child, fragments opened, with nothing for false, null and blank strings. Keys keep the
3
+ * fragment path so a child inside a fragment never shares a key with one outside it. */
4
+ export declare function tileItems(children: ReactNode, path?: string): [
5
+ string,
6
+ ReactNode
7
+ ][];
@@ -0,0 +1,18 @@
1
+ /** auto is compact in a container narrower than the breakpoint (tokens.responsive.tilesGap) and regular from it. */
2
+ export type TilesGap = "auto" | "compact" | "regular";
3
+ /** A cell's narrowest width before a column is dropped: tokens.extensions.tiles.minItem. */
4
+ export type TilesMinItem = "sm" | "md" | "lg";
5
+ export type TilesMaxColumns = 2 | 3 | 4;
6
+ /** The gap step that applies at a container width. */
7
+ export declare const tilesGapStep: (gap: TilesGap, width: number, breakpoint: number) => "compact" | "regular";
8
+ /** As many columns as keep each cell at least minItem wide, between one and maxColumns. Unmeasured widths get one. */
9
+ export declare function tilesColumns(width: number, minItem: number, gap: number, maxColumns: number): number;
10
+ /** Each cell's share of the width after the gaps, like a grid track; undefined until the container has a width. */
11
+ export declare const tilesCellWidth: (width: number, columns: number, gap: number) => number | undefined;
12
+ /** The props with their defaults; a maxColumns outside 2·3·4 falls back to 4. A Vue template's max-columns="3"
13
+ * arrives as the string "3" and counts as 3. */
14
+ export declare const tilesProps: (gap?: TilesGap, minItem?: TilesMinItem, maxColumns?: number | string) => {
15
+ gap: TilesGap;
16
+ minItem: TilesMinItem;
17
+ maxColumns: TilesMaxColumns;
18
+ };
@@ -0,0 +1,18 @@
1
+ /** auto is compact in a container narrower than the breakpoint (tokens.responsive.tilesGap) and regular from it. */
2
+ export type TilesGap = "auto" | "compact" | "regular";
3
+ /** A cell's narrowest width before a column is dropped: tokens.extensions.tiles.minItem. */
4
+ export type TilesMinItem = "sm" | "md" | "lg";
5
+ export type TilesMaxColumns = 2 | 3 | 4;
6
+ /** The gap step that applies at a container width. */
7
+ export declare const tilesGapStep: (gap: TilesGap, width: number, breakpoint: number) => "compact" | "regular";
8
+ /** As many columns as keep each cell at least minItem wide, between one and maxColumns. Unmeasured widths get one. */
9
+ export declare function tilesColumns(width: number, minItem: number, gap: number, maxColumns: number): number;
10
+ /** Each cell's share of the width after the gaps, like a grid track; undefined until the container has a width. */
11
+ export declare const tilesCellWidth: (width: number, columns: number, gap: number) => number | undefined;
12
+ /** The props with their defaults; a maxColumns outside 2·3·4 falls back to 4. A Vue template's max-columns="3"
13
+ * arrives as the string "3" and counts as 3. */
14
+ export declare const tilesProps: (gap?: TilesGap, minItem?: TilesMinItem, maxColumns?: number | string) => {
15
+ gap: TilesGap;
16
+ minItem: TilesMinItem;
17
+ maxColumns: TilesMaxColumns;
18
+ };
@@ -22,4 +22,28 @@ export declare function timeSegments(domain: TimeDomain, value: string | null, {
22
22
  }): TimeSegmentModel[];
23
23
  /** Korean and other East Asian clocks put 오전/오후 before the hour; most others put AM/PM after it. */
24
24
  export declare const periodLeads: (language?: string) => boolean;
25
+ /** Typing digits into a focused segment: a digit picks at once when no two-digit option starts with it; otherwise it waits for a
26
+ * second digit (and picks the single digit meanwhile when that is an option). A pair that is no option starts over from the new digit.
27
+ * `typed` is the waiting digit ("" for none); `value` the option to pick (null for none); `advance` moves focus to the next segment. */
28
+ export declare function typeSegmentDigit(options: readonly number[], typed: string, digit: string): {
29
+ typed: string;
30
+ value: number | null;
31
+ advance: boolean;
32
+ };
33
+ /** A period segment answers the first letter of its labels (a/p, or the label's own first letter when the two differ). */
34
+ export declare function typeSegmentPeriod(options: readonly {
35
+ value: number;
36
+ label: string;
37
+ }[], key: string): number | null;
38
+ /** Keeps the waiting digit of a TimePicker for a second, like a typeahead. */
39
+ export declare function createSegmentTyping(timeout?: number): {
40
+ key(segment: TimeSegmentModel, segmentIndex: number, key: string, now?: number): {
41
+ value: number | null;
42
+ advance: boolean;
43
+ } | null;
44
+ reset(): void;
45
+ };
46
+ /** A segment's spinbutton keys: ↑ and ↓ take the next and previous option and go round, Home and End the first and last.
47
+ * An empty segment starts from its first option (↑) or its last (↓). Returns the option, or null when the key does nothing. */
48
+ export declare function segmentStep(segment: TimeSegmentModel, key: string): number | null;
25
49
  export {};
@@ -22,4 +22,28 @@ export declare function timeSegments(domain: TimeDomain, value: string | null, {
22
22
  }): TimeSegmentModel[];
23
23
  /** Korean and other East Asian clocks put 오전/오후 before the hour; most others put AM/PM after it. */
24
24
  export declare const periodLeads: (language?: string) => boolean;
25
+ /** Typing digits into a focused segment: a digit picks at once when no two-digit option starts with it; otherwise it waits for a
26
+ * second digit (and picks the single digit meanwhile when that is an option). A pair that is no option starts over from the new digit.
27
+ * `typed` is the waiting digit ("" for none); `value` the option to pick (null for none); `advance` moves focus to the next segment. */
28
+ export declare function typeSegmentDigit(options: readonly number[], typed: string, digit: string): {
29
+ typed: string;
30
+ value: number | null;
31
+ advance: boolean;
32
+ };
33
+ /** A period segment answers the first letter of its labels (a/p, or the label's own first letter when the two differ). */
34
+ export declare function typeSegmentPeriod(options: readonly {
35
+ value: number;
36
+ label: string;
37
+ }[], key: string): number | null;
38
+ /** Keeps the waiting digit of a TimePicker for a second, like a typeahead. */
39
+ export declare function createSegmentTyping(timeout?: number): {
40
+ key(segment: TimeSegmentModel, segmentIndex: number, key: string, now?: number): {
41
+ value: number | null;
42
+ advance: boolean;
43
+ } | null;
44
+ reset(): void;
45
+ };
46
+ /** A segment's spinbutton keys: ↑ and ↓ take the next and previous option and go round, Home and End the first and last.
47
+ * An empty segment starts from its first option (↑) or its last (↓). Returns the option, or null when the key does nothing. */
48
+ export declare function segmentStep(segment: TimeSegmentModel, key: string): number | null;
25
49
  export {};
@@ -0,0 +1,54 @@
1
+ import type { createTimeDomain, TimePrecision } from "@kjun-ui/tokens";
2
+ import type { KjunMessages } from "./messages/ko.cjs";
3
+ import type { HourCycle } from "./time-segments.cjs";
4
+ type TimeDomain = ReturnType<typeof createTimeDomain>;
5
+ export type TimeLayout = "auto" | "popover" | "sheet" | "inline";
6
+ export type TimeTrigger = "segments" | "button";
7
+ export type WheelColumnKey = "period" | "hour" | "minute" | "second";
8
+ export interface WheelItem {
9
+ value: number;
10
+ label: string;
11
+ disabled: boolean;
12
+ }
13
+ export interface WheelColumn {
14
+ key: WheelColumnKey;
15
+ label: string;
16
+ items: WheelItem[];
17
+ /** The index of the draft's item. */
18
+ index: number;
19
+ /** Hours, minutes and seconds go round; AM/PM stops at its ends. */
20
+ loop: boolean;
21
+ }
22
+ export interface TimeWheelOptions {
23
+ precision: TimePrecision;
24
+ hourCycle?: HourCycle;
25
+ minuteStep?: number;
26
+ secondStep?: number;
27
+ messages: KjunMessages;
28
+ periodFirst?: boolean;
29
+ }
30
+ /** The wheel's columns for a draft time, in the order the segments read. */
31
+ export declare function timeWheel(domain: TimeDomain, draft: string, { precision, hourCycle, minuteStep, secondStep, messages, periodFirst }: TimeWheelOptions): WheelColumn[];
32
+ /** The draft after a column stops on a value: that time when it is allowed, otherwise the closest allowed one. */
33
+ export declare function wheelPick(domain: TimeDomain, draft: string, key: WheelColumnKey, value: number, { precision, hourCycle }: Pick<TimeWheelOptions, "precision" | "hourCycle">): string;
34
+ /** Where the wheel starts: the value, the allowed time closest to it, or the allowed time closest to now (which rounds now to the step). */
35
+ export declare function wheelStart(domain: TimeDomain, value: string | null, now?: Date): string;
36
+ /** A time as it reads on the button trigger: "09:30" on a 24-hour clock, "오전 9:30" or "9:30 AM" on a 12-hour one. */
37
+ export declare function timeText(domain: TimeDomain, value: string | null, { precision, hourCycle, messages, periodFirst }: Pick<TimeWheelOptions, "precision" | "hourCycle" | "messages" | "periodFirst">): string;
38
+ /** The value a key moves a column to, skipping faded items; null when the key does nothing or the column cannot move. */
39
+ export declare function wheelKey(column: WheelColumn, key: string): number | null;
40
+ /** auto takes the sheet on touch screens and devices, the popover elsewhere. */
41
+ export declare const resolveTimeLayout: (layout: TimeLayout, coarse: boolean) => Exclude<TimeLayout, "auto">;
42
+ /** Segments keep typing on a keyboard; a sheet opens from a one-line button. */
43
+ export declare const resolveTimeTrigger: (trigger: TimeTrigger | undefined, layout: Exclude<TimeLayout, "auto">) => TimeTrigger;
44
+ /** A ":" goes before a digit column that follows another (hour:minute:second); AM/PM reads as a word and takes none, as in the field. */
45
+ export declare const wheelSeparated: (columns: Pick<WheelColumn, "key">[], index: number) => boolean;
46
+ /** A looping column draws its items three times and stays in the middle copy, so it turns either way without an end. */
47
+ export declare const wheelCopies: (column: Pick<WheelColumn, "loop">) => 1 | 3;
48
+ /** The row to show an item on: the copy nearest to the row now in the middle, so a move takes the short way round. */
49
+ export declare function wheelRow(column: WheelColumn, index: number, current: number | null): number;
50
+ /** The same item's row in the middle copy, where a looping column settles after a turn. */
51
+ export declare const wheelHome: (column: WheelColumn, row: number) => number;
52
+ /** The item a settled row shows. */
53
+ export declare const wheelItemAt: (column: WheelColumn, row: number) => WheelItem;
54
+ export {};
@@ -0,0 +1,54 @@
1
+ import type { createTimeDomain, TimePrecision } from "@kjun-ui/tokens";
2
+ import type { KjunMessages } from "./messages/ko.js";
3
+ import type { HourCycle } from "./time-segments.js";
4
+ type TimeDomain = ReturnType<typeof createTimeDomain>;
5
+ export type TimeLayout = "auto" | "popover" | "sheet" | "inline";
6
+ export type TimeTrigger = "segments" | "button";
7
+ export type WheelColumnKey = "period" | "hour" | "minute" | "second";
8
+ export interface WheelItem {
9
+ value: number;
10
+ label: string;
11
+ disabled: boolean;
12
+ }
13
+ export interface WheelColumn {
14
+ key: WheelColumnKey;
15
+ label: string;
16
+ items: WheelItem[];
17
+ /** The index of the draft's item. */
18
+ index: number;
19
+ /** Hours, minutes and seconds go round; AM/PM stops at its ends. */
20
+ loop: boolean;
21
+ }
22
+ export interface TimeWheelOptions {
23
+ precision: TimePrecision;
24
+ hourCycle?: HourCycle;
25
+ minuteStep?: number;
26
+ secondStep?: number;
27
+ messages: KjunMessages;
28
+ periodFirst?: boolean;
29
+ }
30
+ /** The wheel's columns for a draft time, in the order the segments read. */
31
+ export declare function timeWheel(domain: TimeDomain, draft: string, { precision, hourCycle, minuteStep, secondStep, messages, periodFirst }: TimeWheelOptions): WheelColumn[];
32
+ /** The draft after a column stops on a value: that time when it is allowed, otherwise the closest allowed one. */
33
+ export declare function wheelPick(domain: TimeDomain, draft: string, key: WheelColumnKey, value: number, { precision, hourCycle }: Pick<TimeWheelOptions, "precision" | "hourCycle">): string;
34
+ /** Where the wheel starts: the value, the allowed time closest to it, or the allowed time closest to now (which rounds now to the step). */
35
+ export declare function wheelStart(domain: TimeDomain, value: string | null, now?: Date): string;
36
+ /** A time as it reads on the button trigger: "09:30" on a 24-hour clock, "오전 9:30" or "9:30 AM" on a 12-hour one. */
37
+ export declare function timeText(domain: TimeDomain, value: string | null, { precision, hourCycle, messages, periodFirst }: Pick<TimeWheelOptions, "precision" | "hourCycle" | "messages" | "periodFirst">): string;
38
+ /** The value a key moves a column to, skipping faded items; null when the key does nothing or the column cannot move. */
39
+ export declare function wheelKey(column: WheelColumn, key: string): number | null;
40
+ /** auto takes the sheet on touch screens and devices, the popover elsewhere. */
41
+ export declare const resolveTimeLayout: (layout: TimeLayout, coarse: boolean) => Exclude<TimeLayout, "auto">;
42
+ /** Segments keep typing on a keyboard; a sheet opens from a one-line button. */
43
+ export declare const resolveTimeTrigger: (trigger: TimeTrigger | undefined, layout: Exclude<TimeLayout, "auto">) => TimeTrigger;
44
+ /** A ":" goes before a digit column that follows another (hour:minute:second); AM/PM reads as a word and takes none, as in the field. */
45
+ export declare const wheelSeparated: (columns: Pick<WheelColumn, "key">[], index: number) => boolean;
46
+ /** A looping column draws its items three times and stays in the middle copy, so it turns either way without an end. */
47
+ export declare const wheelCopies: (column: Pick<WheelColumn, "loop">) => 1 | 3;
48
+ /** The row to show an item on: the copy nearest to the row now in the middle, so a move takes the short way round. */
49
+ export declare function wheelRow(column: WheelColumn, index: number, current: number | null): number;
50
+ /** The same item's row in the middle copy, where a looping column settles after a turn. */
51
+ export declare const wheelHome: (column: WheelColumn, row: number) => number;
52
+ /** The item a settled row shows. */
53
+ export declare const wheelItemAt: (column: WheelColumn, row: number) => WheelItem;
54
+ export {};
@@ -1 +1,2 @@
1
1
  export declare function watchTrailingOverflow(element: HTMLElement, onChange: (hidden: boolean) => void): () => void;
2
+ export declare function watchLeadingScroll(element: HTMLElement, onChange: (scrolled: boolean) => void): () => void;
@@ -1 +1,2 @@
1
1
  export declare function watchTrailingOverflow(element: HTMLElement, onChange: (hidden: boolean) => void): () => void;
2
+ export declare function watchLeadingScroll(element: HTMLElement, onChange: (scrolled: boolean) => void): () => void;
@@ -0,0 +1,54 @@
1
+ import { type ColorSwatchInput, type PickerState } from "./color-picker.cjs";
2
+ export interface ColorPickerModelOptions {
3
+ value?: string | null;
4
+ defaultValue?: string | null;
5
+ onValueChange?: (value: string | null) => void;
6
+ onChangeCommit?: (value: string | null) => void;
7
+ swatches?: ColorSwatchInput[];
8
+ custom: boolean;
9
+ alpha: boolean;
10
+ input: boolean;
11
+ clearable: boolean;
12
+ open?: boolean;
13
+ defaultOpen: boolean;
14
+ onOpenChange?: (open: boolean) => void;
15
+ disabled?: boolean;
16
+ readOnly?: boolean;
17
+ recentColors?: ColorSwatchInput[];
18
+ onRecentColorsChange?: (colors: string[]) => void;
19
+ eyeDropper?: boolean;
20
+ /** The panel sits in the page: it never opens, and recent colors move after each finished pick instead of on closing. */
21
+ inline?: boolean;
22
+ }
23
+ export declare function useColorPickerModel(o: ColorPickerModelOptions): {
24
+ value: string | null;
25
+ open: boolean;
26
+ setOpen: (next: boolean) => void;
27
+ state: PickerState;
28
+ swatches: {
29
+ value: string;
30
+ label: string;
31
+ }[];
32
+ recent: {
33
+ value: string;
34
+ label: string;
35
+ }[] | null;
36
+ nothing: boolean;
37
+ showInput: boolean;
38
+ selected: number;
39
+ recentSelected: number;
40
+ pick: (next: string | null) => void;
41
+ pickRecent: (next: string | null) => void;
42
+ moveTo: (next: PickerState) => void;
43
+ pickState: (next: PickerState) => void;
44
+ drag: {
45
+ onStart: () => void;
46
+ onEnd: () => void;
47
+ };
48
+ field: {
49
+ onEdit: (live: string | null) => void;
50
+ onCommit: (next: string | null | "revert") => void;
51
+ };
52
+ canPickScreen: boolean;
53
+ pickFromScreen: () => Promise<void>;
54
+ };
@@ -0,0 +1,54 @@
1
+ import { type ColorSwatchInput, type PickerState } from "./color-picker.js";
2
+ export interface ColorPickerModelOptions {
3
+ value?: string | null;
4
+ defaultValue?: string | null;
5
+ onValueChange?: (value: string | null) => void;
6
+ onChangeCommit?: (value: string | null) => void;
7
+ swatches?: ColorSwatchInput[];
8
+ custom: boolean;
9
+ alpha: boolean;
10
+ input: boolean;
11
+ clearable: boolean;
12
+ open?: boolean;
13
+ defaultOpen: boolean;
14
+ onOpenChange?: (open: boolean) => void;
15
+ disabled?: boolean;
16
+ readOnly?: boolean;
17
+ recentColors?: ColorSwatchInput[];
18
+ onRecentColorsChange?: (colors: string[]) => void;
19
+ eyeDropper?: boolean;
20
+ /** The panel sits in the page: it never opens, and recent colors move after each finished pick instead of on closing. */
21
+ inline?: boolean;
22
+ }
23
+ export declare function useColorPickerModel(o: ColorPickerModelOptions): {
24
+ value: string | null;
25
+ open: boolean;
26
+ setOpen: (next: boolean) => void;
27
+ state: PickerState;
28
+ swatches: {
29
+ value: string;
30
+ label: string;
31
+ }[];
32
+ recent: {
33
+ value: string;
34
+ label: string;
35
+ }[] | null;
36
+ nothing: boolean;
37
+ showInput: boolean;
38
+ selected: number;
39
+ recentSelected: number;
40
+ pick: (next: string | null) => void;
41
+ pickRecent: (next: string | null) => void;
42
+ moveTo: (next: PickerState) => void;
43
+ pickState: (next: PickerState) => void;
44
+ drag: {
45
+ onStart: () => void;
46
+ onEnd: () => void;
47
+ };
48
+ field: {
49
+ onEdit: (live: string | null) => void;
50
+ onCommit: (next: string | null | "revert") => void;
51
+ };
52
+ canPickScreen: boolean;
53
+ pickFromScreen: () => Promise<void>;
54
+ };
@@ -0,0 +1,10 @@
1
+ /** The copy button state machine shared by React and Native (Vue keeps its own form in runtime/copy-feedback.ts).
2
+ * One copy runs at a time; success shows for copyFeedbackDuration; callbacks run only while mounted. */
3
+ export declare function useCopyFeedback(copyText: (value: string) => void | Promise<void>, handlers: {
4
+ onSuccess(value: string): void;
5
+ onError(error: unknown): void;
6
+ }): {
7
+ copied: boolean;
8
+ failed: boolean;
9
+ copy: (value: string) => Promise<void>;
10
+ };
@@ -0,0 +1,10 @@
1
+ /** The copy button state machine shared by React and Native (Vue keeps its own form in runtime/copy-feedback.ts).
2
+ * One copy runs at a time; success shows for copyFeedbackDuration; callbacks run only while mounted. */
3
+ export declare function useCopyFeedback(copyText: (value: string) => void | Promise<void>, handlers: {
4
+ onSuccess(value: string): void;
5
+ onError(error: unknown): void;
6
+ }): {
7
+ copied: boolean;
8
+ failed: boolean;
9
+ copy: (value: string) => Promise<void>;
10
+ };