@lwrjs/everywhere 0.20.0 → 0.20.2

package/build/__generated_site_amd_modules__/1/application/amd/l/en-US/ai/amd-bootstrap/configuration/ci/-/-/s/19737ad98c42894d36e278e701b899ac/config.js

@@ -0,0 +1,12 @@
+/* This script is generated */
+/* Client Bootstrap configuration */
+globalThis.LWR = globalThis.LWR || {};
+Object.assign(globalThis.LWR, {"appId":"amd-bootstrap","bootstrapModule":"@lwrjs/app-service/amd-bootstrap/module/amd/v/0_20_2","autoBoot":true,"imports":{"/1/module/amd/1/l/en-US/mi/%40lwrjs%2Fapp-service%2Famd-bootstrap%2Fmodule%2Famd%2Fv%2F0_20_2/s/3aba11034f11c8d5598c93bfca4d4690/@lwrjs_app-service_amd-bootstrap_module_amd.js":["@lwrjs/app-service/amd-bootstrap/module/amd/v/0_20_2"],"/1/module/amd/1/l/en-US/mi/lwr%2FpreInit%2Fv%2F0_20_2/s/7d064ec3a80dbbccaa4845ea5eaef125/lwr_preInit.js":["lwr/preInit/v/0_20_2"],"/1/module/amd/1/l/en-US/mi/lwr%2Finit%2Fv%2F0_20_2/s/8a450e0577e39f3aee74a6cd2f88d4ff/lwr_init.js":["lwr/init/v/0_20_2"],"/1/module/amd/1/l/en-US/mi/lwr%2Fmetrics%2Fv%2F0_20_2/s/fb8c5dd340c69fdf7ded52d3eba633b9/lwr_metrics.js":["lwr/metrics/v/0_20_2"],"/1/module/amd/1/l/en-US/mi/lwc%2Fv%2F8_20_1/s/13f9f9934fd3a3c9f52760160b464d00/lwc.js":["lwc/v/8_20_1"],"/1/module/amd/1/l/en-US/mi/lwr%2FeverywhereAmd%2Fv%2F0_20_2/s/cb931ebef2b89dcf8ab51456e3a68864/lwr_everywhereAmd.js":["lwr/everywhereAmd/v/0_20_2"],"/1/module/amd/1/l/en-US/mi/lwr%2Fvault%2Fv%2F0_20_2/s/c92abd8c1fec2d7eff62e4b097abbe14/lwr_vault.js":["lwr/vault/v/0_20_2"]},"index":{"@lwrjs/app-service/amd-bootstrap/module/amd/v/0_20_2":"/1/module/amd/1/l/en-US/mi/%40lwrjs%2Fapp-service%2Famd-bootstrap%2Fmodule%2Famd%2Fv%2F0_20_2/s/3aba11034f11c8d5598c93bfca4d4690/@lwrjs_app-service_amd-bootstrap_module_amd.js","lwr/preInit/v/0_20_2":"/1/module/amd/1/l/en-US/mi/lwr%2FpreInit%2Fv%2F0_20_2/s/7d064ec3a80dbbccaa4845ea5eaef125/lwr_preInit.js","lwr/init/v/0_20_2":"/1/module/amd/1/l/en-US/mi/lwr%2Finit%2Fv%2F0_20_2/s/8a450e0577e39f3aee74a6cd2f88d4ff/lwr_init.js","lwr/metrics/v/0_20_2":"/1/module/amd/1/l/en-US/mi/lwr%2Fmetrics%2Fv%2F0_20_2/s/fb8c5dd340c69fdf7ded52d3eba633b9/lwr_metrics.js","lwc/v/8_20_1":"/1/module/amd/1/l/en-US/mi/lwc%2Fv%2F8_20_1/s/13f9f9934fd3a3c9f52760160b464d00/lwc.js","lwr/everywhereAmd/v/0_20_2":"/1/module/amd/1/l/en-US/mi/lwr%2FeverywhereAmd%2Fv%2F0_20_2/s/cb931ebef2b89dcf8ab51456e3a68864/lwr_everywhereAmd.js","lwr/vault/v/0_20_2":"/1/module/amd/1/l/en-US/mi/lwr%2Fvault%2Fv%2F0_20_2/s/c92abd8c1fec2d7eff62e4b097abbe14/lwr_vault.js"},"rootComponents":["lwr/everywhereAmd/v/0_20_2"],"serverData":{},"requiredModules":["@lwrjs/app-service/amd-bootstrap/module/amd/v/0_20_2"],"preloadModules":["lwr/preInit/v/0_20_2","lwr/init/v/0_20_2","lwr/metrics/v/0_20_2","lwc/v/8_20_1","lwr/everywhereAmd/v/0_20_2"],"endpoints":{"uris":{"mapping":"/1/mapping/amd/1/l/en-US/mp/"}}});
+globalThis.LWR = {...globalThis.LWR, env: {"SSR":false,"SSREnabled":false,"basePath":"","locale":"en-US","assetBasePath":"","uiBasePath":""}};
+globalThis.process={...globalThis.process,env:{...globalThis.process?.env,...{"NODE_ENV":"compat"}}};
+globalThis.lwcRuntimeFlags = { ENABLE_MIXED_SHADOW_MODE: false, ENABLE_WIRE_SYNC_EMIT: false };
+// Appended by Static Site Generator
+if (!globalThis.LWR.imports) { globalThis.LWR.imports = {}; }
+Object.assign(globalThis.LWR.imports, {"/1/module/amd/1/l/en-US/mi/lwr%2Fprofiler%2Fv%2F0_20_2/s/9f74c8370534ce02c6e7637abdcffedf/lwr_profiler.js":["lwr/profiler/v/0_20_2"],"/1/module/amd/1/l/en-US/mi/lwr%2Floader%2Fv%2F0_20_2/s/753df58285e56c6ebbc5295c72c33401/lwr_loader.js":["lwr/loader/v/0_20_2"]})
+if (!globalThis.LWR.index) { globalThis.LWR.index = {}; }
+Object.assign(globalThis.LWR.index, {"lwr/profiler/v/0_20_2":"/1/module/amd/1/l/en-US/mi/lwr%2Fprofiler%2Fv%2F0_20_2/s/9f74c8370534ce02c6e7637abdcffedf/lwr_profiler.js","lwr/loader/v/0_20_2":"/1/module/amd/1/l/en-US/mi/lwr%2Floader%2Fv%2F0_20_2/s/753df58285e56c6ebbc5295c72c33401/lwr_loader.js"})

package/build/__generated_site_amd_modules__/1/module/amd/1/l/en-US/mi/@lwrjs/app-service/amd-bootstrap/module/amd/v/{0_20_0 → 0_20_2}/s/3aba11034f11c8d5598c93bfca4d4690/@lwrjs_app-service_amd-bootstrap_module_amd.js

@@ -1,15 +1,15 @@
-LWR.define('@lwrjs/app-service/amd-bootstrap/module/amd/v/0_20_0', ['lwr/loader/v/0_20_0', 'lwr/preInit/v/0_20_0', 'lwr/init/v/0_20_0'], (function (_0_20_0$2, _0_20_0, _0_20_0$1) { 'use strict';
+LWR.define('@lwrjs/app-service/amd-bootstrap/module/amd/v/0_20_2', ['lwr/loader/v/0_20_2', 'lwr/preInit/v/0_20_2', 'lwr/init/v/0_20_2'], (function (_0_20_2$2, _0_20_2, _0_20_2$1) { 'use strict';
 
-    const clientBootstrapConfig = _0_20_0.getClientBootstrapConfig();
+    const clientBootstrapConfig = _0_20_2.getClientBootstrapConfig();
     const { serverData, rootComponents } = clientBootstrapConfig;
 
     // initialize additional non-configured root components
     Promise.all(rootComponents.map(async (rootSpecifier) => {
-        const element = _0_20_0$1.toKebabCase(rootSpecifier);
-        const { default: Ctor } = await _0_20_0$2.load(rootSpecifier, '@lwrjs/app-service/amd-bootstrap/module/amd/v/0_20_0');
+        const element = _0_20_2$1.toKebabCase(rootSpecifier);
+        const { default: Ctor } = await _0_20_2$2.load(rootSpecifier, '@lwrjs/app-service/amd-bootstrap/module/amd/v/0_20_2');
         return [element, Ctor];
     })).then((rootModules) => {
-        return _0_20_0$1.init(rootModules, serverData);
+        return _0_20_2$1.init(rootModules, serverData);
     }).then(() => {
         globalThis?.lwcRuntimeFlags?.ENABLE_WIRE_SYNC_EMIT &&
             (globalThis.lwcRuntimeFlags = {

package/build/__generated_site_amd_modules__/1/module/amd/1/l/en-US/mi/lwr/everywhereAmd/v/{0_20_0 → 0_20_2}/s/cb931ebef2b89dcf8ab51456e3a68864/lwr_everywhereAmd.js

@@ -1,10 +1,10 @@
-LWR.define('lwr/everywhereAmd/v/0_20_0', ['exports', 'lwr/vault/v/0_20_0'], (function (exports, _0_20_0) { 'use strict';
+LWR.define('lwr/everywhereAmd/v/0_20_2', ['exports', 'lwr/vault/v/0_20_2'], (function (exports, _0_20_2) { 'use strict';
 
   // IMPORTANT: Do not add any static imports to this file that are not bundled with the amd-client
 
   // Do an OAuthed fetch
   async function authFetch(url, accept = 'javascript') {
-    const authInfo = _0_20_0.getAuthInfo();
+    const authInfo = _0_20_2.getAuthInfo();
     if (authInfo) {
       return fetch(url, {
         headers: {
@@ -53,7 +53,7 @@ LWR.define('lwr/everywhereAmd/v/0_20_0', ['exports', 'lwr/vault/v/0_20_0'], (fun
   function authenticate(authInfo) {
     // Put OAuth info into the vault
     if (authInfo) {
-      _0_20_0.setAuthInfo(authInfo);
+      _0_20_2.setAuthInfo(authInfo);
     }
   }
 

package/build/__generated_site_amd_modules__/1/module/amd/1/l/en-US/mi/lwr/init/v/{0_20_0/s/ba081ae41570981325062377381a1ea2 → 0_20_2/s/8a450e0577e39f3aee74a6cd2f88d4ff}/lwr_init.js

@@ -1,4 +1,4 @@
-LWR.define('lwr/init/v/0_20_0', ['exports', 'lwr/metrics/v/0_20_0', 'lwr/profiler/v/0_20_0', 'lwc/v/8_20_1'], (function (exports, _0_20_0$1, _0_20_0, _8_20_1) { 'use strict';
+LWR.define('lwr/init/v/0_20_2', ['exports', 'lwr/metrics/v/0_20_2', 'lwr/profiler/v/0_20_2', 'lwc/v/8_20_1'], (function (exports, _0_20_2$1, _0_20_2, _8_20_1) { 'use strict';
 
   // eslint-disable-next-line lwr/only-allowed-type-imports
 
@@ -6,11 +6,89 @@ LWR.define('lwr/init/v/0_20_0', ['exports', 'lwr/metrics/v/0_20_0', 'lwr/profile
   // Note: a build step uses these comments to strip the code for core.
   // eslint-disable-next-line lwr/only-allowed-imports
 
+  // hydration directive + value constants
+  // must align with the constants in @lwrjs/shared-utils/src/html-meta.ts
+  const HYDRATE_DIRECTIVE = 'lwr:hydrate';
+  const HYDRATE_VISIBLE_VALUE = 'visible';
   function hydrateComponentProxy(customElement, Ctor, props) {
     _8_20_1.hydrateComponent(customElement, Ctor, props);
   }
   // </hydrateComponentProxy>
 
+  /**
+   * Hydrate the custom element only when it is visible.
+   * @param customElement - The custom element to hydrate
+   * @param ctor - The constructor of the custom element
+   * @param props - The properties of the custom element
+   */
+  function hydrateComponentOnVisible(customElement, ctor, props) {
+    // Use IntersectionObserver for visibility-based hydration
+    const observer = createVisibilityObserver();
+
+    // add the element to the pending hydrations and observe it
+    pendingHydrations.set(customElement, {
+      ctor,
+      props
+    });
+    observer.observe(customElement);
+  }
+
+  // store component metadata for pending hydrations
+  const pendingHydrations = new Map();
+
+  // store the visibility observer so that we don't create a new one each time
+  let visibilityObserver;
+
+  /**
+   * Determines if a component should be hydrated when it becomes visible in the viewport.
+   * This requires IntersectionObserver to be available and the hydrate directive to be set to 'visible'.
+   * @param element - The element to check for visibility-based hydration
+   * @returns True if the component should be hydrated when visible, false otherwise
+   */
+  function shouldHydrateComponentWhenVisible(element) {
+    return 'IntersectionObserver' in globalThis && element.getAttribute(HYDRATE_DIRECTIVE) === HYDRATE_VISIBLE_VALUE;
+  }
+
+  /**
+   * Create an intersection observer for hydrating islands when visible, if one doesn't already exist.
+   * @returns An intersection observer that will hydrate the island when visible
+   */
+  function createVisibilityObserver() {
+    // return the existing observer if it already exists
+    if (visibilityObserver) return visibilityObserver;
+
+    // create a new observer if it doesn't already exist
+    visibilityObserver = new IntersectionObserver((entries, observer) => {
+      // for each observed element, check if it is intersecting with the viewport
+      entries.forEach(entry => {
+        // if intersecting, hydrate the island
+        if (entry.isIntersecting) {
+          const element = entry.target;
+
+          // stop observing the element
+          observer.unobserve(element);
+
+          // get the hydration data for the element
+          const hydrationData = pendingHydrations.get(element);
+          if (hydrationData) {
+            // delete the hydration data for the element
+            pendingHydrations.delete(element);
+            const {
+              ctor,
+              props
+            } = hydrationData;
+            // hydrate the island
+            hydrateComponentProxy(element, ctor, props);
+          }
+        }
+      });
+    }, {
+      root: null,
+      // adds a buffer to the intersection observer to hydrate the island slightly before it enters the viewport
+      rootMargin: '100px'
+    });
+    return visibilityObserver;
+  }
   const shouldYield = (() => {
     const globalThisLWR = globalThis;
     const {
@@ -76,13 +154,13 @@ LWR.define('lwr/init/v/0_20_0', ['exports', 'lwr/metrics/v/0_20_0', 'lwr/profile
   function init(rootModules, serverData = {}) {
     // eslint-disable-next-line lwr/no-unguarded-apis
     if (typeof globalThis.customElements === 'undefined' || typeof globalThis.document === 'undefined') {
-      _0_20_0.logOperationStart({
-        id: _0_20_0$1.BOOTSTRAP_END
+      _0_20_2.logOperationStart({
+        id: _0_20_2$1.BOOTSTRAP_END
       });
       return;
     }
-    _0_20_0.logOperationStart({
-      id: _0_20_0$1.INIT
+    _0_20_2.logOperationStart({
+      id: _0_20_2$1.INIT
     });
     (async () => {
       let index = 0;
@@ -100,8 +178,8 @@ LWR.define('lwr/init/v/0_20_0', ['exports', 'lwr/metrics/v/0_20_0', 'lwr/profile
         // initialize and inject the root module into the LWR Root or DOM if it is missing
         // eslint-disable-next-line lwr/no-unguarded-apis
         if (!document.body.querySelector(elementName)) {
-          _0_20_0.logOperationStart({
-            id: _0_20_0$1.INIT_MODULE,
+          _0_20_2.logOperationStart({
+            id: _0_20_2$1.INIT_MODULE,
             specifier,
             specifierIndex
           });
@@ -112,8 +190,8 @@ LWR.define('lwr/init/v/0_20_0', ['exports', 'lwr/metrics/v/0_20_0', 'lwr/profile
           const container = document.querySelector('[lwr-root]');
           // eslint-disable-next-line lwr/no-unguarded-apis
           container ? container.appendChild(component) : document.body.appendChild(component);
-          _0_20_0.logOperationEnd({
-            id: _0_20_0$1.INIT_MODULE,
+          _0_20_2.logOperationEnd({
+            id: _0_20_2$1.INIT_MODULE,
             specifier,
             specifierIndex,
             metadata: {
@@ -127,8 +205,8 @@ LWR.define('lwr/init/v/0_20_0', ['exports', 'lwr/metrics/v/0_20_0', 'lwr/profile
         // eslint-disable-next-line lwr/no-unguarded-apis
         const elements = document.querySelectorAll(elementName);
         for (const element of elements) {
-          _0_20_0.logOperationStart({
-            id: _0_20_0$1.INIT_MODULE,
+          _0_20_2.logOperationStart({
+            id: _0_20_2$1.INIT_MODULE,
             specifier,
             specifierIndex
           });
@@ -136,9 +214,16 @@ LWR.define('lwr/init/v/0_20_0', ['exports', 'lwr/metrics/v/0_20_0', 'lwr/profile
 
           // hydrate SSR'd components
           if (propsId) {
-            hydrateComponentProxy(element, ctor, serverData[propsId] || {});
-            _0_20_0.logOperationEnd({
-              id: _0_20_0$1.INIT_MODULE,
+            // check if the element is a hydration visible island
+            if (shouldHydrateComponentWhenVisible(element)) {
+              // hydrate the island when visible
+              hydrateComponentOnVisible(element, ctor, serverData[propsId] || {});
+            } else {
+              // hydrate the island immediately
+              hydrateComponentProxy(element, ctor, serverData[propsId] || {});
+            }
+            _0_20_2.logOperationEnd({
+              id: _0_20_2$1.INIT_MODULE,
               specifier,
               specifierIndex,
               metadata: {
@@ -176,8 +261,8 @@ LWR.define('lwr/init/v/0_20_0', ['exports', 'lwr/metrics/v/0_20_0', 'lwr/profile
           if (parent) {
             parent.replaceChild(component, element);
           }
-          _0_20_0.logOperationEnd({
-            id: _0_20_0$1.INIT_MODULE,
+          _0_20_2.logOperationEnd({
+            id: _0_20_2$1.INIT_MODULE,
             specifier,
             specifierIndex,
             metadata: {
@@ -187,11 +272,11 @@ LWR.define('lwr/init/v/0_20_0', ['exports', 'lwr/metrics/v/0_20_0', 'lwr/profile
         }
       }
     })();
-    _0_20_0.logOperationEnd({
-      id: _0_20_0$1.INIT
+    _0_20_2.logOperationEnd({
+      id: _0_20_2$1.INIT
     });
-    _0_20_0.logOperationStart({
-      id: _0_20_0$1.BOOTSTRAP_END
+    _0_20_2.logOperationStart({
+      id: _0_20_2$1.BOOTSTRAP_END
     });
   }
 
@@ -202,6 +287,8 @@ LWR.define('lwr/init/v/0_20_0', ['exports', 'lwr/metrics/v/0_20_0', 'lwr/profile
     return scheduler?.yield ? scheduler.yield() : new Promise(resolve => setTimeout(resolve, 0));
   }
 
+  exports.HYDRATE_DIRECTIVE = HYDRATE_DIRECTIVE;
+  exports.HYDRATE_VISIBLE_VALUE = HYDRATE_VISIBLE_VALUE;
   exports.getPropFromAttrName = getPropFromAttrName;
   exports.init = init;
   exports.toKebabCase = toKebabCase;

package/build/__generated_site_amd_modules__/1/module/amd/1/l/en-US/mi/lwr/loader/v/{0_20_0/s/9685b1c83c0f9ac9a036bb005137e44b → 0_20_2/s/753df58285e56c6ebbc5295c72c33401}/lwr_loader.js

@@ -1,4 +1,4 @@
-LWR.define('lwr/loader/v/0_20_0', ['exports'], (function (exports) { 'use strict';
+LWR.define('lwr/loader/v/0_20_2', ['exports'], (function (exports) { 'use strict';
 
   /**
   * Copyright (c) 2021, salesforce.com, inc.
@@ -6,7 +6,7 @@ LWR.define('lwr/loader/v/0_20_0', ['exports'], (function (exports) { 'use strict
   * SPDX-License-Identifier: MIT
   * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
   */
-  /* LWR Module Loader v0.20.0 */
+  /* LWR Module Loader v0.20.2 */
   const templateRegex = /\{([0-9]+)\}/g;
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
   function templateString(template, args) {
@@ -338,6 +338,27 @@ LWR.define('lwr/loader/v/0_20_0', ['exports'], (function (exports) { 'use strict
   // Loader: mappings
   const MAPPINGS_FETCH = `${LOADER_PREFIX}mappings.fetch`;
   const MAPPINGS_ERROR = `${LOADER_PREFIX}mappings.error`;
+  function _optionalChain(ops) {
+    let lastAccessLHS = undefined;
+    let value = ops[0];
+    let i = 1;
+    while (i < ops.length) {
+      const op = ops[i];
+      const fn = ops[i + 1];
+      i += 2;
+      if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) {
+        return undefined;
+      }
+      if (op === 'access' || op === 'optionalAccess') {
+        lastAccessLHS = value;
+        value = fn(value);
+      } else if (op === 'call' || op === 'optionalCall') {
+        value = fn((...args) => value.call(lastAccessLHS, ...args));
+        lastAccessLHS = undefined;
+      }
+    }
+    return value;
+  }
 
   /* spec based import map resolver */
   class ImportMetadataResolver {
@@ -351,10 +372,19 @@ LWR.define('lwr/loader/v/0_20_0', ['exports'], (function (exports) { 'use strict
     __init3() {
       this.loadMappingHooks = [];
     }
+
+    // mapping request batching
+    __init4() {
+      this.batchSpecifiers = [];
+    }
+
+    // eslint-disable-next-line lwr/no-unguarded-apis
+
     constructor(config, invalidationCallback) {
       ImportMetadataResolver.prototype.__init.call(this);
       ImportMetadataResolver.prototype.__init2.call(this);
       ImportMetadataResolver.prototype.__init3.call(this);
+      ImportMetadataResolver.prototype.__init4.call(this);
       this.config = config;
       this.invalidationCallback = invalidationCallback;
     }
@@ -508,6 +538,27 @@ LWR.define('lwr/loader/v/0_20_0', ['exports'], (function (exports) { 'use strict
       return this.fetchNewMappings(specifier);
     }
     async fetchNewMappings(specifier) {
+      if (!hasSetTimeout || !_optionalChain([this, 'access', _ => _.config, 'optionalAccess', _2 => _2.flags, 'optionalAccess', _3 => _3.batchMappings])) {
+        return this.fetchNewMappingsInner(specifier);
+      }
+      const batch = () => {
+        const specifiers = this.batchSpecifiers.join(',');
+        this.batchSpecifiers = []; // clear pending mapping requests
+        // eslint-disable-next-line lwr/no-unguarded-apis
+        clearTimeout(this.batchTimer); // cancel the batch timer
+        this.batchTimer = undefined;
+        return this.fetchNewMappingsInner(specifiers);
+      };
+      if (!this.batchPromise || this.batchSpecifiers.length === 0) {
+        this.batchPromise = new Promise(resolve => {
+          // eslint-disable-next-line lwr/no-unguarded-apis
+          this.batchTimer = setTimeout(() => resolve(batch()), 0);
+        });
+      }
+      this.batchSpecifiers.push(specifier);
+      return this.batchPromise;
+    }
+    async fetchNewMappingsInner(specifier) {
       if (typeof globalThis.fetch !== 'function') {
         throw new LoaderError(UNRESOLVED, [specifier]);
       }
@@ -1125,24 +1176,8 @@ LWR.define('lwr/loader/v/0_20_0', ['exports'], (function (exports) { 'use strict
 
     // execute the "top-level code" (the code outside of functions) of a module
     async topLevelEvaluation(moduleRecord) {
-      await this.instantiateAll(moduleRecord, {});
       return this.evaluateModule(moduleRecord, {});
     }
-
-    // Returns a promise when a module and all of it's dependencies have finished instantiation
-    async instantiateAll(moduleRecord, instantiatedMap) {
-      if (!instantiatedMap[moduleRecord.id]) {
-        instantiatedMap[moduleRecord.id] = true;
-        const dependencyModuleRecords = await moduleRecord.dependencyRecords;
-        if (dependencyModuleRecords) {
-          for (let i = 0; i < dependencyModuleRecords.length; i++) {
-            const depRecord = dependencyModuleRecords[i];
-            // eslint-disable-next-line no-await-in-loop
-            await this.instantiateAll(depRecord, instantiatedMap);
-          }
-        }
-      }
-    }
     async evaluateModule(moduleRecord, evaluationMap) {
       const dependencyModuleRecords = await moduleRecord.dependencyRecords;
       if (dependencyModuleRecords.length > 0) {
@@ -1464,7 +1499,8 @@ LWR.define('lwr/loader/v/0_20_0', ['exports'], (function (exports) { 'use strict
       this.registry = new ModuleRegistry(Object.freeze({
         endpoints: config.endpoints,
         baseUrl,
-        profiler
+        profiler,
+        flags: config.flags || {}
       }));
 
       // TODO: W-10539691 - temp workaround for LWR-Java -- remove once appId is implemented there

package/build/__generated_site_amd_modules__/1/module/amd/1/l/en-US/mi/lwr/metrics/v/{0_20_0 → 0_20_2}/s/fb8c5dd340c69fdf7ded52d3eba633b9/lwr_metrics.js

@@ -1,4 +1,4 @@
-LWR.define('lwr/metrics/v/0_20_0', ['exports'], (function (exports) { 'use strict';
+LWR.define('lwr/metrics/v/0_20_2', ['exports'], (function (exports) { 'use strict';
 
 	// Bootstrap / shim
 	const BOOTSTRAP_PREFIX = 'lwr.bootstrap.';

package/build/__generated_site_amd_modules__/1/module/amd/1/l/en-US/mi/lwr/preInit/v/{0_20_0 → 0_20_2}/s/7d064ec3a80dbbccaa4845ea5eaef125/lwr_preInit.js

@@ -1,4 +1,4 @@
-LWR.define('lwr/preInit/v/0_20_0', ['exports'], (function (exports) { 'use strict';
+LWR.define('lwr/preInit/v/0_20_2', ['exports'], (function (exports) { 'use strict';
 
   /**
    * This module is called in the ABS module (app bootstrap module) to perform neccesary pre initialization steps for an LWR app.

package/build/__generated_site_amd_modules__/1/module/amd/1/l/en-US/mi/lwr/profiler/v/{0_20_0 → 0_20_2}/s/9f74c8370534ce02c6e7637abdcffedf/lwr_profiler.js

@@ -1,4 +1,4 @@
-LWR.define('lwr/profiler/v/0_20_0', ['exports'], (function (exports) { 'use strict';
+LWR.define('lwr/profiler/v/0_20_2', ['exports'], (function (exports) { 'use strict';
 
   var Phase = /*#__PURE__*/function (Phase) {
     Phase[Phase["Start"] = 0] = "Start";

package/build/__generated_site_amd_modules__/1/module/amd/1/l/en-US/mi/lwr/vault/v/{0_20_0 → 0_20_2}/s/c92abd8c1fec2d7eff62e4b097abbe14/lwr_vault.js

@@ -1,4 +1,4 @@
-LWR.define('lwr/vault/v/0_20_0', ['exports'], (function (exports) { 'use strict';
+LWR.define('lwr/vault/v/0_20_2', ['exports'], (function (exports) { 'use strict';
 
   // Credential vault for storing setters and subscribers for OAuth info
   // This module is a SINGLETON and must be excluded from ESM bundling

package/build/__generated_site_amd_modules__/1/resource/amd/lwr-error-shim.js/v/{0_20_0 → 0_20_2}/lwr-error-shim.js

@@ -4,5 +4,5 @@
 * SPDX-License-Identifier: MIT
 * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
 */
-/* LWR Error Shim v0.20.0 */
+/* LWR Error Shim v0.20.2 */
 !function(){"use strict";const o=globalThis;if(!(o.LWR&&o.LWR.define)){const r=new Error("The LWR application failed to bootstrap");if(!o.LWR||!o.LWR.onError)throw r;o.LWR.onError(r)}}();

package/build/__generated_site_amd_modules__/1/resource/amd/lwr-loader-shim.bundle.js/v/{0_20_0 → 0_20_2}/lwr-loader-shim.bundle.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 Module Loader Shim v0.20.0 */
+/* LWR Module Loader Shim v0.20.2 */
 (function () {
   'use strict';
 
@@ -213,7 +213,7 @@
           // Parse configuration
           this.global = global;
           this.config = global.LWR ;
-          this.loaderSpecifier = 'lwr/loader/v/0_20_0';
+          this.loaderSpecifier = 'lwr/loader/v/0_20_2';
 
           // Set up error handler
           this.errorHandler = this.config.onError ;
@@ -295,6 +295,7 @@
               const loaderConfig = {
                   endpoints: this.config.endpoints,
                   baseUrl: this.config.baseUrl,
+                  flags: this.config.flags,
                   profiler: { logOperationStart, logOperationEnd },
                   // TODO: can be removed following https://github.com/salesforce-experience-platform-emu/lwr/issues/1087
                   appMetadata: {
@@ -364,7 +365,7 @@
           const exporter = (exports) => {
               Object.assign(exports, { logOperationStart, logOperationEnd });
           };
-          define('lwr/profiler/v/0_20_0', ['exports'], exporter);
+          define('lwr/profiler/v/0_20_2', ['exports'], exporter);
       }
 
       // Set up the application globals, import map, root custom element...
@@ -456,14 +457,14 @@
   // The loader module is ALWAYS required
   const GLOBAL = globalThis ;
   GLOBAL.LWR.requiredModules = GLOBAL.LWR.requiredModules || [];
-  if (GLOBAL.LWR.requiredModules.indexOf('lwr/loader/v/0_20_0') < 0) {
-      GLOBAL.LWR.requiredModules.push('lwr/loader/v/0_20_0');
+  if (GLOBAL.LWR.requiredModules.indexOf('lwr/loader/v/0_20_2') < 0) {
+      GLOBAL.LWR.requiredModules.push('lwr/loader/v/0_20_2');
   }
   new LoaderShim(GLOBAL);
 
 })();
 
-LWR.define('lwr/loader/v/0_20_0', ['exports'], (function (exports) { 'use strict';
+LWR.define('lwr/loader/v/0_20_2', ['exports'], (function (exports) { 'use strict';
 
     const templateRegex = /\{([0-9]+)\}/g;
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
@@ -826,6 +827,16 @@ LWR.define('lwr/loader/v/0_20_0', ['exports'], (function (exports) { 'use strict
     const MAPPINGS_FETCH = `${LOADER_PREFIX}mappings.fetch`;
     const MAPPINGS_ERROR = `${LOADER_PREFIX}mappings.error`;
 
+    function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
+
+
+
+
+
+
+
+
+
     /* spec based import map resolver */
     class ImportMetadataResolver {
         // Default to empty mappings
@@ -835,7 +846,13 @@ LWR.define('lwr/loader/v/0_20_0', ['exports'], (function (exports) { 'use strict
         
          __init3() {this.loadMappingHooks = [];}
 
-        constructor(config, invalidationCallback) {ImportMetadataResolver.prototype.__init.call(this);ImportMetadataResolver.prototype.__init2.call(this);ImportMetadataResolver.prototype.__init3.call(this);
+        // mapping request batching
+         __init4() {this.batchSpecifiers = [];}
+        
+        // eslint-disable-next-line lwr/no-unguarded-apis
+        
+
+        constructor(config, invalidationCallback) {ImportMetadataResolver.prototype.__init.call(this);ImportMetadataResolver.prototype.__init2.call(this);ImportMetadataResolver.prototype.__init3.call(this);ImportMetadataResolver.prototype.__init4.call(this);
             this.config = config;
             this.invalidationCallback = invalidationCallback;
         }
@@ -1008,6 +1025,30 @@ LWR.define('lwr/loader/v/0_20_0', ['exports'], (function (exports) { 'use strict
         }
 
          async fetchNewMappings(specifier) {
+            if (!hasSetTimeout || !_optionalChain([this, 'access', _ => _.config, 'optionalAccess', _2 => _2.flags, 'optionalAccess', _3 => _3.batchMappings])) {
+                return this.fetchNewMappingsInner(specifier);
+            }
+
+            const batch = () => {
+                const specifiers = this.batchSpecifiers.join(',');
+                this.batchSpecifiers = []; // clear pending mapping requests
+                // eslint-disable-next-line lwr/no-unguarded-apis
+                clearTimeout(this.batchTimer); // cancel the batch timer
+                this.batchTimer = undefined;
+                return this.fetchNewMappingsInner(specifiers);
+            };
+
+            if (!this.batchPromise || this.batchSpecifiers.length === 0) {
+                this.batchPromise = new Promise((resolve) => {
+                    // eslint-disable-next-line lwr/no-unguarded-apis
+                    this.batchTimer = setTimeout(() => resolve(batch()), 0);
+                });
+            }
+            this.batchSpecifiers.push(specifier);
+            return this.batchPromise;
+        }
+
+         async fetchNewMappingsInner(specifier) {
             if (typeof globalThis.fetch !== 'function') {
                 throw new LoaderError(UNRESOLVED, [specifier]);
             }
@@ -1701,28 +1742,9 @@ LWR.define('lwr/loader/v/0_20_0', ['exports'], (function (exports) { 'use strict
 
         // execute the "top-level code" (the code outside of functions) of a module
          async topLevelEvaluation(moduleRecord) {
-            await this.instantiateAll(moduleRecord, {});
             return this.evaluateModule(moduleRecord, {});
         }
 
-        // Returns a promise when a module and all of it's dependencies have finished instantiation
-         async instantiateAll(
-            moduleRecord,
-            instantiatedMap,
-        ) {
-            if (!instantiatedMap[moduleRecord.id]) {
-                instantiatedMap[moduleRecord.id] = true;
-                const dependencyModuleRecords = await moduleRecord.dependencyRecords;
-                if (dependencyModuleRecords) {
-                    for (let i = 0; i < dependencyModuleRecords.length; i++) {
-                        const depRecord = dependencyModuleRecords[i];
-                        // eslint-disable-next-line no-await-in-loop
-                        await this.instantiateAll(depRecord, instantiatedMap);
-                    }
-                }
-            }
-        }
-
          async evaluateModule(
             moduleRecord,
             evaluationMap,
@@ -2070,7 +2092,14 @@ LWR.define('lwr/loader/v/0_20_0', ['exports'], (function (exports) { 'use strict
                 };
             }
 
-            this.registry = new ModuleRegistry(Object.freeze({ endpoints: config.endpoints, baseUrl, profiler }));
+            this.registry = new ModuleRegistry(
+                Object.freeze({
+                    endpoints: config.endpoints,
+                    baseUrl,
+                    profiler,
+                    flags: config.flags || {},
+                }),
+            );
 
             // TODO: W-10539691 - temp workaround for LWR-Java -- remove once appId is implemented there
             if (config.appMetadata && !config.appMetadata.appId) {