@omnitron-dev/prism 0.3.0 → 0.3.2

package/dist/chunk-E7WM2RXA.js

@@ -0,0 +1,249 @@
+import Box from '@mui/material/Box';
+import { jsxs, jsx } from 'react/jsx-runtime';
+import { createContext, useContext, useState, useRef, useCallback, useEffect } from 'react';
+import Typography from '@mui/material/Typography';
+import { alpha } from '@mui/material/styles';
+
+// src/components/doc-layout/doc-layout.tsx
+function DocLayout({ sidebar, sectionNav, children, sx }) {
+  return /* @__PURE__ */ jsxs(
+    Box,
+    {
+      sx: {
+        display: "flex",
+        width: "100%",
+        ...sx
+      },
+      children: [
+        sidebar && /* @__PURE__ */ jsx(
+          Box,
+          {
+            component: "nav",
+            sx: {
+              width: 272,
+              flexShrink: 0,
+              display: { xs: "none", md: "block" },
+              position: "sticky",
+              top: 80,
+              alignSelf: "flex-start",
+              maxHeight: "calc(100vh - 100px)",
+              overflowY: "auto",
+              pr: 3,
+              borderRight: 1,
+              borderColor: "divider"
+            },
+            children: sidebar
+          }
+        ),
+        /* @__PURE__ */ jsx(
+          Box,
+          {
+            component: "main",
+            sx: {
+              flex: 1,
+              minWidth: 0,
+              px: { xs: 2, md: 4 }
+            },
+            children
+          }
+        ),
+        sectionNav && /* @__PURE__ */ jsx(
+          Box,
+          {
+            component: "aside",
+            sx: {
+              width: 240,
+              flexShrink: 0,
+              display: { xs: "none", lg: "block" },
+              position: "sticky",
+              top: 80,
+              alignSelf: "flex-start",
+              maxHeight: "calc(100vh - 100px)",
+              overflowY: "auto",
+              pl: 3
+            },
+            children: sectionNav
+          }
+        )
+      ]
+    }
+  );
+}
+var ScrollSpyContext = createContext({
+  activeId: null,
+  registerSection: () => {
+  },
+  unregisterSection: () => {
+  }
+});
+function useScrollSpy() {
+  return useContext(ScrollSpyContext);
+}
+function ScrollSpyProvider({
+  children,
+  offset = 80,
+  root = null,
+  headingSelector = "h1[id], h2[id], h3[id], h4[id], h5[id], h6[id]",
+  containerRef
+}) {
+  const [activeId, setActiveId] = useState(null);
+  const sectionsRef = useRef(/* @__PURE__ */ new Map());
+  const observerRef = useRef(null);
+  const wrapperRef = useRef(null);
+  const createObserver = useCallback(() => {
+    observerRef.current?.disconnect();
+    const observer = new IntersectionObserver(
+      (entries) => {
+        const visible = entries.filter((e) => e.isIntersecting).sort((a, b) => a.boundingClientRect.top - b.boundingClientRect.top);
+        if (visible.length > 0) {
+          setActiveId(visible[0].target.id);
+        }
+      },
+      {
+        root,
+        rootMargin: `-${offset}px 0px -60% 0px`,
+        threshold: 0
+      }
+    );
+    sectionsRef.current.forEach((element) => observer.observe(element));
+    observerRef.current = observer;
+  }, [offset, root]);
+  useEffect(() => {
+    if (!headingSelector) return void 0;
+    const timer = setTimeout(() => {
+      const container = containerRef?.current ?? wrapperRef.current;
+      if (!container) return;
+      const headings = container.querySelectorAll(headingSelector);
+      headings.forEach((heading) => {
+        if (heading.id) {
+          sectionsRef.current.set(heading.id, heading);
+        }
+      });
+      createObserver();
+    }, 100);
+    return () => {
+      clearTimeout(timer);
+      observerRef.current?.disconnect();
+    };
+  }, [headingSelector, containerRef, createObserver]);
+  useEffect(() => {
+    if (!headingSelector) return void 0;
+    const container = containerRef?.current ?? wrapperRef.current;
+    if (!container) return void 0;
+    const mutationObserver = new MutationObserver(() => {
+      const headings = container.querySelectorAll(headingSelector);
+      let changed = false;
+      headings.forEach((heading) => {
+        if (heading.id && !sectionsRef.current.has(heading.id)) {
+          sectionsRef.current.set(heading.id, heading);
+          changed = true;
+        }
+      });
+      if (changed) {
+        createObserver();
+      }
+    });
+    mutationObserver.observe(container, { childList: true, subtree: true });
+    return () => mutationObserver.disconnect();
+  }, [headingSelector, containerRef, createObserver]);
+  const registerSection = useCallback((id, element) => {
+    sectionsRef.current.set(id, element);
+    observerRef.current?.observe(element);
+  }, []);
+  const unregisterSection = useCallback((id) => {
+    const element = sectionsRef.current.get(id);
+    if (element) observerRef.current?.unobserve(element);
+    sectionsRef.current.delete(id);
+  }, []);
+  return /* @__PURE__ */ jsx(ScrollSpyContext.Provider, { value: { activeId, registerSection, unregisterSection }, children: /* @__PURE__ */ jsx("div", { ref: wrapperRef, children }) });
+}
+function ScrollSpySection({ id, children, sx }) {
+  const ref = useRef(null);
+  const { registerSection, unregisterSection } = useScrollSpy();
+  useEffect(() => {
+    const element = ref.current;
+    if (!element) return void 0;
+    registerSection(id, element);
+    return () => unregisterSection(id);
+  }, [id, registerSection, unregisterSection]);
+  return /* @__PURE__ */ jsx(Box, { ref, id, sx, children });
+}
+function DocSectionNav({ headings, title = "On this page" }) {
+  const { activeId } = useScrollSpy();
+  const handleClick = useCallback((e, id) => {
+    e.preventDefault();
+    const element = document.getElementById(id);
+    if (element) {
+      element.scrollIntoView({ behavior: "smooth", block: "start" });
+      window.history.replaceState(null, "", `#${id}`);
+    }
+  }, []);
+  if (headings.length === 0) return null;
+  return /* @__PURE__ */ jsxs(Box, { children: [
+    /* @__PURE__ */ jsx(
+      Typography,
+      {
+        variant: "overline",
+        sx: {
+          display: "block",
+          mb: 2,
+          color: "text.secondary",
+          fontSize: "0.6875rem",
+          fontWeight: 700,
+          letterSpacing: "0.08em"
+        },
+        children: title
+      }
+    ),
+    /* @__PURE__ */ jsx(
+      Box,
+      {
+        component: "nav",
+        sx: {
+          position: "relative",
+          borderLeft: 1,
+          borderColor: "divider"
+        },
+        children: headings.map((heading) => {
+          const isActive = activeId === heading.id;
+          const indent = (heading.level - 2) * 1.5;
+          return /* @__PURE__ */ jsx(
+            Box,
+            {
+              component: "a",
+              href: `#${heading.id}`,
+              onClick: (e) => handleClick(e, heading.id),
+              sx: {
+                display: "block",
+                py: 0.75,
+                pl: indent + 2,
+                pr: 1,
+                ml: "-1px",
+                fontSize: "0.8125rem",
+                lineHeight: 1.5,
+                textDecoration: "none",
+                color: isActive ? "primary.main" : "text.disabled",
+                fontWeight: isActive ? 600 : 400,
+                borderLeft: 2,
+                borderColor: isActive ? "primary.main" : "transparent",
+                transition: "color 0.2s ease, border-color 0.2s ease",
+                cursor: "pointer",
+                "&:hover": {
+                  color: isActive ? "primary.main" : "text.primary",
+                  backgroundColor: (theme) => alpha(theme.palette.action.hover, 0.04),
+                  borderRadius: "0 6px 6px 0"
+                }
+              },
+              children: heading.text
+            },
+            heading.id
+          );
+        })
+      }
+    )
+  ] });
+}
+
+export { DocLayout, DocSectionNav, ScrollSpyProvider, ScrollSpySection, useScrollSpy };
+//# sourceMappingURL=chunk-E7WM2RXA.js.map
+//# sourceMappingURL=chunk-E7WM2RXA.js.map

package/dist/chunk-E7WM2RXA.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/components/doc-layout/doc-layout.tsx","../src/components/scroll-spy/scroll-spy-provider.tsx","../src/components/scroll-spy/scroll-spy-section.tsx","../src/components/doc-layout/doc-section-nav.tsx"],"names":["jsx","useRef","useEffect","Box","useCallback","jsxs"],"mappings":";;;;;;;AAmBO,SAAS,UAAU,EAAE,OAAA,EAAS,UAAA,EAAY,QAAA,EAAU,IAAG,EAAmB;AAC/E,EAAA,uBACE,IAAA;AAAA,IAAC,GAAA;AAAA,IAAA;AAAA,MACC,EAAA,EAAI;AAAA,QACF,OAAA,EAAS,MAAA;AAAA,QACT,KAAA,EAAO,MAAA;AAAA,QACP,GAAI;AAAA,OACN;AAAA,MAEC,QAAA,EAAA;AAAA,QAAA,OAAA,oBACC,GAAA;AAAA,UAAC,GAAA;AAAA,UAAA;AAAA,YACC,SAAA,EAAU,KAAA;AAAA,YACV,EAAA,EAAI;AAAA,cACF,KAAA,EAAO,GAAA;AAAA,cACP,UAAA,EAAY,CAAA;AAAA,cACZ,OAAA,EAAS,EAAE,EAAA,EAAI,MAAA,EAAQ,IAAI,OAAA,EAAQ;AAAA,cACnC,QAAA,EAAU,QAAA;AAAA,cACV,GAAA,EAAK,EAAA;AAAA,cACL,SAAA,EAAW,YAAA;AAAA,cACX,SAAA,EAAW,qBAAA;AAAA,cACX,SAAA,EAAW,MAAA;AAAA,cACX,EAAA,EAAI,CAAA;AAAA,cACJ,WAAA,EAAa,CAAA;AAAA,cACb,WAAA,EAAa;AAAA,aACf;AAAA,YAEC,QAAA,EAAA;AAAA;AAAA,SACH;AAAA,wBAGF,GAAA;AAAA,UAAC,GAAA;AAAA,UAAA;AAAA,YACC,SAAA,EAAU,MAAA;AAAA,YACV,EAAA,EAAI;AAAA,cACF,IAAA,EAAM,CAAA;AAAA,cACN,QAAA,EAAU,CAAA;AAAA,cACV,EAAA,EAAI,EAAE,EAAA,EAAI,CAAA,EAAG,IAAI,CAAA;AAAE,aACrB;AAAA,YAEC;AAAA;AAAA,SACH;AAAA,QAEC,UAAA,oBACC,GAAA;AAAA,UAAC,GAAA;AAAA,UAAA;AAAA,YACC,SAAA,EAAU,OAAA;AAAA,YACV,EAAA,EAAI;AAAA,cACF,KAAA,EAAO,GAAA;AAAA,cACP,UAAA,EAAY,CAAA;AAAA,cACZ,OAAA,EAAS,EAAE,EAAA,EAAI,MAAA,EAAQ,IAAI,OAAA,EAAQ;AAAA,cACnC,QAAA,EAAU,QAAA;AAAA,cACV,GAAA,EAAK,EAAA;AAAA,cACL,SAAA,EAAW,YAAA;AAAA,cACX,SAAA,EAAW,qBAAA;AAAA,cACX,SAAA,EAAW,MAAA;AAAA,cACX,EAAA,EAAI;AAAA,aACN;AAAA,YAEC,QAAA,EAAA;AAAA;AAAA;AACH;AAAA;AAAA,GAEJ;AAEJ;ACtEA,IAAM,mBAAmB,aAAA,CAAqC;AAAA,EAC5D,QAAA,EAAU,IAAA;AAAA,EACV,iBAAiB,MAAM;AAAA,EAAC,CAAA;AAAA,EACxB,mBAAmB,MAAM;AAAA,EAAC;AAC5B,CAAC,CAAA;AAEM,SAAS,YAAA,GAAe;AAC7B,EAAA,OAAO,WAAW,gBAAgB,CAAA;AACpC;AAmBO,SAAS,iBAAA,CAAkB;AAAA,EAChC,QAAA;AAAA,EACA,MAAA,GAAS,EAAA;AAAA,EACT,IAAA,GAAO,IAAA;AAAA,EACP,eAAA,GAAkB,gDAAA;AAAA,EAClB;AACF,CAAA,EAA2B;AACzB,EAAA,MAAM,CAAC,QAAA,EAAU,WAAW,CAAA,GAAI,SAAwB,IAAI,CAAA;AAC5D,EAAA,MAAM,WAAA,GAAc,MAAA,iBAAiC,IAAI,GAAA,EAAK,CAAA;AAC9D,EAAA,MAAM,WAAA,GAAc,OAAoC,IAAI,CAAA;AAC5D,EAAA,MAAM,UAAA,GAAa,OAAuB,IAAI,CAAA;AAG9C,EAAA,MAAM,cAAA,GAAiB,YAAY,MAAM;AACvC,IAAA,WAAA,CAAY,SAAS,UAAA,EAAW;AAEhC,IAAA,MAAM,WAAW,IAAI,oBAAA;AAAA,MACnB,CAAC,OAAA,KAAY;AAEX,QAAA,MAAM,UAAU,OAAA,CACb,MAAA,CAAO,CAAC,CAAA,KAAM,EAAE,cAAc,CAAA,CAC9B,IAAA,CAAK,CAAC,GAAG,CAAA,KAAM,CAAA,CAAE,mBAAmB,GAAA,GAAM,CAAA,CAAE,mBAAmB,GAAG,CAAA;AAErE,QAAA,IAAI,OAAA,CAAQ,SAAS,CAAA,EAAG;AACtB,UAAA,WAAA,CAAY,OAAA,CAAQ,CAAC,CAAA,CAAE,MAAA,CAAO,EAAE,CAAA;AAAA,QAClC;AAAA,MACF,CAAA;AAAA,MACA;AAAA,QACE,IAAA;AAAA,QACA,UAAA,EAAY,IAAI,MAAM,CAAA,eAAA,CAAA;AAAA,QACtB,SAAA,EAAW;AAAA;AACb,KACF;AAEA,IAAA,WAAA,CAAY,QAAQ,OAAA,CAAQ,CAAC,YAAY,QAAA,CAAS,OAAA,CAAQ,OAAO,CAAC,CAAA;AAClE,IAAA,WAAA,CAAY,OAAA,GAAU,QAAA;AAAA,EACxB,CAAA,EAAG,CAAC,MAAA,EAAQ,IAAI,CAAC,CAAA;AAGjB,EAAA,SAAA,CAAU,MAAM;AACd,IAAA,IAAI,CAAC,iBAAiB,OAAO,MAAA;AAG7B,IAAA,MAAM,KAAA,GAAQ,WAAW,MAAM;AAC7B,MAAA,MAAM,SAAA,GAAY,YAAA,EAAc,OAAA,IAAW,UAAA,CAAW,OAAA;AACtD,MAAA,IAAI,CAAC,SAAA,EAAW;AAEhB,MAAA,MAAM,QAAA,GAAW,SAAA,CAAU,gBAAA,CAA8B,eAAe,CAAA;AACxE,MAAA,QAAA,CAAS,OAAA,CAAQ,CAAC,OAAA,KAAY;AAC5B,QAAA,IAAI,QAAQ,EAAA,EAAI;AACd,UAAA,WAAA,CAAY,OAAA,CAAQ,GAAA,CAAI,OAAA,CAAQ,EAAA,EAAI,OAAO,CAAA;AAAA,QAC7C;AAAA,MACF,CAAC,CAAA;AAED,MAAA,cAAA,EAAe;AAAA,IACjB,GAAG,GAAG,CAAA;AAEN,IAAA,OAAO,MAAM;AACX,MAAA,YAAA,CAAa,KAAK,CAAA;AAClB,MAAA,WAAA,CAAY,SAAS,UAAA,EAAW;AAAA,IAClC,CAAA;AAAA,EACF,CAAA,EAAG,CAAC,eAAA,EAAiB,YAAA,EAAc,cAAc,CAAC,CAAA;AAGlD,EAAA,SAAA,CAAU,MAAM;AACd,IAAA,IAAI,CAAC,iBAAiB,OAAO,MAAA;AAE7B,IAAA,MAAM,SAAA,GAAY,YAAA,EAAc,OAAA,IAAW,UAAA,CAAW,OAAA;AACtD,IAAA,IAAI,CAAC,WAAW,OAAO,MAAA;AAEvB,IAAA,MAAM,gBAAA,GAAmB,IAAI,gBAAA,CAAiB,MAAM;AAClD,MAAA,MAAM,QAAA,GAAW,SAAA,CAAU,gBAAA,CAA8B,eAAe,CAAA;AACxE,MAAA,IAAI,OAAA,GAAU,KAAA;AAEd,MAAA,QAAA,CAAS,OAAA,CAAQ,CAAC,OAAA,KAAY;AAC5B,QAAA,IAAI,OAAA,CAAQ,MAAM,CAAC,WAAA,CAAY,QAAQ,GAAA,CAAI,OAAA,CAAQ,EAAE,CAAA,EAAG;AACtD,UAAA,WAAA,CAAY,OAAA,CAAQ,GAAA,CAAI,OAAA,CAAQ,EAAA,EAAI,OAAO,CAAA;AAC3C,UAAA,OAAA,GAAU,IAAA;AAAA,QACZ;AAAA,MACF,CAAC,CAAA;AAED,MAAA,IAAI,OAAA,EAAS;AACX,QAAA,cAAA,EAAe;AAAA,MACjB;AAAA,IACF,CAAC,CAAA;AAED,IAAA,gBAAA,CAAiB,QAAQ,SAAA,EAAW,EAAE,WAAW,IAAA,EAAM,OAAA,EAAS,MAAM,CAAA;AAEtE,IAAA,OAAO,MAAM,iBAAiB,UAAA,EAAW;AAAA,EAC3C,CAAA,EAAG,CAAC,eAAA,EAAiB,YAAA,EAAc,cAAc,CAAC,CAAA;AAElD,EAAA,MAAM,eAAA,GAAkB,WAAA,CAAY,CAAC,EAAA,EAAY,OAAA,KAAyB;AACxE,IAAA,WAAA,CAAY,OAAA,CAAQ,GAAA,CAAI,EAAA,EAAI,OAAO,CAAA;AACnC,IAAA,WAAA,CAAY,OAAA,EAAS,QAAQ,OAAO,CAAA;AAAA,EACtC,CAAA,EAAG,EAAE,CAAA;AAEL,EAAA,MAAM,iBAAA,GAAoB,WAAA,CAAY,CAAC,EAAA,KAAe;AACpD,IAAA,MAAM,OAAA,GAAU,WAAA,CAAY,OAAA,CAAQ,GAAA,CAAI,EAAE,CAAA;AAC1C,IAAA,IAAI,OAAA,EAAS,WAAA,CAAY,OAAA,EAAS,SAAA,CAAU,OAAO,CAAA;AACnD,IAAA,WAAA,CAAY,OAAA,CAAQ,OAAO,EAAE,CAAA;AAAA,EAC/B,CAAA,EAAG,EAAE,CAAA;AAEL,EAAA,uBACEA,GAAAA,CAAC,gBAAA,CAAiB,QAAA,EAAjB,EAA0B,OAAO,EAAE,QAAA,EAAU,eAAA,EAAiB,iBAAA,IAC7D,QAAA,kBAAAA,GAAAA,CAAC,SAAI,GAAA,EAAK,UAAA,EAAa,UAAS,CAAA,EAClC,CAAA;AAEJ;ACnIO,SAAS,gBAAA,CAAiB,EAAE,EAAA,EAAI,QAAA,EAAU,IAAG,EAA0B;AAC5E,EAAA,MAAM,GAAA,GAAMC,OAAuB,IAAI,CAAA;AACvC,EAAA,MAAM,EAAE,eAAA,EAAiB,iBAAA,EAAkB,GAAI,YAAA,EAAa;AAE5D,EAAAC,UAAU,MAAM;AACd,IAAA,MAAM,UAAU,GAAA,CAAI,OAAA;AACpB,IAAA,IAAI,CAAC,SAAS,OAAO,MAAA;AACrB,IAAA,eAAA,CAAgB,IAAI,OAAO,CAAA;AAC3B,IAAA,OAAO,MAAM,kBAAkB,EAAE,CAAA;AAAA,EACnC,CAAA,EAAG,CAAC,EAAA,EAAI,eAAA,EAAiB,iBAAiB,CAAC,CAAA;AAE3C,EAAA,uBACEF,GAAAA,CAACG,GAAAA,EAAA,EAAI,GAAA,EAAU,EAAA,EAAQ,IACpB,QAAA,EACH,CAAA;AAEJ;ACNO,SAAS,aAAA,CAAc,EAAE,QAAA,EAAU,KAAA,GAAQ,gBAAe,EAAuB;AACtF,EAAA,MAAM,EAAE,QAAA,EAAS,GAAI,YAAA,EAAa;AAElC,EAAA,MAAM,WAAA,GAAcC,WAAAA,CAAY,CAAC,CAAA,EAAwC,EAAA,KAAe;AACtF,IAAA,CAAA,CAAE,cAAA,EAAe;AACjB,IAAA,MAAM,OAAA,GAAU,QAAA,CAAS,cAAA,CAAe,EAAE,CAAA;AAC1C,IAAA,IAAI,OAAA,EAAS;AACX,MAAA,OAAA,CAAQ,eAAe,EAAE,QAAA,EAAU,QAAA,EAAU,KAAA,EAAO,SAAS,CAAA;AAC7D,MAAA,MAAA,CAAO,QAAQ,YAAA,CAAa,IAAA,EAAM,EAAA,EAAI,CAAA,CAAA,EAAI,EAAE,CAAA,CAAE,CAAA;AAAA,IAChD;AAAA,EACF,CAAA,EAAG,EAAE,CAAA;AAEL,EAAA,IAAI,QAAA,CAAS,MAAA,KAAW,CAAA,EAAG,OAAO,IAAA;AAElC,EAAA,uBACEC,IAAAA,CAACF,GAAAA,EAAA,EACC,QAAA,EAAA;AAAA,oBAAAH,GAAAA;AAAA,MAAC,UAAA;AAAA,MAAA;AAAA,QACC,OAAA,EAAQ,UAAA;AAAA,QACR,EAAA,EAAI;AAAA,UACF,OAAA,EAAS,OAAA;AAAA,UACT,EAAA,EAAI,CAAA;AAAA,UACJ,KAAA,EAAO,gBAAA;AAAA,UACP,QAAA,EAAU,WAAA;AAAA,UACV,UAAA,EAAY,GAAA;AAAA,UACZ,aAAA,EAAe;AAAA,SACjB;AAAA,QAEC,QAAA,EAAA;AAAA;AAAA,KACH;AAAA,oBAEAA,GAAAA;AAAA,MAACG,GAAAA;AAAA,MAAA;AAAA,QACC,SAAA,EAAU,KAAA;AAAA,QACV,EAAA,EAAI;AAAA,UACF,QAAA,EAAU,UAAA;AAAA,UACV,UAAA,EAAY,CAAA;AAAA,UACZ,WAAA,EAAa;AAAA,SACf;AAAA,QAEC,QAAA,EAAA,QAAA,CAAS,GAAA,CAAI,CAAC,OAAA,KAAY;AACzB,UAAA,MAAM,QAAA,GAAW,aAAa,OAAA,CAAQ,EAAA;AACtC,UAAA,MAAM,MAAA,GAAA,CAAU,OAAA,CAAQ,KAAA,GAAQ,CAAA,IAAK,GAAA;AACrC,UAAA,uBACEH,GAAAA;AAAA,YAACG,GAAAA;AAAA,YAAA;AAAA,cAEC,SAAA,EAAU,GAAA;AAAA,cACV,IAAA,EAAM,CAAA,CAAA,EAAI,OAAA,CAAQ,EAAE,CAAA,CAAA;AAAA,cACpB,SAAS,CAAC,CAAA,KAA2C,WAAA,CAAY,CAAA,EAAG,QAAQ,EAAE,CAAA;AAAA,cAC9E,EAAA,EAAI;AAAA,gBACF,OAAA,EAAS,OAAA;AAAA,gBACT,EAAA,EAAI,IAAA;AAAA,gBACJ,IAAI,MAAA,GAAS,CAAA;AAAA,gBACb,EAAA,EAAI,CAAA;AAAA,gBACJ,EAAA,EAAI,MAAA;AAAA,gBACJ,QAAA,EAAU,WAAA;AAAA,gBACV,UAAA,EAAY,GAAA;AAAA,gBACZ,cAAA,EAAgB,MAAA;AAAA,gBAChB,KAAA,EAAO,WAAW,cAAA,GAAiB,eAAA;AAAA,gBACnC,UAAA,EAAY,WAAW,GAAA,GAAM,GAAA;AAAA,gBAC7B,UAAA,EAAY,CAAA;AAAA,gBACZ,WAAA,EAAa,WAAW,cAAA,GAAiB,aAAA;AAAA,gBACzC,UAAA,EAAY,yCAAA;AAAA,gBACZ,MAAA,EAAQ,SAAA;AAAA,gBACR,SAAA,EAAW;AAAA,kBACT,KAAA,EAAO,WAAW,cAAA,GAAiB,cAAA;AAAA,kBACnC,eAAA,EAAiB,CAAC,KAAA,KAAU,KAAA,CAAM,MAAM,OAAA,CAAQ,MAAA,CAAO,OAAO,IAAI,CAAA;AAAA,kBAClE,YAAA,EAAc;AAAA;AAChB,eACF;AAAA,cAEC,QAAA,EAAA,OAAA,CAAQ;AAAA,aAAA;AAAA,YA1BJ,OAAA,CAAQ;AAAA,WA2Bf;AAAA,QAEJ,CAAC;AAAA;AAAA;AACH,GAAA,EACF,CAAA;AAEJ","file":"chunk-E7WM2RXA.js","sourcesContent":["'use client';\n\nimport { type ReactNode } from 'react';\nimport Box from '@mui/material/Box';\nimport type { SxProps, Theme } from '@mui/material/styles';\n\ninterface DocLayoutProps {\n  sidebar?: ReactNode;\n  sectionNav?: ReactNode;\n  children: ReactNode;\n  sx?: SxProps<Theme>;\n}\n\n/**\n * 3-column responsive documentation layout.\n * - Left: sidebar (collapsible tree nav)\n * - Center: content (fills available width)\n * - Right: section nav (ToC from headings)\n */\nexport function DocLayout({ sidebar, sectionNav, children, sx }: DocLayoutProps) {\n  return (\n    <Box\n      sx={{\n        display: 'flex',\n        width: '100%',\n        ...(sx as any),\n      }}\n    >\n      {sidebar && (\n        <Box\n          component=\"nav\"\n          sx={{\n            width: 272,\n            flexShrink: 0,\n            display: { xs: 'none', md: 'block' },\n            position: 'sticky',\n            top: 80,\n            alignSelf: 'flex-start',\n            maxHeight: 'calc(100vh - 100px)',\n            overflowY: 'auto',\n            pr: 3,\n            borderRight: 1,\n            borderColor: 'divider',\n          }}\n        >\n          {sidebar}\n        </Box>\n      )}\n\n      <Box\n        component=\"main\"\n        sx={{\n          flex: 1,\n          minWidth: 0,\n          px: { xs: 2, md: 4 },\n        }}\n      >\n        {children}\n      </Box>\n\n      {sectionNav && (\n        <Box\n          component=\"aside\"\n          sx={{\n            width: 240,\n            flexShrink: 0,\n            display: { xs: 'none', lg: 'block' },\n            position: 'sticky',\n            top: 80,\n            alignSelf: 'flex-start',\n            maxHeight: 'calc(100vh - 100px)',\n            overflowY: 'auto',\n            pl: 3,\n          }}\n        >\n          {sectionNav}\n        </Box>\n      )}\n    </Box>\n  );\n}\n","'use client';\n\nimport { createContext, useContext, useState, useEffect, useRef, useCallback, type ReactNode } from 'react';\n\ninterface ScrollSpyContextValue {\n  activeId: string | null;\n  registerSection: (id: string, element: HTMLElement) => void;\n  unregisterSection: (id: string) => void;\n}\n\nconst ScrollSpyContext = createContext<ScrollSpyContextValue>({\n  activeId: null,\n  registerSection: () => {},\n  unregisterSection: () => {},\n});\n\nexport function useScrollSpy() {\n  return useContext(ScrollSpyContext);\n}\n\ninterface ScrollSpyProviderProps {\n  children: ReactNode;\n  /** Offset from top in pixels for activation threshold */\n  offset?: number;\n  /** Root element to observe (defaults to viewport) */\n  root?: HTMLElement | null;\n  /**\n   * CSS selector for heading elements to auto-observe.\n   * When set, headings matching this selector inside the container\n   * are automatically registered (no need for ScrollSpySection wrappers).\n   * @default 'h1[id], h2[id], h3[id], h4[id], h5[id], h6[id]'\n   */\n  headingSelector?: string;\n  /** Ref to the container to scan for headings. Defaults to document. */\n  containerRef?: React.RefObject<HTMLElement | null>;\n}\n\nexport function ScrollSpyProvider({\n  children,\n  offset = 80,\n  root = null,\n  headingSelector = 'h1[id], h2[id], h3[id], h4[id], h5[id], h6[id]',\n  containerRef,\n}: ScrollSpyProviderProps) {\n  const [activeId, setActiveId] = useState<string | null>(null);\n  const sectionsRef = useRef<Map<string, HTMLElement>>(new Map());\n  const observerRef = useRef<IntersectionObserver | null>(null);\n  const wrapperRef = useRef<HTMLDivElement>(null);\n\n  // Create IntersectionObserver\n  const createObserver = useCallback(() => {\n    observerRef.current?.disconnect();\n\n    const observer = new IntersectionObserver(\n      (entries) => {\n        // Find the topmost visible entry\n        const visible = entries\n          .filter((e) => e.isIntersecting)\n          .sort((a, b) => a.boundingClientRect.top - b.boundingClientRect.top);\n\n        if (visible.length > 0) {\n          setActiveId(visible[0].target.id);\n        }\n      },\n      {\n        root,\n        rootMargin: `-${offset}px 0px -60% 0px`,\n        threshold: 0,\n      }\n    );\n\n    sectionsRef.current.forEach((element) => observer.observe(element));\n    observerRef.current = observer;\n  }, [offset, root]);\n\n  // Auto-scan for headings with IDs\n  useEffect(() => {\n    if (!headingSelector) return undefined;\n\n    // Wait a tick for content to render\n    const timer = setTimeout(() => {\n      const container = containerRef?.current ?? wrapperRef.current;\n      if (!container) return;\n\n      const headings = container.querySelectorAll<HTMLElement>(headingSelector);\n      headings.forEach((heading) => {\n        if (heading.id) {\n          sectionsRef.current.set(heading.id, heading);\n        }\n      });\n\n      createObserver();\n    }, 100);\n\n    return () => {\n      clearTimeout(timer);\n      observerRef.current?.disconnect();\n    };\n  }, [headingSelector, containerRef, createObserver]);\n\n  // Also observe via MutationObserver to catch dynamically added headings\n  useEffect(() => {\n    if (!headingSelector) return undefined;\n\n    const container = containerRef?.current ?? wrapperRef.current;\n    if (!container) return undefined;\n\n    const mutationObserver = new MutationObserver(() => {\n      const headings = container.querySelectorAll<HTMLElement>(headingSelector);\n      let changed = false;\n\n      headings.forEach((heading) => {\n        if (heading.id && !sectionsRef.current.has(heading.id)) {\n          sectionsRef.current.set(heading.id, heading);\n          changed = true;\n        }\n      });\n\n      if (changed) {\n        createObserver();\n      }\n    });\n\n    mutationObserver.observe(container, { childList: true, subtree: true });\n\n    return () => mutationObserver.disconnect();\n  }, [headingSelector, containerRef, createObserver]);\n\n  const registerSection = useCallback((id: string, element: HTMLElement) => {\n    sectionsRef.current.set(id, element);\n    observerRef.current?.observe(element);\n  }, []);\n\n  const unregisterSection = useCallback((id: string) => {\n    const element = sectionsRef.current.get(id);\n    if (element) observerRef.current?.unobserve(element);\n    sectionsRef.current.delete(id);\n  }, []);\n\n  return (\n    <ScrollSpyContext.Provider value={{ activeId, registerSection, unregisterSection }}>\n      <div ref={wrapperRef}>{children}</div>\n    </ScrollSpyContext.Provider>\n  );\n}\n","'use client';\n\nimport { useEffect, useRef, type ReactNode } from 'react';\nimport Box from '@mui/material/Box';\nimport type { SxProps, Theme } from '@mui/material/styles';\nimport { useScrollSpy } from './scroll-spy-provider';\n\ninterface ScrollSpySectionProps {\n  id: string;\n  children: ReactNode;\n  sx?: SxProps<Theme>;\n}\n\nexport function ScrollSpySection({ id, children, sx }: ScrollSpySectionProps) {\n  const ref = useRef<HTMLDivElement>(null);\n  const { registerSection, unregisterSection } = useScrollSpy();\n\n  useEffect(() => {\n    const element = ref.current;\n    if (!element) return undefined;\n    registerSection(id, element);\n    return () => unregisterSection(id);\n  }, [id, registerSection, unregisterSection]);\n\n  return (\n    <Box ref={ref} id={id} sx={sx}>\n      {children}\n    </Box>\n  );\n}\n","'use client';\n\nimport { useCallback } from 'react';\nimport Box from '@mui/material/Box';\nimport Typography from '@mui/material/Typography';\nimport { alpha } from '@mui/material/styles';\nimport { useScrollSpy } from '../scroll-spy/index.js';\n\nexport interface DocHeading {\n  id: string;\n  text: string;\n  level: number;\n}\n\ninterface DocSectionNavProps {\n  headings: DocHeading[];\n  title?: string;\n}\n\n/**\n * Right-side table of contents connected to ScrollSpy.\n * Highlights the currently visible section with a smooth indicator.\n */\nexport function DocSectionNav({ headings, title = 'On this page' }: DocSectionNavProps) {\n  const { activeId } = useScrollSpy();\n\n  const handleClick = useCallback((e: React.MouseEvent<HTMLAnchorElement>, id: string) => {\n    e.preventDefault();\n    const element = document.getElementById(id);\n    if (element) {\n      element.scrollIntoView({ behavior: 'smooth', block: 'start' });\n      window.history.replaceState(null, '', `#${id}`);\n    }\n  }, []);\n\n  if (headings.length === 0) return null;\n\n  return (\n    <Box>\n      <Typography\n        variant=\"overline\"\n        sx={{\n          display: 'block',\n          mb: 2,\n          color: 'text.secondary',\n          fontSize: '0.6875rem',\n          fontWeight: 700,\n          letterSpacing: '0.08em',\n        }}\n      >\n        {title}\n      </Typography>\n\n      <Box\n        component=\"nav\"\n        sx={{\n          position: 'relative',\n          borderLeft: 1,\n          borderColor: 'divider',\n        }}\n      >\n        {headings.map((heading) => {\n          const isActive = activeId === heading.id;\n          const indent = (heading.level - 2) * 1.5;\n          return (\n            <Box\n              key={heading.id}\n              component=\"a\"\n              href={`#${heading.id}`}\n              onClick={(e: React.MouseEvent<HTMLAnchorElement>) => handleClick(e, heading.id)}\n              sx={{\n                display: 'block',\n                py: 0.75,\n                pl: indent + 2,\n                pr: 1,\n                ml: '-1px',\n                fontSize: '0.8125rem',\n                lineHeight: 1.5,\n                textDecoration: 'none',\n                color: isActive ? 'primary.main' : 'text.disabled',\n                fontWeight: isActive ? 600 : 400,\n                borderLeft: 2,\n                borderColor: isActive ? 'primary.main' : 'transparent',\n                transition: 'color 0.2s ease, border-color 0.2s ease',\n                cursor: 'pointer',\n                '&:hover': {\n                  color: isActive ? 'primary.main' : 'text.primary',\n                  backgroundColor: (theme) => alpha(theme.palette.action.hover, 0.04),\n                  borderRadius: '0 6px 6px 0',\n                },\n              }}\n            >\n              {heading.text}\n            </Box>\n          );\n        })}\n      </Box>\n    </Box>\n  );\n}\n"]}