@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
@@ -1,48 +1,6 @@
1
- import { INVALID_ATTRIBUTE } from './reflect.js';
2
- export type AttributeType = 'string' | 'number' | 'boolean' | 'json';
3
- export type ElementAttribute = {
4
- /**
5
- * Attribute representation.
6
- */
7
- type?: AttributeType;
8
- /**
9
- * Component option name; null keeps the value on the host only.
10
- */
11
- option?: string | null;
12
- /**
13
- * Host property name; defaults to camel-cased attribute name.
14
- */
15
- property?: string;
16
- /**
17
- * Property value used while the attribute is absent.
18
- */
19
- default?: unknown;
20
- /**
21
- * Pass the default to the component during initial creation.
22
- */
23
- always?: boolean;
24
- /**
25
- * Recreate the component when this value changes.
26
- */
27
- rebuild?: boolean;
28
- /**
29
- * Value adapter.
30
- */
31
- normalize?: (value: unknown, host: HTMLElement) => unknown;
32
- /**
33
- * Property serializer override.
34
- */
35
- serialize?: (value: unknown, host: HTMLElement) => string | null | typeof INVALID_ATTRIBUTE;
36
- /**
37
- * Live component setter.
38
- */
39
- set?: (component: InstanceType<typeof import('../core/component.js').Component>, value: any, host: HTMLElement) => void;
40
- /**
41
- * Live component getter.
42
- */
43
- get?: (component: InstanceType<typeof import('../core/component.js').Component>, host: HTMLElement) => unknown;
44
- };
45
- export type ElementAttributeMap = Record<string, AttributeType | ElementAttribute>;
1
+ export type ElementAttribute = import('./definitions.js').ElementAttribute;
2
+ export type ElementAttributeMap = import('./definitions.js').ElementAttributeMap;
3
+ export type ElementMethodMap = import('./definitions.js').ElementMethodMap;
46
4
  export type ElementWrapperOptions = {
47
5
  /**
48
6
  * Whether the element participates in native forms.
@@ -52,17 +10,34 @@ export type ElementWrapperOptions = {
52
10
  * Reflected attribute definitions.
53
11
  */
54
12
  attrs?: ElementAttributeMap;
13
+ /**
14
+ * The component's events. Declared, each also reaches the
15
+ * host under its plain name, and no DOM event of that name passes through from inside the
16
+ * component. Left out, the common `zx-*` set is bridged.
17
+ */
18
+ events?: string[] | null;
19
+ /**
20
+ * Component methods the element forwards. Declared,
21
+ * the element also carries its live values across a rebuild and across removal.
22
+ */
23
+ methods?: ElementMethodMap | null;
55
24
  };
56
25
  /**
57
26
  * Creates a light-DOM custom-element class backed by a Zx component.
58
27
  * Groupbox and Dialog wrappers adopt their host's initial children as component content;
59
28
  * other wrappers leave unrelated host children untouched and append their component root.
60
29
  *
30
+ * A wrapper that declares `methods` forwards them: `element.upsert(item)` calls the component, and
31
+ * a call made while no component exists is queued and runs, in order, once it does. A forwarded
32
+ * call returns the component's answer, with the component itself replaced by the element; a
33
+ * queued call returns undefined. A wrapper that declares `events` dispatches each one on the host
34
+ * under its plain name as well as `zx-<type>`. The plain event does not bubble; `zx-<type>` does.
35
+ *
61
36
  * @param {typeof import('../core/component.js').Component} ComponentClass Component constructor.
62
37
  * @param {ElementWrapperOptions} [wrapperOptions={}] Wrapper behavior.
63
38
  * @returns {typeof HTMLElement} Custom-element constructor.
64
39
  */
65
- export declare function elementFor(ComponentClass: typeof import('../core/component.js').Component, { formAssociated, attrs }?: ElementWrapperOptions): typeof HTMLElement;
40
+ export declare function elementFor(ComponentClass: typeof import('../core/component.js').Component, { formAssociated, attrs, events, methods }?: ElementWrapperOptions): typeof HTMLElement;
66
41
  /**
67
42
  * Registers the supported Zx custom elements. Repeated calls and pre-registered names are safe.
68
43
  * This function is deliberately not called by the module.
@@ -0,0 +1,147 @@
1
+ import { INVALID_ATTRIBUTE } from './reflect.js';
2
+ export type AttributeType = import('./reflect.js').AttributeType;
3
+ export type ElementAttribute = {
4
+ /**
5
+ * Attribute representation.
6
+ */
7
+ type?: AttributeType;
8
+ /**
9
+ * Component option name; null keeps the value on the host only.
10
+ */
11
+ option?: string | null;
12
+ /**
13
+ * Host property name; defaults to camel-cased attribute name.
14
+ */
15
+ property?: string;
16
+ /**
17
+ * Property value used while the attribute is absent.
18
+ */
19
+ default?: unknown;
20
+ /**
21
+ * Pass the default to the component during initial creation.
22
+ */
23
+ always?: boolean;
24
+ /**
25
+ * Recreate the component when this value changes.
26
+ */
27
+ rebuild?: boolean;
28
+ /**
29
+ * Write a value set on the property back to the attribute.
30
+ */
31
+ reflect?: boolean;
32
+ /**
33
+ * Read the attribute at all; false makes this a property alone.
34
+ */
35
+ observed?: boolean;
36
+ /**
37
+ * Value adapter.
38
+ */
39
+ normalize?: (value: unknown, host: HTMLElement) => unknown;
40
+ /**
41
+ * Property serializer override.
42
+ */
43
+ serialize?: (value: unknown, host: HTMLElement) => string | null | typeof INVALID_ATTRIBUTE;
44
+ /**
45
+ * Live component setter.
46
+ */
47
+ set?: (component: InstanceType<typeof import('../core/component.js').Component>, value: any, host: HTMLElement) => void;
48
+ /**
49
+ * Live component getter.
50
+ */
51
+ get?: (component: any, host: HTMLElement) => unknown;
52
+ };
53
+ export type ElementAttributeMap = Record<string, AttributeType | ElementAttribute>;
54
+ export type MethodTracker = ((args: unknown[]) => Record<string, unknown> | null | undefined) | null;
55
+ export type ElementMethodMap = Record<string, MethodTracker>;
56
+ /**
57
+ * Fills in every field of an attribute map. Normalizing an already normalized map changes nothing.
58
+ * @param {ElementAttributeMap} attrs Attribute name to definition.
59
+ * @returns {Readonly<Record<string, ElementAttribute>>}
60
+ */
61
+ export declare function normalizeAttributes(attrs: ElementAttributeMap): Readonly<Record<string, ElementAttribute>>;
62
+ /** @param {Record<string, ElementAttribute>} value @returns {Readonly<Record<string, ElementAttribute>>} */
63
+ export declare function attributes(value: Record<string, ElementAttribute>): Readonly<Record<string, ElementAttribute>>;
64
+ /** @param {Partial<ElementAttribute>} [options={}] @returns {ElementAttribute} */
65
+ export declare function text(options?: Partial<ElementAttribute>): ElementAttribute;
66
+ /** @param {Partial<ElementAttribute>} [options={}] @returns {ElementAttribute} */
67
+ export declare function number(options?: Partial<ElementAttribute>): ElementAttribute;
68
+ /** @param {Partial<ElementAttribute>} [options={}] @returns {ElementAttribute} */
69
+ export declare function bool(options?: Partial<ElementAttribute>): ElementAttribute;
70
+ /** @param {Partial<ElementAttribute>} [options={}] @returns {ElementAttribute} */
71
+ export declare function json(options?: Partial<ElementAttribute>): ElementAttribute;
72
+ /**
73
+ * An option that is on by default, or that stays undecided (`default: null`) until it is set.
74
+ * @param {Partial<ElementAttribute>} [options={}]
75
+ * @returns {ElementAttribute}
76
+ */
77
+ export declare function flag(options?: Partial<ElementAttribute>): ElementAttribute;
78
+ /**
79
+ * Rich data: a JSON attribute is read for static markup, and a value set on the property stays
80
+ * there, never serialized back into the attribute.
81
+ * @param {Partial<ElementAttribute>} [options={}]
82
+ * @returns {ElementAttribute}
83
+ */
84
+ export declare function data(options?: Partial<ElementAttribute>): ElementAttribute;
85
+ /**
86
+ * A value markup cannot express: a function, a node, an adapter. It has no attribute at all.
87
+ * @param {Partial<ElementAttribute>} [options={}]
88
+ * @returns {ElementAttribute}
89
+ */
90
+ export declare function prop(options?: Partial<ElementAttribute>): ElementAttribute;
91
+ /**
92
+ * Reflects the plain values of an option that also takes a function, an object or a node. Those
93
+ * stay on the property, because their text would mean nothing in an attribute.
94
+ * @param {AttributeType} type Attribute representation.
95
+ * @returns {(value: unknown) => string|null|typeof INVALID_ATTRIBUTE}
96
+ */
97
+ export declare function reflectPlain(type: AttributeType): (value: unknown) => string | null | typeof INVALID_ATTRIBUTE;
98
+ /** @param {unknown} value @returns {unknown} */
99
+ export declare function normalizeSelectable(value: unknown): unknown;
100
+ /** @param {unknown} value @returns {unknown} */
101
+ export declare function normalizeNumberOrString(value: unknown): unknown;
102
+ /**
103
+ * Declares forwarded methods that need no property bookkeeping.
104
+ * @param {...string} names Method names.
105
+ * @returns {ElementMethodMap}
106
+ */
107
+ export declare function forward(...names: string[]): ElementMethodMap;
108
+ /**
109
+ * A tracker for a method whose first argument is the new value of one property.
110
+ * @param {string} property Host property name.
111
+ * @returns {MethodTracker}
112
+ */
113
+ export declare function records(property: string): MethodTracker;
114
+ /**
115
+ * A tracker for a method whose first argument is a partial set of options, keyed as the
116
+ * properties are.
117
+ * @param {unknown[]} args Call arguments.
118
+ * @returns {Record<string, unknown>|null}
119
+ */
120
+ export declare function recordsPatch([partial]: unknown[]): Record<string, unknown> | null;
121
+ /**
122
+ * The calls made on an element before its component exists, oldest first.
123
+ * @returns {{size: number, push: (name: string, args: unknown[]) => void, drain: (run: (name: string, args: unknown[]) => void, ready?: () => boolean) => void}}
124
+ */
125
+ export declare function createCallQueue(): {
126
+ size: number;
127
+ push: (name: string, args: unknown[]) => void;
128
+ drain: (run: (name: string, args: unknown[]) => void, ready?: () => boolean) => void;
129
+ };
130
+ /**
131
+ * What a forwarded call returns: the component's answer, with the component itself swapped for
132
+ * the element, so a chain stays on the element.
133
+ * @param {unknown} value Component method result.
134
+ * @param {object} component Backing component.
135
+ * @param {HTMLElement} host Custom element.
136
+ * @returns {unknown}
137
+ */
138
+ export declare function forwardedResult(value: unknown, component: object, host: HTMLElement): unknown;
139
+ /**
140
+ * Whether a call to a method the DOM also defines is the DOM's. `element.remove()` removes the
141
+ * element and `element.remove(id)` an item; `element.append(node)` adds a child and
142
+ * `element.append(block)` a block.
143
+ * @param {string} name Method name.
144
+ * @param {unknown[]} args Call arguments.
145
+ * @returns {boolean}
146
+ */
147
+ export declare function isDomCall(name: string, args: unknown[]): boolean;
@@ -0,0 +1,7 @@
1
+ export type ElementAttribute = import('./definitions.js').ElementAttribute;
2
+ /**
3
+ * The agent kit and the data views, as `[suffix, Component, wrapper options]`. None of them is a
4
+ * form control, so none is form-associated.
5
+ * @type {ReadonlyArray<[string, typeof import('../core/component.js').Component, import('./define.js').ElementWrapperOptions]>}
6
+ */
7
+ export declare const KIT_ELEMENTS: ReadonlyArray<[string, typeof import('../core/component.js').Component, import('./define.js').ElementWrapperOptions]>;
@@ -1,8 +1,11 @@
1
1
  /**
2
- * Attribute value types supported by the custom-element wrappers.
3
- * @typedef {'string'|'number'|'boolean'|'json'} AttributeType
2
+ * Attribute value types supported by the custom-element wrappers. `boolean` goes by presence, so
3
+ * an absent attribute means false. `flag` is the shape of HTML's `draggable="false"`, for an option
4
+ * that is on (or undecided) by default: absent keeps the default, `"false"` turns it off, anything
5
+ * else turns it on.
6
+ * @typedef {'string'|'number'|'boolean'|'flag'|'json'} AttributeType
4
7
  */
5
- export type AttributeType = 'string' | 'number' | 'boolean' | 'json';
8
+ export type AttributeType = 'string' | 'number' | 'boolean' | 'flag' | 'json';
6
9
  /** Sentinel returned when an attribute value cannot be safely applied. */
7
10
  export declare const INVALID_ATTRIBUTE: unique symbol;
8
11
  /**
@@ -13,7 +13,7 @@ export { position } from './core/position.js';
13
13
  export { breakpoints, breakpointOf, matchBreakpoint, onBreakpoint } from './core/breakpoint.js';
14
14
  export { MOTION_ATTRIBUTE, prefersReducedMotion, watchMotion } from './core/motion.js';
15
15
  export { Http, zeyosService, parseResult } from './core/http.js';
16
- export { setTranslator, setLanguage, getLanguage, translate, printf, defaultMessages } from './core/i18n.js';
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
19
  export { icon, icons, iconNames, registerIcons, ICON_SIZE, configureIcons, getIconConfig, useFontAwesome, useBuiltinIcons, loadFontAwesome } from './core/icons.js';
@@ -66,10 +66,17 @@ export { BlockView, renderBlocks } from './components/block-view/block-view.js';
66
66
  export { blocksToMarkdown, blocksToText } from './internal/agent-model.js';
67
67
  export { RunStatus } from './components/run-status/run-status.js';
68
68
  export { Composer } from './components/composer/composer.js';
69
+ export { PromptStarters } from './components/prompt-starters/prompt-starters.js';
69
70
  export { ApprovalCard } from './components/approval-card/approval-card.js';
70
71
  export { RunTrace } from './components/run-trace/run-trace.js';
71
72
  export { SourceList } from './components/source-list/source-list.js';
72
73
  export { AgentThread } from './components/agent-thread/agent-thread.js';
74
+ export { UI_MESSAGE_STREAM_VERSION, connectUiMessageStream } from './components/agent-thread/ui-message-stream.js';
75
+ export { AG_UI_VERSION, connectAgUi } from './components/agent-thread/ag-ui.js';
76
+ export { Surface, openSurface } from './components/surface/surface.js';
77
+ export { elicit } from './components/surface/elicit.js';
78
+ export { MCP_ELICITATION_VERSION, elicitationHandler } from './components/surface/mcp.js';
79
+ export { surfaceText } from './components/surface/text.js';
73
80
  export { AccountMenu } from './components/account-menu/account-menu.js';
74
81
  export { WorkspaceSwitcher } from './components/workspace-switcher/workspace-switcher.js';
75
82
  export { normalizeAppItems } from './internal/app-rail.js';
@@ -86,6 +93,8 @@ export { MenuButton } from './components/menu-button/menu-button.js';
86
93
  export { ContextMenu } from './components/context-menu/context-menu.js';
87
94
  export { Select } from './components/select/select.js';
88
95
  export { statusIcon, priorityIcon } from './components/select/glyphs.js';
96
+ export { canonicalLocale } from './components/select/locale.js';
97
+ export { flag, flagEmoji, supportsFlagEmoji, COUNTRY_CODES } from './components/flag/flag.js';
89
98
  export { Checklist } from './components/checklist/checklist.js';
90
99
  export { TagPicker } from './components/tag-picker/tag-picker.js';
91
100
  export { NumberField, parseNumber, snapNumber } from './components/number-field/number-field.js';
@@ -0,0 +1,7 @@
1
+ /**
2
+ * The locale `Intl` writes a date in: a supported component option, then the active language,
3
+ * including regional English, then English when neither can be used.
4
+ * @param {string|string[]|null} [option] The component's `locale` option.
5
+ * @returns {string|string[]}
6
+ */
7
+ export declare function dateLocale(option?: string | string[] | null): string | string[];
@@ -0,0 +1,146 @@
1
+ /**
2
+ * JSON Pointer (RFC 6901) and JSON Patch (RFC 6902) over plain JSON values.
3
+ *
4
+ * Every function here is pure: a document handed in is never mutated, and a function that changes
5
+ * something returns a new document. Pointers may not walk through `__proto__`, `constructor` or
6
+ * `prototype`, so a pointer written by a model or a server can never reach an object's prototype.
7
+ *
8
+ * The module touches no DOM and imports nothing, so it runs unchanged in a browser and on a server.
9
+ */
10
+ export type JsonPatchErrorCode = 'invalid-pointer' | 'forbidden-segment' | 'not-a-container' | 'path-not-found' | 'invalid-index' | 'invalid-operation' | 'test-failed';
11
+ export type JsonPatchOperation = {
12
+ /**
13
+ * Operation name.
14
+ */
15
+ op: 'add' | 'remove' | 'replace' | 'move' | 'copy' | 'test';
16
+ /**
17
+ * RFC 6901 pointer to the target.
18
+ */
19
+ path: string;
20
+ /**
21
+ * Value to add, replace with, or test against.
22
+ */
23
+ value?: unknown;
24
+ /**
25
+ * RFC 6901 pointer to the source of a `move` or `copy`.
26
+ */
27
+ from?: string;
28
+ };
29
+ /**
30
+ * Why a pointer or a patch operation could not be applied.
31
+ * - `invalid-pointer`: the pointer is not a string, or is not empty and does not start with `/`,
32
+ * or carries a `~` that is not `~0` or `~1`.
33
+ * - `forbidden-segment`: a segment is `__proto__`, `constructor` or `prototype`.
34
+ * - `not-a-container`: the path runs through a value that is neither an object nor an array.
35
+ * - `path-not-found`: the target, or its parent, does not exist.
36
+ * - `invalid-index`: an array segment is not an index, is out of range, or is `-` where nothing
37
+ * is appended.
38
+ * - `invalid-operation`: an operation is malformed or unknown, or moves a value into itself.
39
+ * - `test-failed`: a `test` operation's value differs from the document's.
40
+ * @typedef {'invalid-pointer'|'forbidden-segment'|'not-a-container'|'path-not-found'|'invalid-index'|'invalid-operation'|'test-failed'} JsonPatchErrorCode
41
+ */
42
+ /**
43
+ * One RFC 6902 operation. `value` is required by `add`, `replace` and `test`, `from` by `move`
44
+ * and `copy`. Other members are ignored, as the RFC asks.
45
+ * @typedef {Object} JsonPatchOperation
46
+ * @property {'add'|'remove'|'replace'|'move'|'copy'|'test'} op Operation name.
47
+ * @property {string} path RFC 6901 pointer to the target.
48
+ * @property {unknown} [value] Value to add, replace with, or test against.
49
+ * @property {string} [from] RFC 6901 pointer to the source of a `move` or `copy`.
50
+ */
51
+ /**
52
+ * The error every function in this module throws. `code` says what went wrong, `pointer` where,
53
+ * and `index` which operation of a patch failed (`-1` outside a patch).
54
+ */
55
+ export declare class JsonPatchError extends Error {
56
+ /** @type {JsonPatchErrorCode} */
57
+ code: JsonPatchErrorCode;
58
+ /** @type {string} */
59
+ pointer: string;
60
+ /** @type {number} */
61
+ index: number;
62
+ /**
63
+ * @param {string} message Human-readable description.
64
+ * @param {JsonPatchErrorCode} code What went wrong.
65
+ * @param {string} [pointer=''] The pointer involved.
66
+ * @param {number} [index=-1] Position of the failing operation within a patch.
67
+ */
68
+ constructor(message: string, code: JsonPatchErrorCode, pointer?: string, index?: number);
69
+ }
70
+ /**
71
+ * Splits an RFC 6901 pointer into its unescaped segments. `''` is the whole document and yields no
72
+ * segments; `'/'` yields one empty segment. `~1` becomes `/` and then `~0` becomes `~`, in that
73
+ * order, so `~01` reads as the two characters `~1`.
74
+ * @param {string} pointer RFC 6901 pointer.
75
+ * @returns {string[]}
76
+ * @throws {JsonPatchError} `invalid-pointer` when malformed, `forbidden-segment` for `__proto__`,
77
+ * `constructor` or `prototype`.
78
+ */
79
+ export declare function parsePointer(pointer: string): string[];
80
+ /**
81
+ * Joins segments into an RFC 6901 pointer, escaping `~` as `~0` and `/` as `~1`. The inverse of
82
+ * `parsePointer()`.
83
+ * @param {Array<string|number>} segments Unescaped segments.
84
+ * @returns {string}
85
+ */
86
+ export declare function formatPointer(segments: Array<string | number>): string;
87
+ /**
88
+ * Reads the value a pointer names. A path that does not exist, runs through a value that is not a
89
+ * container, or ends in `-` reads as `undefined` rather than throwing, so a binding to data that
90
+ * has not arrived yet is simply empty.
91
+ * @param {unknown} document JSON value to read from.
92
+ * @param {string} pointer RFC 6901 pointer.
93
+ * @returns {unknown} The value, or `undefined` when there is none.
94
+ * @throws {JsonPatchError} When the pointer itself is malformed or names a forbidden segment.
95
+ */
96
+ export declare function getPointer(document: unknown, pointer: string): unknown;
97
+ /**
98
+ * Reports whether a pointer names an existing value, which `getPointer()` cannot tell from a
99
+ * missing one when the value read is `undefined`.
100
+ * @param {unknown} document JSON value to read from.
101
+ * @param {string} pointer RFC 6901 pointer.
102
+ * @returns {boolean}
103
+ * @throws {JsonPatchError} When the pointer itself is malformed or names a forbidden segment.
104
+ */
105
+ export declare function hasPointer(document: unknown, pointer: string): boolean;
106
+ /**
107
+ * Stores a value at a pointer and returns the new document: the simple "set" a data stream needs.
108
+ * An object member is created or replaced; an array element at an existing index is replaced, and
109
+ * one at the array's length or at `-` is appended. The empty pointer replaces the whole document.
110
+ * Every parent on the path must already exist. The value is copied in, never shared.
111
+ * @param {unknown} document JSON value to change. Not mutated.
112
+ * @param {string} pointer RFC 6901 pointer.
113
+ * @param {unknown} value JSON value to store.
114
+ * @returns {unknown} The new document.
115
+ * @throws {JsonPatchError} `not-a-container` when the path runs through a value that is not an
116
+ * object or array, `path-not-found` when a parent is missing, `invalid-index` for a bad array
117
+ * segment, or a pointer error.
118
+ */
119
+ export declare function setPointer(document: unknown, pointer: string, value: unknown): unknown;
120
+ /**
121
+ * Removes the value at a pointer and returns the new document. An array element is spliced out,
122
+ * so the elements after it move up.
123
+ * @param {unknown} document JSON value to change. Not mutated.
124
+ * @param {string} pointer RFC 6901 pointer to an existing value; not the empty pointer.
125
+ * @returns {unknown} The new document.
126
+ * @throws {JsonPatchError} `path-not-found` when nothing is there, `not-a-container` when the path
127
+ * runs through a value that is not an object or array, `invalid-operation` for the empty
128
+ * pointer, or a pointer error.
129
+ */
130
+ export declare function removePointer(document: unknown, pointer: string): unknown;
131
+ /**
132
+ * Applies an RFC 6902 patch and returns the new document. The input is never mutated, and the
133
+ * patch applies all or nothing: when any operation fails — a failing `test` included — the error
134
+ * is thrown and no partial result exists.
135
+ * @param {unknown} document JSON value to patch. Not mutated.
136
+ * @param {JsonPatchOperation[]} operations Operations, applied in order.
137
+ * @returns {unknown} The patched document.
138
+ * @throws {JsonPatchError} At the first failing operation; its `index` says which.
139
+ */
140
+ export declare function applyPatch(document: unknown, operations: JsonPatchOperation[]): unknown;
141
+ /**
142
+ * JSON equality as RFC 6902 `test` defines it: same type, numbers by value, strings by code
143
+ * points, arrays element by element in order, objects by the same members regardless of order.
144
+ * @param {unknown} a @param {unknown} b @returns {boolean}
145
+ */
146
+ export declare function jsonEqual(a: unknown, b: unknown): boolean;
@@ -0,0 +1,13 @@
1
+ /**
2
+ * The German message catalogue: the keys of `defaultMessages`, in its order, with the same
3
+ * placeholders. Install it with `setTranslator((key) => de[key])` and `setLanguage('de')`.
4
+ *
5
+ * The voice is that of a business application. It addresses the reader formally and prefers forms
6
+ * that need no address at all ("Änderungen speichern"); buttons and menu items use the infinitive.
7
+ * Quotation marks are „…“, the ellipsis is one character attached to its word, and a number stays
8
+ * on the line of its unit through a non-breaking space. Established software terms (Agent, Board,
9
+ * Token, Tool) stay; `docs/llms.md` lists the glossary.
10
+ *
11
+ * @type {Readonly<Record<string, string>>}
12
+ */
13
+ export declare const de: Readonly<Record<string, string>>;
@@ -0,0 +1,2 @@
1
+ /** The built-in English catalogue, available through the same opt-in locale entry points. */
2
+ export { defaultMessages as en } from '../core/messages.js';