@zeyos/zx 5.7.0 → 5.8.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 (330) hide show
  1. package/CHANGELOG.md +330 -0
  2. package/README.md +47 -9
  3. package/dist/types/components/activity-item/activity-item.d.ts +14 -3
  4. package/dist/types/components/agent-avatar/agent-avatar.d.ts +165 -0
  5. package/dist/types/components/agent-avatar/agent-face.d.ts +93 -0
  6. package/dist/types/components/agent-thread/ag-ui.d.ts +21 -9
  7. package/dist/types/components/agent-thread/agent-thread.d.ts +26 -0
  8. package/dist/types/components/agent-thread/ui-message-stream.d.ts +3 -1
  9. package/dist/types/components/approval-card/approval-card.d.ts +31 -2
  10. package/dist/types/components/aurora/aurora.d.ts +31 -5
  11. package/dist/types/components/calendar/calendar.d.ts +39 -26
  12. package/dist/types/components/chart/chart.d.ts +250 -20
  13. package/dist/types/components/chart/color.d.ts +66 -0
  14. package/dist/types/components/chart/svg-adapter.d.ts +103 -0
  15. package/dist/types/components/chart/svg-geometry.d.ts +203 -0
  16. package/dist/types/components/check-button/check-button.d.ts +1 -4
  17. package/dist/types/components/checklist/checklist.d.ts +48 -5
  18. package/dist/types/components/code-editor/code-editor.d.ts +55 -1
  19. package/dist/types/components/composer/composer.d.ts +41 -6
  20. package/dist/types/components/context-menu/context-menu.d.ts +36 -8
  21. package/dist/types/components/copy/copy-button.d.ts +6 -0
  22. package/dist/types/components/copy/copy-input.d.ts +1 -0
  23. package/dist/types/components/date-picker/date-picker.d.ts +14 -0
  24. package/dist/types/components/date-picker/time-picker.d.ts +26 -17
  25. package/dist/types/components/datebox/datebox.d.ts +8 -4
  26. package/dist/types/components/dialog/dialog.d.ts +15 -4
  27. package/dist/types/components/empty-state/empty-state.d.ts +10 -1
  28. package/dist/types/components/field/field.d.ts +4 -2
  29. package/dist/types/components/form/form.d.ts +2 -1
  30. package/dist/types/components/kanban-view/kanban-card.d.ts +7 -0
  31. package/dist/types/components/kanban-view/kanban-view.d.ts +15 -3
  32. package/dist/types/components/launcher/launcher.d.ts +26 -0
  33. package/dist/types/components/master-panel/master-panel.d.ts +9 -4
  34. package/dist/types/components/menu-button/menu-button.d.ts +29 -5
  35. package/dist/types/components/message/message.d.ts +308 -5
  36. package/dist/types/components/modal/modal.d.ts +45 -8
  37. package/dist/types/components/modal/native-dialog.d.ts +40 -0
  38. package/dist/types/components/module-bar/module-bar.d.ts +9 -2
  39. package/dist/types/components/multi-value-editor/multi-value-editor.d.ts +5 -4
  40. package/dist/types/components/number-field/number-field.d.ts +31 -1
  41. package/dist/types/components/pagination/pagination.d.ts +341 -19
  42. package/dist/types/components/run-status/run-status.d.ts +26 -0
  43. package/dist/types/components/run-trace/run-trace.d.ts +10 -6
  44. package/dist/types/components/search/search.d.ts +16 -4
  45. package/dist/types/components/select/select.d.ts +19 -1
  46. package/dist/types/components/sheet/sheet.d.ts +20 -6
  47. package/dist/types/components/slider/slider.d.ts +2 -1
  48. package/dist/types/components/stat-tile/stat-tile.d.ts +20 -3
  49. package/dist/types/components/stepper/stepper.d.ts +17 -4
  50. package/dist/types/components/surface/catalog.d.ts +61 -17
  51. package/dist/types/components/surface/surface.d.ts +6 -4
  52. package/dist/types/components/table/table.d.ts +207 -5
  53. package/dist/types/components/table/window.d.ts +25 -1
  54. package/dist/types/components/toggle/toggle.d.ts +38 -6
  55. package/dist/types/components/tooltip/tooltip.d.ts +5 -4
  56. package/dist/types/components/tree/tree.d.ts +43 -6
  57. package/dist/types/components/truncate/truncate.d.ts +4 -2
  58. package/dist/types/components/value-list/value-list.d.ts +9 -2
  59. package/dist/types/core/date.d.ts +2 -1
  60. package/dist/types/core/dom.d.ts +14 -0
  61. package/dist/types/core/drag-axis.d.ts +10 -5
  62. package/dist/types/core/export.d.ts +2 -2
  63. package/dist/types/core/format.d.ts +3 -1
  64. package/dist/types/core/icons.d.ts +36 -3
  65. package/dist/types/core/keyboard.d.ts +7 -3
  66. package/dist/types/core/messages.d.ts +3 -0
  67. package/dist/types/core/storage.d.ts +4 -3
  68. package/dist/types/core/util.d.ts +3 -1
  69. package/dist/types/elements/define.d.ts +5 -2
  70. package/dist/types/index.d.ts +6 -4
  71. package/dist/types/internal/agent-model.d.ts +99 -0
  72. package/dist/types/internal/app-rail.d.ts +37 -2
  73. package/dist/types/internal/collections.d.ts +18 -0
  74. package/dist/types/internal/menu-items.d.ts +27 -0
  75. package/dist/types/internal/overlay-content.d.ts +23 -0
  76. package/dist/types/internal/presence-loop.d.ts +5 -2
  77. package/dist/types/locales/index.d.ts +3 -0
  78. package/dist/types/zeyos/calendar.d.ts +43 -7
  79. package/dist/types/zeyos/connect.d.ts +4 -0
  80. package/dist/types/zeyos/form.d.ts +13 -5
  81. package/dist/types/zeyos/select.d.ts +5 -2
  82. package/dist/types/zeyos/table.d.ts +16 -8
  83. package/dist/types/zeyos/view.d.ts +2 -1
  84. package/dist/zx-zeyos.esm.js +3161 -515
  85. package/dist/zx-zeyos.esm.min.js +4 -4
  86. package/dist/zx.core.css +4 -0
  87. package/dist/zx.core.min.css +1 -1
  88. package/dist/zx.css +970 -57
  89. package/dist/zx.esm.js +6405 -2249
  90. package/dist/zx.esm.min.js +26 -26
  91. package/dist/zx.global.js +6405 -2249
  92. package/dist/zx.global.min.js +26 -26
  93. package/dist/zx.layered.css +972 -57
  94. package/dist/zx.layered.min.css +1 -1
  95. package/dist/zx.min.css +1 -1
  96. package/docs/agent-catalog.json +159 -1
  97. package/docs/agent-surfaces.md +21 -21
  98. package/docs/api.json +3154 -518
  99. package/docs/components/account-menu.md +24 -0
  100. package/docs/components/activity-item.md +23 -0
  101. package/docs/components/activity-list.md +28 -0
  102. package/docs/components/agent-avatar.md +59 -0
  103. package/docs/components/agent-thread.md +275 -0
  104. package/docs/components/app-icon.md +36 -0
  105. package/docs/components/app-sidebar.md +92 -0
  106. package/docs/components/approval-card.md +71 -0
  107. package/docs/components/aurora.md +34 -0
  108. package/docs/components/avatar.md +37 -0
  109. package/docs/components/badge.md +36 -0
  110. package/docs/components/block-view.md +34 -0
  111. package/docs/components/breadcrumb.md +20 -0
  112. package/docs/components/button.md +23 -0
  113. package/docs/components/calendar.md +68 -0
  114. package/docs/components/card-view.md +73 -0
  115. package/docs/components/card.md +25 -0
  116. package/docs/components/chart.md +109 -0
  117. package/docs/components/check-button.md +16 -0
  118. package/docs/components/checklist.md +19 -0
  119. package/docs/components/code-editor.md +38 -0
  120. package/docs/components/composer.md +107 -0
  121. package/docs/components/context-menu.md +32 -0
  122. package/docs/components/copy.md +37 -0
  123. package/docs/components/data-filter.md +16 -0
  124. package/docs/components/date-picker.md +31 -0
  125. package/docs/components/date-range.md +21 -0
  126. package/docs/components/datebox.md +31 -0
  127. package/docs/components/dialog.md +25 -0
  128. package/docs/components/dock.md +57 -0
  129. package/docs/components/dropdown.md +39 -0
  130. package/docs/components/elements.md +63 -0
  131. package/docs/components/empty-state.md +17 -0
  132. package/docs/components/entity-ref.md +26 -0
  133. package/docs/components/field-upload.md +18 -0
  134. package/docs/components/file-item.md +27 -0
  135. package/docs/components/file-list.md +23 -0
  136. package/docs/components/filter-panel.md +45 -0
  137. package/docs/components/filter.md +47 -0
  138. package/docs/components/finder.md +25 -0
  139. package/docs/components/form-widgets.md +42 -0
  140. package/docs/components/form.md +80 -0
  141. package/docs/components/grid.md +26 -0
  142. package/docs/components/groupbox.md +11 -0
  143. package/docs/components/helpers.md +359 -0
  144. package/docs/components/icons.md +87 -0
  145. package/docs/components/index.md +99 -0
  146. package/docs/components/kanban-view.md +42 -0
  147. package/docs/components/kbd.md +23 -0
  148. package/docs/components/kernel.md +41 -0
  149. package/docs/components/launcher.md +66 -0
  150. package/docs/components/layout.md +33 -0
  151. package/docs/components/list-toolbar.md +38 -0
  152. package/docs/components/loading.md +48 -0
  153. package/docs/components/menu-button.md +47 -0
  154. package/docs/components/message.md +76 -0
  155. package/docs/components/modal.md +27 -0
  156. package/docs/components/module-bar.md +71 -0
  157. package/docs/components/multi-value-editor.md +16 -0
  158. package/docs/components/navigation-bar.md +22 -0
  159. package/docs/components/number-field.md +34 -0
  160. package/docs/components/pagination.md +73 -0
  161. package/docs/components/panel.md +28 -0
  162. package/docs/components/prompt-starters.md +40 -0
  163. package/docs/components/prose.md +38 -0
  164. package/docs/components/questionnaire.md +115 -0
  165. package/docs/components/rating.md +19 -0
  166. package/docs/components/run-status.md +50 -0
  167. package/docs/components/run-trace.md +72 -0
  168. package/docs/components/search.md +11 -0
  169. package/docs/components/select.md +129 -0
  170. package/docs/components/sheet-stack.md +39 -0
  171. package/docs/components/sheet.md +77 -0
  172. package/docs/components/skeleton.md +27 -0
  173. package/docs/components/slider.md +29 -0
  174. package/docs/components/sort-control.md +21 -0
  175. package/docs/components/source-list.md +30 -0
  176. package/docs/components/split-view.md +12 -0
  177. package/docs/components/stat-tile.md +49 -0
  178. package/docs/components/stepper.md +27 -0
  179. package/docs/components/surface.md +152 -0
  180. package/docs/components/tabbox.md +33 -0
  181. package/docs/components/table-view.md +43 -0
  182. package/docs/components/table.md +232 -0
  183. package/docs/components/tag-picker.md +39 -0
  184. package/docs/components/timebox.md +16 -0
  185. package/docs/components/toggle.md +21 -0
  186. package/docs/components/tokens.md +82 -0
  187. package/docs/components/toolbar.md +26 -0
  188. package/docs/components/tooltip.md +16 -0
  189. package/docs/components/tree.md +48 -0
  190. package/docs/components/truncate.md +21 -0
  191. package/docs/components/value-list.md +14 -0
  192. package/docs/components/view-settings.md +56 -0
  193. package/docs/components/workspace-switcher.md +42 -0
  194. package/docs/components/zeyos.md +196 -0
  195. package/docs/llms-small.txt +299 -0
  196. package/docs/llms.md +725 -109
  197. package/docs/llms.txt +46 -19
  198. package/package.json +9 -4
  199. package/src/components/activity-item/activity-item.js +21 -2
  200. package/src/components/agent-avatar/agent-avatar.css +195 -0
  201. package/src/components/agent-avatar/agent-avatar.js +333 -0
  202. package/src/components/agent-avatar/agent-face.js +292 -0
  203. package/src/components/agent-thread/ag-ui.js +44 -11
  204. package/src/components/agent-thread/agent-thread.js +103 -11
  205. package/src/components/agent-thread/ui-message-stream.js +3 -1
  206. package/src/components/app-rail/app-rail.css +5 -0
  207. package/src/components/app-sidebar/app-sidebar.css +3 -0
  208. package/src/components/app-sidebar/app-sidebar.js +4 -3
  209. package/src/components/approval-card/approval-card.css +6 -0
  210. package/src/components/approval-card/approval-card.js +55 -7
  211. package/src/components/aurora/aurora.css +149 -14
  212. package/src/components/aurora/aurora.js +49 -6
  213. package/src/components/button/button.css +24 -11
  214. package/src/components/calendar/calendar.css +6 -2
  215. package/src/components/calendar/calendar.js +127 -47
  216. package/src/components/card-view/card-view.js +5 -6
  217. package/src/components/chart/chart.css +159 -1
  218. package/src/components/chart/chart.js +450 -62
  219. package/src/components/chart/color.js +297 -0
  220. package/src/components/chart/svg-adapter.js +576 -0
  221. package/src/components/chart/svg-geometry.js +323 -0
  222. package/src/components/check-button/check-button.js +3 -18
  223. package/src/components/checklist/checklist.css +9 -1
  224. package/src/components/checklist/checklist.js +105 -20
  225. package/src/components/checklist/field-adapter.js +6 -12
  226. package/src/components/code-editor/code-editor.css +33 -0
  227. package/src/components/code-editor/code-editor.js +97 -8
  228. package/src/components/code-editor/field-adapter.js +3 -0
  229. package/src/components/composer/composer.css +3 -0
  230. package/src/components/composer/composer.js +100 -22
  231. package/src/components/context-menu/context-menu.js +41 -5
  232. package/src/components/copy/copy-button.js +9 -1
  233. package/src/components/copy/copy-input.js +5 -0
  234. package/src/components/data-filter/filter-core.js +0 -1
  235. package/src/components/date-picker/date-picker.css +8 -0
  236. package/src/components/date-picker/date-picker.js +47 -8
  237. package/src/components/date-picker/date-range-picker.js +1 -1
  238. package/src/components/date-picker/month-picker.js +19 -3
  239. package/src/components/date-picker/time-picker.js +54 -19
  240. package/src/components/datebox/date-range-box.js +7 -3
  241. package/src/components/datebox/datebox.js +32 -6
  242. package/src/components/dialog/dialog.css +6 -0
  243. package/src/components/dialog/dialog.js +24 -33
  244. package/src/components/dropdown/dropdown.js +1 -18
  245. package/src/components/empty-state/empty-state.js +21 -2
  246. package/src/components/field/field.js +19 -3
  247. package/src/components/fieldset/fieldset.js +3 -1
  248. package/src/components/filter/filter.js +9 -0
  249. package/src/components/form/form.js +19 -2
  250. package/src/components/kanban-view/kanban-card.js +15 -2
  251. package/src/components/kanban-view/kanban-view.css +21 -0
  252. package/src/components/kanban-view/kanban-view.js +29 -16
  253. package/src/components/launcher/launcher.css +14 -0
  254. package/src/components/launcher/launcher.js +54 -9
  255. package/src/components/master-panel/master-panel.js +24 -22
  256. package/src/components/menu-button/menu-button.js +26 -4
  257. package/src/components/message/message.css +228 -29
  258. package/src/components/message/message.js +664 -30
  259. package/src/components/modal/modal.js +129 -30
  260. package/src/components/modal/native-dialog.js +91 -0
  261. package/src/components/module-bar/module-bar.css +3 -0
  262. package/src/components/module-bar/module-bar.js +17 -4
  263. package/src/components/multi-value-editor/multi-value-editor.css +7 -2
  264. package/src/components/multi-value-editor/multi-value-editor.js +3 -2
  265. package/src/components/navigation-bar/navigation-bar.js +13 -1
  266. package/src/components/number-field/field-adapter.js +3 -0
  267. package/src/components/number-field/number-field.js +70 -16
  268. package/src/components/pagination/pagination.css +26 -2
  269. package/src/components/pagination/pagination.js +551 -65
  270. package/src/components/prose/prose.js +7 -1
  271. package/src/components/rating/field-adapter.js +3 -0
  272. package/src/components/run-status/run-status.js +43 -3
  273. package/src/components/run-trace/run-trace.js +15 -7
  274. package/src/components/search/search.js +3 -18
  275. package/src/components/select/field-adapter.js +8 -1
  276. package/src/components/select/select.js +68 -13
  277. package/src/components/sheet/sheet.js +39 -13
  278. package/src/components/slider/field-adapter.js +3 -0
  279. package/src/components/slider/slider.js +4 -6
  280. package/src/components/stat-tile/stat-tile.js +24 -9
  281. package/src/components/stepper/stepper.css +15 -0
  282. package/src/components/stepper/stepper.js +34 -2
  283. package/src/components/surface/catalog.js +185 -28
  284. package/src/components/surface/surface.js +10 -5
  285. package/src/components/tabbox/tabbox.js +13 -1
  286. package/src/components/table/table.css +160 -2
  287. package/src/components/table/table.js +479 -52
  288. package/src/components/table/window.js +46 -4
  289. package/src/components/table-view/table-view.js +1 -10
  290. package/src/components/tag-picker/field-adapter.js +3 -0
  291. package/src/components/tag-picker/tag-picker.js +2 -0
  292. package/src/components/timebox/field-adapter.js +3 -0
  293. package/src/components/toggle/toggle.js +51 -27
  294. package/src/components/tooltip/tooltip.js +21 -14
  295. package/src/components/tree/tree.js +87 -14
  296. package/src/components/truncate/truncate.js +21 -5
  297. package/src/components/value-list/value-list.js +37 -9
  298. package/src/components/view-settings/view-settings.js +1 -5
  299. package/src/core/component.js +34 -2
  300. package/src/core/date.js +5 -4
  301. package/src/core/dom.js +45 -2
  302. package/src/core/drag-axis.js +24 -7
  303. package/src/core/export.js +4 -4
  304. package/src/core/fontawesome.js +34 -3
  305. package/src/core/format.js +3 -1
  306. package/src/core/http.js +23 -11
  307. package/src/core/icons.js +60 -8
  308. package/src/core/keyboard.js +83 -9
  309. package/src/core/messages.js +3 -0
  310. package/src/core/position.js +4 -3
  311. package/src/core/storage.js +80 -31
  312. package/src/core/util.js +16 -5
  313. package/src/elements/define.js +82 -47
  314. package/src/elements/kit.js +46 -35
  315. package/src/index.js +8 -4
  316. package/src/internal/agent-model.js +152 -0
  317. package/src/internal/app-rail.js +53 -2
  318. package/src/internal/collections.js +25 -0
  319. package/src/internal/menu-items.js +59 -0
  320. package/src/internal/overlay-content.js +35 -0
  321. package/src/internal/presence-loop.js +61 -14
  322. package/src/locales/de.js +3 -0
  323. package/src/zeyos/calendar.js +81 -19
  324. package/src/zeyos/connect.js +5 -1
  325. package/src/zeyos/form.js +29 -10
  326. package/src/zeyos/select.js +36 -12
  327. package/src/zeyos/table.js +43 -11
  328. package/src/zeyos/view.js +2 -1
  329. package/styles/tokens/semantic.css +7 -1
  330. package/styles/zx.css +1 -0
@@ -1,5 +1,7 @@
1
1
  import { Component } from '../../core/component.js';
2
2
  export type MessageKind = 'info' | 'success' | 'warning' | 'error';
3
+ export type MessagePlacement = 'top-start' | 'top' | 'top-end' | 'bottom-start' | 'bottom' | 'bottom-end';
4
+ export type MessageHighlight = boolean | 'border' | 'animated';
3
5
  export type MessageAction = {
4
6
  /**
5
7
  * Button text: a verb naming what happens ("Undo", "Approve", "Retry").
@@ -43,10 +45,19 @@ export type MessageShowOptions = {
43
45
  leading?: Node | {
44
46
  toElement: () => Node | null;
45
47
  } | null;
48
+ /**
49
+ * Draws the border in the kind colour (`'border'` or
50
+ * `true`), or sends a light around it (`'animated'`); the default is the area's `highlight`.
51
+ */
52
+ highlight?: MessageHighlight;
46
53
  /**
47
54
  * Element whose nearest Zx theme scope owns a floating toast.
48
55
  */
49
56
  scope?: Element | string | null;
57
+ /**
58
+ * Where a floating toast sits in the viewport; the default is the one set with `Message.setPlacement()`. Messages of one placement share a region. Ignored by an inline area.
59
+ */
60
+ placement?: MessagePlacement;
50
61
  };
51
62
  export type MessageOptions = {
52
63
  /**
@@ -65,6 +76,65 @@ export type MessageOptions = {
65
76
  * Maximum number of visible messages.
66
77
  */
67
78
  maxVisible?: number;
79
+ /**
80
+ * Default highlight of the messages shown here.
81
+ */
82
+ highlight?: MessageHighlight;
83
+ /**
84
+ * Piles the visible messages into one stack, the newest in front
85
+ * and two more peeking out behind it. The stack opens while the pointer is over it or focus is
86
+ * inside it, and a press on it keeps it open until a press outside it or Escape; while it is open
87
+ * by any of these, no message in it times out.
88
+ */
89
+ stack?: boolean;
90
+ /**
91
+ * Keeps a stack open. Its messages still time out.
92
+ */
93
+ expanded?: boolean;
94
+ };
95
+ export type MessageStackLength = {
96
+ /**
97
+ * Measured part, in pixels.
98
+ */
99
+ px: number;
100
+ /**
101
+ * Spacing steps added to it (negative or fractional where it is cut back).
102
+ */
103
+ steps: number;
104
+ };
105
+ export type MessageStackItem = {
106
+ /**
107
+ * Place in the pile, 0 for the front (newest) message, counting back.
108
+ */
109
+ depth: number;
110
+ /**
111
+ * How far the message moves from the stack's edge.
112
+ */
113
+ y: MessageStackLength;
114
+ /**
115
+ * Drawn size, 1 at the front.
116
+ */
117
+ scale: number;
118
+ /**
119
+ * How much is cut from the message's inner edge, in its
120
+ * own unscaled size, so that only the strip peeking out past the message in front of it shows —
121
+ * nothing behind a translucent card shows through it. Null where nothing is cut.
122
+ */
123
+ clip: MessageStackLength | null;
124
+ /**
125
+ * Whether the message is out of sight behind the visible pile.
126
+ */
127
+ hidden: boolean;
128
+ };
129
+ export type MessageStackLayout = {
130
+ /**
131
+ * One per message, the front first.
132
+ */
133
+ items: MessageStackItem[];
134
+ /**
135
+ * The stack's own height.
136
+ */
137
+ size: MessageStackLength;
68
138
  };
69
139
  export type MessageHandle = {
70
140
  /**
@@ -72,7 +142,12 @@ export type MessageHandle = {
72
142
  */
73
143
  close: () => void;
74
144
  };
75
- /** @typedef {'info'|'success'|'warning'|'error'} MessageKind */
145
+ /**
146
+ * How a message stands out beyond its kind icon. `false` draws the plain card; `'border'` (or
147
+ * `true`) draws its border in the kind colour; `'animated'` adds a light that travels around that
148
+ * border — a kind-coloured border where motion is reduced.
149
+ * @typedef {boolean|'border'|'animated'} MessageHighlight
150
+ */
76
151
  /**
77
152
  * The one command a message may carry, drawn as a small button beside its text.
78
153
  * @typedef {Object} MessageAction
@@ -93,7 +168,10 @@ export type MessageHandle = {
93
168
  * @property {Node|{toElement: () => Node|null}|null} [leading=null] Visual shown in place of the
94
169
  * kind icon, such as an Avatar's element. It is decorative — the message text must say what it
95
170
  * shows.
171
+ * @property {MessageHighlight} [highlight=false] Draws the border in the kind colour (`'border'` or
172
+ * `true`), or sends a light around it (`'animated'`); the default is the area's `highlight`.
96
173
  * @property {Element|string|null} [scope=null] Element whose nearest Zx theme scope owns a floating toast.
174
+ * @property {MessagePlacement} [placement='top-end'] Where a floating toast sits in the viewport; the default is the one set with `Message.setPlacement()`. Messages of one placement share a region. Ignored by an inline area.
97
175
  */
98
176
  /**
99
177
  * @typedef {Object} MessageOptions
@@ -101,6 +179,36 @@ export type MessageHandle = {
101
179
  * @property {number} [timeout=4000] Default auto-dismiss delay.
102
180
  * @property {boolean} [closable=true] Default close-button visibility.
103
181
  * @property {number} [maxVisible=5] Maximum number of visible messages.
182
+ * @property {MessageHighlight} [highlight=false] Default highlight of the messages shown here.
183
+ * @property {boolean} [stack=false] Piles the visible messages into one stack, the newest in front
184
+ * and two more peeking out behind it. The stack opens while the pointer is over it or focus is
185
+ * inside it, and a press on it keeps it open until a press outside it or Escape; while it is open
186
+ * by any of these, no message in it times out.
187
+ * @property {boolean} [expanded=false] Keeps a stack open. Its messages still time out.
188
+ */
189
+ /**
190
+ * A length in a stack: measured pixels plus a number of spacing steps, so the spacing stays a
191
+ * theme setting. A step is `--zx-message-gap` in an open stack, the space between two messages,
192
+ * and `--zx-message-peek` in a collapsed one, how far each message behind the front shows.
193
+ * @typedef {Object} MessageStackLength
194
+ * @property {number} px Measured part, in pixels.
195
+ * @property {number} steps Spacing steps added to it (negative or fractional where it is cut back).
196
+ */
197
+ /**
198
+ * Where one message sits in a stack.
199
+ * @typedef {Object} MessageStackItem
200
+ * @property {number} depth Place in the pile, 0 for the front (newest) message, counting back.
201
+ * @property {MessageStackLength} y How far the message moves from the stack's edge.
202
+ * @property {number} scale Drawn size, 1 at the front.
203
+ * @property {MessageStackLength|null} clip How much is cut from the message's inner edge, in its
204
+ * own unscaled size, so that only the strip peeking out past the message in front of it shows —
205
+ * nothing behind a translucent card shows through it. Null where nothing is cut.
206
+ * @property {boolean} hidden Whether the message is out of sight behind the visible pile.
207
+ */
208
+ /**
209
+ * @typedef {Object} MessageStackLayout
210
+ * @property {MessageStackItem[]} items One per message, the front first.
211
+ * @property {MessageStackLength} size The stack's own height.
104
212
  */
105
213
  /**
106
214
  * Returned by every `show()`: closes that message early. Closing one that already closed, or one
@@ -174,7 +282,15 @@ export declare class MessageQueue<T> {
174
282
  }
175
283
  /**
176
284
  * Inline message area and static toast service.
285
+ *
286
+ * With `stack` the visible messages pile up into one card, the newest in front, and the pile
287
+ * opens to show them all — the same for an inline area and a floating region. Floating regions
288
+ * stack by default (`Message.setStack(false)` lists their messages instead); an inline area stacks
289
+ * with `stack: true`. The root then carries `data-stack` and `data-state="collapsed"` or
290
+ * `"expanded"`.
177
291
  * @extends {Component<MessageOptions>}
292
+ * @fires Message#expand
293
+ * @fires Message#collapse
178
294
  */
179
295
  export declare class Message extends Component<MessageOptions> {
180
296
  #private;
@@ -188,11 +304,35 @@ export declare class Message extends Component<MessageOptions> {
188
304
  _floatingHost: Element | null;
189
305
  /** @type {Element|null} Where the floating region was last put: its scope, or the topmost modal. */
190
306
  _placedIn: Element | null;
307
+ /** @type {MessagePlacement|null} The placement this instance is the floating region of. */
308
+ _placement: MessagePlacement | null;
191
309
  /** @type {import('../../core/overlay-stack.js').OverlayHandle|null} The region's toast entry. */
192
310
  _overlay: import('../../core/overlay-stack.js').OverlayHandle | null;
193
311
  /** @type {(() => void)|null} Stops following the overlay stack. */
194
312
  _unfollow: (() => void) | null;
195
313
  _queue: MessageQueue<any>;
314
+ /** @type {any[]} The active messages, oldest first, closing ones until they are gone. */
315
+ _shown: any[];
316
+ /** Activation counter: a newer message paints over an older one in a stack. */
317
+ _seq: number;
318
+ _stack: any;
319
+ /** Stack holds: the pointer is over it, focus is inside it, a press or `expand()` pinned it. */
320
+ _hovered: boolean;
321
+ _focusWithin: boolean;
322
+ _pinned: boolean;
323
+ /** @type {boolean} Whether the timers were last held by the stack. */
324
+ _wasHeld: boolean;
325
+ /** @type {Element|null} Where focus came from when it entered the stack, for Escape. */
326
+ _stackReturn: Element | null;
327
+ /** @type {number} When the stack was last pinned, so the press that pinned it does not unpin it. */
328
+ _pinnedAt: number;
329
+ /** @type {boolean|null} Whether the stack last piled from the foot; null before the first layout. */
330
+ _pileFromEnd: boolean | null;
331
+ /** Set while messages are moved, so the focus they lose and regain is not read as leaving. */
332
+ _reordering: boolean;
333
+ _resizeObserver: ResizeObserver;
334
+ /** @type {boolean} What the last `expand`/`collapse` event said. */
335
+ _wasExpanded: boolean;
196
336
  _cleaned: boolean;
197
337
  static cssName: string;
198
338
  /** @type {Readonly<MessageOptions>} */
@@ -244,30 +384,97 @@ export declare class Message extends Component<MessageOptions> {
244
384
  /**
245
385
  * Shows a floating progress status.
246
386
  * @param {string} text Initial status text.
247
- * @param {{scope?: Element|string|null}} [options={}] Floating-region scope.
387
+ * @param {{scope?: Element|string|null, placement?: MessagePlacement, highlight?: MessageHighlight}} [options={}]
388
+ * Floating-region scope and placement, and the message's highlight.
248
389
  * @returns {ProgressHandle}
249
390
  */
250
391
  static progress(text: string, options?: {
251
392
  scope?: Element | string | null;
393
+ placement?: MessagePlacement;
394
+ highlight?: MessageHighlight;
252
395
  }): ProgressHandle;
396
+ /**
397
+ * Sets whether floating regions stack their messages (see the `stack` option); they do by
398
+ * default, and `false` lists them one below another instead. Unlike a placement it applies at
399
+ * once, to the regions on screen as well as those to come.
400
+ * @param {boolean} enabled Whether to stack.
401
+ * @returns {boolean} Whether floating regions stack now.
402
+ */
403
+ static setStack(enabled: boolean): boolean;
404
+ /**
405
+ * Returns whether floating regions stack their messages, true unless `setStack(false)` was called.
406
+ * @returns {boolean}
407
+ */
408
+ static getStack(): boolean;
409
+ /**
410
+ * Sets where floating messages appear when a call names no `placement`. It applies to messages
411
+ * shown from then on; a region already on screen stays where it is until its last toast closes.
412
+ *
413
+ * The region carries the placement as `data-placement`, and its distance from the viewport edge
414
+ * is the `--zx-message-offset` custom property (default `var(--zx-space-4)`), read from the
415
+ * region's theme scope. At 640px and narrower every placement spans the foot of the viewport.
416
+ * @param {MessagePlacement} placement One of `'top-start'`, `'top'`, `'top-end'`, `'bottom-start'`,
417
+ * `'bottom'`, `'bottom-end'`; anything else restores `'top-end'`.
418
+ * @returns {MessagePlacement} The placement now in effect.
419
+ */
420
+ static setPlacement(placement: MessagePlacement): MessagePlacement;
421
+ /**
422
+ * Returns where floating messages appear when a call names no `placement`.
423
+ * @returns {MessagePlacement}
424
+ */
425
+ static getPlacement(): MessagePlacement;
253
426
  /**
254
427
  * Removes a floating region at once, toasts and all, without waiting for them to time out.
255
428
  *
256
429
  * A region already removes itself when its last toast closes, and one whose host has left the
257
430
  * document is replaced on the next toast, so this is only for a host being torn down while
258
431
  * toasts are still showing — an application view unmounting its themed shell, say.
432
+ *
433
+ * A scope has one region per placement in use; all of them are removed.
259
434
  * @param {Element|string} scope Element or selector whose nearest Zx theme scope owns the region,
260
435
  * as passed to `show()`.
261
436
  * @returns {boolean} Whether there was a region to remove.
262
437
  */
263
438
  static disposeRegion(scope: Element | string): boolean;
439
+ /**
440
+ * Turns stacking on or off for this area or region (see the `stack` option). The messages on
441
+ * screen move into the pile, or back into a list, where they are.
442
+ * @param {boolean} enabled Whether to stack.
443
+ * @returns {this}
444
+ */
445
+ setStack(enabled: boolean): this;
446
+ /**
447
+ * Opens a stack and keeps it open until `collapse()`, Escape, or a press outside it. Does
448
+ * nothing without `stack`.
449
+ * @returns {this}
450
+ * @fires Message#expand
451
+ */
452
+ expand(): this;
453
+ /**
454
+ * Closes a stack opened by a press, `expand()`, or the pointer. A stack holding focus stays open
455
+ * until focus leaves it, and one with `expanded: true` never closes.
456
+ * @returns {this}
457
+ * @fires Message#collapse
458
+ */
459
+ collapse(): this;
460
+ /**
461
+ * Reports whether the stack is open. Always false without `stack`.
462
+ * @returns {boolean}
463
+ */
464
+ isExpanded(): boolean;
264
465
  /** @returns {void} */
265
466
  destroy(): void;
266
- /** @param {string} text @returns {ProgressHandle} */
267
- _progress(text: string): ProgressHandle;
467
+ /**
468
+ * @param {string} text
469
+ * @param {{highlight?: MessageHighlight}} [options={}]
470
+ * @returns {ProgressHandle}
471
+ */
472
+ _progress(text: string, options?: {
473
+ highlight?: MessageHighlight;
474
+ }): ProgressHandle;
268
475
  /**
269
476
  * @param {string|Node} msg
270
- * @param {{kind: MessageKind, timeout: number, closable: boolean, action?: MessageAction|null, leading?: Node|null}} settings
477
+ * @param {{kind: MessageKind, timeout: number, closable: boolean, action?: MessageAction|null, leading?: Node|null, highlight?: 'border'|'animated'|null}} settings
271
478
  * @param {{pct: number, text: string}|null} [progress=null]
272
479
  * @returns {any}
273
480
  */
@@ -277,6 +484,7 @@ export declare class Message extends Component<MessageOptions> {
277
484
  closable: boolean;
278
485
  action?: MessageAction | null;
279
486
  leading?: Node | null;
487
+ highlight?: 'border' | 'animated' | null;
280
488
  }, progress?: {
281
489
  pct: number;
282
490
  text: string;
@@ -293,6 +501,64 @@ export declare class Message extends Component<MessageOptions> {
293
501
  _close(entry: any): void;
294
502
  /** @param {any} entry @returns {void} */
295
503
  _finish(entry: any): void;
504
+ /**
505
+ * Whether a stack holds every timer: it is open because someone is looking at it.
506
+ * @returns {boolean}
507
+ */
508
+ _held(): boolean;
509
+ /**
510
+ * Whether the stack piles from the foot: a bottom placement, or any placement on a phone. Read
511
+ * from the region's `--zx-message-dir`, which the stylesheet sets for both.
512
+ * @returns {boolean}
513
+ */
514
+ _fromEnd(): boolean;
515
+ /**
516
+ * Puts the messages in document order: oldest first, or newest first in a stack that piles from
517
+ * the top. Moves only when the order is wrong. A moved message keeps focus, and does not play
518
+ * its entrance again (`data-entered`).
519
+ * @param {boolean} [fromEnd] Whether the stack piles from the foot, when already known.
520
+ * @returns {void}
521
+ */
522
+ _order(fromEnd?: boolean): void;
523
+ /**
524
+ * Moves focus off a message that is closing with focus inside it. In a stack it goes to the
525
+ * same control of the next message (the one before, for the last), so a keyboard reader closes
526
+ * one message after another without leaving the stack; from the stack's last message it goes
527
+ * back to where it was before it came into the stack. A list hands it back to where it was
528
+ * before it came into the message.
529
+ * @param {any} entry Closing message.
530
+ * @returns {void}
531
+ */
532
+ _handOffFocus(entry: any): void;
533
+ /**
534
+ * Settles a stack after anything that may open or close it: holds or releases the timers,
535
+ * lays the messages out, and reports a change of state.
536
+ * @returns {void}
537
+ */
538
+ _refreshStack(): void;
539
+ /**
540
+ * Lays a stack out from its messages' measured heights: each one's place, size, and clip, and
541
+ * the stack's own height. Runs again whenever a message changes size.
542
+ * @returns {void}
543
+ */
544
+ _syncStack(): void;
545
+ /**
546
+ * An open floating stack taller than the viewport becomes a list that scrolls
547
+ * (`data-overflow`), the newest message in view, so every message stays reachable. An inline
548
+ * stack grows with the page and never needs it.
549
+ * @param {boolean} expanded Whether the stack is open.
550
+ * @param {MessageStackLength} size The open stack's height.
551
+ * @param {boolean} fromEnd Whether it piles from the foot.
552
+ * @returns {void}
553
+ */
554
+ _syncOverflow(expanded: boolean, size: MessageStackLength, fromEnd: boolean): void;
555
+ /**
556
+ * Wires the ways a stack opens and closes: pointer over it, focus inside it, a press on it (a
557
+ * tap included) that keeps it open until a press outside it, and Escape.
558
+ * @param {HTMLElement} root
559
+ * @returns {void}
560
+ */
561
+ _listenStack(root: HTMLElement): void;
296
562
  /**
297
563
  * Takes a floating region out of the document once its last toast has gone, so an emptied host
298
564
  * is not left holding a region nobody uses. Inline areas stay: their element is the caller's.
@@ -319,6 +585,32 @@ export declare class Message extends Component<MessageOptions> {
319
585
  */
320
586
  _message(key: string, fallback: string): string;
321
587
  }
588
+ /**
589
+ * Settles a floating-message placement: the value when it is one of the six, the fallback otherwise.
590
+ * @param {unknown} value Requested placement.
591
+ * @param {MessagePlacement} [fallback='top-end'] Placement used when the value is absent or unknown.
592
+ * @returns {MessagePlacement}
593
+ */
594
+ export declare function normalizeMessagePlacement(value: unknown, fallback?: MessagePlacement): MessagePlacement;
595
+ /**
596
+ * Settles a message highlight: `'border'` for `true` or `'border'`, `'animated'` for `'animated'`,
597
+ * and null — the plain card — for anything else.
598
+ * @param {unknown} value Requested highlight.
599
+ * @returns {'border'|'animated'|null}
600
+ */
601
+ export declare function normalizeMessageHighlight(value: unknown): 'border' | 'animated' | null;
602
+ /**
603
+ * Lays out a stack of messages from their heights, the front (newest) first.
604
+ *
605
+ * Open, the messages follow one another from the stack's edge. Collapsed, the front one sits at
606
+ * the edge and the next two peek out behind it: each lined up with the front one's far edge, one
607
+ * peek further out, a step smaller, and cut down to the strip that shows below the one in front of
608
+ * it. The rest wait out of sight behind them.
609
+ * @param {number[]} heights Height of each message in pixels, the front first.
610
+ * @param {boolean} expanded Whether the stack is open.
611
+ * @returns {MessageStackLayout}
612
+ */
613
+ export declare function messageStackLayout(heights: number[], expanded: boolean): MessageStackLayout;
322
614
  /**
323
615
  * Settles how long a message stays. A message that carries an action stays at least
324
616
  * `MESSAGE_ACTION_MIN_TIMEOUT`, so there is time to reach it; zero still means it stays until
@@ -340,3 +632,14 @@ export declare function normalizeMessageAction(value: unknown): {
340
632
  kind: 'default' | 'primary' | 'danger' | 'ghost';
341
633
  onclick: ((event: MouseEvent) => void) | null;
342
634
  } | null;
635
+ /**
636
+ * Fired when a stack opens: the pointer came over it, focus came into it, it was pressed, or
637
+ * `expand()` was called.
638
+ * @event Message#expand
639
+ * @type {CustomEvent<Record<string, never>>}
640
+ */
641
+ /**
642
+ * Fired when a stack closes again.
643
+ * @event Message#collapse
644
+ * @type {CustomEvent<Record<string, never>>}
645
+ */
@@ -15,7 +15,8 @@ export type ModalOptions = {
15
15
  */
16
16
  closable?: boolean;
17
17
  /**
18
- * Whether a backdrop click closes the modal.
18
+ * Whether a backdrop click closes the modal. Like every
19
+ * dismissal by the reader, it raises a preventable `cancel` first.
19
20
  */
20
21
  lightDismiss?: boolean;
21
22
  /**
@@ -39,20 +40,32 @@ export type ModalOptions = {
39
40
  /**
40
41
  * Cancel event listener.
41
42
  */
42
- oncancel?: (event: CustomEvent<Record<string, never>>) => void;
43
+ oncancel?: (event: CustomEvent<ModalCancelDetail>) => void;
44
+ };
45
+ export type ModalDismissReason = 'escape' | 'close-button' | 'button' | 'backdrop' | 'outside' | 'drag';
46
+ export type ModalCancelDetail = {
47
+ reason: ModalDismissReason;
43
48
  };
44
49
  /**
45
50
  * @typedef {Object} ModalOptions
46
51
  * @property {Node|string|number|{toElement: () => Node|null}|null} [content=null] Modal content.
47
52
  * @property {string|number} [width='auto'] CSS width, or a pixel width when numeric.
48
53
  * @property {boolean} [closable=true] Whether Escape may close the modal.
49
- * @property {boolean} [lightDismiss=false] Whether a backdrop click closes the modal.
54
+ * @property {boolean} [lightDismiss=false] Whether a backdrop click closes the modal. Like every
55
+ * dismissal by the reader, it raises a preventable `cancel` first.
50
56
  * @property {boolean} [destroyOnClose=false] Whether to destroy the modal after it closes.
51
57
  * @property {Element|string|null} [scope=null] Element whose nearest Zx theme scope owns the overlay; defaults to the opener. Resolved on every open, so a scope connected after construction still owns it.
52
58
  * @property {(event: CustomEvent<Record<string, never>>) => void} [onopen] Open event listener.
53
59
  * @property {(event: CustomEvent<{result: unknown}>) => void} [onclose] Close event listener.
54
- * @property {(event: CustomEvent<Record<string, never>>) => void} [oncancel] Cancel event listener.
60
+ * @property {(event: CustomEvent<ModalCancelDetail>) => void} [oncancel] Cancel event listener.
61
+ */
62
+ /**
63
+ * What the reader did to ask for dismissal: pressed Escape, used a header close button, chose a
64
+ * footer button whose action is `'cancel'`, clicked the backdrop, pressed outside a non-modal
65
+ * overlay, or dragged it away.
66
+ * @typedef {'escape'|'close-button'|'button'|'backdrop'|'outside'|'drag'} ModalDismissReason
55
67
  */
68
+ /** @typedef {{reason: ModalDismissReason}} ModalCancelDetail */
56
69
  /**
57
70
  * Thin native-dialog overlay with lifecycle-safe content and dismissal behavior.
58
71
  * The constructor always creates and appends a new dialog; its target argument is ignored.
@@ -92,9 +105,20 @@ export declare class Modal extends Component<ModalOptions> {
92
105
  mountTarget(): Element;
93
106
  /**
94
107
  * Puts the dialog on screen. Overridden by subclasses that open non-modally.
108
+ *
109
+ * Where the platform has no `showModal()` — a DOM implementation used for unit tests — the dialog
110
+ * is presented through its `open` attribute instead: no top layer and no inertness, but `open()`,
111
+ * `close()`, Escape and the lifecycle events behave the same.
95
112
  * @returns {void}
96
113
  */
97
114
  _show(): void;
115
+ /**
116
+ * Whether the current presentation is the modal one: the platform's `:modal`, or the `open`
117
+ * attribute standing in for `showModal()` where that is missing.
118
+ * @returns {boolean}
119
+ * @protected
120
+ */
121
+ protected _isModal(): boolean;
98
122
  /**
99
123
  * Removes the dialog from its current presentation layer.
100
124
  * Subclasses may replace native dialog presentation while preserving Modal lifecycle events.
@@ -114,12 +138,23 @@ export declare class Modal extends Component<ModalOptions> {
114
138
  * Describes the current presentation for the overlay stack, or returns null to stay off it.
115
139
  *
116
140
  * The kind is read from the platform like `aria-modal` is: a `showModal()` dialog is `modal`,
117
- * and its Escape and backdrop stay the browser's; anything else is `non-modal`, and a subclass
118
- * presenting that way adds the Escape and outside-press handling it wants.
141
+ * and the stack leaves its Escape alone (this class answers it, see the constructor); anything
142
+ * else is `non-modal`, and a subclass presenting that way adds the Escape and outside-press
143
+ * handling it wants.
119
144
  * @returns {import('../../core/overlay-stack.js').OverlayEntryOptions|null}
120
145
  * @protected
121
146
  */
122
147
  protected _overlayEntry(): import('../../core/overlay-stack.js').OverlayEntryOptions | null;
148
+ /**
149
+ * Asks to close on the reader's behalf: emits a preventable `cancel` naming what they did, and
150
+ * closes unless a listener prevented it. Every dismissal gesture goes through here; `close()`
151
+ * itself stays unconditional, for the application's own decisions.
152
+ * @param {ModalDismissReason} reason What the reader did.
153
+ * @returns {boolean} Whether the overlay is closing.
154
+ * @fires Modal#cancel
155
+ * @protected
156
+ */
157
+ protected _requestDismiss(reason: ModalDismissReason): boolean;
123
158
  /**
124
159
  * Re-registers the current presentation on the overlay stack: called after every presentation,
125
160
  * including a subclass's change of address that bypasses `open()`.
@@ -237,9 +272,11 @@ export declare class Modal extends Component<ModalOptions> {
237
272
  * @type {CustomEvent<{result: unknown}>}
238
273
  */
239
274
  /**
240
- * Fired when Escape requests cancellation. Preventing it keeps the modal open.
275
+ * Fired when the reader asks to dismiss the modal — Escape, a header close button, a `'cancel'`
276
+ * footer button, a backdrop click, a press outside a non-modal overlay, a drag — with the gesture
277
+ * in `detail.reason`. Preventing it keeps the modal open. A programmatic `close()` does not raise it.
241
278
  * @event Modal#cancel
242
- * @type {CustomEvent<Record<string, never>>}
279
+ * @type {CustomEvent<ModalCancelDetail>}
243
280
  */
244
281
  /**
245
282
  * Picks the control initial focus belongs on inside an overlay panel: an `autofocus` control when
@@ -0,0 +1,40 @@
1
+ /**
2
+ * Asks a state pseudo-class of an element. A selector engine that does not know `:modal` or
3
+ * `:popover-open` throws on it; there the element is in neither state.
4
+ * @param {Element|null|undefined} element Element to ask.
5
+ * @param {string} selector A selector such as `':modal'` or `':popover-open'`.
6
+ * @returns {boolean}
7
+ */
8
+ export declare function matchesState(element: Element | null | undefined, selector: string): boolean;
9
+ /**
10
+ * The open modal dialogs of a document, in document order; empty where `:modal` is unknown.
11
+ * @param {Document} doc Document to search.
12
+ * @returns {Element[]}
13
+ */
14
+ export declare function modalDialogs(doc: Document): Element[];
15
+ /**
16
+ * Whether a dialog is presented, by the reflected `open` property or the attribute itself.
17
+ * @param {Element} dialog Dialog element.
18
+ * @returns {boolean}
19
+ */
20
+ export declare function isDialogOpen(dialog: Element): boolean;
21
+ /**
22
+ * Presents a dialog modally with `showModal()`, or with the `open` attribute where it is missing.
23
+ * @param {Element} dialog Dialog element.
24
+ * @returns {boolean} Whether the platform presented it; false for the attribute fallback.
25
+ */
26
+ export declare function showDialogModal(dialog: Element): boolean;
27
+ /**
28
+ * Presents a dialog non-modally with `show()`, or with the `open` attribute where it is missing.
29
+ * @param {Element} dialog Dialog element.
30
+ * @returns {void}
31
+ */
32
+ export declare function showDialog(dialog: Element): void;
33
+ /**
34
+ * Closes a dialog with `close()`. Where it is missing the `open` attribute is removed and the
35
+ * `close` event the platform would queue is queued here, so one listener settles both.
36
+ * @param {Element} dialog Dialog element.
37
+ * @param {string} [result] Native string return value.
38
+ * @returns {void}
39
+ */
40
+ export declare function closeDialog(dialog: Element, result?: string): void;
@@ -19,6 +19,13 @@ export type ModuleItem = {
19
19
  icon?: string | Node | {
20
20
  toElement: () => Node | null;
21
21
  } | ((context: Record<string, any>, item: AppNavItem) => Node | null);
22
+ /**
23
+ * Draws the module as an
24
+ * agent: an AgentAvatar in place of the tile, whatever the `appearance`, at rest, with its
25
+ * activity's word in the tile's accessible name. `tone` and `color` then do not apply; the
26
+ * avatar's own `tone` does.
27
+ */
28
+ agent?: import('../../internal/app-rail.js').AppNavAgent | true;
22
29
  /**
23
30
  * Identity colour from the theme's categorical tones.
24
31
  */
@@ -277,8 +284,8 @@ export declare class ModuleBar extends AppRailPresenter {
277
284
  focus(): this;
278
285
  /** Destroys flyouts, tooltips, and the catalogue, and restores or removes the root. @returns {void} */
279
286
  destroy(): void;
280
- /** @param {Node|null} node @returns {boolean} @private */
281
- private _containsNode;
287
+ /** @param {Node|null} node @returns {boolean} @protected */
288
+ protected _containsNode(node: Node | null): boolean;
282
289
  /** @returns {void} */
283
290
  _clearArtifacts(): void;
284
291
  /** @param {AppNavItem} item @returns {boolean} */
@@ -25,6 +25,7 @@ export type MultiValueEditorOptions = {
25
25
  values: string[];
26
26
  }>) => void;
27
27
  };
28
+ export type MultiValueEditorPart = 'value' | 'handle' | 'up' | 'down';
28
29
  /**
29
30
  * Ordered value editor with explicit editable rows and controls.
30
31
  *
@@ -69,10 +70,10 @@ export declare class MultiValueEditor extends Component<MultiValueEditorOptions>
69
70
  };
70
71
  /**
71
72
  * @param {number} [focusIndex=-1] Row to focus after the render, or -1 for none.
72
- * @param {keyof PARTS} [focusPart='value'] Which control of that row takes focus.
73
+ * @param {MultiValueEditorPart} [focusPart='value'] Which control of that row takes focus.
73
74
  * @returns {void}
74
75
  */
75
- _renderRows(focusIndex?: number, focusPart?: keyof PARTS): void;
76
+ _renderRows(focusIndex?: number, focusPart?: MultiValueEditorPart): void;
76
77
  /** @param {MouseEvent} event @returns {void} */
77
78
  _handleClick(event: MouseEvent): void;
78
79
  /** @param {Event} event @returns {void} */
@@ -116,10 +117,10 @@ export declare class MultiValueEditor extends Component<MultiValueEditorOptions>
116
117
  /**
117
118
  * @param {number} from Index to move.
118
119
  * @param {number} to Destination index.
119
- * @param {keyof PARTS} part Control of the moved row that takes focus.
120
+ * @param {MultiValueEditorPart} part Control of the moved row that takes focus.
120
121
  * @returns {boolean} Whether anything moved.
121
122
  */
122
- _move(from: number, to: number, part: keyof PARTS): boolean;
123
+ _move(from: number, to: number, part: MultiValueEditorPart): boolean;
123
124
  /** @returns {void} */
124
125
  _emitChange(): void;
125
126
  /** @returns {void} */