@salesforcedevs/docs-components 1.19.3-latest-alpha → 1.19.6-alpha1

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@salesforcedevs/docs-components",
-    "version": "1.19.3-latest-alpha",
+    "version": "1.19.6-alpha1",
     "description": "Docs Lightning web components for DSC",
     "license": "MIT",
     "main": "index.js",

package/src/modules/doc/componentPlayground/componentPlayground.css

@@ -10,11 +10,26 @@
  * Total: 606px
 **/
 
+:host {
+    --playground-iframe-min-height: 500px;
+    --playground-iframe-max-height: 5000px;
+
+    margin-top: var(--dx-g-spacing-md) !important;
+    display: block !important;
+}
+
 iframe {
     width: 100%;
     height: 606px;
-    border-radius: var(--dx-g-spacing-sm);
-    border: 1px solid var(--dx-g-gray-90);
+    min-height: var(--playground-iframe-min-height);
+    max-height: var(--playground-iframe-max-height);
+    transition: height 0.3s ease, min-height 0.3s ease;
+}
+
+@media (prefers-reduced-motion: reduce) {
+    iframe {
+        transition: none;
+    }
 }
 
 .playground-container {

package/src/modules/doc/componentPlayground/componentPlayground.ts

@@ -1,5 +1,8 @@
 import { LightningElement, api } from "lwc";
 
+const PLAYGROUND_HEIGHT_MESSAGE = "PLAYGROUND_HEIGHT_CHANGE";
+const LOADER_TIMEOUT_MS = 2000;
+
 export default class ComponentPlayground extends LightningElement {
     @api model!: string;
     @api namespace!: string;
@@ -36,7 +39,59 @@ export default class ComponentPlayground extends LightningElement {
         }/${this.component.toLowerCase()}.html`;
     }
 
+    connectedCallback() {
+        window.addEventListener("message", this.handleIframeMessage);
+    }
+
+    disconnectedCallback() {
+        window.removeEventListener("message", this.handleIframeMessage);
+    }
+
     handleIframeLoad() {
-        this.isLoading = false;
+        if (!window.ResizeObserver) {
+            // If ResizeObserver not supported, hide loader immediately (no height messages will come)
+            this.isLoading = false;
+        } else {
+            // Hide loader after 2 seconds if no height messages received
+            // This handles cases where iframe fails to load, crashes, or height reporting fails
+            setTimeout(() => {
+                this.isLoading = false;
+            }, LOADER_TIMEOUT_MS);
+        }
     }
+
+    handleIframeMessage = (event: MessageEvent) => {
+        // Only handle height change messages from our iframe
+        if (event.data?.type !== PLAYGROUND_HEIGHT_MESSAGE) {
+            return;
+        }
+
+        const iframe = this.template.querySelector(
+            "iframe"
+        ) as HTMLIFrameElement;
+        if (!iframe || event.source !== iframe.contentWindow) {
+            return;
+        }
+
+        const height = event.data?.height;
+        if (typeof height === "number" && height > 0) {
+            const minHeight = parseInt(
+                getComputedStyle(this.template.host).getPropertyValue(
+                    "--playground-iframe-min-height"
+                ),
+                10
+            );
+            const maxHeight = parseInt(
+                getComputedStyle(this.template.host).getPropertyValue(
+                    "--playground-iframe-max-height"
+                ),
+                10
+            );
+
+            const newHeight = Math.min(Math.max(height, minHeight), maxHeight);
+            iframe.style.height = `${newHeight}px`;
+            iframe.style.minHeight = `${newHeight}px`;
+            this.isLoading = false;
+        }
+    };
 }

package/src/modules/doc/contentLayout/contentLayout.html

@@ -1,6 +1,7 @@
 <template>
     <div class="content">
         <dx-sidebar-old
+            lwc:if={showSidebar}
             class="is-sticky left-nav-bar"
             trees={sidebarContent}
             value={sidebarValue}

package/src/modules/doc/contentLayout/contentLayout.ts

@@ -40,6 +40,7 @@ export default class ContentLayout extends LightningElement {
     @api devCenter: any;
     @api brand: any;
     @api emptyStateMessage?: string;
+    @api showSidebar?: boolean = false;
 
     // This is needed for now to prevent failing snapshot tests due to links in the footer
     @api showFooter = false;