@salesforcedevs/docs-components 1.34.0 → 1.34.1-ai-toolbar-action-1

package/package.json

@@ -1,29 +1,30 @@
 {
-    "name": "@salesforcedevs/docs-components",
-    "version": "1.34.0",
-    "description": "Docs Lightning web components for DSC",
-    "license": "MIT",
-    "main": "index.js",
-    "engines": {
-        "node": "22.x"
-    },
-    "publishConfig": {
-        "access": "public"
-    },
-    "dependencies": {
-        "@api-components/amf-helper-mixin": "4.5.29",
-        "classnames": "2.5.1",
-        "dompurify": "3.2.4",
-        "kagekiri": "1.4.2",
-        "lodash.orderby": "4.6.0",
-        "lodash.uniqby": "4.7.0",
-        "query-string": "7.1.3",
-        "sentence-case": "3.0.4"
-    },
-    "devDependencies": {
-        "@types/classnames": "2.3.1",
-        "@types/lodash.orderby": "4.6.9",
-        "@types/lodash.uniqby": "4.7.9"
-    },
-    "gitHead": "db75cd19dd7a77fe4e09856439c4905c32e64d1f"
-}
+  "name": "@salesforcedevs/docs-components",
+  "version": "1.34.1-ai-toolbar-action-1",
+  "description": "Docs Lightning web components for DSC",
+  "license": "MIT",
+  "main": "index.js",
+  "engines": {
+    "node": "22.x"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@api-components/amf-helper-mixin": "4.5.29",
+    "classnames": "2.5.1",
+    "dompurify": "3.2.4",
+    "kagekiri": "1.4.2",
+    "lodash.orderby": "4.6.0",
+    "lodash.uniqby": "4.7.0",
+    "query-string": "7.1.3",
+    "sentence-case": "3.0.4"
+  },
+  "devDependencies": {
+    "@types/classnames": "2.3.1",
+    "@types/lodash.orderby": "4.6.9",
+    "@types/lodash.uniqby": "4.7.9"
+  },
+  "gitHead": "4629fdd9ca18a13480044ad43515b91945d16aad",
+  "stableVersion": "1.34.1"
+}

package/src/modules/doc/contentActionToolbar/contentActionToolbar.css

@@ -24,9 +24,76 @@
     background-color: var(--dx-g-gray-70);
 }
 
-@media screen and (max-width: 480px) {
-    .toolbar-button_copy-url,
-    .divider_copy-url {
-        display: none;
+.toolbar-button_view-markdown,
+.divider_view-markdown,
+.toolbar-button_view-llms,
+.divider_view-llms {
+    display: none;
+}
+
+.toolbar_no-markdown .toolbar-button_view-llms {
+    display: inline-flex;
+}
+
+.toolbar:not(.toolbar_no-markdown) .divider_menu {
+    display: none;
+}
+
+.menu-trigger-wrap {
+    position: relative;
+    display: inline-flex;
+}
+
+.menu-trigger {
+    --dx-c-button-custom-color: var(--dx-g-blue-vibrant-50);
+    --dx-c-button-custom-color-hover: var(--dx-g-blue-vibrant-30);
+}
+
+.menu-trigger::part(container) {
+    box-sizing: border-box;
+    width: var(--dx-g-spacing-xl);
+    height: var(--dx-g-spacing-xl);
+    padding: 0;
+    border: 2px solid var(--dx-g-blue-vibrant-50);
+    border-radius: var(--dx-g-spacing-xs);
+}
+
+.menu-trigger:hover::part(container),
+.menu-trigger[aria-expanded="true"]::part(container) {
+    border-color: var(--dx-g-blue-vibrant-30);
+}
+
+.menu-trigger-copied {
+    position: absolute;
+    bottom: 100%;
+    right: calc(-1 * var(--dx-g-spacing-xs));
+    margin-bottom: var(--dx-g-spacing-xs);
+    padding: var(--dx-g-spacing-2xs) var(--dx-g-spacing-sm);
+    background: var(--dx-g-gray-50);
+    color: white;
+    font-family: var(--dx-g-font-sans);
+    font-size: var(--dx-g-text-xs);
+    border-radius: 4px;
+    pointer-events: none;
+}
+
+@media screen and (min-width: 480px) {
+    .toolbar-button_view-markdown,
+    .divider_view-markdown {
+        display: inline-flex;
+    }
+
+    .toolbar:not(.toolbar_no-markdown) .divider_menu {
+        display: block;
+    }
+}
+
+@media screen and (min-width: 768px) {
+    .toolbar-button_view-llms {
+        display: inline-flex;
+    }
+
+    .toolbar:not(.toolbar_no-markdown) .divider_view-llms {
+        display: inline-flex;
     }
 }

package/src/modules/doc/contentActionToolbar/contentActionToolbar.html

@@ -1,53 +1,85 @@
 <template>
-    <div class="toolbar" lwc:if={markdownUrl}>
-        <dx-tooltip placement="top-right" label={copyMarkdownLabel}>
+    <div class={toolbarClass}>
+        <template lwc:if={hasMarkdown}>
+            <dx-tooltip placement="top-right" label={copyMarkdownTooltipLabel}>
+                <dx-button
+                    class="toolbar-button"
+                    variant="inline"
+                    size="small"
+                    icon-sprite="utility"
+                    icon-symbol="copy"
+                    icon-size="medium"
+                    icon-position="right"
+                    aria-label={copyMarkdownButtonText}
+                    onclick={handleCopyMarkdown}
+                >
+                    {copyMarkdownButtonText}
+                </dx-button>
+            </dx-tooltip>
+
+            <div class="divider divider_view-markdown"></div>
+
             <dx-button
-                class="toolbar-button"
+                class="toolbar-button toolbar-button_view-markdown"
                 variant="inline"
                 size="small"
                 icon-sprite="utility"
-                icon-symbol="copy"
+                icon-symbol="new_window"
                 icon-size="medium"
                 icon-position="right"
-                aria-label={copyMarkdownButtonText}
-                onclick={handleCopyMarkdown}
+                aria-label={viewMarkdownButtonText}
+                onclick={handleViewMarkdown}
             >
-                {copyMarkdownButtonText}
+                {viewMarkdownButtonText}
             </dx-button>
-        </dx-tooltip>
+        </template>
 
-        <div class="divider"></div>
+        <div class="divider divider_view-llms"></div>
 
         <dx-button
-            class="toolbar-button"
+            class="toolbar-button toolbar-button_view-llms"
             variant="inline"
             size="small"
             icon-sprite="utility"
             icon-symbol="new_window"
             icon-size="medium"
             icon-position="right"
-            aria-label={viewMarkdownButtonText}
-            onclick={handleViewMarkdown}
+            aria-label={viewLlmsButtonText}
+            onclick={handleViewLlms}
         >
-            {viewMarkdownButtonText}
+            {viewLlmsButtonText}
         </dx-button>
 
-        <div class="divider divider_copy-url"></div>
+        <div class="divider divider_menu"></div>
 
-        <dx-tooltip placement="top-right" label={copyUrlLabel}>
-            <dx-button
-                class="toolbar-button toolbar-button_copy-url"
-                variant="inline"
-                size="small"
-                icon-sprite="utility"
-                icon-symbol="link"
-                icon-size="medium"
-                icon-position="right"
-                aria-label={copyUrlButtonText}
-                onclick={handleCopyUrl}
+        <span class="menu-trigger-wrap">
+            <dx-tooltip placement="top-right" label={moreActionsLabel}>
+                <dx-dropdown
+                    class="toolbar-menu"
+                    options={menuOptions}
+                    placement="bottom-end"
+                    width-mode="fit-content"
+                    aria-label={moreActionsLabel}
+                    onchange={handleMenuSelect}
+                >
+                    <dx-button
+                        class="menu-trigger"
+                        variant="icon-only"
+                        size="small"
+                        icon-sprite="utility"
+                        icon-symbol="threedots"
+                        icon-size="medium"
+                        aria-label={moreActionsLabel}
+                    ></dx-button>
+                </dx-dropdown>
+            </dx-tooltip>
+            <span
+                class="menu-trigger-copied"
+                if:true={showCopiedFlash}
+                role="status"
             >
-                {copyUrlButtonText}
-            </dx-button>
-        </dx-tooltip>
+                {copiedLabel}
+            </span>
+        </span>
     </div>
 </template>

package/src/modules/doc/contentActionToolbar/contentActionToolbar.ts

@@ -1,14 +1,53 @@
 import { LightningElement, api } from "lwc";
+import cx from "classnames";
+import { OptionWithNested } from "typings/custom";
 import { track } from "dxUtils/analytics";
 
-const DEFAULT_COPY_TOOLTIP_LABEL = "Click to copy";
+const DEFAULT_TOOLTIP_LABEL = "Click to copy";
 const COPIED_TOOLTIP_LABEL = "Copied!";
-const COPIED_TOOLTIP_RESET_MS = 1000;
+const COPIED_RESET_MS = 1000;
 
 const ANALYTICS_CONTENT_CATEGORY = "content action toolbar";
+const MORE_ACTIONS_LABEL = "More actions";
+
 const COPY_MARKDOWN_LABEL = "Copy as Markdown";
 const VIEW_MARKDOWN_LABEL = "View as Markdown";
-const COPY_URL_LABEL = "Copy URL to Markdown";
+const COPY_MARKDOWN_URL_LABEL = "Copy URL to Markdown";
+const VIEW_LLMS_LABEL = "View llms.txt";
+const COPY_LLMS_URL_LABEL = "Copy URL to llms.txt";
+const OPEN_CHATGPT_LABEL = "Open in ChatGPT";
+const OPEN_CLAUDE_LABEL = "Open in Claude";
+const OPEN_PERPLEXITY_LABEL = "Open in Perplexity";
+
+const LLMS_TXT_PATH = "/docs/llms.txt";
+const CHATGPT_URL = "https://chatgpt.com/";
+const CLAUDE_URL = "https://claude.ai/new";
+const PERPLEXITY_URL = "https://www.perplexity.ai/search";
+
+const LLMS_TXT_CONTEXT_URL = "https://developer.salesforce.com/docs/llms.txt";
+
+const ACTION_COPY_MARKDOWN = "copy-markdown";
+const ACTION_VIEW_MARKDOWN = "view-markdown";
+const ACTION_COPY_MARKDOWN_URL = "copy-markdown-url";
+const ACTION_VIEW_LLMS = "view-llms";
+const ACTION_COPY_LLMS_URL = "copy-llms-url";
+const ACTION_OPEN_CHATGPT = "open-chatgpt";
+const ACTION_OPEN_CLAUDE = "open-claude";
+const ACTION_OPEN_PERPLEXITY = "open-perplexity";
+
+const AI_ASSISTANTS = [
+    {
+        action: ACTION_OPEN_CHATGPT,
+        base: CHATGPT_URL,
+        label: OPEN_CHATGPT_LABEL
+    },
+    { action: ACTION_OPEN_CLAUDE, base: CLAUDE_URL, label: OPEN_CLAUDE_LABEL },
+    {
+        action: ACTION_OPEN_PERPLEXITY,
+        base: PERPLEXITY_URL,
+        label: OPEN_PERPLEXITY_LABEL
+    }
+] as const;
 
 export default class ContentActionToolbar extends LightningElement {
     @api
@@ -23,17 +62,15 @@ export default class ContentActionToolbar extends LightningElement {
     }
     private _pageUrl?: string;
 
-    copyMarkdownLabel: string = DEFAULT_COPY_TOOLTIP_LABEL;
-    copyUrlLabel: string = DEFAULT_COPY_TOOLTIP_LABEL;
+    @api pageTitle?: string;
 
-    private copyTooltipResetTimeout: number | null = null;
+    copyMarkdownTooltipLabel: string = DEFAULT_TOOLTIP_LABEL;
+    copiedLabel: string | null = null;
 
-    /**
-     * Returns the `.md` equivalent of `pageUrl` with any hash and query
-     * string stripped, or `null` when `pageUrl` is not set or does not end
-     * with `.html`.
-     */
-    get markdownUrl(): string | null {
+    private copyMarkdownResetTimeout: number | null = null;
+    private menuCopiedResetTimeout: number | null = null;
+
+    private get absolutePageUrl(): string | null {
         if (!this.pageUrl) {
             return null;
         }
@@ -41,7 +78,15 @@ export default class ContentActionToolbar extends LightningElement {
         const url = new URL(this.pageUrl, window.location.href);
         url.hash = "";
         url.search = "";
+        return url.toString();
+    }
+
+    get markdownUrl(): string | null {
+        if (!this.absolutePageUrl) {
+            return null;
+        }
 
+        const url = new URL(this.absolutePageUrl);
         if (!url.pathname.endsWith(".html")) {
             return null;
         }
@@ -50,6 +95,45 @@ export default class ContentActionToolbar extends LightningElement {
         return url.toString();
     }
 
+    get llmsUrl(): string {
+        return new URL(LLMS_TXT_PATH, window.location.href).toString();
+    }
+
+    private buildAiAssistantUrl(base: string): string | null {
+        if (!this.absolutePageUrl) {
+            return null;
+        }
+
+        const title = this.pageTitle?.trim();
+        const intro = title
+            ? `I'm reading "${title}" at ${this.absolutePageUrl}.`
+            : `I'm reading ${this.absolutePageUrl}.`;
+
+        const url = new URL(base);
+        url.searchParams.set(
+            "q",
+            `${intro} Read this page so I can ask questions about it. ` +
+                `For broader context, see ${LLMS_TXT_CONTEXT_URL}`
+        );
+        return url.toString();
+    }
+
+    get hasMarkdown(): boolean {
+        return Boolean(this.markdownUrl);
+    }
+
+    get toolbarClass(): string {
+        return cx("toolbar", !this.hasMarkdown && "toolbar_no-markdown");
+    }
+
+    get moreActionsLabel(): string {
+        return MORE_ACTIONS_LABEL;
+    }
+
+    get showCopiedFlash(): boolean {
+        return this.copiedLabel !== null;
+    }
+
     get copyMarkdownButtonText(): string {
         return COPY_MARKDOWN_LABEL;
     }
@@ -58,98 +142,219 @@ export default class ContentActionToolbar extends LightningElement {
         return VIEW_MARKDOWN_LABEL;
     }
 
-    get copyUrlButtonText(): string {
-        return COPY_URL_LABEL;
+    get viewLlmsButtonText(): string {
+        return VIEW_LLMS_LABEL;
+    }
+
+    get menuOptions(): OptionWithNested[] {
+        const groups: OptionWithNested[] = [];
+
+        if (this.hasMarkdown) {
+            groups.push({
+                id: "this-page",
+                label: "This Page",
+                options: [
+                    {
+                        id: ACTION_COPY_MARKDOWN,
+                        label: COPY_MARKDOWN_LABEL,
+                        iconSprite: "utility",
+                        iconSymbol: "copy"
+                    },
+                    {
+                        id: ACTION_VIEW_MARKDOWN,
+                        label: VIEW_MARKDOWN_LABEL,
+                        iconSprite: "utility",
+                        iconSymbol: "new_window"
+                    },
+                    {
+                        id: ACTION_COPY_MARKDOWN_URL,
+                        label: COPY_MARKDOWN_URL_LABEL,
+                        iconSprite: "utility",
+                        iconSymbol: "link"
+                    },
+                    ...AI_ASSISTANTS.map(({ action, label }) => ({
+                        id: action,
+                        label,
+                        iconSprite: "utility",
+                        iconSymbol: "new_window"
+                    }))
+                ]
+            });
+        }
+
+        groups.push({
+            id: "all-documentation",
+            label: "All Documentation",
+            options: [
+                {
+                    id: ACTION_VIEW_LLMS,
+                    label: VIEW_LLMS_LABEL,
+                    iconSprite: "utility",
+                    iconSymbol: "new_window"
+                },
+                {
+                    id: ACTION_COPY_LLMS_URL,
+                    label: COPY_LLMS_URL_LABEL,
+                    iconSprite: "utility",
+                    iconSymbol: "link"
+                }
+            ]
+        });
+
+        return groups;
     }
 
     async handleCopyMarkdown(event: Event) {
+        if (await this.copyMarkdown(event)) {
+            this.flashCopyMarkdownTooltip();
+        }
+    }
+
+    handleViewMarkdown(event: Event) {
         if (!this.markdownUrl) {
             return;
         }
 
-        this.trackToolbarEvent(
-            event,
-            "custEv_linkClick",
-            COPY_MARKDOWN_LABEL,
-            this.markdownUrl
-        );
+        this.trackToolbarEvent(event, VIEW_MARKDOWN_LABEL, this.markdownUrl);
+        window.open(this.markdownUrl, "_blank", "noopener,noreferrer");
+    }
+
+    handleViewLlms(event: Event) {
+        this.trackToolbarEvent(event, VIEW_LLMS_LABEL, this.llmsUrl);
+        window.open(this.llmsUrl, "_blank", "noopener,noreferrer");
+    }
+
+    private handleOpenAiAssistant(
+        event: Event,
+        label: string,
+        url: string | null
+    ) {
+        if (!url) {
+            return;
+        }
+
+        this.trackToolbarEvent(event, label, url);
+        window.open(url, "_blank", "noopener,noreferrer");
+    }
+
+    async handleMenuSelect(event: CustomEvent) {
+        switch (event.detail) {
+            case ACTION_COPY_MARKDOWN:
+                if (await this.copyMarkdown(event)) {
+                    this.flashMenuCopied();
+                }
+                return;
+            case ACTION_VIEW_MARKDOWN:
+                this.handleViewMarkdown(event);
+                return;
+            case ACTION_COPY_MARKDOWN_URL:
+                await this.handleCopyMarkdownUrl(event);
+                return;
+            case ACTION_VIEW_LLMS:
+                this.handleViewLlms(event);
+                return;
+            case ACTION_COPY_LLMS_URL:
+                await this.handleCopyLlmsUrl(event);
+                return;
+            default: {
+                const assistant = AI_ASSISTANTS.find(
+                    ({ action }) => action === event.detail
+                );
+                if (assistant) {
+                    this.handleOpenAiAssistant(
+                        event,
+                        assistant.label,
+                        this.buildAiAssistantUrl(assistant.base)
+                    );
+                }
+            }
+        }
+    }
+
+    private async copyMarkdown(event: Event): Promise<boolean> {
+        if (!this.markdownUrl) {
+            return false;
+        }
+
+        this.trackToolbarEvent(event, COPY_MARKDOWN_LABEL, this.markdownUrl);
 
         try {
             const response = await fetch(this.markdownUrl);
             if (!response.ok) {
-                return;
+                return false;
             }
             const markdown = await response.text();
             await navigator.clipboard.writeText(markdown);
-            this.flashCopied("copyMarkdownLabel");
+            return true;
         } catch (error) {
             console.error(error);
+            return false;
         }
     }
 
-    handleViewMarkdown(event: Event) {
+    private async handleCopyMarkdownUrl(event: Event) {
         if (!this.markdownUrl) {
             return;
         }
 
         this.trackToolbarEvent(
             event,
-            "custEv_linkClick",
-            VIEW_MARKDOWN_LABEL,
+            COPY_MARKDOWN_URL_LABEL,
             this.markdownUrl
         );
 
-        window.open(this.markdownUrl, "_blank", "noopener,noreferrer");
-    }
-
-    async handleCopyUrl(event: Event) {
-        if (!this.markdownUrl) {
-            return;
+        try {
+            await navigator.clipboard.writeText(this.markdownUrl);
+            this.flashMenuCopied();
+        } catch (error) {
+            console.error(error);
         }
+    }
 
-        this.trackToolbarEvent(
-            event,
-            "custEv_linkClick",
-            COPY_URL_LABEL,
-            this.markdownUrl
-        );
+    private async handleCopyLlmsUrl(event: Event) {
+        this.trackToolbarEvent(event, COPY_LLMS_URL_LABEL, this.llmsUrl);
 
         try {
-            await navigator.clipboard.writeText(this.markdownUrl);
-            this.flashCopied("copyUrlLabel");
+            await navigator.clipboard.writeText(this.llmsUrl);
+            this.flashMenuCopied();
         } catch (error) {
             console.error(error);
         }
     }
 
-    private trackToolbarEvent(
-        event: Event,
-        eventName: "custEv_linkClick",
-        label: string,
-        url: string
-    ): void {
-        track(event.currentTarget!, eventName, {
+    private trackToolbarEvent(event: Event, label: string, url: string): void {
+        track(event.currentTarget!, "custEv_linkClick", {
             click_text: label,
             click_url: url,
             element_type: "button_link",
             element_title: label,
             content_category: ANALYTICS_CONTENT_CATEGORY,
             // Source page the CTA was clicked from; `click_url` above is the
-            // `.md` destination. Uses the same `page_path` expression as the
+            // destination. Uses the same `page_path` expression as the
             // amfReference doc_page_view events.
             page_path: window.location.pathname + window.location.search
         });
     }
 
-    private flashCopied(labelKey: "copyMarkdownLabel" | "copyUrlLabel") {
-        if (this.copyTooltipResetTimeout !== null) {
-            window.clearTimeout(this.copyTooltipResetTimeout);
+    private flashCopyMarkdownTooltip() {
+        if (this.copyMarkdownResetTimeout !== null) {
+            window.clearTimeout(this.copyMarkdownResetTimeout);
+        }
+        this.copyMarkdownTooltipLabel = COPIED_TOOLTIP_LABEL;
+        this.copyMarkdownResetTimeout = window.setTimeout(() => {
+            this.copyMarkdownTooltipLabel = DEFAULT_TOOLTIP_LABEL;
+            this.copyMarkdownResetTimeout = null;
+        }, COPIED_RESET_MS);
+    }
+
+    private flashMenuCopied() {
+        if (this.menuCopiedResetTimeout !== null) {
+            window.clearTimeout(this.menuCopiedResetTimeout);
         }
-        this[labelKey] = COPIED_TOOLTIP_LABEL;
-        this.copyTooltipResetTimeout = window.setTimeout(() => {
-            this.copyMarkdownLabel = DEFAULT_COPY_TOOLTIP_LABEL;
-            this.copyUrlLabel = DEFAULT_COPY_TOOLTIP_LABEL;
-            this.copyTooltipResetTimeout = null;
-        }, COPIED_TOOLTIP_RESET_MS);
+        this.copiedLabel = COPIED_TOOLTIP_LABEL;
+        this.menuCopiedResetTimeout = window.setTimeout(() => {
+            this.copiedLabel = null;
+            this.menuCopiedResetTimeout = null;
+        }, COPIED_RESET_MS);
     }
 }

package/src/modules/doc/contentActionToolbar/contentActionToolbarMocks.ts

@@ -40,7 +40,7 @@ export function interceptWindowOpenForContentActionToolbar() {
     const originalOpen = window.open.bind(window);
     window.open = ((url?: string | URL, target?: string, features?: string) => {
         const stringUrl = url?.toString() ?? "";
-        if (stringUrl.endsWith(".md")) {
+        if (stringUrl.endsWith(".md") || stringUrl.endsWith("/llms.txt")) {
             return originalOpen(DUMMY_MARKDOWN_DATA_URL, target, features);
         }
         return originalOpen(url ?? "", target, features);

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

@@ -307,9 +307,10 @@ export default class ContentLayout extends LightningElement {
         const toolbar = (this.contentActionToolbarElement ??
             createElement(CONTENT_ACTION_TOOLBAR_TAG, {
                 is: ContentActionToolbar
-            })) as HTMLElement & { pageUrl?: string };
+            })) as HTMLElement & { pageUrl?: string; pageTitle?: string };
 
         toolbar.pageUrl = this.sidebarValue;
+        toolbar.pageTitle = heading.textContent?.trim() || undefined;
 
         if (toolbar.previousElementSibling !== heading) {
             heading.parentNode?.insertBefore(toolbar, heading.nextSibling);

package/src/modules/doc/header/header.ts

@@ -74,6 +74,13 @@ export default class Header extends HeaderBase {
         return (this.hideDocHeader && !this.mobile) || this.showDocDivider;
     }
 
+    private get isDocsPath(): boolean {
+        return (
+            window.location.pathname.includes("/docs/") &&
+            window.location.pathname !== "/docs/apis"
+        );
+    }
+
     connectedCallback(): void {
         super.connectedCallback();
         this.tabletMatchMedia = window.matchMedia(
@@ -83,9 +90,7 @@ export default class Header extends HeaderBase {
         this.tabletMatchMedia.addEventListener("change", this.onTabletChange);
 
         if (
-            (!this.shouldHideHeader &&
-                window.location.pathname.includes("/docs/") &&
-                window.location.pathname !== "/docs/apis") ||
+            (!this.shouldHideHeader && this.isDocsPath) ||
             window.location.pathname ===
                 "/tableau/embedding-playground/overview" ||
             isStorybook()
@@ -109,6 +114,12 @@ export default class Header extends HeaderBase {
         );
     }
 
+    renderedCallback(): void {
+        if (this.hideDocHeader) {
+            this.shouldRender = !this.shouldHideHeader && this.isDocsPath;
+        }
+    }
+
     private onTabletChange = (e: MediaQueryListEvent | MediaQueryList) =>
         (this.tablet = e.matches);
 

package/src/modules/doc/unifiedContentLayout/unifiedContentLayout.ts

@@ -10,11 +10,38 @@ import type { OptionWithLink, TreeNode } from "typings/custom";
  */
 const TOPIC_TYPE_SPEC = "spec";
 
+/**
+ * Walks down the first-child chain and returns the first markdown content
+ * page found, descending through nested content-less parents. Returns
+ * undefined if the chain breaks on a spec or external link before reaching a
+ * content page.
+ */
+function firstChildContentPage(node: TreeNode): TreeNode | undefined {
+    const firstChild = node.children?.[0];
+    if (!firstChild) {
+        return undefined;
+    }
+
+    const isSpec =
+        (firstChild as { topicType?: string }).topicType === TOPIC_TYPE_SPEC;
+    const isExternal = firstChild.link?.target === "_blank";
+    if (isSpec || isExternal) {
+        return undefined;
+    }
+
+    if (firstChild.link?.href) {
+        return firstChild;
+    }
+
+    return firstChildContentPage(firstChild);
+}
+
 /**
  * Translates per-topic `topicType` into the generic `showForwardArrow` flag
- * that `dx-tree-tile` reads (spec topics get the forward arrow icon for Redoc).
+ * that `dx-tree-tile` reads (spec topics get the forward arrow icon for Redoc),
+ * and redirects content-less parent topics whose first child is a content page
  */
-function decorateTopicsWithForwardArrow(
+function decorateTopics(
     topics: Array<TreeNode & { topicType?: string }> | undefined
 ): TreeNode[] | undefined {
     return topics?.map((topic) => {
@@ -23,10 +50,23 @@ function decorateTopicsWithForwardArrow(
             decorated.showForwardArrow = true;
         }
         if (decorated.children) {
-            decorated.children = decorateTopicsWithForwardArrow(
-                decorated.children
-            );
+            decorated.children = decorateTopics(decorated.children);
         }
+
+        /** Redirect a parent that has no content of its own to its first child
+         * but only when that first child is itself a content page
+         */
+        const isContentlessParent =
+            !!decorated.children?.length && !decorated.link?.href;
+
+        if (isContentlessParent) {
+            decorated.redirectToChild = true;
+            const firstChild = firstChildContentPage(topic);
+            if (firstChild?.link) {
+                decorated.link = { ...firstChild.link };
+            }
+        }
+
         return decorated;
     });
 }
@@ -77,9 +117,7 @@ export default class UnifiedContentLayout extends LightningElement {
     }
 
     set sidebarContent(value: string) {
-        this._sidebarContent = decorateTopicsWithForwardArrow(
-            toJson(value)?.topics
-        );
+        this._sidebarContent = decorateTopics(toJson(value)?.topics);
     }
 
     private get enableFooter(): boolean {

package/LICENSE

@@ -1,12 +0,0 @@
-Copyright (c) 2020, Salesforce.com, Inc.
-All rights reserved.
-
-Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
-
-* Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
-
-* Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
-
-* Neither the name of Salesforce.com nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
-
-THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.