@zeyos/zx 5.6.0 → 5.7.1

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 (227) hide show
  1. package/CHANGELOG.md +188 -0
  2. package/README.md +73 -7
  3. package/bin/zx-css.js +328 -0
  4. package/dist/types/components/account-menu/account-menu.d.ts +4 -2
  5. package/dist/types/components/activity-list/activity-list.d.ts +14 -8
  6. package/dist/types/components/agent-thread/ag-ui.d.ts +340 -0
  7. package/dist/types/components/agent-thread/agent-thread.d.ts +142 -14
  8. package/dist/types/components/agent-thread/ui-message-stream.d.ts +401 -0
  9. package/dist/types/components/app-sidebar/app-sidebar.d.ts +14 -8
  10. package/dist/types/components/breadcrumb/breadcrumb.d.ts +3 -3
  11. package/dist/types/components/calendar/calendar-model.d.ts +9 -2
  12. package/dist/types/components/calendar/calendar.d.ts +12 -4
  13. package/dist/types/components/chart/chart.d.ts +25 -13
  14. package/dist/types/components/checklist/checklist.d.ts +29 -0
  15. package/dist/types/components/code-editor/code-editor.d.ts +7 -2
  16. package/dist/types/components/composer/composer.d.ts +206 -4
  17. package/dist/types/components/composer/queue.d.ts +76 -0
  18. package/dist/types/components/copy/copy-button.d.ts +6 -4
  19. package/dist/types/components/copy/copy-input.d.ts +10 -6
  20. package/dist/types/components/datebox/date-range-box.d.ts +33 -0
  21. package/dist/types/components/datebox/placeholder.d.ts +7 -0
  22. package/dist/types/components/dialog/dialog.d.ts +2 -2
  23. package/dist/types/components/dock/dock.d.ts +12 -3
  24. package/dist/types/components/entity-ref/entity-ref.d.ts +5 -3
  25. package/dist/types/components/field-upload/field-upload.d.ts +3 -2
  26. package/dist/types/components/file-item/file-item.d.ts +3 -2
  27. package/dist/types/components/file-list/file-list.d.ts +14 -8
  28. package/dist/types/components/filter/filter-model.d.ts +31 -1
  29. package/dist/types/components/filter/filter.d.ts +20 -2
  30. package/dist/types/components/finder/finder.d.ts +14 -6
  31. package/dist/types/components/flag/flag.d.ts +99 -0
  32. package/dist/types/components/grid/grid.d.ts +1 -1
  33. package/dist/types/components/kanban-view/kanban-view.d.ts +8 -66
  34. package/dist/types/components/launcher/launcher.d.ts +2 -0
  35. package/dist/types/components/modal/modal.d.ts +34 -8
  36. package/dist/types/components/multi-value-editor/multi-value-editor.d.ts +3 -2
  37. package/dist/types/components/number-field/number-field.d.ts +41 -7
  38. package/dist/types/components/prompt-starters/prompt-starters.d.ts +107 -0
  39. package/dist/types/components/prose/prose.d.ts +9 -6
  40. package/dist/types/components/questionnaire/conditions.d.ts +270 -0
  41. package/dist/types/components/questionnaire/items.d.ts +52 -30
  42. package/dist/types/components/questionnaire/questionnaire.d.ts +44 -4
  43. package/dist/types/components/rating/rating.d.ts +5 -3
  44. package/dist/types/components/select/country.d.ts +106 -0
  45. package/dist/types/components/select/field-adapter.d.ts +2 -1
  46. package/dist/types/components/select/locale.d.ts +102 -0
  47. package/dist/types/components/select/select.d.ts +41 -2
  48. package/dist/types/components/sheet/sheet.d.ts +2 -2
  49. package/dist/types/components/slider/slider.d.ts +1 -0
  50. package/dist/types/components/sort-control/sort-control.d.ts +7 -3
  51. package/dist/types/components/source-list/source-list.d.ts +7 -5
  52. package/dist/types/components/split-view/split-view.d.ts +5 -3
  53. package/dist/types/components/surface/catalog.d.ts +260 -0
  54. package/dist/types/components/surface/elicit.d.ts +81 -0
  55. package/dist/types/components/surface/mcp.d.ts +165 -0
  56. package/dist/types/components/surface/schema.d.ts +314 -0
  57. package/dist/types/components/surface/stream.d.ts +118 -0
  58. package/dist/types/components/surface/surface.d.ts +718 -0
  59. package/dist/types/components/surface/text.d.ts +277 -0
  60. package/dist/types/components/surface/validate.d.ts +339 -0
  61. package/dist/types/components/table/table.d.ts +55 -3
  62. package/dist/types/components/table/window.d.ts +203 -0
  63. package/dist/types/components/toolbar/toolbar.d.ts +10 -6
  64. package/dist/types/components/tooltip/tooltip.d.ts +2 -2
  65. package/dist/types/components/tree/tree.d.ts +20 -13
  66. package/dist/types/core/component.d.ts +10 -0
  67. package/dist/types/core/date.d.ts +8 -1
  68. package/dist/types/core/dom.d.ts +15 -0
  69. package/dist/types/core/http.d.ts +10 -0
  70. package/dist/types/core/i18n.d.ts +38 -0
  71. package/dist/types/core/messages.d.ts +344 -1
  72. package/dist/types/core/storage.d.ts +7 -2
  73. package/dist/types/elements/define.d.ts +21 -46
  74. package/dist/types/elements/definitions.d.ts +147 -0
  75. package/dist/types/elements/kit.d.ts +7 -0
  76. package/dist/types/elements/reflect.d.ts +6 -3
  77. package/dist/types/index.d.ts +10 -1
  78. package/dist/types/internal/date-locale.d.ts +7 -0
  79. package/dist/types/internal/json-patch.d.ts +146 -0
  80. package/dist/types/locales/de.d.ts +13 -0
  81. package/dist/types/locales/en.d.ts +2 -0
  82. package/dist/types/locales/index.d.ts +823 -0
  83. package/dist/types/zeyos/view.d.ts +8 -1
  84. package/dist/zx-zeyos.esm.js +16852 -15131
  85. package/dist/zx-zeyos.esm.min.js +5 -5
  86. package/dist/zx.core.css +1276 -0
  87. package/dist/zx.core.min.css +1 -0
  88. package/dist/zx.css +520 -143
  89. package/dist/zx.esm.js +40940 -29684
  90. package/dist/zx.esm.min.js +36 -23
  91. package/dist/zx.global.js +40940 -29684
  92. package/dist/zx.global.min.js +36 -23
  93. package/dist/zx.layered.css +17315 -0
  94. package/dist/zx.layered.min.css +1 -0
  95. package/dist/zx.min.css +1 -1
  96. package/docs/agent-catalog.json +12501 -0
  97. package/docs/agent-surfaces.md +340 -0
  98. package/docs/api.json +909 -137
  99. package/docs/llms.md +1046 -80
  100. package/docs/llms.txt +30 -9
  101. package/package.json +29 -6
  102. package/src/components/account-menu/account-menu.js +6 -3
  103. package/src/components/activity-item/activity-item.js +2 -1
  104. package/src/components/activity-list/activity-list.js +16 -10
  105. package/src/components/agent-thread/ag-ui.js +1439 -0
  106. package/src/components/agent-thread/agent-thread.js +359 -54
  107. package/src/components/agent-thread/ui-message-stream.js +1281 -0
  108. package/src/components/app-sidebar/app-sidebar.js +18 -8
  109. package/src/components/approval-card/approval-card.js +3 -2
  110. package/src/components/block-view/block-view.js +7 -6
  111. package/src/components/breadcrumb/breadcrumb.js +8 -5
  112. package/src/components/button/button.css +24 -11
  113. package/src/components/calendar/calendar-model.js +8 -2
  114. package/src/components/calendar/calendar.js +53 -18
  115. package/src/components/chart/chart.js +54 -23
  116. package/src/components/checklist/checklist.css +9 -1
  117. package/src/components/checklist/checklist.js +59 -3
  118. package/src/components/checklist/field-adapter.js +2 -11
  119. package/src/components/code-editor/code-editor.js +45 -8
  120. package/src/components/code-editor/field-adapter.js +1 -1
  121. package/src/components/composer/composer.css +80 -1
  122. package/src/components/composer/composer.js +390 -16
  123. package/src/components/composer/queue.js +78 -0
  124. package/src/components/context-menu/context-menu.js +12 -1
  125. package/src/components/copy/copy-button.js +9 -7
  126. package/src/components/copy/copy-input.js +10 -6
  127. package/src/components/date-picker/date-picker.js +2 -1
  128. package/src/components/date-picker/date-range-picker.js +8 -7
  129. package/src/components/datebox/date-range-box.js +3 -9
  130. package/src/components/datebox/datebox.js +18 -21
  131. package/src/components/datebox/placeholder.js +18 -0
  132. package/src/components/dialog/dialog.js +4 -5
  133. package/src/components/dock/dock.js +34 -13
  134. package/src/components/entity-ref/entity-ref.js +16 -5
  135. package/src/components/field-upload/field-upload.js +81 -38
  136. package/src/components/file-item/file-item.js +70 -40
  137. package/src/components/file-list/file-list.js +15 -9
  138. package/src/components/filter/filter-model.js +46 -8
  139. package/src/components/filter/filter.css +3 -3
  140. package/src/components/filter/filter.js +29 -10
  141. package/src/components/filter-panel/filter-panel.js +13 -5
  142. package/src/components/finder/finder.js +50 -26
  143. package/src/components/flag/flag.css +40 -0
  144. package/src/components/flag/flag.js +177 -0
  145. package/src/components/form/form.js +1 -1
  146. package/src/components/grid/grid.js +22 -8
  147. package/src/components/kanban-view/kanban-view.js +51 -81
  148. package/src/components/launcher/launcher.js +17 -2
  149. package/src/components/list-toolbar/list-toolbar.js +2 -1
  150. package/src/components/master-panel/master-panel.js +1 -1
  151. package/src/components/menu-button/menu-button.js +4 -0
  152. package/src/components/message/message.js +3 -0
  153. package/src/components/modal/modal.js +62 -8
  154. package/src/components/multi-value-editor/multi-value-editor.js +10 -9
  155. package/src/components/navigation-bar/navigation-bar.js +3 -3
  156. package/src/components/number-field/number-field.js +98 -29
  157. package/src/components/prompt-starters/prompt-starters.css +91 -0
  158. package/src/components/prompt-starters/prompt-starters.js +206 -0
  159. package/src/components/prose/prose.js +14 -10
  160. package/src/components/questionnaire/conditions.js +666 -0
  161. package/src/components/questionnaire/items.js +150 -41
  162. package/src/components/questionnaire/questionnaire.js +126 -32
  163. package/src/components/rating/rating.js +5 -4
  164. package/src/components/run-status/run-status.js +2 -2
  165. package/src/components/select/country.js +136 -0
  166. package/src/components/select/field-adapter.js +7 -2
  167. package/src/components/select/locale.js +219 -0
  168. package/src/components/select/select.css +20 -22
  169. package/src/components/select/select.js +94 -12
  170. package/src/components/sheet/sheet-stack.js +10 -1
  171. package/src/components/sheet/sheet.js +12 -5
  172. package/src/components/slider/slider.js +7 -2
  173. package/src/components/sort-control/sort-control.js +15 -5
  174. package/src/components/source-list/source-list.js +7 -4
  175. package/src/components/split-view/split-view.js +5 -3
  176. package/src/components/surface/catalog.js +1334 -0
  177. package/src/components/surface/elicit.js +107 -0
  178. package/src/components/surface/mcp.js +243 -0
  179. package/src/components/surface/schema.js +644 -0
  180. package/src/components/surface/stream.js +245 -0
  181. package/src/components/surface/surface.css +308 -0
  182. package/src/components/surface/surface.js +2291 -0
  183. package/src/components/surface/text.js +513 -0
  184. package/src/components/surface/validate.js +2218 -0
  185. package/src/components/tabbox/tabbox.js +9 -0
  186. package/src/components/table/table.css +63 -3
  187. package/src/components/table/table.js +167 -28
  188. package/src/components/table/window.js +317 -0
  189. package/src/components/toolbar/toolbar.js +12 -7
  190. package/src/components/tooltip/tooltip.css +2 -3
  191. package/src/components/tooltip/tooltip.js +32 -5
  192. package/src/components/tree/tree.js +53 -23
  193. package/src/core/component.js +25 -1
  194. package/src/core/date.js +62 -16
  195. package/src/core/dom.js +67 -4
  196. package/src/core/format.js +15 -13
  197. package/src/core/http.js +29 -20
  198. package/src/core/i18n.js +83 -10
  199. package/src/core/icons.js +13 -2
  200. package/src/core/keyboard.js +79 -8
  201. package/src/core/messages.js +376 -2
  202. package/src/core/overlay-host.js +1 -0
  203. package/src/core/position.js +3 -2
  204. package/src/core/storage.js +59 -6
  205. package/src/elements/define.js +178 -130
  206. package/src/elements/definitions.js +229 -0
  207. package/src/elements/kit.js +444 -0
  208. package/src/elements/reflect.js +8 -3
  209. package/src/index.js +10 -1
  210. package/src/internal/date-locale.js +11 -0
  211. package/src/internal/json-patch.js +405 -0
  212. package/src/locales/de.js +911 -0
  213. package/src/locales/en.js +2 -0
  214. package/src/locales/index.js +7 -0
  215. package/src/zeyos/calendar.js +2 -1
  216. package/src/zeyos/form.js +2 -1
  217. package/src/zeyos/launcher.js +7 -6
  218. package/src/zeyos/module-bar.js +2 -1
  219. package/src/zeyos/schema.js +37 -23
  220. package/src/zeyos/select.js +4 -3
  221. package/src/zeyos/table.js +2 -13
  222. package/src/zeyos/view.js +57 -17
  223. package/styles/core.css +11 -0
  224. package/styles/tokens/semantic.css +1 -0
  225. package/styles/zeyos.css +2 -0
  226. package/styles/zx.css +4 -8
  227. package/styles/zx.layered.css +1 -0
@@ -38,6 +38,18 @@ const CARETLESS_INPUT_TYPES = new Set(['button', 'checkbox', 'color', 'file', 'i
38
38
  export function focusTrap(container) {
39
39
  let active = false;
40
40
  let previousFocus = null;
41
+ let temporaryTabindex = false;
42
+
43
+ /** @returns {void} */
44
+ function focusBoundary() {
45
+ const boundary = /** @type {HTMLElement} */ (container);
46
+ if (typeof boundary.focus !== 'function') return;
47
+ if (!boundary.hasAttribute('tabindex') && boundary.tabIndex < 0) {
48
+ boundary.setAttribute('tabindex', '-1');
49
+ temporaryTabindex = true;
50
+ }
51
+ boundary.focus();
52
+ }
41
53
 
42
54
  /** @returns {void} */
43
55
  function onKeydown(event) {
@@ -45,6 +57,7 @@ export function focusTrap(container) {
45
57
  const items = focusableItems(container);
46
58
  if (items.length === 0) {
47
59
  event.preventDefault();
60
+ focusBoundary();
48
61
  return;
49
62
  }
50
63
  const first = items[0];
@@ -65,7 +78,9 @@ export function focusTrap(container) {
65
78
  active = true;
66
79
  previousFocus = document.activeElement;
67
80
  document.addEventListener('keydown', onKeydown);
68
- focusableItems(container)[0]?.focus();
81
+ const first = focusableItems(container)[0];
82
+ if (first) first.focus();
83
+ else focusBoundary();
69
84
  },
70
85
 
71
86
  /** Deactivates trapping and restores focus when possible. @returns {void} */
@@ -73,6 +88,8 @@ export function focusTrap(container) {
73
88
  if (!active) return;
74
89
  active = false;
75
90
  document.removeEventListener('keydown', onKeydown);
91
+ if (temporaryTabindex && container.getAttribute('tabindex') === '-1') container.removeAttribute('tabindex');
92
+ temporaryTabindex = false;
76
93
  if (previousFocus?.isConnected && typeof previousFocus.focus === 'function') previousFocus.focus();
77
94
  previousFocus = null;
78
95
  }
@@ -100,11 +117,46 @@ export function focusTrap(container) {
100
117
  export function rovingTabindex(container, itemSelector, { orientation = 'vertical', wrap = true, rtl = 'auto' } = {}) {
101
118
  const controller = new AbortController();
102
119
  const originals = new Map();
120
+ const managed = new Map();
103
121
  let destroyed = false;
104
122
 
123
+ /** @param {HTMLElement} item @returns {void} */
124
+ function release(item) {
125
+ if (!originals.has(item)) return;
126
+ // A caller may have assigned a new value while the item was detached. Only undo our own write.
127
+ if (item.getAttribute('tabindex') === managed.get(item)) {
128
+ const tabindex = originals.get(item);
129
+ if (tabindex === null) item.removeAttribute('tabindex');
130
+ else item.setAttribute('tabindex', tabindex);
131
+ }
132
+ originals.delete(item);
133
+ managed.delete(item);
134
+ }
135
+
136
+ /** @param {MutationRecord[]} records @returns {void} */
137
+ function releaseRemoved(records) {
138
+ for (const record of records) {
139
+ if (record.type !== 'childList') continue;
140
+ for (const node of record.removedNodes) {
141
+ for (const item of originals.keys()) {
142
+ if (node === item || node.contains(item)) release(item);
143
+ }
144
+ }
145
+ }
146
+ }
147
+
105
148
  /** @returns {HTMLElement[]} */
106
149
  function items() {
107
- return /** @type {HTMLElement[]} */ (Array.from(container.querySelectorAll(itemSelector)))
150
+ const pending = observer?.takeRecords() ?? [];
151
+ const changed = pending.some(concernsItems);
152
+ releaseRemoved(pending);
153
+ // A synchronous API/key call can consume observer records before its callback runs. Keep its
154
+ // pending availability refresh even if that call does not itself update the group.
155
+ if (changed) queueMicrotask(() => { if (!destroyed) update(); });
156
+ const current = /** @type {HTMLElement[]} */ (Array.from(container.querySelectorAll(itemSelector)));
157
+ const present = new Set(current);
158
+ for (const item of originals.keys()) if (!present.has(item)) release(item);
159
+ return current
108
160
  .filter((item) => {
109
161
  remember(item);
110
162
  return isAvailable(item);
@@ -113,7 +165,11 @@ export function rovingTabindex(container, itemSelector, { orientation = 'vertica
113
165
 
114
166
  /** @param {HTMLElement} item @returns {void} */
115
167
  function remember(item) {
116
- if (!originals.has(item)) originals.set(item, item.getAttribute('tabindex'));
168
+ if (!originals.has(item)) {
169
+ const value = item.getAttribute('tabindex');
170
+ originals.set(item, value);
171
+ managed.set(item, value);
172
+ }
117
173
  }
118
174
 
119
175
  /** @param {HTMLElement|null} selected @returns {void} */
@@ -124,6 +180,7 @@ export function rovingTabindex(container, itemSelector, { orientation = 'vertica
124
180
  for (const item of available) {
125
181
  const tabindex = item === active ? 0 : -1;
126
182
  if (item.tabIndex !== tabindex) item.tabIndex = tabindex;
183
+ managed.set(item, item.getAttribute('tabindex'));
127
184
  }
128
185
  }
129
186
 
@@ -162,7 +219,11 @@ export function rovingTabindex(container, itemSelector, { orientation = 'vertica
162
219
  container.addEventListener('keydown', onKeydown, { signal: controller.signal });
163
220
  container.addEventListener('focusin', onFocus, { signal: controller.signal });
164
221
  const observer = typeof MutationObserver === 'function'
165
- ? new MutationObserver((records) => { if (records.some(concernsItems)) update(); })
222
+ ? new MutationObserver((records) => {
223
+ const changed = records.some(concernsItems);
224
+ releaseRemoved(records);
225
+ if (changed) update();
226
+ })
166
227
  : null;
167
228
  observer?.observe(container, {
168
229
  childList: true, subtree: true, attributes: true, attributeFilter: AVAILABILITY_ATTRIBUTES
@@ -218,12 +279,14 @@ export function rovingTabindex(container, itemSelector, { orientation = 'vertica
218
279
  if (destroyed) return;
219
280
  destroyed = true;
220
281
  controller.abort();
282
+ releaseRemoved(observer?.takeRecords() ?? []);
221
283
  observer?.disconnect();
222
284
  for (const [item, tabindex] of originals) {
223
285
  if (tabindex === null) item.removeAttribute('tabindex');
224
286
  else item.setAttribute('tabindex', tabindex);
225
287
  }
226
288
  originals.clear();
289
+ managed.clear();
227
290
  }
228
291
  };
229
292
  }
@@ -309,6 +372,7 @@ function controlSignature(element) {
309
372
  export function typeahead(getItems, onMatch) {
310
373
  let buffer = '';
311
374
  let timer = null;
375
+ let lastMatch = null;
312
376
 
313
377
  return function handleTypeahead(event) {
314
378
  const key = typeof event === 'string' ? event : event.key;
@@ -316,16 +380,23 @@ export function typeahead(getItems, onMatch) {
316
380
  if (!key || key.length !== 1 || /\s/.test(key)) return;
317
381
 
318
382
  if (timer !== null) clearTimeout(timer);
319
- buffer += key.toLocaleLowerCase();
320
- if (buffer.split('').every((character) => character === buffer[0])) buffer = buffer[0];
383
+ const letter = key.toLocaleLowerCase();
384
+ const cycle = buffer === letter;
385
+ buffer = cycle ? letter : buffer + letter;
321
386
  timer = setTimeout(() => {
322
387
  buffer = '';
323
388
  timer = null;
324
389
  }, 500);
325
390
 
326
391
  const candidates = getItems();
327
- const index = candidates.findIndex((item) => itemText(item).startsWith(buffer));
328
- if (index >= 0) onMatch(candidates[index], index);
392
+ const start = cycle ? candidates.indexOf(lastMatch) + 1 : 0;
393
+ for (let offset = 0; offset < candidates.length; offset += 1) {
394
+ const index = (start + offset) % candidates.length;
395
+ if (!itemText(candidates[index]).startsWith(buffer)) continue;
396
+ lastMatch = candidates[index];
397
+ onMatch(lastMatch, index);
398
+ break;
399
+ }
329
400
  };
330
401
  }
331
402