@lwrjs/loader 0.22.9 → 0.22.11

package/README.md

@@ -83,6 +83,38 @@ LWR.define('foo/bar', ['exports'], (exports) => {
 });
 ```
 
+### `loader.importMap()`
+
+```ts
+interface LwrImportMapUpdateMethod {
+    (importMapUpdate: ImportMapUpdate): void;
+}
+
+type ImportMapUpdate = Record<string, string[]>;
+```
+
+Apply update of import mappings at runtime. This allows dynamically registering new module mappings after the loader has been initialized. This is a synchronous operation.
+
+**parameters**
+
+-   `importMapUpdate` - Import Map Update object containing:
+    -   [moduleScriptURL] - Script URL containing LWR define statements
+    -   string[] - array of module names which are included in the given script
+
+**Important**: Import map entries are **write-once** — once a specifier is mapped, it cannot be overridden. This ensures deterministic module resolution and prevents runtime mutation of previously resolved dependencies. If a conflicting mapping is provided for an existing specifier, the new mapping is ignored and a warning is logged.
+
+**Important**: Protected modules (`lwc`, `lwr/*`) cannot be remapped for security reasons. Attempting to remap these modules will throw an error.
+
+**Example**
+
+```js
+// Register a runtime import mapping
+// ONLY AVAILABLE WHEN USING THE GLOBAL API (AMD / Legacy Mode):
+LWR.importMap({
+    '/bundles/my-module.js': ['my/module'],
+});
+```
+
 ### `loader.load()`
 
 ```ts
@@ -280,7 +312,7 @@ console.log(result); // 'abc'
 The Client Runtime Loader Shim bootstraps the [Loader instance](#api) and other required modules for LWR applications in AMD format. The AMD Loader Shim is responsible for:
 
 -   defining and executing the [`@lwr/loader`](#api)
--   exposure of the loader's `define` API at `globalThis.LWR.define`
+-   exposure of the loader's `define` and `importMap` APIs at `globalThis.LWR.define` and `globalThis.LWR.importMap`
 -   client-side orchestration for the generated application bootstrap module
 
 ### LWR Application Document

package/build/assets/prod/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.22.9 */
+/* LWR Error Shim v0.22.11 */
 !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)}}();