@waveso/docs 0.6.0 → 0.7.1

package/dist/react/toc.js

@@ -3,7 +3,7 @@ import { DOCS_CONTENT_ID } from "../docs-content-id.js";
 import { useEffect, useMemo, useRef, useState } from "react";
 import { jsx, jsxs } from "react/jsx-runtime";
 //#region src/react/toc.tsx
-const DEFAULT_ROOT_MARGIN = "-80px 0px -60% 0px";
+const DEFAULT_ROOT_MARGIN = "0px 0px -60% 0px";
 /**
 * How many frames to keep looking for headings that are not in the document
 * yet. ~1s at 60Hz, which covers a `<Suspense>` boundary resolving or a
@@ -86,15 +86,22 @@ function DocsToc({ entries, label = "On this page", rootMargin = DEFAULT_ROOT_MA
 	return /* @__PURE__ */ jsxs("nav", {
 		"aria-label": label,
 		className: ["wave-docs-toc", className].filter(Boolean).join(" "),
-		children: [/* @__PURE__ */ jsx(TocList, {
-			entries,
-			activeId,
-			onSelect: setActiveId
-		}), /* @__PURE__ */ jsx("a", {
-			className: "wave-docs-toc__top",
-			href: `#${DOCS_CONTENT_ID}`,
-			children: topLabel
-		})]
+		children: [
+			/* @__PURE__ */ jsx("p", {
+				className: "wave-docs-toc__title",
+				children: label
+			}),
+			/* @__PURE__ */ jsx(TocList, {
+				entries,
+				activeId,
+				onSelect: setActiveId
+			}),
+			/* @__PURE__ */ jsx("a", {
+				className: "wave-docs-toc__top",
+				href: `#${DOCS_CONTENT_ID}`,
+				children: topLabel
+			})
+		]
 	});
 }
 function TocList({ entries, activeId, onSelect }) {

package/dist/render.js

@@ -431,7 +431,8 @@ function createDocsRenderer(options) {
 			relativePath: file.relativePath
 		};
 		const hast = await processor.run(processor.parse(vfile), vfile);
-		if (titleHeading && !hasHeadingOne(hast)) hast.children.unshift(titleHeadingNode(file.frontmatter.title));
+		const hasHero = (file.frontmatter.actions?.length ?? 0) > 0;
+		if (titleHeading && !hasHero && !hasHeadingOne(hast)) hast.children.unshift(titleHeadingNode(file.frontmatter.title));
 		await resolveImages(hast, file, imageResolver);
 		assertLinks(file, vfile.data.docLinks ?? []);
 		assertOwnAnchors(file, hast, vfile.data.docLinks ?? []);

package/dist/source.js

@@ -18,7 +18,7 @@ const INDEX_NAME = "index";
 * ⚠️ THE SCAN USED TO OPEN EVERY MARKDOWN FILE AT ONCE. `scanDir` recursed into
 * its subdirectories in parallel and read that directory's pages with a bare
 * `Promise.all`, so the number of `readFile` calls in flight equalled the number
-* of markdown files in the entire tree. On a 1,200-page corpus and the common
+* of markdown files in the entire tree. On a 1,201-page corpus and the common
 * 1,024-descriptor soft limit, `next build` died with a bare `EMFILE: too many
 * open files` — no error code, no mention that this was the docs scan, and
 * nothing pointing at the fix. Exactly the large content set this package is