@nswds/app 1.74.0 → 1.76.0

package/dist/index.d.cts

@@ -1192,19 +1192,20 @@ declare function Header({ children, sitename, navigation, version, hide, }: {
     };
 }): react_jsx_runtime.JSX.Element;
 
-type BaseProps$1 = React.ComponentPropsWithoutRef<'h1'>;
+type BaseProps$1 = React__default.ComponentPropsWithoutRef<'h1'>;
+type HeadingLevel = 1 | 2 | 3 | 4 | 5 | 6;
 type HeadingProps = ({
     display?: false;
     size?: 1 | 2 | 3 | 4 | 5 | 6;
     trim?: 'normal' | 'start' | 'end' | 'both';
-    level?: 1 | 2 | 3 | 4 | 5 | 6;
+    level?: HeadingLevel;
 } & BaseProps$1) | ({
     display: true;
     size?: 1 | 2 | 3 | 4;
-    level?: 1 | 2 | 3 | 4 | 5 | 6;
+    level?: HeadingLevel;
     trim?: 'normal' | 'start' | 'end' | 'both';
 } & BaseProps$1);
-declare function Heading({ className, trim, size, level, display, ...props }: HeadingProps): react_jsx_runtime.JSX.Element;
+declare function Heading({ className, trim, size, level, display, id: idProp, children, ...props }: HeadingProps): react_jsx_runtime.JSX.Element;
 
 declare const heroBannerVariants: (props?: ({
     variant?: "white" | "primary-800" | "grey-150" | "accent-800" | "primary-200" | null | undefined;

package/dist/index.d.ts

@@ -1192,19 +1192,20 @@ declare function Header({ children, sitename, navigation, version, hide, }: {
     };
 }): react_jsx_runtime.JSX.Element;
 
-type BaseProps$1 = React.ComponentPropsWithoutRef<'h1'>;
+type BaseProps$1 = React__default.ComponentPropsWithoutRef<'h1'>;
+type HeadingLevel = 1 | 2 | 3 | 4 | 5 | 6;
 type HeadingProps = ({
     display?: false;
     size?: 1 | 2 | 3 | 4 | 5 | 6;
     trim?: 'normal' | 'start' | 'end' | 'both';
-    level?: 1 | 2 | 3 | 4 | 5 | 6;
+    level?: HeadingLevel;
 } & BaseProps$1) | ({
     display: true;
     size?: 1 | 2 | 3 | 4;
-    level?: 1 | 2 | 3 | 4 | 5 | 6;
+    level?: HeadingLevel;
     trim?: 'normal' | 'start' | 'end' | 'both';
 } & BaseProps$1);
-declare function Heading({ className, trim, size, level, display, ...props }: HeadingProps): react_jsx_runtime.JSX.Element;
+declare function Heading({ className, trim, size, level, display, id: idProp, children, ...props }: HeadingProps): react_jsx_runtime.JSX.Element;
 
 declare const heroBannerVariants: (props?: ({
     variant?: "white" | "primary-800" | "grey-150" | "accent-800" | "primary-200" | null | undefined;

package/dist/index.js

@@ -17412,16 +17412,33 @@ function FormatToggle({ format, setFormat }) {
 
 // package.json
 var package_default = {
-  version: "1.73.0"};
+  version: "1.75.0"};
+var SluggerContext = React5__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__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 = 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))]",
@@ -17453,10 +17470,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 = 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__ */ jsx(
-    Element2,
+    Tag,
     {
       ...props,
+      id: computedId,
+      "data-anchor": true,
       className: clsx12(
         className,
         trimClasses[trim],
@@ -17465,7 +17491,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
     }
   );
 }
@@ -29856,9 +29883,12 @@ function useActiveSectionObserver(tableOfContents) {
   return currentSection;
 }
 function TableOfContents({ tableOfContents }) {
-  const [mounted, setMounted] = useState(false);
-  useEffect(() => setMounted(true), []);
-  const currentSection = useActiveSectionObserver(mounted ? tableOfContents : []);
+  const [ready, setReady] = useState(false);
+  useEffect(() => {
+    const raf = requestAnimationFrame(() => setReady(true));
+    return () => cancelAnimationFrame(raf);
+  }, []);
+  const currentSection = useActiveSectionObserver(ready ? tableOfContents : []);
   const isActive = useMemo(() => {
     const check = (section) => {
       if (section.id === currentSection) return true;
@@ -29866,8 +29896,8 @@ function TableOfContents({ tableOfContents }) {
     };
     return check;
   }, [currentSection]);
-  return /* @__PURE__ */ jsx("nav", { "aria-labelledby": "on-this-page-title", className: "w-56", suppressHydrationWarning: true, children: !mounted ? (
-    // lightweight placeholder to avoid layout shift (optional)
+  return /* @__PURE__ */ jsx("nav", { "aria-labelledby": "on-this-page-title", className: "w-56", suppressHydrationWarning: true, children: !ready ? (
+    // SSR + initial client paint: deterministic skeleton
     /* @__PURE__ */ jsxs("div", { "aria-hidden": true, className: "mt-3 space-y-2", children: [
       /* @__PURE__ */ jsx("div", { className: "h-4 w-40 animate-pulse rounded bg-black/10 dark:bg-white/10" }),
       /* @__PURE__ */ jsx("div", { className: "h-3 w-32 animate-pulse rounded bg-black/10 dark:bg-white/10" }),
@@ -30592,12 +30622,56 @@ function getHeadings(slugify = slugifyWithCounter()) {
 function usePageHeadings() {
   const [headings, setHeadings] = useState([]);
   const pathname = usePathname();
+  const observerRef = useRef(null);
+  const observedElRef = useRef(null);
   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;
 }