@lwrjs/loader 0.17.2-alpha.3 → 0.17.2-alpha.31

package/build/modules/lwr/loaderLegacy/loaderLegacy.js

@@ -4,7 +4,7 @@
 * SPDX-License-Identifier: MIT
 * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
 */
-/* LWR Legacy Module Loader v0.17.2-alpha.3 */
+/* LWR Legacy Module Loader v0.17.2-alpha.31 */
 const templateRegex = /\{([0-9]+)\}/g;
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 function templateString(template, args) {
@@ -108,7 +108,7 @@ const STALE_HOOK_ERROR = Object.freeze({
     level: 0,
     message: 'An error occurred handling module conflict',
 });
-const MODULE_ALREADY_LOADED = Object.freeze({
+Object.freeze({
     code: 3017,
     level: 0,
     message: 'Marking module(s) as externally loaded, but they are already loaded: {0}',
@@ -320,20 +320,39 @@ if (hasDocument) {
 
 const MODULE_LOAD_TIMEOUT_TIMER = 60 * 1000; // 1m
 
+var MODULE_WARNING; (function (MODULE_WARNING) {
+    const MODULE_REDEFINE = 'Module redefine attempted'; MODULE_WARNING["MODULE_REDEFINE"] = MODULE_REDEFINE;
+    const MODULE_ALREADY_LOADED = 'Marking module(s) as externally loaded, but they are already loaded'; MODULE_WARNING["MODULE_ALREADY_LOADED"] = MODULE_ALREADY_LOADED;
+    const ALIAS_UPDATE = 'Alias update attempt'; MODULE_WARNING["ALIAS_UPDATE"] = ALIAS_UPDATE;
+})(MODULE_WARNING || (MODULE_WARNING = {}));
+
 /*!
  * Copyright (C) 2023 salesforce.com, inc.
  */
 // @ts-ignore: Prevent cannot find name 'trustedTypes' error.
 const SUPPORTS_TRUSTED_TYPES = typeof trustedTypes !== 'undefined';
-function createTrustedTypesPolicy(name, options) {
+const trustedTypePolicyRegistry = {
+  __proto__: null
+};
+function createDuplicateSafeTrustedTypesPolicy(name, options) {
+  // istanbul ignore next: not testable in coverage collection
+  if (trustedTypePolicyRegistry[name]) {
+    return trustedTypePolicyRegistry[name];
+  }
   // @ts-ignore: Prevent cannot find name 'trustedTypes' error.
-  return trustedTypes.createPolicy(name, options);
+  // eslint-disable-next-line no-return-assign
+  return trustedTypePolicyRegistry[name] = trustedTypes.createPolicy(name, options);
 }
-function createFallbackPolicy(_name, options) {
-  return options;
+function createDuplicateSafeFallbackPolicy(name, options) {
+  if (trustedTypePolicyRegistry[name]) {
+    return trustedTypePolicyRegistry[name];
+  }
+  // @ts-ignore: Prevent cannot find name 'trustedTypes' error.
+  // eslint-disable-next-line no-return-assign
+  return trustedTypePolicyRegistry[name] = options;
 }
 // https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Security-Policy/trusted-types
-const createPolicy = SUPPORTS_TRUSTED_TYPES ? createTrustedTypesPolicy : createFallbackPolicy;
+const createPolicy = SUPPORTS_TRUSTED_TYPES ? createDuplicateSafeTrustedTypesPolicy : createDuplicateSafeFallbackPolicy;
 const policyOptions = {
   createHTML(value) {
     return value;
@@ -381,7 +400,7 @@ try {
   // swallow
 }
 const trusted = createPolicy('trusted', policyOptions);
-/*! version: 0.23.6 */
+/*! version: 0.24.6 */
 
 /* global console,process */
 
@@ -451,7 +470,7 @@ async function evaluateLoadHookResponse(response, id) {
         code = `${code}\n//# sourceURL=${id}`; // append sourceURL for debugging
         try {
             // TODO eval source maps for debugging
-            eval(trusted.createScript(code));
+            eval(trusted.createScript(code) );
         } catch (e) {
             // eslint-disable-next-line lwr/no-unguarded-apis
             if (process.env.NODE_ENV !== 'production' && hasConsole) {
@@ -529,7 +548,7 @@ const MODULE_DYNAMIC_LOAD = `${LOADER_PREFIX}module.dynamicLoad`;
 const MODULE_FETCH = `${LOADER_PREFIX}module.fetch`;
 const MODULE_ERROR = `${LOADER_PREFIX}module.error`;
 
-/* global console,process */
+/* global process console */
 
 
 
@@ -583,10 +602,17 @@ const MODULE_ERROR = `${LOADER_PREFIX}module.error`;
 
 class ModuleRegistry {
     
+    
+     __init() {this.isAppMounted = false;}
 
-    constructor(config) {ModuleRegistry.prototype.__init.call(this);ModuleRegistry.prototype.__init2.call(this);ModuleRegistry.prototype.__init3.call(this);
+    constructor(config) {ModuleRegistry.prototype.__init.call(this);ModuleRegistry.prototype.__init2.call(this);ModuleRegistry.prototype.__init3.call(this);ModuleRegistry.prototype.__init4.call(this);
         this.baseUrl = config.baseUrl || '';
         this.profiler = config.profiler;
+        this.warnings = {
+            [MODULE_WARNING.MODULE_REDEFINE]: [],
+            [MODULE_WARNING.MODULE_ALREADY_LOADED]: [],
+            [MODULE_WARNING.ALIAS_UPDATE]: [],
+        };
     }
 
     clearRegistry() {
@@ -723,11 +749,14 @@ class ModuleRegistry {
                 // eslint-disable-next-line lwr/no-unguarded-apis
                 process.env.NODE_ENV !== 'production' &&
                 // eslint-disable-next-line lwr/no-unguarded-apis
-                process.env.MRT_HMR !== 'true' &&
-                hasConsole
+                process.env.MRT_HMR !== 'true'
             ) {
-                // eslint-disable-next-line lwr/no-unguarded-apis
-                console.warn(`Module redefine attempted: ${name}`);
+                if (!this.warnings[MODULE_WARNING.MODULE_REDEFINE].includes(name)) {
+                    this.warnings[MODULE_WARNING.MODULE_REDEFINE].push(name);
+                }
+                if (this.isAppMounted) {
+                    this.logMessage('warning', `${MODULE_WARNING.MODULE_REDEFINE}: ${name}`);
+                }
             }
             this.lastDefine = mod;
             return;
@@ -789,9 +818,13 @@ class ModuleRegistry {
                 };
                 this.namedDefineRegistry.set(id, moduleDef );
                 // eslint-disable-next-line lwr/no-unguarded-apis
-            } else if (process.env.NODE_ENV !== 'production' && hasConsole) {
-                // eslint-disable-next-line lwr/no-unguarded-apis
-                console.warn(MODULE_ALREADY_LOADED.message, id);
+            } else if (process.env.NODE_ENV !== 'production') {
+                if (!this.warnings[MODULE_WARNING.MODULE_ALREADY_LOADED].includes(id)) {
+                    this.warnings[MODULE_WARNING.MODULE_ALREADY_LOADED].push(id);
+                }
+                if (this.isAppMounted) {
+                    this.logMessage('warning', `${MODULE_WARNING.MODULE_ALREADY_LOADED}: ${id}`);
+                }
             }
         });
     }
@@ -840,13 +873,13 @@ class ModuleRegistry {
     
 
     // A registry for named AMD defines containing the *metadata* of AMD module
-     __init() {this.namedDefineRegistry = new Map();}
+     __init2() {this.namedDefineRegistry = new Map();}
 
     // The evaluated module registry where the module identifier (name or URL?) is the key
-     __init2() {this.moduleRegistry = new Map();}
+     __init3() {this.moduleRegistry = new Map();}
 
     // Aliases of modules in the registry
-    __init3() {this.aliases = new Map();}
+    __init4() {this.aliases = new Map();}
 
     
 
@@ -916,14 +949,17 @@ class ModuleRegistry {
         if (aliasId !== resolvedId) {
             if (!this.aliases.has(aliasId)) {
                 this.aliases.set(aliasId, resolvedId);
-            } else if (hasConsole) {
+                // eslint-disable-next-line lwr/no-unguarded-apis
+            } else if (hasConsole && process.env.NODE_ENV !== 'production') {
                 // Warn the user if they were not aliasing to the resolvedId
                 const currentResolvedId = this.aliases.get(aliasId);
                 if (currentResolvedId !== resolvedId) {
-                    // eslint-disable-next-line lwr/no-unguarded-apis
-                    if (process.env.NODE_ENV !== 'production' && hasConsole) {
-                        // eslint-disable-next-line lwr/no-unguarded-apis, no-undef
-                        console.warn(`Alias update attempt: ${aliasId}=>${currentResolvedId}, ${resolvedId}`);
+                    const warningMsg = `${aliasId}=>${currentResolvedId}, ${resolvedId}`;
+                    if (!this.warnings[MODULE_WARNING.ALIAS_UPDATE].includes(warningMsg)) {
+                        this.warnings[MODULE_WARNING.ALIAS_UPDATE].push(warningMsg);
+                    }
+                    if (this.isAppMounted) {
+                        this.logMessage('warning', `${MODULE_WARNING.ALIAS_UPDATE}: ${warningMsg}`);
                     }
                 }
             }
@@ -931,7 +967,23 @@ class ModuleRegistry {
     }
 
      async getModuleDependencyRecord(dependency) {
-        const resolvedDepId = await this.resolve(dependency);
+        let resolvedDepId = await this.resolve(dependency);
+        // If the resolved dependency ID is a URL, it indicates that the dependency
+        // is provided by a bundle that hasn't been fully instantiated yet.
+        if (isUrl(resolvedDepId)) {
+            // Retrieve the module record corresponding to the bundle URL.
+            const existingRecord = this.moduleRegistry.get(resolvedDepId);
+
+            // If a module record for the bundle exists and we haven't already created an alias for this dependency,
+            // then the bundle is still pending instantiation.
+            if (existingRecord && !this.aliases.has(dependency)) {
+                // Wait for the bundle's instantiation promise to resolve.
+                await existingRecord.instantiation;
+                // After instantiation, re-resolve the dependency.
+                // This should now return the final alias (the logical module ID) instead of the raw bundle URL.
+                resolvedDepId = await this.resolve(dependency);
+            }
+        }
         return this.getModuleRecord(resolvedDepId, dependency);
     }
 
@@ -1156,6 +1208,10 @@ class ModuleRegistry {
 
                 // Fallback to the last loader.define call
                 if (!moduleDef) {
+                    this.logMessage(
+                        'warning',
+                        `${moduleName} not found, falling back to the last loader.define call`,
+                    );
                     moduleDef = this.lastDefine;
                 }
 
@@ -1216,6 +1272,28 @@ class ModuleRegistry {
             res === null || typeof res === 'string' || (res && typeof (res ).url === 'string')
         );
     }
+
+    getModuleWarnings(isAppMounted = false) {
+        this.isAppMounted = isAppMounted;
+        return this.warnings;
+    }
+
+    logMessage(logType, message) {
+        if (
+            !hasProcessEnv ||
+            !hasConsole || // eslint-disable-next-line lwr/no-unguarded-apis
+            process.env.NODE_ENV === 'production'
+        ) {
+            return;
+        }
+        if (logType == 'warning') {
+            // eslint-disable-next-line lwr/no-unguarded-apis
+            console.warn(message);
+        } else {
+            // eslint-disable-next-line lwr/no-unguarded-apis
+            console.log(message);
+        }
+    }
 }
 
 // find the longest set of segments from path which are a key in matchObj
@@ -1558,11 +1636,9 @@ class Loader {
             sigs = execute;
         }
 
-        sigs = sigs || {};
-
         invariant(Array.isArray(deps), INVALID_DEPS);
 
-        this.registry.define(name, deps, ctor , sigs );
+        this.registry.define(name, deps, ctor , (sigs || {}) );
     }
 
     /**
@@ -1629,6 +1705,10 @@ class Loader {
     registerExternalModules(modules) {
         this.registry.registerExternalModules(modules);
     }
+
+    getModuleWarnings(isAppMounted = false) {
+        return this.registry.getModuleWarnings(isAppMounted);
+    }
 }
 
 export { Loader };

package/build/modules/lwr/loaderLegacy/moduleRegistry/moduleRegistry.d.ts

@@ -13,6 +13,8 @@ export type Module = {
 };
 export declare class ModuleRegistry {
     private profiler;
+    private warnings;
+    private isAppMounted;
     constructor(config: LoaderConfig);
     clearRegistry(): void;
     load(id: string, importer?: string): Promise<Module>;
@@ -50,5 +52,7 @@ export declare class ModuleRegistry {
     private handleStaleModuleHook?;
     registerHandleStaleModuleHook(handleStaleModule: HandleStaleModuleHook): void;
     isValidResolveResponse(res: ResolveHookResponse): boolean;
+    getModuleWarnings(isAppMounted?: boolean): Record<string, string[]>;
+    logMessage(logType: string, message: string): void;
 }
 //# sourceMappingURL=moduleRegistry.d.ts.map

package/build/modules/lwr/loaderLegacy/moduleRegistry/moduleRegistry.js

@@ -1,14 +1,15 @@
-/* global console,process */
-import { invariant, NO_AMD_REQUIRE, LoaderError, FAIL_INSTANTIATE, FAILED_DEP, UNRESOLVED, INVALID_HOOK, INVALID_LOADER_SERVICE_RESPONSE, MODULE_ALREADY_LOADED, MODULE_LOAD_TIMEOUT, EXPORTER_ERROR, } from '../errors/messages.js';
+/* global process console */
+import { invariant, NO_AMD_REQUIRE, LoaderError, FAIL_INSTANTIATE, FAILED_DEP, UNRESOLVED, INVALID_HOOK, INVALID_LOADER_SERVICE_RESPONSE, MODULE_LOAD_TIMEOUT, EXPORTER_ERROR, } from '../errors/messages.js';
 import { resolveIfNotPlainOrUrl, isUrl } from '../utils/url.js';
 import { hasDocument, hasConsole, hasProcessEnv } from '../utils/dom.js';
 import { loadModuleDef } from './scriptLoad.js';
 import { evaluateLoadHookResponse, evaluateLoadHook, isResponseAPromise, } from '../hooks/resolveAndLoadHook.js';
 import { evaluateHandleStaleModuleHooks } from '../hooks/moduleInvalidation.js';
-import { MODULE_LOAD_TIMEOUT_TIMER } from '../constants/constants.js';
+import { MODULE_LOAD_TIMEOUT_TIMER, MODULE_WARNING } from '../constants/constants.js';
 import { MODULE_DEFINE, MODULE_ERROR, MODULE_FETCH, MODULE_DYNAMIC_LOAD } from 'lwr/metrics';
 export class ModuleRegistry {
     constructor(config) {
+        this.isAppMounted = false;
         // A registry for named AMD defines containing the *metadata* of AMD module
         this.namedDefineRegistry = new Map();
         // The evaluated module registry where the module identifier (name or URL?) is the key
@@ -17,6 +18,11 @@ export class ModuleRegistry {
         this.aliases = new Map();
         this.baseUrl = config.baseUrl || '';
         this.profiler = config.profiler;
+        this.warnings = {
+            [MODULE_WARNING.MODULE_REDEFINE]: [],
+            [MODULE_WARNING.MODULE_ALREADY_LOADED]: [],
+            [MODULE_WARNING.ALIAS_UPDATE]: [],
+        };
     }
     clearRegistry() {
         this.moduleRegistry = new Map();
@@ -134,10 +140,13 @@ export class ModuleRegistry {
                 // eslint-disable-next-line lwr/no-unguarded-apis
                 process.env.NODE_ENV !== 'production' &&
                 // eslint-disable-next-line lwr/no-unguarded-apis
-                process.env.MRT_HMR !== 'true' &&
-                hasConsole) {
-                // eslint-disable-next-line lwr/no-unguarded-apis
-                console.warn(`Module redefine attempted: ${name}`);
+                process.env.MRT_HMR !== 'true') {
+                if (!this.warnings[MODULE_WARNING.MODULE_REDEFINE].includes(name)) {
+                    this.warnings[MODULE_WARNING.MODULE_REDEFINE].push(name);
+                }
+                if (this.isAppMounted) {
+                    this.logMessage('warning', `${MODULE_WARNING.MODULE_REDEFINE}: ${name}`);
+                }
             }
             this.lastDefine = mod;
             return;
@@ -195,9 +204,13 @@ export class ModuleRegistry {
                 this.namedDefineRegistry.set(id, moduleDef);
                 // eslint-disable-next-line lwr/no-unguarded-apis
             }
-            else if (process.env.NODE_ENV !== 'production' && hasConsole) {
-                // eslint-disable-next-line lwr/no-unguarded-apis
-                console.warn(MODULE_ALREADY_LOADED.message, id);
+            else if (process.env.NODE_ENV !== 'production') {
+                if (!this.warnings[MODULE_WARNING.MODULE_ALREADY_LOADED].includes(id)) {
+                    this.warnings[MODULE_WARNING.MODULE_ALREADY_LOADED].push(id);
+                }
+                if (this.isAppMounted) {
+                    this.logMessage('warning', `${MODULE_WARNING.MODULE_ALREADY_LOADED}: ${id}`);
+                }
             }
         });
     }
@@ -296,22 +309,40 @@ export class ModuleRegistry {
         if (aliasId !== resolvedId) {
             if (!this.aliases.has(aliasId)) {
                 this.aliases.set(aliasId, resolvedId);
+                // eslint-disable-next-line lwr/no-unguarded-apis
             }
-            else if (hasConsole) {
+            else if (hasConsole && process.env.NODE_ENV !== 'production') {
                 // Warn the user if they were not aliasing to the resolvedId
                 const currentResolvedId = this.aliases.get(aliasId);
                 if (currentResolvedId !== resolvedId) {
-                    // eslint-disable-next-line lwr/no-unguarded-apis
-                    if (process.env.NODE_ENV !== 'production' && hasConsole) {
-                        // eslint-disable-next-line lwr/no-unguarded-apis, no-undef
-                        console.warn(`Alias update attempt: ${aliasId}=>${currentResolvedId}, ${resolvedId}`);
+                    const warningMsg = `${aliasId}=>${currentResolvedId}, ${resolvedId}`;
+                    if (!this.warnings[MODULE_WARNING.ALIAS_UPDATE].includes(warningMsg)) {
+                        this.warnings[MODULE_WARNING.ALIAS_UPDATE].push(warningMsg);
+                    }
+                    if (this.isAppMounted) {
+                        this.logMessage('warning', `${MODULE_WARNING.ALIAS_UPDATE}: ${warningMsg}`);
                     }
                 }
             }
         }
     }
     async getModuleDependencyRecord(dependency) {
-        const resolvedDepId = await this.resolve(dependency);
+        let resolvedDepId = await this.resolve(dependency);
+        // If the resolved dependency ID is a URL, it indicates that the dependency
+        // is provided by a bundle that hasn't been fully instantiated yet.
+        if (isUrl(resolvedDepId)) {
+            // Retrieve the module record corresponding to the bundle URL.
+            const existingRecord = this.moduleRegistry.get(resolvedDepId);
+            // If a module record for the bundle exists and we haven't already created an alias for this dependency,
+            // then the bundle is still pending instantiation.
+            if (existingRecord && !this.aliases.has(dependency)) {
+                // Wait for the bundle's instantiation promise to resolve.
+                await existingRecord.instantiation;
+                // After instantiation, re-resolve the dependency.
+                // This should now return the final alias (the logical module ID) instead of the raw bundle URL.
+                resolvedDepId = await this.resolve(dependency);
+            }
+        }
         return this.getModuleRecord(resolvedDepId, dependency);
     }
     // execute the "top-level code" (the code outside of functions) of a module
@@ -500,6 +531,7 @@ export class ModuleRegistry {
             moduleDef = moduleName && this.namedDefineRegistry.get(moduleName);
             // Fallback to the last loader.define call
             if (!moduleDef) {
+                this.logMessage('warning', `${moduleName} not found, falling back to the last loader.define call`);
                 moduleDef = this.lastDefine;
             }
             // This should not happen
@@ -551,5 +583,24 @@ export class ModuleRegistry {
     isValidResolveResponse(res) {
         return (res === null || typeof res === 'string' || (res && typeof res.url === 'string'));
     }
+    getModuleWarnings(isAppMounted = false) {
+        this.isAppMounted = isAppMounted;
+        return this.warnings;
+    }
+    logMessage(logType, message) {
+        if (!hasProcessEnv ||
+            !hasConsole || // eslint-disable-next-line lwr/no-unguarded-apis
+            process.env.NODE_ENV === 'production') {
+            return;
+        }
+        if (logType == 'warning') {
+            // eslint-disable-next-line lwr/no-unguarded-apis
+            console.warn(message);
+        }
+        else {
+            // eslint-disable-next-line lwr/no-unguarded-apis
+            console.log(message);
+        }
+    }
 }
 //# sourceMappingURL=moduleRegistry.js.map

package/build/shim/shim.d.ts

@@ -22,10 +22,12 @@ export default class LoaderShim {
     private tempDefine;
     private postCustomInit;
     private initApp;
+    private waitForBody;
     private waitForDOMContentLoaded;
     private createProfilerModule;
     private mountApp;
     private enterErrorState;
     private startWatchdogTimer;
+    private logWarnings;
 }
 //# sourceMappingURL=shim.d.ts.map

package/build/shim/shim.js

@@ -1,4 +1,4 @@
-/* global document */
+/* global document, process, console */
 import { BOOTSTRAP_ERROR } from 'lwr/metrics';
 import { logOperationStart, logOperationEnd } from 'lwr/profiler';
 import { createLoader } from './loader.js';
@@ -7,6 +7,7 @@ import { customInit } from './customInit.js';
 /* eslint-disable lwr/no-unguarded-apis */
 const hasSetTimeout = typeof setTimeout === 'function';
 const hasConsole = typeof console !== 'undefined';
+const hasProcess = typeof process !== 'undefined';
 /* eslint-enable lwr/no-unguarded-apis */
 export default class LoaderShim {
     constructor(global) {
@@ -101,16 +102,38 @@ export default class LoaderShim {
             };
             const loader = createLoader(this.loaderSpecifier, this.defineCache[this.loaderSpecifier], loaderConfig, this.config.preloadModules);
             this.mountApp(loader);
+            if (loader &&
+                typeof loader.getModuleWarnings === 'function' &&
+                hasProcess &&
+                hasConsole &&
+                // eslint-disable-next-line lwr/no-unguarded-apis
+                process.env.NODE_ENV !== 'production') {
+                this.logWarnings(loader.getModuleWarnings(true)); // the true indicates the app is mounted
+            }
         }
         catch (e) {
             this.enterErrorState(e);
         }
     }
+    waitForBody() {
+        return new Promise((resolve) => {
+            // eslint-disable-next-line lwr/no-unguarded-apis
+            if (document.body) {
+                resolve();
+            }
+            else {
+                const observer = new MutationObserver(() => {
+                    // eslint-disable-next-line lwr/no-unguarded-apis
+                    if (document.body) {
+                        observer.disconnect();
+                        resolve();
+                    }
+                });
+                observer.observe(document.documentElement, { childList: true });
+            }
+        });
+    }
     waitForDOMContentLoaded() {
-        // eslint-disable-next-line lwr/no-unguarded-apis
-        if (typeof document === undefined) {
-            return Promise.resolve();
-        }
         // Resolve if document is already "ready" https://developer.mozilla.org/en-US/docs/Web/API/Document/readyState
         // eslint-disable-next-line lwr/no-unguarded-apis
         if (document.readyState === 'interactive' || document.readyState === 'complete') {
@@ -152,8 +175,9 @@ export default class LoaderShim {
                 loader.define(...this.defineCache[specifier]);
             }
         });
-        // by default, app initialization is gated on waiting for document to be parsed (via DOMContentLoaded)
-        const { disableInitDefer } = this.config;
+        // by default, app initialization is gated on waiting for body to be available
+        // this flag uses the DOMContentLoaded event instead
+        const { initDeferDOM } = this.config;
         // Load the import mappings and application bootstrap module
         loader
             .registerImportMappings({ imports: importsObj, index }, [
@@ -161,9 +185,14 @@ export default class LoaderShim {
             rootComponent,
         ])
             .then(() => {
-            if (!disableInitDefer) {
+            // eslint-disable-next-line lwr/no-unguarded-apis
+            if (typeof window === 'undefined' || typeof document === undefined) {
+                return Promise.resolve();
+            }
+            if (initDeferDOM) {
                 return this.waitForDOMContentLoaded();
             }
+            return this.waitForBody();
         })
             .then(() => loader.load(bootstrapModule))
             .catch((reason) => {
@@ -190,5 +219,13 @@ export default class LoaderShim {
             this.enterErrorState(new Error('Failed to load required modules - timed out'));
         }, REQUIRED_MODULES_TIMEOUT);
     }
+    logWarnings(warnings) {
+        for (const warningKey in warnings) {
+            if (warnings[warningKey].length) {
+                // eslint-disable-next-line lwr/no-unguarded-apis
+                console.warn(warningKey, warnings[warningKey]);
+            }
+        }
+    }
 }
 //# sourceMappingURL=shim.js.map

package/build/shim-legacy/shimLegacy.d.ts

@@ -22,10 +22,12 @@ export default class LoaderShim {
     private tempDefine;
     private postCustomInit;
     private initApp;
+    private waitForBody;
     private waitForDOMContentLoaded;
     private createProfilerModule;
     private mountApp;
     private enterErrorState;
     private startWatchdogTimer;
+    private logWarnings;
 }
 //# sourceMappingURL=shimLegacy.d.ts.map

package/build/shim-legacy/shimLegacy.js

@@ -1,4 +1,4 @@
-/* global document */
+/* global document, process, console */
 import { BOOTSTRAP_ERROR } from 'lwr/metrics';
 import { logOperationStart, logOperationEnd } from 'lwr/profiler';
 import { createLoader } from './loaderLegacy.js';
@@ -7,6 +7,7 @@ import { customInit } from '../shim/customInit.js';
 /* eslint-disable lwr/no-unguarded-apis */
 const hasSetTimeout = typeof setTimeout === 'function';
 const hasConsole = typeof console !== 'undefined';
+const hasProcess = typeof process !== 'undefined';
 /* eslint-enable lwr/no-unguarded-apis */
 export default class LoaderShim {
     constructor(global) {
@@ -100,16 +101,38 @@ export default class LoaderShim {
             };
             const loader = createLoader(this.loaderModule, this.defineCache[this.loaderModule], loaderConfig, this.config.preloadModules);
             this.mountApp(loader);
+            if (loader &&
+                typeof loader.getModuleWarnings === 'function' &&
+                hasProcess &&
+                hasConsole &&
+                // eslint-disable-next-line lwr/no-unguarded-apis
+                process.env.NODE_ENV !== 'production') {
+                this.logWarnings(loader.getModuleWarnings(true)); // the true indicates the app is mounted
+            }
         }
         catch (e) {
             this.enterErrorState(e);
         }
     }
+    waitForBody() {
+        return new Promise((resolve) => {
+            // eslint-disable-next-line lwr/no-unguarded-apis
+            if (document.body) {
+                resolve();
+            }
+            else {
+                const observer = new MutationObserver(() => {
+                    // eslint-disable-next-line lwr/no-unguarded-apis
+                    if (document.body) {
+                        observer.disconnect();
+                        resolve();
+                    }
+                });
+                observer.observe(document.documentElement, { childList: true });
+            }
+        });
+    }
     waitForDOMContentLoaded() {
-        // eslint-disable-next-line lwr/no-unguarded-apis
-        if (typeof document === undefined) {
-            return Promise.resolve();
-        }
         // Resolve if document is already "ready" https://developer.mozilla.org/en-US/docs/Web/API/Document/readyState
         // eslint-disable-next-line lwr/no-unguarded-apis
         if (document.readyState === 'interactive' || document.readyState === 'complete') {
@@ -149,15 +172,21 @@ export default class LoaderShim {
                 loader.define(...this.defineCache[specifier]);
             }
         });
-        // by default, app initialization is gated on waiting for document to be parsed (via DOMContentLoaded)
-        const { disableInitDefer } = this.config;
+        // by default, app initialization is gated on waiting for body to be available
+        // this flag uses the DOMContentLoaded event instead
+        const { initDeferDOM } = this.config;
         // Load the import mappings and application bootstrap module
         loader
             .registerImportMappings(importMappings)
             .then(() => {
-            if (!disableInitDefer) {
+            // eslint-disable-next-line lwr/no-unguarded-apis
+            if (typeof window === 'undefined' || typeof document === undefined) {
+                return Promise.resolve();
+            }
+            if (initDeferDOM) {
                 return this.waitForDOMContentLoaded();
             }
+            return this.waitForBody();
         })
             .then(() => loader.load(bootstrapModule))
             .catch((reason) => {
@@ -184,5 +213,13 @@ export default class LoaderShim {
             this.enterErrorState(new Error('Failed to load required modules - timed out'));
         }, REQUIRED_MODULES_TIMEOUT);
     }
+    logWarnings(warnings) {
+        for (const warningKey in warnings) {
+            if (warnings[warningKey].length) {
+                // eslint-disable-next-line lwr/no-unguarded-apis
+                console.warn(warningKey, warnings[warningKey]);
+            }
+        }
+    }
 }
 //# sourceMappingURL=shimLegacy.js.map

package/build/types.d.ts

@@ -18,6 +18,7 @@ export interface BaseLoaderAPI {
     registerExternalModules(modules: string[]): void;
     services: Record<string, Function>;
     clearRegistry: Function;
+    getModuleWarnings(isAppMounted: boolean): Record<string, string[]>;
 }
 export interface LoaderAPI extends BaseLoaderAPI {
     registerImportMappings(mappings?: ImportMap): Promise<void>;