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

package/package.json

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

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

@@ -6,6 +6,7 @@ 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 {
@@ -93,17 +94,38 @@ export default class RedocReference extends LightningElement {
      */
     @api projectTitle: string | null = "All Reference";
 
+    /**
+     * Href to navigate to when the back link is clicked AND there is no
+     * usable referrer (e.g. the user opened the page directly in a fresh
+     * tab).
+     */
+    @api headerHref: string | null = null;
+
+    @api
+    get docContentType(): boolean {
+        return this._docContentType;
+    }
+    set docContentType(value: boolean | string) {
+        this._docContentType = normalizeBoolean(value);
+    }
+    private _docContentType = false;
+
     get specTitle(): string | null {
         return this.getSelectedReference()?.title ?? null;
     }
 
     /**
-     * Whether to show the project header (only for multi-spec reference sets).
+     * 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.projectTitle || this.specTitle);
+        return (
+            (isMultiSpecSet || this._docContentType) &&
+            !!(this.projectTitle || this.specTitle)
+        );
     }
 
     /**
@@ -116,6 +138,10 @@ export default class RedocReference extends LightningElement {
             window.location.href = referrerHref;
             return;
         }
+        if (this._docContentType && this.headerHref) {
+            window.location.href = this.headerHref;
+            return;
+        }
         const fallbackHref = this.getReferencesRootHref();
         if (fallbackHref) {
             window.location.href = fallbackHref;

package/src/modules/doc/unifiedContentLayout/unifiedContentLayout.css

@@ -1,3 +1,19 @@
 :host {
     display: block;
 }
+
+.content-type-docs doc-phase {
+    --doc-c-phase-top: calc(
+        var(--dx-g-global-header-height) + var(--dx-g-doc-header-height) +
+            var(--dx-g-spacing-xl)
+    );
+}
+
+@media screen and (max-width: 768px) {
+    .content-type-docs doc-phase {
+        --doc-c-phase-top: calc(
+            var(--dx-g-global-header-height) + var(--dx-g-doc-header-height) +
+                40px
+        );
+    }
+}