@finos/legend-application-studio 28.8.0 → 28.10.0

package/lib/stores/showcase/ShowcaseViewerEditorMode.js

@@ -0,0 +1,40 @@
+/**
+ * Copyright (c) 2020-present, Goldman Sachs
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { EditorMode } from '../editor/EditorMode.js';
+import { generateShowcasePath } from '../../__lib__/LegendStudioNavigation.js';
+export class ShowcaseViewerEditorMode extends EditorMode {
+    showcaseViewerStore;
+    constructor(showcaseViewerStore) {
+        super();
+        this.showcaseViewerStore = showcaseViewerStore;
+    }
+    generateElementLink(elementPath) {
+        return generateShowcasePath(this.showcaseViewerStore.showcase.path);
+    }
+    generateDependencyElementLink(elementPath, dependencyProject) {
+        return generateShowcasePath(this.showcaseViewerStore.showcase.path);
+    }
+    get isInitialized() {
+        return Boolean(this.showcaseViewerStore._showcase);
+    }
+    get supportSdlcOperations() {
+        return false;
+    }
+    get label() {
+        return 'Showcase View';
+    }
+}
+//# sourceMappingURL=ShowcaseViewerEditorMode.js.map

package/lib/stores/showcase/ShowcaseViewerEditorMode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShowcaseViewerEditorMode.js","sourceRoot":"","sources":["../../../src/stores/showcase/ShowcaseViewerEditorMode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAErD,OAAO,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AAE/E,MAAM,OAAO,wBAAyB,SAAQ,UAAU;IAC7C,mBAAmB,CAAsB;IAElD,YAAY,mBAAwC;QAClD,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,mBAAmB,GAAG,mBAAmB,CAAC;IACjD,CAAC;IAEQ,mBAAmB,CAAC,WAAmB;QAC9C,OAAO,oBAAoB,CAAC,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACtE,CAAC;IACQ,6BAA6B,CACpC,WAAmB,EACnB,iBAAoC;QAEpC,OAAO,oBAAoB,CAAC,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACtE,CAAC;IAED,IAAa,aAAa;QACxB,OAAO,OAAO,CAAC,IAAI,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC;IACrD,CAAC;IAED,IAAa,qBAAqB;QAChC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAa,KAAK;QAChB,OAAO,eAAe,CAAC;IACzB,CAAC;CACF"}

package/lib/stores/showcase/ShowcaseViewerStore.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Copyright (c) 2020-present, Goldman Sachs
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { type GeneratorFn } from '@finos/legend-shared';
+import type { EditorStore } from '../editor/EditorStore.js';
+import type { ShowcaseViewerPathParams } from '../../__lib__/LegendStudioNavigation.js';
+import { type Showcase } from '@finos/legend-server-showcase';
+import type { Entity } from '@finos/legend-storage';
+export declare class ShowcaseViewerStore {
+    readonly editorStore: EditorStore;
+    private readonly showcaseServerClient?;
+    _showcase: Showcase | undefined;
+    constructor(editorStore: EditorStore);
+    private get client();
+    get showcase(): Showcase;
+    setShowcase(val: Showcase): void;
+    initialize(params: ShowcaseViewerPathParams): GeneratorFn<void>;
+    buildGraph(entities: Entity[]): GeneratorFn<boolean>;
+}
+//# sourceMappingURL=ShowcaseViewerStore.d.ts.map

package/lib/stores/showcase/ShowcaseViewerStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShowcaseViewerStore.d.ts","sourceRoot":"","sources":["../../../src/stores/showcase/ShowcaseViewerStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAEL,KAAK,WAAW,EAKjB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,yCAAyC,CAAC;AAExF,OAAO,EAEL,KAAK,QAAQ,EACd,MAAM,+BAA+B,CAAC;AAYvC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAEpD,qBAAa,mBAAmB;IAC9B,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CAA+B;IACrE,SAAS,EAAE,QAAQ,GAAG,SAAS,CAAC;gBAEpB,WAAW,EAAE,WAAW;IAcpC,OAAO,KAAK,MAAM,GAKjB;IAED,IAAI,QAAQ,IAAI,QAAQ,CAEvB;IAED,WAAW,CAAC,GAAG,EAAE,QAAQ,GAAG,IAAI;IAI/B,UAAU,CAAC,MAAM,EAAE,wBAAwB,GAAG,WAAW,CAAC,IAAI,CAAC;IAwF/D,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,WAAW,CAAC,OAAO,CAAC;CAyHtD"}

package/lib/stores/showcase/ShowcaseViewerStore.js

@@ -0,0 +1,193 @@
+/**
+ * Copyright (c) 2020-present, Goldman Sachs
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { guaranteeNonNullable, assertErrorThrown, StopWatch, LogEvent, assertNonEmptyString, } from '@finos/legend-shared';
+import { flow, flowResult, makeObservable, observable } from 'mobx';
+import { LEGEND_STUDIO_APP_EVENT } from '../../__lib__/LegendStudioEvent.js';
+import { ShowcaseRegistryServerClient, } from '@finos/legend-server-showcase';
+import { DependencyGraphBuilderError, GRAPH_MANAGER_EVENT, GraphBuilderError, GraphDataDeserializationError, createGraphBuilderReport, } from '@finos/legend-graph';
+import { DEFAULT_TAB_SIZE } from '@finos/legend-application';
+import { payloadDebugger } from '../editor/panel-group/DevToolPanelState.js';
+import { LegendStudioTelemetryHelper } from '../../__lib__/LegendStudioTelemetryHelper.js';
+import { GRAPH_EDITOR_MODE } from '../editor/EditorConfig.js';
+export class ShowcaseViewerStore {
+    editorStore;
+    showcaseServerClient;
+    _showcase;
+    constructor(editorStore) {
+        this.editorStore = editorStore;
+        makeObservable(this, {
+            _showcase: observable,
+            initialize: flow,
+            buildGraph: flow,
+        });
+        if (this.editorStore.applicationStore.config.showcaseServerUrl) {
+            this.showcaseServerClient = new ShowcaseRegistryServerClient({
+                baseUrl: this.editorStore.applicationStore.config.showcaseServerUrl,
+            });
+        }
+    }
+    get client() {
+        return guaranteeNonNullable(this.showcaseServerClient, `Showcase registry server client is not configured`);
+    }
+    get showcase() {
+        return guaranteeNonNullable(this._showcase);
+    }
+    setShowcase(val) {
+        this._showcase = val;
+    }
+    *initialize(params) {
+        if (!this.editorStore.initState.isInInitialState) {
+            return;
+        }
+        const showcasePath = params[0];
+        this.editorStore.initState.inProgress();
+        const onLeave = (hasBuildSucceeded) => {
+            this.editorStore.initState.complete(hasBuildSucceeded);
+        };
+        try {
+            const stopWatch = new StopWatch();
+            assertNonEmptyString(showcasePath, 'Showcase path expected');
+            // fetch showcase
+            this.editorStore.initState.setMessage(`Fetching Showcase Data...`);
+            this._showcase = (yield this.client.getShowcase(showcasePath));
+            // initialize graph manager
+            yield this.editorStore.graphManagerState.graphManager.initialize({
+                env: this.editorStore.applicationStore.config.env,
+                tabSize: DEFAULT_TAB_SIZE,
+                clientConfig: {
+                    baseUrl: this.editorStore.applicationStore.config.engineServerUrl,
+                    queryBaseUrl: this.editorStore.applicationStore.config.engineQueryServerUrl,
+                    enableCompression: true,
+                    payloadDebugger,
+                },
+            }, {
+                tracerService: this.editorStore.applicationStore.tracerService,
+            });
+            // convert code to entities
+            stopWatch.record();
+            const grammar = this.showcase.code;
+            this.editorStore.initState.setMessage(`Converting showcase code to entities...`);
+            const entities = (yield this.editorStore.graphManagerState.graphManager.pureCodeToEntities(grammar, 
+            // we want to keep section index so we read imports correctly
+            {
+                TEMPORARY__keepSectionIndex: true,
+            }));
+            this.editorStore.initState.setMessage(undefined);
+            stopWatch.record(GRAPH_MANAGER_EVENT.FETCH_GRAPH_ENTITIES__SUCCESS);
+            const graphBuilderResult = (yield flowResult(this.buildGraph(entities)));
+            if (!graphBuilderResult) {
+                onLeave(false);
+                return;
+            }
+            this.editorStore.initState.setMessage(`Generating elements...`);
+            if (this.editorStore.graphManagerState.graph.ownGenerationSpecifications
+                .length) {
+                yield flowResult(this.editorStore.graphState.graphGenerationState.globalGenerate());
+            }
+            // build explorer tree
+            this.editorStore.explorerTreeState.buildImmutableModelTrees();
+            this.editorStore.explorerTreeState.build();
+            // complete actions
+            this.editorStore.initState.setMessage(undefined);
+            onLeave(true);
+        }
+        catch (error) {
+            assertErrorThrown(error);
+            this.editorStore.applicationStore.logService.error(LogEvent.create(LEGEND_STUDIO_APP_EVENT.SDLC_MANAGER_FAILURE), error);
+            this.editorStore.applicationStore.notificationService.notifyError(error);
+            onLeave(false);
+        }
+    }
+    *buildGraph(entities) {
+        try {
+            const stopWatch = new StopWatch();
+            yield this.editorStore.graphManagerState.initializeSystem();
+            // reset
+            this.editorStore.graphManagerState.resetGraph();
+            // build dependencies
+            stopWatch.record();
+            const dependencyManager = this.editorStore.graphManagerState.graphManager.createDependencyManager();
+            this.editorStore.graphManagerState.graph.dependencyManager =
+                dependencyManager;
+            const dependency_buildReport = createGraphBuilderReport();
+            yield this.editorStore.graphManagerState.graphManager.buildDependencies(this.editorStore.graphManagerState.coreModel, this.editorStore.graphManagerState.systemModel, dependencyManager, new Map(), this.editorStore.graphManagerState.dependenciesBuildState, {}, dependency_buildReport);
+            // build graph
+            const graph_buildReport = createGraphBuilderReport();
+            yield this.editorStore.graphManagerState.graphManager.buildGraph(this.editorStore.graphManagerState.graph, entities, this.editorStore.graphManagerState.graphBuildState, undefined, graph_buildReport);
+            // report
+            stopWatch.record(GRAPH_MANAGER_EVENT.INITIALIZE_GRAPH__SUCCESS);
+            const graphBuilderReportData = {
+                timings: this.editorStore.applicationStore.timeService.finalizeTimingsRecord(stopWatch),
+                dependencies: dependency_buildReport,
+                dependenciesCount: this.editorStore.graphManagerState.graph.dependencyManager
+                    .numberOfDependencies,
+                graph: graph_buildReport,
+            };
+            LegendStudioTelemetryHelper.logEvent_GraphInitializationSucceeded(this.editorStore.applicationStore.telemetryService, graphBuilderReportData);
+            this.editorStore.applicationStore.logService.info(LogEvent.create(GRAPH_MANAGER_EVENT.INITIALIZE_GRAPH__SUCCESS), graphBuilderReportData);
+            // fetch available editor configurations
+            yield Promise.all([
+                this.editorStore.graphState.graphGenerationState.globalFileGenerationState.fetchAvailableFileGenerationDescriptions(),
+                this.editorStore.graphState.graphGenerationState.externalFormatState.fetchExternalFormatDescriptions(),
+                this.editorStore.graphState.graphGenerationState.externalFormatState.fetchExternalFormatDescriptions(),
+                this.editorStore.graphState.fetchAvailableFunctionActivatorConfigurations(),
+            ]);
+            return true;
+        }
+        catch (error) {
+            assertErrorThrown(error);
+            // if graph builder fails, we fall back to text-mode
+            this.editorStore.applicationStore.logService.error(LogEvent.create(GRAPH_MANAGER_EVENT.GRAPH_BUILDER_FAILURE), error);
+            if (error instanceof DependencyGraphBuilderError) {
+                // no recovery if dependency models cannot be built, this makes assumption that all dependencies models are compiled successfully
+                // TODO: we might want to handle this more gracefully when we can show people the dependency model element in the future
+                this.editorStore.applicationStore.notificationService.notifyError(`Can't initialize dependency models. Error: ${error.message}`);
+                this.editorStore.applicationStore.alertService.setBlockingAlert({
+                    message: `Can't initialize dependencies`,
+                    prompt: 'Please use editor to better invesigate the issue',
+                });
+            }
+            else if (error instanceof GraphDataDeserializationError) {
+                // if something goes wrong with de-serialization, we can't really do anything but to alert
+                this.editorStore.applicationStore.notificationService.notifyError(`Can't deserialize graph. Error: ${error.message}`);
+                this.editorStore.applicationStore.alertService.setBlockingAlert({
+                    message: `Can't deserialize graph`,
+                    prompt: 'Please use editor to better invesigate the issue',
+                });
+            }
+            else if (error instanceof GraphBuilderError) {
+                // TODO: we should split this into 2 notifications when we support multiple notifications
+                this.editorStore.applicationStore.notificationService.notifyError(`Can't build graph. Redirected to text mode for debugging. Error: ${error.message}`);
+                yield flowResult(this.editorStore.switchModes(GRAPH_EDITOR_MODE.GRAMMAR_TEXT, {
+                    isGraphBuildFailure: true,
+                }));
+                if (this.editorStore.graphEditorMode.mode === GRAPH_EDITOR_MODE.FORM) {
+                    // nothing we can do here so we will just block the user
+                    this.editorStore.applicationStore.alertService.setBlockingAlert({
+                        message: `Can't compose Pure code from graph models`,
+                        prompt: 'Please use editor to better invesigate the issue',
+                    });
+                    return false;
+                }
+            }
+            else {
+                this.editorStore.applicationStore.notificationService.notifyError(error);
+            }
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=ShowcaseViewerStore.js.map

package/lib/stores/showcase/ShowcaseViewerStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShowcaseViewerStore.js","sourceRoot":"","sources":["../../../src/stores/showcase/ShowcaseViewerStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EACL,oBAAoB,EAEpB,iBAAiB,EACjB,SAAS,EACT,QAAQ,EACR,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAEpE,OAAO,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,OAAO,EACL,4BAA4B,GAE7B,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,2BAA2B,EAC3B,mBAAmB,EACnB,iBAAiB,EACjB,6BAA6B,EAC7B,wBAAwB,GACzB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,4CAA4C,CAAC;AAC7E,OAAO,EAAE,2BAA2B,EAAE,MAAM,8CAA8C,CAAC;AAC3F,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAG9D,MAAM,OAAO,mBAAmB;IACrB,WAAW,CAAc;IACjB,oBAAoB,CAAgC;IACrE,SAAS,CAAuB;IAEhC,YAAY,WAAwB;QAClC,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,cAAc,CAAC,IAAI,EAAE;YACnB,SAAS,EAAE,UAAU;YACrB,UAAU,EAAE,IAAI;YAChB,UAAU,EAAE,IAAI;SACjB,CAAC,CAAC;QACH,IAAI,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAAC,MAAM,CAAC,iBAAiB,EAAE;YAC9D,IAAI,CAAC,oBAAoB,GAAG,IAAI,4BAA4B,CAAC;gBAC3D,OAAO,EAAE,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAAC,MAAM,CAAC,iBAAiB;aACpE,CAAC,CAAC;SACJ;IACH,CAAC;IAED,IAAY,MAAM;QAChB,OAAO,oBAAoB,CACzB,IAAI,CAAC,oBAAoB,EACzB,mDAAmD,CACpD,CAAC;IACJ,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,oBAAoB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC9C,CAAC;IAED,WAAW,CAAC,GAAa;QACvB,IAAI,CAAC,SAAS,GAAG,GAAG,CAAC;IACvB,CAAC;IAED,CAAC,UAAU,CAAC,MAAgC;QAC1C,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,gBAAgB,EAAE;YAChD,OAAO;SACR;QAED,MAAM,YAAY,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QAC/B,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,UAAU,EAAE,CAAC;QACxC,MAAM,OAAO,GAAG,CAAC,iBAA0B,EAAQ,EAAE;YACnD,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC;QACzD,CAAC,CAAC;QAEF,IAAI;YACF,MAAM,SAAS,GAAG,IAAI,SAAS,EAAE,CAAC;YAClC,oBAAoB,CAAC,YAAY,EAAE,wBAAwB,CAAC,CAAC;YAC7D,iBAAiB;YACjB,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,UAAU,CAAC,2BAA2B,CAAC,CAAC;YACnE,IAAI,CAAC,SAAS,GAAG,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,CAC7C,YAAY,CACb,CAAa,CAAC;YACf,2BAA2B;YAC3B,MAAM,IAAI,CAAC,WAAW,CAAC,iBAAiB,CAAC,YAAY,CAAC,UAAU,CAC9D;gBACE,GAAG,EAAE,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAAC,MAAM,CAAC,GAAG;gBACjD,OAAO,EAAE,gBAAgB;gBACzB,YAAY,EAAE;oBACZ,OAAO,EAAE,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAAC,MAAM,CAAC,eAAe;oBACjE,YAAY,EACV,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAAC,MAAM,CAAC,oBAAoB;oBAC/D,iBAAiB,EAAE,IAAI;oBACvB,eAAe;iBAChB;aACF,EACD;gBACE,aAAa,EAAE,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAAC,aAAa;aAC/D,CACF,CAAC;YACF,2BAA2B;YAC3B,SAAS,CAAC,MAAM,EAAE,CAAC;YACnB,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;YACnC,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,UAAU,CACnC,yCAAyC,CAC1C,CAAC;YACF,MAAM,QAAQ,GACZ,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,iBAAiB,CAAC,YAAY,CAAC,kBAAkB,CACvE,OAAO;YACP,6DAA6D;YAC7D;gBACE,2BAA2B,EAAE,IAAI;aAClC,CACF,CAAa,CAAC;YACjB,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;YACjD,SAAS,CAAC,MAAM,CAAC,mBAAmB,CAAC,6BAA6B,CAAC,CAAC;YACpE,MAAM,kBAAkB,GAAG,CAAC,MAAM,UAAU,CAC1C,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAC1B,CAAY,CAAC;YAEd,IAAI,CAAC,kBAAkB,EAAE;gBACvB,OAAO,CAAC,KAAK,CAAC,CAAC;gBACf,OAAO;aACR;YACD,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,UAAU,CAAC,wBAAwB,CAAC,CAAC;YAChE,IACE,IAAI,CAAC,WAAW,CAAC,iBAAiB,CAAC,KAAK,CAAC,2BAA2B;iBACjE,MAAM,EACT;gBACA,MAAM,UAAU,CACd,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,oBAAoB,CAAC,cAAc,EAAE,CAClE,CAAC;aACH;YAED,sBAAsB;YACtB,IAAI,CAAC,WAAW,CAAC,iBAAiB,CAAC,wBAAwB,EAAE,CAAC;YAC9D,IAAI,CAAC,WAAW,CAAC,iBAAiB,CAAC,KAAK,EAAE,CAAC;YAE3C,mBAAmB;YACnB,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;YACjD,OAAO,CAAC,IAAI,CAAC,CAAC;SACf;QAAC,OAAO,KAAK,EAAE;YACd,iBAAiB,CAAC,KAAK,CAAC,CAAC;YACzB,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAAC,UAAU,CAAC,KAAK,CAChD,QAAQ,CAAC,MAAM,CAAC,uBAAuB,CAAC,oBAAoB,CAAC,EAC7D,KAAK,CACN,CAAC;YACF,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAAC,mBAAmB,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;YACzE,OAAO,CAAC,KAAK,CAAC,CAAC;SAChB;IACH,CAAC;IAED,CAAC,UAAU,CAAC,QAAkB;QAC5B,IAAI;YACF,MAAM,SAAS,GAAG,IAAI,SAAS,EAAE,CAAC;YAClC,MAAM,IAAI,CAAC,WAAW,CAAC,iBAAiB,CAAC,gBAAgB,EAAE,CAAC;YAE5D,QAAQ;YACR,IAAI,CAAC,WAAW,CAAC,iBAAiB,CAAC,UAAU,EAAE,CAAC;YAEhD,qBAAqB;YACrB,SAAS,CAAC,MAAM,EAAE,CAAC;YACnB,MAAM,iBAAiB,GACrB,IAAI,CAAC,WAAW,CAAC,iBAAiB,CAAC,YAAY,CAAC,uBAAuB,EAAE,CAAC;YAC5E,IAAI,CAAC,WAAW,CAAC,iBAAiB,CAAC,KAAK,CAAC,iBAAiB;gBACxD,iBAAiB,CAAC;YAEpB,MAAM,sBAAsB,GAAG,wBAAwB,EAAE,CAAC;YAC1D,MAAM,IAAI,CAAC,WAAW,CAAC,iBAAiB,CAAC,YAAY,CAAC,iBAAiB,CACrE,IAAI,CAAC,WAAW,CAAC,iBAAiB,CAAC,SAAS,EAC5C,IAAI,CAAC,WAAW,CAAC,iBAAiB,CAAC,WAAW,EAC9C,iBAAiB,EACjB,IAAI,GAAG,EAAE,EACT,IAAI,CAAC,WAAW,CAAC,iBAAiB,CAAC,sBAAsB,EACzD,EAAE,EACF,sBAAsB,CACvB,CAAC;YAEF,cAAc;YACd,MAAM,iBAAiB,GAAG,wBAAwB,EAAE,CAAC;YACrD,MAAM,IAAI,CAAC,WAAW,CAAC,iBAAiB,CAAC,YAAY,CAAC,UAAU,CAC9D,IAAI,CAAC,WAAW,CAAC,iBAAiB,CAAC,KAAK,EACxC,QAAQ,EACR,IAAI,CAAC,WAAW,CAAC,iBAAiB,CAAC,eAAe,EAClD,SAAS,EACT,iBAAiB,CAClB,CAAC;YAEF,SAAS;YACT,SAAS,CAAC,MAAM,CAAC,mBAAmB,CAAC,yBAAyB,CAAC,CAAC;YAChE,MAAM,sBAAsB,GAAG;gBAC7B,OAAO,EACL,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAAC,WAAW,CAAC,qBAAqB,CACjE,SAAS,CACV;gBACH,YAAY,EAAE,sBAAsB;gBACpC,iBAAiB,EACf,IAAI,CAAC,WAAW,CAAC,iBAAiB,CAAC,KAAK,CAAC,iBAAiB;qBACvD,oBAAoB;gBACzB,KAAK,EAAE,iBAAiB;aACzB,CAAC;YACF,2BAA2B,CAAC,qCAAqC,CAC/D,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAAC,gBAAgB,EAClD,sBAAsB,CACvB,CAAC;YAEF,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAAC,UAAU,CAAC,IAAI,CAC/C,QAAQ,CAAC,MAAM,CAAC,mBAAmB,CAAC,yBAAyB,CAAC,EAC9D,sBAAsB,CACvB,CAAC;YAEF,wCAAwC;YACxC,MAAM,OAAO,CAAC,GAAG,CAAC;gBAChB,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,oBAAoB,CAAC,yBAAyB,CAAC,wCAAwC,EAAE;gBACrH,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,oBAAoB,CAAC,mBAAmB,CAAC,+BAA+B,EAAE;gBACtG,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,oBAAoB,CAAC,mBAAmB,CAAC,+BAA+B,EAAE;gBACtG,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,6CAA6C,EAAE;aAC5E,CAAC,CAAC;YAEH,OAAO,IAAI,CAAC;SACb;QAAC,OAAO,KAAK,EAAE;YACd,iBAAiB,CAAC,KAAK,CAAC,CAAC;YAEzB,oDAAoD;YACpD,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAAC,UAAU,CAAC,KAAK,CAChD,QAAQ,CAAC,MAAM,CAAC,mBAAmB,CAAC,qBAAqB,CAAC,EAC1D,KAAK,CACN,CAAC;YACF,IAAI,KAAK,YAAY,2BAA2B,EAAE;gBAChD,iIAAiI;gBACjI,wHAAwH;gBACxH,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAAC,mBAAmB,CAAC,WAAW,CAC/D,8CAA8C,KAAK,CAAC,OAAO,EAAE,CAC9D,CAAC;gBACF,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAAC,YAAY,CAAC,gBAAgB,CAAC;oBAC9D,OAAO,EAAE,+BAA+B;oBACxC,MAAM,EAAE,kDAAkD;iBAC3D,CAAC,CAAC;aACJ;iBAAM,IAAI,KAAK,YAAY,6BAA6B,EAAE;gBACzD,0FAA0F;gBAC1F,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAAC,mBAAmB,CAAC,WAAW,CAC/D,mCAAmC,KAAK,CAAC,OAAO,EAAE,CACnD,CAAC;gBACF,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAAC,YAAY,CAAC,gBAAgB,CAAC;oBAC9D,OAAO,EAAE,yBAAyB;oBAClC,MAAM,EAAE,kDAAkD;iBAC3D,CAAC,CAAC;aACJ;iBAAM,IAAI,KAAK,YAAY,iBAAiB,EAAE;gBAC7C,yFAAyF;gBACzF,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAAC,mBAAmB,CAAC,WAAW,CAC/D,oEAAoE,KAAK,CAAC,OAAO,EAAE,CACpF,CAAC;gBACF,MAAM,UAAU,CACd,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,iBAAiB,CAAC,YAAY,EAAE;oBAC3D,mBAAmB,EAAE,IAAI;iBAC1B,CAAC,CACH,CAAC;gBACF,IAAI,IAAI,CAAC,WAAW,CAAC,eAAe,CAAC,IAAI,KAAK,iBAAiB,CAAC,IAAI,EAAE;oBACpE,wDAAwD;oBACxD,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAAC,YAAY,CAAC,gBAAgB,CAAC;wBAC9D,OAAO,EAAE,2CAA2C;wBACpD,MAAM,EAAE,kDAAkD;qBAC3D,CAAC,CAAC;oBACH,OAAO,KAAK,CAAC;iBACd;aACF;iBAAM;gBACL,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAAC,mBAAmB,CAAC,WAAW,CAC/D,KAAK,CACN,CAAC;aACH;YACD,OAAO,KAAK,CAAC;SACd;IACH,CAAC;CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@finos/legend-application-studio",
-  "version": "28.8.0",
+  "version": "28.10.0",
   "description": "Legend Studio application core",
   "keywords": [
     "legend",
@@ -45,14 +45,14 @@
     "test:watch": "jest --watch"
   },
   "dependencies": {
-    "@finos/legend-application": "15.0.46",
-    "@finos/legend-art": "7.1.0",
-    "@finos/legend-graph": "31.3.7",
-    "@finos/legend-lego": "1.1.41",
-    "@finos/legend-query-builder": "4.10.2",
+    "@finos/legend-application": "15.0.48",
+    "@finos/legend-art": "7.1.2",
+    "@finos/legend-graph": "31.3.8",
+    "@finos/legend-lego": "1.1.43",
+    "@finos/legend-query-builder": "4.11.1",
     "@finos/legend-server-depot": "6.0.31",
     "@finos/legend-server-sdlc": "5.2.2",
-    "@finos/legend-server-showcase": "0.1.0",
+    "@finos/legend-server-showcase": "0.2.0",
     "@finos/legend-shared": "10.0.27",
     "@finos/legend-storage": "3.0.77",
     "@testing-library/react": "14.0.0",

package/src/__lib__/LegendStudioCommand.ts

@@ -20,6 +20,7 @@ export enum LEGEND_STUDIO_COMMAND_KEY {
   SYNC_WITH_WORKSPACE = 'editor.sync-workspace',
   CREATE_ELEMENT = 'editor.create-new-element',
   SEARCH_ELEMENT = 'editor.search-element',
+  OPEN_SHOWCASES = 'editor.show-showcases',
   TOGGLE_TEXT_MODE = 'editor.toggle-text-mode',
   GENERATE = 'editor.generate',
   COMPILE = 'editor.compile',
@@ -48,6 +49,10 @@ export const LEGEND_STUDIO_COMMAND_CONFIG: CommandConfigData = {
     title: 'Toggle model loader',
     defaultKeyboardShortcut: 'F2',
   },
+  [LEGEND_STUDIO_COMMAND_KEY.OPEN_SHOWCASES]: {
+    title: 'Open Showcases',
+    defaultKeyboardShortcut: 'F7',
+  },
   [LEGEND_STUDIO_COMMAND_KEY.TOGGLE_TEXT_MODE]: {
     title: 'Toggle text mode',
     defaultKeyboardShortcut: 'F8',

package/src/__lib__/LegendStudioNavigation.ts

@@ -20,6 +20,7 @@ import { guaranteeNonNullable } from '@finos/legend-shared';
 import { generatePath } from '@finos/legend-application/browser';
 
 export enum LEGEND_STUDIO_ROUTE_PATTERN_TOKEN {
+  SHOWCASE_PATH = 'showcasePath',
   PROJECT_ID = 'projectId',
   PATCH_RELEASE_VERSION_ID = 'patchReleaseVersionId',
   WORKSPACE_ID = 'workspaceId',
@@ -58,6 +59,7 @@ export const LEGEND_STUDIO_SDLC_BYPASSED_ROUTE_PATTERN = Object.freeze({
   VIEW_BY_GAV: `/view/archive/:${LEGEND_STUDIO_ROUTE_PATTERN_TOKEN.GAV}`,
   VIEW_BY_GAV_ENTITY: `/view/archive/:${LEGEND_STUDIO_ROUTE_PATTERN_TOKEN.GAV}/entity/:${LEGEND_STUDIO_ROUTE_PATTERN_TOKEN.ENTITY_PATH}`,
   PREVIEW_BY_GAV_ENTITY: `/view/archive/:${LEGEND_STUDIO_ROUTE_PATTERN_TOKEN.GAV}/entity/:${LEGEND_STUDIO_ROUTE_PATTERN_TOKEN.ENTITY_PATH}/preview`,
+  SHOWCASE_PROJECT: `/showcase/*`,
 });
 
 export type WorkspaceReviewPathParams = {
@@ -73,6 +75,10 @@ export type ProjectViewerPathParams = {
   [LEGEND_STUDIO_ROUTE_PATTERN_TOKEN.ENTITY_PATH]?: string;
 };
 
+export type ShowcaseViewerPathParams = {
+  [0]?: string;
+};
+
 export type WorkspaceEditorPathParams = {
   [LEGEND_STUDIO_ROUTE_PATTERN_TOKEN.PROJECT_ID]: string;
   [LEGEND_STUDIO_ROUTE_PATTERN_TOKEN.PATCH_RELEASE_VERSION_ID]?: string;
@@ -347,3 +353,8 @@ export const EXTERNAL_APPLICATION_NAVIGATION__generateServiceQueryCreatorUrl = (
     artifactId,
     versionId,
   )}/${servicePath}`;
+
+export const generateShowcasePath = (projectPath: string): string =>
+  generatePath(LEGEND_STUDIO_SDLC_BYPASSED_ROUTE_PATTERN.SHOWCASE_PROJECT, {
+    0: projectPath,
+  });

package/src/components/LegendStudioWebApplication.tsx

@@ -40,6 +40,7 @@ import {
   type TEMPORARY__ReactRouterComponentType,
 } from '@finos/legend-application/browser';
 import { LEGEND_STUDIO_DOCUMENTATION_KEY } from '../__lib__/LegendStudioDocumentation.js';
+import { ShowcaseViewer } from './showcase/ShowcaseViewer.js';
 
 const NotFoundPage = observer(() => {
   const applicationStore = useApplicationStore();
@@ -114,7 +115,6 @@ export const LegendStudioWebApplicationRouter = observer(() => {
       applicationStore.alertUnhandledError,
     );
   }, [applicationStore, baseStore]);
-
   return (
     <div className="app">
       {baseStore.initState.hasCompleted && (
@@ -133,6 +133,16 @@ export const LegendStudioWebApplicationRouter = observer(() => {
                     ProjectViewer as TEMPORARY__ReactRouterComponentType
                   }
                 />
+                <Route
+                  exact={true}
+                  path={
+                    LEGEND_STUDIO_SDLC_BYPASSED_ROUTE_PATTERN.SHOWCASE_PROJECT
+                  }
+                  component={
+                    // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+                    ShowcaseViewer as TEMPORARY__ReactRouterComponentType
+                  }
+                />
                 <Route>
                   <NotFoundPage />
                 </Route>

package/src/components/ShowcaseManager.tsx

@@ -32,6 +32,7 @@ import {
   TimesIcon,
   CodeIcon,
   clsx,
+  CopyIcon,
 } from '@finos/legend-art';
 import {
   SHOWCASE_MANAGER_SEARCH_CATEGORY,
@@ -48,6 +49,7 @@ import {
   CodeEditor,
 } from '@finos/legend-lego/code-editor';
 import React, { useEffect, useMemo, useRef } from 'react';
+import { generateShowcasePath } from '../__lib__/LegendStudioNavigation.js';
 
 const ShowcasesExplorerTreeNodeContainer = observer(
   (
@@ -536,7 +538,23 @@ const ShowcaseViewer = observer(
   }) => {
     const { showcaseManagerState, showcase } = props;
     const prettyPath = showcase.path.replaceAll(/\s*\/\s*/g, ' / ');
-
+    const launchShowcase = (): void => {
+      const applicationStore = showcaseManagerState.applicationStore;
+      applicationStore.navigationService.navigator.visitAddress(
+        applicationStore.navigationService.navigator.generateAddress(
+          generateShowcasePath(showcase.path),
+        ),
+      );
+    };
+    const handleCopy =
+      showcaseManagerState.applicationStore.guardUnhandledError(() =>
+        showcaseManagerState.applicationStore.clipboardService.copyTextToClipboard(
+          showcase.code,
+          {
+            notifySuccessMessage: 'Showcase grammar copied to clipboard',
+          },
+        ),
+      );
     return (
       <div className="showcase-manager__view">
         <div className="showcase-manager__view__header">
@@ -583,7 +601,31 @@ const ShowcaseViewer = observer(
         </div>
         <div className="showcase-manager__view__content showcase-manager__viewer__content">
           <div className="showcase-manager__viewer__title">
-            {showcase.title}
+            <div className="showcase-manager__viewer__title__label">
+              {showcase.title}
+            </div>
+            <div className="showcase-manager__viewer__title__action">
+              <div className="btn__dropdown-combo btn__dropdown-combo--primary showcase-manager__viewer__title__action-btn">
+                <button
+                  className="btn__dropdown-combo__label"
+                  onClick={launchShowcase}
+                  title="Open Showcase Project"
+                  tabIndex={-1}
+                >
+                  <div className="btn__dropdown-combo__label__title">
+                    Launch
+                  </div>
+                </button>
+              </div>
+            </div>
+            <div className="showcase-manager__viewer__title__action">
+              <div
+                onClick={handleCopy}
+                className="showcase-manager__viewer__title__action-icon"
+              >
+                <CopyIcon />
+              </div>
+            </div>
           </div>
           <div className="showcase-manager__viewer__path">{prettyPath}</div>
           <div className="showcase-manager__viewer__code">

package/src/components/editor/ActivityBar.tsx

@@ -15,7 +15,11 @@
  */
 
 import { observer } from 'mobx-react-lite';
-import { ACTIVITY_MODE, PANEL_MODE } from '../../stores/editor/EditorConfig.js';
+import {
+  ACTIVITY_MODE,
+  PANEL_MODE,
+  USER_JOURNEYS,
+} from '../../stores/editor/EditorConfig.js';
 import { LEGEND_STUDIO_TEST_ID } from '../../__lib__/LegendStudioTesting.js';
 import {
   clsx,
@@ -36,6 +40,8 @@ import {
   MenuContentDivider,
   FlaskIcon,
   RobotIcon,
+  WorkflowIcon,
+  ReadMeIcon,
 } from '@finos/legend-art';
 import { useEditorStore } from './EditorStoreProvider.js';
 import { forwardRef, useState } from 'react';
@@ -47,8 +53,10 @@ import {
   ActivityBarItemExperimentalBadge,
   type ActivityBarItemConfig,
 } from '@finos/legend-lego/application';
-import { ShowcaseManagerState } from '../../stores/ShowcaseManagerState.js';
-import { SHOWCASE_MANAGER_VIRTUAL_ASSISTANT_TAB_KEY } from '../extensions/Core_LegendStudioApplicationPlugin.js';
+import {
+  ShowcaseManagerState,
+  openShowcaseManager,
+} from '../../stores/ShowcaseManagerState.js';
 
 const SettingsMenu = observer(
   forwardRef<HTMLDivElement, unknown>(function SettingsMenu(props, ref) {
@@ -103,17 +111,6 @@ export const ActivityBarMenu: React.FC = () => {
   // showcases
   const showcaseManagerState =
     ShowcaseManagerState.retrieveNullableState(applicationStore);
-  const openShowcaseManager = (): void => {
-    if (showcaseManagerState?.isEnabled) {
-      applicationStore.assistantService.setIsHidden(false);
-      applicationStore.assistantService.setIsOpen(true);
-      applicationStore.assistantService.setIsPanelMaximized(true);
-      applicationStore.assistantService.setSelectedTab(
-        SHOWCASE_MANAGER_VIRTUAL_ASSISTANT_TAB_KEY,
-      );
-    }
-  };
-
   return (
     <>
       <div className="activity-bar__menu">
@@ -128,7 +125,9 @@ export const ActivityBarMenu: React.FC = () => {
             <MenuContent>
               <MenuContentItem onClick={showAppInfo}>About</MenuContentItem>
               {showcaseManagerState?.isEnabled && (
-                <MenuContentItem onClick={openShowcaseManager}>
+                <MenuContentItem
+                  onClick={() => openShowcaseManager(applicationStore)}
+                >
                   See Showcases
                 </MenuContentItem>
               )}
@@ -363,6 +362,23 @@ export const ActivityBar = observer(() => {
     ] as (ActivityBarItemConfig | boolean)[]
   ).filter((activity): activity is ActivityBarItemConfig => Boolean(activity));
 
+  const userJourneys: ActivityBarItemConfig[] = (
+    [
+      !editorStore.isInConflictResolutionMode &&
+        editorStore.applicationStore.config.options
+          .TEMPORARY__enableEndtoEndWorkflow && {
+          mode: USER_JOURNEYS.END_TO_END_WORKFLOWS,
+          title: 'End to End Workflows (Beta)',
+          icon: (
+            <div>
+              <WorkflowIcon className="activity-bar__icon--service-registrar" />
+              <ActivityBarItemExperimentalBadge />
+            </div>
+          ),
+        },
+    ] as (ActivityBarItemConfig | boolean)[]
+  ).filter((activity): activity is ActivityBarItemConfig => Boolean(activity));
+
   return (
     <div className="activity-bar">
       <ActivityBarMenu />
@@ -382,9 +398,34 @@ export const ActivityBar = observer(() => {
             {activity.icon}
           </button>
         ))}
+        <MenuContentDivider />
+        {userJourneys.map((activity) => (
+          <button
+            key={activity.mode}
+            className={clsx('activity-bar__item', {
+              'activity-bar__item--active':
+                editorStore.sideBarDisplayState.isOpen &&
+                editorStore.activeActivity === activity.mode,
+            })}
+            onClick={changeActivity(activity.mode)}
+            tabIndex={-1}
+            title={activity.title}
+          >
+            {activity.icon}
+          </button>
+        ))}
       </div>
+      <button
+        className={clsx('activity-bar__item')}
+        onClick={() => openShowcaseManager(editorStore.applicationStore)}
+        tabIndex={-1}
+        title={'Open Showcases'}
+      >
+        <ReadMeIcon />
+      </button>
       <DropdownMenu
         className="activity-bar__item"
+        title="Settings"
         content={<SettingsMenu />}
         menuProps={{
           anchorOrigin: { vertical: 'bottom', horizontal: 'right' },

package/src/components/editor/editor-group/EditorGroup.tsx

@@ -77,6 +77,8 @@ import { INTERNAL__UnknownFunctionActivatorEdtiorState } from '../../../stores/e
 import { INTERNAL__UnknownFunctionActivatorEdtior } from './INTERNAL__UnknownFunctionActivatorEdtior.js';
 import { getElementIcon } from '../../ElementIconUtils.js';
 import { ArtifactGenerationViewerState } from '../../../stores/editor/editor-state/ArtifactGenerationViewerState.js';
+import { QueryConnectionEndToEndWorkflowEditorState } from '../../../stores/editor/editor-state/end-to-end-workflow-state/EndToEndWorkflowEditorState.js';
+import { QueryConnectionWorflowEditor } from './end-to-end-flow-editor/QueryConnectionWorkflowEditor.js';
 
 export const ViewerEditorGroupSplashScreen: React.FC = () => {
   const commandListWidth = 300;
@@ -119,7 +121,6 @@ export const EditorGroupSplashScreen: React.FC = () => {
   const commandListHeight = 180;
   const [showCommandList, setShowCommandList] = useState(false);
   const { ref, width, height } = useResizeDetector<HTMLDivElement>();
-
   useEffect(() => {
     setShowCommandList(
       (width ?? 0) > commandListWidth && (height ?? 0) > commandListHeight,
@@ -157,6 +158,14 @@ export const EditorGroupSplashScreen: React.FC = () => {
             <div className="hotkey__key">S</div>
           </div>
         </div>
+        <div className="editor-group__splash-screen__content__item">
+          <div className="editor-group__splash-screen__content__item__label">
+            Open Showcases
+          </div>
+          <div className="editor-group__splash-screen__content__item__hot-keys">
+            <div className="hotkey__key">F7</div>
+          </div>
+        </div>
         <div className="editor-group__splash-screen__content__item">
           <div className="editor-group__splash-screen__content__item__label">
             Toggle Hackermode
@@ -315,6 +324,17 @@ export const EditorGroup = observer(() => {
       return <ModelImporter />;
     } else if (currentTabState instanceof ProjectConfigurationEditorState) {
       return <ProjectConfigurationEditor />;
+    } else if (
+      currentTabState instanceof QueryConnectionEndToEndWorkflowEditorState
+    ) {
+      return (
+        <QueryConnectionWorflowEditor
+          queryConnectionEndToEndWorkflowState={
+            editorStore.globalEndToEndWorkflowState
+              .queryConnectionEndToEndWorkflowState
+          }
+        />
+      );
     }
     // TODO: create an editor for unsupported tab
     return null;