@salesforcedevs/docs-components 1.18.8-specfix-alpha → 1.18.9-rnb-scroll3

package/package.json

@@ -1,11 +1,16 @@
 {
     "name": "@salesforcedevs/docs-components",
-    "version": "1.18.8-specfix-alpha",
+    "version": "1.18.9-rnb-scroll3",
     "description": "Docs Lightning web components for DSC",
     "license": "MIT",
     "main": "index.js",
     "engines": {
-        "node": "20.x"
+        "node": "20.x",
+        "yarn": "1.22.19"
+    },
+    "volta": {
+        "node": "20.19.0",
+        "yarn": "1.22.19"
     },
     "publishConfig": {
         "access": "public"

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

@@ -270,12 +270,14 @@ export default class ContentLayout extends LightningElement {
 
             // Adjusting the right nav bar on scroll.
             if (rightNavBarEl) {
-                rightNavBarEl.style.top = docPhaseEl
-                    ? `${
-                          totalHeaderHeight +
-                          docPhaseEl.getBoundingClientRect().height
-                      }px`
-                    : `${totalHeaderHeight}px`;
+                const docPhaseElHeight = docPhaseEl ? docPhaseEl.getBoundingClientRect().height : 0;
+                const toc = rightNavBarEl.querySelector("dx-toc");
+                const listContainer = toc?.shadowRoot?.querySelector(".toc") as HTMLElement;
+                const viewportHeight = window.innerHeight;
+                const maxHeight = viewportHeight - (docPhaseElHeight + totalHeaderHeight);
+
+                rightNavBarEl.style.top = `${totalHeaderHeight + docPhaseElHeight}px`;
+                listContainer.style.maxHeight = `${maxHeight}px`;
             }
 
             // If doc phase element exists, we need to account for its sticky position. Mobile should include the sidebar height (since it becomes sticky aswell).

package/src/modules/doc/contentMedia/contentMedia.css

@@ -29,7 +29,7 @@
 
 .content-media-iframe {
     position: relative;
-    padding-bottom: calc(var(--aspect-ratio, 0.5625) * 100%);
+    padding-bottom: calc(var(--aspect-ratio, 0.5626) * 100%);
     height: 0;
 }
 

package/src/modules/doc/lwcContentLayout/lwcContentLayout.css

@@ -1 +1,9 @@
 @import "docHelpers/contentLayoutStyle";
+
+.fixed-right-nav-bar {
+    width: 180px;
+}
+
+.content-body-no-rnb {
+    max-width: 1220px;
+}

package/src/modules/doc/lwcContentLayout/lwcContentLayout.html

@@ -19,7 +19,7 @@
             <slot name="doc-phase"></slot>
             <slot name="version-banner"></slot>
             <div class="content-body-container">
-                <div class="content-body">
+                <div class={contentBodyClasses}>
                     <doc-breadcrumbs
                         lwc:if={showBreadcrumbs}
                         breadcrumbs={breadcrumbs}
@@ -29,7 +29,7 @@
                         lwc:if={shouldDisplayFeedback}
                     ></doc-sprig-survey>
                 </div>
-                <div lwc:if={showToc} class="right-nav-bar is-sticky">
+                <div lwc:if={showToc} class={rightNavBarClasses}>
                     <dx-toc
                         header={tocTitle}
                         options={tocOptions}

package/src/modules/doc/lwcContentLayout/lwcContentLayout.ts

@@ -1,4 +1,5 @@
 import ContentLayout from "doc/contentLayout";
+import cx from "classnames";
 
 const TOC_HEADER_TAG = "doc-heading";
 const RNB_BY_TAB = "docs-tab";
@@ -23,6 +24,18 @@ export default class LwcContentLayout extends ContentLayout {
         return this.rnbByTab;
     }
 
+    get rightNavBarClasses() {
+        return cx(
+            "right-nav-bar",
+            "is-sticky",
+            this.showTabBasedRNB && "fixed-right-nav-bar"
+        );
+    }
+
+    get contentBodyClasses() {
+        return cx("content-body", !this.showToc && "content-body-no-rnb");
+    }
+
     /**
      * Check if the main slot contains doc-specification-content
      * Uses caching to avoid repeated DOM queries

package/src/modules/docHelpers/contentLayoutStyle/contentLayoutStyle.css

@@ -74,7 +74,7 @@ dx-toc {
 
 .content-body {
     margin: var(--dx-g-spacing-md) 0 0;
-    max-width: 900px;
+    max-width: 1000px;
     flex: 1;
     width: 0;
 }