@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
@@ -73,6 +73,19 @@ export declare function kpiSummaryLayout(items: {
73
73
  secondary: boolean[];
74
74
  lastFull: number;
75
75
  };
76
+ /**
77
+ * The phone grid of a KpiRow outside the summary (two columns, or size="sm" wrapping in two): which column each
78
+ * cell takes and whether it starts below the first line. A mobileFull cell takes the whole line, and so does a cell
79
+ * left alone on its line (the last one, or one before a full cell), so no half cell stays empty. Web and Native
80
+ * draw the same dividers from it: a left line on the second column (not for sm), a top line below the first line.
81
+ */
82
+ export declare function kpiGridLayout(items: {
83
+ mobileFull?: boolean;
84
+ }[]): {
85
+ column: number;
86
+ full: boolean;
87
+ top: boolean;
88
+ }[];
76
89
  /** A row badge is KjunBadge's tone: neutral is the secondary badge. */
77
90
  export declare const kpiBadgeVariant: (variant?: KpiBadgeVariant) => BadgeVariant;
78
91
  export declare const kpiBadgeRoles: (variant?: KpiBadgeVariant) => BadgeToneRoles;
@@ -73,6 +73,19 @@ export declare function kpiSummaryLayout(items: {
73
73
  secondary: boolean[];
74
74
  lastFull: number;
75
75
  };
76
+ /**
77
+ * The phone grid of a KpiRow outside the summary (two columns, or size="sm" wrapping in two): which column each
78
+ * cell takes and whether it starts below the first line. A mobileFull cell takes the whole line, and so does a cell
79
+ * left alone on its line (the last one, or one before a full cell), so no half cell stays empty. Web and Native
80
+ * draw the same dividers from it: a left line on the second column (not for sm), a top line below the first line.
81
+ */
82
+ export declare function kpiGridLayout(items: {
83
+ mobileFull?: boolean;
84
+ }[]): {
85
+ column: number;
86
+ full: boolean;
87
+ top: boolean;
88
+ }[];
76
89
  /** A row badge is KjunBadge's tone: neutral is the secondary badge. */
77
90
  export declare const kpiBadgeVariant: (variant?: KpiBadgeVariant) => BadgeVariant;
78
91
  export declare const kpiBadgeRoles: (variant?: KpiBadgeVariant) => BadgeToneRoles;
@@ -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 {};
@@ -1,5 +1,7 @@
1
1
  export type ListRowKind = "switch" | "radio" | "checkbox" | "link" | "button" | "static";
2
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;
3
5
  export declare function listRowKind({ checked, selected, href, pressable, mode }: {
4
6
  checked?: boolean;
5
7
  selected?: boolean;
@@ -7,6 +9,13 @@ export declare function listRowKind({ checked, selected, href, pressable, mode }
7
9
  pressable: boolean;
8
10
  mode?: ListSelectionMode;
9
11
  }): ListRowKind;
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;
10
19
  /**
11
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
12
21
  * multiple-choice list, so every choice shows it can be picked; otherwise a check on the chosen row only. A busy
@@ -19,16 +28,31 @@ export declare function listRowEnd({ kind, selected, mode, open, busy }: {
19
28
  open: boolean;
20
29
  busy?: boolean;
21
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;
22
36
  export type ListTypeRole = "label" | "input" | "caption" | "body";
23
37
  /**
24
38
  * A row's metrics for its section's variant and density, the numbers Web's row variables hold, for Native rows and
25
39
  * row skeletons: vertical and horizontal padding, gap, minimum height, actions padding and the title, description and
26
40
  * end value type roles.
27
41
  */
28
- export declare function listRowMetrics({ open, compact }: {
42
+ export declare function listRowMetrics({ open, compact, details }: {
29
43
  open: boolean;
30
44
  compact: boolean;
45
+ details?: boolean;
31
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
+ } | {
32
56
  paddingY: 12 | 8;
33
57
  paddingX: 12;
34
58
  gap: 14;
@@ -72,18 +96,26 @@ export declare function listRowChoice(selection: ListSelection | undefined, rowV
72
96
  * no onPress) has nowhere to go, since only the web follows href; `looseChoice` is a choice row outside a section with a
73
97
  * selection mode, so it cannot join one radio group.
74
98
  */
75
- export declare function warnListRowProps({ checked, selected, href, chevron, deviceLink, looseChoice }: {
99
+ export declare function warnListRowProps({ checked, selected, href, chevron, deviceLink, looseChoice, expanded, pressableDetails, current }: {
76
100
  checked?: boolean;
77
101
  selected?: boolean;
78
102
  href?: string;
79
103
  chevron?: boolean;
80
104
  deviceLink?: boolean;
81
105
  looseChoice?: boolean;
106
+ expanded?: boolean;
107
+ pressableDetails?: boolean;
108
+ current?: boolean;
82
109
  }): void;
83
- /** Development warning, once: an open section draws no dividers, so an explicit `divider` does nothing there. */
84
- export declare function warnListSectionProps({ open, divider }: {
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 }: {
85
115
  open: boolean;
86
116
  divider?: boolean;
117
+ details?: boolean;
118
+ compact?: boolean;
87
119
  }): void;
88
120
  /**
89
121
  * Development warnings, once each, for a section selection that would otherwise be ignored without a word: a value
@@ -98,25 +130,56 @@ export declare function warnListSelection({ mode, value, handled }: {
98
130
  }): void;
99
131
  export type ListSectionCorner = "none" | "sm" | "md" | "lg" | "xl";
100
132
  export type ListGroupVariant = "inset" | "flush" | "open";
101
- export type ListSectionVariant = "default" | "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
+ /** A section's fill: true paints the surface, false none, "muted" the muted (secondary) fill that sets rows apart inside a white card or modal. */
137
+ export type ListSectionSurface = boolean | "muted";
138
+ /**
139
+ * How a section's fill draws, the same on every platform: whether it paints at all, whether it is the muted fill, and the
140
+ * web data-surface value (none for the plain surface, "false" for no fill, "muted"). On the muted fill a badge takes the
141
+ * plain surface like inside a tinted card, dividers take the border role and an open row's icon square the surface, so
142
+ * none of them dissolves into the fill.
143
+ */
144
+ export declare function listSectionSurface(surface?: ListSectionSurface): {
145
+ painted: boolean;
146
+ muted: boolean;
147
+ attribute: "false" | "muted" | undefined;
148
+ };
149
+ /** Where a row's trailing value sits: beside the text, on the title line, or on its own line under the title. */
150
+ export type ListTrailingPosition = "side" | "title" | "below";
102
151
  /**
103
152
  * How a section draws, the same on every platform: whether it is open (rows on the page with no card or dividers; the
104
- * section's variant, or the KjunListGroup's), its card corner (the group's when unset; none when open), whether its title
153
+ * 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
105
154
  * is the small label (a title without a description, unless titleVariant says otherwise) and whether its rows form a card
106
- * with the heading and footer outside it.
155
+ * with the heading and footer outside it. A bleeding section (not an open one, whose rows keep their own inset) is flat: it
156
+ * runs to its container's edge, so it has no corner and keeps its heading and footer with the rows.
107
157
  */
108
- export declare function listSectionShape<R extends ListSectionCorner>({ radius, group, variant, title, description, titleVariant }: {
158
+ export declare function listSectionShape<R extends ListSectionCorner>({ radius, group, variant, title, description, titleVariant, bleed: wantsBleed }: {
109
159
  radius?: R;
110
160
  group?: ListGroupVariant | null;
111
161
  variant?: ListSectionVariant;
112
162
  title?: string;
113
163
  description?: string;
114
164
  titleVariant?: "title" | "label";
165
+ bleed?: boolean;
115
166
  }): {
116
167
  open: boolean;
168
+ details: boolean;
117
169
  corner: "none" | "lg" | R;
118
170
  bare: boolean;
119
171
  outside: boolean;
172
+ bleed: boolean;
173
+ };
174
+ /**
175
+ * How far a bleeding section reaches past its container and the inset its rows, heading and footer take: the container's
176
+ * own inset (a KjunCard body's padding) when it gives one, otherwise the rows' standard inset, so text keeps to the
177
+ * content line around the section while fills and dividers run to the container's edge. Native reads it; the web
178
+ * stylesheet does the same with the card's --_kjun-card-body-padding.
179
+ */
180
+ export declare function listSectionInset(bleed: boolean, containerInset: number | null | undefined, rowInset: number): {
181
+ inset: number;
182
+ margin: number;
120
183
  };
121
184
  /**
122
185
  * Web heading actions: records the tallest action's height on the heading, so any control (not only a KjunButton, which
@@ -1,5 +1,7 @@
1
1
  export type ListRowKind = "switch" | "radio" | "checkbox" | "link" | "button" | "static";
2
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;
3
5
  export declare function listRowKind({ checked, selected, href, pressable, mode }: {
4
6
  checked?: boolean;
5
7
  selected?: boolean;
@@ -7,6 +9,13 @@ export declare function listRowKind({ checked, selected, href, pressable, mode }
7
9
  pressable: boolean;
8
10
  mode?: ListSelectionMode;
9
11
  }): ListRowKind;
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;
10
19
  /**
11
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
12
21
  * multiple-choice list, so every choice shows it can be picked; otherwise a check on the chosen row only. A busy
@@ -19,16 +28,31 @@ export declare function listRowEnd({ kind, selected, mode, open, busy }: {
19
28
  open: boolean;
20
29
  busy?: boolean;
21
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;
22
36
  export type ListTypeRole = "label" | "input" | "caption" | "body";
23
37
  /**
24
38
  * A row's metrics for its section's variant and density, the numbers Web's row variables hold, for Native rows and
25
39
  * row skeletons: vertical and horizontal padding, gap, minimum height, actions padding and the title, description and
26
40
  * end value type roles.
27
41
  */
28
- export declare function listRowMetrics({ open, compact }: {
42
+ export declare function listRowMetrics({ open, compact, details }: {
29
43
  open: boolean;
30
44
  compact: boolean;
45
+ details?: boolean;
31
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
+ } | {
32
56
  paddingY: 12 | 8;
33
57
  paddingX: 12;
34
58
  gap: 14;
@@ -72,18 +96,26 @@ export declare function listRowChoice(selection: ListSelection | undefined, rowV
72
96
  * no onPress) has nowhere to go, since only the web follows href; `looseChoice` is a choice row outside a section with a
73
97
  * selection mode, so it cannot join one radio group.
74
98
  */
75
- export declare function warnListRowProps({ checked, selected, href, chevron, deviceLink, looseChoice }: {
99
+ export declare function warnListRowProps({ checked, selected, href, chevron, deviceLink, looseChoice, expanded, pressableDetails, current }: {
76
100
  checked?: boolean;
77
101
  selected?: boolean;
78
102
  href?: string;
79
103
  chevron?: boolean;
80
104
  deviceLink?: boolean;
81
105
  looseChoice?: boolean;
106
+ expanded?: boolean;
107
+ pressableDetails?: boolean;
108
+ current?: boolean;
82
109
  }): void;
83
- /** Development warning, once: an open section draws no dividers, so an explicit `divider` does nothing there. */
84
- export declare function warnListSectionProps({ open, divider }: {
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 }: {
85
115
  open: boolean;
86
116
  divider?: boolean;
117
+ details?: boolean;
118
+ compact?: boolean;
87
119
  }): void;
88
120
  /**
89
121
  * Development warnings, once each, for a section selection that would otherwise be ignored without a word: a value
@@ -98,25 +130,56 @@ export declare function warnListSelection({ mode, value, handled }: {
98
130
  }): void;
99
131
  export type ListSectionCorner = "none" | "sm" | "md" | "lg" | "xl";
100
132
  export type ListGroupVariant = "inset" | "flush" | "open";
101
- export type ListSectionVariant = "default" | "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
+ /** A section's fill: true paints the surface, false none, "muted" the muted (secondary) fill that sets rows apart inside a white card or modal. */
137
+ export type ListSectionSurface = boolean | "muted";
138
+ /**
139
+ * How a section's fill draws, the same on every platform: whether it paints at all, whether it is the muted fill, and the
140
+ * web data-surface value (none for the plain surface, "false" for no fill, "muted"). On the muted fill a badge takes the
141
+ * plain surface like inside a tinted card, dividers take the border role and an open row's icon square the surface, so
142
+ * none of them dissolves into the fill.
143
+ */
144
+ export declare function listSectionSurface(surface?: ListSectionSurface): {
145
+ painted: boolean;
146
+ muted: boolean;
147
+ attribute: "false" | "muted" | undefined;
148
+ };
149
+ /** Where a row's trailing value sits: beside the text, on the title line, or on its own line under the title. */
150
+ export type ListTrailingPosition = "side" | "title" | "below";
102
151
  /**
103
152
  * How a section draws, the same on every platform: whether it is open (rows on the page with no card or dividers; the
104
- * section's variant, or the KjunListGroup's), its card corner (the group's when unset; none when open), whether its title
153
+ * 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
105
154
  * is the small label (a title without a description, unless titleVariant says otherwise) and whether its rows form a card
106
- * with the heading and footer outside it.
155
+ * with the heading and footer outside it. A bleeding section (not an open one, whose rows keep their own inset) is flat: it
156
+ * runs to its container's edge, so it has no corner and keeps its heading and footer with the rows.
107
157
  */
108
- export declare function listSectionShape<R extends ListSectionCorner>({ radius, group, variant, title, description, titleVariant }: {
158
+ export declare function listSectionShape<R extends ListSectionCorner>({ radius, group, variant, title, description, titleVariant, bleed: wantsBleed }: {
109
159
  radius?: R;
110
160
  group?: ListGroupVariant | null;
111
161
  variant?: ListSectionVariant;
112
162
  title?: string;
113
163
  description?: string;
114
164
  titleVariant?: "title" | "label";
165
+ bleed?: boolean;
115
166
  }): {
116
167
  open: boolean;
168
+ details: boolean;
117
169
  corner: "none" | "lg" | R;
118
170
  bare: boolean;
119
171
  outside: boolean;
172
+ bleed: boolean;
173
+ };
174
+ /**
175
+ * How far a bleeding section reaches past its container and the inset its rows, heading and footer take: the container's
176
+ * own inset (a KjunCard body's padding) when it gives one, otherwise the rows' standard inset, so text keeps to the
177
+ * content line around the section while fills and dividers run to the container's edge. Native reads it; the web
178
+ * stylesheet does the same with the card's --_kjun-card-body-padding.
179
+ */
180
+ export declare function listSectionInset(bleed: boolean, containerInset: number | null | undefined, rowInset: number): {
181
+ inset: number;
182
+ margin: number;
120
183
  };
121
184
  /**
122
185
  * Web heading actions: records the tallest action's height on the heading, so any control (not only a KjunButton, which
@@ -1,3 +1,4 @@
1
+ import { isMarketIdentity } from "./market-table.cjs";
1
2
  export interface LayoutColumn {
2
3
  key?: string;
3
4
  label?: string;
@@ -17,7 +18,7 @@ export declare const marketGeometry: {
17
18
  readonly actionSkeletonWidth: 32;
18
19
  readonly headerSkeletonHeight: 14;
19
20
  };
20
- export declare const isMarketIdentity: (key?: string) => boolean;
21
+ export { isMarketIdentity };
21
22
  export declare const normalizeMarketColumns: (columns: (LayoutColumn | string)[]) => LayoutColumn[];
22
23
  export declare const webMarketActionsWidth = "var(--_kjun-market-table-actions-width)";
23
24
  /** Preserve CSS widths and Vue's historical class-based width overrides. */
@@ -37,5 +38,6 @@ export declare function webMarketLayout(columns: LayoutColumn[], showActions: bo
37
38
  export declare function nativeMarketLayout(columns: LayoutColumn[], showActions: boolean, containerWidth: number, windowWidth?: number): {
38
39
  widths: number[];
39
40
  compact: boolean;
41
+ actionsWidth: number;
40
42
  width: number;
41
43
  };
@@ -1,3 +1,4 @@
1
+ import { isMarketIdentity } from "./market-table.js";
1
2
  export interface LayoutColumn {
2
3
  key?: string;
3
4
  label?: string;
@@ -17,7 +18,7 @@ export declare const marketGeometry: {
17
18
  readonly actionSkeletonWidth: 32;
18
19
  readonly headerSkeletonHeight: 14;
19
20
  };
20
- export declare const isMarketIdentity: (key?: string) => boolean;
21
+ export { isMarketIdentity };
21
22
  export declare const normalizeMarketColumns: (columns: (LayoutColumn | string)[]) => LayoutColumn[];
22
23
  export declare const webMarketActionsWidth = "var(--_kjun-market-table-actions-width)";
23
24
  /** Preserve CSS widths and Vue's historical class-based width overrides. */
@@ -37,5 +38,6 @@ export declare function webMarketLayout(columns: LayoutColumn[], showActions: bo
37
38
  export declare function nativeMarketLayout(columns: LayoutColumn[], showActions: boolean, containerWidth: number, windowWidth?: number): {
38
39
  widths: number[];
39
40
  compact: boolean;
41
+ actionsWidth: number;
40
42
  width: number;
41
43
  };