@salesforce/ui-theme-manager 11.62.1 → 11.64.0

package/dist/runtime/previewContent.d.cts

@@ -1,9 +1,9 @@
 import { Brand } from '../protocol/brandTypes.cjs';
 import { Theme } from '../protocol/types.cjs';
 /**
- * Generates a complete HTML preview page showcasing a theme applied to a
- * luxury hotel landing page. All styling uses --tm-* CSS custom properties
- * that map to the theme protocol.
+ * Generates a complete HTML preview page showcasing a theme as a compact,
+ * self-contained "live snapshot" brand card. All styling uses --tm-* CSS
+ * custom properties that map to the theme protocol.
  *
  * The page is host-agnostic and communicates only via window.postMessage
  * using the typed protocol message constants.
@@ -20,17 +20,24 @@ export interface PreviewOptions {
     nonce?: string;
     /** CSP source for webview (e.g., webview.cspSource) */
     cspSource?: string;
-    /** Image URIs for brand preview sections (optional) */
-    imageUris?: {
-        hero?: string;
-        section3Left?: string;
-        section4Right?: string;
-    };
+    /**
+     * Omit the in-document runtime `<script>` tag entirely.
+     *
+     * Set this when the document is embedded as a nested `<iframe srcdoc>` whose
+     * live updates are driven from the parent frame (e.g. the VS Code extension
+     * writes `--tm-*` variables into the same-origin `contentDocument` via CSSOM).
+     * In that setup the runtime script isn't just unused — a `vscode-resource`
+     * script URL referenced from inside a `srcdoc` iframe can't be resolved by the
+     * webview's service worker, so it 404s and logs "Could not resolve webview id".
+     * Top-level webview panels (e.g. the full-preview page) leave this off so their
+     * runtime script executes normally.
+     */
+    omitRuntimeScript?: boolean;
 }
 /**
- * Generates a complete HTML preview page showcasing a Brand applied to a
- * luxury hotel landing page. All styling uses --tm-* CSS custom properties
- * that map to the Brand protocol.
+ * Generates a complete HTML preview page showcasing a Brand as a compact,
+ * self-contained "live snapshot" brand card. All styling uses --tm-* CSS
+ * custom properties that map to the Brand protocol.
  *
  * The page is host-agnostic and communicates only via window.postMessage
  * using the typed protocol message constants.
@@ -40,4 +47,16 @@ export interface PreviewOptions {
  * @returns Complete HTML document string
  */
 export declare function getBrandPreviewHtml(brand: Brand, options?: PreviewOptions): string;
+/**
+ * Generates the full-page "See full preview" document for a brand: a marketing
+ * landing page styled entirely by the brand's --tm-* tokens. Unlike the compact
+ * card (which the extension embeds in a nested srcdoc iframe), this is meant to
+ * open as its own top-level webview panel, so its runtime script executes and it
+ * receives live MSG_UPDATE_BRAND updates directly.
+ *
+ * @param brand - The brand to preview (will be resolved automatically)
+ * @param options - Optional host integration options (script URI, CSP nonce)
+ * @returns Complete HTML document string
+ */
+export declare function getBrandFullPreviewHtml(brand: Brand, options?: PreviewOptions): string;
 //# sourceMappingURL=previewContent.d.ts.map

package/dist/runtime/previewContent.d.ts

@@ -1,9 +1,9 @@
 import { Brand } from '../protocol/brandTypes.js';
 import { Theme } from '../protocol/types.js';
 /**
- * Generates a complete HTML preview page showcasing a theme applied to a
- * luxury hotel landing page. All styling uses --tm-* CSS custom properties
- * that map to the theme protocol.
+ * Generates a complete HTML preview page showcasing a theme as a compact,
+ * self-contained "live snapshot" brand card. All styling uses --tm-* CSS
+ * custom properties that map to the theme protocol.
  *
  * The page is host-agnostic and communicates only via window.postMessage
  * using the typed protocol message constants.
@@ -20,17 +20,24 @@ export interface PreviewOptions {
     nonce?: string;
     /** CSP source for webview (e.g., webview.cspSource) */
     cspSource?: string;
-    /** Image URIs for brand preview sections (optional) */
-    imageUris?: {
-        hero?: string;
-        section3Left?: string;
-        section4Right?: string;
-    };
+    /**
+     * Omit the in-document runtime `<script>` tag entirely.
+     *
+     * Set this when the document is embedded as a nested `<iframe srcdoc>` whose
+     * live updates are driven from the parent frame (e.g. the VS Code extension
+     * writes `--tm-*` variables into the same-origin `contentDocument` via CSSOM).
+     * In that setup the runtime script isn't just unused — a `vscode-resource`
+     * script URL referenced from inside a `srcdoc` iframe can't be resolved by the
+     * webview's service worker, so it 404s and logs "Could not resolve webview id".
+     * Top-level webview panels (e.g. the full-preview page) leave this off so their
+     * runtime script executes normally.
+     */
+    omitRuntimeScript?: boolean;
 }
 /**
- * Generates a complete HTML preview page showcasing a Brand applied to a
- * luxury hotel landing page. All styling uses --tm-* CSS custom properties
- * that map to the Brand protocol.
+ * Generates a complete HTML preview page showcasing a Brand as a compact,
+ * self-contained "live snapshot" brand card. All styling uses --tm-* CSS
+ * custom properties that map to the Brand protocol.
  *
  * The page is host-agnostic and communicates only via window.postMessage
  * using the typed protocol message constants.
@@ -40,4 +47,16 @@ export interface PreviewOptions {
  * @returns Complete HTML document string
  */
 export declare function getBrandPreviewHtml(brand: Brand, options?: PreviewOptions): string;
+/**
+ * Generates the full-page "See full preview" document for a brand: a marketing
+ * landing page styled entirely by the brand's --tm-* tokens. Unlike the compact
+ * card (which the extension embeds in a nested srcdoc iframe), this is meant to
+ * open as its own top-level webview panel, so its runtime script executes and it
+ * receives live MSG_UPDATE_BRAND updates directly.
+ *
+ * @param brand - The brand to preview (will be resolved automatically)
+ * @param options - Optional host integration options (script URI, CSP nonce)
+ * @returns Complete HTML document string
+ */
+export declare function getBrandFullPreviewHtml(brand: Brand, options?: PreviewOptions): string;
 //# sourceMappingURL=previewContent.d.ts.map

package/dist/runtime/previewContent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"previewContent.d.ts","sourceRoot":"","sources":["../../src/runtime/previewContent.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAGpD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAY/C;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,MAAM,CAG7E;AAED,MAAM,WAAW,cAAc;IAC9B,oFAAoF;IACpF,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uDAAuD;IACvD,SAAS,CAAC,EAAE;QACX,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,aAAa,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;CACF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,MAAM,CAIlF"}
+{"version":3,"file":"previewContent.d.ts","sourceRoot":"","sources":["../../src/runtime/previewContent.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAGpD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAY/C;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,MAAM,CAG7E;AAED,MAAM,WAAW,cAAc;IAC9B,oFAAoF;IACpF,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;;;;;;OAWG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,MAAM,CAIlF;AA+WD;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,MAAM,CAItF"}