@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
@@ -16,7 +16,8 @@ export type DragAxisOptions = {
16
16
  onStart?: (event: PointerEvent) => boolean | void;
17
17
  /**
18
18
  * Called at most once per frame with the signed pixel
19
- * distance travelled along the axis since pointer-down.
19
+ * distance travelled along the axis since pointer-down. A horizontal distance is logical: positive
20
+ * towards the inline end, which is leftwards when the handle's computed `direction` is `rtl`.
20
21
  */
21
22
  onMove: (delta: number) => void;
22
23
  /**
@@ -26,7 +27,8 @@ export type DragAxisOptions = {
26
27
  onEnd?: (delta: number, moved: boolean) => void;
27
28
  /**
28
29
  * Called for an arrow key along the
29
- * axis. `large` is true while Shift is held.
30
+ * axis. `large` is true while Shift is held. `1` is ArrowDown, or towards the inline end:
31
+ * ArrowRight, and ArrowLeft under `rtl`, so the handle moves the way the arrow points.
30
32
  */
31
33
  onStep?: (direction: -1 | 1, large: boolean) => void;
32
34
  /**
@@ -65,11 +67,13 @@ export type DragAxisController = {
65
67
  * drag begins. Return `false` to refuse it — the usual reason being that there is nothing to
66
68
  * resize on either side of the handle.
67
69
  * @property {(delta: number) => void} onMove Called at most once per frame with the signed pixel
68
- * distance travelled along the axis since pointer-down.
70
+ * distance travelled along the axis since pointer-down. A horizontal distance is logical: positive
71
+ * towards the inline end, which is leftwards when the handle's computed `direction` is `rtl`.
69
72
  * @property {(delta: number, moved: boolean) => void} [onEnd] Called once the pointer is released.
70
73
  * `moved` is false for a press that never travelled, which is a click rather than a drag.
71
74
  * @property {(direction: -1|1, large: boolean) => void} [onStep] Called for an arrow key along the
72
- * axis. `large` is true while Shift is held.
75
+ * axis. `large` is true while Shift is held. `1` is ArrowDown, or towards the inline end:
76
+ * ArrowRight, and ArrowLeft under `rtl`, so the handle moves the way the arrow points.
73
77
  * @property {(edge: 'min'|'max') => void} [onJump] Called for Home and End.
74
78
  * @property {() => void} [onActivate] Called for Enter and Space, which components use for the
75
79
  * collapse affordance a splitter is expected to offer.
@@ -91,7 +95,8 @@ export type DragAxisController = {
91
95
  * sheet grows in the opposite direction depending on which edge it is attached to. What they do
92
96
  * share is the fiddly part — pointer capture that survives the pointer leaving the handle, one
93
97
  * write per frame however fast the pointer reports, telling a click apart from a zero-distance
94
- * drag, and the WAI-ARIA keyboard map.
98
+ * drag, and the WAI-ARIA keyboard map. Its distances are logical, like the layouts it serves:
99
+ * under `dir="rtl"` a horizontal handle mirrors both the pointer and the arrow keys.
95
100
  *
96
101
  * @param {Element} handle Element the pointer grabs; also the keyboard target.
97
102
  * @param {DragAxisOptions} options Axis and callbacks.
@@ -43,8 +43,8 @@ export type DownloadOptions = {
43
43
  *
44
44
  * Fields containing the delimiter, a double quote, CR, or LF are quoted with inner quotes doubled.
45
45
  * Dates become ISO strings, null and undefined become empty fields, and text that starts with
46
- * `=`, `+`, `-`, or `@` is prefixed with a tab so spreadsheets treat it as text rather than a
47
- * formula. Numbers are never prefixed, so negative amounts survive intact.
46
+ * `=`, `+`, `-`, `@`, a tab, or a carriage return is prefixed with a tab so spreadsheets treat it
47
+ * as text rather than a formula. Numbers are never prefixed, so negative amounts survive intact.
48
48
  *
49
49
  * @param {Iterable<any>|null|undefined} rows Row objects.
50
50
  * @param {Array<string|CsvColumn>} columns Column ids, or descriptors with a label and accessor.
@@ -56,7 +56,9 @@ export type FileSizeFormatOptions = {
56
56
  };
57
57
  export type RelativeTimeFormatOptions = {
58
58
  /**
59
- * Reference point the date is measured against.
59
+ * Reference point the date is measured against: a
60
+ * Date, a Unix timestamp in seconds (not milliseconds — wrap `Date.now()` in a Date), or a date
61
+ * string, read the same way as the date itself.
60
62
  */
61
63
  now?: Date | number | string;
62
64
  /**
@@ -68,10 +68,32 @@ export type IconGlyph = [string, string] | [string, string, IconPaint];
68
68
  * The bundled glyph set: outline icons from Lucide (ISC; see the notice above), embedded as path
69
69
  * data so the library carries no webfont, stylesheet, or package dependency. Every entry is
70
70
  * `[viewBox, path, 'stroke']` in a 24-unit view box. Extend the set with `registerIcons()`; read
71
- * every available name with `iconNames()`.
71
+ * every available name with `iconNames()`, and the other names a glyph answers to in `iconAliases`.
72
72
  * @type {Readonly<Record<string, IconGlyph>>}
73
73
  */
74
74
  export declare const icons: Readonly<Record<string, IconGlyph>>;
75
+ /**
76
+ * Other names for bundled glyphs, as `alias → bundled name`: legacy gx Factory names, and the
77
+ * older Font Awesome names (`archive`, `edit`) that are still the ones most code reaches for.
78
+ *
79
+ * | Alias | Renders |
80
+ * | --- | --- |
81
+ * | `archive` | `box-archive` |
82
+ * | `edit` | `pen-to-square` |
83
+ * | `settings` | `gear` |
84
+ * | `clear` | `x` |
85
+ * | `checked` | `check` |
86
+ * | `question` | `info` |
87
+ * | `range` | `filter` |
88
+ * | `fields` | `list` |
89
+ * | `grid` | `table-cells-large` |
90
+ *
91
+ * `icon()` accepts an alias wherever it accepts the bundled name, under either renderer, and
92
+ * `iconNames()` lists them. A glyph an application registered under the alias itself takes
93
+ * precedence (see `icon()`); the table is frozen, so that registration is how an alias is changed.
94
+ * @type {Readonly<Record<string, string>>}
95
+ */
96
+ export declare const iconAliases: Readonly<Record<string, string>>;
75
97
  export type IconConfig = {
76
98
  /**
77
99
  * Renderer used for bare icon names.
@@ -146,7 +168,16 @@ export declare function loadFontAwesome(options: string | (Partial<Omit<IconConf
146
168
  */
147
169
  export declare function registerIcons(glyphs: Record<string, IconGlyph>): void;
148
170
  /**
149
- * Lists every inline SVG glyph name available, built-in and registered.
171
+ * Lists every name `icon()` renders as an inline SVG glyph: the bundled set, the glyphs added with
172
+ * `registerIcons()`, and the aliases in `iconAliases`. The two agree — a name listed here renders
173
+ * a glyph, and a bare name that is not listed renders the placeholder (or throws with
174
+ * `{ strict: true }`). Font Awesome is not part of the answer: it resolves names in the browser,
175
+ * so under that renderer any name may draw.
176
+ *
177
+ * An alias is listed beside the glyph it draws, so the list holds more names than glyphs. For one
178
+ * entry per glyph — an icon gallery — leave the aliases out:
179
+ *
180
+ * iconNames().filter((name) => !Object.hasOwn(iconAliases, name));
150
181
  * @returns {string[]} Sorted icon names.
151
182
  */
152
183
  export declare function iconNames(): string[];
@@ -154,7 +185,9 @@ export declare function iconNames(): string[];
154
185
  * Creates an icon element.
155
186
  *
156
187
  * Bare names (`'check'`) render through the active provider: the bundled inline SVG set by
157
- * default, or Font Awesome after `useFontAwesome()` / `loadFontAwesome()`. A name can also select
188
+ * default, or Font Awesome after `useFontAwesome()` / `loadFontAwesome()`. A bare name may be an
189
+ * alias from `iconAliases` (`'edit'` draws `pen-to-square`, `'settings'` draws `gear`); a glyph
190
+ * registered under the alias name wins over the alias. A name can also select
158
191
  * its renderer itself — `'fa:user'`, `'duotone:user'`, `'kit:zeyos-notes'`, `'builtin:check'`, or
159
192
  * a literal Font Awesome class list such as `'fa-solid fa-user'`.
160
193
  *
@@ -72,10 +72,14 @@ export declare function focusTrap(container: Element): FocusTrapController;
72
72
  * the neighbouring item, so a reader is never trapped in it. Under `dir="rtl"` the horizontal
73
73
  * arrows follow the visual order.
74
74
  *
75
+ * An item is skipped while it is hidden, disabled, or `aria-hidden`, while an element between it
76
+ * and the container is `hidden` or `inert`, and — once the container is rendered — while it is not
77
+ * rendered itself. A group built detached or hidden still initializes from its attributes alone.
78
+ *
75
79
  * The group re-reads its items when children are added or removed and when an availability
76
- * attribute (`hidden`, `disabled`, `aria-disabled`, `aria-hidden`) changes on an item or on an
77
- * element inside the container that holds items — a `<fieldset disabled>` toggled around them; its
78
- * own `tabindex` writes and unrelated attribute churn are not observed.
80
+ * attribute (`hidden`, `inert`, `disabled`, `aria-disabled`, `aria-hidden`) changes on an item or
81
+ * on an element inside the container that holds items — a `<fieldset disabled>` toggled around
82
+ * them; its own `tabindex` writes and unrelated attribute churn are not observed.
79
83
  * @param {Element} container Event and query container.
80
84
  * @param {string} itemSelector Selector for roving items.
81
85
  * @param {RovingOptions} [options={}] Behavior options.
@@ -533,6 +533,9 @@ export declare const defaultMessages: Readonly<{
533
533
  'navigationBar.more': "More";
534
534
  'navigationBar.primary': "Primary navigation";
535
535
  'numberField.empty': "Empty";
536
+ 'pagination.auto': "Auto";
537
+ 'pagination.autoLoad': "Auto-load";
538
+ 'pagination.autoSize': "Auto (%1)";
536
539
  'pagination.empty': "0 of 0";
537
540
  'pagination.label': "Pagination";
538
541
  'pagination.loaded': "%1 of %2";
@@ -40,9 +40,10 @@ export type NamespacedStorage = {
40
40
  * Keys use `zx2:<namespace length>:<namespace>:<key>`, so namespaces cannot overlap. Existing
41
41
  * `zx:` keys are copied only when explicitly requested through `migrateLegacy(keys)`; they are
42
42
  * never deleted. `clear()` only touches the current namespace. When the storage area is
43
- * unavailable or refuses a write — private browsing, a full quota, cookies disabled — the view
44
- * transparently falls back to an in-memory map that lives as long as the page, so callers never
45
- * need a try/catch and never see an exception.
43
+ * unavailable or refuses a write — private browsing, a full quota, cookies disabled — the value
44
+ * goes to an in-memory map that lives as long as the page and is shared by every view of the same
45
+ * area, so callers never need a try/catch and never see an exception. A refused write affects only
46
+ * that value: everything else is still read from, and written to, the real storage area.
46
47
  *
47
48
  * @param {string} namespace Namespace segment, typically an application or feature name.
48
49
  * @param {StorageOptions} [options={}] Area selection.
@@ -39,7 +39,9 @@ export declare function throttle<T extends (...args: any[]) => any>(fn: T, ms: n
39
39
  export declare function uid(prefix?: string): string;
40
40
  /**
41
41
  * Recursively merges plain objects without mutating either input.
42
- * Arrays and other values are replaced rather than merged.
42
+ * Arrays and other values are replaced rather than merged. Only own enumerable keys are copied,
43
+ * each as an own data property, so a `__proto__` key from parsed JSON stays an ordinary key and
44
+ * never changes the result's prototype.
43
45
  * @template T
44
46
  * @template U
45
47
  * @param {T} a Base value.
@@ -17,8 +17,7 @@ export type ElementWrapperOptions = {
17
17
  */
18
18
  events?: string[] | null;
19
19
  /**
20
- * Component methods the element forwards. Declared,
21
- * the element also carries its live values across a rebuild and across removal.
20
+ * Component methods the element forwards.
22
21
  */
23
22
  methods?: ElementMethodMap | null;
24
23
  };
@@ -27,6 +26,10 @@ export type ElementWrapperOptions = {
27
26
  * Groupbox and Dialog wrappers adopt their host's initial children as component content;
28
27
  * other wrappers leave unrelated host children untouched and append their component root.
29
28
  *
29
+ * Every wrapper carries its component's live values — what the user selected, typed, checked, or
30
+ * opened — across a rebuild (an attribute that needs a new component changed) and across removal
31
+ * and reinsertion, so moving the element keeps its state.
32
+ *
30
33
  * A wrapper that declares `methods` forwards them: `element.upsert(item)` calls the component, and
31
34
  * a call made while no component exists is queued and runs, in order, once it does. A forwarded
32
35
  * call returns the component's answer, with the component itself replaced by the element; a
@@ -16,7 +16,7 @@ export { Http, zeyosService, parseResult } from './core/http.js';
16
16
  export { setTranslator, setLanguage, getLanguage, translate, translatePlural, printf, defaultMessages } from './core/i18n.js';
17
17
  export { focusTrap, rovingTabindex, typeahead } from './core/keyboard.js';
18
18
  export { formatDate, parseDate, clampDate, isSameDay, addDays, addMonths, getWeekStart } from './core/date.js';
19
- export { icon, icons, iconNames, registerIcons, ICON_SIZE, configureIcons, getIconConfig, useFontAwesome, useBuiltinIcons, loadFontAwesome } from './core/icons.js';
19
+ export { icon, icons, iconAliases, iconNames, registerIcons, ICON_SIZE, configureIcons, getIconConfig, useFontAwesome, useBuiltinIcons, loadFontAwesome } from './core/icons.js';
20
20
  export { faStyles, faFamilies, faNames, faIconClasses, parseIconSpec, kitUrl, loadFontAwesomeKit } from './core/fontawesome.js';
21
21
  export { debounce, throttle, uid, deepMerge, isElement, clamp, toArray, groupBy, sortBy, uniqueBy, escapeRegExp } from './core/util.js';
22
22
  export { formatNumber, formatCurrency, formatPercent, formatFileSize, formatRelativeTime } from './core/format.js';
@@ -52,11 +52,12 @@ export { Tabbox } from './components/tabbox/tabbox.js';
52
52
  export { NavigationBar } from './components/navigation-bar/navigation-bar.js';
53
53
  export { Stepper } from './components/stepper/stepper.js';
54
54
  export { Breadcrumb } from './components/breadcrumb/breadcrumb.js';
55
- export { Pagination, paginationRange } from './components/pagination/pagination.js';
55
+ export { Pagination, fitPageSize, paginationRange } from './components/pagination/pagination.js';
56
56
  export { Search } from './components/search/search.js';
57
57
  export { AppIcon, appIcon } from './components/app-icon/app-icon.js';
58
58
  export { Launcher, rankLauncherItems } from './components/launcher/launcher.js';
59
59
  export { AVATAR_TONES, Avatar, avatarInitials, avatarTone } from './components/avatar/avatar.js';
60
+ export { AGENT_BODIES, AGENT_EYES, AgentAvatar, agentFace, agentTraits } from './components/agent-avatar/agent-avatar.js';
60
61
  export { EntityRef, normalizeEntityRef, normalizeEntityRefLink, normalizeEntityRefMetadata, normalizeEntityRefActions } from './components/entity-ref/entity-ref.js';
61
62
  export { FileItem, normalizeFileItem } from './components/file-item/file-item.js';
62
63
  export { FileList, normalizeFileListItems } from './components/file-list/file-list.js';
@@ -82,7 +83,7 @@ export { WorkspaceSwitcher } from './components/workspace-switcher/workspace-swi
82
83
  export { normalizeAppItems } from './internal/app-rail.js';
83
84
  export { ModuleBar, partitionModules, resolveModuleColor } from './components/module-bar/module-bar.js';
84
85
  export { AppSidebar, presentationGlyph } from './components/app-sidebar/app-sidebar.js';
85
- export { Message } from './components/message/message.js';
86
+ export { Message, messageStackLayout } from './components/message/message.js';
86
87
  export { Modal } from './components/modal/modal.js';
87
88
  export { Dialog } from './components/dialog/dialog.js';
88
89
  export { Sheet } from './components/sheet/sheet.js';
@@ -117,7 +118,8 @@ export { KanbanView } from './components/kanban-view/kanban-view.js';
117
118
  export { absoluteKanbanIndex, allowsKanbanTransition, createKanbanHistory, evaluateKanbanMove, kanbanSearchTerms, locateKanbanRecord, matchesKanbanSearch, normalizeKanbanRules, reorderKanbanRecords, resolveKanbanRules } from './components/kanban-view/kanban-policy.js';
118
119
  export { createKanbanAvatars, createKanbanCardHead, createKanbanIndicator, createKanbanProgress, kanbanAvatarLimit, resolveKanbanAssignees, resolveKanbanIndicator, resolveKanbanProgress } from './components/kanban-view/kanban-card.js';
119
120
  export { Grid, billingColumns, isBillingLine } from './components/grid/grid.js';
120
- export { Chart, ChartJsAdapter, chartSummaryTable, cloneChartValue, isEmptyChartData } from './components/chart/chart.js';
121
+ export { Chart, ChartJsAdapter, chartSummaryModel, chartSummaryTable, cloneChartValue, isEmptyChartData } from './components/chart/chart.js';
122
+ export { SvgChartAdapter } from './components/chart/svg-adapter.js';
121
123
  export { TreeView } from './components/tree/tree.js';
122
124
  export { Finder } from './components/finder/finder.js';
123
125
  export { DataFilter } from './components/data-filter/data-filter.js';
@@ -209,6 +209,23 @@ export type Author = {
209
209
  * A glyph drawn in a tinted tile instead of initials — a model's mark.
210
210
  */
211
211
  icon?: string;
212
+ /**
213
+ * Draws an agent as a generated AgentAvatar face instead of
214
+ * initials or an `icon` tile: its options, or `true` to derive everything from the name. A person
215
+ * ignores it.
216
+ */
217
+ face?: AuthorFace | true;
218
+ };
219
+ export type AuthorFace = {
220
+ seed?: string | number;
221
+ tone?: string;
222
+ body?: string;
223
+ eyes?: string;
224
+ material?: 'flat' | 'soft';
225
+ spacing?: 0 | 1 | 2;
226
+ };
227
+ export type AgentFace = AuthorFace & {
228
+ name?: string;
212
229
  };
213
230
  export type Attachment = {
214
231
  name: string;
@@ -399,6 +416,24 @@ export type StateEntry = {
399
416
  * @property {AgentActivity|null} [activity] What an agent is doing now.
400
417
  * @property {string} [via] The model an agent answers through, shown in the byline.
401
418
  * @property {string} [icon] A glyph drawn in a tinted tile instead of initials — a model's mark.
419
+ * @property {AuthorFace|true} [face] Draws an agent as a generated AgentAvatar face instead of
420
+ * initials or an `icon` tile: its options, or `true` to derive everything from the name. A person
421
+ * ignores it.
422
+ */
423
+ /**
424
+ * The AgentAvatar options an author's face takes; name, size, label and activity come from the
425
+ * author and the place it is drawn. `seed` is what keeps the face — the agent's stable id; a
426
+ * number is read as text, so `42` and `'42'` are one face. `spacing` is the trait
427
+ * `AgentAvatar.getTraits()` reports, for a look stored once.
428
+ * @typedef {{seed?: string|number, tone?: string, body?: string, eyes?: string, material?: 'flat'|'soft',
429
+ * spacing?: 0|1|2}} AuthorFace
430
+ */
431
+ /**
432
+ * An agent drawn as its AgentAvatar face where a component would otherwise draw an icon: the
433
+ * face's traits and the agent's name. Size, label, activity and motion come from the place it is
434
+ * drawn. The face is keyed by `seed`, else by `name`; give one of them, since a face drawn without
435
+ * either is named after the place it stands in.
436
+ * @typedef {AuthorFace & {name?: string}} AgentFace
402
437
  */
403
438
  /** @typedef {{name: string, size?: number, type?: string}} Attachment */
404
439
  /**
@@ -447,6 +482,12 @@ export declare const ACTIVITY: Readonly<Record<AgentActivity, {
447
482
  tone: StateTone;
448
483
  key: string;
449
484
  }>>;
485
+ /**
486
+ * The expression an agent's face takes while its run stands in each state: working while it runs,
487
+ * needs-you while it waits for a person, blocked when blocked or failed, and at rest otherwise.
488
+ * @type {Readonly<Record<RunState, AgentActivity>>}
489
+ */
490
+ export declare const RUN_ACTIVITY: Readonly<Record<RunState, AgentActivity>>;
450
491
  /**
451
492
  * The English words for `STATUS` and `ACTIVITY`, for a component's `msg` defaults.
452
493
  * @type {Readonly<Record<string, string>>}
@@ -585,3 +626,61 @@ export declare function runCost(tokens: [number, number] | null | undefined, pri
585
626
  * @returns {string}
586
627
  */
587
628
  export declare function initialsOf(name: string): string;
629
+ /**
630
+ * What an item's `agent` may set beyond its face where navigation, the Composer and the Launcher
631
+ * draw it: what the agent is doing and how that shows. Size, label and motion stay the place's.
632
+ * @type {ReadonlyArray<string>}
633
+ */
634
+ export declare const AGENT_ITEM_KEYS: ReadonlyArray<string>;
635
+ /**
636
+ * The face an author asks for, reduced to the traits it may set, or null for none: `face: true`
637
+ * derives everything, a plain object contributes its `seed`, `tone`, `body`, `eyes`, `material`
638
+ * and `spacing`, and anything else — a person, another value — means initials. Authors may come
639
+ * from an agent's own data, so how the face is drawn and named is never read from it.
640
+ * @param {Partial<Author>|null|undefined} author
641
+ * @returns {AuthorFace|null}
642
+ */
643
+ export declare function authorFace(author: Partial<Author> | null | undefined): AuthorFace | null;
644
+ /**
645
+ * What an `agent` option asks for, read as {@link authorFace} reads a `face` — `true` derives
646
+ * everything, a plain object contributes its traits and its `name`, anything else is no face.
647
+ * Size, label, activity and motion always belong to the place the face is drawn.
648
+ * @param {unknown} agent
649
+ * @returns {AgentFace|null}
650
+ */
651
+ export declare function agentFaceTraits(agent: unknown): AgentFace | null;
652
+ /**
653
+ * The options of the AgentAvatar a component draws for an agent: the one way every component
654
+ * builds one, so an agent described the same way has the same face wherever it is drawn.
655
+ *
656
+ * Only what says which face it is comes from `source` — its `seed` (a string, or a finite number
657
+ * read as text), its `tone`, `body`, `eyes`, `material` and `name` strings and its `spacing` —
658
+ * plus the `carry` keys a place lets its data set, as navigation lets an item show what its agent
659
+ * is doing ({@link AGENT_ITEM_KEYS}). Nothing else in it is read, so data never decides how a face
660
+ * is sized, labelled or moved. `fallback` fills in what the source leaves out, such as the name of
661
+ * the row it stands in; `fixed` always wins: the place's size, label and motion.
662
+ *
663
+ * The seed keeps a face. A component reads a fallback name once, when it builds the avatar, and
664
+ * keeps that avatar while the source asks for the same traits, so a summary or a title that
665
+ * changes later never changes the face.
666
+ * @param {unknown} source `true`, or a plain object: an `agent` option, an item's `agent`, or an
667
+ * author's face as {@link authorFace} reads it.
668
+ * @param {Record<string, unknown>} [fixed={}] What the place decides; it wins over everything.
669
+ * @param {{fallback?: Record<string, unknown>, carry?: ReadonlyArray<string>}} [options={}]
670
+ * @returns {Record<string, any>|null} The options, or null when the source asks for no face.
671
+ */
672
+ export declare function agentAvatarOptions(source: unknown, fixed?: Record<string, unknown>, options?: {
673
+ fallback?: Record<string, unknown>;
674
+ carry?: ReadonlyArray<string>;
675
+ }): Record<string, any> | null;
676
+ /**
677
+ * A pattern that finds each `@name` of `names` in a text as a whole mention: the trigger not right
678
+ * after a letter, mark, digit or underscore of any script, so `ann@ledger.example` mentions
679
+ * nobody, and the name not right before one, so `@Annabel` does not mention Ann. Where names
680
+ * overlap the longest one is found. The Composer reads mentions back from its text and AgentThread
681
+ * marks them by this one rule.
682
+ * @param {Iterable<unknown>} names Names without the trigger.
683
+ * @param {string} [trigger='@']
684
+ * @returns {RegExp|null} A global pattern, or null without a name.
685
+ */
686
+ export declare function mentionPattern(names: Iterable<unknown>, trigger?: string): RegExp | null;
@@ -15,6 +15,14 @@ export type AppNavItem = {
15
15
  icon?: string | Node | {
16
16
  toElement: () => Node | null;
17
17
  } | ((context: Record<string, any>, item: AppNavItem) => Node | null);
18
+ /**
19
+ * Draws the item as an agent: an AgentAvatar built from these
20
+ * options (`true` for none) in place of `icon`, sized by the slot it sits in. `name` defaults to
21
+ * the item's label. The face shows the agent's `activity` at rest — navigation does not animate —
22
+ * at the small level of detail and flat, whatever the slot measures, and the activity's word
23
+ * joins the control's accessible name ("Ledger, Needs you").
24
+ */
25
+ agent?: AppNavAgent | true;
18
26
  /**
19
27
  * Count or status badge.
20
28
  */
@@ -58,6 +66,7 @@ export type AppNavItem = {
58
66
  toElement: () => Node | null;
59
67
  } | Array<import('./row-actions.js').RowAction | Node>;
60
68
  };
69
+ export type AppNavAgent = Omit<import('../components/agent-avatar/agent-avatar.js').AgentAvatarOptions, 'size' | 'label' | 'animate' | 'phase'>;
61
70
  export type AppRailPresenterOptions = {
62
71
  /**
63
72
  * Application navigation tree.
@@ -136,6 +145,11 @@ export type RailFlyout = {
136
145
  * @property {string|number} id Stable item identifier.
137
146
  * @property {string} label Visible/accessibility label.
138
147
  * @property {string|Node|{toElement: () => Node|null}|((context: Record<string, any>, item: AppNavItem) => Node|null)} [icon] Icon name, node, component, or factory.
148
+ * @property {AppNavAgent|true} [agent] Draws the item as an agent: an AgentAvatar built from these
149
+ * options (`true` for none) in place of `icon`, sized by the slot it sits in. `name` defaults to
150
+ * the item's label. The face shows the agent's `activity` at rest — navigation does not animate —
151
+ * at the small level of detail and flat, whatever the slot measures, and the activity's word
152
+ * joins the control's accessible name ("Ledger, Needs you").
139
153
  * @property {string|number} [badge] Count or status badge.
140
154
  * @property {unknown} [value] Emitted value; defaults to `id`.
141
155
  * @property {string} [href] Native navigation target; executable/data schemes are disabled.
@@ -151,6 +165,10 @@ export type RailFlyout = {
151
165
  * danger?}` descriptors or nodes, revealed with the row, in its context menu, and after its
152
166
  * control in the Tab order while it holds focus. Minimized flyouts show destinations only.
153
167
  */
168
+ /**
169
+ * The AgentAvatar options a navigation item may carry. Size, label and motion belong to the slot.
170
+ * @typedef {Omit<import('../components/agent-avatar/agent-avatar.js').AgentAvatarOptions, 'size'|'label'|'animate'|'phase'>} AppNavAgent
171
+ */
154
172
  /**
155
173
  * @typedef {Object} AppRailPresenterOptions
156
174
  * @property {AppNavItem[]} [items=[]] Application navigation tree.
@@ -226,8 +244,8 @@ export declare class AppRailPresenter extends Component<AppRailPresenterOptions>
226
244
  isFlyoutOpen(id: string | number): boolean;
227
245
  /** Focuses the first top-level rail item. @returns {this} */
228
246
  focus(): this;
229
- /** Reports whether a node belongs to this rail, including detached flyout panels. @param {Node|null} node @returns {boolean} @private */
230
- private _containsNode;
247
+ /** Reports whether a node belongs to this rail, including detached flyout panels. @param {Node|null} node @returns {boolean} @protected */
248
+ protected _containsNode(node: Node | null): boolean;
231
249
  /** Destroys body popovers/tooltips and restores or removes the root. @returns {void} */
232
250
  destroy(): void;
233
251
  /** @returns {void} */
@@ -315,6 +333,23 @@ export declare function normalizeAppItems(items: unknown): AppNavItem[];
315
333
  * @returns {Node|null}
316
334
  */
317
335
  export declare function appNavIcon(item: AppNavItem, renderer: unknown, context: Record<string, any>): Node | null;
336
+ /**
337
+ * The word for what an agent drawn by {@link appNavIcon} is doing, or null for any other visual.
338
+ * @param {Node|null|undefined} visual
339
+ * @returns {string|null}
340
+ */
341
+ export declare function appNavAgentWord(visual: Node | null | undefined): string | null;
342
+ /**
343
+ * A navigation control's accessible name: its label, followed by an agent's activity when the
344
+ * visual is one. The visible label stays first, so the name still starts with what is shown.
345
+ * A control whose badge is printed inside it, and which this name replaces, passes `withBadge` so
346
+ * the count is not lost: "Ledger, Needs you (2)".
347
+ * @param {AppNavItem} item
348
+ * @param {Node|null|undefined} visual
349
+ * @param {boolean} [withBadge=false] Whether to end the name with the item's badge.
350
+ * @returns {string}
351
+ */
352
+ export declare function appNavName(item: AppNavItem, visual: Node | null | undefined, withBadge?: boolean): string;
318
353
  export {};
319
354
  /** Fired when a destination/action is activated. @event AppRailPresenter#select @type {CustomEvent<AppNavSelectDetail>} */
320
355
  /** Fired when a flyout opens or closes. @event AppRailPresenter#flyoutchange @type {CustomEvent<{item: AppNavItem, id: string|number, open: boolean}>} */
@@ -0,0 +1,18 @@
1
+ /**
2
+ * Equality checks over the small collections components keep for their state — selections,
3
+ * hidden fields, orders — so a setter can tell a real change from a repeat and stay silent.
4
+ */
5
+ /**
6
+ * Whether two sets hold the same members, in any order.
7
+ * @param {Set<unknown>} left One set.
8
+ * @param {Set<unknown>} right The other.
9
+ * @returns {boolean}
10
+ */
11
+ export declare function sameSet(left: Set<unknown>, right: Set<unknown>): boolean;
12
+ /**
13
+ * Whether two arrays hold the same entries in the same order, compared with `Object.is`.
14
+ * @param {unknown[]} left One array.
15
+ * @param {unknown[]} right The other.
16
+ * @returns {boolean}
17
+ */
18
+ export declare function sameArray(left: unknown[], right: unknown[]): boolean;
@@ -189,6 +189,33 @@ export declare function isMenuItem(entry: MenuEntry | unknown): entry is MenuIte
189
189
  * @returns {MenuItemRole}
190
190
  */
191
191
  export declare function menuItemRole(item: MenuItem): MenuItemRole;
192
+ /**
193
+ * The checked state choosing an item leaves it in: a `menuitemcheckbox` toggles, a `menuitemradio`
194
+ * becomes checked, and a plain `menuitem` has none.
195
+ * @param {MenuItem} item Chosen item.
196
+ * @param {boolean} current Whether it is checked now.
197
+ * @returns {boolean|undefined}
198
+ */
199
+ export declare function nextCheckedState(item: MenuItem, current: boolean): boolean | undefined;
200
+ /**
201
+ * The indices of the `menuitemradio` items in the same group as the entry at `index`: the section
202
+ * of the menu it sits in, between the nearest separators or headings. Empty for any other entry.
203
+ * @param {MenuEntry[]} entries The menu's entries.
204
+ * @param {number} index Index of a radio item.
205
+ * @returns {number[]}
206
+ */
207
+ export declare function radioGroupIndices(entries: MenuEntry[], index: number): number[];
208
+ /**
209
+ * Shows a chosen checkbox or radio item's new state in a menu rendered by `renderMenuEntries()`:
210
+ * its `aria-checked`, and for a radio item that it is now the only checked one of its group. The
211
+ * entries themselves are left as the application gave them.
212
+ * @param {HTMLElement} panel Menu panel holding the rendered entries.
213
+ * @param {MenuEntry[]} entries The entries it was rendered from.
214
+ * @param {number} index Index of the chosen entry.
215
+ * @param {boolean} checked The chosen item's new state.
216
+ * @returns {void}
217
+ */
218
+ export declare function applyCheckedState(panel: HTMLElement, entries: MenuEntry[], index: number, checked: boolean): void;
192
219
  /**
193
220
  * Builds one menu's entries with shared structure and link safety.
194
221
  * @param {MenuEntry[]} entries Entry definitions.
@@ -0,0 +1,23 @@
1
+ /**
2
+ * Content an overlay accepts: text, a node, or anything exposing `toElement()`. Strings are never
3
+ * parsed as HTML.
4
+ * @typedef {Node|string|number|{toElement: () => Node|null}|null|undefined} OverlayContent
5
+ */
6
+ export type OverlayContent = Node | string | number | {
7
+ toElement: () => Node | null;
8
+ } | null | undefined;
9
+ /**
10
+ * Replaces a container's children with overlay content.
11
+ * @param {Element} target Container to fill.
12
+ * @param {OverlayContent} content Content to display; null or undefined leaves it empty.
13
+ * @returns {void}
14
+ */
15
+ export declare function replaceContent(target: Element, content: OverlayContent): void;
16
+ /**
17
+ * Appends overlay content to a container: a string or number as a text node, the result of
18
+ * `toElement()`, or the node itself. Anything else is ignored.
19
+ * @param {Element} target Container to append to.
20
+ * @param {OverlayContent} content Content to append.
21
+ * @returns {void}
22
+ */
23
+ export declare function appendContent(target: Element, content: OverlayContent): void;
@@ -105,12 +105,15 @@ export type Entry = {
105
105
  * Whether the loop has written a transform it has not cleared.
106
106
  */
107
107
  moved: boolean;
108
- unwatch: () => void;
109
108
  };
110
109
  export type Loop = {
111
110
  document: Document;
112
111
  entries: Map<HTMLElement, Entry>;
113
112
  observer: IntersectionObserver;
113
+ /**
114
+ * The one watcher of `data-zx-motion` regions.
115
+ */
116
+ motion: MutationObserver | null;
114
117
  abort: AbortController;
115
118
  frame: number;
116
119
  last: number;
@@ -124,13 +127,13 @@ export type Loop = {
124
127
  * @property {boolean} visible
125
128
  * @property {boolean} reduced
126
129
  * @property {boolean} moved Whether the loop has written a transform it has not cleared.
127
- * @property {() => void} unwatch
128
130
  */
129
131
  /**
130
132
  * @typedef {Object} Loop
131
133
  * @property {Document} document
132
134
  * @property {Map<HTMLElement, Entry>} entries
133
135
  * @property {IntersectionObserver} observer
136
+ * @property {MutationObserver|null} motion The one watcher of `data-zx-motion` regions.
134
137
  * @property {AbortController} abort
135
138
  * @property {number} frame
136
139
  * @property {number} last
@@ -522,6 +522,9 @@ export declare const locales: Readonly<{
522
522
  'navigationBar.more': "More";
523
523
  'navigationBar.primary': "Primary navigation";
524
524
  'numberField.empty': "Empty";
525
+ 'pagination.auto': "Auto";
526
+ 'pagination.autoLoad': "Auto-load";
527
+ 'pagination.autoSize': "Auto (%1)";
525
528
  'pagination.empty': "0 of 0";
526
529
  'pagination.label': "Pagination";
527
530
  'pagination.loaded': "%1 of %2";