@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.
- package/CHANGELOG.md +188 -0
- package/README.md +73 -7
- package/bin/zx-css.js +328 -0
- package/dist/types/components/account-menu/account-menu.d.ts +4 -2
- package/dist/types/components/activity-list/activity-list.d.ts +14 -8
- package/dist/types/components/agent-thread/ag-ui.d.ts +340 -0
- package/dist/types/components/agent-thread/agent-thread.d.ts +142 -14
- package/dist/types/components/agent-thread/ui-message-stream.d.ts +401 -0
- package/dist/types/components/app-sidebar/app-sidebar.d.ts +14 -8
- package/dist/types/components/breadcrumb/breadcrumb.d.ts +3 -3
- package/dist/types/components/calendar/calendar-model.d.ts +9 -2
- package/dist/types/components/calendar/calendar.d.ts +12 -4
- package/dist/types/components/chart/chart.d.ts +25 -13
- package/dist/types/components/checklist/checklist.d.ts +29 -0
- package/dist/types/components/code-editor/code-editor.d.ts +7 -2
- package/dist/types/components/composer/composer.d.ts +206 -4
- package/dist/types/components/composer/queue.d.ts +76 -0
- package/dist/types/components/copy/copy-button.d.ts +6 -4
- package/dist/types/components/copy/copy-input.d.ts +10 -6
- package/dist/types/components/datebox/date-range-box.d.ts +33 -0
- package/dist/types/components/datebox/placeholder.d.ts +7 -0
- package/dist/types/components/dialog/dialog.d.ts +2 -2
- package/dist/types/components/dock/dock.d.ts +12 -3
- package/dist/types/components/entity-ref/entity-ref.d.ts +5 -3
- package/dist/types/components/field-upload/field-upload.d.ts +3 -2
- package/dist/types/components/file-item/file-item.d.ts +3 -2
- package/dist/types/components/file-list/file-list.d.ts +14 -8
- package/dist/types/components/filter/filter-model.d.ts +31 -1
- package/dist/types/components/filter/filter.d.ts +20 -2
- package/dist/types/components/finder/finder.d.ts +14 -6
- package/dist/types/components/flag/flag.d.ts +99 -0
- package/dist/types/components/grid/grid.d.ts +1 -1
- package/dist/types/components/kanban-view/kanban-view.d.ts +8 -66
- package/dist/types/components/launcher/launcher.d.ts +2 -0
- package/dist/types/components/modal/modal.d.ts +34 -8
- package/dist/types/components/multi-value-editor/multi-value-editor.d.ts +3 -2
- package/dist/types/components/number-field/number-field.d.ts +41 -7
- package/dist/types/components/prompt-starters/prompt-starters.d.ts +107 -0
- package/dist/types/components/prose/prose.d.ts +9 -6
- package/dist/types/components/questionnaire/conditions.d.ts +270 -0
- package/dist/types/components/questionnaire/items.d.ts +52 -30
- package/dist/types/components/questionnaire/questionnaire.d.ts +44 -4
- package/dist/types/components/rating/rating.d.ts +5 -3
- package/dist/types/components/select/country.d.ts +106 -0
- package/dist/types/components/select/field-adapter.d.ts +2 -1
- package/dist/types/components/select/locale.d.ts +102 -0
- package/dist/types/components/select/select.d.ts +41 -2
- package/dist/types/components/sheet/sheet.d.ts +2 -2
- package/dist/types/components/slider/slider.d.ts +1 -0
- package/dist/types/components/sort-control/sort-control.d.ts +7 -3
- package/dist/types/components/source-list/source-list.d.ts +7 -5
- package/dist/types/components/split-view/split-view.d.ts +5 -3
- package/dist/types/components/surface/catalog.d.ts +260 -0
- package/dist/types/components/surface/elicit.d.ts +81 -0
- package/dist/types/components/surface/mcp.d.ts +165 -0
- package/dist/types/components/surface/schema.d.ts +314 -0
- package/dist/types/components/surface/stream.d.ts +118 -0
- package/dist/types/components/surface/surface.d.ts +718 -0
- package/dist/types/components/surface/text.d.ts +277 -0
- package/dist/types/components/surface/validate.d.ts +339 -0
- package/dist/types/components/table/table.d.ts +55 -3
- package/dist/types/components/table/window.d.ts +203 -0
- package/dist/types/components/toolbar/toolbar.d.ts +10 -6
- package/dist/types/components/tooltip/tooltip.d.ts +2 -2
- package/dist/types/components/tree/tree.d.ts +20 -13
- package/dist/types/core/component.d.ts +10 -0
- package/dist/types/core/date.d.ts +8 -1
- package/dist/types/core/dom.d.ts +15 -0
- package/dist/types/core/http.d.ts +10 -0
- package/dist/types/core/i18n.d.ts +38 -0
- package/dist/types/core/messages.d.ts +344 -1
- package/dist/types/core/storage.d.ts +7 -2
- package/dist/types/elements/define.d.ts +21 -46
- package/dist/types/elements/definitions.d.ts +147 -0
- package/dist/types/elements/kit.d.ts +7 -0
- package/dist/types/elements/reflect.d.ts +6 -3
- package/dist/types/index.d.ts +10 -1
- package/dist/types/internal/date-locale.d.ts +7 -0
- package/dist/types/internal/json-patch.d.ts +146 -0
- package/dist/types/locales/de.d.ts +13 -0
- package/dist/types/locales/en.d.ts +2 -0
- package/dist/types/locales/index.d.ts +823 -0
- package/dist/types/zeyos/view.d.ts +8 -1
- package/dist/zx-zeyos.esm.js +16852 -15131
- package/dist/zx-zeyos.esm.min.js +5 -5
- package/dist/zx.core.css +1276 -0
- package/dist/zx.core.min.css +1 -0
- package/dist/zx.css +520 -143
- package/dist/zx.esm.js +40940 -29684
- package/dist/zx.esm.min.js +36 -23
- package/dist/zx.global.js +40940 -29684
- package/dist/zx.global.min.js +36 -23
- package/dist/zx.layered.css +17315 -0
- package/dist/zx.layered.min.css +1 -0
- package/dist/zx.min.css +1 -1
- package/docs/agent-catalog.json +12501 -0
- package/docs/agent-surfaces.md +340 -0
- package/docs/api.json +909 -137
- package/docs/llms.md +1046 -80
- package/docs/llms.txt +30 -9
- package/package.json +29 -6
- package/src/components/account-menu/account-menu.js +6 -3
- package/src/components/activity-item/activity-item.js +2 -1
- package/src/components/activity-list/activity-list.js +16 -10
- package/src/components/agent-thread/ag-ui.js +1439 -0
- package/src/components/agent-thread/agent-thread.js +359 -54
- package/src/components/agent-thread/ui-message-stream.js +1281 -0
- package/src/components/app-sidebar/app-sidebar.js +18 -8
- package/src/components/approval-card/approval-card.js +3 -2
- package/src/components/block-view/block-view.js +7 -6
- package/src/components/breadcrumb/breadcrumb.js +8 -5
- package/src/components/button/button.css +24 -11
- package/src/components/calendar/calendar-model.js +8 -2
- package/src/components/calendar/calendar.js +53 -18
- package/src/components/chart/chart.js +54 -23
- package/src/components/checklist/checklist.css +9 -1
- package/src/components/checklist/checklist.js +59 -3
- package/src/components/checklist/field-adapter.js +2 -11
- package/src/components/code-editor/code-editor.js +45 -8
- package/src/components/code-editor/field-adapter.js +1 -1
- package/src/components/composer/composer.css +80 -1
- package/src/components/composer/composer.js +390 -16
- package/src/components/composer/queue.js +78 -0
- package/src/components/context-menu/context-menu.js +12 -1
- package/src/components/copy/copy-button.js +9 -7
- package/src/components/copy/copy-input.js +10 -6
- package/src/components/date-picker/date-picker.js +2 -1
- package/src/components/date-picker/date-range-picker.js +8 -7
- package/src/components/datebox/date-range-box.js +3 -9
- package/src/components/datebox/datebox.js +18 -21
- package/src/components/datebox/placeholder.js +18 -0
- package/src/components/dialog/dialog.js +4 -5
- package/src/components/dock/dock.js +34 -13
- package/src/components/entity-ref/entity-ref.js +16 -5
- package/src/components/field-upload/field-upload.js +81 -38
- package/src/components/file-item/file-item.js +70 -40
- package/src/components/file-list/file-list.js +15 -9
- package/src/components/filter/filter-model.js +46 -8
- package/src/components/filter/filter.css +3 -3
- package/src/components/filter/filter.js +29 -10
- package/src/components/filter-panel/filter-panel.js +13 -5
- package/src/components/finder/finder.js +50 -26
- package/src/components/flag/flag.css +40 -0
- package/src/components/flag/flag.js +177 -0
- package/src/components/form/form.js +1 -1
- package/src/components/grid/grid.js +22 -8
- package/src/components/kanban-view/kanban-view.js +51 -81
- package/src/components/launcher/launcher.js +17 -2
- package/src/components/list-toolbar/list-toolbar.js +2 -1
- package/src/components/master-panel/master-panel.js +1 -1
- package/src/components/menu-button/menu-button.js +4 -0
- package/src/components/message/message.js +3 -0
- package/src/components/modal/modal.js +62 -8
- package/src/components/multi-value-editor/multi-value-editor.js +10 -9
- package/src/components/navigation-bar/navigation-bar.js +3 -3
- package/src/components/number-field/number-field.js +98 -29
- package/src/components/prompt-starters/prompt-starters.css +91 -0
- package/src/components/prompt-starters/prompt-starters.js +206 -0
- package/src/components/prose/prose.js +14 -10
- package/src/components/questionnaire/conditions.js +666 -0
- package/src/components/questionnaire/items.js +150 -41
- package/src/components/questionnaire/questionnaire.js +126 -32
- package/src/components/rating/rating.js +5 -4
- package/src/components/run-status/run-status.js +2 -2
- package/src/components/select/country.js +136 -0
- package/src/components/select/field-adapter.js +7 -2
- package/src/components/select/locale.js +219 -0
- package/src/components/select/select.css +20 -22
- package/src/components/select/select.js +94 -12
- package/src/components/sheet/sheet-stack.js +10 -1
- package/src/components/sheet/sheet.js +12 -5
- package/src/components/slider/slider.js +7 -2
- package/src/components/sort-control/sort-control.js +15 -5
- package/src/components/source-list/source-list.js +7 -4
- package/src/components/split-view/split-view.js +5 -3
- package/src/components/surface/catalog.js +1334 -0
- package/src/components/surface/elicit.js +107 -0
- package/src/components/surface/mcp.js +243 -0
- package/src/components/surface/schema.js +644 -0
- package/src/components/surface/stream.js +245 -0
- package/src/components/surface/surface.css +308 -0
- package/src/components/surface/surface.js +2291 -0
- package/src/components/surface/text.js +513 -0
- package/src/components/surface/validate.js +2218 -0
- package/src/components/tabbox/tabbox.js +9 -0
- package/src/components/table/table.css +63 -3
- package/src/components/table/table.js +167 -28
- package/src/components/table/window.js +317 -0
- package/src/components/toolbar/toolbar.js +12 -7
- package/src/components/tooltip/tooltip.css +2 -3
- package/src/components/tooltip/tooltip.js +32 -5
- package/src/components/tree/tree.js +53 -23
- package/src/core/component.js +25 -1
- package/src/core/date.js +62 -16
- package/src/core/dom.js +67 -4
- package/src/core/format.js +15 -13
- package/src/core/http.js +29 -20
- package/src/core/i18n.js +83 -10
- package/src/core/icons.js +13 -2
- package/src/core/keyboard.js +79 -8
- package/src/core/messages.js +376 -2
- package/src/core/overlay-host.js +1 -0
- package/src/core/position.js +3 -2
- package/src/core/storage.js +59 -6
- package/src/elements/define.js +178 -130
- package/src/elements/definitions.js +229 -0
- package/src/elements/kit.js +444 -0
- package/src/elements/reflect.js +8 -3
- package/src/index.js +10 -1
- package/src/internal/date-locale.js +11 -0
- package/src/internal/json-patch.js +405 -0
- package/src/locales/de.js +911 -0
- package/src/locales/en.js +2 -0
- package/src/locales/index.js +7 -0
- package/src/zeyos/calendar.js +2 -1
- package/src/zeyos/form.js +2 -1
- package/src/zeyos/launcher.js +7 -6
- package/src/zeyos/module-bar.js +2 -1
- package/src/zeyos/schema.js +37 -23
- package/src/zeyos/select.js +4 -3
- package/src/zeyos/table.js +2 -13
- package/src/zeyos/view.js +57 -17
- package/styles/core.css +11 -0
- package/styles/tokens/semantic.css +1 -0
- package/styles/zeyos.css +2 -0
- package/styles/zx.css +4 -8
- package/styles/zx.layered.css +1 -0
|
@@ -1,48 +1,6 @@
|
|
|
1
|
-
|
|
2
|
-
export type
|
|
3
|
-
export type
|
|
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
|
-
*
|
|
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
|
/**
|
package/dist/types/index.d.ts
CHANGED
|
@@ -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>>;
|