@salesforcedevs/docs-components 1.34.0-docs-feedback-1 → 1.34.0-docs-feedback-2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@salesforcedevs/docs-components",
-  "version": "1.34.0-docs-feedback-1",
+  "version": "1.34.0-docs-feedback-2",
   "description": "Docs Lightning web components for DSC",
   "license": "MIT",
   "main": "index.js",

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

@@ -11,8 +11,10 @@ import type { OptionWithLink, TreeNode } from "typings/custom";
 const TOPIC_TYPE_SPEC = "spec";
 
 /**
- * Returns the parent's first direct child when it is a markdown content
- * page or undefined otherwise.
+ * 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];
@@ -23,11 +25,15 @@ function firstChildContentPage(node: TreeNode): TreeNode | undefined {
     const isSpec =
         (firstChild as { topicType?: string }).topicType === TOPIC_TYPE_SPEC;
     const isExternal = firstChild.link?.target === "_blank";
-    if (isSpec || isExternal || !firstChild.link?.href) {
+    if (isSpec || isExternal) {
         return undefined;
     }
 
-    return firstChild;
+    if (firstChild.link?.href) {
+        return firstChild;
+    }
+
+    return firstChildContentPage(firstChild);
 }
 
 /**
@@ -54,10 +60,10 @@ function decorateTopics(
             !!decorated.children?.length && !decorated.link?.href;
 
         if (isContentlessParent) {
+            decorated.redirectToChild = true;
             const firstChild = firstChildContentPage(topic);
             if (firstChild?.link) {
                 decorated.link = { ...firstChild.link };
-                decorated.redirectToChild = true;
             }
         }