@lwrjs/loader 0.17.2-alpha.2 → 0.17.2-alpha.21

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.2 */
+/* LWR Legacy Module Loader v0.17.2-alpha.21 */
 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}`);
                     }
                 }
             }
@@ -1216,6 +1252,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 +1616,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 +1685,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,15 +309,18 @@ 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}`);
                     }
                 }
             }
@@ -551,5 +567,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,11 @@ export default class LoaderShim {
     private tempDefine;
     private postCustomInit;
     private initApp;
-    private waitForDOMContentLoaded;
+    private waitForBody;
     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,26 +102,39 @@ 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);
         }
     }
-    waitForDOMContentLoaded() {
+    waitForBody() {
         // 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') {
-            return Promise.resolve();
-        }
         return new Promise((resolve) => {
             // eslint-disable-next-line lwr/no-unguarded-apis
-            document.addEventListener('DOMContentLoaded', () => {
+            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 });
+            }
         });
     }
     // Create a module out of the profiler
@@ -152,7 +166,7 @@ export default class LoaderShim {
                 loader.define(...this.defineCache[specifier]);
             }
         });
-        // by default, app initialization is gated on waiting for document to be parsed (via DOMContentLoaded)
+        // by default, app initialization is gated on waiting for body to be available (via DOMContentLoaded)
         const { disableInitDefer } = this.config;
         // Load the import mappings and application bootstrap module
         loader
@@ -162,7 +176,7 @@ export default class LoaderShim {
         ])
             .then(() => {
             if (!disableInitDefer) {
-                return this.waitForDOMContentLoaded();
+                return this.waitForBody();
             }
         })
             .then(() => loader.load(bootstrapModule))
@@ -190,5 +204,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,11 @@ export default class LoaderShim {
     private tempDefine;
     private postCustomInit;
     private initApp;
-    private waitForDOMContentLoaded;
+    private waitForBody;
     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,26 +101,39 @@ 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);
         }
     }
-    waitForDOMContentLoaded() {
+    waitForBody() {
         // 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') {
-            return Promise.resolve();
-        }
         return new Promise((resolve) => {
             // eslint-disable-next-line lwr/no-unguarded-apis
-            document.addEventListener('DOMContentLoaded', () => {
+            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 });
+            }
         });
     }
     // Create a module out of the profiler
@@ -149,14 +163,14 @@ export default class LoaderShim {
                 loader.define(...this.defineCache[specifier]);
             }
         });
-        // by default, app initialization is gated on waiting for document to be parsed (via DOMContentLoaded)
+        // by default, app initialization is gated on waiting for body to be available
         const { disableInitDefer } = this.config;
         // Load the import mappings and application bootstrap module
         loader
             .registerImportMappings(importMappings)
             .then(() => {
             if (!disableInitDefer) {
-                return this.waitForDOMContentLoaded();
+                return this.waitForBody();
             }
         })
             .then(() => loader.load(bootstrapModule))
@@ -184,5 +198,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>;

package/package.json

@@ -5,7 +5,7 @@
     "publishConfig": {
         "access": "public"
     },
-    "version": "0.17.2-alpha.2",
+    "version": "0.17.2-alpha.21",
     "homepage": "https://developer.salesforce.com/docs/platform/lwr/overview",
     "repository": {
         "type": "git",
@@ -60,17 +60,17 @@
         "build": "yarn build:ts && yarn build:error-shim && yarn build:shim && yarn build:loader && yarn build:shim:bundle && yarn build:shim:bundle:minify"
     },
     "devDependencies": {
-        "@locker/trusted-types": "0.23.6",
-        "@lwrjs/diagnostics": "0.17.2-alpha.2",
-        "@lwrjs/types": "0.17.2-alpha.2",
+        "@locker/trusted-types": "0.24.6",
+        "@lwrjs/diagnostics": "0.17.2-alpha.21",
+        "@lwrjs/types": "0.17.2-alpha.21",
         "@rollup/plugin-node-resolve": "^15.2.3",
         "@rollup/plugin-sucrase": "^5.0.2",
         "@rollup/plugin-terser": "^0.4.4",
         "rollup": "^2.79.2"
     },
     "dependencies": {
-        "@lwrjs/client-modules": "0.17.2-alpha.2",
-        "@lwrjs/shared-utils": "0.17.2-alpha.2"
+        "@lwrjs/client-modules": "0.17.2-alpha.21",
+        "@lwrjs/shared-utils": "0.17.2-alpha.21"
     },
     "lwc": {
         "modules": [
@@ -85,10 +85,10 @@
         ]
     },
     "engines": {
-        "node": ">=18.0.0"
+        "node": ">=20.0.0"
     },
     "volta": {
         "extends": "../../../package.json"
     },
-    "gitHead": "739b237f5d7f2c1989142cb505a56cc763f21976"
+    "gitHead": "448ae2b681a4718241a29890f34e0ac13e35e6fd"
 }