@openmrs/esm-routes 7.0.0 → 7.0.1-pre.3256

package/.turbo/turbo-build.log

@@ -1,3 +1,3 @@
-[0] Successfully compiled: 9 files with swc (130.35ms)
+[0] Successfully compiled: 9 files with swc (116.2ms)
 [0] swc --strip-leading-paths src -d dist exited with code 0
 [1] tsc --project tsconfig.build.json exited with code 0

package/dist/loaders/components.js

@@ -1,6 +1,6 @@
 import { attach, registerExtension, registerModal, registerWorkspace, registerWorkspaceGroup } from "@openmrs/esm-extensions";
-import { getLoader } from "./app.js";
 import { registerFeatureFlag } from "@openmrs/esm-feature-flags";
+import { loadLifeCycles } from "./load-lifecycles.js";
 /**
  * This function registers an extension definition with the framework and will
  * attach the extension to any configured slots.
@@ -22,35 +22,22 @@ a 'slot' property. Only the 'slots' property will be honored.`);
     const slots = extension.slots ? extension.slots : extension.slot ? [
         extension.slot
     ] : [];
-    if (!extension.component && !extension.load) {
+    if (!extension.component) {
         console.error(`The extension ${name} from ${appName} is missing a 'component' entry and thus cannot be registered.
 To fix this, ensure that you define a 'component' field inside the extension definition.`, extension);
         return;
     }
-    let loader = undefined;
-    if (extension.component) {
-        loader = getLoader(appName, extension.component);
-    } else if (extension.load) {
-        if (typeof extension.load !== 'function') {
-            console.error(`The extension ${name} from ${appName} declares a 'load' property that is not a function. This is not
-supported, so the extension will not be loaded.`);
-            return;
-        }
-        loader = extension.load;
-    }
-    if (loader) {
-        registerExtension({
-            name,
-            load: loader,
-            meta: extension.meta || {},
-            order: extension.order,
-            moduleName: appName,
-            privileges: extension.privileges,
-            online: extension.online ?? true,
-            offline: extension.offline ?? false,
-            featureFlag: extension.featureFlag
-        });
-    }
+    registerExtension({
+        name,
+        load: ()=>loadLifeCycles(appName, extension.component),
+        meta: extension.meta || {},
+        order: extension.order,
+        moduleName: appName,
+        privileges: extension.privileges,
+        online: extension.online ?? true,
+        offline: extension.offline ?? false,
+        featureFlag: extension.featureFlag
+    });
     for (const slot of slots){
         attach(slot, name);
     }
@@ -68,29 +55,16 @@ registered. To fix this, ensure that you define the "name" field inside the
 modal definition.`, modal);
         return;
     }
-    if (!modal.component && !modal.load) {
+    if (!modal.component) {
         console.error(`The modal ${name} from ${appName} is missing a 'component' entry and thus cannot be registered.
 To fix this, ensure that you define a 'component' field inside the modal definition.`, modal);
         return;
     }
-    let loader = undefined;
-    if (modal.component) {
-        loader = getLoader(appName, modal.component);
-    } else if (modal.load) {
-        if (typeof modal.load !== 'function') {
-            console.error(`The modal ${name} from ${appName} declares a 'load' property that is not a function. This is not
-supported, so the modal will not be loaded.`);
-            return;
-        }
-        loader = modal.load;
-    }
-    if (loader) {
-        registerModal({
-            name,
-            load: loader,
-            moduleName: appName
-        });
-    }
+    registerModal({
+        name,
+        moduleName: appName,
+        load: ()=>loadLifeCycles(appName, modal.component)
+    });
 }
 /**
  * This function registers a workspace definition with the framework so that it can be launched.
@@ -110,36 +84,24 @@ To fix this, ensure that you define the "name" field inside the workspace defini
 To fix this, ensure that you define the "title" field inside the workspace definition.`, workspace);
         return;
     }
-    if (!workspace.component && !workspace.load) {
+    if (!workspace.component) {
         console.error(`The workspace ${name} from ${appName} is missing a 'component' entry and thus cannot be registered.
 To fix this, ensure that you define a 'component' field inside the workspace definition.`, workspace);
         return;
     }
-    let loader = undefined;
-    if (workspace.component) {
-        loader = getLoader(appName, workspace.component);
-    } else if (workspace.load) {
-        if (typeof workspace.load !== 'function') {
-            console.error(`The workspace ${name} from ${appName} declares a 'load' property that is not a function. This is not
-supported, so the workspace will not be loaded.`);
-            return;
-        }
-        loader = workspace.load;
-    }
-    if (loader) {
-        registerWorkspace({
-            name,
-            title,
-            load: loader,
-            moduleName: appName,
-            type: workspace.type,
-            canHide: workspace.canHide,
-            canMaximize: workspace.canMaximize,
-            width: workspace.width,
-            preferredWindowSize: workspace.preferredWindowSize,
-            groups: workspace.groups
-        });
-    }
+    registerWorkspace({
+        name,
+        title,
+        component: workspace.component,
+        moduleName: appName,
+        type: workspace.type,
+        canHide: workspace.canHide,
+        canMaximize: workspace.canMaximize,
+        width: workspace.width,
+        preferredWindowSize: workspace.preferredWindowSize,
+        groups: workspace.groups,
+        load: ()=>loadLifeCycles(appName, workspace.component)
+    });
     for (const group of workspace.groups || []){
         registerWorkspaceGroup({
             name: group,

package/dist/loaders/helpers.d.ts

@@ -1,3 +1 @@
-import { type LifeCycles } from 'single-spa';
-export declare const emptyLifecycle: LifeCycles<never>;
 export declare function routeRegex(regex: RegExp, location: Location): boolean;

package/dist/loaders/helpers.js

@@ -1,14 +1,3 @@
-export const emptyLifecycle = {
-    bootstrap () {
-        return Promise.resolve();
-    },
-    mount () {
-        return Promise.resolve();
-    },
-    unmount () {
-        return Promise.resolve();
-    }
-};
 export function routeRegex(regex, location) {
     const result = regex.test(location.pathname.replace(window.getOpenmrsSpaBase(), ''));
     return result;

package/dist/loaders/index.d.ts

@@ -1,3 +1,3 @@
-export { initializeApp } from './app';
 export { registerApp, finishRegisteringAllApps } from './pages';
 export { tryRegisterExtension } from './components';
+export * from './load-lifecycles';

package/dist/loaders/index.js

@@ -1,3 +1,3 @@
-export { initializeApp } from "./app.js";
 export { registerApp, finishRegisteringAllApps } from "./pages.js";
 export { tryRegisterExtension } from "./components.js";
+export * from "./load-lifecycles.js";

package/dist/loaders/load-lifecycles.d.ts

@@ -0,0 +1,18 @@
+import { type LifeCycles } from 'single-spa';
+/**
+ * This function loads a single-spa Lifecycles from the given app. The Lifecycles should be
+ * created using `getAsyncLifecycle()` or `getSyncLifecycle()` and exported in the app's
+ * index.ts file.
+ * The function is lazy and ensures that the appropriate module is loaded,
+ * that the module's `startupApp()` is called before the component is loaded. It
+ * then calls the component function, which should return either a single-spa
+ * {@link LifeCycles} object or a {@link Promise} that will resolve to such an object.
+ *
+ * @param routesAppName The app name of the routes.json file defining the component to load
+ *
+ * @param fullComponentName The name of the component to load. Note that this can optionally
+ * include the appName to load the component from (in the format `${appName}#${componentName}`),
+ * or omitted to implicitly use routesAppName
+ *
+ */
+export declare function loadLifeCycles(routesAppName: string, fullComponentName: string): Promise<LifeCycles>;

package/dist/loaders/{app.js → load-lifecycles.js}

@@ -1,6 +1,5 @@
 import { importDynamic } from "@openmrs/esm-dynamic-loading";
 import { registerModuleLoad } from "@openmrs/esm-config";
-import { emptyLifecycle } from "./helpers.js";
 /**
  * @internal
  *
@@ -9,44 +8,50 @@ import { emptyLifecycle } from "./helpers.js";
  * Values are promises to support asynchronous loading of the same app multiple times
  */ const initializedApps = new Map();
 /**
- * This function creates a loader function suitable for use in either a single-spa
- * application or parcel.
- *
- * The returned function is lazy and ensures that the appropriate module is loaded,
+ * This function loads a single-spa Lifecycles from the given app. The Lifecycles should be
+ * created using `getAsyncLifecycle()` or `getSyncLifecycle()` and exported in the app's
+ * index.ts file.
+ * The function is lazy and ensures that the appropriate module is loaded,
  * that the module's `startupApp()` is called before the component is loaded. It
  * then calls the component function, which should return either a single-spa
  * {@link LifeCycles} object or a {@link Promise} that will resolve to such an object.
  *
- * React-based pages or extensions should generally use the framework's
- * `getAsyncLifecycle()` or `getSyncLifecycle()` functions.
- *
  * @param routesAppName The app name of the routes.json file defining the component to load
  *
  * @param fullComponentName The name of the component to load. Note that this can optionally
  * include the appName to load the component from (in the format `${appName}#${componentName}`),
  * or omitted to implicitly use routesAppName
  *
- */ export function getLoader(routesAppName, fullComponentName) {
-    return async ()=>{
-        const poundIndex = fullComponentName.indexOf('#');
-        const isNamespaced = poundIndex >= 0;
-        const appName = isNamespaced ? fullComponentName.substring(0, poundIndex) : routesAppName;
-        const componentName = isNamespaced ? fullComponentName.substring(poundIndex + 1) : fullComponentName;
-        const module = await importDynamic(appName);
-        if (module && Object.hasOwn(module, componentName) && typeof module[componentName] === 'function') {
-            return initializeApp(appName, module).then(()=>module[componentName]());
+ */ export async function loadLifeCycles(routesAppName, fullComponentName) {
+    const poundIndex = fullComponentName.indexOf('#');
+    const isNamespaced = poundIndex >= 0;
+    const appName = isNamespaced ? fullComponentName.substring(0, poundIndex) : routesAppName;
+    const componentName = isNamespaced ? fullComponentName.substring(poundIndex + 1) : fullComponentName;
+    const module = await importDynamic(appName);
+    if (module && Object.hasOwn(module, componentName) && typeof module[componentName] === 'function') {
+        return initializeApp(appName, module).then(()=>module[componentName]());
+    } else {
+        if (!module) {
+            console.warn(`Unknown app ${appName} for ${fullComponentName} defined in ${routesAppName}'s routes.json`);
+        } else if (module && Object.hasOwn(module, componentName)) {
+            console.warn(`The export ${fullComponentName}, defined in ${routesAppName}'s routes.json, is not a function`);
         } else {
-            if (!module) {
-                console.warn(`Unknown app ${appName} for ${fullComponentName} defined in ${routesAppName}'s routes.json`);
-            } else if (module && Object.hasOwn(module, componentName)) {
-                console.warn(`The export ${fullComponentName}, defined in ${routesAppName}'s routes.json, is not a function`);
-            } else {
-                console.warn(`${appName} does not define a component called "${componentName}", referenced in ${routesAppName}'s routes.json. This cannot be loaded.`);
-            }
+            console.warn(`${appName} does not define a component called "${componentName}", referenced in ${routesAppName}'s routes.json. This cannot be loaded.`);
         }
-        return emptyLifecycle;
-    };
+    }
+    return emptyLifecycle;
 }
+const emptyLifecycle = {
+    bootstrap () {
+        return Promise.resolve();
+    },
+    mount () {
+        return Promise.resolve();
+    },
+    unmount () {
+        return Promise.resolve();
+    }
+};
 /**
  * This function can be used to manually initialize an application without waiting for the
  * framework to load it. This can sometimes be helpful if the framework doesn't load code
@@ -60,7 +65,7 @@ import { emptyLifecycle } from "./helpers.js";
  * @param module The loaded code module, if available; if this parameter is omitted, this
  *   function will load it.
  * @returns a Promise which completes once the app has been loaded and initialized
- */ export async function initializeApp(appName, module) {
+ */ async function initializeApp(appName, module) {
     if (!(appName in initializedApps)) {
         let _module = module ?? await importDynamic(appName);
         await (initializedApps[appName] = new Promise((resolve, reject)=>{

package/dist/loaders/pages.js

@@ -2,8 +2,8 @@ import { pathToActiveWhen, registerApplication } from "single-spa";
 import { registerModuleWithConfigSystem } from "@openmrs/esm-config";
 import { getFeatureFlag } from "@openmrs/esm-feature-flags";
 import { routeRegex } from "./helpers.js";
-import { getLoader } from "./app.js";
 import { tryRegisterExtension, tryRegisterFeatureFlag, tryRegisterModal, tryRegisterWorkspace, tryRegisterWorkspaceGroup } from "./components.js";
+import { loadLifeCycles } from "./load-lifecycles.js";
 // this is the global holder of all pages registered in the app
 const pages = [];
 /**
@@ -174,6 +174,6 @@ To fix this, ensure that you define the "component" field inside the page defini
         return;
     }
     const activityFn = wrapPageActivityFn(getActivityFn(route), page);
-    const loader = getLoader(page.appName, page.component);
+    const loader = ()=>loadLifeCycles(page.appName, page.component);
     registerApplication(appName, loader, activityFn);
 }

package/dist/public.d.ts

@@ -1,3 +1,2 @@
 export * from './constants';
 export * from './routes';
-export { initializeApp } from './loaders';

package/dist/public.js

@@ -1,3 +1,2 @@
 export * from "./constants.js";
 export * from "./routes.js";
-export { initializeApp } from "./loaders/index.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openmrs/esm-routes",
-  "version": "7.0.0",
+  "version": "7.0.1-pre.3256",
   "license": "MPL-2.0",
   "description": "Utilities for working with the routes registry",
   "type": "module",
@@ -54,12 +54,12 @@
     "single-spa": "6.x"
   },
   "devDependencies": {
-    "@openmrs/esm-config": "7.0.0",
-    "@openmrs/esm-dynamic-loading": "7.0.0",
-    "@openmrs/esm-extensions": "7.0.0",
-    "@openmrs/esm-feature-flags": "7.0.0",
-    "@openmrs/esm-globals": "7.0.0",
-    "@openmrs/esm-utils": "7.0.0",
+    "@openmrs/esm-config": "7.0.1-pre.3256",
+    "@openmrs/esm-dynamic-loading": "7.0.1-pre.3256",
+    "@openmrs/esm-extensions": "7.0.1-pre.3256",
+    "@openmrs/esm-feature-flags": "7.0.1-pre.3256",
+    "@openmrs/esm-globals": "7.0.1-pre.3256",
+    "@openmrs/esm-utils": "7.0.1-pre.3256",
     "@swc/cli": "^0.7.7",
     "@swc/core": "^1.11.29",
     "concurrently": "^9.1.2",
@@ -69,5 +69,6 @@
     "single-spa": "^6.0.3",
     "vitest": "^3.1.4",
     "vitest-fetch-mock": "^0.4.5"
-  }
+  },
+  "stableVersion": "7.0.0"
 }

package/src/loaders/components.ts

@@ -1,6 +1,5 @@
 import {
   attach,
-  type ExtensionRegistration,
   registerExtension,
   registerModal,
   registerWorkspace,
@@ -13,8 +12,8 @@ import {
   type WorkspaceDefinition,
   type WorkspaceGroupDefinition,
 } from '@openmrs/esm-globals';
-import { getLoader } from './app';
 import { registerFeatureFlag } from '@openmrs/esm-feature-flags';
+import { loadLifeCycles } from './load-lifecycles';
 
 /**
  * This function registers an extension definition with the framework and will
@@ -43,7 +42,7 @@ a 'slot' property. Only the 'slots' property will be honored.`,
   }
   const slots = extension.slots ? extension.slots : extension.slot ? [extension.slot] : [];
 
-  if (!extension.component && !extension.load) {
+  if (!extension.component) {
     console.error(
       `The extension ${name} from ${appName} is missing a 'component' entry and thus cannot be registered.
 To fix this, ensure that you define a 'component' field inside the extension definition.`,
@@ -52,33 +51,17 @@ To fix this, ensure that you define a 'component' field inside the extension def
     return;
   }
 
-  let loader: ExtensionRegistration['load'] | undefined = undefined;
-  if (extension.component) {
-    loader = getLoader(appName, extension.component);
-  } else if (extension.load) {
-    if (typeof extension.load !== 'function') {
-      console.error(
-        `The extension ${name} from ${appName} declares a 'load' property that is not a function. This is not
-supported, so the extension will not be loaded.`,
-      );
-      return;
-    }
-    loader = extension.load;
-  }
-
-  if (loader) {
-    registerExtension({
-      name,
-      load: loader,
-      meta: extension.meta || {},
-      order: extension.order,
-      moduleName: appName,
-      privileges: extension.privileges,
-      online: extension.online ?? true,
-      offline: extension.offline ?? false,
-      featureFlag: extension.featureFlag,
-    });
-  }
+  registerExtension({
+    name,
+    load: () => loadLifeCycles(appName, extension.component),
+    meta: extension.meta || {},
+    order: extension.order,
+    moduleName: appName,
+    privileges: extension.privileges,
+    online: extension.online ?? true,
+    offline: extension.offline ?? false,
+    featureFlag: extension.featureFlag,
+  });
 
   for (const slot of slots) {
     attach(slot, name);
@@ -103,7 +86,7 @@ modal definition.`,
     return;
   }
 
-  if (!modal.component && !modal.load) {
+  if (!modal.component) {
     console.error(
       `The modal ${name} from ${appName} is missing a 'component' entry and thus cannot be registered.
 To fix this, ensure that you define a 'component' field inside the modal definition.`,
@@ -112,27 +95,11 @@ To fix this, ensure that you define a 'component' field inside the modal definit
     return;
   }
 
-  let loader: ExtensionRegistration['load'] | undefined = undefined;
-  if (modal.component) {
-    loader = getLoader(appName, modal.component);
-  } else if (modal.load) {
-    if (typeof modal.load !== 'function') {
-      console.error(
-        `The modal ${name} from ${appName} declares a 'load' property that is not a function. This is not
-supported, so the modal will not be loaded.`,
-      );
-      return;
-    }
-    loader = modal.load;
-  }
-
-  if (loader) {
-    registerModal({
-      name,
-      load: loader,
-      moduleName: appName,
-    });
-  }
+  registerModal({
+    name,
+    moduleName: appName,
+    load: () => loadLifeCycles(appName, modal.component),
+  });
 }
 
 /**
@@ -162,7 +129,7 @@ To fix this, ensure that you define the "title" field inside the workspace defin
     return;
   }
 
-  if (!workspace.component && !workspace.load) {
+  if (!workspace.component) {
     console.error(
       `The workspace ${name} from ${appName} is missing a 'component' entry and thus cannot be registered.
 To fix this, ensure that you define a 'component' field inside the workspace definition.`,
@@ -171,34 +138,19 @@ To fix this, ensure that you define a 'component' field inside the workspace def
     return;
   }
 
-  let loader: ExtensionRegistration['load'] | undefined = undefined;
-  if (workspace.component) {
-    loader = getLoader(appName, workspace.component);
-  } else if (workspace.load) {
-    if (typeof workspace.load !== 'function') {
-      console.error(
-        `The workspace ${name} from ${appName} declares a 'load' property that is not a function. This is not
-supported, so the workspace will not be loaded.`,
-      );
-      return;
-    }
-    loader = workspace.load;
-  }
-
-  if (loader) {
-    registerWorkspace({
-      name,
-      title,
-      load: loader,
-      moduleName: appName,
-      type: workspace.type,
-      canHide: workspace.canHide,
-      canMaximize: workspace.canMaximize,
-      width: workspace.width,
-      preferredWindowSize: workspace.preferredWindowSize,
-      groups: workspace.groups,
-    });
-  }
+  registerWorkspace({
+    name,
+    title,
+    component: workspace.component,
+    moduleName: appName,
+    type: workspace.type,
+    canHide: workspace.canHide,
+    canMaximize: workspace.canMaximize,
+    width: workspace.width,
+    preferredWindowSize: workspace.preferredWindowSize,
+    groups: workspace.groups,
+    load: () => loadLifeCycles(appName, workspace.component),
+  });
 
   for (const group of workspace.groups || []) {
     registerWorkspaceGroup({

package/src/loaders/helpers.ts

@@ -1,17 +1,3 @@
-import { type LifeCycles } from 'single-spa';
-
-export const emptyLifecycle: LifeCycles<never> = {
-  bootstrap() {
-    return Promise.resolve();
-  },
-  mount() {
-    return Promise.resolve();
-  },
-  unmount() {
-    return Promise.resolve();
-  },
-};
-
 export function routeRegex(regex: RegExp, location: Location) {
   const result = regex.test(location.pathname.replace(window.getOpenmrsSpaBase(), ''));
   return result;

package/src/loaders/index.ts

@@ -1,3 +1,3 @@
-export { initializeApp } from './app';
 export { registerApp, finishRegisteringAllApps } from './pages';
 export { tryRegisterExtension } from './components';
+export * from './load-lifecycles';

package/src/loaders/{app.ts → load-lifecycles.ts}

@@ -1,7 +1,6 @@
 import { importDynamic } from '@openmrs/esm-dynamic-loading';
-import { registerModuleLoad } from '@openmrs/esm-config';
 import { type LifeCycles } from 'single-spa';
-import { emptyLifecycle } from './helpers';
+import { registerModuleLoad } from '@openmrs/esm-config';
 
 // Couldn't figure out how to express this as an interface
 type Module = Omit<Record<string, () => LifeCycles | Promise<LifeCycles>>, 'startupApp'> & {
@@ -18,17 +17,14 @@ type Module = Omit<Record<string, () => LifeCycles | Promise<LifeCycles>>, 'star
 const initializedApps = new Map<string, Promise<unknown>>();
 
 /**
- * This function creates a loader function suitable for use in either a single-spa
- * application or parcel.
- *
- * The returned function is lazy and ensures that the appropriate module is loaded,
+ * This function loads a single-spa Lifecycles from the given app. The Lifecycles should be
+ * created using `getAsyncLifecycle()` or `getSyncLifecycle()` and exported in the app's
+ * index.ts file.
+ * The function is lazy and ensures that the appropriate module is loaded,
  * that the module's `startupApp()` is called before the component is loaded. It
  * then calls the component function, which should return either a single-spa
  * {@link LifeCycles} object or a {@link Promise} that will resolve to such an object.
  *
- * React-based pages or extensions should generally use the framework's
- * `getAsyncLifecycle()` or `getSyncLifecycle()` functions.
- *
  * @param routesAppName The app name of the routes.json file defining the component to load
  *
  * @param fullComponentName The name of the component to load. Note that this can optionally
@@ -36,33 +32,43 @@ const initializedApps = new Map<string, Promise<unknown>>();
  * or omitted to implicitly use routesAppName
  *
  */
-export function getLoader(routesAppName: string, fullComponentName: string): () => Promise<LifeCycles> {
-  return async () => {
-    const poundIndex = fullComponentName.indexOf('#');
-    const isNamespaced = poundIndex >= 0;
-    const appName = isNamespaced ? fullComponentName.substring(0, poundIndex) : routesAppName;
-    const componentName = isNamespaced ? fullComponentName.substring(poundIndex + 1) : fullComponentName;
+export async function loadLifeCycles(routesAppName: string, fullComponentName: string): Promise<LifeCycles> {
+  const poundIndex = fullComponentName.indexOf('#');
+  const isNamespaced = poundIndex >= 0;
+  const appName = isNamespaced ? fullComponentName.substring(0, poundIndex) : routesAppName;
+  const componentName = isNamespaced ? fullComponentName.substring(poundIndex + 1) : fullComponentName;
 
-    const module = await importDynamic<Module>(appName);
+  const module = await importDynamic<Module>(appName);
 
-    if (module && Object.hasOwn(module, componentName) && typeof module[componentName] === 'function') {
-      return initializeApp(appName, module).then(() => module[componentName]());
+  if (module && Object.hasOwn(module, componentName) && typeof module[componentName] === 'function') {
+    return initializeApp(appName, module).then(() => module[componentName]());
+  } else {
+    if (!module) {
+      console.warn(`Unknown app ${appName} for ${fullComponentName} defined in ${routesAppName}'s routes.json`);
+    } else if (module && Object.hasOwn(module, componentName)) {
+      console.warn(`The export ${fullComponentName}, defined in ${routesAppName}'s routes.json, is not a function`);
     } else {
-      if (!module) {
-        console.warn(`Unknown app ${appName} for ${fullComponentName} defined in ${routesAppName}'s routes.json`);
-      } else if (module && Object.hasOwn(module, componentName)) {
-        console.warn(`The export ${fullComponentName}, defined in ${routesAppName}'s routes.json, is not a function`);
-      } else {
-        console.warn(
-          `${appName} does not define a component called "${componentName}", referenced in ${routesAppName}'s routes.json. This cannot be loaded.`,
-        );
-      }
+      console.warn(
+        `${appName} does not define a component called "${componentName}", referenced in ${routesAppName}'s routes.json. This cannot be loaded.`,
+      );
     }
+  }
 
-    return emptyLifecycle;
-  };
+  return emptyLifecycle;
 }
 
+const emptyLifecycle: LifeCycles<never> = {
+  bootstrap() {
+    return Promise.resolve();
+  },
+  mount() {
+    return Promise.resolve();
+  },
+  unmount() {
+    return Promise.resolve();
+  },
+};
+
 /**
  * This function can be used to manually initialize an application without waiting for the
  * framework to load it. This can sometimes be helpful if the framework doesn't load code
@@ -77,7 +83,7 @@ export function getLoader(routesAppName: string, fullComponentName: string): ()
  *   function will load it.
  * @returns a Promise which completes once the app has been loaded and initialized
  */
-export async function initializeApp(appName: string, module?: Module) {
+async function initializeApp(appName: string, module?: Module) {
   if (!(appName in initializedApps)) {
     let _module: Module = module ?? (await importDynamic<Module>(appName));
 

package/src/loaders/pages.ts

@@ -12,7 +12,6 @@ import {
 } from '@openmrs/esm-globals';
 import { getFeatureFlag } from '@openmrs/esm-feature-flags';
 import { routeRegex } from './helpers';
-import { getLoader } from './app';
 import {
   tryRegisterExtension,
   tryRegisterFeatureFlag,
@@ -20,6 +19,7 @@ import {
   tryRegisterWorkspace,
   tryRegisterWorkspaceGroup,
 } from './components';
+import { loadLifeCycles } from './load-lifecycles';
 
 // this is the global holder of all pages registered in the app
 const pages: Array<RegisteredPageDefinition> = [];
@@ -257,6 +257,6 @@ To fix this, ensure that you define the "component" field inside the page defini
   }
 
   const activityFn = wrapPageActivityFn(getActivityFn(route), page);
-  const loader = getLoader(page.appName, page.component);
+  const loader = () => loadLifeCycles(page.appName, page.component);
   registerApplication(appName, loader, activityFn);
 }

package/src/public.ts

@@ -1,3 +1,2 @@
 export * from './constants';
 export * from './routes';
-export { initializeApp } from './loaders';

package/dist/loaders/app.d.ts

@@ -1,40 +0,0 @@
-import { type LifeCycles } from 'single-spa';
-type Module = Omit<Record<string, () => LifeCycles | Promise<LifeCycles>>, 'startupApp'> & {
-    startupApp?: () => unknown;
-};
-/**
- * This function creates a loader function suitable for use in either a single-spa
- * application or parcel.
- *
- * The returned function is lazy and ensures that the appropriate module is loaded,
- * that the module's `startupApp()` is called before the component is loaded. It
- * then calls the component function, which should return either a single-spa
- * {@link LifeCycles} object or a {@link Promise} that will resolve to such an object.
- *
- * React-based pages or extensions should generally use the framework's
- * `getAsyncLifecycle()` or `getSyncLifecycle()` functions.
- *
- * @param routesAppName The app name of the routes.json file defining the component to load
- *
- * @param fullComponentName The name of the component to load. Note that this can optionally
- * include the appName to load the component from (in the format `${appName}#${componentName}`),
- * or omitted to implicitly use routesAppName
- *
- */
-export declare function getLoader(routesAppName: string, fullComponentName: string): () => Promise<LifeCycles>;
-/**
- * This function can be used to manually initialize an application without waiting for the
- * framework to load it. This can sometimes be helpful if the framework doesn't load code
- * at the point you think is appropriate.
- *
- * This will ensure that the module is available and that it's `startupApp()` function (if
- * any) will be called. Note that these are only guaranteed to be complete once the Promise
- * returned from the function completes.
- *
- * @param appName The name of the app to initialize
- * @param module The loaded code module, if available; if this parameter is omitted, this
- *   function will load it.
- * @returns a Promise which completes once the app has been loaded and initialized
- */
-export declare function initializeApp(appName: string, module?: Module): Promise<void>;
-export {};