@finos/legend-application 7.2.0 → 8.0.0

package/src/stores/AssistantService.ts

@@ -25,12 +25,15 @@ import {
   isNonNullable,
   ActionState,
 } from '@finos/legend-shared';
+import { TextSearchAdvancedConfigState } from './shared/TextSearchAdvancedConfigState.js';
 
 export enum VIRTUAL_ASSISTANT_TAB {
   SEARCH = 'SEARCH',
   CONTEXTUAL_SUPPORT = 'CONTEXTUAL_SUPPORT',
 }
 
+export const DOCUMENTATION_SEARCH_RESULTS_LIMIT = 100;
+
 export class VirtualAssistantDocumentationEntry {
   uuid = uuid();
   documentationKey: string;
@@ -79,7 +82,6 @@ export class VirtualAssistantContextualDocumentationEntry {
 
 export class AssistantService {
   readonly applicationStore: GenericLegendApplicationStore;
-  private readonly searchEngine: Fuse<DocumentationEntry>;
   /**
    * This key is used to allow programmatic re-rendering of the assistant panel
    */
@@ -87,19 +89,28 @@ export class AssistantService {
   isHidden = false;
   isOpen = false;
   selectedTab = VIRTUAL_ASSISTANT_TAB.SEARCH;
+  currentDocumentationEntry: VirtualAssistantDocumentationEntry | undefined;
 
-  searchResults: VirtualAssistantDocumentationEntry[] = [];
-  searchState = ActionState.create().pass();
+  // search text
+  private readonly searchEngine: Fuse<DocumentationEntry>;
+  searchConfigurationState: TextSearchAdvancedConfigState;
+  searchState = ActionState.create();
   searchText = '';
+  searchResults: VirtualAssistantDocumentationEntry[] = [];
+  showSearchConfigurationMenu = false;
+  isOverSearchLimit = false;
 
   constructor(applicationStore: GenericLegendApplicationStore) {
     makeObservable(this, {
       isHidden: observable,
       isOpen: observable,
       panelRenderingKey: observable,
+      isOverSearchLimit: observable,
       selectedTab: observable,
       searchText: observable,
       searchResults: observable,
+      currentDocumentationEntry: observable,
+      showSearchConfigurationMenu: observable,
       currentContextualDocumentationEntry: computed,
       setIsHidden: action,
       setIsOpen: action,
@@ -107,7 +118,9 @@ export class AssistantService {
       setSearchText: action,
       resetSearch: action,
       search: action,
+      openDocumentationEntry: action,
       refreshPanelRendering: action,
+      setShowSearchConfigurationMenu: action,
     });
 
     this.applicationStore = applicationStore;
@@ -143,8 +156,14 @@ export class AssistantService {
             weight: 1,
           },
         ],
+        // extended search allows for exact word match through single quote
+        // See https://fusejs.io/examples.html#extended-search
+        useExtendedSearch: true,
       },
     );
+    this.searchConfigurationState = new TextSearchAdvancedConfigState(() => {
+      this.search();
+    });
   }
 
   get currentContextualDocumentationEntry():
@@ -159,6 +178,7 @@ export class AssistantService {
       this.applicationStore.documentationService.getContextualDocEntry(
         currentContext,
       );
+
     return currentContextualDocumentationEntry
       ? new VirtualAssistantContextualDocumentationEntry(
           currentContext,
@@ -181,6 +201,22 @@ export class AssistantService {
       : undefined;
   }
 
+  openDocumentationEntry(docKey: string): void {
+    const matchingDocEntry = this.applicationStore.documentationService
+      .getAllDocEntries()
+      .find((entry) => entry._documentationKey === docKey);
+
+    if (matchingDocEntry) {
+      this.setIsOpen(true);
+      this.setIsHidden(false);
+      this.currentDocumentationEntry = new VirtualAssistantDocumentationEntry(
+        matchingDocEntry,
+      );
+      this.currentDocumentationEntry.setIsOpen(true);
+      this.resetSearch();
+    }
+  }
+
   setIsHidden(val: boolean): void {
     this.isHidden = val;
   }
@@ -222,10 +258,39 @@ export class AssistantService {
   }
 
   search(): void {
+    if (!this.searchText) {
+      this.searchResults = [];
+      return;
+    }
+    this.currentDocumentationEntry = undefined;
     this.searchState.inProgress();
     this.searchResults = Array.from(
-      this.searchEngine.search(this.searchText).values(),
+      this.searchEngine
+        .search(
+          this.searchConfigurationState.generateSearchText(this.searchText),
+          {
+            // NOTE: search for limit + 1 item so we can know if there are more search results
+            limit: DOCUMENTATION_SEARCH_RESULTS_LIMIT + 1,
+          },
+        )
+        .values(),
     ).map((result) => new VirtualAssistantDocumentationEntry(result.item));
+
+    // check if the search results exceed the limit
+    if (this.searchResults.length > DOCUMENTATION_SEARCH_RESULTS_LIMIT) {
+      this.isOverSearchLimit = true;
+      this.searchResults = this.searchResults.slice(
+        0,
+        DOCUMENTATION_SEARCH_RESULTS_LIMIT,
+      );
+    } else {
+      this.isOverSearchLimit = false;
+    }
+
     this.searchState.complete();
   }
+
+  setShowSearchConfigurationMenu(val: boolean): void {
+    this.showSearchConfigurationMenu = val;
+  }
 }

package/src/stores/LegendApplicationDocumentation.ts

@@ -0,0 +1,19 @@
+/**
+ * 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.
+ */
+
+export enum LEGEND_APPLICATION_DOCUMENTATION_KEY {
+  QUESTION_HOW_TO_USE_ADVANCED_SEARCH_SYNTAX = 'question.how-to-use-advanced-search-syntax',
+}

package/src/stores/PureLanguageSupport.ts

@@ -124,10 +124,7 @@ const generateLanguageMonarch = (
       PURE_ELEMENT_NAME.MEASURE,
       PURE_ELEMENT_NAME.PROFILE,
       PURE_ELEMENT_NAME.FUNCTION,
-      PURE_ELEMENT_NAME.FLAT_DATA,
-      PURE_ELEMENT_NAME.DATABASE,
       PURE_ELEMENT_NAME.MAPPING,
-      PURE_ELEMENT_NAME.SERVICE,
       PURE_ELEMENT_NAME.RUNTIME,
       PURE_ELEMENT_NAME.CONNECTION,
       PURE_ELEMENT_NAME.FILE_GENERATION,
@@ -148,6 +145,9 @@ const generateLanguageMonarch = (
        * @modularize
        * See https://github.com/finos/legend-studio/issues/65
        */
+      PURE_ELEMENT_NAME.SERVICE,
+      PURE_ELEMENT_NAME.FLAT_DATA,
+      PURE_ELEMENT_NAME.DATABASE,
       PURE_CONNECTION_NAME.FLAT_DATA_CONNECTION,
       PURE_CONNECTION_NAME.RELATIONAL_DATABASE_CONNECTION,
       'Relational',

package/src/stores/shared/LambdaParameterState.ts

@@ -38,11 +38,13 @@ import {
 import {
   addUniqueEntry,
   deleteEntry,
+  type Hashable,
+  hashArray,
   IllegalStateError,
   isNonNullable,
   uuid,
 } from '@finos/legend-shared';
-import { makeObservable, observable, action } from 'mobx';
+import { makeObservable, observable, action, computed } from 'mobx';
 import {
   genericType_setRawType,
   multiplicity_setLowerBound,
@@ -54,6 +56,11 @@ export enum PARAMETER_SUBMIT_ACTION {
   EXPORT = 'EXPORT',
 }
 
+enum LAMABA_PARAMETER_HASH_STRUCTURE {
+  LAMBDA_PARAMETER_STATE = 'LAMBDA_PARAMETER_STATE',
+  LAMBDA_PARAMETERS_STATE = 'LAMBDA_PARAMETERS_STATE',
+}
+
 export const buildParametersLetLambdaFunc = (
   graph: PureModel,
   lambdaParametersStates: LambdaParameterState[],
@@ -87,7 +94,7 @@ export const buildParametersLetLambdaFunc = (
     .filter(isNonNullable);
   return letlambdaFunction;
 };
-export class LambdaParameterState {
+export class LambdaParameterState implements Hashable {
   readonly uuid = uuid();
   readonly parameter: VariableExpression;
   readonly graph: PureModel;
@@ -103,12 +110,21 @@ export class LambdaParameterState {
       value: observable,
       setValue: action,
       mockParameterValue: action,
+      hashCode: computed,
     });
     this.observableContext = observableContext;
     this.parameter = observe_VariableExpression(variableExpression);
     this.graph = graph;
   }
 
+  get hashCode(): string {
+    return hashArray([
+      LAMABA_PARAMETER_HASH_STRUCTURE.LAMBDA_PARAMETER_STATE,
+      this.value ?? '',
+      this.parameter.name,
+    ]);
+  }
+
   mockParameterValue(): void {
     this.setValue(
       generateVariableExpressionMockValue(this.parameter, this.graph),
@@ -204,10 +220,24 @@ export class ParameterInstanceValuesEditorState {
     this.setShowModal(false);
   }
 }
-export class LambdaParametersState {
+
+export class LambdaParametersState implements Hashable {
   parameterStates: LambdaParameterState[] = [];
   parameterValuesEditorState = new ParameterInstanceValuesEditorState();
 
+  constructor() {
+    makeObservable(this, {
+      hashCode: computed,
+    });
+  }
+
+  get hashCode(): string {
+    return hashArray([
+      LAMABA_PARAMETER_HASH_STRUCTURE.LAMBDA_PARAMETERS_STATE,
+      hashArray(this.parameterStates),
+    ]);
+  }
+
   addParameter(val: LambdaParameterState): void {
     addUniqueEntry(this.parameterStates, val);
   }

package/src/stores/shared/TextSearchAdvancedConfigState.ts

@@ -0,0 +1,65 @@
+/**
+ * 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 { action, computed, makeObservable, observable } from 'mobx';
+
+export enum ADVANCED_TEXT_SEARCH_MODE {
+  STANDARD = 'standard',
+  INCLUDE = 'include match',
+  EXACT = 'exact match',
+  INVERSE = 'excludes exact match',
+}
+
+export class TextSearchAdvancedConfigState {
+  currentMode = ADVANCED_TEXT_SEARCH_MODE.STANDARD;
+  onSearchModeChange: () => void;
+
+  constructor(onSearchModeChange: () => void) {
+    makeObservable(this, {
+      currentMode: observable,
+      isAdvancedSearchActive: computed,
+      setCurrentMode: action,
+    });
+
+    this.onSearchModeChange = onSearchModeChange;
+  }
+
+  get isAdvancedSearchActive(): boolean {
+    return this.currentMode !== ADVANCED_TEXT_SEARCH_MODE.STANDARD;
+  }
+
+  generateSearchText(val: string): string {
+    switch (this.currentMode) {
+      case ADVANCED_TEXT_SEARCH_MODE.INCLUDE: {
+        return `'"${val}"`;
+      }
+      case ADVANCED_TEXT_SEARCH_MODE.EXACT: {
+        return `="${val}"`;
+      }
+      case ADVANCED_TEXT_SEARCH_MODE.INVERSE: {
+        return `!"${val}"`;
+      }
+      default: {
+        return val;
+      }
+    }
+  }
+
+  setCurrentMode(val: ADVANCED_TEXT_SEARCH_MODE): void {
+    this.currentMode = val;
+    this.onSearchModeChange();
+  }
+}

package/tsconfig.json

@@ -40,6 +40,7 @@
     "./src/stores/AssistantService.ts",
     "./src/stores/DocumentationService.ts",
     "./src/stores/EventService.ts",
+    "./src/stores/LegendApplicationDocumentation.ts",
     "./src/stores/LegendApplicationPlugin.ts",
     "./src/stores/PureLanguageSupport.ts",
     "./src/stores/WebApplicationNavigator.ts",
@@ -47,6 +48,7 @@
     "./src/stores/shared/LambdaEditorState.ts",
     "./src/stores/shared/LambdaParameterState.ts",
     "./src/stores/shared/PackageableElementOption.ts",
+    "./src/stores/shared/TextSearchAdvancedConfigState.ts",
     "./src/stores/shared/ValueSpecificationModifierHelper.ts",
     "./src/application/LegendApplication.tsx",
     "./src/application/LegendApplicationPluginManager.tsx",
@@ -67,6 +69,7 @@
     "./src/components/shared/LambdaParameterValuesEditor.tsx",
     "./src/components/shared/PackageableElementOptionRenderer.tsx",
     "./src/components/shared/TextInputEditor.tsx",
+    "./src/components/shared/TextSearchAdvancedConfigMenu.tsx",
     "./src/components/shared/execution-plan-viewer/ExecutionPlanViewer.tsx",
     "./src/components/shared/execution-plan-viewer/SQLExecutionNodeViewer.tsx",
     "./src/stores/CJS__Fuse.cts"