@perspective-dev/viewer 4.4.0 → 4.4.1

package/src/rust/custom_elements/debug_plugin.rs

@@ -97,12 +97,12 @@ impl PerspectiveDebugPluginElement {
         ApiFuture::default()
     }
 
-    pub fn save(&self) -> ApiFuture<()> {
-        ApiFuture::default()
+    pub fn save(&self) -> ApiResult<JsValue> {
+        Ok(JsValue::null())
     }
 
-    pub fn restore(&self) -> ApiFuture<()> {
-        ApiFuture::default()
+    pub fn restore(&self, _config: Option<JsValue>) -> ApiResult<()> {
+        Ok(())
     }
 
     pub fn delete(&self) -> ApiFuture<()> {

package/src/rust/custom_elements/viewer.rs

@@ -39,6 +39,15 @@ use crate::tasks::*;
 use crate::utils::*;
 use crate::*;
 
+#[wasm_bindgen]
+extern "C" {
+    #[wasm_bindgen(typescript_type = "Promise<ViewerConfig>")]
+    pub type JsViewerConfigPromise;
+
+    #[wasm_bindgen(typescript_type = "ViewerConfigUpdate")]
+    pub type JsViewerConfigUpdate;
+}
+
 #[derive(serde::Deserialize, Default)]
 struct ResizeOptions {
     dimensions: Option<ResizeDimensions>,
@@ -563,7 +572,7 @@ impl PerspectiveViewerElement {
     /// ```javascript
     /// await viewer.restore({group_by: ["State"]});
     /// ```
-    pub fn restore(&self, update: JsValue) -> ApiFuture<()> {
+    pub fn restore(&self, update: JsViewerConfigUpdate) -> ApiFuture<()> {
         let this = self.clone();
         ApiFuture::new_throttled(async move {
             let decoded_update = ViewerConfigUpdate::decode(&update)?;
@@ -646,9 +655,9 @@ impl PerspectiveViewerElement {
     ///     await viewer.restore(token);
     /// });
     /// ```
-    pub fn save(&self) -> ApiFuture<JsValue> {
+    pub fn save(&self) -> JsViewerConfigPromise {
         let this = self.clone();
-        ApiFuture::new(async move {
+        let fut = ApiFuture::new(async move {
             let viewer_config = this
                 .renderer
                 .clone()
@@ -656,7 +665,9 @@ impl PerspectiveViewerElement {
                 .await?;
 
             viewer_config.encode()
-        })
+        });
+
+        js_sys::Promise::from(fut).unchecked_into()
     }
 
     /// Download this viewer's internal [`View`] data via a browser download

package/src/rust/lib.rs

@@ -73,6 +73,11 @@ import type {
     ViewConfigUpdate,
     SystemInfo,
 } from "@perspective-dev/client";
+
+export type * from "../../src/ts/ts-rs/ViewerConfig.d.ts";
+export type * from "../../src/ts/ts-rs/ViewerConfigUpdate.d.ts";
+import type {ViewerConfig} from "../../src/ts/ts-rs/ViewerConfig.d.ts";
+import type {ViewerConfigUpdate} from "../../src/ts/ts-rs/ViewerConfigUpdate.d.ts";
 "#;
 
 /// Register a plugin globally.

package/src/rust/renderer.rs

@@ -35,7 +35,7 @@ use futures::future::{join_all, select_all};
 use perspective_client::utils::*;
 use perspective_client::{View, ViewWindow};
 use perspective_js::json;
-use perspective_js::utils::ApiResult;
+use perspective_js::utils::{ApiResult, ResultTApiErrorExt};
 use wasm_bindgen::prelude::*;
 use web_sys::*;
 use yew::html::ImplicitClone;
@@ -246,7 +246,7 @@ impl Renderer {
             PluginUpdate::Update(plugin) => plugin,
         };
 
-        let idx = self.find_plugin_idx(name).expect("f");
+        let idx = self.find_plugin_idx(name)?;
         let changed = !matches!(
             self.0.borrow().plugins_idx,
             Some(selected_idx) if selected_idx == idx
@@ -403,13 +403,18 @@ impl Renderer {
         if let Some(cb) = self.0.on_render_limits_changed.borrow().as_ref() {
             cb.emit(limits);
         }
+
         let viewer_elem = &self.0.borrow().viewer_elem.clone();
-        if is_update {
+        let result = if is_update {
             let task = plugin.update(view.clone().into(), limits.max_cols, limits.max_rows, false);
-            activate_plugin(viewer_elem, &plugin, task).await?;
+            activate_plugin(viewer_elem, &plugin, task).await
         } else {
             let task = plugin.draw(view.clone().into(), limits.max_cols, limits.max_rows, false);
-            activate_plugin(viewer_elem, &plugin, task).await?;
+            activate_plugin(viewer_elem, &plugin, task).await
+        };
+
+        if let Err(error) = result.ignore_view_delete() {
+            tracing::warn!("{}", error);
         }
 
         remove_inactive_plugin(

package/src/rust/tasks/restore_and_render.rs

@@ -104,11 +104,12 @@ pub trait RestoreAndRender: HasRenderer + HasSession + HasPresentation {
 
             // TODO this should be part of the API for `draw()` above, such that
             // the plugin need not render twice when a theme is provided.
-            if needs_restyle && presentation.is_visible() {
-                let view = session.get_view().into_apierror()?;
+            if needs_restyle
+                && presentation.is_visible()
+                && let Some(view) = session.get_view()
+            {
                 renderer.restyle_all(&view).await?;
             }
-            // }
 
             Ok(())
         })

package/src/svg/datagrid-select-row-tree.svg

@@ -0,0 +1,13 @@
+<svg width="21" height="21" viewBox="0 0 21 21" fill="none" xmlns="http://www.w3.org/2000/svg">
+    <defs></defs>
+    <rect x="3" y="4" width="15" height="1" style="fill: rgb(216, 216, 216); stroke: rgb(0, 0, 0); stroke-width: 0px;">
+    </rect>
+    <rect x="5" y="6.973" width="13" height="4"
+        style="fill: rgb(216, 216, 216); stroke: rgb(0, 0, 0); stroke-width: 0px;"></rect>
+    <rect x="7" y="10" width="11" height="1" style="fill: rgb(216, 216, 216); stroke: rgb(0, 0, 0); stroke-width: 0px;">
+    </rect>
+    <rect x="5" y="13" width="13" height="1" style="fill: rgb(216, 216, 216); stroke: rgb(0, 0, 0); stroke-width: 0px;">
+    </rect>
+    <rect x="3" y="16" width="15" height="1" style="fill: rgb(216, 216, 216); stroke: rgb(0, 0, 0); stroke-width: 0px;">
+    </rect>
+</svg>

package/src/themes/defaults.css

@@ -22,6 +22,24 @@ perspective-date-column-style,
 perspective-datetime-column-style,
 perspective-number-column-style,
 perspective-string-column-style {
+    /* Colors */
+    --psp--color: #161616;
+
+    color: var(--psp--color);
+    background-color: transparent;
+
+    --psp-inactive--color: #ababab;
+    --psp-inactive--border-color: #dadada;
+    --psp-active--color: #2670a9;
+    --psp-error--color: #ff471e;
+    --psp--background-color: #ffffff;
+    --psp-icon-overflow-hint--color: rgba(0, 0, 0, 0.2);
+    --psp-select--background-color: none;
+    --psp-warning--background: #042121;
+    --psp-warning--color: #fdfffd;
+
+    /* TODO deprecate me */
+    --psp-icon-overflow-hint--color: #fdfffd;
     /* Colors */
     --psp-placeholder--background: #8b868045;
 

package/src/themes/icons.css

@@ -90,24 +90,6 @@ perspective-string-column-style {
     --psp-plugin-selector--y-scatter--content: url(../svg/mega-menu-icons-y-scatter.svg);
     --psp-plugin-selector--datagrid--content: url(../svg/mega-menu-icons-datagrid.svg);
 
-    /* Colors */
-    color: #161616;
-    background-color: transparent;
-    --psp--color: #161616;
-    --psp-inactive--color: #ababab;
-    --psp-inactive--border-color: #dadada;
-
-    --psp-active--color: #2670a9;
-    --psp-error--color: #ff471e;
-    --psp--background-color: #ffffff;
-    --psp-icon-overflow-hint--color: rgba(0, 0, 0, 0.2);
-    --psp-select--background-color: none;
-    --psp-warning--background: #042121;
-    --psp-warning--color: #fdfffd;
-
-    /* TODO deprecate me */
-    --psp-icon-overflow-hint--color: #fdfffd;
-
     /* Datagrid */
     /* `regular-table` icons */
     --psp-label--column-style-open-button--content: "style";
@@ -121,4 +103,5 @@ perspective-string-column-style {
     --psp-toolbar-edit-mode-select-row--content: url("../svg/datagrid-select-row.svg");
     --psp-toolbar-edit-mode-select-column--content: url("../svg/datagrid-select-column.svg");
     --psp-toolbar-edit-mode-select-region--content: url("../svg/datagrid-select-region.svg");
+    --psp-toolbar-edit-mode-select-row-tree--content: url("../svg/datagrid-select-row-tree.svg");
 }

package/src/themes/phosphor.css

@@ -0,0 +1,184 @@
+/* ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
+ * ┃ ██████ ██████ ██████       █      █      █      █      █ █▄  ▀███ █       ┃
+ * ┃ ▄▄▄▄▄█ █▄▄▄▄▄ ▄▄▄▄▄█  ▀▀▀▀▀█▀▀▀▀▀ █ ▀▀▀▀▀█ ████████▌▐███ ███▄  ▀█ █ ▀▀▀▀▀ ┃
+ * ┃ █▀▀▀▀▀ █▀▀▀▀▀ █▀██▀▀ ▄▄▄▄▄ █ ▄▄▄▄▄█ ▄▄▄▄▄█ ████████▌▐███ █████▄   █ ▄▄▄▄▄ ┃
+ * ┃ █      ██████ █  ▀█▄       █ ██████      █      ███▌▐███ ███████▄ █       ┃
+ * ┣━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┫
+ * ┃ Copyright (c) 2017, the Perspective Authors.                              ┃
+ * ┃ ╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌ ┃
+ * ┃ This file is part of the Perspective library, distributed under the terms ┃
+ * ┃ of the [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0). ┃
+ * ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛ */
+
+@import "./defaults.css";
+
+perspective-viewer,
+perspective-viewer[theme="Phosphor"] {
+    --psp-theme-name: "Phosphor";
+}
+
+perspective-viewer[theme="Phosphor"] {
+    /* perspective-viewer-phosphor--colors */
+    --theme-bg0: #0a0a0a;
+    --theme-bg1: #0d0d0d;
+    --theme-bg2: #1a1a1a;
+
+    --theme-green-bright: #00ff41;
+    --theme-green-mid: #20cc20;
+    --theme-green-dim: #0d660d;
+    --theme-green-dark: #0a3a0a;
+    --theme-amber: #ffb000;
+    --theme-red: #ff3333;
+
+    color: var(--theme-green-mid);
+    background-color: var(--theme-bg0);
+    --psp--color: var(--theme-green-mid);
+    --psp-active--color: var(--theme-green-bright);
+    --psp-error--color: var(--theme-red);
+    --psp-inactive--color: var(--theme-green-dark);
+    --psp-inactive--border-color: var(--theme-green-dark);
+    --psp--background-color: var(--theme-bg1);
+    --psp-active--background: rgba(51, 255, 51, 0.3);
+    --psp-expression--operator--color: var(--theme-green-dim);
+    --psp-expression--function--color: var(--theme-green-bright);
+    --psp-expression--psp-error--color: var(--theme-red);
+    --psp-calendar--filter: invert(1) hue-rotate(70deg);
+    --psp-warning--color: var(--theme-bg0);
+    --psp-warning--background: var(--theme-amber);
+
+    --psp-icon--select-arrow--mask-image: var(
+        --psp-icon--select-arrow-light--mask-image
+    );
+
+    --psp-icon--select-arrow-hover--mask-image: var(
+        --psp-icon--select-arrow-dark--mask-image
+    );
+
+    /* Syntax */
+    --psp-code-editor--symbol--color: var(--theme-green-mid);
+    --psp-code-editor--literal--color: var(--theme-green-bright);
+    --psp-code-editor--operator--color: var(--theme-amber);
+    --psp-code-editor--comment--color: var(--theme-green-dark);
+    --psp-code-editor--column--color: var(--theme-green-bright);
+
+    --psp-status-icon--connected--color: var(--theme-green-bright);
+    --psp-status-icon--initializing--color: var(--theme-amber);
+    --psp-status-icon--psp-error--color: var(--theme-red);
+
+    /* perspective-viewer-phosphor--animation */
+    --psp-status-icon--updating-keyframes-start--filter: opacity(1);
+    --psp-status-icon--updating-keyframes-end--filter: opacity(0);
+    --psp-status-icon--updating-keyframes-start--transform: scale(1);
+    --psp-status-icon--updating-keyframes-end--transform: scale(0.8);
+    --psp-status-icon--keyframes-start--transform: scale(1.1);
+    --psp-status-icon--keyframes-end--transform: scale(1);
+
+    /* perspective-viewer-phosphor--datagrid */
+    --psp-datagrid--pos-cell--color: var(--theme-green-bright);
+    --psp-datagrid--neg-cell--color: var(--theme-red);
+
+    /* perspective-viewer-phosphor--d3fc */
+    --psp-d3fc--legend--color: var(--theme-green-mid);
+    --psp-d3fc--treemap--labels: var(--theme-green-mid);
+    --psp-d3fc--treemap--hover-highlight: #ff6600;
+    --psp-d3fc--tooltip--color: var(--theme-green-mid);
+    --psp-d3fc--axis-ticks--color: var(--theme-green-mid);
+    --psp-d3fc--axis-lines--color: var(--theme-green-dim);
+    --psp-d3fc--gridline--color: var(--theme-green-dark);
+    --psp-d3fc--tooltip--background: var(--theme-green-dark);
+    --psp-d3fc--tooltip--border-color: var(--theme-green-bright);
+    --psp-d3fc--legend--background: var(--psp--background-color);
+
+    --psp-d3fc--series--color: #00ff41;
+    --psp-d3fc--series-1--color: #00ff41;
+    --psp-d3fc--series-2--color: #00bfff;
+    --psp-d3fc--series-3--color: #ff0055;
+    --psp-d3fc--series-4--color: #ffd700;
+    --psp-d3fc--series-5--color: #7fffd4;
+
+    --psp-d3fc--full-gradient--background: linear-gradient(
+        #ff3333 0%,
+        #1a1a2e 50%,
+        #00cc66 100%
+    );
+
+    --psp-d3fc--pos-gradient--background: linear-gradient(
+        #1a1a2e 0%,
+        #00cc66 100%
+    );
+    --psp-d3fc--neg-gradient--background: linear-gradient(
+        #ff3333 0%,
+        #1a1a2e 100%
+    );
+
+    /* OpenLayers */
+    --psp-openlayers--tile-url: "http://{a-c}.basemaps.cartocdn.com/dark_all/{z}/{x}/{y}.png";
+    --psp-openlayers--attribution--filter: invert(1) hue-rotate(180deg);
+    --psp-openlayers--element--background: #1a1a2e;
+    --psp-openlayers--category-1--color: #ff6600;
+    --psp-openlayers--category-2--color: #33ccff;
+    --psp-openlayers--category-3--color: #00cc66;
+    --psp-openlayers--category-4--color: #ffcc00;
+    --psp-openlayers--category-5--color: #ff3333;
+    --psp-openlayers--category-6--color: #cc66ff;
+    --psp-openlayers--category-7--color: #ff9933;
+    --psp-openlayers--category-8--color: #66ffcc;
+    --psp-openlayers--category-9--color: #ff6699;
+    --psp-openlayers--category-10--color: #99ccff;
+    --psp-openlayers--gradient--background: linear-gradient(
+        #ff3333 0%,
+        #1a1a2e 50%,
+        #00cc66 100%
+    );
+}
+
+perspective-copy-menu[theme="Phosphor"],
+perspective-export-menu[theme="Phosphor"],
+perspective-dropdown[theme="Phosphor"],
+perspective-date-column-style[theme="Phosphor"],
+perspective-datetime-column-style[theme="Phosphor"],
+perspective-number-column-style[theme="Phosphor"],
+perspective-string-column-style[theme="Phosphor"] {
+    /* perspective-viewer-phosphor--colors */
+    --theme-bg0: #0a0a0a;
+    --theme-bg1: #0d0d0d;
+    --theme-bg2: #1a1a1a;
+    --theme-green-bright: #33ff33;
+    --theme-green-mid: #20cc20;
+    --theme-green-dim: #0d660d;
+    --theme-green-dark: #0a3a0a;
+    --theme-amber: #ffb000;
+    --theme-red: #ff3333;
+
+    color: var(--theme-green-mid);
+    --psp--color: var(--theme-green-mid);
+    --psp-active--color: var(--theme-green-bright);
+    --psp-error--color: var(--theme-red);
+    --psp-inactive--color: var(--theme-green-dark);
+    --psp-inactive--border-color: var(--theme-green-dark);
+    --psp--background-color: var(--theme-bg1);
+    --psp-active--background: rgba(51, 255, 51, 0.3);
+    --psp-expression--operator--color: var(--theme-green-dim);
+    --psp-expression--function--color: var(--theme-green-bright);
+    --psp-expression--psp-error--color: var(--theme-red);
+    --psp-calendar--filter: invert(1) hue-rotate(70deg);
+    --psp-warning--color: var(--theme-bg0);
+    --psp-warning--background: var(--theme-amber);
+    --psp-icon--select-arrow--mask-image: var(
+        --psp-icon--select-arrow-light--mask-image
+    );
+    --psp-icon--select-arrow-hover--mask-image: var(
+        --psp-icon--select-arrow-dark--mask-image
+    );
+    --psp-code-editor--symbol--color: var(--theme-green-mid);
+    --psp-code-editor--literal--color: var(--theme-green-bright);
+    --psp-code-editor--operator--color: var(--theme-amber);
+    --psp-code-editor--comment--color: var(--theme-green-dark);
+    --psp-code-editor--column--color: var(--theme-green-bright);
+    --psp-status-icon--connected--color: var(--theme-green-bright);
+    --psp-status-icon--initializing--color: var(--theme-amber);
+    --psp-status-icon--psp-error--color: var(--theme-red);
+
+    background-color: #0a0a0a;
+    border: 1px solid #1a3a1a;
+}

package/src/themes/themes.css

@@ -20,3 +20,4 @@
 @import "./gruvbox-dark.css";
 @import "./dracula.css";
 @import "./botanical.css";
+@import "./phosphor.css";

package/src/ts/extensions.ts

@@ -26,7 +26,6 @@ export class PerspectiveSelectDetail {
     column_names?: string[];
     removeConfigs: ViewConfigUpdate[];
     insertConfigs: ViewConfigUpdate[];
-
     constructor(
         selected: boolean,
         row: Record<string, unknown>,
@@ -49,6 +48,7 @@ export class PerspectiveSelectDetail {
         return this.insertConfigs.flatMap((x) => x.filter ?? []);
     }
 }
+
 import type {
     ExportDropDownMenuElement,
     CopyDropDownMenuElement,
@@ -190,6 +190,12 @@ export interface PerspectiveViewerElementExt {
         options?: { signal: AbortSignal },
     ): void;
 
+    addEventListener(
+        name: "perspective-global-filter",
+        cb: (e: CustomEvent<PerspectiveSelectEventDetail>) => void,
+        options?: { signal: AbortSignal },
+    ): void;
+
     addEventListener(
         name: "perspective-toggle-settings",
         cb: (e: CustomEvent) => void,
@@ -228,6 +234,7 @@ export interface PerspectiveViewerElementExt {
 
     removeEventListener(name: "perspective-click", cb: any): void;
     removeEventListener(name: "perspective-select", cb: any): void;
+    removeEventListener(name: "perspective-global-filter", cb: any): void;
     removeEventListener(name: "perspective-toggle-settings", cb: any): void;
     removeEventListener(
         name: "perspective-toggle-settings-before",

package/src/ts/perspective-viewer.ts

@@ -37,6 +37,7 @@ export { HTMLPerspectiveViewerPluginElement } from "./plugin";
 export type * from "./extensions.ts";
 export { PerspectiveSelectDetail } from "./extensions.ts";
 export type * from "./ts-rs/ViewerConfigUpdate.d.ts";
+export type * from "./ts-rs/ViewerConfig.d.ts";
 export type * from "./ts-rs/ColumnConfigValues.d.ts";
 export type * from "./ts-rs/Filter.d.ts";
 export type * from "./ts-rs/FilterTerm.d.ts";

package/src/ts/plugin.ts

@@ -157,13 +157,13 @@ export interface IPerspectiveViewerPlugin {
      * Like `update()`, but for when the dimensions of the plugin have changed
      * and the underlying data has not.
      */
-    resize(): Promise<void>;
+    resize(view: View): Promise<void>;
 
     /**
      * Notify the plugin that the style environment has changed.  Useful for
      * plugins which read CSS styles via `window.getComputedStyle()`.
      */
-    restyle(): Promise<void>;
+    restyle(view: View): Promise<void>;
 
     /**
      * Save this plugin's state to a JSON-serializable value.  While this value
@@ -176,17 +176,17 @@ export interface IPerspectiveViewerPlugin {
      * reload.  For example, `@perspective-dev/viewer-d3fc` uses
      * `plugin_config` to remember the user-repositionable legend coordinates.
      */
-    save(): Promise<any>;
+    save(): any;
 
     /**
      * Restore this plugin to a state previously returned by `save()`.
      */
-    restore(config: any): Promise<void>;
+    restore(config: any): void;
 
     /**
      * Free any resources acquired by this plugin and prepare to be deleted.
      */
-    delete(): Promise<void>;
+    delete(): void;
 }
 
 /**
@@ -257,19 +257,19 @@ export class HTMLPerspectiveViewerPluginElement
         this.innerHTML = "";
     }
 
-    async resize(): Promise<void> {
+    async resize(view: View): Promise<void> {
         // Not Implemented
     }
 
-    async restyle(): Promise<void> {
+    async restyle(view: View): Promise<void> {
         // Not Implemented
     }
 
-    async save(): Promise<any> {
+    save(): any {
         // Not Implemented
     }
 
-    async restore(): Promise<void> {
+    restore(): void {
         // Not Implemented
     }
 

package/src/ts/ts-rs/NumberForegroundMode.ts

@@ -1,3 +1,3 @@
 // This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
 
-export type NumberForegroundMode = "disabled" | "color" | "bar";
+export type NumberForegroundMode = "disabled" | "color" | "bar" | "label-bar";

package/src/ts/ts-rs/ViewerConfig.ts

@@ -0,0 +1,15 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { Aggregate } from "./Aggregate.js";
+import type { ColumnConfigValues } from "./ColumnConfigValues.js";
+import type { Expressions } from "./Expressions.js";
+import type { Filter } from "./Filter.js";
+import type { FilterReducer } from "./FilterReducer.js";
+import type { GroupRollupMode } from "./GroupRollupMode.js";
+import type { Sort } from "./Sort.js";
+import type { JsonValue } from "./serde_json/JsonValue.js";
+
+/**
+ * The state of an entire `custom_elements::PerspectiveViewerElement` component
+ * and its `Plugin`.
+ */
+export type ViewerConfig<V = string> = { version: V, columns_config: { [key in string]?: ColumnConfigValues }, plugin: string, plugin_config: JsonValue, settings: boolean, table: string | null, theme: string | null, title: string | null, group_by: Array<string>, split_by: Array<string>, sort: Array<Sort>, filter: Array<Filter>, group_rollup_mode: GroupRollupMode, filter_op?: FilterReducer, expressions: Expressions, columns: Array<string | null>, aggregates: { [key in string]?: Aggregate }, group_by_depth?: number | null, };