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