@kjun-ui/react 0.21.0 → 0.23.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (297) hide show
  1. package/README.md +19 -5
  2. package/dist/index.cjs +8795 -3753
  3. package/dist/index.js +9349 -4284
  4. package/dist/styles.css +2736 -480
  5. package/dist/types/packages/react/src/actions.d.cts +21 -16
  6. package/dist/types/packages/react/src/actions.d.ts +21 -16
  7. package/dist/types/packages/react/src/app-navigation.d.cts +14 -4
  8. package/dist/types/packages/react/src/app-navigation.d.ts +14 -4
  9. package/dist/types/packages/react/src/avatar-group.d.cts +36 -0
  10. package/dist/types/packages/react/src/avatar-group.d.ts +36 -0
  11. package/dist/types/packages/react/src/button.d.cts +15 -6
  12. package/dist/types/packages/react/src/button.d.ts +15 -6
  13. package/dist/types/packages/react/src/calendar.d.cts +6 -2
  14. package/dist/types/packages/react/src/calendar.d.ts +6 -2
  15. package/dist/types/packages/react/src/card.d.cts +10 -3
  16. package/dist/types/packages/react/src/card.d.ts +10 -3
  17. package/dist/types/packages/react/src/carousel.d.cts +8 -1
  18. package/dist/types/packages/react/src/carousel.d.ts +8 -1
  19. package/dist/types/packages/react/src/choice-controls.d.cts +99 -0
  20. package/dist/types/packages/react/src/choice-controls.d.ts +99 -0
  21. package/dist/types/packages/react/src/collapse.d.cts +4 -1
  22. package/dist/types/packages/react/src/collapse.d.ts +4 -1
  23. package/dist/types/packages/react/src/color-picker.d.cts +8 -1
  24. package/dist/types/packages/react/src/color-picker.d.ts +8 -1
  25. package/dist/types/packages/react/src/combobox.d.cts +18 -5
  26. package/dist/types/packages/react/src/combobox.d.ts +18 -5
  27. package/dist/types/packages/react/src/controls.d.cts +7 -74
  28. package/dist/types/packages/react/src/controls.d.ts +7 -74
  29. package/dist/types/packages/react/src/data-state.d.cts +19 -6
  30. package/dist/types/packages/react/src/data-state.d.ts +19 -6
  31. package/dist/types/packages/react/src/date-picker.d.cts +8 -2
  32. package/dist/types/packages/react/src/date-picker.d.ts +8 -2
  33. package/dist/types/packages/react/src/display.d.cts +33 -8
  34. package/dist/types/packages/react/src/display.d.ts +33 -8
  35. package/dist/types/packages/react/src/drawer.d.cts +11 -2
  36. package/dist/types/packages/react/src/drawer.d.ts +11 -2
  37. package/dist/types/packages/react/src/dropdown.d.cts +21 -6
  38. package/dist/types/packages/react/src/dropdown.d.ts +21 -6
  39. package/dist/types/packages/react/src/event-calendar.d.cts +47 -0
  40. package/dist/types/packages/react/src/event-calendar.d.ts +47 -0
  41. package/dist/types/packages/react/src/fab.d.cts +2 -0
  42. package/dist/types/packages/react/src/fab.d.ts +2 -0
  43. package/dist/types/packages/react/src/file-upload-row.d.cts +23 -0
  44. package/dist/types/packages/react/src/file-upload-row.d.ts +23 -0
  45. package/dist/types/packages/react/src/file-upload.d.cts +38 -0
  46. package/dist/types/packages/react/src/file-upload.d.ts +38 -0
  47. package/dist/types/packages/react/src/financial-display.d.cts +32 -11
  48. package/dist/types/packages/react/src/financial-display.d.ts +32 -11
  49. package/dist/types/packages/react/src/floating-panel.d.cts +6 -2
  50. package/dist/types/packages/react/src/floating-panel.d.ts +6 -2
  51. package/dist/types/packages/react/src/index.d.cts +12 -1
  52. package/dist/types/packages/react/src/index.d.ts +12 -1
  53. package/dist/types/packages/react/src/input.d.cts +27 -1
  54. package/dist/types/packages/react/src/input.d.ts +27 -1
  55. package/dist/types/packages/react/src/kpi-hero.d.cts +2 -0
  56. package/dist/types/packages/react/src/kpi-hero.d.ts +2 -0
  57. package/dist/types/packages/react/src/kpi-row.d.cts +5 -0
  58. package/dist/types/packages/react/src/kpi-row.d.ts +5 -0
  59. package/dist/types/packages/react/src/layout-primitives.d.cts +71 -139
  60. package/dist/types/packages/react/src/layout-primitives.d.ts +71 -139
  61. package/dist/types/packages/react/src/list-context.d.cts +2 -1
  62. package/dist/types/packages/react/src/list-context.d.ts +2 -1
  63. package/dist/types/packages/react/src/list.d.cts +49 -12
  64. package/dist/types/packages/react/src/list.d.ts +49 -12
  65. package/dist/types/packages/react/src/market-model.d.cts +15 -1
  66. package/dist/types/packages/react/src/market-model.d.ts +15 -1
  67. package/dist/types/packages/react/src/market-parts.d.cts +9 -0
  68. package/dist/types/packages/react/src/market-parts.d.ts +9 -0
  69. package/dist/types/packages/react/src/market-skeleton.d.cts +7 -1
  70. package/dist/types/packages/react/src/market-skeleton.d.ts +7 -1
  71. package/dist/types/packages/react/src/media.d.cts +6 -2
  72. package/dist/types/packages/react/src/media.d.ts +6 -2
  73. package/dist/types/packages/react/src/modal.d.cts +11 -2
  74. package/dist/types/packages/react/src/modal.d.ts +11 -2
  75. package/dist/types/packages/react/src/navigation.d.cts +34 -5
  76. package/dist/types/packages/react/src/navigation.d.ts +34 -5
  77. package/dist/types/packages/react/src/number-display.d.cts +8 -5
  78. package/dist/types/packages/react/src/number-display.d.ts +8 -5
  79. package/dist/types/packages/react/src/number-input.d.cts +28 -0
  80. package/dist/types/packages/react/src/number-input.d.ts +28 -0
  81. package/dist/types/packages/react/src/popover.d.cts +5 -2
  82. package/dist/types/packages/react/src/popover.d.ts +5 -2
  83. package/dist/types/packages/react/src/pressable.d.cts +17 -0
  84. package/dist/types/packages/react/src/pressable.d.ts +17 -0
  85. package/dist/types/packages/react/src/quantity-stepper.d.cts +3 -1
  86. package/dist/types/packages/react/src/quantity-stepper.d.ts +3 -1
  87. package/dist/types/packages/react/src/range-input.d.cts +15 -3
  88. package/dist/types/packages/react/src/range-input.d.ts +15 -3
  89. package/dist/types/packages/react/src/search-input.d.cts +6 -3
  90. package/dist/types/packages/react/src/search-input.d.ts +6 -3
  91. package/dist/types/packages/react/src/select-control.d.cts +7 -2
  92. package/dist/types/packages/react/src/select-control.d.ts +7 -2
  93. package/dist/types/packages/react/src/side-navigation-layout-spaces.d.cts +31 -0
  94. package/dist/types/packages/react/src/side-navigation-layout-spaces.d.ts +31 -0
  95. package/dist/types/packages/react/src/side-navigation-layout.d.cts +63 -0
  96. package/dist/types/packages/react/src/side-navigation-layout.d.ts +63 -0
  97. package/dist/types/packages/react/src/side-navigation.d.cts +74 -0
  98. package/dist/types/packages/react/src/side-navigation.d.ts +74 -0
  99. package/dist/types/packages/react/src/skeletons.d.cts +18 -3
  100. package/dist/types/packages/react/src/skeletons.d.ts +18 -3
  101. package/dist/types/packages/react/src/spinner-glyph.d.cts +8 -0
  102. package/dist/types/packages/react/src/spinner-glyph.d.ts +8 -0
  103. package/dist/types/packages/react/src/split-pane.d.cts +20 -5
  104. package/dist/types/packages/react/src/split-pane.d.ts +20 -5
  105. package/dist/types/packages/react/src/stacked-bar.d.cts +3 -1
  106. package/dist/types/packages/react/src/stacked-bar.d.ts +3 -1
  107. package/dist/types/packages/react/src/steps.d.cts +27 -0
  108. package/dist/types/packages/react/src/steps.d.ts +27 -0
  109. package/dist/types/packages/react/src/table-cards.d.cts +4 -12
  110. package/dist/types/packages/react/src/table-cards.d.ts +4 -12
  111. package/dist/types/packages/react/src/table-grid.d.cts +3 -7
  112. package/dist/types/packages/react/src/table-grid.d.ts +3 -7
  113. package/dist/types/packages/react/src/table-groups.d.cts +5 -0
  114. package/dist/types/packages/react/src/table-groups.d.ts +5 -0
  115. package/dist/types/packages/react/src/table-list.d.cts +2 -9
  116. package/dist/types/packages/react/src/table-list.d.ts +2 -9
  117. package/dist/types/packages/react/src/table-model.d.cts +6 -2
  118. package/dist/types/packages/react/src/table-model.d.ts +6 -2
  119. package/dist/types/packages/react/src/tabs.d.cts +3 -1
  120. package/dist/types/packages/react/src/tabs.d.ts +3 -1
  121. package/dist/types/packages/react/src/textarea.d.cts +6 -3
  122. package/dist/types/packages/react/src/textarea.d.ts +6 -3
  123. package/dist/types/packages/react/src/tiles.d.cts +18 -0
  124. package/dist/types/packages/react/src/tiles.d.ts +18 -0
  125. package/dist/types/packages/react/src/time-picker.d.cts +12 -2
  126. package/dist/types/packages/react/src/time-picker.d.ts +12 -2
  127. package/dist/types/packages/react/src/time-wheel.d.cts +18 -0
  128. package/dist/types/packages/react/src/time-wheel.d.ts +18 -0
  129. package/dist/types/packages/react/src/use-filter-scroll.d.cts +5 -0
  130. package/dist/types/packages/react/src/use-filter-scroll.d.ts +5 -0
  131. package/dist/types/shared/package-runtime/accordion-state.d.cts +2 -0
  132. package/dist/types/shared/package-runtime/accordion-state.d.ts +2 -0
  133. package/dist/types/shared/package-runtime/action-size.d.cts +4 -0
  134. package/dist/types/shared/package-runtime/action-size.d.ts +4 -0
  135. package/dist/types/shared/package-runtime/alert-actions.d.cts +7 -0
  136. package/dist/types/shared/package-runtime/alert-actions.d.ts +7 -0
  137. package/dist/types/shared/package-runtime/alert-exit.d.cts +6 -0
  138. package/dist/types/shared/package-runtime/alert-exit.d.ts +6 -0
  139. package/dist/types/shared/package-runtime/alert-live.d.cts +2 -0
  140. package/dist/types/shared/package-runtime/alert-live.d.ts +2 -0
  141. package/dist/types/shared/package-runtime/avatar-group.d.cts +18 -0
  142. package/dist/types/shared/package-runtime/avatar-group.d.ts +18 -0
  143. package/dist/types/shared/package-runtime/badge-tone.d.cts +8 -2
  144. package/dist/types/shared/package-runtime/badge-tone.d.ts +8 -2
  145. package/dist/types/shared/package-runtime/bottom-bar.d.cts +1 -1
  146. package/dist/types/shared/package-runtime/bottom-bar.d.ts +1 -1
  147. package/dist/types/shared/package-runtime/bottom-navigation.d.cts +10 -0
  148. package/dist/types/shared/package-runtime/bottom-navigation.d.ts +10 -0
  149. package/dist/types/shared/package-runtime/calendar.d.cts +21 -7
  150. package/dist/types/shared/package-runtime/calendar.d.ts +21 -7
  151. package/dist/types/shared/package-runtime/card-layout.d.cts +8 -0
  152. package/dist/types/shared/package-runtime/card-layout.d.ts +8 -0
  153. package/dist/types/shared/package-runtime/carousel-scroll.d.cts +2 -0
  154. package/dist/types/shared/package-runtime/carousel-scroll.d.ts +2 -0
  155. package/dist/types/shared/package-runtime/carousel.d.cts +12 -2
  156. package/dist/types/shared/package-runtime/carousel.d.ts +12 -2
  157. package/dist/types/shared/package-runtime/chart-skeleton.d.cts +1 -1
  158. package/dist/types/shared/package-runtime/chart-skeleton.d.ts +1 -1
  159. package/dist/types/shared/package-runtime/clipboard.d.cts +6 -0
  160. package/dist/types/shared/package-runtime/clipboard.d.ts +6 -0
  161. package/dist/types/shared/package-runtime/combobox-options.d.cts +13 -0
  162. package/dist/types/shared/package-runtime/combobox-options.d.ts +13 -0
  163. package/dist/types/shared/package-runtime/combobox.d.cts +3 -1
  164. package/dist/types/shared/package-runtime/combobox.d.ts +3 -1
  165. package/dist/types/shared/package-runtime/copy-button.d.cts +11 -0
  166. package/dist/types/shared/package-runtime/copy-button.d.ts +11 -0
  167. package/dist/types/shared/package-runtime/data-cells.d.cts +36 -0
  168. package/dist/types/shared/package-runtime/data-cells.d.ts +36 -0
  169. package/dist/types/shared/package-runtime/development.d.cts +4 -0
  170. package/dist/types/shared/package-runtime/development.d.ts +4 -0
  171. package/dist/types/shared/package-runtime/distribution.d.cts +36 -1
  172. package/dist/types/shared/package-runtime/distribution.d.ts +36 -1
  173. package/dist/types/shared/package-runtime/drawer-geometry.d.cts +7 -0
  174. package/dist/types/shared/package-runtime/drawer-geometry.d.ts +7 -0
  175. package/dist/types/shared/package-runtime/event-calendar.d.cts +81 -0
  176. package/dist/types/shared/package-runtime/event-calendar.d.ts +81 -0
  177. package/dist/types/shared/package-runtime/external-link.d.cts +4 -0
  178. package/dist/types/shared/package-runtime/external-link.d.ts +4 -0
  179. package/dist/types/shared/package-runtime/field-group.d.cts +17 -0
  180. package/dist/types/shared/package-runtime/field-group.d.ts +17 -0
  181. package/dist/types/shared/package-runtime/file-upload.d.cts +128 -0
  182. package/dist/types/shared/package-runtime/file-upload.d.ts +128 -0
  183. package/dist/types/shared/package-runtime/filter-scroll.d.cts +5 -0
  184. package/dist/types/shared/package-runtime/filter-scroll.d.ts +5 -0
  185. package/dist/types/shared/package-runtime/filter-value.d.cts +2 -0
  186. package/dist/types/shared/package-runtime/filter-value.d.ts +2 -0
  187. package/dist/types/shared/package-runtime/input-field.d.cts +23 -0
  188. package/dist/types/shared/package-runtime/input-field.d.ts +23 -0
  189. package/dist/types/shared/package-runtime/input-variant.d.cts +7 -0
  190. package/dist/types/shared/package-runtime/input-variant.d.ts +7 -0
  191. package/dist/types/shared/package-runtime/kpi.d.cts +13 -0
  192. package/dist/types/shared/package-runtime/kpi.d.ts +13 -0
  193. package/dist/types/shared/package-runtime/layout-primitives.d.cts +115 -6
  194. package/dist/types/shared/package-runtime/layout-primitives.d.ts +115 -6
  195. package/dist/types/shared/package-runtime/list-row.d.cts +71 -8
  196. package/dist/types/shared/package-runtime/list-row.d.ts +71 -8
  197. package/dist/types/shared/package-runtime/market-layout.d.cts +3 -1
  198. package/dist/types/shared/package-runtime/market-layout.d.ts +3 -1
  199. package/dist/types/shared/package-runtime/market-query.d.cts +6 -0
  200. package/dist/types/shared/package-runtime/market-query.d.ts +6 -0
  201. package/dist/types/shared/package-runtime/market-table.d.cts +32 -0
  202. package/dist/types/shared/package-runtime/market-table.d.ts +32 -0
  203. package/dist/types/shared/package-runtime/menu-button.d.cts +4 -0
  204. package/dist/types/shared/package-runtime/menu-button.d.ts +4 -0
  205. package/dist/types/shared/package-runtime/messages/ko.d.cts +77 -1
  206. package/dist/types/shared/package-runtime/messages/ko.d.ts +77 -1
  207. package/dist/types/shared/package-runtime/messages-context.d.cts +69 -1
  208. package/dist/types/shared/package-runtime/messages-context.d.ts +69 -1
  209. package/dist/types/shared/package-runtime/minimum-loading.d.cts +3 -0
  210. package/dist/types/shared/package-runtime/minimum-loading.d.ts +3 -0
  211. package/dist/types/shared/package-runtime/modal-geometry.d.cts +15 -0
  212. package/dist/types/shared/package-runtime/modal-geometry.d.ts +15 -0
  213. package/dist/types/shared/package-runtime/navigation.d.cts +9 -2
  214. package/dist/types/shared/package-runtime/navigation.d.ts +9 -2
  215. package/dist/types/shared/package-runtime/nested-controls.d.cts +7 -0
  216. package/dist/types/shared/package-runtime/nested-controls.d.ts +7 -0
  217. package/dist/types/shared/package-runtime/node-text.d.cts +1 -0
  218. package/dist/types/shared/package-runtime/node-text.d.ts +1 -0
  219. package/dist/types/shared/package-runtime/number-input.d.cts +73 -0
  220. package/dist/types/shared/package-runtime/number-input.d.ts +73 -0
  221. package/dist/types/shared/package-runtime/options.d.cts +25 -5
  222. package/dist/types/shared/package-runtime/options.d.ts +25 -5
  223. package/dist/types/shared/package-runtime/pagination.d.cts +12 -0
  224. package/dist/types/shared/package-runtime/pagination.d.ts +12 -0
  225. package/dist/types/shared/package-runtime/press-repeat.d.cts +13 -0
  226. package/dist/types/shared/package-runtime/press-repeat.d.ts +13 -0
  227. package/dist/types/shared/package-runtime/progress-circle.d.cts +5 -0
  228. package/dist/types/shared/package-runtime/progress-circle.d.ts +5 -0
  229. package/dist/types/shared/package-runtime/progress-marker.d.cts +7 -0
  230. package/dist/types/shared/package-runtime/progress-marker.d.ts +7 -0
  231. package/dist/types/shared/package-runtime/progress-tone.d.cts +6 -0
  232. package/dist/types/shared/package-runtime/progress-tone.d.ts +6 -0
  233. package/dist/types/shared/package-runtime/select-trigger.d.cts +23 -0
  234. package/dist/types/shared/package-runtime/select-trigger.d.ts +23 -0
  235. package/dist/types/shared/package-runtime/sheet-drag.d.cts +24 -0
  236. package/dist/types/shared/package-runtime/sheet-drag.d.ts +24 -0
  237. package/dist/types/shared/package-runtime/side-navigation-keys.d.cts +23 -0
  238. package/dist/types/shared/package-runtime/side-navigation-keys.d.ts +23 -0
  239. package/dist/types/shared/package-runtime/side-navigation-layout.d.cts +24 -0
  240. package/dist/types/shared/package-runtime/side-navigation-layout.d.ts +24 -0
  241. package/dist/types/shared/package-runtime/side-navigation-scroll.d.cts +7 -0
  242. package/dist/types/shared/package-runtime/side-navigation-scroll.d.ts +7 -0
  243. package/dist/types/shared/package-runtime/side-navigation.d.cts +277 -0
  244. package/dist/types/shared/package-runtime/side-navigation.d.ts +277 -0
  245. package/dist/types/shared/package-runtime/signed-number.d.cts +33 -0
  246. package/dist/types/shared/package-runtime/signed-number.d.ts +33 -0
  247. package/dist/types/shared/package-runtime/skeleton-text.d.cts +4 -0
  248. package/dist/types/shared/package-runtime/skeleton-text.d.ts +4 -0
  249. package/dist/types/shared/package-runtime/slider-view.d.cts +17 -2
  250. package/dist/types/shared/package-runtime/slider-view.d.ts +17 -2
  251. package/dist/types/shared/package-runtime/sparkline.d.cts +8 -4
  252. package/dist/types/shared/package-runtime/sparkline.d.ts +8 -4
  253. package/dist/types/shared/package-runtime/spinner-geometry.d.cts +14 -0
  254. package/dist/types/shared/package-runtime/spinner-geometry.d.ts +14 -0
  255. package/dist/types/shared/package-runtime/split-pane.d.cts +40 -1
  256. package/dist/types/shared/package-runtime/split-pane.d.ts +40 -1
  257. package/dist/types/shared/package-runtime/steps.d.cts +51 -0
  258. package/dist/types/shared/package-runtime/steps.d.ts +51 -0
  259. package/dist/types/shared/package-runtime/tab-keyboard.d.cts +6 -0
  260. package/dist/types/shared/package-runtime/tab-keyboard.d.ts +6 -0
  261. package/dist/types/shared/package-runtime/table-columns.d.cts +8 -0
  262. package/dist/types/shared/package-runtime/table-columns.d.ts +8 -0
  263. package/dist/types/shared/package-runtime/table-model.d.cts +23 -3
  264. package/dist/types/shared/package-runtime/table-model.d.ts +23 -3
  265. package/dist/types/shared/package-runtime/table-presentation.d.cts +12 -2
  266. package/dist/types/shared/package-runtime/table-presentation.d.ts +12 -2
  267. package/dist/types/shared/package-runtime/table.d.cts +17 -2
  268. package/dist/types/shared/package-runtime/table.d.ts +17 -2
  269. package/dist/types/shared/package-runtime/textarea.d.cts +6 -4
  270. package/dist/types/shared/package-runtime/textarea.d.ts +6 -4
  271. package/dist/types/shared/package-runtime/tiles-children.d.cts +7 -0
  272. package/dist/types/shared/package-runtime/tiles-children.d.ts +7 -0
  273. package/dist/types/shared/package-runtime/tiles.d.cts +18 -0
  274. package/dist/types/shared/package-runtime/tiles.d.ts +18 -0
  275. package/dist/types/shared/package-runtime/time-segments.d.cts +24 -0
  276. package/dist/types/shared/package-runtime/time-segments.d.ts +24 -0
  277. package/dist/types/shared/package-runtime/time-wheel.d.cts +54 -0
  278. package/dist/types/shared/package-runtime/time-wheel.d.ts +54 -0
  279. package/dist/types/shared/package-runtime/trailing-overflow.d.cts +1 -0
  280. package/dist/types/shared/package-runtime/trailing-overflow.d.ts +1 -0
  281. package/dist/types/shared/package-runtime/use-color-picker.d.cts +3 -0
  282. package/dist/types/shared/package-runtime/use-color-picker.d.ts +3 -0
  283. package/dist/types/shared/package-runtime/use-copy-feedback.d.cts +10 -0
  284. package/dist/types/shared/package-runtime/use-copy-feedback.d.ts +10 -0
  285. package/dist/types/shared/package-runtime/use-open-state.d.cts +5 -0
  286. package/dist/types/shared/package-runtime/use-open-state.d.ts +5 -0
  287. package/dist/types/shared/package-runtime/use-pending-action.d.cts +6 -0
  288. package/dist/types/shared/package-runtime/use-pending-action.d.ts +6 -0
  289. package/dist/types/shared/package-runtime/use-side-navigation-state.d.cts +25 -0
  290. package/dist/types/shared/package-runtime/use-side-navigation-state.d.ts +25 -0
  291. package/dist/types/shared/package-runtime/use-slide.d.cts +3 -0
  292. package/dist/types/shared/package-runtime/use-slide.d.ts +3 -0
  293. package/package.json +3 -3
  294. package/dist/types/packages/react/src/compound-control.d.cts +0 -1
  295. package/dist/types/packages/react/src/compound-control.d.ts +0 -1
  296. package/dist/types/shared/package-runtime/center-option.d.cts +0 -1
  297. package/dist/types/shared/package-runtime/center-option.d.ts +0 -1
@@ -7,7 +7,7 @@ export interface BottomBarStore {
7
7
  }
8
8
  export declare function createBottomBarStore(): BottomBarStore;
9
9
  /**
10
- * Web: writes the bar's height as --_kjun-bottom-bar on the outermost KjunProvider scope while the bar is mounted.
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
11
  * A bar the app hides (display: none) measures 0. Returns the cleanup.
12
12
  */
13
13
  export declare function trackBottomBar(element: HTMLElement | null): () => void;
@@ -7,7 +7,7 @@ export interface BottomBarStore {
7
7
  }
8
8
  export declare function createBottomBarStore(): BottomBarStore;
9
9
  /**
10
- * Web: writes the bar's height as --_kjun-bottom-bar on the outermost KjunProvider scope while the bar is mounted.
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
11
  * A bar the app hides (display: none) measures 0. Returns the cleanup.
12
12
  */
13
13
  export declare function trackBottomBar(element: HTMLElement | null): () => void;
@@ -23,3 +23,13 @@ export declare function bottomNavigationLayout(items: readonly {
23
23
  badgeOnIcon: boolean;
24
24
  };
25
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;
31
+ /**
32
+ * Web: how far a floating bar (the capsule, or a floating action bar's content) stands off the screen's bottom edge — its
33
+ * margin in the page flow and, with sticky, its distance from the viewport's bottom while it sticks, so both agree.
34
+ */
35
+ export declare const floatingBarEdge: (offset: number, safeBottom: string) => string;
@@ -23,3 +23,13 @@ export declare function bottomNavigationLayout(items: readonly {
23
23
  badgeOnIcon: boolean;
24
24
  };
25
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;
31
+ /**
32
+ * Web: how far a floating bar (the capsule, or a floating action bar's content) stands off the screen's bottom edge — its
33
+ * margin in the page flow and, with sticky, its distance from the viewport's bottom while it sticks, so both agree.
34
+ */
35
+ export declare const floatingBarEdge: (offset: number, safeBottom: string) => string;
@@ -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. */
@@ -15,6 +15,7 @@ export interface CardParts {
15
15
  /** Layout decisions every platform makes the same way. */
16
16
  export declare function cardLayout(parts: CardParts, options: {
17
17
  pressable: boolean;
18
+ link?: boolean;
18
19
  headingLevel: CardHeadingLevel;
19
20
  surface: CardSurface;
20
21
  padding: CardPadding;
@@ -31,4 +32,11 @@ export declare function cardLayout(parts: CardParts, options: {
31
32
  /** Without a divider the header sits a step closer to the body than to the card edge. */
32
33
  headerGap: 0 | 16 | 12 | 8;
33
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;
34
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;
@@ -15,6 +15,7 @@ export interface CardParts {
15
15
  /** Layout decisions every platform makes the same way. */
16
16
  export declare function cardLayout(parts: CardParts, options: {
17
17
  pressable: boolean;
18
+ link?: boolean;
18
19
  headingLevel: CardHeadingLevel;
19
20
  surface: CardSurface;
20
21
  padding: CardPadding;
@@ -31,4 +32,11 @@ export declare function cardLayout(parts: CardParts, options: {
31
32
  /** Without a divider the header sits a step closer to the body than to the card edge. */
32
33
  headerGap: 0 | 16 | 12 | 8;
33
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;
34
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 }: {
@@ -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;
@@ -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,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>;
@@ -0,0 +1,13 @@
1
+ import { type SelectOption } from "./options.cjs";
2
+ /**
3
+ * Combobox candidates: every option until the user types after opening, then Select's ranked match
4
+ * (label prefix, label contains, searchKeys contains). A caller's filterFn owns matching and keeps the original order.
5
+ */
6
+ export declare function comboboxOptions<T extends SelectOption>({ options, query, typed, labelKey, filterFn, searchKeys }: {
7
+ options: T[];
8
+ query: string;
9
+ typed: boolean;
10
+ labelKey: string;
11
+ filterFn?: (option: T, query: string) => boolean;
12
+ searchKeys?: readonly string[];
13
+ }): T[];
@@ -0,0 +1,13 @@
1
+ import { type SelectOption } from "./options.js";
2
+ /**
3
+ * Combobox candidates: every option until the user types after opening, then Select's ranked match
4
+ * (label prefix, label contains, searchKeys contains). A caller's filterFn owns matching and keeps the original order.
5
+ */
6
+ export declare function comboboxOptions<T extends SelectOption>({ options, query, typed, labelKey, filterFn, searchKeys }: {
7
+ options: T[];
8
+ query: string;
9
+ typed: boolean;
10
+ labelKey: string;
11
+ filterFn?: (option: T, query: string) => boolean;
12
+ searchKeys?: readonly string[];
13
+ }): T[];
@@ -1,11 +1,12 @@
1
1
  import { type OptionValue, type SelectOption } from "./options.cjs";
2
- export declare function useComboboxModel<T extends SelectOption>({ value, options, labelKey, valueKey, disabled, filterFn, onValueChange, onChange, onSearch, onClear, }: {
2
+ export declare function useComboboxModel<T extends SelectOption>({ value, options, labelKey, valueKey, disabled, filterFn, searchKeys, onValueChange, onChange, onSearch, onClear, }: {
3
3
  value: OptionValue | null;
4
4
  options: T[];
5
5
  labelKey: string;
6
6
  valueKey: string;
7
7
  disabled: boolean;
8
8
  filterFn?: (option: T, query: string) => boolean;
9
+ searchKeys?: readonly string[];
9
10
  onValueChange?: (value: OptionValue | null) => void;
10
11
  onChange?: (value: OptionValue | null) => void;
11
12
  onSearch?: (value: string) => void;
@@ -14,6 +15,7 @@ export declare function useComboboxModel<T extends SelectOption>({ value, option
14
15
  open: boolean;
15
16
  displayValue: string;
16
17
  options: T[];
18
+ isSelected: (option: T) => boolean;
17
19
  changeOpen(next: boolean): void;
18
20
  search(next: string, openOnInput: boolean): void;
19
21
  select(option: T): void;
@@ -1,11 +1,12 @@
1
1
  import { type OptionValue, type SelectOption } from "./options.js";
2
- export declare function useComboboxModel<T extends SelectOption>({ value, options, labelKey, valueKey, disabled, filterFn, onValueChange, onChange, onSearch, onClear, }: {
2
+ export declare function useComboboxModel<T extends SelectOption>({ value, options, labelKey, valueKey, disabled, filterFn, searchKeys, onValueChange, onChange, onSearch, onClear, }: {
3
3
  value: OptionValue | null;
4
4
  options: T[];
5
5
  labelKey: string;
6
6
  valueKey: string;
7
7
  disabled: boolean;
8
8
  filterFn?: (option: T, query: string) => boolean;
9
+ searchKeys?: readonly string[];
9
10
  onValueChange?: (value: OptionValue | null) => void;
10
11
  onChange?: (value: OptionValue | null) => void;
11
12
  onSearch?: (value: string) => void;
@@ -14,6 +15,7 @@ export declare function useComboboxModel<T extends SelectOption>({ value, option
14
15
  open: boolean;
15
16
  displayValue: string;
16
17
  options: T[];
18
+ isSelected: (option: T) => boolean;
17
19
  changeOpen(next: boolean): void;
18
20
  search(next: string, openOnInput: boolean): void;
19
21
  select(option: T): void;
@@ -0,0 +1,11 @@
1
+ export type CopyButtonSize = "xs" | "sm" | "md";
2
+ /** CopyButton takes ghost-button geometry for its size: an icon-only control is a square of the button
3
+ * height, a labelled one has the icon-side and label-side insets and the content gap. */
4
+ export declare function copyButtonGeometry(size: CopyButtonSize, labelled: boolean): {
5
+ height: 40 | 24 | 32;
6
+ radius: 10 | 12 | 8;
7
+ gap: 4;
8
+ width: 40 | 24 | 32 | undefined;
9
+ paddingStart: number;
10
+ paddingEnd: number;
11
+ };
@@ -0,0 +1,11 @@
1
+ export type CopyButtonSize = "xs" | "sm" | "md";
2
+ /** CopyButton takes ghost-button geometry for its size: an icon-only control is a square of the button
3
+ * height, a labelled one has the icon-side and label-side insets and the content gap. */
4
+ export declare function copyButtonGeometry(size: CopyButtonSize, labelled: boolean): {
5
+ height: 40 | 24 | 32;
6
+ radius: 10 | 12 | 8;
7
+ gap: 4;
8
+ width: 40 | 24 | 32 | undefined;
9
+ paddingStart: number;
10
+ paddingEnd: number;
11
+ };
@@ -0,0 +1,36 @@
1
+ export type HeatCellMode = "diverging" | "sequential" | "price";
2
+ export type HeatCellColor = "brand" | "success" | "danger" | "warning";
3
+ /**
4
+ * How a heatmap cell is filled. `role` is the web colour role (`--_kjun-color-<role>`); Native maps it.
5
+ * Diverging and price cells measure the distance from `center` (the middle of min..max when left out) on one scale,
6
+ * the longer of the two sides, so the same strength means the same size on either side.
7
+ */
8
+ export declare function heatCell(value: number | null | undefined, min: number, max: number, mode: HeatCellMode, color: HeatCellColor, center?: number | null): {
9
+ missing: true;
10
+ role: null;
11
+ magnitude: number;
12
+ opacity: number;
13
+ } | {
14
+ missing: false;
15
+ role: "price-up" | "price-down" | HeatCellColor;
16
+ magnitude: number;
17
+ opacity: number;
18
+ };
19
+ export type ProgressCellColor = "auto" | "brand" | "success" | "danger" | "warning" | "custom";
20
+ /**
21
+ * The bar's width and fill. `custom` is the app's colour when one applies: customColor with color "custom", or
22
+ * customColor alone (color left on "auto"). color "custom" without a customColor falls back to the auto colour.
23
+ */
24
+ export declare function progressCellState<C>(value: number, max: number, color: ProgressCellColor, customColor?: C | null): {
25
+ percent: number;
26
+ rounded: number;
27
+ role: "brand" | "danger" | "success" | "warning";
28
+ custom: NonNullable<C> | undefined;
29
+ };
30
+ export type PriceFlash = boolean | "text" | "background";
31
+ /** Which way a price moved, for its flash; null when either side is not a finite number or nothing changed. */
32
+ export declare function priceFlashDirection(previous: number | null | undefined, next: number | null | undefined): "up" | "down" | null;
33
+ /** The flash's kind, or null when it is off. true means the text colour. */
34
+ export declare const priceFlashKind: (flash: PriceFlash | undefined) => "text" | "background" | null;
35
+ /** The web keyframe class for a flash (price-motion.css). */
36
+ export declare const priceFlashClass: (kind: "text" | "background", direction: "up" | "down") => string;
@@ -0,0 +1,36 @@
1
+ export type HeatCellMode = "diverging" | "sequential" | "price";
2
+ export type HeatCellColor = "brand" | "success" | "danger" | "warning";
3
+ /**
4
+ * How a heatmap cell is filled. `role` is the web colour role (`--_kjun-color-<role>`); Native maps it.
5
+ * Diverging and price cells measure the distance from `center` (the middle of min..max when left out) on one scale,
6
+ * the longer of the two sides, so the same strength means the same size on either side.
7
+ */
8
+ export declare function heatCell(value: number | null | undefined, min: number, max: number, mode: HeatCellMode, color: HeatCellColor, center?: number | null): {
9
+ missing: true;
10
+ role: null;
11
+ magnitude: number;
12
+ opacity: number;
13
+ } | {
14
+ missing: false;
15
+ role: "price-up" | "price-down" | HeatCellColor;
16
+ magnitude: number;
17
+ opacity: number;
18
+ };
19
+ export type ProgressCellColor = "auto" | "brand" | "success" | "danger" | "warning" | "custom";
20
+ /**
21
+ * The bar's width and fill. `custom` is the app's colour when one applies: customColor with color "custom", or
22
+ * customColor alone (color left on "auto"). color "custom" without a customColor falls back to the auto colour.
23
+ */
24
+ export declare function progressCellState<C>(value: number, max: number, color: ProgressCellColor, customColor?: C | null): {
25
+ percent: number;
26
+ rounded: number;
27
+ role: "brand" | "danger" | "success" | "warning";
28
+ custom: NonNullable<C> | undefined;
29
+ };
30
+ export type PriceFlash = boolean | "text" | "background";
31
+ /** Which way a price moved, for its flash; null when either side is not a finite number or nothing changed. */
32
+ export declare function priceFlashDirection(previous: number | null | undefined, next: number | null | undefined): "up" | "down" | null;
33
+ /** The flash's kind, or null when it is off. true means the text colour. */
34
+ export declare const priceFlashKind: (flash: PriceFlash | undefined) => "text" | "background" | null;
35
+ /** The web keyframe class for a flash (price-motion.css). */
36
+ export declare const priceFlashClass: (kind: "text" | "background", direction: "up" | "down") => string;
@@ -0,0 +1,4 @@
1
+ /** True in a development build, where KJUN warns about misuse; bundlers replace NODE_ENV, and without it this is false. */
2
+ export declare function developmentMode(): boolean;
3
+ /** The warning for a FAB with neither a label nor an accessible name, or "" when it has one. */
4
+ export declare function fabNameWarning(label: unknown, ariaLabel: unknown): "" | "[KJUN] KjunFab needs a label or ariaLabel: an icon alone gives the button no name.";
@@ -0,0 +1,4 @@
1
+ /** True in a development build, where KJUN warns about misuse; bundlers replace NODE_ENV, and without it this is false. */
2
+ export declare function developmentMode(): boolean;
3
+ /** The warning for a FAB with neither a label nor an accessible name, or "" when it has one. */
4
+ export declare function fabNameWarning(label: unknown, ariaLabel: unknown): "" | "[KJUN] KjunFab needs a label or ariaLabel: an icon alone gives the button no name.";
@@ -64,6 +64,37 @@ export declare function gaugeSliver(width: number, position: number, count: numb
64
64
  start: number;
65
65
  size: number;
66
66
  } | null;
67
+ /**
68
+ * The gap the track leaves around the marker, in the axis's own length units: the marker and its ring on each side,
69
+ * widened over a sliver too thin to read. The background shows through it, whatever it is.
70
+ */
71
+ export declare function gaugeHole(width: number, position: number, count: number, near: {
72
+ before?: GaugeBoundary;
73
+ after?: GaugeBoundary;
74
+ }, geometry: GaugeGeometry): {
75
+ start: number;
76
+ end: number;
77
+ };
78
+ export interface GaugePiece {
79
+ start: number;
80
+ size: number;
81
+ first: boolean;
82
+ last: boolean;
83
+ color?: string;
84
+ }
85
+ /**
86
+ * The zones as drawn pieces for a renderer without masks (Native): each zone's span on a measured axis, less the hole
87
+ * around the marker. `first` and `last` mark the axis's own rounded ends.
88
+ */
89
+ export declare function gaugePieces(width: number, segments: readonly GaugeSegment[], gap: number, hole?: {
90
+ start: number;
91
+ end: number;
92
+ }): GaugePiece[];
93
+ /** The CSS variables the web axis reads for its marker and hole: the position, the zone count and the neighbouring boundaries. */
94
+ export declare function gaugeAxisVars(position: number, count: number, near: {
95
+ before?: GaugeBoundary;
96
+ after?: GaugeBoundary;
97
+ }): Record<string, string>;
67
98
  export declare function gaugeSpoken(label: string | undefined, valueText: string, zoneLabel?: string): string;
68
99
  /** missing: nothing to show; empty: real values that add up to nothing; ready: at least one part to draw. */
69
100
  export declare function stackedState(items: readonly StackedItem[] | null | undefined): StackedState;
@@ -101,7 +132,7 @@ export declare function gaugeModel(input: GaugeInput): {
101
132
  position: number;
102
133
  /** The caption's end: the value and the zone it falls in. */
103
134
  caption: string;
104
- /** The zone boundaries beside the marker, for the sliver covers; none without a value. */
135
+ /** The zone boundaries beside the marker, for the hole around it; none without a value. */
105
136
  near: ReturnType<typeof gaugeNeighbours>;
106
137
  /** One image for screen readers: the name, the value and the zone it falls in. */
107
138
  spoken: string;
@@ -110,6 +141,8 @@ export interface StackedInput {
110
141
  items: readonly StackedItem[] | null | undefined;
111
142
  label?: string;
112
143
  ariaLabel?: string;
144
+ /** The app's summary at the end of the caption line (a total, a verdict); read after the name. */
145
+ valueText?: string;
113
146
  formatValue?: (value: number) => string;
114
147
  missingText?: string;
115
148
  noData: string;
@@ -120,6 +153,8 @@ export declare function stackedModel(input: StackedInput): {
120
153
  state: StackedState;
121
154
  missing: boolean;
122
155
  mark: string;
156
+ /** The caption's end: the missing mark, or else the app's summary. */
157
+ caption: string | undefined;
123
158
  /** One per item, in order: its key, its length on the bar (when drawn) and its legend line. */
124
159
  parts: {
125
160
  item: StackedItem;