@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
@@ -3,3 +3,9 @@
3
3
  * instead of jumping; `done` runs once it is gone. Reduced motion (or no Web Animations) finishes at once.
4
4
  */
5
5
  export declare function collapseAlert(el: HTMLElement | null, reduced: boolean, done: () => void): void;
6
+ /**
7
+ * A dismissed Alert takes its focused close button with it: when focus is inside the alert, it moves to the next
8
+ * tabbable element after it, or the one before when the alert was last, so keyboard users keep their place.
9
+ * Call before the alert turns inert.
10
+ */
11
+ export declare function keepFocusPastAlert(el: HTMLElement | null): void;
@@ -1,3 +1,5 @@
1
1
  export type AlertLive = "assertive" | "polite" | "off";
2
2
  /** Alert announcement role: `live` overrides the tone default (danger interrupts, others are polite); off announces nothing. */
3
3
  export declare function alertRole(tone: string, live?: AlertLive): "alert" | "status" | undefined;
4
+ /** Android announces changes only in a live region (the role alone is not enough): alert interrupts, status waits, off sets none. */
5
+ export declare function alertLiveRegion(tone: string, live?: AlertLive): "assertive" | "polite" | undefined;
@@ -1,3 +1,5 @@
1
1
  export type AlertLive = "assertive" | "polite" | "off";
2
2
  /** Alert announcement role: `live` overrides the tone default (danger interrupts, others are polite); off announces nothing. */
3
3
  export declare function alertRole(tone: string, live?: AlertLive): "alert" | "status" | undefined;
4
+ /** Android announces changes only in a live region (the role alone is not enough): alert interrupts, status waits, off sets none. */
5
+ export declare function alertLiveRegion(tone: string, live?: AlertLive): "assertive" | "polite" | undefined;
@@ -0,0 +1,18 @@
1
+ /** The overflow chip stops at this count so its text always fits the circle; the group name keeps the real number. */
2
+ export declare const AVATAR_GROUP_OVERFLOW_CAP = 99;
3
+ export interface AvatarGroupModel {
4
+ visible: number;
5
+ overflow: number;
6
+ overflowText: string;
7
+ totalCount: number;
8
+ }
9
+ /**
10
+ * How many avatars a group draws, how many it folds into "+N", and the headcount it is named by.
11
+ * At xs and sm a three-character "+99" does not fit the circle, so the chip drops the "+" and shows "99".
12
+ */
13
+ export declare function avatarGroupModel({ count, max, total, size }: {
14
+ count: number;
15
+ max?: number;
16
+ total?: number;
17
+ size?: string;
18
+ }): AvatarGroupModel;
@@ -0,0 +1,18 @@
1
+ /** The overflow chip stops at this count so its text always fits the circle; the group name keeps the real number. */
2
+ export declare const AVATAR_GROUP_OVERFLOW_CAP = 99;
3
+ export interface AvatarGroupModel {
4
+ visible: number;
5
+ overflow: number;
6
+ overflowText: string;
7
+ totalCount: number;
8
+ }
9
+ /**
10
+ * How many avatars a group draws, how many it folds into "+N", and the headcount it is named by.
11
+ * At xs and sm a three-character "+99" does not fit the circle, so the chip drops the "+" and shows "99".
12
+ */
13
+ export declare function avatarGroupModel({ count, max, total, size }: {
14
+ count: number;
15
+ max?: number;
16
+ total?: number;
17
+ size?: string;
18
+ }): AvatarGroupModel;
@@ -26,9 +26,9 @@ export declare function badgeGeometry(size: BadgeSize): {
26
26
  readonly x: 12;
27
27
  readonly y: 4;
28
28
  };
29
- radius: 4 | 10 | 8 | 6;
29
+ radius: 4 | 10 | 6 | 8;
30
30
  gap: 4 | 6;
31
- dotSize: 8 | 6;
31
+ dotSize: 6 | 8;
32
32
  type: {
33
33
  fontWeight: 500;
34
34
  fontSizePx: 12;
@@ -55,5 +55,11 @@ export declare function badgeGeometry(size: BadgeSize): {
55
55
  lineHeightPx: 24;
56
56
  letterSpacingEm: 0;
57
57
  };
58
+ count: {
59
+ paddingX: 4 | 6;
60
+ radius: 9999;
61
+ minWidth: number;
62
+ };
63
+ standaloneDotSize: 8;
58
64
  };
59
65
  export {};
@@ -26,9 +26,9 @@ export declare function badgeGeometry(size: BadgeSize): {
26
26
  readonly x: 12;
27
27
  readonly y: 4;
28
28
  };
29
- radius: 4 | 10 | 8 | 6;
29
+ radius: 4 | 10 | 6 | 8;
30
30
  gap: 4 | 6;
31
- dotSize: 8 | 6;
31
+ dotSize: 6 | 8;
32
32
  type: {
33
33
  fontWeight: 500;
34
34
  fontSizePx: 12;
@@ -55,5 +55,11 @@ export declare function badgeGeometry(size: BadgeSize): {
55
55
  lineHeightPx: 24;
56
56
  letterSpacingEm: 0;
57
57
  };
58
+ count: {
59
+ paddingX: 4 | 6;
60
+ radius: 9999;
61
+ minWidth: number;
62
+ };
63
+ standaloneDotSize: 8;
58
64
  };
59
65
  export {};
@@ -0,0 +1,15 @@
1
+ /** Heights by bar; the total is what a floating component must clear. Native keeps one per outermost KjunProvider. */
2
+ export interface BottomBarStore {
3
+ set(key: object, height: number): void;
4
+ remove(key: object): void;
5
+ subscribe(listener: () => void): () => void;
6
+ total(): number;
7
+ }
8
+ export declare function createBottomBarStore(): BottomBarStore;
9
+ /**
10
+ * Web: writes the bar's height (with its bottom margin) as --_kjun-bottom-bar on the outermost KjunProvider scope while the bar is mounted.
11
+ * A bar the app hides (display: none) measures 0. Returns the cleanup.
12
+ */
13
+ export declare function trackBottomBar(element: HTMLElement | null): () => void;
14
+ /** A FAB's extra bottom offset in px; anything that is not a positive number counts as 0. */
15
+ export declare const fabOffset: (offsetBottom: unknown) => number;
@@ -0,0 +1,15 @@
1
+ /** Heights by bar; the total is what a floating component must clear. Native keeps one per outermost KjunProvider. */
2
+ export interface BottomBarStore {
3
+ set(key: object, height: number): void;
4
+ remove(key: object): void;
5
+ subscribe(listener: () => void): () => void;
6
+ total(): number;
7
+ }
8
+ export declare function createBottomBarStore(): BottomBarStore;
9
+ /**
10
+ * Web: writes the bar's height (with its bottom margin) as --_kjun-bottom-bar on the outermost KjunProvider scope while the bar is mounted.
11
+ * A bar the app hides (display: none) measures 0. Returns the cleanup.
12
+ */
13
+ export declare function trackBottomBar(element: HTMLElement | null): () => void;
14
+ /** A FAB's extra bottom offset in px; anything that is not a positive number counts as 0. */
15
+ export declare const fabOffset: (offsetBottom: unknown) => number;
@@ -0,0 +1,30 @@
1
+ /** How a bottom bar draws its icons: "auto" outlines them and fills the selected one; "filled" and "outline" keep one style for all. */
2
+ export type NavigationIconStyle = "auto" | "filled" | "outline";
3
+ /** Whether a destination's icon draws its filled glyph (icons without one fall back to the outline). */
4
+ export declare const navigationIconFilled: (style: NavigationIconStyle, selected: boolean) => boolean;
5
+ /**
6
+ * The bar's layout: `hasIcons` when any destination has an icon, and `iconOnly` when labels are off on such a bar (the
7
+ * lower bar). `parts` tells what one destination draws:
8
+ * - `showLabel`: a destination without an icon always shows its label, so it never disappears from an icon-only bar;
9
+ * - `iconBox`: the icon's box. A labelled bar keeps it empty for a destination without an icon so every label sits on
10
+ * one line; an icon-only bar drops it, leaving that destination's label centered;
11
+ * - `badgeOnIcon`: the badge sits on the icon box's corner, otherwise in the line after the label.
12
+ */
13
+ export declare function bottomNavigationLayout(items: readonly {
14
+ icon?: string;
15
+ }[], showLabels: boolean): {
16
+ hasIcons: boolean;
17
+ iconOnly: boolean;
18
+ parts(item: {
19
+ icon?: string;
20
+ }): {
21
+ showLabel: boolean;
22
+ iconBox: boolean;
23
+ badgeOnIcon: boolean;
24
+ };
25
+ };
26
+ /**
27
+ * How far a scrolling bar moves so one item is in view: 0 when it already is, otherwise the shortest move that brings it
28
+ * in (its start first when it is wider than the view). Positions share one axis; a negative result scrolls back.
29
+ */
30
+ export declare function revealDelta(itemStart: number, itemEnd: number, viewStart: number, viewEnd: number): number;
@@ -0,0 +1,30 @@
1
+ /** How a bottom bar draws its icons: "auto" outlines them and fills the selected one; "filled" and "outline" keep one style for all. */
2
+ export type NavigationIconStyle = "auto" | "filled" | "outline";
3
+ /** Whether a destination's icon draws its filled glyph (icons without one fall back to the outline). */
4
+ export declare const navigationIconFilled: (style: NavigationIconStyle, selected: boolean) => boolean;
5
+ /**
6
+ * The bar's layout: `hasIcons` when any destination has an icon, and `iconOnly` when labels are off on such a bar (the
7
+ * lower bar). `parts` tells what one destination draws:
8
+ * - `showLabel`: a destination without an icon always shows its label, so it never disappears from an icon-only bar;
9
+ * - `iconBox`: the icon's box. A labelled bar keeps it empty for a destination without an icon so every label sits on
10
+ * one line; an icon-only bar drops it, leaving that destination's label centered;
11
+ * - `badgeOnIcon`: the badge sits on the icon box's corner, otherwise in the line after the label.
12
+ */
13
+ export declare function bottomNavigationLayout(items: readonly {
14
+ icon?: string;
15
+ }[], showLabels: boolean): {
16
+ hasIcons: boolean;
17
+ iconOnly: boolean;
18
+ parts(item: {
19
+ icon?: string;
20
+ }): {
21
+ showLabel: boolean;
22
+ iconBox: boolean;
23
+ badgeOnIcon: boolean;
24
+ };
25
+ };
26
+ /**
27
+ * How far a scrolling bar moves so one item is in view: 0 when it already is, otherwise the shortest move that brings it
28
+ * in (its start first when it is wider than the view). Positions share one axis; a negative result scrolls back.
29
+ */
30
+ export declare function revealDelta(itemStart: number, itemEnd: number, viewStart: number, viewEnd: number): number;
@@ -14,12 +14,20 @@ export interface CalendarDay {
14
14
  rangeStart: boolean;
15
15
  rangeEnd: boolean;
16
16
  inRange: boolean;
17
+ /** While a range's end is picked: the day would make the range shorter than minDays or longer than maxDays. */
18
+ limited: boolean;
19
+ }
20
+ /** The length a range may take, counting both ends; either bound may be left out. */
21
+ export interface RangeLimits {
22
+ minDays?: number;
23
+ maxDays?: number;
17
24
  }
18
25
  export declare function parseDate(iso: string | null | undefined): {
19
26
  year: number;
20
27
  month: number;
21
28
  day: number;
22
29
  } | null;
30
+ export declare const weekdayOf: (year: number, month: number, day: number) => number;
23
31
  export declare const toIsoDate: (year: number, month: number, day: number) => string;
24
32
  export declare function todayIso(now?: Date): string;
25
33
  export declare const isBlocked: (iso: string, min?: string, max?: string) => boolean;
@@ -33,8 +41,8 @@ export declare function addDays(iso: string, days: number): string;
33
41
  export declare function addMonths(iso: string, months: number): string;
34
42
  /** The band a range draws: the committed range, or while only the start is picked, the start to the previewed day. */
35
43
  export declare function rangeBand(range: DateRange | undefined, preview?: string): DateRange | null;
36
- /** Whole weeks covering the month from weekStart (Sunday by default), with the neighbouring months' days marked outside. */
37
- export declare function calendarDays(year: number, month: number, { value, range, min, max, today, weekStart, unavailable, preview }: {
44
+ /** Whole weeks covering the month from weekStart (Sunday by default), with the neighbouring months' days marked outside; fixedWeeks always gives six. */
45
+ export declare function calendarDays(year: number, month: number, { value, range, min, max, today, weekStart, unavailable, preview, fixedWeeks, limits }: {
38
46
  value?: string;
39
47
  range?: DateRange;
40
48
  min?: string;
@@ -43,6 +51,8 @@ export declare function calendarDays(year: number, month: number, { value, range
43
51
  weekStart?: WeekStart;
44
52
  unavailable?: DateUnavailable;
45
53
  preview?: string;
54
+ fixedWeeks?: boolean;
55
+ limits?: RangeLimits;
46
56
  }): CalendarDay[];
47
57
  /** Weekday names (given Sunday first) turned to start on weekStart. */
48
58
  export declare const orderWeekdays: <T>(names: readonly T[], weekStart?: WeekStart) => T[];
@@ -54,7 +64,11 @@ export declare function moveDate(iso: string, key: string, shift?: boolean, week
54
64
  * The next range after picking a day: a fresh pick starts a range, the second pick ends it (in either order).
55
65
  * A range may not run across an unavailable day; picking past one starts a new range there.
56
66
  */
57
- export declare function pickRange(range: DateRange, iso: string, unavailable?: DateUnavailable): DateRange;
67
+ export declare function pickRange(range: DateRange, iso: string, unavailable?: DateUnavailable, limits?: RangeLimits): DateRange;
68
+ /** Days a range covers, counting both ends ("09-08" to "09-14" is 7). */
69
+ export declare function rangeDays(a: string, b: string): number;
70
+ /** Whether ending a range that starts on start at iso breaks minDays or maxDays. */
71
+ export declare function outsideLimits(start: string, iso: string, limits?: RangeLimits): boolean;
58
72
  /** A range Apply can commit: both ends, or neither (which clears it). */
59
73
  export declare const canApplyRange: (range: DateRange) => boolean;
60
74
  /** A range from the app put in order and inside the bounds; a malformed one reads as empty. */
@@ -72,14 +86,16 @@ export declare const pickYear: (focus: string, year: number) => string;
72
86
  /** Twelve years around the shown one, aligned to multiples of twelve, for the year view. */
73
87
  export declare const yearGrid: (year: number) => number[];
74
88
  export declare const yearOutside: (year: number, min?: string, max?: string) => boolean;
75
- /** What the footer holds: a clear button when clearing is allowed, then Apply for ranges (unless they commit on the second pick) or Today when today can be picked. */
76
- export declare function calendarFooter({ range, apply, clearable, todayBlocked }: {
89
+ /** What the footer holds: a length note while one applies, else a clear button when clearing is allowed, then Apply for ranges (unless they commit on the second pick) or Today when today can be picked. */
90
+ export declare function calendarFooter({ range, apply, clearable, todayBlocked, note }: {
77
91
  range: boolean;
78
92
  apply?: boolean;
79
93
  clearable: boolean;
80
94
  todayBlocked: boolean;
95
+ note?: boolean;
81
96
  }): {
82
97
  clear: boolean;
98
+ note: boolean;
83
99
  action: "today" | "apply" | null;
84
100
  shown: boolean;
85
101
  };
@@ -92,8 +108,6 @@ export declare function monthNames(year: number, scope?: KjunMessageScope): {
92
108
  title: string;
93
109
  months: string[];
94
110
  };
95
- /** Five years around the shown one for the month view's year chips, kept inside the bounds. */
96
- export declare function yearChoices(year: number, min?: string, max?: string): number[];
97
111
  /** Range field text: the end drops a repeated year ("2026. 09. 08. – 09. 16."). */
98
112
  export declare function formatRange(range: DateRange, format: (iso: string) => string): string;
99
113
  /** The spoken range for the field: both ends' day names. */
@@ -14,12 +14,20 @@ export interface CalendarDay {
14
14
  rangeStart: boolean;
15
15
  rangeEnd: boolean;
16
16
  inRange: boolean;
17
+ /** While a range's end is picked: the day would make the range shorter than minDays or longer than maxDays. */
18
+ limited: boolean;
19
+ }
20
+ /** The length a range may take, counting both ends; either bound may be left out. */
21
+ export interface RangeLimits {
22
+ minDays?: number;
23
+ maxDays?: number;
17
24
  }
18
25
  export declare function parseDate(iso: string | null | undefined): {
19
26
  year: number;
20
27
  month: number;
21
28
  day: number;
22
29
  } | null;
30
+ export declare const weekdayOf: (year: number, month: number, day: number) => number;
23
31
  export declare const toIsoDate: (year: number, month: number, day: number) => string;
24
32
  export declare function todayIso(now?: Date): string;
25
33
  export declare const isBlocked: (iso: string, min?: string, max?: string) => boolean;
@@ -33,8 +41,8 @@ export declare function addDays(iso: string, days: number): string;
33
41
  export declare function addMonths(iso: string, months: number): string;
34
42
  /** The band a range draws: the committed range, or while only the start is picked, the start to the previewed day. */
35
43
  export declare function rangeBand(range: DateRange | undefined, preview?: string): DateRange | null;
36
- /** Whole weeks covering the month from weekStart (Sunday by default), with the neighbouring months' days marked outside. */
37
- export declare function calendarDays(year: number, month: number, { value, range, min, max, today, weekStart, unavailable, preview }: {
44
+ /** Whole weeks covering the month from weekStart (Sunday by default), with the neighbouring months' days marked outside; fixedWeeks always gives six. */
45
+ export declare function calendarDays(year: number, month: number, { value, range, min, max, today, weekStart, unavailable, preview, fixedWeeks, limits }: {
38
46
  value?: string;
39
47
  range?: DateRange;
40
48
  min?: string;
@@ -43,6 +51,8 @@ export declare function calendarDays(year: number, month: number, { value, range
43
51
  weekStart?: WeekStart;
44
52
  unavailable?: DateUnavailable;
45
53
  preview?: string;
54
+ fixedWeeks?: boolean;
55
+ limits?: RangeLimits;
46
56
  }): CalendarDay[];
47
57
  /** Weekday names (given Sunday first) turned to start on weekStart. */
48
58
  export declare const orderWeekdays: <T>(names: readonly T[], weekStart?: WeekStart) => T[];
@@ -54,7 +64,11 @@ export declare function moveDate(iso: string, key: string, shift?: boolean, week
54
64
  * The next range after picking a day: a fresh pick starts a range, the second pick ends it (in either order).
55
65
  * A range may not run across an unavailable day; picking past one starts a new range there.
56
66
  */
57
- export declare function pickRange(range: DateRange, iso: string, unavailable?: DateUnavailable): DateRange;
67
+ export declare function pickRange(range: DateRange, iso: string, unavailable?: DateUnavailable, limits?: RangeLimits): DateRange;
68
+ /** Days a range covers, counting both ends ("09-08" to "09-14" is 7). */
69
+ export declare function rangeDays(a: string, b: string): number;
70
+ /** Whether ending a range that starts on start at iso breaks minDays or maxDays. */
71
+ export declare function outsideLimits(start: string, iso: string, limits?: RangeLimits): boolean;
58
72
  /** A range Apply can commit: both ends, or neither (which clears it). */
59
73
  export declare const canApplyRange: (range: DateRange) => boolean;
60
74
  /** A range from the app put in order and inside the bounds; a malformed one reads as empty. */
@@ -72,14 +86,16 @@ export declare const pickYear: (focus: string, year: number) => string;
72
86
  /** Twelve years around the shown one, aligned to multiples of twelve, for the year view. */
73
87
  export declare const yearGrid: (year: number) => number[];
74
88
  export declare const yearOutside: (year: number, min?: string, max?: string) => boolean;
75
- /** What the footer holds: a clear button when clearing is allowed, then Apply for ranges (unless they commit on the second pick) or Today when today can be picked. */
76
- export declare function calendarFooter({ range, apply, clearable, todayBlocked }: {
89
+ /** What the footer holds: a length note while one applies, else a clear button when clearing is allowed, then Apply for ranges (unless they commit on the second pick) or Today when today can be picked. */
90
+ export declare function calendarFooter({ range, apply, clearable, todayBlocked, note }: {
77
91
  range: boolean;
78
92
  apply?: boolean;
79
93
  clearable: boolean;
80
94
  todayBlocked: boolean;
95
+ note?: boolean;
81
96
  }): {
82
97
  clear: boolean;
98
+ note: boolean;
83
99
  action: "today" | "apply" | null;
84
100
  shown: boolean;
85
101
  };
@@ -92,8 +108,6 @@ export declare function monthNames(year: number, scope?: KjunMessageScope): {
92
108
  title: string;
93
109
  months: string[];
94
110
  };
95
- /** Five years around the shown one for the month view's year chips, kept inside the bounds. */
96
- export declare function yearChoices(year: number, min?: string, max?: string): number[];
97
111
  /** Range field text: the end drops a repeated year ("2026. 09. 08. – 09. 16."). */
98
112
  export declare function formatRange(range: DateRange, format: (iso: string) => string): string;
99
113
  /** The spoken range for the field: both ends' day names. */
@@ -0,0 +1,42 @@
1
+ import { tokens, type CardPadding, type CardSurface } from "@kjun-ui/tokens";
2
+ export type CardHeadingLevel = false | 2 | 3 | 4 | 5 | 6;
3
+ export type CardMediaPosition = "top" | "start";
4
+ export type CardMediaAspect = keyof typeof tokens.card.mediaAspects;
5
+ /** Which parts a card draws; each platform passes its own content checks so React nodes and Vue slots share one rule. */
6
+ export interface CardParts {
7
+ header: boolean;
8
+ title: boolean;
9
+ subtitle: boolean;
10
+ actions: boolean;
11
+ body: boolean;
12
+ footer: boolean;
13
+ media: boolean;
14
+ }
15
+ /** Layout decisions every platform makes the same way. */
16
+ export declare function cardLayout(parts: CardParts, options: {
17
+ pressable: boolean;
18
+ link?: boolean;
19
+ headingLevel: CardHeadingLevel;
20
+ surface: CardSurface;
21
+ padding: CardPadding;
22
+ mediaPosition: CardMediaPosition;
23
+ }): {
24
+ heading: boolean;
25
+ header: boolean;
26
+ /** A title drawn from the title prop (not a custom header) keeps a minimum width beside its actions and aligns them to its first line. */
27
+ titled: boolean;
28
+ /** A pressable card is one button, whose content is not a heading. */
29
+ titleLevel: CardHeadingLevel;
30
+ /** A tinted surface lifts its badges onto the plain surface colour. */
31
+ tinted: boolean;
32
+ /** Without a divider the header sits a step closer to the body than to the card edge. */
33
+ headerGap: 0 | 16 | 12 | 8;
34
+ sideMedia: boolean;
35
+ /** A link card with a title and no header actions ends its header with a chevron, so it reads as one before hover or focus. */
36
+ linkMark: boolean;
37
+ /** Header actions without a title share the body's row (actions at the end) instead of a header row of their own;
38
+ * with media or a footer the card keeps its rows. */
39
+ actionsBeside: boolean;
40
+ };
41
+ /** Development only, once: Native on a device does not follow href, so a link card there needs onPress. */
42
+ export declare function warnCardDeviceLink(deviceLink: boolean): void;
@@ -0,0 +1,42 @@
1
+ import { tokens, type CardPadding, type CardSurface } from "@kjun-ui/tokens";
2
+ export type CardHeadingLevel = false | 2 | 3 | 4 | 5 | 6;
3
+ export type CardMediaPosition = "top" | "start";
4
+ export type CardMediaAspect = keyof typeof tokens.card.mediaAspects;
5
+ /** Which parts a card draws; each platform passes its own content checks so React nodes and Vue slots share one rule. */
6
+ export interface CardParts {
7
+ header: boolean;
8
+ title: boolean;
9
+ subtitle: boolean;
10
+ actions: boolean;
11
+ body: boolean;
12
+ footer: boolean;
13
+ media: boolean;
14
+ }
15
+ /** Layout decisions every platform makes the same way. */
16
+ export declare function cardLayout(parts: CardParts, options: {
17
+ pressable: boolean;
18
+ link?: boolean;
19
+ headingLevel: CardHeadingLevel;
20
+ surface: CardSurface;
21
+ padding: CardPadding;
22
+ mediaPosition: CardMediaPosition;
23
+ }): {
24
+ heading: boolean;
25
+ header: boolean;
26
+ /** A title drawn from the title prop (not a custom header) keeps a minimum width beside its actions and aligns them to its first line. */
27
+ titled: boolean;
28
+ /** A pressable card is one button, whose content is not a heading. */
29
+ titleLevel: CardHeadingLevel;
30
+ /** A tinted surface lifts its badges onto the plain surface colour. */
31
+ tinted: boolean;
32
+ /** Without a divider the header sits a step closer to the body than to the card edge. */
33
+ headerGap: 0 | 16 | 12 | 8;
34
+ sideMedia: boolean;
35
+ /** A link card with a title and no header actions ends its header with a chevron, so it reads as one before hover or focus. */
36
+ linkMark: boolean;
37
+ /** Header actions without a title share the body's row (actions at the end) instead of a header row of their own;
38
+ * with media or a footer the card keeps its rows. */
39
+ actionsBeside: boolean;
40
+ };
41
+ /** Development only, once: Native on a device does not follow href, so a link card there needs onPress. */
42
+ export declare function warnCardDeviceLink(deviceLink: boolean): void;
@@ -9,6 +9,8 @@ export interface CarouselScrollerOptions {
9
9
  current: () => number;
10
10
  mouseDrag: () => boolean;
11
11
  align: () => CarouselSnapAlign;
12
+ /** Each slide at least this wide; as many as fit share the row. undefined leaves widths to slideSize. */
13
+ minSlideWidth: () => number | undefined;
12
14
  }
13
15
  export interface CarouselScroller {
14
16
  scrollTo: (target: number, smooth: boolean) => void;
@@ -9,6 +9,8 @@ export interface CarouselScrollerOptions {
9
9
  current: () => number;
10
10
  mouseDrag: () => boolean;
11
11
  align: () => CarouselSnapAlign;
12
+ /** Each slide at least this wide; as many as fit share the row. undefined leaves widths to slideSize. */
13
+ minSlideWidth: () => number | undefined;
12
14
  }
13
15
  export interface CarouselScroller {
14
16
  scrollTo: (target: number, smooth: boolean) => void;
@@ -23,8 +23,17 @@ export declare function stopDots(stops: readonly number[] | undefined, count: nu
23
23
  target: number;
24
24
  current: boolean;
25
25
  }[];
26
+ /**
27
+ * Where previous or next leads: the first slide of the neighbouring stop, so slides that share the end of a card rail
28
+ * are passed over in one step instead of moving nothing. undefined when there is no stop that way.
29
+ */
30
+ export declare function stepTarget(stops: readonly number[] | undefined, current: number, count: number, direction: "previous" | "next"): number | undefined;
26
31
  /** Where focus goes after a button moves to an end: the scroller for side buttons, which vanish, or the other header button. */
27
- export declare function stepFocus(target: number, count: number, header: boolean): "viewport" | "previous" | "next" | undefined;
32
+ export declare function stepFocus(stops: readonly number[] | undefined, target: number, count: number, header: boolean): "viewport" | "previous" | "next" | undefined;
33
+ /** How many slides fit side by side when each must be at least `min` wide (never fewer than one). */
34
+ export declare function slidesPerView(width: number, min: number, gap: number): number;
35
+ /** The slide width that puts `perView` slides across `width` with `gap` between them. */
36
+ export declare function perViewWidth(width: number, perView: number, gap: number): number;
28
37
  /** Slide starts as scroll positions the scroller can actually reach; starts past the end stop at the end. */
29
38
  export declare function reachableOffsets(offsets: readonly number[], max: number): number[];
30
39
  /** Where a mouse drag lands: wherever the position is nearest, or one slide on once the drag passes a fifth of the view. */
@@ -36,7 +45,8 @@ export declare function dragTarget({ start, nearest, distance, width, count }: {
36
45
  count: number;
37
46
  }): number;
38
47
  export declare function carouselKey(key: string): CarouselMove | undefined;
39
- export declare function carouselTarget(move: CarouselMove, index: number, count: number): number;
48
+ /** Arrow keys step by stop like the buttons; Home and End go to either end. */
49
+ export declare function carouselTarget(move: CarouselMove, index: number, count: number, stops?: readonly number[]): number;
40
50
  export declare function warnUnnamedCarousel(named: boolean): void;
41
51
  /** Development-only hints for setups that leave some people unable to move or name the carousel. */
42
52
  export declare function warnCarouselSetup({ controls, dots, mouseDrag, named }: {
@@ -23,8 +23,17 @@ export declare function stopDots(stops: readonly number[] | undefined, count: nu
23
23
  target: number;
24
24
  current: boolean;
25
25
  }[];
26
+ /**
27
+ * Where previous or next leads: the first slide of the neighbouring stop, so slides that share the end of a card rail
28
+ * are passed over in one step instead of moving nothing. undefined when there is no stop that way.
29
+ */
30
+ export declare function stepTarget(stops: readonly number[] | undefined, current: number, count: number, direction: "previous" | "next"): number | undefined;
26
31
  /** Where focus goes after a button moves to an end: the scroller for side buttons, which vanish, or the other header button. */
27
- export declare function stepFocus(target: number, count: number, header: boolean): "viewport" | "previous" | "next" | undefined;
32
+ export declare function stepFocus(stops: readonly number[] | undefined, target: number, count: number, header: boolean): "viewport" | "previous" | "next" | undefined;
33
+ /** How many slides fit side by side when each must be at least `min` wide (never fewer than one). */
34
+ export declare function slidesPerView(width: number, min: number, gap: number): number;
35
+ /** The slide width that puts `perView` slides across `width` with `gap` between them. */
36
+ export declare function perViewWidth(width: number, perView: number, gap: number): number;
28
37
  /** Slide starts as scroll positions the scroller can actually reach; starts past the end stop at the end. */
29
38
  export declare function reachableOffsets(offsets: readonly number[], max: number): number[];
30
39
  /** Where a mouse drag lands: wherever the position is nearest, or one slide on once the drag passes a fifth of the view. */
@@ -36,7 +45,8 @@ export declare function dragTarget({ start, nearest, distance, width, count }: {
36
45
  count: number;
37
46
  }): number;
38
47
  export declare function carouselKey(key: string): CarouselMove | undefined;
39
- export declare function carouselTarget(move: CarouselMove, index: number, count: number): number;
48
+ /** Arrow keys step by stop like the buttons; Home and End go to either end. */
49
+ export declare function carouselTarget(move: CarouselMove, index: number, count: number, stops?: readonly number[]): number;
40
50
  export declare function warnUnnamedCarousel(named: boolean): void;
41
51
  /** Development-only hints for setups that leave some people unable to move or name the carousel. */
42
52
  export declare function warnCarouselSetup({ controls, dots, mouseDrag, named }: {
@@ -10,7 +10,7 @@ export declare const chartFrameDefaults: {
10
10
  /** Evenly spaced positions from 0 to 1 for at least two marks (grid lines or ticks). */
11
11
  export declare function chartFrameStops(count: number): number[];
12
12
  /** A tick label centres on its tick, except at the ends where it stays inside the plot (percent of its width). */
13
- export declare function chartTickShift(stop: number): 0 | -100 | -50;
13
+ export declare function chartTickShift(stop: number): 0 | -50 | -100;
14
14
  /** Grid lines in a 0 0 100 100 viewBox, drawn with non-scaling strokes over the plot area. */
15
15
  export declare const chartFrameViewBox = "0 0 100 100";
16
16
  export declare function chartFramePath(gridLines: number): string;
@@ -20,7 +20,7 @@ export declare const chartSkeletonMaxCount = 100;
20
20
  export declare function chartSkeletonCount(value: number): number;
21
21
  /** Every third diagonal cell is drawn at the pending opacity so the matrix reads as a heatmap. */
22
22
  export declare function chartMatrixMuted(row: number, column: number): boolean;
23
- /** Donut ring diameter as a share of the skeleton height; data-state.css repeats it as 80% and 80cqh. */
23
+ /** Donut ring diameter as a share of the skeleton height; skeleton.css repeats it as 80% and 80cqh. */
24
24
  export declare const chartDonutRatio = 0.8;
25
25
  /** Inner diameter of the donut ring. */
26
26
  export declare function chartDonutHole(height: number, thickness: number): number;
@@ -10,7 +10,7 @@ export declare const chartFrameDefaults: {
10
10
  /** Evenly spaced positions from 0 to 1 for at least two marks (grid lines or ticks). */
11
11
  export declare function chartFrameStops(count: number): number[];
12
12
  /** A tick label centres on its tick, except at the ends where it stays inside the plot (percent of its width). */
13
- export declare function chartTickShift(stop: number): 0 | -100 | -50;
13
+ export declare function chartTickShift(stop: number): 0 | -50 | -100;
14
14
  /** Grid lines in a 0 0 100 100 viewBox, drawn with non-scaling strokes over the plot area. */
15
15
  export declare const chartFrameViewBox = "0 0 100 100";
16
16
  export declare function chartFramePath(gridLines: number): string;
@@ -20,7 +20,7 @@ export declare const chartSkeletonMaxCount = 100;
20
20
  export declare function chartSkeletonCount(value: number): number;
21
21
  /** Every third diagonal cell is drawn at the pending opacity so the matrix reads as a heatmap. */
22
22
  export declare function chartMatrixMuted(row: number, column: number): boolean;
23
- /** Donut ring diameter as a share of the skeleton height; data-state.css repeats it as 80% and 80cqh. */
23
+ /** Donut ring diameter as a share of the skeleton height; skeleton.css repeats it as 80% and 80cqh. */
24
24
  export declare const chartDonutRatio = 0.8;
25
25
  /** Inner diameter of the donut ring. */
26
26
  export declare function chartDonutHole(height: number, thickness: number): number;
@@ -0,0 +1,4 @@
1
+ import { tokens } from "@kjun-ui/tokens";
2
+ export type ChipSize = keyof typeof tokens.extensions.chip.typography;
3
+ /** Templates and plain JS can pass any string; an unknown size draws as md instead of losing its icon and spacing. */
4
+ export declare function chipSize(size: unknown): ChipSize;
@@ -0,0 +1,4 @@
1
+ import { tokens } from "@kjun-ui/tokens";
2
+ export type ChipSize = keyof typeof tokens.extensions.chip.typography;
3
+ /** Templates and plain JS can pass any string; an unknown size draws as md instead of losing its icon and spacing. */
4
+ export declare function chipSize(size: unknown): ChipSize;
@@ -0,0 +1,6 @@
1
+ /** How long a copy button shows its success state before it can copy again. */
2
+ export declare const copyFeedbackDuration = 1500;
3
+ /** Web copy: the async Clipboard API in secure contexts, else a hidden textarea and execCommand. */
4
+ export declare function browserCopy(value: string): Promise<void>;
5
+ /** True for a handler result that settles later, so a control can stay busy until it does. */
6
+ export declare function isPending(result: unknown): result is PromiseLike<unknown>;
@@ -0,0 +1,6 @@
1
+ /** How long a copy button shows its success state before it can copy again. */
2
+ export declare const copyFeedbackDuration = 1500;
3
+ /** Web copy: the async Clipboard API in secure contexts, else a hidden textarea and execCommand. */
4
+ export declare function browserCopy(value: string): Promise<void>;
5
+ /** True for a handler result that settles later, so a control can stay busy until it does. */
6
+ export declare function isPending(result: unknown): result is PromiseLike<unknown>;