@salesforce/metadata-visualizer-web 1.0.1

package/dist/index.js

@@ -0,0 +1,18 @@
+/**
+ * Copyright (c) 2025, Salesforce, Inc.
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ **/
+/**
+ * @salesforce/metadata-visualizer-web — Public API.
+ *
+ * Web/HTTP SDK for the Salesforce Metadata Visualizer framework. Lets any
+ * HTTP-style host (custom web services, browser applications, demo pages)
+ * plug a host-supplied IFileSystem into the framework and serve plugin
+ * visualizations to a browser without seeing plugin internals.
+ */
+// Factory + engine.
+export { createWebVisualizationEngine } from './createWebVisualizationEngine.js';
+export { WebVisualizationEngine } from './WebVisualizationEngine.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;IAKI;AAEJ;;;;;;;GAOG;AAEH,oBAAoB;AACpB,OAAO,EAAE,4BAA4B,EAAE,MAAM,mCAAmC,CAAC;AACjF,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/internal/CompositeFileSystem.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Copyright (c) 2025, Salesforce, Inc.
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ **/
+import type { IFileSystem } from '@salesforce/metadata-core-sdk';
+/**
+ * Wrap a host `IFileSystem` so reads under `bundledRoot` resolve through
+ * `node:fs` against the adapter's bundled plugin assets, while every other
+ * call passes through to the host unchanged.
+ *
+ * Why this exists: the framework's `visualize(filePath)` flow uses
+ * `IPlatformContext.fileSystem` to BOTH parse the user's metadata file AND
+ * read the plugin's `index.html` (via HtmlVizGenerator). The web adapter
+ * needs the parser-side reads to go through the host's filesystem (so
+ * the host's restricted-path rules apply), and the plugin-asset reads to
+ * come from the adapter's bundle (so the host's filesystem is never asked
+ * for paths it doesn't know about).
+ *
+ * Only `readFile` and `exists` actually need bundled-side handling — every
+ * other `IFileSystem` method (path helpers, workspace ops, writeFile, etc.)
+ * is forwarded verbatim. We use a `Proxy` rather than a class with delegating
+ * stubs so the wrapper stays in sync automatically when `IFileSystem` grows
+ * new members.
+ */
+export declare function createCompositeFileSystem(host: IFileSystem, bundledRoot: string): IFileSystem;
+//# sourceMappingURL=CompositeFileSystem.d.ts.map

package/dist/internal/CompositeFileSystem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CompositeFileSystem.d.ts","sourceRoot":"","sources":["../../src/internal/CompositeFileSystem.ts"],"names":[],"mappings":"AAAA;;;;;IAKI;AAIJ,OAAO,KAAK,EAAE,WAAW,EAAU,MAAM,+BAA+B,CAAC;AAEzE;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,GAAG,WAAW,CAiD7F"}

package/dist/internal/CompositeFileSystem.js

@@ -0,0 +1,82 @@
+/**
+ * Copyright (c) 2025, Salesforce, Inc.
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ **/
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+/**
+ * Wrap a host `IFileSystem` so reads under `bundledRoot` resolve through
+ * `node:fs` against the adapter's bundled plugin assets, while every other
+ * call passes through to the host unchanged.
+ *
+ * Why this exists: the framework's `visualize(filePath)` flow uses
+ * `IPlatformContext.fileSystem` to BOTH parse the user's metadata file AND
+ * read the plugin's `index.html` (via HtmlVizGenerator). The web adapter
+ * needs the parser-side reads to go through the host's filesystem (so
+ * the host's restricted-path rules apply), and the plugin-asset reads to
+ * come from the adapter's bundle (so the host's filesystem is never asked
+ * for paths it doesn't know about).
+ *
+ * Only `readFile` and `exists` actually need bundled-side handling — every
+ * other `IFileSystem` method (path helpers, workspace ops, writeFile, etc.)
+ * is forwarded verbatim. We use a `Proxy` rather than a class with delegating
+ * stubs so the wrapper stays in sync automatically when `IFileSystem` grows
+ * new members.
+ */
+export function createCompositeFileSystem(host, bundledRoot) {
+    const bundledRootNormalized = path.resolve(bundledRoot);
+    const isBundled = (p) => {
+        if (!p) {
+            return false;
+        }
+        const abs = path.isAbsolute(p) ? path.normalize(p) : path.resolve(p);
+        return abs === bundledRootNormalized || abs.startsWith(bundledRootNormalized + path.sep);
+    };
+    const readFile = async (filePath) => {
+        if (!isBundled(filePath)) {
+            return host.readFile(filePath);
+        }
+        try {
+            return { success: true, data: await fs.readFile(filePath, 'utf-8') };
+        }
+        catch (err) {
+            return { success: false, error: asError(err) };
+        }
+    };
+    const exists = async (filePath) => {
+        if (!isBundled(filePath)) {
+            return host.exists(filePath);
+        }
+        try {
+            await fs.stat(filePath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    };
+    return new Proxy(host, {
+        get(target, prop) {
+            if (prop === 'readFile') {
+                return readFile;
+            }
+            if (prop === 'exists') {
+                return exists;
+            }
+            const value = target[prop];
+            // Bind methods to the host so `this` resolves correctly inside them.
+            return typeof value === 'function'
+                ? value.bind(target)
+                : value;
+        },
+    });
+}
+function asError(value) {
+    if (value && typeof value === 'object' && 'message' in value) {
+        return value;
+    }
+    return new Error(String(value));
+}
+//# sourceMappingURL=CompositeFileSystem.js.map

package/dist/internal/CompositeFileSystem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CompositeFileSystem.js","sourceRoot":"","sources":["../../src/internal/CompositeFileSystem.ts"],"names":[],"mappings":"AAAA;;;;;IAKI;AAEJ,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAGlC;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,yBAAyB,CAAC,IAAiB,EAAE,WAAmB;IAC9E,MAAM,qBAAqB,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAExD,MAAM,SAAS,GAAG,CAAC,CAAS,EAAW,EAAE;QACvC,IAAI,CAAC,CAAC,EAAE,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QACrE,OAAO,GAAG,KAAK,qBAAqB,IAAI,GAAG,CAAC,UAAU,CAAC,qBAAqB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;IAC3F,CAAC,CAAC;IAEF,MAAM,QAAQ,GAAG,KAAK,EAAE,QAAgB,EAA2B,EAAE;QACnE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;YACzB,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACjC,CAAC;QACD,IAAI,CAAC;YACH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,CAAC;QACvE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACjD,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,MAAM,GAAG,KAAK,EAAE,QAAgB,EAAoB,EAAE;QAC1D,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;YACzB,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC/B,CAAC;QACD,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACxB,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC,CAAC;IAEF,OAAO,IAAI,KAAK,CAAC,IAAI,EAAE;QACrB,GAAG,CAAC,MAAmB,EAAE,IAAqB;YAC5C,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;gBACxB,OAAO,QAAQ,CAAC;YAClB,CAAC;YACD,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACtB,OAAO,MAAM,CAAC;YAChB,CAAC;YACD,MAAM,KAAK,GAAI,MAAsD,CAAC,IAAI,CAAC,CAAC;YAC5E,qEAAqE;YACrE,OAAO,OAAO,KAAK,KAAK,UAAU;gBAChC,CAAC,CAAE,KAAyC,CAAC,IAAI,CAAC,MAAM,CAAC;gBACzD,CAAC,CAAC,KAAK,CAAC;QACZ,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED,SAAS,OAAO,CAAC,KAAc;IAC7B,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,SAAS,IAAI,KAAK,EAAE,CAAC;QAC7D,OAAO,KAAc,CAAC;IACxB,CAAC;IACD,OAAO,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;AAClC,CAAC"}

package/dist/internal/assetInliner.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Copyright (c) 2025, Salesforce, Inc.
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ **/
+import type { BundledPluginAssetReader } from '../pluginAssets/BundledPluginAssetReader.js';
+/**
+ * Asset reader interface - the minimal contract needed for asset inlining.
+ */
+type AssetReader = Pick<BundledPluginAssetReader, 'readPluginAsset' | 'readPluginIndexHtml' | 'readDesignSystemCss'>;
+/**
+ * Inline all external assets (JS, CSS) referenced in a plugin's HTML into
+ * a single self-contained HTML document. This eliminates the waterfall of
+ * HTTP requests when loading a plugin in an iframe.
+ *
+ * Transformations:
+ *  - <script src="./assets/index.js"> → <script>...inlined code...</script>
+ *  - <link href="./assets/index.css"> → <style>...inlined css...</style>
+ *  - Fonts/images in CSS remain as relative paths (or convert to data: URLs)
+ *
+ * @param html - Plugin's index.html content
+ * @param pluginId - Plugin identifier for asset resolution
+ * @param assetReader - Reader to fetch plugin assets
+ * @param platformCss - Optional platform CSS to inline (from @dist/ references)
+ * @returns HTML with all assets inlined
+ */
+export declare function inlineAssets(html: string, pluginId: string, assetReader: AssetReader, platformCss?: string): Promise<string>;
+export {};
+//# sourceMappingURL=assetInliner.d.ts.map

package/dist/internal/assetInliner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assetInliner.d.ts","sourceRoot":"","sources":["../../src/internal/assetInliner.ts"],"names":[],"mappings":"AAAA;;;;;IAKI;AAEJ,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,6CAA6C,CAAC;AAE5F;;GAEG;AACH,KAAK,WAAW,GAAG,IAAI,CACrB,wBAAwB,EACxB,iBAAiB,GAAG,qBAAqB,GAAG,qBAAqB,CAClE,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,WAAW,EACxB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,CAAC,CAajB"}

package/dist/internal/assetInliner.js

@@ -0,0 +1,126 @@
+/**
+ * Copyright (c) 2025, Salesforce, Inc.
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ **/
+/**
+ * Inline all external assets (JS, CSS) referenced in a plugin's HTML into
+ * a single self-contained HTML document. This eliminates the waterfall of
+ * HTTP requests when loading a plugin in an iframe.
+ *
+ * Transformations:
+ *  - <script src="./assets/index.js"> → <script>...inlined code...</script>
+ *  - <link href="./assets/index.css"> → <style>...inlined css...</style>
+ *  - Fonts/images in CSS remain as relative paths (or convert to data: URLs)
+ *
+ * @param html - Plugin's index.html content
+ * @param pluginId - Plugin identifier for asset resolution
+ * @param assetReader - Reader to fetch plugin assets
+ * @param platformCss - Optional platform CSS to inline (from @dist/ references)
+ * @returns HTML with all assets inlined
+ */
+export async function inlineAssets(html, pluginId, assetReader, platformCss) {
+    // First, inline platform CSS (@dist/ references)
+    if (platformCss) {
+        html = inlinePlatformCss(html, platformCss);
+    }
+    // Inline all <script src="..."> tags
+    html = await inlineScripts(html, pluginId, assetReader);
+    // Inline all <link rel="stylesheet" href="..."> tags
+    html = await inlineStylesheets(html, pluginId, assetReader);
+    return html;
+}
+/**
+ * Replace @dist/ link tags with inlined platform CSS.
+ */
+function inlinePlatformCss(html, platformCss) {
+    // Match: <link ... href="@dist/design-system/platform.css" ...>
+    const linkPattern = /<link\b[^>]*?\bhref=["']@dist\/[^"']*["'][^>]*?>/gi;
+    return html.replace(linkPattern, () => {
+        return `<style data-source="platform-css">\n${escapeForStyleTag(platformCss)}\n</style>`;
+    });
+}
+/**
+ * Escape a JS payload so it cannot prematurely close the surrounding <script> tag.
+ * Browsers terminate <script> on the literal substring `</script` (case-insensitive,
+ * regardless of whether a `>` follows), so any occurrence inside the payload — common
+ * in templated HTML strings, regex literals, or React server output — must be broken.
+ * `<\/script` is semantically identical in JS source but invisible to the HTML parser.
+ */
+function escapeForScriptTag(code) {
+    return code.replace(/<\/script/gi, '<\\/script');
+}
+/**
+ * Escape a CSS payload so it cannot prematurely close the surrounding <style> tag.
+ * Same hazard as escapeForScriptTag, but for `</style`. Replaced with `<\/style`,
+ * which CSS tokenizers ignore (the backslash is a valid CSS escape character).
+ */
+function escapeForStyleTag(css) {
+    return css.replace(/<\/style/gi, '<\\/style');
+}
+/**
+ * Inline all <script src="..."> tags that reference relative paths.
+ * Resolves each unique tag to its replacement asynchronously, then runs a single
+ * global regex pass so duplicate tags (e.g. shared vendor chunks) are all rewritten.
+ */
+async function inlineScripts(html, pluginId, assetReader) {
+    // Match: <script ... src="..." ...>
+    const scriptPattern = /<script\b([^>]*?\bsrc=["'])([^"']+)(["'][^>]*?)>/gi;
+    const replacements = new Map();
+    for (const tagMatch of html.matchAll(scriptPattern)) {
+        const fullTag = tagMatch[0];
+        const url = tagMatch[2];
+        if (replacements.has(fullTag) || isAbsoluteOrRooted(url)) {
+            continue;
+        }
+        const assetPath = url.startsWith('./') ? url.slice(2) : url;
+        try {
+            const bytes = await assetReader.readPluginAsset(pluginId, assetPath);
+            const code = escapeForScriptTag(new TextDecoder('utf-8').decode(bytes));
+            const inlineScript = fullTag.includes('type="module"')
+                ? `<script type="module">\n${code}\n</script>`
+                : `<script>\n${code}\n</script>`;
+            replacements.set(fullTag, inlineScript);
+        }
+        catch (err) {
+            // eslint-disable-next-line no-console
+            console.warn(`[assetInliner] Failed to inline script: ${assetPath}`, err);
+            // Leave fullTag absent from replacements so the original tag is preserved
+        }
+    }
+    // Single global pass: every occurrence of every resolved tag is rewritten.
+    return html.replace(scriptPattern, (fullTag) => replacements.get(fullTag) ?? fullTag);
+}
+/**
+ * Inline all <link rel="stylesheet" href="..."> tags that reference relative paths.
+ * Same single-pass strategy as inlineScripts to handle duplicate stylesheet refs.
+ */
+async function inlineStylesheets(html, pluginId, assetReader) {
+    // Match: <link ... rel="stylesheet" ... href="..." ...>
+    const linkPattern = /<link\b[^>]*?\brel=["']stylesheet["'][^>]*?\bhref=["']([^"']+)["'][^>]*?>/gi;
+    const replacements = new Map();
+    for (const tagMatch of html.matchAll(linkPattern)) {
+        const fullTag = tagMatch[0];
+        const url = tagMatch[1];
+        if (replacements.has(fullTag) || isAbsoluteOrRooted(url)) {
+            continue;
+        }
+        const assetPath = url.startsWith('./') ? url.slice(2) : url;
+        try {
+            const bytes = await assetReader.readPluginAsset(pluginId, assetPath);
+            const css = escapeForStyleTag(new TextDecoder('utf-8').decode(bytes));
+            replacements.set(fullTag, `<style data-source="${assetPath}">\n${css}\n</style>`);
+        }
+        catch (err) {
+            // eslint-disable-next-line no-console
+            console.warn(`[assetInliner] Failed to inline stylesheet: ${assetPath}`, err);
+        }
+    }
+    return html.replace(linkPattern, (fullTag) => replacements.get(fullTag) ?? fullTag);
+}
+function isAbsoluteOrRooted(url) {
+    // http(s)://, //cdn..., data:, blob:, /already-rooted
+    return /^[a-z][a-z0-9+.-]*:/i.test(url) || url.startsWith('//') || url.startsWith('/');
+}
+//# sourceMappingURL=assetInliner.js.map

package/dist/internal/assetInliner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assetInliner.js","sourceRoot":"","sources":["../../src/internal/assetInliner.ts"],"names":[],"mappings":"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"}

package/dist/internal/constants.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Copyright (c) 2025, Salesforce, Inc.
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ **/
+/**
+ * Bootstrap script for browser-iframe hosts.
+ *
+ * Defines `window.__ExtensionHostPostMessage` as a thin wrapper around
+ * `window.parent.postMessage(msg, '*')`. The embedding host's parent
+ * window is responsible for relaying the message to its server (e.g. via
+ * a `POST /visualize` REST call).
+ *
+ * Self-checks at runtime that the script is actually running inside a
+ * frame; logs an error if not, since `__ExtensionHostPostMessage` would
+ * otherwise post to the same window.
+ */
+export declare const BROWSER_IFRAME_BOOTSTRAP: string;
+//# sourceMappingURL=constants.d.ts.map

package/dist/internal/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/internal/constants.ts"],"names":[],"mappings":"AAAA;;;;;IAKI;AAEJ;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,wBAAwB,QAc7B,CAAC"}

package/dist/internal/constants.js

@@ -0,0 +1,34 @@
+/**
+ * Copyright (c) 2025, Salesforce, Inc.
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ **/
+/**
+ * Bootstrap script for browser-iframe hosts.
+ *
+ * Defines `window.__ExtensionHostPostMessage` as a thin wrapper around
+ * `window.parent.postMessage(msg, '*')`. The embedding host's parent
+ * window is responsible for relaying the message to its server (e.g. via
+ * a `POST /visualize` REST call).
+ *
+ * Self-checks at runtime that the script is actually running inside a
+ * frame; logs an error if not, since `__ExtensionHostPostMessage` would
+ * otherwise post to the same window.
+ */
+export const BROWSER_IFRAME_BOOTSTRAP = `
+<script>
+(function() {
+  if (window.parent === window) {
+    console.error('[browser-bootstrap] Not running inside a frame; __ExtensionHostPostMessage needs a parent window.');
+    return;
+  }
+  Object.defineProperty(window, '__ExtensionHostPostMessage', {
+    value: function(msg) { window.parent.postMessage(msg, '*'); },
+    writable: false,
+    configurable: false
+  });
+})();
+</script>
+`.trim();
+//# sourceMappingURL=constants.js.map

package/dist/internal/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/internal/constants.ts"],"names":[],"mappings":"AAAA;;;;;IAKI;AAEJ;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG;;;;;;;;;;;;;;CAcvC,CAAC,IAAI,EAAE,CAAC"}

package/dist/internal/htmlPipeline.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Copyright (c) 2025, Salesforce, Inc.
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ **/
+/**
+ * Pure HTML transforms that prepare a plugin's `index.html` for delivery to
+ * an iframe under a host's URL prefixes. No I/O. No host imports.
+ *
+ * The three transforms are applied by `WebVisualizationEngine.getPluginIndexHtml`
+ * in this order:
+ *   1. rewriteDistPlaceholders  — turn `@dist/...` into URLs under the
+ *      consumer's `platformAssetBaseUrl` (the platform CSS specifically).
+ *   2. rewritePluginAssetUrls   — turn the plugin's relative asset URLs
+ *      (`./assets/index-abc.js`, `./fonts/x.woff2`, etc.) into absolute
+ *      URLs under `pluginUiBaseUrl`.
+ *   3. injectBootstrap          — splice the host bridge's bootstrap
+ *      `<script>` into the document so plugins can postMessage to host.
+ */
+/**
+ * Inject the host-bridge bootstrap `<script>` into the document. Tries
+ * `</head>` first, falls back to `</body>`, and prepends if neither exists.
+ */
+export declare function injectBootstrap(html: string, scriptTag: string): string;
+/**
+ * Rewrite `@dist/` placeholders in the plugin's HTML to URLs under the
+ * consumer's platform-asset base URL. Plugins emit `<link href="@dist/design-system/platform.css">`
+ * as a host-portable indirection. The web adapter resolves it to
+ * `<base>/design-system/platform.css`, where `<base>` is the consumer-supplied
+ * `platformAssetBaseUrl`.
+ */
+export declare function rewriteDistPlaceholders(html: string, platformAssetBaseUrl: string): string;
+/**
+ * Rewrite the plugin's RELATIVE asset URLs to absolute URLs under
+ * `pluginUiBaseUrl`. Today, plugin builds emit:
+ *
+ *   <script type="module" crossorigin src="./assets/index-abc.js"></script>
+ *   <link rel="stylesheet" crossorigin href="./assets/index-abc.css">
+ *
+ * They may also emit `./fonts/...`, `./images/...`, or other relative
+ * paths in the future. We rewrite ANY relative path on `<script src>`
+ * and `<link href>` (i.e., starts with `./` or `assets/`-style without
+ * leading slash) to `<base>/<original>`.
+ *
+ * The "assets/" path segment lives only in this file. The consumer's
+ * route handlers never see it.
+ */
+export declare function rewritePluginAssetUrls(html: string, pluginUiBaseUrl: string): string;
+//# sourceMappingURL=htmlPipeline.d.ts.map

package/dist/internal/htmlPipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"htmlPipeline.d.ts","sourceRoot":"","sources":["../../src/internal/htmlPipeline.ts"],"names":[],"mappings":"AAAA;;;;;IAKI;AAEJ;;;;;;;;;;;;;GAaG;AAEH;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAQvE;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM,GAAG,MAAM,CAG1F;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,MAAM,CA4BpF"}

package/dist/internal/htmlPipeline.js

@@ -0,0 +1,86 @@
+/**
+ * Copyright (c) 2025, Salesforce, Inc.
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ **/
+/**
+ * Pure HTML transforms that prepare a plugin's `index.html` for delivery to
+ * an iframe under a host's URL prefixes. No I/O. No host imports.
+ *
+ * The three transforms are applied by `WebVisualizationEngine.getPluginIndexHtml`
+ * in this order:
+ *   1. rewriteDistPlaceholders  — turn `@dist/...` into URLs under the
+ *      consumer's `platformAssetBaseUrl` (the platform CSS specifically).
+ *   2. rewritePluginAssetUrls   — turn the plugin's relative asset URLs
+ *      (`./assets/index-abc.js`, `./fonts/x.woff2`, etc.) into absolute
+ *      URLs under `pluginUiBaseUrl`.
+ *   3. injectBootstrap          — splice the host bridge's bootstrap
+ *      `<script>` into the document so plugins can postMessage to host.
+ */
+/**
+ * Inject the host-bridge bootstrap `<script>` into the document. Tries
+ * `</head>` first, falls back to `</body>`, and prepends if neither exists.
+ */
+export function injectBootstrap(html, scriptTag) {
+    if (html.includes('</head>')) {
+        return html.replace('</head>', `${scriptTag}\n</head>`);
+    }
+    if (html.includes('</body>')) {
+        return html.replace('</body>', `${scriptTag}\n</body>`);
+    }
+    return `${scriptTag}\n${html}`;
+}
+/**
+ * Rewrite `@dist/` placeholders in the plugin's HTML to URLs under the
+ * consumer's platform-asset base URL. Plugins emit `<link href="@dist/design-system/platform.css">`
+ * as a host-portable indirection. The web adapter resolves it to
+ * `<base>/design-system/platform.css`, where `<base>` is the consumer-supplied
+ * `platformAssetBaseUrl`.
+ */
+export function rewriteDistPlaceholders(html, platformAssetBaseUrl) {
+    const base = stripTrailingSlash(platformAssetBaseUrl);
+    return html.replace(/@dist\//g, `${base}/`);
+}
+/**
+ * Rewrite the plugin's RELATIVE asset URLs to absolute URLs under
+ * `pluginUiBaseUrl`. Today, plugin builds emit:
+ *
+ *   <script type="module" crossorigin src="./assets/index-abc.js"></script>
+ *   <link rel="stylesheet" crossorigin href="./assets/index-abc.css">
+ *
+ * They may also emit `./fonts/...`, `./images/...`, or other relative
+ * paths in the future. We rewrite ANY relative path on `<script src>`
+ * and `<link href>` (i.e., starts with `./` or `assets/`-style without
+ * leading slash) to `<base>/<original>`.
+ *
+ * The "assets/" path segment lives only in this file. The consumer's
+ * route handlers never see it.
+ */
+export function rewritePluginAssetUrls(html, pluginUiBaseUrl) {
+    const base = stripTrailingSlash(pluginUiBaseUrl);
+    // Match <script ... src="..."> and <link ... href="..."> attributes.
+    // We rewrite only paths that look relative; we leave absolute URLs and
+    // already-absolute paths alone. The trailing closing-quote is included
+    // in the replacement, so we don't need a separate capture for it.
+    const rewrite = (match, prefix, quote, url) => {
+        if (isAbsoluteOrRooted(url)) {
+            return match;
+        }
+        const cleaned = url.startsWith('./') ? url.slice(2) : url;
+        return `${prefix}${quote}${base}/${cleaned}${quote}`;
+    };
+    // Process <script src="..."> tags.
+    html = html.replace(/(<script\b[^>]*?\bsrc=)(["'])([^"']+)\2/gi, (m, p, q, u) => rewrite(m, p, q, u));
+    // Process <link href="..."> tags.
+    html = html.replace(/(<link\b[^>]*?\bhref=)(["'])([^"']+)\2/gi, (m, p, q, u) => rewrite(m, p, q, u));
+    return html;
+}
+function isAbsoluteOrRooted(url) {
+    // http(s)://, //cdn..., data:, blob:, /already-rooted
+    return /^[a-z][a-z0-9+.-]*:/i.test(url) || url.startsWith('//') || url.startsWith('/');
+}
+function stripTrailingSlash(s) {
+    return s.endsWith('/') ? s.slice(0, -1) : s;
+}
+//# sourceMappingURL=htmlPipeline.js.map

package/dist/internal/htmlPipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"htmlPipeline.js","sourceRoot":"","sources":["../../src/internal/htmlPipeline.ts"],"names":[],"mappings":"AAAA;;;;;IAKI;AAEJ;;;;;;;;;;;;;GAaG;AAEH;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,SAAiB;IAC7D,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,SAAS,WAAW,CAAC,CAAC;IAC1D,CAAC;IACD,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,SAAS,WAAW,CAAC,CAAC;IAC1D,CAAC;IACD,OAAO,GAAG,SAAS,KAAK,IAAI,EAAE,CAAC;AACjC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAAY,EAAE,oBAA4B;IAChF,MAAM,IAAI,GAAG,kBAAkB,CAAC,oBAAoB,CAAC,CAAC;IACtD,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,GAAG,IAAI,GAAG,CAAC,CAAC;AAC9C,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAY,EAAE,eAAuB;IAC1E,MAAM,IAAI,GAAG,kBAAkB,CAAC,eAAe,CAAC,CAAC;IAEjD,qEAAqE;IACrE,uEAAuE;IACvE,uEAAuE;IACvE,kEAAkE;IAClE,MAAM,OAAO,GAAG,CAAC,KAAa,EAAE,MAAc,EAAE,KAAa,EAAE,GAAW,EAAU,EAAE;QACpF,IAAI,kBAAkB,CAAC,GAAG,CAAC,EAAE,CAAC;YAC5B,OAAO,KAAK,CAAC;QACf,CAAC;QACD,MAAM,OAAO,GAAG,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QAC1D,OAAO,GAAG,MAAM,GAAG,KAAK,GAAG,IAAI,IAAI,OAAO,GAAG,KAAK,EAAE,CAAC;IACvD,CAAC,CAAC;IAEF,mCAAmC;IACnC,IAAI,GAAG,IAAI,CAAC,OAAO,CACjB,2CAA2C,EAC3C,CAAC,CAAS,EAAE,CAAS,EAAE,CAAS,EAAE,CAAS,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CACpE,CAAC;IAEF,kCAAkC;IAClC,IAAI,GAAG,IAAI,CAAC,OAAO,CACjB,0CAA0C,EAC1C,CAAC,CAAS,EAAE,CAAS,EAAE,CAAS,EAAE,CAAS,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CACpE,CAAC;IAEF,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,kBAAkB,CAAC,GAAW;IACrC,sDAAsD;IACtD,OAAO,sBAAsB,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;AACzF,CAAC;AAED,SAAS,kBAAkB,CAAC,CAAS;IACnC,OAAO,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC9C,CAAC"}

package/dist/pluginAssets/BundledPluginAssetReader.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Copyright (c) 2025, Salesforce, Inc.
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ **/
+/**
+ * Plugin asset reader for the web adapter.
+ *
+ * Reads plugin React builds and the platform CSS from a bundled `dist/`
+ * directory, populated by `scripts/copy-plugin-assets.mjs` at build time.
+ * The adapter has zero runtime dependency on `@salesforce/metadata-plugins`
+ * — this reader only touches paths under its constructor-provided
+ * `bundledRoot`.
+ *
+ * Layout under `bundledRoot`:
+ *   <root>/plugins/<pluginId>/ui/index.html
+ *   <root>/plugins/<pluginId>/ui/assets/...
+ *   <root>/design-system/platform.css
+ */
+export declare class BundledPluginAssetReader {
+    private readonly bundledRoot;
+    /**
+     * @param bundledRoot Absolute path to the directory containing the
+     *   `plugins/` and `design-system/` subdirs. The factory in
+     *   `createWebVisualizationEngine` resolves this to the package's own
+     *   `dist/` at runtime; tests pass a tempdir.
+     */
+    constructor(bundledRoot: string);
+    readPluginIndexHtml(pluginId: string): Promise<string>;
+    readPluginAsset(pluginId: string, relativePath: string): Promise<Uint8Array>;
+    readDesignSystemCss(): Promise<string>;
+}
+//# sourceMappingURL=BundledPluginAssetReader.d.ts.map

package/dist/pluginAssets/BundledPluginAssetReader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BundledPluginAssetReader.d.ts","sourceRoot":"","sources":["../../src/pluginAssets/BundledPluginAssetReader.ts"],"names":[],"mappings":"AAAA;;;;;IAKI;AAOJ;;;;;;;;;;;;;GAaG;AACH,qBAAa,wBAAwB;IACnC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IAErC;;;;;OAKG;gBACS,WAAW,EAAE,MAAM;IAIzB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAetD,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAe5E,mBAAmB,IAAI,OAAO,CAAC,MAAM,CAAC;CAW7C"}

package/dist/pluginAssets/BundledPluginAssetReader.js

@@ -0,0 +1,77 @@
+/**
+ * Copyright (c) 2025, Salesforce, Inc.
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ **/
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { REACT_UI_DIR_NAME } from '@salesforce/metadata-core-sdk';
+import { AssetNotFoundError, PluginNotFoundError } from '../errors/index.js';
+/**
+ * Plugin asset reader for the web adapter.
+ *
+ * Reads plugin React builds and the platform CSS from a bundled `dist/`
+ * directory, populated by `scripts/copy-plugin-assets.mjs` at build time.
+ * The adapter has zero runtime dependency on `@salesforce/metadata-plugins`
+ * — this reader only touches paths under its constructor-provided
+ * `bundledRoot`.
+ *
+ * Layout under `bundledRoot`:
+ *   <root>/plugins/<pluginId>/ui/index.html
+ *   <root>/plugins/<pluginId>/ui/assets/...
+ *   <root>/design-system/platform.css
+ */
+export class BundledPluginAssetReader {
+    /**
+     * @param bundledRoot Absolute path to the directory containing the
+     *   `plugins/` and `design-system/` subdirs. The factory in
+     *   `createWebVisualizationEngine` resolves this to the package's own
+     *   `dist/` at runtime; tests pass a tempdir.
+     */
+    constructor(bundledRoot) {
+        this.bundledRoot = bundledRoot;
+    }
+    async readPluginIndexHtml(pluginId) {
+        const indexPath = path.join(this.bundledRoot, 'plugins', pluginId, REACT_UI_DIR_NAME, 'index.html');
+        try {
+            return await fs.readFile(indexPath, 'utf-8');
+        }
+        catch (err) {
+            throw mapEnoent(err, () => new PluginNotFoundError(pluginId));
+        }
+    }
+    async readPluginAsset(pluginId, relativePath) {
+        const assetPath = path.join(this.bundledRoot, 'plugins', pluginId, REACT_UI_DIR_NAME, relativePath);
+        try {
+            return await fs.readFile(assetPath);
+        }
+        catch (err) {
+            throw mapEnoent(err, () => new AssetNotFoundError(pluginId, relativePath));
+        }
+    }
+    async readDesignSystemCss() {
+        const cssPath = path.join(this.bundledRoot, 'design-system', 'platform.css');
+        try {
+            return await fs.readFile(cssPath, 'utf-8');
+        }
+        catch (err) {
+            throw mapEnoent(err, () => new Error(`Platform CSS not found in bundled dist (looked at ${cssPath})`));
+        }
+    }
+}
+function mapEnoent(err, build) {
+    // We avoid `instanceof Error` here because cross-realm errors (e.g. errors
+    // thrown by node:fs/promises and observed by a CommonJS-compiled test) can
+    // fail the prototype check even though they are functionally Error objects.
+    // Duck-type on `code` and gracefully wrap anything else.
+    const code = err?.code;
+    if (code === 'ENOENT') {
+        return build();
+    }
+    if (err && typeof err === 'object' && 'message' in err) {
+        return err;
+    }
+    return new Error(String(err));
+}
+//# sourceMappingURL=BundledPluginAssetReader.js.map

package/dist/pluginAssets/BundledPluginAssetReader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BundledPluginAssetReader.js","sourceRoot":"","sources":["../../src/pluginAssets/BundledPluginAssetReader.ts"],"names":[],"mappings":"AAAA;;;;;IAKI;AAEJ,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE7E;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,wBAAwB;IAGnC;;;;;OAKG;IACH,YAAY,WAAmB;QAC7B,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,mBAAmB,CAAC,QAAgB;QACxC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CACzB,IAAI,CAAC,WAAW,EAChB,SAAS,EACT,QAAQ,EACR,iBAAiB,EACjB,YAAY,CACb,CAAC;QACF,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAC/C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,mBAAmB,CAAC,QAAQ,CAAC,CAAC,CAAC;QAChE,CAAC;IACH,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,QAAgB,EAAE,YAAoB;QAC1D,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CACzB,IAAI,CAAC,WAAW,EAChB,SAAS,EACT,QAAQ,EACR,iBAAiB,EACjB,YAAY,CACb,CAAC;QACF,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QACtC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,kBAAkB,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC;QAC7E,CAAC;IACH,CAAC;IAED,KAAK,CAAC,mBAAmB;QACvB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,eAAe,EAAE,cAAc,CAAC,CAAC;QAC7E,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC7C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,SAAS,CACb,GAAG,EACH,GAAG,EAAE,CAAC,IAAI,KAAK,CAAC,qDAAqD,OAAO,GAAG,CAAC,CACjF,CAAC;QACJ,CAAC;IACH,CAAC;CACF;AAED,SAAS,SAAS,CAAC,GAAY,EAAE,KAAkB;IACjD,2EAA2E;IAC3E,2EAA2E;IAC3E,4EAA4E;IAC5E,yDAAyD;IACzD,MAAM,IAAI,GAAI,GAAoC,EAAE,IAAI,CAAC;IACzD,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtB,OAAO,KAAK,EAAE,CAAC;IACjB,CAAC;IACD,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,SAAS,IAAI,GAAG,EAAE,CAAC;QACvD,OAAO,GAAY,CAAC;IACtB,CAAC;IACD,OAAO,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;AAChC,CAAC"}