@salesforcedevs/docs-components 1.28.5-redoc-alpha5 → 1.28.5-redoc-alpha7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@salesforcedevs/docs-components",
-  "version": "1.28.5-redoc-alpha5",
+  "version": "1.28.5-redoc-alpha7",
   "description": "Docs Lightning web components for DSC",
   "license": "MIT",
   "main": "index.js",

package/src/modules/doc/amfReference/amfReference.ts

@@ -37,7 +37,7 @@ type NavigationItem = {
     isExpanded: boolean;
     children: ParsedMarkdownTopic[];
     isChildrenLoading: boolean;
-    renderWith?: string;
+    showForwardArrow?: boolean;
 };
 
 export default class AmfReference extends LightningElement {
@@ -499,7 +499,7 @@ export default class AmfReference extends LightningElement {
                     this.isExpandChildrenEnabled(amfConfig.id),
                 children: navItemChildren,
                 isChildrenLoading,
-                renderWith: this.resolveNavRenderWith(amfConfig)
+                showForwardArrow: this.resolveNavRenderWith(amfConfig)
             };
             this.parentReferenceUrls.push(amfConfig.href);
         }
@@ -507,21 +507,19 @@ export default class AmfReference extends LightningElement {
     }
 
     /**
-     * Determines the `renderWith` value forwarded to the sidebar. Honors any
-     * value set on the config; otherwise infers `"redoc"` for non-markdown
-     * references that have no AMF URL (i.e. those rendered by Redoc).
+     * Determines whether the sidebar tile should render a forward arrow for
+     * this reference. Honors `redoc` set on the config, and also infers it
+     * for non-markdown references that have no AMF URL (i.e. those rendered
+     * by Redoc).
      */
-    private resolveNavRenderWith(amfConfig: AmfConfig): string | undefined {
+    private resolveNavRenderWith(amfConfig: AmfConfig): boolean {
         if (amfConfig.renderWith) {
-            return amfConfig.renderWith;
+            return amfConfig.renderWith === "redoc";
         }
-        if (
+        return (
             amfConfig.referenceType !== REFERENCE_TYPES.markdown &&
             !amfConfig.amf
-        ) {
-            return "redoc";
-        }
-        return undefined;
+        );
     }
 
     /**

package/src/modules/doc/redocReference/redocReference.ts

@@ -37,7 +37,7 @@ type ReferenceConfig = {
 const SCROLL_THROTTLE_DELAY = 50;
 const ELEMENT_TIMEOUT = 10000;
 const ELEMENT_CHECK_INTERVAL = 100;
-const REFERENCES_SEGMENT = "/references";
+const REFERENCES_SEGMENT = "/references/";
 
 export default class RedocReference extends LightningElement {
     private _referenceConfig: ReferenceConfig = { refList: [] };
@@ -93,16 +93,8 @@ export default class RedocReference extends LightningElement {
      */
     @api projectTitle: string | null = "All Reference";
 
-    private _specTitle: string | null = null;
-
-    /** Title of the currently selected spec, shown beneath the project title. */
-    @api
     get specTitle(): string | null {
-        return this._specTitle || this.getSelectedReference()?.title || null;
-    }
-
-    set specTitle(value: string | null) {
-        this._specTitle = value || null;
+        return this.getSelectedReference()?.title ?? null;
     }
 
     /**
@@ -119,8 +111,9 @@ export default class RedocReference extends LightningElement {
      */
     private onBackClick = (event: Event): void => {
         event.preventDefault();
-        if (this.cameFromSameOriginPage()) {
-            window.history.back();
+        const referrerHref = this.getSameOriginReferrerHref();
+        if (referrerHref) {
+            window.location.href = referrerHref;
             return;
         }
         const fallbackHref = this.getReferencesRootHref();
@@ -130,19 +123,23 @@ export default class RedocReference extends LightningElement {
     };
 
     /**
-     * Returns true only when the page was reached via in-tab navigation from
-     * a same-origin page, so `history.back()` is safe to call. Checks both
-     * `initialHistoryLength` and `document.referrer` since neither signal is
-     * reliable on its own.
+     * Returns the referrer URL when the page was reached via in-tab navigation
+     * from a same-origin page; otherwise `null`. Both `initialHistoryLength`
+     * and `document.referrer` are checked since neither signal is reliable on
+     * its own.
      */
-    private cameFromSameOriginPage(): boolean {
+    private getSameOriginReferrerHref(): string | null {
         if (this.initialHistoryLength <= 1 || !document.referrer) {
-            return false;
+            return null;
         }
         try {
-            return new URL(document.referrer).origin === window.location.origin;
+            const referrerUrl = new URL(document.referrer);
+            if (referrerUrl.origin !== window.location.origin) {
+                return null;
+            }
+            return referrerUrl.href;
         } catch {
-            return false;
+            return null;
         }
     }