@salesforce/metadata-visualizer-web 1.1.0 → 1.2.0

package/README.md

@@ -45,13 +45,13 @@ After implementing `IFileSystem` and constructing the engine via `createWebVisua
 
 ### Core API Methods
 
-| Method                                       | Returns                                                             | Use Case                                                                                  |
-| -------------------------------------------- | ------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
-| `getPlugin(metadataFilePath)`                | `PluginInfo \| null`                                                | Resolve a metadata file path to its registered plugin (returns `id`, `displayName`, etc.) |
-| `visualizeMetadata(pluginId)`                | `{ bundle: HttpAsset<string> \| null, error: PluginError \| null }` | Generate a fully self-contained HTML shell for the plugin's UI (no parsing — UI only)     |
-| `getParsedMetadata(metadataFilePath)`        | `VisualizeOutcome` — `{ result, error }`                            | Parse metadata and return structured data without generating HTML                         |
-| `getUpdatedParsedMetadata(metadataFilePath)` | `{ error, pluginDataUpdateMessage }`                                | Generate update message for posting to existing plugin iframe (live updates)              |
-| `dispose()`                                  | `void`                                                              | Release all resources (call on shutdown)                                                  |
+| Method                                       | Returns                                                             | Use Case                                                                                                                             |
+| -------------------------------------------- | ------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
+| `getPlugin(metadataFilePath)`                | `PluginInfo \| null`                                                | Resolve a metadata file path to its registered plugin (returns `id`, `displayName`, etc.)                                            |
+| `visualizeMetadata(pluginId, options?)`      | `{ bundle: HttpAsset<string> \| null, error: PluginError \| null }` | Generate a fully self-contained HTML shell for the plugin's UI (no parsing — UI only); `options.theme` selects a design-system theme |
+| `getParsedMetadata(metadataFilePath)`        | `VisualizeOutcome` — `{ result, error }`                            | Parse metadata and return structured data without generating HTML                                                                    |
+| `getUpdatedParsedMetadata(metadataFilePath)` | `{ error, pluginDataUpdateMessage }`                                | Generate update message for posting to existing plugin iframe (live updates)                                                         |
+| `dispose()`                                  | `void`                                                              | Release all resources (call on shutdown)                                                                                             |
 
 ### Method Details
 
@@ -63,7 +63,7 @@ After implementing `IFileSystem` and constructing the engine via `createWebVisua
 - Returns `PluginInfo` (with `id`) on match, `null` otherwise
 - Synchronous and side-effect-free
 
-**`visualizeMetadata(pluginId)`** — Generate UI shell:
+**`visualizeMetadata(pluginId, options?)`** — Generate UI shell:
 
 - Returns fully self-contained HTML with all assets (JS, CSS, platform styles) inlined
 - **No metadata parsing occurs** — this generates the static plugin UI only
@@ -71,6 +71,15 @@ After implementing `IFileSystem` and constructing the engine via `createWebVisua
 - Perfect for iframe embedding: `<iframe srcdoc="..."></iframe>`
 - The loaded plugin iframe requests its data separately via postMessage
 - Error handling: Check `error` field first, then use `bundle`
+- **Theming:** Pass `{ theme: 'light' }` to inline the light design-system sheet. Omitting `options` (or `options.theme`) yields the default dark-fallback bundle, byte-for-byte identical to the pre-theme behavior. An unknown theme returns a `Validation` error (no silent fallback), reported before any asset read. Valid theme names come from `DESIGN_SYSTEM_THEMES` / `isDesignSystemTheme` (re-exported from `@salesforce/metadata-core-sdk/design-system`).
+- **Caching:** The bundle body varies by `(pluginId, theme)` at a stable URL, so its `cacheControl` is `public, max-age=86400` (no `immutable`). Multi-theme callers should vary their own cache key by theme.
+
+```ts
+// Light theme bundle
+const { bundle, error } = await engine.visualizeMetadata(pluginInfo.id, { theme: 'light' });
+```
+
+> **Known limitation:** React Flow chrome elements (canvas dots, minimap, attribution) in plugin UIs remain dark-mode styled. Those elements are rendered by the external `@salesforce/metadata-plugins` package and are not reached by the design-system theme layer. Closing this gap requires a separate plugins-repo change.
 
 **`getParsedMetadata(metadataFilePath)`** — Parse metadata only:
 
@@ -250,7 +259,7 @@ Build runs from the workspace root — `@salesforce/metadata-plugins` lives in t
 
 - `WebVisualizationEngine` — Main class with five methods:
   - `getPlugin(metadataFilePath)` — Resolve a file path to its registered plugin
-  - `visualizeMetadata(pluginId)` — Generate the plugin UI shell (HTML bundle, no parsing)
+  - `visualizeMetadata(pluginId, options?)` — Generate the plugin UI shell (HTML bundle, no parsing); `options.theme` selects a design-system theme
   - `getParsedMetadata(metadataFilePath)` — Parse metadata only
   - `getUpdatedParsedMetadata(metadataFilePath)` — Generate update message for live updates
   - `dispose()` — Release resources
@@ -263,6 +272,8 @@ Build runs from the workspace root — `@salesforce/metadata-plugins` lives in t
 - `VisualizeOutcome` — Parse result: `{ result, error }`. The `error` field is a `PluginError` from `@salesforce/metadata-core-sdk`.
 - `PluginDataUpdateMessage<T = unknown>` — Update message for postMessage: `{ type: 'PLUGIN_DATA_UPDATE', payload: PluginDataResponse<T> }`. Generic `T` lets plugin code with a known data shape opt into type-safety; consumers can narrow on `message.type` in a discriminated-union switch.
 - `WebAdapterOptions` — Engine constructor options: `{ fileSystem, telemetry? }`
+- `VisualizeMetadataOptions` — `visualizeMetadata` options: `{ theme?: DesignSystemTheme }`
+- `DesignSystemTheme` / `DESIGN_SYSTEM_THEMES` / `isDesignSystemTheme` — Theme catalog re-exported from `@salesforce/metadata-core-sdk/design-system`
 
 ## License
 

package/dist/WebVisualizationEngine.d.ts

@@ -5,6 +5,7 @@
  * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
  **/
 import type { PluginError } from '@salesforce/metadata-core-sdk';
+import { type DesignSystemTheme } from '@salesforce/metadata-core-sdk/design-system';
 import type { PluginManager, VisualizationEngine } from '@salesforce/metadata-visualizer-core';
 import { BundledPluginAssetReader } from './pluginAssets/BundledPluginAssetReader.js';
 import type { HttpAsset } from './types/HttpAsset.js';
@@ -22,6 +23,18 @@ export interface WebVisualizationEngineDeps {
     pluginManager: PluginManager;
     pluginAssetReader: BundledPluginAssetReader;
 }
+/**
+ * Options for {@link WebVisualizationEngine.visualizeMetadata}.
+ */
+export interface VisualizeMetadataOptions {
+    /**
+     * Optional theme name. If omitted, returns the default (dark-fallback)
+     * bundle — byte-for-byte identical to the pre-theme behavior. A value that
+     * is not a known theme is rejected with a `Validation` error rather than
+     * silently falling back.
+     */
+    theme?: DesignSystemTheme;
+}
 /**
  * Browser/HTTP platform adapter for the visualization framework.
  * Provides methods to generate self-contained HTML bundles and parse metadata
@@ -59,20 +72,31 @@ export declare class WebVisualizationEngine {
      * ready to be embedded in an iframe. No metadata parsing occurs — this generates the static UI shell.
      *
      * @param pluginId - ID of the registered plugin to generate bundle for
+     * @param options - Optional bundle options. `theme` selects a design-system
+     *   theme (e.g. `'light'`); omitting it yields the default dark-fallback bundle.
      * @returns Object containing the bundle (null if failed) and error (null if successful)
      *
      * @example
      * ```typescript
+     * // Default (dark-fallback) bundle
      * const { bundle, error } = await engine.visualizeMetadata('flexipage-visualizer');
+     *
+     * // Light theme bundle
+     * const { bundle, error } = await engine.visualizeMetadata('flexipage-visualizer', { theme: 'light' });
+     *
      * if (error) {
      *   console.error('Bundle generation failed:', error.message);
-     *   res.status(error.category === 'Configuration' ? 404 : 500).json({ error: error.message });
+     *   res
+     *     .status(
+     *       error.category === 'Validation' ? 400 : error.category === 'Configuration' ? 404 : 500
+     *     )
+     *     .json({ error: error.message });
      * } else if (bundle) {
      *   res.type(bundle.contentType).send(bundle.body);
      * }
      * ```
      */
-    visualizeMetadata(pluginId: string): Promise<{
+    visualizeMetadata(pluginId: string, options?: VisualizeMetadataOptions): Promise<{
         bundle: HttpAsset<string> | null;
         error: PluginError | null;
     }>;

package/dist/WebVisualizationEngine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WebVisualizationEngine.d.ts","sourceRoot":"","sources":["../src/WebVisualizationEngine.ts"],"names":[],"mappings":"AAAA;;;;;IAKI;AAEJ,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAEjE,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAI/F,OAAO,EAAE,wBAAwB,EAAE,MAAM,4CAA4C,CAAC;AACtF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAElF;;;;;GAKG;AACH,MAAM,WAAW,0BAA0B;IACzC,SAAS,EAAE,mBAAmB,CAAC;IAC/B,aAAa,EAAE,aAAa,CAAC;IAC7B,iBAAiB,EAAE,wBAAwB,CAAC;CAC7C;AAED;;;;GAIG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsB;IAChD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAC9C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA2B;IACvD,4EAA4E;IAC5E,OAAO,CAAC,QAAQ,CAAS;IACzB,gGAAgG;IAChG,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA6B;IAE5D;;;;;;;;;;;;;;;;OAgBG;gBACS,IAAI,EAAE,0BAA0B;IAM5C;;;;;;;;;;;;;;;;;;OAkBG;IACG,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QACjD,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;QACjC,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;KAC3B,CAAC;IA0DF;;;;;;;;;;;;;;;;;OAiBG;IACG,iBAAiB,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAyC5E;;;;;;;;;;;;;;;;;;OAkBG;IACG,wBAAwB,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC;QAChE,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;QAC1B,uBAAuB,EAAE,uBAAuB,GAAG,IAAI,CAAC;KACzD,CAAC;IASF;;;;;;;;;;;;;;;;;OAiBG;IACH,OAAO,IAAI,IAAI;IAUf;;;;;;;OAOG;IACH,OAAO,CAAC,uBAAuB;IAsB/B;;;;;;OAMG;IACH,SAAS,CAAC,YAAY,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAKlD;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAI1B,4DAA4D;IAC5D,OAAO,CAAC,iBAAiB;CAK1B"}
+{"version":3,"file":"WebVisualizationEngine.d.ts","sourceRoot":"","sources":["../src/WebVisualizationEngine.ts"],"names":[],"mappings":"AAAA;;;;;IAKI;AAEJ,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAEjE,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,6CAA6C,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAI/F,OAAO,EAAE,wBAAwB,EAAE,MAAM,4CAA4C,CAAC;AACtF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAElF;;;;;GAKG;AACH,MAAM,WAAW,0BAA0B;IACzC,SAAS,EAAE,mBAAmB,CAAC;IAC/B,aAAa,EAAE,aAAa,CAAC;IAC7B,iBAAiB,EAAE,wBAAwB,CAAC;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC;;;;;OAKG;IACH,KAAK,CAAC,EAAE,iBAAiB,CAAC;CAC3B;AAED;;;;GAIG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsB;IAChD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAC9C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA2B;IACvD,4EAA4E;IAC5E,OAAO,CAAC,QAAQ,CAAS;IACzB,gGAAgG;IAChG,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA6B;IAE5D;;;;;;;;;;;;;;;;OAgBG;gBACS,IAAI,EAAE,0BAA0B;IAM5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACG,iBAAiB,CACrB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,wBAAwB,GACjC,OAAO,CAAC;QACT,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;QACjC,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;KAC3B,CAAC;IA8EF;;;;;;;;;;;;;;;;;OAiBG;IACG,iBAAiB,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAyC5E;;;;;;;;;;;;;;;;;;OAkBG;IACG,wBAAwB,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC;QAChE,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;QAC1B,uBAAuB,EAAE,uBAAuB,GAAG,IAAI,CAAC;KACzD,CAAC;IASF;;;;;;;;;;;;;;;;;OAiBG;IACH,OAAO,IAAI,IAAI;IAUf;;;;;;;OAOG;IACH,OAAO,CAAC,uBAAuB;IAsB/B;;;;;;OAMG;IACH,SAAS,CAAC,YAAY,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAKlD;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAI1B,4DAA4D;IAC5D,OAAO,CAAC,iBAAiB;CAK1B"}

package/dist/WebVisualizationEngine.js

@@ -5,6 +5,7 @@
  * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
  **/
 import { WebviewMessageType, ErrorCategory } from '@salesforce/metadata-core-sdk';
+import { isDesignSystemTheme, } from '@salesforce/metadata-core-sdk/design-system';
 import { injectBootstrap } from './internal/htmlPipeline.js';
 import { inlineAssets } from './internal/assetInliner.js';
 import { BROWSER_IFRAME_BOOTSTRAP } from './internal/constants.js';
@@ -46,20 +47,31 @@ export class WebVisualizationEngine {
      * ready to be embedded in an iframe. No metadata parsing occurs — this generates the static UI shell.
      *
      * @param pluginId - ID of the registered plugin to generate bundle for
+     * @param options - Optional bundle options. `theme` selects a design-system
+     *   theme (e.g. `'light'`); omitting it yields the default dark-fallback bundle.
      * @returns Object containing the bundle (null if failed) and error (null if successful)
      *
      * @example
      * ```typescript
+     * // Default (dark-fallback) bundle
      * const { bundle, error } = await engine.visualizeMetadata('flexipage-visualizer');
+     *
+     * // Light theme bundle
+     * const { bundle, error } = await engine.visualizeMetadata('flexipage-visualizer', { theme: 'light' });
+     *
      * if (error) {
      *   console.error('Bundle generation failed:', error.message);
-     *   res.status(error.category === 'Configuration' ? 404 : 500).json({ error: error.message });
+     *   res
+     *     .status(
+     *       error.category === 'Validation' ? 400 : error.category === 'Configuration' ? 404 : 500
+     *     )
+     *     .json({ error: error.message });
      * } else if (bundle) {
      *   res.type(bundle.contentType).send(bundle.body);
      * }
      * ```
      */
-    async visualizeMetadata(pluginId) {
+    async visualizeMetadata(pluginId, options) {
         this.assertNotDisposed();
         // Fail fast on invalid plugin IDs to avoid downstream errors
         if (!pluginId || pluginId.trim().length === 0) {
@@ -71,6 +83,18 @@ export class WebVisualizationEngine {
                 },
             };
         }
+        // Reject an unknown theme up front — before any plugin verification or asset
+        // read — so a bad theme never touches the filesystem. No silent fallback:
+        // an invalid theme is a caller error, consistent with the error-first boundary.
+        if (options?.theme !== undefined && !isDesignSystemTheme(options.theme)) {
+            return {
+                bundle: null,
+                error: {
+                    message: `Invalid theme: ${options.theme}`,
+                    category: ErrorCategory.Validation,
+                },
+            };
+        }
         // Verify plugin is registered before attempting asset read
         if (!this.requireKnownPlugin(pluginId)) {
             return {
@@ -84,7 +108,7 @@ export class WebVisualizationEngine {
         try {
             // Build self-contained HTML bundle: inline all assets to eliminate external requests
             let html = await this.assetReader.readPluginIndexHtml(pluginId);
-            const platformCss = await this.assetReader.readDesignSystemCss();
+            const platformCss = await this.assetReader.readDesignSystemCss(options?.theme);
             html = await inlineAssets(html, pluginId, this.assetReader, platformCss);
             // Bootstrap script enables host-plugin postMessage communication
             html = injectBootstrap(html, BROWSER_IFRAME_BOOTSTRAP);
@@ -92,11 +116,16 @@ export class WebVisualizationEngine {
                 bundle: {
                     contentType: 'text/html; charset=utf-8',
                     body: html,
-                    // Bundle is the static plugin UI shell only (no per-user / per-org data —
-                    // that flows separately via getParsedMetadata + postMessage). The shell is
-                    // an immutable build artifact keyed by pluginId, safe to share across users
-                    // and cache for a day. `immutable` lets clients skip revalidation entirely.
-                    cacheControl: 'public, max-age=86400, immutable',
+                    // Bundle is the static plugin UI shell + themed CSS (no per-user / per-org
+                    // data — that flows separately via getParsedMetadata + postMessage). The
+                    // shell is keyed by (pluginId, theme), but the theme is chosen via the
+                    // options parameter, not the URL — so the same URL can yield different
+                    // bodies. We therefore drop `immutable`: with it, a client that fetched the
+                    // default bundle and later requests light for the same plugin would be
+                    // served the stale cached copy. `public, max-age=86400` still allows a day
+                    // of caching but lets the client revalidate after that or on hard refresh.
+                    // Multi-theme callers should vary their own cache key by theme.
+                    cacheControl: 'public, max-age=86400',
                 },
                 error: null,
             };
@@ -108,7 +137,9 @@ export class WebVisualizationEngine {
                 error: {
                     message: err instanceof Error ? err.message : 'Failed to generate bundle',
                     category: ErrorCategory.Runtime,
-                    context: { pluginId: pluginId },
+                    // Include the theme so a themed-read failure (e.g. a missing theme
+                    // sheet) is distinguishable from a default-read failure by context.
+                    context: { pluginId: pluginId, theme: options?.theme ?? 'default' },
                     stackTrace: err instanceof Error ? err.stack : undefined,
                 },
             };

package/dist/WebVisualizationEngine.js.map

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

package/dist/design-system/light-design-system.css

@@ -0,0 +1,724 @@
+/**
+ * Copyright (c) 2026, 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
+ **/
+
+/* Light theme — VS Code "Light Modern" aligned, tuned so every meaningful
+   color clears its WCAG floor on a light canvas. This sheet declares the full
+   `--vscode-*` layer that vscode-design-system.css reads for its `--mv-*`
+   tokens; without it, a plain browser iframe falls to the base sheet's dark
+   fallbacks. Body text clears WCAG-AA (4.5:1) and every graphical color clears
+   WCAG 1.4.11 (3:1) on white. Ratios in the trailing comments are measured
+   with the WCAG 2.x relative-luminance formula (the same math the parity test
+   uses). Dark is NOT re-authored here — dark remains the base sheet's inline
+   fallbacks, so the default (no-theme) bundle stays byte-identical. */
+:root {
+  /* ===== Canvas / shell ===== */
+  --vscode-editor-background: #ffffff;
+  --vscode-foreground: #3b3b3b; /* 11.2:1 on white — deliberately not pure black */
+  --vscode-descriptionForeground: #5f6368; /* 6.05:1 on white */
+  --vscode-disabledForeground: #a1a1a1; /* 2.58:1 — disabled text is WCAG-exempt, not asserted */
+
+  /* ===== Node / surface backgrounds (near-white so foreground stays >= 4.5:1) ===== */
+  --vscode-editorWidget-background: #f8f8f8;
+  --vscode-sideBar-background: #f8f8f8;
+  --vscode-panel-background: #ffffff;
+  --vscode-dropdown-background: #ffffff;
+  --vscode-input-background: #ffffff;
+  --vscode-minimap-background: #f8f8f8;
+  --vscode-widget-background: rgba(255, 255, 255, 0.9);
+
+  /* ===== Interactive / chrome (text pairs >= 4.5:1) ===== */
+  --vscode-textLink-foreground: #005fb8; /* 6.31:1 on white */
+  --vscode-textLink-activeForeground: #005fb8; /* 6.31:1 on white */
+  --vscode-button-background: #005fb8;
+  --vscode-button-foreground: #ffffff; /* 6.31:1 on the button background */
+  --vscode-button-secondaryBackground: #e5e5e5;
+  --vscode-button-secondaryForeground: #3b3b3b; /* 8.89:1 on the secondary background */
+  --vscode-badge-background: #005fb8;
+  --vscode-badge-foreground: #ffffff;
+  --vscode-list-activeSelectionBackground: #0060c0;
+  --vscode-list-activeSelectionForeground: #ffffff; /* 6.11:1 on the selection background */
+  --vscode-textPreformat-foreground: #0a5c79; /* 7.45:1 on white */
+  --vscode-focusBorder: #005fb8;
+
+  /* ===== Borders / separators (structural, visible on white) ===== */
+  --vscode-editorGroup-border: #d4d4d4;
+  --vscode-widget-border: #d4d4d4;
+  --vscode-panel-border: #d4d4d4;
+  --vscode-input-border: #d4d4d4;
+  --vscode-dropdown-border: #d4d4d4;
+  --vscode-editorRuler-foreground: #d4d4d4;
+  --vscode-contrastBorder: transparent; /* High-contrast mode only; stays transparent otherwise */
+
+  /* ===== Charts / accents / edges (>= 3:1 on white) =====
+     Darkened from the SLDS bright hues so they clear the non-text floor on a
+     light canvas. The bright #4bca81 / #fe9339 / #e4a201 fail 3:1 on white and
+     are intentionally NOT used. These feed accent, status, and ERD-edge tokens
+     that color meaningful non-text graphics. */
+  --vscode-charts-blue: #0b66c2; /* 5.69:1 on white */
+  --vscode-charts-green: #137a3c; /* 5.42:1 on white — darkened from the bright green */
+  --vscode-charts-red: #d13438; /* 4.93:1 on white */
+  --vscode-charts-orange: #b5620a; /* 4.45:1 on white — darkened from the bright orange */
+  --vscode-charts-yellow: #946a00; /* 4.86:1 on white — a dark amber; bright yellow cannot clear 3:1 */
+  --vscode-charts-purple: #8250df; /* 5.05:1 on white */
+  --vscode-charts-lines: #767676; /* 4.54:1 on white — edges are meaningful; a faint ruler line fails */
+
+  /* ===== Status / ANSI (graphical >= 3:1, error text >= 4.5:1) ===== */
+  --vscode-terminal-ansiGreen: #137a3c; /* 5.42:1 on white */
+  --vscode-terminal-ansiCyan: #0a7c8c; /* 4.91:1 on white */
+  --vscode-terminal-ansiYellow: #946a00; /* 4.86:1 on white */
+  --vscode-errorForeground: #c4291c; /* 5.70:1 on white */
+  --vscode-inputValidation-errorBackground: #fdedeb;
+  --vscode-inputValidation-errorBorder: #c4291c;
+
+  /* ===== Syntax primitives (rendered as text inside nodes on #f8f8f8) ===== */
+  --vscode-debugTokenExpression-string: #a31515; /* 7.39:1 on #f8f8f8 */
+  --vscode-debugTokenExpression-number: #0a7d33; /* 4.95:1 on #f8f8f8 */
+  --vscode-debugTokenExpression-boolean: #0000ff; /* 8.09:1 on #f8f8f8 */
+  --vscode-debugTokenExpression-name: #001080; /* 14.27:1 on #f8f8f8 */
+  --vscode-symbolIcon-propertyForeground: #3b3b3b;
+  --vscode-symbolIcon-classForeground: #9a6700; /* 4.58:1 on #f8f8f8 — class icon is graphical */
+
+  /* ===== Selection / hover tints ===== */
+  --vscode-editor-selectionBackground: rgba(0, 95, 184, 0.15);
+  --vscode-list-hoverBackground: #f0f0f0;
+  --vscode-scrollbarSlider-background: rgba(100, 100, 100, 0.4);
+  --vscode-scrollbarSlider-hoverBackground: rgba(100, 100, 100, 0.7);
+  --vscode-widget-shadow: rgba(0, 0, 0, 0.16);
+
+  /* ===== Fonts (environmental, not color — carried over from the base sheet's
+     own fallbacks so the light bundle stays self-contained and all vars are
+     declared for parity) ===== */
+  --vscode-font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;
+  --vscode-editor-font-family: "SF Mono", Monaco, "Cascadia Code", "Roboto Mono", Consolas, "Courier New", monospace;
+  --vscode-editor-font-size: 13px;
+  --vscode-editor-font-weight: 400;
+}
+
+
+/* ===== RESET & BASE STYLES ===== */
+
+*,
+*::before,
+*::after {
+  box-sizing: border-box;
+}
+
+html,
+body {
+  margin: 0;
+  padding: 0;
+  width: 100%;
+  height: 100%;
+  overflow-x: hidden;
+}
+
+body {
+  font-family: var(--vscode-font-family, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif);
+  font-size: var(--vscode-editor-font-size, 13px);
+  font-weight: var(--vscode-editor-font-weight, 400);
+  line-height: 1.4;
+  color: var(--vscode-foreground, #cccccc);
+  background: var(--vscode-editor-background, #1e1e1e);
+  -webkit-font-smoothing: antialiased;
+  -moz-osx-font-smoothing: grayscale;
+}
+
+h1, h2, h3, h4, h5, h6,
+p, blockquote, pre,
+dl, dd, ol, ul,
+figure, hr {
+  margin: 0;
+  padding: 0;
+}
+
+ol, ul {
+  list-style: none;
+}
+
+img {
+  max-width: 100%;
+  height: auto;
+  display: block;
+}
+
+button, input, select, textarea {
+  font-family: inherit;
+  font-size: inherit;
+  line-height: inherit;
+}
+
+button {
+  background: transparent;
+  border: none;
+  cursor: pointer;
+  padding: 0;
+}
+
+a {
+  color: var(--vscode-textLink-foreground, #3794ff);
+  text-decoration: none;
+}
+
+a:hover {
+  color: var(--vscode-textLink-activeForeground, #3794ff);
+  text-decoration: underline;
+}
+
+:focus-visible {
+  outline: 2px solid var(--vscode-focusBorder, #007fd4);
+  outline-offset: 2px;
+}
+
+::-webkit-scrollbar {
+  width: 10px;
+  height: 10px;
+}
+
+::-webkit-scrollbar-track {
+  background: var(--vscode-scrollbarSlider-background, rgba(121, 121, 121, 0.4));
+}
+
+::-webkit-scrollbar-thumb {
+  background: var(--vscode-scrollbarSlider-background, rgba(121, 121, 121, 0.4));
+  border-radius: 10px;
+}
+
+::-webkit-scrollbar-thumb:hover {
+  background: var(--vscode-scrollbarSlider-hoverBackground, rgba(100, 100, 100, 0.7));
+}
+
+/* ===== DESIGN TOKENS ===== */
+
+:root {
+  /* ===== 1. CANVAS & SHELL (Global Environment) ===== */
+  /* The immutable stage - ensures every visualization looks native to VS Code */
+  
+  /* Canvas */
+  --mv-canvas-bg: var(--vscode-editor-background, #1e1e1e);
+  --mv-canvas-grid: var(--vscode-editorRuler-foreground, #e5e5e5);
+  --mv-minimap-bg: var(--vscode-minimap-background, #f0f0f0);
+  
+  /* Chrome / Shell */
+  --mv-panel-bg: var(--vscode-editorWidget-background, #252526);
+  --mv-panel-border: var(--vscode-editorGroup-border, #454545);
+  --mv-panel-shadow: 0 4px 16px var(--vscode-widget-shadow, rgba(0, 0, 0, 0.36));
+
+  /* ===== 2. CORE ENTITIES (Node Contract) ===== */
+  /* Base tokens for all entity cards - ensures consistent elevation and behavior */
+  
+  /* Node Base */
+  --mv-node-bg: var(--vscode-editorWidget-background, #252526);
+  --mv-node-border: var(--vscode-widget-border, #454545);
+  --mv-node-border-focus: var(--vscode-focusBorder, #007fd4);
+
+  --mv-node-bg-hover: var(--vscode-list-hoverBackground, #2a2d2e);
+  --mv-node-bg-selected: var(--vscode-list-activeSelectionBackground, #094771);
+  --mv-node-fg: var(--vscode-foreground, #cccccc);
+  --mv-node-fg-secondary: var(--vscode-descriptionForeground, #cccccc99);
+  --mv-node-fg-selected: var(--vscode-list-activeSelectionForeground, #ffffff);
+
+  --mv-edge-neutral: var(--vscode-charts-lines, #cccccc);
+  --mv-edge-active: var(--vscode-textLink-activeForeground, #3794ff);
+
+  /* ===== 3. SEMANTIC VARIANTS & SYNTAX ===== */
+
+  /* 3A. Functional Accents - The "Four Pillars" */
+  /* Teams must map their metadata concepts to these four categories */
+  --mv-accent-data: var(--vscode-charts-purple, #b180d7);
+  --mv-accent-logic: var(--vscode-charts-blue, #3794ff);
+  --mv-accent-ui: var(--vscode-charts-yellow, #ffb454);
+  --mv-accent-system: var(--vscode-charts-orange, #d18616);
+
+  /* Syntax Primitives */
+  --mv-syntax-string: var(--vscode-debugTokenExpression-string, #ce9178);
+  --mv-syntax-number: var(--vscode-debugTokenExpression-number, #b5cea8);
+  --mv-syntax-boolean: var(--vscode-debugTokenExpression-boolean, #569cd6);
+  --mv-syntax-property: var(--vscode-symbolIcon-propertyForeground, #cccccc);
+  --mv-syntax-class: var(--vscode-symbolIcon-classForeground, #ee9d28);
+
+  
+  /* 3B. State Indicators - Universal Status */
+  /* Teams must use these for state indication - custom colors forbidden */
+  --mv-status-positive: var(--vscode-charts-green, #23d18b);
+  --mv-status-negative: var(--vscode-charts-red, #f14c4c);
+  --mv-status-warning: var(--vscode-charts-orange, #d18616);
+  --mv-status-info: var(--vscode-charts-blue, #3794ff);
+  --mv-status-neutral: var(--vscode-disabledForeground, #656565);
+
+  /* ===== 4. INTERNAL COMPONENT TOKENS ===== */
+  /* Standardized internal elements for within nodes */
+  --mv-marker-primary: var(--vscode-foreground, #cccccc);
+  --mv-marker-muted: var(--vscode-disabledForeground, #656565);
+  --mv-separator: var(--vscode-editorRuler-foreground, #e5e5ee);
+  --mv-region-zone: var(--vscode-editor-selectionBackground, rgba(38, 79, 120, 0.4));
+
+  /* ===== 5. ACCESSIBILITY (High Contrast) ===== */
+  /* Platform-enforced overrides for High Contrast mode */
+  --mv-hc-border: var(--vscode-contrastBorder, transparent);
+  --mv-hc-selection: var(--vscode-focusBorder, #007fd4);
+
+  /* ===== GENERAL PURPOSE TOKENS ===== */
+  
+  /* Background Colors */
+  --mv-bg-primary: var(--vscode-editor-background, #1e1e1e);
+  --mv-bg-secondary: var(--vscode-sideBar-background, #252526);
+  --mv-bg-elevated: var(--vscode-dropdown-background, #3c3c3c);
+  --mv-bg-surface: var(--vscode-panel-background, #1e1e1e);
+  --mv-bg-surface-hover: var(--vscode-list-hoverBackground, #2a2d2e);
+  --mv-bg-input: var(--vscode-input-background, #3c3c3c);
+  --mv-bg-badge: var(--vscode-badge-background, #4d4d4d);
+  --mv-fg-badge: var(--vscode-badge-foreground, #ffffff);
+
+  /* Text Colors */
+  --mv-text-primary: var(--vscode-foreground, #cccccc);
+  --mv-text-secondary: var(--vscode-descriptionForeground, #999999);
+  --mv-text-muted: var(--vscode-disabledForeground, #656565);
+  --mv-text-inverse: var(--vscode-list-activeSelectionForeground, #ffffff);
+
+  /* Interactive Colors */
+  --mv-interactive-primary: var(--vscode-textLink-foreground, #3794ff);
+  --mv-interactive-primary-hover: var(--vscode-textLink-activeForeground, #3794ff);
+  --mv-interactive-secondary: var(--vscode-textPreformat-foreground, #d7ba7d);
+  --mv-interactive-focus: var(--vscode-button-background, #0e639c);
+  --mv-interactive-focus-border: var(--vscode-focusBorder, #007fd4);
+  --mv-button-primary-bg: var(--vscode-button-background, #0e639c);
+  --mv-button-primary-fg: var(--vscode-button-foreground, #ffffff);
+  --mv-button-secondary-bg: var(--vscode-button-secondaryBackground, #5f6a79);
+  --mv-button-secondary-fg: var(--vscode-button-secondaryForeground, #ffffff);
+
+  /* Border Colors */
+  --mv-border-default: var(--vscode-panel-border, #454545); 
+  --mv-border-primary: var(--vscode-editorGroup-border, #454545);
+  --mv-border-hover: var(--vscode-list-hoverBackground, #2a2d2e);
+  --mv-border-input: var(--vscode-input-border, #454545);
+  --mv-border-focus: var(--vscode-focusBorder, #007fd4);
+  --mv-border-dropdown: var(--vscode-dropdown-border, #454545);
+
+  /* Status Colors */
+  --mv-status-error: var(--vscode-errorForeground, #f14c4c);
+  --mv-status-error-bg: var(--vscode-inputValidation-errorBackground, #5a1d1d);
+  --mv-status-error-border: var(--vscode-inputValidation-errorBorder, #be1100);
+  --mv-status-success: var(--vscode-terminal-ansiGreen, #23d18b);
+
+  /* Accent Colors */
+  --mv-accent-cyan: var(--vscode-terminal-ansiCyan, #11b7ee);
+  --mv-accent-cyan-light: var(--vscode-debugTokenExpression-name, #9cdcfe);
+  --mv-accent-yellow: var(--vscode-terminal-ansiYellow, #ffb454);
+
+  /* Shadows & Effects */
+  --mv-shadow-light: rgba(0, 0, 0, 0.1);
+  --mv-shadow-medium: rgba(0, 0, 0, 0.15);
+  --mv-shadow-heavy: rgba(0, 0, 0, 0.3);
+  --mv-shadow-text: rgba(0, 0, 0, 0.4);
+  --mv-bg-overlay: var(--vscode-widget-background, rgba(37, 37, 38, 0.8));
+
+  /* Typography */
+  --mv-font-family: var(--vscode-font-family, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif);
+  --mv-font-family-mono: var(--vscode-editor-font-family, 'SF Mono', Monaco, 'Cascadia Code', 'Roboto Mono', Consolas, 'Courier New', monospace);
+  --mv-font-size-xs: 0.75rem;
+  --mv-font-size-sm: 0.875rem;
+  --mv-font-size-base: 1rem;
+  --mv-font-size-lg: 1.125rem;
+  --mv-font-size-xl: 1.25rem;
+  --mv-font-size-2xl: 1.5rem;
+  --mv-font-size-3xl: 1.875rem;
+  --mv-font-weight-normal: 400;
+  --mv-font-weight-medium: 500;
+  --mv-font-weight-semibold: 600;
+  --mv-font-weight-bold: 700;
+  --mv-line-height-tight: 1.25;
+  --mv-line-height-normal: 1.5;
+  --mv-line-height-relaxed: 1.75;
+
+  /* Spacing */
+  --mv-spacing-xs: 0.25rem;
+  --mv-spacing-sm: 0.5rem;
+  --mv-spacing-md: 1rem;
+  --mv-spacing-lg: 1.5rem;
+  --mv-spacing-xl: 2rem;
+  --mv-spacing-2xl: 3rem;
+  --mv-spacing-3xl: 4rem;
+
+  /* Shadows */
+  --mv-shadow-sm: 0 1px 2px 0 rgba(0, 0, 0, 0.05);
+  --mv-shadow-md: 0 4px 6px -1px rgba(0, 0, 0, 0.1), 0 2px 4px -1px rgba(0, 0, 0, 0.06);
+  --mv-shadow-lg: 0 10px 15px -3px rgba(0, 0, 0, 0.1), 0 4px 6px -2px rgba(0, 0, 0, 0.05);
+  --mv-shadow-xl: 0 20px 25px -5px rgba(0, 0, 0, 0.1), 0 10px 10px -5px rgba(0, 0, 0, 0.04);
+
+  /* Border Radius */
+  --mv-radius-none: 0;
+  --mv-radius-sm: 0.125rem;
+  --mv-radius-md: 0.25rem;
+  --mv-radius-lg: 0.5rem;
+  --mv-radius-xl: 0.75rem;
+  --mv-radius-full: 9999px;
+
+  /* Transitions */
+  --mv-transition-fast: 150ms ease;
+  --mv-transition-base: 250ms ease;
+  --mv-transition-slow: 350ms ease;
+
+  /* Layout */
+  --mv-container-max-width: 1200px;
+  --mv-content-max-width: 65ch;
+}
+
+/* ===== UTILITY CLASSES ===== */
+
+/* Layout */
+.mv-container {
+  width: 100%;
+  max-width: var(--mv-container-max-width);
+  margin: 0 auto;
+  padding: var(--mv-spacing-lg);
+}
+
+.mv-container-full {
+  width: 100%;
+  padding: var(--mv-spacing-lg);
+}
+
+.mv-flex {
+  display: flex;
+}
+
+.mv-flex-col {
+  display: flex;
+  flex-direction: column;
+}
+
+.mv-items-center {
+  align-items: center;
+}
+
+.mv-justify-between {
+  justify-content: space-between;
+}
+
+.mv-justify-center {
+  justify-content: center;
+}
+
+.mv-grid {
+  display: grid;
+}
+
+.mv-grid-cols-2 {
+  grid-template-columns: repeat(2, 1fr);
+}
+
+.mv-grid-cols-3 {
+  grid-template-columns: repeat(3, 1fr);
+}
+
+.mv-grid-cols-4 {
+  grid-template-columns: repeat(4, 1fr);
+}
+
+/* Gap */
+.mv-gap-xs { gap: var(--mv-spacing-xs); }
+.mv-gap-sm { gap: var(--mv-spacing-sm); }
+.mv-gap-md { gap: var(--mv-spacing-md); }
+.mv-gap-lg { gap: var(--mv-spacing-lg); }
+
+/* Padding */
+.mv-p-xs { padding: var(--mv-spacing-xs); }
+.mv-p-sm { padding: var(--mv-spacing-sm); }
+.mv-p-md { padding: var(--mv-spacing-md); }
+.mv-p-lg { padding: var(--mv-spacing-lg); }
+.mv-px-sm { padding-left: var(--mv-spacing-sm); padding-right: var(--mv-spacing-sm); }
+.mv-px-md { padding-left: var(--mv-spacing-md); padding-right: var(--mv-spacing-md); }
+.mv-py-sm { padding-top: var(--mv-spacing-sm); padding-bottom: var(--mv-spacing-sm); }
+.mv-py-md { padding-top: var(--mv-spacing-md); padding-bottom: var(--mv-spacing-md); }
+
+/* Margins */
+.mv-mb-sm { margin-bottom: var(--mv-spacing-sm); }
+.mv-mb-md { margin-bottom: var(--mv-spacing-md); }
+.mv-mb-lg { margin-bottom: var(--mv-spacing-lg); }
+.mv-mt-sm { margin-top: var(--mv-spacing-sm); }
+.mv-mt-md { margin-top: var(--mv-spacing-md); }
+
+/* Typography */
+.mv-text-xs {
+  font-size: var(--mv-font-size-xs);
+  line-height: var(--mv-line-height-normal);
+}
+
+.mv-text-sm {
+  font-size: var(--mv-font-size-sm);
+  line-height: var(--mv-line-height-normal);
+}
+
+.mv-text-base {
+  font-size: var(--mv-font-size-base);
+  line-height: var(--mv-line-height-normal);
+}
+
+.mv-text-lg {
+  font-size: var(--mv-font-size-lg);
+  line-height: var(--mv-line-height-normal);
+}
+
+.mv-text-xl {
+  font-size: var(--mv-font-size-xl);
+  line-height: var(--mv-line-height-tight);
+}
+
+.mv-text-2xl {
+  font-size: var(--mv-font-size-2xl);
+  line-height: var(--mv-line-height-tight);
+}
+
+.mv-font-medium { font-weight: var(--mv-font-weight-medium); }
+.mv-font-semibold { font-weight: var(--mv-font-weight-semibold); }
+.mv-font-bold { font-weight: var(--mv-font-weight-bold); }
+
+.mv-text-primary { color: var(--mv-text-primary); }
+.mv-text-secondary { color: var(--mv-text-secondary); }
+.mv-text-muted { color: var(--mv-text-muted); }
+.mv-text-error { color: var(--mv-status-error); }
+.mv-text-warning { color: var(--mv-status-warning); }
+.mv-text-success { color: var(--mv-status-success); }
+.mv-text-info { color: var(--mv-status-info); }
+
+.mv-text-center { text-align: center; }
+
+/* ===== COMPONENTS ===== */
+
+/* Cards */
+.mv-card {
+  background: var(--mv-bg-surface);
+  border: 1px solid var(--mv-border-default);
+  border-radius: var(--mv-radius-lg);
+  padding: var(--mv-spacing-lg);
+  box-shadow: var(--mv-shadow-sm);
+  transition: box-shadow var(--mv-transition-base);
+}
+
+.mv-card:hover {
+  box-shadow: var(--mv-shadow-md);
+}
+
+.mv-card-elevated {
+  background: var(--mv-bg-elevated);
+  box-shadow: var(--mv-shadow-lg);
+}
+
+/* Headers */
+.mv-header {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  padding: var(--mv-spacing-lg);
+  border-bottom: 1px solid var(--mv-border-default);
+  margin-bottom: var(--mv-spacing-lg);
+}
+
+.mv-header-title {
+  font-size: var(--mv-font-size-xl);
+  font-weight: var(--mv-font-weight-semibold);
+  color: var(--mv-text-primary);
+  margin: 0;
+  display: flex;
+  align-items: center;
+  gap: var(--mv-spacing-sm);
+}
+
+.mv-header-subtitle {
+  font-size: var(--mv-font-size-sm);
+  color: var(--mv-text-secondary);
+  margin-top: var(--mv-spacing-xs);
+}
+
+/* Buttons */
+.mv-button {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  gap: var(--mv-spacing-xs);
+  padding: var(--mv-spacing-sm) var(--mv-spacing-md);
+  border: none;
+  border-radius: var(--mv-radius-md);
+  font-family: var(--mv-font-family);
+  font-size: var(--mv-font-size-sm);
+  font-weight: var(--mv-font-weight-medium);
+  cursor: pointer;
+  transition: all var(--mv-transition-fast);
+  text-decoration: none;
+}
+
+.mv-button:focus-visible {
+  outline: 2px solid var(--mv-border-focus);
+  outline-offset: 2px;
+}
+
+.mv-button-primary {
+  background: var(--mv-button-primary-bg);
+  color: var(--mv-button-primary-fg);
+}
+
+.mv-button-primary:hover {
+  filter: brightness(1.1);
+}
+
+.mv-button-secondary {
+  background: var(--mv-button-secondary-bg);
+  color: var(--mv-button-secondary-fg);
+}
+
+.mv-button-outline {
+  background: transparent;
+  color: var(--mv-interactive-primary);
+  border: 1px solid var(--mv-border-default);
+}
+
+.mv-button-outline:hover {
+  background: var(--mv-bg-elevated);
+}
+
+.mv-button-sm {
+  padding: var(--mv-spacing-xs) var(--mv-spacing-sm);
+  font-size: var(--mv-font-size-xs);
+}
+
+/* Badges */
+.mv-badge {
+  display: inline-flex;
+  align-items: center;
+  padding: var(--mv-spacing-xs) var(--mv-spacing-sm);
+  background: var(--mv-bg-elevated);
+  color: var(--mv-text-primary);
+  font-size: var(--mv-font-size-xs);
+  font-weight: var(--mv-font-weight-medium);
+  border-radius: var(--mv-radius-full);
+  border: 1px solid var(--mv-border-default);
+}
+
+.mv-badge-primary {
+  background: var(--mv-interactive-primary);
+  color: var(--mv-text-inverse);
+  border-color: var(--mv-interactive-primary);
+}
+
+.mv-badge-error {
+  background: var(--mv-status-error);
+  color: var(--mv-text-inverse);
+  border-color: var(--mv-status-error);
+}
+
+.mv-badge-warning {
+  background: var(--mv-status-warning);
+  color: var(--mv-text-inverse);
+  border-color: var(--mv-status-warning);
+}
+
+.mv-badge-success {
+  background: var(--mv-status-success);
+  color: var(--mv-text-inverse);
+  border-color: var(--mv-status-success);
+}
+
+.mv-badge-info {
+  background: var(--mv-status-info);
+  color: var(--mv-text-inverse);
+  border-color: var(--mv-status-info);
+}
+
+/* Status dots */
+.mv-status-dot {
+  display: inline-block;
+  width: 8px;
+  height: 8px;
+  border-radius: var(--mv-radius-full);
+  background: var(--mv-text-muted);
+}
+
+.mv-status-dot-error { background: var(--mv-status-error); }
+.mv-status-dot-warning { background: var(--mv-status-warning); }
+.mv-status-dot-success { background: var(--mv-status-success); }
+.mv-status-dot-info { background: var(--mv-status-info); }
+
+/* Form elements */
+.mv-input {
+  width: 100%;
+  padding: var(--mv-spacing-sm) var(--mv-spacing-md);
+  background: var(--mv-bg-input);
+  border: 1px solid var(--mv-border-input);
+  border-radius: var(--mv-radius-md);
+  color: var(--mv-text-primary);
+  font-family: var(--mv-font-family);
+  font-size: var(--mv-font-size-sm);
+  transition: border-color var(--mv-transition-fast);
+}
+
+.mv-input:focus {
+  outline: none;
+  border-color: var(--mv-border-focus);
+}
+
+.mv-input::placeholder {
+  color: var(--mv-text-muted);
+}
+
+/* Lists */
+.mv-list {
+  display: flex;
+  flex-direction: column;
+  gap: var(--mv-spacing-xs);
+}
+
+.mv-list-item {
+  display: flex;
+  align-items: center;
+  gap: var(--mv-spacing-sm);
+  padding: var(--mv-spacing-sm);
+  border-radius: var(--mv-radius-md);
+  transition: background-color var(--mv-transition-fast);
+}
+
+.mv-list-item:hover {
+  background: var(--mv-bg-elevated);
+}
+
+/* Utilities */
+.mv-hidden {
+  display: none !important;
+}
+
+.mv-truncate {
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+/* Loading spinner */
+.mv-spinner {
+  display: inline-block;
+  width: 20px;
+  height: 20px;
+  border: 2px solid var(--mv-text-muted);
+  border-radius: 50%;
+  border-top-color: var(--mv-interactive-primary);
+  animation: mv-spin 1s ease-in-out infinite;
+}
+
+@keyframes mv-spin {
+  to { transform: rotate(360deg); }
+}
+
+/* Responsive */
+@media (max-width: 768px) {
+  .mv-container {
+    padding: var(--mv-spacing-md);
+  }
+
+  .mv-grid-cols-2,
+  .mv-grid-cols-3,
+  .mv-grid-cols-4 {
+    grid-template-columns: 1fr;
+  }
+}

package/dist/index.d.ts

@@ -19,4 +19,7 @@ export type { PluginInfo } from './types/PluginInfo.js';
 export type { PluginDataUpdateMessage } from './types/PluginDataUpdateMessage.js';
 export type { VisualizeOutcome } from './types/VisualizeOutcome.js';
 export type { WebAdapterOptions } from './types/WebAdapterOptions.js';
+export type { VisualizeMetadataOptions } from './WebVisualizationEngine.js';
+export { DESIGN_SYSTEM_THEMES, isDesignSystemTheme, } from '@salesforce/metadata-core-sdk/design-system';
+export type { DesignSystemTheme } from '@salesforce/metadata-core-sdk/design-system';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;IAKI;AAEJ;;;;;;;GAOG;AAGH,OAAO,EAAE,4BAA4B,EAAE,MAAM,mCAAmC,CAAC;AACjF,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAGrE,YAAY,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,YAAY,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAClF,YAAY,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACpE,YAAY,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;IAKI;AAEJ;;;;;;;GAOG;AAGH,OAAO,EAAE,4BAA4B,EAAE,MAAM,mCAAmC,CAAC;AACjF,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAGrE,YAAY,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,YAAY,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAClF,YAAY,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACpE,YAAY,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAGtE,YAAY,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AAC5E,OAAO,EACL,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,6CAA6C,CAAC;AACrD,YAAY,EAAE,iBAAiB,EAAE,MAAM,6CAA6C,CAAC"}

package/dist/index.js

@@ -15,4 +15,5 @@
 // Factory + engine.
 export { createWebVisualizationEngine } from './createWebVisualizationEngine.js';
 export { WebVisualizationEngine } from './WebVisualizationEngine.js';
+export { DESIGN_SYSTEM_THEMES, isDesignSystemTheme, } from '@salesforce/metadata-core-sdk/design-system';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +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"}
+{"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;AAWrE,OAAO,EACL,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,6CAA6C,CAAC"}

package/dist/pluginAssets/BundledPluginAssetReader.d.ts

@@ -4,6 +4,7 @@
  * 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 DesignSystemTheme } from '@salesforce/metadata-core-sdk/design-system';
 /**
  * Plugin asset reader for the web adapter.
  *
@@ -29,6 +30,6 @@ export declare class BundledPluginAssetReader {
     constructor(bundledRoot: string);
     readPluginIndexHtml(pluginId: string): Promise<string>;
     readPluginAsset(pluginId: string, relativePath: string): Promise<Uint8Array>;
-    readDesignSystemCss(): Promise<string>;
+    readDesignSystemCss(theme?: DesignSystemTheme): Promise<string>;
 }
 //# sourceMappingURL=BundledPluginAssetReader.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"BundledPluginAssetReader.d.ts","sourceRoot":"","sources":["../../src/pluginAssets/BundledPluginAssetReader.ts"],"names":[],"mappings":"AAAA;;;;;IAKI;AAKJ,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,6CAA6C,CAAC;AAGrD;;;;;;;;;;;;;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,CAAC,KAAK,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC;CAiBtE"}

package/dist/pluginAssets/BundledPluginAssetReader.js

@@ -7,6 +7,7 @@
 import * as fs from 'node:fs/promises';
 import * as path from 'node:path';
 import { REACT_UI_DIR_NAME } from '@salesforce/metadata-core-sdk';
+import { designSystemCssFileName, } from '@salesforce/metadata-core-sdk/design-system';
 import { AssetNotFoundError, PluginNotFoundError } from '../errors/index.js';
 /**
  * Plugin asset reader for the web adapter.
@@ -50,13 +51,16 @@ export class BundledPluginAssetReader {
             throw mapEnoent(err, () => new AssetNotFoundError(pluginId, relativePath));
         }
     }
-    async readDesignSystemCss() {
-        const cssPath = path.join(this.bundledRoot, 'design-system', 'platform.css');
+    async readDesignSystemCss(theme) {
+        // Default (no theme) resolves to platform.css (the dark-fallback sheet);
+        // a named theme resolves to its composed sheet (e.g. light-design-system.css).
+        const fileName = designSystemCssFileName(theme);
+        const cssPath = path.join(this.bundledRoot, 'design-system', fileName);
         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})`));
+            throw mapEnoent(err, () => new Error(`Platform CSS for theme '${theme ?? 'default'}' not found in bundled dist (looked at ${cssPath})`));
         }
     }
 }

package/dist/pluginAssets/BundledPluginAssetReader.js.map

@@ -1 +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"}
+{"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,EACL,uBAAuB,GAExB,MAAM,6CAA6C,CAAC;AACrD,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,CAAC,KAAyB;QACjD,yEAAyE;QACzE,+EAA+E;QAC/E,MAAM,QAAQ,GAAG,uBAAuB,CAAC,KAAK,CAAC,CAAC;QAChD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,eAAe,EAAE,QAAQ,CAAC,CAAC;QACvE,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,CACH,IAAI,KAAK,CACP,2BAA2B,KAAK,IAAI,SAAS,0CAA0C,OAAO,GAAG,CAClG,CACJ,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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@salesforce/metadata-visualizer-web",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "Web/HTTP SDK for the Salesforce Metadata Visualizer framework. Lets any HTTP server plug a host-supplied IFileSystem into the framework and serve plugin visualizations.",
   "type": "module",
   "main": "./dist/index.js",
@@ -55,7 +55,7 @@
     "verify": "npm run lint && npm run typecheck && npm run build && npm run test"
   },
   "dependencies": {
-    "@salesforce/metadata-core-sdk": "^1.4.0",
+    "@salesforce/metadata-core-sdk": "^1.5.0",
     "@salesforce/metadata-visualizer-core": "^1.4.0"
   },
   "devDependencies": {