@nswds/app 1.74.0 → 1.76.0

package/dist/index.cjs

@@ -17465,16 +17465,33 @@ function FormatToggle({ format, setFormat }) {
 
 // package.json
 var package_default = {
-  version: "1.73.0"};
+  version: "1.75.0"};
+var SluggerContext = React5__namespace.default.createContext(null);
+function flattenText(nodes) {
+  if (nodes == null || typeof nodes === "boolean") return "";
+  if (typeof nodes === "string" || typeof nodes === "number" || typeof nodes === "bigint")
+    return String(nodes);
+  if (Array.isArray(nodes)) return nodes.map(flattenText).join("");
+  if (React5__namespace.default.isValidElement(nodes)) {
+    return flattenText(nodes.props.children);
+  }
+  return "";
+}
+function baseSlug(input) {
+  return input.toLowerCase().trim().replace(/[\s\W]+/g, "-").replace(/^-+|-+$/g, "");
+}
 function Heading({
   className,
   trim = "normal",
   size = 1,
   level = 1,
   display = false,
+  id: idProp,
+  children,
   ...props
 }) {
-  const Element2 = `h${level}`;
+  const Tag = `h${level}`;
+  const slugger = React5.useContext(SluggerContext);
   const headingSizeClasses = {
     1: "text-[calc(var(--heading-font-size-1)_*_var(--heading-font-size-adjust))] leading-[var(--line-height-52)] tracking-[calc(var(--heading-letter-spacing-2)_+_var(--heading-letter-spacing))]",
     2: "text-[calc(var(--heading-font-size-2)_*_var(--heading-font-size-adjust))] leading-[var(--line-height-44)] tracking-[calc(var(--heading-letter-spacing-2)_+_var(--heading-letter-spacing))]",
@@ -17506,10 +17523,19 @@ function Heading({
       "after:mt-[calc(var(--leading-trim-end,var(--default-leading-trim-end))-var(--line-height,calc(1em*var(--default-line-height)))/2)]"
     ]
   };
+  const computedId = React5.useMemo(() => {
+    if (idProp) return idProp;
+    const text = flattenText(children);
+    if (!text) return void 0;
+    const base = baseSlug(text);
+    return slugger ? slugger.slug(base) : base;
+  }, [idProp, children, slugger]);
   return /* @__PURE__ */ jsxRuntime.jsx(
-    Element2,
+    Tag,
     {
       ...props,
+      id: computedId,
+      "data-anchor": true,
       className: clsx12__default.default(
         className,
         trimClasses[trim],
@@ -17518,7 +17544,8 @@ function Heading({
         "[--leading-trim-end:var(--heading-leading-trim-end)] [--leading-trim-start:var(--heading-leading-trim-start)]",
         "text-primary-800 dark:text-white",
         sizeClass
-      )
+      ),
+      children
     }
   );
 }
@@ -29909,9 +29936,12 @@ function useActiveSectionObserver(tableOfContents) {
   return currentSection;
 }
 function TableOfContents({ tableOfContents }) {
-  const [mounted, setMounted] = React5.useState(false);
-  React5.useEffect(() => setMounted(true), []);
-  const currentSection = useActiveSectionObserver(mounted ? tableOfContents : []);
+  const [ready, setReady] = React5.useState(false);
+  React5.useEffect(() => {
+    const raf = requestAnimationFrame(() => setReady(true));
+    return () => cancelAnimationFrame(raf);
+  }, []);
+  const currentSection = useActiveSectionObserver(ready ? tableOfContents : []);
   const isActive = React5.useMemo(() => {
     const check = (section) => {
       if (section.id === currentSection) return true;
@@ -29919,8 +29949,8 @@ function TableOfContents({ tableOfContents }) {
     };
     return check;
   }, [currentSection]);
-  return /* @__PURE__ */ jsxRuntime.jsx("nav", { "aria-labelledby": "on-this-page-title", className: "w-56", suppressHydrationWarning: true, children: !mounted ? (
-    // lightweight placeholder to avoid layout shift (optional)
+  return /* @__PURE__ */ jsxRuntime.jsx("nav", { "aria-labelledby": "on-this-page-title", className: "w-56", suppressHydrationWarning: true, children: !ready ? (
+    // SSR + initial client paint: deterministic skeleton
     /* @__PURE__ */ jsxRuntime.jsxs("div", { "aria-hidden": true, className: "mt-3 space-y-2", children: [
       /* @__PURE__ */ jsxRuntime.jsx("div", { className: "h-4 w-40 animate-pulse rounded bg-black/10 dark:bg-white/10" }),
       /* @__PURE__ */ jsxRuntime.jsx("div", { className: "h-3 w-32 animate-pulse rounded bg-black/10 dark:bg-white/10" }),
@@ -30645,12 +30675,56 @@ function getHeadings(slugify$1 = slugify.slugifyWithCounter()) {
 function usePageHeadings() {
   const [headings, setHeadings] = React5.useState([]);
   const pathname = navigation.usePathname();
+  const observerRef = React5.useRef(null);
+  const observedElRef = React5.useRef(null);
   React5.useEffect(() => {
-    const timer = setTimeout(() => {
-      const result = getHeadings();
-      setHeadings(result);
-    }, 0);
-    return () => clearTimeout(timer);
+    const update = () => setHeadings(getHeadings());
+    const attachToCurrentArticle = () => {
+      const article = document.querySelector("article");
+      if (!article || observedElRef.current === article) return;
+      observerRef.current?.disconnect();
+      const obs = new MutationObserver(() => {
+        update();
+      });
+      obs.observe(article, {
+        childList: true,
+        subtree: true,
+        attributes: true,
+        attributeFilter: ["id"]
+      });
+      observerRef.current = obs;
+      observedElRef.current = article;
+      requestAnimationFrame(update);
+    };
+    attachToCurrentArticle();
+    const articleParent = document.querySelector("article")?.parentElement;
+    const rootObserver = new MutationObserver((mutations) => {
+      for (const mutation of mutations) {
+        for (const node of Array.from(mutation.addedNodes)) {
+          if (node.nodeType === Node.ELEMENT_NODE && node.tagName.toLowerCase() === "article") {
+            attachToCurrentArticle();
+            return;
+          }
+        }
+        for (const node of Array.from(mutation.removedNodes)) {
+          if (node.nodeType === Node.ELEMENT_NODE && node.tagName.toLowerCase() === "article") {
+            attachToCurrentArticle();
+            return;
+          }
+        }
+      }
+    });
+    if (articleParent) {
+      rootObserver.observe(articleParent, { childList: true });
+    } else {
+      rootObserver.observe(document.body, { childList: true });
+    }
+    return () => {
+      rootObserver.disconnect();
+      observerRef.current?.disconnect();
+      observerRef.current = null;
+      observedElRef.current = null;
+    };
   }, [pathname]);
   return headings;
 }