zudoku 0.37.1 → 0.39.0

package/src/lib/plugins/search-pagefind/get-results.tsx

@@ -1,16 +1,30 @@
+import type { AuthState } from "../../authentication/state.js";
+import type { ZudokuContext } from "../../core/ZudokuContext.js";
 import type { PagefindOptions } from "./index.js";
 import type { PagefindSearchFragment, PagefindSearchResults } from "./types.js";
 
-export const getResults = async (
-  search: PagefindSearchResults,
-  options: PagefindOptions,
-) => {
+export const getResults = async ({
+  search,
+  options,
+  auth,
+  context,
+}: {
+  search: PagefindSearchResults;
+  options: PagefindOptions;
+  auth: AuthState;
+  context: ZudokuContext;
+}) => {
   const maxResults = options.maxResults ?? 10;
   const transformFn = options.transformResults ?? (() => true);
 
   const transformedResults: PagefindSearchFragment[] = [];
 
-  const generator = searchResultGenerator(search, transformFn);
+  const generator = searchResultGenerator({
+    search,
+    transformFn,
+    auth,
+    context,
+  });
 
   for await (const result of generator) {
     transformedResults.push(result);
@@ -20,10 +34,17 @@ export const getResults = async (
   return transformedResults;
 };
 
-async function* searchResultGenerator(
-  search: PagefindSearchResults,
-  transformFn: NonNullable<PagefindOptions["transformResults"]>,
-) {
+async function* searchResultGenerator({
+  search,
+  transformFn,
+  auth,
+  context,
+}: {
+  search: PagefindSearchResults;
+  transformFn: NonNullable<PagefindOptions["transformResults"]>;
+  auth: AuthState<unknown>;
+  context: ZudokuContext;
+}) {
   const batchSize = 5;
   let processedCount = 0;
 
@@ -37,7 +58,7 @@ async function* searchResultGenerator(
     const batchData = await Promise.all(batch.map((result) => result.data()));
 
     for (const result of batchData) {
-      const transformed = transformFn(result);
+      const transformed = transformFn({ result, auth, context });
 
       if (transformed === false) {
         // Skip this result

package/src/lib/util/traverse.ts

@@ -1,10 +1,6 @@
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export type RecordAny = Record<string, any>;
+import type { JsonValue, RecordAny } from "./types.js";
 
-type JsonPrimitive = string | number | boolean | null;
-type JsonArray = JsonValue[];
-type JsonObject = { [key: string]: JsonValue };
-type JsonValue = JsonPrimitive | JsonArray | JsonObject;
+export type { RecordAny };
 
 export const traverse = <T extends JsonValue = RecordAny>(
   specification: RecordAny,

package/src/lib/util/types.ts

@@ -0,0 +1,7 @@
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export type RecordAny = Record<string, any>;
+
+export type JsonPrimitive = string | number | boolean | null;
+export type JsonArray = JsonValue[];
+export type JsonObject = { [key: string]: JsonValue };
+export type JsonValue = JsonPrimitive | JsonArray | JsonObject;

package/src/lib/util/useOnScreen.ts

@@ -1,14 +1,16 @@
 import { useEffect, useRef, useState } from "react";
 
-export const useOnScreen = ({
+export const useOnScreen = <E extends Element = HTMLElement>({
   rootMargin = "0px",
   threshold,
+  root,
 }: {
   rootMargin?: string;
   threshold?: number;
+  root?: Element | null;
 } = {}) => {
   const [isVisible, setIsVisible] = useState(false);
-  const ref = useRef<HTMLElement | null>(null);
+  const ref = useRef<E | null>(null);
 
   useEffect(() => {
     const observer = new IntersectionObserver(
@@ -16,7 +18,7 @@ export const useOnScreen = ({
         if (!entry) return;
         setIsVisible(entry.isIntersecting);
       },
-      { rootMargin, threshold },
+      { rootMargin, threshold, root },
     );
 
     const currentElement = ref.current;
@@ -26,7 +28,7 @@ export const useOnScreen = ({
     observer.observe(currentElement);
 
     return () => observer.unobserve(currentElement);
-  }, [rootMargin, threshold]);
+  }, [root, rootMargin, threshold]);
 
   return [ref, isVisible] as const;
 };

package/src/lib/util/useScrollToAnchor.ts

@@ -1,4 +1,4 @@
-import { useCallback, useEffect } from "react";
+import { useCallback, useEffect, useRef } from "react";
 import { useLocation } from "react-router";
 import { useViewportAnchor } from "../components/context/ViewportAnchorContext.js";
 import { DATA_ANCHOR_ATTR } from "../components/navigation/SidebarItem.js";
@@ -40,21 +40,29 @@ export const useScrollToHash = () => {
 
 export const useScrollToAnchor = () => {
   const location = useLocation();
-  const { setActiveAnchor } = useViewportAnchor();
   const scrollToHash = useScrollToHash();
+  const initialScrolled = useRef(false);
 
   useEffect(() => {
-    if (!location.hash) return;
-
-    if (!scrollToHash(location.hash)) {
-      const observer = new MutationObserver((_, obs) => {
-        if (!scrollToHash(location.hash)) return;
-        obs.disconnect();
-      });
+    if (!location.hash || !initialScrolled.current) return;
 
-      observer.observe(document.body, { childList: true, subtree: true });
+    scrollToHash(location.hash);
+  }, [location.hash, scrollToHash]);
 
-      return () => observer.disconnect();
+  useEffect(() => {
+    if (!location.hash) {
+      initialScrolled.current = true;
+      return;
     }
-  }, [location.hash, scrollToHash, setActiveAnchor]);
+
+    const observer = new MutationObserver((_, obs) => {
+      if (!scrollToHash(location.hash)) return;
+      initialScrolled.current = true;
+      obs.disconnect();
+    });
+
+    observer.observe(document.body, { childList: true, subtree: true });
+
+    return () => observer.disconnect();
+  }, [location.hash, scrollToHash]);
 };

package/dist/lib/plugins/markdown/Toc.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Toc.js","sourceRoot":"","sources":["../../../../src/lib/plugins/markdown/Toc.tsx"],"names":[],"mappings":"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"}

package/lib/MdxPage-D2rD1vC4.js

@@ -1,200 +0,0 @@
-import { j as e } from "./jsx-runtime-CYK1ROHF.js";
-import { s as P } from "./index-LNp6rxyU.js";
-import { H as _, u as H } from "./index.esm-CltAN0Tf.js";
-import { useRef as w, useState as I, useEffect as k } from "react";
-import { e as S, L as b } from "./chunk-HA7DTUK3-ZGg2W6yV.js";
-import { C as $ } from "./CategoryHeading-DpB47wvk.js";
-import { u as L, A as D, H as u, P as M } from "./Markdown-DT5Rrq8_.js";
-import { c as q, d as B } from "./hook-DzQC8PzJ.js";
-import { c as p } from "./cn-qaFjX9_3.js";
-import { ListTreeIcon as V } from "lucide-react";
-const A = "data-active", N = ({
-  item: r,
-  children: t,
-  className: a,
-  isActive: s
-}) => /* @__PURE__ */ e.jsxs(
-  "li",
-  {
-    className: p(
-      "truncate",
-      s ? "text-primary" : "text-foreground/65 dark:text-foreground/75",
-      a
-    ),
-    title: r.value,
-    children: [
-      /* @__PURE__ */ e.jsx(
-        D,
-        {
-          to: `#${r.id}`,
-          [A]: r.id,
-          className: p(
-            s ? "text-primary" : "text-foreground/65 dark:text-foreground/75 hover:text-foreground"
-          ),
-          children: r.value
-        }
-      ),
-      t
-    ]
-  }
-), W = ({ entries: r }) => {
-  const { activeAnchor: t } = L(), a = w(null), s = w(!1), [c, l] = I({
-    top: 0,
-    opacity: 0
-  });
-  return k(() => {
-    if (!a.current) return;
-    const n = a.current.querySelector(
-      `[${A}='${t}']`
-    );
-    if (!n) {
-      l({ top: 0, opacity: 0 });
-      return;
-    }
-    const o = a.current.getBoundingClientRect().top, h = n.getBoundingClientRect().top;
-    l({
-      opacity: 1,
-      top: `${h - o}px`
-    }), !s.current && requestIdleCallback(() => {
-      s.current = !0;
-    });
-  }, [t]), /* @__PURE__ */ e.jsxs("aside", { className: "sticky scrollbar top-[--header-height] h-[calc(100vh-var(--header-height))] pt-[--padding-content-top] pb-[--padding-content-bottom] overflow-y-auto ps-1 text-sm", children: [
-    /* @__PURE__ */ e.jsxs("div", { className: "flex items-center gap-2 font-medium mb-2", children: [
-      /* @__PURE__ */ e.jsx(V, { size: 16 }),
-      "On this page"
-    ] }),
-    /* @__PURE__ */ e.jsxs("div", { className: "relative ms-2 ps-4", children: [
-      /* @__PURE__ */ e.jsx("div", { className: "absolute inset-0 right-auto bg-border w-[2px]" }),
-      /* @__PURE__ */ e.jsx(
-        "div",
-        {
-          className: p(
-            "absolute -left-px -translate-y-1 h-6 w-[4px] rounded bg-primary",
-            s.current && "ease-out [transition:top_150ms,opacity_325ms]"
-          ),
-          style: c
-        }
-      ),
-      /* @__PURE__ */ e.jsx(
-        "ul",
-        {
-          ref: a,
-          className: "relative font-medium list-none space-y-2",
-          children: r.map((n) => /* @__PURE__ */ e.jsx(
-            N,
-            {
-              isActive: n.id === t,
-              item: n,
-              className: "pl-0",
-              children: n.children && /* @__PURE__ */ e.jsx("ul", { className: "list-none pl-4 pt-2 space-y-2", children: n.children.map((o) => /* @__PURE__ */ e.jsx(
-                N,
-                {
-                  item: o,
-                  isActive: o.id === t
-                },
-                o.id
-              )) })
-            },
-            n.id
-          ))
-        }
-      )
-    ] })
-  ] });
-}, z = {
-  h2: ({ children: r, id: t }) => /* @__PURE__ */ e.jsx(u, { level: 2, id: t, registerSidebarAnchor: !0, children: r }),
-  h3: ({ children: r, id: t }) => /* @__PURE__ */ e.jsx(u, { level: 3, id: t, registerSidebarAnchor: !0, children: r })
-}, ee = ({
-  mdxComponent: r,
-  file: t,
-  frontmatter: a = {},
-  defaultOptions: s,
-  tableOfContents: c,
-  excerpt: l
-}) => {
-  var j, v, y;
-  const n = (j = q()) == null ? void 0 : j.categoryLabel;
-  let o = null;
-  const h = S("");
-  typeof window < "u" && (o = `${window.location.origin}${h}`);
-  const d = a.title, g = a.category ?? n, R = a.toc === !1 || (s == null ? void 0 : s.toc) === !1, T = ((v = c.find((i) => i.depth === 1)) == null ? void 0 : v.value) ?? d, C = a.disablePager ?? (s == null ? void 0 : s.disablePager) ?? !1, f = ((y = c.find((i) => i.depth === 1)) == null ? void 0 : y.children) ?? // if `title` is provided by frontmatter it does not appear in the table of contents
-  c.filter((i) => i.depth === 2), E = !R && f.length > 0, { prev: x, next: m } = B();
-  return k(() => {
-    if (process.env.NODE_ENV === "development")
-      return window.__getReactRefreshIgnoredExports = ({ id: i }) => {
-        if (i.endsWith(t))
-          return ["frontmatter", "tableOfContents"];
-      }, () => {
-        window.__getReactRefreshIgnoredExports = void 0;
-      };
-  }, [t]), /* @__PURE__ */ e.jsxs(
-    "div",
-    {
-      className: "grid grid-cols-1 xl:grid-cols-[--sidecar-grid-cols] gap-8 justify-between",
-      "data-pagefind-filter": "section:markdown",
-      "data-pagefind-meta": "section:markdown",
-      children: [
-        /* @__PURE__ */ e.jsxs(_, { children: [
-          /* @__PURE__ */ e.jsx("title", { children: T }),
-          l && /* @__PURE__ */ e.jsx("meta", { name: "description", content: l }),
-          o && /* @__PURE__ */ e.jsx("link", { rel: "canonical", href: o })
-        ] }),
-        /* @__PURE__ */ e.jsxs(
-          "div",
-          {
-            className: p(
-              M,
-              "max-w-full xl:w-full xl:max-w-3xl flex-1 flex-shrink pt-[--padding-content-top] pb-[--padding-content-bottom]"
-            ),
-            children: [
-              (g || d) && /* @__PURE__ */ e.jsxs("header", { children: [
-                g && /* @__PURE__ */ e.jsx($, { children: g }),
-                d && /* @__PURE__ */ e.jsx(u, { level: 1, id: P(d), children: d })
-              ] }),
-              /* @__PURE__ */ e.jsx(
-                r,
-                {
-                  components: { ...H(), ...z }
-                }
-              ),
-              !C && /* @__PURE__ */ e.jsxs(e.Fragment, { children: [
-                /* @__PURE__ */ e.jsx("hr", {}),
-                /* @__PURE__ */ e.jsxs("div", { className: "not-prose flex flex-wrap items-center justify-between gap-2 lg:gap-8", children: [
-                  x ? /* @__PURE__ */ e.jsxs(
-                    b,
-                    {
-                      to: x.id,
-                      className: "flex flex-col items-stretch gap-2 flex-1 min-w-max border rounded px-6 py-4 text-start hover:border-primary/85 transition shadow-sm hover:shadow-md",
-                      title: x.label,
-                      children: [
-                        /* @__PURE__ */ e.jsx("div", { className: "text-sm text-muted-foreground", children: "← Previous page" }),
-                        /* @__PURE__ */ e.jsx("div", { className: "text-lg text-primary truncate", children: x.label })
-                      ]
-                    }
-                  ) : /* @__PURE__ */ e.jsx("div", { className: "flex-1" }),
-                  m ? /* @__PURE__ */ e.jsxs(
-                    b,
-                    {
-                      to: m.id,
-                      className: "flex flex-col items-stretch gap-2 flex-1 min-w-max border rounded px-6 py-4 text-end hover:border-primary/85 transition shadow-sm hover:shadow-md",
-                      title: m.label,
-                      children: [
-                        /* @__PURE__ */ e.jsx("div", { className: "text-sm text-muted-foreground", children: "Next page →" }),
-                        /* @__PURE__ */ e.jsx("div", { className: "text-lg text-primary truncate", children: m.label })
-                      ]
-                    }
-                  ) : /* @__PURE__ */ e.jsx("div", { className: "flex-1" })
-                ] })
-              ] })
-            ]
-          }
-        ),
-        /* @__PURE__ */ e.jsx("div", { className: "hidden xl:block", children: E && /* @__PURE__ */ e.jsx(W, { entries: f }) })
-      ]
-    }
-  );
-};
-export {
-  ee as MdxPage
-};
-//# sourceMappingURL=MdxPage-D2rD1vC4.js.map

package/lib/MdxPage-D2rD1vC4.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"MdxPage-D2rD1vC4.js","sources":["../src/lib/plugins/markdown/Toc.tsx","../src/lib/plugins/markdown/MdxPage.tsx"],"sourcesContent":["import type { TocEntry } from \"@stefanprobst/rehype-extract-toc\";\nimport { ListTreeIcon } from \"lucide-react\";\nimport {\n  useEffect,\n  useRef,\n  useState,\n  type CSSProperties,\n  type PropsWithChildren,\n} from \"react\";\nimport { AnchorLink } from \"../../components/AnchorLink.js\";\nimport { useViewportAnchor } from \"../../components/context/ViewportAnchorContext.js\";\nimport { cn } from \"../../util/cn.js\";\n\nconst DATA_ANCHOR_ATTR = \"data-active\";\n\nconst TocItem = ({\n  item,\n  children,\n  className,\n  isActive,\n}: PropsWithChildren<{\n  item: TocEntry;\n  isActive: boolean;\n  className?: string;\n}>) => {\n  return (\n    <li\n      className={cn(\n        \"truncate\",\n        isActive\n          ? \"text-primary\"\n          : \"text-foreground/65 dark:text-foreground/75\",\n        className,\n      )}\n      title={item.value}\n    >\n      <AnchorLink\n        to={`#${item.id}`}\n        {...{ [DATA_ANCHOR_ATTR]: item.id }}\n        className={cn(\n          isActive\n            ? \"text-primary\"\n            : \"text-foreground/65 dark:text-foreground/75 hover:text-foreground\",\n        )}\n      >\n        {item.value}\n      </AnchorLink>\n      {children}\n    </li>\n  );\n};\n\nexport const Toc = ({ entries }: { entries: TocEntry[] }) => {\n  const { activeAnchor } = useViewportAnchor();\n  const listWrapperRef = useRef<HTMLUListElement>(null);\n  const paintedOnce = useRef(false);\n  const [indicatorStyle, setIndicatorStyles] = useState<CSSProperties>({\n    top: 0,\n    opacity: 0,\n  });\n\n  // synchronize active anchor indicator with the scroll position\n  useEffect(() => {\n    if (!listWrapperRef.current) return;\n\n    const activeElement = listWrapperRef.current.querySelector(\n      `[${DATA_ANCHOR_ATTR}='${activeAnchor}']`,\n    );\n\n    if (!activeElement) {\n      setIndicatorStyles({ top: 0, opacity: 0 });\n      return;\n    }\n\n    const topParent = listWrapperRef.current.getBoundingClientRect().top;\n    const topElement = activeElement.getBoundingClientRect().top;\n\n    setIndicatorStyles({\n      opacity: 1,\n      top: `${topElement - topParent}px`,\n    });\n\n    if (paintedOnce.current) return;\n\n    // after all is painted, the indicator should animate\n    requestIdleCallback(() => {\n      paintedOnce.current = true;\n    });\n  }, [activeAnchor]);\n\n  return (\n    <aside className=\"sticky scrollbar top-[--header-height] h-[calc(100vh-var(--header-height))] pt-[--padding-content-top] pb-[--padding-content-bottom] overflow-y-auto ps-1 text-sm\">\n      <div className=\"flex items-center gap-2 font-medium mb-2\">\n        <ListTreeIcon size={16} />\n        On this page\n      </div>\n      <div className=\"relative ms-2 ps-4\">\n        <div className=\"absolute inset-0 right-auto bg-border w-[2px]\" />\n        <div\n          className={cn(\n            \"absolute -left-px -translate-y-1 h-6 w-[4px] rounded bg-primary\",\n            paintedOnce.current &&\n              \"ease-out [transition:top_150ms,opacity_325ms]\",\n          )}\n          style={indicatorStyle}\n        />\n        <ul\n          ref={listWrapperRef}\n          className=\"relative font-medium list-none space-y-2\"\n        >\n          {entries.map((item) => (\n            <TocItem\n              isActive={item.id === activeAnchor}\n              key={item.id}\n              item={item}\n              className=\"pl-0\"\n            >\n              {item.children && (\n                <ul className=\"list-none pl-4 pt-2 space-y-2\">\n                  {item.children.map((child) => (\n                    <TocItem\n                      item={child}\n                      isActive={child.id === activeAnchor}\n                      key={child.id}\n                    />\n                  ))}\n                </ul>\n              )}\n            </TocItem>\n          ))}\n        </ul>\n      </div>\n    </aside>\n  );\n};\n","import { useMDXComponents } from \"@mdx-js/react\";\nimport slugify from \"@sindresorhus/slugify\";\nimport { Helmet } from \"@zudoku/react-helmet-async\";\nimport { type PropsWithChildren, useEffect } from \"react\";\nimport { Link, useHref } from \"react-router\";\nimport { CategoryHeading } from \"../../components/CategoryHeading.js\";\nimport { Heading } from \"../../components/Heading.js\";\nimport { ProseClasses } from \"../../components/Markdown.js\";\nimport {\n  useCurrentItem,\n  usePrevNext,\n} from \"../../components/navigation/utils.js\";\nimport type { MdxComponentsType } from \"../../util/MdxComponents.js\";\nimport { cn } from \"../../util/cn.js\";\nimport { Toc } from \"./Toc.js\";\nimport { type MarkdownPluginDefaultOptions, type MDXImport } from \"./index.js\";\n\ndeclare global {\n  interface Window {\n    __getReactRefreshIgnoredExports?: (args: {\n      id: string;\n    }) => string[] | undefined;\n  }\n}\n\nconst MarkdownHeadings = {\n  h2: ({ children, id }) => (\n    <Heading level={2} id={id} registerSidebarAnchor>\n      {children}\n    </Heading>\n  ),\n  h3: ({ children, id }) => (\n    <Heading level={3} id={id} registerSidebarAnchor>\n      {children}\n    </Heading>\n  ),\n} satisfies MdxComponentsType;\n\nexport const MdxPage = ({\n  mdxComponent: MdxComponent,\n  file,\n  frontmatter = {},\n  defaultOptions,\n  tableOfContents,\n  excerpt,\n}: PropsWithChildren<\n  Omit<MDXImport, \"default\"> & {\n    file: string;\n    mdxComponent: MDXImport[\"default\"];\n    defaultOptions?: MarkdownPluginDefaultOptions;\n  }\n>) => {\n  const categoryTitle = useCurrentItem()?.categoryLabel;\n  let canonicalUrl = null;\n  const path = useHref(\"\");\n  if (typeof window !== \"undefined\") {\n    const domain = window.location.origin;\n    canonicalUrl = `${domain}${path}`;\n  }\n\n  const title = frontmatter.title;\n  const category = frontmatter.category ?? categoryTitle;\n  const hideToc = frontmatter.toc === false || defaultOptions?.toc === false;\n  const pageTitle =\n    tableOfContents.find((item) => item.depth === 1)?.value ?? title;\n  const hidePager =\n    frontmatter.disablePager ?? defaultOptions?.disablePager ?? false;\n\n  const tocEntries =\n    tableOfContents.find((item) => item.depth === 1)?.children ??\n    // if `title` is provided by frontmatter it does not appear in the table of contents\n    tableOfContents.filter((item) => item.depth === 2);\n\n  const showToc = !hideToc && tocEntries.length > 0;\n\n  const { prev, next } = usePrevNext();\n\n  useEffect(() => {\n    if (process.env.NODE_ENV === \"development\") {\n      window.__getReactRefreshIgnoredExports = ({ id }) => {\n        if (!id.endsWith(file)) return;\n\n        return [\"frontmatter\", \"tableOfContents\"];\n      };\n\n      return () => {\n        window.__getReactRefreshIgnoredExports = undefined;\n      };\n    }\n  }, [file]);\n\n  return (\n    <div\n      className=\"grid grid-cols-1 xl:grid-cols-[--sidecar-grid-cols] gap-8 justify-between\"\n      data-pagefind-filter=\"section:markdown\"\n      data-pagefind-meta=\"section:markdown\"\n    >\n      <Helmet>\n        <title>{pageTitle}</title>\n        {excerpt && <meta name=\"description\" content={excerpt} />}\n        {canonicalUrl && <link rel=\"canonical\" href={canonicalUrl} />}\n      </Helmet>\n      <div\n        className={cn(\n          ProseClasses,\n          \"max-w-full xl:w-full xl:max-w-3xl flex-1 flex-shrink pt-[--padding-content-top] pb-[--padding-content-bottom]\",\n        )}\n      >\n        {(category || title) && (\n          <header>\n            {category && <CategoryHeading>{category}</CategoryHeading>}\n            {title && (\n              <Heading level={1} id={slugify(title)}>\n                {title}\n              </Heading>\n            )}\n          </header>\n        )}\n        <MdxComponent\n          components={{ ...useMDXComponents(), ...MarkdownHeadings }}\n        />\n        {!hidePager && (\n          <>\n            <hr />\n            <div className=\"not-prose flex flex-wrap items-center justify-between gap-2 lg:gap-8\">\n              {prev ? (\n                <Link\n                  to={prev.id}\n                  className=\"flex flex-col items-stretch gap-2 flex-1 min-w-max border rounded px-6 py-4 text-start hover:border-primary/85 transition shadow-sm hover:shadow-md\"\n                  title={prev.label}\n                >\n                  <div className=\"text-sm text-muted-foreground\">\n                    ← Previous page\n                  </div>\n                  <div className=\"text-lg text-primary truncate\">\n                    {prev.label}\n                  </div>\n                </Link>\n              ) : (\n                <div className=\"flex-1\" />\n              )}\n              {next ? (\n                <Link\n                  to={next.id}\n                  className=\"flex flex-col items-stretch gap-2 flex-1 min-w-max border rounded px-6 py-4 text-end hover:border-primary/85 transition shadow-sm hover:shadow-md\"\n                  title={next.label}\n                >\n                  <div className=\"text-sm text-muted-foreground\">\n                    Next page →\n                  </div>\n                  <div className=\"text-lg text-primary truncate\">\n                    {next.label}\n                  </div>\n                </Link>\n              ) : (\n                <div className=\"flex-1\" />\n              )}\n            </div>\n          </>\n        )}\n      </div>\n      <div className=\"hidden xl:block\">\n        {showToc && <Toc entries={tocEntries} />}\n      </div>\n    </div>\n  );\n};\n"],"names":["DATA_ANCHOR_ATTR","TocItem","item","children","className","isActive","jsxs","cn","jsx","AnchorLink","Toc","entries","activeAnchor","useViewportAnchor","listWrapperRef","useRef","paintedOnce","indicatorStyle","setIndicatorStyles","useState","useEffect","activeElement","topParent","topElement","ListTreeIcon","child","MarkdownHeadings","id","Heading","MdxPage","MdxComponent","file","frontmatter","defaultOptions","tableOfContents","excerpt","categoryTitle","_a","useCurrentItem","canonicalUrl","path","useHref","title","category","hideToc","pageTitle","_b","hidePager","tocEntries","_c","showToc","prev","next","usePrevNext","Helmet","ProseClasses","CategoryHeading","slugify","useMDXComponents","Fragment","Link"],"mappings":"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"}