@finos/legend-application 13.0.10 → 14.0.0

package/src/application/LegendApplicationDocumentation.ts

@@ -15,13 +15,5 @@
  */
 
 export enum LEGEND_APPLICATION_DOCUMENTATION_KEY {
-  TUTORIAL_QUERY_BUILDER = 'tutorial.query.builder',
   QUESTION_HOW_TO_USE_ADVANCED_SEARCH_SYNTAX = 'question.how-to-use-advanced-search-syntax',
-  QUESTION_WHEN_TO_CONFIGURE_PLATFORM_VERSIONS = 'question.when-to-configure-project-platform-dependencies-versions',
-  QUESTION_HOW_TO_WRITE_A_SERVICE_TEST = 'question.how-to-write-a-service-test',
-  QUESTION_WHY_DO_I_SEE_ERROR_WITH_ASSOCIATION_PROPERTY_TYPE = 'question.why-do-i-see-error-with-association-property-type',
-  QUESTION_HOW_TO_ADD_PARAMETERS_TO_QUERY = 'question.how-to-add-parameters-to-query',
-  QUESTION_HOW_TO_ADD_CONSTANTS_TO_QUERY = 'question.how-to-add-constants-to-query',
-  QUESTION_HOW_TO_WRITE_SERVICE_CONNECTION_TEST_DATA = 'question.how-to-write-service-connection-test-data',
-  QUESTION_HOW_TO_CREATE_A_DATA_ELEMENT = 'question.how-to-create-a-data-element',
 }

package/src/components/ApplicationStoreProvider.tsx

@@ -14,8 +14,8 @@
  * limitations under the License.
  */
 
-import { createContext, useContext } from 'react';
-import { useLocalObservable } from 'mobx-react-lite';
+import { createContext, useContext, useEffect } from 'react';
+import { observer, useLocalObservable } from 'mobx-react-lite';
 import {
   ApplicationStore,
   type GenericLegendApplicationStore,
@@ -30,6 +30,34 @@ const ApplicationStoreContext = createContext<
   GenericLegendApplicationStore | undefined
 >(undefined);
 
+export const useApplicationStore = <
+  T extends LegendApplicationConfig,
+  V extends LegendApplicationPluginManager<LegendApplicationPlugin>,
+>(): ApplicationStore<T, V> =>
+  guaranteeNonNullable(
+    useContext(ApplicationStoreContext) as ApplicationStore<T, V> | undefined,
+    `Can't find application store in context`,
+  );
+
+const ApplicationContent = observer(
+  (props: { children: React.ReactNode }): React.ReactElement => {
+    const { children } = props;
+    const applicationStore = useApplicationStore();
+
+    useEffect(() => {
+      applicationStore.initialize().catch(applicationStore.alertUnhandledError);
+    }, [applicationStore]);
+
+    if (!applicationStore.initState.hasSucceeded) {
+      return <></>;
+    }
+    // TODO: would be great if we can have <React.StrictMode> here but since Mobx React is not ready for
+    // concurrency yet, we would have to wait
+    // See https://github.com/mobxjs/mobx/issues/2526
+    return <>{children}</>;
+  },
+);
+
 export const ApplicationStoreProvider = <
   T extends LegendApplicationConfig,
   V extends LegendApplicationPluginManager<LegendApplicationPlugin>,
@@ -48,16 +76,7 @@ export const ApplicationStoreProvider = <
   );
   return (
     <ApplicationStoreContext.Provider value={applicationStore}>
-      {children}
+      <ApplicationContent>{children}</ApplicationContent>
     </ApplicationStoreContext.Provider>
   );
 };
-
-export const useApplicationStore = <
-  T extends LegendApplicationConfig,
-  V extends LegendApplicationPluginManager<LegendApplicationPlugin>,
->(): ApplicationStore<T, V> =>
-  guaranteeNonNullable(
-    useContext(ApplicationStoreContext) as ApplicationStore<T, V> | undefined,
-    `Can't find application store in context`,
-  );

package/src/components/VirtualAssistant.tsx

@@ -31,12 +31,13 @@ import {
   SunglassesIcon,
   WizardHatIcon,
   FaceLaughWinkIcon,
-  VerticalDragHandleThinIcon,
+  ThinVerticalDragHandleIcon,
   CircleIcon,
   PanelLoadingIndicator,
   BasePopover,
   FaceSadTearIcon,
   CogIcon,
+  Draggable,
 } from '@finos/legend-art';
 import {
   ContentType,
@@ -54,10 +55,9 @@ import {
   VIRTUAL_ASSISTANT_TAB,
 } from '../stores/AssistantService.js';
 import { useApplicationStore } from './ApplicationStoreProvider.js';
-import Draggable from 'react-draggable';
 import { DATE_TIME_FORMAT } from '@finos/legend-graph';
 import { LegendApplicationTelemetryHelper } from '../application/LegendApplicationTelemetry.js';
-import { TextSearchAdvancedConfigMenu } from './shared/TextSearchAdvancedConfigMenu.js';
+import { FuzzySearchAdvancedConfigMenu } from './shared/FuzzySearchAdvancedConfigMenu.js';
 
 const WIZARD_GREETING = `Bonjour, It's Pierre!`;
 
@@ -265,7 +265,6 @@ const VirtualAssistantContextualSupportPanel = observer(() => {
 const VirtualAssistantSearchPanel = observer(() => {
   const applicationStore = useApplicationStore();
   const searchInputRef = useRef<HTMLInputElement>(null);
-  const searchConfigButtonRef = useRef<HTMLButtonElement>(null);
   const assistantService = applicationStore.assistantService;
 
   // search text
@@ -285,6 +284,10 @@ const VirtualAssistantSearchPanel = observer(() => {
     assistantService.currentDocumentationEntry = undefined;
     searchInputRef.current?.focus();
   };
+  const toggleSearchConfigMenu = (): void =>
+    assistantService.setShowSearchConfigurationMenu(
+      !assistantService.showSearchConfigurationMenu,
+    );
 
   const downloadDocRegistry = (): void => {
     downloadFileUsingDataURI(
@@ -314,10 +317,6 @@ const VirtualAssistantSearchPanel = observer(() => {
       ContentType.APPLICATION_JSON,
     );
   };
-  const toggleSearchConfigMenu = (): void =>
-    assistantService.setShowSearchConfigurationMenu(
-      !assistantService.showSearchConfigurationMenu,
-    );
 
   useEffect(() => {
     searchInputRef.current?.focus();
@@ -374,7 +373,6 @@ const VirtualAssistantSearchPanel = observer(() => {
           </div>
         )}
         <button
-          ref={searchConfigButtonRef}
           className={clsx('virtual-assistant__search__input__config__trigger', {
             'virtual-assistant__search__input__config__trigger--toggled':
               assistantService.showSearchConfigurationMenu,
@@ -410,18 +408,16 @@ const VirtualAssistantSearchPanel = observer(() => {
         <PanelLoadingIndicator
           isLoading={assistantService.searchState.isInProgress}
         />
-        {/* {assistantService.showSearchConfigurationMenu && ( */}
         <div
           className={clsx('virtual-assistant__search__input__config__panel', {
             'virtual-assistant__search__input__config__panel--toggled':
               assistantService.showSearchConfigurationMenu,
           })}
         >
-          <TextSearchAdvancedConfigMenu
+          <FuzzySearchAdvancedConfigMenu
             configState={assistantService.searchConfigurationState}
           />
         </div>
-        {/* )} */}
         {assistantService.currentDocumentationEntry && (
           <div className="virtual-assistant__search__results">
             <VirtualAssistantDocumentationEntryViewer
@@ -747,7 +743,7 @@ export const VirtualAssistant = observer(() => {
               className="virtual-assistant__station__drag-handle__content"
               title={isDragging ? undefined : 'Grab to drag assistant'}
             >
-              <VerticalDragHandleThinIcon />
+              <ThinVerticalDragHandleIcon />
             </div>
           </ContextMenu>
         </div>

package/src/components/shared/DocumentationLink.tsx

@@ -15,8 +15,8 @@
  */
 
 import { clsx, QuestionCircleIcon } from '@finos/legend-art';
-import { shouldDisplayVirtualAssistantDocumentationEntry } from '../../stores/AssistantService.js';
 import { useApplicationStore } from '../ApplicationStoreProvider.js';
+import { shouldDisplayVirtualAssistantDocumentationEntry } from '../../stores/AssistantService.js';
 
 export const DocumentationLink: React.FC<{
   documentationKey: string;

package/src/components/shared/{TextSearchAdvancedConfigMenu.tsx → FuzzySearchAdvancedConfigMenu.tsx}

@@ -16,22 +16,22 @@
 
 import { BaseRadioGroup, InfoCircleIcon } from '@finos/legend-art';
 import { observer } from 'mobx-react-lite';
-import { LEGEND_APPLICATION_DOCUMENTATION_KEY } from '../../application/LegendApplicationDocumentation.js';
 import {
-  ADVANCED_TEXT_SEARCH_MODE,
-  type TextSearchAdvancedConfigState,
-} from '../../stores/shared/TextSearchAdvancedConfigState.js';
+  ADVANCED_FUZZY_SEARCH_MODE,
+  type FuzzySearchAdvancedConfigState,
+} from '../../stores/shared/FuzzySearchAdvancedConfigState.js';
+import { LEGEND_APPLICATION_DOCUMENTATION_KEY } from '../../application/LegendApplicationDocumentation.js';
 import { useApplicationStore } from '../ApplicationStoreProvider.js';
 
-export const TextSearchAdvancedConfigMenu = observer(
-  (props: { configState: TextSearchAdvancedConfigState }) => {
+export const FuzzySearchAdvancedConfigMenu = observer(
+  (props: { configState: FuzzySearchAdvancedConfigState }) => {
     const { configState } = props;
     const applicationStore = useApplicationStore();
 
     const handleSearchMode: React.ChangeEventHandler<HTMLInputElement> = (
       event,
     ): void => {
-      const searchMode = event.target.value as ADVANCED_TEXT_SEARCH_MODE;
+      const searchMode = event.target.value as ADVANCED_FUZZY_SEARCH_MODE;
       configState.setCurrentMode(searchMode);
     };
     const seeDocumentation = (): void =>
@@ -40,11 +40,11 @@ export const TextSearchAdvancedConfigMenu = observer(
       );
 
     return (
-      <div className="text-search-advanced-config__panel">
-        <div className="text-search-advanced-config__panel__header__label">
+      <div className="fuzzy-search__advanced-config__panel">
+        <div className="fuzzy-search__advanced-config__panel__header__label">
           search config
           <button
-            className="text-search-advanced-config__panel__header__hint"
+            className="fuzzy-search__advanced-config__panel__header__hint"
             tabIndex={-1}
             onClick={seeDocumentation}
             title="Click to see more details on advanced search"
@@ -59,10 +59,10 @@ export const TextSearchAdvancedConfigMenu = observer(
             onChange={handleSearchMode}
             row={false}
             options={[
-              ADVANCED_TEXT_SEARCH_MODE.STANDARD,
-              ADVANCED_TEXT_SEARCH_MODE.INCLUDE,
-              ADVANCED_TEXT_SEARCH_MODE.EXACT,
-              ADVANCED_TEXT_SEARCH_MODE.INVERSE,
+              ADVANCED_FUZZY_SEARCH_MODE.STANDARD,
+              ADVANCED_FUZZY_SEARCH_MODE.INCLUDE,
+              ADVANCED_FUZZY_SEARCH_MODE.EXACT,
+              ADVANCED_FUZZY_SEARCH_MODE.INVERSE,
             ]}
             size={1}
           />

package/src/components.ts

@@ -0,0 +1,23 @@
+/**
+ * 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 * from './components/shared/DocumentationLink.js';
+
+export * from './components/shared/TabManager.js';
+export * from './stores/shared/TabManagerState.js';
+
+export * from './components/shared/FuzzySearchAdvancedConfigMenu.js';
+export * from './stores/shared/FuzzySearchAdvancedConfigState.js';

package/src/const.ts

@@ -20,12 +20,14 @@ export const DEFAULT_TYPEAHEAD_SEARCH_LIMIT = 10;
 
 export const MONOSPACED_FONT_FAMILY = 'Roboto Mono';
 
-export enum EDITOR_THEME {
-  LEGEND = 'LEGEND',
+// TODO: to be moved to `@finos/legend-lego`
+export enum CODE_EDITOR_THEME {
+  LEGEND = 'legend',
   TEMPORARY__VSCODE_LIGHT = 'vs',
 }
 
-export enum EDITOR_LANGUAGE {
+// TODO: to be moved to `@finos/legend-lego`
+export enum CODE_EDITOR_LANGUAGE {
   TEXT = 'plaintext',
   PURE = 'pure',
   JSON = 'json',

package/src/index.ts

@@ -20,7 +20,6 @@ export * from './application/LegendApplication.js';
 export * from './application/LegendApplicationConfig.js';
 export * from './application/LegendApplicationPluginManager.js';
 export * from './application/LegendApplicationEvent.js';
-export * from './application/LegendApplicationDocumentation.js';
 export * from './application/LegendApplicationTelemetry.js';
 export * from './application/LegendApplicationSetting.js';
 export { LEGEND_APPLICATION_COLOR_THEME } from './application/LegendApplicationTheme.js';
@@ -60,24 +59,13 @@ export * from './stores/ApplicationStoreTestUtils.js';
 export * from './stores/navigation/WebApplicationRouter.js';
 export { DISPLAY_ANSI_ESCAPE } from './stores/terminal/Terminal.js';
 
-// ------------------------------------------- Shared components -------------------------------------------
+// ------------------------------------------- TO BE MOVED -------------------------------------------
 
-export * from './components/shared/DocumentationLink.js';
-
-/**
- * To be moved to other packages
- * @modularize
- */
-export * from './components/execution-plan-viewer/ExecutionPlanViewer.js';
-export * from './stores/ExecutionPlanState.js';
-
-export * from './components/shared/TextInputEditor.js';
+// TODO: move to `@finos/legend-lego/code-editor`
+export {
+  PURE_GRAMMAR_TOKEN,
+  setupPureLanguageService,
+} from './stores/pure-language/PureLanguageSupport.js';
+export * from './stores/pure-language/PureLanguageCodeEditorSupport.js';
 export * from './components/shared/PackageableElementOptionLabel.js';
-export { PURE_GRAMMAR_TOKEN } from './stores/pure-language/PureLanguageSupport.js';
-export * from './stores/pure-language/PureLanguageTextEditorSupport.js';
 export * from './stores/shared/PackageableElementOption.js';
-
-export * from './components/shared/TabManager.js';
-export * from './components/shared/TextSearchAdvancedConfigMenu.js';
-export * from './stores/shared/TabManagerState.js';
-export * from './stores/shared/TextSearchAdvancedConfigState.js';

package/src/stores/ApplicationStore.ts

@@ -19,6 +19,8 @@ import {
   LogService,
   LogEvent,
   uuid,
+  ActionState,
+  assertErrorThrown,
 } from '@finos/legend-shared';
 import { APPLICATION_EVENT } from '../application/LegendApplicationEvent.js';
 import type { LegendApplicationConfig } from '../application/LegendApplicationConfig.js';
@@ -56,6 +58,7 @@ export class ApplicationStore<
 
   readonly config: T;
   readonly pluginManager: V;
+  readonly initState = ActionState.create();
 
   // core
   readonly timeService: TimeService;
@@ -132,6 +135,34 @@ export class ApplicationStore<
     this.tracerService.registerPlugins(pluginManager.getTracerServicePlugins());
   }
 
+  async initialize(): Promise<void> {
+    if (!this.initState.isInInitialState) {
+      this.notificationService.notifyIllegalState(
+        'Application store is re-initialized',
+      );
+      return;
+    }
+    this.initState.inProgress();
+
+    try {
+      await Promise.all(
+        this.pluginManager
+          .getApplicationPlugins()
+          .flatMap((plugin) => plugin.getExtraApplicationSetups?.() ?? [])
+          .map((setup) => setup(this)),
+      );
+      this.initState.pass();
+    } catch (error) {
+      assertErrorThrown(error);
+      this.notificationService.notifyError(error);
+      this.logService.error(
+        LogEvent.create(APPLICATION_EVENT.APPLICATION_LOAD__FAILURE),
+        'Failed to load Legend application',
+      );
+      this.initState.fail();
+    }
+  }
+
   /**
    * When we call store/state functions from the component, we should handle error thrown at these functions instead
    * of throwing them to the UI. This enforces that by throwing `IllegalStateError`

package/src/stores/AssistantService.ts

@@ -17,15 +17,15 @@
 import { action, makeObservable, observable, computed } from 'mobx';
 import type { DocumentationEntry } from './DocumentationService.js';
 import type { GenericLegendApplicationStore } from './ApplicationStore.js';
-import { FuzzySearchEngine } from '@finos/legend-art';
 import {
   type MarkdownText,
   guaranteeNonEmptyString,
   uuid,
   isNonNullable,
   ActionState,
+  FuzzySearchEngine,
 } from '@finos/legend-shared';
-import { TextSearchAdvancedConfigState } from './shared/TextSearchAdvancedConfigState.js';
+import { FuzzySearchAdvancedConfigState } from './shared/FuzzySearchAdvancedConfigState.js';
 
 export enum VIRTUAL_ASSISTANT_TAB {
   SEARCH = 'SEARCH',
@@ -113,8 +113,8 @@ export class AssistantService {
 
   // search text
   private readonly searchEngine: FuzzySearchEngine<DocumentationEntry>;
-  searchConfigurationState: TextSearchAdvancedConfigState;
-  searchState = ActionState.create();
+  searchConfigurationState: FuzzySearchAdvancedConfigState;
+  readonly searchState = ActionState.create();
   searchText = '';
   searchResults: VirtualAssistantDocumentationEntry[] = [];
   showSearchConfigurationMenu = false;
@@ -178,7 +178,7 @@ export class AssistantService {
         useExtendedSearch: true,
       },
     );
-    this.searchConfigurationState = new TextSearchAdvancedConfigState(() => {
+    this.searchConfigurationState = new FuzzySearchAdvancedConfigState(() => {
       this.search();
     });
   }

package/src/stores/Core_LegendApplicationPlugin.ts

@@ -22,11 +22,89 @@ import {
   LEGACY_LIGHT_COLOR_THEME,
 } from '../application/LegendApplicationTheme.js';
 import type { ColorTheme } from './LayoutService.js';
-import { LegendApplicationPlugin } from './LegendApplicationPlugin.js';
+import {
+  LegendApplicationPlugin,
+  type LegendApplicationSetup,
+} from './LegendApplicationPlugin.js';
 import {
   collectSettingConfigurationEntriesFromConfig,
   type SettingConfigurationEntry,
 } from './SettingService.js';
+import { configure as configureMobx } from 'mobx';
+import { KeyCode, KeyMod, editor as monacoEditorAPI } from 'monaco-editor';
+import { MONOSPACED_FONT_FAMILY } from '../const.js';
+import { LogEvent } from '@finos/legend-shared';
+import { APPLICATION_EVENT } from '../application/LegendApplicationEvent.js';
+import { configureComponents } from '@finos/legend-art';
+import type { GenericLegendApplicationStore } from './ApplicationStore.js';
+
+const configureCodeEditorComponent = async (
+  applicationStore: GenericLegendApplicationStore,
+): Promise<void> => {
+  /**
+   * Since we use a custom fonts for text-editor, we want to make sure the font is loaded before any text-editor is opened
+   * this is to ensure
+   */
+  const fontLoadFailureErrorMessage = `Monospaced font '${MONOSPACED_FONT_FAMILY}' has not been loaded properly, text editor display problems might occur`;
+  await Promise.all(
+    [400, 700].map((weight) =>
+      document.fonts.load(`${weight} 1em ${MONOSPACED_FONT_FAMILY}`),
+    ),
+  )
+    .then(() => {
+      if (document.fonts.check(`1em ${MONOSPACED_FONT_FAMILY}`)) {
+        monacoEditorAPI.remeasureFonts();
+        applicationStore.logService.info(
+          LogEvent.create(APPLICATION_EVENT.LOAD_TEXT_EDITOR_FONT__SUCCESS),
+          `Monospaced font '${MONOSPACED_FONT_FAMILY}' has been loaded`,
+        );
+      } else {
+        applicationStore.logService.error(
+          LogEvent.create(APPLICATION_EVENT.APPLICATION_SETUP__FAILURE),
+          fontLoadFailureErrorMessage,
+        );
+      }
+    })
+    .catch(() =>
+      applicationStore.logService.error(
+        LogEvent.create(APPLICATION_EVENT.APPLICATION_SETUP__FAILURE),
+        fontLoadFailureErrorMessage,
+      ),
+    );
+
+  // override native hotkeys supported by monaco-editor
+  // here we map these keys to a dummy command that would just dispatch the key combination
+  // to the application keyboard shortcut service, effectively bypassing the command associated
+  // with the native keybinding
+  const OVERRIDE_DEFAULT_KEYBINDING_COMMAND =
+    'legend.code-editor.override-default-keybinding';
+  monacoEditorAPI.registerCommand(
+    OVERRIDE_DEFAULT_KEYBINDING_COMMAND,
+    (accessor, ...args) => {
+      applicationStore.keyboardShortcutsService.dispatch(args[0]);
+    },
+  );
+  const hotkeyMapping: [number, string][] = [
+    [KeyCode.F1, 'F1'], // show command center
+    [KeyCode.F8, 'F8'], // show error
+    [KeyCode.F9, 'F9'], // toggle debugger breakpoint
+    [KeyMod.WinCtrl | KeyCode.KeyG, 'Control+KeyG'], // go-to line command
+    [KeyMod.WinCtrl | KeyCode.KeyB, 'Control+KeyB'], // cursor move (core command)
+    [KeyMod.WinCtrl | KeyCode.KeyO, 'Control+KeyO'], // cursor move (core command)
+    [KeyMod.WinCtrl | KeyCode.KeyD, 'Control+KeyD'], // cursor move (core command)
+    [KeyMod.WinCtrl | KeyCode.KeyP, 'Control+KeyP'], // cursor move (core command)
+    [KeyMod.Shift | KeyCode.F10, 'Shift+F10'], // show editor context menu
+    [KeyMod.WinCtrl | KeyCode.F2, 'Control+F2'], // change all instances
+    [KeyMod.WinCtrl | KeyCode.F12, 'Control+F12'], // go-to definition
+  ];
+  monacoEditorAPI.addKeybindingRules(
+    hotkeyMapping.map(([nativeCodeEditorKeyBinding, keyCombination]) => ({
+      keybinding: nativeCodeEditorKeyBinding,
+      command: OVERRIDE_DEFAULT_KEYBINDING_COMMAND,
+      commandArgs: keyCombination,
+    })),
+  );
+};
 
 export class Core_LegendApplicationPlugin extends LegendApplicationPlugin {
   static NAME = packageJson.extensions.applicationPlugin;
@@ -41,6 +119,27 @@ export class Core_LegendApplicationPlugin extends LegendApplicationPlugin {
     pluginManager.registerApplicationPlugin(this);
   }
 
+  override getExtraApplicationSetups(): LegendApplicationSetup[] {
+    return [
+      async (applicationStore) => {
+        // configure `mobx`
+        configureMobx({
+          // Force state modification to be done via actions
+          // Otherwise, warning will be shown in development mode
+          // However, no warning will shown in production mode
+          // See https://mobx.js.org/configuration.html#enforceactions
+          enforceActions: 'observed',
+        });
+
+        // configure code editor
+        await configureCodeEditorComponent(applicationStore);
+
+        // configure UI components
+        configureComponents();
+      },
+    ];
+  }
+
   override getExtraColorThemes(): ColorTheme[] {
     return [LEGACY_LIGHT_COLOR_THEME, HIGH_CONTRAST_LIGHT_COLOR_THEME];
   }

package/src/stores/LegendApplicationPlugin.ts

@@ -24,11 +24,16 @@ import type {
 } from './DocumentationService.js';
 import type { ColorTheme } from './LayoutService.js';
 import type { SettingConfigurationEntry } from './SettingService.js';
+import type { GenericLegendApplicationStore } from './ApplicationStore.js';
 
-export type LegendApplicationSetup = <T extends LegendApplicationPlugin>(
+export type LegendApplicationBootstrap = <T extends LegendApplicationPlugin>(
   pluginManager: LegendApplicationPluginManager<T>,
 ) => Promise<void>;
 
+export type LegendApplicationSetup = (
+  applicationStore: GenericLegendApplicationStore,
+) => Promise<void>;
+
 /**
  * Prefix URL patterns coming from extensions with `/extensions/`
  * to avoid potential conflicts with main routes.
@@ -43,10 +48,20 @@ export type ApplicationPageEntry = {
 };
 
 export abstract class LegendApplicationPlugin extends AbstractPlugin {
+  /**
+   * Get the list of bootstrap procedures to be run when booting up the application.
+   *
+   * NOTE: The application will call the bootstrap procedures from all extensions concurrently.
+   * These procedures should be idempotent and should not depend on each other.
+   */
+  getExtraApplicationBootstraps?(): LegendApplicationBootstrap[];
+
   /**
    * Get the list of setup procedures to be run when booting up the application.
    *
    * NOTE: The application will call the setup procedures from all extensions concurrently.
+   * These procedures should be idempotent and should not depend on each other.
+   * They will be called just before the application is rendered.
    */
   getExtraApplicationSetups?(): LegendApplicationSetup[];