@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
@@ -0,0 +1,23 @@
1
+ /** How many labels end past the room left for them, given each label's right edge. */
2
+ export declare function hiddenLabelCount(rights: readonly number[], available: number): number;
3
+ /** Size and place of the clear button that sits over a select-like trigger, before its indicator. */
4
+ export declare function selectClearStyle(spec: {
5
+ padding: number;
6
+ iconSize: number;
7
+ affixGap: number;
8
+ clearSize: number;
9
+ }): {
10
+ right: number;
11
+ width: number;
12
+ height: number;
13
+ minHeight: number;
14
+ };
15
+ /** The filled circle drawn inside the clear button; the button keeps the larger target. */
16
+ export declare function selectClearMarkStyle(spec: {
17
+ clearMarkSize: number;
18
+ }): {
19
+ width: number;
20
+ height: number;
21
+ };
22
+ /** Web: how many of the label spans inside `text` end past its visible width. */
23
+ export declare function measureHiddenLabels(text: HTMLElement | null | undefined): number;
@@ -0,0 +1,24 @@
1
+ /** Downward speed in px per ms at which a short flick still dismisses the sheet. */
2
+ export declare const sheetFlickVelocity = 0.5;
3
+ /** How far the sheet follows a drag: only downward, never past its own height. */
4
+ export declare function sheetDragOffset(delta: number, height: number): number;
5
+ /** Whether a released drag closes the sheet: past the dismiss distance, or a downward flick. */
6
+ export declare function sheetDragDismisses(offset: number, velocity: number, distance: number): boolean;
7
+ /** How much of the backdrop remains while the sheet is dragged down (1 at rest, 0 at its full height). */
8
+ export declare function sheetDragFade(offset: number, height: number): number;
9
+ export interface SheetDragTarget {
10
+ /** The overlay that carries the backdrop. */
11
+ overlay: () => HTMLElement | null;
12
+ /** The panel that moves with the pointer. */
13
+ panel: () => HTMLElement | null;
14
+ /** Dismiss distance in px (tokens drawer.dismissDistance). */
15
+ distance: number;
16
+ enabled: () => boolean;
17
+ onDismiss: () => void;
18
+ }
19
+ /**
20
+ * pointerdown handler for the drag area (handle and header), given that area's element. While dragging the panel follows the pointer inline and the
21
+ * overlay carries data-dragging with --_kjun-drawer-drag (the backdrop that remains); on release both are cleared, so the
22
+ * panel springs back or leaves through the drawer's own CSS transition from where it was dropped.
23
+ */
24
+ export declare function sheetDragStart(target: SheetDragTarget): (event: PointerEvent, area: HTMLElement | null) => void;
@@ -0,0 +1,24 @@
1
+ /** Downward speed in px per ms at which a short flick still dismisses the sheet. */
2
+ export declare const sheetFlickVelocity = 0.5;
3
+ /** How far the sheet follows a drag: only downward, never past its own height. */
4
+ export declare function sheetDragOffset(delta: number, height: number): number;
5
+ /** Whether a released drag closes the sheet: past the dismiss distance, or a downward flick. */
6
+ export declare function sheetDragDismisses(offset: number, velocity: number, distance: number): boolean;
7
+ /** How much of the backdrop remains while the sheet is dragged down (1 at rest, 0 at its full height). */
8
+ export declare function sheetDragFade(offset: number, height: number): number;
9
+ export interface SheetDragTarget {
10
+ /** The overlay that carries the backdrop. */
11
+ overlay: () => HTMLElement | null;
12
+ /** The panel that moves with the pointer. */
13
+ panel: () => HTMLElement | null;
14
+ /** Dismiss distance in px (tokens drawer.dismissDistance). */
15
+ distance: number;
16
+ enabled: () => boolean;
17
+ onDismiss: () => void;
18
+ }
19
+ /**
20
+ * pointerdown handler for the drag area (handle and header), given that area's element. While dragging the panel follows the pointer inline and the
21
+ * overlay carries data-dragging with --_kjun-drawer-drag (the backdrop that remains); on release both are cleared, so the
22
+ * panel springs back or leaves through the drawer's own CSS transition from where it was dropped.
23
+ */
24
+ export declare function sheetDragStart(target: SheetDragTarget): (event: PointerEvent, area: HTMLElement | null) => void;
@@ -0,0 +1,23 @@
1
+ /** A parent or group title's own panel: whether it shows, how to open or close it, and the panel's id. */
2
+ export type SideNavigationArrowOwner = {
3
+ shown: boolean;
4
+ set: (open: boolean) => void;
5
+ panel: string;
6
+ };
7
+ type KeyEvent = {
8
+ key: string;
9
+ currentTarget: EventTarget | null;
10
+ preventDefault(): void;
11
+ };
12
+ /** The first row a panel holds that can take focus. */
13
+ export declare function sideNavigationFirstRow(panel: string): HTMLElement | null;
14
+ /** The parent button or group title whose panel holds a row. */
15
+ export declare function sideNavigationOwner(node: HTMLElement): HTMLElement | null;
16
+ /** Moves or opens for an arrow key on a row. own is the row's own panel (a parent or group title); leave closes the
17
+ * flyout the row sits in. */
18
+ export declare function sideNavigationArrowKey(event: KeyEvent, own?: SideNavigationArrowOwner, leave?: () => void): void;
19
+ /** Whether a key on a collapsed icon opens its flyout: → (← right to left). */
20
+ export declare const sideNavigationOpensFlyout: (event: KeyEvent) => boolean;
21
+ /** Closes a flyout and puts focus back on the icon that opened it. */
22
+ export declare function closeSideNavigationFlyout(close: () => void, trigger: string): void;
23
+ export {};
@@ -0,0 +1,23 @@
1
+ /** A parent or group title's own panel: whether it shows, how to open or close it, and the panel's id. */
2
+ export type SideNavigationArrowOwner = {
3
+ shown: boolean;
4
+ set: (open: boolean) => void;
5
+ panel: string;
6
+ };
7
+ type KeyEvent = {
8
+ key: string;
9
+ currentTarget: EventTarget | null;
10
+ preventDefault(): void;
11
+ };
12
+ /** The first row a panel holds that can take focus. */
13
+ export declare function sideNavigationFirstRow(panel: string): HTMLElement | null;
14
+ /** The parent button or group title whose panel holds a row. */
15
+ export declare function sideNavigationOwner(node: HTMLElement): HTMLElement | null;
16
+ /** Moves or opens for an arrow key on a row. own is the row's own panel (a parent or group title); leave closes the
17
+ * flyout the row sits in. */
18
+ export declare function sideNavigationArrowKey(event: KeyEvent, own?: SideNavigationArrowOwner, leave?: () => void): void;
19
+ /** Whether a key on a collapsed icon opens its flyout: → (← right to left). */
20
+ export declare const sideNavigationOpensFlyout: (event: KeyEvent) => boolean;
21
+ /** Closes a flyout and puts focus back on the icon that opened it. */
22
+ export declare function closeSideNavigationFlyout(close: () => void, trigger: string): void;
23
+ export {};
@@ -0,0 +1,24 @@
1
+ /** The menu panel beside a spaces rail: a card set into the rail's band, or flat against it with a line before the page. */
2
+ export type SideNavigationPanelSurface = "card" | "flat";
3
+ type SpacesGeometry = {
4
+ paddingX: number;
5
+ iconSize: number;
6
+ spacesRailPaddingX: number;
7
+ spacesPanelWidth: number;
8
+ spacesPanelInset: number;
9
+ };
10
+ /** The rail's cell: an icons-only menu row (padding, icon, padding) with the rail's padding on each side. */
11
+ export declare function spacesRailCellWidth(geometry: Pick<SpacesGeometry, "paddingX" | "iconSize" | "spacesRailPaddingX">): number;
12
+ /** The column's width: the rail's cell, plus the panel (and a card's end inset) while the panel is open. */
13
+ export declare function spacesColumnWidth(geometry: SpacesGeometry, surface: SideNavigationPanelSurface, panelCollapsed: boolean): number;
14
+ /** Where focus goes after the panel opens or closes: to the rail's expand button when the panel closes around the focus
15
+ * or by its own button, to the panel's collapse button when a button opened it, otherwise it stays (null). */
16
+ export declare function spacesFocusAfterChange(nextCollapsed: boolean, focusInPanel: boolean, byButton: boolean): "expand" | "collapse" | null;
17
+ /** The layout props a spaces rail replaces (the rail is the collapsed column, and the panel has one width), named only
18
+ * when the app set them, for a development warning. */
19
+ export declare function spacesIgnoredProps(props: {
20
+ collapsed?: boolean;
21
+ railLabels?: boolean;
22
+ width?: string;
23
+ }): string[];
24
+ export {};
@@ -0,0 +1,24 @@
1
+ /** The menu panel beside a spaces rail: a card set into the rail's band, or flat against it with a line before the page. */
2
+ export type SideNavigationPanelSurface = "card" | "flat";
3
+ type SpacesGeometry = {
4
+ paddingX: number;
5
+ iconSize: number;
6
+ spacesRailPaddingX: number;
7
+ spacesPanelWidth: number;
8
+ spacesPanelInset: number;
9
+ };
10
+ /** The rail's cell: an icons-only menu row (padding, icon, padding) with the rail's padding on each side. */
11
+ export declare function spacesRailCellWidth(geometry: Pick<SpacesGeometry, "paddingX" | "iconSize" | "spacesRailPaddingX">): number;
12
+ /** The column's width: the rail's cell, plus the panel (and a card's end inset) while the panel is open. */
13
+ export declare function spacesColumnWidth(geometry: SpacesGeometry, surface: SideNavigationPanelSurface, panelCollapsed: boolean): number;
14
+ /** Where focus goes after the panel opens or closes: to the rail's expand button when the panel closes around the focus
15
+ * or by its own button, to the panel's collapse button when a button opened it, otherwise it stays (null). */
16
+ export declare function spacesFocusAfterChange(nextCollapsed: boolean, focusInPanel: boolean, byButton: boolean): "expand" | "collapse" | null;
17
+ /** The layout props a spaces rail replaces (the rail is the collapsed column, and the panel has one width), named only
18
+ * when the app set them, for a development warning. */
19
+ export declare function spacesIgnoredProps(props: {
20
+ collapsed?: boolean;
21
+ railLabels?: boolean;
22
+ width?: string;
23
+ }): string[];
24
+ export {};
@@ -0,0 +1,7 @@
1
+ /** Web only. Scrolling the side navigation's own column, never the page: element.scrollIntoView would also move the
2
+ * window and every scrolling ancestor, which jumps the page when the menu sits in a sticky sidebar. */
3
+ /** Brings an element into its scrolling column by the shortest move ("nearest"); does nothing when it is already in view. */
4
+ export declare function scrollSideNavigationRow(node: HTMLElement | null | undefined, instant?: boolean): void;
5
+ /** The row that shows where the person is: the current link when it is on screen, else the closed parent or group that
6
+ * stands for it. */
7
+ export declare function sideNavigationCurrentRow(nav: HTMLElement | null | undefined): HTMLElement | null;
@@ -0,0 +1,7 @@
1
+ /** Web only. Scrolling the side navigation's own column, never the page: element.scrollIntoView would also move the
2
+ * window and every scrolling ancestor, which jumps the page when the menu sits in a sticky sidebar. */
3
+ /** Brings an element into its scrolling column by the shortest move ("nearest"); does nothing when it is already in view. */
4
+ export declare function scrollSideNavigationRow(node: HTMLElement | null | undefined, instant?: boolean): void;
5
+ /** The row that shows where the person is: the current link when it is on screen, else the closed parent or group that
6
+ * stands for it. */
7
+ export declare function sideNavigationCurrentRow(nav: HTMLElement | null | undefined): HTMLElement | null;
@@ -0,0 +1,277 @@
1
+ import { type NavigationBadge } from "./navigation-badge.cjs";
2
+ /** A small button at the end of a row or a group title, such as "New" or "More". It does not navigate; the press reaches
3
+ * onAction (Vue: the action event) with the row's key and the action's key. */
4
+ export interface SideNavigationAction {
5
+ key: string;
6
+ icon: string;
7
+ label: string;
8
+ }
9
+ /** How loud a badge is: "alert" (the default) is the danger pill, "neutral" a quiet grey count for plain totals. */
10
+ export type SideNavigationBadgeTone = "alert" | "neutral";
11
+ /** A destination in the side navigation: the bottom navigation's shape, so one list can feed both. */
12
+ export interface SideNavigationDestination {
13
+ key: string;
14
+ label: string;
15
+ href: string;
16
+ /** Drawn on top-level rows only; a child row starts at its parent's label and draws no icon. */
17
+ icon?: string;
18
+ /** A count or short text; true draws a dot. Numbers over 99 show 99+. 0 and "" draw nothing. */
19
+ badge?: NavigationBadge;
20
+ /** "neutral" draws the badge as a quiet grey count; keep "alert" (the default) for what needs attention. */
21
+ badgeTone?: SideNavigationBadgeTone;
22
+ disabled?: boolean;
23
+ /** The name under the icon in a labelled rail (railLabels), which is only 72 wide: about four Korean characters. The
24
+ * full label stays the accessible name and shows as a tooltip there. */
25
+ shortLabel?: string;
26
+ /** Where the link opens on Web, such as "_blank" for a page outside the app. Such a link is left to the browser. */
27
+ target?: string;
28
+ /** Buttons at the end of the row, shown under a pointer or focus (always on touch). Hidden while only icons show. */
29
+ actions?: SideNavigationAction[];
30
+ }
31
+ /** The fields every destination type shares; Native's destination has an optional href. */
32
+ type Destination = {
33
+ key: string;
34
+ label: string;
35
+ icon?: string;
36
+ badge?: NavigationBadge;
37
+ badgeTone?: SideNavigationBadgeTone;
38
+ disabled?: boolean;
39
+ shortLabel?: string;
40
+ target?: string;
41
+ actions?: SideNavigationAction[];
42
+ };
43
+ /** What any platform's destination holds, for helpers generic over Web's and Native's. */
44
+ export type SideNavigationAnyDestination = Destination;
45
+ /** A parent under a parent: the second and last level. It opens its destinations in place, one step further in. */
46
+ export interface SideNavigationSubParent<D extends Destination = SideNavigationDestination> {
47
+ key: string;
48
+ label: string;
49
+ disabled?: boolean;
50
+ children: D[];
51
+ }
52
+ /** A parent that opens its destinations under it. Its children may hold one more level of parents. It is a toggle and
53
+ * does not navigate itself. */
54
+ export interface SideNavigationParent<D extends Destination = SideNavigationDestination> {
55
+ key: string;
56
+ label: string;
57
+ icon?: string;
58
+ disabled?: boolean;
59
+ /** The name under the icon in a labelled rail (railLabels). */
60
+ shortLabel?: string;
61
+ children: (D | SideNavigationSubParent<D>)[];
62
+ }
63
+ export type SideNavigationItem<D extends Destination = SideNavigationDestination> = D | SideNavigationParent<D>;
64
+ /** A titled run of items, such as "Documents" or "Admin". */
65
+ export interface SideNavigationGroup<D extends Destination = SideNavigationDestination> {
66
+ title: string;
67
+ items: SideNavigationItem<D>[];
68
+ /** The group's identity in expandedGroups and showAll; the title when absent. */
69
+ key?: string;
70
+ /** The group's mark in a collapsed rail of groups (rail="groups"); its title's first character when absent. */
71
+ icon?: string;
72
+ /** The group's name under its icon in a labelled rail of groups. */
73
+ shortTitle?: string;
74
+ /** Whether this title opens and closes its group. Absent: the navigation's collapsibleGroups. */
75
+ collapsible?: boolean;
76
+ /** Starts open when the navigation keeps the open groups itself. The current page's group always starts open. */
77
+ defaultOpen?: boolean;
78
+ /** Shows only the first rows and a "N more" row for the rest, for lists people grow (projects, channels). The row of the
79
+ * current page always shows. */
80
+ limit?: number;
81
+ /** One button at the end of the title, such as "New project". */
82
+ action?: SideNavigationAction;
83
+ /** A quiet line shown in place of the rows while the group has none, such as "No projects yet", so an empty group does
84
+ * not read as a closed one. */
85
+ empty?: string;
86
+ }
87
+ export type SideNavigationEntry<D extends Destination = SideNavigationDestination> = SideNavigationItem<D> | SideNavigationGroup<D>;
88
+ export interface SideNavigationSection<D extends Destination = SideNavigationDestination> {
89
+ title?: string;
90
+ items: SideNavigationItem<D>[];
91
+ /** Set on a titled section: the group's key (its title when the group has none) and its options. */
92
+ key?: string;
93
+ icon?: string;
94
+ shortTitle?: string;
95
+ collapsible?: boolean;
96
+ defaultOpen?: boolean;
97
+ limit?: number;
98
+ action?: SideNavigationAction;
99
+ empty?: string;
100
+ }
101
+ /** A titled section, as a rail of groups or a toggle reads it. */
102
+ export type SideNavigationTitledSection<D extends Destination = SideNavigationDestination> = SideNavigationSection<D> & {
103
+ key: string;
104
+ title: string;
105
+ };
106
+ /** What a collapsed menu shows one icon for: each top-level item, or each group (loose items keep their own row). */
107
+ export type SideNavigationRail = "items" | "groups";
108
+ /** While collapsed, what pressing a parent or a group does: widen the column with it open, or show its rows in a
109
+ * floating panel beside the icon and keep the column narrow. */
110
+ export type SideNavigationCollapsedParent = "widen" | "flyout";
111
+ /** The width of an open column in KjunSideNavigationLayout. */
112
+ export type SideNavigationWidth = "sm" | "md" | "lg";
113
+ type AnyParent<D extends Destination> = SideNavigationParent<D> | SideNavigationSubParent<D>;
114
+ type Node<D extends Destination> = D | AnyParent<D>;
115
+ export declare const isSideGroup: <D extends Destination>(entry: SideNavigationEntry<D>) => entry is SideNavigationGroup<D>;
116
+ export declare const isSideParent: <T extends {
117
+ key: string;
118
+ }>(item: T) => item is Extract<T, {
119
+ children: unknown[];
120
+ }>;
121
+ export declare const isTitledSection: <D extends Destination>(section: SideNavigationSection<D>) => section is SideNavigationTitledSection<D>;
122
+ /** The entries as sections in order: loose items between groups form untitled sections, each group its own titled one. */
123
+ export declare function sideNavigationSections<D extends Destination>(entries: readonly SideNavigationEntry<D>[]): SideNavigationSection<D>[];
124
+ /** The parents that hold the current destination, at both levels; they start open so the current page is in view. */
125
+ export declare function sideNavigationCurrentParents<D extends Destination>(entries: readonly SideNavigationEntry<D>[], value: string | null | undefined): string[];
126
+ /** The open parents once the current destination's parents are added. The same array when nothing was added, so a
127
+ * component can tell whether to store or report a change. */
128
+ export declare function sideNavigationWithCurrentParents<D extends Destination>(open: readonly string[], entries: readonly SideNavigationEntry<D>[], value: string | null | undefined): readonly string[];
129
+ /** A group's identity in expandedGroups. */
130
+ export declare const sideGroupKey: (group: {
131
+ key?: string;
132
+ title: string;
133
+ }) => string;
134
+ /** Whether a titled section's title opens and closes it: its own collapsible, else the navigation's collapsibleGroups. */
135
+ export declare const sideSectionToggles: <D extends Destination>(section: SideNavigationSection<D>, collapsibleGroups: boolean) => section is SideNavigationTitledSection<D>;
136
+ /** Whether a parent holds the current destination, at either level under it. */
137
+ export declare const sideParentHoldsCurrent: <D extends Destination>(parent: AnyParent<D>, value: string | null | undefined) => boolean;
138
+ /** Whether a run of items holds the current destination, directly or under a parent. */
139
+ export declare const sideItemsHoldCurrent: <D extends Destination>(items: readonly Node<D>[], value: string | null | undefined) => boolean;
140
+ /** The tone of the dot that stands for the badges hidden in a run of items: "alert" when any of them is an alert, else
141
+ * "neutral" when any has a badge, else null. Disabled rows and their badges do not count. */
142
+ export declare function sideItemsBadgeTone<D extends Destination>(items: readonly Node<D>[]): SideNavigationBadgeTone | null;
143
+ /** Whether a run of items has a badge to show while it is hidden behind its group. */
144
+ export declare const sideItemsHaveBadge: <D extends Destination>(items: readonly Node<D>[]) => boolean;
145
+ export declare const sideParentHasBadge: <D extends Destination>(parent: AnyParent<D>) => boolean;
146
+ /** The open groups once the group of the current destination is added. The same array when nothing was added, like
147
+ * sideNavigationWithCurrentParents, so a component can tell whether to store or report a change. */
148
+ export declare function sideNavigationWithCurrentGroups<D extends Destination>(open: readonly string[], entries: readonly SideNavigationEntry<D>[], value: string | null | undefined): readonly string[];
149
+ /** The groups a navigation that keeps its own list starts with: those marked defaultOpen and the current page's group. */
150
+ export declare function sideNavigationInitialGroups<D extends Destination>(entries: readonly SideNavigationEntry<D>[], value: string | null | undefined): string[];
151
+ /** The rows of a collapsed rail of groups, in order: one per titled group, and the loose items between groups as they are. */
152
+ export type SideNavigationRailRow<D extends Destination = SideNavigationDestination> = {
153
+ group: SideNavigationTitledSection<D>;
154
+ } | {
155
+ item: SideNavigationItem<D>;
156
+ };
157
+ export declare function sideNavigationGroupRail<D extends Destination>(entries: readonly SideNavigationEntry<D>[]): SideNavigationRailRow<D>[];
158
+ /** The next list of open parents (or groups, or groups showing all rows) after one is toggled. */
159
+ export declare const toggleSideParent: (open: readonly string[], key: string) => string[];
160
+ /** What a parent row shows: whether its children are on screen, and what it stands for while they are not (a closed
161
+ * parent holding the current page, a dot for a child's badge in that badge's tone). In a flyout the children show beside,
162
+ * not under, it. */
163
+ export declare function sideParentState<D extends Destination>(parent: AnyParent<D>, { open, collapsed, value }: {
164
+ open: readonly string[];
165
+ collapsed: boolean;
166
+ value: string | null | undefined;
167
+ }): {
168
+ shown: boolean;
169
+ within: boolean;
170
+ dot: boolean;
171
+ tone: SideNavigationBadgeTone | null;
172
+ };
173
+ /** What a group toggle shows: the selection's trace and a dot for a badge inside while closed, and how many rows it holds. */
174
+ export declare function sideGroupState<D extends Destination>(section: SideNavigationTitledSection<D>, { openGroups, value }: {
175
+ openGroups: readonly string[];
176
+ value: string | null | undefined;
177
+ }): {
178
+ shown: boolean;
179
+ within: boolean;
180
+ dot: boolean;
181
+ tone: SideNavigationBadgeTone | null;
182
+ count: number;
183
+ };
184
+ /** A rail-of-groups row: always closed, so it stands for everything in its group. */
185
+ export declare function sideRailGroupState<D extends Destination>(section: SideNavigationTitledSection<D>, value: string | null | undefined): {
186
+ within: boolean;
187
+ dot: boolean;
188
+ tone: SideNavigationBadgeTone | null;
189
+ };
190
+ /** The rows a group shows under its limit: the first `limit`, plus any later row that holds the current page, in their
191
+ * places. hidden is how many stay behind the "more" row; 0 when the group has no limit, fits it, or shows all. */
192
+ export declare function sideSectionRows<D extends Destination>(section: SideNavigationSection<D>, { value, showAll }: {
193
+ value: string | null | undefined;
194
+ showAll: readonly string[];
195
+ }): {
196
+ items: SideNavigationItem<D>[];
197
+ hidden: number;
198
+ expandable: boolean;
199
+ expanded: boolean;
200
+ };
201
+ /** The line a titled group shows in place of its rows: its empty text while it has none, else nothing. */
202
+ export declare const sideSectionEmpty: (section: {
203
+ items: readonly unknown[];
204
+ empty?: string;
205
+ }) => string | undefined;
206
+ /** A link that leaves this tab (target="_blank" and the like). The browser opens it; the app is not asked to route. */
207
+ export declare const sideNavigationOpensElsewhere: (destination: {
208
+ target?: string;
209
+ }) => boolean;
210
+ /** A plain primary click: no modifier key and the main button. Modified clicks open a new tab or window, so they are left
211
+ * to the browser. Fields missing from an event (a touch on Native Web) count as plain. */
212
+ export declare function isPlainNavigationClick(event: {
213
+ button?: number;
214
+ metaKey?: boolean;
215
+ ctrlKey?: boolean;
216
+ shiftKey?: boolean;
217
+ altKey?: boolean;
218
+ defaultPrevented?: boolean;
219
+ } | null | undefined): boolean;
220
+ /** The first character of a label: the mark of a row without an icon while the navigation shows icons only. */
221
+ export declare const sideNavigationInitial: (label: string) => string;
222
+ /** The name a row shows: its short name under an icon in a labelled rail, else its label. */
223
+ export declare const sideNavigationShownLabel: (item: {
224
+ label: string;
225
+ shortLabel?: string;
226
+ }, labelled: boolean) => string;
227
+ /** A group's name under its icon in a labelled rail of groups. */
228
+ export declare const sideNavigationShownTitle: (group: {
229
+ title: string;
230
+ shortTitle?: string;
231
+ }, labelled: boolean) => string;
232
+ type Messages = {
233
+ newContent: string;
234
+ newCount: (count: number) => string;
235
+ newWindow: string;
236
+ };
237
+ /** A destination's accessible name: its full label, what its badge says, and that it opens elsewhere. */
238
+ export declare const sideNavigationLinkName: (item: {
239
+ label: string;
240
+ badge?: NavigationBadge;
241
+ target?: string;
242
+ }, m: Messages) => string;
243
+ /** The same name for Web's aria-label, or undefined when the shown text already is the whole name. */
244
+ export declare function sideNavigationLinkLabel(item: {
245
+ label: string;
246
+ shortLabel?: string;
247
+ badge?: NavigationBadge;
248
+ target?: string;
249
+ }, m: Messages, labelled: boolean): string | undefined;
250
+ /** A parent's or group's accessible name: its label, and "new" while a dot stands for a hidden badge. */
251
+ export declare const sideNavigationToggleName: (label: string, dot: boolean, m: {
252
+ newContent: string;
253
+ }) => string;
254
+ /** What an arrow key asks of a row in an open menu: "in" opens a closed parent or group, or moves to its first row;
255
+ * "out" closes an open one, or moves from a row to the parent or group title it sits under. Right to left swaps them. */
256
+ export declare function sideNavigationArrow(key: string, rtl: boolean): "in" | "out" | null;
257
+ /** The flyout open beside a collapsed icon, by kind, so a parent and a group with the same key never share one. */
258
+ export declare const sideFlyoutKey: (kind: "parent" | "group", key: string) => string;
259
+ /** A key as part of an element id: anything outside [A-Za-z0-9_-] becomes its code point, so different keys stay apart. */
260
+ export declare const sideNavigationIdPart: (key: string) => string;
261
+ /** Heading levels a group title can take. */
262
+ export type SideNavigationHeadingLevel = 2 | 3 | 4 | 5 | 6;
263
+ /** A one-time development warning. */
264
+ export declare function warnSideNavigation(message: string): void;
265
+ /** Keys that repeat: two rows or two groups with one key open, close and mark the current page together. */
266
+ export declare function sideNavigationDuplicateKeys<D extends Destination>(entries: readonly SideNavigationEntry<D>[]): string[];
267
+ /** Parents nested deeper than two levels: the third level is not drawn. */
268
+ export declare function sideNavigationTooDeep<D extends Destination>(entries: readonly SideNavigationEntry<D>[]): string[];
269
+ /** Development checks for a navigation's items and the props that read them. */
270
+ export declare function checkSideNavigation<D extends Destination>(entries: readonly SideNavigationEntry<D>[]): void;
271
+ /** A parent or group pressed while collapsed asks to widen; without a handler the press would do nothing visible. */
272
+ export declare const warnNoWiden: () => void;
273
+ /** KjunSideNavigationLayout's railBreakpoint: the collapsed value to ask for when the viewport moves across it, else null.
274
+ * previous is null before the first reading, where only a viewport already below it asks (for the rail). Between
275
+ * crossings the person's own toggle stands. */
276
+ export declare function sideNavigationRailRequest(previous: boolean | null, below: boolean, collapsed: boolean): boolean | null;
277
+ export {};