@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
|
@@ -73,9 +73,12 @@ export type CalendarOptions = {
|
|
|
73
73
|
*/
|
|
74
74
|
eventStartEditable?: boolean | null;
|
|
75
75
|
/**
|
|
76
|
-
*
|
|
76
|
+
* Resize policy for events that
|
|
77
|
+
* set none of their own: `true` or `false`, or null to follow `editable`. A string or function
|
|
78
|
+
* instead names the per-event resize field, read as the other `event*` readers are
|
|
79
|
+
* (`'durationEditable'` when none is given).
|
|
77
80
|
*/
|
|
78
|
-
eventDurationEditable?: boolean | null;
|
|
81
|
+
eventDurationEditable?: boolean | null | CalendarReader;
|
|
79
82
|
/**
|
|
80
83
|
* Apply event proposals locally before persistence confirms.
|
|
81
84
|
*/
|
|
@@ -124,10 +127,6 @@ export type CalendarOptions = {
|
|
|
124
127
|
* Per-event move reader.
|
|
125
128
|
*/
|
|
126
129
|
eventEditable?: CalendarReader;
|
|
127
|
-
/**
|
|
128
|
-
* Per-event resize reader.
|
|
129
|
-
*/
|
|
130
|
-
eventDurationEditable?: CalendarReader;
|
|
131
130
|
/**
|
|
132
131
|
* Unit for numeric event dates.
|
|
133
132
|
*/
|
|
@@ -274,7 +273,10 @@ export type CalendarSetOptions = {
|
|
|
274
273
|
* @property {boolean} [selectable=false] Enable pointer time-range selection.
|
|
275
274
|
* @property {boolean} [editable=false] Enable event moving and resizing.
|
|
276
275
|
* @property {boolean|null} [eventStartEditable=null] Global move override; null inherits editable.
|
|
277
|
-
* @property {boolean|null} [eventDurationEditable=null]
|
|
276
|
+
* @property {boolean|null|CalendarReader} [eventDurationEditable=null] Resize policy for events that
|
|
277
|
+
* set none of their own: `true` or `false`, or null to follow `editable`. A string or function
|
|
278
|
+
* instead names the per-event resize field, read as the other `event*` readers are
|
|
279
|
+
* (`'durationEditable'` when none is given).
|
|
278
280
|
* @property {boolean} [optimistic=true] Apply event proposals locally before persistence confirms.
|
|
279
281
|
* @property {boolean} [nowIndicator=true] Show the current-time line in day/week views.
|
|
280
282
|
* @property {Date|(() => Date)|null} [now=null] Current-time override for deterministic rendering.
|
|
@@ -287,7 +289,6 @@ export type CalendarSetOptions = {
|
|
|
287
289
|
* @property {CalendarReader} [eventColor='color'] Event colour reader.
|
|
288
290
|
* @property {CalendarReader} [eventLocation='location'] Event location reader.
|
|
289
291
|
* @property {CalendarReader} [eventEditable='editable'] Per-event move reader.
|
|
290
|
-
* @property {CalendarReader} [eventDurationEditable='durationEditable'] Per-event resize reader.
|
|
291
292
|
* @property {'milliseconds'|'seconds'} [dateUnit='milliseconds'] Unit for numeric event dates.
|
|
292
293
|
* @property {Record<string, string>} [msg] Per-instance messages, keyed `calendar.*` (`calendar.today`,
|
|
293
294
|
* `calendar.next`, …). The bare keys of earlier versions (`today`, `next`) are still read, after the
|
|
@@ -330,10 +331,7 @@ export type CalendarSetOptions = {
|
|
|
330
331
|
*/
|
|
331
332
|
export declare class Calendar extends Component<CalendarOptions> {
|
|
332
333
|
_createdRoot: boolean;
|
|
333
|
-
|
|
334
|
-
attributes: string[][];
|
|
335
|
-
children: ChildNode[];
|
|
336
|
-
};
|
|
334
|
+
_snapshot: import("../../core/dom.js").TargetSnapshot;
|
|
337
335
|
_views: import("./calendar-model.js").CalendarView[];
|
|
338
336
|
_view: any;
|
|
339
337
|
_date: Date;
|
|
@@ -380,6 +378,8 @@ export declare class Calendar extends Component<CalendarOptions> {
|
|
|
380
378
|
_suppressClickId: string;
|
|
381
379
|
_suppressDateClick: boolean;
|
|
382
380
|
_focusedSlot: any;
|
|
381
|
+
/** @type {string|null} Day key of the date cell the keyboard was last on. */
|
|
382
|
+
_focusedDate: string | null;
|
|
383
383
|
_selection: any;
|
|
384
384
|
_nowTimer: number;
|
|
385
385
|
_range: {
|
|
@@ -395,8 +395,15 @@ export declare class Calendar extends Component<CalendarOptions> {
|
|
|
395
395
|
getEvents(): CalendarEvent[];
|
|
396
396
|
/** Replaces all source records atomically. @param {Record<string, any>[]} events @param {CalendarSetOptions} [options={}] @returns {this} */
|
|
397
397
|
setEvents(events: Record<string, any>[], options?: CalendarSetOptions): this;
|
|
398
|
-
/**
|
|
399
|
-
|
|
398
|
+
/**
|
|
399
|
+
* Adds one source event. Given an event name and a listener instead, it is the `addEvent()` alias
|
|
400
|
+
* of `on()` that every component has.
|
|
401
|
+
* @param {Record<string, any>|string} event Source event, or a component event name.
|
|
402
|
+
* @param {CalendarSetOptions|import('../../core/component.js').ComponentListener|EventListenerObject} [options={}]
|
|
403
|
+
* Set options, or the listener when `event` is a name.
|
|
404
|
+
* @returns {this}
|
|
405
|
+
*/
|
|
406
|
+
addEvent(event: Record<string, any> | string, options?: CalendarSetOptions | import('../../core/component.js').ComponentListener | EventListenerObject): this;
|
|
400
407
|
/**
|
|
401
408
|
* Updates one normalized event. Date changes accept valid Date objects, ISO strings, or numeric
|
|
402
409
|
* values in the configured date unit.
|
|
@@ -460,6 +467,20 @@ export declare class Calendar extends Component<CalendarOptions> {
|
|
|
460
467
|
start: Date;
|
|
461
468
|
end: Date;
|
|
462
469
|
}): HTMLElement;
|
|
470
|
+
/**
|
|
471
|
+
* Gives the date cells of a month or year view a single Tab stop, after the APG grid pattern:
|
|
472
|
+
* the date the keyboard was last on, else the anchor date, else today, else the first day of
|
|
473
|
+
* the period. The arrow keys move it with the focus.
|
|
474
|
+
* @param {Element} container The rendered view.
|
|
475
|
+
* @returns {void}
|
|
476
|
+
*/
|
|
477
|
+
_rovingDates(container: Element): void;
|
|
478
|
+
/**
|
|
479
|
+
* Makes a month or year date cell the grid's Tab stop, and remembers it across re-renders.
|
|
480
|
+
* @param {HTMLElement} cell Date cell.
|
|
481
|
+
* @returns {void}
|
|
482
|
+
*/
|
|
483
|
+
_moveDateStop(cell: HTMLElement): void;
|
|
463
484
|
/**
|
|
464
485
|
* @param {CalendarEvent} event
|
|
465
486
|
* @param {{variant: 'agenda'|'timed'|'span'|'month', day: Date, resizable?: boolean}} context
|
|
@@ -552,20 +573,22 @@ export declare class Calendar extends Component<CalendarOptions> {
|
|
|
552
573
|
_dateFromTarget(target: HTMLElement): Date | null;
|
|
553
574
|
/** @param {HTMLElement} target @returns {void} */
|
|
554
575
|
_rememberFocusedDate(target: HTMLElement): void;
|
|
555
|
-
/** @returns {{eventId?: string, eventAction?: string, date?: string, slot?: string, row?: string, column?: string}|null} */
|
|
576
|
+
/** @returns {{eventId?: string, eventAction?: string, date?: string, dateCell?: string, slot?: string, row?: string, column?: string}|null} */
|
|
556
577
|
_focusIdentity(): {
|
|
557
578
|
eventId?: string;
|
|
558
579
|
eventAction?: string;
|
|
559
580
|
date?: string;
|
|
581
|
+
dateCell?: string;
|
|
560
582
|
slot?: string;
|
|
561
583
|
row?: string;
|
|
562
584
|
column?: string;
|
|
563
585
|
} | null;
|
|
564
|
-
/** @param {{eventId?: string, eventAction?: string, date?: string, slot?: string, row?: string, column?: string}} identity @returns {void} */
|
|
586
|
+
/** @param {{eventId?: string, eventAction?: string, date?: string, dateCell?: string, slot?: string, row?: string, column?: string}} identity @returns {void} */
|
|
565
587
|
_restoreFocus(identity: {
|
|
566
588
|
eventId?: string;
|
|
567
589
|
eventAction?: string;
|
|
568
590
|
date?: string;
|
|
591
|
+
dateCell?: string;
|
|
569
592
|
slot?: string;
|
|
570
593
|
row?: string;
|
|
571
594
|
column?: string;
|
|
@@ -594,13 +617,3 @@ export declare class Calendar extends Component<CalendarOptions> {
|
|
|
594
617
|
*/
|
|
595
618
|
_message(key: string, fallback: string, ...args: unknown[]): string;
|
|
596
619
|
}
|
|
597
|
-
/** @event Calendar#viewchange @type {CustomEvent<{view: CalendarView, oldView: CalendarView}>} */
|
|
598
|
-
/** @event Calendar#dateschange @type {CustomEvent<{view: CalendarView, start: Date, end: Date}>} */
|
|
599
|
-
/** @event Calendar#eventclick @type {CustomEvent<{event: CalendarEvent, jsEvent: Event}>} */
|
|
600
|
-
/** @event Calendar#eventdblclick @type {CustomEvent<{event: CalendarEvent, jsEvent: Event}>} */
|
|
601
|
-
/** @event Calendar#dateclick @type {CustomEvent<{date: Date, allDay: boolean, view: CalendarView, jsEvent: Event}>} */
|
|
602
|
-
/** @event Calendar#select @type {CustomEvent<{start: Date, end: Date, allDay: boolean, view: CalendarView, jsEvent: Event}>} */
|
|
603
|
-
/** @event Calendar#eventchange @type {CustomEvent<CalendarEventChangeDetail>} */
|
|
604
|
-
/** @event Calendar#eventschange @type {CustomEvent<{events: CalendarEvent[]}>} */
|
|
605
|
-
/** @event Calendar#new @type {CustomEvent<{date: Date, view: CalendarView, jsEvent: Event}>} */
|
|
606
|
-
/** @event Calendar#moreclick @type {CustomEvent<{date: Date, count: number, jsEvent: Event}>} */
|
|
@@ -10,6 +10,28 @@ export type ChartData = {
|
|
|
10
10
|
[key: string]: unknown;
|
|
11
11
|
};
|
|
12
12
|
export type ChartText = (key: string, ...args: unknown[]) => string;
|
|
13
|
+
export type ChartTheme = {
|
|
14
|
+
/**
|
|
15
|
+
* Text colour, from `--zx-color-text`. Absent where the token is not
|
|
16
|
+
* defined (no Zx stylesheet).
|
|
17
|
+
*/
|
|
18
|
+
color?: string;
|
|
19
|
+
/**
|
|
20
|
+
* Grid and axis line colour, from `--zx-color-border`. Absent
|
|
21
|
+
* where the token is not defined.
|
|
22
|
+
*/
|
|
23
|
+
borderColor?: string;
|
|
24
|
+
/**
|
|
25
|
+
* The surface the chart is drawn on, from `--zx-color-bg-surface`,
|
|
26
|
+
* for what has to mask the grid behind a label. Absent where the token is not defined.
|
|
27
|
+
*/
|
|
28
|
+
background?: string;
|
|
29
|
+
/**
|
|
30
|
+
* The categorical series colours, `--zx-color-chart-1` to `-8`, in
|
|
31
|
+
* order; empty where the tokens are not defined. Series beyond the eighth start over.
|
|
32
|
+
*/
|
|
33
|
+
palette: string[];
|
|
34
|
+
};
|
|
13
35
|
export type ChartSpec = {
|
|
14
36
|
/**
|
|
15
37
|
* Chart type.
|
|
@@ -20,9 +42,17 @@ export type ChartSpec = {
|
|
|
20
42
|
*/
|
|
21
43
|
data: ChartData;
|
|
22
44
|
/**
|
|
23
|
-
* Engine-specific options
|
|
45
|
+
* Engine-specific options: the application's
|
|
46
|
+
* `chartOptions`, over `color` and `borderColor` from the theme (the same strings as
|
|
47
|
+
* `theme.color` and `theme.borderColor`, in the shape Chart.js reads them). Chart.js takes the
|
|
48
|
+
* colours of its axes from its global defaults rather than from these, so `ChartJsAdapter` also
|
|
49
|
+
* gives every scale the theme's colours wherever the options leave one unset.
|
|
24
50
|
*/
|
|
25
51
|
options: Record<string, unknown>;
|
|
52
|
+
/**
|
|
53
|
+
* Resolved theme colours, including the categorical palette.
|
|
54
|
+
*/
|
|
55
|
+
theme: ChartTheme;
|
|
26
56
|
/**
|
|
27
57
|
* Whether the chart must not animate: the operating system asks
|
|
28
58
|
* for reduced motion, or the host sits inside a `data-zx-motion="reduced"` region. An adapter turns
|
|
@@ -36,11 +66,12 @@ export type ChartSpec = {
|
|
|
36
66
|
};
|
|
37
67
|
export type ChartHandle = {
|
|
38
68
|
/**
|
|
39
|
-
* Update the mounted chart.
|
|
69
|
+
* Update the mounted chart. Called for new data, type
|
|
70
|
+
* or options, and whenever the theme or the motion preference changes.
|
|
40
71
|
*/
|
|
41
72
|
update: (spec: ChartSpec) => void;
|
|
42
73
|
/**
|
|
43
|
-
* Resize the mounted chart.
|
|
74
|
+
* Resize the mounted chart; called when the viewport changes size.
|
|
44
75
|
*/
|
|
45
76
|
resize: () => void;
|
|
46
77
|
/**
|
|
@@ -53,8 +84,52 @@ export type ChartHandle = {
|
|
|
53
84
|
instance?: unknown;
|
|
54
85
|
};
|
|
55
86
|
export type ChartAdapter = {
|
|
56
|
-
|
|
87
|
+
/**
|
|
88
|
+
* Creates the
|
|
89
|
+
* engine on the chart's canvas. Chart calls it once the canvas is connected to a document and its
|
|
90
|
+
* viewport has a size, so the engine can measure the canvas and `spec.theme` carries real values;
|
|
91
|
+
* a chart that is loading, empty or in error has no engine. Where the environment has no
|
|
92
|
+
* `ResizeObserver`, or no layout at all, there is nothing to wait for and `create()` runs as soon
|
|
93
|
+
* as the chart has data.
|
|
94
|
+
*/
|
|
95
|
+
create?: (canvas: HTMLCanvasElement, spec: ChartSpec) => ChartHandle;
|
|
96
|
+
/**
|
|
97
|
+
* Creates the engine
|
|
98
|
+
* with an element of its own, appended to the chart's viewport, at the moment `create()` would
|
|
99
|
+
* run. The canvas stays in place, empty, and keeps the chart's accessible name and description;
|
|
100
|
+
* what the adapter appends lies over it, is presentational (`aria-hidden="true"`), and is removed
|
|
101
|
+
* by the handle's `destroy()`. `SvgChartAdapter` is one.
|
|
102
|
+
*/
|
|
103
|
+
mount?: (viewport: HTMLElement, spec: ChartSpec) => ChartHandle;
|
|
57
104
|
};
|
|
105
|
+
export type ChartSummaryContext = {
|
|
106
|
+
/**
|
|
107
|
+
* The series the value belongs to.
|
|
108
|
+
*/
|
|
109
|
+
dataset: ChartDataset;
|
|
110
|
+
/**
|
|
111
|
+
* Index of that series in `data.datasets`.
|
|
112
|
+
*/
|
|
113
|
+
datasetIndex: number;
|
|
114
|
+
/**
|
|
115
|
+
* Index of the value in the series, and of its row in the table.
|
|
116
|
+
*/
|
|
117
|
+
index: number;
|
|
118
|
+
/**
|
|
119
|
+
* Entry of `data.labels` at that index; undefined where there is none.
|
|
120
|
+
*/
|
|
121
|
+
label: unknown;
|
|
122
|
+
/**
|
|
123
|
+
* The entry of `dataset.data` as it was given — the whole point object
|
|
124
|
+
* where `value` is its `y` or `r`.
|
|
125
|
+
*/
|
|
126
|
+
raw: unknown;
|
|
127
|
+
/**
|
|
128
|
+
* The text the table would show without `summaryFormat`.
|
|
129
|
+
*/
|
|
130
|
+
formatted: string;
|
|
131
|
+
};
|
|
132
|
+
export type ChartSummaryFormat = (value: unknown, context: ChartSummaryContext) => string | null | undefined;
|
|
58
133
|
export type ChartJsAdapterOptions = Object;
|
|
59
134
|
export type ChartSelectDetail = {
|
|
60
135
|
/**
|
|
@@ -84,7 +159,9 @@ export type ChartSelectDetail = {
|
|
|
84
159
|
};
|
|
85
160
|
export type ChartOptions = {
|
|
86
161
|
/**
|
|
87
|
-
*
|
|
162
|
+
* The engine that draws: `new SvgChartAdapter()`
|
|
163
|
+
* needs nothing else, `new ChartJsAdapter(Chart)` an injected Chart.js. Without one the chart
|
|
164
|
+
* draws nothing, and its data lives in the summary table alone.
|
|
88
165
|
*/
|
|
89
166
|
adapter?: ChartAdapter | null;
|
|
90
167
|
/**
|
|
@@ -112,6 +189,13 @@ export type ChartOptions = {
|
|
|
112
189
|
* Semantic data-table presentation.
|
|
113
190
|
*/
|
|
114
191
|
summary?: 'hidden' | 'visible';
|
|
192
|
+
/**
|
|
193
|
+
* Formats a summary-table value. Without
|
|
194
|
+
* it a number is written for the active language (`lang`, else `getLanguage()`) with grouping and
|
|
195
|
+
* up to twelve significant digits — `1234567.5` reads "1,234,567.5", `0.1 + 0.2` reads "0.3" —
|
|
196
|
+
* and any other value as its own text.
|
|
197
|
+
*/
|
|
198
|
+
summaryFormat?: ChartSummaryFormat | null;
|
|
115
199
|
/**
|
|
116
200
|
* Initial loading state.
|
|
117
201
|
*/
|
|
@@ -132,9 +216,17 @@ export type ChartOptions = {
|
|
|
132
216
|
*/
|
|
133
217
|
errorText?: string | null;
|
|
134
218
|
/**
|
|
135
|
-
* Responsive container aspect ratio.
|
|
219
|
+
* Responsive container aspect ratio. Not used in
|
|
220
|
+
* `fill` mode.
|
|
136
221
|
*/
|
|
137
222
|
aspectRatio?: string;
|
|
223
|
+
/**
|
|
224
|
+
* Takes the block size of the container instead of deriving it
|
|
225
|
+
* from `aspectRatio`: the root is 100% tall and the viewport takes what the description and a
|
|
226
|
+
* visible summary leave. The container needs a height of its own. The minimum viewport height
|
|
227
|
+
* is the `--zx-chart-min-block-size` custom property: 220px by default, none in `fill` mode.
|
|
228
|
+
*/
|
|
229
|
+
fill?: boolean;
|
|
138
230
|
/**
|
|
139
231
|
* Engine-ready listener.
|
|
140
232
|
*/
|
|
@@ -162,11 +254,31 @@ export type ChartOptions = {
|
|
|
162
254
|
/** @typedef {{label?: string, data?: unknown[], [key: string]: unknown}} ChartDataset */
|
|
163
255
|
/** @typedef {{labels?: unknown[], datasets?: ChartDataset[], [key: string]: unknown}} ChartData */
|
|
164
256
|
/** @typedef {(key: string, ...args: unknown[]) => string} ChartText Resolves a message. */
|
|
257
|
+
/**
|
|
258
|
+
* @typedef {Object} ChartTheme
|
|
259
|
+
* The theme as the chart root resolves it, read when the engine is created and again on every
|
|
260
|
+
* update. Every colour is a string a CSS Color 3 parser reads: `#rrggbb` when opaque,
|
|
261
|
+
* `rgba(r, g, b, a)` when translucent — never `color()`, `oklch()`, `light-dark()` or a `var()`.
|
|
262
|
+
* @property {string} [color] Text colour, from `--zx-color-text`. Absent where the token is not
|
|
263
|
+
* defined (no Zx stylesheet).
|
|
264
|
+
* @property {string} [borderColor] Grid and axis line colour, from `--zx-color-border`. Absent
|
|
265
|
+
* where the token is not defined.
|
|
266
|
+
* @property {string} [background] The surface the chart is drawn on, from `--zx-color-bg-surface`,
|
|
267
|
+
* for what has to mask the grid behind a label. Absent where the token is not defined.
|
|
268
|
+
* @property {string[]} palette The categorical series colours, `--zx-color-chart-1` to `-8`, in
|
|
269
|
+
* order; empty where the tokens are not defined. Series beyond the eighth start over.
|
|
270
|
+
*/
|
|
165
271
|
/**
|
|
166
272
|
* @typedef {Object} ChartSpec
|
|
273
|
+
* What a `ChartAdapter` receives in `create()` and in every `update()`.
|
|
167
274
|
* @property {string} type Chart type.
|
|
168
275
|
* @property {ChartData} data Chart data.
|
|
169
|
-
* @property {Record<string, unknown>} options Engine-specific options
|
|
276
|
+
* @property {Record<string, unknown>} options Engine-specific options: the application's
|
|
277
|
+
* `chartOptions`, over `color` and `borderColor` from the theme (the same strings as
|
|
278
|
+
* `theme.color` and `theme.borderColor`, in the shape Chart.js reads them). Chart.js takes the
|
|
279
|
+
* colours of its axes from its global defaults rather than from these, so `ChartJsAdapter` also
|
|
280
|
+
* gives every scale the theme's colours wherever the options leave one unset.
|
|
281
|
+
* @property {ChartTheme} theme Resolved theme colours, including the categorical palette.
|
|
170
282
|
* @property {boolean} reducedMotion Whether the chart must not animate: the operating system asks
|
|
171
283
|
* for reduced motion, or the host sits inside a `data-zx-motion="reduced"` region. An adapter turns
|
|
172
284
|
* its engine's own animation off when this is true; `ChartJsAdapter` sets `animation: false`.
|
|
@@ -174,12 +286,44 @@ export type ChartOptions = {
|
|
|
174
286
|
*/
|
|
175
287
|
/**
|
|
176
288
|
* @typedef {Object} ChartHandle
|
|
177
|
-
* @property {(spec: ChartSpec) => void} update Update the mounted chart.
|
|
178
|
-
*
|
|
289
|
+
* @property {(spec: ChartSpec) => void} update Update the mounted chart. Called for new data, type
|
|
290
|
+
* or options, and whenever the theme or the motion preference changes.
|
|
291
|
+
* @property {() => void} resize Resize the mounted chart; called when the viewport changes size.
|
|
179
292
|
* @property {() => void} destroy Destroy the mounted chart.
|
|
180
293
|
* @property {unknown} [instance] Engine instance.
|
|
181
294
|
*/
|
|
182
|
-
/**
|
|
295
|
+
/**
|
|
296
|
+
* @typedef {Object} ChartAdapter
|
|
297
|
+
* The contract between Chart and a chart engine. An engine that paints a canvas implements
|
|
298
|
+
* `create()`; one that draws an element of its own, such as an SVG, implements `mount()`. Chart
|
|
299
|
+
* calls `mount()` when an adapter has it, `create()` otherwise.
|
|
300
|
+
* @property {(canvas: HTMLCanvasElement, spec: ChartSpec) => ChartHandle} [create] Creates the
|
|
301
|
+
* engine on the chart's canvas. Chart calls it once the canvas is connected to a document and its
|
|
302
|
+
* viewport has a size, so the engine can measure the canvas and `spec.theme` carries real values;
|
|
303
|
+
* a chart that is loading, empty or in error has no engine. Where the environment has no
|
|
304
|
+
* `ResizeObserver`, or no layout at all, there is nothing to wait for and `create()` runs as soon
|
|
305
|
+
* as the chart has data.
|
|
306
|
+
* @property {(viewport: HTMLElement, spec: ChartSpec) => ChartHandle} [mount] Creates the engine
|
|
307
|
+
* with an element of its own, appended to the chart's viewport, at the moment `create()` would
|
|
308
|
+
* run. The canvas stays in place, empty, and keeps the chart's accessible name and description;
|
|
309
|
+
* what the adapter appends lies over it, is presentational (`aria-hidden="true"`), and is removed
|
|
310
|
+
* by the handle's `destroy()`. `SvgChartAdapter` is one.
|
|
311
|
+
*/
|
|
312
|
+
/**
|
|
313
|
+
* @typedef {Object} ChartSummaryContext
|
|
314
|
+
* @property {ChartDataset} dataset The series the value belongs to.
|
|
315
|
+
* @property {number} datasetIndex Index of that series in `data.datasets`.
|
|
316
|
+
* @property {number} index Index of the value in the series, and of its row in the table.
|
|
317
|
+
* @property {unknown} label Entry of `data.labels` at that index; undefined where there is none.
|
|
318
|
+
* @property {unknown} raw The entry of `dataset.data` as it was given — the whole point object
|
|
319
|
+
* where `value` is its `y` or `r`.
|
|
320
|
+
* @property {string} formatted The text the table would show without `summaryFormat`.
|
|
321
|
+
*/
|
|
322
|
+
/**
|
|
323
|
+
* @typedef {(value: unknown, context: ChartSummaryContext) => string|null|undefined} ChartSummaryFormat
|
|
324
|
+
* Formats one cell of the summary table. `value` is the data entry, or `y` (else `r`) of a point
|
|
325
|
+
* object; the returned text is the cell, and null or undefined keeps `context.formatted`.
|
|
326
|
+
*/
|
|
183
327
|
/**
|
|
184
328
|
* @typedef {Object} ChartJsAdapterOptions
|
|
185
329
|
* Generated API marker for the adapter class; its constructor accepts an injected engine and
|
|
@@ -196,7 +340,9 @@ export type ChartOptions = {
|
|
|
196
340
|
*/
|
|
197
341
|
/**
|
|
198
342
|
* @typedef {Object} ChartOptions
|
|
199
|
-
* @property {ChartAdapter|null} [adapter=null]
|
|
343
|
+
* @property {ChartAdapter|null} [adapter=null] The engine that draws: `new SvgChartAdapter()`
|
|
344
|
+
* needs nothing else, `new ChartJsAdapter(Chart)` an injected Chart.js. Without one the chart
|
|
345
|
+
* draws nothing, and its data lives in the summary table alone.
|
|
200
346
|
* @property {string} [type='bar'] Chart type passed to the adapter.
|
|
201
347
|
* @property {ChartData} [data={labels: [], datasets: []}] Chart data.
|
|
202
348
|
* @property {Record<string, unknown>} [chartOptions={}] Engine-specific options.
|
|
@@ -204,6 +350,10 @@ export type ChartOptions = {
|
|
|
204
350
|
* the `chart.label` message ("Chart").
|
|
205
351
|
* @property {string} [description=''] Accessible description.
|
|
206
352
|
* @property {'hidden'|'visible'} [summary='hidden'] Semantic data-table presentation.
|
|
353
|
+
* @property {ChartSummaryFormat|null} [summaryFormat=null] Formats a summary-table value. Without
|
|
354
|
+
* it a number is written for the active language (`lang`, else `getLanguage()`) with grouping and
|
|
355
|
+
* up to twelve significant digits — `1234567.5` reads "1,234,567.5", `0.1 + 0.2` reads "0.3" —
|
|
356
|
+
* and any other value as its own text.
|
|
207
357
|
* @property {boolean} [loading=false] Initial loading state.
|
|
208
358
|
* @property {string|null} [emptyText] Empty-state text, by default the `chart.empty` message
|
|
209
359
|
* ("No chart data"). Null shows none.
|
|
@@ -211,7 +361,12 @@ export type ChartOptions = {
|
|
|
211
361
|
* ("Loading chart…"). Null shows none.
|
|
212
362
|
* @property {string|null} [errorText] Error fallback text, by default the `chart.error` message
|
|
213
363
|
* ("Unable to render chart"). Null shows none.
|
|
214
|
-
* @property {string} [aspectRatio='16 / 9'] Responsive container aspect ratio.
|
|
364
|
+
* @property {string} [aspectRatio='16 / 9'] Responsive container aspect ratio. Not used in
|
|
365
|
+
* `fill` mode.
|
|
366
|
+
* @property {boolean} [fill=false] Takes the block size of the container instead of deriving it
|
|
367
|
+
* from `aspectRatio`: the root is 100% tall and the viewport takes what the description and a
|
|
368
|
+
* visible summary leave. The container needs a height of its own. The minimum viewport height
|
|
369
|
+
* is the `--zx-chart-min-block-size` custom property: 220px by default, none in `fill` mode.
|
|
215
370
|
* @property {(event: CustomEvent<{instance: unknown}>) => void} [onready] Engine-ready listener.
|
|
216
371
|
* @property {(event: CustomEvent<{data: ChartData, type: string}>) => void} [onupdate] Update listener.
|
|
217
372
|
* @property {(event: CustomEvent<ChartSelectDetail>) => void} [onselect] Point-selection listener.
|
|
@@ -227,10 +382,7 @@ export type ChartOptions = {
|
|
|
227
382
|
*/
|
|
228
383
|
export declare class Chart extends Component<ChartOptions> {
|
|
229
384
|
_createdRoot: boolean;
|
|
230
|
-
|
|
231
|
-
attributes: string[][];
|
|
232
|
-
children: ChildNode[];
|
|
233
|
-
};
|
|
385
|
+
_snapshot: import("../../core/dom.js").TargetSnapshot;
|
|
234
386
|
_adapter: ChartAdapter;
|
|
235
387
|
_type: string;
|
|
236
388
|
_data: ChartData;
|
|
@@ -241,7 +393,10 @@ export declare class Chart extends Component<ChartOptions> {
|
|
|
241
393
|
_hasError: boolean;
|
|
242
394
|
_handle: ChartHandle;
|
|
243
395
|
_destroyed: boolean;
|
|
396
|
+
_themeKey: string;
|
|
397
|
+
_sized: boolean;
|
|
244
398
|
_observer: ResizeObserver;
|
|
399
|
+
_themeObserver: MutationObserver;
|
|
245
400
|
_stopWatchingMotion: () => void;
|
|
246
401
|
static cssName: string;
|
|
247
402
|
/** @type {Readonly<ChartOptions>} */
|
|
@@ -268,16 +423,80 @@ export declare class Chart extends Component<ChartOptions> {
|
|
|
268
423
|
setError(error: unknown): this;
|
|
269
424
|
/** Clears the error and remounts when data and an adapter are available. @returns {this} */
|
|
270
425
|
clearError(): this;
|
|
271
|
-
/**
|
|
426
|
+
/**
|
|
427
|
+
* Changes the accessible name of the canvas and the caption of the summary table.
|
|
428
|
+
* @param {string|null} label Label; null or blank text reads the `chart.label` message.
|
|
429
|
+
* @returns {this}
|
|
430
|
+
*/
|
|
431
|
+
setLabel(label: string | null): this;
|
|
432
|
+
/**
|
|
433
|
+
* Changes the description under the chart, which also describes the canvas.
|
|
434
|
+
* @param {string|null} description Description; null or empty text shows none.
|
|
435
|
+
* @returns {this}
|
|
436
|
+
*/
|
|
437
|
+
setDescription(description: string | null): this;
|
|
438
|
+
/**
|
|
439
|
+
* Shows the summary table or leaves it to assistive technology only.
|
|
440
|
+
* @param {'hidden'|'visible'} summary Presentation.
|
|
441
|
+
* @returns {this}
|
|
442
|
+
*/
|
|
443
|
+
setSummary(summary: 'hidden' | 'visible'): this;
|
|
444
|
+
/**
|
|
445
|
+
* Changes the aspect ratio of the viewport. It has no effect while the chart is in `fill` mode.
|
|
446
|
+
* @param {string|number|null} aspectRatio A CSS `aspect-ratio` value such as `'16 / 9'` or `2`;
|
|
447
|
+
* null or blank text restores the default.
|
|
448
|
+
* @returns {this}
|
|
449
|
+
*/
|
|
450
|
+
setAspectRatio(aspectRatio: string | number | null): this;
|
|
451
|
+
/**
|
|
452
|
+
* Switches `fill` mode, in which the chart takes the block size of its container.
|
|
453
|
+
* @param {boolean} [fill=true] Whether to fill the container.
|
|
454
|
+
* @returns {this}
|
|
455
|
+
*/
|
|
456
|
+
setFill(fill?: boolean): this;
|
|
457
|
+
/**
|
|
458
|
+
* Requests an engine resize. The chart follows its viewport on its own; this is for an engine
|
|
459
|
+
* that needs telling after something else changed.
|
|
460
|
+
* @returns {this}
|
|
461
|
+
*/
|
|
272
462
|
resize(): this;
|
|
273
|
-
/**
|
|
463
|
+
/**
|
|
464
|
+
* Re-applies computed theme values through the adapter update path. The chart does this itself
|
|
465
|
+
* when a `data-zx-theme` or `data-zx-preset` attribute changes anywhere in the document, when the
|
|
466
|
+
* system colour scheme or contrast preference changes, and when it is shown again after being
|
|
467
|
+
* hidden or moved; call it after changing tokens in a way none of those cover — a stylesheet
|
|
468
|
+
* swap, a class, or an inline custom property.
|
|
469
|
+
* @returns {this}
|
|
470
|
+
*/
|
|
274
471
|
refreshTheme(): this;
|
|
275
|
-
/**
|
|
472
|
+
/**
|
|
473
|
+
* Returns the underlying engine instance when the adapter exposes it. The engine exists once
|
|
474
|
+
* the chart is connected, displayed, and has data; asking for it right after appending the
|
|
475
|
+
* chart creates it then rather than on the next frame.
|
|
476
|
+
* @returns {unknown} Null while there is no engine.
|
|
477
|
+
*/
|
|
276
478
|
getInstance(): unknown;
|
|
277
479
|
/** Destroys the engine/observer and restores or removes the host. @returns {void} */
|
|
278
480
|
destroy(): void;
|
|
279
481
|
/** @param {boolean} emitUpdate @returns {void} */
|
|
280
482
|
_mountOrUpdate(emitUpdate: boolean): void;
|
|
483
|
+
/**
|
|
484
|
+
* Whether an engine can be created now: the canvas is in a document and its viewport has a size.
|
|
485
|
+
* An environment that cannot say — no `ResizeObserver` to report the size later, or no layout at
|
|
486
|
+
* all (jsdom measures everything as zero) — is not made to wait for an answer it will never get.
|
|
487
|
+
* @returns {boolean}
|
|
488
|
+
*/
|
|
489
|
+
_canMount(): boolean;
|
|
490
|
+
/**
|
|
491
|
+
* The viewport changed size: create the engine if it was waiting for one, otherwise resize it.
|
|
492
|
+
* A viewport that had no size and has one again was hidden or moved, possibly into another
|
|
493
|
+
* theme region, so the theme is read again too.
|
|
494
|
+
* @param {ResizeObserverEntry[]} entries
|
|
495
|
+
* @returns {void}
|
|
496
|
+
*/
|
|
497
|
+
_viewportResized(entries: ResizeObserverEntry[]): void;
|
|
498
|
+
/** Updates the engine when the theme it was given is no longer the one the root resolves. @returns {void} */
|
|
499
|
+
_syncTheme(): void;
|
|
281
500
|
/** @returns {ChartSpec} */
|
|
282
501
|
_spec(): ChartSpec;
|
|
283
502
|
/** @returns {void} */
|
|
@@ -327,7 +546,8 @@ export declare function isEmptyChartData(data: ChartData): boolean;
|
|
|
327
546
|
*/
|
|
328
547
|
export declare function chartSummaryTable(data: ChartData, label?: string): HTMLTableElement;
|
|
329
548
|
/**
|
|
330
|
-
* Produces the exact text matrix rendered by the semantic chart summary
|
|
549
|
+
* Produces the exact text matrix rendered by the semantic chart summary, with numbers written for
|
|
550
|
+
* the active language.
|
|
331
551
|
* @param {ChartData} data Chart data.
|
|
332
552
|
* @returns {{headers: string[], rows: Array<{label: string, values: string[]}>}}
|
|
333
553
|
*/
|
|
@@ -338,6 +558,16 @@ export declare function chartSummaryModel(data: ChartData): {
|
|
|
338
558
|
values: string[];
|
|
339
559
|
}>;
|
|
340
560
|
};
|
|
561
|
+
export type SummaryFormatting = {
|
|
562
|
+
/**
|
|
563
|
+
* Number-formatting locale; the active language by default.
|
|
564
|
+
*/
|
|
565
|
+
locale?: string;
|
|
566
|
+
/**
|
|
567
|
+
* The chart's `summaryFormat`.
|
|
568
|
+
*/
|
|
569
|
+
format?: ChartSummaryFormat | null;
|
|
570
|
+
};
|
|
341
571
|
/** Fired after the adapter creates an engine instance. @event Chart#ready @type {CustomEvent<{instance: unknown}>} */
|
|
342
572
|
/** Fired after an existing chart updates. @event Chart#update @type {CustomEvent<{data: ChartData, type: string}>} */
|
|
343
573
|
/** Fired when the engine reports a selected point. @event Chart#select @type {CustomEvent<ChartSelectDetail>} */
|
|
@@ -0,0 +1,66 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Colours for chart engines.
|
|
3
|
+
*
|
|
4
|
+
* A browser reports a computed colour in the syntax it was authored in: a token mixed with
|
|
5
|
+
* `color-mix()` reads back as `color(srgb 1 1 1 / 0.09)` or `oklab(…)`, a wide-gamut one as
|
|
6
|
+
* `oklch(…)` or `color(display-p3 …)`. Chart engines usually bring their own colour parser, and
|
|
7
|
+
* most of those stop at CSS Color 3. `legacyColor()` rewrites a computed colour as `#rrggbb`, or as
|
|
8
|
+
* `rgba(r, g, b, a)` when it is translucent — the two forms every parser reads.
|
|
9
|
+
*
|
|
10
|
+
* The conversion is arithmetic and needs no DOM. Its limits: it reads the syntaxes a computed
|
|
11
|
+
* value can take (hex, `rgb()`, `hsl()`, `hwb()`, `lab()`, `lch()`, `oklab()`, `oklch()`, and
|
|
12
|
+
* `color()` in srgb, srgb-linear, display-p3, xyz, xyz-d65 and xyz-d50) — no colour names except
|
|
13
|
+
* `transparent`, no `color-mix()`, `light-dark()` or `var()`, which only an element can resolve;
|
|
14
|
+
* and a colour outside the sRGB gamut is clipped per channel rather than gamut-mapped.
|
|
15
|
+
* `paintedColor()` covers what the parser does not, by painting the colour on a canvas.
|
|
16
|
+
* @module zx/components/chart/color
|
|
17
|
+
*/
|
|
18
|
+
export type RgbaColor = {
|
|
19
|
+
r: number;
|
|
20
|
+
g: number;
|
|
21
|
+
b: number;
|
|
22
|
+
a: number;
|
|
23
|
+
};
|
|
24
|
+
/**
|
|
25
|
+
* Parses a computed CSS colour into sRGB channels.
|
|
26
|
+
* @param {unknown} value Colour text.
|
|
27
|
+
* @returns {RgbaColor|null} Null when the text is not one of the supported syntaxes.
|
|
28
|
+
*/
|
|
29
|
+
export declare function parseCssColor(value: unknown): RgbaColor | null;
|
|
30
|
+
/**
|
|
31
|
+
* Rewrites a computed CSS colour in a syntax every colour parser reads.
|
|
32
|
+
* @param {unknown} value Colour text, in any syntax `parseCssColor()` supports.
|
|
33
|
+
* @returns {string|null} `#rrggbb` for an opaque colour, `rgba(r, g, b, a)` for a translucent one,
|
|
34
|
+
* null when the text could not be read.
|
|
35
|
+
*/
|
|
36
|
+
export declare function legacyColor(value: unknown): string | null;
|
|
37
|
+
/**
|
|
38
|
+
* The same colour at another opacity, for the fill under a line or inside a point.
|
|
39
|
+
* @param {unknown} value Colour text.
|
|
40
|
+
* @param {number} alpha Opacity from 0 to 1; it replaces the colour's own.
|
|
41
|
+
* @returns {string|null} `rgba(r, g, b, a)` (or `#rrggbb` at full opacity), null for unreadable text.
|
|
42
|
+
*/
|
|
43
|
+
export declare function withAlpha(value: unknown, alpha: number): string | null;
|
|
44
|
+
/**
|
|
45
|
+
* Serialises channels in the legacy syntax.
|
|
46
|
+
* @param {RgbaColor} color Channels.
|
|
47
|
+
* @returns {string}
|
|
48
|
+
*/
|
|
49
|
+
export declare function formatLegacyColor({ r, g, b, a }: RgbaColor): string;
|
|
50
|
+
/**
|
|
51
|
+
* Reads a colour by painting it: whatever the browser can paint comes back as 8-bit sRGB, so this
|
|
52
|
+
* covers syntaxes `legacyColor()` does not parse. It needs a 2D canvas, and a faint colour loses
|
|
53
|
+
* precision to the canvas's premultiplied 8-bit storage — which is why the parser goes first.
|
|
54
|
+
* @param {unknown} value Colour text.
|
|
55
|
+
* @param {Document|null} [ownerDocument] Document that creates the canvas.
|
|
56
|
+
* @returns {string|null} A legacy colour string, or null when the colour is invalid or no canvas is
|
|
57
|
+
* available.
|
|
58
|
+
*/
|
|
59
|
+
export declare function paintedColor(value: unknown, ownerDocument?: Document | null): string | null;
|
|
60
|
+
/**
|
|
61
|
+
* A colour as an engine can read it: parsed where possible, painted otherwise.
|
|
62
|
+
* @param {unknown} value Computed colour text.
|
|
63
|
+
* @param {Document|null} [ownerDocument] Document for the canvas fallback.
|
|
64
|
+
* @returns {string|undefined} Undefined when neither route could read it.
|
|
65
|
+
*/
|
|
66
|
+
export declare function engineColor(value: unknown, ownerDocument?: Document | null): string | undefined;
|