@salesforcedevs/docs-components 1.29.0-docspec-alpha → 1.29.0-docspec-alpha1

package/package.json

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

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

@@ -6,7 +6,6 @@ import DxIcon from "dx/icon";
 import SprigSurvey from "doc/sprigSurvey";
 import { throttle } from "throttle-debounce";
 import { pollUntil } from "dxUtils/async";
-import { normalizeBoolean } from "dxUtils/normalizers";
 
 declare global {
     interface Window {
@@ -92,7 +91,16 @@ export default class RedocReference extends LightningElement {
      * Project title (same value passed to `<doc-header>` as `subtitle`). Used
      * inside the Redoc-rendered UI to label the parent project.
      */
-    @api projectTitle: string | null = "All Reference";
+    @api
+    get projectTitle(): string | null {
+        return this._projectTitle;
+    }
+    set projectTitle(value: string | null) {
+        if (this.isDocContentType) {
+            this._projectTitle = value;
+        }
+    }
+    private _projectTitle: string | null = "All Reference";
 
     /**
      * Href to navigate to when the back link is clicked AND there is no
@@ -102,29 +110,40 @@ export default class RedocReference extends LightningElement {
     @api headerHref: string | null = null;
 
     @api
-    get docContentType(): boolean {
-        return this._docContentType;
+    get contentType(): string {
+        return this._contentType;
     }
-    set docContentType(value: boolean | string) {
-        this._docContentType = normalizeBoolean(value);
+    set contentType(value: string) {
+        this._contentType = value;
     }
-    private _docContentType = false;
+    private _contentType: string = "";
 
     get specTitle(): string | null {
         return this.getSelectedReference()?.title ?? null;
     }
 
+    get isDocContentType(): boolean {
+        return this.contentType === "docs";
+    }
+
+    get isReferenceContentType(): boolean {
+        return this.contentType === "references";
+    }
+
+    get isMultiSpecSet(): boolean {
+        const refCount = this.referenceConfig?.refList?.length ?? 0;
+        return refCount > 1;
+    }
+
     /**
      * Whether to show the project header. Shown for multi-spec reference
      * sets, and for any docs-content spec topic so it always has a back
      * link.
      */
     get showRedocHeader(): boolean {
-        const refCount = this._referenceConfig?.refList?.length ?? 0;
-        const isMultiSpecSet = refCount > 1;
         return (
-            (isMultiSpecSet || this._docContentType) &&
-            !!(this.projectTitle || this.specTitle)
+            (this.isReferenceContentType && this.isMultiSpecSet) ||
+            this.isDocContentType
         );
     }
 
@@ -138,7 +157,7 @@ export default class RedocReference extends LightningElement {
             window.location.href = referrerHref;
             return;
         }
-        if (this._docContentType && this.headerHref) {
+        if (this.headerHref) {
             window.location.href = this.headerHref;
             return;
         }