@dogsbay/docs-layout 0.2.0-beta.86 → 0.2.0-beta.88

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dogsbay/docs-layout",
-  "version": "0.2.0-beta.86",
+  "version": "0.2.0-beta.88",
   "description": "Standard documentation layout components for Dogsbay",
   "type": "module",
   "exports": {
@@ -29,8 +29,8 @@
     "./json-ld": "./src/json-ld.ts"
   },
   "dependencies": {
-    "@dogsbay/ui": "0.2.0-beta.86",
-    "@dogsbay/primitives": "0.2.0-beta.86"
+    "@dogsbay/primitives": "0.2.0-beta.88",
+    "@dogsbay/ui": "0.2.0-beta.88"
   },
   "devDependencies": {
     "vitest": "^3.0.0"

package/src/DocsLayout.astro

@@ -35,7 +35,7 @@ import DocsNavClient from "./DocsNavClient.astro";
 import Separator from "@dogsbay/ui/separator/Separator.astro";
 import ThemeToggle from "@dogsbay/ui/theme-toggle/ThemeToggle.astro";
 import DocsToc from "./DocsToc.astro";
-import { resolveTocPlacement, type TocMode } from "./toc-placement.js";
+import { resolveTocPlacement, hasDisplayableToc, type TocMode } from "./toc-placement.js";
 import DocsFooter from "./DocsFooter.astro";
 import SearchDialog from "./SearchDialog.astro";
 import TagList from "./TagList.astro";
@@ -528,7 +528,10 @@ const hasMetaStrip = (
 // TOC placement: which container(s) + the right-rail plugin region render.
 // Logic lives in toc-placement.ts so it's unit-tested; this file just consumes.
 const tocPlacement = resolveTocPlacement(toc, {
-  hasHeadings: headings.length > 0,
+  // Only show a TOC when the page has 2+ displayable headings (depth 2–3);
+  // the H1 doesn't count and a one-item TOC is noise. Keeps "On this page"
+  // off landing/welcome pages that are just an H1 + prose.
+  hasHeadings: hasDisplayableToc(headings),
   wideLayout: !!wideLayout,
 });
 
@@ -1012,7 +1015,7 @@ const siteIcon = '<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16"
               Hidden when nothing fills it (see the empty-rail style below). */}
           {tocPlacement.regionRail && (
             <aside
-              class="dba-right-rail sticky top-12 hidden h-[calc(100vh-3rem)] w-56 shrink-0 overflow-y-auto border-l p-4 lg:block"
+              class="dba-right-rail sticky top-12 hidden h-[calc(100vh-3rem)] w-80 shrink-0 overflow-y-auto border-l p-4 lg:block xl:w-96"
               data-right-rail
             >
               <slot name="right-rail" />

package/src/toc-placement.ts

@@ -25,6 +25,26 @@ export interface TocPlacement {
   regionRail: boolean;
 }
 
+/**
+ * Whether a page has enough displayable headings to warrant a TOC. The TOC
+ * (`DocsToc`) only lists depth `minDepth`–`maxDepth` (2–3 by default), so the
+ * page H1 never counts; and a TOC of a single entry isn't useful, so require
+ * `min` (2) by default. Pages like a landing/welcome page — H1 + prose, no
+ * sub-sections — therefore get no "On this page".
+ */
+export function hasDisplayableToc(
+  headings: { depth: number }[],
+  opts: { minDepth?: number; maxDepth?: number; min?: number } = {},
+): boolean {
+  const { minDepth = 2, maxDepth = 3, min = 2 } = opts;
+  let count = 0;
+  for (const h of headings) {
+    if (h.depth >= minDepth && h.depth <= maxDepth) count++;
+    if (count >= min) return true;
+  }
+  return false;
+}
+
 export interface TocPlacementInput {
   /** Page has at least one heading to list. */
   hasHeadings: boolean;