@finos/legend-data-cube 0.1.3 → 0.1.5

package/lib/stores/view/grid/DataCubeGridState.d.ts

@@ -17,8 +17,8 @@ import { type DebouncedFunc } from '@finos/legend-shared';
 import type { GridApi } from 'ag-grid-community';
 import type { DataCubeViewState } from '../DataCubeViewState.js';
 import { DataCubeGridClientServerSideDataSource } from './DataCubeGridClientEngine.js';
-import { DataCubeQuerySnapshotController } from '../../services/DataCubeQuerySnapshotService.js';
-import type { DataCubeQuerySnapshot } from '../../core/DataCubeQuerySnapshot.js';
+import { DataCubeSnapshotController } from '../../services/DataCubeSnapshotService.js';
+import type { DataCubeSnapshot } from '../../core/DataCubeSnapshot.js';
 import { DataCubeConfiguration } from '../../core/model/DataCubeConfiguration.js';
 import { DataCubeGridControllerState } from './DataCubeGridControllerState.js';
 import { DataCubeGridClientExportEngine } from './DataCubeGridClientExportEngine.js';
@@ -37,7 +37,7 @@ import { DataCubeGridClientExportEngine } from './DataCubeGridClientExportEngine
  * row model datasource, so without the companion grid controller, these changes will not
  * trigger publishing a new snapshot, hence not propagated.
  */
-export declare class DataCubeGridState extends DataCubeQuerySnapshotController {
+export declare class DataCubeGridState extends DataCubeSnapshotController {
     private readonly _view;
     readonly controller: DataCubeGridControllerState;
     readonly exportEngine: DataCubeGridClientExportEngine;
@@ -51,12 +51,14 @@ export declare class DataCubeGridState extends DataCubeQuerySnapshotController {
     debouncedAutoResizeColumns?: DebouncedFunc<() => void>;
     constructor(view: DataCubeViewState);
     setPaginationEnabled(val: boolean): void;
-    setCachingEnabled(val: boolean): Promise<void>;
+    setCachingEnabled(val: boolean, options?: {
+        suppressWarning?: boolean | undefined;
+    }): Promise<void>;
     setScrollHintText(val: string | undefined): void;
     get isClientConfigured(): boolean;
     get client(): GridApi<any>;
     configureClient(val: GridApi | undefined): void;
     getSnapshotSubscriberName(): string;
-    applySnapshot(snapshot: DataCubeQuerySnapshot, previousSnapshot: DataCubeQuerySnapshot | undefined): Promise<void>;
+    applySnapshot(snapshot: DataCubeSnapshot, previousSnapshot: DataCubeSnapshot | undefined): Promise<void>;
 }
 //# sourceMappingURL=DataCubeGridState.d.ts.map

package/lib/stores/view/grid/DataCubeGridState.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DataCubeGridState.d.ts","sourceRoot":"","sources":["../../../../src/stores/view/grid/DataCubeGridState.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAGL,KAAK,aAAa,EACnB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EACL,sCAAsC,EAOvC,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,+BAA+B,EAAE,MAAM,gDAAgD,CAAC;AACjG,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAEjF,OAAO,EAAE,qBAAqB,EAAE,MAAM,2CAA2C,CAAC;AAClF,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAC/E,OAAO,EAAE,8BAA8B,EAAE,MAAM,qCAAqC,CAAC;AAKrF;;;;;;;;;;;;;;GAcG;AACH,qBAAa,iBAAkB,SAAQ,+BAA+B;IACpE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoB;IAE1C,QAAQ,CAAC,UAAU,EAAE,2BAA2B,CAAC;IAEjD,QAAQ,CAAC,YAAY,EAAE,8BAA8B,CAAC;IACtD,OAAO,CAAC,OAAO,CAAC,CAAsB;IACtC,gBAAgB,EAAE,sCAAsC,CAAC;IAEzD,kBAAkB,EAAE,qBAAqB,CAAC;IAC1C,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,mBAAmB,UAAmD;IACtE,gBAAgB,UAAgD;IAChE,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAGpC,0BAA0B,CAAC,EAAE,aAAa,CAAC,MAAM,IAAI,CAAC,CAAC;gBAE3C,IAAI,EAAE,iBAAiB;IAgCnC,oBAAoB,CAAC,GAAG,EAAE,OAAO;IAoB3B,iBAAiB,CAAC,GAAG,EAAE,OAAO;IA4FpC,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS;IAIzC,IAAI,kBAAkB,YAErB;IAED,IAAI,MAAM,iBAET;IAED,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,SAAS;IAQ/B,yBAAyB;IAInB,aAAa,CAC1B,QAAQ,EAAE,qBAAqB,EAC/B,gBAAgB,EAAE,qBAAqB,GAAG,SAAS;CAoDtD"}
+{"version":3,"file":"DataCubeGridState.d.ts","sourceRoot":"","sources":["../../../../src/stores/view/grid/DataCubeGridState.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAGL,KAAK,aAAa,EACnB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EACL,sCAAsC,EAOvC,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,0BAA0B,EAAE,MAAM,2CAA2C,CAAC;AACvF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAEvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,2CAA2C,CAAC;AAClF,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAC/E,OAAO,EAAE,8BAA8B,EAAE,MAAM,qCAAqC,CAAC;AAKrF;;;;;;;;;;;;;;GAcG;AACH,qBAAa,iBAAkB,SAAQ,0BAA0B;IAC/D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoB;IAE1C,QAAQ,CAAC,UAAU,EAAE,2BAA2B,CAAC;IAEjD,QAAQ,CAAC,YAAY,EAAE,8BAA8B,CAAC;IACtD,OAAO,CAAC,OAAO,CAAC,CAAsB;IACtC,gBAAgB,EAAE,sCAAsC,CAAC;IAEzD,kBAAkB,EAAE,qBAAqB,CAAC;IAC1C,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,mBAAmB,UAAmD;IACtE,gBAAgB,UAAgD;IAChE,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAGpC,0BAA0B,CAAC,EAAE,aAAa,CAAC,MAAM,IAAI,CAAC,CAAC;gBAE3C,IAAI,EAAE,iBAAiB;IAgCnC,oBAAoB,CAAC,GAAG,EAAE,OAAO;IAoB3B,iBAAiB,CACrB,GAAG,EAAE,OAAO,EACZ,OAAO,CAAC,EAAE;QACR,eAAe,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;KACvC;IA8FH,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS;IAIzC,IAAI,kBAAkB,YAErB;IAED,IAAI,MAAM,iBAET;IAED,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,SAAS;IAQ/B,yBAAyB;IAInB,aAAa,CAC1B,QAAQ,EAAE,gBAAgB,EAC1B,gBAAgB,EAAE,gBAAgB,GAAG,SAAS;CAoDjD"}

package/lib/stores/view/grid/DataCubeGridState.js

@@ -16,7 +16,7 @@
 import { debounce, guaranteeNonNullable, } from '@finos/legend-shared';
 import { action, makeObservable, observable, runInAction } from 'mobx';
 import { DataCubeGridClientServerSideDataSource, INTERNAL__GRID_CLIENT_DEFAULT_CACHE_BLOCK_SIZE, INTERNAL__GRID_CLIENT_DATA_FETCH_MANUAL_TRIGGER_COLUMN_ID, INTERNAL__GRID_CLIENT_MAX_CACHE_BLOCK_SIZE, INTERNAL__GRID_CLIENT_DEFAULT_ENABLE_PAGINATION, computeHashCodeForDataFetchManualTrigger, INTERNAL__GRID_CLIENT_DEFAULT_ENABLE_CACHING, } from './DataCubeGridClientEngine.js';
-import { DataCubeQuerySnapshotController } from '../../services/DataCubeQuerySnapshotService.js';
+import { DataCubeSnapshotController } from '../../services/DataCubeSnapshotService.js';
 import { generateGridOptionsFromSnapshot } from './DataCubeGridConfigurationBuilder.js';
 import { DataCubeConfiguration } from '../../core/model/DataCubeConfiguration.js';
 import { DataCubeGridControllerState } from './DataCubeGridControllerState.js';
@@ -39,7 +39,7 @@ import { AlertType } from '../../services/DataCubeAlertService.js';
  * row model datasource, so without the companion grid controller, these changes will not
  * trigger publishing a new snapshot, hence not propagated.
  */
-export class DataCubeGridState extends DataCubeQuerySnapshotController {
+export class DataCubeGridState extends DataCubeSnapshotController {
     _view;
     controller;
     exportEngine;
@@ -88,7 +88,7 @@ export class DataCubeGridState extends DataCubeQuerySnapshotController {
                 : INTERNAL__GRID_CLIENT_MAX_CACHE_BLOCK_SIZE,
         });
     }
-    async setCachingEnabled(val) {
+    async setCachingEnabled(val, options) {
         if (val === this.isCachingEnabled) {
             return;
         }
@@ -117,10 +117,11 @@ export class DataCubeGridState extends DataCubeQuerySnapshotController {
         // TODO?: we might want to do a quick check here for the amount of data the cache
         // will handle, so maybe fire a COUNT query to check for the number of records
         // and check that against a threshold, we will need to alter the prompt below accordingly.
-        if (this._settingService.getBooleanValue(DataCubeSettingKey.GRID_CLIENT__SHOW_CACHE_PERFORMANCE_WARNING)) {
+        if (this._settingService.getBooleanValue(DataCubeSettingKey.GRID_CLIENT__SHOW_CACHE_PERFORMANCE_WARNING) &&
+            !options?.suppressWarning) {
             this._view.alertService.alert({
                 message: `Confirm you want to proceed with caching`,
-                text: `When enabled, the source dataset will be cached locally in order to boost query performance. But depending on computational resource available to your environment, sometimes, caching can negatively impact the overall performance, and can even lead to crashes.\nDo you still want to proceed?`,
+                text: `When enabled, the source dataset will be cached locally in order to boost query performance. But depending on computational resource available to your environment, sometimes, caching can negatively impact the overall performance, and can even lead to crashes.\n\nOverall, caching is still an experimental feature where we only support queries with simple execution plans, certain queries might not work, in which case, you can abort by turning off caching.\n\nDo you still want to proceed?`,
                 type: AlertType.WARNING,
                 actions: [
                     {
@@ -144,7 +145,7 @@ export class DataCubeGridState extends DataCubeQuerySnapshotController {
                 windowConfig: {
                     ...DEFAULT_ALERT_WINDOW_CONFIG,
                     width: 600,
-                    height: 210,
+                    height: 300,
                     minWidth: 300,
                     minHeight: 150,
                 },

package/lib/stores/view/grid/DataCubeGridState.js.map

@@ -1 +1 @@
-{"version":3,"file":"DataCubeGridState.js","sourceRoot":"","sources":["../../../../src/stores/view/grid/DataCubeGridState.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"DataCubeGridState.js","sourceRoot":"","sources":["../../../../src/stores/view/grid/DataCubeGridState.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@finos/legend-data-cube",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "Legend DataCube",
   "keywords": [
     "legend",
@@ -43,8 +43,8 @@
   },
   "dependencies": {
     "@finos/legend-art": "7.1.81",
-    "@finos/legend-code-editor": "2.0.44",
-    "@finos/legend-graph": "32.1.2",
+    "@finos/legend-code-editor": "2.0.45",
+    "@finos/legend-graph": "32.1.3",
     "@finos/legend-shared": "11.0.3",
     "@types/react": "19.0.8",
     "ag-grid-community": "33.0.4",

package/src/__lib__/DataCubeSetting.ts

@@ -15,11 +15,13 @@
  */
 
 export enum DataCubeSettingKey {
+  EDITOR__MAX_HISTORY_STACK_SIZE = 'dataCube.editor.maxHistoryStackSize',
   DEBUGGER__ENABLE_DEBUG_MODE = 'dataCube.debugger.enableDebugMode',
   DEBUGGER__USE_DEV_CLIENT_PROTOCOL_VERSION = 'dataCube.debugger.useDevClientProtocolVersion',
   DEBUGGER__ACTION__RELOAD = 'dataCube.debugger.action.reload',
   GRID_CLIENT__ROW_BUFFER = 'dataCube.grid.rowBuffer',
   GRID_CLIENT__PURGE_CLOSED_ROW_NODES = 'dataCube.grid.purgeClosedRowNodes',
+  GRID_CLIENT__SHOW_AUTO_ENABLE_CACHE_PERFORMANCE_WARNING = 'dataCube.grid.showAutoEnableCachePerformanceWarning',
   GRID_CLIENT__SHOW_CACHE_PERFORMANCE_WARNING = 'dataCube.grid.showCachePerformanceWarning',
   GRID_CLIENT__SUPPRESS_LARGE_DATASET_WARNING = 'dataCube.grid.suppressLargeDatasetWarning',
   GRID_CLIENT__ACTION__RETRY_FAILED_DATA_FETCHES = 'dataCube.grid.action.retryFailedDataFetches',

package/src/components/DataCube.tsx

@@ -23,7 +23,7 @@ import type { DataCubeEngine } from '../stores/core/DataCubeEngine.js';
 import { DataCubeState } from '../stores/DataCubeState.js';
 import { type DataCubeOptions } from '../stores/DataCubeOptions.js';
 import { DataCubeContextProvider, useDataCube } from './DataCubeProvider.js';
-import type { DataCubeQuery } from '../stores/core/model/DataCubeQuery.js';
+import type { DataCubeSpecification } from '../stores/core/model/DataCubeSpecification.js';
 import { DataCubeTitleBar } from './DataCubeTitleBar.js';
 import { DEFAULT_REPORT_NAME } from '../stores/core/DataCubeQueryEngine.js';
 import {
@@ -37,7 +37,7 @@ const DataCubeRoot = observer(() => {
 
   useEffect(() => {
     dataCube.view
-      .initialize(dataCube.query)
+      .initialize(dataCube.specification)
       .catch((error) => dataCube.logService.logUnhandledError(error));
   }, [dataCube]);
 
@@ -47,19 +47,21 @@ const DataCubeRoot = observer(() => {
         title={view.info.name}
         menuItems={[
           {
-            label: 'See Documentation',
-            action: () => {
-              const url = dataCube.options?.documentationUrl;
-              if (url) {
-                dataCube.navigationService.openLink(url);
-              }
-            },
+            label: 'Undo',
+            action: () => dataCube.view.snapshotService.undo(),
+            disabled: !dataCube.view.snapshotService.canUndo,
+          },
+          {
+            label: 'Redo',
+            action: () => dataCube.view.snapshotService.redo(),
+            disabled: !dataCube.view.snapshotService.canRedo,
           },
           {
             label: 'Settings...',
             action: () => dataCube.settingService.display.open(),
           },
         ]}
+        getMenuItems={dataCube.options?.getHeaderMenuItems}
       >
         {dataCube.options?.innerHeaderRenderer?.({ api: dataCube.api }) ?? null}
       </DataCubeTitleBar>
@@ -74,13 +76,13 @@ const DataCubeRoot = observer(() => {
 
 export const DataCube = observer(
   (props: {
-    query: DataCubeQuery;
+    specification: DataCubeSpecification;
     engine: DataCubeEngine;
     options?: DataCubeOptions | undefined;
   }) => {
-    const { query, engine, options } = props;
+    const { specification, engine, options } = props;
     const dataCube = useLocalObservable(
-      () => new DataCubeState(query, engine, options),
+      () => new DataCubeState(specification, engine, options),
     );
 
     useEffect(() => {

package/src/components/DataCubePlaceholder.tsx

@@ -15,7 +15,10 @@
  */
 
 import { observer } from 'mobx-react-lite';
-import type { DataCubeMenuItem } from '../stores/DataCubeOptions.js';
+import type {
+  DataCubeMenuItem,
+  DataCubeNativeMenuItem,
+} from '../stores/DataCubeOptions.js';
 import { DataCubeTitleBar } from './DataCubeTitleBar.js';
 import { DataCubeStatusBar } from './DataCubeStatusBar.js';
 import type { LayoutManager } from '../stores/services/DataCubeLayoutService.js';
@@ -67,7 +70,7 @@ export const DataCubePlaceholder = observer(
     children?: React.ReactNode | undefined;
     title: string;
     headerContent?: React.ReactNode | undefined;
-    menuItems?: DataCubeMenuItem[] | undefined;
+    menuItems?: (DataCubeMenuItem | DataCubeNativeMenuItem)[] | undefined;
     layoutManager?: LayoutManager | undefined;
     taskManager?: TaskManager | undefined;
   }) => {

package/src/components/DataCubeTitleBar.tsx

@@ -21,17 +21,26 @@ import {
   DropdownMenuItem,
 } from '@finos/legend-art';
 import { observer } from 'mobx-react-lite';
-import type { DataCubeMenuItem } from '../stores/DataCubeOptions.js';
+import {
+  DataCubeNativeMenuItem,
+  type DataCubeMenuItem,
+} from '../stores/DataCubeOptions.js';
+import { useState } from 'react';
+import { isObject } from '@finos/legend-shared';
 
 export const DataCubeTitleBar = observer(
   (props: {
     children: React.ReactNode;
     title: string;
-    menuItems?: DataCubeMenuItem[] | undefined;
+    menuItems?: (DataCubeMenuItem | DataCubeNativeMenuItem)[] | undefined;
+    getMenuItems?:
+      | (() => (DataCubeMenuItem | DataCubeNativeMenuItem)[])
+      | undefined;
   }) => {
-    const { children, title, menuItems } = props;
+    const { children, title, menuItems, getMenuItems } = props;
     const [openMenuDropdown, closeMenuDropdown, menuDropdownProps] =
       useDropdownMenu();
+    const [items, setItems] = useState([...(menuItems ?? [])]);
 
     return (
       <div className="flex h-7 justify-between bg-neutral-100">
@@ -43,7 +52,14 @@ export const DataCubeTitleBar = observer(
           {children}
           <button
             className="flex aspect-square h-full flex-shrink-0 items-center justify-center text-lg disabled:text-neutral-400"
-            onClick={openMenuDropdown}
+            onClick={(event) => {
+              const extraItems = getMenuItems?.() ?? [];
+              if (extraItems.length) {
+                extraItems.unshift(DataCubeNativeMenuItem.SEPARATOR);
+              }
+              setItems([...(menuItems ?? []), ...extraItems]);
+              openMenuDropdown(event);
+            }}
             disabled={!menuItems?.length}
           >
             <DataCubeIcon.Menu />
@@ -55,24 +71,38 @@ export const DataCubeTitleBar = observer(
               transformOrigin: { vertical: 'top', horizontal: 'left' },
               classes: {
                 paper: 'rounded-none mt-[1px]',
-                list: 'w-40 p-0 rounded-none border border-neutral-400 bg-white max-h-40 overflow-y-auto py-0.5',
+                list: 'w-40 p-0 rounded-none border border-neutral-400 bg-white overflow-y-auto py-0.5',
               },
             }}
           >
-            {menuItems?.map((item, idx) => (
-              <DropdownMenuItem
-                // eslint-disable-next-line react/no-array-index-key
-                key={idx}
-                className="flex h-[22px] w-full items-center px-2.5 text-base hover:bg-neutral-100 focus:bg-neutral-100"
-                onClick={() => {
-                  item.action();
-                  closeMenuDropdown();
-                }}
-                disabled={Boolean(item.disabled)}
-              >
-                {item.label}
-              </DropdownMenuItem>
-            ))}
+            {items.map((item, idx) => {
+              if (isObject(item)) {
+                return (
+                  <DropdownMenuItem
+                    // eslint-disable-next-line react/no-array-index-key
+                    key={idx}
+                    className="flex h-[22px] w-full items-center px-2.5 text-base hover:bg-neutral-100 focus:bg-neutral-100"
+                    onClick={() => {
+                      item.action();
+                      closeMenuDropdown();
+                    }}
+                    disabled={Boolean(item.disabled)}
+                  >
+                    {item.label}
+                  </DropdownMenuItem>
+                );
+                // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+              } else if (item === DataCubeNativeMenuItem.SEPARATOR) {
+                return (
+                  <div
+                    // eslint-disable-next-line react/no-array-index-key
+                    key={idx}
+                    className="my-1 h-[1px] w-full bg-neutral-200"
+                  />
+                );
+              }
+              return null;
+            })}
           </DropdownMenu>
         </div>
       </div>

package/src/index.tsx

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-export * from './stores/core/model/DataCubeQuery.js';
+export * from './stores/core/model/DataCubeSpecification.js';
 export * from './stores/core/model/DataCubeSource.js';
 export { type DataCubeColumn } from './stores/core/model/DataCubeColumn.js';
 export * from './stores/core/model/DataCubeConfiguration.js';
@@ -23,7 +23,7 @@ export { CachedDataCubeSource } from './stores/core/model/CachedDataCubeSource.j
 
 export * from './stores/core/DataCubeEngine.js';
 export * from './stores/core/DataCubeQueryEngine.js';
-export { DataCubeQuerySnapshot } from './stores/core/DataCubeQuerySnapshot.js';
+export { DataCubeSnapshot } from './stores/core/DataCubeSnapshot.js';
 
 export {
   type DataCubeSetting,
@@ -34,6 +34,7 @@ export {
 export {
   DataCubeLayoutService,
   WindowState,
+  type WindowConfiguration,
   DisplayState,
   LayoutConfiguration,
   DEFAULT_TOOL_PANEL_WINDOW_CONFIG,

package/src/stores/DataCubeAPI.ts

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-import type { DataCubeQuery } from './core/model/DataCubeQuery.js';
+import type { DataCubeSpecification } from './core/model/DataCubeSpecification.js';
 import type { DataCubeSource } from './core/model/DataCubeSource.js';
 import type { DataCubeState } from './DataCubeState.js';
 import type { DataCubeViewState } from './view/DataCubeViewState.js';
@@ -29,10 +29,21 @@ export interface DataCubeAPI {
    */
   getProcessedSource(): DataCubeSource | undefined;
   /**
-   * Generates the data cube query (including the query, configuration, and source)
+   * Generates the specification (including the query, configuration, and source)
    * from the latest state of the DataCube.
    */
-  generateDataCubeQuery(): Promise<DataCubeQuery>;
+  generateSpecification(): Promise<DataCubeSpecification>;
+  /**
+   * Updates the name of the DataCube main view.
+   */
+  updateName(name: string): void;
+  /**
+   * Applies the specification to the DataCube, i.e. update the query, configuration.
+   *
+   * Note that source cannot be updated via this method, providing a different source
+   * than the one the DataCube has will result in an error.
+   */
+  applySpecification(specification: DataCubeSpecification): Promise<void>;
   /**
    * Retries all failed data fetches and rerender the grid.
    */
@@ -67,11 +78,19 @@ export class INTERNAL__DataCubeAPI implements DataCubeAPI {
   // ----------------------------- API -----------------------------
 
   getProcessedSource() {
-    return this._dataCube.view.getOriginalSource();
+    return this._dataCube.view.getInitialSource();
+  }
+
+  generateSpecification() {
+    return this._dataCube.view.generateSpecification();
+  }
+
+  updateName(name: string) {
+    this._dataCube.view.updateName(name);
   }
 
-  generateDataCubeQuery() {
-    return this._dataCube.view.generateDataCubeQuery();
+  async applySpecification(specification: DataCubeSpecification) {
+    await this._dataCube.view.applySpecification(specification);
   }
 
   retryFailedDataFetches() {

package/src/stores/DataCubeOptions.ts

@@ -48,6 +48,9 @@ export type DataCubeMenuItem = {
   disabled?: boolean | undefined;
   action: () => void;
 };
+export enum DataCubeNativeMenuItem {
+  SEPARATOR = 'separator',
+}
 
 type DataCubeOptionsBaseParams = {
   api: DataCubeAPI;
@@ -75,6 +78,10 @@ export type DataCubeOptions = {
   onViewInitialized?:
     | ((event: DataCubeViewInitializedEvent) => void)
     | undefined;
+  /**
+   * Enables caching to suppport local query execution.
+   */
+  enableCache?: boolean | undefined;
 
   // ------------------------------ GRID ------------------------------
 
@@ -103,6 +110,12 @@ export type DataCubeOptions = {
   innerHeaderRenderer?:
     | ((params: DataCubeInnerHeaderComponentParams) => React.ReactNode)
     | undefined;
+  /**
+   * Provides a list of items to be displayed in the header dropdown menu.
+   */
+  getHeaderMenuItems?:
+    | (() => (DataCubeMenuItem | DataCubeNativeMenuItem)[])
+    | undefined;
 
   // ------------------------------ SETTINGS ------------------------------
 
@@ -119,15 +132,4 @@ export type DataCubeOptions = {
   onSettingsChanged?:
     | ((event: DataCubeSettingsChangedEvent) => void)
     | undefined;
-
-  // ------------------------------ DOCUMENTATION ------------------------------
-
-  /**
-   * URL to the documentation website.
-   */
-  documentationUrl?: string | undefined;
-  /**
-   * Enables caching to suppport local query execution.
-   */
-  enableCache?: boolean | undefined;
 };

package/src/stores/DataCubeState.tsx

@@ -21,7 +21,7 @@ import { action, makeObservable, observable } from 'mobx';
 import { DataCubeSettingService } from './services/DataCubeSettingService.js';
 import { INTERNAL__DataCubeAPI } from './DataCubeAPI.js';
 import type { DataCubeOptions } from './DataCubeOptions.js';
-import type { DataCubeQuery } from './core/model/DataCubeQuery.js';
+import type { DataCubeSpecification } from './core/model/DataCubeSpecification.js';
 import { LicenseManager } from 'ag-grid-enterprise';
 import {
   configureCodeEditor,
@@ -47,7 +47,7 @@ export class DataCubeState {
   readonly navigationService: DataCubeNavigationService;
   readonly telemetryService: DataCubeTelemetryService;
 
-  readonly query: DataCubeQuery;
+  readonly specification: DataCubeSpecification;
   readonly options?: DataCubeOptions | undefined;
 
   readonly initializeState = ActionState.create();
@@ -59,7 +59,7 @@ export class DataCubeState {
   view: DataCubeViewState;
 
   constructor(
-    query: DataCubeQuery,
+    specification: DataCubeSpecification,
     engine: DataCubeEngine,
     options?: DataCubeOptions | undefined,
   ) {
@@ -90,7 +90,7 @@ export class DataCubeState {
     this.telemetryService = new DataCubeTelemetryService(this.engine);
 
     this.api = new INTERNAL__DataCubeAPI(this);
-    this.query = query;
+    this.specification = specification;
     this.options = options;
 
     this.view = new DataCubeViewState(this);

package/src/stores/core/DataCubeConfigurationBuilder.ts

@@ -25,12 +25,12 @@ import {
   DataCubeFontTextAlignment,
 } from './DataCubeQueryEngine.js';
 import { _findCol, type DataCubeColumn } from './model/DataCubeColumn.js';
-import type { DataCubeQuerySnapshotProcessingContext } from './DataCubeQuerySnapshot.js';
+import type { DataCubeSnapshotProcessingContext } from './DataCubeSnapshot.js';
 import { at } from '@finos/legend-shared';
 
 export function newColumnConfiguration(
   column: DataCubeColumn,
-  context?: DataCubeQuerySnapshotProcessingContext | undefined,
+  context?: DataCubeSnapshotProcessingContext | undefined,
 ): DataCubeColumnConfiguration {
   const { name, type } = column;
   const config = new DataCubeColumnConfiguration(name, type);
@@ -108,7 +108,7 @@ export function newColumnConfiguration(
 }
 
 export function newConfiguration(
-  context: DataCubeQuerySnapshotProcessingContext,
+  context: DataCubeSnapshotProcessingContext,
 ): DataCubeConfiguration {
   const { snapshot, groupBySortColumns } = context;
   const data = snapshot.data;

package/src/stores/core/DataCubeEngine.tsx

@@ -67,7 +67,7 @@ import { DataCubeQueryFilterOperation__EndWithCaseInsensitive } from './filter/D
 import { DataCubeQueryFilterOperation__NotEndWith } from './filter/DataCubeQueryFilterOperation__NotEndWith.js';
 import { DataCubeQueryFilterOperation__IsNull } from './filter/DataCubeQueryFilterOperation__IsNull.js';
 import { DataCubeQueryFilterOperation__IsNotNull } from './filter/DataCubeQueryFilterOperation__IsNotNull.js';
-import { DataCubeQuerySnapshot } from './DataCubeQuerySnapshot.js';
+import { DataCubeSnapshot } from './DataCubeSnapshot.js';
 import { buildExecutableQuery } from './DataCubeQueryBuilder.js';
 import { _toCol, type DataCubeColumn } from './model/DataCubeColumn.js';
 import {
@@ -84,7 +84,7 @@ import {
   type PlainObject,
 } from '@finos/legend-shared';
 import type { CachedDataCubeSource } from './model/CachedDataCubeSource.js';
-import { DataCubeQuery } from './model/DataCubeQuery.js';
+import { DataCubeSpecification } from './model/DataCubeSpecification.js';
 import { newConfiguration } from './DataCubeConfigurationBuilder.js';
 
 export type CompletionItem = {
@@ -197,7 +197,7 @@ export abstract class DataCubeEngine {
    * Then remove this dummy value from the final code.
    */
   async getPartialQueryCode(
-    snapshot: DataCubeQuerySnapshot,
+    snapshot: DataCubeSnapshot,
     pretty?: boolean | undefined,
   ) {
     const source = new INTERNAL__DataCubeSource();
@@ -212,14 +212,14 @@ export abstract class DataCubeEngine {
     ).substring(`''->`.length);
   }
 
-  async generateBaseQuery(sourceData: PlainObject) {
-    const source = await this.processQuerySource(sourceData);
-    const query = new DataCubeQuery();
+  async generateBaseSpecification(sourceData: PlainObject) {
+    const source = await this.processSource(sourceData);
+    const query = new DataCubeSpecification();
     query.source = sourceData;
     query.query = await this.getValueSpecificationCode(
       _selectFunction(source.columns),
     );
-    const snapshot = DataCubeQuerySnapshot.create({});
+    const snapshot = DataCubeSnapshot.create({});
     snapshot.data.sourceColumns = source.columns.map(_toCol);
     snapshot.data.selectColumns = source.columns.map(_toCol);
     const configuration = newConfiguration({
@@ -231,7 +231,7 @@ export abstract class DataCubeEngine {
 
   // ---------------------------------- PROCESSOR ----------------------------------
 
-  abstract processQuerySource(sourceData: PlainObject): Promise<DataCubeSource>;
+  abstract processSource(sourceData: PlainObject): Promise<DataCubeSource>;
 
   abstract parseValueSpecification(
     code: string,

package/src/stores/core/DataCubeQueryBuilder.ts

@@ -18,7 +18,7 @@
  * [CORE]
  *
  * This and its corresponding utilitites are used to build the executable query from
- * the query snapshot. The executable query is then used to fetch data.
+ * the snapshot. The executable query is then used to fetch data.
  ***************************************************************************************/
 
 import {
@@ -26,7 +26,7 @@ import {
   V1_Lambda,
   type V1_AppliedFunction,
 } from '@finos/legend-graph';
-import { type DataCubeQuerySnapshot } from './DataCubeQuerySnapshot.js';
+import { type DataCubeSnapshot } from './DataCubeSnapshot.js';
 import { at, guaranteeType } from '@finos/legend-shared';
 import {
   DataCubeFunction,
@@ -55,12 +55,12 @@ import { _findCol } from './model/DataCubeColumn.js';
 import type { DataCubeEngine } from './DataCubeEngine.js';
 
 export function buildExecutableQuery(
-  snapshot: DataCubeQuerySnapshot,
+  snapshot: DataCubeSnapshot,
   source: DataCubeSource,
   engine: DataCubeEngine,
   options?: {
     postProcessor?: (
-      snapshot: DataCubeQuerySnapshot,
+      snapshot: DataCubeSnapshot,
       sequence: V1_AppliedFunction[],
       funcMap: DataCubeQueryFunctionMap,
       configuration: DataCubeConfiguration,