@mintlify/msft-sdk 1.1.0 → 1.1.2

package/dist/components/toc/index.js

@@ -1,65 +1,68 @@
-import { jsx as g, jsxs as $ } from "react/jsx-runtime";
-import { useState as N, useRef as E, useEffect as k } from "react";
-import l from "./toc.module.css.js";
-function F({ toc: s }) {
-  const [I, u] = N(""), o = E(!1), t = E();
-  return k(() => {
-    var h;
-    if (s.length === 0) return;
+import { jsx as d, jsxs as S } from "react/jsx-runtime";
+import { useState as y, useRef as w, useEffect as B } from "react";
+import { cn as A } from "../../utils/cn.js";
+function j({ toc: i }) {
+  const [x, c] = y(""), o = w(!1), t = w();
+  return B(() => {
+    var g;
+    if (i.length === 0) return;
     o.current = !1, t.current && clearTimeout(t.current);
     const n = window.location.hash.slice(1);
-    n ? (u(n), o.current = !0, t.current = setTimeout(() => {
+    n ? (c(n), o.current = !0, t.current = setTimeout(() => {
       o.current = !1;
-    }, 1e3)) : u(((h = s[0]) == null ? void 0 : h.slug) || "");
-    const a = () => {
+    }, 1e3)) : c(((g = i[0]) == null ? void 0 : g.slug) || "");
+    const m = () => {
       const r = window.location.hash.slice(1);
-      r && (u(r), o.current = !0, t.current && clearTimeout(t.current), t.current = setTimeout(() => {
+      r && (c(r), o.current = !0, t.current && clearTimeout(t.current), t.current = setTimeout(() => {
         o.current = !1;
       }, 1e3));
-    }, e = document.getElementById("main-content"), R = () => {
-      var p, w;
-      if (!e) return (p = s[0]) == null ? void 0 : p.slug;
-      const r = window.getComputedStyle(document.documentElement), y = parseFloat(
+    }, e = document.getElementById("main-content"), T = () => {
+      var p, b;
+      if (!e) return (p = i[0]) == null ? void 0 : p.slug;
+      const r = window.getComputedStyle(document.documentElement), E = parseFloat(
         r.getPropertyValue("--scroll-mt") || "0"
-      ), C = parseFloat(r.fontSize), L = y * C + 100, v = e.scrollTop, m = s.map((c) => {
-        const T = document.getElementById(c.slug);
-        if (!T) return null;
-        const S = T.getBoundingClientRect(), A = e.getBoundingClientRect(), B = S.top - A.top + v;
-        return { id: c.slug, top: B };
+      ), R = parseFloat(r.fontSize), k = E * R + 100, h = e.scrollTop, f = i.map((s) => {
+        const v = document.getElementById(s.slug);
+        if (!v) return null;
+        const C = v.getBoundingClientRect(), I = e.getBoundingClientRect(), L = C.top - I.top + h;
+        return { id: s.slug, top: L };
       }).filter(Boolean);
-      if (m.length === 0) return (w = s[0]) == null ? void 0 : w.slug;
-      let f = m[0];
-      for (const c of m)
-        v + L >= c.top && (f = c);
-      return f == null ? void 0 : f.id;
-    }, i = () => {
+      if (f.length === 0) return (b = i[0]) == null ? void 0 : b.slug;
+      let a = f[0];
+      for (const s of f)
+        h + k >= s.top && (a = s);
+      return a == null ? void 0 : a.id;
+    }, l = () => {
       if (o.current) return;
-      const r = R();
-      r && u(r);
+      const r = T();
+      r && c(r);
     };
-    window.addEventListener("hashchange", a), e ? e.addEventListener("scroll", i, {
+    window.addEventListener("hashchange", m), e ? e.addEventListener("scroll", l, {
       passive: !0
-    }) : window.addEventListener("scroll", i, { passive: !0 });
-    let d;
-    return n || (d = setTimeout(i, 100)), () => {
-      d && clearTimeout(d), t.current && clearTimeout(t.current), window.removeEventListener("hashchange", a), e ? e.removeEventListener("scroll", i) : window.removeEventListener("scroll", i);
+    }) : window.addEventListener("scroll", l, { passive: !0 });
+    let u;
+    return n || (u = setTimeout(l, 100)), () => {
+      u && clearTimeout(u), t.current && clearTimeout(t.current), window.removeEventListener("hashchange", m), e ? e.removeEventListener("scroll", l) : window.removeEventListener("scroll", l);
     };
-  }, [s]), /* @__PURE__ */ g("ul", { className: l.list, children: s.map((n, a) => {
-    const e = I === n.slug;
-    return /* @__PURE__ */ $("li", { className: l.listItem, children: [
-      e && /* @__PURE__ */ g("div", { className: l.activeIndicator }),
-      /* @__PURE__ */ g(
+  }, [i]), /* @__PURE__ */ d("ul", { className: "mint:flex mint:flex-col mint:gap-1 mint:text-sm mint:text-[#6b7280] mint:dark:text-[#9ca3af] mint:font-medium mint:relative mint:pl-[0.15rem] mint:before:content-[''] mint:before:absolute mint:before:left-[0.15rem] mint:before:top-0 mint:before:bottom-0 mint:before:w-[3px] mint:before:bg-[#f2f3f3] mint:dark:before:bg-[#222223] mint:before:rounded-full", children: i.map((n, m) => {
+    const e = x === n.slug;
+    return /* @__PURE__ */ S("li", { className: "mint:relative", children: [
+      e && /* @__PURE__ */ d("div", { className: "mint:absolute mint:left-0 mint:top-0 mint:bottom-0 mint:w-[3px] mint:rounded-full mint:bg-[#643fb2] mint:dark:bg-[#c9aaf9] mint:z-[1]" }),
+      /* @__PURE__ */ d(
         "a",
         {
           href: `#${n.slug}`,
-          className: `${l.link} ${e ? l.linkActive : l.linkInactive}`,
+          className: A(
+            "mint:block mint:pl-6 mint:leading-[1.625] mint:transition-colors mint:duration-150 mint:no-underline",
+            e ? "mint:text-[#643fb2] mint:dark:text-[#c9aaf9]" : "mint:hover:text-[#111827] mint:dark:hover:text-[#d1d5db]"
+          ),
           children: n.title
         }
       )
-    ] }, `${n.slug}-${a}`);
+    ] }, `${n.slug}-${m}`);
   }) });
 }
 export {
-  F as TableOfContents
+  j as TableOfContents
 };
 //# sourceMappingURL=index.js.map

package/dist/components/toc/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../../src/components/toc/index.tsx"],"sourcesContent":["import { useEffect, useRef, useState } from \"react\";\nimport type { TocItem } from \"../../types\";\nimport styles from \"./toc.module.css\";\n\ninterface TableOfContentsProps {\n  toc: TocItem[];\n}\n\nexport function TableOfContents({ toc }: TableOfContentsProps) {\n  const [activeId, setActiveId] = useState(\"\");\n  const ignoreScrollRef = useRef(false);\n  const ignoreTimeoutRef = useRef<NodeJS.Timeout>();\n\n  useEffect(() => {\n    if (toc.length === 0) return;\n\n    ignoreScrollRef.current = false;\n    if (ignoreTimeoutRef.current) {\n      clearTimeout(ignoreTimeoutRef.current);\n    }\n\n    const hash = window.location.hash.slice(1);\n    if (hash) {\n      setActiveId(hash);\n      ignoreScrollRef.current = true;\n      ignoreTimeoutRef.current = setTimeout(() => {\n        ignoreScrollRef.current = false;\n      }, 1000);\n    } else {\n      setActiveId(toc[0]?.slug || \"\");\n    }\n\n    const handleHashChange = () => {\n      const hash = window.location.hash.slice(1);\n      if (hash) {\n        setActiveId(hash);\n        ignoreScrollRef.current = true;\n        if (ignoreTimeoutRef.current) {\n          clearTimeout(ignoreTimeoutRef.current);\n        }\n        ignoreTimeoutRef.current = setTimeout(() => {\n          ignoreScrollRef.current = false;\n        }, 1000);\n      }\n    };\n\n    const scrollContainer = document.getElementById(\"main-content\");\n\n    const getActiveHeading = () => {\n      if (!scrollContainer) return toc[0]?.slug;\n\n      const style = window.getComputedStyle(document.documentElement);\n      const scrollMtRem = parseFloat(\n        style.getPropertyValue(\"--scroll-mt\") || \"0\"\n      );\n      const fontSize = parseFloat(style.fontSize);\n      const scrollOffset = scrollMtRem * fontSize + 100;\n\n      const scrollY = scrollContainer.scrollTop;\n\n      const headingPositions = toc\n        .map((item) => {\n          const element = document.getElementById(item.slug);\n          if (!element) return null;\n\n          const rect = element.getBoundingClientRect();\n          const containerRect = scrollContainer.getBoundingClientRect();\n          const relativeTop = rect.top - containerRect.top + scrollY;\n\n          return { id: item.slug, top: relativeTop };\n        })\n        .filter(Boolean) as Array<{ id: string; top: number }>;\n\n      if (headingPositions.length === 0) return toc[0]?.slug;\n\n      let currentHeading = headingPositions[0];\n      for (const heading of headingPositions) {\n        if (scrollY + scrollOffset >= heading.top) {\n          currentHeading = heading;\n        }\n      }\n\n      return currentHeading?.id;\n    };\n\n    const handleScroll = () => {\n      if (ignoreScrollRef.current) return;\n\n      const newActiveId = getActiveHeading();\n      if (newActiveId) {\n        setActiveId(newActiveId);\n      }\n    };\n\n    window.addEventListener(\"hashchange\", handleHashChange);\n\n    if (scrollContainer) {\n      scrollContainer.addEventListener(\"scroll\", handleScroll, {\n        passive: true,\n      });\n    } else {\n      window.addEventListener(\"scroll\", handleScroll, { passive: true });\n    }\n\n    let timeoutId: NodeJS.Timeout | undefined;\n    if (!hash) {\n      timeoutId = setTimeout(handleScroll, 100);\n    }\n\n    return () => {\n      if (timeoutId) clearTimeout(timeoutId);\n      if (ignoreTimeoutRef.current) clearTimeout(ignoreTimeoutRef.current);\n      window.removeEventListener(\"hashchange\", handleHashChange);\n      if (scrollContainer) {\n        scrollContainer.removeEventListener(\"scroll\", handleScroll);\n      } else {\n        window.removeEventListener(\"scroll\", handleScroll);\n      }\n    };\n  }, [toc]);\n\n  return (\n    <ul className={styles.list}>\n      {toc.map((item, index) => {\n        const isActive = activeId === item.slug;\n        return (\n          <li key={`${item.slug}-${index}`} className={styles.listItem}>\n            {isActive && <div className={styles.activeIndicator} />}\n            <a\n              href={`#${item.slug}`}\n              className={`${styles.link} ${\n                isActive ? styles.linkActive : styles.linkInactive\n              }`}\n            >\n              {item.title}\n            </a>\n          </li>\n        );\n      })}\n    </ul>\n  );\n}\n"],"names":["TableOfContents","toc","activeId","setActiveId","useState","ignoreScrollRef","useRef","ignoreTimeoutRef","useEffect","hash","_a","handleHashChange","scrollContainer","getActiveHeading","style","scrollMtRem","fontSize","scrollOffset","scrollY","headingPositions","item","element","rect","containerRect","relativeTop","_b","currentHeading","heading","handleScroll","newActiveId","timeoutId","jsx","styles","index","isActive","jsxs"],"mappings":"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"}
+{"version":3,"file":"index.js","sources":["../../../src/components/toc/index.tsx"],"sourcesContent":["import { useEffect, useRef, useState } from \"react\";\nimport type { TocItem } from \"../../types\";\nimport { cn } from \"../../utils/cn\";\n\ninterface TableOfContentsProps {\n  toc: TocItem[];\n}\n\nexport function TableOfContents({ toc }: TableOfContentsProps) {\n  const [activeId, setActiveId] = useState(\"\");\n  const ignoreScrollRef = useRef(false);\n  const ignoreTimeoutRef = useRef<NodeJS.Timeout>();\n\n  useEffect(() => {\n    if (toc.length === 0) return;\n\n    ignoreScrollRef.current = false;\n    if (ignoreTimeoutRef.current) {\n      clearTimeout(ignoreTimeoutRef.current);\n    }\n\n    const hash = window.location.hash.slice(1);\n    if (hash) {\n      setActiveId(hash);\n      ignoreScrollRef.current = true;\n      ignoreTimeoutRef.current = setTimeout(() => {\n        ignoreScrollRef.current = false;\n      }, 1000);\n    } else {\n      setActiveId(toc[0]?.slug || \"\");\n    }\n\n    const handleHashChange = () => {\n      const hash = window.location.hash.slice(1);\n      if (hash) {\n        setActiveId(hash);\n        ignoreScrollRef.current = true;\n        if (ignoreTimeoutRef.current) {\n          clearTimeout(ignoreTimeoutRef.current);\n        }\n        ignoreTimeoutRef.current = setTimeout(() => {\n          ignoreScrollRef.current = false;\n        }, 1000);\n      }\n    };\n\n    const scrollContainer = document.getElementById(\"main-content\");\n\n    const getActiveHeading = () => {\n      if (!scrollContainer) return toc[0]?.slug;\n\n      const style = window.getComputedStyle(document.documentElement);\n      const scrollMtRem = parseFloat(\n        style.getPropertyValue(\"--scroll-mt\") || \"0\"\n      );\n      const fontSize = parseFloat(style.fontSize);\n      const scrollOffset = scrollMtRem * fontSize + 100;\n\n      const scrollY = scrollContainer.scrollTop;\n\n      const headingPositions = toc\n        .map((item) => {\n          const element = document.getElementById(item.slug);\n          if (!element) return null;\n\n          const rect = element.getBoundingClientRect();\n          const containerRect = scrollContainer.getBoundingClientRect();\n          const relativeTop = rect.top - containerRect.top + scrollY;\n\n          return { id: item.slug, top: relativeTop };\n        })\n        .filter(Boolean) as Array<{ id: string; top: number }>;\n\n      if (headingPositions.length === 0) return toc[0]?.slug;\n\n      let currentHeading = headingPositions[0];\n      for (const heading of headingPositions) {\n        if (scrollY + scrollOffset >= heading.top) {\n          currentHeading = heading;\n        }\n      }\n\n      return currentHeading?.id;\n    };\n\n    const handleScroll = () => {\n      if (ignoreScrollRef.current) return;\n\n      const newActiveId = getActiveHeading();\n      if (newActiveId) {\n        setActiveId(newActiveId);\n      }\n    };\n\n    window.addEventListener(\"hashchange\", handleHashChange);\n\n    if (scrollContainer) {\n      scrollContainer.addEventListener(\"scroll\", handleScroll, {\n        passive: true,\n      });\n    } else {\n      window.addEventListener(\"scroll\", handleScroll, { passive: true });\n    }\n\n    let timeoutId: NodeJS.Timeout | undefined;\n    if (!hash) {\n      timeoutId = setTimeout(handleScroll, 100);\n    }\n\n    return () => {\n      if (timeoutId) clearTimeout(timeoutId);\n      if (ignoreTimeoutRef.current) clearTimeout(ignoreTimeoutRef.current);\n      window.removeEventListener(\"hashchange\", handleHashChange);\n      if (scrollContainer) {\n        scrollContainer.removeEventListener(\"scroll\", handleScroll);\n      } else {\n        window.removeEventListener(\"scroll\", handleScroll);\n      }\n    };\n  }, [toc]);\n\n  return (\n    <ul className=\"mint:flex mint:flex-col mint:gap-1 mint:text-sm mint:text-[#6b7280] mint:dark:text-[#9ca3af] mint:font-medium mint:relative mint:pl-[0.15rem] mint:before:content-[''] mint:before:absolute mint:before:left-[0.15rem] mint:before:top-0 mint:before:bottom-0 mint:before:w-[3px] mint:before:bg-[#f2f3f3] mint:dark:before:bg-[#222223] mint:before:rounded-full\">\n      {toc.map((item, index) => {\n        const isActive = activeId === item.slug;\n        return (\n          <li key={`${item.slug}-${index}`} className=\"mint:relative\">\n            {isActive && (\n              <div className=\"mint:absolute mint:left-0 mint:top-0 mint:bottom-0 mint:w-[3px] mint:rounded-full mint:bg-[#643fb2] mint:dark:bg-[#c9aaf9] mint:z-[1]\" />\n            )}\n            <a\n              href={`#${item.slug}`}\n              className={cn(\n                \"mint:block mint:pl-6 mint:leading-[1.625] mint:transition-colors mint:duration-150 mint:no-underline\",\n                isActive\n                  ? \"mint:text-[#643fb2] mint:dark:text-[#c9aaf9]\"\n                  : \"mint:hover:text-[#111827] mint:dark:hover:text-[#d1d5db]\"\n              )}\n            >\n              {item.title}\n            </a>\n          </li>\n        );\n      })}\n    </ul>\n  );\n}\n"],"names":["TableOfContents","toc","activeId","setActiveId","useState","ignoreScrollRef","useRef","ignoreTimeoutRef","useEffect","hash","_a","handleHashChange","scrollContainer","getActiveHeading","style","scrollMtRem","fontSize","scrollOffset","scrollY","headingPositions","item","element","rect","containerRect","relativeTop","_b","currentHeading","heading","handleScroll","newActiveId","timeoutId","jsx","index","isActive","jsxs","cn"],"mappings":"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"}

package/dist/context/components-context.js

@@ -0,0 +1,17 @@
+import { jsx as n } from "react/jsx-runtime";
+import { createContext as r, useContext as m } from "react";
+const o = r({});
+function i({
+  children: t,
+  LinkComponent: e
+}) {
+  return /* @__PURE__ */ n(o.Provider, { value: { LinkComponent: e }, children: t });
+}
+function p() {
+  return m(o);
+}
+export {
+  i as ComponentsProvider,
+  p as useComponents
+};
+//# sourceMappingURL=components-context.js.map

package/dist/context/components-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"components-context.js","sources":["../../src/context/components-context.tsx"],"sourcesContent":["import { createContext, useContext } from \"react\";\nimport type { LinkComponent } from \"../types\";\n\nexport interface ComponentsContextValue {\n  LinkComponent?: LinkComponent;\n}\n\nconst ComponentsContext = createContext<ComponentsContextValue>({});\n\nexport function ComponentsProvider({\n  children,\n  LinkComponent,\n}: {\n  children: React.ReactNode;\n  LinkComponent?: LinkComponent;\n}) {\n  return (\n    <ComponentsContext.Provider value={{ LinkComponent }}>\n      {children}\n    </ComponentsContext.Provider>\n  );\n}\n\nexport function useComponents() {\n  return useContext(ComponentsContext);\n}\n"],"names":["ComponentsContext","createContext","ComponentsProvider","children","LinkComponent","jsx","useComponents","useContext"],"mappings":";;AAOA,MAAMA,IAAoBC,EAAsC,EAAE;AAE3D,SAASC,EAAmB;AAAA,EACjC,UAAAC;AAAA,EACA,eAAAC;AACF,GAGG;AACD,SACE,gBAAAC,EAACL,EAAkB,UAAlB,EAA2B,OAAO,EAAE,eAAAI,EAAA,GAClC,UAAAD,GACH;AAEJ;AAEO,SAASG,IAAgB;AAC9B,SAAOC,EAAWP,CAAiB;AACrC;"}

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+import { ClassValue } from 'clsx';
 import { default as default_2 } from 'react';
 import { Element as Element_2 } from 'hast';
 import { Handle } from 'hast-util-to-mdast';
@@ -14,7 +15,7 @@ import { Text as Text_2 } from 'hast';
 
 export declare const allComponents: {
     CodeBlock: typeof CodeBlock;
-    Heading: ({ id, level, children, className }: HeadingProps) => JSX_2.Element;
+    Heading: ({ id, level, children, className, }: HeadingProps) => JSX_2.Element;
     Link: typeof Link;
     Callout: typeof Callout;
     ZonePivot: typeof ZonePivot;
@@ -45,6 +46,8 @@ declare type CalloutType = "note" | "tip" | "important" | "caution" | "warning"
 
 export declare const capitalize: (str: string) => string;
 
+export declare function cn(...inputs: ClassValue[]): string;
+
 export declare function CodeBlock({ children, className, fileName, language, }: CodeBlockProps): JSX_2.Element;
 
 declare interface CodeBlockProps {
@@ -54,6 +57,15 @@ declare interface CodeBlockProps {
     fileName?: string;
 }
 
+declare interface ComponentsContextValue {
+    LinkComponent?: LinkComponent;
+}
+
+export declare function ComponentsProvider({ children, LinkComponent, }: {
+    children: React.ReactNode;
+    LinkComponent?: LinkComponent;
+}): JSX_2.Element;
+
 export declare function convertHtmlToMdx(html: string, options?: ConvertOptions): Promise<{
     mdx: string;
     mdxExtracts: MdxExtracts;
@@ -72,6 +84,12 @@ export declare interface CopyMarkdownOptions {
 
 export declare const copyMarkdownToClipboard: ({ pathname, onSuccess, onFail, }: CopyMarkdownOptions) => void;
 
+export declare function createDefaultComponents(options?: CreateDefaultComponentsOptions): MDXComponents;
+
+export declare interface CreateDefaultComponentsOptions {
+    LinkComponent?: LinkComponent;
+}
+
 export declare const defaultComponents: MDXComponents;
 
 export declare function Details({ children, open }: DetailsProps): JSX_2.Element;
@@ -81,7 +99,7 @@ declare interface DetailsProps {
     open?: boolean;
 }
 
-export declare function DocsPage({ payload, toc, navTree, dropdown, activeHref, theme, className, pathname, markdownContent, allPages, baseUrl, bottomLinks, }: DocsPageProps): JSX_2.Element;
+export declare function DocsPage({ payload, toc, navTree, dropdown, activeHref, theme, className, pathname, markdownContent, allPages, baseUrl, bottomLinks, LinkComponent, }: DocsPageProps): JSX_2.Element;
 
 export declare interface DocsPageProps {
     payload: PayloadData;
@@ -96,6 +114,7 @@ export declare interface DocsPageProps {
     allPages?: LlmsPageConfig[];
     baseUrl?: string;
     bottomLinks?: BottomLinkConfig[];
+    LinkComponent?: LinkComponent;
 }
 
 export declare interface DropdownConfig {
@@ -148,7 +167,7 @@ export declare function getPageMarkdown(pathname: string): Promise<string>;
 
 export declare function getTextContent(node: Element_2 | Text_2): string;
 
-export declare const Heading: ({ id, level, children, className }: HeadingProps) => JSX_2.Element;
+export declare const Heading: ({ id, level, children, className, }: HeadingProps) => JSX_2.Element;
 
 declare interface HeadingProps {
     id: string;
@@ -167,6 +186,13 @@ export declare function isElement<T extends ElementType = Element_2>(node: Eleme
 
 export declare function Link({ href, children, className }: LinkProps): JSX_2.Element;
 
+export declare type LinkComponent = default_2.ComponentType<LinkComponentProps>;
+
+export declare interface LinkComponentProps extends default_2.AnchorHTMLAttributes<HTMLAnchorElement> {
+    children?: default_2.ReactNode;
+    className?: string;
+}
+
 declare interface LinkProps {
     href?: string;
     children: default_2.ReactNode;
@@ -196,7 +222,7 @@ export declare interface MDXComponents {
     h6?: default_2.ComponentType<any>;
     code?: default_2.ComponentType<any>;
     pre?: default_2.ComponentType<any>;
-    a?: default_2.ComponentType<any>;
+    a?: default_2.ComponentType<any> | LinkComponent;
     p?: default_2.ComponentType<any>;
     ul?: default_2.ComponentType<any>;
     ol?: default_2.ComponentType<any>;
@@ -233,7 +259,7 @@ declare interface MDXRendererProps {
     components?: MDXComponents;
 }
 
-export declare function MobileNavTree({ isOpen, setIsOpen, navTree, activeId, className, theme, dropdown, activeHref, bottomLinks, }: MobileNavTreeProps): JSX_2.Element;
+export declare function MobileNavTree({ isOpen, setIsOpen, navTree, activeId, className, theme, dropdown, activeHref, bottomLinks, LinkComponent, }: MobileNavTreeProps): JSX_2.Element;
 
 declare interface MobileNavTreeProps {
     isOpen: boolean;
@@ -245,6 +271,7 @@ declare interface MobileNavTreeProps {
     dropdown?: DropdownConfig;
     activeHref?: string;
     bottomLinks?: BottomLinkConfig[];
+    LinkComponent?: LinkComponent;
 }
 
 export declare interface NavItem {
@@ -396,6 +423,8 @@ export declare interface TocItem {
     children?: TocItem[];
 }
 
+export declare function useComponents(): ComponentsContextValue;
+
 export declare function useMarkdownCopy(pathname: string): void;
 
 export declare function ZonePivot({ pivot, target, children }: ZonePivotProps): JSX_2.Element | null;

package/dist/index.js

@@ -1,110 +1,116 @@
 import { DocsPage as r } from "./components/page.js";
 import { MDXRenderer as m } from "./components/mdx-renderer.js";
-import { PlainTextPage as p } from "./components/plain-text-page.js";
-import { NavTree as l } from "./components/nav-tree/index.js";
-import { TableOfContents as n } from "./components/toc/index.js";
-import { PivotAwareTOC as s } from "./components/toc/pivot-aware-toc.js";
-import { PageContextMenu as T } from "./components/page-context-menu.js";
-import { copyMarkdownToClipboard as C, getPageMarkdown as g, useMarkdownCopy as H } from "./hooks/useMarkdownCopy.js";
-import { generateLlmsFullTxt as y, generateLlmsTxt as v } from "./utils/generate-llms-txt.js";
-import { getNodeText as M } from "./utils/get-node-text.js";
-import { capitalize as k } from "./utils/string.js";
-import { getClassNames as w, getTextContent as N, isElement as D } from "./utils/rehype.js";
-import { convertHtmlToMdx as Z } from "./parser/convert-html-to-mdx.js";
-import { serializeMdx as F } from "./parser/serialize-mdx.js";
-import { extractHeadings as B } from "./plugins/extract-headings.js";
-import { rehypeRemoveHtmlComments as I, removeHtmlComments as O } from "./plugins/sanitize/remove-html-comments.js";
-import { CodeBlock as A } from "./components/content-components/code-block.js";
-import { Heading as X } from "./components/content-components/heading.js";
-import { Link as q } from "./components/content-components/link.js";
-import { Callout as K } from "./components/content-components/callouts.js";
-import { ZonePivot as U } from "./components/content-components/zone-pivots/zone-pivot.js";
-import { ZoneTarget as W } from "./components/content-components/zone-pivots/zone-target.js";
-import { ZonePivotProvider as _ } from "./components/content-components/zone-pivots/zone-pivot-context.js";
-import { ZonePivotSelector as ee } from "./components/content-components/zone-pivots/zone-pivot-selector.js";
-import { ParamName as re } from "./components/content-components/param-name.js";
-import { Tabs as me } from "./components/content-components/tabs/tabs.js";
-import { Tab as pe } from "./components/content-components/tabs/tab.js";
-import { Details as le, Summary as fe } from "./components/content-components/details/details.js";
-import { Table as de, TableBody as se, TableCaption as ie, TableCell as Te, TableFooter as be, TableHead as Ce, TableHeader as ge, TableRow as He } from "./components/content-components/table/index.js";
-import { allComponents as ye } from "./components/content-components/all-components.js";
-import { defaultComponents as he } from "./components/content-components/default-components.js";
-import { Home as ce } from "./components/content-components/home.js";
-import { DropdownMenu as ue } from "./components/nav-tree/dropdown-menu.js";
-import { MobileNavTree as Ne } from "./components/nav-tree/mobile-nav.js";
-import { rehypeCodeblocks as Re } from "./plugins/rehype/rehype-code-blocks.js";
-import { remarkHeadingIds as ze } from "./plugins/remark/remark-heading-ids.js";
-import { sanitizePreTags as Le } from "./plugins/sanitize/rehype-pre-to-mdx-fence.js";
-import { rehypeCallouts as Ee } from "./plugins/sanitize/rehype-callouts.js";
-import { rehypeParamName as Oe } from "./plugins/sanitize/rehype-param-name.js";
-import { rehypeTabs as Ae } from "./plugins/sanitize/rehype-tabs.js";
-import { rehypeDetails as Xe } from "./plugins/sanitize/rehype-details.js";
-import { rehypeHeadingIds as qe } from "./plugins/sanitize/rehype-heading-ids.js";
-import { rehypeZonePivots as Ke } from "./plugins/sanitize/rehype-zone-pivots.js";
-import { mdxJsxFlowElementHandler as Ue, rehypeRemark as Ve } from "./plugins/sanitize/rehype-remark.js";
-import { tableCellHandler as Ye, tableHandler as _e, tableRowHandler as $e } from "./plugins/sanitize/rehype-table-align.js";
+import { PlainTextPage as a } from "./components/plain-text-page.js";
+import { createDefaultComponents as f, defaultComponents as l } from "./components/content-components/default-components.js";
+import { ComponentsProvider as s, useComponents as d } from "./context/components-context.js";
+import { NavTree as T } from "./components/nav-tree/index.js";
+import { TableOfContents as b } from "./components/toc/index.js";
+import { PivotAwareTOC as P } from "./components/toc/pivot-aware-toc.js";
+import { PageContextMenu as y } from "./components/page-context-menu.js";
+import { copyMarkdownToClipboard as c, getPageMarkdown as u, useMarkdownCopy as h } from "./hooks/useMarkdownCopy.js";
+import { generateLlmsFullTxt as k, generateLlmsTxt as w } from "./utils/generate-llms-txt.js";
+import { getNodeText as N } from "./utils/get-node-text.js";
+import { capitalize as Z } from "./utils/string.js";
+import { cn as F } from "./utils/cn.js";
+import { getClassNames as B, getTextContent as E, isElement as I } from "./utils/rehype.js";
+import { convertHtmlToMdx as S } from "./parser/convert-html-to-mdx.js";
+import { serializeMdx as J } from "./parser/serialize-mdx.js";
+import { extractHeadings as j } from "./plugins/extract-headings.js";
+import { rehypeRemoveHtmlComments as G, removeHtmlComments as K } from "./plugins/sanitize/remove-html-comments.js";
+import { CodeBlock as U } from "./components/content-components/code-block.js";
+import { Heading as W } from "./components/content-components/heading.js";
+import { Link as _ } from "./components/content-components/link.js";
+import { Callout as ee } from "./components/content-components/callouts.js";
+import { ZonePivot as re } from "./components/content-components/zone-pivots/zone-pivot.js";
+import { ZoneTarget as me } from "./components/content-components/zone-pivots/zone-target.js";
+import { ZonePivotProvider as ae } from "./components/content-components/zone-pivots/zone-pivot-context.js";
+import { ZonePivotSelector as fe } from "./components/content-components/zone-pivots/zone-pivot-selector.js";
+import { ParamName as ne } from "./components/content-components/param-name.js";
+import { Tabs as de } from "./components/content-components/tabs/tabs.js";
+import { Tab as Te } from "./components/content-components/tabs/tab.js";
+import { Details as be, Summary as ge } from "./components/content-components/details/details.js";
+import { Table as He, TableBody as ye, TableCaption as ve, TableCell as ce, TableFooter as ue, TableHead as he, TableHeader as Me, TableRow as ke } from "./components/content-components/table/index.js";
+import { allComponents as De } from "./components/content-components/all-components.js";
+import { Home as Re } from "./components/content-components/home.js";
+import { DropdownMenu as ze } from "./components/nav-tree/dropdown-menu.js";
+import { MobileNavTree as Le } from "./components/nav-tree/mobile-nav.js";
+import { rehypeCodeblocks as Ee } from "./plugins/rehype/rehype-code-blocks.js";
+import { remarkHeadingIds as Oe } from "./plugins/remark/remark-heading-ids.js";
+import { sanitizePreTags as Ae } from "./plugins/sanitize/rehype-pre-to-mdx-fence.js";
+import { rehypeCallouts as Xe } from "./plugins/sanitize/rehype-callouts.js";
+import { rehypeParamName as qe } from "./plugins/sanitize/rehype-param-name.js";
+import { rehypeTabs as Ke } from "./plugins/sanitize/rehype-tabs.js";
+import { rehypeDetails as Ue } from "./plugins/sanitize/rehype-details.js";
+import { rehypeHeadingIds as We } from "./plugins/sanitize/rehype-heading-ids.js";
+import { rehypeZonePivots as _e } from "./plugins/sanitize/rehype-zone-pivots.js";
+import { mdxJsxFlowElementHandler as eo, rehypeRemark as oo } from "./plugins/sanitize/rehype-remark.js";
+import { tableCellHandler as to, tableHandler as mo, tableRowHandler as po } from "./plugins/sanitize/rehype-table-align.js";
 export {
-  K as Callout,
-  A as CodeBlock,
-  le as Details,
+  ee as Callout,
+  U as CodeBlock,
+  s as ComponentsProvider,
+  be as Details,
   r as DocsPage,
-  ue as DropdownMenu,
-  X as Heading,
-  ce as Home,
-  q as Link,
+  ze as DropdownMenu,
+  W as Heading,
+  Re as Home,
+  _ as Link,
   m as MDXRenderer,
-  Ne as MobileNavTree,
-  l as NavTree,
-  T as PageContextMenu,
-  re as ParamName,
-  s as PivotAwareTOC,
-  p as PlainTextPage,
-  fe as Summary,
-  pe as Tab,
-  de as Table,
-  se as TableBody,
-  ie as TableCaption,
-  Te as TableCell,
-  be as TableFooter,
-  Ce as TableHead,
-  ge as TableHeader,
-  n as TableOfContents,
-  He as TableRow,
-  me as Tabs,
-  U as ZonePivot,
-  _ as ZonePivotProvider,
-  ee as ZonePivotSelector,
-  W as ZoneTarget,
-  ye as allComponents,
-  k as capitalize,
-  Z as convertHtmlToMdx,
-  C as copyMarkdownToClipboard,
-  he as defaultComponents,
-  B as extractHeadings,
-  y as generateLlmsFullTxt,
-  v as generateLlmsTxt,
-  w as getClassNames,
-  M as getNodeText,
-  g as getPageMarkdown,
-  N as getTextContent,
-  D as isElement,
-  Ue as mdxJsxFlowElementHandler,
-  Ee as rehypeCallouts,
-  Re as rehypeCodeblocks,
-  Xe as rehypeDetails,
-  qe as rehypeHeadingIds,
-  Oe as rehypeParamName,
-  Ve as rehypeRemark,
-  I as rehypeRemoveHtmlComments,
-  Ae as rehypeTabs,
-  Ke as rehypeZonePivots,
-  ze as remarkHeadingIds,
-  O as removeHtmlComments,
-  Le as sanitizePreTags,
-  F as serializeMdx,
-  Ye as tableCellHandler,
-  _e as tableHandler,
-  $e as tableRowHandler,
-  H as useMarkdownCopy
+  Le as MobileNavTree,
+  T as NavTree,
+  y as PageContextMenu,
+  ne as ParamName,
+  P as PivotAwareTOC,
+  a as PlainTextPage,
+  ge as Summary,
+  Te as Tab,
+  He as Table,
+  ye as TableBody,
+  ve as TableCaption,
+  ce as TableCell,
+  ue as TableFooter,
+  he as TableHead,
+  Me as TableHeader,
+  b as TableOfContents,
+  ke as TableRow,
+  de as Tabs,
+  re as ZonePivot,
+  ae as ZonePivotProvider,
+  fe as ZonePivotSelector,
+  me as ZoneTarget,
+  De as allComponents,
+  Z as capitalize,
+  F as cn,
+  S as convertHtmlToMdx,
+  c as copyMarkdownToClipboard,
+  f as createDefaultComponents,
+  l as defaultComponents,
+  j as extractHeadings,
+  k as generateLlmsFullTxt,
+  w as generateLlmsTxt,
+  B as getClassNames,
+  N as getNodeText,
+  u as getPageMarkdown,
+  E as getTextContent,
+  I as isElement,
+  eo as mdxJsxFlowElementHandler,
+  Xe as rehypeCallouts,
+  Ee as rehypeCodeblocks,
+  Ue as rehypeDetails,
+  We as rehypeHeadingIds,
+  qe as rehypeParamName,
+  oo as rehypeRemark,
+  G as rehypeRemoveHtmlComments,
+  Ke as rehypeTabs,
+  _e as rehypeZonePivots,
+  Oe as remarkHeadingIds,
+  K as removeHtmlComments,
+  Ae as sanitizePreTags,
+  J as serializeMdx,
+  to as tableCellHandler,
+  mo as tableHandler,
+  po as tableRowHandler,
+  d as useComponents,
+  h as useMarkdownCopy
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}