@kjun-ui/react 0.20.0 → 0.22.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (327) hide show
  1. package/README.md +19 -5
  2. package/dist/index.cjs +11354 -4458
  3. package/dist/index.js +10951 -4033
  4. package/dist/styles.css +3948 -738
  5. package/dist/types/packages/react/src/actions.d.cts +21 -16
  6. package/dist/types/packages/react/src/actions.d.ts +21 -16
  7. package/dist/types/packages/react/src/app-navigation.d.cts +14 -5
  8. package/dist/types/packages/react/src/app-navigation.d.ts +14 -5
  9. package/dist/types/packages/react/src/avatar-group.d.cts +36 -0
  10. package/dist/types/packages/react/src/avatar-group.d.ts +36 -0
  11. package/dist/types/packages/react/src/button.d.cts +14 -6
  12. package/dist/types/packages/react/src/button.d.ts +14 -6
  13. package/dist/types/packages/react/src/calendar.d.cts +6 -2
  14. package/dist/types/packages/react/src/calendar.d.ts +6 -2
  15. package/dist/types/packages/react/src/card-actions-context.d.cts +2 -0
  16. package/dist/types/packages/react/src/card-actions-context.d.ts +2 -0
  17. package/dist/types/packages/react/src/card.d.cts +23 -6
  18. package/dist/types/packages/react/src/card.d.ts +23 -6
  19. package/dist/types/packages/react/src/carousel.d.cts +8 -1
  20. package/dist/types/packages/react/src/carousel.d.ts +8 -1
  21. package/dist/types/packages/react/src/chip.d.cts +4 -2
  22. package/dist/types/packages/react/src/chip.d.ts +4 -2
  23. package/dist/types/packages/react/src/choice-controls.d.cts +99 -0
  24. package/dist/types/packages/react/src/choice-controls.d.ts +99 -0
  25. package/dist/types/packages/react/src/collapse.d.cts +4 -1
  26. package/dist/types/packages/react/src/collapse.d.ts +4 -1
  27. package/dist/types/packages/react/src/color-picker-parts.d.cts +58 -0
  28. package/dist/types/packages/react/src/color-picker-parts.d.ts +58 -0
  29. package/dist/types/packages/react/src/color-picker.d.cts +58 -0
  30. package/dist/types/packages/react/src/color-picker.d.ts +58 -0
  31. package/dist/types/packages/react/src/combobox.d.cts +18 -5
  32. package/dist/types/packages/react/src/combobox.d.ts +18 -5
  33. package/dist/types/packages/react/src/controls.d.cts +7 -74
  34. package/dist/types/packages/react/src/controls.d.ts +7 -74
  35. package/dist/types/packages/react/src/data-state.d.cts +22 -9
  36. package/dist/types/packages/react/src/data-state.d.ts +22 -9
  37. package/dist/types/packages/react/src/date-picker.d.cts +8 -2
  38. package/dist/types/packages/react/src/date-picker.d.ts +8 -2
  39. package/dist/types/packages/react/src/display.d.cts +40 -11
  40. package/dist/types/packages/react/src/display.d.ts +40 -11
  41. package/dist/types/packages/react/src/drawer.d.cts +11 -2
  42. package/dist/types/packages/react/src/drawer.d.ts +11 -2
  43. package/dist/types/packages/react/src/dropdown.d.cts +19 -5
  44. package/dist/types/packages/react/src/dropdown.d.ts +19 -5
  45. package/dist/types/packages/react/src/event-calendar.d.cts +47 -0
  46. package/dist/types/packages/react/src/event-calendar.d.ts +47 -0
  47. package/dist/types/packages/react/src/fab.d.cts +18 -7
  48. package/dist/types/packages/react/src/fab.d.ts +18 -7
  49. package/dist/types/packages/react/src/file-upload-row.d.cts +23 -0
  50. package/dist/types/packages/react/src/file-upload-row.d.ts +23 -0
  51. package/dist/types/packages/react/src/file-upload.d.cts +38 -0
  52. package/dist/types/packages/react/src/file-upload.d.ts +38 -0
  53. package/dist/types/packages/react/src/financial-display.d.cts +32 -11
  54. package/dist/types/packages/react/src/financial-display.d.ts +32 -11
  55. package/dist/types/packages/react/src/floating-panel.d.cts +6 -2
  56. package/dist/types/packages/react/src/floating-panel.d.ts +6 -2
  57. package/dist/types/packages/react/src/index.d.cts +16 -1
  58. package/dist/types/packages/react/src/index.d.ts +16 -1
  59. package/dist/types/packages/react/src/input.d.cts +14 -1
  60. package/dist/types/packages/react/src/input.d.ts +14 -1
  61. package/dist/types/packages/react/src/kpi-hero.d.cts +55 -0
  62. package/dist/types/packages/react/src/kpi-hero.d.ts +55 -0
  63. package/dist/types/packages/react/src/kpi-row.d.cts +46 -0
  64. package/dist/types/packages/react/src/kpi-row.d.ts +46 -0
  65. package/dist/types/packages/react/src/kpi.d.cts +2 -72
  66. package/dist/types/packages/react/src/kpi.d.ts +2 -72
  67. package/dist/types/packages/react/src/layout-primitives.d.cts +71 -139
  68. package/dist/types/packages/react/src/layout-primitives.d.ts +71 -139
  69. package/dist/types/packages/react/src/list-context.d.cts +9 -0
  70. package/dist/types/packages/react/src/list-context.d.ts +9 -0
  71. package/dist/types/packages/react/src/list.d.cts +84 -11
  72. package/dist/types/packages/react/src/list.d.ts +84 -11
  73. package/dist/types/packages/react/src/market-model.d.cts +13 -1
  74. package/dist/types/packages/react/src/market-model.d.ts +13 -1
  75. package/dist/types/packages/react/src/market-parts.d.cts +9 -0
  76. package/dist/types/packages/react/src/market-parts.d.ts +9 -0
  77. package/dist/types/packages/react/src/market-skeleton.d.cts +7 -1
  78. package/dist/types/packages/react/src/market-skeleton.d.ts +7 -1
  79. package/dist/types/packages/react/src/media.d.cts +6 -2
  80. package/dist/types/packages/react/src/media.d.ts +6 -2
  81. package/dist/types/packages/react/src/modal.d.cts +14 -2
  82. package/dist/types/packages/react/src/modal.d.ts +14 -2
  83. package/dist/types/packages/react/src/navigation.d.cts +36 -6
  84. package/dist/types/packages/react/src/navigation.d.ts +36 -6
  85. package/dist/types/packages/react/src/number-display.d.cts +10 -5
  86. package/dist/types/packages/react/src/number-display.d.ts +10 -5
  87. package/dist/types/packages/react/src/number-input.d.cts +28 -0
  88. package/dist/types/packages/react/src/number-input.d.ts +28 -0
  89. package/dist/types/packages/react/src/popover.d.cts +5 -2
  90. package/dist/types/packages/react/src/popover.d.ts +5 -2
  91. package/dist/types/packages/react/src/pressable.d.cts +17 -0
  92. package/dist/types/packages/react/src/pressable.d.ts +17 -0
  93. package/dist/types/packages/react/src/quantity-stepper.d.cts +3 -1
  94. package/dist/types/packages/react/src/quantity-stepper.d.ts +3 -1
  95. package/dist/types/packages/react/src/range-input.d.cts +15 -3
  96. package/dist/types/packages/react/src/range-input.d.ts +15 -3
  97. package/dist/types/packages/react/src/reorder-controls.d.cts +43 -0
  98. package/dist/types/packages/react/src/reorder-controls.d.ts +43 -0
  99. package/dist/types/packages/react/src/search-input.d.cts +6 -3
  100. package/dist/types/packages/react/src/search-input.d.ts +6 -3
  101. package/dist/types/packages/react/src/select-control.d.cts +7 -2
  102. package/dist/types/packages/react/src/select-control.d.ts +7 -2
  103. package/dist/types/packages/react/src/side-navigation-layout.d.cts +47 -0
  104. package/dist/types/packages/react/src/side-navigation-layout.d.ts +47 -0
  105. package/dist/types/packages/react/src/side-navigation.d.cts +74 -0
  106. package/dist/types/packages/react/src/side-navigation.d.ts +74 -0
  107. package/dist/types/packages/react/src/skeletons.d.cts +19 -3
  108. package/dist/types/packages/react/src/skeletons.d.ts +19 -3
  109. package/dist/types/packages/react/src/spinner-glyph.d.cts +8 -0
  110. package/dist/types/packages/react/src/spinner-glyph.d.ts +8 -0
  111. package/dist/types/packages/react/src/split-pane.d.cts +43 -0
  112. package/dist/types/packages/react/src/split-pane.d.ts +43 -0
  113. package/dist/types/packages/react/src/stacked-bar.d.cts +24 -0
  114. package/dist/types/packages/react/src/stacked-bar.d.ts +24 -0
  115. package/dist/types/packages/react/src/steps.d.cts +26 -0
  116. package/dist/types/packages/react/src/steps.d.ts +26 -0
  117. package/dist/types/packages/react/src/table-cards.d.cts +4 -12
  118. package/dist/types/packages/react/src/table-cards.d.ts +4 -12
  119. package/dist/types/packages/react/src/table-grid.d.cts +3 -7
  120. package/dist/types/packages/react/src/table-grid.d.ts +3 -7
  121. package/dist/types/packages/react/src/table-groups.d.cts +5 -0
  122. package/dist/types/packages/react/src/table-groups.d.ts +5 -0
  123. package/dist/types/packages/react/src/table-list.d.cts +2 -9
  124. package/dist/types/packages/react/src/table-list.d.ts +2 -9
  125. package/dist/types/packages/react/src/table-model.d.cts +6 -2
  126. package/dist/types/packages/react/src/table-model.d.ts +6 -2
  127. package/dist/types/packages/react/src/tabs.d.cts +3 -1
  128. package/dist/types/packages/react/src/tabs.d.ts +3 -1
  129. package/dist/types/packages/react/src/textarea.d.cts +6 -3
  130. package/dist/types/packages/react/src/textarea.d.ts +6 -3
  131. package/dist/types/packages/react/src/tiles.d.cts +18 -0
  132. package/dist/types/packages/react/src/tiles.d.ts +18 -0
  133. package/dist/types/packages/react/src/time-picker.d.cts +12 -2
  134. package/dist/types/packages/react/src/time-picker.d.ts +12 -2
  135. package/dist/types/packages/react/src/time-wheel.d.cts +18 -0
  136. package/dist/types/packages/react/src/time-wheel.d.ts +18 -0
  137. package/dist/types/packages/react/src/use-filter-scroll.d.cts +5 -0
  138. package/dist/types/packages/react/src/use-filter-scroll.d.ts +5 -0
  139. package/dist/types/packages/react/src/zone-gauge.d.cts +28 -0
  140. package/dist/types/packages/react/src/zone-gauge.d.ts +28 -0
  141. package/dist/types/shared/package-runtime/accordion-state.d.cts +2 -0
  142. package/dist/types/shared/package-runtime/accordion-state.d.ts +2 -0
  143. package/dist/types/shared/package-runtime/action-size.d.cts +4 -0
  144. package/dist/types/shared/package-runtime/action-size.d.ts +4 -0
  145. package/dist/types/shared/package-runtime/alert-action-size.d.cts +1 -0
  146. package/dist/types/shared/package-runtime/alert-action-size.d.ts +1 -0
  147. package/dist/types/shared/package-runtime/alert-actions.d.cts +7 -0
  148. package/dist/types/shared/package-runtime/alert-actions.d.ts +7 -0
  149. package/dist/types/shared/package-runtime/alert-exit.d.cts +6 -0
  150. package/dist/types/shared/package-runtime/alert-exit.d.ts +6 -0
  151. package/dist/types/shared/package-runtime/alert-live.d.cts +2 -0
  152. package/dist/types/shared/package-runtime/alert-live.d.ts +2 -0
  153. package/dist/types/shared/package-runtime/avatar-group.d.cts +18 -0
  154. package/dist/types/shared/package-runtime/avatar-group.d.ts +18 -0
  155. package/dist/types/shared/package-runtime/badge-tone.d.cts +8 -2
  156. package/dist/types/shared/package-runtime/badge-tone.d.ts +8 -2
  157. package/dist/types/shared/package-runtime/bottom-bar.d.cts +15 -0
  158. package/dist/types/shared/package-runtime/bottom-bar.d.ts +15 -0
  159. package/dist/types/shared/package-runtime/bottom-navigation.d.cts +30 -0
  160. package/dist/types/shared/package-runtime/bottom-navigation.d.ts +30 -0
  161. package/dist/types/shared/package-runtime/calendar.d.cts +21 -7
  162. package/dist/types/shared/package-runtime/calendar.d.ts +21 -7
  163. package/dist/types/shared/package-runtime/card-layout.d.cts +42 -0
  164. package/dist/types/shared/package-runtime/card-layout.d.ts +42 -0
  165. package/dist/types/shared/package-runtime/carousel-scroll.d.cts +2 -0
  166. package/dist/types/shared/package-runtime/carousel-scroll.d.ts +2 -0
  167. package/dist/types/shared/package-runtime/carousel.d.cts +12 -2
  168. package/dist/types/shared/package-runtime/carousel.d.ts +12 -2
  169. package/dist/types/shared/package-runtime/chart-skeleton.d.cts +2 -2
  170. package/dist/types/shared/package-runtime/chart-skeleton.d.ts +2 -2
  171. package/dist/types/shared/package-runtime/chip-size.d.cts +4 -0
  172. package/dist/types/shared/package-runtime/chip-size.d.ts +4 -0
  173. package/dist/types/shared/package-runtime/clipboard.d.cts +6 -0
  174. package/dist/types/shared/package-runtime/clipboard.d.ts +6 -0
  175. package/dist/types/shared/package-runtime/color-picker-model.d.cts +51 -0
  176. package/dist/types/shared/package-runtime/color-picker-model.d.ts +51 -0
  177. package/dist/types/shared/package-runtime/color-picker.d.cts +92 -0
  178. package/dist/types/shared/package-runtime/color-picker.d.ts +92 -0
  179. package/dist/types/shared/package-runtime/color.d.cts +22 -0
  180. package/dist/types/shared/package-runtime/color.d.ts +22 -0
  181. package/dist/types/shared/package-runtime/combobox-options.d.cts +13 -0
  182. package/dist/types/shared/package-runtime/combobox-options.d.ts +13 -0
  183. package/dist/types/shared/package-runtime/combobox.d.cts +3 -1
  184. package/dist/types/shared/package-runtime/combobox.d.ts +3 -1
  185. package/dist/types/shared/package-runtime/copy-button.d.cts +11 -0
  186. package/dist/types/shared/package-runtime/copy-button.d.ts +11 -0
  187. package/dist/types/shared/package-runtime/data-cells.d.cts +36 -0
  188. package/dist/types/shared/package-runtime/data-cells.d.ts +36 -0
  189. package/dist/types/shared/package-runtime/development.d.cts +4 -0
  190. package/dist/types/shared/package-runtime/development.d.ts +4 -0
  191. package/dist/types/shared/package-runtime/distribution.d.cts +168 -0
  192. package/dist/types/shared/package-runtime/distribution.d.ts +168 -0
  193. package/dist/types/shared/package-runtime/drawer-geometry.d.cts +7 -0
  194. package/dist/types/shared/package-runtime/drawer-geometry.d.ts +7 -0
  195. package/dist/types/shared/package-runtime/empty-geometry.d.cts +19 -0
  196. package/dist/types/shared/package-runtime/empty-geometry.d.ts +19 -0
  197. package/dist/types/shared/package-runtime/event-calendar.d.cts +81 -0
  198. package/dist/types/shared/package-runtime/event-calendar.d.ts +81 -0
  199. package/dist/types/shared/package-runtime/external-link.d.cts +4 -0
  200. package/dist/types/shared/package-runtime/external-link.d.ts +4 -0
  201. package/dist/types/shared/package-runtime/file-upload.d.cts +128 -0
  202. package/dist/types/shared/package-runtime/file-upload.d.ts +128 -0
  203. package/dist/types/shared/package-runtime/filter-scroll.d.cts +5 -0
  204. package/dist/types/shared/package-runtime/filter-scroll.d.ts +5 -0
  205. package/dist/types/shared/package-runtime/filter-value.d.cts +2 -0
  206. package/dist/types/shared/package-runtime/filter-value.d.ts +2 -0
  207. package/dist/types/shared/package-runtime/input-field.d.cts +23 -0
  208. package/dist/types/shared/package-runtime/input-field.d.ts +23 -0
  209. package/dist/types/shared/package-runtime/input-variant.d.cts +7 -0
  210. package/dist/types/shared/package-runtime/input-variant.d.ts +7 -0
  211. package/dist/types/shared/package-runtime/kpi.d.cts +102 -0
  212. package/dist/types/shared/package-runtime/kpi.d.ts +102 -0
  213. package/dist/types/shared/package-runtime/layer-state.d.cts +2 -1
  214. package/dist/types/shared/package-runtime/layer-state.d.ts +2 -1
  215. package/dist/types/shared/package-runtime/layout-primitives.d.cts +115 -6
  216. package/dist/types/shared/package-runtime/layout-primitives.d.ts +115 -6
  217. package/dist/types/shared/package-runtime/list-leading.d.cts +38 -0
  218. package/dist/types/shared/package-runtime/list-leading.d.ts +38 -0
  219. package/dist/types/shared/package-runtime/list-row.d.cts +152 -4
  220. package/dist/types/shared/package-runtime/list-row.d.ts +152 -4
  221. package/dist/types/shared/package-runtime/market-layout.d.cts +6 -2
  222. package/dist/types/shared/package-runtime/market-layout.d.ts +6 -2
  223. package/dist/types/shared/package-runtime/market-query.d.cts +21 -0
  224. package/dist/types/shared/package-runtime/market-query.d.ts +21 -0
  225. package/dist/types/shared/package-runtime/market-table.d.cts +32 -0
  226. package/dist/types/shared/package-runtime/market-table.d.ts +32 -0
  227. package/dist/types/shared/package-runtime/menu-button.d.cts +4 -0
  228. package/dist/types/shared/package-runtime/menu-button.d.ts +4 -0
  229. package/dist/types/shared/package-runtime/messages/ko.d.cts +101 -1
  230. package/dist/types/shared/package-runtime/messages/ko.d.ts +101 -1
  231. package/dist/types/shared/package-runtime/messages-context.d.cts +93 -1
  232. package/dist/types/shared/package-runtime/messages-context.d.ts +93 -1
  233. package/dist/types/shared/package-runtime/minimum-loading.d.cts +3 -0
  234. package/dist/types/shared/package-runtime/minimum-loading.d.ts +3 -0
  235. package/dist/types/shared/package-runtime/modal-geometry.d.cts +15 -0
  236. package/dist/types/shared/package-runtime/modal-geometry.d.ts +15 -0
  237. package/dist/types/shared/package-runtime/navigation.d.cts +9 -2
  238. package/dist/types/shared/package-runtime/navigation.d.ts +9 -2
  239. package/dist/types/shared/package-runtime/nested-controls.d.cts +7 -0
  240. package/dist/types/shared/package-runtime/nested-controls.d.ts +7 -0
  241. package/dist/types/shared/package-runtime/number-input.d.cts +63 -0
  242. package/dist/types/shared/package-runtime/number-input.d.ts +63 -0
  243. package/dist/types/shared/package-runtime/number-sign.d.cts +9 -0
  244. package/dist/types/shared/package-runtime/number-sign.d.ts +9 -0
  245. package/dist/types/shared/package-runtime/options.d.cts +25 -5
  246. package/dist/types/shared/package-runtime/options.d.ts +25 -5
  247. package/dist/types/shared/package-runtime/pagination.d.cts +12 -0
  248. package/dist/types/shared/package-runtime/pagination.d.ts +12 -0
  249. package/dist/types/shared/package-runtime/popover-scroll.d.cts +3 -0
  250. package/dist/types/shared/package-runtime/popover-scroll.d.ts +3 -0
  251. package/dist/types/shared/package-runtime/press-repeat.d.cts +13 -0
  252. package/dist/types/shared/package-runtime/press-repeat.d.ts +13 -0
  253. package/dist/types/shared/package-runtime/progress-circle.d.cts +5 -0
  254. package/dist/types/shared/package-runtime/progress-circle.d.ts +5 -0
  255. package/dist/types/shared/package-runtime/progress-marker.d.cts +7 -0
  256. package/dist/types/shared/package-runtime/progress-marker.d.ts +7 -0
  257. package/dist/types/shared/package-runtime/radio-keyboard.d.cts +2 -0
  258. package/dist/types/shared/package-runtime/radio-keyboard.d.ts +2 -0
  259. package/dist/types/shared/package-runtime/reorder-session.d.cts +62 -0
  260. package/dist/types/shared/package-runtime/reorder-session.d.ts +62 -0
  261. package/dist/types/shared/package-runtime/reorder.d.cts +81 -0
  262. package/dist/types/shared/package-runtime/reorder.d.ts +81 -0
  263. package/dist/types/shared/package-runtime/select-trigger.d.cts +23 -0
  264. package/dist/types/shared/package-runtime/select-trigger.d.ts +23 -0
  265. package/dist/types/shared/package-runtime/sheet-drag.d.cts +24 -0
  266. package/dist/types/shared/package-runtime/sheet-drag.d.ts +24 -0
  267. package/dist/types/shared/package-runtime/side-navigation-keys.d.cts +23 -0
  268. package/dist/types/shared/package-runtime/side-navigation-keys.d.ts +23 -0
  269. package/dist/types/shared/package-runtime/side-navigation-scroll.d.cts +7 -0
  270. package/dist/types/shared/package-runtime/side-navigation-scroll.d.ts +7 -0
  271. package/dist/types/shared/package-runtime/side-navigation.d.cts +277 -0
  272. package/dist/types/shared/package-runtime/side-navigation.d.ts +277 -0
  273. package/dist/types/shared/package-runtime/signed-number.d.cts +33 -0
  274. package/dist/types/shared/package-runtime/signed-number.d.ts +33 -0
  275. package/dist/types/shared/package-runtime/skeleton-text.d.cts +18 -0
  276. package/dist/types/shared/package-runtime/skeleton-text.d.ts +18 -0
  277. package/dist/types/shared/package-runtime/slider-view.d.cts +17 -2
  278. package/dist/types/shared/package-runtime/slider-view.d.ts +17 -2
  279. package/dist/types/shared/package-runtime/sparkline.d.cts +8 -4
  280. package/dist/types/shared/package-runtime/sparkline.d.ts +8 -4
  281. package/dist/types/shared/package-runtime/spinner-geometry.d.cts +14 -0
  282. package/dist/types/shared/package-runtime/spinner-geometry.d.ts +14 -0
  283. package/dist/types/shared/package-runtime/split-pane.d.cts +85 -0
  284. package/dist/types/shared/package-runtime/split-pane.d.ts +85 -0
  285. package/dist/types/shared/package-runtime/steps.d.cts +37 -0
  286. package/dist/types/shared/package-runtime/steps.d.ts +37 -0
  287. package/dist/types/shared/package-runtime/tab-keyboard.d.cts +6 -0
  288. package/dist/types/shared/package-runtime/tab-keyboard.d.ts +6 -0
  289. package/dist/types/shared/package-runtime/table-columns.d.cts +36 -0
  290. package/dist/types/shared/package-runtime/table-columns.d.ts +36 -0
  291. package/dist/types/shared/package-runtime/table-model.d.cts +23 -3
  292. package/dist/types/shared/package-runtime/table-model.d.ts +23 -3
  293. package/dist/types/shared/package-runtime/table-presentation.d.cts +33 -4
  294. package/dist/types/shared/package-runtime/table-presentation.d.ts +33 -4
  295. package/dist/types/shared/package-runtime/table.d.cts +44 -2
  296. package/dist/types/shared/package-runtime/table.d.ts +44 -2
  297. package/dist/types/shared/package-runtime/textarea.d.cts +6 -4
  298. package/dist/types/shared/package-runtime/textarea.d.ts +6 -4
  299. package/dist/types/shared/package-runtime/tiles-children.d.cts +7 -0
  300. package/dist/types/shared/package-runtime/tiles-children.d.ts +7 -0
  301. package/dist/types/shared/package-runtime/tiles.d.cts +18 -0
  302. package/dist/types/shared/package-runtime/tiles.d.ts +18 -0
  303. package/dist/types/shared/package-runtime/time-segments.d.cts +24 -0
  304. package/dist/types/shared/package-runtime/time-segments.d.ts +24 -0
  305. package/dist/types/shared/package-runtime/time-wheel.d.cts +54 -0
  306. package/dist/types/shared/package-runtime/time-wheel.d.ts +54 -0
  307. package/dist/types/shared/package-runtime/trailing-overflow.d.cts +1 -0
  308. package/dist/types/shared/package-runtime/trailing-overflow.d.ts +1 -0
  309. package/dist/types/shared/package-runtime/use-color-picker.d.cts +54 -0
  310. package/dist/types/shared/package-runtime/use-color-picker.d.ts +54 -0
  311. package/dist/types/shared/package-runtime/use-copy-feedback.d.cts +10 -0
  312. package/dist/types/shared/package-runtime/use-copy-feedback.d.ts +10 -0
  313. package/dist/types/shared/package-runtime/use-layer.d.cts +4 -2
  314. package/dist/types/shared/package-runtime/use-layer.d.ts +4 -2
  315. package/dist/types/shared/package-runtime/use-open-state.d.cts +5 -0
  316. package/dist/types/shared/package-runtime/use-open-state.d.ts +5 -0
  317. package/dist/types/shared/package-runtime/use-pending-action.d.cts +6 -0
  318. package/dist/types/shared/package-runtime/use-pending-action.d.ts +6 -0
  319. package/dist/types/shared/package-runtime/use-side-navigation-state.d.cts +25 -0
  320. package/dist/types/shared/package-runtime/use-side-navigation-state.d.ts +25 -0
  321. package/dist/types/shared/package-runtime/use-slide.d.cts +3 -0
  322. package/dist/types/shared/package-runtime/use-slide.d.ts +3 -0
  323. package/package.json +3 -3
  324. package/dist/types/packages/react/src/compound-control.d.cts +0 -1
  325. package/dist/types/packages/react/src/compound-control.d.ts +0 -1
  326. package/dist/types/shared/package-runtime/center-option.d.cts +0 -1
  327. package/dist/types/shared/package-runtime/center-option.d.ts +0 -1
@@ -1,15 +1,124 @@
1
- export type TextVariant = "pageTitle" | "sectionTitle" | "cardTitle" | "body" | "label" | "meta" | "caption" | "numberSm" | "numberMd" | "numberLg" | "displaySm" | "displayMd" | "displayLg";
2
- export type TextTone = "default" | "secondary" | "tertiary" | "disabled" | "brand" | "danger" | "success" | "warning" | "inverse";
1
+ /** "inherit" takes the size, line height and weight of the text around it, for a part of a sentence. */
2
+ export type TextVariant = "pageTitle" | "sectionTitle" | "cardTitle" | "bodyLg" | "body" | "bodyLong" | "label" | "labelStrong" | "meta" | "caption" | "captionStrong" | "numberSm" | "numberMd" | "numberLg" | "displaySm" | "displayMd" | "displayLg" | "inherit";
3
+ /** onBrand·onDanger·onSuccess·onWarning are text on a surface filled with that color; inverse is the older name of onBrand. */
4
+ export type TextTone = "default" | "secondary" | "tertiary" | "disabled" | "brand" | "danger" | "success" | "warning" | "info" | "inverse" | "onBrand" | "onDanger" | "onSuccess" | "onWarning";
3
5
  export type TextAlign = "start" | "center" | "end";
4
- export type TextTag = "h1" | "h2" | "h3" | "h4" | "h5" | "h6" | "p" | "span" | "div";
5
- export type StackGap = "none" | "sm" | "md" | "lg" | "section-sm" | "section-md" | "section-lg";
6
+ export type TextTag = "h1" | "h2" | "h3" | "h4" | "h5" | "h6" | "p" | "span" | "div" | "dt" | "dd" | "li" | "label" | "legend" | "figcaption" | "time" | "strong" | "em";
7
+ export type TextDecoration = "lineThrough";
8
+ /** space.stack (xs 4 · sm 8 · smMd 12 · md 16 · lg 24) and space.section (sectionSm 32 · sectionMd 48 · sectionLg 64). */
9
+ export type StackGap = "none" | "xs" | "sm" | "smMd" | "md" | "lg" | "sectionSm" | "sectionMd" | "sectionLg";
10
+ /** Earlier spellings of the section steps; they still work and warn once in development. */
11
+ export type LegacyStackGap = "section-sm" | "section-md" | "section-lg";
12
+ /** The breakpoints a responsive value can change at: tokens.responsive.stackCompact·stackMedium·stackWide (640·768·1024 wide and up). */
13
+ export type StackBreakpoint = "compact" | "medium" | "wide";
14
+ /** One value, or a value per width: base below compact, then each named breakpoint and wider. */
15
+ export type Responsive<T> = T | ({
16
+ base?: T;
17
+ } & Partial<Record<StackBreakpoint, T>>);
18
+ export type StackGapValue = Responsive<StackGap | LegacyStackGap>;
6
19
  export type StackAlign = "stretch" | "start" | "center" | "end";
20
+ export type StackJustify = "start" | "center" | "end" | "between";
21
+ /** Web only. ul and ol drop the list's bullets and indent; their children should be li. */
22
+ export type StackTag = "div" | "section" | "ul" | "ol" | "nav" | "header" | "footer" | "main" | "article" | "aside" | "form" | "fieldset";
23
+ /** column stacks children, row lines them up; Stack starts as column and Inline as row. */
24
+ export type FlexDirection = "column" | "row";
25
+ export type DirectionValue = Responsive<FlexDirection>;
26
+ /** space.inset: sm 12 · md 16 · lg 24. */
27
+ export type InsetStep = "none" | "sm" | "md" | "lg";
28
+ export type PaddingValue = Responsive<InsetStep>;
29
+ /** true or "full" is a hairline across the stack, "inset" starts it after dividerInset, "strong" is a band for sections. */
30
+ export type StackDivider = boolean | "full" | "inset" | "strong";
31
+ /** viewport follows the screen width (CSS media queries, right on the first paint); container measures the element itself. */
32
+ export type ResponsiveBasis = "viewport" | "container";
7
33
  export type InlineGap = "none" | "xs" | "sm" | "md" | "lg";
34
+ export type InlineGapValue = Responsive<InlineGap>;
8
35
  export type InlineAlign = "start" | "center" | "end" | "baseline" | "stretch";
9
36
  export type InlineJustify = "start" | "center" | "end" | "between";
37
+ /** align and justify also take a value per width, like gap: { base: "stretch", medium: "center" }. */
38
+ export type StackAlignValue = Responsive<StackAlign>;
39
+ export type InlineAlignValue = Responsive<InlineAlign>;
40
+ export type JustifyValue = Responsive<StackJustify>;
41
+ /** The space between the wrapped lines of an Inline: space.stack (xs 4 · sm 8 · smMd 12 · md 16 · lg 24). */
42
+ export type InlineRowGap = "none" | "xs" | "sm" | "smMd" | "md" | "lg";
43
+ export type InlineRowGapValue = Responsive<InlineRowGap>;
10
44
  export declare const titleVariants: readonly TextVariant[];
11
- /** The .kjun-type-* role class (pageTitle → kjun-type-page-title). */
45
+ /** The .kjun-type-* role class (pageTitle → kjun-type-page-title); inherit has its own class and no role. */
12
46
  export declare const textTypeClass: (variant: TextVariant) => string;
13
- /** Document tag when the app gives no `as`: titles are headings, numbers are inline, the rest are paragraphs. */
47
+ /** Document tag when the app gives no `as`: titles are headings, numbers and inherit are inline, the rest are paragraphs. */
14
48
  export declare const defaultTextTag: (variant: TextVariant) => TextTag;
15
49
  export declare const isNumericVariant: (variant: TextVariant) => boolean;
50
+ /** data-tone value (onDanger → on-danger); the default tone sets no attribute. */
51
+ export declare const textToneAttribute: (tone: TextTone) => string | undefined;
52
+ /** Whole line count of 1 or more, or undefined: 0, a fraction below 1, NaN and negatives do not clamp. */
53
+ export declare const clampLines: (maxLines: number | undefined) => number | undefined;
54
+ /** Web: whether a clamped text hides lines (its content is taller than the clamped box). */
55
+ export declare const clampOverflows: (element: {
56
+ scrollHeight: number;
57
+ clientHeight: number;
58
+ }) => boolean;
59
+ export declare const stackBreakpoints: readonly StackBreakpoint[];
60
+ /** A responsive value as its steps: base (the fallback when absent) and any breakpoint the app named. */
61
+ export type Steps<T> = {
62
+ base: T;
63
+ } & Partial<Record<StackBreakpoint, T>>;
64
+ export declare function responsiveSteps<T>(value: Responsive<T> | undefined, fallback: T): Steps<T>;
65
+ /** The step that applies at a width: the widest breakpoint the width reaches wins over base. */
66
+ export declare function stepAt<T>(steps: Steps<T>, width: number, breakpoints: Record<StackBreakpoint, number>): T;
67
+ /** sectionSm for the earlier section-sm spelling, with one development warning. */
68
+ export declare function stackGapName(step: StackGap | LegacyStackGap): StackGap;
69
+ /** A gap as its steps: base (md when absent) and any breakpoint the app named, in the current spelling. */
70
+ export declare function stackGapSteps(gap: StackGapValue | undefined): Steps<StackGap>;
71
+ /** The step that applies at a width, given the breakpoint widths (Native reads the window; Web uses media queries). */
72
+ export declare function stackGapAt(gap: StackGapValue | undefined, width: number, breakpoints: Record<StackBreakpoint, number>): StackGap;
73
+ /** Whether a stack's tag is a list, so its divider is an li too. */
74
+ export declare const isStackList: (tag: StackTag | undefined) => tag is "ol" | "ul";
75
+ /** "full" for true, the variant for a string, undefined when off. */
76
+ export declare const dividerVariant: (divider: StackDivider | undefined) => "full" | "inset" | "strong" | undefined;
77
+ /** Puts a separator between neighbouring children; none next to a spacer, which already parts them. */
78
+ export declare function interleave<T>(items: readonly T[], isSpacer: (item: T) => boolean, separator: (index: number) => T): T[];
79
+ /** The CSS value of a stack gap step: a space.stack or space.section token variable. */
80
+ export declare const stackGapCss: (step: StackGap) => string;
81
+ export declare const inlineGapCss: (step: InlineGap) => string;
82
+ export declare const insetCss: (step: InsetStep) => string;
83
+ /** CSS values of the alignment names; the same names map to flex values on Native. */
84
+ export declare const crossAxisCss: {
85
+ readonly stretch: "stretch";
86
+ readonly start: "flex-start";
87
+ readonly center: "center";
88
+ readonly end: "flex-end";
89
+ readonly baseline: "baseline";
90
+ };
91
+ export declare const mainAxisCss: {
92
+ readonly start: "flex-start";
93
+ readonly center: "center";
94
+ readonly end: "flex-end";
95
+ readonly between: "space-between";
96
+ };
97
+ /** How a content-width control (button, badge, chip…) sits under an alignment: its own width under stretch, the parent's alignment otherwise. */
98
+ export declare const intrinsicSelf: (align: StackAlign | InlineAlign) => "auto" | "flex-start";
99
+ export interface FlexLayoutInput {
100
+ kind: "stack" | "inline";
101
+ gap?: StackGapValue | InlineGapValue;
102
+ direction?: DirectionValue;
103
+ padding?: PaddingValue;
104
+ paddingX?: PaddingValue;
105
+ paddingY?: PaddingValue;
106
+ dividerInset?: InsetStep;
107
+ align?: StackAlignValue | InlineAlignValue;
108
+ justify?: JustifyValue;
109
+ /** Inline only: the space between wrapped lines; absent, the lines keep the gap. */
110
+ rowGap?: InlineRowGapValue;
111
+ /** The measured width for responsive="container"; every responsive value then resolves to one step. */
112
+ width?: number;
113
+ breakpoints?: Record<StackBreakpoint, number>;
114
+ }
115
+ type Attrs = Record<string, string | undefined>;
116
+ /** Web attributes and style variables for a Stack or Inline: data-* names the steps (and turns on the breakpoint rules),
117
+ * --_kjun-flex-* holds the token variable of each step. */
118
+ export declare function flexLayout(input: FlexLayoutInput): {
119
+ attrs: Attrs;
120
+ vars: Record<string, string>;
121
+ };
122
+ /** Whether any value changes with the width, so container mode has something to measure. */
123
+ export declare const isResponsive: (...values: unknown[]) => boolean;
124
+ export {};
@@ -1,15 +1,124 @@
1
- export type TextVariant = "pageTitle" | "sectionTitle" | "cardTitle" | "body" | "label" | "meta" | "caption" | "numberSm" | "numberMd" | "numberLg" | "displaySm" | "displayMd" | "displayLg";
2
- export type TextTone = "default" | "secondary" | "tertiary" | "disabled" | "brand" | "danger" | "success" | "warning" | "inverse";
1
+ /** "inherit" takes the size, line height and weight of the text around it, for a part of a sentence. */
2
+ export type TextVariant = "pageTitle" | "sectionTitle" | "cardTitle" | "bodyLg" | "body" | "bodyLong" | "label" | "labelStrong" | "meta" | "caption" | "captionStrong" | "numberSm" | "numberMd" | "numberLg" | "displaySm" | "displayMd" | "displayLg" | "inherit";
3
+ /** onBrand·onDanger·onSuccess·onWarning are text on a surface filled with that color; inverse is the older name of onBrand. */
4
+ export type TextTone = "default" | "secondary" | "tertiary" | "disabled" | "brand" | "danger" | "success" | "warning" | "info" | "inverse" | "onBrand" | "onDanger" | "onSuccess" | "onWarning";
3
5
  export type TextAlign = "start" | "center" | "end";
4
- export type TextTag = "h1" | "h2" | "h3" | "h4" | "h5" | "h6" | "p" | "span" | "div";
5
- export type StackGap = "none" | "sm" | "md" | "lg" | "section-sm" | "section-md" | "section-lg";
6
+ export type TextTag = "h1" | "h2" | "h3" | "h4" | "h5" | "h6" | "p" | "span" | "div" | "dt" | "dd" | "li" | "label" | "legend" | "figcaption" | "time" | "strong" | "em";
7
+ export type TextDecoration = "lineThrough";
8
+ /** space.stack (xs 4 · sm 8 · smMd 12 · md 16 · lg 24) and space.section (sectionSm 32 · sectionMd 48 · sectionLg 64). */
9
+ export type StackGap = "none" | "xs" | "sm" | "smMd" | "md" | "lg" | "sectionSm" | "sectionMd" | "sectionLg";
10
+ /** Earlier spellings of the section steps; they still work and warn once in development. */
11
+ export type LegacyStackGap = "section-sm" | "section-md" | "section-lg";
12
+ /** The breakpoints a responsive value can change at: tokens.responsive.stackCompact·stackMedium·stackWide (640·768·1024 wide and up). */
13
+ export type StackBreakpoint = "compact" | "medium" | "wide";
14
+ /** One value, or a value per width: base below compact, then each named breakpoint and wider. */
15
+ export type Responsive<T> = T | ({
16
+ base?: T;
17
+ } & Partial<Record<StackBreakpoint, T>>);
18
+ export type StackGapValue = Responsive<StackGap | LegacyStackGap>;
6
19
  export type StackAlign = "stretch" | "start" | "center" | "end";
20
+ export type StackJustify = "start" | "center" | "end" | "between";
21
+ /** Web only. ul and ol drop the list's bullets and indent; their children should be li. */
22
+ export type StackTag = "div" | "section" | "ul" | "ol" | "nav" | "header" | "footer" | "main" | "article" | "aside" | "form" | "fieldset";
23
+ /** column stacks children, row lines them up; Stack starts as column and Inline as row. */
24
+ export type FlexDirection = "column" | "row";
25
+ export type DirectionValue = Responsive<FlexDirection>;
26
+ /** space.inset: sm 12 · md 16 · lg 24. */
27
+ export type InsetStep = "none" | "sm" | "md" | "lg";
28
+ export type PaddingValue = Responsive<InsetStep>;
29
+ /** true or "full" is a hairline across the stack, "inset" starts it after dividerInset, "strong" is a band for sections. */
30
+ export type StackDivider = boolean | "full" | "inset" | "strong";
31
+ /** viewport follows the screen width (CSS media queries, right on the first paint); container measures the element itself. */
32
+ export type ResponsiveBasis = "viewport" | "container";
7
33
  export type InlineGap = "none" | "xs" | "sm" | "md" | "lg";
34
+ export type InlineGapValue = Responsive<InlineGap>;
8
35
  export type InlineAlign = "start" | "center" | "end" | "baseline" | "stretch";
9
36
  export type InlineJustify = "start" | "center" | "end" | "between";
37
+ /** align and justify also take a value per width, like gap: { base: "stretch", medium: "center" }. */
38
+ export type StackAlignValue = Responsive<StackAlign>;
39
+ export type InlineAlignValue = Responsive<InlineAlign>;
40
+ export type JustifyValue = Responsive<StackJustify>;
41
+ /** The space between the wrapped lines of an Inline: space.stack (xs 4 · sm 8 · smMd 12 · md 16 · lg 24). */
42
+ export type InlineRowGap = "none" | "xs" | "sm" | "smMd" | "md" | "lg";
43
+ export type InlineRowGapValue = Responsive<InlineRowGap>;
10
44
  export declare const titleVariants: readonly TextVariant[];
11
- /** The .kjun-type-* role class (pageTitle → kjun-type-page-title). */
45
+ /** The .kjun-type-* role class (pageTitle → kjun-type-page-title); inherit has its own class and no role. */
12
46
  export declare const textTypeClass: (variant: TextVariant) => string;
13
- /** Document tag when the app gives no `as`: titles are headings, numbers are inline, the rest are paragraphs. */
47
+ /** Document tag when the app gives no `as`: titles are headings, numbers and inherit are inline, the rest are paragraphs. */
14
48
  export declare const defaultTextTag: (variant: TextVariant) => TextTag;
15
49
  export declare const isNumericVariant: (variant: TextVariant) => boolean;
50
+ /** data-tone value (onDanger → on-danger); the default tone sets no attribute. */
51
+ export declare const textToneAttribute: (tone: TextTone) => string | undefined;
52
+ /** Whole line count of 1 or more, or undefined: 0, a fraction below 1, NaN and negatives do not clamp. */
53
+ export declare const clampLines: (maxLines: number | undefined) => number | undefined;
54
+ /** Web: whether a clamped text hides lines (its content is taller than the clamped box). */
55
+ export declare const clampOverflows: (element: {
56
+ scrollHeight: number;
57
+ clientHeight: number;
58
+ }) => boolean;
59
+ export declare const stackBreakpoints: readonly StackBreakpoint[];
60
+ /** A responsive value as its steps: base (the fallback when absent) and any breakpoint the app named. */
61
+ export type Steps<T> = {
62
+ base: T;
63
+ } & Partial<Record<StackBreakpoint, T>>;
64
+ export declare function responsiveSteps<T>(value: Responsive<T> | undefined, fallback: T): Steps<T>;
65
+ /** The step that applies at a width: the widest breakpoint the width reaches wins over base. */
66
+ export declare function stepAt<T>(steps: Steps<T>, width: number, breakpoints: Record<StackBreakpoint, number>): T;
67
+ /** sectionSm for the earlier section-sm spelling, with one development warning. */
68
+ export declare function stackGapName(step: StackGap | LegacyStackGap): StackGap;
69
+ /** A gap as its steps: base (md when absent) and any breakpoint the app named, in the current spelling. */
70
+ export declare function stackGapSteps(gap: StackGapValue | undefined): Steps<StackGap>;
71
+ /** The step that applies at a width, given the breakpoint widths (Native reads the window; Web uses media queries). */
72
+ export declare function stackGapAt(gap: StackGapValue | undefined, width: number, breakpoints: Record<StackBreakpoint, number>): StackGap;
73
+ /** Whether a stack's tag is a list, so its divider is an li too. */
74
+ export declare const isStackList: (tag: StackTag | undefined) => tag is "ol" | "ul";
75
+ /** "full" for true, the variant for a string, undefined when off. */
76
+ export declare const dividerVariant: (divider: StackDivider | undefined) => "full" | "inset" | "strong" | undefined;
77
+ /** Puts a separator between neighbouring children; none next to a spacer, which already parts them. */
78
+ export declare function interleave<T>(items: readonly T[], isSpacer: (item: T) => boolean, separator: (index: number) => T): T[];
79
+ /** The CSS value of a stack gap step: a space.stack or space.section token variable. */
80
+ export declare const stackGapCss: (step: StackGap) => string;
81
+ export declare const inlineGapCss: (step: InlineGap) => string;
82
+ export declare const insetCss: (step: InsetStep) => string;
83
+ /** CSS values of the alignment names; the same names map to flex values on Native. */
84
+ export declare const crossAxisCss: {
85
+ readonly stretch: "stretch";
86
+ readonly start: "flex-start";
87
+ readonly center: "center";
88
+ readonly end: "flex-end";
89
+ readonly baseline: "baseline";
90
+ };
91
+ export declare const mainAxisCss: {
92
+ readonly start: "flex-start";
93
+ readonly center: "center";
94
+ readonly end: "flex-end";
95
+ readonly between: "space-between";
96
+ };
97
+ /** How a content-width control (button, badge, chip…) sits under an alignment: its own width under stretch, the parent's alignment otherwise. */
98
+ export declare const intrinsicSelf: (align: StackAlign | InlineAlign) => "auto" | "flex-start";
99
+ export interface FlexLayoutInput {
100
+ kind: "stack" | "inline";
101
+ gap?: StackGapValue | InlineGapValue;
102
+ direction?: DirectionValue;
103
+ padding?: PaddingValue;
104
+ paddingX?: PaddingValue;
105
+ paddingY?: PaddingValue;
106
+ dividerInset?: InsetStep;
107
+ align?: StackAlignValue | InlineAlignValue;
108
+ justify?: JustifyValue;
109
+ /** Inline only: the space between wrapped lines; absent, the lines keep the gap. */
110
+ rowGap?: InlineRowGapValue;
111
+ /** The measured width for responsive="container"; every responsive value then resolves to one step. */
112
+ width?: number;
113
+ breakpoints?: Record<StackBreakpoint, number>;
114
+ }
115
+ type Attrs = Record<string, string | undefined>;
116
+ /** Web attributes and style variables for a Stack or Inline: data-* names the steps (and turns on the breakpoint rules),
117
+ * --_kjun-flex-* holds the token variable of each step. */
118
+ export declare function flexLayout(input: FlexLayoutInput): {
119
+ attrs: Attrs;
120
+ vars: Record<string, string>;
121
+ };
122
+ /** Whether any value changes with the width, so container mode has something to measure. */
123
+ export declare const isResponsive: (...values: unknown[]) => boolean;
124
+ export {};
@@ -0,0 +1,38 @@
1
+ export type ListLeadingSize = "xs" | "sm" | "md" | "lg";
2
+ /**
3
+ * Explicit sizes reserve a square. Only a built-in icon background opts into sm automatically; in an open section a
4
+ * built-in icon always sits on a 40px rounded square (its own color, or the secondary role).
5
+ */
6
+ export declare function listLeadingGeometry({ size, custom, background, open }: {
7
+ size?: ListLeadingSize;
8
+ custom: boolean;
9
+ background: boolean;
10
+ open?: boolean;
11
+ }): {
12
+ size: ListLeadingSize | undefined;
13
+ /** The leading box itself (avatar or icon square). */
14
+ width: 40 | 24 | 32 | 56;
15
+ /** The column it sits in: a sized box smaller than the 40px leading column keeps that column (centered), so
16
+ * titles start on one line whether the row leads with an app avatar or a 32px icon square. */
17
+ column: number;
18
+ iconSize: 20 | 16 | 24 | 28;
19
+ tile: boolean;
20
+ };
21
+ /**
22
+ * The leading column a section's rows share (Web's --_kjun-list-shared-column): beside an avatar or a sized square, a
23
+ * plain icon centers in the 40px column (56px beside an lg box), so every title and divider starts on one line. A list
24
+ * of plain icons keeps their 24px column, and rows without leading content are not counted.
25
+ */
26
+ export declare function listSharedColumn(rows: {
27
+ leading: boolean;
28
+ custom: boolean;
29
+ size?: ListLeadingSize;
30
+ background: boolean;
31
+ }[], open?: boolean): number;
32
+ /**
33
+ * How far a leading box, switch or mark may reach into a one-line row's vertical padding (a negative margin, the same
34
+ * on every platform; Web's --_kjun-list-bleed-limit). Anything up to the title line plus twice this fits without
35
+ * growing the row past its minimum height, and taller content still keeps `minimumInset` to the row's edge, whatever
36
+ * its size: an avatar, a leading square or a switch.
37
+ */
38
+ export declare function listRowBleed(paddingY: number): number;
@@ -0,0 +1,38 @@
1
+ export type ListLeadingSize = "xs" | "sm" | "md" | "lg";
2
+ /**
3
+ * Explicit sizes reserve a square. Only a built-in icon background opts into sm automatically; in an open section a
4
+ * built-in icon always sits on a 40px rounded square (its own color, or the secondary role).
5
+ */
6
+ export declare function listLeadingGeometry({ size, custom, background, open }: {
7
+ size?: ListLeadingSize;
8
+ custom: boolean;
9
+ background: boolean;
10
+ open?: boolean;
11
+ }): {
12
+ size: ListLeadingSize | undefined;
13
+ /** The leading box itself (avatar or icon square). */
14
+ width: 40 | 24 | 32 | 56;
15
+ /** The column it sits in: a sized box smaller than the 40px leading column keeps that column (centered), so
16
+ * titles start on one line whether the row leads with an app avatar or a 32px icon square. */
17
+ column: number;
18
+ iconSize: 20 | 16 | 24 | 28;
19
+ tile: boolean;
20
+ };
21
+ /**
22
+ * The leading column a section's rows share (Web's --_kjun-list-shared-column): beside an avatar or a sized square, a
23
+ * plain icon centers in the 40px column (56px beside an lg box), so every title and divider starts on one line. A list
24
+ * of plain icons keeps their 24px column, and rows without leading content are not counted.
25
+ */
26
+ export declare function listSharedColumn(rows: {
27
+ leading: boolean;
28
+ custom: boolean;
29
+ size?: ListLeadingSize;
30
+ background: boolean;
31
+ }[], open?: boolean): number;
32
+ /**
33
+ * How far a leading box, switch or mark may reach into a one-line row's vertical padding (a negative margin, the same
34
+ * on every platform; Web's --_kjun-list-bleed-limit). Anything up to the title line plus twice this fits without
35
+ * growing the row past its minimum height, and taller content still keeps `minimumInset` to the row's edge, whatever
36
+ * its size: an avatar, a leading square or a switch.
37
+ */
38
+ export declare function listRowBleed(paddingY: number): number;
@@ -1,14 +1,162 @@
1
- export type ListRowKind = "switch" | "radio" | "link" | "button" | "static";
2
- export declare function listRowKind({ checked, selected, href, pressable }: {
1
+ export type ListRowKind = "switch" | "radio" | "checkbox" | "link" | "button" | "static";
2
+ export type ListSelectionMode = "none" | "single" | "multiple";
3
+ /** A link row's rel: the app's own, else "noopener noreferrer" for a new tab so the opened page gets neither the opener nor the referrer. */
4
+ export declare const linkRel: (target?: string, rel?: string) => string | undefined;
5
+ export declare function listRowKind({ checked, selected, href, pressable, mode }: {
3
6
  checked?: boolean;
4
7
  selected?: boolean;
5
8
  href?: string;
6
9
  pressable: boolean;
10
+ mode?: ListSelectionMode;
7
11
  }): ListRowKind;
8
- /** One development warning when a row is given props that cannot apply together. */
9
- export declare function warnListRowProps({ checked, selected, href, chevron }: {
12
+ /** A row opens its own content when `expanded` is given and it has no other role (switch, choice or link). */
13
+ export declare const listRowExpandable: ({ expanded, checked, selected, href }: {
14
+ expanded?: boolean;
15
+ checked?: boolean;
16
+ selected?: boolean;
17
+ href?: string;
18
+ }) => boolean;
19
+ /**
20
+ * What a row draws at its end for its choice: a mark (an empty ring or box, filled when chosen) in an open section or a
21
+ * multiple-choice list, so every choice shows it can be picked; otherwise a check on the chosen row only. A busy
22
+ * pressable row (not a switch, whose thumb spins) draws a spinner in place of its mark, check and chevron.
23
+ */
24
+ export declare function listRowEnd({ kind, selected, mode, open, busy }: {
25
+ kind: ListRowKind;
26
+ selected?: boolean;
27
+ mode: ListSelectionMode;
28
+ open: boolean;
29
+ busy?: boolean;
30
+ }): "mark" | "spinner" | "check" | null;
31
+ /**
32
+ * The aria-current a row's own control takes when it is the item open now (a message open beside its list, the settings
33
+ * page shown): "page" on a link row, "true" on any other row. A switch or choice row has its own state, so it takes none.
34
+ */
35
+ export declare function listRowCurrent(kind: ListRowKind, current?: boolean): "page" | "true" | undefined;
36
+ export type ListTypeRole = "label" | "input" | "caption" | "body";
37
+ /**
38
+ * A row's metrics for its section's variant and density, the numbers Web's row variables hold, for Native rows and
39
+ * row skeletons: vertical and horizontal padding, gap, minimum height, actions padding and the title, description and
40
+ * end value type roles.
41
+ */
42
+ export declare function listRowMetrics({ open, compact, details }: {
43
+ open: boolean;
44
+ compact: boolean;
45
+ details?: boolean;
46
+ }): {
47
+ paddingY: 6;
48
+ paddingX: 16;
49
+ gap: 12;
50
+ minimumHeight: 32;
51
+ actionsPadding: 16;
52
+ title: ListTypeRole;
53
+ description: ListTypeRole;
54
+ trailing: ListTypeRole;
55
+ } | {
56
+ paddingY: 12 | 8;
57
+ paddingX: 12;
58
+ gap: 14;
59
+ minimumHeight: 56 | 64;
60
+ actionsPadding: 12;
61
+ title: ListTypeRole;
62
+ description: ListTypeRole;
63
+ trailing: ListTypeRole;
64
+ } | {
65
+ paddingY: 16 | 12;
66
+ paddingX: 16;
67
+ gap: 12;
68
+ minimumHeight: 56 | 44;
69
+ actionsPadding: 16;
70
+ title: ListTypeRole;
71
+ description: ListTypeRole;
72
+ trailing: ListTypeRole;
73
+ };
74
+ export type ListChoiceValue = string | number;
75
+ /** A section's selection: its mode and, when the section owns the value, that value and its change handler. */
76
+ export interface ListSelection {
77
+ mode: ListSelectionMode;
78
+ value?: ListChoiceValue | null | readonly ListChoiceValue[];
79
+ onValueChange?: (value: never) => void;
80
+ }
81
+ /**
82
+ * A row's choice state. A row with a `value` inside a section that owns its value (value given) reads its selection from
83
+ * the section and changes it when pressed; any other row keeps its own `selected` and press handler.
84
+ */
85
+ export declare function listRowChoice(selection: ListSelection | undefined, rowValue: ListChoiceValue | undefined, selected: boolean | undefined): {
86
+ selected: boolean | undefined;
87
+ owned: boolean;
88
+ press: undefined;
89
+ } | {
90
+ selected: boolean;
91
+ owned: boolean;
92
+ press: () => void | undefined;
93
+ };
94
+ /**
95
+ * Development warnings, once each, for props that cannot apply together. `deviceLink` (Native on a device: an href with
96
+ * no onPress) has nowhere to go, since only the web follows href; `looseChoice` is a choice row outside a section with a
97
+ * selection mode, so it cannot join one radio group.
98
+ */
99
+ export declare function warnListRowProps({ checked, selected, href, chevron, deviceLink, looseChoice, expanded, pressableDetails, current }: {
10
100
  checked?: boolean;
11
101
  selected?: boolean;
12
102
  href?: string;
13
103
  chevron?: boolean;
104
+ deviceLink?: boolean;
105
+ looseChoice?: boolean;
106
+ expanded?: boolean;
107
+ pressableDetails?: boolean;
108
+ current?: boolean;
109
+ }): void;
110
+ /**
111
+ * Development warnings, once each: an open section draws no dividers, so an explicit `divider` does nothing there; a
112
+ * details section keeps its own 32px rows, so `density` does nothing there.
113
+ */
114
+ export declare function warnListSectionProps({ open, divider, details, compact }: {
115
+ open: boolean;
116
+ divider?: boolean;
117
+ details?: boolean;
118
+ compact?: boolean;
119
+ }): void;
120
+ /**
121
+ * Development warnings, once each, for a section selection that would otherwise be ignored without a word: a value
122
+ * with no selection mode, a single value for "multiple" (read as none chosen), a list for "single", and a value with
123
+ * no change handler, whose rows look pressable but never change. Vue always has its update event, so it passes
124
+ * `handled`.
125
+ */
126
+ export declare function warnListSelection({ mode, value, handled }: {
127
+ mode: ListSelectionMode;
128
+ value: unknown;
129
+ handled: boolean;
14
130
  }): void;
131
+ export type ListSectionCorner = "none" | "sm" | "md" | "lg" | "xl";
132
+ export type ListGroupVariant = "inset" | "flush" | "open";
133
+ /** "details": rows that are read, not pressed, such as "Payment method / Visa": 32 tall, no dividers by default, the
134
+ * label in the secondary body type and the value in the text color, given the room the label leaves. */
135
+ export type ListSectionVariant = "default" | "open" | "details";
136
+ /** Where a row's trailing value sits: beside the text, on the title line, or on its own line under the title. */
137
+ export type ListTrailingPosition = "side" | "title" | "below";
138
+ /**
139
+ * How a section draws, the same on every platform: whether it is open (rows on the page with no card or dividers; the
140
+ * section's variant, or the KjunListGroup's) or details (read-only rows; only its own variant), its card corner (the group's when unset; none when open), whether its title
141
+ * is the small label (a title without a description, unless titleVariant says otherwise) and whether its rows form a card
142
+ * with the heading and footer outside it.
143
+ */
144
+ export declare function listSectionShape<R extends ListSectionCorner>({ radius, group, variant, title, description, titleVariant }: {
145
+ radius?: R;
146
+ group?: ListGroupVariant | null;
147
+ variant?: ListSectionVariant;
148
+ title?: string;
149
+ description?: string;
150
+ titleVariant?: "title" | "label";
151
+ }): {
152
+ open: boolean;
153
+ details: boolean;
154
+ corner: "none" | "lg" | R;
155
+ bare: boolean;
156
+ outside: boolean;
157
+ };
158
+ /**
159
+ * Web heading actions: records the tallest action's height on the heading, so any control (not only a KjunButton, which
160
+ * the stylesheet already knows) centers on the title's first line. Returns the cleanup.
161
+ */
162
+ export declare function observeListHeadingActions(actions: HTMLElement): () => void;